@linkforty/core 1.33.0 → 1.35.0

package/dist/lib/portable/cli.test.js

@@ -0,0 +1,98 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import zlib from 'zlib';
+import pg from 'pg';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { runCli } from './cli.js';
+/**
+ * The `linkforty` command: arguments, exit codes and what it prints. The
+ * export and import runs need a real database and skip without DATABASE_URL.
+ */
+function capture() {
+    const lines = [];
+    const errors = [];
+    return { lines, errors, log: (l) => lines.push(l), logError: (l) => errors.push(l) };
+}
+describe('linkforty usage', () => {
+    it('prints usage and exits 2 for an unknown command or a missing file', async () => {
+        for (const argv of [[], ['backup'], ['export']]) {
+            const out = capture();
+            expect(await runCli(argv, {}, out.log, out.logError)).toBe(2);
+            expect(out.errors.join('\n')).toContain('Usage:');
+        }
+    });
+    it('exits 2 for a malformed flag', async () => {
+        const out = capture();
+        expect(await runCli(['import', 'x.lfbundle', '--organization'], {}, out.log, out.logError)).toBe(2);
+        expect(out.errors[0]).toContain('--organization needs a value');
+    });
+    it('exits 2 without DATABASE_URL', async () => {
+        const out = capture();
+        expect(await runCli(['export', 'x.lfbundle'], {}, out.log, out.logError)).toBe(2);
+        expect(out.errors[0]).toContain('DATABASE_URL');
+    });
+});
+const ADMIN_URL = process.env.DATABASE_URL;
+describe.skipIf(!ADMIN_URL)('linkforty export and import (integration)', () => {
+    const stamp = Date.now();
+    const names = { source: `lf_core_cli_src_${stamp}`, target: `lf_core_cli_dst_${stamp}` };
+    let admin;
+    let dir;
+    let file;
+    const urlFor = (name) => {
+        const url = new URL(ADMIN_URL);
+        url.pathname = `/${name}`;
+        return url.toString();
+    };
+    const run = async (argv, database) => {
+        const out = capture();
+        const code = await runCli(argv, { DATABASE_URL: urlFor(names[database]) }, out.log, out.logError);
+        return { code, text: out.lines.join('\n'), errors: out.errors.join('\n') };
+    };
+    beforeAll(async () => {
+        admin = new pg.Client({ connectionString: ADMIN_URL });
+        await admin.connect();
+        for (const name of Object.values(names))
+            await admin.query(`CREATE DATABASE ${name}`);
+        dir = fs.mkdtempSync(path.join(os.tmpdir(), 'lf-cli-'));
+        file = path.join(dir, 'server.lfbundle');
+        // An export creates the schema; then seed one link and one webhook.
+        await run(['export', path.join(dir, 'empty.lfbundle')], 'source');
+        const source = new pg.Client({ connectionString: urlFor(names.source) });
+        await source.connect();
+        await source.query(`INSERT INTO links (short_code, original_url) VALUES ('hello', 'https://example.com')`);
+        await source.query(`INSERT INTO webhooks (name, url, secret, events) VALUES ('w', 'https://hooks.example', 's', '{click_event}')`);
+        await source.end();
+    }, 60000);
+    afterAll(async () => {
+        for (const name of Object.values(names))
+            await admin.query(`DROP DATABASE IF EXISTS ${name} WITH (FORCE)`);
+        await admin.end();
+        fs.rmSync(dir, { recursive: true, force: true });
+    }, 30000);
+    it('exports, dry-runs, imports and then reports conflicts', async () => {
+        const exported = await run(['export', file], 'source');
+        expect(exported.code).toBe(0);
+        expect(exported.text).toContain('Exported 2 rows');
+        const dry = await run(['import', file, '--dry-run'], 'target');
+        expect(dry).toMatchObject({ code: 0 });
+        expect(dry.text).toContain('Dry run: no conflicts');
+        const imported = await run(['import', file], 'target');
+        expect(imported.code).toBe(0);
+        expect(imported.text).toContain('Imported.');
+        expect(imported.text).toMatch(/https:\/\/hooks\.example {2}[0-9a-f]{64}/);
+        const again = await run(['import', file], 'target');
+        expect(again.code).toBe(1);
+        expect(again.text).toContain('conflict(s); nothing was imported');
+        expect(again.text).toContain('short_code_taken: hello');
+    }, 60000);
+    it('exits 1 with the reason for a file that is not a bundle', async () => {
+        const bogus = path.join(dir, 'bogus.lfbundle');
+        fs.writeFileSync(bogus, zlib.gzipSync('{"hello":"world"}\n'));
+        const result = await run(['import', bogus], 'target');
+        expect(result.code).toBe(1);
+        expect(result.errors).toContain('Not a LinkForty bundle');
+    }, 60000);
+});
+//# sourceMappingURL=cli.test.js.map

package/dist/lib/portable/cli.test.js.map

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

package/dist/lib/portable/files.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Bundles as files: gzipped NDJSON, conventionally named `*.lfbundle`.
+ */
+import type { Pool } from 'pg';
+import { type ExportOptions } from './bundle.js';
+import { type ImportOptions, type ImportReport } from './import.js';
+/** Export to a gzipped bundle file at `path`. */
+export declare function exportBundleToFile(pool: Pool, path: string, options?: ExportOptions): Promise<{
+    counts: Record<string, number>;
+    rows: number;
+    sha256: string;
+}>;
+/** The lines of a gzipped bundle file. */
+export declare function bundleFileLines(path: string): AsyncIterable<string>;
+/** Check, and unless it's a dry run, import a gzipped bundle file. */
+export declare function importBundleFile(pool: Pool, path: string, options?: ImportOptions): Promise<ImportReport>;
+//# sourceMappingURL=files.d.ts.map

package/dist/lib/portable/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/lib/portable/files.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAElF,iDAAiD;AACjD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;;;;GAe7F;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAGnE;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAE7G"}

package/dist/lib/portable/files.js

@@ -0,0 +1,37 @@
+/**
+ * Bundles as files: gzipped NDJSON, conventionally named `*.lfbundle`.
+ */
+import fs from 'fs';
+import readline from 'readline';
+import zlib from 'zlib';
+import { finished } from 'stream/promises';
+import { exportBundle } from './bundle.js';
+import { importBundle } from './import.js';
+/** Export to a gzipped bundle file at `path`. */
+export async function exportBundleToFile(pool, path, options = {}) {
+    const gzip = zlib.createGzip();
+    const file = fs.createWriteStream(path);
+    gzip.pipe(file);
+    try {
+        const result = await exportBundle(pool, gzip, options);
+        gzip.end();
+        await finished(file);
+        return result;
+    }
+    catch (error) {
+        gzip.destroy();
+        file.destroy();
+        await fs.promises.rm(path, { force: true });
+        throw error;
+    }
+}
+/** The lines of a gzipped bundle file. */
+export function bundleFileLines(path) {
+    const input = fs.createReadStream(path).pipe(zlib.createGunzip());
+    return readline.createInterface({ input, crlfDelay: Infinity });
+}
+/** Check, and unless it's a dry run, import a gzipped bundle file. */
+export function importBundleFile(pool, path, options = {}) {
+    return importBundle(pool, () => bundleFileLines(path), options);
+}
+//# sourceMappingURL=files.js.map

package/dist/lib/portable/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/lib/portable/files.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAyC,MAAM,aAAa,CAAC;AAElF,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAU,EAAE,IAAY,EAAE,UAAyB,EAAE;IAC5F,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,IAAU,EAAE,IAAY,EAAE,UAAyB,EAAE;IACpF,OAAO,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/lib/portable/import.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Restoring a LinkForty bundle (bundle.ts).
+ *
+ * Import reads the bundle twice. The first pass checks it: the format, the
+ * checksum, and every row against the target database — ids already present,
+ * short codes already used in the target organization, template slugs already
+ * taken. If anything conflicts, or on a dry run, it stops there and reports.
+ * The second pass writes every row in one transaction, so an import either
+ * lands whole or not at all. Ids are kept, so links, clicks and installs stay
+ * connected, and apps keep the install ids they already hold.
+ */
+import type { Pool } from 'pg';
+import { type BundleManifest } from './bundle.js';
+export interface ImportOptions {
+    /** Check the bundle against the database and report, without writing. */
+    dryRun?: boolean;
+    /**
+     * Import into this organization: links and webhooks are assigned to it, and
+     * the bundle's own organization record is not created.
+     */
+    organizationId?: string;
+    /** Assign imported links, templates and webhooks to this user (null clears it). */
+    userId?: string | null;
+}
+export interface ImportConflict {
+    record: string;
+    kind: 'id_exists' | 'short_code_taken' | 'template_slug_taken';
+    value: string;
+}
+export interface ImportReport {
+    manifest: BundleManifest;
+    /** Rows per record type found in the bundle. */
+    counts: Record<string, number>;
+    /** Conflicts with the target database, at most 100 per kind and record. */
+    conflicts: ImportConflict[];
+    imported: boolean;
+    /** Imported webhooks with the signing secrets issued to them. */
+    webhooks: Array<{
+        id: string;
+        url: string;
+        secret: string;
+    }>;
+}
+export declare class BundleError extends Error {
+}
+/**
+ * Check a bundle against the database and, unless it's a dry run or anything
+ * conflicts, import it in one transaction. `openLines` is called once per pass
+ * and must yield the bundle's lines from the start each time.
+ */
+export declare function importBundle(pool: Pool, openLines: () => AsyncIterable<string>, options?: ImportOptions): Promise<ImportReport>;
+//# sourceMappingURL=import.d.ts.map

package/dist/lib/portable/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../src/lib/portable/import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAmD,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAInG,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;IAC/D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,2EAA2E;IAC3E,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,qBAAa,WAAY,SAAQ,KAAK;CAAG;AA0KzC;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,aAAa,CAAC,MAAM,CAAC,EACtC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA8CvB"}

package/dist/lib/portable/import.js

@@ -0,0 +1,211 @@
+/**
+ * Restoring a LinkForty bundle (bundle.ts).
+ *
+ * Import reads the bundle twice. The first pass checks it: the format, the
+ * checksum, and every row against the target database — ids already present,
+ * short codes already used in the target organization, template slugs already
+ * taken. If anything conflicts, or on a dry run, it stops there and reports.
+ * The second pass writes every row in one transaction, so an import either
+ * lands whole or not at all. Ids are kept, so links, clicks and installs stay
+ * connected, and apps keep the install ids they already hold.
+ */
+import crypto from 'crypto';
+import { BUNDLE_FORMAT, BUNDLE_FORMAT_VERSION, ZERO_UUID } from './bundle.js';
+import { BUNDLE_TABLES, exportedColumns } from './registry.js';
+import { generateWebhookSecret } from '../webhook.js';
+export class BundleError extends Error {
+}
+/** Rows written or checked per statement. */
+const BATCH_SIZE = 1000;
+const CONFLICT_CAP = 100;
+const TABLE_BY_RECORD = new Map(Object.entries(BUNDLE_TABLES).map(([table, rule]) => [rule.record, table]));
+/**
+ * Parse and verify a bundle's lines: manifest first, rows, then a trailer
+ * whose checksum and count match. Yields rows; throws BundleError on anything
+ * malformed.
+ */
+async function* readBundle(lines, onManifest) {
+    const hash = crypto.createHash('sha256');
+    let manifest = null;
+    let rows = 0;
+    let ended = false;
+    for await (const raw of lines) {
+        if (raw === '')
+            continue;
+        if (ended)
+            throw new BundleError('Data after the end of the bundle');
+        let line;
+        try {
+            line = JSON.parse(raw);
+        }
+        catch {
+            throw new BundleError('Bundle contains a line that is not JSON');
+        }
+        if (!manifest) {
+            if (line?.type !== 'manifest' || line.format !== BUNDLE_FORMAT) {
+                throw new BundleError('Not a LinkForty bundle');
+            }
+            if (typeof line.formatVersion !== 'number' || line.formatVersion > BUNDLE_FORMAT_VERSION) {
+                throw new BundleError(`Bundle format version ${line.formatVersion} is newer than this server reads (${BUNDLE_FORMAT_VERSION}); upgrade first`);
+            }
+            manifest = line;
+            onManifest(manifest);
+            continue;
+        }
+        if (line?.type === 'end') {
+            if (line.rows !== rows || line.sha256 !== hash.digest('hex')) {
+                throw new BundleError('Bundle checksum does not match; the file is incomplete or was changed');
+            }
+            ended = true;
+            continue;
+        }
+        const table = TABLE_BY_RECORD.get(line?.type);
+        if (!table || !line.data || typeof line.data !== 'object') {
+            throw new BundleError(`Unknown record type in bundle: ${String(line?.type)}`);
+        }
+        hash.update(raw + '\n');
+        rows++;
+        yield { record: line.type, table, data: line.data };
+    }
+    if (!manifest)
+        throw new BundleError('Bundle is empty');
+    if (!ended)
+        throw new BundleError('Bundle has no end record; the file is incomplete');
+}
+/** A bundle row as a row of its table, with the import's assignments applied. */
+function toColumns(row, options) {
+    const out = {};
+    for (const [column, rule] of exportedColumns(row.table)) {
+        let value = row.data[rule.field];
+        if (rule.class === 'portable' && rule.keys && value && typeof value === 'object' && !Array.isArray(value)) {
+            value = Object.fromEntries(rule.keys.filter((k) => k in value).map((k) => [k, value[k]]));
+        }
+        if (rule.class === 'remap') {
+            if (rule.owner === 'organization' && options.organizationId)
+                value = options.organizationId;
+            if (rule.owner === 'user' && options.userId !== undefined)
+                value = options.userId;
+        }
+        out[column] = value ?? null;
+    }
+    return out;
+}
+/** Rows grouped into batches, each batch from a single table. */
+async function* batches(rows) {
+    let batch = [];
+    for await (const row of rows) {
+        if (batch.length > 0 && (batch[0].table !== row.table || batch.length >= BATCH_SIZE)) {
+            yield batch;
+            batch = [];
+        }
+        batch.push(row);
+    }
+    if (batch.length > 0)
+        yield batch;
+}
+function skipped(row, options) {
+    // Importing into an existing organization: the bundle's organization record
+    // describes the source, not the target.
+    return row.table === 'organizations' && Boolean(options.organizationId);
+}
+async function findConflicts(client, batch, options) {
+    const { table, record } = batch[0];
+    const key = BUNDLE_TABLES[table].key;
+    const keyField = BUNDLE_TABLES[table].columns[key].field;
+    const conflicts = [];
+    const ids = batch.map((r) => r.data[keyField]).filter((v) => typeof v === 'string');
+    const existing = await client.query(`SELECT ${key}::text AS id FROM ${table} WHERE ${key} = ANY($1::uuid[])`, [ids]);
+    for (const { id } of existing.rows)
+        conflicts.push({ record, kind: 'id_exists', value: id });
+    if (table === 'links') {
+        const codes = batch.map((r) => ({
+            code: String(r.data.shortCode),
+            org: options.organizationId ?? r.data.organizationId ?? ZERO_UUID,
+        }));
+        const taken = await client.query(`SELECT l.short_code
+         FROM links l
+         INNER JOIN unnest($1::text[], $2::uuid[]) AS c(code, org)
+           ON l.short_code = c.code AND COALESCE(l.organization_id, '${ZERO_UUID}'::uuid) = c.org`, [codes.map((c) => c.code), codes.map((c) => c.org)]);
+        for (const { short_code } of taken.rows)
+            conflicts.push({ record, kind: 'short_code_taken', value: short_code });
+    }
+    if (table === 'link_templates') {
+        const slugs = batch.map((r) => String(r.data.slug));
+        const taken = await client.query('SELECT slug FROM link_templates WHERE slug = ANY($1::text[])', [slugs]);
+        for (const { slug } of taken.rows)
+            conflicts.push({ record, kind: 'template_slug_taken', value: slug });
+    }
+    return conflicts;
+}
+async function insertBatch(client, batch, options, webhooks) {
+    const { table } = batch[0];
+    const rows = batch.map((row) => toColumns(row, options));
+    const columns = exportedColumns(table).map(([column]) => column);
+    if (table === 'webhooks') {
+        columns.push('secret');
+        for (const row of rows) {
+            row.secret = generateWebhookSecret();
+            webhooks.push({ id: String(row.id), url: String(row.url), secret: String(row.secret) });
+        }
+    }
+    // json_populate_recordset converts every value back to its column type
+    // exactly as row_to_json rendered it on export.
+    const list = columns.join(', ');
+    await client.query(`INSERT INTO ${table} (${list}) SELECT ${list} FROM json_populate_recordset(null::${table}, $1::json)`, [JSON.stringify(rows)]);
+}
+/**
+ * Check a bundle against the database and, unless it's a dry run or anything
+ * conflicts, import it in one transaction. `openLines` is called once per pass
+ * and must yield the bundle's lines from the start each time.
+ */
+export async function importBundle(pool, openLines, options = {}) {
+    let manifest = null;
+    const counts = {};
+    const conflicts = [];
+    const webhooks = [];
+    const client = await pool.connect();
+    try {
+        // Pass 1: verify and check.
+        for await (const batch of batches(readBundle(openLines(), (m) => (manifest = m)))) {
+            const { record } = batch[0];
+            counts[record] = (counts[record] ?? 0) + batch.length;
+            const kept = batch.filter((row) => !skipped(row, options));
+            if (kept.length === 0)
+                continue;
+            for (const conflict of await findConflicts(client, kept, options)) {
+                const sameKind = conflicts.filter((c) => c.record === conflict.record && c.kind === conflict.kind).length;
+                if (sameKind < CONFLICT_CAP)
+                    conflicts.push(conflict);
+            }
+        }
+        const report = (imported) => ({
+            manifest: manifest,
+            counts,
+            conflicts,
+            imported,
+            webhooks,
+        });
+        if (options.dryRun || conflicts.length > 0)
+            return report(false);
+        // Pass 2: write everything or nothing.
+        await client.query('BEGIN');
+        try {
+            for await (const batch of batches(readBundle(openLines(), () => undefined))) {
+                const kept = batch.filter((row) => !skipped(row, options));
+                if (kept.length > 0)
+                    await insertBatch(client, kept, options, webhooks);
+            }
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK').catch(() => undefined);
+            webhooks.length = 0;
+            throw error;
+        }
+        return report(true);
+    }
+    finally {
+        client.release();
+    }
+}
+//# sourceMappingURL=import.js.map

package/dist/lib/portable/import.js.map

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

package/dist/lib/portable/index.d.ts

@@ -0,0 +1,5 @@
+export * from './registry.js';
+export * from './bundle.js';
+export * from './import.js';
+export * from './files.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/portable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/portable/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/lib/portable/index.js

@@ -0,0 +1,5 @@
+export * from './registry.js';
+export * from './bundle.js';
+export * from './import.js';
+export * from './files.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/portable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/portable/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/lib/portable/portable.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=portable.integration.test.d.ts.map

package/dist/lib/portable/portable.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable.integration.test.d.ts","sourceRoot":"","sources":["../../../src/lib/portable/portable.integration.test.ts"],"names":[],"mappings":""}

package/dist/lib/portable/portable.integration.test.js

@@ -0,0 +1,139 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import zlib from 'zlib';
+import pg from 'pg';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { db, initializeDatabase } from '../database.js';
+import { BUNDLE_TABLES, exportedColumns } from './registry.js';
+import { exportBundleToFile, importBundleFile } from './files.js';
+import { BundleError } from './import.js';
+/**
+ * A bundle restores exactly what it exported: every carried column, value for
+ * value, with excluded columns left behind. Import refuses conflicts and
+ * tampered files, and can target a different organization.
+ *
+ * Needs a real database; skipped without DATABASE_URL, like database.test.ts.
+ */
+const ADMIN_URL = process.env.DATABASE_URL;
+const ORG_A = '0a0a0a0a-0000-4000-8000-00000000000a';
+const ORG_B = '0b0b0b0b-0000-4000-8000-00000000000b';
+const ORG_X = '0c0c0c0c-0000-4000-8000-00000000000c';
+const TEMPLATE = '1a1a1a1a-0000-4000-8000-00000000001a';
+const LINK_A = '2a2a2a2a-0000-4000-8000-00000000002a';
+const LINK_B = '2b2b2b2b-0000-4000-8000-00000000002b';
+const CLICK = '3a3a3a3a-0000-4000-8000-00000000003a';
+const INSTALL = '4a4a4a4a-0000-4000-8000-00000000004a';
+const WEBHOOK = '5a5a5a5a-0000-4000-8000-00000000005a';
+describe.skipIf(!ADMIN_URL)('LinkForty bundles (integration)', () => {
+    const stamp = Date.now();
+    const names = { source: `lf_core_bundle_src_${stamp}`, target: `lf_core_bundle_dst_${stamp}`, other: `lf_core_bundle_org_${stamp}` };
+    const pools = {};
+    let admin;
+    let dir;
+    const urlFor = (name) => {
+        const url = new URL(ADMIN_URL);
+        url.pathname = `/${name}`;
+        return url.toString();
+    };
+    /** Every carried column of every row, as Postgres renders it. */
+    async function snapshot(pool) {
+        const out = {};
+        for (const [table, rule] of Object.entries(BUNDLE_TABLES)) {
+            const cols = exportedColumns(table).map(([c]) => c).join(', ');
+            const result = await pool.query(`SELECT row_to_json(r) AS row FROM (SELECT ${cols} FROM ${table} ORDER BY ${rule.key}) r`);
+            out[table] = result.rows.map((r) => r.row);
+        }
+        return out;
+    }
+    beforeAll(async () => {
+        admin = new pg.Client({ connectionString: ADMIN_URL });
+        await admin.connect();
+        for (const key of ['other', 'target', 'source']) {
+            await admin.query(`CREATE DATABASE ${names[key]}`);
+            await initializeDatabase({ url: urlFor(names[key]), pool: { min: 1, max: 3 } });
+            pools[key] = db;
+        }
+        dir = fs.mkdtempSync(path.join(os.tmpdir(), 'lf-bundle-'));
+        const q = (sql, params = []) => pools.source.query(sql, params);
+        await q(`INSERT INTO organizations (id, name, settings, suspended_at) VALUES
+         ($1, 'A', '{"appConfig":{"webFallbackUrl":"https://a.example"},"launchpad":{"mobile":"page"},"brandKit":{"accent":"#000"}}', NOW()),
+         ($2, 'B', '{}', NULL)`, [ORG_A, ORG_B]);
+        await q(`INSERT INTO link_templates (id, name, slug, settings, is_default) VALUES ($1, 'T', 'tpl-a', '{"defaultWebFallbackUrl":"https://t.example"}', true)`, [TEMPLATE]);
+        await q(`INSERT INTO links (id, organization_id, template_id, short_code, original_url, web_fallback_url, deep_link_parameters,
+                          utm_parameters, expires_at, warn_at, disabled_reason, created_at)
+       VALUES ($1, $2, $3, 'promo', 'https://a.example/p', 'https://a.example/p', '{"token":"x"}', '{"source":"ig"}',
+               '2030-01-02 03:04:05.678', '2026-10-01 12:00:00+00', 'flagged', '2026-01-01 00:00:00.123456')`, [LINK_A, ORG_A, TEMPLATE]);
+        await q(`INSERT INTO links (id, organization_id, short_code, original_url) VALUES ($1, $2, 'promo', 'https://b.example')`, [LINK_B, ORG_B]);
+        await q(`INSERT INTO click_events (id, link_id, clicked_at, ip_address, latitude, longitude, link_params, is_bot)
+       VALUES ($1, $2, '2026-10-15 10:00:00.5', '203.0.113.7', 37.7749, -122.4194, '{"fbclid":"abc"}', false)`, [CLICK, LINK_A]);
+        await q(`INSERT INTO device_fingerprints (click_id, fingerprint_hash, ip_address, user_agent, screen_width) VALUES ($1, 'h', '2001:db8::1', 'UA', 1170)`, [CLICK]);
+        await q(`INSERT INTO install_events (id, link_id, click_id, fingerprint_hash, confidence_score, matched_factors, deep_link_data, ip_address)
+       VALUES ($1, $2, $3, 'h', 90.5, ARRAY['ip','platform'], '{"shortCode":"promo"}', '203.0.113.7')`, [INSTALL, LINK_A, CLICK]);
+        await q(`INSERT INTO in_app_events (install_id, event_name, event_data, event_timestamp) VALUES ($1, 'purchase', '{"revenue":29.99}', NOW())`, [INSTALL]);
+        await q(`INSERT INTO webhooks (id, organization_id, name, url, secret, events, headers) VALUES ($1, $2, 'W', 'https://hooks.example', 'old-secret', '{click_event,install_event}', '{"X-Key":"1"}')`, [WEBHOOK, ORG_A]);
+    }, 120000);
+    afterAll(async () => {
+        for (const pool of Object.values(pools))
+            await pool?.end().catch(() => undefined);
+        for (const name of Object.values(names))
+            await admin.query(`DROP DATABASE IF EXISTS ${name} WITH (FORCE)`);
+        await admin.end();
+        fs.rmSync(dir, { recursive: true, force: true });
+    }, 60000);
+    it('restores every carried column exactly, and nothing it excludes', async () => {
+        const file = path.join(dir, 'all.lfbundle');
+        const exported = await exportBundleToFile(pools.source, file);
+        expect(exported.counts).toMatchObject({ organization: 2, link: 2, click: 1, fingerprint: 1, install: 1, event: 1, webhook: 1 });
+        const report = await importBundleFile(pools.target, file);
+        expect(report.conflicts).toEqual([]);
+        expect(report.imported).toBe(true);
+        const [source, target] = [await snapshot(pools.source), await snapshot(pools.target)];
+        // Settings carry only the listed keys.
+        const orgA = source.organizations.find((o) => o.id === ORG_A);
+        delete orgA.settings.brandKit;
+        expect(target).toEqual(source);
+        const link = await pools.target.query('SELECT warn_at, disabled_reason FROM links WHERE id = $1', [LINK_A]);
+        expect(link.rows[0]).toEqual({ warn_at: null, disabled_reason: null });
+        const org = await pools.target.query('SELECT suspended_at FROM organizations WHERE id = $1', [ORG_A]);
+        expect(org.rows[0].suspended_at).toBeNull();
+        const webhook = await pools.target.query('SELECT secret FROM webhooks WHERE id = $1', [WEBHOOK]);
+        expect(webhook.rows[0].secret).not.toBe('old-secret');
+        expect(report.webhooks).toEqual([{ id: WEBHOOK, url: 'https://hooks.example', secret: webhook.rows[0].secret }]);
+    }, 60000);
+    it('reports conflicts and writes nothing when the data is already there', async () => {
+        const file = path.join(dir, 'all.lfbundle');
+        const before = await snapshot(pools.target);
+        const report = await importBundleFile(pools.target, file);
+        expect(report.imported).toBe(false);
+        expect(report.conflicts).toEqual(expect.arrayContaining([
+            { record: 'link', kind: 'id_exists', value: LINK_A },
+            { record: 'link', kind: 'short_code_taken', value: 'promo' },
+            { record: 'template', kind: 'template_slug_taken', value: 'tpl-a' },
+        ]));
+        expect(await snapshot(pools.target)).toEqual(before);
+    }, 60000);
+    it('refuses a bundle that was changed after export', async () => {
+        const file = path.join(dir, 'all.lfbundle');
+        const text = zlib.gunzipSync(fs.readFileSync(file)).toString().replace('https://a.example/p', 'https://evil.example/p');
+        const tampered = path.join(dir, 'tampered.lfbundle');
+        fs.writeFileSync(tampered, zlib.gzipSync(text));
+        await expect(importBundleFile(pools.other, tampered)).rejects.toThrow(BundleError);
+    });
+    it("exports one organization's data and imports it into another organization", async () => {
+        const file = path.join(dir, 'org-a.lfbundle');
+        const exported = await exportBundleToFile(pools.source, file, { organizationId: ORG_A });
+        expect(exported.counts).toMatchObject({ organization: 1, link: 1, click: 1, install: 1, event: 1, webhook: 1, template: 1 });
+        await pools.other.query(`INSERT INTO organizations (id, name) VALUES ($1, 'X')`, [ORG_X]);
+        const dry = await importBundleFile(pools.other, file, { organizationId: ORG_X, dryRun: true });
+        expect(dry).toMatchObject({ imported: false, conflicts: [] });
+        expect((await pools.other.query('SELECT COUNT(*)::int AS n FROM links')).rows[0].n).toBe(0);
+        const report = await importBundleFile(pools.other, file, { organizationId: ORG_X });
+        expect(report.imported).toBe(true);
+        const links = await pools.other.query('SELECT id, organization_id FROM links');
+        expect(links.rows).toEqual([{ id: LINK_A, organization_id: ORG_X }]);
+        const orgs = await pools.other.query('SELECT id FROM organizations');
+        expect(orgs.rows).toEqual([{ id: ORG_X }]);
+    }, 60000);
+});
+//# sourceMappingURL=portable.integration.test.js.map