@riverbankcms/sdk 0.151.0 → 0.153.0

package/dist/_dts/media-core/src/fileStorage.d.ts

@@ -1,5 +1,6 @@
 import { type SafeDownloadFilename, type SiteScopedStoragePath, type SiteId, type StorageBucketName, type StoragePath, type UploadSessionId, type UserId, type MediaAssetId, type Result } from '../../core/src/index';
 import type { StorageClass } from './fileDomain';
+import { type WritableStoragePathError } from './storageObjectKey';
 export declare const FILE_STORAGE_BUCKETS: {
     readonly publicSite: StorageBucketName;
     readonly privateSite: StorageBucketName;
@@ -16,7 +17,7 @@ export declare const DURABLE_FILE_FOLDER = "files";
 export declare const SDK_UPLOAD_STAGING_PREFIX = "sdk-staging";
 export declare const PRIVATE_SITE_FILE_BUCKET_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "application/rtf", "text/rtf", "image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "image/svg+xml", "text/csv", "application/csv", "application/vnd.ms-excel", "application/zip", "application/x-zip-compressed", "audio/mpeg", "audio/mp4", "audio/wav", "audio/x-wav", "audio/ogg", "audio/webm", "audio/flac", "video/mp4", "video/webm", "video/quicktime"];
 export declare const TEMP_UPLOAD_BUCKET_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "application/rtf", "text/rtf", "image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "image/svg+xml", "text/csv", "application/csv", "application/vnd.ms-excel", "application/zip", "application/x-zip-compressed", "audio/mpeg", "audio/mp4", "audio/wav", "audio/x-wav", "audio/ogg", "audio/webm", "audio/flac", "video/mp4", "video/webm", "video/quicktime", "font/woff2", "application/font-woff2", "application/x-font-woff2", "application/octet-stream"];
-export type FileStoragePathError = 'unsafe-path-segment';
+export type FileStoragePathError = WritableStoragePathError;
 export type StagedUploadStoragePathInput = {
     readonly userId: UserId;
     readonly siteId: SiteId;
@@ -35,12 +36,12 @@ export type DurableFileStoragePathInput = {
 export declare function storageBucketForStorageClass(storageClass: StorageClass): StorageBucketName;
 /**
  * Builds the `temp-uploads` object path allowed by Storage RLS:
- * `temp-file-uploads/{userId}/{siteId}/{uploadSessionId}/{safeDownloadFilename}`.
+ * `temp-file-uploads/{userId}/{siteId}/{uploadSessionId}/{storageObjectFilename}`.
  */
 export declare function buildStagedUploadStoragePath(input: StagedUploadStoragePathInput): Result<StoragePath, FileStoragePathError>;
 /**
  * Builds the durable site-scoped object path allowed by public/private site-file RLS:
- * `sites/{siteId}/files/{fileAssetId}/{safeDownloadFilename}`.
+ * `sites/{siteId}/files/{fileAssetId}/{storageObjectFilename}`.
  */
 export declare function buildDurableFileStoragePath(input: DurableFileStoragePathInput): Result<SiteScopedStoragePath, FileStoragePathError>;
 export declare function parseStoragePath(value: string): Result<StoragePath, FileStoragePathError>;

package/dist/_dts/media-core/src/index.d.ts

@@ -1,6 +1,7 @@
 export * from './types';
 export * from './fileDomain';
 export * from './fileStorage';
+export * from './storageObjectKey';
 export * from './storagePathDomain';
 export * from './fileSafety';
 export * from './filePersistence';
@@ -28,6 +29,9 @@ export * from './classifyAllPlanning';
 export * from './mediaSettingsState';
 export * from './videoSlotPolicy';
 export * from './identifiers';
+export * from './mediaIdentifierSchema';
+export * from './mediaKinds';
+export * from './media';
 export { getImageUrl, getDirectImageUrl, getDirectImageUrlForRelativePath, getDirectImageUrlForSiteScopedPath, getDirectImageUrlForBucketPath, getDirectImageUrlForMediaAsset, isSiteScopedDirectImageStoragePath, type DirectImageMediaAsset, type DirectImageUrlOptions, type DirectImageUrlPathTarget, type ImageProxyFit, type ImageProxyParams, } from './url';
 export { isSameTransformRect, isSameHotspot, type HotspotLike } from './compare';
 export { asRecord, isRecord } from './typeGuards';
@@ -45,6 +49,7 @@ export * from './richTextImageWriteNormalizer';
 export * from './mediaUsageProjection';
 export * from './portableMediaReferences';
 export * from './renderableMediaAsset';
+export * from './renderableMediaAssetAdmission';
 export * from './contentMediaAudit';
 export * from './contentMediaAuditFieldAdapter';
 export * from './contentMediaSnapshotAudit';

package/dist/_dts/media-core/src/media.d.ts

@@ -0,0 +1,406 @@
+import { z } from 'zod';
+import { type MediaTypeDiscriminant } from './mediaKinds';
+export { mediaIdentifierSchema } from './mediaIdentifierSchema';
+export type { MediaIdentifier } from './identifiers';
+export { mediaTypeDiscriminants, type MediaTypeDiscriminant } from './mediaKinds';
+export declare const mediaPosterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    tag: z.ZodLiteral<"media">;
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+}, z.core.$strict>, z.ZodObject<{
+    tag: z.ZodLiteral<"external-src">;
+    src: z.ZodString;
+}, z.core.$strict>], "tag">;
+declare const mediaUsageShape: {
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+};
+declare const mediaBaseSchema: z.ZodObject<{
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare const imageMediaSchema: z.ZodObject<{
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"image">;
+}, z.core.$strict>;
+export declare const videoMediaSchema: z.ZodObject<{
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"video">;
+}, z.core.$strict>;
+type ManagedMediaFields = z.infer<typeof mediaBaseSchema>;
+export type MediaOfType<TType extends MediaTypeDiscriminant> = ManagedMediaFields & {
+    type: TType;
+};
+export type Media = {
+    [TType in MediaTypeDiscriminant]: MediaOfType<TType>;
+}[MediaTypeDiscriminant];
+export declare const mediaSchema: z.ZodType<Media>;
+export declare const persistableMediaSchema: z.ZodType<Media, unknown, z.core.$ZodTypeInternals<Media, unknown>>;
+export declare const externalMediaSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        archive: "archive";
+    }>;
+    src: z.ZodString;
+    identifier: z.ZodOptional<z.ZodNever>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type PersistableMedia = Media;
+export type ExternalMedia = z.infer<typeof externalMediaSchema>;
+export type MediaPoster = z.infer<typeof mediaPosterSchema>;
+export type MediaUsage = z.infer<z.ZodObject<typeof mediaUsageShape>>;
+export declare const assetMediaSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        archive: "archive";
+    }>;
+    asset: z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/src/index").MediaAssetId, string>>;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+        storageBucket: z.ZodString;
+        storagePath: z.ZodString;
+        mimeType: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    identifier: z.ZodOptional<z.ZodNever>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare const runtimeMediaSchema: z.ZodUnion<readonly [z.ZodType<Media, unknown, z.core.$ZodTypeInternals<Media, unknown>>, z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        archive: "archive";
+    }>;
+    src: z.ZodString;
+    identifier: z.ZodOptional<z.ZodNever>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        archive: "archive";
+    }>;
+    asset: z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/src/index").MediaAssetId, string>>;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+        storageBucket: z.ZodString;
+        storagePath: z.ZodString;
+        mimeType: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    identifier: z.ZodOptional<z.ZodNever>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>]>;
+export type AssetMedia = z.infer<typeof assetMediaSchema>;
+export type RuntimeMedia = z.infer<typeof runtimeMediaSchema>;
+export type RuntimeMediaOfType<TType extends MediaTypeDiscriminant> = MediaOfType<TType> | (ExternalMedia & {
+    type: TType;
+}) | (AssetMedia & {
+    type: TType;
+});

package/dist/_dts/media-core/src/mediaIdentifierSchema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+/** Strict stored-reference admission delegates the canonical identifier decision. */
+export declare const mediaIdentifierSchema: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;

package/dist/_dts/media-core/src/mediaKinds.d.ts

@@ -0,0 +1,2 @@
+export declare const mediaTypeDiscriminants: readonly ["image", "video", "audio", "document", "spreadsheet", "archive"];
+export type MediaTypeDiscriminant = (typeof mediaTypeDiscriminants)[number];

package/dist/_dts/media-core/src/mediaUsageProjection.d.ts

@@ -104,7 +104,19 @@ export type ProductFileDownloadMediaUsageLocation = Readonly<{
     productId: string;
     productTitle: string;
 }>;
-export type MediaUsageLocationProjection = PageBlockMediaUsageLocation | EntrySlotBlockMediaUsageLocation | SurfaceSlotBlockMediaUsageLocation | ContentEntryMediaUsageLocation | ProductFileDownloadMediaUsageLocation;
+export type NewsletterTemplateMediaUsageLocation = Readonly<{
+    kind: 'newsletterTemplate';
+    siteId: string;
+    templateId: string;
+    templateName: string;
+}>;
+export type NewsletterCampaignMediaUsageLocation = Readonly<{
+    kind: 'newsletterCampaign';
+    siteId: string;
+    campaignId: string;
+    campaignName: string;
+}>;
+export type MediaUsageLocationProjection = PageBlockMediaUsageLocation | EntrySlotBlockMediaUsageLocation | SurfaceSlotBlockMediaUsageLocation | ContentEntryMediaUsageLocation | ProductFileDownloadMediaUsageLocation | NewsletterTemplateMediaUsageLocation | NewsletterCampaignMediaUsageLocation;
 export type MediaUsageCheckItemProjection = Readonly<{
     assetId: string;
     filename: string | null;

package/dist/_dts/media-core/src/mediaWriteNormalizer.d.ts

@@ -8,11 +8,7 @@ export type NormalizeMediaReferencesForWriteCoreOptions = Readonly<{
     value: unknown;
     resolveMediaAssetsById: (assetIds: readonly string[]) => Promise<readonly MediaIdentifierResolutionRecord[]>;
 }>;
-/**
- * Normalizes CMS media objects to identifier-only persistence. Infrastructure
- * concerns stay behind callbacks so this core workflow can run outside the
- * dashboard app.
- *
- * @mutates options.value (and nested objects) in-place.
+/** Projects explicit write candidates; stored reads never use this conversion.
+ * @mutates options.value in-place only after classification, lookup and validation succeed.
  */
 export declare function normalizeMediaReferencesForWriteCore(options: NormalizeMediaReferencesForWriteCoreOptions): Promise<void>;

package/dist/_dts/media-core/src/portableMediaReferences.d.ts

@@ -1,36 +1,23 @@
-type PortableMediaReferenceSource = 'media-field' | 'rich-text-image';
+import type { MediaIdentifier } from './identifiers';
+import { type ManagedMediaResolution } from './renderableMediaAsset';
 export type PortableMediaReference = Readonly<{
-    kind: 'assetId';
-    assetId: string;
-    location: string;
-    source: PortableMediaReferenceSource;
-} | {
     kind: 'identifier';
-    identifier: string;
+    identifier: MediaIdentifier;
     location: string;
-    source: PortableMediaReferenceSource;
+    source: 'media-field' | 'rich-text-image' | 'media-poster';
 }>;
 export type PortableMediaReferenceSummary = Readonly<{
     references: PortableMediaReference[];
-    assetIds: string[];
-    identifiers: string[];
+    identifiers: MediaIdentifier[];
 }>;
 type PortableMediaLookupAsset = Readonly<{
     id: string;
-    identifier?: string | null;
+    identifier: MediaIdentifier;
 }>;
 type PortableMediaLookup<TAsset extends PortableMediaLookupAsset> = Readonly<{
-    byId: Map<string, TAsset>;
-    byIdentifier: Map<string, TAsset>;
-}>;
-export type PortableMediaResolution<TAsset extends PortableMediaLookupAsset> = Readonly<{
-    kind: 'resolved';
-    reference: PortableMediaReference;
-    asset: TAsset;
-} | {
-    kind: 'missing';
-    reference: PortableMediaReference;
+    byIdentifier: ReadonlyMap<MediaIdentifier, TAsset>;
 }>;
+export type PortableMediaResolution<TAsset extends PortableMediaLookupAsset> = ManagedMediaResolution<PortableMediaReference, TAsset>;
 export declare function summarizePortableMediaReferences(references: readonly PortableMediaReference[]): PortableMediaReferenceSummary;
 export declare function collectPortableMediaReferencesFromContent(content: unknown): PortableMediaReferenceSummary;
 export declare function buildPortableMediaLookup<TAsset extends PortableMediaLookupAsset>(assets: readonly TAsset[]): PortableMediaLookup<TAsset>;

package/dist/_dts/media-core/src/renderableMediaAsset.d.ts

@@ -1,18 +1,32 @@
 import type { MediaAssetId } from '../../core/src/index';
-export type RenderableMediaAsset = Readonly<{
-    id: MediaAssetId;
-    identifier?: string | null;
-    storageBucket?: string;
-    storagePath?: string;
-    width?: number | null;
-    height?: number | null;
-    mimeType?: string;
-}>;
+import type { MediaIdentifier } from './identifiers';
+import type { RenderableMediaAsset } from './renderableMediaAssetAdmission';
+export type { RenderableMediaAsset } from './renderableMediaAssetAdmission';
 export type RenderableMediaAssetIndex = Readonly<{
-    byId: ReadonlyMap<string, RenderableMediaAsset>;
-    byIdentifier: ReadonlyMap<string, RenderableMediaAsset>;
+    byId: ReadonlyMap<MediaAssetId, RenderableMediaAsset>;
+    byIdentifier: ReadonlyMap<MediaIdentifier, RenderableMediaAsset>;
 }>;
-export declare function buildRenderableMediaAssetIndex(assets: readonly RenderableMediaAsset[] | undefined): RenderableMediaAssetIndex | undefined;
-export declare function attachRenderableMediaAssetFields<TMedia extends Readonly<Record<string, unknown>>>(media: TMedia, asset: RenderableMediaAsset): TMedia & RenderableMediaAsset & Readonly<{
-    assetId: MediaAssetId;
+/** Shared identifier indexing for admitted site-scoped projections. */
+export declare function buildMediaIdentifierIndex<TAsset extends Readonly<{
+    identifier: MediaIdentifier;
+}>>(assets: readonly TAsset[]): ReadonlyMap<MediaIdentifier, TAsset>;
+/** Index already admitted projections, including runtime registration updates. */
+export declare function indexRenderableMediaAssets(assets: readonly RenderableMediaAsset[]): (RenderableMediaAssetIndex & Readonly<{
+    assets: readonly RenderableMediaAsset[];
+}>) | undefined;
+export type ManagedMediaResolution<TReference extends Readonly<{
+    identifier: MediaIdentifier;
+}>, TAsset = RenderableMediaAsset> = Readonly<{
+    kind: 'resolved';
+    reference: TReference;
+    asset: TAsset;
+}> | Readonly<{
+    kind: 'missing';
+    reference: TReference;
 }>;
+/** A portable reference never uses an incidental UUID, URL or storage snapshot for identity. */
+export declare function resolveManagedMediaReference<TReference extends Readonly<{
+    identifier: MediaIdentifier;
+}>, TAsset = RenderableMediaAsset>(reference: TReference, index: Readonly<{
+    byIdentifier: ReadonlyMap<MediaIdentifier, TAsset>;
+}> | undefined): ManagedMediaResolution<TReference, TAsset>;

package/dist/_dts/media-core/src/renderableMediaAssetAdmission.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { indexRenderableMediaAssets } from './renderableMediaAsset';
+export declare const renderableMediaAssetSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/src/index").MediaAssetId, string>>;
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    storageBucket: z.ZodString;
+    storagePath: z.ZodString;
+    mimeType: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodNullable<z.ZodNumber>;
+    height: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type RenderableMediaAsset = Readonly<z.infer<typeof renderableMediaAssetSchema>>;
+/** Admission precedes the identifier-only runtime resolution decision. */
+export declare function buildRenderableMediaAssetIndex(assets: readonly unknown[] | undefined): ReturnType<typeof indexRenderableMediaAssets>;

package/dist/_dts/media-core/src/storageObjectKey.d.ts

@@ -0,0 +1,12 @@
+import { type Result, type StoragePath } from '../../core/src/index';
+declare const writableStoragePathBrand: unique symbol;
+/** An exact key admitted for a write; readable paths have a different contract. */
+export type WritableStoragePath = StoragePath & {
+    readonly [writableStoragePathBrand]: true;
+};
+export type WritableStoragePathError = 'unsafe-path-segment' | 'unsupported-storage-character';
+/** Validate without trimming or rewriting: supplied keys are object identities. */
+export declare function parseWritableStoragePath(value: unknown): Result<WritableStoragePath, WritableStoragePathError>;
+/** Choose a new internal filename; never use this to rewrite an existing key. */
+export declare function storageObjectFilename(filename: string, maxLength?: 120 | 255): string;
+export {};