@marinoscar/platform-contract 0.1.0-next.3 → 0.1.0-next.4

package/dist/cjs/storage/constants.js

@@ -0,0 +1,107 @@
+"use strict";
+// =============================================================================
+// Storage: plain values of the storage slice's wire shapes (issue #736, PP-8.3)
+// =============================================================================
+//
+// Zod-free, so a consumer that needs only a provider list or a status list
+// (the web app) never bundles the schemas or zod. Moved from the API's
+// `common/schemas/settings.schema.ts` and `storage/config/storage-config.ts`
+// with their comments; the API re-exports them.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORAGE_SECRET_FIELD_NAMES = exports.MISSING_STORAGE_CONFIG_FIELDS = exports.STORAGE_OBJECT_STATUSES = exports.LEGACY_STORAGE_FLAT_FIELDS = exports.STORAGE_PROVIDER_KINDS = exports.BUILTIN_STORAGE_PROVIDER_KINDS = exports.STORAGE_DRIVER_ID_PATTERN = void 0;
+/**
+ * The pattern every storage driver id must match: a lower-case letter, then
+ * letters, digits and hyphens, 2 to 48 characters. The same pattern as every
+ * pluggable id (`PLUGGABLE_ID_PATTERN` of `@marinoscar/platform-contract/settings`).
+ * An id is the key its settings are stored under, so it is permanent once a
+ * row exists.
+ *
+ * @stability experimental
+ */
+exports.STORAGE_DRIVER_ID_PATTERN = /^[a-z][a-z0-9-]{1,47}$/;
+/**
+ * The storage drivers the platform SHIPS (S3-compatible object stores). Not a
+ * closed set: an app or package registers more with `registerStorageDriver`
+ * (`@marinoscar/platform-api/storage`) and its id is any
+ * {@link STORAGE_DRIVER_ID_PATTERN} string. Use this list for defaults, labels
+ * and the "is this one of the S3 flavours" question, never to validate an id.
+ *
+ *  - `s3`           - AWS S3 proper. `region` is required by the SDK;
+ *                     `endpoint` is left empty and the SDK derives it.
+ *  - `r2`           - Cloudflare R2: its `region` is literally `auto`, and its
+ *                     endpoint is DERIVED from `accountId`.
+ *  - `s3compatible` - MinIO, Backblaze B2, Wasabi, Ceph RGW and anything else
+ *                     speaking the same protocol at an operator-supplied
+ *                     `endpoint`.
+ *
+ * @stability experimental
+ */
+exports.BUILTIN_STORAGE_PROVIDER_KINDS = ['s3', 'r2', 's3compatible'];
+/**
+ * The built-in storage provider kinds.
+ *
+ * @deprecated Use `BUILTIN_STORAGE_PROVIDER_KINDS`. The list is no longer
+ *   the set of valid providers: any registered storage driver id is one.
+ * @stability stable
+ */
+exports.STORAGE_PROVIDER_KINDS = exports.BUILTIN_STORAGE_PROVIDER_KINDS;
+/**
+ * The names of the legacy flat fields the `storage` namespace stored before
+ * drivers had a settings record of their own. They are a read-only view of the
+ * active built-in driver's settings; the namespace stores the new shape
+ * (`provider` plus `drivers`).
+ *
+ * @stability experimental
+ */
+exports.LEGACY_STORAGE_FLAT_FIELDS = ['bucket', 'region', 'endpoint', 'accountId', 'accessKeyId', 'forcePathStyle'];
+/**
+ * The five `StorageObjectStatus` values of the `storage` fragment, in its
+ * declaration order (the order the OpenAPI enum lists them in).
+ *
+ * @stability stable
+ */
+exports.STORAGE_OBJECT_STATUSES = ['pending', 'uploading', 'processing', 'ready', 'failed'];
+/**
+ * Every field the BUILT-IN (S3 family) storage drivers can be missing, in the
+ * order the admin page and the 503 list them. `secretAccessKey` is the
+ * credential store's half; the rest are the driver's settings. A driver an app
+ * registers reports its own field names, so the wire shape of `missing` is a
+ * list of strings; this list names the built-ins' values.
+ *
+ * @stability stable
+ */
+exports.MISSING_STORAGE_CONFIG_FIELDS = [
+    'bucket',
+    'region',
+    'endpoint',
+    'accountId',
+    'accessKeyId',
+    'secretAccessKey',
+];
+/**
+ * Field names the `storage` settings namespace may never declare, at any
+ * case: the secret half of the storage credential lives in the encrypted
+ * credential store at `(purpose 'storage', name 'default')`, never in the
+ * settings blob `GET /api/system-settings` returns wholesale.
+ *
+ * `accessKeyId` is deliberately ABSENT: it is an identifier that travels in
+ * the clear in every SigV4 `Authorization` header and authorises nothing by
+ * itself. The settings slice's own list (`SETTINGS_SECRET_FIELD_NAMES` of
+ * `@marinoscar/platform-api/settings`) is the registry-time check of every
+ * namespace; this is the contract's compile-time copy for the one namespace
+ * it owns.
+ *
+ * @stability stable
+ */
+exports.STORAGE_SECRET_FIELD_NAMES = [
+    'secretAccessKey',
+    'secretKey',
+    'sessionToken',
+    'secret',
+    'password',
+    'apiKey',
+    'token',
+    'privateKey',
+];
+//# sourceMappingURL=constants.js.map

package/dist/cjs/storage/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/storage/constants.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,uEAAuE;AACvE,6EAA6E;AAC7E,gDAAgD;AAChD,gFAAgF;;;AAEhF;;;;;;;;GAQG;AACU,QAAA,yBAAyB,GAAG,wBAAwB,CAAC;AAElE;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,8BAA8B,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAU,CAAC;AAEpF;;;;;;GAMG;AACU,QAAA,sBAAsB,GAAG,sCAA8B,CAAC;AAkBrE;;;;;;;GAOG;AACU,QAAA,0BAA0B,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,CAAU,CAAC;AAElI;;;;;GAKG;AACU,QAAA,uBAAuB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAS1G;;;;;;;;GAQG;AACU,QAAA,6BAA6B,GAAG;IAC3C,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,WAAW;IACX,aAAa;IACb,iBAAiB;CACT,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACU,QAAA,0BAA0B,GAAG;IACxC,iBAAiB;IACjB,WAAW;IACX,cAAc;IACd,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,OAAO;IACP,YAAY;CACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+export { BUILTIN_STORAGE_PROVIDER_KINDS, LEGACY_STORAGE_FLAT_FIELDS, MISSING_STORAGE_CONFIG_FIELDS, STORAGE_DRIVER_ID_PATTERN, STORAGE_OBJECT_STATUSES, STORAGE_PROVIDER_KINDS, STORAGE_SECRET_FIELD_NAMES, } from './constants.js';
+export type { BuiltinStorageProviderKind, StorageEnum, StorageObjectStatusName, StorageProviderKind } from './constants.js';
+export { STORAGE_SETTINGS_CARRIES_NO_SECRET, storageDriverIdSchema, storageDriverSettingsSchema, storageDriversPatchSchema, storageDriversSchema, storageResponseSchema, storageSettingsPatchSchema, storageSettingsSchema, systemStoragePatchSchema, systemStorageSchema, } from './schemas.js';
+export type { StorageSettingsCarriesNoSecret, StorageSettingsInput, StorageSettingsPatchInput, StorageSettingsResponse, SystemStoragePatchValue, SystemStorageValue, } from './schemas.js';
+export { completeUploadSchema } from './schemas.js';
+export type { CompleteUploadDto } from './schemas.js';
+export { downloadUrlResponseSchema } from './schemas.js';
+export type { DownloadUrlResponse } from './schemas.js';
+export { initUploadResponseSchema, initUploadSchema } from './schemas.js';
+export type { InitUploadDto, InitUploadResponse } from './schemas.js';
+export { objectListQuerySchema } from './schemas.js';
+export type { ObjectListQueryDto, ObjectListResponse } from './schemas.js';
+export { objectResponseSchema, uploadStatusResponseSchema } from './schemas.js';
+export type { ObjectResponse, UploadStatusResponse } from './schemas.js';
+export { updateMetadataSchema } from './schemas.js';
+export type { UpdateMetadataDto } from './schemas.js';
+export { storageStatusResponseSchema } from './schemas.js';
+export type { StorageStatusResponse } from './schemas.js';
+export { STORAGE_SWITCH_CONFIRMATION, updateStorageConfigSchema } from './schemas.js';
+export type { UpdateStorageConfigInput } from './schemas.js';
+export { storageConfigResponseSchema, storageSecretStatusSchema } from './schemas.js';
+export type { StorageConfigResponse } from './schemas.js';
+export { STORAGE_TEST_CHECK_CODES, STORAGE_TEST_CHECK_IDS, STORAGE_TEST_CHECK_STATUSES, storageConnectionCheckSchema, storageConnectionTestResultSchema, testStorageConfigSchema, } from './schemas.js';
+export type { StorageConnectionCheck, StorageConnectionTestResult, StorageTestCheckId, TestStorageConfigInput, } from './schemas.js';
+export { STORAGE_BUCKET_OUTCOMES, STORAGE_BUCKET_STEP_IDS, STORAGE_BUCKET_STEP_STATUSES, guidedBucketInstructionsSchema, provisionStorageBucketSchema, storageBucketProvisionResultSchema, storageBucketStepSchema, } from './schemas.js';
+export type { ProvisionStorageBucketInput, StorageBucketOutcome, StorageBucketProvisionResult, StorageBucketStep, StorageBucketStepId, } from './schemas.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,0BAA0B,EAAE,WAAW,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG5H,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,8BAA8B,EAC9B,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACtF,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACtF,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,kCAAkC,EAClC,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/cjs/storage/index.js

@@ -0,0 +1,69 @@
+"use strict";
+// `@marinoscar/platform-contract/storage`: the storage slice's wire shapes,
+// shared by `@marinoscar/platform-api/storage` (its DTOs wrap these schemas)
+// and `@marinoscar/platform-web/storage` (types) (issue #736, PP-8.3): the
+// objects API, the storage-config admin routes, `GET /api/storage/status` and
+// the `storage` system-settings namespace. Documented in ./README.md.
+// Explicit named exports only. constants.ts is zod-free.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storageBucketStepSchema = exports.storageBucketProvisionResultSchema = exports.provisionStorageBucketSchema = exports.guidedBucketInstructionsSchema = exports.STORAGE_BUCKET_STEP_STATUSES = exports.STORAGE_BUCKET_STEP_IDS = exports.STORAGE_BUCKET_OUTCOMES = exports.testStorageConfigSchema = exports.storageConnectionTestResultSchema = exports.storageConnectionCheckSchema = exports.STORAGE_TEST_CHECK_STATUSES = exports.STORAGE_TEST_CHECK_IDS = exports.STORAGE_TEST_CHECK_CODES = exports.storageSecretStatusSchema = exports.storageConfigResponseSchema = exports.updateStorageConfigSchema = exports.STORAGE_SWITCH_CONFIRMATION = exports.storageStatusResponseSchema = exports.updateMetadataSchema = exports.uploadStatusResponseSchema = exports.objectResponseSchema = exports.objectListQuerySchema = exports.initUploadSchema = exports.initUploadResponseSchema = exports.downloadUrlResponseSchema = exports.completeUploadSchema = exports.systemStorageSchema = exports.systemStoragePatchSchema = exports.storageSettingsSchema = exports.storageSettingsPatchSchema = exports.storageResponseSchema = exports.storageDriversSchema = exports.storageDriversPatchSchema = exports.storageDriverSettingsSchema = exports.storageDriverIdSchema = exports.STORAGE_SETTINGS_CARRIES_NO_SECRET = exports.STORAGE_SECRET_FIELD_NAMES = exports.STORAGE_PROVIDER_KINDS = exports.STORAGE_OBJECT_STATUSES = exports.STORAGE_DRIVER_ID_PATTERN = exports.MISSING_STORAGE_CONFIG_FIELDS = exports.LEGACY_STORAGE_FLAT_FIELDS = exports.BUILTIN_STORAGE_PROVIDER_KINDS = void 0;
+var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "BUILTIN_STORAGE_PROVIDER_KINDS", { enumerable: true, get: function () { return constants_js_1.BUILTIN_STORAGE_PROVIDER_KINDS; } });
+Object.defineProperty(exports, "LEGACY_STORAGE_FLAT_FIELDS", { enumerable: true, get: function () { return constants_js_1.LEGACY_STORAGE_FLAT_FIELDS; } });
+Object.defineProperty(exports, "MISSING_STORAGE_CONFIG_FIELDS", { enumerable: true, get: function () { return constants_js_1.MISSING_STORAGE_CONFIG_FIELDS; } });
+Object.defineProperty(exports, "STORAGE_DRIVER_ID_PATTERN", { enumerable: true, get: function () { return constants_js_1.STORAGE_DRIVER_ID_PATTERN; } });
+Object.defineProperty(exports, "STORAGE_OBJECT_STATUSES", { enumerable: true, get: function () { return constants_js_1.STORAGE_OBJECT_STATUSES; } });
+Object.defineProperty(exports, "STORAGE_PROVIDER_KINDS", { enumerable: true, get: function () { return constants_js_1.STORAGE_PROVIDER_KINDS; } });
+Object.defineProperty(exports, "STORAGE_SECRET_FIELD_NAMES", { enumerable: true, get: function () { return constants_js_1.STORAGE_SECRET_FIELD_NAMES; } });
+// ---- the `storage` system-settings namespace --------------------------------------------
+var schemas_js_1 = require("./schemas.js");
+Object.defineProperty(exports, "STORAGE_SETTINGS_CARRIES_NO_SECRET", { enumerable: true, get: function () { return schemas_js_1.STORAGE_SETTINGS_CARRIES_NO_SECRET; } });
+Object.defineProperty(exports, "storageDriverIdSchema", { enumerable: true, get: function () { return schemas_js_1.storageDriverIdSchema; } });
+Object.defineProperty(exports, "storageDriverSettingsSchema", { enumerable: true, get: function () { return schemas_js_1.storageDriverSettingsSchema; } });
+Object.defineProperty(exports, "storageDriversPatchSchema", { enumerable: true, get: function () { return schemas_js_1.storageDriversPatchSchema; } });
+Object.defineProperty(exports, "storageDriversSchema", { enumerable: true, get: function () { return schemas_js_1.storageDriversSchema; } });
+Object.defineProperty(exports, "storageResponseSchema", { enumerable: true, get: function () { return schemas_js_1.storageResponseSchema; } });
+Object.defineProperty(exports, "storageSettingsPatchSchema", { enumerable: true, get: function () { return schemas_js_1.storageSettingsPatchSchema; } });
+Object.defineProperty(exports, "storageSettingsSchema", { enumerable: true, get: function () { return schemas_js_1.storageSettingsSchema; } });
+Object.defineProperty(exports, "systemStoragePatchSchema", { enumerable: true, get: function () { return schemas_js_1.systemStoragePatchSchema; } });
+Object.defineProperty(exports, "systemStorageSchema", { enumerable: true, get: function () { return schemas_js_1.systemStorageSchema; } });
+// ---- the objects API (`/api/storage/objects`) and `/api/storage/status` ------------------
+var schemas_js_2 = require("./schemas.js");
+Object.defineProperty(exports, "completeUploadSchema", { enumerable: true, get: function () { return schemas_js_2.completeUploadSchema; } });
+var schemas_js_3 = require("./schemas.js");
+Object.defineProperty(exports, "downloadUrlResponseSchema", { enumerable: true, get: function () { return schemas_js_3.downloadUrlResponseSchema; } });
+var schemas_js_4 = require("./schemas.js");
+Object.defineProperty(exports, "initUploadResponseSchema", { enumerable: true, get: function () { return schemas_js_4.initUploadResponseSchema; } });
+Object.defineProperty(exports, "initUploadSchema", { enumerable: true, get: function () { return schemas_js_4.initUploadSchema; } });
+var schemas_js_5 = require("./schemas.js");
+Object.defineProperty(exports, "objectListQuerySchema", { enumerable: true, get: function () { return schemas_js_5.objectListQuerySchema; } });
+var schemas_js_6 = require("./schemas.js");
+Object.defineProperty(exports, "objectResponseSchema", { enumerable: true, get: function () { return schemas_js_6.objectResponseSchema; } });
+Object.defineProperty(exports, "uploadStatusResponseSchema", { enumerable: true, get: function () { return schemas_js_6.uploadStatusResponseSchema; } });
+var schemas_js_7 = require("./schemas.js");
+Object.defineProperty(exports, "updateMetadataSchema", { enumerable: true, get: function () { return schemas_js_7.updateMetadataSchema; } });
+var schemas_js_8 = require("./schemas.js");
+Object.defineProperty(exports, "storageStatusResponseSchema", { enumerable: true, get: function () { return schemas_js_8.storageStatusResponseSchema; } });
+// ---- the storage-config admin routes (`/api/admin/storage-config`) -----------------------
+var schemas_js_9 = require("./schemas.js");
+Object.defineProperty(exports, "STORAGE_SWITCH_CONFIRMATION", { enumerable: true, get: function () { return schemas_js_9.STORAGE_SWITCH_CONFIRMATION; } });
+Object.defineProperty(exports, "updateStorageConfigSchema", { enumerable: true, get: function () { return schemas_js_9.updateStorageConfigSchema; } });
+var schemas_js_10 = require("./schemas.js");
+Object.defineProperty(exports, "storageConfigResponseSchema", { enumerable: true, get: function () { return schemas_js_10.storageConfigResponseSchema; } });
+Object.defineProperty(exports, "storageSecretStatusSchema", { enumerable: true, get: function () { return schemas_js_10.storageSecretStatusSchema; } });
+var schemas_js_11 = require("./schemas.js");
+Object.defineProperty(exports, "STORAGE_TEST_CHECK_CODES", { enumerable: true, get: function () { return schemas_js_11.STORAGE_TEST_CHECK_CODES; } });
+Object.defineProperty(exports, "STORAGE_TEST_CHECK_IDS", { enumerable: true, get: function () { return schemas_js_11.STORAGE_TEST_CHECK_IDS; } });
+Object.defineProperty(exports, "STORAGE_TEST_CHECK_STATUSES", { enumerable: true, get: function () { return schemas_js_11.STORAGE_TEST_CHECK_STATUSES; } });
+Object.defineProperty(exports, "storageConnectionCheckSchema", { enumerable: true, get: function () { return schemas_js_11.storageConnectionCheckSchema; } });
+Object.defineProperty(exports, "storageConnectionTestResultSchema", { enumerable: true, get: function () { return schemas_js_11.storageConnectionTestResultSchema; } });
+Object.defineProperty(exports, "testStorageConfigSchema", { enumerable: true, get: function () { return schemas_js_11.testStorageConfigSchema; } });
+var schemas_js_12 = require("./schemas.js");
+Object.defineProperty(exports, "STORAGE_BUCKET_OUTCOMES", { enumerable: true, get: function () { return schemas_js_12.STORAGE_BUCKET_OUTCOMES; } });
+Object.defineProperty(exports, "STORAGE_BUCKET_STEP_IDS", { enumerable: true, get: function () { return schemas_js_12.STORAGE_BUCKET_STEP_IDS; } });
+Object.defineProperty(exports, "STORAGE_BUCKET_STEP_STATUSES", { enumerable: true, get: function () { return schemas_js_12.STORAGE_BUCKET_STEP_STATUSES; } });
+Object.defineProperty(exports, "guidedBucketInstructionsSchema", { enumerable: true, get: function () { return schemas_js_12.guidedBucketInstructionsSchema; } });
+Object.defineProperty(exports, "provisionStorageBucketSchema", { enumerable: true, get: function () { return schemas_js_12.provisionStorageBucketSchema; } });
+Object.defineProperty(exports, "storageBucketProvisionResultSchema", { enumerable: true, get: function () { return schemas_js_12.storageBucketProvisionResultSchema; } });
+Object.defineProperty(exports, "storageBucketStepSchema", { enumerable: true, get: function () { return schemas_js_12.storageBucketStepSchema; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,sEAAsE;AACtE,yDAAyD;;;AAEzD,+CAQwB;AAPtB,8HAAA,8BAA8B,OAAA;AAC9B,0HAAA,0BAA0B,OAAA;AAC1B,6HAAA,6BAA6B,OAAA;AAC7B,yHAAA,yBAAyB,OAAA;AACzB,uHAAA,uBAAuB,OAAA;AACvB,sHAAA,sBAAsB,OAAA;AACtB,0HAAA,0BAA0B,OAAA;AAI5B,4FAA4F;AAC5F,2CAWsB;AAVpB,gIAAA,kCAAkC,OAAA;AAClC,mHAAA,qBAAqB,OAAA;AACrB,yHAAA,2BAA2B,OAAA;AAC3B,uHAAA,yBAAyB,OAAA;AACzB,kHAAA,oBAAoB,OAAA;AACpB,mHAAA,qBAAqB,OAAA;AACrB,wHAAA,0BAA0B,OAAA;AAC1B,mHAAA,qBAAqB,OAAA;AACrB,sHAAA,wBAAwB,OAAA;AACxB,iHAAA,mBAAmB,OAAA;AAWrB,6FAA6F;AAC7F,2CAAoD;AAA3C,kHAAA,oBAAoB,OAAA;AAE7B,2CAAyD;AAAhD,uHAAA,yBAAyB,OAAA;AAElC,2CAA0E;AAAjE,sHAAA,wBAAwB,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAEnD,2CAAqD;AAA5C,mHAAA,qBAAqB,OAAA;AAE9B,2CAAgF;AAAvE,kHAAA,oBAAoB,OAAA;AAAE,wHAAA,0BAA0B,OAAA;AAEzD,2CAAoD;AAA3C,kHAAA,oBAAoB,OAAA;AAE7B,2CAA2D;AAAlD,yHAAA,2BAA2B,OAAA;AAGpC,6FAA6F;AAC7F,2CAAsF;AAA7E,yHAAA,2BAA2B,OAAA;AAAE,uHAAA,yBAAyB,OAAA;AAE/D,4CAAsF;AAA7E,0HAAA,2BAA2B,OAAA;AAAE,wHAAA,yBAAyB,OAAA;AAE/D,4CAOsB;AANpB,uHAAA,wBAAwB,OAAA;AACxB,qHAAA,sBAAsB,OAAA;AACtB,0HAAA,2BAA2B,OAAA;AAC3B,2HAAA,4BAA4B,OAAA;AAC5B,gIAAA,iCAAiC,OAAA;AACjC,sHAAA,uBAAuB,OAAA;AAQzB,4CAQsB;AAPpB,sHAAA,uBAAuB,OAAA;AACvB,sHAAA,uBAAuB,OAAA;AACvB,2HAAA,4BAA4B,OAAA;AAC5B,6HAAA,8BAA8B,OAAA;AAC9B,2HAAA,4BAA4B,OAAA;AAC5B,iIAAA,kCAAkC,OAAA;AAClC,sHAAA,uBAAuB,OAAA"}

package/dist/cjs/storage/objects-complete-upload.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+/**
+ * The `POST /api/storage/objects/:id/upload/complete` body: every uploaded part with its ETag.
+ *
+ * @stability experimental
+ */
+export declare const completeUploadSchema: z.ZodObject<{
+    parts: z.ZodArray<z.ZodObject<{
+        partNumber: z.ZodNumber;
+        eTag: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * The complete-upload body, inferred.
+ *
+ * @stability experimental
+ */
+export type CompleteUploadDto = z.infer<typeof completeUploadSchema>;
+//# sourceMappingURL=objects-complete-upload.d.ts.map

package/dist/cjs/storage/objects-complete-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-complete-upload.d.ts","sourceRoot":"","sources":["../../../src/storage/objects-complete-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAQ/B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/cjs/storage/objects-complete-upload.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.completeUploadSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * The `POST /api/storage/objects/:id/upload/complete` body: every uploaded part with its ETag.
+ *
+ * @stability experimental
+ */
+exports.completeUploadSchema = zod_1.z.object({
+    /** Every uploaded part, with its ETag. */
+    parts: zod_1.z.array(zod_1.z.object({
+        /** The part number (1-10000). */
+        partNumber: zod_1.z.number().int().positive(),
+        /** The part's ETag, as the provider returned it. */
+        eTag: zod_1.z.string().min(1),
+    })).min(1),
+});
+//# sourceMappingURL=objects-complete-upload.js.map

package/dist/cjs/storage/objects-complete-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-complete-upload.js","sourceRoot":"","sources":["../../../src/storage/objects-complete-upload.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;GAIG;AACU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,0CAA0C;IAC1C,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QACtB,iCAAiC;QACjC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACvC,oDAAoD;QACpD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACxB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACX,CAAC,CAAC"}

package/dist/cjs/storage/objects-download-url.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+/**
+ * The `GET /api/storage/objects/:id/download` payload: a signed URL and its lifetime.
+ *
+ * @stability experimental
+ */
+export declare const downloadUrlResponseSchema: z.ZodObject<{
+    url: z.ZodURL;
+    expiresIn: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * The `GET /api/storage/objects/:id/download` payload.
+ *
+ * @stability stable
+ */
+export type DownloadUrlResponse = z.infer<typeof downloadUrlResponseSchema>;
+//# sourceMappingURL=objects-download-url.d.ts.map

package/dist/cjs/storage/objects-download-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-download-url.d.ts","sourceRoot":"","sources":["../../../src/storage/objects-download-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;iBAKpC,CAAC;AAGH;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/cjs/storage/objects-download-url.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadUrlResponseSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * The `GET /api/storage/objects/:id/download` payload: a signed URL and its lifetime.
+ *
+ * @stability experimental
+ */
+exports.downloadUrlResponseSchema = zod_1.z.object({
+    /** Time-limited signed URL. Fetch it directly; it does not carry an Authorization header. */
+    url: zod_1.z.url(),
+    /** Seconds until the URL stops working. */
+    expiresIn: zod_1.z.number().int().positive(),
+});
+//# sourceMappingURL=objects-download-url.js.map

package/dist/cjs/storage/objects-download-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-download-url.js","sourceRoot":"","sources":["../../../src/storage/objects-download-url.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;GAIG;AACU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,6FAA6F;IAC7F,GAAG,EAAE,OAAC,CAAC,GAAG,EAAE;IACZ,2CAA2C;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

package/dist/cjs/storage/objects-init-upload.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/**
+ * The `POST /api/storage/objects/upload/init` body: the file name, size and media type.
+ *
+ * @stability experimental
+ */
+export declare const initUploadSchema: z.ZodObject<{
+    name: z.ZodString;
+    size: z.ZodNumber;
+    mimeType: z.ZodString;
+}, z.core.$strip>;
+/**
+ * The init-upload body, inferred.
+ *
+ * @stability experimental
+ */
+export type InitUploadDto = z.infer<typeof initUploadSchema>;
+/**
+ * The init-upload payload: the object id, the provider upload id, the part size and the first presigned part URLs.
+ *
+ * @stability experimental
+ */
+export declare const initUploadResponseSchema: z.ZodObject<{
+    objectId: z.ZodUUID;
+    uploadId: z.ZodString;
+    partSize: z.ZodNumber;
+    totalParts: z.ZodNumber;
+    presignedUrls: z.ZodArray<z.ZodObject<{
+        partNumber: z.ZodNumber;
+        url: z.ZodURL;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * The `POST /api/storage/objects/upload/init` payload.
+ *
+ * @stability stable
+ */
+export type InitUploadResponse = z.infer<typeof initUploadResponseSchema>;
+//# sourceMappingURL=objects-init-upload.d.ts.map

package/dist/cjs/storage/objects-init-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-init-upload.d.ts","sourceRoot":"","sources":["../../../src/storage/objects-init-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;iBAO3B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;iBAkBnC,CAAC;AAGH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/cjs/storage/objects-init-upload.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initUploadResponseSchema = exports.initUploadSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * The `POST /api/storage/objects/upload/init` body: the file name, size and media type.
+ *
+ * @stability experimental
+ */
+exports.initUploadSchema = zod_1.z.object({
+    /** The original filename. */
+    name: zod_1.z.string().min(1).max(255),
+    /** The size in bytes, as a string (64-bit safe). */
+    size: zod_1.z.number().int().positive(),
+    /** The declared media type. */
+    mimeType: zod_1.z.string().min(1),
+});
+/**
+ * The init-upload payload: the object id, the provider upload id, the part size and the first presigned part URLs.
+ *
+ * @stability experimental
+ */
+exports.initUploadResponseSchema = zod_1.z.object({
+    /** The object id (UUID). */
+    objectId: zod_1.z.uuid(),
+    /** Provider-side multipart upload id, echoed back on complete/abort. */
+    uploadId: zod_1.z.string(),
+    /** Byte length of every part but the last. */
+    partSize: zod_1.z.number().int().positive(),
+    /** How many parts the upload has. */
+    totalParts: zod_1.z.number().int().positive(),
+    /** One signed PUT URL per part. Upload to them directly, then call complete. */
+    presignedUrls: zod_1.z.array(zod_1.z.object({
+        /** The part number (1-10000). */
+        partNumber: zod_1.z.number().int().positive(),
+        /** The signed URL; fetch it directly. */
+        url: zod_1.z.url(),
+    })),
+});
+//# sourceMappingURL=objects-init-upload.js.map

package/dist/cjs/storage/objects-init-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-init-upload.js","sourceRoot":"","sources":["../../../src/storage/objects-init-upload.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;GAIG;AACU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,6BAA6B;IAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,oDAAoD;IACpD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,+BAA+B;IAC/B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AASH;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,4BAA4B;IAC5B,QAAQ,EAAE,OAAC,CAAC,IAAI,EAAE;IAClB,wEAAwE;IACxE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,qCAAqC;IACrC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACvC,gFAAgF;IAChF,aAAa,EAAE,OAAC,CAAC,KAAK,CACpB,OAAC,CAAC,MAAM,CAAC;QACP,iCAAiC;QACjC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACvC,yCAAyC;QACzC,GAAG,EAAE,OAAC,CAAC,GAAG,EAAE;KACb,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/cjs/storage/objects-list-query.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import type { ObjectResponse } from './objects-object-response.js';
+import { type StorageEnum } from './constants.js';
+/**
+ * The `GET /api/storage/objects` query: page, page size, status filter and sort.
+ *
+ * @stability experimental
+ */
+export declare const objectListQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    status: z.ZodOptional<z.ZodEnum<StorageEnum<readonly ["pending", "uploading", "processing", "ready", "failed"]>>>;
+    sortBy: z.ZodDefault<z.ZodEnum<StorageEnum<["createdAt", "name", "size"]>>>;
+    sortOrder: z.ZodDefault<z.ZodEnum<StorageEnum<["asc", "desc"]>>>;
+}, z.core.$strip>;
+/**
+ * The list query, parsed (defaults applied).
+ *
+ * @stability experimental
+ */
+export type ObjectListQueryDto = z.infer<typeof objectListQuerySchema>;
+/**
+ * The NESTED list shape — counts live in a `meta` object inside the payload,
+ * and the total is named `totalItems`. The flat lists (`GET /api/users`,
+ * `GET /api/allowlist`) spell the same concept differently; see
+ * `ApiDataResponse` for why that asymmetry is documented rather than hidden.
+ *
+ * Left as an interface: the controller documents this shape through
+ * `@ApiDataResponse(ObjectResponseDto, { pagination: 'nested' })`, which is
+ * where the published schema comes from, so a parallel zod schema here would be
+ * a second declaration to keep in step for no gain.
+ *
+ * @stability experimental
+ */
+export interface ObjectListResponse {
+    /** The page's objects. */
+    items: ObjectResponse[];
+    /** The page's position in the list. */
+    meta: {
+        /** The page, 1-based. */
+        page: number;
+        /** Items per page. */
+        pageSize: number;
+        /** Objects matching the filter, across pages. */
+        totalItems: number;
+        /** How many pages there are. */
+        totalPages: number;
+    };
+}
+//# sourceMappingURL=objects-list-query.d.ts.map

package/dist/cjs/storage/objects-list-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-list-query.d.ts","sourceRoot":"","sources":["../../../src/storage/objects-list-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAWhC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,uCAAuC;IACvC,IAAI,EAAE;QACJ,yBAAyB;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,sBAAsB;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,iDAAiD;QACjD,UAAU,EAAE,MAAM,CAAC;QACnB,gCAAgC;QAChC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/cjs/storage/objects-list-query.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectListQuerySchema = void 0;
+const zod_1 = require("zod");
+const constants_js_1 = require("./constants.js");
+/**
+ * The `GET /api/storage/objects` query: page, page size, status filter and sort.
+ *
+ * @stability experimental
+ */
+exports.objectListQuerySchema = zod_1.z.object({
+    /** The page, 1-based. */
+    page: zod_1.z.coerce.number().int().positive().default(1),
+    /** Items per page (at most 100). */
+    pageSize: zod_1.z.coerce.number().int().positive().max(100).default(20),
+    /** The status. */
+    status: zod_1.z.enum(constants_js_1.STORAGE_OBJECT_STATUSES).optional(),
+    /** The sort field. */
+    sortBy: zod_1.z.enum(['createdAt', 'name', 'size']).default('createdAt'),
+    /** The sort direction. */
+    sortOrder: zod_1.z.enum(['asc', 'desc']).default('desc'),
+});
+//# sourceMappingURL=objects-list-query.js.map

package/dist/cjs/storage/objects-list-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-list-query.js","sourceRoot":"","sources":["../../../src/storage/objects-list-query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,iDAA2E;AAE3E;;;;GAIG;AACU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,yBAAyB;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,oCAAoC;IACpC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACjE,kBAAkB;IAClB,MAAM,EAAG,OAAC,CAAC,IAAI,CAAC,sCAAuB,CAA4D,CAAC,QAAQ,EAAE;IAC9G,sBAAsB;IACtB,MAAM,EAAG,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAA2D,CAAC,OAAO,CAAC,WAAW,CAAC;IAC7H,0BAA0B;IAC1B,SAAS,EAAG,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAA6C,CAAC,OAAO,CAAC,MAAM,CAAC;CAChG,CAAC,CAAC"}

package/dist/cjs/storage/objects-object-response.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { type StorageEnum } from './constants.js';
+/**
+ * Storage object metadata as returned to a caller.
+ *
+ * Declared as a zod schema rather than a bare TypeScript `interface` because an
+ * interface is erased at compile time: `@ApiResponse({ type: ObjectResponseDto })`
+ * against one produced nothing, and the controller fell back to `type: Object`,
+ * publishing an empty schema. A `createZodDto` class is both the compile-time
+ * type the service already used and a real JSON Schema in the document.
+ *
+ * @stability experimental
+ */
+export declare const objectResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    name: z.ZodString;
+    size: z.ZodString;
+    mimeType: z.ZodString;
+    status: z.ZodEnum<StorageEnum<readonly ["pending", "uploading", "processing", "ready", "failed"]>>;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+/**
+ * The `GET /api/storage/objects/:id/upload/status` payload: the parts uploaded so far.
+ *
+ * @stability experimental
+ */
+export declare const uploadStatusResponseSchema: z.ZodObject<{
+    objectId: z.ZodUUID;
+    status: z.ZodEnum<StorageEnum<readonly ["pending", "uploading", "processing", "ready", "failed"]>>;
+    uploadedParts: z.ZodArray<z.ZodNumber>;
+    totalParts: z.ZodNumber;
+    uploadedBytes: z.ZodString;
+    totalBytes: z.ZodString;
+}, z.core.$strip>;
+/**
+ * One storage object as the API returns it.
+ *
+ * @stability stable
+ */
+export type ObjectResponse = z.infer<typeof objectResponseSchema>;
+/**
+ * A resumable upload's progress, as the API returns it.
+ *
+ * @stability stable
+ */
+export type UploadStatusResponse = z.infer<typeof uploadStatusResponseSchema>;
+//# sourceMappingURL=objects-object-response.d.ts.map

package/dist/cjs/storage/objects-object-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-object-response.d.ts","sourceRoot":"","sources":["../../../src/storage/objects-object-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAiB/B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;iBAarC,CAAC;AAGH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/cjs/storage/objects-object-response.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadStatusResponseSchema = exports.objectResponseSchema = void 0;
+const zod_1 = require("zod");
+const constants_js_1 = require("./constants.js");
+/**
+ * Storage object metadata as returned to a caller.
+ *
+ * Declared as a zod schema rather than a bare TypeScript `interface` because an
+ * interface is erased at compile time: `@ApiResponse({ type: ObjectResponseDto })`
+ * against one produced nothing, and the controller fell back to `type: Object`,
+ * publishing an empty schema. A `createZodDto` class is both the compile-time
+ * type the service already used and a real JSON Schema in the document.
+ *
+ * @stability experimental
+ */
+exports.objectResponseSchema = zod_1.z.object({
+    /** The id. */
+    id: zod_1.z.uuid(),
+    /** The original filename. */
+    name: zod_1.z.string(),
+    /** BigInt serialized as a string — 64-bit values lose precision as JSON numbers. */
+    size: zod_1.z.string(),
+    /** The declared media type. */
+    mimeType: zod_1.z.string(),
+    /** The status. */
+    status: zod_1.z.enum(constants_js_1.STORAGE_OBJECT_STATUSES),
+    /** Free-form metadata, or `null`. */
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable(),
+    /** When it was created (ISO). */
+    createdAt: zod_1.z.string(),
+    /** When it was last written (ISO), or `null`. */
+    updatedAt: zod_1.z.string(),
+});
+/**
+ * The `GET /api/storage/objects/:id/upload/status` payload: the parts uploaded so far.
+ *
+ * @stability experimental
+ */
+exports.uploadStatusResponseSchema = zod_1.z.object({
+    /** The object id (UUID). */
+    objectId: zod_1.z.uuid(),
+    /** The status. */
+    status: zod_1.z.enum(constants_js_1.STORAGE_OBJECT_STATUSES),
+    /** Part numbers already uploaded, so a resuming client knows what to skip. */
+    uploadedParts: zod_1.z.array(zod_1.z.number().int()),
+    /** How many parts the upload has. */
+    totalParts: zod_1.z.number().int(),
+    /** Bytes uploaded so far, as a string. */
+    uploadedBytes: zod_1.z.string(),
+    /** The total size, as a string. */
+    totalBytes: zod_1.z.string(),
+});
+//# sourceMappingURL=objects-object-response.js.map

package/dist/cjs/storage/objects-object-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-object-response.js","sourceRoot":"","sources":["../../../src/storage/objects-object-response.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,iDAA2E;AAE3E;;;;;;;;;;GAUG;AACU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,cAAc;IACd,EAAE,EAAE,OAAC,CAAC,IAAI,EAAE;IACZ,6BAA6B;IAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,oFAAoF;IACpF,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,kBAAkB;IAClB,MAAM,EAAG,OAAC,CAAC,IAAI,CAAC,sCAAuB,CAA4D;IACnG,qCAAqC;IACrC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,iCAAiC;IACjC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,iDAAiD;IACjD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,4BAA4B;IAC5B,QAAQ,EAAE,OAAC,CAAC,IAAI,EAAE;IAClB,kBAAkB;IAClB,MAAM,EAAG,OAAC,CAAC,IAAI,CAAC,sCAAuB,CAA4D;IACnG,8EAA8E;IAC9E,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;IACxC,qCAAqC;IACrC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC5B,0CAA0C;IAC1C,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,mCAAmC;IACnC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC"}

package/dist/cjs/storage/objects-update-metadata.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+/**
+ * The `PATCH /api/storage/objects/:id/metadata` body: keys merged into the existing metadata.
+ *
+ * @stability experimental
+ */
+export declare const updateMetadataSchema: z.ZodObject<{
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * The metadata patch, inferred.
+ *
+ * @stability experimental
+ */
+export type UpdateMetadataDto = z.infer<typeof updateMetadataSchema>;
+//# sourceMappingURL=objects-update-metadata.d.ts.map

package/dist/cjs/storage/objects-update-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-update-metadata.d.ts","sourceRoot":"","sources":["../../../src/storage/objects-update-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;iBAG/B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}