@weave-kit/client 0.1.0

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createClient, ClientError, version, layoutPagePath } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/layouts.d.ts

@@ -0,0 +1,107 @@
+import type { LayoutAddress, ObjectLayoutView } from '@weave-kit/engine/layout';
+import type { HttpOptions } from './http.js';
+/**
+ * Page layout source accessor (SU-7c). The engine serves the raw layout JSON
+ * source and its content version via the path-mirrored API
+ * (`/pages/<path>` — e.g. `app.layout` / `<id>.layout` /
+ * `<object>/show.layout` / `<object>/list.layout`); interpretation belongs to
+ * the frontend (@weave-kit/ui layout engine). GET is Bearer-authenticated;
+ * PUT / page lifecycle are admin-gated server-side (403 when the identity's
+ * roles miss `rest.adminRoles`). 404 → null; stale `expectVersion` → 409.
+ */
+export interface SourceDocument {
+    source: string;
+    version: string;
+}
+export interface LayoutSourceOptions {
+    signal?: AbortSignal;
+}
+export interface LayoutSaveOptions extends LayoutSourceOptions {
+    /** optimistic lock — 409 when the current version differs */
+    expectVersion?: string;
+    /** explicit overwrite: skip the version check */
+    force?: boolean;
+}
+export interface LayoutSaveResult {
+    ok: true;
+    committed: boolean;
+    version: string;
+}
+export type PageSummary = {
+    kind: 'shell';
+    id: 'app';
+    path: string;
+} | {
+    kind: 'object';
+    id: string;
+    view: ObjectLayoutView;
+    path: string;
+} | {
+    kind: 'custom';
+    id: string;
+    path: string;
+};
+export interface CreatePageOptions {
+    /** optional initial layout source (defaults to an empty desktop layout) */
+    source?: string;
+    signal?: AbortSignal;
+}
+export interface CreatePageResult {
+    ok: true;
+    id: string;
+    path: string;
+}
+export interface RenamePageOptions {
+    signal?: AbortSignal;
+}
+export interface RenamePageResult {
+    ok: true;
+    id: string;
+    path: string;
+}
+export interface DeletePageOptions {
+    signal?: AbortSignal;
+}
+export interface DeletePageResult {
+    ok: true;
+    deleted: boolean;
+}
+export interface DesignSavePart {
+    source: string;
+    expectVersion?: string;
+}
+export interface DesignSaveOptions {
+    force?: boolean;
+    signal?: AbortSignal;
+}
+export interface DesignSaveResult {
+    ok: true;
+    committed: boolean;
+}
+/** the `/pages/<path>` segment mirroring the physical file (single source lives in the engine) */
+export declare function layoutPagePath(addr: LayoutAddress): string;
+export interface LayoutsClient {
+    /** layout source + content version for a page, or null (404) */
+    getSource(addr: LayoutAddress, options?: LayoutSourceOptions): Promise<SourceDocument | null>;
+    /** replace a page layout source (admin; strict optimistic lock unless `force`) */
+    save(addr: LayoutAddress, source: string, options?: LayoutSaveOptions): Promise<LayoutSaveResult>;
+    /** page catalog: shell + object show/list + custom pages */
+    list(options?: {
+        signal?: AbortSignal;
+    }): Promise<PageSummary[]>;
+    /** create a custom page (admin) */
+    create(id: string, options?: CreatePageOptions): Promise<CreatePageResult>;
+    /** rename a custom page (admin; atomically updates shell PageRefs) */
+    rename(id: string, newId: string, options?: RenamePageOptions): Promise<RenamePageResult>;
+    /** delete a custom page (admin; 409 while referenced from the shell) */
+    delete(id: string, options?: DeletePageOptions): Promise<DeletePageResult>;
+    /** atomic object design save: show + list + owning schema in one Git commit (admin) */
+    saveDesign(options: {
+        object: string;
+        show?: DesignSavePart;
+        list?: DesignSavePart;
+        schema?: DesignSavePart;
+    } & DesignSaveOptions): Promise<DesignSaveResult>;
+}
+export declare function createLayoutsClient(http: HttpOptions): LayoutsClient;
+//# sourceMappingURL=layouts.d.ts.map

package/dist/layouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../src/layouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAW1D;AAED,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9F,kFAAkF;IAClF,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClG,4DAA4D;IAC5D,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACjE,mCAAmC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3E,sEAAsE;IACtE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1F,wEAAwE;IACxE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3E,uFAAuF;IACvF,UAAU,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,cAAc,CAAC;QAAC,IAAI,CAAC,EAAE,cAAc,CAAC;QAAC,MAAM,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/J;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAyCpE"}

package/dist/layouts.js

@@ -0,0 +1,65 @@
+import { ClientError, request } from './http.js';
+/** the `/pages/<path>` segment mirroring the physical file (single source lives in the engine) */
+export function layoutPagePath(addr) {
+    switch (addr.kind) {
+        case 'shell':
+            return 'app.layout';
+        case 'custom':
+            return `${addr.id}/layout`;
+        case 'object':
+            return `${addr.id}/${addr.view}.layout`;
+        case 'page-face':
+            return `${addr.page}/objects/${addr.object}/${addr.face}.layout`;
+    }
+}
+export function createLayoutsClient(http) {
+    const pagePath = (addr) => `/pages/${layoutPagePath(addr)}`;
+    return {
+        async getSource(addr, options = {}) {
+            try {
+                return await request(http, 'GET', pagePath(addr), { signal: options.signal });
+            }
+            catch (error) {
+                if (error instanceof ClientError && error.status === 404)
+                    return null;
+                throw error;
+            }
+        },
+        save(addr, source, options = {}) {
+            const body = { source };
+            if (options.expectVersion !== undefined)
+                body.expectVersion = options.expectVersion;
+            if (options.force !== undefined)
+                body.force = options.force;
+            return request(http, 'PUT', pagePath(addr), { body, signal: options.signal });
+        },
+        list(options = {}) {
+            return request(http, 'GET', '/pages', { signal: options.signal });
+        },
+        create(id, options = {}) {
+            const body = { id };
+            if (options.source !== undefined)
+                body.source = options.source;
+            return request(http, 'POST', '/pages', { body, signal: options.signal });
+        },
+        rename(id, newId, options = {}) {
+            return request(http, 'PATCH', `/pages/${encodeURIComponent(id)}`, { body: { newId }, signal: options.signal });
+        },
+        delete(id, options = {}) {
+            return request(http, 'DELETE', `/pages/${encodeURIComponent(id)}`, { signal: options.signal });
+        },
+        saveDesign({ object, show, list, schema, force, signal }) {
+            const body = {};
+            if (show !== undefined)
+                body.show = show;
+            if (list !== undefined)
+                body.list = list;
+            if (schema !== undefined)
+                body.schema = schema;
+            if (force !== undefined)
+                body.force = force;
+            return request(http, 'PUT', `/pages/${encodeURIComponent(object)}/design`, { body, signal });
+        },
+    };
+}
+//# sourceMappingURL=layouts.js.map

package/dist/layouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layouts.js","sourceRoot":"","sources":["../src/layouts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqFjD,kGAAkG;AAClG,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,OAAO,YAAY,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,CAAC,EAAE,SAAS,CAAC;QAC7B,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,SAAS,CAAC;QAC1C,KAAK,WAAW;YACd,OAAO,GAAG,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,SAAS,CAAC;IACrE,CAAC;AACH,CAAC;AAmBD,MAAM,UAAU,mBAAmB,CAAC,IAAiB;IACnD,MAAM,QAAQ,GAAG,CAAC,IAAmB,EAAU,EAAE,CAAC,UAAU,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;IAEnF,OAAO;QACL,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE;YAChC,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAiB,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAChG,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;oBAAE,OAAO,IAAI,CAAC;gBACtE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE;YAC7B,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,CAAC;YACjD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;gBAAE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;YACpF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC5D,OAAO,OAAO,CAAmB,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,EAAE;YACf,OAAO,OAAO,CAAgB,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE;YACrB,MAAM,IAAI,GAA4B,EAAE,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC/D,OAAO,OAAO,CAAmB,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE;YAC5B,OAAO,OAAO,CAAmB,IAAI,EAAE,OAAO,EAAE,UAAU,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACnI,CAAC;QACD,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE;YACrB,OAAO,OAAO,CAAmB,IAAI,EAAE,QAAQ,EAAE,UAAU,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACnH,CAAC;QACD,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;YACtD,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,IAAI,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACzC,IAAI,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACzC,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YAC/C,IAAI,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5C,OAAO,OAAO,CAAmB,IAAI,EAAE,KAAK,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,23 @@
+import type { MetadataPermissions, ObjectDescriptor } from '@weave-kit/engine';
+import type { HttpOptions } from './http.js';
+/** `GET /api/permissions` — per-object effective permissions for the identity */
+export interface PermissionsResult {
+    objects: Array<{
+        name: string;
+        label: string;
+        permissions: MetadataPermissions;
+    }>;
+}
+/** metadata + permissions accessors (M11 frontend contract) */
+export interface MetadataClient {
+    /** all objects the identity can read, each with its field schema + permissions */
+    list(): Promise<{
+        objects: ObjectDescriptor[];
+    }>;
+    /** one object descriptor (404 unknown / 403 unreadable) */
+    get(name: string): Promise<ObjectDescriptor>;
+    /** effective permissions per object (Refine accessControl / RA canAccess source) */
+    permissions(): Promise<PermissionsResult>;
+}
+export declare function createMetadataClient(http: HttpOptions): MetadataClient;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAAC;CACnF;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC,CAAC;IACjD,2DAA2D;IAC3D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7C,oFAAoF;IACpF,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3C;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAYtE"}

package/dist/metadata.js

@@ -0,0 +1,15 @@
+import { request } from './http.js';
+export function createMetadataClient(http) {
+    return {
+        list() {
+            return request(http, 'GET', '/metadata');
+        },
+        get(name) {
+            return request(http, 'GET', '/metadata', { query: { object: name } });
+        },
+        permissions() {
+            return request(http, 'GET', '/permissions');
+        },
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,MAAM,UAAU,oBAAoB,CAAC,IAAiB;IACpD,OAAO;QACL,IAAI;YACF,OAAO,OAAO,CAAkC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;QACD,GAAG,CAAC,IAAY;YACd,OAAO,OAAO,CAAmB,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,WAAW;YACT,OAAO,OAAO,CAAoB,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/objects.d.ts

@@ -0,0 +1,21 @@
+import type { RestResult } from '@weave-kit/engine';
+import type { HttpOptions } from './http.js';
+import type { FindOneParams, FindParams } from './types.js';
+/** typed CRUD handle for one object collection, parameterized by its generated type */
+export interface ObjectsClient<T = Record<string, unknown>> {
+    find(params?: FindParams, signal?: AbortSignal): Promise<RestResult<T>>;
+    findOne(id: string, params?: FindOneParams, signal?: AbortSignal): Promise<T | null>;
+    create(data: Partial<T>, signal?: AbortSignal): Promise<T>;
+    update(id: string, changes: Partial<T>, signal?: AbortSignal): Promise<T>;
+    delete(id: string, signal?: AbortSignal): Promise<void>;
+    /** atomic batch update (single transaction): every id updated or none */
+    updateMany(ids: string[], changes: Partial<T>, signal?: AbortSignal): Promise<{
+        updated: string[];
+    }>;
+    /** atomic batch delete (single transaction): every id deleted or none */
+    deleteMany(ids: string[], signal?: AbortSignal): Promise<{
+        deleted: string[];
+    }>;
+}
+export declare function createObjectsClient<T = Record<string, unknown>>(http: HttpOptions, name: string): ObjectsClient<T>;
+//# sourceMappingURL=objects.d.ts.map

package/dist/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,uFAAuF;AACvF,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrF,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,yEAAyE;IACzE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrG,yEAAyE;IACzE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACjF;AAED,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,GACX,aAAa,CAAC,CAAC,CAAC,CA4ClB"}

package/dist/objects.js

@@ -0,0 +1,43 @@
+import { ClientError, request } from './http.js';
+import { buildFindQuery } from './types.js';
+export function createObjectsClient(http, name) {
+    const path = `/objects/${encodeURIComponent(name)}`;
+    return {
+        find(params, signal) {
+            return request(http, 'GET', path, {
+                query: params === undefined ? undefined : buildFindQuery(params),
+                signal,
+            });
+        },
+        async findOne(id, params, signal) {
+            const query = params?.fields === undefined ? undefined : { fields: params.fields.join(',') };
+            try {
+                return await request(http, 'GET', `${path}/${encodeURIComponent(id)}`, { query, signal });
+            }
+            catch (error) {
+                if (error instanceof ClientError && error.status === 404)
+                    return null;
+                throw error;
+            }
+        },
+        create(data, signal) {
+            return request(http, 'POST', path, { body: data, signal });
+        },
+        update(id, changes, signal) {
+            return request(http, 'PATCH', `${path}/${encodeURIComponent(id)}`, {
+                body: changes,
+                signal,
+            });
+        },
+        delete(id, signal) {
+            return request(http, 'DELETE', `${path}/${encodeURIComponent(id)}`, { signal });
+        },
+        updateMany(ids, changes, signal) {
+            return request(http, 'PATCH', path, { body: { ids, changes }, signal });
+        },
+        deleteMany(ids, signal) {
+            return request(http, 'DELETE', path, { body: { ids }, signal });
+        },
+    };
+}
+//# sourceMappingURL=objects.js.map

package/dist/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgB5C,MAAM,UAAU,mBAAmB,CACjC,IAAiB,EACjB,IAAY;IAEZ,MAAM,IAAI,GAAG,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;IAEpD,OAAO;QACL,IAAI,CAAC,MAAmB,EAAE,MAAoB;YAC5C,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;gBAChC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC;gBAChE,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,MAAsB,EAAE,MAAoB;YACpE,MAAM,KAAK,GAAG,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7F,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAI,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/F,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;oBAAE,OAAO,IAAI,CAAC;gBACtE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAgB,EAAE,MAAoB;YAC3C,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAA+B,EAAE,MAAM,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,CAAC,EAAU,EAAE,OAAmB,EAAE,MAAoB;YAC1D,OAAO,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;gBACjE,IAAI,EAAE,OAAkC;gBACxC,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,EAAU,EAAE,MAAoB;YACrC,OAAO,OAAO,CAAO,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,UAAU,CAAC,GAAa,EAAE,OAAmB,EAAE,MAAoB;YACjE,OAAO,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,UAAU,CAAC,GAAa,EAAE,MAAoB;YAC5C,OAAO,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,33 @@
+import type { HttpOptions } from './http.js';
+/**
+ * Raw object schema source accessor (SU-7c). The engine serves/accepts
+ * `objects/<name>/schema.json` source + content version (admin-gated). PUT runs
+ * the loader's validation (parse + full cross-object graph) and never applies
+ * DDL — structural changes take effect on the next `weave dev`/`migrate`.
+ */
+export interface SchemaSourceDocument {
+    source: string;
+    version: string;
+}
+export interface SchemaSourceOptions {
+    signal?: AbortSignal;
+}
+export interface SchemaSaveOptions extends SchemaSourceOptions {
+    /** optimistic lock — 409 when the current version differs */
+    expectVersion?: string;
+    /** explicit overwrite: skip the version check */
+    force?: boolean;
+}
+export interface SchemaSaveResult {
+    ok: true;
+    committed: boolean;
+    version: string;
+}
+export interface SchemaClient {
+    /** raw schema source + version for an object, or null (404) */
+    getSource(name: string, options?: SchemaSourceOptions): Promise<SchemaSourceDocument | null>;
+    /** replace an object's schema source (admin; strict optimistic lock unless `force`) */
+    save(name: string, source: string, options?: SchemaSaveOptions): Promise<SchemaSaveResult>;
+}
+export declare function createSchemaClient(http: HttpOptions): SchemaClient;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;GAKG;AAEH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC7F,uFAAuF;IACvF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC5F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CA2BlE"}

package/dist/schema.js

@@ -0,0 +1,24 @@
+import { ClientError, request } from './http.js';
+export function createSchemaClient(http) {
+    return {
+        async getSource(name, options = {}) {
+            try {
+                return await request(http, 'GET', `/objects/${encodeURIComponent(name)}/schema`, { signal: options.signal });
+            }
+            catch (error) {
+                if (error instanceof ClientError && error.status === 404)
+                    return null;
+                throw error;
+            }
+        },
+        save(name, source, options = {}) {
+            const body = { source };
+            if (options.expectVersion !== undefined)
+                body.expectVersion = options.expectVersion;
+            if (options.force !== undefined)
+                body.force = options.force;
+            return request(http, 'PUT', `/objects/${encodeURIComponent(name)}/schema`, { body, signal: options.signal });
+        },
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCjD,MAAM,UAAU,kBAAkB,CAAC,IAAiB;IAClD,OAAO;QACL,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE;YAChC,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAClB,IAAI,EACJ,KAAK,EACL,YAAY,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAC7C,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;oBAAE,OAAO,IAAI,CAAC;gBACtE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE;YAC7B,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,CAAC;YACjD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;gBAAE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;YACpF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC5D,OAAO,OAAO,CACZ,IAAI,EACJ,KAAK,EACL,YAAY,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CACjC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/scripts.d.ts

@@ -0,0 +1,44 @@
+import type { ScriptSourceKind } from "@weave-kit/engine";
+import type { HttpOptions } from "./http.js";
+export interface ScriptSourceDocument {
+    source: string;
+    version: string;
+}
+export interface ScriptSourceOptions {
+    signal?: AbortSignal;
+}
+export interface ScriptSaveOptions extends ScriptSourceOptions {
+    /** Reserved for optimistic locking; SU-7b servers accept but do not enforce it. */
+    expectVersion?: string;
+}
+export interface ScriptSaveResult {
+    ok: true;
+    committed: boolean;
+    version: string;
+    warnings?: string[];
+}
+/** Page-scoped client script accessor (千页千面): `show.client`/`list.client`.
+ *  Page-level (`/pages/<path>/scripts/<kind>`) overrides the object script for
+ *  that page; block-level (`/pages/<path>/blocks/<ui_id>/scripts/<kind>`) scopes
+ *  a script to one `list` block instance. */
+export interface PageScriptsClient {
+    /** read a page-level or block-level client script (404 → null) */
+    getSource(path: string, kind: string, options?: ScriptSourceOptions): Promise<ScriptSourceDocument | null>;
+    /** write/replace a page-scoped client script (admin) */
+    save(path: string, kind: string, source: string, options?: ScriptSaveOptions): Promise<ScriptSaveResult>;
+    /** delete a page-scoped client script → falls back to the object script (admin) */
+    delete(path: string, kind: string, options?: ScriptSourceOptions): Promise<{
+        ok: true;
+        deleted: boolean;
+    }>;
+}
+export interface ScriptsClient {
+    /** source for server/show/list scripts, including its content version */
+    getSource(name: string, kind: ScriptSourceKind, options?: ScriptSourceOptions): Promise<ScriptSourceDocument | null>;
+    /** replace one script source and commit it to the engine project's Git repository */
+    save(name: string, kind: ScriptSourceKind, source: string, options?: ScriptSaveOptions): Promise<ScriptSaveResult>;
+    /** page-scoped client scripts (`/pages/<path>/...`) */
+    page: PageScriptsClient;
+}
+export declare function createScriptsClient(http: HttpOptions): ScriptsClient;
+//# sourceMappingURL=scripts.d.ts.map

package/dist/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../src/scripts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;6CAG6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC3G,wDAAwD;IACxD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzG,mFAAmF;IACnF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC5G;AAED,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACrH,qFAAqF;IACrF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnH,uDAAuD;IACvD,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAOD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CA2CpE"}

package/dist/scripts.js

@@ -0,0 +1,41 @@
+import { ClientError, request } from "./http.js";
+/** build a `/pages/<path>/<scope>/scripts/<kind>` URL fragment for a page-scoped script */
+function pageScriptUrl(path, kind) {
+    return `/pages/${path}/scripts/${encodeURIComponent(kind)}`;
+}
+export function createScriptsClient(http) {
+    return {
+        getSource: async (name, kind, options = {}) => {
+            try {
+                return await request(http, "GET", `/objects/${encodeURIComponent(name)}/scripts/${encodeURIComponent(kind)}`, { signal: options.signal });
+            }
+            catch (error) {
+                if (error instanceof ClientError && error.status === 404)
+                    return null;
+                throw error;
+            }
+        },
+        save: (name, kind, source, options = {}) => request(http, "PUT", `/objects/${encodeURIComponent(name)}/scripts/${encodeURIComponent(kind)}`, {
+            body: options.expectVersion === undefined ? { source } : { source, expectVersion: options.expectVersion },
+            signal: options.signal,
+        }),
+        page: {
+            getSource: async (path, kind, options = {}) => {
+                try {
+                    return await request(http, "GET", pageScriptUrl(path, kind), { signal: options.signal });
+                }
+                catch (error) {
+                    if (error instanceof ClientError && error.status === 404)
+                        return null;
+                    throw error;
+                }
+            },
+            save: (path, kind, source, options = {}) => request(http, "PUT", pageScriptUrl(path, kind), {
+                body: options.expectVersion === undefined ? { source } : { source, expectVersion: options.expectVersion },
+                signal: options.signal,
+            }),
+            delete: async (path, kind, options = {}) => request(http, "DELETE", pageScriptUrl(path, kind), { signal: options.signal }),
+        },
+    };
+}
+//# sourceMappingURL=scripts.js.map

package/dist/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../src/scripts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CjD,2FAA2F;AAC3F,SAAS,aAAa,CAAC,IAAY,EAAE,IAAY;IAC/C,OAAO,UAAU,IAAI,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAiB;IACnD,OAAO;QACL,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;YAC5C,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAClB,IAAI,EACJ,KAAK,EACL,YAAY,kBAAkB,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC1E,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;oBAAE,OAAO,IAAI,CAAC;gBACtE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CACzC,OAAO,CACL,IAAI,EACJ,KAAK,EACL,YAAY,kBAAkB,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC1E;YACE,IAAI,EAAE,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;YACzG,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF;QACH,IAAI,EAAE;YACJ,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;gBAC5C,IAAI,CAAC;oBACH,OAAO,MAAM,OAAO,CAAuB,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;wBAAE,OAAO,IAAI,CAAC;oBACtE,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YACD,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CACzC,OAAO,CAAmB,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;gBAChE,IAAI,EAAE,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;gBACzG,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC;YACJ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CACzC,OAAO,CAAiC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SACjH;KACF,CAAC;AACJ,CAAC"}

package/dist/subscribe.d.ts

@@ -0,0 +1,32 @@
+import type { HttpOptions } from './http.js';
+/**
+ * Live subscription (M12) — fetch-based SSE client. `fetch` can set the
+ * Authorization header (native EventSource cannot), so the API key travels in
+ * the Bearer header, never in the query string. Auto-reconnects with backoff
+ * and sends `Last-Event-ID` so the engine replays events missed while
+ * disconnected. A `schema.changed` event (with `payload.replayGap`) is emitted
+ * when the engine can no longer replay (process restart / ring overflow) —
+ * refetch metadata/permissions via REST.
+ */
+/** one live event (wire shape: `{ seq?, ts?, type, payload }`) */
+export interface LiveEvent {
+    seq?: number;
+    ts?: string;
+    type: string;
+    payload: Record<string, unknown>;
+}
+export interface SubscribeOptions {
+    onEvent(event: LiveEvent): void;
+    onOpen?(): void;
+    onError?(error: Error): void;
+    /** reconnect backoff base ms; doubles per retry (default 1000) */
+    backoffMs?: number;
+    /** reconnect backoff cap ms (default 15000) */
+    maxBackoffMs?: number;
+}
+export interface Subscription {
+    close(): void;
+}
+/** build a `client.subscribe` function bound to one client's transport */
+export declare function createSubscriber(http: HttpOptions): (options: SubscribeOptions) => Subscription;
+//# sourceMappingURL=subscribe.d.ts.map

package/dist/subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../src/subscribe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;;;;;GAQG;AAEH,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,IAAI,IAAI,CAAC;IAChB,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,IAAI,IAAI,CAAC;CACf;AAkCD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,IACtB,SAAS,gBAAgB,KAAG,YAAY,CAiFnE"}