n8n-nodes-orboto 1.0.1

package/dist/nodes/orboto/shared/GenericFunctions.d.ts

@@ -0,0 +1,47 @@
+import type { IExecuteFunctions, IHttpRequestOptions, INode, INodeExecutionData } from 'n8n-workflow';
+import { ApiClient } from './ApiClient';
+import type { QueryValue } from './Types';
+/** Resolves the credential type from the Authentication parameter (apiKey | oauth). */
+export declare function credentialTypeOf(context: {
+    getNodeParameter(name: string, itemIndex?: number, fallback?: unknown): unknown;
+}): 'orbotoApi' | 'orbotoOAuth2Api';
+/** Builds the shared API client from the node's orboto credential (API key or OAuth2). */
+export declare function getClient(executeContext: IExecuteFunctions): Promise<ApiClient>;
+/** Client for loadOptions methods (same transport, different context type). */
+export declare function getLoadOptionsClient(context: {
+    getCredentials(name: string): Promise<Record<string, unknown>>;
+    getNodeParameter(name: string, itemIndex?: number, fallback?: unknown): unknown;
+} & {
+    helpers: {
+        httpRequest(options: IHttpRequestOptions): Promise<unknown>;
+    };
+}): Promise<ApiClient>;
+/**
+ * Some orboto routes return bare JSON arrays (projects, milestones, statuses,
+ * members, labels, versions, attachments) while list routes paginate with
+ * `{items, nextCursor}`. This helper normalizes both to an item array.
+ */
+export declare function pageItems<T = unknown>(body: unknown): T[];
+export declare function isUuid(value: string): boolean;
+/**
+ * Resolves a user-supplied ticket reference (UUID, key like `ONN-42`,
+ * or bare number `42`) to the ticket id. UUIDs pass through untouched;
+ * keys/numbers resolve via the project-scoped by-key route.
+ */
+export declare function resolveTicketId(client: ApiClient, projectId: string, ticket: string): Promise<string>;
+/**
+ * Resolves a project key (ONN) or id to the project id. Some routes
+ * (/projects/{id}/members) only accept ids, unlike the ticket routes.
+ */
+export declare function resolveProjectId(client: ApiClient, project: string): Promise<string>;
+/**
+ * Resolves a user-supplied milestone reference (UUID or key like `M-3`)
+ * to the milestone id. UUIDs pass through untouched.
+ */
+export declare function resolveMilestoneId(client: ApiClient, projectId: string, milestone: string): Promise<string>;
+/** Wraps API failures into n8n errors with actionable descriptions. */
+export declare function toNodeError(node: INode, error: unknown, itemIndex: number): Error;
+/** Success output helper. */
+export declare function jsonOutput(body: unknown): INodeExecutionData;
+/** Reads a query-string-style filter set from node parameters. */
+export declare function collectQuery(entries: Array<[string, unknown]>): Record<string, QueryValue | undefined>;

package/dist/nodes/orboto/shared/GenericFunctions.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.credentialTypeOf = credentialTypeOf;
+exports.getClient = getClient;
+exports.getLoadOptionsClient = getLoadOptionsClient;
+exports.pageItems = pageItems;
+exports.isUuid = isUuid;
+exports.resolveTicketId = resolveTicketId;
+exports.resolveProjectId = resolveProjectId;
+exports.resolveMilestoneId = resolveMilestoneId;
+exports.toNodeError = toNodeError;
+exports.jsonOutput = jsonOutput;
+exports.collectQuery = collectQuery;
+const n8n_workflow_1 = require("n8n-workflow");
+const ApiClient_1 = require("./ApiClient");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Resolves the credential type from the Authentication parameter (apiKey | oauth). */
+function credentialTypeOf(context) {
+    const authType = String(context.getNodeParameter('authType', 0, 'apiKey'));
+    return authType === 'oauth' ? 'orbotoOAuth2Api' : 'orbotoApi';
+}
+/** Builds the shared API client from the node's orboto credential (API key or OAuth2). */
+async function getClient(executeContext) {
+    const type = credentialTypeOf(executeContext);
+    const credentials = await executeContext.getCredentials(type);
+    if (type === 'orbotoOAuth2Api') {
+        // OAuth: let n8n inject and refresh the bearer token - an empty apiKey
+        // keeps ApiClient from setting its own Authorization header.
+        return new ApiClient_1.ApiClient({ baseUrl: String(credentials.baseUrl ?? '') }, (request) => executeContext.helpers.httpRequestWithAuthentication.call(executeContext, 'orbotoOAuth2Api', {
+            method: request.method,
+            url: request.url,
+            headers: request.headers,
+            body: request.body,
+        }));
+    }
+    return new ApiClient_1.ApiClient({
+        baseUrl: String(credentials.baseUrl ?? ''),
+        apiKey: String(credentials.apiKey ?? ''),
+    }, (request) => executeContext.helpers.httpRequest({
+        method: request.method,
+        url: request.url,
+        headers: request.headers,
+        body: request.body,
+    }));
+}
+/** Client for loadOptions methods (same transport, different context type). */
+async function getLoadOptionsClient(context) {
+    const type = credentialTypeOf(context);
+    const credentials = await context.getCredentials(type);
+    const oauthToken = credentials.oauthTokenData;
+    return new ApiClient_1.ApiClient({
+        baseUrl: String(credentials.baseUrl ?? ''),
+        apiKey: String(oauthToken?.access_token ?? credentials.apiKey ?? ''),
+    }, (request) => context.helpers.httpRequest({
+        method: request.method,
+        url: request.url,
+        headers: request.headers,
+        body: request.body,
+    }));
+}
+/**
+ * Some orboto routes return bare JSON arrays (projects, milestones, statuses,
+ * members, labels, versions, attachments) while list routes paginate with
+ * `{items, nextCursor}`. This helper normalizes both to an item array.
+ */
+function pageItems(body) {
+    if (Array.isArray(body))
+        return body;
+    const page = body;
+    if (page && Array.isArray(page.items))
+        return page.items;
+    return [];
+}
+function isUuid(value) {
+    return UUID_RE.test(value.trim());
+}
+/**
+ * Resolves a user-supplied ticket reference (UUID, key like `ONN-42`,
+ * or bare number `42`) to the ticket id. UUIDs pass through untouched;
+ * keys/numbers resolve via the project-scoped by-key route.
+ */
+async function resolveTicketId(client, projectId, ticket) {
+    const value = ticket.trim();
+    if (isUuid(value))
+        return value;
+    if (!projectId) {
+        throw new Error('A project is required to resolve a ticket key or number to an id');
+    }
+    const found = await client.request(`/projects/${encodeURIComponent(projectId)}/tickets/by-key/${encodeURIComponent(value)}`);
+    return found.id;
+}
+/**
+ * Resolves a project key (ONN) or id to the project id. Some routes
+ * (/projects/{id}/members) only accept ids, unlike the ticket routes.
+ */
+async function resolveProjectId(client, project) {
+    const value = project.trim();
+    if (isUuid(value))
+        return value;
+    const found = await client.request(`/projects/by-key/${encodeURIComponent(value)}`);
+    return found.id;
+}
+/**
+ * Resolves a user-supplied milestone reference (UUID or key like `M-3`)
+ * to the milestone id. UUIDs pass through untouched.
+ */
+async function resolveMilestoneId(client, projectId, milestone) {
+    const value = milestone.trim();
+    if (isUuid(value))
+        return value;
+    if (!projectId) {
+        throw new Error('A project is required to resolve a milestone key to an id');
+    }
+    const found = await client.request(`/projects/${encodeURIComponent(projectId)}/milestones/by-key/${encodeURIComponent(value)}`);
+    return found.id;
+}
+/** Wraps API failures into n8n errors with actionable descriptions. */
+function toNodeError(node, error, itemIndex) {
+    if (error instanceof n8n_workflow_1.NodeApiError || error instanceof n8n_workflow_1.NodeOperationError)
+        return error;
+    if (error instanceof ApiClient_1.ApiError) {
+        const description = appendWarningHints(describeApiError(error), error);
+        return new n8n_workflow_1.NodeApiError(node, error, {
+            message: error.message,
+            description,
+            itemIndex,
+        });
+    }
+    return new n8n_workflow_1.NodeApiError(node, error, { itemIndex });
+}
+/**
+ * orboto attaches structured hints to some error bodies - a languageWarning
+ * on 422 and similarWarnings on 409. They must reach the workflow author,
+ * not vanish inside a generic failure (binding error-semantics design).
+ */
+function appendWarningHints(description, error) {
+    const raw = (error.raw ?? {});
+    const hints = [];
+    const languageWarning = raw.languageWarning;
+    if (languageWarning && typeof languageWarning === 'object') {
+        hints.push(`Language warning: text detected as ${String(languageWarning.detected)} but the project expects ${String(languageWarning.expected)}.`);
+    }
+    const similar = raw.similarWarnings;
+    if (Array.isArray(similar) && similar.length > 0) {
+        const first = similar[0] ?? {};
+        hints.push(`${similar.length} similar ticket(s) flagged as possible duplicates (e.g. ${String(first.title ?? first.id ?? 'unknown')}).`);
+    }
+    return hints.length > 0 ? `${description} ${hints.join(' ')}` : description;
+}
+function describeApiError(error) {
+    switch (error.status) {
+        case 401:
+            return 'orboto rejected the API key. Check the credential (Settings > API Keys in orboto).';
+        case 403:
+            return 'The API key lacks permission for this call. Check its scopes in orboto.';
+        case 409:
+            return 'orboto blocked this as a duplicate. Inspect similarWarnings in the error output, then retry with "Allow Duplicate" and a justification if it really is distinct work.';
+        case 422:
+            return 'orboto rejected the ticket language. Retry with "Allow Language Mismatch" if the deviation is intended.';
+        case 423:
+            return 'The ticket is under legal hold and cannot be modified or deleted.';
+        case 429:
+            return 'Rate limit exceeded (default 600 requests/minute per instance). Batch operations, slow down, or enable "Continue On Fail" to skip throttled items.';
+        default:
+            if (error.status === 0)
+                return 'Could not reach the orboto instance. Check the Base URL credential field.';
+            return error.detail ?? `The request failed with HTTP ${error.status}.`;
+    }
+}
+/** Success output helper. */
+function jsonOutput(body) {
+    return { json: body };
+}
+/** Reads a query-string-style filter set from node parameters. */
+function collectQuery(entries) {
+    const query = {};
+    for (const [key, value] of entries) {
+        if (value === undefined || value === null || value === '')
+            continue;
+        if (typeof value === 'object')
+            continue;
+        query[key] = typeof value === 'number' || typeof value === 'boolean' ? value : String(value);
+    }
+    return query;
+}
+//# sourceMappingURL=GenericFunctions.js.map

package/dist/nodes/orboto/shared/GenericFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenericFunctions.js","sourceRoot":"","sources":["../../../../nodes/orboto/shared/GenericFunctions.ts"],"names":[],"mappings":";;AAQA,4CAKC;AAGD,8BA4BC;AAGD,oDAwBC;AAOD,8BAKC;AAED,wBAEC;AAOD,0CAcC;AAMD,4CAQC;AAMD,gDAcC;AAGD,kCAWC;AAiDD,gCAEC;AAGD,oCAUC;AA5ND,+CAAgE;AAEhE,2CAAgE;AAGhE,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF,uFAAuF;AACvF,SAAgB,gBAAgB,CAC/B,OAA4F;IAE5F,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3E,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC;AAC/D,CAAC;AAED,0FAA0F;AACnF,KAAK,UAAU,SAAS,CAAC,cAAiC;IAChE,MAAM,IAAI,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAChC,uEAAuE;QACvE,6DAA6D;QAC7D,OAAO,IAAI,qBAAS,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAChF,cAAc,CAAC,OAAO,CAAC,6BAA6B,CAAC,IAAI,CAAC,cAAc,EAAE,iBAAiB,EAAE;YAC5F,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;SACK,CAAC,CACzB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,qBAAS,CACnB;QACC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;QAC1C,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;KACxC,EACD,CAAC,OAAO,EAAE,EAAE,CACX,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;KACK,CAAC,CAC1B,CAAC;AACH,CAAC;AAED,+EAA+E;AACxE,KAAK,UAAU,oBAAoB,CACzC,OAKC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,WAAW,CAAC,cAAuD,CAAC;IACvF,OAAO,IAAI,qBAAS,CACnB;QACC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;QAC1C,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,YAAY,IAAI,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;KACpE,EACD,CAAC,OAAO,EAAE,EAAE,CACX,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;QAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;KACK,CAAC,CAC1B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAc,IAAa;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAW,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAyB,CAAC;IACvC,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IACzD,OAAO,EAAE,CAAC;AACX,CAAC;AAED,SAAgB,MAAM,CAAC,KAAa;IACnC,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe,CACpC,MAAiB,EACjB,SAAiB,EACjB,MAAc;IAEd,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CACjC,aAAa,kBAAkB,CAAC,SAAS,CAAC,mBAAmB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CACxF,CAAC;IACF,OAAO,KAAK,CAAC,EAAE,CAAC;AACjB,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,gBAAgB,CACrC,MAAiB,EACjB,OAAe;IAEf,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAiB,oBAAoB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpG,OAAO,KAAK,CAAC,EAAE,CAAC;AACjB,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CACvC,MAAiB,EACjB,SAAiB,EACjB,SAAiB;IAEjB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CACjC,aAAa,kBAAkB,CAAC,SAAS,CAAC,sBAAsB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAC3F,CAAC;IACF,OAAO,KAAK,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,uEAAuE;AACvE,SAAgB,WAAW,CAAC,IAAW,EAAE,KAAc,EAAE,SAAiB;IACzE,IAAI,KAAK,YAAY,2BAAY,IAAI,KAAK,YAAY,iCAAkB;QAAE,OAAO,KAAK,CAAC;IACvF,IAAI,KAAK,YAAY,oBAAQ,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACvE,OAAO,IAAI,2BAAY,CAAC,IAAI,EAAE,KAA8B,EAAE;YAC7D,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW;YACX,SAAS;SACT,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,2BAAY,CAAC,IAAI,EAAE,KAA8B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,WAAmB,EAAE,KAAe;IAC/D,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,eAAe,GAAG,GAAG,CAAC,eAAsD,CAAC;IACnF,IAAI,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CACT,sCAAsC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,4BAA4B,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CACrI,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC;IACpC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAI,OAAO,CAAC,CAAC,CAA6B,IAAI,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CACT,GAAG,OAAO,CAAC,MAAM,2DAA2D,MAAM,CACjF,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,IAAI,SAAS,CACpC,IAAI,CACL,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7E,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAe;IACxC,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,GAAG;YACP,OAAO,oFAAoF,CAAC;QAC7F,KAAK,GAAG;YACP,OAAO,yEAAyE,CAAC;QAClF,KAAK,GAAG;YACP,OAAO,uKAAuK,CAAC;QAChL,KAAK,GAAG;YACP,OAAO,yGAAyG,CAAC;QAClH,KAAK,GAAG;YACP,OAAO,mEAAmE,CAAC;QAC5E,KAAK,GAAG;YACP,OAAO,oJAAoJ,CAAC;QAC7J;YACC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,2EAA2E,CAAC;YAC3G,OAAO,KAAK,CAAC,MAAM,IAAI,gCAAgC,KAAK,CAAC,MAAM,GAAG,CAAC;IACzE,CAAC;AACF,CAAC;AAED,6BAA6B;AAC7B,SAAgB,UAAU,CAAC,IAAa;IACvC,OAAO,EAAE,IAAI,EAAE,IAAkC,EAAE,CAAC;AACrD,CAAC;AAED,kEAAkE;AAClE,SAAgB,YAAY,CAC3B,OAAiC;IAEjC,MAAM,KAAK,GAA2C,EAAE,CAAC;IACzD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QACpE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QACxC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/nodes/orboto/shared/Types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared type definitions for the orboto n8n nodes.
+ *
+ * These types are intentionally decoupled from n8n's own type system: the
+ * shared REST client (ApiClient) is a plain module that can be unit-tested
+ * without an n8n runtime. Nodes adapt n8n helpers to these shapes.
+ */
+/** Data coming from an orboto credential (API key credential, ONN-3; OAuth2, ONN-4). */
+export interface ApiCredentials {
+    /** Base URL of the orboto API, e.g. `https://orboto.example.com/api`. */
+    baseUrl: string;
+    /** Bearer token used for the `Authorization` header. Empty when the transport owns auth (OAuth via n8n). */
+    apiKey?: string;
+}
+/** Cursor-paginated list envelope returned by every orboto list route. */
+export interface ApiPage<T> {
+    items: T[];
+    nextCursor: string | null;
+}
+export type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+export type QueryValue = string | number | boolean;
+/** Request shape handed to the transport function. */
+export interface TransportRequest {
+    method: HttpMethod;
+    /** Fully qualified URL, including query string. */
+    url: string;
+    headers: Record<string, string>;
+    /** Parsed request body; serialized as JSON by the transport. */
+    body?: unknown;
+}
+/**
+ * Transport performs the actual HTTP call and returns the parsed JSON body.
+ *
+ * This is structurally compatible with n8n's `this.helpers.httpRequest`
+ * (IHttpRequestHelper): the n8n adapter in `n8nTransport` maps our options
+ * onto it, so proxies, custom CA certificates and timeouts configured in n8n
+ * keep working for every orboto call.
+ */
+export type Transport = (request: TransportRequest) => Promise<unknown>;
+/**
+ * Minimal structural type for n8n's HTTP helper.
+ *
+ * Kept loose on purpose so this module does not need a hard compile-time
+ * dependency on `n8n-core` (the host provides it at runtime).
+ */
+export interface N8nHttpHelper {
+    httpRequest(options: {
+        method: TransportRequest['method'];
+        url: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+        skipReadBody?: boolean;
+    }): Promise<unknown>;
+}

package/dist/nodes/orboto/shared/Types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Shared type definitions for the orboto n8n nodes.
+ *
+ * These types are intentionally decoupled from n8n's own type system: the
+ * shared REST client (ApiClient) is a plain module that can be unit-tested
+ * without an n8n runtime. Nodes adapt n8n helpers to these shapes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Types.js.map

package/dist/nodes/orboto/shared/Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../../../nodes/orboto/shared/Types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/nodes/orboto/shared/loadOptions.d.ts

@@ -0,0 +1,17 @@
+import type { ILoadOptionsFunctions, INodePropertyOptions } from 'n8n-workflow';
+/** Projects the credential's account can see. */
+export declare function getProjects(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/** Open (plus optionally closed) milestones of the project chosen in the node. */
+export declare function getMilestones(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/** Ticket statuses of the project, labeled with their category. */
+export declare function getStatuses(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/** Project members (assignee picker). */
+export declare function getMembers(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/** Labels of the project (ids - for the add/remove label routes). */
+export declare function getLabels(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/** Labels of the project by name - create/update take labelNames, not ids. */
+export declare function getLabelNames(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/** Versions of the project. */
+export declare function getVersions(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+/** Wiki spaces (for the doc resource). */
+export declare function getSpaces(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;

package/dist/nodes/orboto/shared/loadOptions.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjects = getProjects;
+exports.getMilestones = getMilestones;
+exports.getStatuses = getStatuses;
+exports.getMembers = getMembers;
+exports.getLabels = getLabels;
+exports.getLabelNames = getLabelNames;
+exports.getVersions = getVersions;
+exports.getSpaces = getSpaces;
+const GenericFunctions_1 = require("./GenericFunctions");
+function option(value, name) {
+    return { value, name };
+}
+/** Projects the credential's account can see. */
+async function getProjects() {
+    const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+    const projects = await client.request('/projects/');
+    return (0, GenericFunctions_1.pageItems)(projects).map((p) => option(p.id, p.projectKey ? `${p.projectKey} - ${p.name}` : p.name));
+}
+/** Open (plus optionally closed) milestones of the project chosen in the node. */
+async function getMilestones() {
+    const projectId = this.getCurrentNodeParameter('project', { extractValue: true });
+    if (!projectId)
+        return [];
+    const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+    const milestones = await client.request(`/projects/${encodeURIComponent(projectId)}/milestones`);
+    return (0, GenericFunctions_1.pageItems)(milestones).map((m) => option(m.id, m.milestoneKey ? `${m.milestoneKey} - ${m.name}` : m.name));
+}
+/** Ticket statuses of the project, labeled with their category. */
+async function getStatuses() {
+    const projectId = this.getCurrentNodeParameter('project', { extractValue: true });
+    if (!projectId)
+        return [];
+    const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+    const statuses = await client.request(`/projects/${encodeURIComponent(projectId)}/ticket-statuses`);
+    return (0, GenericFunctions_1.pageItems)(statuses).map((s) => option(s.id, `${s.name} (${s.category})`));
+}
+/** Project members (assignee picker). */
+async function getMembers() {
+    const projectId = this.getCurrentNodeParameter('project', { extractValue: true });
+    if (!projectId)
+        return [];
+    const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+    const members = await client.request(`/projects/${encodeURIComponent(projectId)}/members`);
+    return (0, GenericFunctions_1.pageItems)(members).map((m) => {
+        const userId = m.user?.id ?? m.userId;
+        const name = m.user?.fullName ?? m.user?.email ?? userId;
+        return option(userId, name);
+    });
+}
+/** Labels of the project (ids - for the add/remove label routes). */
+async function getLabels() {
+    const projectId = this.getCurrentNodeParameter('project', { extractValue: true });
+    if (!projectId)
+        return [];
+    const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+    const labels = await client.request(`/projects/${encodeURIComponent(projectId)}/labels`);
+    return (0, GenericFunctions_1.pageItems)(labels).map((l) => option(l.id, l.name));
+}
+/** Labels of the project by name - create/update take labelNames, not ids. */
+async function getLabelNames() {
+    const projectId = this.getCurrentNodeParameter('project', { extractValue: true });
+    if (!projectId)
+        return [];
+    const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+    const labels = await client.request(`/projects/${encodeURIComponent(projectId)}/labels`);
+    return (0, GenericFunctions_1.pageItems)(labels).map((l) => option(l.name, l.name));
+}
+/** Versions of the project. */
+async function getVersions() {
+    const projectId = this.getCurrentNodeParameter('project', { extractValue: true });
+    if (!projectId)
+        return [];
+    const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+    const versions = await client.request(`/projects/${encodeURIComponent(projectId)}/versions`);
+    return (0, GenericFunctions_1.pageItems)(versions).map((v) => option(v.id, v.name));
+}
+/** Wiki spaces (for the doc resource). */
+async function getSpaces() {
+    const client = await (0, GenericFunctions_1.getLoadOptionsClient)(this);
+    const spaces = await client.request('/spaces');
+    return (0, GenericFunctions_1.pageItems)(spaces).map((s) => option(s.id, s.key ? `${s.key} - ${s.name}` : s.name));
+}
+//# sourceMappingURL=loadOptions.js.map

package/dist/nodes/orboto/shared/loadOptions.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "n8n-nodes-orboto",
+  "version": "1.0.1",
+  "description": "n8n community nodes for orboto - automate tickets, milestones, projects, docs and more from your workflows",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "orboto",
+    "project-management",
+    "tickets",
+    "automation"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "orboto",
+    "email": "hello@orboto.io"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orboto/n8n-nodes-orboto.git"
+  },
+  "homepage": "https://github.com/orboto/n8n-nodes-orboto#readme",
+  "bugs": {
+    "url": "https://github.com/orboto/n8n-nodes-orboto/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "main": "dist/nodes/index.js",
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/orbotoApi.credentials.js",
+      "dist/credentials/orbotoOAuth2Api.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/orboto/orboto.node.js",
+      "dist/nodes/orboto/orbotoTrigger.node.js"
+    ]
+  },
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint \"nodes/**/*.ts\" \"credentials/**/*.ts\" --no-error-on-unmatched-pattern && eslint package.json",
+    "lint:fix": "eslint \"nodes/**/*.ts\" \"credentials/**/*.ts\" --no-error-on-unmatched-pattern --fix",
+    "test": "vitest run",
+    "prepublishOnly": "npm run lint && npm run build && npm run test"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "@typescript-eslint/eslint-plugin": "^8.68.0",
+    "@typescript-eslint/parser": "^8.57.2",
+    "eslint": "^8.57.1",
+    "eslint-plugin-n8n-nodes-base": "^2.0.0",
+    "gulp": "^5.0.1",
+    "jsonc-eslint-parser": "^3.3.0",
+    "n8n-core": "^2.16.1",
+    "n8n-workflow": "^2.16.0",
+    "prettier": "^3.9.6",
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.11"
+  }
+}