@weave-kit/client 0.1.0

package/dist/subscribe.js

@@ -0,0 +1,128 @@
+import { ClientError } from './http.js';
+/** parse one SSE block; null for comment/ping-only blocks */
+function parseBlock(block) {
+    let id;
+    let type;
+    const dataParts = [];
+    for (const line of block.split('\n')) {
+        if (line.startsWith(':') || line === '')
+            continue;
+        const idx = line.indexOf(':');
+        if (idx === -1)
+            continue;
+        const field = line.slice(0, idx).trim();
+        const value = line.slice(idx + 1).replace(/^ /, '');
+        if (field === 'id')
+            id = Number.parseInt(value, 10);
+        else if (field === 'event')
+            type = value;
+        else if (field === 'data')
+            dataParts.push(value);
+    }
+    if (dataParts.length === 0)
+        return null; // heartbeat / comment only
+    let event;
+    try {
+        const parsed = JSON.parse(dataParts.join('\n'));
+        if (typeof parsed.type !== 'string')
+            throw new Error('no type');
+        event = parsed;
+    }
+    catch {
+        event = { type: type ?? 'message', payload: { data: dataParts.join('\n') } };
+    }
+    return { event, id };
+}
+/** build a `client.subscribe` function bound to one client's transport */
+export function createSubscriber(http) {
+    return function subscribe(options) {
+        let closed = false;
+        let retries = 0;
+        let lastSeq;
+        let controller;
+        let timer;
+        const close = () => {
+            closed = true;
+            controller?.abort();
+            if (timer !== undefined)
+                clearTimeout(timer);
+        };
+        const scheduleReconnect = () => {
+            if (closed)
+                return;
+            const base = options.backoffMs ?? 1000;
+            const max = options.maxBackoffMs ?? 15000;
+            const delay = Math.min(base * 2 ** retries, max);
+            retries += 1;
+            timer = setTimeout(() => {
+                timer = undefined;
+                void connect();
+            }, delay);
+            // a reconnect timer must never keep the process alive (subscription may be abandoned)
+            timer.unref?.();
+        };
+        const connect = async () => {
+            if (closed)
+                return;
+            controller = new AbortController();
+            const url = new URL(`${http.baseUrl}${http.prefix}/events`);
+            const headers = { accept: 'text/event-stream' };
+            if (http.apiKey !== undefined)
+                headers.authorization = `Bearer ${http.apiKey}`;
+            if (lastSeq !== undefined)
+                headers['last-event-id'] = String(lastSeq);
+            let reader;
+            let buffer = '';
+            const decoder = new TextDecoder();
+            try {
+                // bare call — `http.fetchImpl(...)` sets `this` to the http object and
+                // native `window.fetch` throws "Illegal invocation"
+                const fetchImpl = http.fetchImpl;
+                const res = await fetchImpl(url.toString(), { method: 'GET', headers, signal: controller.signal });
+                if (!res.ok)
+                    throw new ClientError(res.status, '', res.statusText);
+                if (res.body === null)
+                    throw new Error('empty response body');
+                options.onOpen?.();
+                retries = 0;
+                reader = res.body.getReader();
+                for (;;) {
+                    if (closed)
+                        return;
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buffer += decoder.decode(value, { stream: true });
+                    let idx;
+                    while ((idx = buffer.indexOf('\n\n')) !== -1) {
+                        const block = buffer.slice(0, idx);
+                        buffer = buffer.slice(idx + 2);
+                        const parsed = parseBlock(block);
+                        if (parsed === null)
+                            continue;
+                        if (parsed.id !== undefined)
+                            lastSeq = parsed.id;
+                        else if (parsed.event.seq !== undefined)
+                            lastSeq = parsed.event.seq;
+                        options.onEvent(parsed.event);
+                    }
+                }
+                // stream ended cleanly (server closed) → reconnect
+                scheduleReconnect();
+            }
+            catch (error) {
+                if (closed)
+                    return;
+                if (error instanceof ClientError && (error.status === 401 || error.status === 403)) {
+                    options.onError?.(error);
+                    return; // auth failures never auto-retry
+                }
+                options.onError?.(error instanceof Error ? error : new Error(String(error)));
+                scheduleReconnect();
+            }
+        };
+        void connect();
+        return { close };
+    };
+}
+//# sourceMappingURL=subscribe.js.map

package/dist/subscribe.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,23 @@
+import type { Filter, SortDir } from '@weave-kit/engine';
+/** one sort clause; serialized as `field:direction` on the wire */
+export interface FindSort {
+    field: string;
+    direction: SortDir;
+}
+/** list query params — serialized to the M5 REST contract (filter/sort/fields/limit/offset) */
+export interface FindParams {
+    /** equality/operator filter object (JSON-encoded on the wire) */
+    filter?: Filter;
+    sort?: FindSort[];
+    limit?: number;
+    offset?: number;
+    /** column projection whitelist */
+    fields?: string[];
+}
+/** single-record read params */
+export interface FindOneParams {
+    fields?: string[];
+}
+/** serialize FindParams to REST query string entries */
+export declare function buildFindQuery(params: FindParams): Record<string, string> | undefined;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,+FAA+F;AAC/F,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQrF"}

package/dist/types.js

@@ -0,0 +1,16 @@
+/** serialize FindParams to REST query string entries */
+export function buildFindQuery(params) {
+    const query = {};
+    if (params.filter !== undefined)
+        query.filter = JSON.stringify(params.filter);
+    if (params.sort !== undefined)
+        query.sort = params.sort.map((s) => `${s.field}:${s.direction}`).join(',');
+    if (params.fields !== undefined)
+        query.fields = params.fields.join(',');
+    if (params.limit !== undefined)
+        query.limit = String(params.limit);
+    if (params.offset !== undefined)
+        query.offset = String(params.offset);
+    return Object.keys(query).length === 0 ? undefined : query;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwBA,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1G,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@weave-kit/client",
+  "version": "0.1.0",
+  "description": "WeaveKit client — framework-agnostic TypeScript SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=24"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "weavekit",
+    "client",
+    "sdk",
+    "rest",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/weavekit/client.git"
+  },
+  "scripts": {
+    "dev": "node --watch --import tsx src/client.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "prelint": "node scripts/check-memory-sizes.mjs",
+    "lint": "eslint .",
+    "test": "node --import tsx --test \"tests/**/*.test.ts\""
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "~5.9.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "dependencies": {
+    "@weave-kit/engine": "^0.1.0"
+  }
+}