n8n-nodes-ups 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nodrel-dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# n8n-nodes-ups
+
+An [n8n](https://n8n.io) community node for **UPS**. It talks directly to the UPS REST API on
+your own UPS application and account number — no aggregator, no runtime dependencies.
+
+Four operations across three resources:
+
+| Resource | Operation | What it does |
+|----------|-----------|--------------|
+| **Tracking** | Track | Current status + scan history for a tracking number |
+| **Address** | Validate | Standardize + classify an address (residential/commercial) |
+| **Shipping** | Get Rates | Service options with published & negotiated rates + transit times |
+| **Shipping** | Create | Create a shipment, return tracking number + label (and customs invoice for international) |
+
+The node sets `usableAsTool: true`, so every operation is callable from the AI-Agent **tool**
+path as well as the normal node path.
+
+## Installation
+
+In n8n: **Settings → Community Nodes → Install** and enter `n8n-nodes-ups`.
+
+## Credentials
+
+The node uses a single credential, **UPS OAuth2 API**, that covers all four operations (one UPS
+OAuth app entitles every endpoint).
+
+1. Create an application in the [UPS Developer Portal](https://developer.ups.com/) and note its
+   **Client ID** and **Client Secret**.
+2. In n8n, create a **UPS OAuth2 API** credential:
+   - **Environment** — `Sandbox (CIE)` (default) or `Production`. This single switch drives **both**
+     the OAuth token URL and the API base URL, so they can never point at different hosts.
+   - **Client ID** / **Client Secret** — from your UPS application.
+3. Click **Test**. The test performs an authenticated Track probe; reaching UPS's Track layer
+   (even a "not found") confirms your credentials and environment. A `401/403` means the Client ID,
+   Secret, or Environment is wrong.
+
+Grant type is OAuth2 **client credentials** (HTTP Basic, empty scope) — configured automatically;
+nothing to set by hand. Secrets live only in n8n's encrypted credential store; never hardcode them.
+
+### Sandbox vs Production
+
+| | Sandbox (CIE) | Production |
+|---|---|---|
+| Token URL | `https://wwwcie.ups.com/security/v1/oauth/token` | `https://onlinetools.ups.com/security/v1/oauth/token` |
+| API base | `https://wwwcie.ups.com/api` | `https://onlinetools.ups.com/api` |
+
+The Customer Integration Environment (CIE) is limited test data — e.g. address validation returns
+street-level results for **US NY/CA** addresses only.
+
+## Operations
+
+### Tracking → Track
+- **Tracking Number** (required) — one inquiry number per input item.
+- **Detail** — *Detailed* (status + scan history) or *Status Only* (current status only).
+- **Locale** — e.g. `en_US`.
+
+Unknown numbers are flagged on their own item; with **Continue On Fail** the rest still process.
+
+### Address → Validate
+- Address line(s), city, state/province, postal code, country.
+- Returns one item with `resolution` (`valid` / `ambiguous` / `none`), a `classification`
+  (UnClassified / Commercial / Residential), and standardized `candidates[]`.
+
+### Shipping → Get Rates
+- **Account Number** (required) — your ShipperNumber; also requests negotiated rates.
+- Shipper / Ship To (and optional Ship From) addresses, package weight (+ unit) and optional
+  dimensions (+ unit).
+- **Customs Value** — required when origin and destination countries differ (international).
+- Emits **one output item per service**, each with published + negotiated price, transit days, and
+  any UPS alerts. If no negotiated rates are returned, a request-level alert is attached to the
+  first item.
+
+### Shipping → Create
+- **Account Number** (required), **Service Code**, Shipper / Ship To (and optional Ship From),
+  package weight/dimensions, **Label Format** (GIF default; ZPL / EPL / SPL — no PDF label).
+- **International** (origin ≠ destination country) additionally requires the customs fields:
+  reason for export, currency, terms of shipment, sold-to party, and at least one commodity line.
+- Returns the tracking number plus the **label** as a binary attachment (`label`); international
+  shipments also return the **commercial invoice** PDF (`customsInvoice`). Label/invoice image data
+  is never embedded as a string in the JSON output.
+
+Billing is to the shipper (transportation charges); international duties are billed to the receiver
+(DDU) in this version.
+
+## AI-Agent tool usage
+
+Because the node is tool-enabled, an AI Agent can call any operation directly (e.g. "track
+1Z…", "rate this shipment"). Test new workflows through both the normal node path and the tool
+path.
+
+## Development
+
+```bash
+npm install      # install dev dependencies
+npm test         # run the pure-core unit tests (vitest)
+npm run lint     # n8n community-node lint (strict)
+npm run build    # compile to dist/
+npm run dev      # run locally inside n8n (Node.js >= 22.22)
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/credentials/UpsOAuth2Api.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { ICredentialTestRequest, ICredentialType, Icon, INodeProperties } from 'n8n-workflow';
+export declare class UpsOAuth2Api implements ICredentialType {
+    name: string;
+    extends: string[];
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    test: ICredentialTestRequest;
+}

package/dist/credentials/UpsOAuth2Api.credentials.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpsOAuth2Api = void 0;
+const TOKEN_URL = {
+    sandbox: 'https://wwwcie.ups.com/security/v1/oauth/token',
+    production: 'https://onlinetools.ups.com/security/v1/oauth/token',
+};
+const API_HOST = {
+    sandbox: 'https://wwwcie.ups.com',
+    production: 'https://onlinetools.ups.com',
+};
+class UpsOAuth2Api {
+    constructor() {
+        this.name = 'upsOAuth2Api';
+        this.extends = ['oAuth2Api'];
+        this.displayName = 'UPS OAuth2 API';
+        this.icon = 'file:ups.svg';
+        this.documentationUrl = 'https://github.com/nodrel-dev/n8n-nodes-ups?tab=readme-ov-file#credentials';
+        this.properties = [
+            {
+                displayName: 'Environment',
+                name: 'environment',
+                type: 'options',
+                options: [
+                    { name: 'Sandbox (CIE)', value: 'sandbox' },
+                    { name: 'Production', value: 'production' },
+                ],
+                default: 'sandbox',
+                description: 'Which UPS environment to use. Sandbox is the Customer Integration Environment (CIE). Drives both the token URL and the API base URL.',
+            },
+            {
+                displayName: 'Grant Type',
+                name: 'grantType',
+                type: 'hidden',
+                default: 'clientCredentials',
+            },
+            {
+                displayName: 'Access Token URL',
+                name: 'accessTokenUrl',
+                type: 'hidden',
+                default: `={{ $self["environment"] === "production" ? "${TOKEN_URL.production}" : "${TOKEN_URL.sandbox}" }}`,
+            },
+            {
+                displayName: 'Auth URI Query Parameters',
+                name: 'authQueryParameters',
+                type: 'hidden',
+                default: '',
+            },
+            {
+                displayName: 'Scope',
+                name: 'scope',
+                type: 'hidden',
+                default: '',
+            },
+            {
+                displayName: 'Authentication',
+                name: 'authentication',
+                type: 'hidden',
+                default: 'header',
+            },
+        ];
+        this.test = {
+            request: {
+                baseURL: `={{ $credentials.environment === "production" ? "${API_HOST.production}" : "${API_HOST.sandbox}" }}`,
+                url: '/api/track/v1/details/1Z00000000000000000',
+                method: 'GET',
+                headers: {
+                    transId: 'n8n-nodes-ups-credtest',
+                    transactionSrc: 'n8n-nodes-ups',
+                },
+            },
+        };
+    }
+}
+exports.UpsOAuth2Api = UpsOAuth2Api;
+//# sourceMappingURL=UpsOAuth2Api.credentials.js.map

package/dist/credentials/UpsOAuth2Api.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpsOAuth2Api.credentials.js","sourceRoot":"","sources":["../../credentials/UpsOAuth2Api.credentials.ts"],"names":[],"mappings":";;;AASA,MAAM,SAAS,GAAG;IACjB,OAAO,EAAE,gDAAgD;IACzD,UAAU,EAAE,qDAAqD;CACjE,CAAC;AAGF,MAAM,QAAQ,GAAG;IAChB,OAAO,EAAE,wBAAwB;IACjC,UAAU,EAAE,6BAA6B;CACzC,CAAC;AAEF,MAAa,YAAY;IAAzB;QACC,SAAI,GAAG,cAAc,CAAC;QAEtB,YAAO,GAAG,CAAC,WAAW,CAAC,CAAC;QAExB,gBAAW,GAAG,gBAAgB,CAAC;QAE/B,SAAI,GAAS,cAAc,CAAC;QAE5B,qBAAgB,GAAG,4EAA4E,CAAC;QAEhG,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE;oBACR,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE;oBAC3C,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;iBAC3C;gBACD,OAAO,EAAE,SAAS;gBAClB,WAAW,EACV,sIAAsI;aACvI;YACD;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,mBAAmB;aAC5B;YACD;gBAGC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,gDAAgD,SAAS,CAAC,UAAU,QAAQ,SAAS,CAAC,OAAO,MAAM;aAC5G;YACD;gBACC,WAAW,EAAE,2BAA2B;gBACxC,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;aACX;YACD;gBAEC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;aACX;YACD;gBAGC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,QAAQ;aACjB;SACD,CAAC;QAWF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,oDAAoD,QAAQ,CAAC,UAAU,QAAQ,QAAQ,CAAC,OAAO,MAAM;gBAC9G,GAAG,EAAE,2CAA2C;gBAChD,MAAM,EAAE,KAAK;gBAKb,OAAO,EAAE;oBACR,OAAO,EAAE,wBAAwB;oBACjC,cAAc,EAAE,eAAe;iBAC/B;aACD;SACD,CAAC;IACH,CAAC;CAAA;AArFD,oCAqFC"}

package/dist/credentials/ups.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6f4e37" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/>
+  <polyline points="3.27 6.96 12 12.01 20.73 6.96"/>
+  <line x1="12" y1="22.08" x2="12" y2="12"/>
+</svg>

package/dist/nodes/Ups/Ups.node.d.ts

@@ -0,0 +1,4 @@
+import { type INodeType, type INodeTypeDescription } from 'n8n-workflow';
+export declare class Ups implements INodeType {
+    description: INodeTypeDescription;
+}

package/dist/nodes/Ups/Ups.node.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ups = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const tracking_1 = require("./resources/tracking");
+const address_1 = require("./resources/address");
+const shipping_1 = require("./resources/shipping");
+class Ups {
+    constructor() {
+        this.description = {
+            displayName: 'UPS',
+            name: 'ups',
+            icon: { light: 'file:ups.svg', dark: 'file:ups.dark.svg' },
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Track shipments, validate addresses, rate, and create UPS shipments',
+            defaults: {
+                name: 'UPS',
+            },
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [{ name: 'upsOAuth2Api', required: true }],
+            requestDefaults: {
+                baseURL: '={{ $credentials.environment === "production" ? "https://onlinetools.ups.com/api" : "https://wwwcie.ups.com/api" }}',
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                },
+            },
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        { name: 'Address', value: 'address' },
+                        { name: 'Shipping', value: 'shipping' },
+                        { name: 'Tracking', value: 'tracking' },
+                    ],
+                    default: 'tracking',
+                },
+                ...tracking_1.trackingDescription,
+                ...address_1.addressDescription,
+                ...shipping_1.shippingDescription,
+            ],
+        };
+    }
+}
+exports.Ups = Ups;
+//# sourceMappingURL=Ups.node.js.map

package/dist/nodes/Ups/Ups.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ups.node.js","sourceRoot":"","sources":["../../../nodes/Ups/Ups.node.ts"],"names":[],"mappings":";;;AAAA,+CAA8F;AAC9F,mDAA2D;AAC3D,iDAAyD;AACzD,mDAA2D;AAE3D,MAAa,GAAG;IAAhB;QAMC,gBAAW,GAAyB;YACnC,WAAW,EAAE,KAAK;YAClB,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,mBAAmB,EAAE;YAC1D,KAAK,EAAE,CAAC,WAAW,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,8DAA8D;YACxE,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE;gBACT,IAAI,EAAE,KAAK;aACX;YACD,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACvD,eAAe,EAAE;gBAIhB,OAAO,EACN,qHAAqH;gBACtH,OAAO,EAAE;oBACR,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;iBAClC;aACD;YACD,UAAU,EAAE;gBACX;oBACC,WAAW,EAAE,UAAU;oBACvB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,SAAS;oBACf,gBAAgB,EAAE,IAAI;oBACtB,OAAO,EAAE;wBACR,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;wBACrC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;wBACvC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;qBACvC;oBACD,OAAO,EAAE,UAAU;iBACnB;gBACD,GAAG,8BAAmB;gBACtB,GAAG,4BAAkB;gBACrB,GAAG,8BAAmB;aACtB;SACD,CAAC;IACH,CAAC;CAAA;AAlDD,kBAkDC"}

package/dist/nodes/Ups/Ups.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "n8n-nodes-ups.ups",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["Miscellaneous"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/nodrel-dev/n8n-nodes-ups?tab=readme-ov-file#credentials"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/nodrel-dev/n8n-nodes-ups?tab=readme-ov-file"
+            }
+        ]
+    }
+}

package/dist/nodes/Ups/core/buildCommodities.d.ts

@@ -0,0 +1,10 @@
+import type { Product } from './types';
+export interface CommodityLineInput {
+    description: string;
+    quantity: number;
+    unitValue: number;
+    unitOfMeasure: string;
+    commodityCode?: string;
+    originCountry?: string;
+}
+export declare function buildCommodities(items: CommodityLineInput[]): Product[];

package/dist/nodes/Ups/core/buildCommodities.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCommodities = buildCommodities;
+function buildCommodities(items) {
+    return items.map((item) => {
+        const product = {
+            Description: item.description,
+            Unit: {
+                Number: String(item.quantity),
+                UnitOfMeasurement: { Code: item.unitOfMeasure },
+                Value: String(item.unitValue),
+            },
+        };
+        if (item.commodityCode)
+            product.CommodityCode = item.commodityCode;
+        if (item.originCountry)
+            product.OriginCountryCode = item.originCountry;
+        return product;
+    });
+}
+//# sourceMappingURL=buildCommodities.js.map

package/dist/nodes/Ups/core/buildCommodities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCommodities.js","sourceRoot":"","sources":["../../../../nodes/Ups/core/buildCommodities.ts"],"names":[],"mappings":";;AAeA,4CAcC;AAdD,SAAgB,gBAAgB,CAAC,KAA2B;IAC3D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,OAAO,GAAY;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC7B,iBAAiB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE;gBAC/C,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;aAC7B;SACD,CAAC;QACF,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACnE,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,aAAa,CAAC;QACvE,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/nodes/Ups/core/buildInternationalForms.d.ts

@@ -0,0 +1,17 @@
+import type { InternationalForms, Product } from './types';
+export interface CustomsInput {
+    reasonForExport: string;
+    currency: string;
+    termsOfShipment?: string;
+    invoiceNumber?: string;
+    invoiceDate?: string;
+    soldTo: {
+        name: string;
+        addressLines: string[];
+        city: string;
+        stateProvinceCode?: string;
+        postalCode?: string;
+        countryCode: string;
+    };
+}
+export declare function buildInternationalForms(customs: CustomsInput, commodities: Product[]): InternationalForms;

package/dist/nodes/Ups/core/buildInternationalForms.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInternationalForms = buildInternationalForms;
+function buildInternationalForms(customs, commodities) {
+    var _a;
+    const forms = {
+        FormType: ['01'],
+        ReasonForExport: customs.reasonForExport,
+        CurrencyCode: customs.currency,
+        Contacts: {
+            SoldTo: {
+                Name: customs.soldTo.name,
+                Address: {
+                    AddressLine: ((_a = customs.soldTo.addressLines) !== null && _a !== void 0 ? _a : []).filter((l) => l && l.trim().length > 0),
+                    City: customs.soldTo.city,
+                    CountryCode: customs.soldTo.countryCode,
+                },
+            },
+        },
+        Product: commodities,
+    };
+    if (customs.soldTo.stateProvinceCode)
+        forms.Contacts.SoldTo.Address.StateProvinceCode = customs.soldTo.stateProvinceCode;
+    if (customs.soldTo.postalCode)
+        forms.Contacts.SoldTo.Address.PostalCode = customs.soldTo.postalCode;
+    if (customs.termsOfShipment)
+        forms.TermsOfShipment = customs.termsOfShipment;
+    if (customs.invoiceNumber)
+        forms.InvoiceNumber = customs.invoiceNumber;
+    if (customs.invoiceDate)
+        forms.InvoiceDate = customs.invoiceDate;
+    return forms;
+}
+//# sourceMappingURL=buildInternationalForms.js.map

package/dist/nodes/Ups/core/buildInternationalForms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildInternationalForms.js","sourceRoot":"","sources":["../../../../nodes/Ups/core/buildInternationalForms.ts"],"names":[],"mappings":";;AAsBA,0DA8BC;AA9BD,SAAgB,uBAAuB,CACtC,OAAqB,EACrB,WAAsB;;IAEtB,MAAM,KAAK,GAAuB;QACjC,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,YAAY,EAAE,OAAO,CAAC,QAAQ;QAC9B,QAAQ,EAAE;YACT,MAAM,EAAE;gBACP,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;gBACzB,OAAO,EAAE;oBACR,WAAW,EAAE,CAAC,MAAA,OAAO,CAAC,MAAM,CAAC,YAAY,mCAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;oBACxF,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBACzB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;iBACvC;aACD;SACD;QACD,OAAO,EAAE,WAAW;KACpB,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,CAAC,iBAAiB;QACnC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACpF,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU;QAC5B,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IACtE,IAAI,OAAO,CAAC,eAAe;QAAE,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAC7E,IAAI,OAAO,CAAC,aAAa;QAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IACvE,IAAI,OAAO,CAAC,WAAW;QAAE,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAEjE,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/nodes/Ups/core/extractCharges.d.ts

@@ -0,0 +1,20 @@
+import type { Money } from './types';
+import { type UpsCharge } from './toMoney';
+export interface ExtractedCharges {
+    published: Money | null;
+    negotiated: Money | null;
+}
+interface ShipChargeResponse {
+    ShipmentResponse?: {
+        ShipmentResults?: {
+            ShipmentCharges?: {
+                TotalCharges?: UpsCharge;
+            };
+            NegotiatedRateCharges?: {
+                TotalCharge?: UpsCharge;
+            };
+        };
+    };
+}
+export declare function extractCharges(response: ShipChargeResponse): ExtractedCharges;
+export {};

package/dist/nodes/Ups/core/extractCharges.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractCharges = extractCharges;
+const toMoney_1 = require("./toMoney");
+function extractCharges(response) {
+    var _a, _b, _c;
+    const results = (_a = response.ShipmentResponse) === null || _a === void 0 ? void 0 : _a.ShipmentResults;
+    return {
+        published: (0, toMoney_1.toMoney)((_b = results === null || results === void 0 ? void 0 : results.ShipmentCharges) === null || _b === void 0 ? void 0 : _b.TotalCharges),
+        negotiated: (0, toMoney_1.toMoney)((_c = results === null || results === void 0 ? void 0 : results.NegotiatedRateCharges) === null || _c === void 0 ? void 0 : _c.TotalCharge),
+    };
+}
+//# sourceMappingURL=extractCharges.js.map

package/dist/nodes/Ups/core/extractCharges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractCharges.js","sourceRoot":"","sources":["../../../../nodes/Ups/core/extractCharges.ts"],"names":[],"mappings":";;AAuBA,wCAMC;AA5BD,uCAAoD;AAsBpD,SAAgB,cAAc,CAAC,QAA4B;;IAC1D,MAAM,OAAO,GAAG,MAAA,QAAQ,CAAC,gBAAgB,0CAAE,eAAe,CAAC;IAC3D,OAAO;QACN,SAAS,EAAE,IAAA,iBAAO,EAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,0CAAE,YAAY,CAAC;QAC1D,UAAU,EAAE,IAAA,iBAAO,EAAC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,qBAAqB,0CAAE,WAAW,CAAC;KAChE,CAAC;AACH,CAAC"}

package/dist/nodes/Ups/core/extractForms.d.ts

@@ -0,0 +1,23 @@
+export interface ExtractedForm {
+    base64: string;
+    mime: string;
+    filename: string;
+}
+interface RawForm {
+    Image?: {
+        GraphicImage?: string;
+        ImageFormat?: {
+            Code?: string;
+        };
+    };
+}
+interface ShipResponse {
+    ShipmentResponse?: {
+        ShipmentResults?: {
+            ShipmentIdentificationNumber?: string;
+            Form?: RawForm[] | RawForm;
+        };
+    };
+}
+export declare function extractForms(response: ShipResponse): ExtractedForm[];
+export {};

package/dist/nodes/Ups/core/extractForms.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractForms = extractForms;
+function toArray(value) {
+    if (value === undefined || value === null)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+function extractForms(response) {
+    var _a, _b;
+    const results = (_a = response.ShipmentResponse) === null || _a === void 0 ? void 0 : _a.ShipmentResults;
+    const shipmentId = (_b = results === null || results === void 0 ? void 0 : results.ShipmentIdentificationNumber) !== null && _b !== void 0 ? _b : 'shipment';
+    const forms = toArray(results === null || results === void 0 ? void 0 : results.Form);
+    return forms
+        .filter((form) => { var _a; return (_a = form.Image) === null || _a === void 0 ? void 0 : _a.GraphicImage; })
+        .map((form, index) => {
+        var _a;
+        return ({
+            base64: (_a = form.Image) === null || _a === void 0 ? void 0 : _a.GraphicImage,
+            mime: 'application/pdf',
+            filename: `customs-invoice-${shipmentId}${index > 0 ? `-${index + 1}` : ''}.pdf`,
+        });
+    });
+}
+//# sourceMappingURL=extractForms.js.map

package/dist/nodes/Ups/core/extractForms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractForms.js","sourceRoot":"","sources":["../../../../nodes/Ups/core/extractForms.ts"],"names":[],"mappings":";;AA4BA,oCAaC;AAlBD,SAAS,OAAO,CAAI,KAA0B;IAC7C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,YAAY,CAAC,QAAsB;;IAClD,MAAM,OAAO,GAAG,MAAA,QAAQ,CAAC,gBAAgB,0CAAE,eAAe,CAAC;IAC3D,MAAM,UAAU,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,4BAA4B,mCAAI,UAAU,CAAC;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,IAAI,CAAC,CAAC;IAErC,OAAO,KAAK;SACV,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,WAAC,OAAA,MAAA,IAAI,CAAC,KAAK,0CAAE,YAAY,CAAA,EAAA,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;;QAAC,OAAA,CAAC;YACtB,MAAM,EAAE,MAAA,IAAI,CAAC,KAAK,0CAAE,YAAsB;YAE1C,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,mBAAmB,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM;SAChF,CAAC,CAAA;KAAA,CAAC,CAAC;AACN,CAAC"}

package/dist/nodes/Ups/core/extractLabel.d.ts

@@ -0,0 +1,30 @@
+export type LabelFormat = 'GIF' | 'ZPL' | 'EPL' | 'SPL';
+export interface ExtractedLabel {
+    trackingNumber: string;
+    base64: string;
+    mime: string;
+    filename: string;
+}
+export interface ExtractLabelResult {
+    shipmentId: string;
+    labels: ExtractedLabel[];
+}
+interface RawPackageResult {
+    TrackingNumber?: string;
+    ShippingLabel?: {
+        ImageFormat?: {
+            Code?: string;
+        };
+        GraphicImage?: string;
+    };
+}
+interface ShipResponse {
+    ShipmentResponse?: {
+        ShipmentResults?: {
+            ShipmentIdentificationNumber?: string;
+            PackageResults?: RawPackageResult[] | RawPackageResult;
+        };
+    };
+}
+export declare function extractLabel(response: ShipResponse, requestedFormat: string): ExtractLabelResult;
+export {};

package/dist/nodes/Ups/core/extractLabel.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractLabel = extractLabel;
+const MIME_BY_FORMAT = {
+    GIF: 'image/gif',
+    ZPL: 'text/plain',
+    EPL: 'text/plain',
+    SPL: 'text/plain',
+};
+function toArray(value) {
+    if (value === undefined || value === null)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+function extractLabel(response, requestedFormat) {
+    var _a, _b;
+    const results = (_a = response.ShipmentResponse) === null || _a === void 0 ? void 0 : _a.ShipmentResults;
+    const shipmentId = (_b = results === null || results === void 0 ? void 0 : results.ShipmentIdentificationNumber) !== null && _b !== void 0 ? _b : '';
+    const packages = toArray(results === null || results === void 0 ? void 0 : results.PackageResults);
+    const labels = packages
+        .filter((pkg) => { var _a; return (_a = pkg.ShippingLabel) === null || _a === void 0 ? void 0 : _a.GraphicImage; })
+        .map((pkg) => {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const format = ((_d = (_c = (_b = (_a = pkg.ShippingLabel) === null || _a === void 0 ? void 0 : _a.ImageFormat) === null || _b === void 0 ? void 0 : _b.Code) !== null && _c !== void 0 ? _c : requestedFormat) !== null && _d !== void 0 ? _d : 'GIF').toUpperCase();
+        const trackingNumber = (_e = pkg.TrackingNumber) !== null && _e !== void 0 ? _e : shipmentId;
+        return {
+            trackingNumber,
+            base64: (_f = pkg.ShippingLabel) === null || _f === void 0 ? void 0 : _f.GraphicImage,
+            mime: (_g = MIME_BY_FORMAT[format]) !== null && _g !== void 0 ? _g : 'application/octet-stream',
+            filename: `${trackingNumber}.${format.toLowerCase()}`,
+        };
+    });
+    return { shipmentId, labels };
+}
+//# sourceMappingURL=extractLabel.js.map

package/dist/nodes/Ups/core/extractLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractLabel.js","sourceRoot":"","sources":["../../../../nodes/Ups/core/extractLabel.ts"],"names":[],"mappings":";;AAiDA,oCAuBC;AAnCD,MAAM,cAAc,GAA2B;IAC9C,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;CACjB,CAAC;AAEF,SAAS,OAAO,CAAI,KAA0B;IAC7C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,YAAY,CAAC,QAAsB,EAAE,eAAuB;;IAC3E,MAAM,OAAO,GAAG,MAAA,QAAQ,CAAC,gBAAgB,0CAAE,eAAe,CAAC;IAC3D,MAAM,UAAU,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,4BAA4B,mCAAI,EAAE,CAAC;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,CAAC,CAAC;IAElD,MAAM,MAAM,GAAqB,QAAQ;SACvC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,WAAC,OAAA,MAAA,GAAG,CAAC,aAAa,0CAAE,YAAY,CAAA,EAAA,CAAC;SAChD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;;QACZ,MAAM,MAAM,GAAG,CACd,MAAA,MAAA,MAAA,MAAA,GAAG,CAAC,aAAa,0CAAE,WAAW,0CAAE,IAAI,mCACpC,eAAe,mCACf,KAAK,CACL,CAAC,WAAW,EAAE,CAAC;QAChB,MAAM,cAAc,GAAG,MAAA,GAAG,CAAC,cAAc,mCAAI,UAAU,CAAC;QACxD,OAAO;YACN,cAAc;YACd,MAAM,EAAE,MAAA,GAAG,CAAC,aAAa,0CAAE,YAAsB;YACjD,IAAI,EAAE,MAAA,cAAc,CAAC,MAAM,CAAC,mCAAI,0BAA0B;YAC1D,QAAQ,EAAE,GAAG,cAAc,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE;SACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC"}

package/dist/nodes/Ups/core/flattenRates.d.ts

@@ -0,0 +1,36 @@
+import type { RateLine } from './types';
+import { type UpsCharge } from './toMoney';
+interface RawAlert {
+    Code?: string;
+    Description?: string;
+}
+interface RawRatedShipment {
+    Service?: {
+        Code?: string;
+        Description?: string;
+    };
+    BillingWeight?: {
+        Weight?: string;
+    };
+    TotalCharges?: UpsCharge;
+    NegotiatedRateCharges?: {
+        TotalCharge?: UpsCharge;
+    };
+    GuaranteedDelivery?: {
+        BusinessDaysInTransit?: string;
+        DeliveryByTime?: string;
+    };
+    RatedShipmentAlert?: RawAlert[] | RawAlert;
+}
+interface RateResponse {
+    RateResponse?: {
+        Response?: {
+            Alert?: RawAlert[] | RawAlert;
+        };
+        RatedShipment?: RawRatedShipment[] | RawRatedShipment;
+    };
+}
+export declare function flattenRates(response: RateResponse, options: {
+    wantTransit: boolean;
+}): RateLine[];
+export {};