@quadrokit/client 0.1.0 → 0.2.0

package/dist/runtime/datastore.js

@@ -0,0 +1,15 @@
+/** Call nested datastore paths like `authentify/login` (POST by default). */
+export async function callDatastorePath(http, segments, init) {
+    const path = `/${segments.join('/')}`;
+    const method = init?.method ?? 'POST';
+    if (method === 'GET') {
+        return http.json(path, { method: 'GET' });
+    }
+    return http.json(path, {
+        method: 'POST',
+        body: init?.body !== undefined ? JSON.stringify(init.body) : undefined,
+    });
+}
+export function createDatastoreNamespace(_http, tree) {
+    return tree;
+}

package/dist/runtime/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class QuadroHttpError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAMzC"}

package/dist/runtime/errors.js

@@ -0,0 +1,10 @@
+export class QuadroHttpError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`Quadro HTTP ${status}: ${body.slice(0, 200)}`);
+        this.name = 'QuadroHttpError';
+        this.status = status;
+        this.body = body;
+    }
+}

package/dist/runtime/http.d.ts

@@ -0,0 +1,16 @@
+export interface QuadroFetchOptions {
+    baseURL: string;
+    fetchImpl?: typeof fetch;
+    /** Extra headers on every request (e.g. Authorization for generate). */
+    defaultHeaders?: Record<string, string>;
+}
+export declare function normalizeBaseURL(baseURL: string): string;
+export declare class QuadroHttp {
+    private readonly opts;
+    constructor(opts: QuadroFetchOptions);
+    get baseURL(): string;
+    request(path: string, init?: RequestInit): Promise<Response>;
+    json<T>(path: string, init?: RequestInit): Promise<T>;
+    void(path: string, init?: RequestInit): Promise<void>;
+}
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAErD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwBhE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAYzD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAOhE"}

package/dist/runtime/http.js

@@ -0,0 +1,54 @@
+import { QuadroHttpError } from './errors.js';
+export function normalizeBaseURL(baseURL) {
+    return baseURL.replace(/\/$/, '');
+}
+export class QuadroHttp {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    get baseURL() {
+        return normalizeBaseURL(this.opts.baseURL);
+    }
+    async request(path, init = {}) {
+        const url = path.startsWith('http')
+            ? path
+            : `${this.baseURL}${path.startsWith('/') ? '' : '/'}${path}`;
+        const headers = new Headers(init.headers);
+        if (!headers.has('Accept')) {
+            headers.set('Accept', 'application/json');
+        }
+        if (init.body !== undefined && !headers.has('Content-Type')) {
+            headers.set('Content-Type', 'application/json');
+        }
+        for (const [k, v] of Object.entries(this.opts.defaultHeaders ?? {})) {
+            if (!headers.has(k)) {
+                headers.set(k, v);
+            }
+        }
+        const fetchFn = this.opts.fetchImpl ?? fetch;
+        return fetchFn(url, {
+            credentials: 'include',
+            ...init,
+            headers,
+        });
+    }
+    async json(path, init = {}) {
+        const res = await this.request(path, init);
+        const text = await res.text();
+        if (!res.ok) {
+            throw new QuadroHttpError(res.status, text);
+        }
+        if (!text) {
+            return undefined;
+        }
+        return JSON.parse(text);
+    }
+    async void(path, init = {}) {
+        const res = await this.request(path, init);
+        if (!res.ok) {
+            const text = await res.text();
+            throw new QuadroHttpError(res.status, text);
+        }
+    }
+}

package/dist/runtime/index.d.ts

@@ -0,0 +1,9 @@
+export { type CollectionContext, type CollectionHandle, type CollectionOptions, createCollection, } from './collection.js';
+export { attachRelatedApis, type DataClassRuntimeConfig, type EntityNavigationConfig, makeDataClassApi, makeRelatedCollectionApi, } from './data-class.js';
+export { callDatastorePath, createDatastoreNamespace } from './datastore.js';
+export { QuadroHttpError } from './errors.js';
+export { normalizeBaseURL, type QuadroFetchOptions, QuadroHttp, } from './http.js';
+export type { Paths1, SelectedEntity } from './paths.js';
+export { buildListSearchParams, type ListQueryParams } from './query.js';
+export { unwrapEntity, unwrapEntityList } from './unwrap.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,UAAU,GACX,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/runtime/index.js

@@ -0,0 +1,7 @@
+export { createCollection, } from './collection.js';
+export { attachRelatedApis, makeDataClassApi, makeRelatedCollectionApi, } from './data-class.js';
+export { callDatastorePath, createDatastoreNamespace } from './datastore.js';
+export { QuadroHttpError } from './errors.js';
+export { normalizeBaseURL, QuadroHttp, } from './http.js';
+export { buildListSearchParams } from './query.js';
+export { unwrapEntity, unwrapEntityList } from './unwrap.js';

package/dist/runtime/paths.d.ts

@@ -0,0 +1,16 @@
+/** Type-level helpers for `$select` dot paths (compile-time only). */
+type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+type PickOne<T, H extends string> = H extends keyof T & string ? Pick<T, H> : H extends `${infer K}.${infer R}` ? K extends keyof T & string ? NonNullable<T[K]> extends infer U ? U extends object ? {
+    [P in K]: PickOne<U, R>;
+} : never : never : never : never;
+declare const selectBrand: unique symbol;
+/** Entity narrowed to selected paths (branded for nominal distinction). */
+export type SelectedEntity<T, S extends readonly string[]> = UnionToIntersection<S[number] extends infer H ? (H extends string ? PickOne<T, H> : never) : never> extends infer O ? O extends object ? O & {
+    readonly [selectBrand]: S;
+} : never : never;
+/** Flat union of first-level and nested dot paths (codegen emits concrete unions). */
+export type Paths1<T> = T extends object ? {
+    [K in keyof T & string]: NonNullable<T[K]> extends infer U ? U extends object ? K | `${K}.${Paths1<U>}` : K : K;
+}[keyof T & string] : never;
+export {};
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/runtime/paths.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CACjF,CAAC,EAAE,MAAM,CAAC,KACP,IAAI,GACL,CAAC,GACD,KAAK,CAAA;AAET,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,GAC1D,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GACV,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,GAC/B,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,GACxB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAC/B,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAAE,GAC3B,KAAK,GACP,KAAK,GACP,KAAK,GACP,KAAK,CAAA;AAEX,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAA;AAExC,2EAA2E;AAC3E,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,IACvD,mBAAmB,CACjB,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAC/E,SAAS,MAAM,CAAC,GACb,CAAC,SAAS,MAAM,GACd,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;CAAE,GACjC,KAAK,GACP,KAAK,CAAA;AAEX,sFAAsF;AACtF,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACpC;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GACtD,CAAC,SAAS,MAAM,GACd,CAAC,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,GACvB,CAAC,GACH,CAAC;CACN,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GACnB,KAAK,CAAA"}

package/dist/runtime/paths.js

@@ -0,0 +1,2 @@
+/** Type-level helpers for `$select` dot paths (compile-time only). */
+export {};

package/dist/runtime/query.d.ts

@@ -0,0 +1,14 @@
+/** Build 4D REST query params ($skip, $top, $filter, $expand, $select). */
+export interface ListQueryParams {
+    page?: number;
+    pageSize?: number;
+    /** Dot-paths like `manager.name` → $expand + nested $select where possible. */
+    select?: readonly string[];
+    /** OData-style filter string (4D REST). */
+    filter?: string;
+    orderby?: string;
+}
+export declare function buildListSearchParams(className: string, opts: ListQueryParams, _relationMap: Record<string, string>): string;
+/** Query string for a single entity (only $select / $expand, no paging). */
+export declare function buildEntityParams(className: string, select: readonly string[] | undefined, _relationMap: Record<string, string>): string;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/runtime/query.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAwBR;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAcR"}

package/dist/runtime/query.js

@@ -0,0 +1,76 @@
+/** Build 4D REST query params ($skip, $top, $filter, $expand, $select). */
+export function buildListSearchParams(className, opts, _relationMap) {
+    const params = new URLSearchParams();
+    const page = opts.page ?? 1;
+    const pageSize = opts.pageSize ?? 50;
+    const skip = (page - 1) * pageSize;
+    if (skip > 0) {
+        params.set('$skip', String(skip));
+    }
+    params.set('$top', String(pageSize));
+    if (opts.filter) {
+        params.set('$filter', opts.filter);
+    }
+    if (opts.orderby) {
+        params.set('$orderby', opts.orderby);
+    }
+    const { expand, selectRoot } = buildExpandAndSelect(className, opts.select ?? [], _relationMap);
+    if (selectRoot.length) {
+        params.set('$select', selectRoot.join(','));
+    }
+    if (expand.length) {
+        params.set('$expand', expand.join(','));
+    }
+    const q = params.toString();
+    return q ? `?${q}` : '';
+}
+/** Query string for a single entity (only $select / $expand, no paging). */
+export function buildEntityParams(className, select, _relationMap) {
+    if (!select?.length) {
+        return '';
+    }
+    const { expand, selectRoot } = buildExpandAndSelect(className, select, _relationMap);
+    const params = new URLSearchParams();
+    if (selectRoot.length) {
+        params.set('$select', selectRoot.join(','));
+    }
+    if (expand.length) {
+        params.set('$expand', expand.join(','));
+    }
+    const q = params.toString();
+    return q ? `?${q}` : '';
+}
+function buildExpandAndSelect(_className, paths, _relationMap) {
+    if (!paths.length) {
+        return { expand: [], selectRoot: [] };
+    }
+    const rootSelect = new Set();
+    const expandParts = [];
+    const byRel = new Map();
+    for (const p of paths) {
+        const dot = p.indexOf('.');
+        if (dot === -1) {
+            rootSelect.add(p);
+            continue;
+        }
+        const rel = p.slice(0, dot);
+        const rest = p.slice(dot + 1);
+        if (!byRel.has(rel)) {
+            byRel.set(rel, new Set());
+        }
+        byRel.get(rel).add(rest);
+    }
+    for (const [rel, nested] of byRel) {
+        const nestedList = [...nested];
+        const inner = nestedList.length ? `($select=${nestedList.join(',')})` : '';
+        // Use navigation property name (4D / OData $expand), not the target class name.
+        expandParts.push(`${rel}${inner}`);
+        if (!rootSelect.has(rel)) {
+            rootSelect.add(rel);
+        }
+    }
+    return {
+        expand: expandParts,
+        selectRoot: [...rootSelect],
+    };
+}

package/dist/runtime/unwrap.d.ts

@@ -0,0 +1,4 @@
+/** Normalize 4D REST JSON (array or `{ ClassName: [...] }`). */
+export declare function unwrapEntityList<T>(className: string, body: unknown): T[];
+export declare function unwrapEntity<T>(className: string, body: unknown): T | null;
+//# sourceMappingURL=unwrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unwrap.d.ts","sourceRoot":"","sources":["../../src/runtime/unwrap.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,EAAE,CAiBzE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,CAW1E"}

package/dist/runtime/unwrap.js

@@ -0,0 +1,31 @@
+/** Normalize 4D REST JSON (array or `{ ClassName: [...] }`). */
+export function unwrapEntityList(className, body) {
+    if (Array.isArray(body)) {
+        return body;
+    }
+    if (body && typeof body === 'object' && className in body) {
+        const v = body[className];
+        if (Array.isArray(v)) {
+            return v;
+        }
+    }
+    if (body && typeof body === 'object' && '__ENTITIES' in body) {
+        const v = body.__ENTITIES;
+        if (Array.isArray(v)) {
+            return v;
+        }
+    }
+    return [];
+}
+export function unwrapEntity(className, body) {
+    if (body == null) {
+        return null;
+    }
+    if (Array.isArray(body)) {
+        return body[0] ?? null;
+    }
+    if (typeof body === 'object' && className in body) {
+        return body[className] ?? null;
+    }
+    return body;
+}

package/package.json

@@ -1,22 +1,29 @@
 {
   "name": "@quadrokit/client",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Typed 4D REST client and catalog code generator for QuadroKit",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "bin": {
-    "quadrokit-client": "./src/cli.ts"
+    "quadrokit-client": "./dist/cli.js"
   },
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "import": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./runtime": {
-      "types": "./src/runtime/index.ts",
-      "import": "./src/runtime/index.ts"
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
     }
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "generate:fixture": "bun run src/cli.ts generate --url file://../../assets/catalog.json --out ../../.quadrokit/generated-demo"
   },

package/src/cli.ts

@@ -1,82 +0,0 @@
-#!/usr/bin/env bun
-import { fileURLToPath } from 'node:url'
-import type { CatalogJson } from '@quadrokit/shared'
-import { writeGenerated } from './generate/codegen.js'
-
-function parseArgs(argv: string[]): {
-  command: string
-  url?: string
-  token?: string
-  out: string
-} {
-  let command = ''
-  let url: string | undefined
-  let token: string | undefined
-  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: string, token?: string): Promise<CatalogJson> {
-  if (url.startsWith('file:')) {
-    const path = fileURLToPath(url)
-    const file = Bun.file(path)
-    const text = await file.text()
-    return JSON.parse(text) as CatalogJson
-  }
-
-  const headers: Record<string, string> = {
-    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() as Promise<CatalogJson>
-}
-
-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)
-})