@ketvietlab/ketjs 0.1.1

package/dist/server/fn.js

@@ -0,0 +1,170 @@
+// The atom. One declaration yields an HTTP endpoint, a typed client method, a
+// manifest entry, an agent tool descriptor and a dry-runnable test handle.
+// Written once, never restated.
+import { createContext } from './ctx.js';
+import { createIdempotency } from './idem.js';
+import { KetError } from '../kernel/errors.js';
+import { project } from './project.js';
+import { isDateText, parseType } from '../kernel/types.js';
+import { queueFor } from './queue.js';
+const registry = new Map();
+export function defineFn(spec) {
+    if (typeof spec.handler !== 'function')
+        throw new KetError({ code: 'E_FN_NO_HANDLER', message: 'defineFn() requires a handler' });
+    return spec;
+}
+export function registerFunctions(modules) {
+    registry.clear();
+    for (const m of modules)
+        for (const [name, def] of Object.entries(m.functions))
+            registry.set(`${m.name}.${name}`, def);
+    return registry;
+}
+const JS_OF = {
+    id: 'string',
+    text: 'string',
+    ref: 'string',
+    int: 'number',
+    float: 'number',
+    bool: 'boolean',
+    date: 'string',
+    datetime: 'string',
+    json: 'object',
+};
+const DECIMAL = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)$/;
+export function validateInput(fnKey, manifest, args) {
+    const sig = manifest.functions[fnKey]?.input ?? {};
+    const errors = [];
+    for (const [name, tspec] of Object.entries(sig)) {
+        const t = parseType(tspec);
+        const v = args?.[name];
+        if (v == null) {
+            if (t.ok && !t.optional)
+                errors.push(`missing required input "${name}" (${tspec})`);
+            continue;
+        }
+        if (!t.ok)
+            continue;
+        const want = JS_OF[t.base];
+        if (want && typeof v !== want)
+            errors.push(`input "${name}" expects ${t.base} (${want}), got ${typeof v}`);
+        if (t.base === 'decimal' &&
+            !((typeof v === 'number' && Number.isFinite(v)) || (typeof v === 'string' && DECIMAL.test(v.trim()))))
+            errors.push(`input "${name}" expects a finite number or an exact decimal string`);
+        if (t.base === 'int' && typeof v === 'number' && !Number.isInteger(v))
+            errors.push(`input "${name}" expects an integer`);
+        if (t.base === 'date' && !isDateText(v))
+            errors.push(`input "${name}" expects a calendar date (YYYY-MM-DD)`);
+    }
+    for (const k of Object.keys(args ?? {})) {
+        if (!(k in sig))
+            errors.push(`unknown input "${k}" (accepted: ${Object.keys(sig).join(', ') || 'none'})`);
+    }
+    if (errors.length) {
+        throw new KetError({
+            code: 'E_INVALID_INPUT',
+            message: `${fnKey}: ${errors.join('; ')}`,
+            hint: `signature: ${JSON.stringify(sig)}`,
+        });
+    }
+}
+const stores = new WeakMap();
+const idemFor = (adapter) => {
+    let p = stores.get(adapter);
+    if (!p) {
+        p = createIdempotency(adapter);
+        stores.set(adapter, p);
+    }
+    return p;
+};
+export const _resetIdempotency = () => {
+    /* records are durable; nothing to clear */
+};
+export async function callFn(fnKey, args, o) {
+    const def = registry.get(fnKey);
+    const owner = fnKey.split('.')[0];
+    if (o.manifest.disabledModules?.includes(owner)) {
+        throw new KetError({
+            code: 'E_APP_NOT_INSTALLED',
+            module: owner,
+            message: `"${fnKey}" belongs to "${owner}", which is not installed on this database`,
+            hint: `install "${owner}" first — the code ships with this deployment, it is simply switched off here`,
+        });
+    }
+    if (!def)
+        throw new KetError({
+            code: 'E_UNKNOWN_FUNCTION',
+            message: `no server function "${fnKey}"`,
+            hint: `known: ${[...registry.keys()].join(', ')}`,
+        });
+    // Permission is checked before the input is validated, so a caller who may not
+    // call this at all learns that and nothing else — not which arguments it takes,
+    // and not whether the ones they guessed were right.
+    if (o.allow && !o.allow.includes(fnKey)) {
+        throw new KetError({
+            code: 'E_FN_NOT_PERMITTED',
+            module: owner,
+            message: `this caller may not call "${fnKey}"`,
+            hint: 'grant a role that includes it — `ket permissions --grant` shows what any set of functions reaches',
+        });
+    }
+    validateInput(fnKey, o.manifest, args);
+    const meta = o.manifest.functions[fnKey];
+    const dryRun = o.dryRun ?? false;
+    // Create system queue tables on the root adapter before user code can enter a
+    // transaction. Lazy DDL inside a rolled-back transaction would otherwise leave
+    // an in-memory "initialized" marker pointing at a table that no longer exists.
+    if (Object.keys(o.manifest.jobs).length)
+        await queueFor(o.adapter);
+    const idemKey = o.idempotencyKey ? `${fnKey}:${o.idempotencyKey}` : null;
+    let idem = null;
+    if (idemKey) {
+        if (!meta.idempotent) {
+            throw new KetError({
+                code: 'E_NOT_IDEMPOTENT',
+                message: `"${fnKey}" is not declared idempotent but was called with an idempotency key`,
+                hint: 'declare `idempotent: true` on the function, or drop the key',
+            });
+        }
+        idem = await idemFor(o.adapter);
+        // Claim the key before doing any work. Losing the race means another caller is
+        // either mid-flight or already finished, and both are answered from the record.
+        const claimed = await idem.claim(idemKey, fnKey);
+        if (!claimed) {
+            const existing = await idem.read(idemKey);
+            if (existing?.state === 'done')
+                return { ...existing.result, replayed: true };
+            throw new KetError({
+                code: 'E_IDEMPOTENCY_IN_FLIGHT',
+                message: `"${fnKey}" is already running with idempotency key "${o.idempotencyKey}"`,
+                hint: 'retry shortly; the first call has not finished yet',
+            });
+        }
+    }
+    if (dryRun && !meta.dryRun)
+        throw new KetError({ code: 'E_NO_DRY_RUN', message: `"${fnKey}" does not support dry-run` });
+    const ctx = createContext({
+        adapter: o.adapter,
+        manifest: o.manifest,
+        fnKey,
+        dryRun,
+        actor: o.actor ?? null,
+        scope: o.scope,
+        queueNotify: o.queueNotify,
+    });
+    let result;
+    try {
+        const value = project(fnKey, meta.output, await def.handler(ctx, args ?? {}));
+        result = { ok: true, value, writes: ctx.writes, dryRun };
+    }
+    catch (e) {
+        // A claim whose call then failed must not wedge the key forever.
+        if (idemKey && idem)
+            await idem.release(idemKey);
+        throw e;
+    }
+    if (idemKey && idem)
+        await idem.complete(idemKey, result);
+    return result;
+}
+//# sourceMappingURL=fn.js.map

package/dist/server/fn.js.map

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

package/dist/server/http.d.ts

@@ -0,0 +1,79 @@
+import type { RouteResult } from './respond.ts';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { StreamStore } from './stream.ts';
+import type { Adapter, Manifest, Scope } from '../types.ts';
+import type { AdapterPool } from '../data/pool.ts';
+import type { ThemeRuntime } from '../theme/render.ts';
+import type { RouteParams } from '../kernel/routes.ts';
+type HttpRoute = (url: URL, req: IncomingMessage, params: RouteParams) => Promise<RouteResult> | RouteResult;
+export type ServeOpts = {
+    manifest: Manifest;
+    /** A single database. Use `pool` + `resolveDatastore` for one database per tenant. */
+    adapter?: Adapter | null;
+    /** One database per tenant, resolved per request and leased from a bounded pool. */
+    pool?: AdapterPool;
+    /**
+     * Which database this request belongs to. Resolution happens exactly once, here,
+     * because ctx is the only thing that touches data — so a request cannot end up
+     * reading the wrong tenant by forgetting to pass something along.
+     */
+    resolveDatastore?: (url: URL, req: IncomingMessage) => string | null;
+    theme?: ThemeRuntime | ((url: URL, req: IncomingMessage) => Promise<ThemeRuntime | null>);
+    /** Browser modules for islands available to this request. */
+    islandClients?: ThemeRuntime['clients'] | ((url: URL, req: IncomingMessage) => Promise<ThemeRuntime['clients']>);
+    port?: number;
+    /** Defaults to a table on the app's adapter; swap for memory on a single instance. */
+    streamStore?: StreamStore;
+    /**
+     * Which language this request is in. Resolved in one place, like the datastore,
+     * so a handler cannot answer in the wrong one by forgetting to pass it along.
+     */
+    resolveLocale?: (url: URL, req: IncomingMessage) => string;
+    /**
+     * Which company and branches this request acts as. Resolved here for the same
+     * reason the datastore is: a handler that had to remember to pass it along would
+     * eventually forget, and forgetting means answering with another company's rows.
+     */
+    resolveScope?: (url: URL, req: IncomingMessage) => Scope | Promise<Scope>;
+    /** Authenticated user id captured into functions and any jobs they enqueue. */
+    resolveActor?: (url: URL, req: IncomingMessage) => string | null | Promise<string | null>;
+    /** Functions this request may call. Null means unrestricted — see boot.ts. */
+    resolveAllow?: (url: URL, req: IncomingMessage) => Promise<readonly string[] | null>;
+    /** Disable PostgreSQL notification while retaining polling correctness. */
+    queueNotify?: boolean;
+    /** Serve files from disk under a URL prefix. Meant for stylesheets during design. */
+    /** Static file mounts. One fixed directory, or a resolver that answers per request. */
+    assets?: AssetMount | AssetMount[];
+    /** Extra routes, matched before the theme takes the request. */
+    routes?: Record<string, HttpRoute>;
+    pageScope?: (url: URL, req: IncomingMessage) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    /** Theme region returned for progressive GET navigation. */
+    pageRegion?: string;
+};
+/**
+ * A mount is either a directory, or a function from the rest of the path to an
+ * absolute file — which is how a module's assets can stop being served the moment
+ * the module is uninstalled, without rebuilding the server.
+ */
+export type AssetMount = {
+    prefix: string;
+    dir?: string;
+    resolve?: (rest: string, url: URL, req: IncomingMessage) => Promise<string | null>;
+};
+export declare function createKetServer(o: ServeOpts): Promise<{
+    server: import("node:http").Server<typeof IncomingMessage, typeof ServerResponse>;
+    streams: {
+        store: StreamStore;
+        open(id: string): Promise<import("./stream.ts").Writer>;
+        since(id: string, fromSeq?: number): Promise<import("./stream.ts").Since>;
+        tail(id: string, fromSeq?: number, opt?: {
+            pollMs?: number;
+            timeoutMs?: number;
+        }): AsyncGenerator<import("./stream.ts").Chunk>;
+        sweep(olderThanMs?: number): Promise<number>;
+    };
+    listen(port?: number): Promise<number>;
+    close(): Promise<void>;
+}>;
+export {};
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/server/http.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAI/C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGtD,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAA;AAE5G,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,QAAQ,CAAA;IAClB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,oFAAoF;IACpF,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,CAAA;IACpE,KAAK,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAA;IACzF,6DAA6D;IAC7D,aAAa,CAAC,EACV,YAAY,CAAC,SAAS,CAAC,GACvB,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sFAAsF;IACtF,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,MAAM,CAAA;IAC1D;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACzE,+EAA+E;IAC/E,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACzF,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;IACpF,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qFAAqF;IACrF,uFAAuF;IACvF,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAA;IAClC,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAClC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1G,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CACnF,CAAA;AAyPD,wBAAsB,eAAe,CAAC,CAAC,EAAE,SAAS;;;;;;;;;;;;2BAmNf,OAAO,CAAC,MAAM,CAAC;aAKrC,OAAO,CAAC,IAAI,CAAC;GAIzB"}