@antelopejs/dms 0.0.1

package/dist/utils/export-jobs.js

@@ -0,0 +1,241 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPORT_TTL_MS = exports.EXPORT_JOB_QUERY_PARAM = exports.EMAIL_DELIVERY = exports.DEFAULT_EXPORT_HISTORY_LIMIT = exports.DEFAULT_EXPORT_FORMAT = exports.DEFAULT_DELIVERY = void 0;
+exports.getExporter = getExporter;
+exports.readJobResult = readJobResult;
+exports.getDeliverer = getDeliverer;
+exports.getExportLocalScratchPath = getExportLocalScratchPath;
+exports.uploadExportToStorage = uploadExportToStorage;
+exports.streamExportFromStorage = streamExportFromStorage;
+exports.deleteExportFromStorage = deleteExportFromStorage;
+exports.sweepStaleExportsAllTenants = sweepStaleExportsAllTenants;
+exports.deleteAllExportsForTenant = deleteAllExportsForTenant;
+exports.buildExportFilename = buildExportFilename;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_stream_1 = require("node:stream");
+const interface_api_util_1 = require("@antelopejs/interface-api-util");
+const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
+const interface_email_1 = require("@antelopejs/interface-email");
+const interface_file_storage_1 = require("@antelopejs/interface-file-storage");
+const db_1 = require("@antelopejs/interface-dms/db");
+const db_2 = require("@antelopejs/interface-dms/auth/db");
+const types_1 = require("@antelopejs/interface-dms/base/types");
+const html_render_1 = require("@antelopejs/interface-dms/html-render");
+const sync_1 = require("csv-stringify/sync");
+const config_1 = require("../config");
+const exportJobs_model_1 = require("@antelopejs/interface-dms/db/models/exportJobs.model");
+const run_in_batches_1 = require("./run-in-batches");
+const export_jobs_1 = require("@antelopejs/interface-dms/base/export-jobs");
+const time_1 = require("@antelopejs/interface-dms/utils/time");
+var export_jobs_2 = require("@antelopejs/interface-dms/base/export-jobs");
+Object.defineProperty(exports, "DEFAULT_DELIVERY", { enumerable: true, get: function () { return export_jobs_2.DEFAULT_DELIVERY; } });
+Object.defineProperty(exports, "DEFAULT_EXPORT_FORMAT", { enumerable: true, get: function () { return export_jobs_2.DEFAULT_EXPORT_FORMAT; } });
+Object.defineProperty(exports, "DEFAULT_EXPORT_HISTORY_LIMIT", { enumerable: true, get: function () { return export_jobs_2.DEFAULT_EXPORT_HISTORY_LIMIT; } });
+Object.defineProperty(exports, "EMAIL_DELIVERY", { enumerable: true, get: function () { return export_jobs_2.EMAIL_DELIVERY; } });
+Object.defineProperty(exports, "EXPORT_JOB_QUERY_PARAM", { enumerable: true, get: function () { return export_jobs_2.EXPORT_JOB_QUERY_PARAM; } });
+Object.defineProperty(exports, "EXPORT_TTL_MS", { enumerable: true, get: function () { return export_jobs_2.EXPORT_TTL_MS; } });
+const EXPORT_TMP_PREFIX = "dms-export-";
+const EXPORT_STORAGE_PREFIX = "table-view-exports";
+const READ_URL_EXPIRES_IN_SEC = 60 * 60;
+const ARRAY_JOIN_SEPARATOR = ";";
+const FILENAME_ILLEGAL_CHARS = /[^a-zA-Z0-9._-]/g;
+const FILENAME_REPLACEMENT = "-";
+function castCsvValue(value) {
+    if (Array.isArray(value))
+        return value.join(ARRAY_JOIN_SEPARATOR);
+    return String(value);
+}
+class CsvWriter {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    writeHeaders(headers) {
+        node_fs_1.default.writeFileSync(this.filePath, `${headers.join(",")}\n`);
+    }
+    appendRow(headers, row) {
+        const csvRowContent = (0, sync_1.stringify)([row], {
+            header: false,
+            columns: headers,
+            cast: {
+                date: (value) => value.toISOString(),
+                string: castCsvValue,
+            },
+        });
+        node_fs_1.default.appendFileSync(this.filePath, csvRowContent);
+    }
+    close() { }
+}
+const csvExporter = {
+    extension: "csv",
+    contentType: "text/csv; charset=utf-8",
+    createWriter(filePath) {
+        return new CsvWriter(filePath);
+    },
+};
+const exporters = {
+    csv: csvExporter,
+};
+function getExporter(format) {
+    const exporter = exporters[format];
+    (0, interface_api_util_1.assert)(exporter, 400, `Unknown export format: ${format}`);
+    return exporter;
+}
+const downloadDeliverer = {
+    async deliver() { },
+};
+const ExportReadyTemplate = (0, html_render_1.RegisterHtmlTemplate)("EmailExportReady");
+const EXPORT_READY_SUBJECT = "Your data export is ready";
+function buildDeliveryLink(exportRecord) {
+    const baseUrl = (0, config_1.getClientBaseUrl)();
+    (0, interface_api_util_1.assert)(baseUrl, 500, "clientBaseUrl is required to deliver an export link");
+    return `${baseUrl}${exportRecord.deliveryPath}?${export_jobs_1.EXPORT_JOB_QUERY_PARAM}=${exportRecord._id}`;
+}
+function readJobResult(exportRecord) {
+    if (!exportRecord.json_result)
+        return undefined;
+    return JSON.parse(exportRecord.json_result);
+}
+const emailDeliverer = {
+    validate(options) {
+        (0, interface_api_util_1.assert)(options.deliveryPath, 400, "Email delivery requires a deliveryPath to build the download link");
+    },
+    async deliver(exportRecord) {
+        const user = await (0, interface_database_decorators_1.GetModel)(db_2.UserModel).get(exportRecord.userId);
+        (0, interface_api_util_1.assert)(user, 500, "Export recipient not found");
+        const result = readJobResult(exportRecord);
+        const html = await (0, html_render_1.GenerateHtml)(ExportReadyTemplate, {
+            userName: user.name || user.email,
+            downloadLink: buildDeliveryLink(exportRecord),
+            expiresIn: `${export_jobs_1.EXPORT_TTL_MS / time_1.MILLISECONDS_PER_HOUR} hours`,
+            partial: result?.partial ?? false,
+            failedSources: (result?.failures ?? []).map((failure) => failure.source),
+        });
+        const sent = await (0, interface_email_1.Send)({
+            to: user.email,
+            subject: EXPORT_READY_SUBJECT,
+            html,
+        });
+        (0, interface_api_util_1.assert)(sent.success, 500, `Failed to send export email: ${sent.error?.message}`);
+    },
+};
+const deliverers = {
+    download: downloadDeliverer,
+    email: emailDeliverer,
+};
+function getDeliverer(delivery) {
+    const deliverer = deliverers[delivery];
+    (0, interface_api_util_1.assert)(deliverer, 400, `Unknown export delivery: ${delivery}`);
+    return deliverer;
+}
+function getExportLocalScratchPath(exportId, extension) {
+    return node_path_1.default.join(node_os_1.default.tmpdir(), `${EXPORT_TMP_PREFIX}${exportId}.${extension}`);
+}
+async function uploadExportToStorage(localPath, tenantId, exportId, extension, contentType) {
+    const { size } = await node_fs_1.default.promises.stat(localPath);
+    const filename = `${exportId}.${extension}`;
+    const presign = await (0, interface_file_storage_1.CreateUploadUrl)({
+        filename,
+        size,
+        mimetype: contentType,
+        path: `${EXPORT_STORAGE_PREFIX}/${tenantId}`,
+    });
+    const fileStream = node_fs_1.default.createReadStream(localPath);
+    const response = await fetch(presign.uploadUrl, {
+        method: "PUT",
+        headers: presign.headers,
+        body: node_stream_1.Readable.toWeb(fileStream),
+        duplex: "half",
+    });
+    if (!response.ok) {
+        await response.body?.cancel().catch(() => undefined);
+        (0, interface_api_util_1.assert)(false, 500, `Failed to upload export: HTTP ${response.status}`);
+    }
+    await node_fs_1.default.promises.unlink(localPath).catch(() => undefined);
+    return presign.resourceKey;
+}
+async function streamExportFromStorage(resourceKey) {
+    const presign = await (0, interface_file_storage_1.CreateReadUrl)(resourceKey, READ_URL_EXPIRES_IN_SEC);
+    const response = await fetch(presign.url);
+    (0, interface_api_util_1.assert)(response.ok, 500, `Failed to fetch export: HTTP ${response.status}`);
+    (0, interface_api_util_1.assert)(response.body, 500, "Export response has no body");
+    const contentLengthHeader = response.headers.get("content-length");
+    const size = contentLengthHeader ? Number(contentLengthHeader) : undefined;
+    return { body: response.body, size };
+}
+async function deleteExportFromStorage(resourceKey) {
+    try {
+        await (0, interface_file_storage_1.DeleteFile)(resourceKey);
+    }
+    catch (error) {
+        if (await (0, interface_file_storage_1.FileExists)(resourceKey))
+            throw error;
+    }
+}
+const UPDATED_AT_INDEX = "updatedAt";
+const EPOCH_LOWER_BOUND = new Date(0);
+const EXPORT_DELETE_BATCH_SIZE = 10;
+const EXPORT_SWEEP_PAGE_SIZE = 100;
+const TENANT_SWEEP_BATCH_SIZE = 5;
+async function removeExportRecord(model, record) {
+    if (record.resultPath) {
+        await deleteExportFromStorage(record.resultPath);
+    }
+    await model.delete(record._id);
+}
+async function removeStaleRecords(model, threshold) {
+    while (true) {
+        const staleRecords = await model.table
+            .between(UPDATED_AT_INDEX, EPOCH_LOWER_BOUND, threshold)
+            .filter((record) => record
+            .key("status")
+            .eq(types_1.ExportStatus.completed)
+            .or(record.key("status").eq(types_1.ExportStatus.failed)))
+            .slice(0, EXPORT_SWEEP_PAGE_SIZE)
+            .run();
+        await (0, run_in_batches_1.runInBatches)(staleRecords, EXPORT_DELETE_BATCH_SIZE, (record) => removeExportRecord(model, record));
+        if (staleRecords.length < EXPORT_SWEEP_PAGE_SIZE)
+            return;
+    }
+}
+async function sweepStaleExportsForTenant(tenantId, ttlMs) {
+    const threshold = new Date(Date.now() - ttlMs);
+    const model = (0, interface_database_decorators_1.GetModel)(exportJobs_model_1.ExportJobModel, tenantId);
+    await removeStaleRecords(model, threshold);
+}
+async function sweepStaleExportsAllTenants(ttlMs) {
+    const tenantModel = (0, interface_database_decorators_1.GetModel)(db_1.TenantModel);
+    const tenants = await tenantModel.getAll();
+    await (0, run_in_batches_1.runInBatches)(tenants, TENANT_SWEEP_BATCH_SIZE, (tenant) => sweepStaleExportsForTenant(tenant._id, ttlMs));
+}
+async function deleteAllExportsForTenant(tenantId) {
+    const model = (0, interface_database_decorators_1.GetModel)(exportJobs_model_1.ExportJobModel, tenantId);
+    let offset = 0;
+    while (true) {
+        const records = await model.table
+            .slice(offset, offset + EXPORT_SWEEP_PAGE_SIZE)
+            .run();
+        await (0, run_in_batches_1.runInBatches)(records, EXPORT_DELETE_BATCH_SIZE, async (record) => {
+            if (record.resultPath)
+                await deleteExportFromStorage(record.resultPath);
+        });
+        if (records.length < EXPORT_SWEEP_PAGE_SIZE)
+            break;
+        offset += EXPORT_SWEEP_PAGE_SIZE;
+    }
+    await model.table.delete().run();
+}
+function sanitizeFilenameSegment(segment) {
+    return segment.replace(FILENAME_ILLEGAL_CHARS, FILENAME_REPLACEMENT);
+}
+function buildExportFilename(base, extension) {
+    const timestamp = sanitizeFilenameSegment(new Date().toISOString());
+    const safeBase = sanitizeFilenameSegment(base);
+    return `${safeBase}-${timestamp}.${extension}`;
+}
+//# sourceMappingURL=export-jobs.js.map

package/dist/utils/export-jobs.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./ensure-default-tenant";
+export * from "./export-jobs";
+export * from "./export-jobs-run";
+export * from "./run-in-batches";
+export * from "./tenant-export-archive";
+export * from "@antelopejs/interface-dms/utils/row-instance";
+export * from "@antelopejs/interface-dms/utils/saas-mode";
+export * from "@antelopejs/interface-dms/utils/time";
+export * from "@antelopejs/interface-dms/utils/value-parser";

package/dist/utils/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ensure-default-tenant"), exports);
+__exportStar(require("./export-jobs"), exports);
+__exportStar(require("./export-jobs-run"), exports);
+__exportStar(require("./run-in-batches"), exports);
+__exportStar(require("./tenant-export-archive"), exports);
+__exportStar(require("@antelopejs/interface-dms/utils/row-instance"), exports);
+__exportStar(require("@antelopejs/interface-dms/utils/saas-mode"), exports);
+__exportStar(require("@antelopejs/interface-dms/utils/time"), exports);
+__exportStar(require("@antelopejs/interface-dms/utils/value-parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,gDAA8B;AAC9B,oDAAkC;AAClC,mDAAiC;AACjC,0DAAwC;AACxC,+EAA6D;AAC7D,4EAA0D;AAC1D,uEAAqD;AACrD,+EAA6D"}

package/dist/utils/row-action-rule-evaluator.d.ts

@@ -0,0 +1,4 @@
+import type { RowActionRule } from "@antelopejs/interface-dms/base/types/row-action";
+type RuleEvaluator = (rule: RowActionRule, row: Record<string, unknown>) => boolean;
+export declare const evaluateRowActionRule: RuleEvaluator;
+export {};

package/dist/utils/row-action-rule-evaluator.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateRowActionRule = void 0;
+const row_action_operators_1 = require("@antelopejs/interface-dms/base/types/row-action-operators");
+const get = (obj, path) => {
+    const keys = path.split(".");
+    let result = obj;
+    for (const key of keys) {
+        if (result === null || result === undefined)
+            return undefined;
+        result = result[key];
+    }
+    return result;
+};
+const createLogicalEvaluators = (evaluate) => ({
+    and: (val, row) => val.every((r) => evaluate(r, row)),
+    or: (val, row) => val.some((r) => evaluate(r, row)),
+    not: (val, row) => !evaluate(val, row),
+});
+let cachedLogicalEvaluators;
+const getLogicalEvaluators = () => {
+    if (!cachedLogicalEvaluators) {
+        cachedLogicalEvaluators = createLogicalEvaluators(exports.evaluateRowActionRule);
+    }
+    return cachedLogicalEvaluators;
+};
+const evaluateRowActionRule = (rule, row) => {
+    const ruleObj = rule;
+    const logicalEvaluators = getLogicalEvaluators();
+    for (const operator of row_action_operators_1.LOGICAL_OPERATOR_KEYS) {
+        if (operator in ruleObj) {
+            return logicalEvaluators[operator](ruleObj[operator], row);
+        }
+    }
+    if (row_action_operators_1.FIELD_KEY in ruleObj) {
+        const fieldValue = get(row, ruleObj[row_action_operators_1.FIELD_KEY]);
+        for (const [operator, def] of Object.entries(row_action_operators_1.FIELD_OPERATORS)) {
+            if (operator in ruleObj) {
+                const compare = def.compare;
+                return compare(fieldValue, ruleObj[operator]);
+            }
+        }
+    }
+    return false;
+};
+exports.evaluateRowActionRule = evaluateRowActionRule;
+//# sourceMappingURL=row-action-rule-evaluator.js.map

package/dist/utils/row-action-rule-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-action-rule-evaluator.js","sourceRoot":"","sources":["../../src/utils/row-action-rule-evaluator.ts"],"names":[],"mappings":";;;AACA,oGAImE;AAEnE,MAAM,GAAG,GAAG,CAAC,GAA4B,EAAE,IAAY,EAAW,EAAE;IAClE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,MAAM,GAAY,GAAG,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC9D,MAAM,GAAI,MAAkC,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAOF,MAAM,uBAAuB,GAAG,CAAC,QAAuB,EAAE,EAAE,CAAC,CAAC;IAC5D,GAAG,EAAE,CAAC,GAAY,EAAE,GAA4B,EAAE,EAAE,CACjD,GAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzD,EAAE,EAAE,CAAC,GAAY,EAAE,GAA4B,EAAE,EAAE,CAChD,GAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,GAAG,EAAE,CAAC,GAAY,EAAE,GAA4B,EAAE,EAAE,CAClD,CAAC,QAAQ,CAAC,GAAoB,EAAE,GAAG,CAAC;CACvC,CAAC,CAAC;AAEH,IAAI,uBAAmE,CAAC;AACxE,MAAM,oBAAoB,GAAG,GAAG,EAAE;IAChC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC7B,uBAAuB,GAAG,uBAAuB,CAAC,6BAAqB,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,uBAAuB,CAAC;AACjC,CAAC,CAAC;AAEK,MAAM,qBAAqB,GAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IAChE,MAAM,OAAO,GAAG,IAA+B,CAAC;IAChD,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAC;IAEjD,KAAK,MAAM,QAAQ,IAAI,4CAAqB,EAAE,CAAC;QAC7C,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;YACxB,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,IAAI,gCAAS,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,gCAAS,CAAW,CAAC,CAAC;QAC1D,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,sCAAe,CAAC,EAAE,CAAC;YAC9D,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,GAAG,CAAC,OAA2C,CAAC;gBAChE,OAAO,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AArBW,QAAA,qBAAqB,yBAqBhC"}

package/dist/utils/run-in-batches.d.ts

@@ -0,0 +1 @@
+export declare function runInBatches<T>(items: T[], batchSize: number, worker: (item: T) => Promise<void>): Promise<void>;

package/dist/utils/run-in-batches.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInBatches = runInBatches;
+async function runInBatches(items, batchSize, worker) {
+    if (batchSize < 1)
+        throw new RangeError("Batch size must be positive.");
+    let nextIndex = 0;
+    const runWorker = async () => {
+        while (nextIndex < items.length) {
+            const item = items[nextIndex++];
+            await worker(item);
+        }
+    };
+    const workerCount = Math.min(batchSize, items.length);
+    await Promise.all(Array.from({ length: workerCount }, runWorker));
+}
+//# sourceMappingURL=run-in-batches.js.map

package/dist/utils/run-in-batches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-in-batches.js","sourceRoot":"","sources":["../../src/utils/run-in-batches.ts"],"names":[],"mappings":";;AAOA,oCAeC;AAfM,KAAK,UAAU,YAAY,CAChC,KAAU,EACV,SAAiB,EACjB,MAAkC;IAElC,IAAI,SAAS,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACxE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE;QAC1C,OAAO,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAChC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/utils/tenant-export-archive.d.ts

@@ -0,0 +1,6 @@
+import type { ExportJobResultSummary, ExportJobTicket } from "@antelopejs/interface-dms/base/export-jobs";
+import type { BuildTenantExportArchiveOptions, StartTenantExportJobOptions } from "@antelopejs/interface-dms/base/tenant-export-archive";
+export type { BuildTenantExportArchiveOptions, StartTenantExportJobOptions, } from "@antelopejs/interface-dms/base/tenant-export-archive";
+export { TENANT_EXPORT_CONTENT_TYPE, TENANT_EXPORT_EXTENSION, } from "@antelopejs/interface-dms/base/tenant-export-archive";
+export declare function buildTenantExportArchive(options: BuildTenantExportArchiveOptions): Promise<ExportJobResultSummary>;
+export declare function startTenantExportJob(options: StartTenantExportJobOptions): Promise<ExportJobTicket>;

package/dist/utils/tenant-export-archive.js

@@ -0,0 +1,271 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TENANT_EXPORT_EXTENSION = exports.TENANT_EXPORT_CONTENT_TYPE = void 0;
+exports.buildTenantExportArchive = buildTenantExportArchive;
+exports.startTenantExportJob = startTenantExportJob;
+const node_fs_1 = __importDefault(require("node:fs"));
+const promises_1 = require("node:stream/promises");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const hooks_1 = require("@antelopejs/interface-dms/hooks");
+const archiver_1 = __importDefault(require("archiver"));
+const tenant_export_archive_1 = require("@antelopejs/interface-dms/base/tenant-export-archive");
+const export_jobs_run_1 = require("./export-jobs-run");
+var tenant_export_archive_2 = require("@antelopejs/interface-dms/base/tenant-export-archive");
+Object.defineProperty(exports, "TENANT_EXPORT_CONTENT_TYPE", { enumerable: true, get: function () { return tenant_export_archive_2.TENANT_EXPORT_CONTENT_TYPE; } });
+Object.defineProperty(exports, "TENANT_EXPORT_EXTENSION", { enumerable: true, get: function () { return tenant_export_archive_2.TENANT_EXPORT_EXTENSION; } });
+const MANIFEST_ENTRY = "manifest.json";
+const MODULES_DIRECTORY = "modules";
+const JSON_INDENT = 2;
+const JSON_EXTENSION = "json";
+const MODULE_ID_ILLEGAL_CHARS = /[^a-zA-Z0-9._-]/g;
+const MODULE_ID_REPLACEMENT = "-";
+const UNNAMED_MODULE_ID = "module";
+const PATH_SEPARATORS = /[\\/]+/;
+const TRAVERSAL_SEGMENTS = [".", ".."];
+const FULL_PROGRESS = 100;
+const DEDUPE_START_SUFFIX = 2;
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function abortReason(signal) {
+    return signal.reason ?? new Error("Tenant export aborted");
+}
+class ExportArchiveWriter {
+    signal;
+    archive = (0, archiver_1.default)("zip");
+    output;
+    failure;
+    constructor(localPath, signal) {
+        this.signal = signal;
+        this.output = node_fs_1.default.createWriteStream(localPath);
+        this.archive.pipe(this.output);
+        this.archive.on("error", (error) => {
+            this.failure ??= error;
+        });
+        this.archive.on("warning", (warning) => {
+            logging_1.Logging.Warn("[dms] tenant export archive warning:", warning);
+        });
+        this.output.on("error", (error) => {
+            this.failure ??= error;
+        });
+        this.signal.addEventListener("abort", () => this.archive.abort(), {
+            once: true,
+        });
+    }
+    throwIfAborted() {
+        if (this.signal.aborted) {
+            throw abortReason(this.signal);
+        }
+    }
+    assertUsable() {
+        if (this.failure) {
+            throw this.failure;
+        }
+    }
+    appendJson(name, data) {
+        const payload = Buffer.from(JSON.stringify(data, null, JSON_INDENT));
+        return this.append(name, () => {
+            this.archive.append(payload, { name });
+        });
+    }
+    appendStream(name, stream) {
+        return this.append(name, () => {
+            this.archive.append(stream, { name });
+        });
+    }
+    async appendFile(name, localPath) {
+        await node_fs_1.default.promises.stat(localPath);
+        await this.append(name, () => {
+            this.archive.file(localPath, { name });
+        });
+    }
+    async finalize() {
+        const closed = (0, promises_1.finished)(this.output);
+        closed.catch(() => undefined);
+        await this.archive.finalize();
+        await closed;
+    }
+    destroy() {
+        this.archive.abort();
+        this.output.destroy();
+    }
+    async append(name, enqueue) {
+        this.throwIfAborted();
+        this.assertUsable();
+        const consumed = this.waitForEntry(name);
+        enqueue();
+        await consumed;
+    }
+    waitForEntry(name) {
+        return new Promise((resolve, reject) => {
+            const settle = (outcome) => {
+                this.archive.off("entry", onEntry);
+                this.archive.off("error", onError);
+                this.signal.removeEventListener("abort", onAbort);
+                outcome();
+            };
+            const onEntry = (entry) => {
+                if (entry.name === name)
+                    settle(resolve);
+            };
+            const onError = (error) => settle(() => reject(error));
+            const onAbort = () => settle(() => reject(abortReason(this.signal)));
+            this.archive.on("entry", onEntry);
+            this.archive.on("error", onError);
+            this.signal.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+}
+class ScopedTenantExportArchive {
+    writer;
+    moduleId;
+    entries = [];
+    closed = false;
+    constructor(writer, moduleId) {
+        this.writer = writer;
+        this.moduleId = moduleId;
+    }
+    close() {
+        this.closed = true;
+    }
+    addJson(path, data) {
+        return this.add(path, (name) => this.writer.appendJson(name, data));
+    }
+    addFile(path, localPath) {
+        return this.add(path, (name) => this.writer.appendFile(name, localPath));
+    }
+    addStream(path, stream) {
+        return this.add(path, (name) => this.writer.appendStream(name, stream));
+    }
+    async add(path, append) {
+        if (this.closed) {
+            throw new Error(`Tenant export archive for '${this.moduleId}' is no longer writable`);
+        }
+        const name = this.resolveEntryName(path);
+        await append(name);
+        this.entries.push(name);
+    }
+    resolveEntryName(path) {
+        const segments = path
+            .split(PATH_SEPARATORS)
+            .filter((segment) => segment !== "" && !TRAVERSAL_SEGMENTS.includes(segment));
+        if (segments.length === 0) {
+            throw new Error(`Invalid tenant export archive path: '${path}'`);
+        }
+        return [MODULES_DIRECTORY, this.moduleId, ...segments].join("/");
+    }
+}
+function sanitizeModuleId(moduleId) {
+    return moduleId.replace(MODULE_ID_ILLEGAL_CHARS, MODULE_ID_REPLACEMENT);
+}
+function resolveModuleIds(contributors) {
+    const taken = new Set();
+    return contributors.map((contributor, index) => {
+        const base = sanitizeModuleId(contributor.moduleId ?? `${UNNAMED_MODULE_ID}-${index}`);
+        let candidate = base;
+        let suffix = DEDUPE_START_SUFFIX;
+        while (taken.has(candidate)) {
+            candidate = `${base}-${suffix}`;
+            suffix++;
+        }
+        taken.add(candidate);
+        return candidate;
+    });
+}
+async function writeContribution(writer, moduleId, contribution) {
+    if (!contribution)
+        return undefined;
+    await writer.appendJson(`${MODULES_DIRECTORY}/${moduleId}.${JSON_EXTENSION}`, contribution.data);
+    return contribution.moduleId === moduleId ? undefined : contribution.moduleId;
+}
+async function collectContribution(scoped, contributor, options) {
+    try {
+        return await contributor.handler(options.tenantId, scoped, options.signal);
+    }
+    finally {
+        scoped.close();
+    }
+}
+async function runContributor(writer, moduleId, contributor, options) {
+    const scoped = new ScopedTenantExportArchive(writer, moduleId);
+    try {
+        const contribution = await collectContribution(scoped, contributor, options);
+        const declaredModuleId = await writeContribution(writer, moduleId, contribution);
+        return {
+            moduleId,
+            declaredModuleId,
+            entries: scoped.entries,
+            failed: false,
+        };
+    }
+    catch (error) {
+        writer.throwIfAborted();
+        writer.assertUsable();
+        logging_1.Logging.Error(`[dms] tenant data export contributor '${moduleId}' failed:`, error);
+        return {
+            moduleId,
+            entries: scoped.entries,
+            failed: true,
+            error: describeError(error),
+        };
+    }
+}
+async function runContributors(writer, options) {
+    const contributors = (0, hooks_1.GetRegisteredHooks)(hooks_1.Hook.TENANT_DATA_EXPORT);
+    const moduleIds = resolveModuleIds(contributors);
+    const reports = [];
+    for (const [index, contributor] of contributors.entries()) {
+        writer.throwIfAborted();
+        reports.push(await runContributor(writer, moduleIds[index], contributor, options));
+        await options.reportProgress?.(((index + 1) / contributors.length) * FULL_PROGRESS);
+    }
+    return reports;
+}
+function buildManifest(tenantId, reports) {
+    return {
+        tenantId,
+        exportedAt: new Date().toISOString(),
+        partial: reports.some((report) => report.failed),
+        modules: reports,
+    };
+}
+function summarize(reports) {
+    const failures = reports
+        .filter((report) => report.failed)
+        .map((report) => ({
+        source: report.moduleId,
+        error: report.error ?? "",
+    }));
+    return { partial: failures.length > 0, failures };
+}
+async function buildTenantExportArchive(options) {
+    const writer = new ExportArchiveWriter(options.localPath, options.signal);
+    try {
+        const reports = await runContributors(writer, options);
+        await writer.appendJson(MANIFEST_ENTRY, buildManifest(options.tenantId, reports));
+        await writer.finalize();
+        return summarize(reports);
+    }
+    catch (error) {
+        writer.destroy();
+        throw error;
+    }
+}
+function startTenantExportJob(options) {
+    return (0, export_jobs_run_1.runExportJob)({
+        ...options,
+        extension: tenant_export_archive_1.TENANT_EXPORT_EXTENSION,
+        contentType: tenant_export_archive_1.TENANT_EXPORT_CONTENT_TYPE,
+        retainUntilExpiry: true,
+        generate: ({ tenantId, localPath, signal, reportProgress }) => buildTenantExportArchive({
+            tenantId,
+            localPath,
+            signal,
+            reportProgress,
+        }),
+    });
+}
+//# sourceMappingURL=tenant-export-archive.js.map