@quadrokit/client 0.1.0 → 0.2.1

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { writeGenerated } from './generate/codegen.mjs';
+function parseArgs(argv) {
+    let command = '';
+    let url;
+    let token;
+    let out = '.quadrokit/generated';
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--url' && argv[i + 1]) {
+            url = argv[++i];
+        }
+        else if (a === '--token' && argv[i + 1]) {
+            token = argv[++i];
+        }
+        else if (a === '--out' && argv[i + 1]) {
+            out = argv[++i];
+        }
+        else if (!a.startsWith('-') && !command) {
+            command = a;
+        }
+    }
+    return { command, url, token, out };
+}
+async function loadCatalog(url, token) {
+    if (url.startsWith('file:')) {
+        const path = fileURLToPath(url);
+        const text = await readFile(path, 'utf8');
+        return JSON.parse(text);
+    }
+    const headers = {
+        Accept: 'application/json',
+    };
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    const res = await fetch(url, { headers });
+    if (!res.ok) {
+        const t = await res.text();
+        throw new Error(`Failed to fetch catalog (${res.status}): ${t.slice(0, 500)}`);
+    }
+    return res.json();
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const { command, url, token, out } = parseArgs(argv);
+    if (command !== 'generate') {
+        console.error(`Usage: quadrokit-client generate --url <catalog_url> [--token <token>] [--out <dir>]
+
+Examples:
+  quadrokit-client generate --url http://localhost:7080/rest/\\$catalog --token secret
+  quadrokit-client generate --url file://./assets/catalog.json --out .quadrokit/generated
+`);
+        process.exit(1);
+    }
+    if (!url) {
+        console.error('Error: --url is required for generate.');
+        process.exit(1);
+    }
+    const catalog = await loadCatalog(url, token);
+    await writeGenerated(out, catalog);
+    console.error(`Wrote generated client to ${out}`);
+}
+main().catch((e) => {
+    console.error(e);
+    process.exit(1);
+});

package/dist/generate/codegen.d.ts

@@ -0,0 +1,3 @@
+import type { CatalogJson } from '@quadrokit/shared';
+export declare function writeGenerated(outDir: string, catalog: CatalogJson): Promise<void>;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/generate/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/generate/codegen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsC,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAgTxF,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBxF"}

package/dist/generate/codegen.mjs

@@ -0,0 +1,287 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { sessionCookieName } from '@quadrokit/shared';
+function map4dType(attr) {
+    const t = attr.type ?? 'unknown';
+    switch (t) {
+        case 'long':
+        case 'word':
+            return 'number';
+        case 'string':
+            return 'string';
+        case 'bool':
+            return 'boolean';
+        case 'number':
+            return 'number';
+        case 'date':
+            return 'string';
+        case 'duration':
+            return 'string | number';
+        case 'image':
+            return 'string | null';
+        case 'object':
+            return 'Record<string, unknown>';
+        default: {
+            if (attr.kind === 'relatedEntity') {
+                return `${t} | null`;
+            }
+            if (attr.kind === 'relatedEntities' || attr.kind === 'calculated') {
+                return 'unknown';
+            }
+            return 'unknown';
+        }
+    }
+}
+function selectionToEntity(selectionType) {
+    if (selectionType.endsWith('Selection')) {
+        return selectionType.slice(0, -'Selection'.length);
+    }
+    return selectionType;
+}
+function navigableRelations(dc) {
+    const out = [];
+    for (const a of dc.attributes ?? []) {
+        if (a.kind === 'relatedEntities') {
+            out.push({
+                attr: a.name,
+                targetClass: selectionToEntity(a.type ?? 'unknown'),
+            });
+        }
+        if (a.kind === 'calculated' && a.behavior === 'relatedEntities' && a.type) {
+            out.push({ attr: a.name, targetClass: selectionToEntity(a.type) });
+        }
+    }
+    return out;
+}
+function relationTargets(dc) {
+    const m = {};
+    for (const a of dc.attributes ?? []) {
+        if (a.kind === 'relatedEntity' && a.type) {
+            m[a.name] = a.type;
+        }
+    }
+    return m;
+}
+function keyNames(dc) {
+    const k = dc.key?.map((x) => x.name) ?? ['ID'];
+    return k.length ? k : ['ID'];
+}
+function collectPaths(dc, byName, maxDepth) {
+    const paths = new Set();
+    const visit = (current, prefix, depth) => {
+        for (const a of current.attributes ?? []) {
+            if (a.kind === 'storage' || a.kind === 'calculated' || a.kind === 'alias') {
+                const p = prefix ? `${prefix}.${a.name}` : a.name;
+                paths.add(p);
+            }
+            if (a.kind === 'relatedEntity' && a.type && depth < maxDepth) {
+                const child = byName.get(a.type);
+                const base = prefix ? `${prefix}.${a.name}` : a.name;
+                paths.add(base);
+                if (child) {
+                    visit(child, base, depth + 1);
+                }
+            }
+        }
+    };
+    visit(dc, '', 0);
+    return [...paths].sort();
+}
+function emitInterface(dc, _byName) {
+    const lines = [];
+    lines.push(`export interface ${dc.name} {`);
+    for (const a of dc.attributes ?? []) {
+        if (a.kind === 'relatedEntities') {
+            continue;
+        }
+        if (a.kind === 'calculated' && a.behavior === 'relatedEntities') {
+            continue;
+        }
+        const opt = a.not_null || a.identifying ? '' : '?';
+        const ts = map4dType(a);
+        lines.push(`  ${a.name}${opt}: ${ts};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+function emitTypes(catalog) {
+    const classes = catalog.dataClasses?.filter((d) => d.exposed) ?? [];
+    const byName = new Map(classes.map((c) => [c.name, c]));
+    const interfaces = classes.map((c) => emitInterface(c, byName));
+    const pathTypes = classes.map((c) => {
+        const paths = collectPaths(c, byName, 2);
+        const name = `${c.name}Path`;
+        const body = paths.length ? paths.map((p) => `'${p}'`).join('\n  | ') : 'never';
+        return `export type ${name} =\n  | ${body};`;
+    });
+    return `/* eslint-disable */\n/* Auto-generated by @quadrokit/client — do not edit */\n\n${interfaces.join('\n\n')}\n\n${pathTypes.join('\n\n')}\n`;
+}
+function emitClient(catalog) {
+    const classes = catalog.dataClasses?.filter((d) => d.exposed) ?? [];
+    const dbName = catalog.__NAME ?? 'default';
+    const hasAuthentify = catalog.methods?.some((m) => m.name === 'authentify' && m.applyTo === 'dataStore');
+    const keyNamesRecord = Object.fromEntries(classes.map((x) => [x.name, keyNames(x)]));
+    const imports = classes.length > 0
+        ? `/* eslint-disable */\n/* Auto-generated by @quadrokit/client — do not edit */\n\nimport {\n  QuadroHttp,\n  makeDataClassApi,\n  attachRelatedApis,\n  callDatastorePath,\n  type CollectionHandle,\n  type CollectionOptions,\n  type SelectedEntity,\n} from '@quadrokit/client/runtime';\n`
+        : `/* eslint-disable */\n/* Auto-generated by @quadrokit/client — do not edit */\n\nimport { QuadroHttp, callDatastorePath } from '@quadrokit/client/runtime';\n`;
+    const typeImports = classes.map((c) => c.name).join(', ');
+    const pathImports = classes.map((c) => `${c.name}Path`).join(', ');
+    const typeImportLine = typeImports || pathImports
+        ? `\nimport type { ${[typeImports, pathImports].filter(Boolean).join(', ')} } from './types.gen.mjs';\n\n`
+        : '\n';
+    const header = `${imports}${typeImportLine}`;
+    const metaExport = `
+export const quadrokitCatalogMeta = {
+  __NAME: ${JSON.stringify(dbName)},
+  sessionCookieName: ${JSON.stringify(sessionCookieName(catalog))},
+} as const;
+`;
+    const configInterface = `
+export interface QuadroClientConfig {
+  baseURL: string;
+  fetchImpl?: typeof fetch;
+  defaultHeaders?: Record<string, string>;
+}
+`;
+    const mapFunctions = classes
+        .map((c) => {
+        const nav = navigableRelations(c);
+        const relMap = JSON.stringify(relationTargets(c));
+        return `  function map${c.name}Row(http: QuadroHttp, raw: unknown): ${c.name} {
+    const row = raw as ${c.name};
+    const pk = (row as { ID?: number }).ID ?? (row as { id?: number }).id;
+    attachRelatedApis(
+      raw,
+      {
+        http,
+        parentClass: '${c.name}',
+        parentId: pk as number,
+        relationMap: ${relMap},
+        keyNames: ${JSON.stringify(keyNamesRecord)},
+      },
+      ${JSON.stringify(nav)},
+    );
+    return row;
+  }`;
+    })
+        .join('\n\n');
+    const classBranches = classes
+        .map((c) => {
+        const relMap = JSON.stringify(relationTargets(c));
+        const kn = JSON.stringify(keyNames(c));
+        const pathsType = `${c.name}Path`;
+        return `    ${c.name}: (() => {
+      const cfg = {
+        http,
+        className: '${c.name}',
+        relationMap: ${relMap},
+        keyNames: ${kn},
+      } as const;
+      const api = makeDataClassApi<${c.name}>(cfg);
+      return {
+        all<S extends readonly ${pathsType}[] = readonly []>(
+          options?: CollectionOptions & { select?: S },
+        ): CollectionHandle<S['length'] extends 0 ? ${c.name} : SelectedEntity<${c.name}, S>> {
+          const inner = api.all(options as CollectionOptions);
+          return {
+            ...inner,
+            delete: inner.delete.bind(inner),
+            release: inner.release.bind(inner),
+            get length() {
+              return inner.length;
+            },
+            [Symbol.asyncIterator]() {
+              const it = inner[Symbol.asyncIterator]();
+              return {
+                async next() {
+                  const n = await it.next();
+                  if (!n.done && n.value) {
+                    map${c.name}Row(http, n.value);
+                  }
+                  return n;
+                },
+              };
+            },
+          } as CollectionHandle<S['length'] extends 0 ? ${c.name} : SelectedEntity<${c.name}, S>>;
+        },
+        async get<S extends readonly ${pathsType}[] = readonly []>(
+          id: string | number,
+          options?: { select?: S },
+        ): Promise<(S['length'] extends 0 ? ${c.name} : SelectedEntity<${c.name}, S>) | null> {
+          const entity = await api.get(id, options);
+          if (entity) {
+            map${c.name}Row(http, entity);
+          }
+          return entity as (S['length'] extends 0 ? ${c.name} : SelectedEntity<${c.name}, S>) | null;
+        },
+        delete: (id: string | number) => api.delete(id),
+        query<S extends readonly ${pathsType}[] = readonly []>(
+          filter: string,
+          options?: CollectionOptions & { params?: unknown[]; select?: S },
+        ): CollectionHandle<S['length'] extends 0 ? ${c.name} : SelectedEntity<${c.name}, S>> {
+          const inner = api.query(filter, options as CollectionOptions);
+          return {
+            ...inner,
+            delete: inner.delete.bind(inner),
+            release: inner.release.bind(inner),
+            get length() {
+              return inner.length;
+            },
+            [Symbol.asyncIterator]() {
+              const it = inner[Symbol.asyncIterator]();
+              return {
+                async next() {
+                  const n = await it.next();
+                  if (!n.done && n.value) {
+                    map${c.name}Row(http, n.value);
+                  }
+                  return n;
+                },
+              };
+            },
+          } as CollectionHandle<S['length'] extends 0 ? ${c.name} : SelectedEntity<${c.name}, S>>;
+        },
+      };
+    })(),`;
+    })
+        .join('\n');
+    const authentifyBlock = hasAuthentify
+        ? `
+    authentify: {
+      login: (body: { email: string; password: string }) =>
+        callDatastorePath(http, ['authentify', 'login'], { body }),
+    },`
+        : '';
+    const body = `
+export function createClient(config: QuadroClientConfig) {
+  const http = new QuadroHttp({
+    baseURL: config.baseURL,
+    fetchImpl: config.fetchImpl,
+    defaultHeaders: config.defaultHeaders,
+  });
+
+${mapFunctions}
+
+  return {${authentifyBlock}
+${classBranches}
+    rpc: (segments: string[], init?: { method?: 'GET' | 'POST'; body?: unknown }) =>
+      callDatastorePath(http, segments, init),
+    sessionCookieName: quadrokitCatalogMeta.sessionCookieName,
+    _http: http,
+  };
+}
+
+export type QuadroClient = ReturnType<typeof createClient>;
+`;
+    return header + metaExport + configInterface + body;
+}
+export async function writeGenerated(outDir, catalog) {
+    await mkdir(outDir, { recursive: true });
+    await writeFile(path.join(outDir, 'types.gen.ts'), emitTypes(catalog), 'utf8');
+    await writeFile(path.join(outDir, 'client.gen.ts'), emitClient(catalog), 'utf8');
+    await writeFile(path.join(outDir, 'meta.json'), JSON.stringify({
+        __NAME: catalog.__NAME,
+        sessionCookieName: sessionCookieName(catalog),
+        generatedAt: new Date().toISOString(),
+    }, null, 2), 'utf8');
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Runtime and types for QuadroKit 4D REST clients.
+ * Generated `createClient` lives in `.quadrokit/generated/client.gen.ts` after `generate`.
+ */
+export * from './runtime/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oBAAoB,CAAA"}

package/{src/index.ts → dist/index.mjs}

@@ -2,4 +2,4 @@
  * Runtime and types for QuadroKit 4D REST clients.
  * Generated `createClient` lives in `.quadrokit/generated/client.gen.ts` after `generate`.
  */
-export * from './runtime/index.js'
+export * from './runtime/index.mjs';

package/dist/runtime/collection.d.ts

@@ -0,0 +1,29 @@
+import type { QuadroHttp } from './http.js';
+import { type ListQueryParams } from './query.js';
+export interface CollectionContext {
+    http: QuadroHttp;
+    className: string;
+    relationMap: Record<string, string>;
+    /** Primary key attribute names (first wins for simple path). */
+    keyNames: readonly string[];
+    path: string;
+    /** Optional entity-set URL from a previous response for `release()`. */
+    entitySetUrl?: string;
+}
+export interface CollectionOptions extends ListQueryParams {
+    page?: number;
+    pageSize?: number;
+    select?: readonly string[];
+}
+export type MapRow<R> = (raw: unknown) => R;
+/**
+ * Lazy paged collection: async iteration loads further pages; tracks PKs for `delete()`.
+ */
+export declare function createCollection<R>(ctx: CollectionContext, initialOptions: CollectionOptions, mapRow: MapRow<R>): CollectionHandle<R>;
+export type CollectionHandle<R> = AsyncIterable<R> & {
+    delete(): Promise<void>;
+    release(): Promise<void>;
+    /** Number of entities seen while iterating (used after partial iteration). */
+    readonly length: number;
+};
+//# sourceMappingURL=collection.d.ts.map

package/dist/runtime/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/runtime/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAGxE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,gEAAgE;IAChE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAA;AAe3C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,iBAAiB,EACtB,cAAc,EAAE,iBAAiB,EACjC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,gBAAgB,CAAC,CAAC,CAAC,CAoFrB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IACnD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAA"}

package/dist/runtime/collection.mjs

@@ -0,0 +1,94 @@
+import { buildListSearchParams } from './query.mjs';
+import { unwrapEntityList } from './unwrap.mjs';
+function primaryKeyFromRow(row, keyNames) {
+    if (!row || typeof row !== 'object') {
+        return undefined;
+    }
+    const o = row;
+    for (const k of keyNames) {
+        if (k in o && o[k] != null) {
+            return o[k];
+        }
+    }
+    return undefined;
+}
+/**
+ * Lazy paged collection: async iteration loads further pages; tracks PKs for `delete()`.
+ */
+export function createCollection(ctx, initialOptions, mapRow) {
+    const seenIds = new Set();
+    let entitySetUrl = ctx.entitySetUrl;
+    async function fetchPage(page) {
+        const qs = buildListSearchParams(ctx.className, { ...initialOptions, page }, ctx.relationMap);
+        const res = await ctx.http.request(`${ctx.path}${qs}`);
+        const text = await res.text();
+        if (!res.ok) {
+            throw new Error(`List failed ${res.status}: ${text.slice(0, 200)}`);
+        }
+        const loc = res.headers.get('Content-Location') ?? res.headers.get('Location');
+        if (loc) {
+            entitySetUrl = loc.startsWith('http')
+                ? loc
+                : `${ctx.http.baseURL}${loc.startsWith('/') ? '' : '/'}${loc}`;
+        }
+        const json = text ? JSON.parse(text) : [];
+        return unwrapEntityList(ctx.className, json);
+    }
+    async function* iteratePages() {
+        let page = initialOptions.page ?? 1;
+        const pageSize = initialOptions.pageSize ?? 50;
+        while (true) {
+            const rows = await fetchPage(page);
+            if (!rows.length) {
+                break;
+            }
+            for (const raw of rows) {
+                const mapped = mapRow(raw);
+                const pk = primaryKeyFromRow(raw, ctx.keyNames);
+                if (pk !== undefined) {
+                    seenIds.add(pk);
+                }
+                yield mapped;
+            }
+            if (rows.length < pageSize) {
+                break;
+            }
+            page += 1;
+        }
+    }
+    const iterable = {
+        [Symbol.asyncIterator]() {
+            return iteratePages()[Symbol.asyncIterator]();
+        },
+    };
+    const handle = {
+        ...iterable,
+        async delete() {
+            const ids = [...seenIds];
+            if (!ids.length) {
+                return;
+            }
+            await Promise.all(ids.map((id) => ctx.http.void(`${ctx.className}(${encodeURIComponent(String(id))})`, {
+                method: 'DELETE',
+            })));
+            seenIds.clear();
+        },
+        async release() {
+            if (entitySetUrl) {
+                try {
+                    await ctx.http.void(entitySetUrl.replace(ctx.http.baseURL, '') || entitySetUrl, {
+                        method: 'DELETE',
+                    });
+                }
+                catch {
+                    // Some servers ignore release; swallow
+                }
+                entitySetUrl = undefined;
+            }
+        },
+        get length() {
+            return seenIds.size;
+        },
+    };
+    return handle;
+}

package/dist/runtime/data-class.d.ts

@@ -0,0 +1,42 @@
+import { type CollectionHandle, type CollectionOptions } from './collection.js';
+import type { QuadroHttp } from './http.js';
+import { unwrapEntityList } from './unwrap.js';
+export interface DataClassRuntimeConfig {
+    http: QuadroHttp;
+    className: string;
+    /** relation attribute name → target class name for $expand */
+    relationMap: Record<string, string>;
+    keyNames: readonly string[];
+}
+export declare function makeDataClassApi<R = unknown>(cfg: DataClassRuntimeConfig): {
+    all<S extends readonly string[] = readonly []>(options?: CollectionOptions & {
+        select?: S;
+    }): CollectionHandle<S extends readonly never[] ? R : R>;
+    get<S extends readonly string[] = readonly []>(id: string | number, options?: {
+        select?: S;
+    }): Promise<R | null>;
+    delete(id: string | number): Promise<boolean>;
+    query<S extends readonly string[] = readonly []>(filter: string, options?: CollectionOptions & {
+        params?: unknown[];
+        select?: S;
+    }): CollectionHandle<S extends readonly never[] ? R : R>;
+};
+export interface EntityNavigationConfig {
+    http: QuadroHttp;
+    parentClass: string;
+    parentId: string | number;
+    relationMap: Record<string, string>;
+    keyNames: Record<string, readonly string[]>;
+}
+/** Nested collection under an entity, e.g. `Agency(1)/todayBookings`. */
+export declare function makeRelatedCollectionApi(cfg: EntityNavigationConfig, attributeName: string, targetClassName: string): {
+    list<S extends readonly string[] = readonly []>(options?: CollectionOptions & {
+        select?: S;
+    }): CollectionHandle<unknown>;
+};
+export declare function attachRelatedApis(row: unknown, cfg: EntityNavigationConfig, relations: readonly {
+    attr: string;
+    targetClass: string;
+}[]): void;
+export { unwrapEntityList };
+//# sourceMappingURL=data-class.d.ts.map

package/dist/runtime/data-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-class.d.ts","sourceRoot":"","sources":["../../src/runtime/data-class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAoB,MAAM,iBAAiB,CAAA;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAgB,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE5D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,sBAAsB;QAIjE,CAAC,SAAS,SAAS,MAAM,EAAE,0BACnB,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,GAC3C,gBAAgB,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAc7C,CAAC,SAAS,SAAS,MAAM,EAAE,oBAC/B,MAAM,GAAG,MAAM,YACT;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,GACvB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;eASH,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;UAU7C,CAAC,SAAS,SAAS,MAAM,EAAE,wBACvB,MAAM,YACJ,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,GAC/D,gBAAgB,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;EAe1D;AA6BD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;CAC5C;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,sBAAsB,EAC3B,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM;SAKhB,CAAC,SAAS,SAAS,MAAM,EAAE,0BACpB,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,GAC3C,gBAAgB,CAAC,OAAO,CAAC;EAc/B;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,sBAAsB,EAC3B,SAAS,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,GAC1D,IAAI,CAYN;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/runtime/data-class.mjs

@@ -0,0 +1,99 @@
+import { createCollection } from './collection.mjs';
+import { buildEntityParams } from './query.mjs';
+import { unwrapEntity, unwrapEntityList } from './unwrap.mjs';
+export function makeDataClassApi(cfg) {
+    const path = `/${cfg.className}`;
+    return {
+        all(options) {
+            return createCollection({
+                http: cfg.http,
+                className: cfg.className,
+                relationMap: cfg.relationMap,
+                keyNames: cfg.keyNames,
+                path,
+            }, options ?? {}, (raw) => raw);
+        },
+        async get(id, options) {
+            const qs = options?.select?.length
+                ? buildEntityParams(cfg.className, options.select, cfg.relationMap)
+                : '';
+            const key = encodeURIComponent(String(id));
+            const body = await cfg.http.json(`${cfg.className}(${key})${qs}`);
+            return unwrapEntity(cfg.className, body);
+        },
+        async delete(id) {
+            const key = encodeURIComponent(String(id));
+            try {
+                await cfg.http.void(`${cfg.className}(${key})`, { method: 'DELETE' });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        query(filter, options) {
+            const paramFilter = substituteQueryParams(filter, options?.params);
+            return createCollection({
+                http: cfg.http,
+                className: cfg.className,
+                relationMap: cfg.relationMap,
+                keyNames: cfg.keyNames,
+                path,
+            }, { ...options, filter: paramFilter }, (raw) => raw);
+        },
+    };
+}
+function substituteQueryParams(expr, params) {
+    if (!params?.length) {
+        return expr;
+    }
+    let out = expr;
+    params.forEach((p, i) => {
+        const placeholder = `:${i + 1}`;
+        const lit = formatFilterLiteral(p);
+        out = out.split(placeholder).join(lit);
+    });
+    return out;
+}
+function formatFilterLiteral(p) {
+    if (p === null || p === undefined) {
+        return 'null';
+    }
+    if (typeof p === 'number') {
+        return String(p);
+    }
+    if (typeof p === 'boolean') {
+        return p ? 'true' : 'false';
+    }
+    const s = String(p).replace(/'/g, "''");
+    return `'${s}'`;
+}
+/** Nested collection under an entity, e.g. `Agency(1)/todayBookings`. */
+export function makeRelatedCollectionApi(cfg, attributeName, targetClassName) {
+    const basePath = `/${cfg.parentClass}(${encodeURIComponent(String(cfg.parentId))})/${attributeName}`;
+    return {
+        list(options) {
+            return createCollection({
+                http: cfg.http,
+                className: targetClassName,
+                relationMap: cfg.relationMap,
+                keyNames: cfg.keyNames[targetClassName] ?? ['ID'],
+                path: basePath,
+            }, options ?? {}, (raw) => raw);
+        },
+    };
+}
+export function attachRelatedApis(row, cfg, relations) {
+    if (!row || typeof row !== 'object') {
+        return;
+    }
+    const obj = row;
+    for (const { attr, targetClass } of relations) {
+        Object.defineProperty(obj, attr, {
+            enumerable: false,
+            configurable: true,
+            value: makeRelatedCollectionApi(cfg, attr, targetClass),
+        });
+    }
+}
+export { unwrapEntityList };

package/dist/runtime/datastore.d.ts

@@ -0,0 +1,8 @@
+import type { QuadroHttp } from './http.js';
+/** Call nested datastore paths like `authentify/login` (POST by default). */
+export declare function callDatastorePath(http: QuadroHttp, segments: readonly string[], init?: {
+    method?: 'GET' | 'POST';
+    body?: unknown;
+}): Promise<unknown>;
+export declare function createDatastoreNamespace(_http: QuadroHttp, tree: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=datastore.d.ts.map