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

package/dist/esm/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/esm/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/esm/storage/index.js

@@ -0,0 +1,23 @@
+// `@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.
+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';
+// ---- the `storage` system-settings namespace --------------------------------------------
+export { STORAGE_SETTINGS_CARRIES_NO_SECRET, storageDriverIdSchema, storageDriverSettingsSchema, storageDriversPatchSchema, storageDriversSchema, storageResponseSchema, storageSettingsPatchSchema, storageSettingsSchema, systemStoragePatchSchema, systemStorageSchema, } from './schemas.js';
+// ---- the objects API (`/api/storage/objects`) and `/api/storage/status` ------------------
+export { completeUploadSchema } from './schemas.js';
+export { downloadUrlResponseSchema } from './schemas.js';
+export { initUploadResponseSchema, initUploadSchema } from './schemas.js';
+export { objectListQuerySchema } from './schemas.js';
+export { objectResponseSchema, uploadStatusResponseSchema } from './schemas.js';
+export { updateMetadataSchema } from './schemas.js';
+export { storageStatusResponseSchema } from './schemas.js';
+// ---- the storage-config admin routes (`/api/admin/storage-config`) -----------------------
+export { STORAGE_SWITCH_CONFIRMATION, updateStorageConfigSchema } from './schemas.js';
+export { storageConfigResponseSchema, storageSecretStatusSchema } from './schemas.js';
+export { STORAGE_TEST_CHECK_CODES, STORAGE_TEST_CHECK_IDS, STORAGE_TEST_CHECK_STATUSES, storageConnectionCheckSchema, storageConnectionTestResultSchema, testStorageConfigSchema, } from './schemas.js';
+export { STORAGE_BUCKET_OUTCOMES, STORAGE_BUCKET_STEP_IDS, STORAGE_BUCKET_STEP_STATUSES, guidedBucketInstructionsSchema, provisionStorageBucketSchema, storageBucketProvisionResultSchema, storageBucketStepSchema, } from './schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/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,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAGxB,4FAA4F;AAC5F,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;AAUtB,6FAA6F;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAG3D,6FAA6F;AAC7F,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEtF,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEtF,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,kCAAkC,EAClC,uBAAuB,GACxB,MAAM,cAAc,CAAC"}

package/dist/esm/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/esm/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/esm/storage/objects-complete-upload.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+/**
+ * The `POST /api/storage/objects/:id/upload/complete` body: every uploaded part with its ETag.
+ *
+ * @stability experimental
+ */
+export const completeUploadSchema = z.object({
+    /** Every uploaded part, with its ETag. */
+    parts: z.array(z.object({
+        /** The part number (1-10000). */
+        partNumber: z.number().int().positive(),
+        /** The part's ETag, as the provider returned it. */
+        eTag: z.string().min(1),
+    })).min(1),
+});
+//# sourceMappingURL=objects-complete-upload.js.map

package/dist/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,0CAA0C;IAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACtB,iCAAiC;QACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACvC,oDAAoD;QACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACxB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACX,CAAC,CAAC"}

package/dist/esm/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/esm/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/esm/storage/objects-download-url.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * The `GET /api/storage/objects/:id/download` payload: a signed URL and its lifetime.
+ *
+ * @stability experimental
+ */
+export const downloadUrlResponseSchema = z.object({
+    /** Time-limited signed URL. Fetch it directly; it does not carry an Authorization header. */
+    url: z.url(),
+    /** Seconds until the URL stops working. */
+    expiresIn: z.number().int().positive(),
+});
+//# sourceMappingURL=objects-download-url.js.map

package/dist/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,6FAA6F;IAC7F,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;IACZ,2CAA2C;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

package/dist/esm/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/esm/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/esm/storage/objects-init-upload.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/**
+ * The `POST /api/storage/objects/upload/init` body: the file name, size and media type.
+ *
+ * @stability experimental
+ */
+export const initUploadSchema = z.object({
+    /** The original filename. */
+    name: z.string().min(1).max(255),
+    /** The size in bytes, as a string (64-bit safe). */
+    size: z.number().int().positive(),
+    /** The declared media type. */
+    mimeType: 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
+ */
+export const initUploadResponseSchema = z.object({
+    /** The object id (UUID). */
+    objectId: z.uuid(),
+    /** Provider-side multipart upload id, echoed back on complete/abort. */
+    uploadId: z.string(),
+    /** Byte length of every part but the last. */
+    partSize: z.number().int().positive(),
+    /** How many parts the upload has. */
+    totalParts: z.number().int().positive(),
+    /** One signed PUT URL per part. Upload to them directly, then call complete. */
+    presignedUrls: z.array(z.object({
+        /** The part number (1-10000). */
+        partNumber: z.number().int().positive(),
+        /** The signed URL; fetch it directly. */
+        url: z.url(),
+    })),
+});
+//# sourceMappingURL=objects-init-upload.js.map

package/dist/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,6BAA6B;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,oDAAoD;IACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AASH;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,4BAA4B;IAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE;IAClB,wEAAwE;IACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,qCAAqC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACvC,gFAAgF;IAChF,aAAa,EAAE,CAAC,CAAC,KAAK,CACpB,CAAC,CAAC,MAAM,CAAC;QACP,iCAAiC;QACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACvC,yCAAyC;QACzC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;KACb,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/esm/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/esm/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/esm/storage/objects-list-query.js

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

package/dist/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAoB,MAAM,gBAAgB,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,yBAAyB;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,oCAAoC;IACpC,QAAQ,EAAE,CAAC,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,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAA4D,CAAC,QAAQ,EAAE;IAC9G,sBAAsB;IACtB,MAAM,EAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAA2D,CAAC,OAAO,CAAC,WAAW,CAAC;IAC7H,0BAA0B;IAC1B,SAAS,EAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAA6C,CAAC,OAAO,CAAC,MAAM,CAAC;CAChG,CAAC,CAAC"}

package/dist/esm/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/esm/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/esm/storage/objects-object-response.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { STORAGE_OBJECT_STATUSES } 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 const objectResponseSchema = z.object({
+    /** The id. */
+    id: z.uuid(),
+    /** The original filename. */
+    name: z.string(),
+    /** BigInt serialized as a string — 64-bit values lose precision as JSON numbers. */
+    size: z.string(),
+    /** The declared media type. */
+    mimeType: z.string(),
+    /** The status. */
+    status: z.enum(STORAGE_OBJECT_STATUSES),
+    /** Free-form metadata, or `null`. */
+    metadata: z.record(z.string(), z.unknown()).nullable(),
+    /** When it was created (ISO). */
+    createdAt: z.string(),
+    /** When it was last written (ISO), or `null`. */
+    updatedAt: z.string(),
+});
+/**
+ * The `GET /api/storage/objects/:id/upload/status` payload: the parts uploaded so far.
+ *
+ * @stability experimental
+ */
+export const uploadStatusResponseSchema = z.object({
+    /** The object id (UUID). */
+    objectId: z.uuid(),
+    /** The status. */
+    status: z.enum(STORAGE_OBJECT_STATUSES),
+    /** Part numbers already uploaded, so a resuming client knows what to skip. */
+    uploadedParts: z.array(z.number().int()),
+    /** How many parts the upload has. */
+    totalParts: z.number().int(),
+    /** Bytes uploaded so far, as a string. */
+    uploadedBytes: z.string(),
+    /** The total size, as a string. */
+    totalBytes: z.string(),
+});
+//# sourceMappingURL=objects-object-response.js.map

package/dist/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAoB,MAAM,gBAAgB,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,cAAc;IACd,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;IACZ,6BAA6B;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,oFAAoF;IACpF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,kBAAkB;IAClB,MAAM,EAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAA4D;IACnG,qCAAqC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,iCAAiC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,iDAAiD;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,4BAA4B;IAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE;IAClB,kBAAkB;IAClB,MAAM,EAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAA4D;IACnG,8EAA8E;IAC9E,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;IACxC,qCAAqC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC5B,0CAA0C;IAC1C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,mCAAmC;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC"}

package/dist/esm/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/esm/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"}

package/dist/esm/storage/objects-update-metadata.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+/**
+ * The `PATCH /api/storage/objects/:id/metadata` body: keys merged into the existing metadata.
+ *
+ * @stability experimental
+ */
+export const updateMetadataSchema = z.object({
+    /** Merged into the object's existing metadata rather than replacing it. */
+    metadata: z.record(z.string(), z.unknown()),
+});
+//# sourceMappingURL=objects-update-metadata.js.map

package/dist/esm/storage/objects-update-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects-update-metadata.js","sourceRoot":"","sources":["../../../src/storage/objects-update-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAC5C,CAAC,CAAC"}

package/dist/esm/storage/schemas.d.ts

@@ -0,0 +1,13 @@
+export * from './settings-schemas.js';
+export * from './objects-complete-upload.js';
+export * from './objects-download-url.js';
+export * from './objects-init-upload.js';
+export * from './objects-list-query.js';
+export * from './objects-object-response.js';
+export * from './objects-update-metadata.js';
+export * from './storage-status.js';
+export * from './storage-config-update.js';
+export * from './storage-config-response.js';
+export * from './storage-connection-test.js';
+export * from './storage-bucket-provision.js';
+//# sourceMappingURL=schemas.d.ts.map

package/dist/esm/storage/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/storage/schemas.ts"],"names":[],"mappings":"AAMA,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/dist/esm/storage/schemas.js

@@ -0,0 +1,19 @@
+// The storage schemas, by route group (issue #736, PP-8.3): the `storage`
+// system-settings namespace (./settings-schemas.ts), the objects API
+// (./objects-*.ts), `GET /api/storage/status` (./storage-status.ts) and the
+// storage-config admin routes (./storage-config-*.ts,
+// ./storage-connection-test.ts, ./storage-bucket-provision.ts). The zod-free
+// value lists live in ./constants.ts.
+export * from './settings-schemas.js';
+export * from './objects-complete-upload.js';
+export * from './objects-download-url.js';
+export * from './objects-init-upload.js';
+export * from './objects-list-query.js';
+export * from './objects-object-response.js';
+export * from './objects-update-metadata.js';
+export * from './storage-status.js';
+export * from './storage-config-update.js';
+export * from './storage-config-response.js';
+export * from './storage-connection-test.js';
+export * from './storage-bucket-provision.js';
+//# sourceMappingURL=schemas.js.map

package/dist/esm/storage/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/storage/schemas.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,4EAA4E;AAC5E,sDAAsD;AACtD,6EAA6E;AAC7E,sCAAsC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}