@cogenta/export 0.2.3

package/dist/content-export.js

@@ -0,0 +1,197 @@
+import { orderByDependency, } from '@cogenta/schema';
+import { EXPORT_FORMAT, EXPORT_FORMAT_VERSION, encodeRecord, } from './format.js';
+const PAGE_SIZE = 200;
+function inSelection(selection, name) {
+    if (selection?.collections === undefined)
+        return true;
+    return selection.collections.includes(name);
+}
+function mediaIdsOf(value) {
+    if (typeof value === 'string')
+        return [value];
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === 'string');
+    }
+    return [];
+}
+/**
+ * Streams a whole export as NDJSON text, one `ExportRecord` per line, and
+ * resolves to the exact counts and the set of referenced media ids once every
+ * record has been produced.
+ *
+ * The manifest is the **first** line rather than a sibling file: a two-file
+ * export can drift out of step (one gets copied, the other does not), one
+ * stream cannot. Its `counts` are written as zero and are informational only
+ * on this first pass — a reader that needs exact counts before it starts
+ * reads `exportContentToLines`'s returned `ExportResult` instead, which is
+ * what `cogenta export` writes back into the manifest once the file is
+ * seekable.
+ */
+export async function* exportContent(options) {
+    const selection = options.selection ?? {};
+    const canReadCollection = options.canReadCollection ?? (() => true);
+    const canReadTaxonomy = options.canReadTaxonomy ?? (() => true);
+    const now = options.now ?? (() => new Date());
+    const counts = { entries: 0, terms: 0, menus: 0, menuItems: 0, redirects: 0, mediaRefs: 0 };
+    const mediaSeen = new Set();
+    const manifest = {
+        kind: 'manifest',
+        format: EXPORT_FORMAT,
+        version: EXPORT_FORMAT_VERSION,
+        createdAt: now().toISOString(),
+        site: options.site,
+        selection,
+        counts,
+    };
+    yield encodeRecord(manifest);
+    // Taxonomies before collections, and collections in dependency order
+    // (`orderByDependency`, the same helper `createSchemaTables` uses to
+    // decide table creation order): a `f.taxonomy()` or `f.relation()` field
+    // is a foreign key, and `content-import.ts` replays this exact stream in a
+    // single forward pass rather than buffering it, so whatever it needs to
+    // already exist has to have been emitted already.
+    for (const taxonomy of options.taxonomies) {
+        if (!canReadTaxonomy(taxonomy))
+            continue;
+        const store = options.taxonomyStoreFor(taxonomy);
+        const terms = await store.list();
+        for (const term of terms) {
+            counts.terms += 1;
+            const record = {
+                kind: 'term',
+                taxonomy: taxonomy.name,
+                id: term.id,
+                slug: term.slug,
+                parent: term.parent,
+                position: term.position,
+                labels: term.labels,
+            };
+            yield encodeRecord(record);
+        }
+    }
+    for (const collection of orderByDependency(options.collections)) {
+        if (!inSelection(selection, collection.name))
+            continue;
+        if (!canReadCollection(collection))
+            continue;
+        const mediaFields = Object.entries(collection.fields)
+            .filter(([, field]) => field.kind === 'media')
+            .map(([name]) => name);
+        const store = options.storeFor(collection);
+        let cursor;
+        for (;;) {
+            const page = await store.list({
+                state: 'working',
+                limit: PAGE_SIZE,
+                trashed: selection.includeTrashed === true ? 'include' : 'exclude',
+                ...(cursor === undefined ? {} : { cursor }),
+            });
+            for (const entry of page.items) {
+                if (selection.statuses !== undefined && !selection.statuses.includes(entry.status)) {
+                    continue;
+                }
+                if (selection.locales !== undefined && !selection.locales.includes(entry.locale)) {
+                    continue;
+                }
+                if (selection.from !== undefined && entry.updatedAt < selection.from)
+                    continue;
+                if (selection.to !== undefined && entry.updatedAt > selection.to)
+                    continue;
+                counts.entries += 1;
+                yield encodeRecord({
+                    kind: 'entry',
+                    collection: collection.name,
+                    id: entry.id,
+                    locale: entry.locale,
+                    translationOf: entry.translationOf,
+                    status: entry.status,
+                    deletedAt: entry.deletedAt,
+                    version: entry.version,
+                    provenance: entry.provenance,
+                    provenanceDetail: entry.provenanceDetail ?? null,
+                    createdAt: entry.createdAt,
+                    updatedAt: entry.updatedAt,
+                    createdBy: entry.createdBy,
+                    updatedBy: entry.updatedBy,
+                    publishedAt: entry.publishedAt,
+                    values: entry.values,
+                    blocks: entry.blocks,
+                });
+                for (const field of mediaFields) {
+                    for (const id of mediaIdsOf(entry.values[field]))
+                        mediaSeen.add(id);
+                }
+                if (selection.includeHistory === true) {
+                    const history = await store.history(entry.id, { trashed: 'include' });
+                    for (const version of history) {
+                        const record = {
+                            kind: 'version',
+                            collection: collection.name,
+                            entryId: entry.id,
+                            version: version.version,
+                            status: version.status,
+                            createdAt: version.createdAt,
+                            createdBy: version.createdBy,
+                        };
+                        yield encodeRecord(record);
+                    }
+                }
+            }
+            if (!page.hasMore || page.nextCursor === null)
+                break;
+            cursor = page.nextCursor;
+        }
+    }
+    if (options.menus !== undefined) {
+        const menus = await options.menus.list();
+        for (const menu of menus) {
+            counts.menus += 1;
+            const record = {
+                kind: 'menu',
+                id: menu.id,
+                name: menu.name,
+                locale: menu.locale,
+                label: menu.label,
+            };
+            yield encodeRecord(record);
+            const items = await options.menus.listItems(menu.id);
+            for (const item of items) {
+                counts.menuItems += 1;
+                const itemRecord = {
+                    kind: 'menu-item',
+                    id: item.id,
+                    menuId: menu.id,
+                    parent: item.parent,
+                    position: item.position,
+                    label: item.label,
+                    itemKind: item.kind,
+                    url: item.url,
+                    targetCollection: item.targetCollection,
+                    targetEntryId: item.targetEntryId,
+                    openInNewTab: item.openInNewTab,
+                };
+                yield encodeRecord(itemRecord);
+            }
+        }
+    }
+    if (options.redirects !== undefined) {
+        const redirects = await options.redirects.list({ limit: 100_000 });
+        for (const redirect of redirects) {
+            counts.redirects += 1;
+            const record = {
+                kind: 'redirect',
+                from: redirect.from,
+                to: redirect.to,
+                status: redirect.status,
+                collection: redirect.collection,
+                entryId: redirect.entryId,
+                locale: redirect.locale,
+                reason: redirect.reason,
+            };
+            yield encodeRecord(record);
+        }
+    }
+    counts.mediaRefs = mediaSeen.size;
+    return { counts, mediaIds: [...mediaSeen] };
+}
+//# sourceMappingURL=content-export.js.map

package/dist/content-export.js.map

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

package/dist/content-import.d.ts

@@ -0,0 +1,44 @@
+import type { CollectionDefinition, ContentStore, MenuStore, RedirectStore, TaxonomyDefinition, TaxonomyStore } from '@cogenta/schema';
+export interface ImportContentOptions {
+    readonly collections: readonly CollectionDefinition[];
+    readonly taxonomies: readonly TaxonomyDefinition[];
+    readonly storeFor: (collection: CollectionDefinition) => ContentStore;
+    readonly taxonomyStoreFor: (taxonomy: TaxonomyDefinition) => TaxonomyStore;
+    readonly menus?: MenuStore;
+    readonly redirects?: RedirectStore;
+    /**
+     * `'skip'` (the default): a record whose id already exists in the target is
+     * left alone and counted in `report.skipped`. `'fail'` stops the whole
+     * import at the first collision — appropriate for "restore a content
+     * export into an empty site", where any collision means the site was not
+     * actually empty and the caller should know before more damage is done.
+     */
+    readonly onConflict?: 'skip' | 'fail';
+}
+export interface ImportReport {
+    readonly entries: number;
+    readonly terms: number;
+    readonly menus: number;
+    readonly menuItems: number;
+    readonly redirects: number;
+    readonly skipped: number;
+    readonly errors: readonly {
+        readonly kind: string;
+        readonly id: string;
+        readonly message: string;
+    }[];
+}
+/**
+ * Applies one line of an export stream at a time — the counterpart of
+ * `exportContent`, replaying the exact ordering it committed to (taxonomies,
+ * then collections in dependency order, then menus, then redirects) so a
+ * forward-only pass never needs the row it has not seen yet.
+ *
+ * The one exception is a translation whose source entry appears later than
+ * itself in the stream (possible when a store's default list order is not
+ * strictly creation order): such an entry is deferred to a small pending
+ * queue — bounded by how many translations are out of order, never by the
+ * size of the export — and retried once the stream ends.
+ */
+export declare function importContent(lines: AsyncIterable<string> | Iterable<string>, options: ImportContentOptions): Promise<ImportReport>;
+//# sourceMappingURL=content-import.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-import.d.ts","sourceRoot":"","sources":["../src/content-import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,aAAa,EACd,MAAM,iBAAiB,CAAA;AAGxB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACrD,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,YAAY,CAAA;IACrE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,aAAa,CAAA;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAA;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KACzB,EAAE,CAAA;CACJ;AAcD;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAmNvB"}

package/dist/content-import.js

@@ -0,0 +1,221 @@
+import { CogentaError } from '@cogenta/core';
+import { assertManifest, decodeRecord } from './format.js';
+function emptyReport() {
+    return { entries: 0, terms: 0, menus: 0, menuItems: 0, redirects: 0, skipped: 0, errors: [] };
+}
+/**
+ * Applies one line of an export stream at a time — the counterpart of
+ * `exportContent`, replaying the exact ordering it committed to (taxonomies,
+ * then collections in dependency order, then menus, then redirects) so a
+ * forward-only pass never needs the row it has not seen yet.
+ *
+ * The one exception is a translation whose source entry appears later than
+ * itself in the stream (possible when a store's default list order is not
+ * strictly creation order): such an entry is deferred to a small pending
+ * queue — bounded by how many translations are out of order, never by the
+ * size of the export — and retried once the stream ends.
+ */
+export async function importContent(lines, options) {
+    const onConflict = options.onConflict ?? 'skip';
+    const report = emptyReport();
+    const collectionByName = new Map(options.collections.map((c) => [c.name, c]));
+    const taxonomyByName = new Map(options.taxonomies.map((t) => [t.name, t]));
+    const pendingTranslations = [];
+    let sawManifest = false;
+    let lineNumber = 0;
+    const applyEntry = async (record, allowDefer = true) => {
+        const collection = collectionByName.get(record.collection);
+        if (collection === undefined) {
+            report.errors.push({
+                kind: 'entry',
+                id: record.id,
+                message: `Collection "${record.collection}" does not exist in the target site.`,
+            });
+            return;
+        }
+        const store = options.storeFor(collection);
+        const existing = await store.read(record.id, { state: 'working', trashed: 'include' });
+        if (existing !== null) {
+            if (onConflict === 'fail') {
+                throw new CogentaError({
+                    code: 'RESTORE_CONFLICT',
+                    message: `Entry "${record.id}" of "${record.collection}" already exists in the target.`,
+                    hint: 'Import into an empty site, or pass onConflict: "skip".',
+                    details: { collection: record.collection, id: record.id },
+                });
+            }
+            report.skipped += 1;
+            return;
+        }
+        if (record.translationOf !== null) {
+            const source = await store.read(record.translationOf, {
+                state: 'working',
+                trashed: 'include',
+            });
+            if (source === null) {
+                if (allowDefer)
+                    pendingTranslations.push(record);
+                return;
+            }
+        }
+        await store.create({
+            id: record.id,
+            locale: record.locale,
+            translationOf: record.translationOf,
+            status: record.status,
+            createdBy: record.createdBy,
+            provenance: record.provenance,
+            ...(record.provenanceDetail === null ? {} : { provenanceDetail: record.provenanceDetail }),
+            values: record.values,
+            blocks: record.blocks,
+        });
+        if (record.deletedAt !== null)
+            await store.delete(record.id);
+        report.entries += 1;
+    };
+    const applyRecord = async (record) => {
+        switch (record.kind) {
+            case 'manifest':
+                assertManifest(record);
+                sawManifest = true;
+                return;
+            case 'entry':
+                await applyEntry(record);
+                return;
+            case 'version':
+                // Version history is informational (task 1's "avec ou sans historique
+                // de versions"); it is exported for archival reading, not replayed —
+                // `ContentStore` has no "insert a past version" primitive, and
+                // fabricating one would misreport who wrote what, when.
+                return;
+            case 'term': {
+                const taxonomy = taxonomyByName.get(record.taxonomy);
+                if (taxonomy === undefined) {
+                    report.errors.push({
+                        kind: 'term',
+                        id: record.id,
+                        message: `Taxonomy "${record.taxonomy}" does not exist in the target site.`,
+                    });
+                    return;
+                }
+                const store = options.taxonomyStoreFor(taxonomy);
+                const existing = await store.read(record.id);
+                if (existing !== null) {
+                    if (onConflict === 'fail') {
+                        throw new CogentaError({
+                            code: 'RESTORE_CONFLICT',
+                            message: `Term "${record.id}" of "${record.taxonomy}" already exists in the target.`,
+                            hint: 'Import into an empty site, or pass onConflict: "skip".',
+                        });
+                    }
+                    report.skipped += 1;
+                    return;
+                }
+                await store.create({
+                    id: record.id,
+                    slug: record.slug,
+                    labels: record.labels,
+                    parent: record.parent,
+                    position: record.position,
+                });
+                report.terms += 1;
+                return;
+            }
+            case 'menu': {
+                if (options.menus === undefined)
+                    return;
+                const existing = await options.menus.read(record.id);
+                if (existing !== null) {
+                    if (onConflict === 'fail') {
+                        throw new CogentaError({
+                            code: 'RESTORE_CONFLICT',
+                            message: `Menu "${record.id}" already exists in the target.`,
+                            hint: 'Import into an empty site, or pass onConflict: "skip".',
+                        });
+                    }
+                    report.skipped += 1;
+                    return;
+                }
+                await options.menus.create({
+                    id: record.id,
+                    name: record.name,
+                    locale: record.locale,
+                    label: record.label,
+                });
+                report.menus += 1;
+                return;
+            }
+            case 'menu-item': {
+                if (options.menus === undefined)
+                    return;
+                const existing = await options.menus.readItem(record.id);
+                if (existing !== null) {
+                    report.skipped += 1;
+                    return;
+                }
+                await options.menus.createItem(record.menuId, {
+                    id: record.id,
+                    label: record.label,
+                    kind: record.itemKind,
+                    parent: record.parent,
+                    targetCollection: record.targetCollection,
+                    targetEntryId: record.targetEntryId,
+                    url: record.url,
+                    position: record.position,
+                    openInNewTab: record.openInNewTab,
+                });
+                report.menuItems += 1;
+                return;
+            }
+            case 'redirect': {
+                if (options.redirects === undefined)
+                    return;
+                await options.redirects.add({
+                    from: record.from,
+                    to: record.to,
+                    status: record.status,
+                    reason: 'import',
+                    ...(record.collection === null ? {} : { collection: record.collection }),
+                    ...(record.entryId === null ? {} : { entryId: record.entryId }),
+                    ...(record.locale === null ? {} : { locale: record.locale }),
+                });
+                report.redirects += 1;
+                return;
+            }
+            default:
+                return;
+        }
+    };
+    for await (const line of lines) {
+        if (line.trim().length === 0)
+            continue;
+        lineNumber += 1;
+        const record = decodeRecord(line, lineNumber);
+        await applyRecord(record);
+    }
+    if (!sawManifest) {
+        throw new CogentaError({
+            code: 'EXPORT_FORMAT_INVALID',
+            message: 'The import stream never carried a manifest record.',
+            hint: 'The first line of a Cogenta export must be `{"kind":"manifest",…}`.',
+        });
+    }
+    // Retry deferred translations, in the order they were deferred. A source
+    // that is itself still missing after this pass is a genuinely broken
+    // export (a translation whose source was never included) rather than an
+    // ordering artefact, and is reported as an error instead of retried forever.
+    for (const record of [...pendingTranslations]) {
+        const entriesBefore = report.entries;
+        const skippedBefore = report.skipped;
+        await applyEntry(record, false);
+        if (report.entries === entriesBefore && report.skipped === skippedBefore) {
+            report.errors.push({
+                kind: 'entry',
+                id: record.id,
+                message: `Translation source "${record.translationOf}" was never found in the export.`,
+            });
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=content-import.js.map

package/dist/content-import.js.map

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

package/dist/crypto.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Encrypts a byte stream, never buffering more than one chunk at a time.
+ *
+ * Framing: `MAGIC(5) | salt(16) | iv(12) | ciphertext(…) | authTag(16)`. The
+ * tag trails the ciphertext because GCM only finalises it once every byte has
+ * passed through the cipher — putting it up front would require buffering the
+ * whole backup first, which is exactly what task 2's "never assembled in
+ * memory" rules out.
+ */
+export declare function encryptStream(input: AsyncIterable<Buffer> | Iterable<Buffer>, passphrase: string): AsyncGenerator<Buffer>;
+/**
+ * Decrypts a stream produced by `encryptStream`. Holds at most one input
+ * chunk plus a `TAG_LENGTH`-byte lookback buffer at a time — the lookback is
+ * what lets the trailing auth tag be recognised without having read the whole
+ * file first.
+ */
+export declare function decryptStream(input: AsyncIterable<Buffer> | Iterable<Buffer>, passphrase: string): AsyncGenerator<Buffer>;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAuCA;;;;;;;;GAQG;AACH,wBAAuB,aAAa,CAClC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,EAC/C,UAAU,EAAE,MAAM,GACjB,cAAc,CAAC,MAAM,CAAC,CAexB;AAED;;;;;GAKG;AACH,wBAAuB,aAAa,CAClC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,EAC/C,UAAU,EAAE,MAAM,GACjB,cAAc,CAAC,MAAM,CAAC,CA2ExB"}

package/dist/crypto.js

@@ -0,0 +1,151 @@
+import { createCipheriv, createDecipheriv, randomBytes, scrypt as scryptCb } from 'node:crypto';
+import { CogentaError } from '@cogenta/core';
+function scrypt(passphrase, salt, keyLength, options) {
+    return new Promise((resolve, reject) => {
+        scryptCb(passphrase, salt, keyLength, options, (error, derivedKey) => {
+            if (error)
+                reject(error);
+            else
+                resolve(derivedKey);
+        });
+    });
+}
+/** `aes-256-gcm`: authenticated, so a tampered or truncated backup fails to decrypt rather than silently restoring garbage. */
+const ALGORITHM = 'aes-256-gcm';
+const KEY_LENGTH = 32;
+const SALT_LENGTH = 16;
+const IV_LENGTH = 12;
+const TAG_LENGTH = 16;
+/** `scrypt` cost parameters (RFC 7914's "interactive" profile, scaled up once): memory-hard, so a leaked backup cannot be brute-forced on a GPU as cheaply as a mere iterated hash would allow (rule of thumb: a backup carries every password hash on the site, per the plan's own piège). */
+const SCRYPT_N = 2 ** 15;
+const SCRYPT_R = 8;
+const SCRYPT_P = 1;
+const MAGIC = Buffer.from('CGEB1'); // "Cogenta Encrypted Backup, v1"
+async function deriveKey(passphrase, salt) {
+    return scrypt(passphrase, salt, KEY_LENGTH, {
+        N: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+        maxmem: 256 * 1024 * 1024,
+    });
+}
+/**
+ * Encrypts a byte stream, never buffering more than one chunk at a time.
+ *
+ * Framing: `MAGIC(5) | salt(16) | iv(12) | ciphertext(…) | authTag(16)`. The
+ * tag trails the ciphertext because GCM only finalises it once every byte has
+ * passed through the cipher — putting it up front would require buffering the
+ * whole backup first, which is exactly what task 2's "never assembled in
+ * memory" rules out.
+ */
+export async function* encryptStream(input, passphrase) {
+    const salt = randomBytes(SALT_LENGTH);
+    const iv = randomBytes(IV_LENGTH);
+    const key = await deriveKey(passphrase, salt);
+    const cipher = createCipheriv(ALGORITHM, key, iv);
+    yield Buffer.concat([MAGIC, salt, iv]);
+    for await (const chunk of input) {
+        const encrypted = cipher.update(chunk);
+        if (encrypted.length > 0)
+            yield encrypted;
+    }
+    const final = cipher.final();
+    if (final.length > 0)
+        yield final;
+    yield cipher.getAuthTag();
+}
+/**
+ * Decrypts a stream produced by `encryptStream`. Holds at most one input
+ * chunk plus a `TAG_LENGTH`-byte lookback buffer at a time — the lookback is
+ * what lets the trailing auth tag be recognised without having read the whole
+ * file first.
+ */
+export async function* decryptStream(input, passphrase) {
+    const iterator = normalise(input)[Symbol.asyncIterator]();
+    let buffered = Buffer.alloc(0);
+    const need = async (bytes) => {
+        while (buffered.length < bytes) {
+            const next = await iterator.next();
+            if (next.done === true)
+                return false;
+            buffered = Buffer.concat([buffered, next.value]);
+        }
+        return true;
+    };
+    if (!(await need(MAGIC.length + SALT_LENGTH + IV_LENGTH))) {
+        throw truncated();
+    }
+    const magic = buffered.subarray(0, MAGIC.length);
+    if (!magic.equals(MAGIC)) {
+        throw new CogentaError({
+            code: 'BACKUP_DECRYPTION_FAILED',
+            message: 'This file is not a Cogenta encrypted backup.',
+            hint: 'Decrypt only files produced by `cogenta backup --encrypt`.',
+        });
+    }
+    const salt = buffered.subarray(MAGIC.length, MAGIC.length + SALT_LENGTH);
+    const iv = buffered.subarray(MAGIC.length + SALT_LENGTH, MAGIC.length + SALT_LENGTH + IV_LENGTH);
+    buffered = buffered.subarray(MAGIC.length + SALT_LENGTH + IV_LENGTH);
+    const key = await deriveKey(passphrase, Buffer.from(salt));
+    const decipher = createDecipheriv(ALGORITHM, key, iv);
+    // Everything from here on is ciphertext, except the final TAG_LENGTH bytes
+    // of the whole stream. Only the boundary is uncertain until the stream
+    // ends, so at most TAG_LENGTH bytes are ever held back. `buffered` may
+    // already hold more than the header when the source handed everything to
+    // `need()` in a single chunk (a `Buffer[]` input, in particular) — released
+    // right away, rather than only after another `iterator.next()` that may
+    // never come.
+    const release = () => {
+        if (buffered.length <= TAG_LENGTH)
+            return null;
+        const releasable = buffered.subarray(0, buffered.length - TAG_LENGTH);
+        buffered = buffered.subarray(buffered.length - TAG_LENGTH);
+        return releasable;
+    };
+    const initial = release();
+    if (initial !== null) {
+        const decrypted = decipher.update(initial);
+        if (decrypted.length > 0)
+            yield decrypted;
+    }
+    for (;;) {
+        const next = await iterator.next();
+        if (next.done === true)
+            break;
+        buffered = Buffer.concat([buffered, next.value]);
+        const releasable = release();
+        if (releasable !== null) {
+            const decrypted = decipher.update(releasable);
+            if (decrypted.length > 0)
+                yield decrypted;
+        }
+    }
+    if (buffered.length !== TAG_LENGTH)
+        throw truncated();
+    decipher.setAuthTag(buffered);
+    try {
+        const final = decipher.final();
+        if (final.length > 0)
+            yield final;
+    }
+    catch (cause) {
+        throw new CogentaError({
+            code: 'BACKUP_DECRYPTION_FAILED',
+            message: 'Decryption failed: the passphrase is wrong or the file was tampered with.',
+            hint: 'Re-enter the passphrase used to create this backup, or restore from a different file.',
+            cause,
+        });
+    }
+}
+function truncated() {
+    return new CogentaError({
+        code: 'BACKUP_DECRYPTION_FAILED',
+        message: 'The encrypted backup is truncated.',
+        hint: 'The file was not fully downloaded or copied. Retry the transfer.',
+    });
+}
+async function* normalise(input) {
+    for await (const chunk of input)
+        yield chunk;
+}
+//# sourceMappingURL=crypto.js.map