@krantho/api 0.0.0-stage → 1.0.1

package/dist/reference-resolver.js

@@ -0,0 +1,128 @@
+import { canGetContent, canQuery, hasRuntimeSchema, } from '@krantho/persistence';
+/** Extract reference fields from runtime schema for a collection */
+async function getReferenceFields(collection, adapter) {
+    if (!hasRuntimeSchema(adapter))
+        return [];
+    const schema = await adapter.getRuntimeSchema(collection);
+    if (!schema)
+        return [];
+    return schema.fields
+        .filter((f) => f.type === 'reference' && f.refCollection)
+        .map((f) => ({
+        name: f.name,
+        // Safe: the filter above guarantees f.refCollection is defined
+        refCollection: f.refCollection,
+        isArray: f.isArray ?? false,
+    }));
+}
+/**
+ * Resolve reference fields in a ContentDocument.
+ *
+ * Collects all reference field slugs, batch-loads them per collection,
+ * and replaces slug strings with full ContentDocument objects.
+ */
+export async function resolveReferences(doc, adapter) {
+    const refFields = await getReferenceFields(doc.meta.collection, adapter);
+    if (refFields.length === 0)
+        return doc;
+    // Collect slugs to resolve, grouped by target collection
+    const toResolve = new Map();
+    for (const field of refFields) {
+        const value = doc.fields[field.name];
+        if (!value || !field.refCollection)
+            continue;
+        if (!toResolve.has(field.refCollection)) {
+            toResolve.set(field.refCollection, new Set());
+        }
+        const slugs = toResolve.get(field.refCollection);
+        if (field.isArray && Array.isArray(value)) {
+            for (const slug of value) {
+                if (typeof slug === 'string')
+                    slugs.add(slug);
+            }
+        }
+        else if (typeof value === 'string') {
+            slugs.add(value);
+        }
+    }
+    if (toResolve.size === 0)
+        return doc;
+    // Batch load per collection
+    const resolved = new Map();
+    for (const [collection, slugs] of toResolve) {
+        if (!canGetContent(adapter))
+            continue;
+        for (const slug of slugs) {
+            const refDoc = await adapter.getContent(collection, slug);
+            if (refDoc)
+                resolved.set(`${collection}/${slug}`, refDoc);
+        }
+    }
+    if (resolved.size === 0)
+        return doc;
+    // Replace slug values with resolved documents
+    const resolvedFields = { ...doc.fields };
+    for (const field of refFields) {
+        const value = doc.fields[field.name];
+        if (!value || !field.refCollection)
+            continue;
+        if (field.isArray && Array.isArray(value)) {
+            resolvedFields[field.name] = value.map((slug) => {
+                if (typeof slug !== 'string')
+                    return slug;
+                return resolved.get(`${field.refCollection}/${slug}`) ?? slug;
+            });
+        }
+        else if (typeof value === 'string') {
+            const refDoc = resolved.get(`${field.refCollection}/${value}`);
+            if (refDoc)
+                resolvedFields[field.name] = refDoc;
+        }
+    }
+    return { ...doc, fields: resolvedFields };
+}
+/**
+ * Find all content items that reference a specific slug in a specific collection.
+ *
+ * Scans all collections for reference fields pointing to the target collection,
+ * then checks each item's field values.
+ */
+export async function findReferencingItems(targetCollection, targetSlug, adapter, contentConfig) {
+    const references = [];
+    for (const [, collectionDef] of contentConfig.collections) {
+        const refFields = await getReferenceFields(collectionDef.name, adapter);
+        const matching = refFields.filter((f) => f.refCollection === targetCollection);
+        if (matching.length === 0)
+            continue;
+        if (!canQuery(adapter))
+            continue;
+        const { items } = await adapter.query({
+            state: 'current',
+            projection: 'summary',
+            collections: [collectionDef.name],
+        });
+        for (const item of items) {
+            for (const field of matching) {
+                const value = item.fields[field.name];
+                if (field.isArray && Array.isArray(value)) {
+                    if (value.includes(targetSlug)) {
+                        references.push({
+                            collection: collectionDef.name,
+                            slug: item.meta.slug,
+                            field: field.name,
+                        });
+                    }
+                }
+                else if (value === targetSlug) {
+                    references.push({
+                        collection: collectionDef.name,
+                        slug: item.meta.slug,
+                        field: field.name,
+                    });
+                }
+            }
+        }
+    }
+    return references;
+}
+//# sourceMappingURL=reference-resolver.js.map

package/dist/reference-resolver.js.map

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

package/dist/return-to.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The path from `?returnTo=`, kept only when it is a same-origin path —
+ * anything that could leave the site (`//host`, `/\host`, a scheme, control
+ * characters) falls back to Studio.
+ */
+export declare function safeReturnTo(value: string | undefined): string;
+//# sourceMappingURL=return-to.d.ts.map

package/dist/return-to.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-to.d.ts","sourceRoot":"","sources":["../src/return-to.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM9D"}

package/dist/return-to.js

@@ -0,0 +1,15 @@
+/** Where the browser lands after a sign-in or refresh when the request names nowhere */
+const DEFAULT_RETURN_TO = '/studio/';
+/**
+ * The path from `?returnTo=`, kept only when it is a same-origin path —
+ * anything that could leave the site (`//host`, `/\host`, a scheme, control
+ * characters) falls back to Studio.
+ */
+export function safeReturnTo(value) {
+    if (!value?.startsWith('/') || value.startsWith('//') || value.startsWith('/\\')) {
+        return DEFAULT_RETURN_TO;
+    }
+    const hasControlCharacter = [...value].some((ch) => ch <= '\u001f' || ch === '\u007f');
+    return hasControlCharacter ? DEFAULT_RETURN_TO : value;
+}
+//# sourceMappingURL=return-to.js.map

package/dist/return-to.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-to.js","sourceRoot":"","sources":["../src/return-to.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,iBAAiB,GAAG,UAAU,CAAA;AAEpC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACjF,OAAO,iBAAiB,CAAA;IAC1B,CAAC;IACD,MAAM,mBAAmB,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAA;IACtF,OAAO,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAA;AACxD,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,14 @@
+import type { ApiContext, ApiHandler, ApiRequest, ApiResponse } from './types.js';
+export declare class ApiRouter {
+    private readonly routes;
+    /** Register a route */
+    add(method: string, pattern: string, handler: ApiHandler): void;
+    /** List all registered routes (for OpenAPI spec generation) */
+    listRoutes(): Array<{
+        method: string;
+        pattern: string;
+    }>;
+    /** Handle an incoming request */
+    handle(req: ApiRequest, ctx: ApiContext): Promise<ApiResponse>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AA2CjF,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IAErC,uBAAuB;IACvB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAK/D,+DAA+D;IAC/D,UAAU,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAIxD,iCAAiC;IAC3B,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CASrE"}

package/dist/router.js

@@ -0,0 +1,51 @@
+/** Parse a route pattern like '/api/content/:collection/:slug' into a regex */
+function compilePattern(pattern) {
+    const paramNames = [];
+    const regexStr = pattern.replace(/:(\w+)/g, (_, name) => {
+        paramNames.push(name);
+        return '([^/]+)';
+    });
+    return { regex: new RegExp(`^${regexStr}$`), paramNames };
+}
+/** Match a request path against a route and extract params */
+function matchRoute(req, routes) {
+    for (const route of routes) {
+        if (route.method !== req.method)
+            continue;
+        const match = route.regex.exec(req.path);
+        if (!match)
+            continue;
+        const params = { ...req.params };
+        for (let i = 0; i < route.paramNames.length; i++) {
+            const name = route.paramNames[i];
+            const value = match[i + 1];
+            if (name && value) {
+                params[name] = value;
+            }
+        }
+        return { route, params };
+    }
+    return undefined;
+}
+export class ApiRouter {
+    routes = [];
+    /** Register a route */
+    add(method, pattern, handler) {
+        const { regex, paramNames } = compilePattern(pattern);
+        this.routes.push({ method, pattern, paramNames, regex, handler });
+    }
+    /** List all registered routes (for OpenAPI spec generation) */
+    listRoutes() {
+        return this.routes.map((r) => ({ method: r.method, pattern: r.pattern }));
+    }
+    /** Handle an incoming request */
+    async handle(req, ctx) {
+        const matched = matchRoute(req, this.routes);
+        if (!matched) {
+            return { status: 404, body: { error: `No handler for ${req.method} ${req.path}` } };
+        }
+        const enrichedReq = { ...req, params: matched.params };
+        return matched.route.handler(enrichedReq, ctx);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAUA,+EAA+E;AAC/E,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;QACtD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrB,OAAO,SAAS,CAAA;IAClB,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,UAAU,EAAE,CAAA;AAC3D,CAAC;AAED,8DAA8D;AAC9D,SAAS,UAAU,CACjB,GAAe,EACf,MAAwB;IAExB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;YAAE,SAAQ;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACxC,IAAI,CAAC,KAAK;YAAE,SAAQ;QAEpB,MAAM,MAAM,GAA2B,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAA;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YAC1B,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;YACtB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAC1B,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,OAAO,SAAS;IACH,MAAM,GAAY,EAAE,CAAA;IAErC,uBAAuB;IACvB,GAAG,CAAC,MAAc,EAAE,OAAe,EAAE,OAAmB;QACtD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,+DAA+D;IAC/D,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,MAAM,CAAC,GAAe,EAAE,GAAe;QAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,kBAAkB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,CAAA;QACrF,CAAC;QAED,MAAM,WAAW,GAAe,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAA;QAClE,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IAChD,CAAC;CACF"}

package/dist/runtime-field-checks.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeFieldDefinition } from '@krantho/persistence';
+/** Whether a value sent as an enum's values is a list of text */
+export declare function isTextList(value: unknown): value is string[];
+/**
+ * Why a runtime field definition cannot be saved, or null when it can. The
+ * merged schema is built from these definitions, so one that does not hold —
+ * a pattern that does not compile, an enum the schema would turn into plain
+ * text — would break every save in its collection.
+ */
+export declare function runtimeFieldError(field: RuntimeFieldDefinition, collections: ReadonlySet<string>): string | null;
+//# sourceMappingURL=runtime-field-checks.d.ts.map

package/dist/runtime-field-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-field-checks.d.ts","sourceRoot":"","sources":["../src/runtime-field-checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAsBlE,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAE5D;AAiCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,EAC7B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,MAAM,GAAG,IAAI,CAWf"}

package/dist/runtime-field-checks.js

@@ -0,0 +1,72 @@
+/** A runtime field's name: a letter, then letters, digits, hyphens and underscores */
+const FIELD_NAME = /^[a-z][a-z0-9_-]*$/i;
+/** Why the default does not fit the field's type, or null */
+function defaultError(field) {
+    const value = field.default;
+    if (value === undefined)
+        return null;
+    if (field.type === 'number') {
+        return typeof value === 'number' && Number.isFinite(value) ? null : 'The default is a number.';
+    }
+    if (field.type === 'boolean') {
+        return typeof value === 'boolean' ? null : 'The default is true or false.';
+    }
+    if (typeof value !== 'string')
+        return 'The default is text.';
+    if (field.type === 'enum' && !field.enumValues?.includes(value)) {
+        return 'The default is one of the values.';
+    }
+    return null;
+}
+/** Whether a value sent as an enum's values is a list of text */
+export function isTextList(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+/**
+ * Why the enum's values do not hold, or null: the schema makes an enum of two
+ * different values or more, and with fewer the field would take any text
+ */
+function enumError({ type, enumValues }) {
+    if (type !== 'enum')
+        return null;
+    return new Set(enumValues).size < 2 ? 'An enum has two different values or more.' : null;
+}
+/** Why the bounds do not hold, or null */
+function boundsError({ min, max }) {
+    if ([min, max].some((bound) => bound !== undefined && !Number.isFinite(bound))) {
+        return 'Minimum and maximum are numbers.';
+    }
+    if (min !== undefined && max !== undefined && min > max) {
+        return 'The minimum is not above the maximum.';
+    }
+    return null;
+}
+/** Why the pattern is not a regular expression, or null */
+function patternError({ pattern }) {
+    if (pattern === undefined)
+        return null;
+    try {
+        new RegExp(pattern);
+        return null;
+    }
+    catch {
+        return 'The pattern is not a valid regular expression.';
+    }
+}
+/**
+ * Why a runtime field definition cannot be saved, or null when it can. The
+ * merged schema is built from these definitions, so one that does not hold —
+ * a pattern that does not compile, an enum the schema would turn into plain
+ * text — would break every save in its collection.
+ */
+export function runtimeFieldError(field, collections) {
+    if (!FIELD_NAME.test(field.name)) {
+        return 'A name starts with a letter and holds only letters, digits, hyphens and underscores.';
+    }
+    if (field.type === 'reference' &&
+        !(field.refCollection && collections.has(field.refCollection))) {
+        return 'A reference field names the collection it refers to.';
+    }
+    return enumError(field) ?? boundsError(field) ?? patternError(field) ?? defaultError(field);
+}
+//# sourceMappingURL=runtime-field-checks.js.map

package/dist/runtime-field-checks.js.map

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

package/dist/save-document.d.ts

@@ -0,0 +1,71 @@
+import type { ContentChange } from '@krantho/core';
+import { type ContentDocument, type DefaultProvenance } from '@krantho/persistence';
+import { type Collection } from '@krantho/schema';
+import type { ZodObject, ZodRawShape } from 'zod';
+import type { ApiContext, ApiResponse } from './types.js';
+/** One document save, as the REST create/update handlers and the assistant make it */
+export interface SaveDocumentInput {
+    collection: string;
+    slug: string;
+    fields: Record<string, unknown>;
+    /** A string replaces the body; undefined keeps the current body (existing documents only) */
+    body: string | undefined;
+    locale: string | undefined;
+    isNew: boolean;
+    /** Reject with 409 when the current version differs */
+    expectedVersion?: number | undefined;
+    changedBy: string;
+    repositoryBasis?: ContentDocument['repositoryBasis'] | undefined;
+    metadata?: unknown;
+    defaults?: readonly DefaultProvenance[] | undefined;
+}
+/** A committed save: the document's version after it and its live version (null when nothing is live) */
+export type SaveDocumentResult = {
+    ok: true;
+    slug: string;
+    version: number;
+    liveVersion: number | null;
+} | {
+    ok: false;
+    response: ApiResponse;
+};
+type PreparedFields = {
+    ok: true;
+    fields: Record<string, unknown>;
+} | {
+    ok: false;
+    response: ApiResponse;
+};
+/**
+ * Validate a document's values against the collection's active contract, as
+ * `saveDocument` does: a draft prepared ahead of its save (the assistant's)
+ * passes or fails exactly as the save will.
+ */
+export declare function prepareFields(ctx: ApiContext, collectionDef: Collection<ZodObject<ZodRawShape>>, values: {
+    fields: Record<string, unknown>;
+    body: string;
+    metadata: ContentDocument['metadata'];
+}): Promise<PreparedFields>;
+/**
+ * The change a committed save announces: visitors see it only when the saved
+ * version is live — never on an adapter with history, where a save keeps the
+ * live version; at once on one without (the filesystem adapter).
+ */
+export declare function savedChange(ctx: ApiContext, target: {
+    collection: string;
+    slug: string;
+    locale: string | undefined;
+}): Promise<ContentChange & {
+    version: number;
+    liveVersion: number | null;
+}>;
+/**
+ * Save one document as a new version: role, collection, edit lock,
+ * concurrency, the before-save hook, the active contract, the write, then the
+ * webhook, the after-hook and the change announcement. A save never changes
+ * what visitors see — publishing does (`changePublication`). The single write
+ * path of the REST handlers and the assistant.
+ */
+export declare function saveDocument(ctx: ApiContext, input: SaveDocumentInput): Promise<SaveDocumentResult>;
+export {};
+//# sourceMappingURL=save-document.d.ts.map

package/dist/save-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-document.d.ts","sourceRoot":"","sources":["../src/save-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAEL,KAAK,eAAe,EAMpB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,KAAK,UAAU,EAA6C,MAAM,iBAAiB,CAAA;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAA;AAMjD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGzD,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,6FAA6F;IAC7F,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAA;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAA;CACpD;AAED,yGAAyG;AACzG,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAA;AAExC,KAAK,cAAc,GACf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAA;AAExC;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,aAAa,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,EACjD,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;CAAE,GAC/F,OAAO,CAAC,cAAc,CAAC,CAYzB;AAmBD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,UAAU,EACf,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvE,OAAO,CAAC,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAe1E;AA2JD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA+B7B"}

package/dist/save-document.js

@@ -0,0 +1,213 @@
+import { ContentWriteConflict, canGetContent, canWriteContent, currentIsLive, } from '@krantho/persistence';
+import { retainDefaultProvenance, validateDocument } from '@krantho/schema';
+import { announceChange } from './content-change.js';
+import { lockedByOther } from './content-locks.js';
+import { runAfterHook, runBeforeSave } from './hooks.js';
+import { getActiveContract } from './merged-schema.js';
+import { requireRole } from './permissions.js';
+import { formatZodErrors } from './validators.js';
+/**
+ * Validate a document's values against the collection's active contract, as
+ * `saveDocument` does: a draft prepared ahead of its save (the assistant's)
+ * passes or fails exactly as the save will.
+ */
+export async function prepareFields(ctx, collectionDef, values) {
+    const contract = await getActiveContract(collectionDef, ctx.adapter);
+    const validation = validateDocument(contract, values);
+    if (!validation.success)
+        return {
+            ok: false,
+            response: {
+                status: 422,
+                body: { error: 'Validation failed', details: formatZodErrors(validation.error.issues) },
+            },
+        };
+    return { ok: true, fields: validation.data.fields };
+}
+/** Optimistic concurrency: 409 when the current version is not the expected one */
+function versionConflict(input, current) {
+    if (input.expectedVersion === undefined)
+        return null;
+    if ((current?.meta.version ?? 0) === input.expectedVersion)
+        return null;
+    return {
+        status: 409,
+        body: {
+            error: 'Content has been modified by another user',
+            currentVersion: current?.meta.version ?? 0,
+            yourVersion: input.expectedVersion,
+        },
+    };
+}
+/**
+ * The change a committed save announces: visitors see it only when the saved
+ * version is live — never on an adapter with history, where a save keeps the
+ * live version; at once on one without (the filesystem adapter).
+ */
+export async function savedChange(ctx, target) {
+    const saved = canGetContent(ctx.adapter)
+        ? await ctx.adapter.getContent(target.collection, target.slug, target.locale)
+        : null;
+    const version = saved?.meta.version ?? 0;
+    const liveVersion = saved?.meta.liveVersion ?? null;
+    return {
+        kind: 'document',
+        collection: target.collection,
+        slug: target.slug,
+        locale: target.locale,
+        live: currentIsLive({ version, liveVersion }),
+        version,
+        liveVersion,
+    };
+}
+/** Write the prepared save as a new version: a save keeps the live version */
+async function writeDocument(adapter, input, slug, fields, body, contract, metadata, current) {
+    await adapter.writeContent({
+        collection: input.collection,
+        slug,
+        fields,
+        body,
+        locale: input.locale,
+        contract,
+        metadata,
+        repositoryBasis: input.repositoryBasis ?? current?.repositoryBasis ?? null,
+        defaults: retainDefaultProvenance(input.defaults ?? current?.defaults ?? [], metadata),
+        expectedVersion: input.isNew ? 0 : (input.expectedVersion ?? current?.meta.version),
+    }, input.changedBy);
+}
+/** Webhook, after-hook and change announcement of a committed save */
+async function afterSave(ctx, input, slug) {
+    const { collection, locale } = input;
+    ctx.fireWebhook?.(input.isNew ? 'create' : 'update', collection, slug);
+    const hook = input.isNew ? ctx.contentHooks?.afterCreate : ctx.contentHooks?.afterUpdate;
+    await runAfterHook(hook, { collection, slug });
+    const { version, liveVersion, ...change } = await savedChange(ctx, { collection, slug, locale });
+    await announceChange(ctx, change);
+    return { version, liveVersion };
+}
+/** The document as it stands before a save, or null for a new one */
+async function currentDocument(ctx, input) {
+    if (input.isNew || !canGetContent(ctx.adapter))
+        return null;
+    const current = await ctx.adapter.getContent(input.collection, input.slug, input.locale);
+    const locale = input.locale ?? ctx.config.site.defaultLocale;
+    return current?.meta.locale === locale ? current : null;
+}
+/**
+ * 409 when a create names a document that already exists: a create never
+ * writes over one, so another user's lock and version are never passed by.
+ * Read where the write would land — the same collection, slug and locale.
+ * This early check provides a readable error; the adapter atomically rejects
+ * a concurrent create through expectedVersion zero.
+ */
+async function alreadyExists(ctx, input, slug) {
+    if (!canGetContent(ctx.adapter))
+        return null;
+    const existing = await ctx.adapter.getContent(input.collection, slug, input.locale);
+    if (!existing || existing.meta.locale !== (input.locale ?? ctx.config.site.defaultLocale))
+        return null;
+    const error = `"${input.collection}/${slug}" already exists. Open it and save it instead.`;
+    return { status: 409, body: { error } };
+}
+const fail = (status, error) => ({
+    ok: false,
+    response: { status, body: { error } },
+});
+/** Role, collection, adapter, edit lock, version and existence, checked before anything runs */
+async function admitSave(ctx, input) {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return { ok: false, response: denied };
+    const collectionDef = ctx.contentConfig.collections.get(input.collection);
+    if (!collectionDef)
+        return fail(404, `Collection "${input.collection}" not found`);
+    if (!canWriteContent(ctx.adapter))
+        return fail(501, 'Adapter does not support writeContent');
+    // Locks are checked when the request arrives; a lock taken after this point
+    // does not stop the write, and `expectedVersion` still catches the conflict
+    const locked = input.isNew ? null : await lockedByOther(ctx, input);
+    if (locked)
+        return { ok: false, response: locked };
+    const current = await currentDocument(ctx, input);
+    const conflict = versionConflict(input, current);
+    if (conflict)
+        return { ok: false, response: conflict };
+    if (!input.isNew && input.body === undefined && !canGetContent(ctx.adapter))
+        return fail(501, 'Adapter cannot read a document, so a save must send its body');
+    if (!input.isNew && canGetContent(ctx.adapter) && !current)
+        return fail(404, `Content "${input.collection}/${input.slug}" not found`);
+    return { ok: true, value: { collectionDef, writer: ctx.adapter, current } };
+}
+/** Metadata as the request sends it: an object of groups, each an object of properties */
+function isMetadata(value) {
+    const isRecord = (entry) => entry !== null && typeof entry === 'object' && !Array.isArray(entry);
+    return isRecord(value) && Object.values(value).every(isRecord);
+}
+/** The before-save hook's view of the save: a save without a body merges the fields it names */
+function hookInput(input, metadata, current) {
+    return {
+        collection: input.collection,
+        slug: input.slug,
+        fields: input.body === undefined && current ? { ...current.fields, ...input.fields } : input.fields,
+        body: input.body ?? current?.body ?? '',
+        metadata,
+        isNew: input.isNew,
+    };
+}
+/** The adapter's conflict as the 409 a client reloads on */
+function writeConflict(error) {
+    return {
+        ok: false,
+        response: {
+            status: 409,
+            body: {
+                error: error.message,
+                currentVersion: error.currentVersion,
+                yourVersion: error.expectedVersion,
+            },
+        },
+    };
+}
+/**
+ * Save one document as a new version: role, collection, edit lock,
+ * concurrency, the before-save hook, the active contract, the write, then the
+ * webhook, the after-hook and the change announcement. A save never changes
+ * what visitors see — publishing does (`changePublication`). The single write
+ * path of the REST handlers and the assistant.
+ */
+export async function saveDocument(ctx, input) {
+    const admitted = await admitSave(ctx, input);
+    if (!admitted.ok)
+        return admitted;
+    const { collectionDef, writer, current } = admitted.value;
+    // The hook sees metadata of the right shape; the contract checks its groups after it
+    const sent = input.metadata === undefined ? (current?.metadata ?? {}) : input.metadata;
+    if (!isMetadata(sent))
+        return fail(422, 'Metadata must be an object of named groups');
+    const hooked = await runBeforeSave(ctx.contentHooks, hookInput(input, sent, current));
+    const slug = input.isNew ? hooked.slug : input.slug;
+    const exists = input.isNew ? await alreadyExists(ctx, input, slug) : null;
+    if (exists)
+        return { ok: false, response: exists };
+    const contract = await getActiveContract(collectionDef, ctx.adapter);
+    const parsed = validateDocument(contract, {
+        fields: hooked.fields,
+        body: hooked.body,
+        metadata: hooked.metadata,
+    });
+    if (!parsed.success) {
+        const details = formatZodErrors(parsed.error.issues);
+        return { ok: false, response: { status: 422, body: { error: 'Validation failed', details } } };
+    }
+    const { fields, body, metadata } = parsed.data;
+    try {
+        await writeDocument(writer, input, slug, fields, body, contract, metadata, current);
+    }
+    catch (error) {
+        if (error instanceof ContentWriteConflict)
+            return writeConflict(error);
+        throw error;
+    }
+    return { ok: true, slug, ...(await afterSave(ctx, input, slug)) };
+}
+//# sourceMappingURL=save-document.js.map

package/dist/save-document.js.map

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