Skip to content

Commit 797eae1

Browse files
committed
Update generated docs to comply with linter
1 parent 6e233a6 commit 797eae1

6 files changed

Lines changed: 586 additions & 575 deletions

File tree

actions/gls-action/scripts/generateDocs.ts

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ export function createGlsDocsConfig(): StandardActionDocsConfig {
1515
title: "Datatypes",
1616
description: "All data types registered by the GLS Action.",
1717
heading: "GLS Action Types",
18-
intro: `The GLS Action registers the following data types with the Hercules platform. These types are used as inputs and outputs of the GLS functions and can be referenced in your flows.`,
18+
intro: `The GLS Action registers the following data types with the Hercules platform.\nThese types are used as inputs and outputs of the GLS functions and can be referenced in your flows.`,
1919
},
2020
functionsCopy: {
2121
title: "Functions",
@@ -33,7 +33,8 @@ export function createGlsDocsConfig(): StandardActionDocsConfig {
3333
},
3434
{
3535
heading: "Shipment functions",
36-
intro: `All shipment functions accept a common set of parameters in addition to their type-specific parameters. They call the GLS ShipIT API (\`POST /rs/shipments\`) and return a \`GLS_CREATE_PARCELS_RESPONSE\`.
36+
intro: `All shipment functions accept a common set of parameters in addition to their type-specific parameters.
37+
They call the GLS ShipIT API (\`POST /rs/shipments\`) and return a \`GLS_CREATE_PARCELS_RESPONSE\`.
3738
3839
**Common parameters for all shipment functions:**
3940

actions/gls-action/src/functions/reprintParcel.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ export default (sdk: ActionSdk) => {
1515
documentation: [
1616
{
1717
code: "en-US",
18-
content: "Reprints the label for an existing parcel. Use this if the original label is damaged, lost, or needs to be printed in a different format."
18+
content: "Reprints the label for an existing parcel.\nUse this if the original label is damaged, lost, or needs to be printed in a different format."
1919
}
2020
],
2121
displayMessage: [
@@ -33,7 +33,7 @@ export default (sdk: ActionSdk) => {
3333
description: [
3434
{
3535
code: "en-US",
36-
content: "Reprints the label for an existing parcel. Use this if the original label is damaged, lost, or needs to be printed in a different format.",
36+
content: "Reprints the label for an existing parcel.\nUse this if the original label is damaged, lost, or needs to be printed in a different format.",
3737
}
3838
],
3939
signature: "(data: GLS_REPRINT_PARCEL_REQUEST_DATA): GLS_REPRINT_PARCEL_RESPONSE_DATA",

actions/gls-action/src/functions/validateShipment.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ export default (sdk: ActionSdk) => {
1515
documentation: [
1616
{
1717
code: "en-US",
18-
content: "Validates a shipment against the GLS API without creating it. Use this before `createShipment` functions to catch errors early."
18+
content: "Validates a shipment against the GLS API without creating it.\nUse this before `createShipment` functions to catch errors early."
1919
}
2020
],
2121
displayMessage: [
@@ -33,7 +33,7 @@ export default (sdk: ActionSdk) => {
3333
description: [
3434
{
3535
code: "en-US",
36-
content: "Validates a shipment against the GLS API without creating it. Use this before `createShipment` functions to catch errors early.",
36+
content: "Validates a shipment against the GLS API without creating it.\nUse this before `createShipment` functions to catch errors early.",
3737
}
3838
],
3939
signature: "(data: GLS_VALIDATE_SHIPMENT_REQUEST_DATA): GLS_VALIDATE_SHIPMENT_RESPONSE_DATA",

docs/Actions/GLS/functions.mdx

Lines changed: 8 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,6 @@ The GLS Action exposes functions grouped into three categories:
1313

1414
## Builder functions
1515

16-
1716
### `createShipmentUnit`
1817

1918
| Parameter | Name | Type | Required | Description |
@@ -27,8 +26,6 @@ The GLS Action exposes functions grouped into three categories:
2726

2827
Return Type: [GLS_SHIPMENT_UNIT](./types.mdx#gls_shipment_unit)
2928

30-
#
31-
3229
Creates a GLS shipment unit (an individual parcel within a shipment).
3330

3431
<FunctionCard definition={
@@ -159,8 +156,6 @@ Creates a GLS shipment unit (an individual parcel within a shipment).
159156

160157
Return Type: [GLS_PRINTING_OPTIONS](./types.mdx#gls_printing_options)
161158

162-
#
163-
164159
Creates GLS printing options that control how labels are generated.
165160

166161
<FunctionCard definition={
@@ -220,8 +215,6 @@ Creates GLS printing options that control how labels are generated.
220215

221216
Return Type: [GLS_CUSTOM_CONTENT](./types.mdx#gls_custom_content)
222217

223-
#
224-
225218
Creates custom content settings for GLS labels, including logos and barcodes.
226219

227220
<FunctionCard definition={
@@ -340,8 +333,6 @@ Creates custom content settings for GLS labels, including logos and barcodes.
340333

341334
Return Type: [GLS_CONSIGNEE](./types.mdx#gls_consignee)
342335

343-
#
344-
345336
Creates a GLS consignee (recipient) object for use in shipments.
346337

347338
<FunctionCard definition={
@@ -454,8 +445,6 @@ Creates a GLS consignee (recipient) object for use in shipments.
454445

455446
Return Type: [GLS_ADDRESS](./types.mdx#gls_address)
456447

457-
#
458-
459448
Creates a GLS address object (`GLS_ADDRESS`) for use in shipments as consignee, shipper, or return address.
460449

461450
<FunctionCard definition={
@@ -685,7 +674,8 @@ Creates a GLS address object (`GLS_ADDRESS`) for use in shipments as consignee,
685674

686675
## Shipment functions
687676

688-
All shipment functions accept a common set of parameters in addition to their type-specific parameters. They call the GLS ShipIT API (`POST /rs/shipments`) and return a `GLS_CREATE_PARCELS_RESPONSE`.
677+
All shipment functions accept a common set of parameters in addition to their type-specific parameters.
678+
They call the GLS ShipIT API (`POST /rs/shipments`) and return a `GLS_CREATE_PARCELS_RESPONSE`.
689679

690680
**Common parameters for all shipment functions:**
691681

@@ -698,7 +688,6 @@ All shipment functions accept a common set of parameters in addition to their ty
698688

699689
---
700690

701-
702691
### `createTyreShipment`
703692

704693
| Parameter | Name | Type | Required | Description |
@@ -710,8 +699,6 @@ All shipment functions accept a common set of parameters in addition to their ty
710699

711700
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
712701

713-
#
714-
715702
Creates a shipment specifically for tyre/wheel delivery (uses the GLS TyreService).
716703

717704
<FunctionCard definition={
@@ -815,8 +802,6 @@ Creates a shipment specifically for tyre/wheel delivery (uses the GLS TyreServic
815802

816803
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
817804

818-
#
819-
820805
Creates a shipment that requires a recipient signature upon delivery.
821806

822807
<FunctionCard definition={
@@ -922,8 +907,6 @@ Creates a shipment that requires a recipient signature upon delivery.
922907

923908
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
924909

925-
#
926-
927910
Creates a return shipment from a GLS Parcel Shop (customer drops off parcel at a shop).
928911

929912
<FunctionCard definition={
@@ -1058,8 +1041,6 @@ Creates a return shipment from a GLS Parcel Shop (customer drops off parcel at a
10581041

10591042
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
10601043

1061-
#
1062-
10631044
Delivers a parcel to a GLS Parcel Shop where the recipient can collect it.
10641045

10651046
<FunctionCard definition={
@@ -1179,8 +1160,6 @@ Delivers a parcel to a GLS Parcel Shop where the recipient can collect it.
11791160

11801161
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
11811162

1182-
#
1183-
11841163
Schedules a pickup from the consignee's address on a given date.
11851164

11861165
<FunctionCard definition={
@@ -1303,8 +1282,6 @@ Schedules a pickup from the consignee's address on a given date.
13031282

13041283
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
13051284

1306-
#
1307-
13081285
Delivers a parcel with identity verification - the driver checks the recipient's ID document.
13091286

13101287
<FunctionCard definition={
@@ -1470,8 +1447,6 @@ Delivers a parcel with identity verification - the driver checks the recipient's
14701447

14711448
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
14721449

1473-
#
1474-
14751450
Delivers a parcel with PIN and optional birthdate verification.
14761451

14771452
<FunctionCard definition={
@@ -1605,8 +1580,6 @@ Delivers a parcel with PIN and optional birthdate verification.
16051580

16061581
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
16071582

1608-
#
1609-
16101583
Creates a shipment with guaranteed delivery within 24 hours.
16111584

16121585
<FunctionCard definition={
@@ -1710,8 +1683,6 @@ Creates a shipment with guaranteed delivery within 24 hours.
17101683

17111684
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
17121685

1713-
#
1714-
17151686
Creates a shipment with flexible delivery - the recipient can redirect or reschedule delivery.
17161687

17171688
<FunctionCard definition={
@@ -1817,8 +1788,6 @@ Creates a shipment with flexible delivery - the recipient can redirect or resche
18171788

18181789
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
18191790

1820-
#
1821-
18221791
Delivers a new parcel while simultaneously picking up an existing one (exchange).
18231792

18241793
<FunctionCard definition={
@@ -1953,8 +1922,6 @@ Delivers a new parcel while simultaneously picking up an existing one (exchange)
19531922

19541923
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
19551924

1956-
#
1957-
19581925
Delivers a parcel to a designated deposit location (e.g. a garage or shed) without requiring a signature.
19591926

19601927
<FunctionCard definition={
@@ -2073,8 +2040,6 @@ Delivers a parcel to a designated deposit location (e.g. a garage or shed) witho
20732040

20742041
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
20752042

2076-
#
2077-
20782043
Creates an EXPRESS shipment for Saturday delivery.
20792044

20802045
<FunctionCard definition={
@@ -2178,8 +2143,6 @@ Creates an EXPRESS shipment for Saturday delivery.
21782143

21792144
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
21802145

2181-
#
2182-
21832146
Creates an EXPRESS shipment for delivery on the next working day (EOB service).
21842147

21852148
<FunctionCard definition={
@@ -2289,8 +2252,6 @@ Creates an EXPRESS shipment for delivery on the next working day (EOB service).
22892252

22902253
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
22912254

2292-
#
2293-
22942255
Delivers a parcel to a specific location within a workplace (building, floor, room).
22952256

22962257
<FunctionCard definition={
@@ -2484,8 +2445,6 @@ Delivers a parcel to a specific location within a workplace (building, floor, ro
24842445

24852446
Return Type: [GLS_CREATE_PARCELS_RESPONSE](./types.mdx#gls_create_parcels_response)
24862447

2487-
#
2488-
24892448
Creates a shipment that can only be delivered to the named addressee (no neighbor delivery).
24902449

24912450
<FunctionCard definition={
@@ -2580,7 +2539,6 @@ Creates a shipment that can only be delivered to the named addressee (no neighbo
25802539

25812540
## API functions
25822541

2583-
25842542
### `validateShipment`
25852543

25862544
| Parameter | Name | Type | Required | Description |
@@ -2589,16 +2547,15 @@ Creates a shipment that can only be delivered to the named addressee (no neighbo
25892547

25902548
Return Type: [GLS_VALIDATE_SHIPMENT_RESPONSE_DATA](./types.mdx#gls_validate_shipment_response_data)
25912549

2592-
#
2593-
2594-
Validates a shipment against the GLS API without creating it. Use this before `createShipment` functions to catch errors early.
2550+
Validates a shipment against the GLS API without creating it.
2551+
Use this before `createShipment` functions to catch errors early.
25952552

25962553
<FunctionCard definition={
25972554
{
25982555
"descriptions": [
25992556
{
26002557
"code": "en-US",
2601-
"content": "Validates a shipment against the GLS API without creating it. Use this before `createShipment` functions to catch errors early."
2558+
"content": "Validates a shipment against the GLS API without creating it.\nUse this before `createShipment` functions to catch errors early."
26022559
}
26032560
],
26042561
"names": [
@@ -2646,8 +2603,6 @@ Validates a shipment against the GLS API without creating it. Use this before `c
26462603

26472604
Return Type: [GLS_END_OF_DAY_RESPONSE_DATA](./types.mdx#gls_end_of_day_response_data)
26482605

2649-
#
2650-
26512606
Updates the weight of an already-created parcel. Useful when the final weight is only known after packaging.
26522607

26532608
<FunctionCard definition={
@@ -2703,16 +2658,15 @@ Updates the weight of an already-created parcel. Useful when the final weight is
27032658

27042659
Return Type: [GLS_REPRINT_PARCEL_RESPONSE_DATA](./types.mdx#gls_reprint_parcel_response_data)
27052660

2706-
#
2707-
2708-
Reprints the label for an existing parcel. Use this if the original label is damaged, lost, or needs to be printed in a different format.
2661+
Reprints the label for an existing parcel.
2662+
Use this if the original label is damaged, lost, or needs to be printed in a different format.
27092663

27102664
<FunctionCard definition={
27112665
{
27122666
"descriptions": [
27132667
{
27142668
"code": "en-US",
2715-
"content": "Reprints the label for an existing parcel. Use this if the original label is damaged, lost, or needs to be printed in a different format."
2669+
"content": "Reprints the label for an existing parcel.\nUse this if the original label is damaged, lost, or needs to be printed in a different format."
27162670
}
27172671
],
27182672
"names": [
@@ -2760,8 +2714,6 @@ Reprints the label for an existing parcel. Use this if the original label is dam
27602714

27612715
Return Type: [GLS_END_OF_DAY_RESPONSE_DATA](./types.mdx#gls_end_of_day_response_data)
27622716

2763-
#
2764-
27652717
Retrieves all shipments dispatched on a given date. Useful for reconciliation and end-of-day processing.
27662718

27672719
<FunctionCard definition={
@@ -2817,8 +2769,6 @@ Retrieves all shipments dispatched on a given date. Useful for reconciliation an
28172769

28182770
Return Type: [GLS_ALLOWED_SERVICES_RESPONSE_DATA](./types.mdx#gls_allowed_services_response_data)
28192771

2820-
#
2821-
28222772
Returns the GLS services available for a given origin/destination country and ZIP code combination.
28232773

28242774
<FunctionCard definition={
@@ -2874,8 +2824,6 @@ Returns the GLS services available for a given origin/destination country and ZI
28742824

28752825
Return Type: [GLS_CANCEL_SHIPMENT_RESPONSE_DATA](./types.mdx#gls_cancel_shipment_response_data)
28762826

2877-
#
2878-
28792827
Cancels an existing shipment by its Track ID. Only possible if the parcel has not yet been scanned.
28802828

28812829
<FunctionCard definition={

0 commit comments

Comments
 (0)