n8n-nodes-caedral 0.1.0

package/README.md

@@ -0,0 +1,93 @@
+# n8n-nodes-caedral
+
+Official [n8n](https://n8n.io) community node for the [Caedral API](https://caedral.com). Send chat completions and check prepaid API usage from your workflows.
+
+## Installation
+
+### npm (recommended for self-hosted n8n)
+
+```bash
+cd ~/.n8n/custom
+npm install n8n-nodes-caedral
+# Restart n8n
+```
+
+### Local development (monorepo)
+
+```bash
+cd n8n-nodes-caedral
+npm install && npm run build
+npm link
+cd ~/.n8n/custom && npm link n8n-nodes-caedral
+```
+
+## Credentials
+
+Create **Caedral API** credentials in n8n:
+
+| Field | Description |
+|-------|-------------|
+| API Key | Your `cd_live_...` key from [Dashboard → API Keys](https://caedral.com/dashboard/api-keys) |
+| Base URL | `https://api.caedral.com` (production) or `http://localhost:5001` (local gateway) |
+
+Connection test calls `GET /v1/usage`.
+
+## Operations
+
+### Chat Completion
+
+Send a chat completion to any Caedral model tier (`caedral-base`, `caedral-titan`, `caedral-olympus`, `caedral-primordial`).
+
+Configure:
+
+- **Model** — dropdown of available tiers
+- **Messages** — JSON array or individual role/content fields
+- **Temperature**, **Max Tokens** — optional generation parameters
+
+Returns parsed `content`, `model`, `finishReason`, and `usage` fields.
+
+### Get Usage
+
+Returns prepaid API balance, weekly pool (for Caedral Chat), plan info, and account status via `GET /v1/usage`.
+
+## Example workflow
+
+1. **Get Usage** — check `balanceCents` before a paid-tier call
+2. **IF** — continue only if balance is sufficient
+3. **Chat Completion** — run inference with `caedral-olympus`
+4. Send output to Slack, email, or downstream nodes
+
+See [Example n8n workflow](https://caedral.com/docs/n8n-example) in the Caedral docs.
+
+## HTTP details
+
+The node calls the Caedral API gateway directly:
+
+- `POST /v1/chat/completions` — chat completion
+- `GET /v1/usage` — usage summary
+
+Authentication: `Authorization: Bearer <apiKey>`.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+Integration tests require a running local gateway on port **5001** and `DATABASE_URL` in the repo root `.env`.
+
+## Publishing
+
+See [PUBLISHING.md](./PUBLISHING.md) for npm publish and n8n Creator Portal submission steps.
+
+## Links
+
+- [Caedral docs — n8n overview](https://caedral.com/docs/n8n-overview)
+- [npm package](https://www.npmjs.com/package/n8n-nodes-caedral)
+- [GitHub](https://github.com/caedral/n8n-nodes-caedral)
+
+## License
+
+MIT

package/dist/credentials/CaedralApi.credentials.d.ts

@@ -0,0 +1,20 @@
+import type { ICredentialTestRequest, ICredentialType, INodeProperties } from "n8n-workflow";
+/**
+ * n8n credential type for the Caedral API.
+ *
+ * Collects the user's `apiKey` (stored securely as a password
+ * field) and an optional `baseUrl` override for self-hosted or
+ * local deployments. The `test` request validates the credentials
+ * by hitting `GET /v1/usage`, which requires a valid API key.
+ */
+export declare class CaedralApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    icon: {
+        readonly light: "file:../../icons/caedral.svg";
+        readonly dark: "file:../../icons/caedral.dark.svg";
+    };
+    properties: INodeProperties[];
+    test: ICredentialTestRequest;
+}

package/dist/credentials/CaedralApi.credentials.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaedralApi = void 0;
+const constants_1 = require("../shared/constants");
+/**
+ * n8n credential type for the Caedral API.
+ *
+ * Collects the user's `apiKey` (stored securely as a password
+ * field) and an optional `baseUrl` override for self-hosted or
+ * local deployments. The `test` request validates the credentials
+ * by hitting `GET /v1/usage`, which requires a valid API key.
+ */
+class CaedralApi {
+    constructor() {
+        this.name = "caedralApi";
+        this.displayName = "Caedral API";
+        this.documentationUrl = "https://caedral.com/docs";
+        this.icon = {
+            light: "file:../../icons/caedral.svg",
+            dark: "file:../../icons/caedral.dark.svg",
+        };
+        this.properties = [
+            {
+                displayName: "API Key",
+                name: "apiKey",
+                type: "string",
+                typeOptions: { password: true },
+                default: "",
+                required: true,
+                placeholder: "cd_live_...",
+                description: "Your Caedral API key from the dashboard",
+            },
+            {
+                displayName: "Base URL",
+                name: "baseUrl",
+                type: "string",
+                default: constants_1.DEFAULT_BASE_URL,
+                description: "Caedral API gateway URL. Use http://localhost:5001 for local development.",
+            },
+        ];
+        this.test = {
+            request: {
+                baseURL: "={{$credentials.baseUrl}}",
+                url: "/v1/usage",
+                method: "GET",
+                headers: {
+                    Authorization: "=Bearer {{$credentials.apiKey}}",
+                    Accept: "application/json",
+                },
+            },
+        };
+    }
+}
+exports.CaedralApi = CaedralApi;
+//# sourceMappingURL=CaedralApi.credentials.js.map

package/dist/credentials/CaedralApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaedralApi.credentials.js","sourceRoot":"","sources":["../../credentials/CaedralApi.credentials.ts"],"names":[],"mappings":";;;AAMA,mDAAuD;AAEvD;;;;;;;GAOG;AACH,MAAa,UAAU;IAAvB;QACE,SAAI,GAAG,YAAY,CAAC;QAEpB,gBAAW,GAAG,aAAa,CAAC;QAE5B,qBAAgB,GAAG,0BAA0B,CAAC;QAE9C,SAAI,GAAG;YACL,KAAK,EAAE,8BAA8B;YACrC,IAAI,EAAE,mCAAmC;SACjC,CAAC;QAEX,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,aAAa;gBAC1B,WAAW,EAAE,yCAAyC;aACvD;YACD;gBACE,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,4BAAgB;gBACzB,WAAW,EACT,2EAA2E;aAC9E;SACF,CAAC;QAEF,SAAI,GAA2B;YAC7B,OAAO,EAAE;gBACP,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,WAAW;gBAChB,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,aAAa,EAAE,iCAAiC;oBAChD,MAAM,EAAE,kBAAkB;iBAC3B;aACF;SACF,CAAC;IACJ,CAAC;CAAA;AA5CD,gCA4CC"}

package/dist/icons/caedral.dark.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="60" viewBox="0 0 100 100" role="img" aria-label="Caedral">
+  <g fill="#E8DCC4">
+    <polygon points="18,82 40,82 52,42 30,42"/>
+    <polygon points="48,82 70,82 86,18 64,18"/>
+  </g>
+</svg>

package/dist/icons/caedral.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="60" viewBox="0 0 100 100" role="img" aria-label="Caedral">
+  <g fill="#D4C5A9">
+    <polygon points="18,82 40,82 52,42 30,42"/>
+    <polygon points="48,82 70,82 86,18 64,18"/>
+  </g>
+</svg>

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

@@ -0,0 +1,36 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from "n8n-workflow";
+/**
+ * n8n node exposing the Caedral API.
+ *
+ * Supports two operations:
+ * - `chatCompletion` — send a chat completion request to a Caedral
+ *   model, either with a single simple message or a full JSON
+ *   messages array.
+ * - `getUsage` — fetch the account's current pool, balance, and
+ *   overage status.
+ *
+ * Requests are authenticated using the `caedralApi` credentials
+ * (API key + optional base URL override).
+ */
+export declare class Caedral implements INodeType {
+    description: INodeTypeDescription;
+    /**
+     * Execute the node for every input item.
+     *
+     * For each item, resolves the selected `operation` and dispatches
+     * the corresponding Caedral API call. On success, the response is
+     * normalized into a flat JSON object and pushed to the output.
+     *
+     * When "Continue On Fail" is enabled, per-item errors are captured
+     * as `{ error: string }` entries in the output; otherwise the
+     * error is re-thrown (wrapped in `NodeOperationError` if it is not
+     * already a node error).
+     *
+     * @returns A single-branch array of output items, one per input.
+     * @throws {NodeApiError} If the Caedral API returns a non-2xx
+     *   status and "Continue On Fail" is disabled.
+     * @throws {NodeOperationError} For validation or unknown-operation
+     *   errors, or when wrapping an unexpected runtime error.
+     */
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/Caedral/Caedral.node.js

@@ -0,0 +1,298 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Caedral = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const helpers_1 = require("./helpers");
+/**
+ * n8n node exposing the Caedral API.
+ *
+ * Supports two operations:
+ * - `chatCompletion` — send a chat completion request to a Caedral
+ *   model, either with a single simple message or a full JSON
+ *   messages array.
+ * - `getUsage` — fetch the account's current pool, balance, and
+ *   overage status.
+ *
+ * Requests are authenticated using the `caedralApi` credentials
+ * (API key + optional base URL override).
+ */
+class Caedral {
+    constructor() {
+        this.description = {
+            displayName: "Caedral",
+            name: "caedral",
+            icon: {
+                light: "file:../../icons/caedral.svg",
+                dark: "file:../../icons/caedral.dark.svg",
+            },
+            group: ["transform"],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: "Call Caedral AI models and check usage from your workflows",
+            defaults: {
+                name: "Caedral",
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [
+                {
+                    name: "caedralApi",
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: "Operation",
+                    name: "operation",
+                    type: "options",
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: "Chat Completion",
+                            value: "chatCompletion",
+                            description: "Send a chat completion request to a Caedral model",
+                            action: "Send a chat completion",
+                        },
+                        {
+                            name: "Get Usage",
+                            value: "getUsage",
+                            description: "Get current pool, balance, and overage status",
+                            action: "Get usage",
+                        },
+                    ],
+                    default: "chatCompletion",
+                },
+                {
+                    displayName: "Model",
+                    name: "model",
+                    type: "options",
+                    displayOptions: {
+                        show: {
+                            operation: ["chatCompletion"],
+                        },
+                    },
+                    options: [...helpers_1.MODEL_OPTIONS],
+                    default: "caedral-base",
+                    description: "The Caedral model tier to use",
+                },
+                {
+                    displayName: "Message Input Mode",
+                    name: "messageMode",
+                    type: "options",
+                    displayOptions: {
+                        show: {
+                            operation: ["chatCompletion"],
+                        },
+                    },
+                    options: [
+                        {
+                            name: "Simple",
+                            value: "simple",
+                            description: "Single user message text",
+                        },
+                        {
+                            name: "JSON",
+                            value: "json",
+                            description: "Full messages array as JSON",
+                        },
+                    ],
+                    default: "simple",
+                },
+                {
+                    displayName: "Message",
+                    name: "message",
+                    type: "string",
+                    typeOptions: {
+                        rows: 4,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ["chatCompletion"],
+                            messageMode: ["simple"],
+                        },
+                    },
+                    default: "",
+                    placeholder: "Explain quantum computing in one sentence.",
+                    description: "The user message sent to the model",
+                },
+                {
+                    displayName: "Messages JSON",
+                    name: "messagesJson",
+                    type: "json",
+                    displayOptions: {
+                        show: {
+                            operation: ["chatCompletion"],
+                            messageMode: ["json"],
+                        },
+                    },
+                    default: '[{"role":"user","content":"Hello!"}]',
+                    description: 'Array of message objects, e.g. [{"role":"user","content":"Hello"}]',
+                },
+                {
+                    displayName: "Temperature",
+                    name: "temperature",
+                    type: "number",
+                    typeOptions: {
+                        minValue: 0,
+                        maxValue: 2,
+                        numberStepSize: 0.1,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ["chatCompletion"],
+                        },
+                    },
+                    default: 1,
+                    description: "Sampling temperature (0–2). Leave default to omit from request.",
+                },
+                {
+                    displayName: "Max Tokens",
+                    name: "maxTokens",
+                    type: "number",
+                    typeOptions: {
+                        minValue: 1,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ["chatCompletion"],
+                        },
+                    },
+                    default: 0,
+                    description: "Maximum tokens to generate. Set to 0 to omit from request.",
+                },
+            ],
+        };
+    }
+    /**
+     * Execute the node for every input item.
+     *
+     * For each item, resolves the selected `operation` and dispatches
+     * the corresponding Caedral API call. On success, the response is
+     * normalized into a flat JSON object and pushed to the output.
+     *
+     * When "Continue On Fail" is enabled, per-item errors are captured
+     * as `{ error: string }` entries in the output; otherwise the
+     * error is re-thrown (wrapped in `NodeOperationError` if it is not
+     * already a node error).
+     *
+     * @returns A single-branch array of output items, one per input.
+     * @throws {NodeApiError} If the Caedral API returns a non-2xx
+     *   status and "Continue On Fail" is disabled.
+     * @throws {NodeOperationError} For validation or unknown-operation
+     *   errors, or when wrapping an unexpected runtime error.
+     */
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = (await this.getCredentials("caedralApi"));
+        const baseUrl = (0, helpers_1.normalizeBaseUrl)(credentials.baseUrl);
+        const apiKey = credentials.apiKey;
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+            try {
+                const operation = this.getNodeParameter("operation", itemIndex);
+                if (operation === "getUsage") {
+                    const usage = await caedralRequest(this, baseUrl, apiKey, "GET", "/v1/usage");
+                    returnData.push({
+                        json: (0, helpers_1.formatUsageForOutput)(usage),
+                        pairedItem: { item: itemIndex },
+                    });
+                    continue;
+                }
+                if (operation === "chatCompletion") {
+                    const model = this.getNodeParameter("model", itemIndex);
+                    const messageMode = this.getNodeParameter("messageMode", itemIndex);
+                    const message = this.getNodeParameter("message", itemIndex);
+                    const messagesJson = this.getNodeParameter("messagesJson", itemIndex);
+                    const temperature = this.getNodeParameter("temperature", itemIndex);
+                    const maxTokens = this.getNodeParameter("maxTokens", itemIndex);
+                    const body = (0, helpers_1.buildChatCompletionBody)({
+                        model,
+                        messageMode,
+                        message,
+                        messagesJson: messagesJson,
+                        temperature: temperature === 1 ? undefined : temperature,
+                        maxTokens: maxTokens > 0 ? maxTokens : undefined,
+                    });
+                    const response = await caedralRequest(this, baseUrl, apiKey, "POST", "/v1/chat/completions", body);
+                    const parsed = (0, helpers_1.parseChatCompletionResponse)(response);
+                    returnData.push({
+                        json: {
+                            content: parsed.content,
+                            model: parsed.model,
+                            finishReason: parsed.finishReason,
+                            usage: parsed.usage,
+                            raw: parsed.raw,
+                        },
+                        pairedItem: { item: itemIndex },
+                    });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`, {
+                    itemIndex,
+                });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: {
+                            error: error instanceof Error ? error.message : String(error),
+                        },
+                        pairedItem: { item: itemIndex },
+                    });
+                    continue;
+                }
+                if (error instanceof n8n_workflow_1.NodeApiError || error instanceof n8n_workflow_1.NodeOperationError) {
+                    throw error;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, {
+                    itemIndex,
+                });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Caedral = Caedral;
+async function caedralRequest(context, baseUrl, apiKey, method, path, body) {
+    const url = (0, helpers_1.buildRequestUrl)(baseUrl, path);
+    try {
+        const requestOptions = {
+            method,
+            url,
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                Accept: "application/json",
+            },
+            json: true,
+            returnFullResponse: true,
+            ignoreHttpStatusErrors: true,
+        };
+        if (body !== undefined) {
+            requestOptions.headers["Content-Type"] = "application/json";
+            requestOptions.body = body;
+        }
+        const response = await context.helpers.httpRequest(requestOptions);
+        const statusCode = response.statusCode;
+        const responseBody = response.body;
+        if (statusCode >= 400) {
+            throw new n8n_workflow_1.NodeApiError(context.getNode(), {
+                message: (0, helpers_1.formatApiErrorMessage)(statusCode, responseBody),
+                description: JSON.stringify(responseBody, null, 2),
+                httpCode: String(statusCode),
+            });
+        }
+        return responseBody;
+    }
+    catch (error) {
+        if (error instanceof n8n_workflow_1.NodeApiError) {
+            throw error;
+        }
+        throw new n8n_workflow_1.NodeApiError(context.getNode(), {
+            message: error instanceof Error
+                ? error.message
+                : "Unexpected error calling Caedral API",
+        });
+    }
+}
+//# sourceMappingURL=Caedral.node.js.map

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

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

package/dist/nodes/Caedral/Caedral.node.json

@@ -0,0 +1,18 @@
+{
+  "node": "n8n-nodes-caedral",
+  "nodeVersion": "1.0",
+  "codexVersion": "1.0",
+  "categories": ["Development", "AI"],
+  "resources": {
+    "primaryDocumentation": [
+      {
+        "url": "https://caedral.com/docs"
+      }
+    ],
+    "credentialDocumentation": [
+      {
+        "url": "https://caedral.com/docs/authentication"
+      }
+    ]
+  }
+}

package/dist/nodes/Caedral/helpers.d.ts

@@ -0,0 +1,203 @@
+import { DEFAULT_BASE_URL } from "../../shared/constants";
+export { DEFAULT_BASE_URL };
+export declare const MODEL_OPTIONS: readonly [{
+    readonly name: "Base (Free)";
+    readonly value: "caedral-base";
+}, {
+    readonly name: "Titan";
+    readonly value: "caedral-titan";
+}, {
+    readonly name: "Olympus";
+    readonly value: "caedral-olympus";
+}, {
+    readonly name: "Primordial";
+    readonly value: "caedral-primordial";
+}];
+export type CaedralModelId = (typeof MODEL_OPTIONS)[number]["value"];
+export type ChatMessage = {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+    name?: string;
+};
+export type ChatCompletionRequestBody = {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    max_tokens?: number;
+};
+export type ChatCompletionResponse = {
+    id?: string;
+    model?: string;
+    choices?: Array<{
+        index?: number;
+        message?: {
+            role?: string;
+            content?: string | null;
+        };
+        finish_reason?: string | null;
+    }>;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+};
+export type UsageResponse = {
+    accountStatus?: string;
+    plan?: string;
+    planStatus?: string;
+    balanceCents?: number;
+    weeklyPool?: {
+        limit?: number;
+        used?: number;
+        remaining?: number;
+    };
+    overage?: {
+        enabled?: boolean;
+        limitCents?: number | null;
+        usedCents?: number;
+        remainingCents?: number | null;
+    };
+    balanceWeightedUnitsAffordable?: number;
+};
+export type CaedralApiErrorBody = {
+    error?: {
+        type?: string;
+        message?: string;
+        code?: number;
+    };
+};
+/**
+ * Normalize a user-supplied base URL for the Caedral API.
+ *
+ * Trims whitespace, falls back to {@link DEFAULT_BASE_URL} when
+ * empty, and strips any trailing slash so that paths can be
+ * appended safely.
+ *
+ * @param baseUrl - Raw base URL from the node credentials.
+ * @returns The normalized base URL without a trailing slash.
+ */
+export declare function normalizeBaseUrl(baseUrl?: string): string;
+/**
+ * Build the JSON body for a `POST /v1/chat/completions` request.
+ *
+ * Resolves the messages array from either the simple `message`
+ * field or the raw `messagesJson`, and includes `temperature` and
+ * `max_tokens` only when they are explicitly provided.
+ *
+ * @param params - Node parameters collected for the chat completion
+ *   operation.
+ * @returns A fully-formed request body ready to send to the API.
+ * @throws {Error} If message resolution fails (missing text in
+ *   Simple mode, or invalid JSON in JSON mode).
+ */
+export declare function buildChatCompletionBody(params: {
+    model: string;
+    messageMode: "simple" | "json";
+    message?: string;
+    messagesJson?: string | ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+}): ChatCompletionRequestBody;
+/**
+ * Resolve the effective chat messages array for a request.
+ *
+ * In `"simple"` mode a single user message is built from the
+ * trimmed `message` string. In `"json"` mode the `messagesJson`
+ * input is parsed and validated via {@link parseMessagesJson}.
+ *
+ * @param messageMode - Which input path to use.
+ * @param message - Raw text for Simple mode.
+ * @param messagesJson - Raw JSON (string or already-parsed array)
+ *   for JSON mode.
+ * @returns The validated list of chat messages.
+ * @throws {Error} If required input is missing or invalid.
+ */
+export declare function resolveMessages(messageMode: "simple" | "json", message?: string, messagesJson?: string | ChatMessage[]): ChatMessage[];
+/**
+ * Parse and validate the raw `messagesJson` node input.
+ *
+ * Accepts either a JSON-encoded string or an already-decoded array.
+ * Each entry must be an object with a supported `role`
+ * (`"system" | "user" | "assistant" | "tool"`) and a string
+ * `content`.
+ *
+ * @param raw - The raw input value provided by the user.
+ * @returns The list of validated chat messages.
+ * @throws {Error} If the value is missing, is not valid JSON, is
+ *   not an array, or contains an invalid entry.
+ */
+export declare function parseMessagesJson(raw: string | ChatMessage[] | undefined): ChatMessage[];
+/**
+ * Flatten a raw chat completion response into the shape emitted by
+ * the node.
+ *
+ * Extracts the first choice's content, the model id, the finish
+ * reason, and token usage, while also preserving the full `raw`
+ * payload for downstream nodes that need it.
+ *
+ * @param response - Raw API response body.
+ * @returns A flattened, node-friendly representation.
+ */
+export declare function parseChatCompletionResponse(response: ChatCompletionResponse): {
+    content: string;
+    model: string;
+    finishReason: string | null;
+    usage: ChatCompletionResponse["usage"] | null;
+    raw: ChatCompletionResponse;
+};
+/**
+ * Normalize a `GET /v1/usage` response for node output.
+ *
+ * Fills in defaults for any missing fields so downstream nodes can
+ * rely on a stable shape (numeric zeros instead of `undefined`,
+ * `"unknown"` for missing status strings, etc.).
+ *
+ * @param usage - Raw usage response from the API.
+ * @returns A fully-populated usage object with default values.
+ */
+export declare function formatUsageForOutput(usage: UsageResponse): {
+    accountStatus: string;
+    plan: string;
+    planStatus: string;
+    balanceCents: number;
+    weeklyPool: {
+        limit: number;
+        used: number;
+        remaining: number;
+    };
+    overage: {
+        enabled: boolean;
+        limitCents: number | null;
+        usedCents: number;
+        remainingCents: number | null;
+    };
+    balanceWeightedUnitsAffordable: number;
+};
+/**
+ * Format a human-readable error message from a Caedral API failure.
+ *
+ * If the body follows the Caedral error envelope
+ * (`{ error: { type, message, code } }`), the `type` is prefixed
+ * in brackets before the message. Otherwise a generic message
+ * including the HTTP status is returned.
+ *
+ * @param statusCode - HTTP status code of the failing response.
+ * @param body - Parsed error body, or the raw text when parsing
+ *   failed.
+ * @returns A human-readable error message suitable for surfacing
+ *   in n8n.
+ */
+export declare function formatApiErrorMessage(statusCode: number, body: CaedralApiErrorBody | string): string;
+/**
+ * Compose a full API URL from a base URL and endpoint path.
+ *
+ * The base URL is passed through {@link normalizeBaseUrl} and the
+ * path is prefixed with `/` if it does not already start with one,
+ * guaranteeing exactly one slash between the two.
+ *
+ * @param baseUrl - Base URL for the Caedral API.
+ * @param path - Endpoint path (with or without a leading slash).
+ * @returns The composed absolute URL.
+ */
+export declare function buildRequestUrl(baseUrl: string, path: string): string;

package/dist/nodes/Caedral/helpers.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_OPTIONS = exports.DEFAULT_BASE_URL = void 0;
+exports.normalizeBaseUrl = normalizeBaseUrl;
+exports.buildChatCompletionBody = buildChatCompletionBody;
+exports.resolveMessages = resolveMessages;
+exports.parseMessagesJson = parseMessagesJson;
+exports.parseChatCompletionResponse = parseChatCompletionResponse;
+exports.formatUsageForOutput = formatUsageForOutput;
+exports.formatApiErrorMessage = formatApiErrorMessage;
+exports.buildRequestUrl = buildRequestUrl;
+const constants_1 = require("../../shared/constants");
+Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return constants_1.DEFAULT_BASE_URL; } });
+exports.MODEL_OPTIONS = [
+    { name: "Base (Free)", value: "caedral-base" },
+    { name: "Titan", value: "caedral-titan" },
+    { name: "Olympus", value: "caedral-olympus" },
+    { name: "Primordial", value: "caedral-primordial" },
+];
+/**
+ * Normalize a user-supplied base URL for the Caedral API.
+ *
+ * Trims whitespace, falls back to {@link DEFAULT_BASE_URL} when
+ * empty, and strips any trailing slash so that paths can be
+ * appended safely.
+ *
+ * @param baseUrl - Raw base URL from the node credentials.
+ * @returns The normalized base URL without a trailing slash.
+ */
+function normalizeBaseUrl(baseUrl) {
+    const trimmed = ((baseUrl === null || baseUrl === void 0 ? void 0 : baseUrl.trim()) || constants_1.DEFAULT_BASE_URL).replace(/\/$/, "");
+    return trimmed;
+}
+/**
+ * Build the JSON body for a `POST /v1/chat/completions` request.
+ *
+ * Resolves the messages array from either the simple `message`
+ * field or the raw `messagesJson`, and includes `temperature` and
+ * `max_tokens` only when they are explicitly provided.
+ *
+ * @param params - Node parameters collected for the chat completion
+ *   operation.
+ * @returns A fully-formed request body ready to send to the API.
+ * @throws {Error} If message resolution fails (missing text in
+ *   Simple mode, or invalid JSON in JSON mode).
+ */
+function buildChatCompletionBody(params) {
+    const messages = resolveMessages(params.messageMode, params.message, params.messagesJson);
+    const body = {
+        model: params.model,
+        messages,
+    };
+    if (params.temperature !== undefined && params.temperature !== null) {
+        body.temperature = params.temperature;
+    }
+    if (params.maxTokens !== undefined && params.maxTokens !== null) {
+        body.max_tokens = params.maxTokens;
+    }
+    return body;
+}
+/**
+ * Resolve the effective chat messages array for a request.
+ *
+ * In `"simple"` mode a single user message is built from the
+ * trimmed `message` string. In `"json"` mode the `messagesJson`
+ * input is parsed and validated via {@link parseMessagesJson}.
+ *
+ * @param messageMode - Which input path to use.
+ * @param message - Raw text for Simple mode.
+ * @param messagesJson - Raw JSON (string or already-parsed array)
+ *   for JSON mode.
+ * @returns The validated list of chat messages.
+ * @throws {Error} If required input is missing or invalid.
+ */
+function resolveMessages(messageMode, message, messagesJson) {
+    if (messageMode === "simple") {
+        const text = message === null || message === void 0 ? void 0 : message.trim();
+        if (!text) {
+            throw new Error("Message is required in Simple mode.");
+        }
+        return [{ role: "user", content: text }];
+    }
+    const parsed = parseMessagesJson(messagesJson);
+    if (parsed.length === 0) {
+        throw new Error("Messages JSON must contain at least one message.");
+    }
+    return parsed;
+}
+/**
+ * Parse and validate the raw `messagesJson` node input.
+ *
+ * Accepts either a JSON-encoded string or an already-decoded array.
+ * Each entry must be an object with a supported `role`
+ * (`"system" | "user" | "assistant" | "tool"`) and a string
+ * `content`.
+ *
+ * @param raw - The raw input value provided by the user.
+ * @returns The list of validated chat messages.
+ * @throws {Error} If the value is missing, is not valid JSON, is
+ *   not an array, or contains an invalid entry.
+ */
+function parseMessagesJson(raw) {
+    if (raw === undefined || raw === null || raw === "") {
+        throw new Error("Messages JSON is required in JSON mode.");
+    }
+    let value = raw;
+    if (typeof raw === "string") {
+        try {
+            value = JSON.parse(raw);
+        }
+        catch {
+            throw new Error("Messages JSON must be valid JSON.");
+        }
+    }
+    if (!Array.isArray(value)) {
+        throw new Error("Messages JSON must be an array of message objects.");
+    }
+    const messages = [];
+    for (const [index, item] of value.entries()) {
+        if (typeof item !== "object" || item === null) {
+            throw new Error(`Message at index ${index} must be an object.`);
+        }
+        const role = item.role;
+        const content = item.content;
+        if (typeof role !== "string" || !role.trim()) {
+            throw new Error(`Message at index ${index} requires a role.`);
+        }
+        if (typeof content !== "string") {
+            throw new Error(`Message at index ${index} requires string content.`);
+        }
+        if (!["system", "user", "assistant", "tool"].includes(role)) {
+            throw new Error(`Message at index ${index} has invalid role "${role}".`);
+        }
+        messages.push({ role: role, content });
+    }
+    return messages;
+}
+/**
+ * Flatten a raw chat completion response into the shape emitted by
+ * the node.
+ *
+ * Extracts the first choice's content, the model id, the finish
+ * reason, and token usage, while also preserving the full `raw`
+ * payload for downstream nodes that need it.
+ *
+ * @param response - Raw API response body.
+ * @returns A flattened, node-friendly representation.
+ */
+function parseChatCompletionResponse(response) {
+    var _a, _b, _c, _d, _e, _f;
+    const choice = (_a = response.choices) === null || _a === void 0 ? void 0 : _a[0];
+    return {
+        content: (_c = (_b = choice === null || choice === void 0 ? void 0 : choice.message) === null || _b === void 0 ? void 0 : _b.content) !== null && _c !== void 0 ? _c : "",
+        model: (_d = response.model) !== null && _d !== void 0 ? _d : "",
+        finishReason: (_e = choice === null || choice === void 0 ? void 0 : choice.finish_reason) !== null && _e !== void 0 ? _e : null,
+        usage: (_f = response.usage) !== null && _f !== void 0 ? _f : null,
+        raw: response,
+    };
+}
+/**
+ * Normalize a `GET /v1/usage` response for node output.
+ *
+ * Fills in defaults for any missing fields so downstream nodes can
+ * rely on a stable shape (numeric zeros instead of `undefined`,
+ * `"unknown"` for missing status strings, etc.).
+ *
+ * @param usage - Raw usage response from the API.
+ * @returns A fully-populated usage object with default values.
+ */
+function formatUsageForOutput(usage) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
+    return {
+        accountStatus: (_a = usage.accountStatus) !== null && _a !== void 0 ? _a : "unknown",
+        plan: (_b = usage.plan) !== null && _b !== void 0 ? _b : "free",
+        planStatus: (_c = usage.planStatus) !== null && _c !== void 0 ? _c : "unknown",
+        balanceCents: (_d = usage.balanceCents) !== null && _d !== void 0 ? _d : 0,
+        weeklyPool: {
+            limit: (_f = (_e = usage.weeklyPool) === null || _e === void 0 ? void 0 : _e.limit) !== null && _f !== void 0 ? _f : 0,
+            used: (_h = (_g = usage.weeklyPool) === null || _g === void 0 ? void 0 : _g.used) !== null && _h !== void 0 ? _h : 0,
+            remaining: (_k = (_j = usage.weeklyPool) === null || _j === void 0 ? void 0 : _j.remaining) !== null && _k !== void 0 ? _k : 0,
+        },
+        overage: {
+            enabled: (_m = (_l = usage.overage) === null || _l === void 0 ? void 0 : _l.enabled) !== null && _m !== void 0 ? _m : false,
+            limitCents: (_p = (_o = usage.overage) === null || _o === void 0 ? void 0 : _o.limitCents) !== null && _p !== void 0 ? _p : null,
+            usedCents: (_r = (_q = usage.overage) === null || _q === void 0 ? void 0 : _q.usedCents) !== null && _r !== void 0 ? _r : 0,
+            remainingCents: (_t = (_s = usage.overage) === null || _s === void 0 ? void 0 : _s.remainingCents) !== null && _t !== void 0 ? _t : null,
+        },
+        balanceWeightedUnitsAffordable: (_u = usage.balanceWeightedUnitsAffordable) !== null && _u !== void 0 ? _u : 0,
+    };
+}
+/**
+ * Format a human-readable error message from a Caedral API failure.
+ *
+ * If the body follows the Caedral error envelope
+ * (`{ error: { type, message, code } }`), the `type` is prefixed
+ * in brackets before the message. Otherwise a generic message
+ * including the HTTP status is returned.
+ *
+ * @param statusCode - HTTP status code of the failing response.
+ * @param body - Parsed error body, or the raw text when parsing
+ *   failed.
+ * @returns A human-readable error message suitable for surfacing
+ *   in n8n.
+ */
+function formatApiErrorMessage(statusCode, body) {
+    if (typeof body === "string") {
+        return `Caedral API error (${statusCode}): ${body}`;
+    }
+    const err = body.error;
+    if (err === null || err === void 0 ? void 0 : err.message) {
+        const type = err.type ? `[${err.type}] ` : "";
+        return `${type}${err.message}`;
+    }
+    return `Caedral API error (${statusCode})`;
+}
+/**
+ * Compose a full API URL from a base URL and endpoint path.
+ *
+ * The base URL is passed through {@link normalizeBaseUrl} and the
+ * path is prefixed with `/` if it does not already start with one,
+ * guaranteeing exactly one slash between the two.
+ *
+ * @param baseUrl - Base URL for the Caedral API.
+ * @param path - Endpoint path (with or without a leading slash).
+ * @returns The composed absolute URL.
+ */
+function buildRequestUrl(baseUrl, path) {
+    return `${normalizeBaseUrl(baseUrl)}${path.startsWith("/") ? path : `/${path}`}`;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/nodes/Caedral/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../nodes/Caedral/helpers.ts"],"names":[],"mappings":";;;AA8EA,4CAGC;AAeD,0DA4BC;AAgBD,0CAkBC;AAeD,8CA+CC;AAaD,kEAiBC;AAYD,oDAoBC;AAgBD,sDAeC;AAaD,0CAEC;AAxUD,sDAA0D;AAEjD,iGAFA,4BAAgB,OAEA;AAEZ,QAAA,aAAa,GAAG;IAC3B,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE;IAC9C,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE;IACzC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC7C,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,oBAAoB,EAAE;CAC3C,CAAC;AA2DX;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,OAAO,GAAG,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,IAAI,EAAE,KAAI,4BAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,uBAAuB,CAAC,MAOvC;IACC,MAAM,QAAQ,GAAG,eAAe,CAC9B,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,YAAY,CACpB,CAAC;IAEF,MAAM,IAAI,GAA8B;QACtC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ;KACT,CAAC;IAEF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACpE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,eAAe,CAC7B,WAA8B,EAC9B,OAAgB,EAChB,YAAqC;IAErC,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,iBAAiB,CAC/B,GAAuC;IAEvC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,KAAK,GAAY,GAAG,CAAC;IACzB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,qBAAqB,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;QAC/C,MAAM,OAAO,GAAI,IAA8B,CAAC,OAAO,CAAC;QAExD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,mBAAmB,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,2BAA2B,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CACb,oBAAoB,KAAK,sBAAsB,IAAI,IAAI,CACxD,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAA2B,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,2BAA2B,CACzC,QAAgC;;IAQhC,MAAM,MAAM,GAAG,MAAA,QAAQ,CAAC,OAAO,0CAAG,CAAC,CAAC,CAAC;IACrC,OAAO;QACL,OAAO,EAAE,MAAA,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,OAAO,0CAAE,OAAO,mCAAI,EAAE;QACvC,KAAK,EAAE,MAAA,QAAQ,CAAC,KAAK,mCAAI,EAAE;QAC3B,YAAY,EAAE,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,aAAa,mCAAI,IAAI;QAC3C,KAAK,EAAE,MAAA,QAAQ,CAAC,KAAK,mCAAI,IAAI;QAC7B,GAAG,EAAE,QAAQ;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAAC,KAAoB;;IACvD,OAAO;QACL,aAAa,EAAE,MAAA,KAAK,CAAC,aAAa,mCAAI,SAAS;QAC/C,IAAI,EAAE,MAAA,KAAK,CAAC,IAAI,mCAAI,MAAM;QAC1B,UAAU,EAAE,MAAA,KAAK,CAAC,UAAU,mCAAI,SAAS;QACzC,YAAY,EAAE,MAAA,KAAK,CAAC,YAAY,mCAAI,CAAC;QACrC,UAAU,EAAE;YACV,KAAK,EAAE,MAAA,MAAA,KAAK,CAAC,UAAU,0CAAE,KAAK,mCAAI,CAAC;YACnC,IAAI,EAAE,MAAA,MAAA,KAAK,CAAC,UAAU,0CAAE,IAAI,mCAAI,CAAC;YACjC,SAAS,EAAE,MAAA,MAAA,KAAK,CAAC,UAAU,0CAAE,SAAS,mCAAI,CAAC;SAC5C;QACD,OAAO,EAAE;YACP,OAAO,EAAE,MAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,OAAO,mCAAI,KAAK;YACxC,UAAU,EAAE,MAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,UAAU,mCAAI,IAAI;YAC7C,SAAS,EAAE,MAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,SAAS,mCAAI,CAAC;YACxC,cAAc,EAAE,MAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,cAAc,mCAAI,IAAI;SACtD;QACD,8BAA8B,EAC5B,MAAA,KAAK,CAAC,8BAA8B,mCAAI,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,qBAAqB,CACnC,UAAkB,EAClB,IAAkC;IAElC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,sBAAsB,UAAU,MAAM,IAAI,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;IACvB,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,GAAG,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,OAAO,sBAAsB,UAAU,GAAG,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAC,OAAe,EAAE,IAAY;IAC3D,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACnF,CAAC"}

package/dist/shared/constants.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_BASE_URL = "https://api.caedral.com";

package/dist/shared/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BASE_URL = void 0;
+exports.DEFAULT_BASE_URL = "https://api.caedral.com";
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../shared/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG,yBAAyB,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "n8n-nodes-caedral",
+  "version": "0.1.0",
+  "description": "n8n community node for Caedral AI — chat completions and usage from your workflows",
+  "license": "MIT",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "caedral",
+    "ai",
+    "llm",
+    "chatgpt",
+    "openai"
+  ],
+  "author": {
+    "name": "Caedral",
+    "email": "hello@caedral.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/caedral/n8n-nodes-caedral"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && node scripts/copy-assets.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "homepage": "https://caedral.com/docs/n8n-overview",
+  "bugs": {
+    "url": "https://github.com/caedral/n8n-nodes-caedral/issues"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/CaedralApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Caedral/Caedral.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "bcryptjs": "^3.0.3",
+    "dotenv": "^16.4.7",
+    "n8n-workflow": "^1.82.0",
+    "postgres": "^3.4.9",
+    "typescript": "^5",
+    "vitest": "^3.0.9"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}