@krantho/server 0.0.0-stage → 1.0.0

package/dist/content-migration.js

@@ -0,0 +1,291 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { renderContent } from '@krantho/core';
+import { canGetContent, publicationOfFile, } from '@krantho/persistence';
+import { documentChecksum, parseRepositoryContent, resolveCollectionContract, } from '@krantho/schema';
+import matter from 'gray-matter';
+import { recordNewConflict, resolveConflictsOf } from './content-conflicts.js';
+import { contentDateKey, contentDateLookup } from './content-dates.js';
+import { autoImport } from './import.js';
+import { CONTENT_MANIFEST_FILE } from './manifest.js';
+/**
+ * Bring the database up to date with the repository's content on startup.
+ *
+ * Without `<contentDir>/manifest.json` (or a migration adapter) the content is
+ * imported into an empty database only. With one, every deployment whose
+ * manifest is newer than the database's compares each file with its document:
+ * a new or changed file is imported, unless an editor changed the document in
+ * Studio since — then the editor's version stands and a changed file is
+ * recorded as a conflict. A document deleted in Studio stays deleted.
+ */
+export async function runContentMigration(adapter, contentConfig, migrationAdapter, checkpointAdapter, contentDir, defaultStatus = 'published') {
+    const manifest = await loadManifest(contentDir);
+    const dateOf = await contentDateLookup(contentDir);
+    if (!manifest || !migrationAdapter) {
+        const imported = await autoImport(adapter, contentConfig, dateOf, defaultStatus);
+        return {
+            action: imported > 0 ? 'full-import' : 'skip',
+            imported,
+            conflicts: 0,
+            rejected: 0,
+            checkpointVersion: null,
+            reason: !manifest ? `No ${CONTENT_MANIFEST_FILE} found` : 'Migration adapter not configured',
+            details: [],
+        };
+    }
+    const dbVersion = await migrationAdapter.getContentManifestVersion();
+    if (dbVersion !== null && dbVersion >= manifest.version) {
+        return {
+            action: 'skip',
+            imported: 0,
+            conflicts: 0,
+            rejected: 0,
+            checkpointVersion: null,
+            reason: `DB version ${dbVersion} >= repo version ${manifest.version}`,
+            details: [],
+        };
+    }
+    const previous = (await migrationAdapter.getContentManifest())?.fileChecksums ?? {};
+    const files = await readRepositoryFiles(adapter, contentConfig, contentDir);
+    const planned = await planFiles(adapter, files, previous);
+    const checkpointVersion = await checkpointBeforeImport(adapter, checkpointAdapter, planned, manifest.version);
+    await applyPlan(adapter, migrationAdapter, planned, dateOf, defaultStatus);
+    await migrationAdapter.saveContentManifest({
+        id: 0,
+        repoVersion: manifest.version,
+        repoCommit: manifest.commit ?? null,
+        importedAt: new Date().toISOString(),
+        fileChecksums: knownFiles(planned),
+    });
+    const count = (outcome) => planned.filter((p) => p.outcome === outcome).length;
+    return {
+        action: dbVersion === null ? 'full-import' : 'migrate',
+        imported: count('imported'),
+        conflicts: count('conflict'),
+        rejected: count('rejected'),
+        checkpointVersion,
+        details: planned.map(({ file, outcome }) => ({
+            collection: file.collection,
+            slug: file.slug,
+            outcome,
+        })),
+    };
+}
+async function planFiles(adapter, files, previous) {
+    const planned = [];
+    for (const file of files) {
+        const read = await adapter.getContent(file.collection, file.slug, file.document?.locale);
+        const current = file.document?.locale !== undefined && read?.meta.locale !== file.document.locale
+            ? null
+            : read;
+        planned.push({ file, current, outcome: decideFile(file, current, previous[file.key]) });
+    }
+    return planned;
+}
+/**
+ * What to do with one repository file, given its document's current version
+ * and the file's checksum when the database last took the repository's
+ * content (undefined: the database never saw this file).
+ *
+ * Content equal to a state the repository held (the document's basis, or what
+ * the last deployment took) is not an edit: a document that carries the
+ * repository's previous file, as one does after a pull of production's edits was
+ * merged, is not reported as edited, and a file at that state is not reported as changed.
+ *
+ * A version an import wrote is not an edit either, whatever its checksum: nobody changed it since,
+ * even when it predates the document's basis and contract. A restore copies the restored version's
+ * source but always names who restored it, so only a version with no `changedBy` is an import's.
+ */
+export function decideFile(file, current, previousChecksum) {
+    if (!file.fields)
+        return 'rejected';
+    if (!current)
+        return previousChecksum === undefined ? 'imported' : 'deleted';
+    const repo = documentChecksum({ ...file.document, fields: file.fields, body: file.body });
+    const database = documentChecksum(current);
+    if (repo === database)
+        return 'unchanged';
+    if (current.meta.source === 'filesystem' && current.meta.changedBy === null)
+        return 'imported';
+    const basis = current.repositoryBasis?.checksum ?? previousChecksum;
+    if (basis === undefined)
+        return 'conflict';
+    const heldByRepository = (checksum) => checksum === basis || checksum === previousChecksum;
+    const repositoryChanged = !heldByRepository(repo);
+    const databaseChanged = !heldByRepository(database);
+    if (repositoryChanged && databaseChanged)
+        return 'conflict';
+    return repositoryChanged ? 'imported' : 'kept';
+}
+/** A checkpoint before the first import into a database that already holds content */
+async function checkpointBeforeImport(adapter, checkpointAdapter, planned, version) {
+    if (!checkpointAdapter)
+        return null;
+    if (!planned.some((p) => p.outcome === 'imported'))
+        return null;
+    if ((await adapter.listSlugs()).length === 0)
+        return null;
+    const checkpoint = await checkpointAdapter.createCheckpoint(`pre-content-migration-v${version}`, 'pre-migration');
+    return checkpoint.version;
+}
+async function applyPlan(adapter, migrationAdapter, planned, dateOf, defaultStatus) {
+    const migrationId = (await migrationAdapter.getContentManifest())?.id ?? 0;
+    // Read once: each document is planned once, so no conflict this run touches is read again
+    const open = await migrationAdapter.listConflicts();
+    for (const plan of planned) {
+        const { file, current } = plan;
+        if (plan.outcome === 'imported' && file.fields) {
+            try {
+                await importFile(adapter, file, file.fields, dateOf, defaultStatus, current?.meta.version ?? 0);
+            }
+            catch (err) {
+                console.warn(`[content-migration] Failed to import ${file.key}:`, err);
+                plan.outcome = 'rejected';
+                continue;
+            }
+            await resolveConflictsOf(migrationAdapter, open, {
+                collection: file.collection,
+                slug: file.slug,
+                locale: file.document?.locale ?? current?.meta.locale,
+            });
+        }
+        else if (plan.outcome === 'conflict' && file.fields && current) {
+            await recordNewConflict(migrationAdapter, open, {
+                migrationId,
+                collection: file.collection,
+                slug: file.slug,
+                locale: current.meta.locale,
+                repoChecksum: documentChecksum({ ...file.document, fields: file.fields, body: file.body }),
+                dbChecksum: documentChecksum(current),
+            });
+        }
+        else if (plan.outcome === 'rejected') {
+            console.warn(`[import] Skipping ${file.key}: schema validation failed`);
+            for (const issue of file.issues)
+                console.warn(`  - ${issue}`);
+        }
+    }
+}
+async function importFile(adapter, file, fields, dateOf, defaultStatus, expectedVersion) {
+    const { html, sections } = await renderContent(fields, file.body, { atNotation: false });
+    await adapter.upsertFromFile(file.collection, file.slug, fields, file.body, html, sections, file.filePath, file.document?.locale, dateOf(file.filePath), {
+        ...file.document,
+        publication: publicationOfFile(file.status ?? defaultStatus),
+        expectedVersion,
+    });
+}
+/** The files the database now knows, by key: every file it holds or chose not to */
+function knownFiles(planned) {
+    return Object.fromEntries(planned
+        .filter((p) => p.outcome !== 'rejected')
+        .map((p) => [
+        p.file.key,
+        p.outcome === 'conflict' || p.outcome === 'kept'
+            ? (p.current?.repositoryBasis?.checksum ?? p.file.fileChecksum)
+            : p.file.fileChecksum,
+    ]));
+}
+/** Every markdown file in each collection's directory, parsed and validated */
+async function readRepositoryFiles(adapter, contentConfig, contentDir) {
+    const files = [];
+    for (const [, collection] of contentConfig.collections) {
+        if (!collection.directory)
+            continue;
+        let entries;
+        try {
+            entries = await readdir(collection.directory);
+        }
+        catch {
+            continue;
+        }
+        const contract = resolveCollectionContract(collection, (await adapter.getRuntimeSchema?.(collection.name)) ?? null);
+        for (const name of entries.filter((e) => e.endsWith('.md'))) {
+            const filePath = join(collection.directory, name);
+            const raw = await readFile(filePath, 'utf-8');
+            const parsed = matter(raw);
+            const result = parseRepositoryContent(collection, name.slice(0, -3), parsed.data, parsed.content, collection.schema, contract);
+            files.push({
+                key: contentDateKey(contentDir, filePath),
+                collection: collection.name,
+                slug: name.slice(0, -3),
+                filePath,
+                fileChecksum: result.success
+                    ? documentChecksum(result.data)
+                    : createHash('sha256').update(raw).digest('hex'),
+                document: result.success ? result.data : undefined,
+                status: typeof parsed.data['status'] === 'string' ? parsed.data['status'] : undefined,
+                fields: result.success ? result.data.fields : null,
+                issues: result.success
+                    ? []
+                    : result.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`),
+                body: parsed.content,
+            });
+        }
+    }
+    return files;
+}
+/** Read `<contentDir>/manifest.json`, or null when the build wrote none */
+export async function loadManifest(contentDir) {
+    try {
+        const raw = await readFile(join(contentDir, CONTENT_MANIFEST_FILE), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            typeof parsed['version'] !== 'number' ||
+            typeof parsed['files'] !== 'object') {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** Canonical authored content checksum, independent of YAML spelling and key order. */
+export function contentChecksum(fields, body) {
+    return documentChecksum({ fields, body });
+}
+/**
+ * Import the repository's content into the database when it needs it (an
+ * empty database, or a newer content manifest), logging what happened. Both
+ * the API handler and the page loader run it on first use, so whichever a
+ * fresh deployment serves first finds the content in place.
+ *
+ * @returns how many documents were imported
+ */
+export async function importRepositoryContent(adapter, contentConfig, migrationAdapter, checkpointAdapter, contentDir, defaultStatus = 'published') {
+    if (!('upsertFromFile' in adapter && 'listSlugs' in adapter && canGetContent(adapter)))
+        return 0;
+    const result = await runContentMigration(adapter, contentConfig, migrationAdapter, checkpointAdapter, contentDir, defaultStatus);
+    if (result.imported > 0 || result.conflicts > 0 || result.rejected > 0) {
+        const parts = [`[krantho] Content migration: ${result.action}`];
+        parts.push(`${result.imported} imported`);
+        if (result.conflicts > 0)
+            parts.push(`${result.conflicts} conflicts`);
+        if (result.rejected > 0)
+            parts.push(`${result.rejected} rejected`);
+        console.log(parts.join(', '));
+    }
+    return result.imported;
+}
+/** The site setting that holds the last content version the site announced */
+const ANNOUNCED_CONTENT_VERSION = 'content.announcedVersion';
+/**
+ * Whether the database holds a content version the site has not announced
+ * yet, recording it as announced. The page loader can import a deployment's
+ * content before the API handler starts, and only the handler can announce a
+ * change, so it announces each new content version once, whoever imported it.
+ */
+export async function claimContentAnnouncement(migrationAdapter, settings) {
+    if (!migrationAdapter || !settings)
+        return false;
+    const version = await migrationAdapter.getContentManifestVersion();
+    if (version === null)
+        return false;
+    if ((await settings.getSetting(ANNOUNCED_CONTENT_VERSION)) === String(version))
+        return false;
+    await settings.setSetting(ANNOUNCED_CONTENT_VERSION, String(version));
+    return true;
+}
+//# sourceMappingURL=content-migration.js.map

package/dist/content-migration.js.map

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

package/dist/convert.d.ts

@@ -0,0 +1,18 @@
+import type { ApiRequest, ApiResponse } from '@krantho/api';
+/**
+ * Convert a Web Request to a framework-agnostic ApiRequest.
+ *
+ * Extracts method, path, query parameters, headers, and body.
+ * Supports both JSON and multipart/form-data content types.
+ * The `/api` prefix is preserved — the API router expects it.
+ */
+export declare function toApiRequest(request: Request): Promise<ApiRequest>;
+/**
+ * Convert a framework-agnostic ApiResponse to a Web Response.
+ *
+ * Handles JSON bodies (default), binary bodies (Buffer/Uint8Array for image
+ * serving) and stream bodies (a `ReadableStream`, passed through unread). Content-Type is set from response headers if present,
+ * otherwise defaults to application/json.
+ */
+export declare function toResponse(apiResponse: ApiResponse): Response;
+//# sourceMappingURL=convert.d.ts.map

package/dist/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAyC3D;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CA2CxE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,QAAQ,CAyE7D"}

package/dist/convert.js

@@ -0,0 +1,152 @@
+const METHODS_WITH_BODY = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
+/**
+ * Check whether the content-type header indicates multipart form data.
+ */
+function isMultipart(headers) {
+    const ct = headers['content-type'] ?? '';
+    return ct.startsWith('multipart/form-data');
+}
+/**
+ * Parse multipart form data from a Request into the files array format
+ * expected by ApiRequest.
+ */
+async function parseMultipartFiles(request) {
+    const formData = await request.formData();
+    const files = [];
+    const body = {};
+    for (const [key, value] of formData) {
+        if (value instanceof File) {
+            const buffer = await value.arrayBuffer();
+            files.push({
+                name: key,
+                data: new Uint8Array(buffer),
+                filename: value.name,
+                mimeType: value.type || 'application/octet-stream',
+            });
+        }
+        else {
+            body[key] = value;
+        }
+    }
+    return { files, body };
+}
+/**
+ * Convert a Web Request to a framework-agnostic ApiRequest.
+ *
+ * Extracts method, path, query parameters, headers, and body.
+ * Supports both JSON and multipart/form-data content types.
+ * The `/api` prefix is preserved — the API router expects it.
+ */
+export async function toApiRequest(request) {
+    const url = new URL(request.url);
+    const method = request.method.toUpperCase();
+    const query = {};
+    for (const [key, value] of url.searchParams) {
+        query[key] = value;
+    }
+    const headers = {};
+    for (const [key, value] of request.headers) {
+        headers[key.toLowerCase()] = value;
+    }
+    let body;
+    let files;
+    if (METHODS_WITH_BODY.has(method) && request.body) {
+        if (isMultipart(headers)) {
+            const parsed = await parseMultipartFiles(request);
+            files = parsed.files;
+            body = parsed.body;
+        }
+        else {
+            try {
+                body = await request.json();
+            }
+            catch {
+                // Non-JSON body or empty — leave undefined
+            }
+        }
+    }
+    return {
+        method,
+        path: url.pathname,
+        params: {},
+        query,
+        body,
+        headers,
+        rawRequest: request,
+        files,
+    };
+}
+/**
+ * Convert a framework-agnostic ApiResponse to a Web Response.
+ *
+ * Handles JSON bodies (default), binary bodies (Buffer/Uint8Array for image
+ * serving) and stream bodies (a `ReadableStream`, passed through unread). Content-Type is set from response headers if present,
+ * otherwise defaults to application/json.
+ */
+export function toResponse(apiResponse) {
+    const responseHeaders = new Headers();
+    if (apiResponse.headers) {
+        for (const [key, value] of Object.entries(apiResponse.headers)) {
+            responseHeaders.set(key, value);
+        }
+    }
+    // Emit each cookie as its own Set-Cookie header line (RFC 6265). Headers.append
+    // accumulates, and the resulting Response exposes them via headers.getSetCookie().
+    if (apiResponse.cookies) {
+        for (const cookie of apiResponse.cookies) {
+            responseHeaders.append('set-cookie', cookie);
+        }
+    }
+    // Stream body (e.g. server-sent events) — passed through unread
+    if (apiResponse.body instanceof ReadableStream) {
+        if (!responseHeaders.has('content-type')) {
+            responseHeaders.set('content-type', 'application/octet-stream');
+        }
+        return new Response(apiResponse.body, {
+            status: apiResponse.status,
+            headers: responseHeaders,
+        });
+    }
+    // Binary body (Buffer or Uint8Array) — pass raw bytes
+    if (apiResponse.body instanceof Uint8Array || Buffer.isBuffer(apiResponse.body)) {
+        if (!responseHeaders.has('content-type')) {
+            responseHeaders.set('content-type', 'application/octet-stream');
+        }
+        const raw = Buffer.isBuffer(apiResponse.body)
+            ? apiResponse.body
+            : Buffer.from(apiResponse.body);
+        // Copy to a new ArrayBuffer to satisfy BodyInit type (avoids SharedArrayBuffer issue)
+        const ab = new ArrayBuffer(raw.byteLength);
+        new Uint8Array(ab).set(raw);
+        return new Response(ab, {
+            status: apiResponse.status,
+            headers: responseHeaders,
+        });
+    }
+    // Null body (e.g., 304 Not Modified)
+    if (apiResponse.body === null || apiResponse.body === undefined) {
+        return new Response(null, {
+            status: apiResponse.status,
+            headers: responseHeaders,
+        });
+    }
+    // String body with explicit Content-Type (e.g., text/html)
+    if (typeof apiResponse.body === 'string') {
+        if (!responseHeaders.has('content-type')) {
+            responseHeaders.set('content-type', 'text/plain');
+        }
+        return new Response(apiResponse.body, {
+            status: apiResponse.status,
+            headers: responseHeaders,
+        });
+    }
+    // Default: JSON
+    if (!responseHeaders.has('content-type')) {
+        responseHeaders.set('content-type', 'application/json');
+    }
+    return new Response(JSON.stringify(apiResponse.body), {
+        status: apiResponse.status,
+        headers: responseHeaders,
+    });
+}
+//# sourceMappingURL=convert.js.map

package/dist/convert.js.map

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

package/dist/file-store.d.ts

@@ -0,0 +1,11 @@
+import type { MediaSection } from '@krantho/config';
+import type { IFileStore } from '@krantho/persistence';
+/**
+ * Build the file store `media.provider` selects.
+ *
+ * Each store is its own optional peer, loaded by a literal dynamic import so
+ * bundlers and Next/Vercel file tracing can follow it; an app installs only
+ * the store it uses.
+ */
+export declare function createFileStore(media: MediaSection): Promise<IFileStore>;
+//# sourceMappingURL=file-store.d.ts.map

package/dist/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../src/file-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAyB9E"}

package/dist/file-store.js

@@ -0,0 +1,39 @@
+/**
+ * Build the file store `media.provider` selects.
+ *
+ * Each store is its own optional peer, loaded by a literal dynamic import so
+ * bundlers and Next/Vercel file tracing can follow it; an app installs only
+ * the store it uses.
+ */
+export async function createFileStore(media) {
+    switch (media.provider) {
+        case 'local': {
+            const mod = await load('local', '@krantho/media-local', () => import('@krantho/media-local'));
+            return mod.createLocalFileStore(media.local);
+        }
+        case 'vercel-blob': {
+            const mod = await load('vercel-blob', '@krantho/media-vercel-blob', () => import('@krantho/media-vercel-blob'));
+            return mod.createVercelBlobFileStore(media.vercelBlob);
+        }
+        case 's3': {
+            const mod = await load('s3', '@krantho/media-s3', () => import('@krantho/media-s3'));
+            return mod.createS3FileStore(media.s3);
+        }
+        case 'gcs': {
+            const mod = await load('gcs', '@krantho/media-gcs', () => import('@krantho/media-gcs'));
+            return mod.createGcsFileStore(media.gcs);
+        }
+        case undefined:
+            throw new Error('media.provider is not set');
+    }
+}
+async function load(provider, pkg, importer) {
+    try {
+        return await importer();
+    }
+    catch (err) {
+        throw new Error(`media.provider is "${provider}", but ${pkg} could not be loaded. ` +
+            'Add it to the dependencies of the app that runs krantho.', { cause: err });
+    }
+}
+//# sourceMappingURL=file-store.js.map

package/dist/file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.js","sourceRoot":"","sources":["../src/file-store.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAmB;IACvD,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAA;YAC7F,OAAO,GAAG,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC9C,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,MAAM,IAAI,CACpB,aAAa,EACb,4BAA4B,EAC5B,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAC3C,CAAA;YACD,OAAO,GAAG,CAAC,yBAAyB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QACxD,CAAC;QACD,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAA;YACpF,OAAO,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACxC,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAA;YACvF,OAAO,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC1C,CAAC;QACD,KAAK,SAAS;YACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAChD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI,CACjB,QAAuB,EACvB,GAAW,EACX,QAA0B;IAE1B,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,EAAE,CAAA;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,UAAU,GAAG,wBAAwB;YACjE,0DAA0D,EAC5D,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/file-watcher.d.ts

@@ -0,0 +1,19 @@
+import type { ApiHandlers } from '@krantho/api';
+import { type ContentConfig } from '@krantho/schema';
+import type { ImportableAdapter } from './import.js';
+export interface FileWatcherOptions {
+    contentConfig: ContentConfig;
+    adapter: ImportableAdapter;
+    saveDocument: ApiHandlers['saveRepositoryDocument'];
+}
+/**
+ * Start watching filesystem collection directories for changes.
+ *
+ * When a `.md` file is added or modified, it is parsed, validated against
+ * the collection contract, and saved as a draft through the common document write
+ * path. When a file is deleted, the document stays in the database until explicitly archived.
+ *
+ * Returns a cleanup function to stop watching.
+ */
+export declare function startFileWatcher(options: FileWatcherOptions): Promise<() => void>;
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../src/file-watcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAEL,KAAK,aAAa,EAInB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAkEpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,aAAa,CAAA;IAC5B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,YAAY,EAAE,WAAW,CAAC,wBAAwB,CAAC,CAAA;CACpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAoDvF"}