@marinoscar/platform-api 0.1.0-next.21 → 0.1.0-next.23

package/dist/storage/providers/storage-provider.types.d.ts

@@ -87,4 +87,90 @@ export interface MultipartUploadInit {
     /** The object key. */
     key: string;
 }
+/**
+ * One part of an in-flight multipart upload as the storage backend holds it.
+ *
+ * @stability experimental
+ */
+export interface UploadedPart {
+    /** The part number (1-10000). */
+    partNumber: number;
+    /** The part's size in bytes, as the backend stores it. */
+    size: number;
+    /** The part's ETag, quoted or not exactly as the backend reports it; compare with {@link normalizeEtag}. */
+    eTag: string;
+}
+/**
+ * The result of storing one part through the API.
+ *
+ * @stability experimental
+ */
+export interface StoredPart {
+    /** The part's ETag (an MD5 digest, quoted or not). */
+    eTag: string;
+}
+/**
+ * How a client gets a part to the backend (see `StorageProvider.partUploadMode`).
+ *
+ *  - `presigned`: the provider signs a URL the client PUTs to directly.
+ *  - `proxied`: the provider has no signed URLs; the bytes go through the API's
+ *    part route into `StorageProvider.uploadPart`.
+ *
+ * @stability experimental
+ */
+export type StoragePartUploadMode = 'presigned' | 'proxied';
+/**
+ * A part body did not have the size the upload requires. Throw it from
+ * `StorageProvider.uploadPart` when the stream ends short or runs long; the
+ * objects API answers 400 `PART_SIZE_MISMATCH`.
+ *
+ * @stability experimental
+ */
+export declare class PartSizeMismatchError extends Error {
+    readonly partNumber: number;
+    readonly expectedSize: number;
+    readonly receivedSize: number;
+    readonly exceeded: boolean;
+    /**
+     * @param partNumber - the part.
+     * @param expectedSize - the exact byte count the part must have.
+     * @param receivedSize - the bytes seen before the mismatch was detected.
+     * @param exceeded - true when the body was cut off for running past `expectedSize`.
+     */
+    constructor(partNumber: number, expectedSize: number, receivedSize: number, exceeded: boolean);
+}
+/**
+ * The backend no longer knows the multipart session (completed, aborted or
+ * garbage-collected). Throw it from `listUploadedParts` / `uploadPart` /
+ * `completeMultipartUpload`; the objects API answers 409 `UPLOAD_SESSION_INVALID`.
+ *
+ * @stability experimental
+ */
+export declare class MultipartSessionNotFoundError extends Error {
+    readonly uploadId: string;
+    /** @param uploadId - the unknown session. */
+    constructor(uploadId: string);
+}
+/**
+ * `completeMultipartUpload` found parts missing or whose bytes do not match the
+ * ETag the client sent. Nothing is written; the objects API answers 409
+ * `UPLOAD_PARTS_MISSING` with the numbers so the client re-sends only those.
+ *
+ * @stability experimental
+ */
+export declare class MultipartPartsMissingError extends Error {
+    readonly partNumbers: number[];
+    /** @param partNumbers - the missing or mismatching parts. */
+    constructor(partNumbers: number[]);
+}
+/**
+ * An ETag without its surrounding quotes, so a client's `"abc"` and a backend's
+ * `abc` compare equal.
+ *
+ * @param eTag - an ETag, quoted or not.
+ * @returns the bare value.
+ *
+ * @stability experimental
+ */
+export declare function normalizeEtag(eTag: string): string;
 //# sourceMappingURL=storage-provider.types.d.ts.map

package/dist/storage/providers/storage-provider.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-provider.types.d.ts","sourceRoot":"","sources":["../../../src/storage/providers/storage-provider.types.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"storage-provider.types.d.ts","sourceRoot":"","sources":["../../../src/storage/providers/storage-provider.types.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,4GAA4G;IAC5G,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5D;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAQ5C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO;IAV5B;;;;;OAKG;gBAEQ,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO;CAS7B;AAED;;;;;;GAMG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IAE1C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IADrC,6CAA6C;gBACxB,QAAQ,EAAE,MAAM;CAItC;AAED;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IAEvC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE;IAD1C,6DAA6D;gBACxC,WAAW,EAAE,MAAM,EAAE;CAI3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/storage/providers/storage-provider.types.js

@@ -1,3 +1,81 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultipartPartsMissingError = exports.MultipartSessionNotFoundError = exports.PartSizeMismatchError = void 0;
+exports.normalizeEtag = normalizeEtag;
+/**
+ * A part body did not have the size the upload requires. Throw it from
+ * `StorageProvider.uploadPart` when the stream ends short or runs long; the
+ * objects API answers 400 `PART_SIZE_MISMATCH`.
+ *
+ * @stability experimental
+ */
+class PartSizeMismatchError extends Error {
+    partNumber;
+    expectedSize;
+    receivedSize;
+    exceeded;
+    /**
+     * @param partNumber - the part.
+     * @param expectedSize - the exact byte count the part must have.
+     * @param receivedSize - the bytes seen before the mismatch was detected.
+     * @param exceeded - true when the body was cut off for running past `expectedSize`.
+     */
+    constructor(partNumber, expectedSize, receivedSize, exceeded) {
+        super(exceeded
+            ? `Part ${partNumber} is larger than the expected ${expectedSize} bytes`
+            : `Part ${partNumber} has ${receivedSize} bytes, expected ${expectedSize}`);
+        this.partNumber = partNumber;
+        this.expectedSize = expectedSize;
+        this.receivedSize = receivedSize;
+        this.exceeded = exceeded;
+        this.name = 'PartSizeMismatchError';
+    }
+}
+exports.PartSizeMismatchError = PartSizeMismatchError;
+/**
+ * The backend no longer knows the multipart session (completed, aborted or
+ * garbage-collected). Throw it from `listUploadedParts` / `uploadPart` /
+ * `completeMultipartUpload`; the objects API answers 409 `UPLOAD_SESSION_INVALID`.
+ *
+ * @stability experimental
+ */
+class MultipartSessionNotFoundError extends Error {
+    uploadId;
+    /** @param uploadId - the unknown session. */
+    constructor(uploadId) {
+        super(`Multipart upload ${uploadId} does not exist`);
+        this.uploadId = uploadId;
+        this.name = 'MultipartSessionNotFoundError';
+    }
+}
+exports.MultipartSessionNotFoundError = MultipartSessionNotFoundError;
+/**
+ * `completeMultipartUpload` found parts missing or whose bytes do not match the
+ * ETag the client sent. Nothing is written; the objects API answers 409
+ * `UPLOAD_PARTS_MISSING` with the numbers so the client re-sends only those.
+ *
+ * @stability experimental
+ */
+class MultipartPartsMissingError extends Error {
+    partNumbers;
+    /** @param partNumbers - the missing or mismatching parts. */
+    constructor(partNumbers) {
+        super(`Multipart upload is missing or has corrupt part(s): ${partNumbers.join(', ')}`);
+        this.partNumbers = partNumbers;
+        this.name = 'MultipartPartsMissingError';
+    }
+}
+exports.MultipartPartsMissingError = MultipartPartsMissingError;
+/**
+ * An ETag without its surrounding quotes, so a client's `"abc"` and a backend's
+ * `abc` compare equal.
+ *
+ * @param eTag - an ETag, quoted or not.
+ * @returns the bare value.
+ *
+ * @stability experimental
+ */
+function normalizeEtag(eTag) {
+    return eTag.replace(/^"+|"+$/g, '');
+}
 //# sourceMappingURL=storage-provider.types.js.map

package/dist/storage/providers/storage-provider.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-provider.types.js","sourceRoot":"","sources":["../../../src/storage/providers/storage-provider.types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"storage-provider.types.js","sourceRoot":"","sources":["../../../src/storage/providers/storage-provider.types.ts"],"names":[],"mappings":";;;AAyMA,sCAEC;AAtED;;;;;;GAMG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAQnC;IACA;IACA;IACA;IAVX;;;;;OAKG;IACH,YACW,UAAkB,EAClB,YAAoB,EACpB,YAAoB,EACpB,QAAiB;QAE1B,KAAK,CACH,QAAQ;YACN,CAAC,CAAC,QAAQ,UAAU,gCAAgC,YAAY,QAAQ;YACxE,CAAC,CAAC,QAAQ,UAAU,QAAQ,YAAY,oBAAoB,YAAY,EAAE,CAC7E,CAAC;QATO,eAAU,GAAV,UAAU,CAAQ;QAClB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,aAAQ,GAAR,QAAQ,CAAS;QAO1B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AApBD,sDAoBC;AAED;;;;;;GAMG;AACH,MAAa,6BAA8B,SAAQ,KAAK;IAEjC;IADrB,6CAA6C;IAC7C,YAAqB,QAAgB;QACnC,KAAK,CAAC,oBAAoB,QAAQ,iBAAiB,CAAC,CAAC;QADlC,aAAQ,GAAR,QAAQ,CAAQ;QAEnC,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAND,sEAMC;AAED;;;;;;GAMG;AACH,MAAa,0BAA2B,SAAQ,KAAK;IAE9B;IADrB,6DAA6D;IAC7D,YAAqB,WAAqB;QACxC,KAAK,CAAC,uDAAuD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QADpE,gBAAW,GAAX,WAAW,CAAU;QAExC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAND,gEAMC;AAED;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/storage/providers/storage-providers.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-providers.module.d.ts","sourceRoot":"","sources":["../../../src/storage/providers/storage-providers.module.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH;;;;;;;;;GASG;AACH,qBAca,sBAAsB;CAAG"}
+{"version":3,"file":"storage-providers.module.d.ts","sourceRoot":"","sources":["../../../src/storage/providers/storage-providers.module.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH;;;;;;;;;GASG;AACH,qBAea,sBAAsB;CAAG"}

package/dist/storage/providers/storage-providers.module.js

@@ -11,6 +11,7 @@ const common_1 = require("@nestjs/common");
 const index_1 = require("../../credentials/index");
 const storage_config_service_1 = require("../config/storage-config.service");
 const resolving_storage_provider_1 = require("./resolving-storage.provider");
+const storage_provider_router_1 = require("./storage-provider-router");
 const storage_provider_binding_1 = require("./storage-provider.binding");
 const storage_provider_interface_1 = require("./storage-provider.interface");
 /**
@@ -82,13 +83,14 @@ exports.StorageProvidersModule = StorageProvidersModule = __decorate([
         providers: [
             storage_config_service_1.StorageConfigService,
             resolving_storage_provider_1.ResolvingStorageProvider,
+            storage_provider_router_1.StorageProviderRouter,
             {
                 provide: storage_provider_interface_1.STORAGE_PROVIDER,
                 useFactory: (binding, resolving) => binding ?? resolving,
                 inject: [{ token: storage_provider_binding_1.STORAGE_PROVIDER_BINDING, optional: true }, resolving_storage_provider_1.ResolvingStorageProvider],
             },
         ],
-        exports: [storage_provider_interface_1.STORAGE_PROVIDER, storage_config_service_1.StorageConfigService],
+        exports: [storage_provider_interface_1.STORAGE_PROVIDER, storage_config_service_1.StorageConfigService, storage_provider_router_1.StorageProviderRouter],
     })
 ], StorageProvidersModule);
 //# sourceMappingURL=storage-providers.module.js.map

package/dist/storage/providers/storage-providers.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-providers.module.js","sourceRoot":"","sources":["../../../src/storage/providers/storage-providers.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAExC,mDAA4D;AAC5D,6EAAwE;AACxE,6EAAwE;AACxE,yEAAsE;AACtE,6EAAsF;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH;;;;;;;;;GASG;AAeI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;CAAG,CAAA;AAAzB,wDAAsB;iCAAtB,sBAAsB;IAdlC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,yBAAiB,CAAC;QAC5B,SAAS,EAAE;YACT,6CAAoB;YACpB,qDAAwB;YACxB;gBACE,OAAO,EAAE,6CAAgB;gBACzB,UAAU,EAAE,CAAC,OAAoC,EAAE,SAAmC,EAAmB,EAAE,CACzG,OAAO,IAAI,SAAS;gBACtB,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,mDAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,qDAAwB,CAAC;aACxF;SACF;QACD,OAAO,EAAE,CAAC,6CAAgB,EAAE,6CAAoB,CAAC;KAClD,CAAC;GACW,sBAAsB,CAAG"}
+{"version":3,"file":"storage-providers.module.js","sourceRoot":"","sources":["../../../src/storage/providers/storage-providers.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAExC,mDAA4D;AAC5D,6EAAwE;AACxE,6EAAwE;AACxE,uEAAkE;AAClE,yEAAsE;AACtE,6EAAsF;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH;;;;;;;;;GASG;AAgBI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;CAAG,CAAA;AAAzB,wDAAsB;iCAAtB,sBAAsB;IAflC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,yBAAiB,CAAC;QAC5B,SAAS,EAAE;YACT,6CAAoB;YACpB,qDAAwB;YACxB,+CAAqB;YACrB;gBACE,OAAO,EAAE,6CAAgB;gBACzB,UAAU,EAAE,CAAC,OAAoC,EAAE,SAAmC,EAAmB,EAAE,CACzG,OAAO,IAAI,SAAS;gBACtB,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,mDAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,qDAAwB,CAAC;aACxF;SACF;QACD,OAAO,EAAE,CAAC,6CAAgB,EAAE,6CAAoB,EAAE,+CAAqB,CAAC;KACzE,CAAC;GACW,sBAAsB,CAAG"}

package/dist/storage/testing/conformance.d.ts

@@ -1,5 +1,6 @@
 import type { ConformanceFinding, ConformanceSuite } from '../../testing/index';
 import { type StorageKeyPrefixDef } from '../storage-key-prefix.registry';
+import '../drivers/builtin-storage-drivers';
 declare module '../../testing/index' {
     interface PlatformConformanceSuiteOptions {
         /** The storage slice's suite: its options, or `false` to opt out. Registered by importing `@marinoscar/platform-api/storage/testing`. */
@@ -44,6 +45,17 @@ export declare function checkOrgScopedKeys(defs: readonly StorageKeyPrefixDef[])
  * @stability experimental
  */
 export declare function checkStorageSettingsSchemas(): ConformanceFinding[];
+/**
+ * Check 4: per-row routing. Two built-in drivers are configured (offline: a
+ * presigned URL is computed locally, nothing is fetched); the active one is
+ * flipped from A to B and back, and an object recorded on A must keep signing
+ * against A's bucket and host each time.
+ *
+ * @returns one finding per violated rule.
+ *
+ * @stability experimental
+ */
+export declare function checkStorageRouting(): Promise<ConformanceFinding[]>;
 /**
  * The `storage` conformance suite. Registered when
  * `@marinoscar/platform-api/storage/testing` is imported.

package/dist/storage/testing/conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../src/storage/testing/conformance.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAmB,kBAAkB,EAAqB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpH,OAAO,EAKL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,+BAA+B;QACvC,yIAAyI;QACzI,OAAO,CAAC,EAAE,yBAAyB,GAAG,KAAK,CAAC;KAC7C;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,iGAAiG;IACjG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AASD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,mBAAmB,EAAE,EACpC,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,kBAAkB,EAAE,CAiBtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,mBAAmB,EAAE,GAAG,kBAAkB,EAAE,CAe7F;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,IAAI,kBAAkB,EAAE,CAWlE;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,CAAC,yBAAyB,CA2C/E,CAAC"}
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../src/storage/testing/conformance.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAmB,kBAAkB,EAAqB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpH,OAAO,EAKL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAOxC,OAAO,oCAAoC,CAAC;AAE5C,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,+BAA+B;QACvC,yIAAyI;QACzI,OAAO,CAAC,EAAE,yBAAyB,GAAG,KAAK,CAAC;KAC7C;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,iGAAiG;IACjG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAUD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,mBAAmB,EAAE,EACpC,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,kBAAkB,EAAE,CAiBtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,mBAAmB,EAAE,GAAG,kBAAkB,EAAE,CAe7F;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,IAAI,kBAAkB,EAAE,CAWlE;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyFzE;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,CAAC,yBAAyB,CAiD/E,CAAC"}

package/dist/storage/testing/conformance.js

@@ -14,19 +14,29 @@
 //      key without an organization; `orgKeyPrefixes` returns exactly them;
 //   3. no-secret: the `storage` settings namespace and the admin view cannot
 //      carry the secret access key.
+//   4. routing: an object recorded on driver A stays addressable on driver A
+//      (its recorded bucket, its own signing) after the active driver becomes B,
+//      and a legacy row, the active location and an app-bound provider route to
+//      the provider in force.
 // =============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.storageConformanceSuite = void 0;
 exports.checkStorageKeyPrefixes = checkStorageKeyPrefixes;
 exports.checkOrgScopedKeys = checkOrgScopedKeys;
 exports.checkStorageSettingsSchemas = checkStorageSettingsSchemas;
+exports.checkStorageRouting = checkStorageRouting;
+const common_1 = require("@nestjs/common");
 const storage_1 = require("@marinoscar/platform-contract/storage");
 const index_1 = require("../../testing/index");
 const storage_key_prefix_registry_1 = require("../storage-key-prefix.registry");
 const storage_key_prefixes_1 = require("../storage-key-prefixes");
+const storage_provider_router_1 = require("../providers/storage-provider-router");
+const storage_driver_1 = require("../drivers/storage-driver");
+require("../drivers/builtin-storage-drivers");
 const FILE_PREFIXES = 'storage-key-prefixes';
 const FILE_KEYS = 'storage-object-keys';
 const FILE_SCHEMAS = 'storage-schemas';
+const FILE_ROUTING = 'storage-routing';
 /** A fixed UUID for the key checks; never a real organization. */
 const PROBE_ORG = '00000000-0000-4000-8000-000000000001';
 /**
@@ -102,6 +112,102 @@ function checkStorageSettingsSchemas() {
     }
     return findings;
 }
+/**
+ * Check 4: per-row routing. Two built-in drivers are configured (offline: a
+ * presigned URL is computed locally, nothing is fetched); the active one is
+ * flipped from A to B and back, and an object recorded on A must keep signing
+ * against A's bucket and host each time.
+ *
+ * @returns one finding per violated rule.
+ *
+ * @stability experimental
+ */
+async function checkStorageRouting() {
+    const findings = [];
+    const fail = (message) => findings.push({ file: FILE_ROUTING, message });
+    const resolutions = {
+        s3: {
+            configured: true,
+            config: {
+                provider: 's3',
+                bucket: 'routing-s3-bucket',
+                region: 'us-east-1',
+                settings: { bucket: 'routing-s3-bucket', region: 'us-east-1', endpoint: '', accessKeyId: 'AKIAROUTINGS3', forcePathStyle: null },
+                secrets: { secretAccessKey: 'routing-secret-s3' },
+            },
+        },
+        r2: {
+            configured: true,
+            config: {
+                provider: 'r2',
+                bucket: 'routing-r2-bucket',
+                region: 'auto',
+                endpoint: 'https://routingacct.r2.cloudflarestorage.com',
+                settings: { bucket: 'routing-r2-bucket', accountId: 'routingacct', region: '', endpoint: '', accessKeyId: 'AKIAROUTINGR2', forcePathStyle: null },
+                secrets: { secretAccessKey: 'routing-secret-r2' },
+            },
+        },
+    };
+    const providers = [];
+    const buildActive = async (id) => {
+        const resolution = resolutions[id];
+        if (!resolution.configured)
+            throw new Error('unreachable');
+        const built = await (0, storage_driver_1.requireStorageDriver)(id).build({
+            settings: resolution.config.settings,
+            secret: async (name) => resolution.config.secrets[name] ?? null,
+            logger: new common_1.Logger('storage-routing'),
+            partSize: 5 * 1024 * 1024,
+        });
+        providers.push(built);
+        return built;
+    };
+    try {
+        for (const activeId of ['s3', 'r2']) {
+            const config = {
+                activeProvider: async () => activeId,
+                resolveDriver: async (id) => resolutions[id],
+            };
+            const current = await buildActive(activeId);
+            const router = new storage_provider_router_1.StorageProviderRouter({ resolveCurrent: async () => current }, config, { get: (_key, fallback) => fallback });
+            // An object recorded on r2 stays on r2; one recorded on s3 stays on s3.
+            for (const [recorded, host] of [['r2', 'r2.cloudflarestorage.com'], ['s3', 'amazonaws.com']]) {
+                const resolution = resolutions[recorded];
+                if (!resolution.configured)
+                    continue;
+                const provider = await router.forLocation({ provider: recorded, bucket: resolution.config.bucket });
+                const url = await provider.getSignedDownloadUrl('routing/probe.txt', { expiresIn: 60 });
+                if (provider.kind !== recorded)
+                    fail(`active=${activeId}: a row recorded on "${recorded}" was routed to "${provider.kind}"`);
+                if (!url.includes(resolution.config.bucket))
+                    fail(`active=${activeId}: a row recorded on "${recorded}" signed outside its bucket`);
+                if (!url.includes(host))
+                    fail(`active=${activeId}: a row recorded on "${recorded}" signed against the wrong host`);
+            }
+            // A row whose recorded bucket differs from the driver's current one signs against the recorded bucket.
+            const moved = await router.forLocation({ provider: 'r2', bucket: 'routing-r2-previous' });
+            if (!(await moved.getSignedDownloadUrl('routing/probe.txt')).includes('routing-r2-previous')) {
+                fail(`active=${activeId}: a row recorded on a previous bucket was not routed to that bucket`);
+            }
+            // A legacy row (no recorded location) and an unrecorded provider use the one in force.
+            if ((await router.forLocation(null)) !== current)
+                fail(`active=${activeId}: a legacy row was not routed to the active provider`);
+            if ((await router.forObject({ storageProvider: null, bucket: null })) !== current) {
+                fail(`active=${activeId}: a row with no recorded provider was not routed to the active provider`);
+            }
+        }
+        // An app-bound provider routes itself: the router must hand it back for every row.
+        const bound = { kind: 'app-bound' };
+        const boundRouter = new storage_provider_router_1.StorageProviderRouter(bound);
+        if ((await boundRouter.forLocation({ provider: 'r2', bucket: 'x' })) !== bound)
+            fail('an app-bound provider was bypassed by the router');
+    }
+    finally {
+        for (const provider of providers)
+            provider.destroy?.();
+    }
+    return findings;
+}
 /**
  * The `storage` conformance suite. Registered when
  * `@marinoscar/platform-api/storage/testing` is imported.
@@ -155,6 +261,12 @@ exports.storageConformanceSuite = {
                     expect(report.findings.filter((finding) => finding.file === FILE_SCHEMAS)).toEqual([]);
                 },
             },
+            {
+                name: 'storage-routing: an object stays on the provider and bucket it was written to after the active driver changes',
+                run: async (_report, expect) => {
+                    expect(await checkStorageRouting()).toEqual([]);
+                },
+            },
         ];
     },
 };

package/dist/storage/testing/conformance.js.map

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

package/dist/storage/testing/driver-conformance.d.ts

@@ -17,7 +17,7 @@ export interface StorageDriverConformanceHarness {
  *
  * @stability experimental
  */
-export type StorageDriverConformanceScenario = 'definition' | 'provider' | 'roundTrip' | 'streamedUpload' | 'signedUrl' | 'listKeys' | 'testConnection' | 'provision' | 'pure';
+export type StorageDriverConformanceScenario = 'definition' | 'provider' | 'roundTrip' | 'streamedUpload' | 'signedUrl' | 'listKeys' | 'testConnection' | 'provision' | 'multipartList' | 'proxiedPart' | 'pure';
 /**
  * Options of {@link describeStorageDriverConformance}.
  *
@@ -44,6 +44,18 @@ export interface StorageDriverConformanceOptions extends StorageDriverConformanc
     skip?: readonly StorageDriverConformanceScenario[];
     /** Size of the streamed upload in bytes. Default 6 MiB. */
     streamedBytes?: number;
+    /**
+     * PUTs one part to a presigned part URL (`getSignedUploadUrl`), so the kit can
+     * exercise `listUploadedParts` on a driver that takes presigned parts. Without
+     * it the `multipartList` scenario only runs for `proxied` drivers.
+     */
+    putPart?: (url: string, body: Buffer) => Promise<void>;
+    /**
+     * Size in bytes of the part the `proxiedPart` scenario streams. Default 64 MiB:
+     * the scenario fails when the driver still holds more than half of it (after a
+     * forced collection) while the part is consumed, i.e. when it buffers the part.
+     */
+    proxiedPartBytes?: number;
 }
 /**
  * Registers the storage driver conformance suite.

package/dist/storage/testing/driver-conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver-conformance.d.ts","sourceRoot":"","sources":["../../../src/storage/testing/driver-conformance.ts"],"names":[],"mappings":"AAuDA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;IACpD,qFAAqF;IACrF,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;IACvD,6BAA6B;IAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GACxC,YAAY,GACZ,UAAU,GACV,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,UAAU,GACV,gBAAgB,GAChB,WAAW,GACX,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,+BAAgC,SAAQ,+BAA+B;IACtF,uIAAuI;IACvI,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC1D,mEAAmE;IACnE,IAAI,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACnD,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAkED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,uBAAuB,CAAC,GAAG,CAAC,GAAG,MAAM,EAC7C,OAAO,EAAE,+BAA+B,GACvC,IAAI,CA0ON"}
+{"version":3,"file":"driver-conformance.d.ts","sourceRoot":"","sources":["../../../src/storage/testing/driver-conformance.ts"],"names":[],"mappings":"AAgEA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;IACpD,qFAAqF;IACrF,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;IACvD,6BAA6B;IAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GACxC,YAAY,GACZ,UAAU,GACV,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,UAAU,GACV,gBAAgB,GAChB,WAAW,GACX,eAAe,GACf,aAAa,GACb,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,+BAAgC,SAAQ,+BAA+B;IACtF,uIAAuI;IACvI,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC1D,mEAAmE;IACnE,IAAI,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACnD,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAqFD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,uBAAuB,CAAC,GAAG,CAAC,GAAG,MAAM,EAC7C,OAAO,EAAE,+BAA+B,GACvC,IAAI,CA2VN"}

package/dist/storage/testing/driver-conformance.js

@@ -44,6 +44,13 @@
 //   - `testConnection` NEVER THROWS and NEVER returns secret material: with
 //     valid settings, with the driver's defaults and no secrets, and with a
 //     sentinel secret the driver must not echo into its message, details or checks;
+//   - multipart extensions, when the provider declares them: `listUploadedParts`
+//     reports the parts of an in-flight upload (and, for a driver that takes
+//     presigned parts, the kit PUTs them through `putPart`); a `proxied` driver
+//     accepts a STREAMED `uploadPart` larger than the process's buffer budget
+//     (it samples external memory while the lazily generated part is consumed),
+//     discards a part whose stream ends short, and completes an upload built
+//     from API parts;
 //   - `provision`, when defined, can be repeated;
 //   - `location` and `missing`, when defined, are pure and well formed.
 // =============================================================================
@@ -52,6 +59,8 @@ exports.describeStorageDriverConformance = describeStorageDriverConformance;
 const common_1 = require("@nestjs/common");
 const node_crypto_1 = require("node:crypto");
 const node_stream_1 = require("node:stream");
+const node_vm_1 = require("node:vm");
+const node_v8_1 = require("node:v8");
 const storage_1 = require("@marinoscar/platform-contract/storage");
 const storage_driver_1 = require("../drivers/storage-driver");
 /** A value no driver may ever echo back from `testConnection`. */
@@ -72,7 +81,26 @@ const PROVIDER_METHODS = [
     'getBucket',
 ];
 const DEFAULT_STREAMED_BYTES = 6 * 1024 * 1024;
+const DEFAULT_PROXIED_PART_BYTES = 64 * 1024 * 1024;
+const PROXIED_SAMPLE_BYTES = 4 * 1024 * 1024;
 const STREAM_CHUNK_BYTES = 64 * 1024;
+/**
+ * A function that runs a full garbage collection, or `null` when the runtime
+ * will not give one. Enabled at run time (`--expose-gc` through V8's flags), so
+ * the kit needs no launch flag: external memory (Buffers) is only reclaimed
+ * lazily, and without a forced collection a driver that streams correctly still
+ * looks like one that holds the part.
+ */
+function gcFunction() {
+    try {
+        (0, node_v8_1.setFlagsFromString)('--expose-gc');
+        const gc = (0, node_vm_1.runInNewContext)('gc');
+        return typeof gc === 'function' ? gc : null;
+    }
+    catch {
+        return null;
+    }
+}
 async function collect(stream) {
     const chunks = [];
     for await (const chunk of stream)
@@ -312,6 +340,112 @@ function describeStorageDriverConformance(driver, options) {
                 }
             });
         }
+        scenario('multipartList', 'listUploadedParts reports the parts the backend holds for an in-flight upload', async () => {
+            await withProvider(async (provider) => {
+                if (provider.listUploadedParts === undefined)
+                    return;
+                const key = `${keyPrefix()}multipart.bin`;
+                const first = Buffer.alloc(1024, 1);
+                const second = Buffer.alloc(2048, 2);
+                const proxied = provider.partUploadMode === 'proxied';
+                if (!proxied && options.putPart === undefined)
+                    return;
+                const { uploadId } = await provider.initMultipartUpload(key, { mimeType: 'application/octet-stream' });
+                try {
+                    expect(await provider.listUploadedParts(key, uploadId)).toEqual([]);
+                    for (const [index, body] of [first, second].entries()) {
+                        const partNumber = index + 1;
+                        if (proxied) {
+                            const stored = await provider.uploadPart(key, uploadId, partNumber, node_stream_1.Readable.from([body]), body.length);
+                            expect(typeof stored.eTag).toBe('string');
+                        }
+                        else {
+                            await options.putPart(await provider.getSignedUploadUrl(key, uploadId, partNumber, 60), body);
+                        }
+                    }
+                    const held = await provider.listUploadedParts(key, uploadId);
+                    expect(held.map((part) => part.partNumber).sort((a, b) => a - b)).toEqual([1, 2]);
+                    expect(held.find((part) => part.partNumber === 1)?.size).toBe(first.length);
+                    expect(held.find((part) => part.partNumber === 2)?.size).toBe(second.length);
+                    for (const part of held)
+                        expect(part.eTag.length).toBeGreaterThan(0);
+                }
+                finally {
+                    await provider.abortMultipartUpload(key, uploadId);
+                }
+            });
+        });
+        scenario('proxiedPart', 'a proxied driver streams a part larger than the buffer budget, and discards a short one', async () => {
+            await withProvider(async (provider) => {
+                if (provider.partUploadMode !== 'proxied')
+                    return;
+                expect(typeof provider.uploadPart).toBe('function');
+                const key = `${keyPrefix()}proxied.bin`;
+                const partBytes = options.proxiedPartBytes ?? DEFAULT_PROXIED_PART_BYTES;
+                const { uploadId } = await provider.initMultipartUpload(key, { mimeType: 'application/octet-stream' });
+                try {
+                    // 1. A part bigger than the budget, produced lazily; sample external
+                    //    memory as each chunk is pulled. A driver that buffers the part
+                    //    holds all of it at once.
+                    //    External memory is sampled after a FORCED collection every few
+                    //    MiB, so garbage the driver has already let go of is not counted:
+                    //    only bytes it still holds are. (Skipped where the runtime offers
+                    //    no way to collect.)
+                    const gc = gcFunction();
+                    gc?.();
+                    const baseline = process.memoryUsage().arrayBuffers;
+                    let peak = 0;
+                    let produced = 0;
+                    let sinceSample = 0;
+                    const source = node_stream_1.Readable.from((function* () {
+                        while (produced < partBytes) {
+                            const size = Math.min(STREAM_CHUNK_BYTES, partBytes - produced);
+                            produced += size;
+                            sinceSample += size;
+                            if (gc !== null && sinceSample >= PROXIED_SAMPLE_BYTES) {
+                                sinceSample = 0;
+                                gc();
+                                peak = Math.max(peak, process.memoryUsage().arrayBuffers - baseline);
+                            }
+                            yield Buffer.allocUnsafeSlow(size).fill(7);
+                        }
+                    })(), { objectMode: false, highWaterMark: STREAM_CHUNK_BYTES });
+                    const stored = await provider.uploadPart(key, uploadId, 1, source, partBytes);
+                    expect(typeof stored.eTag).toBe('string');
+                    expect(produced).toBe(partBytes);
+                    if (gc !== null)
+                        expect(peak).toBeLessThan(partBytes / 2);
+                    // 2. A body that fails part-way (the platform errors the stream when it
+                    //    ends short or runs long) must not leave a part behind.
+                    let refused = false;
+                    try {
+                        let sent = false;
+                        const failing = new node_stream_1.Readable({
+                            read() {
+                                if (sent) {
+                                    this.destroy(new Error('stream ended early'));
+                                    return;
+                                }
+                                sent = true;
+                                this.push(Buffer.alloc(16, 1));
+                            },
+                        });
+                        await provider.uploadPart(key, uploadId, 2, failing, partBytes);
+                    }
+                    catch {
+                        refused = true;
+                    }
+                    expect(refused).toBe(true);
+                    if (provider.listUploadedParts !== undefined) {
+                        const held = await provider.listUploadedParts(key, uploadId);
+                        expect(held.map((part) => part.partNumber)).toEqual([1]);
+                    }
+                }
+                finally {
+                    await provider.abortMultipartUpload(key, uploadId);
+                }
+            });
+        });
         scenario('pure', 'location and missing are pure and well formed', () => {
             const settings = def.settingsSchema.parse({ ...def.defaults, ...options.settings });
             const present = Object.fromEntries((def.secrets ?? []).map((secret) => [secret.name, true]));