@cogenta/export 0.2.3

package/dist/restore.js

@@ -0,0 +1,173 @@
+import { createHash } from 'node:crypto';
+import { CogentaError, identifier, sql, unsafeRaw, } from '@cogenta/core';
+import { decryptStream } from './crypto.js';
+import { openZip } from './zip-reader.js';
+async function bufferEntry(zip, name) {
+    const chunks = [];
+    for await (const chunk of zip.read(name))
+        chunks.push(chunk);
+    return Buffer.concat(chunks);
+}
+export async function readBackupManifest(path) {
+    const zip = await openZip(path);
+    try {
+        const raw = await bufferEntry(zip, 'manifest.json');
+        return JSON.parse(raw.toString('utf8'));
+    }
+    finally {
+        await zip.close();
+    }
+}
+function tablePlaintext(zip, table, manifest, passphrase) {
+    const raw = zip.read(table.file);
+    if (!manifest.encrypted)
+        return raw;
+    if (passphrase === undefined) {
+        throw new CogentaError({
+            code: 'BACKUP_PASSPHRASE_REQUIRED',
+            message: 'This backup is encrypted; a passphrase is required to read it.',
+            hint: 'Pass the passphrase used at `cogenta backup --encrypt` time.',
+        });
+    }
+    return decryptStream(raw, passphrase);
+}
+/**
+ * Recomputes the manifest's checksum over the backup's own bytes and throws
+ * if it does not match — task 3's "somme de contrôle vérifiée avant
+ * restauration", called by `applyRestore` before it writes a single row, and
+ * exposed on its own for a caller (the admin's restore screen, `cogenta
+ * restore --dry-run`) that wants to check a file without touching a database.
+ */
+export async function verifyBackup(path, options = {}) {
+    const manifest = await readBackupManifest(path);
+    const zip = await openZip(path);
+    try {
+        const hash = createHash('sha256');
+        for (const table of manifest.tables) {
+            for await (const chunk of tablePlaintext(zip, table, manifest, options.passphrase)) {
+                hash.update(chunk);
+            }
+        }
+        const checksum = hash.digest('hex');
+        if (checksum !== manifest.checksum) {
+            throw new CogentaError({
+                code: 'BACKUP_CHECKSUM_MISMATCH',
+                message: 'The backup file does not match its own checksum.',
+                hint: 'The file is corrupted or was modified after it was created. Restore from a different copy.',
+                details: { expected: manifest.checksum, found: checksum },
+            });
+        }
+        return manifest;
+    }
+    finally {
+        await zip.close();
+    }
+}
+/**
+ * "Ce qui sera écrasé, ce qui sera ajouté" (task 4) — a read-only pass that
+ * verifies the checksum and, for every table the target database already has
+ * created, counts what is already there. A table this database has never
+ * created (a fresh site, mid-migration) reports `rowsExisting: 0` rather than
+ * failing, since that is exactly the case an empty-site restore expects.
+ */
+export async function previewRestore(path, db, options = {}) {
+    const manifest = await verifyBackup(path, options);
+    const tables = [];
+    for (const table of manifest.tables) {
+        let rowsExisting = 0;
+        try {
+            const result = await db.query(sql `select count(*) as n from ${identifier(table.name, db.dialect)}`);
+            rowsExisting = Number(result.rows[0]?.n ?? 0);
+        }
+        catch {
+            // The table does not exist yet on this database — a fresh site being
+            // restored into before its schema has been created. That is reported
+            // as "nothing there yet", not as a failure of the preview.
+            rowsExisting = 0;
+        }
+        tables.push({ name: table.name, rowsInBackup: table.rows, rowsExisting });
+    }
+    return { manifest, tables };
+}
+function* splitLines(buffer) {
+    let start = 0;
+    for (;;) {
+        const index = buffer.indexOf('\n', start);
+        if (index === -1) {
+            if (start < buffer.length)
+                yield buffer.slice(start);
+            return;
+        }
+        yield buffer.slice(start, index);
+        start = index + 1;
+    }
+}
+/**
+ * Restores every table of a backup, in the manifest's own order — the same
+ * dependency order `buildBackupTables` produced it in, so a foreign key never
+ * meets a row it references before that row exists.
+ *
+ * **Full restore only, by design (task 4).** This function does not decide
+ * who may call it; `packages/cli`'s `cogenta restore` is the only caller
+ * this codebase gives a full restore to — the admin API restores a *content*
+ * export instead (`importContent`), never a whole-database backup, because
+ * that would let a browser session overwrite the database it is itself
+ * running against.
+ */
+export async function applyRestore(path, options) {
+    const manifest = await verifyBackup(path, options.passphrase === undefined ? {} : { passphrase: options.passphrase });
+    const zip = await openZip(path);
+    const report = [];
+    try {
+        for (const table of manifest.tables) {
+            let rows = 0;
+            let carry = '';
+            const tableIdentifier = identifier(table.name, options.db.dialect);
+            for await (const chunk of tablePlaintext(zip, table, manifest, options.passphrase)) {
+                carry += chunk.toString('utf8');
+                const lastNewline = carry.lastIndexOf('\n');
+                if (lastNewline === -1)
+                    continue;
+                const complete = carry.slice(0, lastNewline);
+                carry = carry.slice(lastNewline + 1);
+                for (const line of splitLines(complete)) {
+                    if (line.trim().length === 0)
+                        continue;
+                    await insertRow(options.db, tableIdentifier, table.name, JSON.parse(line));
+                    rows += 1;
+                }
+            }
+            if (carry.trim().length > 0) {
+                await insertRow(options.db, tableIdentifier, table.name, JSON.parse(carry));
+                rows += 1;
+            }
+            report.push({ name: table.name, rows });
+        }
+    }
+    finally {
+        await zip.close();
+    }
+    return { tables: report };
+}
+function joinFragments(parts, separator) {
+    return parts.reduce((acc, next, index) => (index === 0 ? next : sql `${acc}${unsafeRaw(separator)}${next}`), unsafeRaw(''));
+}
+async function insertRow(db, table, tableName, row) {
+    const columns = Object.keys(row);
+    if (columns.length === 0)
+        return;
+    const columnList = joinFragments(columns.map((column) => identifier(column, db.dialect)), ', ');
+    const valueList = joinFragments(columns.map((column) => sql `${row[column]}`), ', ');
+    try {
+        await db.query(sql `insert into ${table} (${columnList}) values (${valueList})`);
+    }
+    catch (cause) {
+        throw new CogentaError({
+            code: 'RESTORE_CONFLICT',
+            message: `Could not insert a row into "${tableName}" while restoring.`,
+            hint: 'The target database is probably not empty. Restore into a freshly created database.',
+            cause,
+        });
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/restore.js.map

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

package/dist/tables.d.ts

@@ -0,0 +1,28 @@
+import { type CollectionDefinition, type TaxonomyDefinition } from '@cogenta/schema';
+export interface BuildBackupTablesOptions {
+    readonly collections: readonly CollectionDefinition[];
+    readonly taxonomies: readonly TaxonomyDefinition[];
+    /**
+     * Tables outside the content schema that content may reference — users,
+     * media — listed first so a foreign key in a content table always finds
+     * its target already restored. Order is the caller's: `@cogenta/export`
+     * does not know `@cogenta/auth` or `@cogenta/core`'s media table exists,
+     * by design (it depends on neither), so it trusts whoever assembled the
+     * site to have put users before sessions and so on.
+     */
+    readonly before?: readonly string[];
+    /**
+     * Tables that may reference content — navigation menus, redirects, a
+     * commerce catalogue — listed last for the same reason, in reverse.
+     */
+    readonly after?: readonly string[];
+}
+/**
+ * Every physical table backup task 3 needs to know about, in an order a
+ * forward-only restore can insert into without ever meeting a foreign key
+ * before its target: `before`, then taxonomy terms, then content in
+ * dependency order (`orderByDependency`, the same helper table creation
+ * itself uses), then `after`.
+ */
+export declare function buildBackupTables(options: BuildBackupTablesOptions): readonly string[];
+//# sourceMappingURL=tables.d.ts.map

package/dist/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAKzB,KAAK,kBAAkB,EAGxB,MAAM,iBAAiB,CAAA;AAExB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACrD,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAClD;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,SAAS,MAAM,EAAE,CAkBtF"}

package/dist/tables.js

@@ -0,0 +1,26 @@
+import { blocksTable, entriesTable, orderByDependency, relationsOf, relationTable, taxonomyTable, versionsTable, } from '@cogenta/schema';
+/**
+ * Every physical table backup task 3 needs to know about, in an order a
+ * forward-only restore can insert into without ever meeting a foreign key
+ * before its target: `before`, then taxonomy terms, then content in
+ * dependency order (`orderByDependency`, the same helper table creation
+ * itself uses), then `after`.
+ */
+export function buildBackupTables(options) {
+    const tables = [...(options.before ?? [])];
+    for (const taxonomy of options.taxonomies) {
+        tables.push(taxonomyTable(taxonomy.name));
+    }
+    for (const collection of orderByDependency(options.collections)) {
+        tables.push(entriesTable(collection.name));
+        tables.push(versionsTable(collection.name));
+        tables.push(blocksTable(collection.name));
+        for (const relation of relationsOf(collection)) {
+            if (relation.many)
+                tables.push(relationTable(collection.name, relation.field));
+        }
+    }
+    tables.push(...(options.after ?? []));
+    return tables;
+}
+//# sourceMappingURL=tables.js.map

package/dist/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAEX,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,aAAa,EAEb,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAA;AAqBxB;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,MAAM,GAAa,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAA;IAEpD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QAC1C,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QACzC,KAAK,MAAM,QAAQ,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,IAAI,QAAQ,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;QAChF,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAA;IACrC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/zip-reader.d.ts

@@ -0,0 +1,13 @@
+export interface ZipEntry {
+    readonly name: string;
+    readonly size: number;
+    readonly localHeaderOffset: number;
+}
+export interface ZipReader {
+    readonly entries: readonly ZipEntry[];
+    /** Streams one entry's raw (stored, uncompressed) bytes in fixed-size chunks. */
+    read(name: string): AsyncGenerator<Buffer>;
+    close(): Promise<void>;
+}
+export declare function openZip(path: string): Promise<ZipReader>;
+//# sourceMappingURL=zip-reader.d.ts.map

package/dist/zip-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-reader.d.ts","sourceRoot":"","sources":["../src/zip-reader.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAA;IACrC,iFAAiF;IACjF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAWD,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA4D9D"}

package/dist/zip-reader.js

@@ -0,0 +1,97 @@
+import { open } from 'node:fs/promises';
+import { CogentaError } from '@cogenta/core';
+/**
+ * Reads back what `zip-writer.ts` writes: a store-mode ZIP with a trailing
+ * data descriptor per entry. Random-access, via the file's own end-of-central-
+ * directory record — a backup or media archive is read from disk (never from
+ * an in-memory buffer), so seeking to exactly the bytes one entry needs costs
+ * nothing extra, and the file itself is never read in full.
+ */
+const END_OF_CENTRAL_DIRECTORY_SIGNATURE = 0x06054b50;
+const CENTRAL_DIRECTORY_SIGNATURE = 0x02014b50;
+const LOCAL_HEADER_FIXED_LENGTH = 30;
+/** The end-of-central-directory record is 22 bytes, plus up to 65535 bytes of comment this writer never sets — 4 KiB covers any real file. */
+const EOCD_SEARCH_WINDOW = 4096;
+function notAnArchive(cause) {
+    return new CogentaError({
+        code: 'EXPORT_FORMAT_INVALID',
+        message: 'This file is not a Cogenta archive (no end-of-central-directory record found).',
+        hint: 'Restore only files produced by `cogenta backup` / `@cogenta/export`.',
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+export async function openZip(path) {
+    const handle = await open(path, 'r');
+    const stat = await handle.stat();
+    const tailLength = Math.min(EOCD_SEARCH_WINDOW, stat.size);
+    const tail = Buffer.alloc(tailLength);
+    await handle.read(tail, 0, tailLength, stat.size - tailLength);
+    let eocdOffset = -1;
+    for (let i = tail.length - 22; i >= 0; i -= 1) {
+        if (tail.readUInt32LE(i) === END_OF_CENTRAL_DIRECTORY_SIGNATURE) {
+            eocdOffset = i;
+            break;
+        }
+    }
+    if (eocdOffset === -1) {
+        await handle.close();
+        throw notAnArchive();
+    }
+    const entryCount = tail.readUInt16LE(eocdOffset + 10);
+    const centralDirectorySize = tail.readUInt32LE(eocdOffset + 12);
+    const centralDirectoryStart = tail.readUInt32LE(eocdOffset + 16);
+    const centralDirectory = Buffer.alloc(centralDirectorySize);
+    await handle.read(centralDirectory, 0, centralDirectorySize, centralDirectoryStart);
+    const entries = [];
+    let cursor = 0;
+    for (let i = 0; i < entryCount; i += 1) {
+        if (centralDirectory.readUInt32LE(cursor) !== CENTRAL_DIRECTORY_SIGNATURE) {
+            await handle.close();
+            throw notAnArchive();
+        }
+        const size = centralDirectory.readUInt32LE(cursor + 24);
+        const nameLength = centralDirectory.readUInt16LE(cursor + 28);
+        const extraLength = centralDirectory.readUInt16LE(cursor + 30);
+        const commentLength = centralDirectory.readUInt16LE(cursor + 32);
+        const localHeaderOffset = centralDirectory.readUInt32LE(cursor + 42);
+        const nameStart = cursor + 46;
+        const name = centralDirectory.toString('utf8', nameStart, nameStart + nameLength);
+        entries.push({ name, size, localHeaderOffset });
+        cursor = nameStart + nameLength + extraLength + commentLength;
+    }
+    return {
+        entries,
+        async *read(name) {
+            const entry = entries.find((candidate) => candidate.name === name);
+            if (entry === undefined) {
+                throw new CogentaError({
+                    code: 'EXPORT_FORMAT_INVALID',
+                    message: `The archive has no entry named "${name}".`,
+                    hint: 'The archive is incomplete or was not produced by this package.',
+                    details: { name },
+                });
+            }
+            yield* readEntryBody(handle, entry);
+        },
+        close: () => handle.close(),
+    };
+}
+async function* readEntryBody(handle, entry) {
+    const header = Buffer.alloc(LOCAL_HEADER_FIXED_LENGTH);
+    await handle.read(header, 0, LOCAL_HEADER_FIXED_LENGTH, entry.localHeaderOffset);
+    const nameLength = header.readUInt16LE(26);
+    const extraLength = header.readUInt16LE(28);
+    const dataStart = entry.localHeaderOffset + LOCAL_HEADER_FIXED_LENGTH + nameLength + extraLength;
+    const CHUNK_SIZE = 64 * 1024;
+    let remaining = entry.size;
+    let position = dataStart;
+    while (remaining > 0) {
+        const size = Math.min(CHUNK_SIZE, remaining);
+        const buffer = Buffer.alloc(size);
+        await handle.read(buffer, 0, size, position);
+        yield buffer;
+        remaining -= size;
+        position += size;
+    }
+}
+//# sourceMappingURL=zip-reader.js.map

package/dist/zip-reader.js.map

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

package/dist/zip-writer.d.ts

@@ -0,0 +1,16 @@
+export interface ZipWriter {
+    /**
+     * Streams one file into the archive. `data` may be a `Buffer` or an
+     * `AsyncIterable<Buffer>` (a `Readable` satisfies this) — either way, bytes
+     * are written to `sink` as they arrive rather than assembled in memory.
+     */
+    addFile(name: string, data: Buffer | AsyncIterable<Buffer>): Promise<void>;
+    /** Writes the central directory and end record. Call exactly once, last. */
+    finish(): Promise<void>;
+}
+export interface CreateZipWriterOptions {
+    /** Called with each chunk of the archive, in order. */
+    readonly write: (chunk: Buffer) => Promise<void> | void;
+}
+export declare function createZipWriter(options: CreateZipWriterOptions): ZipWriter;
+//# sourceMappingURL=zip-writer.d.ts.map

package/dist/zip-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-writer.d.ts","sourceRoot":"","sources":["../src/zip-writer.ts"],"names":[],"mappings":"AAmDA,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,4EAA4E;IAC5E,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACxD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CA+G1E"}

package/dist/zip-writer.js

@@ -0,0 +1,143 @@
+import { crc32 } from 'node:zlib';
+import { CogentaError } from '@cogenta/core';
+/**
+ * A streaming, store-only (uncompressed) ZIP writer. Zero dependencies (R9):
+ * `node:zlib` already has the one non-trivial piece a ZIP needs (`crc32`),
+ * and the container format itself is a few hundred bytes of bookkeeping.
+ *
+ * **Store, not deflate, on purpose.** The two things this writer bundles —
+ * media originals and NDJSON table dumps — are either already compressed
+ * (images) or compress cheaply enough at rest that a second pass buys little
+ * (`gzip -9` on a backup's NDJSON is a caller's choice, layered outside this
+ * writer, never inside it). Store mode also means every entry's compressed
+ * size equals its real size, known before the bytes are read — which is what
+ * lets this writer emit each entry's local header, data and data descriptor
+ * as they stream past, and hold nothing beyond the current entry in memory.
+ *
+ * A `.zip` is otherwise unremarkable: local file headers first, then a
+ * central directory naming every one of them, then one end-of-central-
+ * directory record. Every unzip tool reads it the same way.
+ */
+const LOCAL_FILE_HEADER_SIGNATURE = 0x04034b50;
+const CENTRAL_DIRECTORY_SIGNATURE = 0x02014b50;
+const END_OF_CENTRAL_DIRECTORY_SIGNATURE = 0x06054b50;
+/** ZIP64 is not implemented: `@cogenta/agents`' reader does not need it either, and a backup or media archive over 4 GiB is a `docs/hebergement-mutualise.md`-scale exception, not the common case this package targets. */
+const MAX_ENTRY_SIZE = 0xffffffff;
+/** DOS date/time, fixed at the Unix epoch: content, not the archive's own timestamp, is what a Cogenta export means to preserve. */
+const DOS_TIME = 0;
+const DOS_DATE = 0b0000000000100001; // 1980-01-01, the DOS epoch
+function u16(value) {
+    const buffer = Buffer.alloc(2);
+    buffer.writeUInt16LE(value, 0);
+    return buffer;
+}
+function u32(value) {
+    const buffer = Buffer.alloc(4);
+    buffer.writeUInt32LE(value, 0);
+    return buffer;
+}
+export function createZipWriter(options) {
+    const entries = [];
+    let offset = 0;
+    const write = async (chunk) => {
+        await options.write(chunk);
+        offset += chunk.length;
+    };
+    return {
+        async addFile(name, data) {
+            const nameBuffer = Buffer.from(name, 'utf8');
+            const localHeaderOffset = offset;
+            // Store mode with a trailing data descriptor: the size and CRC are not
+            // known until the last byte has streamed past, so the local header
+            // declares them as zero and a descriptor after the data carries the
+            // real values — a ZIP reader is required to accept this (general
+            // purpose bit 3), and it is what makes streaming a file of unknown
+            // length possible without buffering it first.
+            const generalPurposeFlag = 0b0000000000001000;
+            const localHeader = Buffer.concat([
+                u32(LOCAL_FILE_HEADER_SIGNATURE),
+                u16(20), // version needed to extract
+                u16(generalPurposeFlag),
+                u16(0), // compression method: store
+                u16(DOS_TIME),
+                u16(DOS_DATE),
+                u32(0), // crc-32 (deferred)
+                u32(0), // compressed size (deferred)
+                u32(0), // uncompressed size (deferred)
+                u16(nameBuffer.length),
+                u16(0), // extra field length
+                nameBuffer,
+            ]);
+            await write(localHeader);
+            let crc = 0;
+            let size = 0;
+            if (Buffer.isBuffer(data)) {
+                crc = crc32(data);
+                size = data.length;
+                await write(data);
+            }
+            else {
+                for await (const chunk of data) {
+                    crc = crc32(chunk, crc);
+                    size += chunk.length;
+                    await write(chunk);
+                }
+            }
+            if (size > MAX_ENTRY_SIZE) {
+                throw new CogentaError({
+                    code: 'EXPORT_ENTRY_TOO_LARGE',
+                    message: `"${name}" is ${size} bytes; this writer does not implement ZIP64.`,
+                    hint: `Split the archive, or keep entries under ${MAX_ENTRY_SIZE} bytes.`,
+                    details: { name, size, max: MAX_ENTRY_SIZE },
+                });
+            }
+            const descriptor = Buffer.concat([
+                u32(0x08074b50), // optional but conventional signature
+                u32(crc >>> 0),
+                u32(size),
+                u32(size),
+            ]);
+            await write(descriptor);
+            entries.push({ name: nameBuffer, crc32: crc >>> 0, size, offset: localHeaderOffset });
+        },
+        async finish() {
+            const centralDirectoryStart = offset;
+            for (const entry of entries) {
+                const header = Buffer.concat([
+                    u32(CENTRAL_DIRECTORY_SIGNATURE),
+                    u16(20), // version made by
+                    u16(20), // version needed to extract
+                    u16(0b0000000000001000), // general purpose flag (data descriptor used)
+                    u16(0), // compression method: store
+                    u16(DOS_TIME),
+                    u16(DOS_DATE),
+                    u32(entry.crc32),
+                    u32(entry.size),
+                    u32(entry.size),
+                    u16(entry.name.length),
+                    u16(0), // extra field length
+                    u16(0), // file comment length
+                    u16(0), // disk number start
+                    u16(0), // internal file attributes
+                    u32(0), // external file attributes
+                    u32(entry.offset),
+                    entry.name,
+                ]);
+                await write(header);
+            }
+            const centralDirectorySize = offset - centralDirectoryStart;
+            const end = Buffer.concat([
+                u32(END_OF_CENTRAL_DIRECTORY_SIGNATURE),
+                u16(0), // this disk
+                u16(0), // disk with central directory start
+                u16(entries.length),
+                u16(entries.length),
+                u32(centralDirectorySize),
+                u32(centralDirectoryStart),
+                u16(0), // comment length
+            ]);
+            await write(end);
+        },
+    };
+}
+//# sourceMappingURL=zip-writer.js.map

package/dist/zip-writer.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@cogenta/export",
+  "version": "0.2.3",
+  "description": "Content export/import, site backup/restore and GDPR export — export@1.0.",
+  "license": "MPL-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.11.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cogenta-cms/cogenta.git",
+    "directory": "packages/export"
+  },
+  "dependencies": {
+    "@cogenta/core": "0.8.0",
+    "@cogenta/auth": "0.5.2",
+    "@cogenta/schema": "0.5.1"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run --passWithNoTests",
+    "test:integration": "vitest run --config vitest.integration.config.ts --passWithNoTests"
+  }
+}