n8n-nodes-taliware 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TALIWARE
+
+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,291 @@
+# n8n-nodes-taliware
+
+TALIWARE CL2C biometric NFT mint node for [n8n](https://n8n.io/) — manually execute mints or expose **Mint Biometric NFT** as an AI Agent tool.
+
+The node is a thin gate to the [CL2C API](https://developer.taliware.com/api/cl2c.yaml): resolve owner → create NFT → poll until `MINTED` or `FAILED` → return agent-readable JSON. Confida biometric approval happens on the owner's mobile device after create; this package does not embed the Confida SDK.
+
+**Requirements:** n8n **≥ 1.79.0** (community AI Agent tools).
+
+---
+
+## Quick Start
+
+Goal: first successful testnet mint in under 30 minutes.
+
+### 1. Install the community node
+
+On your n8n host, set environment variables:
+
+```bash
+N8N_COMMUNITY_PACKAGES_ENABLED=true
+N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true   # required for AI Agent tools
+```
+
+Restart n8n, then: **Settings → Community Nodes → Install** → enter `n8n-nodes-taliware`.
+
+### 2. Create Taliware API credentials
+
+In n8n: **Credentials → New → Taliware API**
+
+| Field | Required | Notes |
+|-------|----------|-------|
+| API Key | Yes | Sent as `x-api-key` on CL2C requests only — never logged |
+| Base URL | No | Default: `https://developer.taliware.com/api/v1` |
+| Default Smart Contract ID | No | UUID of a contract with `env: TESTNET` for testnet mints |
+
+**Testnet:** Use the same API host. Pick a smart contract where `env` is `TESTNET` (via [CL2C API](https://developer.taliware.com/api/cl2c.yaml) or TALIWARE platform). Set that UUID in credentials or override it on the node.
+
+List contracts (example):
+
+```bash
+curl -s -H "x-api-key: YOUR_KEY" \
+  "https://developer.taliware.com/api/v1/cl2c/contract?limit=50" | jq '.data[] | {id, name, env, network}'
+```
+
+### 3. Invite the NFT owner
+
+The owner must exist on the TALIWARE platform before mint. Either:
+
+- **Platform UI** — invite the user via the TALIWARE dashboard, or
+- **API** — `POST /cl2c/user` with the owner's email:
+
+```bash
+curl -s -X POST "https://developer.taliware.com/api/v1/cl2c/user" \
+  -H "x-api-key: YOUR_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"email":"owner@example.com"}'
+```
+
+The owner must complete Confida setup (see below) before mint can succeed.
+
+**Owner User ID:** When resolving by email, the node uses the org entry `id` from `GET /cl2c/user` (UUID), **not** the nested `user.id` platform identifier. You can paste that UUID into **Owner User ID** to skip email lookup:
+
+```bash
+curl -s -H "x-api-key: YOUR_KEY" \
+  "https://developer.taliware.com/api/v1/cl2c/user?search=owner@example.com" | jq '.data[] | {id, email, status}'
+```
+
+Use the top-level `id` field in the mint request.
+
+### 4. Run your first manual mint
+
+1. Add **Mint Biometric NFT** to a workflow.
+2. Select **Taliware API** credentials.
+3. Set parameters:
+   - **Owner Email** (or **Owner User ID**)
+   - **Name** (required)
+   - **Image Path** — HTTPS URL, base64 (`data:image/...;base64,...` or raw), or leave empty and pass binary on the input item (see **Binary Property Name**)
+   - **Smart Contract ID** — leave empty to use credential default, or paste a TESTNET contract UUID
+4. Click **Execute workflow**.
+5. The owner receives a Confida mobile notification — complete fingerprint approval on device.
+6. The node polls until `status` is `MINTED` or `FAILED` (default: 10 s interval, 20 min timeout).
+
+On success, output includes `status: "MINTED"`, `mintedAt`, and `smartContract.contractAddress`.
+
+**Mint from a local file:** Import [`workflows/manual-mint-binary.example.json`](workflows/manual-mint-binary.example.json) — **Read Binary File** (set `filePath` to your PNG/JPEG) → **Mint Biometric NFT** with **Image Path** empty and **Binary Property Name** `data`.
+
+If Confida confirms but the node ends with `status: FAILED` and `mintedAt: null`, the create + IPFS + biometric steps succeeded; on-chain mint likely failed (e.g. unfunded org wallet / CRDB tokens). Retry after TALIWARE recharges testnet funds — no node change required.
+
+---
+
+## Confida (biometric approval)
+
+TALIWARE orchestrates [Confida](https://developer.taliware.com/docs/confida) for biometric identity verification. This node **does not** embed the Confida SDK or capture biometrics inside n8n.
+
+What happens:
+
+1. Owner is invited to the platform and completes Confida setup on mobile.
+2. `POST /cl2c/nft` creates the NFT with `status: CREATED` and triggers Confida notifications.
+3. Owner approves on mobile (fingerprint).
+4. This node polls `GET /cl2c/nft/{id}` until terminal status.
+
+If the owner ignores the notification, polling hits the timeout — see **ConfidaTimeout** in [Error Reference](#error-reference).
+
+Full Confida documentation: [developer.taliware.com/docs/confida](https://developer.taliware.com/docs/confida)
+
+---
+
+## AI Agent tool
+
+### Connect the tool
+
+1. Confirm env vars from [Quick Start](#1-install-the-community-node) are set.
+2. Add an **AI Agent** node to your workflow.
+3. On the agent's **Tools** input, add **Mint Biometric NFT Tool** (the wrapped variant of this node).
+4. Select credentials and configure poll/debug settings on the tool node if needed.
+
+Agent-supplied parameters (via `$fromAI` when the tool is connected):
+
+| Parameter | Required | Notes |
+|-----------|----------|-------|
+| `name` | Yes | NFT display name |
+| `description` | No | Photo or artwork description |
+| `imagePath` | No | HTTPS URL or base64 image for `MintRequest.imagePath` |
+| `ownerEmail` | One of email/userId | Platform user email |
+| `ownerUserId` | One of email/userId | Org entry `id` from `GET /cl2c/user`; skips email lookup when set |
+| `smartContractId` | No | Overrides credential default |
+| `ownershipPercentage` | No | Default 100 |
+
+Manual **Execute** and **Tool** invoke share the same `execute()` code path.
+
+### Tool output fields (for agent prompts)
+
+On `MINTED`, the tool returns a single JSON item (under ~8 KB, no raw image bytes):
+
+```json
+{
+  "id": "uuid",
+  "status": "MINTED",
+  "name": "My Photo NFT",
+  "description": "…",
+  "imagePath": "https://…",
+  "externalUrl": "https://…",
+  "mintedAt": "2026-05-30T12:00:00.000Z",
+  "smartContract": {
+    "id": "uuid",
+    "contractAddress": "0x…",
+    "env": "TESTNET",
+    "network": "cordoba"
+  },
+  "copyright": [
+    {
+      "email": "owner@example.com",
+      "status": "…",
+      "percentage": 100,
+      "walletAddress": "0x…"
+    }
+  ]
+}
+```
+
+Use `id`, `status`, `mintedAt`, `smartContract.contractAddress`, and `copyright[]` in agent system prompts so the model can confirm mint success to the user.
+
+### Workflow Tool workaround (n8n #26202)
+
+Some n8n versions have a [FIFO queue ordering bug](https://github.com/n8n-io/n8n/issues/26202) where AI Agents receive an **empty observation** from `usableAsTool` community nodes even though the tool executed successfully.
+
+**Symptom:** Agent says the tool returned nothing; execution log shows the mint node succeeded with JSON output.
+
+**Workaround:** Wrap the mint in a sub-workflow and connect it via n8n's native **Workflow Tool** (uses `supplyData`, not the `usableAsTool` wrapper):
+
+1. Create a workflow with **Execute Workflow Trigger** (or **When Executed by Another Workflow**) → **Mint Biometric NFT** → return mapped JSON.
+2. In your agent workflow, add **Workflow Tool** pointing at that sub-workflow instead of **Mint Biometric NFT Tool** directly.
+3. Map tool inputs in the sub-workflow trigger to mint node parameters.
+
+Upgrade n8n when a fix for #26202 is available in your release channel.
+
+---
+
+## Error Reference
+
+All failures use `NodeOperationError` with a prefix in the execution log:
+
+| Prefix | Likely cause | Remediation |
+|--------|--------------|-------------|
+| **Configuration:** | Invalid or missing API key, bad base URL, missing default smart contract when node override is empty | Verify **Taliware API** credentials; set **Default Smart Contract ID** or node **Smart Contract ID** |
+| **Validation:** | Missing name, missing owner email/userId, owner not found, invalid `imagePath`, CL2C 400/404 validation | Fix parameters before retry; invite owner via platform or `POST /cl2c/user` |
+| **API:** | CL2C request failed, NFT `status: FAILED` after poll | Read message and API `details`; check contract env, owner Confida status, image data/URL |
+| **ConfidaTimeout:** | Poll timeout — owner did not complete biometric approval in time | Ask owner to approve on mobile; increase **Poll Timeout Minutes**; node does **not** auto re-mint |
+| **n8nTool:** | n8n tool-layer issues (e.g. empty observation from #26202) | Use [Workflow Tool workaround](#workflow-tool-workaround-n8n-26202); upgrade n8n |
+
+Example messages:
+
+- `Validation: Name is required`
+- `Validation: Owner not found — user must be invited via TALIWARE platform or POST /cl2c/user`
+- `Validation: imagePath must be an HTTPS URL, a data:image/...;base64,... URI, or raw base64 image data`
+- `ConfidaTimeout: Mint approval timed out — Confida biometric approval may still be pending (id=…, status=CREATED)`
+
+---
+
+## Reliability
+
+### Duplicate mint on agent retries
+
+CL2C v1.0.0 has **no idempotency key**. If an AI Agent retries a failed or timed-out tool call, each attempt creates a **new** NFT via `POST /cl2c/nft`. Design agent prompts and error handling to avoid blind retries after partial success (e.g. after create but before poll completes).
+
+### HTTP 429 rate limits
+
+The CL2C client retries up to 3 times with exponential backoff (1 s, 2 s, 4 s) on HTTP 429.
+
+### Poll behaviour
+
+The node polls until NFT-level `status` is `MINTED` or `FAILED`. Success is determined by `status === 'MINTED'`, not individual `copyright[].status` values. Defaults: 10 s interval, 20 min timeout (configurable on the node).
+
+### Debug mode
+
+Enable **Debug** on the node to log NFT `id`, poll count, and last `status` only — never API keys or full email addresses.
+
+---
+
+## Publishing
+
+Version **0.1.0** is published to npm as [`n8n-nodes-taliware`](https://www.npmjs.com/package/n8n-nodes-taliware).
+
+### Local checks before release
+
+```bash
+npm run lint
+npm run build
+npm pack --dry-run   # verify tarball: dist/, workflows/, README, LICENSE, CHANGELOG only
+```
+
+The package `files` field includes only `dist/` and `workflows/` — no BMad or planning artifacts are shipped.
+
+### Release to npm (with provenance)
+
+1. Configure [npm Trusted Publishing](https://docs.npmjs.com/trusted-publishers) (OIDC) on npmjs.com for this repo's `publish.yml` workflow, or set `NPM_TOKEN` in GitHub secrets.
+2. Locally bump and tag (does **not** publish from your machine):
+
+   ```bash
+   npm run release
+   ```
+
+3. Push the tag (e.g. `0.1.0`) — GitHub Actions runs `.github/workflows/publish.yml`, which lint/builds and runs `npm publish` with `NPM_CONFIG_PROVENANCE=true`.
+
+Example workflows for post-publish validation are in [`workflows/`](workflows/).
+
+---
+
+## Development
+
+**Requirements:** Node.js ≥ 22.16 (n8n engine), npm. For local `npm run dev` with bundled n8n, **Node 22 LTS** is recommended — Node 24 may fail on native `isolated-vm` builds.
+
+```bash
+cd n8n-nodes-taliware
+npm install          # uses .npmrc ignore-scripts=true for @n8n/node-cli
+npm run build
+npm run lint
+npm run dev          # symlinks to ~/.n8n-node-cli and starts n8n + tsc watch
+```
+
+### Local n8n test (while testnet tokens recharge)
+
+1. `npm run build && npm run dev` (or `docker compose up` after build).
+2. Open http://localhost:5678 → **Credentials → Taliware API**:
+   - **API Key:** your `n8nplugin…` CL2C key (`x-api-key`, not Bearer)
+   - **Default Smart Contract ID:** TESTNET contract UUID
+3. Import `workflows/manual-mint-binary.example.json`.
+4. Set **Read Binary File → filePath** to a local image (e.g. `scripts/fixtures/testest.png` during dev).
+5. Set **Owner Email** to a Confida-ready ACTIVE user; leave **Image Path** empty.
+6. Execute → approve Confida on mobile → node polls until `MINTED` or `FAILED`.
+
+See [`scripts/README.md`](scripts/README.md) for curl smoke tests without n8n.
+
+**External n8n:**
+
+```bash
+# Terminal 1
+npm run dev -- --external-n8n
+
+# Terminal 2
+N8N_DEV_RELOAD=true N8N_USER_FOLDER=$HOME/.n8n-node-cli n8n start
+```
+
+---
+
+## Resources
+
+- [CL2C OpenAPI spec (cl2c.yaml)](https://developer.taliware.com/api/cl2c.yaml)
+- [Confida documentation](https://developer.taliware.com/docs/confida)
+- [n8n community nodes](https://docs.n8n.io/integrations/community-nodes/)
+- [n8n $fromAI() function](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/)

package/dist/credentials/TaliwareApi.credentials.d.ts

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

package/dist/credentials/TaliwareApi.credentials.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaliwareApi = void 0;
+const DEFAULT_BASE_URL = 'https://developer.taliware.com/api/v1';
+class TaliwareApi {
+    constructor() {
+        this.name = 'taliwareApi';
+        this.displayName = 'Taliware API';
+        this.icon = {
+            light: 'file:icons/taliware.svg',
+            dark: 'file:icons/taliware.dark.svg',
+        };
+        this.documentationUrl = 'https://developer.taliware.com/docs/api';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                required: true,
+                default: '',
+                description: 'Organization API key from the TALIWARE Developer Platform',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: DEFAULT_BASE_URL,
+                description: 'CL2C API base URL (testnet uses the same host; select a TESTNET contract id)',
+            },
+            {
+                displayName: 'Default Smart Contract ID',
+                name: 'defaultSmartContractId',
+                type: 'string',
+                default: '',
+                description: 'Optional default contract UUID for mint operations',
+            },
+        ];
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/cl2c/user',
+                qs: { limit: '1' },
+                headers: {
+                    'x-api-key': '={{$credentials.apiKey}}',
+                },
+            },
+        };
+    }
+}
+exports.TaliwareApi = TaliwareApi;
+//# sourceMappingURL=TaliwareApi.credentials.js.map

package/dist/credentials/TaliwareApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaliwareApi.credentials.js","sourceRoot":"","sources":["../../credentials/TaliwareApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AAEjE,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QAErB,gBAAW,GAAG,cAAc,CAAC;QAE7B,SAAI,GAAS;YACZ,KAAK,EAAE,yBAAyB;YAChC,IAAI,EAAE,8BAA8B;SACpC,CAAC;QAEF,qBAAgB,GAAG,yCAAyC,CAAC;QAE7D,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,2DAA2D;aACxE;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,gBAAgB;gBACzB,WAAW,EAAE,8EAA8E;aAC3F;YACD;gBACC,WAAW,EAAE,2BAA2B;gBACxC,IAAI,EAAE,wBAAwB;gBAC9B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,oDAAoD;aACjE;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,YAAY;gBACjB,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;gBAClB,OAAO,EAAE;oBACR,WAAW,EAAE,0BAA0B;iBACvC;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAhDD,kCAgDC"}

package/dist/credentials/icons/taliware.dark.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="aquamarine"
+    stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-cpu">
+    <rect x="4" y="4" width="16" height="16" rx="2" ry="2"></rect>
+    <rect x="9" y="9" width="6" height="6"></rect>
+    <line x1="9" y1="1" x2="9" y2="4"></line>
+    <line x1="15" y1="1" x2="15" y2="4"></line>
+    <line x1="9" y1="20" x2="9" y2="23"></line>
+    <line x1="15" y1="20" x2="15" y2="23"></line>
+    <line x1="20" y1="9" x2="23" y2="9"></line>
+    <line x1="20" y1="14" x2="23" y2="14"></line>
+    <line x1="1" y1="9" x2="4" y2="9"></line>
+    <line x1="1" y1="14" x2="4" y2="14"></line>
+</svg>

package/dist/credentials/icons/taliware.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="darkblue"
+    stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-cpu">
+    <rect x="4" y="4" width="16" height="16" rx="2" ry="2"></rect>
+    <rect x="9" y="9" width="6" height="6"></rect>
+    <line x1="9" y1="1" x2="9" y2="4"></line>
+    <line x1="15" y1="1" x2="15" y2="4"></line>
+    <line x1="9" y1="20" x2="9" y2="23"></line>
+    <line x1="15" y1="20" x2="15" y2="23"></line>
+    <line x1="20" y1="9" x2="23" y2="9"></line>
+    <line x1="20" y1="14" x2="23" y2="14"></line>
+    <line x1="1" y1="9" x2="4" y2="9"></line>
+    <line x1="1" y1="14" x2="4" y2="14"></line>
+</svg>

package/dist/lib/cl2cClient.d.ts

@@ -0,0 +1,18 @@
+import type { INode } from 'n8n-workflow';
+import type { TaliwareApiCredentials } from './types';
+export interface Cl2cRequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string | number | undefined>;
+    body?: unknown;
+}
+export declare class Cl2cClient {
+    private readonly credentials;
+    private readonly node;
+    constructor(credentials: TaliwareApiCredentials, node: INode);
+    request<T>(options: Cl2cRequestOptions): Promise<T>;
+    private buildUrl;
+    private parseResponse;
+    private assertCl2cPath;
+}
+export declare function createCl2cClient(credentials: TaliwareApiCredentials, node: INode): Cl2cClient;

package/dist/lib/cl2cClient.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cl2cClient = void 0;
+exports.createCl2cClient = createCl2cClient;
+const n8n_workflow_1 = require("n8n-workflow");
+const errors_1 = require("./errors");
+const MAX_429_RETRIES = 3;
+const INITIAL_BACKOFF_MS = 1000;
+class Cl2cClient {
+    constructor(credentials, node) {
+        this.credentials = credentials;
+        this.node = node;
+    }
+    async request(options) {
+        this.assertCl2cPath(options.path);
+        for (let attempt = 0; attempt <= MAX_429_RETRIES; attempt++) {
+            const response = await fetch(this.buildUrl(options), {
+                method: options.method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-api-key': this.credentials.apiKey,
+                },
+                body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+            });
+            if (response.status === 429 && attempt < MAX_429_RETRIES) {
+                await (0, n8n_workflow_1.sleep)(INITIAL_BACKOFF_MS * Math.pow(2, attempt));
+                continue;
+            }
+            return await this.parseResponse(response);
+        }
+        throw (0, errors_1.configurationError)(this.node, 'Exceeded maximum retries for rate-limited CL2C request');
+    }
+    buildUrl(options) {
+        const url = new URL(options.path.startsWith('/') ? options.path.slice(1) : options.path, `${this.credentials.baseUrl}/`);
+        if (options.query) {
+            for (const [key, value] of Object.entries(options.query)) {
+                if (value !== undefined && value !== '') {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    async parseResponse(response) {
+        if (response.status === 401) {
+            throw (0, errors_1.configurationError)(this.node, errors_1.INVALID_API_KEY_MESSAGE);
+        }
+        const payload = await readResponseBody(response);
+        if (!response.ok) {
+            throw (0, errors_1.httpErrorFromResponse)(this.node, response.status, payload, `HTTP ${response.status}: CL2C request failed`);
+        }
+        return payload;
+    }
+    assertCl2cPath(path) {
+        const normalized = path.startsWith('/') ? path : `/${path}`;
+        if (!normalized.startsWith('/cl2c/')) {
+            throw (0, errors_1.configurationError)(this.node, `Invalid CL2C path: ${normalized}`);
+        }
+    }
+}
+exports.Cl2cClient = Cl2cClient;
+function createCl2cClient(credentials, node) {
+    return new Cl2cClient(credentials, node);
+}
+async function readResponseBody(response) {
+    const text = await response.text();
+    if (!text) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=cl2cClient.js.map

package/dist/lib/cl2cClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cl2cClient.js","sourceRoot":"","sources":["../../lib/cl2cClient.ts"],"names":[],"mappings":"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"}

package/dist/lib/createNft.d.ts

@@ -0,0 +1,12 @@
+import type { Cl2cClient } from './cl2cClient';
+import { type NftDetail } from './types';
+export interface CreateNftInput {
+    name: string;
+    smartContractId: string;
+    userId: string;
+    ownershipPercentage: number;
+    description?: string;
+    imagePath?: string;
+    externalUrl?: string;
+}
+export declare function createNft(client: Cl2cClient, input: CreateNftInput): Promise<NftDetail>;

package/dist/lib/createNft.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNft = createNft;
+const types_1 = require("./types");
+async function createNft(client, input) {
+    var _a, _b, _c;
+    const body = {
+        name: input.name.trim(),
+        smartContractId: input.smartContractId,
+        supply: 1,
+        copyright: [
+            {
+                userId: input.userId,
+                percentage: input.ownershipPercentage,
+            },
+        ],
+    };
+    const description = (_a = input.description) === null || _a === void 0 ? void 0 : _a.trim();
+    if (description) {
+        body.description = description;
+    }
+    const imagePath = (_b = input.imagePath) === null || _b === void 0 ? void 0 : _b.trim();
+    if (imagePath) {
+        body.imagePath = imagePath;
+    }
+    const externalUrl = (_c = input.externalUrl) === null || _c === void 0 ? void 0 : _c.trim();
+    if (externalUrl) {
+        body.externalUrl = externalUrl;
+    }
+    return await client.request({
+        method: 'POST',
+        path: types_1.CL2C_PATHS.nft,
+        body,
+    });
+}
+//# sourceMappingURL=createNft.js.map

package/dist/lib/createNft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNft.js","sourceRoot":"","sources":["../../lib/createNft.ts"],"names":[],"mappings":";;AAaA,8BAoCC;AAhDD,mCAAuE;AAYhE,KAAK,UAAU,SAAS,CAC9B,MAAkB,EAClB,KAAqB;;IAErB,MAAM,IAAI,GAAgB;QACzB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QACvB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,MAAM,EAAE,CAAC;QACT,SAAS,EAAE;YACV;gBACC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,mBAAmB;aACrC;SACD;KACD,CAAC;IAEF,MAAM,WAAW,GAAG,MAAA,KAAK,CAAC,WAAW,0CAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,WAAW,EAAE,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;IAED,MAAM,SAAS,GAAG,MAAA,KAAK,CAAC,SAAS,0CAAE,IAAI,EAAE,CAAC;IAC1C,IAAI,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,MAAM,WAAW,GAAG,MAAA,KAAK,CAAC,WAAW,0CAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,WAAW,EAAE,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,MAAM,CAAC,OAAO,CAAY;QACtC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,kBAAU,CAAC,GAAG;QACpB,IAAI;KACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,16 @@
+import type { INode } from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+import type { Cl2cErrorResponse } from './types';
+export type ErrorPrefix = 'Configuration' | 'Validation' | 'API' | 'ConfidaTimeout' | 'n8nTool';
+export declare function prefixedError(prefix: ErrorPrefix, message: string): string;
+export declare function createNodeError(node: INode, prefix: ErrorPrefix, message: string): NodeOperationError;
+export declare function configurationError(node: INode, message: string): NodeOperationError;
+export declare function validationError(node: INode, message: string): NodeOperationError;
+export declare function apiError(node: INode, message: string): NodeOperationError;
+export declare function confidaTimeoutError(node: INode, message: string): NodeOperationError;
+export declare function n8nToolError(node: INode, message: string): NodeOperationError;
+export declare const INVALID_API_KEY_MESSAGE = "Invalid API key or unauthorized access";
+export declare function formatCl2cApiErrorMessage(payload: unknown, fallback?: string): string;
+export declare function apiErrorFromPayload(node: INode, payload: unknown, fallback?: string): NodeOperationError;
+export declare function httpErrorFromResponse(node: INode, status: number, payload: unknown, fallback?: string): NodeOperationError;
+export declare function isCl2cErrorResponse(payload: unknown): payload is Cl2cErrorResponse;

package/dist/lib/errors.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVALID_API_KEY_MESSAGE = void 0;
+exports.prefixedError = prefixedError;
+exports.createNodeError = createNodeError;
+exports.configurationError = configurationError;
+exports.validationError = validationError;
+exports.apiError = apiError;
+exports.confidaTimeoutError = confidaTimeoutError;
+exports.n8nToolError = n8nToolError;
+exports.formatCl2cApiErrorMessage = formatCl2cApiErrorMessage;
+exports.apiErrorFromPayload = apiErrorFromPayload;
+exports.httpErrorFromResponse = httpErrorFromResponse;
+exports.isCl2cErrorResponse = isCl2cErrorResponse;
+const n8n_workflow_1 = require("n8n-workflow");
+function prefixedError(prefix, message) {
+    return `${prefix}: ${message}`;
+}
+function createNodeError(node, prefix, message) {
+    return new n8n_workflow_1.NodeOperationError(node, prefixedError(prefix, message));
+}
+function configurationError(node, message) {
+    return createNodeError(node, 'Configuration', message);
+}
+function validationError(node, message) {
+    return createNodeError(node, 'Validation', message);
+}
+function apiError(node, message) {
+    return createNodeError(node, 'API', message);
+}
+function confidaTimeoutError(node, message) {
+    return createNodeError(node, 'ConfidaTimeout', message);
+}
+function n8nToolError(node, message) {
+    return createNodeError(node, 'n8nTool', message);
+}
+exports.INVALID_API_KEY_MESSAGE = 'Invalid API key or unauthorized access';
+function formatCl2cApiErrorMessage(payload, fallback = 'API request failed') {
+    if (!payload || typeof payload !== 'object') {
+        return fallback;
+    }
+    const record = payload;
+    const parts = [];
+    if (typeof record.error === 'string' && record.error.trim()) {
+        parts.push(record.error.trim());
+    }
+    if (Array.isArray(record.details)) {
+        const detailMessages = record.details.filter((entry) => typeof entry === 'string' && entry.trim().length > 0);
+        if (detailMessages.length > 0) {
+            parts.push(detailMessages.join('; '));
+        }
+    }
+    return parts.length > 0 ? parts.join(' — ') : fallback;
+}
+function apiErrorFromPayload(node, payload, fallback) {
+    return apiError(node, formatCl2cApiErrorMessage(payload, fallback));
+}
+function httpErrorFromResponse(node, status, payload, fallback) {
+    const message = formatCl2cApiErrorMessage(payload, fallback !== null && fallback !== void 0 ? fallback : `HTTP ${status}: CL2C request failed`);
+    if (status === 400 || status === 404) {
+        return validationError(node, message);
+    }
+    return apiError(node, message);
+}
+function isCl2cErrorResponse(payload) {
+    return Boolean(payload && typeof payload === 'object' && 'error' in payload);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../lib/errors.ts"],"names":[],"mappings":"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"}