@krantho/api 0.0.0-stage → 1.0.0

package/dist/handlers/export-bundle.js.map

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

package/dist/handlers/export-content.d.ts

@@ -0,0 +1,7 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * GET /api/content/:collection/export?format=json|markdown&locale=en&state=current|published —
+ * export a collection. The published state is public; the current state, with its drafts, needs an editor.
+ */
+export declare const exportContent: ApiHandler;
+//# sourceMappingURL=export-content.d.ts.map

package/dist/handlers/export-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-content.d.ts","sourceRoot":"","sources":["../../src/handlers/export-content.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,UA+D3B,CAAA"}

package/dist/handlers/export-content.js

@@ -0,0 +1,69 @@
+import { canQuery, repositoryDocument, repositoryMarkdown } from '@krantho/persistence';
+import { documentChecksum } from '@krantho/schema';
+import { requireRole } from '../permissions.js';
+import { parseLocaleParam, validateCollectionParam } from '../validators.js';
+/**
+ * GET /api/content/:collection/export?format=json|markdown&locale=en&state=current|published —
+ * export a collection. The published state is public; the current state, with its drafts, needs an editor.
+ */
+export const exportContent = async (req, ctx) => {
+    const validated = validateCollectionParam(req.params['collection'], ctx);
+    if (!validated.isValid)
+        return validated.response;
+    if (!canQuery(ctx.adapter)) {
+        return { status: 501, body: { error: 'Adapter does not support query' } };
+    }
+    const format = req.query['format'] === 'markdown' ? 'markdown' : 'json';
+    const locale = parseLocaleParam(req.query['locale']);
+    const state = req.query['state'] ?? 'current';
+    if (state !== 'current' && state !== 'published')
+        return { status: 400, body: { error: 'State must be current or published' } };
+    // The current state holds drafts: published content is what visitors read, drafts are for editors
+    if (state === 'current') {
+        const denied = requireRole(ctx.auth, 'editor');
+        if (denied)
+            return denied;
+    }
+    const { items } = await ctx.adapter.query({
+        state,
+        projection: 'full',
+        collections: [validated.collection],
+        locale,
+    });
+    const exported = items.map((item) => repositoryDocument(item, documentChecksum(item)));
+    if (format === 'markdown') {
+        if (new Set(exported.map((item) => item.identity.slug)).size !== exported.length) {
+            return {
+                status: 409,
+                body: {
+                    error: 'Markdown filenames would collide across locales. Export one locale at a time, or use JSON.',
+                },
+            };
+        }
+        const files = [];
+        for (const item of exported) {
+            files.push({ slug: item.identity.slug, content: repositoryMarkdown(item) });
+        }
+        return {
+            status: 200,
+            body: {
+                collection: validated.collection,
+                format: 'markdown',
+                state,
+                count: files.length,
+                files,
+            },
+        };
+    }
+    return {
+        status: 200,
+        body: {
+            collection: validated.collection,
+            format: 'json',
+            state,
+            count: exported.length,
+            items: exported,
+        },
+    };
+};
+//# sourceMappingURL=export-content.js.map

package/dist/handlers/export-content.js.map

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

package/dist/handlers/export-schema.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** Export the complete code and runtime contract for reviewed code adoption. */
+export declare const exportSchema: ApiHandler;
+//# sourceMappingURL=export-schema.d.ts.map

package/dist/handlers/export-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-schema.d.ts","sourceRoot":"","sources":["../../src/handlers/export-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,gFAAgF;AAChF,eAAO,MAAM,YAAY,EAAE,UAM1B,CAAA"}

package/dist/handlers/export-schema.js

@@ -0,0 +1,13 @@
+import { exportContractAsZod } from '@krantho/schema';
+import { getActiveContract } from '../merged-schema.js';
+import { validateCollectionParam } from '../validators.js';
+/** Export the complete code and runtime contract for reviewed code adoption. */
+export const exportSchema = async (req, ctx) => {
+    const checked = validateCollectionParam(req.params['collection'], ctx);
+    if (!checked.isValid)
+        return checked.response;
+    const contract = await getActiveContract(checked.collectionDef, ctx.adapter);
+    const code = exportContractAsZod(checked.collectionDef, contract);
+    return { status: 200, body: { collection: checked.collection, contract, code } };
+};
+//# sourceMappingURL=export-schema.js.map

package/dist/handlers/export-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-schema.js","sourceRoot":"","sources":["../../src/handlers/export-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACzD,MAAM,OAAO,GAAG,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAA;IACtE,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAA;IAC7C,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5E,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;IACjE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAA;AAClF,CAAC,CAAA"}

package/dist/handlers/get-content.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/content/:collection/:slug — single content item */
+export declare const getContent: ApiHandler;
+//# sourceMappingURL=get-content.d.ts.map

package/dist/handlers/get-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-content.d.ts","sourceRoot":"","sources":["../../src/handlers/get-content.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,+DAA+D;AAC/D,eAAO,MAAM,UAAU,EAAE,UAqExB,CAAA"}

package/dist/handlers/get-content.js

@@ -0,0 +1,65 @@
+import { canGetContent } from '@krantho/persistence';
+import { getContentWithFallback } from '../locale-fallback.js';
+import { resolveReferences } from '../reference-resolver.js';
+import { parseLocaleParam, requireParam, validateCollectionParam } from '../validators.js';
+/** GET /api/content/:collection/:slug — single content item */
+export const getContent = async (req, ctx) => {
+    const validated = validateCollectionParam(req.params['collection'], ctx);
+    if (!validated.isValid)
+        return validated.response;
+    const slugResult = requireParam(req.params, 'slug');
+    if (!slugResult.isValid)
+        return slugResult.response;
+    const slug = slugResult.value;
+    const locale = parseLocaleParam(req.query['locale']);
+    // Prefer adapter.getContent (returns ContentDocument) over engine.loadContent
+    if (canGetContent(ctx.adapter)) {
+        // Use locale fallback when a locale is requested
+        const doc = locale
+            ? await getContentWithFallback(ctx.adapter, validated.collection, slug, locale, ctx.config.site)
+            : await ctx.adapter.getContent(validated.collection, slug);
+        if (!doc) {
+            return {
+                status: 404,
+                body: { error: `Content "${slug}" not found in "${validated.collection}"` },
+            };
+        }
+        // Resolve references if requested
+        if (req.query['resolve'] === 'true') {
+            const resolved = await resolveReferences(doc, ctx.adapter);
+            return { status: 200, body: resolved };
+        }
+        return { status: 200, body: doc };
+    }
+    // Fallback to engine.loadContent for adapters without getContent.
+    // Note: IContentEngine.loadContent does not accept a collection parameter,
+    // so this fallback cannot scope the lookup to the validated collection.
+    const result = await ctx.engine.loadContent(slug);
+    if (result.error) {
+        return {
+            status: 404,
+            body: { error: `Content "${slug}" not found in "${validated.collection}"` },
+        };
+    }
+    const statusValue = result.fields['status'];
+    return {
+        status: 200,
+        body: {
+            meta: {
+                collection: validated.collection,
+                slug,
+                locale: ctx.config.site.defaultLocale,
+                version: 1,
+                status: typeof statusValue === 'string' ? statusValue : 'draft',
+                source: 'file',
+                changedBy: null,
+                createdAt: result.metadata.lastModified.toISOString(),
+            },
+            fields: result.fields,
+            body: result.content,
+            html: result.html,
+            sections: result.sections,
+        },
+    };
+};
+//# sourceMappingURL=get-content.js.map

package/dist/handlers/get-content.js.map

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

package/dist/handlers/get-runtime-schema.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/schema/:collection/runtime — runtime field extensions */
+export declare const getRuntimeSchema: ApiHandler;
+//# sourceMappingURL=get-runtime-schema.d.ts.map

package/dist/handlers/get-runtime-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-runtime-schema.d.ts","sourceRoot":"","sources":["../../src/handlers/get-runtime-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,EAAE,UAa9B,CAAA"}

package/dist/handlers/get-runtime-schema.js

@@ -0,0 +1,17 @@
+import { hasRuntimeSchema } from '@krantho/persistence';
+import { validateCollectionParam } from '../validators.js';
+/** GET /api/schema/:collection/runtime — runtime field extensions */
+export const getRuntimeSchema = async (req, ctx) => {
+    const validated = validateCollectionParam(req.params['collection'], ctx);
+    if (!validated.isValid)
+        return validated.response;
+    if (!hasRuntimeSchema(ctx.adapter)) {
+        return { status: 200, body: { collection: validated.collection, fields: [] } };
+    }
+    const schema = await ctx.adapter.getRuntimeSchema(validated.collection);
+    return {
+        status: 200,
+        body: schema ?? { collection: validated.collection, fields: [], updatedAt: null },
+    };
+};
+//# sourceMappingURL=get-runtime-schema.js.map

package/dist/handlers/get-runtime-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-runtime-schema.js","sourceRoot":"","sources":["../../src/handlers/get-runtime-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC7D,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAA;IACxE,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAA;IAEjD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAA;IAChF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACvE,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;KAClF,CAAA;AACH,CAAC,CAAA"}

package/dist/handlers/get-schema.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/schema/:collection — JSON Schema for a collection's fields (code + runtime) */
+export declare const getSchema: ApiHandler;
+//# sourceMappingURL=get-schema.d.ts.map

package/dist/handlers/get-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/handlers/get-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,2FAA2F;AAC3F,eAAO,MAAM,SAAS,EAAE,UAgCvB,CAAA"}

package/dist/handlers/get-schema.js

@@ -0,0 +1,87 @@
+import { collectionToJsonSchema } from '@krantho/schema';
+import { getActiveContract } from '../merged-schema.js';
+import { validateCollectionParam } from '../validators.js';
+/** GET /api/schema/:collection — JSON Schema for a collection's fields (code + runtime) */
+export const getSchema = async (req, ctx) => {
+    const validated = validateCollectionParam(req.params['collection'], ctx);
+    if (!validated.isValid)
+        return validated.response;
+    const jsonSchema = collectionToJsonSchema(validated.collectionDef);
+    // Merge runtime fields into the JSON Schema response
+    if (ctx.adapter.getRuntimeSchema) {
+        const runtimeSchema = await ctx.adapter.getRuntimeSchema(validated.collection);
+        if (runtimeSchema && runtimeSchema.fields.length > 0) {
+            const schema = jsonSchema.schema;
+            const properties = { ...(schema.properties ?? {}) };
+            const required = [...(schema.required ?? [])];
+            const codeFieldNames = new Set(Object.keys(schema.properties ?? {}));
+            for (const field of runtimeSchema.fields) {
+                if (codeFieldNames.has(field.name))
+                    continue;
+                properties[field.name] = runtimeFieldToJsonSchema(field);
+                if (field.required) {
+                    required.push(field.name);
+                }
+            }
+            jsonSchema.schema = { ...schema, properties, required };
+        }
+    }
+    const contract = await getActiveContract(validated.collectionDef, ctx.adapter);
+    return { status: 200, body: { ...jsonSchema, contract } };
+};
+function runtimeFieldToJsonSchema(field) {
+    const prop = { _runtime: true };
+    switch (field.type) {
+        case 'string':
+        case 'textarea':
+        case 'date':
+        case 'color':
+        case 'reference':
+            prop['type'] = 'string';
+            break;
+        case 'number':
+            prop['type'] = 'number';
+            break;
+        case 'boolean':
+            prop['type'] = 'boolean';
+            break;
+        case 'url':
+            prop['type'] = 'string';
+            prop['format'] = 'uri';
+            break;
+        case 'email':
+            prop['type'] = 'string';
+            prop['format'] = 'email';
+            break;
+        case 'enum':
+            prop['type'] = 'string';
+            if (field.enumValues)
+                prop['enum'] = field.enumValues;
+            break;
+    }
+    if (field.isArray)
+        return {
+            type: 'array',
+            items: {
+                ...prop,
+                ...(field.refCollection ? { description: `ref:${field.refCollection}` } : {}),
+            },
+            _runtime: true,
+        };
+    if (field.default !== undefined)
+        prop['default'] = field.default;
+    if (field.description)
+        prop['description'] = field.description;
+    if (field.min !== undefined) {
+        prop[field.type === 'number' ? 'minimum' : 'minLength'] = field.min;
+    }
+    if (field.max !== undefined) {
+        prop[field.type === 'number' ? 'maximum' : 'maxLength'] = field.max;
+    }
+    if (field.pattern)
+        prop['pattern'] = field.pattern;
+    if (field.refCollection)
+        prop['description'] = `ref:${field.refCollection}`;
+    return prop;
+}
+//# sourceMappingURL=get-schema.js.map

package/dist/handlers/get-schema.js.map

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

package/dist/handlers/get-version.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/content/:collection/:slug/versions/:version — get specific version */
+export declare const getVersion: ApiHandler;
+//# sourceMappingURL=get-version.d.ts.map

package/dist/handlers/get-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-version.d.ts","sourceRoot":"","sources":["../../src/handlers/get-version.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAQ7C,kFAAkF;AAClF,eAAO,MAAM,UAAU,EAAE,UAyBxB,CAAA"}

package/dist/handlers/get-version.js

@@ -0,0 +1,26 @@
+import { hasVersioning } from '@krantho/persistence';
+import { parseLocaleParam, parsePositiveInt, requireParam, validateCollectionParam, } from '../validators.js';
+/** GET /api/content/:collection/:slug/versions/:version — get specific version */
+export const getVersion = async (req, ctx) => {
+    const validated = validateCollectionParam(req.params['collection'], ctx);
+    if (!validated.isValid)
+        return validated.response;
+    const slugResult = requireParam(req.params, 'slug');
+    if (!slugResult.isValid)
+        return slugResult.response;
+    const slug = slugResult.value;
+    const version = parsePositiveInt(req.params['version']);
+    if (version === undefined || version < 1) {
+        return { status: 400, body: { error: 'Invalid version number' } };
+    }
+    if (!hasVersioning(ctx.adapter)) {
+        return { status: 501, body: { error: 'Adapter does not support versioning' } };
+    }
+    const locale = parseLocaleParam(req.query['locale']);
+    const doc = await ctx.adapter.getVersion(validated.collection, slug, version, locale);
+    if (!doc) {
+        return { status: 404, body: { error: `Version ${version} not found for "${slug}"` } };
+    }
+    return { status: 200, body: doc };
+};
+//# sourceMappingURL=get-version.js.map

package/dist/handlers/get-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-version.js","sourceRoot":"","sources":["../../src/handlers/get-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AAEzB,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACvD,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAA;IACxE,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAA;IAEjD,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnD,IAAI,CAAC,UAAU,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAA;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAA;IAE7B,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;IACvD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,CAAA;IACnE,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE,EAAE,CAAA;IAChF,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IACpD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IAErF,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,OAAO,mBAAmB,IAAI,GAAG,EAAE,EAAE,CAAA;IACvF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAA;AACnC,CAAC,CAAA"}

package/dist/handlers/import-bundle.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** A bundle contains portable documents; each uses the reviewed document import path. */
+export declare const importBundle: ApiHandler;
+//# sourceMappingURL=import-bundle.d.ts.map

package/dist/handlers/import-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-bundle.d.ts","sourceRoot":"","sources":["../../src/handlers/import-bundle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI7C,yFAAyF;AACzF,eAAO,MAAM,YAAY,EAAE,UAiD1B,CAAA"}

package/dist/handlers/import-bundle.js

@@ -0,0 +1,55 @@
+import { requireRole } from '../permissions.js';
+import { validateRequestBody } from '../validators.js';
+import { importContent } from './import-content.js';
+/** A bundle contains portable documents; each uses the reviewed document import path. */
+export const importBundle = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    const body = validateRequestBody(req.body);
+    if (!body.isValid)
+        return body.response;
+    const content = body.body['content'];
+    if (!content || typeof content !== 'object' || Array.isArray(content)) {
+        return { status: 400, body: { error: 'Bundle must contain a content object' } };
+    }
+    const entries = Object.entries(content);
+    if (entries.some(([, items]) => !Array.isArray(items))) {
+        return {
+            status: 400,
+            body: { error: 'Each collection must contain an array of portable documents' },
+        };
+    }
+    if (ctx.checkpointAdapter) {
+        await ctx.checkpointAdapter.createCheckpoint('pre-bundle-import', 'pre-import');
+    }
+    const results = [];
+    let imported = 0;
+    let skipped = 0;
+    const errors = [];
+    for (const [collection, items] of entries) {
+        const response = await importContent({ ...req, params: { collection }, body: { items } }, ctx);
+        const result = response.body;
+        if (response.status >= 400)
+            errors.push({ collection, slug: '', error: result.error ?? 'Collection import failed' });
+        for (const item of result.results ?? []) {
+            if (item.unchanged)
+                skipped++;
+            if (item.error)
+                errors.push({ collection, slug: item.slug, error: item.error });
+        }
+        imported += result.imported ?? 0;
+        results.push({ collection, status: response.status, result: response.body });
+    }
+    return {
+        status: 200,
+        body: {
+            imported,
+            skipped,
+            errors,
+            results,
+            checkpoint: ctx.checkpointAdapter ? 'created' : 'unavailable',
+        },
+    };
+};
+//# sourceMappingURL=import-bundle.js.map

package/dist/handlers/import-bundle.js.map

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

package/dist/handlers/import-content.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** Reviewed imports use document saves; no implicit publication or destructive deletion. */
+export declare const importContent: ApiHandler;
+//# sourceMappingURL=import-content.d.ts.map

package/dist/handlers/import-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-content.d.ts","sourceRoot":"","sources":["../../src/handlers/import-content.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAiC7C,4FAA4F;AAC5F,eAAO,MAAM,aAAa,EAAE,UAsI3B,CAAA"}

package/dist/handlers/import-content.js

@@ -0,0 +1,152 @@
+import { canGetContent, contractReferenceMatches, } from '@krantho/persistence';
+import { documentChecksum, parseRepositoryContent } from '@krantho/schema';
+import { z } from 'zod';
+import { getActiveContract } from '../merged-schema.js';
+import { changedByFromAuth, requireRole } from '../permissions.js';
+import { saveDocument } from '../save-document.js';
+import { formatZodErrors, validateCollectionParam, validateRequestBody } from '../validators.js';
+const portableDocument = z
+    .object({
+    identity: z
+        .object({
+        collection: z.string().min(1),
+        slug: z
+            .string()
+            .min(1)
+            .refine((value) => !value
+            .split('/')
+            .some((segment) => segment === '.' || segment === '..' || segment === '') &&
+            !value.includes('\\')),
+        locale: z.string().min(2),
+    })
+        .strict(),
+    contract: z.record(z.string(), z.json()).nullable(),
+    fields: z.record(z.string(), z.json()),
+    metadata: z.record(z.string(), z.record(z.string(), z.json())),
+    defaults: z.array(z.json()),
+    body: z.string(),
+    basis: z
+        .object({ checksum: z.string().min(1), version: z.number().int().positive() })
+        .strict()
+        .optional(),
+})
+    .strict();
+/** Reviewed imports use document saves; no implicit publication or destructive deletion. */
+export const importContent = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    const checked = validateCollectionParam(req.params['collection'], ctx);
+    if (!checked.isValid)
+        return checked.response;
+    const body = validateRequestBody(req.body);
+    if (!body.isValid)
+        return body.response;
+    const items = body.body['items'];
+    if (!Array.isArray(items) || items.length === 0)
+        return { status: 400, body: { error: 'Request body must include a non-empty "items" array' } };
+    const contract = await getActiveContract(checked.collectionDef, ctx.adapter);
+    const results = [];
+    for (const raw of items) {
+        const envelope = portableDocument.safeParse(raw);
+        if (!envelope.success) {
+            results.push({
+                slug: '(unknown)',
+                imported: false,
+                status: 422,
+                error: 'Invalid portable document',
+                details: formatZodErrors(envelope.error.issues),
+            });
+            continue;
+        }
+        const item = envelope.data;
+        const slug = item.identity?.slug;
+        const locale = item.identity?.locale;
+        if (typeof slug !== 'string' ||
+            typeof locale !== 'string' ||
+            item.identity.collection !== checked.collection) {
+            results.push({
+                slug: slug ?? '(unknown)',
+                imported: false,
+                error: 'Document identity must name this collection, a slug and a locale',
+            });
+            continue;
+        }
+        if (!contractReferenceMatches(item.contract, contract)) {
+            results.push({
+                slug,
+                imported: false,
+                error: 'The exported contract differs from the active contract. Review its fields and metadata before importing.',
+            });
+            continue;
+        }
+        const parsed = parseRepositoryContent(checked.collectionDef, slug, {
+            ...item.fields,
+            identity: item.identity,
+            contract: item.contract,
+            metadata: item.metadata,
+            defaults: item.defaults,
+        }, item.body, checked.collectionDef.schema, contract);
+        if (!parsed.success) {
+            results.push({
+                slug,
+                imported: false,
+                status: 422,
+                error: 'Document validation failed',
+                details: formatZodErrors(parsed.error.issues),
+            });
+            continue;
+        }
+        const read = canGetContent(ctx.adapter)
+            ? await ctx.adapter.getContent(checked.collection, slug, locale)
+            : null;
+        const current = read?.meta.locale === locale ? read : null;
+        const values = parsed.data;
+        if (current && documentChecksum(current) === documentChecksum(values)) {
+            results.push({ slug, imported: false, unchanged: true });
+            continue;
+        }
+        if (current && (!item.basis || item.basis.checksum !== documentChecksum(current))) {
+            results.push({
+                slug,
+                imported: false,
+                status: 409,
+                error: 'Repository and database changes need an explicit review',
+                details: { currentVersion: current.meta.version },
+            });
+            continue;
+        }
+        const saved = await saveDocument(ctx, {
+            collection: checked.collection,
+            slug,
+            locale,
+            fields: values.fields,
+            body: values.body,
+            metadata: values.metadata,
+            defaults: values.defaults,
+            repositoryBasis: { checksum: documentChecksum(values), version: 0 },
+            isNew: !current,
+            expectedVersion: current?.meta.version,
+            changedBy: changedByFromAuth(ctx.auth),
+        });
+        results.push(saved.ok
+            ? { slug, imported: true }
+            : {
+                slug,
+                imported: false,
+                status: saved.response.status,
+                error: String(saved.response.body.error ?? 'Document save failed'),
+                details: saved.response.body,
+            });
+    }
+    return {
+        status: 200,
+        body: {
+            collection: checked.collection,
+            imported: results.filter((r) => r.imported).length,
+            total: items.length,
+            results,
+        },
+    };
+};
+//# sourceMappingURL=import-content.js.map