@marinoscar/platform-api 0.1.0-next.26 → 0.1.0-next.27

package/dist/storage/migration/copy-and-verify.js

@@ -0,0 +1,94 @@
+"use strict";
+// =============================================================================
+// Stream one object from a source provider to a target provider, then prove it
+// (issue #1093)
+// =============================================================================
+//
+// NEVER BUFFERED. The source download is piped through a metering transform
+// (sha256 and byte count, computed on the same pass) straight into the target's
+// `upload`, so memory is bounded by the stream's high-water mark whatever the
+// object's size.
+//
+// VERIFIED BEFORE ANY REPOINT. After the upload resolves, the object is read
+// BACK from the target, streamed through a second hash, and three facts must
+// agree: the bytes read from the source, the bytes read back from the target,
+// and the row's recorded size. A target that acknowledged an upload it did not
+// keep, truncated it, or a source that changed under the copy, all fail here,
+// and the caller leaves the row pointing at the source.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageCopyVerificationError = void 0;
+exports.copyAndVerify = copyAndVerify;
+const node_crypto_1 = require("node:crypto");
+const node_stream_1 = require("node:stream");
+/**
+ * A copy that did not verify. Thrown by {@link copyAndVerify}; the job retries it.
+ *
+ * @stability experimental
+ */
+class StorageCopyVerificationError extends Error {
+    /** @param message - which fact disagreed. */
+    constructor(message) {
+        super(message);
+        this.name = 'StorageCopyVerificationError';
+    }
+}
+exports.StorageCopyVerificationError = StorageCopyVerificationError;
+function meter() {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    let bytes = 0n;
+    const transform = new node_stream_1.Transform({
+        transform(chunk, _encoding, callback) {
+            hash.update(chunk);
+            bytes += BigInt(chunk.length);
+            callback(null, chunk);
+        },
+    });
+    return { transform, digest: () => ({ bytes, sha256: hash.digest('hex') }) };
+}
+async function hashStream(stream) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    let bytes = 0n;
+    for await (const chunk of stream) {
+        const buffer = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
+        hash.update(buffer);
+        bytes += BigInt(buffer.length);
+    }
+    return { bytes, sha256: hash.digest('hex') };
+}
+/**
+ * Copies `key` from `source` to `target` under the same key, by streaming, and
+ * verifies the copy by reading it back.
+ *
+ * @param source - the provider the row records.
+ * @param target - the provider the run copies to.
+ * @param object - the row's key, media type and size.
+ * @returns the verified byte count and sha256.
+ * @throws StorageCopyVerificationError when a size or checksum disagrees; any provider error as thrown.
+ *
+ * @stability experimental
+ */
+async function copyAndVerify(source, target, object) {
+    const input = await source.download(object.storageKey);
+    const metered = meter();
+    // A source error must abort the upload, not leave it waiting for more bytes.
+    input.once('error', (error) => metered.transform.destroy(error));
+    input.pipe(metered.transform);
+    await target.upload(object.storageKey, metered.transform, {
+        mimeType: object.mimeType,
+        contentLength: Number(object.size),
+    });
+    const sent = metered.digest();
+    if (sent.bytes !== object.size) {
+        throw new StorageCopyVerificationError(`read ${sent.bytes} byte(s) from the source but the row records ${object.size}`);
+    }
+    const readBack = await hashStream(await target.download(object.storageKey));
+    if (readBack.bytes !== sent.bytes) {
+        throw new StorageCopyVerificationError(`the target holds ${readBack.bytes} byte(s), ${sent.bytes} were sent`);
+    }
+    if (readBack.sha256 !== sent.sha256) {
+        throw new StorageCopyVerificationError('the checksum of the bytes read back from the target differs from the source');
+    }
+    return sent;
+}
+//# sourceMappingURL=copy-and-verify.js.map

package/dist/storage/migration/copy-and-verify.js.map

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

package/dist/storage/migration/dto/storage-migration.dto.d.ts

@@ -0,0 +1,73 @@
+import { startStorageMigrationSchema, storageMigrationListQuerySchema, storageMigrationRunListSchema, storageMigrationRunSchema } from '@marinoscar/platform-contract/storage';
+export { startStorageMigrationSchema, storageMigrationListQuerySchema, storageMigrationRunListSchema, storageMigrationRunSchema };
+export type { StartStorageMigrationInput, StorageMigrationListQuery, StorageMigrationRun, StorageMigrationRunList, } from '@marinoscar/platform-contract/storage';
+declare const StartStorageMigrationDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    sourceProvider: import("zod").ZodString;
+    targetProvider: import("zod").ZodString;
+}, import("zod/v4/core").$strict>, false>;
+/**
+ * `startStorageMigrationSchema` (`@marinoscar/platform-contract/storage`) as a Nest DTO: the OpenAPI component and the validated body.
+ *
+ * @stability experimental
+ */
+export declare class StartStorageMigrationDto extends StartStorageMigrationDto_base {
+}
+declare const StorageMigrationRunDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    sourceProvider: import("zod").ZodString;
+    targetProvider: import("zod").ZodString;
+    status: import("zod").ZodEnum<import("@marinoscar/platform-contract/storage").StorageEnum<typeof import("@marinoscar/platform-contract/storage").STORAGE_MIGRATION_RUN_STATUSES>>;
+    totalCount: import("zod").ZodNumber;
+    migratedCount: import("zod").ZodNumber;
+    failedCount: import("zod").ZodNumber;
+    skippedCount: import("zod").ZodNumber;
+    pendingCount: import("zod").ZodNumber;
+    startedById: import("zod").ZodNullable<import("zod").ZodString>;
+    startedAt: import("zod").ZodNullable<import("zod").ZodString>;
+    plannedAt: import("zod").ZodNullable<import("zod").ZodString>;
+    finishedAt: import("zod").ZodNullable<import("zod").ZodString>;
+    cancelledAt: import("zod").ZodNullable<import("zod").ZodString>;
+    lastError: import("zod").ZodNullable<import("zod").ZodString>;
+    createdAt: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, false>;
+/**
+ * `storageMigrationRunSchema` (`@marinoscar/platform-contract/storage`) as a Nest DTO: the OpenAPI component of one run.
+ *
+ * @stability experimental
+ */
+export declare class StorageMigrationRunDto extends StorageMigrationRunDto_base {
+}
+declare const StorageMigrationRunListDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    items: import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        sourceProvider: import("zod").ZodString;
+        targetProvider: import("zod").ZodString;
+        status: import("zod").ZodEnum<import("@marinoscar/platform-contract/storage").StorageEnum<typeof import("@marinoscar/platform-contract/storage").STORAGE_MIGRATION_RUN_STATUSES>>;
+        totalCount: import("zod").ZodNumber;
+        migratedCount: import("zod").ZodNumber;
+        failedCount: import("zod").ZodNumber;
+        skippedCount: import("zod").ZodNumber;
+        pendingCount: import("zod").ZodNumber;
+        startedById: import("zod").ZodNullable<import("zod").ZodString>;
+        startedAt: import("zod").ZodNullable<import("zod").ZodString>;
+        plannedAt: import("zod").ZodNullable<import("zod").ZodString>;
+        finishedAt: import("zod").ZodNullable<import("zod").ZodString>;
+        cancelledAt: import("zod").ZodNullable<import("zod").ZodString>;
+        lastError: import("zod").ZodNullable<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    meta: import("zod").ZodObject<{
+        page: import("zod").ZodNumber;
+        pageSize: import("zod").ZodNumber;
+        totalItems: import("zod").ZodNumber;
+        totalPages: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strip>, false>;
+/**
+ * `storageMigrationRunListSchema` (`@marinoscar/platform-contract/storage`) as a Nest DTO: the OpenAPI component of one page of runs.
+ *
+ * @stability experimental
+ */
+export declare class StorageMigrationRunListDto extends StorageMigrationRunListDto_base {
+}
+//# sourceMappingURL=storage-migration.dto.d.ts.map

package/dist/storage/migration/dto/storage-migration.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-migration.dto.d.ts","sourceRoot":"","sources":["../../../../src/storage/migration/dto/storage-migration.dto.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,2BAA2B,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,CAAC;AAClI,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,uCAAuC,CAAC;;;;;AAE/C;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,6BAAyC;CAAG;;;;;;;;;;;;;;;;;;;AAE1F;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,2BAAuC;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,+BAA2C;CAAG"}

package/dist/storage/migration/dto/storage-migration.dto.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageMigrationRunListDto = exports.StorageMigrationRunDto = exports.StartStorageMigrationDto = exports.storageMigrationRunSchema = exports.storageMigrationRunListSchema = exports.storageMigrationListQuerySchema = exports.startStorageMigrationSchema = void 0;
+const nestjs_zod_1 = require("nestjs-zod");
+const storage_1 = require("@marinoscar/platform-contract/storage");
+Object.defineProperty(exports, "startStorageMigrationSchema", { enumerable: true, get: function () { return storage_1.startStorageMigrationSchema; } });
+Object.defineProperty(exports, "storageMigrationListQuerySchema", { enumerable: true, get: function () { return storage_1.storageMigrationListQuerySchema; } });
+Object.defineProperty(exports, "storageMigrationRunListSchema", { enumerable: true, get: function () { return storage_1.storageMigrationRunListSchema; } });
+Object.defineProperty(exports, "storageMigrationRunSchema", { enumerable: true, get: function () { return storage_1.storageMigrationRunSchema; } });
+/**
+ * `startStorageMigrationSchema` (`@marinoscar/platform-contract/storage`) as a Nest DTO: the OpenAPI component and the validated body.
+ *
+ * @stability experimental
+ */
+class StartStorageMigrationDto extends (0, nestjs_zod_1.createZodDto)(storage_1.startStorageMigrationSchema) {
+}
+exports.StartStorageMigrationDto = StartStorageMigrationDto;
+/**
+ * `storageMigrationRunSchema` (`@marinoscar/platform-contract/storage`) as a Nest DTO: the OpenAPI component of one run.
+ *
+ * @stability experimental
+ */
+class StorageMigrationRunDto extends (0, nestjs_zod_1.createZodDto)(storage_1.storageMigrationRunSchema) {
+}
+exports.StorageMigrationRunDto = StorageMigrationRunDto;
+/**
+ * `storageMigrationRunListSchema` (`@marinoscar/platform-contract/storage`) as a Nest DTO: the OpenAPI component of one page of runs.
+ *
+ * @stability experimental
+ */
+class StorageMigrationRunListDto extends (0, nestjs_zod_1.createZodDto)(storage_1.storageMigrationRunListSchema) {
+}
+exports.StorageMigrationRunListDto = StorageMigrationRunListDto;
+//# sourceMappingURL=storage-migration.dto.js.map

package/dist/storage/migration/dto/storage-migration.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-migration.dto.js","sourceRoot":"","sources":["../../../../src/storage/migration/dto/storage-migration.dto.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAC1C,mEAK+C;AAEtC,4GANP,qCAA2B,OAMO;AAAE,gHALpC,yCAA+B,OAKoC;AAAE,8GAJrE,uCAA6B,OAIqE;AAAE,0GAHpG,mCAAyB,OAGoG;AAQ/H;;;;GAIG;AACH,MAAa,wBAAyB,SAAQ,IAAA,yBAAY,EAAC,qCAA2B,CAAC;CAAG;AAA1F,4DAA0F;AAE1F;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,IAAA,yBAAY,EAAC,mCAAyB,CAAC;CAAG;AAAtF,wDAAsF;AAEtF;;;;GAIG;AACH,MAAa,0BAA2B,SAAQ,IAAA,yBAAY,EAAC,uCAA6B,CAAC;CAAG;AAA9F,gEAA8F"}

package/dist/storage/migration/index.d.ts

@@ -0,0 +1,11 @@
+export { StorageMigrationService } from './storage-migration.service';
+export type { StorageMigrationItemCounts, StorageMigrationRunPage, StorageMigrationRunView } from './storage-migration.service';
+export { StorageMigratePlanHandler } from './storage-migrate-plan.handler';
+export type { StorageMigratePlanPayload } from './storage-migrate-plan.handler';
+export { StorageMigrateObjectHandler } from './storage-migrate-object.handler';
+export type { StorageMigrateObjectPayload } from './storage-migrate-object.handler';
+export { StorageCopyVerificationError, copyAndVerify } from './copy-and-verify';
+export type { VerifiedCopy } from './copy-and-verify';
+export { STORAGE_MIGRATE_OBJECT_TYPE, STORAGE_MIGRATE_PLAN_TYPE, STORAGE_MIGRATION_ACTIVE_INDEX, STORAGE_MIGRATION_AUDIT_ACTIONS, STORAGE_MIGRATION_ITEM_SUBJECT_TYPE, STORAGE_MIGRATION_PRIORITY, STORAGE_MIGRATION_RUN_SUBJECT_TYPE, STORAGE_MIGRATION_SYSTEM_ACCESS_REASON, registerStorageMigrationSystemAccessReason, } from './storage-migration.constants';
+export { StorageMigrationSettledListener } from './storage-migration-settled.listener';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/migration/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAChI,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,YAAY,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,+BAA+B,EAC/B,mCAAmC,EACnC,0BAA0B,EAC1B,kCAAkC,EAClC,sCAAsC,EACtC,0CAA0C,GAC3C,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/storage/migration/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageMigrationSettledListener = exports.registerStorageMigrationSystemAccessReason = exports.STORAGE_MIGRATION_SYSTEM_ACCESS_REASON = exports.STORAGE_MIGRATION_RUN_SUBJECT_TYPE = exports.STORAGE_MIGRATION_PRIORITY = exports.STORAGE_MIGRATION_ITEM_SUBJECT_TYPE = exports.STORAGE_MIGRATION_AUDIT_ACTIONS = exports.STORAGE_MIGRATION_ACTIVE_INDEX = exports.STORAGE_MIGRATE_PLAN_TYPE = exports.STORAGE_MIGRATE_OBJECT_TYPE = exports.copyAndVerify = exports.StorageCopyVerificationError = exports.StorageMigrateObjectHandler = exports.StorageMigratePlanHandler = exports.StorageMigrationService = void 0;
+// Copy-only storage provider migration (issue #1093). Exported from the
+// storage slice index.
+var storage_migration_service_1 = require("./storage-migration.service");
+Object.defineProperty(exports, "StorageMigrationService", { enumerable: true, get: function () { return storage_migration_service_1.StorageMigrationService; } });
+var storage_migrate_plan_handler_1 = require("./storage-migrate-plan.handler");
+Object.defineProperty(exports, "StorageMigratePlanHandler", { enumerable: true, get: function () { return storage_migrate_plan_handler_1.StorageMigratePlanHandler; } });
+var storage_migrate_object_handler_1 = require("./storage-migrate-object.handler");
+Object.defineProperty(exports, "StorageMigrateObjectHandler", { enumerable: true, get: function () { return storage_migrate_object_handler_1.StorageMigrateObjectHandler; } });
+var copy_and_verify_1 = require("./copy-and-verify");
+Object.defineProperty(exports, "StorageCopyVerificationError", { enumerable: true, get: function () { return copy_and_verify_1.StorageCopyVerificationError; } });
+Object.defineProperty(exports, "copyAndVerify", { enumerable: true, get: function () { return copy_and_verify_1.copyAndVerify; } });
+var storage_migration_constants_1 = require("./storage-migration.constants");
+Object.defineProperty(exports, "STORAGE_MIGRATE_OBJECT_TYPE", { enumerable: true, get: function () { return storage_migration_constants_1.STORAGE_MIGRATE_OBJECT_TYPE; } });
+Object.defineProperty(exports, "STORAGE_MIGRATE_PLAN_TYPE", { enumerable: true, get: function () { return storage_migration_constants_1.STORAGE_MIGRATE_PLAN_TYPE; } });
+Object.defineProperty(exports, "STORAGE_MIGRATION_ACTIVE_INDEX", { enumerable: true, get: function () { return storage_migration_constants_1.STORAGE_MIGRATION_ACTIVE_INDEX; } });
+Object.defineProperty(exports, "STORAGE_MIGRATION_AUDIT_ACTIONS", { enumerable: true, get: function () { return storage_migration_constants_1.STORAGE_MIGRATION_AUDIT_ACTIONS; } });
+Object.defineProperty(exports, "STORAGE_MIGRATION_ITEM_SUBJECT_TYPE", { enumerable: true, get: function () { return storage_migration_constants_1.STORAGE_MIGRATION_ITEM_SUBJECT_TYPE; } });
+Object.defineProperty(exports, "STORAGE_MIGRATION_PRIORITY", { enumerable: true, get: function () { return storage_migration_constants_1.STORAGE_MIGRATION_PRIORITY; } });
+Object.defineProperty(exports, "STORAGE_MIGRATION_RUN_SUBJECT_TYPE", { enumerable: true, get: function () { return storage_migration_constants_1.STORAGE_MIGRATION_RUN_SUBJECT_TYPE; } });
+Object.defineProperty(exports, "STORAGE_MIGRATION_SYSTEM_ACCESS_REASON", { enumerable: true, get: function () { return storage_migration_constants_1.STORAGE_MIGRATION_SYSTEM_ACCESS_REASON; } });
+Object.defineProperty(exports, "registerStorageMigrationSystemAccessReason", { enumerable: true, get: function () { return storage_migration_constants_1.registerStorageMigrationSystemAccessReason; } });
+var storage_migration_settled_listener_1 = require("./storage-migration-settled.listener");
+Object.defineProperty(exports, "StorageMigrationSettledListener", { enumerable: true, get: function () { return storage_migration_settled_listener_1.StorageMigrationSettledListener; } });
+//# sourceMappingURL=index.js.map

package/dist/storage/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/migration/index.ts"],"names":[],"mappings":";;;AAAA,wEAAwE;AACxE,uBAAuB;AACvB,yEAAsE;AAA7D,oIAAA,uBAAuB,OAAA;AAEhC,+EAA2E;AAAlE,yIAAA,yBAAyB,OAAA;AAElC,mFAA+E;AAAtE,6IAAA,2BAA2B,OAAA;AAEpC,qDAAgF;AAAvE,+HAAA,4BAA4B,OAAA;AAAE,gHAAA,aAAa,OAAA;AAEpD,6EAUuC;AATrC,0IAAA,2BAA2B,OAAA;AAC3B,wIAAA,yBAAyB,OAAA;AACzB,6IAAA,8BAA8B,OAAA;AAC9B,8IAAA,+BAA+B,OAAA;AAC/B,kJAAA,mCAAmC,OAAA;AACnC,yIAAA,0BAA0B,OAAA;AAC1B,iJAAA,kCAAkC,OAAA;AAClC,qJAAA,sCAAsC,OAAA;AACtC,yJAAA,0CAA0C,OAAA;AAE5C,2FAAuF;AAA9E,qJAAA,+BAA+B,OAAA"}

package/dist/storage/migration/storage-migrate-object.handler.d.ts

@@ -0,0 +1,40 @@
+import { OnModuleInit } from '@nestjs/common';
+import { JobHandlerRegistry, JobScope, type Job, type JobExecutionProfile, type JobHandler } from '../../jobs/index';
+import { StorageConfigService } from '../config/storage-config.service';
+import { StorageProviderRouter } from '../providers/storage-provider-router';
+import { StorageMigrationService } from './storage-migration.service';
+/**
+ * The per-object job's payload.
+ *
+ * @stability experimental
+ */
+export interface StorageMigrateObjectPayload {
+    /** The run. */
+    runId: string;
+    /** The item (one object of the run). */
+    itemId: string;
+}
+/**
+ * The server-only `storage.migrate_object` job: streams one object from the run's source driver to its target, verifies size and sha256 by reading it back, repoints the row and leaves the source in place.
+ *
+ * @stability experimental
+ */
+export declare class StorageMigrateObjectHandler implements JobHandler, OnModuleInit {
+    private readonly registry;
+    private readonly migrations;
+    private readonly jobScope;
+    private readonly router;
+    private readonly storageConfig;
+    private readonly logger;
+    readonly type = "storage.migrate_object";
+    readonly label = "Storage migration (copy object)";
+    /** One object can be several gigabytes, copied and then read back. */
+    readonly profile: JobExecutionProfile;
+    constructor(registry: JobHandlerRegistry, migrations: StorageMigrationService, jobScope: JobScope, router: StorageProviderRouter, storageConfig: StorageConfigService);
+    /** Self-registration. */
+    onModuleInit(): void;
+    /** Copies, verifies and repoints the job's object; see the file header. */
+    process(job: Job): Promise<void>;
+    private skip;
+}
+//# sourceMappingURL=storage-migrate-object.handler.d.ts.map

package/dist/storage/migration/storage-migrate-object.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-migrate-object.handler.d.ts","sourceRoot":"","sources":["../../../src/storage/migration/storage-migrate-object.handler.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,KAAK,GAAG,EACR,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AASxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD;;;;GAIG;AACH,qBACa,2BAA4B,YAAW,UAAU,EAAE,YAAY;IAWxE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAdhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;IAEvE,QAAQ,CAAC,IAAI,4BAA+B;IAE5C,QAAQ,CAAC,KAAK,qCAAqC;IAEnD,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAiD;gBAGnE,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,uBAAuB,EACnC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,qBAAqB,EAC7B,aAAa,EAAE,oBAAoB;IAGtD,yBAAyB;IACzB,YAAY,IAAI,IAAI;IAIpB,2EAA2E;IACrE,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YA8ExB,IAAI;CAMnB"}

package/dist/storage/migration/storage-migrate-object.handler.js

@@ -0,0 +1,177 @@
+"use strict";
+// =============================================================================
+// `storage.migrate_object` — copy one object to the run's target driver,
+// verify it, repoint its row, leave the source (issue #1093)
+// =============================================================================
+//
+// ORDER, AND WHY IT IS THE WHOLE DESIGN
+//
+//   1. The run must still be running. A cancelled (or finished) run's item is
+//      marked `skipped` and nothing is copied: a cancelled run stops before its
+//      next unclaimed object.
+//   2. The item and its object are read in the object's organization
+//      (`JobScope.run`, the job carries the object's `orgId`). An object that is
+//      gone, not `ready`, or no longer recorded on the source (repointed by an
+//      earlier run, re-uploaded elsewhere) is `skipped`: a re-run never copies
+//      an already-migrated object twice.
+//   3. The bytes are STREAMED from the source into the target and read back
+//      (`copyAndVerify`): the byte count and the sha256 must agree on both sides
+//      and with the row's size. Nothing is buffered.
+//   4. Only then is the row repointed, in one org-scoped transaction, guarded by
+//      `storage_provider = source AND storage_key = key`: an object changed while
+//      it was being copied is not repointed (it is `skipped`), so the row never
+//      points at bytes that are not its own.
+//   5. The source object is NEVER deleted: it is the fallback.
+//
+// FAILURE. A thrown error (a network glitch, throttling, a verification
+// mismatch) is retried by the queue with backoff; the item stays `copying`.
+// When the job gives up, `StorageMigrationSettledListener` marks a still-open item `failed` — a
+// listener rather than an "is this my last attempt?" check, because a timeout
+// or a dead executor never returns into `process`.
+//
+// SERVER-ONLY BY DERIVATION: neither `nodeResultSchema` nor `persistNodeResult`.
+// The copy needs BOTH drivers' secrets, which are never brokered to a worker
+// node.
+// =============================================================================
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var StorageMigrateObjectHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageMigrateObjectHandler = void 0;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../../jobs/index");
+const storage_config_service_1 = require("../config/storage-config.service");
+const storage_db_1 = require("../data/storage-db");
+const storage_provider_router_1 = require("../providers/storage-provider-router");
+const copy_and_verify_1 = require("./copy-and-verify");
+const storage_migration_constants_1 = require("./storage-migration.constants");
+const storage_migration_service_1 = require("./storage-migration.service");
+function readPayload(job) {
+    const payload = job.payload;
+    if (!payload || typeof payload.runId !== 'string' || typeof payload.itemId !== 'string') {
+        throw new Error(`${storage_migration_constants_1.STORAGE_MIGRATE_OBJECT_TYPE} job ${job.id} has an invalid payload`);
+    }
+    return { runId: payload.runId, itemId: payload.itemId };
+}
+/**
+ * The server-only `storage.migrate_object` job: streams one object from the run's source driver to its target, verifies size and sha256 by reading it back, repoints the row and leaves the source in place.
+ *
+ * @stability experimental
+ */
+let StorageMigrateObjectHandler = StorageMigrateObjectHandler_1 = class StorageMigrateObjectHandler {
+    registry;
+    migrations;
+    jobScope;
+    router;
+    storageConfig;
+    logger = new common_1.Logger(StorageMigrateObjectHandler_1.name);
+    type = storage_migration_constants_1.STORAGE_MIGRATE_OBJECT_TYPE;
+    label = 'Storage migration (copy object)';
+    /** One object can be several gigabytes, copied and then read back. */
+    profile = { maxRuntimeMs: 60 * 60_000, maxAttempts: 3 };
+    constructor(registry, migrations, jobScope, router, storageConfig) {
+        this.registry = registry;
+        this.migrations = migrations;
+        this.jobScope = jobScope;
+        this.router = router;
+        this.storageConfig = storageConfig;
+    }
+    /** Self-registration. */
+    onModuleInit() {
+        this.registry.register(this);
+    }
+    /** Copies, verifies and repoints the job's object; see the file header. */
+    async process(job) {
+        const { runId, itemId } = readPayload(job);
+        const run = await this.migrations.db().storageMigrationRun.findUnique({ where: { id: runId } });
+        if (!run)
+            return;
+        const claim = await this.jobScope.run(job, async (tx) => {
+            const item = await tx.storageMigrationItem.findUnique({ where: { id: itemId } });
+            if (!item || (item.status !== storage_db_1.StorageMigrationItemStatus.pending && item.status !== storage_db_1.StorageMigrationItemStatus.copying)) {
+                return { kind: 'done' };
+            }
+            if (run.status !== storage_db_1.StorageMigrationRunStatus.running) {
+                await this.skip(tx, itemId, `Run ${run.status}`);
+                return { kind: 'skipped' };
+            }
+            const object = await tx.storageObject.findUnique({ where: { id: item.objectId } });
+            if (!object || object.status !== storage_db_1.StorageObjectStatus.ready) {
+                await this.skip(tx, itemId, 'The object is gone or not ready');
+                return { kind: 'skipped' };
+            }
+            if (object.storageProvider !== run.sourceProvider) {
+                await this.skip(tx, itemId, `The object is recorded on "${object.storageProvider}", not on the source`);
+                return { kind: 'skipped' };
+            }
+            await tx.storageMigrationItem.update({ where: { id: itemId }, data: { status: storage_db_1.StorageMigrationItemStatus.copying } });
+            return { kind: 'copy', object };
+        });
+        if (claim.kind === 'done')
+            return;
+        if (claim.kind === 'skipped') {
+            await this.migrations.finalizeIfDone(runId);
+            return;
+        }
+        const { object } = claim;
+        // Both drivers must be buildable: the router would serve an unbuildable one
+        // with the ACTIVE provider, which is the wrong place to read or write.
+        for (const provider of [run.sourceProvider, run.targetProvider]) {
+            const resolution = await this.storageConfig.resolveDriver(provider);
+            if (!resolution.configured) {
+                throw new Error(`Storage driver "${provider}" is not configured (missing ${resolution.missing.join(', ')})`);
+            }
+        }
+        const source = await this.router.forObject(object);
+        const target = await this.router.forLocation({ provider: run.targetProvider, bucket: '' });
+        const verified = await (0, copy_and_verify_1.copyAndVerify)(source, target, object);
+        const targetBucket = target.getBucket();
+        const repointed = await this.jobScope.run(job, async (tx) => {
+            const moved = await tx.storageObject.updateMany({
+                where: { id: object.id, storageProvider: run.sourceProvider, storageKey: object.storageKey },
+                data: { storageProvider: run.targetProvider, bucket: targetBucket },
+            });
+            if (moved.count === 0) {
+                await this.skip(tx, itemId, 'The object changed while it was being copied; not repointed');
+                return false;
+            }
+            await tx.storageMigrationItem.update({
+                where: { id: itemId },
+                data: {
+                    status: storage_db_1.StorageMigrationItemStatus.migrated,
+                    sizeBytes: verified.bytes,
+                    checksumSha256: verified.sha256,
+                    lastError: null,
+                },
+            });
+            return true;
+        });
+        if (repointed) {
+            this.logger.log(`Storage migration ${runId}: object ${object.id} copied ${run.sourceProvider} -> ${run.targetProvider} (${verified.bytes} bytes, verified)`);
+        }
+        await this.migrations.finalizeIfDone(runId);
+    }
+    async skip(tx, itemId, reason) {
+        await tx.storageMigrationItem.update({
+            where: { id: itemId },
+            data: { status: storage_db_1.StorageMigrationItemStatus.skipped, lastError: reason },
+        });
+    }
+};
+exports.StorageMigrateObjectHandler = StorageMigrateObjectHandler;
+exports.StorageMigrateObjectHandler = StorageMigrateObjectHandler = StorageMigrateObjectHandler_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [index_1.JobHandlerRegistry,
+        storage_migration_service_1.StorageMigrationService,
+        index_1.JobScope,
+        storage_provider_router_1.StorageProviderRouter,
+        storage_config_service_1.StorageConfigService])
+], StorageMigrateObjectHandler);
+//# sourceMappingURL=storage-migrate-object.handler.js.map

package/dist/storage/migration/storage-migrate-object.handler.js.map

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

package/dist/storage/migration/storage-migrate-plan.handler.d.ts

@@ -0,0 +1,34 @@
+import { OnModuleInit } from '@nestjs/common';
+import { JobHandlerRegistry, JobsService, type Job, type JobExecutionProfile, type JobHandler } from '../../jobs/index';
+import { StorageMigrationService } from './storage-migration.service';
+/**
+ * The planner job's payload.
+ *
+ * @stability experimental
+ */
+export interface StorageMigratePlanPayload {
+    /** The run to plan. */
+    runId: string;
+}
+/**
+ * The server-only `storage.migrate_plan` job: creates one item per `ready` object on the run's source driver and queues one `storage.migrate_object` job per item, resumably; a planner that gives up fails its run.
+ *
+ * @stability experimental
+ */
+export declare class StorageMigratePlanHandler implements JobHandler, OnModuleInit {
+    private readonly registry;
+    private readonly migrations;
+    private readonly jobs;
+    private readonly logger;
+    readonly type = "storage.migrate_plan";
+    readonly label = "Storage migration (plan)";
+    /** Listing and queueing a large deployment's objects is long but bounded work. */
+    readonly profile: JobExecutionProfile;
+    constructor(registry: JobHandlerRegistry, migrations: StorageMigrationService, jobs: JobsService);
+    /** Self-registration. */
+    onModuleInit(): void;
+    /** Plans the run named in the payload. */
+    process(job: Job): Promise<void>;
+    private cancelled;
+}
+//# sourceMappingURL=storage-migrate-plan.handler.d.ts.map

package/dist/storage/migration/storage-migrate-plan.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-migrate-plan.handler.d.ts","sourceRoot":"","sources":["../../../src/storage/migration/storage-migrate-plan.handler.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EACL,kBAAkB,EAElB,WAAW,EACX,KAAK,GAAG,EACR,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAKtE;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAUD;;;;GAIG;AACH,qBACa,yBAA0B,YAAW,UAAU,EAAE,YAAY;IAWtE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IAErE,QAAQ,CAAC,IAAI,0BAA6B;IAE1C,QAAQ,CAAC,KAAK,8BAA8B;IAE5C,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAiD;gBAGnE,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,uBAAuB,EACnC,IAAI,EAAE,WAAW;IAGpC,yBAAyB;IACzB,YAAY,IAAI,IAAI;IAIpB,0CAA0C;IACpC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAoFxB,SAAS;CAIxB"}