callman-core 1.38.0 → 1.40.0

package/dist/mock-engine/data/record-codec.d.ts

@@ -0,0 +1,28 @@
+import type { MockRecordDoc, MockResource } from "../types.js";
+export declare const SEP = "\u001F";
+export type CodecError = {
+    field: string;
+    message: string;
+};
+export declare const canonicalKey: (value: unknown) => string | null;
+/** Canonical key for a path param / string lookup value, using the resource's id type. */
+export declare const keyFromParam: (resource: MockResource, raw: string, field?: string) => string;
+/** The JSON value a canonical key stands for. */
+export declare const valueFromKey: (key: string) => string | number;
+export declare const refToken: (field: string, key: string) => string;
+/** Build the store document for a record. Returns an error when a unique value is too long. */
+export declare const encodeRecord: (resource: MockResource, data: Record<string, unknown>, rev: number) => {
+    ok: true;
+    doc: MockRecordDoc;
+} | {
+    ok: false;
+    error: CodecError;
+};
+/**
+ * Reject keys MongoDB or the template engine cannot store safely: `$`-prefix,
+ * dots, control characters, prototype keys; bound depth and width.
+ */
+export declare const sanitizeRecordKeys: (value: unknown, path?: string, depth?: number) => CodecError | null;
+/** Hide write-only and password fields; apply `_fields` projection. */
+export declare const projectRecord: (resource: MockResource, data: Record<string, unknown>, fields?: string[]) => Record<string, unknown>;
+//# sourceMappingURL=record-codec.d.ts.map

package/dist/mock-engine/data/record-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-codec.d.ts","sourceRoot":"","sources":["../../../src/mock-engine/data/record-codec.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAa,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1E,eAAO,MAAM,GAAG,WAAW,CAAC;AAM5B,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAS5D,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,IAMtD,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,YAAY,GAAI,UAAU,YAAY,EAAE,KAAK,MAAM,EAAE,QAAQ,MAAM,KAAG,MAMlF,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,MAAsE,CAAC;AAY3H,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,MAAgC,CAAC;AAevF,+FAA+F;AAC/F,eAAO,MAAM,YAAY,GACvB,UAAU,YAAY,EACtB,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,MAAM,KACV;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAyBnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,EAAE,aAAS,EAAE,cAAS,KAAG,UAAU,GAAG,IAsBtF,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,aAAa,GAAI,UAAU,YAAY,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAS9H,CAAC"}

package/dist/mock-engine/data/record-codec.js

@@ -0,0 +1,155 @@
+// Record encoding shared by every store (MongoDB on the server, the file
+// store on the desktop, the in-memory store in previews and tests).
+//
+//   key   canonical id: integer ids → "n:5", everything else → "s:<value>"
+//   uniq  "#\u001f<key>" + "<field>\u001f<canonical value>" per unique field;
+//         one compound unique index over this array makes PK and unique
+//         fields atomic in MongoDB (a shared element = E11000)
+//   refs  "<field>\u001f<target key>" per ref field (nested lists, embed,
+//         cascade, FK checks)
+//   text  lower-cased string/number leaves for `q` (write-only fields skipped)
+import { byteLength, isForbiddenKey, isPlainObject } from "../util.js";
+export const SEP = "\u001f";
+const MAX_UNIQUE_VALUE_BYTES = 512;
+const MAX_TEXT_CHARS = 4_096;
+const MAX_DEPTH = 10;
+const MAX_KEYS_PER_OBJECT = 200;
+/** The id field's declared type decides how path params are read. */
+const idIsInteger = (resource) => {
+    if (resource.idStrategy === "incremental")
+        return true;
+    const field = resource.fields.find((f) => f.name === resource.idField);
+    return field?.type === "integer" || field?.type === "number";
+};
+export const canonicalKey = (value) => {
+    if (value === undefined || value === null || value === "")
+        return null;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? `n:${value}` : null;
+    if (typeof value === "boolean")
+        return `s:${String(value)}`;
+    if (typeof value === "string")
+        return `s:${value}`;
+    return null;
+};
+/** Canonical key for a path param / string lookup value, using the resource's id type. */
+export const keyFromParam = (resource, raw, field) => {
+    const targetField = field ?? resource.idField;
+    if (targetField === resource.idField && idIsInteger(resource) && /^-?\d+$/.test(raw))
+        return `n:${Number(raw)}`;
+    const declared = resource.fields.find((f) => f.name === targetField);
+    if ((declared?.type === "integer" || declared?.type === "number") && /^-?\d+(\.\d+)?$/.test(raw))
+        return `n:${Number(raw)}`;
+    return `s:${raw}`;
+};
+/** The JSON value a canonical key stands for. */
+export const valueFromKey = (key) => (key.startsWith("n:") ? Number(key.slice(2)) : key.slice(2));
+const canonicalUniqueValue = (field, value) => {
+    if (value === undefined || value === null)
+        return null;
+    let canon;
+    if (typeof value === "number")
+        canon = `n:${value}`;
+    else if (typeof value === "boolean")
+        canon = `b:${value}`;
+    else if (typeof value === "string")
+        canon = `s:${field.uniqueCaseInsensitive ? value.toLowerCase() : value}`;
+    else
+        canon = `j:${JSON.stringify(value)}`;
+    return byteLength(canon) > MAX_UNIQUE_VALUE_BYTES ? null : canon;
+};
+export const refToken = (field, key) => `${field}${SEP}${key}`;
+const collectText = (value, out, skip, depth) => {
+    if (depth > 4 || out.join(" ").length > MAX_TEXT_CHARS)
+        return;
+    if (typeof value === "string")
+        out.push(value.toLowerCase());
+    else if (typeof value === "number")
+        out.push(String(value));
+    else if (Array.isArray(value))
+        value.forEach((item) => collectText(item, out, skip, depth + 1));
+    else if (isPlainObject(value)) {
+        for (const [key, child] of Object.entries(value)) {
+            if (depth === 0 && skip.has(key))
+                continue;
+            collectText(child, out, skip, depth + 1);
+        }
+    }
+};
+/** Build the store document for a record. Returns an error when a unique value is too long. */
+export const encodeRecord = (resource, data, rev) => {
+    const key = canonicalKey(data[resource.idField]);
+    if (!key)
+        return { ok: false, error: { field: resource.idField, message: "is required" } };
+    const uniq = [`#${SEP}${key}`];
+    const refs = [];
+    const hidden = new Set();
+    for (const field of resource.fields) {
+        if (field.writeOnly || field.type === "password")
+            hidden.add(field.name);
+        const value = data[field.name];
+        if (field.unique && field.name !== resource.idField) {
+            if (value !== undefined && value !== null) {
+                const canon = canonicalUniqueValue(field, value);
+                if (canon === null)
+                    return { ok: false, error: { field: field.name, message: "is too long to be unique" } };
+                uniq.push(`${field.name}${SEP}${canon}`);
+            }
+        }
+        if (field.ref && value !== undefined && value !== null) {
+            const targetKey = canonicalKey(value);
+            if (targetKey)
+                refs.push(refToken(field.name, targetKey));
+        }
+    }
+    const textParts = [];
+    collectText(data, textParts, hidden, 0);
+    const text = textParts.join(" ").slice(0, MAX_TEXT_CHARS);
+    return { ok: true, doc: { resource: resource.resourceId, key, data, uniq, refs, text, rev } };
+};
+/**
+ * Reject keys MongoDB or the template engine cannot store safely: `$`-prefix,
+ * dots, control characters, prototype keys; bound depth and width.
+ */
+export const sanitizeRecordKeys = (value, path = "", depth = 0) => {
+    if (depth > MAX_DEPTH)
+        return { field: path || "(body)", message: "is nested too deeply" };
+    if (Array.isArray(value)) {
+        for (let i = 0; i < value.length; i += 1) {
+            const error = sanitizeRecordKeys(value[i], `${path}[${i}]`, depth + 1);
+            if (error)
+                return error;
+        }
+        return null;
+    }
+    if (!isPlainObject(value))
+        return null;
+    const keys = Object.keys(value);
+    if (keys.length > MAX_KEYS_PER_OBJECT)
+        return { field: path || "(body)", message: "has too many keys" };
+    for (const key of keys) {
+        const childPath = path ? `${path}.${key}` : key;
+        // eslint-disable-next-line no-control-regex
+        if (key.startsWith("$") || key.includes(".") || /[\u0000-\u001f]/.test(key) || isForbiddenKey(key)) {
+            return { field: childPath, message: "is not an allowed field name" };
+        }
+        const error = sanitizeRecordKeys(value[key], childPath, depth + 1);
+        if (error)
+            return error;
+    }
+    return null;
+};
+/** Hide write-only and password fields; apply `_fields` projection. */
+export const projectRecord = (resource, data, fields) => {
+    const hidden = new Set(resource.fields.filter((f) => f.writeOnly || f.type === "password").map((f) => f.name));
+    const out = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (hidden.has(key))
+            continue;
+        if (fields && fields.length > 0 && !fields.includes(key))
+            continue;
+        out[key] = value;
+    }
+    return out;
+};
+//# sourceMappingURL=record-codec.js.map

package/dist/mock-engine/data/record-codec.js.map

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

package/dist/mock-engine/data/resource-ops.d.ts

@@ -0,0 +1,53 @@
+import { type MockTemplateRuntime, type MockTemplateScope } from "../templates.js";
+import type { MockDataStore, MockDefinition, MockEngineContext, MockFilterNode, MockInvalidField, MockOutcome, MockRecordDoc, MockResource, MockStoreScope } from "../types.js";
+import { type RecordWriteMode } from "./validate-record.js";
+export interface DataRuntime {
+    definition: MockDefinition;
+    scope: MockStoreScope;
+    store: MockDataStore;
+    ctx: MockEngineContext;
+    tpl: MockTemplateRuntime;
+    /** Template scope of the current request (defaults like "{{auth.sub}}"). */
+    templateScope: MockTemplateScope;
+    /** Management writes may set read-only fields and skip owner scoping. */
+    management?: boolean;
+    /** Mount path for Location/Link headers ("/mock/<id>" or ""). */
+    mountPath: string;
+    /** Request URL path (for Link headers). */
+    requestPath: string;
+}
+export interface OpResult {
+    outcome: MockOutcome;
+    status: number;
+    body: unknown;
+    headers?: Record<string, string>;
+    /** Values added to the template scope for outcome overrides. */
+    scope: Partial<MockTemplateScope>;
+    affected: number;
+}
+export declare const resourceByName: (definition: MockDefinition, name: string) => MockResource | undefined;
+export declare const validationFailure: (invalidFields: MockInvalidField[]) => OpResult;
+export declare const notFoundResult: (resource: MockResource) => OpResult;
+/** Public shape of a record: write-only fields hidden. */
+export declare const presentRecord: (resource: MockResource, doc: MockRecordDoc, fields?: string[]) => Record<string, unknown>;
+/** Owner scoping filter for public requests on owner-scoped resources. */
+export declare const ownerFilter: (rt: DataRuntime, resource: MockResource) => MockFilterNode | undefined;
+/** Find one record by a lookup value (id or `lookupField`). */
+export declare const findByLookup: (rt: DataRuntime, resource: MockResource, rawValue: string, extra?: MockFilterNode) => Promise<MockRecordDoc | null>;
+/** Attach `_expand` parents and `_embed` children to presented records. */
+export declare const applyRelations: (rt: DataRuntime, resource: MockResource, docs: MockRecordDoc[], presented: Record<string, unknown>[], expand: string[], embed: string[]) => Promise<void>;
+/** Insert a record. `stamp` fields (owner, nested parent) override the body. */
+export declare const createRecord: (rt: DataRuntime, resource: MockResource, body: unknown, stamp?: Record<string, unknown>) => Promise<OpResult>;
+/** Replace (PUT) or patch (PATCH) an existing record. */
+export declare const writeRecord: (rt: DataRuntime, resource: MockResource, doc: MockRecordDoc, body: unknown, mode: Exclude<RecordWriteMode, "create">, stamp?: Record<string, unknown>) => Promise<OpResult>;
+/** Delete records (with relation handling). */
+export declare const deleteRecords: (rt: DataRuntime, resource: MockResource, docs: MockRecordDoc[]) => Promise<OpResult>;
+/** List records with the query language, envelope and headers. */
+export declare const listRecords: (rt: DataRuntime, resource: MockResource, rawQuery: Array<[string, string]>, extra?: MockFilterNode, overrides?: {
+    sort?: string;
+    limit?: number;
+    useRequestQuery?: boolean;
+}) => Promise<OpResult>;
+/** Get one record by lookup value, with `_expand`/`_embed`/`_fields`. */
+export declare const getRecord: (rt: DataRuntime, resource: MockResource, lookupValue: string, rawQuery: Array<[string, string]>, extra?: MockFilterNode) => Promise<OpResult>;
+//# sourceMappingURL=resource-ops.d.ts.map

package/dist/mock-engine/data/resource-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-ops.d.ts","sourceRoot":"","sources":["../../../src/mock-engine/data/resource-ops.ts"],"names":[],"mappings":"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"}