@nodrel-dev/n8n-nodes-ups 0.3.1

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,249 @@
+<div align="center">
+
+# 📦 n8n-nodes-ups
+
+**Use the UPS REST API directly in your n8n workflows.**
+
+Track shipments · validate addresses · quote rates · create labels (with international customs forms) — against _your own_ UPS account, with no aggregator in the middle.
+
+[![npm version](https://img.shields.io/npm/v/@nodrel-dev/n8n-nodes-ups?logo=npm&color=cb3837)](https://www.npmjs.com/package/@nodrel-dev/n8n-nodes-ups)
+[![npm downloads](https://img.shields.io/npm/dm/@nodrel-dev/n8n-nodes-ups)](https://www.npmjs.com/package/@nodrel-dev/n8n-nodes-ups)
+[![CI](https://github.com/nodrel-dev/n8n-nodes-ups/actions/workflows/ci.yml/badge.svg)](https://github.com/nodrel-dev/n8n-nodes-ups/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/npm/l/@nodrel-dev/n8n-nodes-ups)](https://www.npmjs.com/package/@nodrel-dev/n8n-nodes-ups)
+[![published with provenance](https://img.shields.io/badge/published%20with-provenance-3b82f6?logo=npm)](https://www.npmjs.com/package/@nodrel-dev/n8n-nodes-ups#provenance)
+
+[Installation](#installation) · [Operations](#operations) · [Credentials](#credentials) · [Usage](#usage) · [npm](https://www.npmjs.com/package/@nodrel-dev/n8n-nodes-ups) · [UPS Developer Portal](https://developer.ups.com/) · [Report an issue](https://github.com/nodrel-dev/n8n-nodes-ups/issues)
+
+</div>
+
+## What is this?
+
+This is an [n8n](https://n8n.io/) community node for the **UPS REST API**. It lets your workflows track shipments, validate addresses, quote rates, and create shipping labels — talking straight to UPS with your own API credentials.
+
+Because there's no aggregator in the middle, you get **your own negotiated rates** and UPS bills your account directly. [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/sustainable-use-license/) workflow automation platform.
+
+### Highlights
+
+- 🚚 **Direct to UPS** — your API keys, your negotiated rates, your account billed. No aggregator markup or middleman.
+- 🏷️ **Labels as real binary** — Create returns a print-ready GIF / ZPL / EPL / SPL label as n8n binary data, not a base64 blob buried in JSON.
+- 🌍 **International built in** — cross-border Create assembles the UPS commercial-invoice customs forms and returns the UPS-generated invoice as a PDF binary alongside the label.
+- 🔑 **One credential, all four APIs** — a single UPS OAuth app entitles Track, Address Validation, Rating, and Ship, so there is exactly one credential to set up.
+- 🔀 **One sandbox / production switch** — a single credential field repoints every API request and the OAuth token URL together, so a call can never straddle environments.
+- 🔐 **Native OAuth2, no token code** — n8n performs the client-credentials exchange and refreshes the token for you.
+- 📦 **Zero runtime dependencies** — ships only `dist/`, published to npm with signed [provenance](https://docs.npmjs.com/generating-provenance-statements).
+
+## Who it's for
+
+- **E-commerce & retail** — print labels at fulfillment, surface tracking to customers, and rate-shop services per order.
+- **3PLs & fulfillment ops** — automate shipping for many accounts and wire labels into existing pick-and-pack flows.
+- **Cross-border sellers** — generate the commercial invoice and customs forms UPS needs for international shipments, automatically.
+- **Finance & operations teams** — quote live negotiated rates inside approval and reconciliation workflows.
+- **Developers & integrators** — embed UPS tracking, address validation, rates, and labels into any n8n automation without hand-rolling OAuth.
+
+## How it works
+
+The node sits between your workflow and UPS. A single **UPS OAuth2** credential holds your Client ID/Secret and the sandbox-or-production switch; n8n handles the token exchange, and every request is routed to the matching UPS host.
+
+```mermaid
+flowchart LR
+    subgraph wf["n8n workflow"]
+        prev["Upstream node"] --> ups["UPS node"]
+        ups --> down["Downstream node<br/>(Write Binary File,<br/>Send Email, …)"]
+    end
+
+    cred["UPS OAuth2 credential<br/>Client ID + Secret<br/>Sandbox (CIE) / Production"]
+    cred -. "n8n exchanges and refreshes token" .-> ups
+
+    ups -->|"HTTPS + bearer token"| api["UPS REST API<br/>(your account and rates)"]
+```
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation. In n8n, go to **Settings → Community Nodes → Install** and enter `@nodrel-dev/n8n-nodes-ups`.
+
+## Operations
+
+The node exposes three resources: **Tracking**, **Address**, and **Shipping**.
+
+```mermaid
+flowchart TD
+    node["UPS node"]
+    node --> tracking["📍 Tracking"]
+    node --> address["🏠 Address"]
+    node --> shipping["📦 Shipping"]
+
+    tracking --> track["Track<br/>GET /track/v1/details/{number}"]
+    address --> validate["Validate<br/>POST /addressvalidation/v2/3"]
+    shipping --> rates["Get Rates<br/>POST /rating/v2409/Shoptimeintransit"]
+    shipping --> create["Create<br/>POST /shipments/v2409/ship"]
+```
+
+### Tracking → Track
+
+Get the current status and scan history for one UPS inquiry number per item (`GET /track/v1/details/{number}`).
+
+- **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
+
+Standardize an address and classify it residential vs commercial (`POST /addressvalidation/v2/3`).
+
+- 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
+
+Quote published and negotiated rates with transit times for every eligible service (`POST /rating/v2409/Shoptimeintransit`).
+
+- **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
+
+Buy a shipment and get a printable label plus tracking number (`POST /shipments/v2409/ship`).
+
+- **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 and account/published charges, 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.
+
+## Credentials
+
+You authenticate with a UPS **Client ID** and **Client Secret** using OAuth2 client-credentials. n8n performs the token exchange and refreshes the token automatically — you never handle tokens yourself.
+
+### Prerequisites
+
+1. Create an application on the [UPS Developer Portal](https://developer.ups.com/).
+2. Note its **Client ID** and **Client Secret**. A single UPS OAuth app entitles all four APIs used here (Track, Address Validation, Rating, Ship), so one credential covers every operation.
+3. For Get Rates and Create you also need your UPS **account number** (ShipperNumber).
+
+### One credential type
+
+The node uses a single credential, **UPS OAuth2 API**, for all four operations:
+
+| Credential type | Used by |
+| --------------- | ------- |
+| `upsOAuth2Api`  | Track, Validate, Get Rates, Create |
+
+### Set up a credential in n8n
+
+1. Add a new **UPS OAuth2 API** credential.
+2. Set **Environment** to **Sandbox (CIE)** while developing, or **Production** for real shipments. This single switch points both the OAuth token URL and every API request at the matching UPS host, so a request can never straddle sandbox and production.
+3. Enter your **Client ID** and **Client Secret**.
+4. Save — n8n runs the credential test (an authenticated Track probe) and shows a green confirmation when the keys are valid. 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:** credentials default to **Sandbox (CIE)** on purpose, so a half-configured connection can't hit a live account. Switch to **Production** only when you are ready to create real, billable shipments.
+
+### Sandbox vs production hosts
+
+|  | 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 — for example, address validation returns street-level results for **US NY/CA** addresses only, and Track returns a canned `DELIVERED` response for any well-formed `1Z` number.
+
+## Compatibility
+
+- Requires n8n with `n8nNodesApiVersion: 1`.
+- Built and tested against the UPS REST API (Track v1, Address Validation v2, Rating v2409, Ship v2409).
+- The account number is never defaulted or hardcoded — it always comes from the node field, and your API keys live only in the credential.
+
+## Security & dependencies
+
+The published package ships only `dist/` with **zero runtime dependencies** (`n8n-workflow` is a peer, provided by your n8n instance). Any audit findings are confined to the build, test, and release tooling or the host-provided peer — none of them reach an installed node.
+
+Every release is published to npm with a signed **[provenance](https://docs.npmjs.com/generating-provenance-statements) attestation** through GitHub Actions [OIDC trusted publishing](https://docs.npmjs.com/trusted-publishers): no long-lived npm token is stored in the repo, and anyone can cryptographically verify that a given version was built by this workflow from this exact commit (see the **Provenance** panel on the [npm page](https://www.npmjs.com/package/@nodrel-dev/n8n-nodes-ups#provenance)).
+
+The package is also scanned with `npx @n8n/scan-community-package @nodrel-dev/n8n-nodes-ups` as part of the release process.
+
+## AI-Agent tool usage
+
+The node sets `usableAsTool: true`, so every operation is callable from the AI-Agent **tool** path as well as the normal node path. An AI Agent can call any operation directly (for example "track 1Z…", or "rate this shipment"). Test new workflows through both the normal node path and the tool path.
+
+## Usage
+
+### Get Rates and Create
+
+Both operations share the same **Shipper**, **Ship From**, and **Ship To** address fields, so values carry over when you switch between them. Package dimensions (length/width/height) are optional and only sent to UPS when provided. Ship From is optional and defaults to the Shipper address.
+
+### The label binary (Create)
+
+Create returns the label as proper n8n **binary data** on the output property named `label` — not a base64 string buried in JSON. Under the hood, the node requests an inline base64 label, decodes it, and attaches it as binary so downstream nodes can print or save it directly. International shipments additionally return the UPS commercial invoice as a PDF binary on the property `customsInvoice`:
+
+```mermaid
+sequenceDiagram
+    participant WF as n8n workflow
+    participant Node as UPS node
+    participant Auth as OAuth2 (n8n-managed)
+    participant API as UPS Ship API
+
+    WF->>Node: Execute "Create"
+    Node->>Auth: Need access token
+    Auth-->>Node: Cached / refreshed token
+    Node->>Node: createPreSend assembles ShipmentRequest<br/>(+ InternationalForms if cross-border)
+    Node->>API: POST /shipments/v2409/ship (bearer token)
+    API-->>Node: JSON + base64 label (+ base64 invoice)
+    Node->>Node: createPostReceive decodes base64 →<br/>attach binary "label" (+ "customsInvoice"),<br/>surface charges
+    Node-->>WF: JSON (tracking #, charges)<br/>+ binary label (+ invoice)
+```
+
+Choose the format with **Label Format**:
+
+| Label Format | MIME type | Typical use |
+| --- | --- | --- |
+| GIF | `image/gif` | Default; preview / office printers |
+| ZPL | `text/plain` | Zebra thermal printers (4×6 stock) |
+| EPL | `text/plain` | Eltron thermal printers (4×6 stock) |
+| SPL | `text/plain` | SATO thermal printers (4×6 stock) |
+
+The tracking number and charge details are passed through on the main JSON output. Wire the `label` (and `customsInvoice`) binary into **Write Binary File**, **Send Email** (as an attachment), or any node that consumes binary data.
+
+### Errors and Continue On Fail
+
+UPS error codes and messages are surfaced verbatim through n8n's error handling — classified as authentication, input, or transient — and the node honors **Continue On Fail**: failed items emit an `error` entry and the workflow keeps processing the rest. Non-fatal UPS alerts (for example "no negotiated rates returned") are surfaced as warnings without failing the item.
+
+## Documentation
+
+Deeper docs for contributors and integrators live in [`docs/`](docs/):
+
+- [System Overview](docs/system-overview.md) — architecture, auth/environment model, request lifecycle (with diagrams).
+- [Integration Specification](docs/integration-spec.md) — endpoints, request/response shapes, enums, and error handling for all four operations.
+- [Data Model](docs/data-model.md) — the typed shapes the node assembles, and the node-parameter → UPS-field mapping.
+- [Architecture Decision Records](docs/adr/) — why the key design choices were made.
+- [n8n Community Node Gotchas](docs/n8n-gotchas.md) — hard-won build/release/verify traps.
+
+## 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)
+```
+
+Releases are driven by [release-please](https://github.com/googleapis/release-please): merge the auto-generated release PR on `main` and the workflow tags, publishes to npm with provenance, and scans. Never run a release or `npm publish` locally.
+
+## Resources
+
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
+- [UPS Developer Portal](https://developer.ups.com/)
+- [UPS API catalog](https://developer.ups.com/api/reference)
+
+## Version history
+
+See [CHANGELOG.md](CHANGELOG.md) for the full, per-release history (kept current automatically on each release).
+
+## 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": "@nodrel-dev/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"}