@cogenta/import 0.1.4 → 0.2.1

package/dist/csv-import.d.ts

@@ -0,0 +1,11 @@
+import type { GenericSourceRecord } from './generic-import.js';
+/**
+ * CSV as an import source (fiche 25 task 5).
+ *
+ * `sourceId` is the row number (1-based, header excluded): stable across a
+ * re-analysis of the exact same file, which is what resume and undo rely on.
+ * A CSV re-exported with rows reordered gets a fresh run rather than a false
+ * resume — the same honest limit `parseCsv` itself does not try to solve.
+ */
+export declare function csvToRecords(text: string): readonly GenericSourceRecord[];
+//# sourceMappingURL=csv-import.d.ts.map

package/dist/csv-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-import.d.ts","sourceRoot":"","sources":["../src/csv-import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,mBAAmB,EAAE,CAGzE"}

package/dist/csv-import.js

@@ -0,0 +1,14 @@
+import { parseCsv } from './csv.js';
+/**
+ * CSV as an import source (fiche 25 task 5).
+ *
+ * `sourceId` is the row number (1-based, header excluded): stable across a
+ * re-analysis of the exact same file, which is what resume and undo rely on.
+ * A CSV re-exported with rows reordered gets a fresh run rather than a false
+ * resume — the same honest limit `parseCsv` itself does not try to solve.
+ */
+export function csvToRecords(text) {
+    const { rows } = parseCsv(text);
+    return rows.map((values, index) => ({ sourceId: String(index + 1), values }));
+}
+//# sourceMappingURL=csv-import.js.map

package/dist/csv-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-import.js","sourceRoot":"","sources":["../src/csv-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGnC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;AAC/E,CAAC"}

package/dist/csv.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A hand-rolled CSV parser (RFC 4180), fiche 25 task 5.
+ *
+ * R9: a correct parser — quoted fields, an embedded comma, an embedded
+ * newline inside a quoted field, a doubled `""` escaping a literal quote,
+ * a UTF-8 BOM, and both CRLF and bare LF line endings — is a hundred lines.
+ * No dependency earns its place over that.
+ */
+export interface ParsedCsv {
+    readonly headers: readonly string[];
+    /** One object per data row, keyed by header. A short row pads with `''`; a long row's extra cells are dropped. */
+    readonly rows: readonly Readonly<Record<string, string>>[];
+}
+export declare function parseCsv(text: string): ParsedCsv;
+//# sourceMappingURL=csv.d.ts.map

package/dist/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,kHAAkH;IAClH,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAA;CAC3D;AA0ED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAqChD"}

package/dist/csv.js

@@ -0,0 +1,100 @@
+import { CogentaError } from '@cogenta/core';
+function stripBom(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+/** Splits CSV text into rows of raw cells, respecting quoted fields. */
+function tokenize(text) {
+    const rows = [];
+    let row = [];
+    let cell = '';
+    let inQuotes = false;
+    let i = 0;
+    const length = text.length;
+    while (i < length) {
+        const char = text[i];
+        if (inQuotes) {
+            if (char === '"') {
+                if (text[i + 1] === '"') {
+                    cell += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i += 1;
+                continue;
+            }
+            cell += char;
+            i += 1;
+            continue;
+        }
+        if (char === '"') {
+            inQuotes = true;
+            i += 1;
+            continue;
+        }
+        if (char === ',') {
+            row.push(cell);
+            cell = '';
+            i += 1;
+            continue;
+        }
+        if (char === '\r') {
+            // Peek past a possible \n — either way this ends the row.
+            row.push(cell);
+            cell = '';
+            rows.push(row);
+            row = [];
+            i += text[i + 1] === '\n' ? 2 : 1;
+            continue;
+        }
+        if (char === '\n') {
+            row.push(cell);
+            cell = '';
+            rows.push(row);
+            row = [];
+            i += 1;
+            continue;
+        }
+        cell += char;
+        i += 1;
+    }
+    if (cell.length > 0 || row.length > 0) {
+        row.push(cell);
+        rows.push(row);
+    }
+    return rows;
+}
+export function parseCsv(text) {
+    const rows = tokenize(stripBom(text)).filter((row) => !(row.length === 1 && row[0] === ''));
+    const [headerRow, ...dataRows] = rows;
+    if (headerRow === undefined) {
+        throw new CogentaError({
+            code: 'IMPORT_CSV_INVALID',
+            message: 'This CSV file has no header row.',
+            hint: 'The first line must name each column.',
+        });
+    }
+    const headers = headerRow.map((header) => header.trim());
+    const seen = new Set();
+    for (const header of headers) {
+        if (header.length === 0) {
+            throw new CogentaError({
+                code: 'IMPORT_CSV_INVALID',
+                message: 'A column header is empty.',
+                hint: 'Every column needs a non-empty name.',
+            });
+        }
+        if (seen.has(header)) {
+            throw new CogentaError({
+                code: 'IMPORT_CSV_INVALID',
+                message: `Column "${header}" appears more than once.`,
+                hint: 'Rename one of the duplicate columns.',
+                details: { header },
+            });
+        }
+        seen.add(header);
+    }
+    const parsedRows = dataRows.map((cells) => Object.fromEntries(headers.map((header, index) => [header, cells[index] ?? ''])));
+    return { headers, rows: parsedRows };
+}
+//# sourceMappingURL=csv.js.map

package/dist/csv.js.map

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

package/dist/feed.d.ts

@@ -0,0 +1,4 @@
+import type { GenericSourceRecord } from './generic-import.js';
+/** `title`, `link`, `description`/`summary`/`content`, `pubDate`/`published`, `guid`/`id`. */
+export declare function feedToRecords(xml: string): readonly GenericSourceRecord[];
+//# sourceMappingURL=feed.d.ts.map

package/dist/feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAqB9D,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,mBAAmB,EAAE,CAkCzE"}

package/dist/feed.js

@@ -0,0 +1,50 @@
+import { CogentaError } from '@cogenta/core';
+import { children, firstChild, parseXmlDocument, textOfChild } from './wordpress/xml.js';
+/**
+ * RSS 2.0 and Atom feed reading (fiche 25 task 5).
+ *
+ * Reuses the WXR reader's own XML parser rather than a new dependency (R9) —
+ * both formats are well-known, narrow dialects `parseXmlDocument` already
+ * reads safely (no DTD entity expansion, R8's own concern for content of
+ * unknown provenance).
+ */
+function atomLink(item) {
+    for (const link of children(item, 'link')) {
+        if (link.attrs['rel'] === undefined || link.attrs['rel'] === 'alternate') {
+            return link.attrs['href'] ?? '';
+        }
+    }
+    return '';
+}
+/** `title`, `link`, `description`/`summary`/`content`, `pubDate`/`published`, `guid`/`id`. */
+export function feedToRecords(xml) {
+    const root = parseXmlDocument(xml);
+    const isAtom = root.name === 'feed';
+    const container = isAtom ? root : (firstChild(root, 'channel') ?? root);
+    const itemName = isAtom ? 'entry' : 'item';
+    const items = children(container, itemName);
+    if (items.length === 0 && root.name !== 'rss' && !isAtom) {
+        throw new CogentaError({
+            code: 'IMPORT_FEED_INVALID',
+            message: 'This document is neither an RSS <rss> feed nor an Atom <feed>.',
+            hint: 'Point the importer at a real RSS 2.0 or Atom XML export.',
+        });
+    }
+    return items.map((item, index) => {
+        const title = textOfChild(item, 'title');
+        const link = isAtom ? atomLink(item) : textOfChild(item, 'link');
+        const description = isAtom
+            ? textOfChild(item, 'summary') || textOfChild(item, 'content')
+            : textOfChild(item, 'description');
+        const published = isAtom
+            ? textOfChild(item, 'published') || textOfChild(item, 'updated')
+            : textOfChild(item, 'pubDate');
+        const guid = isAtom ? textOfChild(item, 'id') : textOfChild(item, 'guid') || link;
+        const sourceId = guid.length > 0 ? guid : `${index + 1}`;
+        return {
+            sourceId,
+            values: { title, link, description, publishedAt: published },
+        };
+    });
+}
+//# sourceMappingURL=feed.js.map

package/dist/feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.js","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAExF;;;;;;;GAOG;AAEH,SAAS,QAAQ,CAAC,IAA6C;IAC7D,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,WAAW,EAAE,CAAC;YACzE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;QACjC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAA;IACnC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,CAAA;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACzD,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,gEAAgE;YACzE,IAAI,EAAE,0DAA0D;SACjE,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAChE,MAAM,WAAW,GAAG,MAAM;YACxB,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;YAC9D,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QACpC,MAAM,SAAS,GAAG,MAAM;YACtB,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;YAChE,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAA;QAEjF,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAA;QAExD,OAAO;YACL,QAAQ;YACR,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE;SAC7D,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/generic-import.d.ts

@@ -0,0 +1,56 @@
+import type { CollectionDefinition, ContentStore } from '@cogenta/schema';
+import { type FieldMapping } from './mapping.js';
+import type { ImportTrackingStore } from './tracking.js';
+/**
+ * The shared engine behind CSV and RSS/Atom import (fiche 25 task 5).
+ *
+ * Both sources reduce to the same shape once parsed — a list of records, each
+ * with a stable `sourceId` and a bag of string values — so the mapping,
+ * preview, apply, resume and undo machinery is written once here rather than
+ * twice. WordPress keeps its own pipeline (`wordpress/import.ts`): its source
+ * shape is not tabular, and forcing it through this engine would lose the
+ * category/tag/media/author handling that is specific to it.
+ */
+export interface GenericSourceRecord {
+    /** Stable across re-analysis of the same file — a CSV row number, an RSS item's guid/link. */
+    readonly sourceId: string;
+    readonly values: Readonly<Record<string, string>>;
+}
+export interface GenericPreviewReport {
+    readonly totalRecords: number;
+    readonly sourceFields: readonly string[];
+    readonly proposedMapping: FieldMapping;
+    /** The first few records, for the mapping/preview screen. */
+    readonly sample: readonly Readonly<Record<string, string>>[];
+    readonly warnings: readonly string[];
+}
+export declare function analyzeGeneric(records: readonly GenericSourceRecord[], targetCollection: CollectionDefinition): GenericPreviewReport;
+export interface ApplyGenericOptions {
+    readonly records: readonly GenericSourceRecord[];
+    readonly mapping: FieldMapping;
+    readonly collections: readonly CollectionDefinition[];
+    readonly storeFor: (collection: CollectionDefinition) => ContentStore;
+    readonly tracking: ImportTrackingStore;
+    readonly runId: string;
+    readonly createdBy: string | null;
+    readonly status?: 'draft' | 'published';
+}
+export interface GenericApplyReport {
+    readonly imported: number;
+    /** Already recorded for this run — a resume, not a fresh write. */
+    readonly resumedSkips: number;
+    readonly errors: readonly {
+        readonly sourceId: string;
+        readonly message: string;
+    }[];
+}
+/**
+ * Writes every record not already recorded for this run.
+ *
+ * Resumable by construction: `tracking.doneSourceIds` is read once up front,
+ * and every successful write is recorded before moving to the next record —
+ * a process killed mid-run leaves a run whose next `applyGeneric` call picks
+ * up exactly where it stopped, with no duplicate entries.
+ */
+export declare function applyGeneric(options: ApplyGenericOptions): Promise<GenericApplyReport>;
+//# sourceMappingURL=generic-import.d.ts.map

package/dist/generic-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-import.d.ts","sourceRoot":"","sources":["../src/generic-import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,KAAK,YAAY,EAAuC,MAAM,cAAc,CAAA;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExD;;;;;;;;;GASG;AAEH,MAAM,WAAW,mBAAmB;IAClC,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAA;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAA;IAC5D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAID,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,gBAAgB,EAAE,oBAAoB,GACrC,oBAAoB,CActB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAChD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACrD,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,YAAY,CAAA;IACrE,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,mEAAmE;IACnE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACpF;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0C5F"}

package/dist/generic-import.js

@@ -0,0 +1,64 @@
+import { proposeFieldMapping, resolveMapping } from './mapping.js';
+const SAMPLE_SIZE = 5;
+export function analyzeGeneric(records, targetCollection) {
+    const sourceFields = records[0] === undefined ? [] : Object.keys(records[0].values);
+    const warnings = [];
+    if (records.length === 0) {
+        warnings.push('The source carries no importable record.');
+    }
+    return {
+        totalRecords: records.length,
+        sourceFields,
+        proposedMapping: proposeFieldMapping(sourceFields, targetCollection),
+        sample: records.slice(0, SAMPLE_SIZE).map((record) => record.values),
+        warnings,
+    };
+}
+/**
+ * Writes every record not already recorded for this run.
+ *
+ * Resumable by construction: `tracking.doneSourceIds` is read once up front,
+ * and every successful write is recorded before moving to the next record —
+ * a process killed mid-run leaves a run whose next `applyGeneric` call picks
+ * up exactly where it stopped, with no duplicate entries.
+ */
+export async function applyGeneric(options) {
+    const resolved = resolveMapping(options.mapping, options.collections);
+    const store = options.storeFor(resolved.collection);
+    const done = await options.tracking.doneSourceIds(options.runId);
+    let imported = 0;
+    let resumedSkips = 0;
+    const errors = [];
+    for (const record of options.records) {
+        if (done.has(record.sourceId)) {
+            resumedSkips += 1;
+            continue;
+        }
+        const values = {};
+        for (const [source, target] of resolved.fields) {
+            values[target] = record.values[source] ?? '';
+        }
+        try {
+            const entry = await store.create({
+                status: options.status ?? 'draft',
+                createdBy: options.createdBy,
+                values,
+            });
+            await options.tracking.recordItem({
+                runId: options.runId,
+                sourceId: record.sourceId,
+                collection: resolved.collection.name,
+                entryId: entry.id,
+            });
+            imported += 1;
+        }
+        catch (error) {
+            errors.push({
+                sourceId: record.sourceId,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return { imported, resumedSkips, errors };
+}
+//# sourceMappingURL=generic-import.js.map

package/dist/generic-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-import.js","sourceRoot":"","sources":["../src/generic-import.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AA6BrF,MAAM,WAAW,GAAG,CAAC,CAAA;AAErB,MAAM,UAAU,cAAc,CAC5B,OAAuC,EACvC,gBAAsC;IAEtC,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IACnF,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;IAC3D,CAAC;IAED,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,YAAY;QACZ,eAAe,EAAE,mBAAmB,CAAC,YAAY,EAAE,gBAAgB,CAAC;QACpE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QACpE,QAAQ;KACT,CAAA;AACH,CAAC;AAoBD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IACnD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAEhE,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,MAAM,MAAM,GAA4C,EAAE,CAAA;IAE1D,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,YAAY,IAAI,CAAC,CAAA;YACjB,SAAQ;QACV,CAAC;QAED,MAAM,MAAM,GAA4B,EAAE,CAAA;QAC1C,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;QAC9C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;gBAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO;gBACjC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM;aACP,CAAC,CAAA;YACF,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAChC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI;gBACpC,OAAO,EAAE,KAAK,CAAC,EAAE;aAClB,CAAC,CAAA;YACF,QAAQ,IAAI,CAAC,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAA;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,20 @@
+export type { ParsedCsv } from './csv.js';
+export { parseCsv } from './csv.js';
+export { csvToRecords } from './csv-import.js';
+export { feedToRecords } from './feed.js';
+export type { ApplyGenericOptions, GenericApplyReport, GenericPreviewReport, GenericSourceRecord, } from './generic-import.js';
+export { analyzeGeneric, applyGeneric } from './generic-import.js';
+export type { ApplyJsonOptions, JsonApplyReport, JsonImportRecord, JsonPreviewReport, } from './json-import.js';
+export { analyzeJson, applyJson, parseJsonImport } from './json-import.js';
+export type { FieldMapping, ResolvedMapping } from './mapping.js';
+export { proposeFieldMapping, resolveMapping } from './mapping.js';
+export { assertPublicUrl, isPrivateAddress } from './ssrf.js';
+export type { CreateImportRunInput, CreateImportTrackingStoreOptions, ImportItem, ImportRun, ImportRunStatus, ImportSource, ImportTrackingStore, } from './tracking.js';
+export { createImportTrackingStore, IMPORT_ITEMS_TABLE, IMPORT_RUN_STATUSES, IMPORT_RUNS_TABLE, IMPORT_SOURCES, } from './tracking.js';
+export type { UndoImportOptions, UndoImportReport } from './undo.js';
+export { undoImport } from './undo.js';
+export type { WordPressPreviewReport, WordPressSlugConflict } from './wordpress/analyze.js';
+export { analyzeWordPress } from './wordpress/analyze.js';
 export { WORDPRESS_IMPORT_COLLECTIONS, wpCategory, wpComment, wpPage, wpPost, wpTag, } from './wordpress/collections.js';
 export type { ContentConversionNote, ContentConversionResult, DraftBlock, } from './wordpress/content-convert.js';
 export { convertContent, mediaUrlsOf, resolveMediaReferences } from './wordpress/content-convert.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,KAAK,GACN,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,GACX,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AACpG,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACX,MAAM,EACN,UAAU,GACX,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClE,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC1E,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC7D,YAAY,EACV,oBAAoB,EACpB,gCAAgC,EAChC,UAAU,EACV,SAAS,EACT,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,KAAK,GACN,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,UAAU,GACX,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AACpG,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACX,MAAM,EACN,UAAU,GACX,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -1,3 +1,13 @@
+export { parseCsv } from './csv.js';
+export { csvToRecords } from './csv-import.js';
+export { feedToRecords } from './feed.js';
+export { analyzeGeneric, applyGeneric } from './generic-import.js';
+export { analyzeJson, applyJson, parseJsonImport } from './json-import.js';
+export { proposeFieldMapping, resolveMapping } from './mapping.js';
+export { assertPublicUrl, isPrivateAddress } from './ssrf.js';
+export { createImportTrackingStore, IMPORT_ITEMS_TABLE, IMPORT_RUN_STATUSES, IMPORT_RUNS_TABLE, IMPORT_SOURCES, } from './tracking.js';
+export { undoImport } from './undo.js';
+export { analyzeWordPress } from './wordpress/analyze.js';
 export { WORDPRESS_IMPORT_COLLECTIONS, wpCategory, wpComment, wpPage, wpPost, wpTag, } from './wordpress/collections.js';
 export { convertContent, mediaUrlsOf, resolveMediaReferences } from './wordpress/content-convert.js';
 export { importWordPress } from './wordpress/import.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,KAAK,GACN,MAAM,4BAA4B,CAAA;AAMnC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAEpG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAMvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAY9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAOzC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAOlE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE1E,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAU7D,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,KAAK,GACN,MAAM,4BAA4B,CAAA;AAMnC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAEpG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAMvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAY9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/json-import.d.ts

@@ -0,0 +1,52 @@
+import type { CollectionDefinition, ContentStore } from '@cogenta/schema';
+import type { ImportTrackingStore } from './tracking.js';
+/**
+ * JSON import (fiche 25 task 5): one Cogenta site's content, moved into
+ * another.
+ *
+ * The format is intentionally minimal and self-contained — newline-delimited
+ * JSON, one entry per line, `{ collection, id?, status?, locale?, values }` —
+ * rather than a reuse of `@cogenta/export`'s own NDJSON format: that package
+ * is not present in this branch (no `packages/export`), so there is no
+ * `export@1.0` writer to round-trip against yet. This reader is written to
+ * the shape that format's manifest already documents (collection, id,
+ * status, locale, values are exactly its `entry` record's own fields), so
+ * once `@cogenta/export` lands, wiring this import to consume its real
+ * stream is a matter of mapping its `ExportEntryRecord` onto
+ * `JsonImportRecord`, not a rewrite.
+ */
+export interface JsonImportRecord {
+    readonly collection: string;
+    /** Present on a real Cogenta export; absent on a hand-written JSON import, where the store assigns one. */
+    readonly id?: string;
+    readonly status?: 'draft' | 'published' | 'archived';
+    readonly locale?: string;
+    readonly values: Readonly<Record<string, unknown>>;
+}
+export declare function parseJsonImport(text: string): readonly JsonImportRecord[];
+export interface JsonPreviewReport {
+    readonly totalRecords: number;
+    readonly byCollection: Readonly<Record<string, number>>;
+    /** A collection this site does not declare — the record will be skipped and named at apply time, never dropped silently. */
+    readonly unknownCollections: readonly string[];
+    readonly warnings: readonly string[];
+}
+export declare function analyzeJson(records: readonly JsonImportRecord[], collections: readonly CollectionDefinition[]): JsonPreviewReport;
+export interface ApplyJsonOptions {
+    readonly records: readonly JsonImportRecord[];
+    readonly collections: readonly CollectionDefinition[];
+    readonly storeFor: (collection: CollectionDefinition) => ContentStore;
+    readonly tracking: ImportTrackingStore;
+    readonly runId: string;
+    readonly createdBy: string | null;
+}
+export interface JsonApplyReport {
+    readonly imported: number;
+    readonly resumedSkips: number;
+    readonly errors: readonly {
+        readonly sourceId: string;
+        readonly message: string;
+    }[];
+}
+export declare function applyJson(options: ApplyJsonOptions): Promise<JsonApplyReport>;
+//# sourceMappingURL=json-import.d.ts.map

package/dist/json-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-import.d.ts","sourceRoot":"","sources":["../src/json-import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAA;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACnD;AAWD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CAuCzE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACvD,4HAA4H;IAC5H,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,WAAW,EAAE,SAAS,oBAAoB,EAAE,GAC3C,iBAAiB,CAuBnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACrD,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,YAAY,CAAA;IACrE,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACpF;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8CnF"}

package/dist/json-import.js

@@ -0,0 +1,110 @@
+import { CogentaError } from '@cogenta/core';
+function invalidLine(lineNumber, reason) {
+    return new CogentaError({
+        code: 'IMPORT_SOURCE_INVALID',
+        message: `Line ${lineNumber} of the JSON import is not usable: ${reason}.`,
+        hint: 'Each line must be a JSON object shaped { "collection": "...", "values": { ... } }.',
+        details: { line: lineNumber },
+    });
+}
+export function parseJsonImport(text) {
+    const records = [];
+    const lines = text.split(/\r\n|\n/);
+    lines.forEach((line, index) => {
+        if (line.trim().length === 0)
+            return;
+        const lineNumber = index + 1;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            throw invalidLine(lineNumber, 'not valid JSON');
+        }
+        if (typeof parsed !== 'object' || parsed === null)
+            throw invalidLine(lineNumber, 'not a JSON object');
+        const record = parsed;
+        if (typeof record['collection'] !== 'string' || record['collection'].length === 0) {
+            throw invalidLine(lineNumber, 'missing a "collection" name');
+        }
+        if (typeof record['values'] !== 'object' || record['values'] === null) {
+            throw invalidLine(lineNumber, 'missing a "values" object');
+        }
+        records.push({
+            collection: record['collection'],
+            ...(typeof record['id'] === 'string' ? { id: record['id'] } : {}),
+            ...(record['status'] === 'draft' ||
+                record['status'] === 'published' ||
+                record['status'] === 'archived'
+                ? { status: record['status'] }
+                : {}),
+            ...(typeof record['locale'] === 'string' ? { locale: record['locale'] } : {}),
+            values: record['values'],
+        });
+    });
+    return records;
+}
+export function analyzeJson(records, collections) {
+    const known = new Set(collections.map((c) => c.name));
+    const byCollection = {};
+    const unknown = new Set();
+    for (const record of records) {
+        byCollection[record.collection] = (byCollection[record.collection] ?? 0) + 1;
+        if (!known.has(record.collection))
+            unknown.add(record.collection);
+    }
+    const warnings = [];
+    if (unknown.size > 0) {
+        warnings.push(`${[...unknown].join(', ')} — not declared on this site; those records will be skipped.`);
+    }
+    return {
+        totalRecords: records.length,
+        byCollection,
+        unknownCollections: [...unknown],
+        warnings,
+    };
+}
+export async function applyJson(options) {
+    const collectionByName = new Map(options.collections.map((c) => [c.name, c]));
+    const done = await options.tracking.doneSourceIds(options.runId);
+    let imported = 0;
+    let resumedSkips = 0;
+    const errors = [];
+    for (const [index, record] of options.records.entries()) {
+        const sourceId = record.id ?? `line:${index + 1}`;
+        if (done.has(sourceId)) {
+            resumedSkips += 1;
+            continue;
+        }
+        const collection = collectionByName.get(record.collection);
+        if (collection === undefined) {
+            errors.push({
+                sourceId,
+                message: `Collection "${record.collection}" does not exist on this site.`,
+            });
+            continue;
+        }
+        try {
+            const store = options.storeFor(collection);
+            const entry = await store.create({
+                ...(record.id === undefined ? {} : { id: record.id }),
+                ...(record.status === undefined ? {} : { status: record.status }),
+                ...(record.locale === undefined ? {} : { locale: record.locale }),
+                createdBy: options.createdBy,
+                values: record.values,
+            });
+            await options.tracking.recordItem({
+                runId: options.runId,
+                sourceId,
+                collection: collection.name,
+                entryId: entry.id,
+            });
+            imported += 1;
+        }
+        catch (error) {
+            errors.push({ sourceId, message: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    return { imported, resumedSkips, errors };
+}
+//# sourceMappingURL=json-import.js.map

package/dist/json-import.js.map

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

package/dist/mapping.d.ts

@@ -0,0 +1,23 @@
+import type { CollectionDefinition } from '@cogenta/schema';
+/**
+ * Field correspondence, fiche 25 task 2.
+ *
+ * `null` on a source field means "ignore" — the preview names it, the
+ * mapping screen offers it, and the report counts it under
+ * `fieldsWithoutTarget` so an import never drops data silently.
+ */
+export interface FieldMapping {
+    readonly targetCollection: string;
+    /** Source field name → target field name, or `null` to ignore it. */
+    readonly fields: Readonly<Record<string, string | null>>;
+}
+export interface ResolvedMapping {
+    readonly collection: CollectionDefinition;
+    /** Source field → target field, `null` entries already removed. */
+    readonly fields: ReadonlyMap<string, string>;
+    readonly ignored: readonly string[];
+}
+/** Proposes target field names by matching source header names case-insensitively (task 2's "correspondances proposées automatiquement"). */
+export declare function proposeFieldMapping(sourceFields: readonly string[], collection: CollectionDefinition): FieldMapping;
+export declare function resolveMapping(mapping: FieldMapping, collections: readonly CollectionDefinition[]): ResolvedMapping;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;CACzD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,6IAA6I;AAC7I,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,UAAU,EAAE,oBAAoB,GAC/B,YAAY,CASd;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,SAAS,oBAAoB,EAAE,GAC3C,eAAe,CAgCjB"}