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

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

@@ -0,0 +1,83 @@
+"use strict";
+// =============================================================================
+// Copy-only storage provider migration: the permanent strings (issue #1093)
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORAGE_MIGRATION_AUDIT_ACTIONS = exports.STORAGE_MIGRATION_SYSTEM_ACCESS_REASON = exports.STORAGE_MIGRATION_ACTIVE_INDEX = exports.STORAGE_MIGRATION_PRIORITY = exports.STORAGE_MIGRATION_ITEM_SUBJECT_TYPE = exports.STORAGE_MIGRATION_RUN_SUBJECT_TYPE = exports.STORAGE_MIGRATE_OBJECT_TYPE = exports.STORAGE_MIGRATE_PLAN_TYPE = void 0;
+exports.registerStorageMigrationSystemAccessReason = registerStorageMigrationSystemAccessReason;
+const index_1 = require("../../core/index");
+const index_2 = require("../../jobs/index");
+/**
+ * The job type that lists a run's objects, creates one item per object and
+ * queues one {@link STORAGE_MIGRATE_OBJECT_TYPE} job per item. PERMANENT:
+ * rows outlive handlers. Server-only (no `nodeResultSchema`).
+ *
+ * @stability experimental
+ */
+exports.STORAGE_MIGRATE_PLAN_TYPE = 'storage.migrate_plan';
+/**
+ * The job type that copies ONE object to the run's target driver, verifies it
+ * and repoints its row. PERMANENT. Server-only: it needs both drivers' secrets,
+ * which are never brokered to a worker node.
+ *
+ * @stability experimental
+ */
+exports.STORAGE_MIGRATE_OBJECT_TYPE = 'storage.migrate_object';
+/**
+ * The `subjectType` of a planner job (`subjectId` is the run id).
+ *
+ * @stability experimental
+ */
+exports.STORAGE_MIGRATION_RUN_SUBJECT_TYPE = 'storage_migration_run';
+/**
+ * The `subjectType` of a per-object job (`subjectId` is the item id).
+ *
+ * @stability experimental
+ */
+exports.STORAGE_MIGRATION_ITEM_SUBJECT_TYPE = 'storage_migration_item';
+/**
+ * The queue priority of both job types: background, the housekeeping value,
+ * so a migration never delays an upload's processing.
+ *
+ * @stability experimental
+ */
+exports.STORAGE_MIGRATION_PRIORITY = index_2.HOUSEKEEPING_PRIORITY;
+/**
+ * The raw-SQL partial unique index that allows one pending or running run.
+ *
+ * @stability experimental
+ */
+exports.STORAGE_MIGRATION_ACTIVE_INDEX = 'storage_migration_runs_active_uniq_idx';
+/**
+ * The system access reason every migration query names: a run is
+ * deployment-wide (its `org_id` is NULL) and spans every organization's objects.
+ *
+ * @stability experimental
+ */
+exports.STORAGE_MIGRATION_SYSTEM_ACCESS_REASON = 'storage-migration';
+/**
+ * The audit actions the migration writes.
+ *
+ * @stability experimental
+ */
+exports.STORAGE_MIGRATION_AUDIT_ACTIONS = {
+    START: 'storage.migration.start',
+    CANCEL: 'storage.migration.cancel',
+};
+/**
+ * Registers {@link STORAGE_MIGRATION_SYSTEM_ACCESS_REASON} with core's
+ * registry, once. The service and both handlers call it from their
+ * constructors (bootstrap, before the registry freezes), so code that builds
+ * them by hand (a database test) is covered too.
+ *
+ * @stability experimental
+ */
+function registerStorageMigrationSystemAccessReason() {
+    if (index_1.systemAccessReasonRegistry.has(exports.STORAGE_MIGRATION_SYSTEM_ACCESS_REASON))
+        return;
+    (0, index_1.registerSystemAccessReason)({
+        id: exports.STORAGE_MIGRATION_SYSTEM_ACCESS_REASON,
+        description: 'Copy-only storage provider migration: deployment-wide runs (NULL org_id) and the objects of every organization they copy.',
+    });
+}
+//# sourceMappingURL=storage-migration.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-migration.constants.js","sourceRoot":"","sources":["../../../src/storage/migration/storage-migration.constants.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;;;AAmFhF,gGAOC;AAxFD,4CAA0F;AAC1F,4CAAyD;AAEzD;;;;;;GAMG;AACU,QAAA,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE;;;;;;GAMG;AACU,QAAA,2BAA2B,GAAG,wBAAwB,CAAC;AAEpE;;;;GAIG;AACU,QAAA,kCAAkC,GAAG,uBAAuB,CAAC;AAE1E;;;;GAIG;AACU,QAAA,mCAAmC,GAAG,wBAAwB,CAAC;AAE5E;;;;;GAKG;AACU,QAAA,0BAA0B,GAAW,6BAAqB,CAAC;AAExE;;;;GAIG;AACU,QAAA,8BAA8B,GAAG,wCAAwC,CAAC;AAEvF;;;;;GAKG;AACU,QAAA,sCAAsC,GAAG,mBAAmB,CAAC;AAE1E;;;;GAIG;AACU,QAAA,+BAA+B,GAKxC;IACF,KAAK,EAAE,yBAAyB;IAChC,MAAM,EAAE,0BAA0B;CAC1B,CAAC;AAEX;;;;;;;GAOG;AACH,SAAgB,0CAA0C;IACxD,IAAI,kCAA0B,CAAC,GAAG,CAAC,8CAAsC,CAAC;QAAE,OAAO;IACnF,IAAA,kCAA0B,EAAC;QACzB,EAAE,EAAE,8CAAsC;QAC1C,WAAW,EACT,2HAA2H;KAC9H,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,26 @@
+import { StartStorageMigrationDto, type StorageMigrationListQuery } from './dto/storage-migration.dto';
+import { StorageMigrationService, type StorageMigrationRunPage, type StorageMigrationRunView } from './storage-migration.service';
+/**
+ * The `/api/admin/storage/migrations` routes (`storage_config:read|write`): start, list, read and cancel a copy-only provider migration.
+ *
+ * @internal
+ *
+ * @stability experimental
+ */
+export declare class StorageMigrationController {
+    private readonly migrations;
+    constructor(migrations: StorageMigrationService);
+    start(dto: StartStorageMigrationDto, userId: string): Promise<{
+        data: StorageMigrationRunView;
+    }>;
+    list(query: StorageMigrationListQuery): Promise<{
+        data: StorageMigrationRunPage;
+    }>;
+    get(runId: string): Promise<{
+        data: StorageMigrationRunView;
+    }>;
+    cancel(runId: string, userId: string): Promise<{
+        data: StorageMigrationRunView;
+    }>;
+}
+//# sourceMappingURL=storage-migration.controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-migration.controller.d.ts","sourceRoot":"","sources":["../../../src/storage/migration/storage-migration.controller.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,wBAAwB,EAIxB,KAAK,yBAAyB,EAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAYlI;;;;;;GAMG;AACH,qBAEa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,uBAAuB;IAkB1D,KAAK,CACD,GAAG,EAAE,wBAAwB,EAClB,MAAM,EAAE,MAAM,GAChC,OAAO,CAAC;QAAE,IAAI,EAAE,uBAAuB,CAAA;KAAE,CAAC;IAavC,IAAI,CACuD,KAAK,EAAE,yBAAyB,GAC9F,OAAO,CAAC;QAAE,IAAI,EAAE,uBAAuB,CAAA;KAAE,CAAC;IAavC,GAAG,CAAgC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,uBAAuB,CAAA;KAAE,CAAC;IAkB7F,MAAM,CACqB,KAAK,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GAChC,OAAO,CAAC;QAAE,IAAI,EAAE,uBAAuB,CAAA;KAAE,CAAC;CAG9C"}

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

@@ -0,0 +1,135 @@
+"use strict";
+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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageMigrationController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const nestjs_zod_1 = require("nestjs-zod");
+const index_1 = require("../../identity/index");
+const storage_constants_1 = require("../storage.constants");
+const storage_migration_dto_1 = require("./dto/storage-migration.dto");
+const storage_migration_service_1 = require("./storage-migration.service");
+// =============================================================================
+// /api/admin/storage/migrations — copy-only storage provider migration (#1093)
+// =============================================================================
+//
+// The same permission pair as `/api/admin/storage-config` (`storage_config:*`):
+// a migration decides where the deployment's bytes live, exactly the authority
+// the configuration screen already grants. Starting and cancelling write;
+// listing and reading read.
+// =============================================================================
+/**
+ * The `/api/admin/storage/migrations` routes (`storage_config:read|write`): start, list, read and cancel a copy-only provider migration.
+ *
+ * @internal
+ *
+ * @stability experimental
+ */
+let StorageMigrationController = class StorageMigrationController {
+    migrations;
+    constructor(migrations) {
+        this.migrations = migrations;
+    }
+    async start(dto, userId) {
+        return { data: await this.migrations.start(dto, userId) };
+    }
+    async list(query) {
+        return { data: await this.migrations.list(query) };
+    }
+    async get(runId) {
+        return { data: await this.migrations.get(runId) };
+    }
+    async cancel(runId, userId) {
+        return { data: await this.migrations.cancel(runId, userId) };
+    }
+};
+exports.StorageMigrationController = StorageMigrationController;
+__decorate([
+    (0, common_1.Post)(),
+    (0, index_1.Auth)({ permissions: [storage_constants_1.PERMISSIONS.STORAGE_CONFIG_WRITE] }),
+    (0, common_1.HttpCode)(common_1.HttpStatus.CREATED),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Start a copy-only storage provider migration (Admin only)',
+        description: 'Copies every `ready` object recorded on `sourceProvider` to `targetProvider`, one queue job per ' +
+            'object: the bytes are streamed (never buffered), verified by reading them back (byte count and ' +
+            'sha256), and only then is the row repointed. **The source object is never deleted**; it stays as a ' +
+            'fallback. Returns at once; poll `GET /api/admin/storage/migrations/:runId` for progress.\n\n' +
+            'Both drivers must be registered and configured, and must not name the same bucket (`400`, ' +
+            '`details.reason`). **One run at a time**: `409` with the active run at `details.activeRunId`.',
+    }),
+    (0, swagger_1.ApiResponse)({ status: 201, description: 'The run was started', type: storage_migration_dto_1.StorageMigrationRunDto }),
+    (0, swagger_1.ApiResponse)({ status: 400, description: 'Validation error, an unknown or unconfigured driver, or the same bucket on both sides' }),
+    (0, swagger_1.ApiResponse)({ status: 409, description: 'A run is already pending or running (`details.activeRunId`)' }),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, index_1.CurrentUser)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [storage_migration_dto_1.StartStorageMigrationDto, String]),
+    __metadata("design:returntype", Promise)
+], StorageMigrationController.prototype, "start", null);
+__decorate([
+    (0, common_1.Get)(),
+    (0, index_1.Auth)({ permissions: [storage_constants_1.PERMISSIONS.STORAGE_CONFIG_READ] }),
+    (0, swagger_1.ApiOperation)({
+        summary: 'List storage provider migrations (Admin only)',
+        description: 'Runs newest first. The counts are recomputed from the runs\' items on every read.',
+    }),
+    (0, swagger_1.ApiQuery)({ name: 'page', required: false, type: Number, description: 'Page number (default: 1)' }),
+    (0, swagger_1.ApiQuery)({ name: 'pageSize', required: false, type: Number, description: 'Runs per page (default: 20, max: 100)' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'One page of runs', type: storage_migration_dto_1.StorageMigrationRunListDto }),
+    __param(0, (0, common_1.Query)(new nestjs_zod_1.ZodValidationPipe(storage_migration_dto_1.storageMigrationListQuerySchema))),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], StorageMigrationController.prototype, "list", null);
+__decorate([
+    (0, common_1.Get)(':runId'),
+    (0, index_1.Auth)({ permissions: [storage_constants_1.PERMISSIONS.STORAGE_CONFIG_READ] }),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Get a storage provider migration (Admin only)',
+        description: 'One run with live counts: total, migrated, failed, skipped and pending (queued or being copied).',
+    }),
+    (0, swagger_1.ApiParam)({ name: 'runId', type: String, format: 'uuid' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'The run', type: storage_migration_dto_1.StorageMigrationRunDto }),
+    (0, swagger_1.ApiResponse)({ status: 404, description: 'No such run' }),
+    __param(0, (0, common_1.Param)('runId', common_1.ParseUUIDPipe)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], StorageMigrationController.prototype, "get", null);
+__decorate([
+    (0, common_1.Post)(':runId/cancel'),
+    (0, index_1.Auth)({ permissions: [storage_constants_1.PERMISSIONS.STORAGE_CONFIG_WRITE] }),
+    (0, common_1.HttpCode)(common_1.HttpStatus.OK),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Cancel a storage provider migration (Admin only)',
+        description: 'Stops a pending or running run before its next unclaimed object: queued objects are marked ' +
+            '`skipped` at once. An object being copied at that moment finishes (its copy is verified). ' +
+            'Objects already repointed stay on the target, and every source object is untouched.',
+    }),
+    (0, swagger_1.ApiParam)({ name: 'runId', type: String, format: 'uuid' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'The cancelled run', type: storage_migration_dto_1.StorageMigrationRunDto }),
+    (0, swagger_1.ApiResponse)({ status: 404, description: 'No such run' }),
+    (0, swagger_1.ApiResponse)({ status: 409, description: 'The run already finished' }),
+    __param(0, (0, common_1.Param)('runId', common_1.ParseUUIDPipe)),
+    __param(1, (0, index_1.CurrentUser)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], StorageMigrationController.prototype, "cancel", null);
+exports.StorageMigrationController = StorageMigrationController = __decorate([
+    (0, swagger_1.ApiTags)('Storage Configuration'),
+    (0, common_1.Controller)('admin/storage/migrations'),
+    __metadata("design:paramtypes", [storage_migration_service_1.StorageMigrationService])
+], StorageMigrationController);
+//# sourceMappingURL=storage-migration.controller.js.map

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

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

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

@@ -0,0 +1,182 @@
+import { JobsService } from '../../jobs/index';
+import { StorageConfigService } from '../config/storage-config.service';
+import { StorageMigrationRunStatus, type StoragePrisma } from '../data/storage-db';
+import { type StorageSystemData } from '../ports';
+/**
+ * A run as the admin routes return it (the contract's `StorageMigrationRun`).
+ *
+ * @stability experimental
+ */
+export interface StorageMigrationRunView {
+    /** The run id. */
+    id: string;
+    /** The driver copied from. */
+    sourceProvider: string;
+    /** The driver copied to. */
+    targetProvider: string;
+    /** Lifecycle status. */
+    status: StorageMigrationRunStatus;
+    /** Items the run holds. */
+    totalCount: number;
+    /** Migrated items. */
+    migratedCount: number;
+    /** Failed items. */
+    failedCount: number;
+    /** Skipped items. */
+    skippedCount: number;
+    /** Queued or copying items. */
+    pendingCount: number;
+    /** Who started it. */
+    startedById: string | null;
+    /** ISO 8601 or null. */
+    startedAt: string | null;
+    /** ISO 8601 or null. */
+    plannedAt: string | null;
+    /** ISO 8601 or null. */
+    finishedAt: string | null;
+    /** ISO 8601 or null. */
+    cancelledAt: string | null;
+    /** The last error recorded. */
+    lastError: string | null;
+    /** ISO 8601. */
+    createdAt: string;
+}
+/**
+ * The per-status item counts of one run.
+ *
+ * @stability experimental
+ */
+export interface StorageMigrationItemCounts {
+    /** Every item. */
+    total: number;
+    /** `migrated`. */
+    migrated: number;
+    /** `failed`. */
+    failed: number;
+    /** `skipped`. */
+    skipped: number;
+    /** `pending` or `copying`. */
+    pending: number;
+}
+/**
+ * One page of runs, newest first.
+ *
+ * @stability experimental
+ */
+export interface StorageMigrationRunPage {
+    /** The page's runs. */
+    items: StorageMigrationRunView[];
+    /** The page's position in the list. */
+    meta: {
+        /** The page, 1-based. */
+        page: number;
+        /** Runs per page. */
+        pageSize: number;
+        /** Runs across pages. */
+        totalItems: number;
+        /** How many pages there are. */
+        totalPages: number;
+    };
+}
+/**
+ * Truncates an error message to fit `last_error`.
+ *
+ * @param error - anything thrown.
+ * @returns at most 1000 characters.
+ *
+ * @internal
+ */
+export declare function storageMigrationErrorText(error: unknown): string;
+/**
+ * Starts, lists, reads and cancels copy-only storage provider migrations, and owns the run bookkeeping (item counts, race-safe finalization) the two migration job handlers share.
+ *
+ * @stability experimental
+ */
+export declare class StorageMigrationService {
+    private readonly system;
+    private readonly prisma;
+    private readonly storageConfig;
+    private readonly jobs;
+    private readonly logger;
+    constructor(system: StorageSystemData, prisma: StoragePrisma, storageConfig: StorageConfigService, jobs: JobsService);
+    /** The bypass client, with this slice's reason. */
+    db(): ReturnType<StorageSystemData['asSystem']>;
+    /**
+     * Starts a run: validates both drivers, claims the one active slot and queues the planner.
+     *
+     * @param input - the source and target driver ids (they differ; the DTO checks it).
+     * @param userId - the administrator.
+     * @returns the new run.
+     * @throws BadRequestException (`details.reason`: `UNKNOWN_DRIVER`, `SOURCE_NOT_CONFIGURED`, `TARGET_NOT_CONFIGURED`, `SAME_LOCATION`).
+     * @throws ConflictException when a run is already pending or running (`details.activeRunId`).
+     */
+    start(input: {
+        sourceProvider: string;
+        targetProvider: string;
+    }, userId: string): Promise<StorageMigrationRunView>;
+    /**
+     * One page of runs, newest first, with live counts.
+     *
+     * @param query - page (1-based) and page size.
+     * @returns the page and its position.
+     */
+    list(query: {
+        page: number;
+        pageSize: number;
+    }): Promise<StorageMigrationRunPage>;
+    /**
+     * One run, with live counts.
+     *
+     * @param runId - the run.
+     * @returns the run.
+     * @throws NotFoundException when there is no such run.
+     */
+    get(runId: string): Promise<StorageMigrationRunView>;
+    /**
+     * Cancels a pending or running run. Queued items become `skipped` at once, so
+     * the run stops before its next unclaimed object; an object being copied right
+     * now finishes (its copy is verified and harmless) and the source of every
+     * object is untouched either way.
+     *
+     * @param runId - the run.
+     * @param userId - the administrator.
+     * @returns the cancelled run.
+     * @throws NotFoundException when there is no such run.
+     * @throws ConflictException when it already finished.
+     */
+    cancel(runId: string, userId: string): Promise<StorageMigrationRunView>;
+    /**
+     * Item counts per run, by status, in one `groupBy`.
+     *
+     * @param runIds - the runs.
+     * @returns a map from run id to its counts (absent: no items).
+     */
+    countsFor(runIds: readonly string[]): Promise<Map<string, StorageMigrationItemCounts>>;
+    /**
+     * Finalizes a running, fully planned run whose items are all terminal:
+     * `failed` when any item failed, `completed` otherwise. Safe to call from any
+     * number of finishing jobs at once (one conditional update wins).
+     *
+     * @param runId - the run.
+     * @returns the final status when this call finalized it, otherwise `null`.
+     */
+    finalizeIfDone(runId: string): Promise<StorageMigrationRunStatus | null>;
+    /**
+     * Marks an active run `failed` with a reason (the planner gave up, or could not be queued).
+     *
+     * @param runId - the run.
+     * @param reason - why.
+     */
+    failRun(runId: string, reason: string): Promise<void>;
+    /**
+     * Records an error on the run (the most recent item failure), without changing its status.
+     *
+     * @param runId - the run.
+     * @param message - the error.
+     */
+    recordRunError(runId: string, message: string): Promise<void>;
+    private writeCounterSnapshot;
+    private view;
+    private audit;
+}
+//# sourceMappingURL=storage-migration.service.d.ts.map

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

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