@quiltr/sdk 1.3.0

package/dist/shared/websocket.client.js

@@ -0,0 +1,93 @@
+/**
+ * WebSocket client wrapper for real-time updates.
+ * Uses socket.io-client for workflow and job progress events.
+ *
+ * Socket.IO is an optional peer dependency - this module gracefully
+ * degrades if socket.io-client is not installed.
+ */
+export class WebSocketClient {
+    config;
+    getAccessToken;
+    socket = null;
+    listeners = new Map();
+    constructor(config, getAccessToken) {
+        this.config = config;
+        this.getAccessToken = getAccessToken;
+    }
+    /**
+     * Connect to the WebSocket server.
+     * Requires socket.io-client to be installed as a peer dependency.
+     */
+    async connect(options) {
+        if (this.socket?.connected)
+            return;
+        let io;
+        try {
+            // Dynamic import to keep socket.io-client optional
+            const module = await import('socket.io-client');
+            io = module.io || module.default;
+        }
+        catch {
+            throw new Error('socket.io-client is required for WebSocket support. Install it: npm install socket.io-client');
+        }
+        const baseUrl = this.config.baseUrl.replace(/\/+$/, '');
+        const namespace = options?.namespace || '/';
+        const token = this.getAccessToken();
+        this.socket = io(`${baseUrl}${namespace}`, {
+            autoConnect: options?.autoConnect ?? true,
+            auth: {
+                token,
+                ...options?.auth,
+            },
+            transports: ['websocket', 'polling'],
+        });
+        if (!this.socket.connected) {
+            this.socket.connect();
+        }
+    }
+    disconnect() {
+        this.socket?.disconnect();
+        this.socket = null;
+        this.listeners.clear();
+    }
+    get isConnected() {
+        return this.socket?.connected ?? false;
+    }
+    // --- Job Events ---
+    onJobProgress(jobId, callback) {
+        return this.subscribe(`job:${jobId}:progress`, callback);
+    }
+    onJobComplete(jobId, callback) {
+        return this.subscribe(`job:${jobId}:complete`, callback);
+    }
+    onJobFailed(jobId, callback) {
+        return this.subscribe(`job:${jobId}:failed`, callback);
+    }
+    // --- Workflow Events ---
+    onWorkflowTransition(instanceId, callback) {
+        return this.subscribe(`workflow:${instanceId}:transition`, callback);
+    }
+    onWorkflowComplete(instanceId, callback) {
+        return this.subscribe(`workflow:${instanceId}:complete`, callback);
+    }
+    // --- Generic ---
+    on(event, callback) {
+        return this.subscribe(event, callback);
+    }
+    emit(event, ...args) {
+        this.socket?.emit(event, ...args);
+    }
+    subscribe(event, callback) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(callback);
+        this.socket?.on(event, callback);
+        // Return unsubscribe function
+        return () => {
+            this.listeners.get(event)?.delete(callback);
+            this.socket?.off(event, callback);
+        };
+    }
+}
+//# sourceMappingURL=websocket.client.js.map

package/dist/shared/websocket.client.js.map

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

package/dist/types/common.types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SDK-specific types (not shared with other consumers).
+ */
+export interface SdkConfig {
+    baseUrl: string;
+    /** Default headers to include with every request */
+    headers?: Record<string, string>;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Max retry attempts for transient failures (default: 2) */
+    maxRetries?: number;
+    /** Called when a token refresh is needed */
+    onTokenRefresh?: (refreshToken: string) => Promise<TokenPair | null>;
+    /** Called when authentication is completely lost */
+    onAuthExpired?: () => void;
+}
+export interface TokenPair {
+    accessToken: string;
+    refreshToken: string;
+}
+//# sourceMappingURL=common.types.d.ts.map

package/dist/types/common.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACrE,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/common.types.js

@@ -0,0 +1,5 @@
+/**
+ * SDK-specific types (not shared with other consumers).
+ */
+export {};
+//# sourceMappingURL=common.types.js.map

package/dist/types/common.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.types.js","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from '@quiltr/types';
+export type { SdkConfig, TokenPair } from './common.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC;AAG9B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+// Re-export all shared types from @quiltr/types
+export * from '@quiltr/types';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,cAAc,eAAe,CAAC"}

package/dist/utils/query-builder.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Query parameter builder for API requests.
+ * Larch Framework: Pure function, no side effects.
+ *
+ * Converts typed query params into URL query string format
+ * matching the API's BaseQueryDto conventions.
+ */
+import type { BaseQueryParams } from '../types';
+export declare function buildQueryParams(params?: BaseQueryParams): Record<string, string>;
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/utils/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../src/utils/query-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBjF"}

package/dist/utils/query-builder.js

@@ -0,0 +1,33 @@
+/**
+ * Query parameter builder for API requests.
+ * Larch Framework: Pure function, no side effects.
+ *
+ * Converts typed query params into URL query string format
+ * matching the API's BaseQueryDto conventions.
+ */
+export function buildQueryParams(params) {
+    if (!params)
+        return {};
+    const query = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === 'object' && !Array.isArray(value)) {
+            // Handle range filters: { priceInCents: { gte: 1000, lte: 5000 } }
+            // → priceInCents[gte]=1000&priceInCents[lte]=5000
+            for (const [op, opValue] of Object.entries(value)) {
+                if (opValue !== undefined && opValue !== null) {
+                    query[`${key}[${op}]`] = String(opValue);
+                }
+            }
+        }
+        else if (Array.isArray(value)) {
+            query[key] = value.join(',');
+        }
+        else {
+            query[key] = String(value);
+        }
+    }
+    return query;
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/utils/query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../../src/utils/query-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAEpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,mEAAmE;YACnE,kDAAkD;YAClD,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;gBAC7E,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBAC9C,KAAK,CAAC,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@quiltr/sdk",
+  "version": "1.3.0",
+  "description": "TypeScript SDK for the Quiltr NestJS Multitenant API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@quiltr/types": "^0.2.0"
+  },
+  "peerDependencies": {
+    "socket.io-client": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "socket.io-client": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "socket.io-client": "^4.7.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "UNLICENSED"
+}