@shippo/shippo-mcp 0.8.39 → 0.8.48
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/mcp-server.js +125 -40
- package/bin/mcp-server.js.map +17 -17
- package/esm/funcs/batchesCreate.d.ts +9 -0
- package/esm/funcs/batchesCreate.d.ts.map +1 -1
- package/esm/funcs/batchesCreate.js +9 -0
- package/esm/funcs/batchesCreate.js.map +1 -1
- package/esm/funcs/batchesGet.d.ts +9 -4
- package/esm/funcs/batchesGet.d.ts.map +1 -1
- package/esm/funcs/batchesGet.js +9 -4
- package/esm/funcs/batchesGet.js.map +1 -1
- package/esm/lib/config.d.ts +2 -2
- package/esm/lib/config.js +2 -2
- package/esm/mcp-server/mcp-server.js +1 -1
- package/esm/mcp-server/server.js +1 -1
- package/esm/mcp-server/tools/batchesCreate.d.ts.map +1 -1
- package/esm/mcp-server/tools/batchesCreate.js +11 -1
- package/esm/mcp-server/tools/batchesCreate.js.map +1 -1
- package/esm/mcp-server/tools/batchesGet.d.ts.map +1 -1
- package/esm/mcp-server/tools/batchesGet.js +10 -4
- package/esm/mcp-server/tools/batchesGet.js.map +1 -1
- package/esm/mcp-server/tools/manifestsGet.d.ts.map +1 -1
- package/esm/mcp-server/tools/manifestsGet.js +10 -3
- package/esm/mcp-server/tools/manifestsGet.js.map +1 -1
- package/esm/mcp-server/tools/manifestsList.d.ts.map +1 -1
- package/esm/mcp-server/tools/manifestsList.js +10 -3
- package/esm/mcp-server/tools/manifestsList.js.map +1 -1
- package/esm/mcp-server/tools/trackingStatusGet.d.ts.map +1 -1
- package/esm/mcp-server/tools/trackingStatusGet.js +5 -0
- package/esm/mcp-server/tools/trackingStatusGet.js.map +1 -1
- package/esm/mcp-server/tools/transactionsCreate.d.ts.map +1 -1
- package/esm/mcp-server/tools/transactionsCreate.js +12 -0
- package/esm/mcp-server/tools/transactionsCreate.js.map +1 -1
- package/esm/mcp-server/tools/transactionsGet.d.ts.map +1 -1
- package/esm/mcp-server/tools/transactionsGet.js +7 -0
- package/esm/mcp-server/tools/transactionsGet.js.map +1 -1
- package/esm/mcp-server/tools/transactionsList.d.ts.map +1 -1
- package/esm/mcp-server/tools/transactionsList.js +7 -0
- package/esm/mcp-server/tools/transactionsList.js.map +1 -1
- package/esm/models/order.d.ts +39 -11
- package/esm/models/order.d.ts.map +1 -1
- package/esm/models/order.js +36 -11
- package/esm/models/order.js.map +1 -1
- package/esm/models/ordercreaterequest.d.ts +10 -10
- package/esm/models/ordercreaterequest.d.ts.map +1 -1
- package/esm/models/ordercreaterequest.js +10 -10
- package/esm/models/ordercreaterequest.js.map +1 -1
- package/manifest.json +9 -9
- package/package.json +1 -1
- package/src/funcs/batchesCreate.ts +9 -0
- package/src/funcs/batchesGet.ts +9 -4
- package/src/lib/config.ts +2 -2
- package/src/mcp-server/mcp-server.ts +1 -1
- package/src/mcp-server/server.ts +1 -1
- package/src/mcp-server/tools/batchesCreate.ts +11 -1
- package/src/mcp-server/tools/batchesGet.ts +10 -4
- package/src/mcp-server/tools/manifestsGet.ts +10 -3
- package/src/mcp-server/tools/manifestsList.ts +10 -3
- package/src/mcp-server/tools/trackingStatusGet.ts +5 -0
- package/src/mcp-server/tools/transactionsCreate.ts +12 -0
- package/src/mcp-server/tools/transactionsGet.ts +7 -0
- package/src/mcp-server/tools/transactionsList.ts +7 -0
- package/src/models/order.ts +84 -22
- package/src/models/ordercreaterequest.ts +20 -20
|
@@ -12,6 +12,15 @@ import { Result } from "../types/fp.js";
|
|
|
12
12
|
*
|
|
13
13
|
* @remarks
|
|
14
14
|
* Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.
|
|
15
|
+
*
|
|
16
|
+
* **IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
|
|
17
|
+
* You must store the batch `object_id` returned from this endpoint to retrieve batches later using `batches-get`.
|
|
18
|
+
*
|
|
19
|
+
* **Workflow:**
|
|
20
|
+
* 1. Create batch → Save the returned `object_id`
|
|
21
|
+
* 2. Retrieve batch status using `batches-get` with the saved ID
|
|
22
|
+
* 3. Add/remove shipments as needed
|
|
23
|
+
* 4. Purchase the batch when ready
|
|
15
24
|
*/
|
|
16
25
|
export declare function batchesCreate(client$: ShippoSDKCore, request: BatchCreateRequest, options?: RequestOptions): APIPromise<Result<CreateBatchResponse, APIError | SDKValidationError | UnexpectedClientError | InvalidRequestError | RequestAbortedError | RequestTimeoutError | ConnectionError>>;
|
|
17
26
|
//# sourceMappingURL=batchesCreate.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batchesCreate.d.ts","sourceRoot":"","sources":["../../src/funcs/batchesCreate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,kBAAkB,EAEnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC
|
|
1
|
+
{"version":3,"file":"batchesCreate.d.ts","sourceRoot":"","sources":["../../src/funcs/batchesCreate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,kBAAkB,EAEnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,mBAAmB,EACjB,QAAQ,GACR,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,CAClB,CACF,CAMA"}
|
|
@@ -15,6 +15,15 @@ import { APIPromise } from "../types/async.js";
|
|
|
15
15
|
*
|
|
16
16
|
* @remarks
|
|
17
17
|
* Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.
|
|
18
|
+
*
|
|
19
|
+
* **IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
|
|
20
|
+
* You must store the batch `object_id` returned from this endpoint to retrieve batches later using `batches-get`.
|
|
21
|
+
*
|
|
22
|
+
* **Workflow:**
|
|
23
|
+
* 1. Create batch → Save the returned `object_id`
|
|
24
|
+
* 2. Retrieve batch status using `batches-get` with the saved ID
|
|
25
|
+
* 3. Add/remove shipments as needed
|
|
26
|
+
* 4. Purchase the batch when ready
|
|
18
27
|
*/
|
|
19
28
|
export function batchesCreate(client$, request, options) {
|
|
20
29
|
return new APIPromise($do(client$, request, options));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batchesCreate.js","sourceRoot":"","sources":["../../src/funcs/batchesCreate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,CAAC,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAEL,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGxD
|
|
1
|
+
{"version":3,"file":"batchesCreate.js","sourceRoot":"","sources":["../../src/funcs/batchesCreate.ts"],"names":[],"mappings":"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"}
|
|
@@ -10,10 +10,15 @@ import { Result } from "../types/fp.js";
|
|
|
10
10
|
* Retrieve a batch
|
|
11
11
|
*
|
|
12
12
|
* @remarks
|
|
13
|
-
* Returns a batch using an object ID.
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
13
|
+
* Returns a batch using an object ID. Batch shipments are displayed 100 at a time. You can iterate through each `page` using the `?page=` query parameter. You can also filter based on batch shipment status, for example, by passing a query param like `?object_results=creation_failed`.
|
|
14
|
+
*
|
|
15
|
+
* **IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
|
|
16
|
+
* You must know the batch `object_id` (returned when you created the batch) to retrieve it.
|
|
17
|
+
* Store batch IDs when creating batches if you need to access them later.
|
|
18
|
+
*
|
|
19
|
+
* **URL HANDLING:** This response contains `label_url` (array of download URLs).
|
|
20
|
+
* When displaying URLs, ALWAYS show the complete URL without truncation.
|
|
21
|
+
* Never replace parts with "..." - S3 signed URLs will break if truncated.
|
|
17
22
|
*/
|
|
18
23
|
export declare function batchesGet(client$: ShippoSDKCore, request: GetBatchRequest, options?: RequestOptions): APIPromise<Result<GetBatchResponse, APIError | SDKValidationError | UnexpectedClientError | InvalidRequestError | RequestAbortedError | RequestTimeoutError | ConnectionError>>;
|
|
19
24
|
//# sourceMappingURL=batchesGet.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batchesGet.d.ts","sourceRoot":"","sources":["../../src/funcs/batchesGet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EACL,eAAe,EAEf,gBAAgB,EAEjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC
|
|
1
|
+
{"version":3,"file":"batchesGet.d.ts","sourceRoot":"","sources":["../../src/funcs/batchesGet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EACL,eAAe,EAEf,gBAAgB,EAEjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,gBAAgB,EACd,QAAQ,GACR,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,CAClB,CACF,CAMA"}
|
package/esm/funcs/batchesGet.js
CHANGED
|
@@ -13,10 +13,15 @@ import { APIPromise } from "../types/async.js";
|
|
|
13
13
|
* Retrieve a batch
|
|
14
14
|
*
|
|
15
15
|
* @remarks
|
|
16
|
-
* Returns a batch using an object ID.
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
16
|
+
* Returns a batch using an object ID. Batch shipments are displayed 100 at a time. You can iterate through each `page` using the `?page=` query parameter. You can also filter based on batch shipment status, for example, by passing a query param like `?object_results=creation_failed`.
|
|
17
|
+
*
|
|
18
|
+
* **IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
|
|
19
|
+
* You must know the batch `object_id` (returned when you created the batch) to retrieve it.
|
|
20
|
+
* Store batch IDs when creating batches if you need to access them later.
|
|
21
|
+
*
|
|
22
|
+
* **URL HANDLING:** This response contains `label_url` (array of download URLs).
|
|
23
|
+
* When displaying URLs, ALWAYS show the complete URL without truncation.
|
|
24
|
+
* Never replace parts with "..." - S3 signed URLs will break if truncated.
|
|
20
25
|
*/
|
|
21
26
|
export function batchesGet(client$, request, options) {
|
|
22
27
|
return new APIPromise($do(client$, request, options));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batchesGet.js","sourceRoot":"","sources":["../../src/funcs/batchesGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,CAAC,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAU3C,OAAO,EAEL,yBAAyB,EAEzB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGxD
|
|
1
|
+
{"version":3,"file":"batchesGet.js","sourceRoot":"","sources":["../../src/funcs/batchesGet.ts"],"names":[],"mappings":"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"}
|
package/esm/lib/config.d.ts
CHANGED
|
@@ -39,8 +39,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
|
|
|
39
39
|
export declare const SDK_METADATA: {
|
|
40
40
|
readonly language: "typescript";
|
|
41
41
|
readonly openapiDocVersion: "2018-02-08";
|
|
42
|
-
readonly sdkVersion: "0.8.
|
|
42
|
+
readonly sdkVersion: "0.8.48";
|
|
43
43
|
readonly genVersion: "2.770.0";
|
|
44
|
-
readonly userAgent: "speakeasy-sdk/mcp-typescript 0.8.
|
|
44
|
+
readonly userAgent: "speakeasy-sdk/mcp-typescript 0.8.48 2.770.0 2018-02-08 @shippo/shippo-mcp";
|
|
45
45
|
};
|
|
46
46
|
//# sourceMappingURL=config.d.ts.map
|
package/esm/lib/config.js
CHANGED
|
@@ -24,8 +24,8 @@ export function serverURLFromOptions(options) {
|
|
|
24
24
|
export const SDK_METADATA = {
|
|
25
25
|
language: "typescript",
|
|
26
26
|
openapiDocVersion: "2018-02-08",
|
|
27
|
-
sdkVersion: "0.8.
|
|
27
|
+
sdkVersion: "0.8.48",
|
|
28
28
|
genVersion: "2.770.0",
|
|
29
|
-
userAgent: "speakeasy-sdk/mcp-typescript 0.8.
|
|
29
|
+
userAgent: "speakeasy-sdk/mcp-typescript 0.8.48 2.770.0 2018-02-08 @shippo/shippo-mcp",
|
|
30
30
|
};
|
|
31
31
|
//# sourceMappingURL=config.js.map
|
package/esm/mcp-server/server.js
CHANGED
|
@@ -79,7 +79,7 @@ import { tool$webhooksUpdate } from "./tools/webhooksUpdate.js";
|
|
|
79
79
|
export function createMCPServer(deps) {
|
|
80
80
|
const server = new McpServer({
|
|
81
81
|
name: "ShippoSDK",
|
|
82
|
-
version: "0.8.
|
|
82
|
+
version: "0.8.48",
|
|
83
83
|
});
|
|
84
84
|
const getClient = deps.getSDK || (() => new ShippoSDKCore({
|
|
85
85
|
security: deps.security,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batchesCreate.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/batchesCreate.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,IAAI,
|
|
1
|
+
{"version":3,"file":"batchesCreate.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/batchesCreate.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,IAAI,CAyC1D,CAAC"}
|
|
@@ -11,7 +11,17 @@ export const tool$batchesCreate = {
|
|
|
11
11
|
name: "batches-create",
|
|
12
12
|
description: `Create a batch
|
|
13
13
|
|
|
14
|
-
Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid
|
|
14
|
+
Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.
|
|
15
|
+
|
|
16
|
+
**IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
|
|
17
|
+
You must store the batch \`object_id\` returned from this endpoint to retrieve batches later using \`batches-get\`.
|
|
18
|
+
|
|
19
|
+
**Workflow:**
|
|
20
|
+
1. Create batch → Save the returned \`object_id\`
|
|
21
|
+
2. Retrieve batch status using \`batches-get\` with the saved ID
|
|
22
|
+
3. Add/remove shipments as needed
|
|
23
|
+
4. Purchase the batch when ready
|
|
24
|
+
`,
|
|
15
25
|
annotations: {
|
|
16
26
|
"title": "",
|
|
17
27
|
"destructiveHint": false,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batchesCreate.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/batchesCreate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,4BAA4B;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE
|
|
1
|
+
{"version":3,"file":"batchesCreate.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/batchesCreate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,4BAA4B;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;;;;;CAYd;IACC,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,aAAa,CAC3C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batchesGet.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/batchesGet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,IAAI,
|
|
1
|
+
{"version":3,"file":"batchesGet.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/batchesGet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,IAAI,CAwCvD,CAAC"}
|
|
@@ -11,10 +11,16 @@ export const tool$batchesGet = {
|
|
|
11
11
|
name: "batches-get",
|
|
12
12
|
description: `Retrieve a batch
|
|
13
13
|
|
|
14
|
-
Returns a batch using an object ID.
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
14
|
+
Returns a batch using an object ID. Batch shipments are displayed 100 at a time. You can iterate through each \`page\` using the \`?page=\` query parameter. You can also filter based on batch shipment status, for example, by passing a query param like \`?object_results=creation_failed\`.
|
|
15
|
+
|
|
16
|
+
**IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
|
|
17
|
+
You must know the batch \`object_id\` (returned when you created the batch) to retrieve it.
|
|
18
|
+
Store batch IDs when creating batches if you need to access them later.
|
|
19
|
+
|
|
20
|
+
**URL HANDLING:** This response contains \`label_url\` (array of download URLs).
|
|
21
|
+
When displaying URLs, ALWAYS show the complete URL without truncation.
|
|
22
|
+
Never replace parts with "..." - S3 signed URLs will break if truncated.
|
|
23
|
+
`,
|
|
18
24
|
annotations: {
|
|
19
25
|
"title": "",
|
|
20
26
|
"destructiveHint": false,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batchesGet.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/batchesGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,yBAAyB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE
|
|
1
|
+
{"version":3,"file":"batchesGet.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/batchesGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,yBAAyB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;CAWd;IACC,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,UAAU,CACxC,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manifestsGet.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/manifestsGet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,OAAO,IAAI,
|
|
1
|
+
{"version":3,"file":"manifestsGet.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/manifestsGet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,OAAO,IAAI,CAsCzD,CAAC"}
|
|
@@ -9,15 +9,22 @@ const args = {
|
|
|
9
9
|
};
|
|
10
10
|
export const tool$manifestsGet = {
|
|
11
11
|
name: "manifests-get",
|
|
12
|
-
description: `
|
|
12
|
+
description: `Returns an existing manifest using an object ID.
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
**⚠️ URL HANDLING - CRITICAL:**
|
|
15
|
+
The manifest contains a \`documents\` field with URLs to scan form PDFs.
|
|
16
|
+
When displaying these URLs:
|
|
17
|
+
- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
|
|
18
|
+
- These are S3 signed URLs that break if modified
|
|
19
|
+
- Display URLs in a code block AND as a clickable hyperlink
|
|
20
|
+
`,
|
|
21
|
+
scopes: ["read"],
|
|
15
22
|
annotations: {
|
|
16
23
|
"title": "",
|
|
17
24
|
"destructiveHint": false,
|
|
18
25
|
"idempotentHint": false,
|
|
19
26
|
"openWorldHint": false,
|
|
20
|
-
"readOnlyHint":
|
|
27
|
+
"readOnlyHint": false,
|
|
21
28
|
},
|
|
22
29
|
args,
|
|
23
30
|
tool: async (client, args, ctx) => {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manifestsGet.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/manifestsGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,4BAA4B;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE
|
|
1
|
+
{"version":3,"file":"manifestsGet.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/manifestsGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,4BAA4B;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;CAQd;IACC,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,YAAY,CAC1C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manifestsList.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/manifestsList.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,IAAI,
|
|
1
|
+
{"version":3,"file":"manifestsList.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/manifestsList.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,IAAI,CAsC1D,CAAC"}
|
|
@@ -9,15 +9,22 @@ const args = {
|
|
|
9
9
|
};
|
|
10
10
|
export const tool$manifestsList = {
|
|
11
11
|
name: "manifests-list",
|
|
12
|
-
description: `
|
|
12
|
+
description: `Returns a list of all manifest objects.
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
**⚠️ URL HANDLING - CRITICAL:**
|
|
15
|
+
Each manifest contains a \`documents\` field with URLs to scan form PDFs.
|
|
16
|
+
When displaying these URLs:
|
|
17
|
+
- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
|
|
18
|
+
- These are S3 signed URLs that break if modified
|
|
19
|
+
- Display URLs in a code block AND as a clickable hyperlink
|
|
20
|
+
`,
|
|
21
|
+
scopes: ["read"],
|
|
15
22
|
annotations: {
|
|
16
23
|
"title": "",
|
|
17
24
|
"destructiveHint": false,
|
|
18
25
|
"idempotentHint": false,
|
|
19
26
|
"openWorldHint": false,
|
|
20
|
-
"readOnlyHint":
|
|
27
|
+
"readOnlyHint": false,
|
|
21
28
|
},
|
|
22
29
|
args,
|
|
23
30
|
tool: async (client, args, ctx) => {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manifestsList.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/manifestsList.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,8BAA8B,CAAC,QAAQ,EAAE;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE
|
|
1
|
+
{"version":3,"file":"manifestsList.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/manifestsList.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,8BAA8B,CAAC,QAAQ,EAAE;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;CAQd;IACC,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,aAAa,CAC3C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"trackingStatusGet.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/trackingStatusGet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAAc,CAAC,OAAO,IAAI,
|
|
1
|
+
{"version":3,"file":"trackingStatusGet.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/trackingStatusGet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAAc,CAAC,OAAO,IAAI,CA2D9D,CAAC"}
|
|
@@ -32,6 +32,11 @@ not the actual carrier names like 'USPS', 'UPS', 'FedEx', etc.
|
|
|
32
32
|
\`\`\`
|
|
33
33
|
|
|
34
34
|
The API will return an error if you use real carrier names with test tokens.
|
|
35
|
+
|
|
36
|
+
**⚠️ URL HANDLING - CRITICAL:**
|
|
37
|
+
The response may include tracking URLs. When displaying any URLs:
|
|
38
|
+
- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
|
|
39
|
+
- Display URLs in a code block AND as a clickable hyperlink
|
|
35
40
|
`,
|
|
36
41
|
scopes: ["read", "tracking"],
|
|
37
42
|
annotations: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"trackingStatusGet.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/trackingStatusGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,yBAAyB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAgC;IACjE,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT
|
|
1
|
+
{"version":3,"file":"trackingStatusGet.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/trackingStatusGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,yBAAyB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAgC;IACjE,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BH;IACC,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,iBAAiB,CAC/C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transactionsCreate.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsCreate.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,OAAO,IAAI,
|
|
1
|
+
{"version":3,"file":"transactionsCreate.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsCreate.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,OAAO,IAAI,CAmH/D,CAAC"}
|
|
@@ -82,6 +82,18 @@ First create a shipment to get rates, then use this tool with the rate ID.
|
|
|
82
82
|
- \`QUEUED\` → Processing (keep polling)
|
|
83
83
|
- \`SUCCESS\` → ✅ Label ready! Check label_url and tracking_number
|
|
84
84
|
- \`ERROR\` → ❌ Check messages for details
|
|
85
|
+
|
|
86
|
+
**⚠️ URL HANDLING - CRITICAL:**
|
|
87
|
+
When transaction succeeds, the response includes:
|
|
88
|
+
- \`label_url\`: S3 signed URL for shipping label download
|
|
89
|
+
- \`qr_code_url\`: QR code image URL (if requested)
|
|
90
|
+
- \`tracking_url_provider\`: Carrier's tracking page URL
|
|
91
|
+
|
|
92
|
+
**When displaying these URLs:**
|
|
93
|
+
- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
|
|
94
|
+
- S3 signed URLs contain required query parameters (Signature, Expires, AWSAccessKeyId)
|
|
95
|
+
- Truncating these URLs will make them non-functional
|
|
96
|
+
- Display URLs in a code block AND as a clickable hyperlink
|
|
85
97
|
`,
|
|
86
98
|
scopes: ["write"],
|
|
87
99
|
annotations: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transactionsCreate.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsCreate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,kCAAkC;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAgC;IAClE,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE
|
|
1
|
+
{"version":3,"file":"transactionsCreate.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsCreate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,kCAAkC;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAgC;IAClE,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFd;IACC,MAAM,EAAE,CAAC,OAAO,CAAC;IACjB,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,kBAAkB,CAChD,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transactionsGet.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsGet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,OAAO,IAAI,
|
|
1
|
+
{"version":3,"file":"transactionsGet.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsGet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,OAAO,IAAI,CAmE5D,CAAC"}
|
|
@@ -39,6 +39,13 @@ export const tool$transactionsGet = {
|
|
|
39
39
|
|
|
40
40
|
**Required Parameter:**
|
|
41
41
|
- \`TransactionId\`: The transaction object ID from transaction creation
|
|
42
|
+
|
|
43
|
+
**⚠️ URL HANDLING - CRITICAL:**
|
|
44
|
+
When displaying URLs from this response (label_url, qr_code_url, tracking_url_provider):
|
|
45
|
+
- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
|
|
46
|
+
- These are S3 signed URLs with required query parameters (Signature, Expires, AWSAccessKeyId)
|
|
47
|
+
- Truncating these URLs will make them non-functional
|
|
48
|
+
- Display URLs in a code block AND as a clickable hyperlink
|
|
42
49
|
`,
|
|
43
50
|
scopes: ["read"],
|
|
44
51
|
annotations: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transactionsGet.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,+BAA+B;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgC;IAC/D,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE
|
|
1
|
+
{"version":3,"file":"transactionsGet.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsGet.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,+BAA+B;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgC;IAC/D,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCd;IACC,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,eAAe,CAC7C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transactionsList.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsList.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,OAAO,IAAI,
|
|
1
|
+
{"version":3,"file":"transactionsList.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsList.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,OAAO,IAAI,CAsE7D,CAAC"}
|
|
@@ -41,6 +41,13 @@ This tool lists transaction objects, which represent purchased shipping labels.
|
|
|
41
41
|
|
|
42
42
|
**Note on Test Mode:**
|
|
43
43
|
Test transactions will always show \`tracking_status: "UNKNOWN"\` because they don't receive real carrier tracking updates.
|
|
44
|
+
|
|
45
|
+
**⚠️ URL HANDLING - CRITICAL:**
|
|
46
|
+
Each transaction may include URLs (label_url, qr_code_url, tracking_url_provider).
|
|
47
|
+
When displaying these URLs:
|
|
48
|
+
- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
|
|
49
|
+
- These are S3 signed URLs that break if modified
|
|
50
|
+
- Display URLs in a code block AND as a clickable hyperlink
|
|
44
51
|
`,
|
|
45
52
|
scopes: ["read"],
|
|
46
53
|
annotations: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transactionsList.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsList.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,iCAAiC,CAAC,QAAQ,EAAE;CACtD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgC;IAChE,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT
|
|
1
|
+
{"version":3,"file":"transactionsList.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/transactionsList.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,iCAAiC,CAAC,QAAQ,EAAE;CACtD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgC;IAChE,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCH;IACC,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,WAAW,EAAE;QACX,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,gBAAgB,CAC9C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}
|
package/esm/models/order.d.ts
CHANGED
|
@@ -1,26 +1,54 @@
|
|
|
1
1
|
import * as z from "zod";
|
|
2
2
|
import { Address } from "./address.js";
|
|
3
|
+
import { AddressValidationResults } from "./addressvalidationresults.js";
|
|
3
4
|
import { LineItem } from "./lineitem.js";
|
|
4
5
|
import { OrderShopAppEnum } from "./ordershopappenum.js";
|
|
5
6
|
import { OrderStatusEnum } from "./orderstatusenum.js";
|
|
6
7
|
import { WeightUnitEnum } from "./weightunitenum.js";
|
|
8
|
+
/**
|
|
9
|
+
* <a href="#tag/Addresses">Address</a> object of the sender / seller. Will be returned expanded by default.
|
|
10
|
+
*/
|
|
11
|
+
export type OrderAddressFrom = {
|
|
12
|
+
name?: string | undefined;
|
|
13
|
+
company?: string | undefined;
|
|
14
|
+
street1?: string | undefined;
|
|
15
|
+
street2?: string | undefined;
|
|
16
|
+
street3?: string | undefined;
|
|
17
|
+
street_no?: string | undefined;
|
|
18
|
+
city?: string | undefined;
|
|
19
|
+
state?: string | undefined;
|
|
20
|
+
zip?: string | undefined;
|
|
21
|
+
country: string;
|
|
22
|
+
phone?: string | undefined;
|
|
23
|
+
email?: string | undefined;
|
|
24
|
+
is_residential?: boolean | null | undefined;
|
|
25
|
+
metadata?: string | undefined;
|
|
26
|
+
is_complete?: boolean | undefined;
|
|
27
|
+
object_created?: string | undefined;
|
|
28
|
+
object_id?: string | undefined;
|
|
29
|
+
object_owner?: string | undefined;
|
|
30
|
+
object_updated?: string | undefined;
|
|
31
|
+
validation_results?: AddressValidationResults | undefined;
|
|
32
|
+
test?: boolean | null | undefined;
|
|
33
|
+
};
|
|
34
|
+
export declare const OrderAddressFrom$zodSchema: z.ZodType<OrderAddressFrom, z.ZodTypeDef, unknown>;
|
|
7
35
|
export type OrderTransaction = {};
|
|
8
36
|
export declare const OrderTransaction$zodSchema: z.ZodType<OrderTransaction, z.ZodTypeDef, unknown>;
|
|
9
37
|
export type Order = {
|
|
10
|
-
currency?: string | undefined;
|
|
11
|
-
notes?: string | undefined;
|
|
12
|
-
order_number?: string | undefined;
|
|
38
|
+
currency?: string | null | undefined;
|
|
39
|
+
notes?: string | null | undefined;
|
|
40
|
+
order_number?: string | null | undefined;
|
|
13
41
|
order_status?: OrderStatusEnum | undefined;
|
|
14
42
|
placed_at: string;
|
|
15
|
-
shipping_cost?: string | undefined;
|
|
16
|
-
shipping_cost_currency?: string | undefined;
|
|
17
|
-
shipping_method?: string | undefined;
|
|
18
|
-
subtotal_price?: string | undefined;
|
|
19
|
-
total_price?: string | undefined;
|
|
20
|
-
total_tax?: string | undefined;
|
|
21
|
-
weight?: string | undefined;
|
|
43
|
+
shipping_cost?: string | null | undefined;
|
|
44
|
+
shipping_cost_currency?: string | null | undefined;
|
|
45
|
+
shipping_method?: string | null | undefined;
|
|
46
|
+
subtotal_price?: string | null | undefined;
|
|
47
|
+
total_price?: string | null | undefined;
|
|
48
|
+
total_tax?: string | null | undefined;
|
|
49
|
+
weight?: string | null | undefined;
|
|
22
50
|
weight_unit?: WeightUnitEnum | undefined;
|
|
23
|
-
from_address?:
|
|
51
|
+
from_address?: OrderAddressFrom | null | undefined;
|
|
24
52
|
to_address: Address;
|
|
25
53
|
line_items?: Array<LineItem> | undefined;
|
|
26
54
|
object_id?: string | undefined;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../src/models/order.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,OAAO,EAAqB,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAsB,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAElC,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAChD,gBAAgB,EAChB,CAAC,CAAC,UAAU,EACZ,OAAO,CACO,CAAC;AAEjB,MAAM,MAAM,KAAK,GAAG;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../src/models/order.ts"],"names":[],"mappings":"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"}
|
package/esm/models/order.js
CHANGED
|
@@ -3,32 +3,57 @@
|
|
|
3
3
|
*/
|
|
4
4
|
import * as z from "zod";
|
|
5
5
|
import { Address$zodSchema } from "./address.js";
|
|
6
|
+
import { AddressValidationResults$zodSchema, } from "./addressvalidationresults.js";
|
|
6
7
|
import { LineItem$zodSchema } from "./lineitem.js";
|
|
7
8
|
import { OrderShopAppEnum$zodSchema, } from "./ordershopappenum.js";
|
|
8
9
|
import { OrderStatusEnum$zodSchema, } from "./orderstatusenum.js";
|
|
9
10
|
import { WeightUnitEnum$zodSchema } from "./weightunitenum.js";
|
|
11
|
+
export const OrderAddressFrom$zodSchema = z.object({
|
|
12
|
+
city: z.string().optional(),
|
|
13
|
+
company: z.string().optional(),
|
|
14
|
+
country: z.string(),
|
|
15
|
+
email: z.string().optional(),
|
|
16
|
+
is_complete: z.boolean().optional(),
|
|
17
|
+
is_residential: z.boolean().nullable().optional(),
|
|
18
|
+
metadata: z.string().optional(),
|
|
19
|
+
name: z.string().optional(),
|
|
20
|
+
object_created: z.string().datetime({ offset: true }).optional(),
|
|
21
|
+
object_id: z.string().optional(),
|
|
22
|
+
object_owner: z.string().optional(),
|
|
23
|
+
object_updated: z.string().datetime({ offset: true }).optional(),
|
|
24
|
+
phone: z.string().optional(),
|
|
25
|
+
state: z.string().optional(),
|
|
26
|
+
street1: z.string().optional(),
|
|
27
|
+
street2: z.string().optional(),
|
|
28
|
+
street3: z.string().optional(),
|
|
29
|
+
street_no: z.string().optional(),
|
|
30
|
+
test: z.boolean().nullable().optional(),
|
|
31
|
+
validation_results: AddressValidationResults$zodSchema.optional(),
|
|
32
|
+
zip: z.string().optional(),
|
|
33
|
+
}).describe("<a href=\"#tag/Addresses\">Address</a> object of the sender / seller. Will be returned expanded by default.");
|
|
10
34
|
export const OrderTransaction$zodSchema = z.object({});
|
|
11
35
|
export const Order$zodSchema = z
|
|
12
36
|
.object({
|
|
13
|
-
currency: z.string().optional(),
|
|
14
|
-
from_address:
|
|
37
|
+
currency: z.string().nullable().optional(),
|
|
38
|
+
from_address: z.lazy(() => OrderAddressFrom$zodSchema).nullable()
|
|
39
|
+
.optional(),
|
|
15
40
|
line_items: z.array(LineItem$zodSchema).optional(),
|
|
16
|
-
notes: z.string().optional(),
|
|
41
|
+
notes: z.string().nullable().optional(),
|
|
17
42
|
object_id: z.string().optional(),
|
|
18
43
|
object_owner: z.string().optional(),
|
|
19
|
-
order_number: z.string().optional(),
|
|
44
|
+
order_number: z.string().nullable().optional(),
|
|
20
45
|
order_status: OrderStatusEnum$zodSchema.optional(),
|
|
21
46
|
placed_at: z.string(),
|
|
22
|
-
shipping_cost: z.string().optional(),
|
|
23
|
-
shipping_cost_currency: z.string().optional(),
|
|
24
|
-
shipping_method: z.string().optional(),
|
|
47
|
+
shipping_cost: z.string().nullable().optional(),
|
|
48
|
+
shipping_cost_currency: z.string().nullable().optional(),
|
|
49
|
+
shipping_method: z.string().nullable().optional(),
|
|
25
50
|
shop_app: OrderShopAppEnum$zodSchema.optional(),
|
|
26
|
-
subtotal_price: z.string().optional(),
|
|
51
|
+
subtotal_price: z.string().nullable().optional(),
|
|
27
52
|
to_address: Address$zodSchema,
|
|
28
|
-
total_price: z.string().optional(),
|
|
29
|
-
total_tax: z.string().optional(),
|
|
53
|
+
total_price: z.string().nullable().optional(),
|
|
54
|
+
total_tax: z.string().nullable().optional(),
|
|
30
55
|
transactions: z.array(z.lazy(() => OrderTransaction$zodSchema)).optional(),
|
|
31
|
-
weight: z.string().optional(),
|
|
56
|
+
weight: z.string().nullable().optional(),
|
|
32
57
|
weight_unit: WeightUnitEnum$zodSchema.optional(),
|
|
33
58
|
});
|
|
34
59
|
//# sourceMappingURL=order.js.map
|