@wildo-ai/zod-decorators 1.1.1 → 1.1.3

package/dist/esm/zod-file.d.ts

@@ -71,6 +71,36 @@ export declare function resolveMimeTypes(allowedMimeTypes: string[] | FileMimeTy
  *
  * Creates a file schema with metadata for detection and form component rendering.
  *
+ * ## Where a file field may be declared
+ *
+ * **The resource's primary scope must be application, organization or user.** A resource scoped to
+ * an ANONYMOUS visitor cannot carry a file field — a file's own scope is one of those three, so
+ * there is nothing to attribute the bytes to, and the upload refuses that scope by name rather than
+ * pretending to support it.
+ *
+ * **Within the schema, a file field may nest inside objects, arrays and DISCRIMINATED unions.** It
+ * may NOT sit inside a record, a map, a set, a tuple, or a plain (non-discriminated) union — the
+ * walker that finds file fields refuses those shapes. Where variants are needed, use a discriminated
+ * union.
+ *
+ * **A field carried on several branches of a discriminated union must declare IDENTICAL options on
+ * every branch.** Differing options at one path are a conflict the framework refuses rather than
+ * choosing between, so a branch that quietly widens `maxSize` or changes `allowedMimeTypes` fails
+ * the schema instead of silently winning.
+ *
+ * ## Uploading is not attaching
+ *
+ * The generated upload route creates a FILE ROW. Attaching it to a business record is that record's
+ * own write, with its own authority. So an uploaded-but-never-submitted file is a real state a
+ * caller can produce; the cleanup sweep is what handles it.
+ *
+ * ## Declaring `imageConstraints.aspectRatio` turns the cropper on
+ *
+ * That option is the switch for the browser-side crop step — nothing else is wired. It applies to
+ * single-file fields only: a `multiple` field keeps the plain upload path. Vector images and
+ * formats the browser cannot decode bypass the cropper and upload the original, so the server-side
+ * constraint stays the authority.
+ *
  * @param options - Configuration options for file field
  * @returns A Zod object schema with metadata for file detection
  */

package/dist/esm/zod-file.d.ts.map

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

package/dist/esm/zod-file.js

@@ -131,6 +131,36 @@ function assertGeneratedPdfFileOptions(params) {
  *
  * Creates a file schema with metadata for detection and form component rendering.
  *
+ * ## Where a file field may be declared
+ *
+ * **The resource's primary scope must be application, organization or user.** A resource scoped to
+ * an ANONYMOUS visitor cannot carry a file field — a file's own scope is one of those three, so
+ * there is nothing to attribute the bytes to, and the upload refuses that scope by name rather than
+ * pretending to support it.
+ *
+ * **Within the schema, a file field may nest inside objects, arrays and DISCRIMINATED unions.** It
+ * may NOT sit inside a record, a map, a set, a tuple, or a plain (non-discriminated) union — the
+ * walker that finds file fields refuses those shapes. Where variants are needed, use a discriminated
+ * union.
+ *
+ * **A field carried on several branches of a discriminated union must declare IDENTICAL options on
+ * every branch.** Differing options at one path are a conflict the framework refuses rather than
+ * choosing between, so a branch that quietly widens `maxSize` or changes `allowedMimeTypes` fails
+ * the schema instead of silently winning.
+ *
+ * ## Uploading is not attaching
+ *
+ * The generated upload route creates a FILE ROW. Attaching it to a business record is that record's
+ * own write, with its own authority. So an uploaded-but-never-submitted file is a real state a
+ * caller can produce; the cleanup sweep is what handles it.
+ *
+ * ## Declaring `imageConstraints.aspectRatio` turns the cropper on
+ *
+ * That option is the switch for the browser-side crop step — nothing else is wired. It applies to
+ * single-file fields only: a `multiple` field keeps the plain upload path. Vector images and
+ * formats the browser cannot decode bypass the cropper and upload the original, so the server-side
+ * constraint stays the authority.
+ *
  * @param options - Configuration options for file field
  * @returns A Zod object schema with metadata for file detection
  */
@@ -157,11 +187,15 @@ export function createFileSchema(options = {}) {
             console.warn('[z_file] filePathBinding.fileName is set on a multiple file field — fileName is ignored for multiple uploads. ' +
                 'Use filePathBinding.multipleFilePolicy.fileNameTemplate instead.');
         }
-        const implicitOrExplicitS3 = !storageAccepted || storageAccepted.includes(FileStorageAccepted.WILDO_MANAGED);
-        const localIncluded = storageAccepted?.includes(FileStorageAccepted.LOCAL_DIRECTORY);
-        if (filePathBinding.includeApplicationId === false && implicitOrExplicitS3 && !localIncluded) {
-            console.warn('[z_file] filePathBinding.includeApplicationId is false with WILDO_MANAGED storage. ' +
-                'S3 keys will not be scoped by applicationId — ensure cross-app collision is acceptable.');
+        // Warned for EVERY provider, not only WILDO_MANAGED. The condition used to exempt a field that
+        // named LOCAL_DIRECTORY, because that provider defaulted to `false` anyway and the warning would
+        // have fired on its own default. Both providers now default to `true` and both honour `false`
+        // identically, so `false` is an explicit opt-out of the tenant-scoped key shape wherever it is
+        // authored — and that is the thing worth saying out loud.
+        if (filePathBinding.includeApplicationId === false) {
+            console.warn('[z_file] filePathBinding.includeApplicationId is false. Storage keys for this field will carry ' +
+                'NO applications/<appId>/files/<resource>/<scope>/<scopeId>/ prefix, so per-tenant listing, ' +
+                'erasure sweeps and prefix-confined credentials cannot address them — ensure that is intended.');
         }
     }
     // Resolve MIME type groups to actual MIME types

package/dist/esm/zod-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"zod-file.js","sourceRoot":"","sources":["../../../src/zod-file.ts"],"names":[],"mappings":"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","sourcesContent":["\n// ============================================================================\n// FILE SCHEMA HELPER\n// ============================================================================\n\n\nimport {\n  DecoratorInput,\n  SCHEMA_METADATA,\n  CustomFieldMetadata,\n  FileSchemaMetadata,\n  FileSchemaOptions,\n  FileMimeTypeGroups,\n  FileMimeTypeGroup,\n  FileNature,\n  FileDisplayNature,\n  FileDisplayPresentation,\n  FileActivationPolicy,\n  type FileActivationConfig,\n  type FileUIDisplayParams,\n  FileStorageAccepted,\n  FileNatureConstraints_Image,\n  FileNatureConstraints_Video,\n  FileNatureConstraints_Audio,\n  FileNatureConstraints_Document,\n  FileGenerationConfig,\n  FileGenerationSource,\n  RagSourceConfiguration,\n  ZodDecorator,\n  ZodDecorator_ParamsType\n} from \"./zod-decorators.types\";\nimport { z } from \"zod\";\nimport { addChainableMethods, addDecorators } from \"./zod.module-override\";\nimport { UnifiedFileFormatRegistry } from \"./files/unified-registry\";\n\n// Minimal console declaration — avoids pulling in 'dom' or '@types/node' into this shared lib\ndeclare const console: { warn(...args: unknown[]): void };\n\n/**\n * Deduplicated warning tracker for unsupported storage providers.\n * Prevents console spam when the same schema is created multiple times (e.g., in tests or HMR).\n */\nconst _warnedStorageProviders = new Set<string>();\nconst _supportedProviders = new Set([FileStorageAccepted.WILDO_MANAGED, FileStorageAccepted.LOCAL_DIRECTORY]);\nconst GENERATED_PDF_MIME_TYPES = ['application/pdf'] as const;\nconst GENERATION_METADATA_KEYS = new Set(['source', 'templateId']);\n\n/**\n * Single file value type - represents a single file reference stored in the database.\n * The actual file is stored in a file storage system, this object references it.\n */\nexport interface SingleFileValue {\n  /** File ID (foreign key to file storage) */\n  fileId: string;\n  /** Last update timestamp */\n  updatedAt: Date;\n\n}\n\n/**\n * Multiple files value type - represents multiple file references stored in the database.\n */\nexport interface MultipleFileValue {\n  /** File IDs (foreign keys to file storage) */\n  fileIds: string[];\n  /** Last update timestamp */\n  updatedAt: Date;\n}\n\n/**\n * File value type - can be single or multiple depending on schema configuration.\n */\nexport type FileValue = SingleFileValue | MultipleFileValue;\n\n/**\n * Zod schema for SingleFileValue.\n */\nexport const SingleFileValueSchema: z.ZodObject<{ fileId: z.ZodString; updatedAt: z.ZodDate }> = z.object({\n  fileId: z.string().min(1),\n  updatedAt: z.date(),\n});\n\n/**\n * Zod schema for MultipleFileValue.\n */\nexport const MultipleFileValueSchema: z.ZodObject<{ fileIds: z.ZodArray<z.ZodString>; updatedAt: z.ZodDate }> = z.object({\n  fileIds: z.array(z.string().min(1)),\n  updatedAt: z.date(),\n});\n\n\n/**\n * Resolve MIME type groups to actual MIME types.\n * Handles both single group names and arrays of groups/MIME types.\n */\nexport function resolveMimeTypes(\n  allowedMimeTypes: string[] | FileMimeTypeGroup | FileMimeTypeGroup[] | undefined\n): string[] | undefined {\n  if (!allowedMimeTypes) return undefined;\n\n  // If it's a single group name\n  if (typeof allowedMimeTypes === 'string') {\n    if (allowedMimeTypes in FileMimeTypeGroups) {\n      return [...FileMimeTypeGroups[allowedMimeTypes as FileMimeTypeGroup]];\n    }\n    // Single MIME type\n    return [allowedMimeTypes];\n  }\n\n  // If it's an array\n  if (Array.isArray(allowedMimeTypes)) {\n    const resolved: string[] = [];\n    for (const item of allowedMimeTypes) {\n      if (item in FileMimeTypeGroups) {\n        // It's a group name\n        resolved.push(...FileMimeTypeGroups[item as FileMimeTypeGroup]);\n      } else {\n        // It's a MIME type\n        resolved.push(item);\n      }\n    }\n    // Remove duplicates\n    return [...new Set(resolved)];\n  }\n\n  return undefined;\n}\n\nfunction assertValidFileGenerationConfig(generation: FileGenerationConfig): void {\n  const rawGeneration = generation as unknown as Record<string, unknown> | undefined;\n  if (!rawGeneration || typeof rawGeneration !== 'object' || Array.isArray(rawGeneration)) {\n    throw new Error('[z_file] generation must be an object.');\n  }\n\n  const extraKeys = Object.keys(rawGeneration).filter((key) => !GENERATION_METADATA_KEYS.has(key));\n  if (extraKeys.length > 0) {\n    throw new Error(\n      `[z_file] generation contains unsupported key(s): ${extraKeys.join(', ')}. ` +\n      'Use only { source: FileGenerationSource.PDF_TEMPLATE, templateId }.'\n    );\n  }\n\n  if (rawGeneration.source !== FileGenerationSource.PDF_TEMPLATE) {\n    throw new Error('[z_file] generation.source must be FileGenerationSource.PDF_TEMPLATE.');\n  }\n\n  if (typeof rawGeneration.templateId !== 'string' || rawGeneration.templateId.trim().length === 0) {\n    throw new Error('[z_file] generation.templateId must be a non-empty string.');\n  }\n}\n\nfunction assertGeneratedPdfFileOptions(params: {\n  generation?: FileGenerationConfig;\n  multiple: boolean;\n  resolvedMimeTypes?: string[];\n  overridable: boolean;\n  ragSource?: RagSourceConfiguration;\n  scanPolicy?: unknown;\n}): void {\n  if (!params.generation) return;\n\n  assertValidFileGenerationConfig(params.generation);\n\n  if (params.multiple) {\n    throw new Error('[z_file] PDF template generation supports single-file fields only.');\n  }\n\n  if (params.overridable === false) {\n    throw new Error('[z_file] PDF template generation requires overridable to remain true so framework REGENERATE can replace the generated file.');\n  }\n\n  // Re-expression of the pre-Phase-0 `rag` refusal against the shared decorator: a PDF-template\n  // output is framework-RENDERED presentation of resource data the corpus can already reach at the\n  // source fields — chunking the rendering would index the same facts twice, keyed to a file the\n  // next REGENERATE silently replaces.\n  if (params.ragSource) {\n    throw new Error('[z_file] PDF template generation cannot be combined with RAG ingestion options.');\n  }\n\n  if (params.scanPolicy) {\n    throw new Error('[z_file] PDF template generation cannot be combined with upload scanPolicy options.');\n  }\n\n  if (\n    params.resolvedMimeTypes !== undefined &&\n    (params.resolvedMimeTypes.length !== 1 || params.resolvedMimeTypes[0] !== GENERATED_PDF_MIME_TYPES[0])\n  ) {\n    throw new Error('[z_file] PDF template generation requires allowedMimeTypes to resolve exactly to application/pdf.');\n  }\n}\n\n/**\n * z_file() - Creates file schemas for file uploads.\n *\n * File values are stored as: { fileId: string, updatedAt: Date }\n * - fileId: Reference to the file in storage (foreign key, indexed)\n * - updatedAt: When the file was last updated\n *\n * @example\n * ```typescript\n * import { z_file } from '@wildo-ai/zod-decorators';\n *\n * const avatar = z_file();\n * const document = z_file({ allowedMimeTypes: 'Documents' });\n * const images = z_file({\n *   allowedMimeTypes: 'Images',\n *   maxSize: 5 * 1024 * 1024, // 5MB\n *   overridable: true\n * });\n *\n * // With decorators (chainable)\n * z_file().fileUI({ edit: { editMode: FileEditMode.DROPZONE } })\n * z_file({ allowedMimeTypes: ['Images', 'PDF'] }).isHidden({ edit: true })\n * ```\n */\n\n/**\n * @wildo_source:part:start zod.decorators.file-schema\n *\n * Creates a file schema with metadata for detection and form component rendering.\n *\n * @param options - Configuration options for file field\n * @returns A Zod object schema with metadata for file detection\n */\nexport function createFileSchema(\n  options: FileSchemaOptions = {}\n): DecoratedFileSchema | DecoratedMultipleFileSchema {\n  const {\n    overridable = true,\n    allowedMimeTypes,\n    maxSize,\n    minSize,\n    multiple = false,\n    maxFiles,\n    nature,\n    storageAccepted,\n    filePathBinding,\n    generation,\n    imageConstraints,\n    videoConstraints,\n    audioConstraints,\n    documentConstraints,\n    ragSource,\n    textExtraction,\n    scanPolicy,\n    onParentDelete = 'cascade',\n    sharable,\n    sharableDefaults,\n  } = options;\n\n  // Warn at schema creation if non-WILDO_MANAGED storage providers are configured (not yet supported)\n  // Uses deduplication to avoid console spam during tests or HMR\n  if (storageAccepted && storageAccepted.some(s => !_supportedProviders.has(s))) {\n    const unsupported = storageAccepted.filter(s => !_supportedProviders.has(s));\n    const warnKey = unsupported.sort().join(',');\n    if (!_warnedStorageProviders.has(warnKey)) {\n      _warnedStorageProviders.add(warnKey);\n      console.warn(\n        `[z_file] storageAccepted contains unsupported providers: ${unsupported.join(', ')}. ` +\n        `Only '${FileStorageAccepted.WILDO_MANAGED}' and '${FileStorageAccepted.LOCAL_DIRECTORY}' are currently implemented. ` +\n        `External storage providers (OneDrive, Google Drive, Dropbox) will be ignored until their integrations are available.`\n      );\n    }\n  }\n\n  if (filePathBinding) {\n    if (filePathBinding.multipleFilePolicy && !multiple) {\n      console.warn(\n        '[z_file] filePathBinding.multipleFilePolicy is set but multiple is false — multipleFilePolicy will be ignored. ' +\n        'Either set multiple: true or remove multipleFilePolicy.'\n      );\n    }\n    if (filePathBinding.fileName && multiple) {\n      console.warn(\n        '[z_file] filePathBinding.fileName is set on a multiple file field — fileName is ignored for multiple uploads. ' +\n        'Use filePathBinding.multipleFilePolicy.fileNameTemplate instead.'\n      );\n    }\n    const implicitOrExplicitS3 = !storageAccepted || storageAccepted.includes(FileStorageAccepted.WILDO_MANAGED);\n    const localIncluded = storageAccepted?.includes(FileStorageAccepted.LOCAL_DIRECTORY);\n    if (filePathBinding.includeApplicationId === false && implicitOrExplicitS3 && !localIncluded) {\n      console.warn(\n        '[z_file] filePathBinding.includeApplicationId is false with WILDO_MANAGED storage. ' +\n        'S3 keys will not be scoped by applicationId — ensure cross-app collision is acceptable.'\n      );\n    }\n  }\n\n  // Resolve MIME type groups to actual MIME types\n  const resolvedMimeTypes = resolveMimeTypes(allowedMimeTypes);\n  assertGeneratedPdfFileOptions({ generation, multiple, resolvedMimeTypes, overridable, ragSource, scanPolicy });\n  const effectiveMimeTypes = generation ? [...GENERATED_PDF_MIME_TYPES] : resolvedMimeTypes;\n\n  // Create the file object schema based on single/multiple\n  const fileSchema = multiple\n    ? z.object({\n        fileIds: z.array(z.string().min(1)),\n        updatedAt: z.date(),\n      })\n    : z.object({\n        fileId: z.string().min(1),\n        updatedAt: z.date(),\n      });\n\n  // No longer stored in metadata — consumers derive accept from allowedMimeTypes via buildAcceptAttribute()\n\n  // Store file metadata in SCHEMA_METADATA.fileConfig\n  const fileMetadata: FileSchemaMetadata = {\n    isFile: true,\n    overridable,\n    ...(effectiveMimeTypes !== undefined && { allowedMimeTypes: effectiveMimeTypes }),\n    ...(maxSize !== undefined && { maxSize }),\n    ...(minSize !== undefined && { minSize }),\n    multiple,\n    ...(maxFiles !== undefined && { maxFiles }),\n    ...(nature !== undefined && { nature }),\n    ...(storageAccepted !== undefined && { storageAccepted }),\n    ...(filePathBinding !== undefined && { filePathBinding }),\n    ...(generation !== undefined && { generation }),\n    ...(imageConstraints !== undefined && { imageConstraints }),\n    ...(videoConstraints !== undefined && { videoConstraints }),\n    ...(audioConstraints !== undefined && { audioConstraints }),\n    ...(documentConstraints !== undefined && { documentConstraints }),\n    // Text-provider config only — the RAG declaration itself is NOT stored here (single source of\n    // truth is the RAG_SOURCE decorator registered below; read it with `getRagSourceConfig`).\n    ...(textExtraction !== undefined && { textExtraction }),\n    ...(scanPolicy !== undefined && { scanPolicy }),\n    onParentDelete,\n    ...(sharable !== undefined && { sharable }),\n    ...(sharableDefaults !== undefined && { sharableDefaults }),\n  };\n\n  // Initialize or extend SCHEMA_METADATA with file config\n  const existingMetadata: CustomFieldMetadata = (fileSchema as any)[SCHEMA_METADATA] || {};\n  (fileSchema as any)[SCHEMA_METADATA] = {\n    ...existingMetadata,\n    fileConfig: fileMetadata,\n  };\n\n  // Add chainable decorator methods to the file schema instance\n  addChainableMethods(fileSchema);\n\n  // Map the file-side `ragSource` option onto the SHARED RAG_SOURCE decorator — the same one\n  // `z.string().ragSource()` registers — so `RagSourceFieldDetection` sees one uniform declaration\n  // regardless of text provider. Registered through `addDecorators` (the escape-hatch door) because\n  // the fluent `.ragSource()` is deliberately not installed on ZodObject; the shared chokepoint\n  // still validates the config and enforces the refused companions identically.\n  if (ragSource !== undefined) {\n    addDecorators(fileSchema, [{ ref: ZodDecorator.RAG_SOURCE, params: ragSource }]);\n  }\n\n  if (multiple) {\n    return fileSchema as unknown as DecoratedMultipleFileSchema;\n  }\n  return fileSchema as unknown as DecoratedFileSchema;\n}\n\n/**\n * File schemas declare NO decorator surface of their own.\n *\n * They used to, via a `FileSchemaDecoratorMethods<TSelf>` mixin that re-declared `isDBIndexed`,\n * `isHidden`, `isNotEditable` and `showWhen` with the return narrowed to the file schema — necessary\n * only because the `ZodObject` module augmentation did not carry them. It now does (2026-08-12), and\n * re-declaring them made both interfaces below fail TS2320: an interface may not extend two types\n * whose same-named member differs, and `TSelf` is not `DecoratedPrimitiveZodType<this>`.\n *\n * Removing the mixin costs nothing, because `DecoratedPrimitiveZodType<T>` is `T & { … }` — an\n * INTERSECTION. `z_file().isHidden()` still returns something assignable to `DecoratedFileSchema`,\n * and the full decorator surface is now available rather than the four this mixin listed.\n */\n\n/**\n * Return type for single file schemas - includes decorator methods.\n * IS_DB_INDEXED will index the fileId field for query optimization.\n *\n * Uses `interface` instead of `type` to allow self-referencing without circular alias errors.\n */\nexport interface DecoratedFileSchema extends z.ZodObject<{\n  fileId: z.ZodString;\n  updatedAt: z.ZodDate;\n}> {}\n\n/**\n * Return type for multiple file schemas - includes decorator methods.\n * IS_DB_INDEXED will index the fileIds array for query optimization.\n *\n * Uses `interface` instead of `type` to allow self-referencing without circular alias errors.\n */\nexport interface DecoratedMultipleFileSchema extends z.ZodObject<{\n  fileIds: z.ZodArray<z.ZodString>;\n  updatedAt: z.ZodDate;\n}> {}\n\n/**\n * Creates a file schema for file uploads with reference storage.\n * Named z_file to indicate it's a Zod helper function exported standalone.\n *\n * Single file values are stored as: { fileId: string, updatedAt: Date }\n * Multiple file values are stored as: { fileIds: string[], updatedAt: Date }\n *\n * @example\n * ```typescript\n * import { z_file } from '@wildo-ai/zod-decorators';\n *\n * // Simple usage - single file, any type\n * z_file()\n *\n * // With MIME type groups (shortcuts)\n * z_file({ allowedMimeTypes: 'Images' })\n * z_file({ allowedMimeTypes: 'PDF' })\n * z_file({ allowedMimeTypes: ['Images', 'Video'] })\n * z_file({ allowedMimeTypes: 'Documents' }) // PDF + Office\n *\n * // With specific MIME types\n * z_file({ allowedMimeTypes: ['image/png', 'image/jpeg'] })\n *\n * // With size constraints\n * z_file({ maxSize: 10 * 1024 * 1024 }) // 10MB max\n *\n * // Multiple files (uses fileIds instead of fileId)\n * z_file({ multiple: true, maxFiles: 5 })\n *\n * // Non-overridable (append-only)\n * z_file({ overridable: false })\n *\n * // RAG corpus source — registers the shared RAG_SOURCE decorator on the returned schema\n * // (chunking config), with the file-side text-provider knobs beside it (OCR opt-in).\n * z_file({ allowedMimeTypes: 'Documents', ragSource: {}, textExtraction: { ocr: true } })\n *\n * // With decorators\n * z_file().fileUI({ edit: { editMode: FileEditMode.DROPZONE } })\n * z_file().isHidden({ display: true })\n * ```\n */\nexport function z_file(options?: FileSchemaOptions): DecoratedFileSchema | DecoratedMultipleFileSchema {\n  return createFileSchema(options);\n}\n/** @wildo_source:part:end zod.decorators.file-schema */\n\n// ============================================================================\n// UTILITY FUNCTIONS\n// ============================================================================\n\n/**\n * Format file size for display.\n */\nexport function formatFileSize(bytes: number): string {\n  if (!Number.isFinite(bytes)) return '—';\n  if (bytes === 0) return '0 B';\n  if (bytes < 0) return '-' + formatFileSize(Math.abs(bytes));\n\n  const units = ['B', 'KB', 'MB', 'GB', 'TB'];\n  const k = 1024;\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${units[i]}`;\n}\n\n/**\n * Build enhanced accept attribute string from MIME types.\n * Includes both MIME types and extensions for better browser compatibility.\n * Format: \"image/*,.jpg,.jpeg,.png\" or \"application/pdf,.pdf\"\n *\n * @param mimeTypes - Array of MIME type strings\n * @returns Accept attribute string with MIME types and extensions\n */\nexport function buildAcceptAttribute(mimeTypes: string[]): string {\n  if (!mimeTypes || mimeTypes.length === 0) return '';\n\n  const parts = new Set<string>();\n  const extensions = new Set<string>();\n\n  for (const mimeType of mimeTypes) {\n    // Add MIME type\n    parts.add(mimeType);\n\n    // Get extensions for this MIME type\n    const mimeExtensions = UnifiedFileFormatRegistry.getExtensions(mimeType);\n    for (const ext of mimeExtensions) {\n      if (ext) {\n        extensions.add(`.${ext}`);\n      }\n    }\n\n    // Also check if it's a wildcard MIME type (e.g., image/*)\n    // In that case, get all extensions for that nature\n    if (mimeType.endsWith('/*')) {\n      const formatType = UnifiedFileFormatRegistry.getFormatTypeFromMimeType(mimeType);\n\n      if (formatType && formatType.type === 'nature') {\n        const natureExtensions = UnifiedFileFormatRegistry.getExtensionsForNature(formatType.nature);\n        for (const ext of natureExtensions) {\n          if (ext) {\n            extensions.add(`.${ext}`);\n          }\n        }\n      }\n    }\n  }\n\n  // Combine MIME types and extensions\n  const allParts = [...parts, ...extensions];\n  return allParts.join(',');\n}\n\n/**\n * Get file extension from filename.\n * Uses UnifiedFileFormatRegistry for consistency.\n */\nexport function getFileExtension(filename: string): string {\n  return UnifiedFileFormatRegistry.getFileExtension(filename);\n}\n\n/**\n * Check if a MIME type is allowed based on allowed types.\n */\nexport function isMimeTypeAllowed(mimeType: string, allowedMimeTypes?: string[]): boolean {\n  if (!allowedMimeTypes || allowedMimeTypes.length === 0) return true;\n\n  // Check exact match\n  if (allowedMimeTypes.includes(mimeType)) return true;\n\n  // Check wildcard match (e.g., \"image/*\")\n  const [type] = mimeType.split('/');\n  if (allowedMimeTypes.includes(`${type}/*`)) return true;\n\n  return false;\n}\n\n/**\n * Get a human-readable description of allowed file types.\n * Uses UnifiedFileFormatRegistry for better format detection.\n */\nexport function getAcceptDescription(allowedMimeTypes?: string[]): string {\n  if (!allowedMimeTypes || allowedMimeTypes.length === 0) return 'All files';\n\n  const types = new Set<string>();\n\n  for (const mime of allowedMimeTypes) {\n    // Use registry to detect format type\n    const formatType = UnifiedFileFormatRegistry.getFormatTypeFromMimeType(mime);\n\n    if (formatType) {\n      if (formatType.type === 'nature') {\n        // Map FileNature to human-readable names\n        const natureNames: Record<string, string> = {\n          [FileNature.IMAGE]: 'Images',\n          [FileNature.VIDEO]: 'Videos',\n          [FileNature.AUDIO]: 'Audio files',\n          [FileNature.PDF]: 'PDF',\n          [FileNature.OFFICE]: 'Office documents',\n          [FileNature.ARCHIVE]: 'Archives',\n        };\n        const name = natureNames[formatType.nature];\n        if (name) {\n          types.add(name);\n          continue;\n        }\n      } else if (formatType.type === 'agent') {\n        // Map agent formats to human-readable names\n        const agentNames: Record<string, string> = {\n          'text': 'Text files',\n          'markdown': 'Markdown',\n          'json': 'JSON',\n          'typescript': 'TypeScript',\n          'typescript_react': 'TypeScript React',\n          'yaml': 'YAML',\n        };\n        const name = agentNames[formatType.format] || formatType.format.replace(/_/g, ' ').replace(/\\b\\w/g, l => l.toUpperCase());\n        types.add(name);\n        continue;\n      }\n    }\n\n    // Fallback: use MIME type patterns\n    if (mime === 'application/pdf') {\n      types.add('PDF');\n    } else if (mime.startsWith('image/')) {\n      types.add('Images');\n    } else if (mime.startsWith('video/')) {\n      types.add('Videos');\n    } else if (mime.startsWith('audio/')) {\n      types.add('Audio');\n    } else if (mime.includes('document') || mime.includes('word') || mime.includes('excel') || mime.includes('powerpoint')) {\n      types.add('Office documents');\n    } else {\n      // Get extension-like description\n      const ext = mime.split('/').pop()?.toUpperCase();\n      if (ext) types.add(ext);\n    }\n  }\n\n  return Array.from(types).join(', ') || 'Selected file types';\n}\n\n/**\n * Get file nature from schema metadata.\n * @param schema - Zod schema (must be a file schema)\n * @returns FileNature or undefined if not set\n */\nexport function getFileNature(schema: z.ZodTypeAny): FileNature | undefined {\n  const metadata = (schema as any)[SCHEMA_METADATA] as CustomFieldMetadata | undefined;\n  return metadata?.fileConfig?.nature;\n}\n\n/**\n * Get storage accepted from schema metadata.\n * @param schema - Zod schema (must be a file schema)\n * @returns Array of FileStorageAccepted or undefined if not set\n */\nexport function getStorageAccepted(schema: z.ZodTypeAny): FileStorageAccepted[] | undefined {\n  const metadata = (schema as any)[SCHEMA_METADATA] as CustomFieldMetadata | undefined;\n  return metadata?.fileConfig?.storageAccepted;\n}\n\n/**\n * Get file constraints from schema metadata.\n * @param schema - Zod schema (must be a file schema)\n * @returns Object with all constraint properties or undefined if not set\n */\nexport function getFileConstraints(schema: z.ZodTypeAny): {\n  imageConstraints?: FileNatureConstraints_Image;\n  videoConstraints?: FileNatureConstraints_Video;\n  audioConstraints?: FileNatureConstraints_Audio;\n  documentConstraints?: FileNatureConstraints_Document;\n} | undefined {\n  const metadata = (schema as any)[SCHEMA_METADATA] as CustomFieldMetadata | undefined;\n  const fileConfig = metadata?.fileConfig;\n  if (!fileConfig) return undefined;\n\n  const hasConstraints =\n    fileConfig.imageConstraints ||\n    fileConfig.videoConstraints ||\n    fileConfig.audioConstraints ||\n    fileConfig.documentConstraints;\n\n  if (!hasConstraints) return undefined;\n\n  return {\n    ...(fileConfig.imageConstraints && { imageConstraints: fileConfig.imageConstraints }),\n    ...(fileConfig.videoConstraints && { videoConstraints: fileConfig.videoConstraints }),\n    ...(fileConfig.audioConstraints && { audioConstraints: fileConfig.audioConstraints }),\n    ...(fileConfig.documentConstraints && { documentConstraints: fileConfig.documentConstraints }),\n  };\n}\n\n// ============================================================================\n// DISPLAY NATURE RESOLUTION\n// ============================================================================\n\n/**\n * Mapping from schema-level `FileNature` to rendering-level `FileDisplayNature`.\n *\n * PDF and OFFICE both render as DOCUMENT.\n * ARCHIVE and ALL are GENERIC (no specialized renderer).\n */\nconst FILE_NATURE_TO_DISPLAY_NATURE: Record<FileNature, FileDisplayNature> = {\n  [FileNature.IMAGE]: FileDisplayNature.IMAGE,\n  [FileNature.VIDEO]: FileDisplayNature.VIDEO,\n  [FileNature.AUDIO]: FileDisplayNature.AUDIO,\n  [FileNature.PDF]: FileDisplayNature.DOCUMENT,\n  [FileNature.OFFICE]: FileDisplayNature.DOCUMENT,\n  [FileNature.ARCHIVE]: FileDisplayNature.GENERIC,\n  [FileNature.ALL]: FileDisplayNature.GENERIC,\n};\n\n/**\n * Detect `FileDisplayNature` from a MIME type string.\n *\n * Used as a fallback when no `FileNature` is declared in schema metadata.\n */\nfunction detectDisplayNatureFromMimeType(mimeType: string): FileDisplayNature {\n  if (mimeType.startsWith('image/')) return FileDisplayNature.IMAGE;\n  if (mimeType.startsWith('video/')) return FileDisplayNature.VIDEO;\n  if (mimeType.startsWith('audio/')) return FileDisplayNature.AUDIO;\n  if (\n    mimeType === 'application/pdf' ||\n    mimeType.includes('document') || mimeType.includes('word') ||\n    mimeType.includes('spreadsheet') || mimeType.includes('excel') ||\n    mimeType.includes('presentation') || mimeType.includes('powerpoint')\n  ) return FileDisplayNature.DOCUMENT;\n  return FileDisplayNature.GENERIC;\n}\n\n/**\n * Resolve the rendering-level display nature for a file.\n *\n * Resolution priority:\n * 1. `schemaNature` (from `z_file({ nature: ... })` metadata) → mapped via `FILE_NATURE_TO_DISPLAY_NATURE`\n * 2. `mimeType` (from file metadata or browser File object) → detected via MIME prefix matching\n * 3. `FileDisplayNature.GENERIC` (fallback)\n *\n * @param schemaNature - The `FileNature` declared in schema metadata (from `getFileMetadata(schema)?.nature`)\n * @param mimeType - The MIME type of the actual file\n * @returns The `FileDisplayNature` to use for rendering\n *\n * @example\n * ```typescript\n * const displayNature = resolveFileDisplayNature(fileSchemaMetadata?.nature, metadata.mimeType)\n * // FileDisplayNature.IMAGE | .VIDEO | .AUDIO | .DOCUMENT | .GENERIC\n * ```\n */\nexport function resolveFileDisplayNature(\n  schemaNature?: FileNature,\n  mimeType?: string,\n): FileDisplayNature {\n  // Priority 1: Schema-declared nature\n  if (schemaNature) {\n    return FILE_NATURE_TO_DISPLAY_NATURE[schemaNature] ?? FileDisplayNature.GENERIC;\n  }\n  // Priority 2: MIME type detection\n  if (mimeType) {\n    return detectDisplayNatureFromMimeType(mimeType);\n  }\n  // Priority 3: Fallback\n  return FileDisplayNature.GENERIC;\n}\n\n// ============================================================================\n// DISPLAY POLICY RESOLUTION (presentation × activation, + the availability guard)\n// ============================================================================\n\n/**\n * Whether the engine can RENDER a file of this nature/MIME (i.e. whether\n * `THUMBNAIL` / `FULL` presentation and `OVERLAY` activation are satisfiable).\n *\n * Nature alone is not always enough: `DOCUMENT` covers PDF *and* Office, and only\n * PDF has a viewer — so the MIME decides when it is known. Extend this (and only\n * this) when a new displayer ships; every guard tier reads it, so availability can\n * never drift between the static and runtime answers.\n */\nexport function fileNatureHasDisplayer(\n  displayNature: FileDisplayNature,\n  mimeType?: string,\n): boolean {\n  switch (displayNature) {\n    case FileDisplayNature.IMAGE:\n    case FileDisplayNature.VIDEO:\n    case FileDisplayNature.AUDIO:\n      return true;\n    case FileDisplayNature.DOCUMENT:\n      // PDF renders (PDF.js); Office documents have no viewer yet. With no MIME\n      // known (the static tier on a declared PDF nature) the answer is yes,\n      // because `FileNature.PDF` maps here only for PDFs.\n      return mimeType === undefined || mimeType === 'application/pdf';\n    case FileDisplayNature.GENERIC:\n      return false;\n  }\n}\n\n/**\n * Whether a DECLARED schema nature can satisfy a display-requiring policy, decided\n * WITHOUT a MIME type. This is the static (registry-build) tier of the guard.\n *\n * Returns `undefined` for `FileNature.ALL` — genuinely undecidable before the file\n * exists, so the static tier must admit it and the runtime tier decides. Any other\n * nature yields a definite answer, which is what lets a misauthored\n * `ARCHIVE` + `FULL` fail at build instead of rendering nothing at runtime.\n */\nexport function declaredFileNatureCanDisplay(schemaNature: FileNature): boolean | undefined {\n  if (schemaNature === FileNature.ALL) return undefined;\n  return fileNatureHasDisplayer(FILE_NATURE_TO_DISPLAY_NATURE[schemaNature] ?? FileDisplayNature.GENERIC);\n}\n\n/** Outcome of {@link resolveFileDisplayPolicy}. */\nexport interface ResolvedFileDisplayPolicy {\n  /** Effective resting presentation after the availability guard. */\n  presentation: FileDisplayPresentation;\n  /** Effective activation after the availability guard. */\n  activation: FileActivationConfig;\n  /** The nature the effective policy was resolved against. */\n  displayNature: FileDisplayNature;\n  /** True when the authored policy could not be satisfied and was degraded. */\n  degraded: boolean;\n  /** Human-readable cause, for the dev-only warning. Set iff `degraded`. */\n  degradationReason?: string;\n}\n\n/**\n * Resolve the effective file display policy — the RUNTIME tier of the guard.\n *\n * Defaults, when nothing is authored: `CARD` presentation, and an activation derived\n * from the nature (`OVERLAY` when a displayer exists, `DOWNLOAD` otherwise) — so a\n * file is always useful without any authoring, and a document does not mount a\n * viewer just by being on the page.\n *\n * Degradation is deterministic, never a crash and never a dead control:\n * `FULL`/`THUMBNAIL` → `CARD`, `OVERLAY` → `DOWNLOAD`. It only fires when the file's\n * actual nature has no displayer — which is only reachable when the schema declared\n * an open nature (`FileNature.ALL`), because a narrow declared nature that cannot\n * display was already refused at registry build.\n *\n * `CUSTOM` is never degraded: it targets an operation, not a displayer, so displayer\n * availability is irrelevant to it.\n */\nexport function resolveFileDisplayPolicy(params: {\n  schemaNature?: FileNature;\n  mimeType?: string;\n  authored?: FileUIDisplayParams;\n}): ResolvedFileDisplayPolicy {\n  const { schemaNature, mimeType, authored } = params;\n  const displayNature = resolveFileDisplayNature(schemaNature, mimeType);\n  const hasDisplayer = fileNatureHasDisplayer(displayNature, mimeType);\n\n  const requestedPresentation = authored?.presentation ?? FileDisplayPresentation.CARD;\n  const requestedActivation: FileActivationConfig = authored?.activation ?? {\n    policy: hasDisplayer ? FileActivationPolicy.OVERLAY : FileActivationPolicy.DOWNLOAD,\n  };\n\n  const presentationNeedsDisplayer = requestedPresentation !== FileDisplayPresentation.CARD;\n  const activationNeedsDisplayer = requestedActivation.policy === FileActivationPolicy.OVERLAY;\n\n  if (hasDisplayer || (!presentationNeedsDisplayer && !activationNeedsDisplayer)) {\n    return { presentation: requestedPresentation, activation: requestedActivation, displayNature, degraded: false };\n  }\n\n  return {\n    presentation: presentationNeedsDisplayer ? FileDisplayPresentation.CARD : requestedPresentation,\n    activation: activationNeedsDisplayer ? { policy: FileActivationPolicy.DOWNLOAD } : requestedActivation,\n    displayNature,\n    degraded: true,\n    degradationReason:\n      `no displayer for ${displayNature}${mimeType ? ` (${mimeType})` : ''}: `\n      + `${presentationNeedsDisplayer ? `presentation ${requestedPresentation} → card` : ''}`\n      + `${presentationNeedsDisplayer && activationNeedsDisplayer ? ', ' : ''}`\n      + `${activationNeedsDisplayer ? 'activation overlay → download' : ''}`,\n  };\n}\n"]}
+{"version":3,"file":"zod-file.js","sourceRoot":"","sources":["../../../src/zod-file.ts"],"names":[],"mappings":"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","sourcesContent":["\n// ============================================================================\n// FILE SCHEMA HELPER\n// ============================================================================\n\n\nimport {\n  DecoratorInput,\n  SCHEMA_METADATA,\n  CustomFieldMetadata,\n  FileSchemaMetadata,\n  FileSchemaOptions,\n  FileMimeTypeGroups,\n  FileMimeTypeGroup,\n  FileNature,\n  FileDisplayNature,\n  FileDisplayPresentation,\n  FileActivationPolicy,\n  type FileActivationConfig,\n  type FileUIDisplayParams,\n  FileStorageAccepted,\n  FileNatureConstraints_Image,\n  FileNatureConstraints_Video,\n  FileNatureConstraints_Audio,\n  FileNatureConstraints_Document,\n  FileGenerationConfig,\n  FileGenerationSource,\n  RagSourceConfiguration,\n  ZodDecorator,\n  ZodDecorator_ParamsType\n} from \"./zod-decorators.types\";\nimport { z } from \"zod\";\nimport { addChainableMethods, addDecorators } from \"./zod.module-override\";\nimport { UnifiedFileFormatRegistry } from \"./files/unified-registry\";\n\n// Minimal console declaration — avoids pulling in 'dom' or '@types/node' into this shared lib\ndeclare const console: { warn(...args: unknown[]): void };\n\n/**\n * Deduplicated warning tracker for unsupported storage providers.\n * Prevents console spam when the same schema is created multiple times (e.g., in tests or HMR).\n */\nconst _warnedStorageProviders = new Set<string>();\nconst _supportedProviders = new Set([FileStorageAccepted.WILDO_MANAGED, FileStorageAccepted.LOCAL_DIRECTORY]);\nconst GENERATED_PDF_MIME_TYPES = ['application/pdf'] as const;\nconst GENERATION_METADATA_KEYS = new Set(['source', 'templateId']);\n\n/**\n * Single file value type - represents a single file reference stored in the database.\n * The actual file is stored in a file storage system, this object references it.\n */\nexport interface SingleFileValue {\n  /** File ID (foreign key to file storage) */\n  fileId: string;\n  /** Last update timestamp */\n  updatedAt: Date;\n\n}\n\n/**\n * Multiple files value type - represents multiple file references stored in the database.\n */\nexport interface MultipleFileValue {\n  /** File IDs (foreign keys to file storage) */\n  fileIds: string[];\n  /** Last update timestamp */\n  updatedAt: Date;\n}\n\n/**\n * File value type - can be single or multiple depending on schema configuration.\n */\nexport type FileValue = SingleFileValue | MultipleFileValue;\n\n/**\n * Zod schema for SingleFileValue.\n */\nexport const SingleFileValueSchema: z.ZodObject<{ fileId: z.ZodString; updatedAt: z.ZodDate }> = z.object({\n  fileId: z.string().min(1),\n  updatedAt: z.date(),\n});\n\n/**\n * Zod schema for MultipleFileValue.\n */\nexport const MultipleFileValueSchema: z.ZodObject<{ fileIds: z.ZodArray<z.ZodString>; updatedAt: z.ZodDate }> = z.object({\n  fileIds: z.array(z.string().min(1)),\n  updatedAt: z.date(),\n});\n\n\n/**\n * Resolve MIME type groups to actual MIME types.\n * Handles both single group names and arrays of groups/MIME types.\n */\nexport function resolveMimeTypes(\n  allowedMimeTypes: string[] | FileMimeTypeGroup | FileMimeTypeGroup[] | undefined\n): string[] | undefined {\n  if (!allowedMimeTypes) return undefined;\n\n  // If it's a single group name\n  if (typeof allowedMimeTypes === 'string') {\n    if (allowedMimeTypes in FileMimeTypeGroups) {\n      return [...FileMimeTypeGroups[allowedMimeTypes as FileMimeTypeGroup]];\n    }\n    // Single MIME type\n    return [allowedMimeTypes];\n  }\n\n  // If it's an array\n  if (Array.isArray(allowedMimeTypes)) {\n    const resolved: string[] = [];\n    for (const item of allowedMimeTypes) {\n      if (item in FileMimeTypeGroups) {\n        // It's a group name\n        resolved.push(...FileMimeTypeGroups[item as FileMimeTypeGroup]);\n      } else {\n        // It's a MIME type\n        resolved.push(item);\n      }\n    }\n    // Remove duplicates\n    return [...new Set(resolved)];\n  }\n\n  return undefined;\n}\n\nfunction assertValidFileGenerationConfig(generation: FileGenerationConfig): void {\n  const rawGeneration = generation as unknown as Record<string, unknown> | undefined;\n  if (!rawGeneration || typeof rawGeneration !== 'object' || Array.isArray(rawGeneration)) {\n    throw new Error('[z_file] generation must be an object.');\n  }\n\n  const extraKeys = Object.keys(rawGeneration).filter((key) => !GENERATION_METADATA_KEYS.has(key));\n  if (extraKeys.length > 0) {\n    throw new Error(\n      `[z_file] generation contains unsupported key(s): ${extraKeys.join(', ')}. ` +\n      'Use only { source: FileGenerationSource.PDF_TEMPLATE, templateId }.'\n    );\n  }\n\n  if (rawGeneration.source !== FileGenerationSource.PDF_TEMPLATE) {\n    throw new Error('[z_file] generation.source must be FileGenerationSource.PDF_TEMPLATE.');\n  }\n\n  if (typeof rawGeneration.templateId !== 'string' || rawGeneration.templateId.trim().length === 0) {\n    throw new Error('[z_file] generation.templateId must be a non-empty string.');\n  }\n}\n\nfunction assertGeneratedPdfFileOptions(params: {\n  generation?: FileGenerationConfig;\n  multiple: boolean;\n  resolvedMimeTypes?: string[];\n  overridable: boolean;\n  ragSource?: RagSourceConfiguration;\n  scanPolicy?: unknown;\n}): void {\n  if (!params.generation) return;\n\n  assertValidFileGenerationConfig(params.generation);\n\n  if (params.multiple) {\n    throw new Error('[z_file] PDF template generation supports single-file fields only.');\n  }\n\n  if (params.overridable === false) {\n    throw new Error('[z_file] PDF template generation requires overridable to remain true so framework REGENERATE can replace the generated file.');\n  }\n\n  // Re-expression of the pre-Phase-0 `rag` refusal against the shared decorator: a PDF-template\n  // output is framework-RENDERED presentation of resource data the corpus can already reach at the\n  // source fields — chunking the rendering would index the same facts twice, keyed to a file the\n  // next REGENERATE silently replaces.\n  if (params.ragSource) {\n    throw new Error('[z_file] PDF template generation cannot be combined with RAG ingestion options.');\n  }\n\n  if (params.scanPolicy) {\n    throw new Error('[z_file] PDF template generation cannot be combined with upload scanPolicy options.');\n  }\n\n  if (\n    params.resolvedMimeTypes !== undefined &&\n    (params.resolvedMimeTypes.length !== 1 || params.resolvedMimeTypes[0] !== GENERATED_PDF_MIME_TYPES[0])\n  ) {\n    throw new Error('[z_file] PDF template generation requires allowedMimeTypes to resolve exactly to application/pdf.');\n  }\n}\n\n/**\n * z_file() - Creates file schemas for file uploads.\n *\n * File values are stored as: { fileId: string, updatedAt: Date }\n * - fileId: Reference to the file in storage (foreign key, indexed)\n * - updatedAt: When the file was last updated\n *\n * @example\n * ```typescript\n * import { z_file } from '@wildo-ai/zod-decorators';\n *\n * const avatar = z_file();\n * const document = z_file({ allowedMimeTypes: 'Documents' });\n * const images = z_file({\n *   allowedMimeTypes: 'Images',\n *   maxSize: 5 * 1024 * 1024, // 5MB\n *   overridable: true\n * });\n *\n * // With decorators (chainable)\n * z_file().fileUI({ edit: { editMode: FileEditMode.DROPZONE } })\n * z_file({ allowedMimeTypes: ['Images', 'PDF'] }).isHidden({ edit: true })\n * ```\n */\n\n/**\n * @wildo_source:part:start zod.decorators.file-schema\n *\n * Creates a file schema with metadata for detection and form component rendering.\n *\n * ## Where a file field may be declared\n *\n * **The resource's primary scope must be application, organization or user.** A resource scoped to\n * an ANONYMOUS visitor cannot carry a file field — a file's own scope is one of those three, so\n * there is nothing to attribute the bytes to, and the upload refuses that scope by name rather than\n * pretending to support it.\n *\n * **Within the schema, a file field may nest inside objects, arrays and DISCRIMINATED unions.** It\n * may NOT sit inside a record, a map, a set, a tuple, or a plain (non-discriminated) union — the\n * walker that finds file fields refuses those shapes. Where variants are needed, use a discriminated\n * union.\n *\n * **A field carried on several branches of a discriminated union must declare IDENTICAL options on\n * every branch.** Differing options at one path are a conflict the framework refuses rather than\n * choosing between, so a branch that quietly widens `maxSize` or changes `allowedMimeTypes` fails\n * the schema instead of silently winning.\n *\n * ## Uploading is not attaching\n *\n * The generated upload route creates a FILE ROW. Attaching it to a business record is that record's\n * own write, with its own authority. So an uploaded-but-never-submitted file is a real state a\n * caller can produce; the cleanup sweep is what handles it.\n *\n * ## Declaring `imageConstraints.aspectRatio` turns the cropper on\n *\n * That option is the switch for the browser-side crop step — nothing else is wired. It applies to\n * single-file fields only: a `multiple` field keeps the plain upload path. Vector images and\n * formats the browser cannot decode bypass the cropper and upload the original, so the server-side\n * constraint stays the authority.\n *\n * @param options - Configuration options for file field\n * @returns A Zod object schema with metadata for file detection\n */\nexport function createFileSchema(\n  options: FileSchemaOptions = {}\n): DecoratedFileSchema | DecoratedMultipleFileSchema {\n  const {\n    overridable = true,\n    allowedMimeTypes,\n    maxSize,\n    minSize,\n    multiple = false,\n    maxFiles,\n    nature,\n    storageAccepted,\n    filePathBinding,\n    generation,\n    imageConstraints,\n    videoConstraints,\n    audioConstraints,\n    documentConstraints,\n    ragSource,\n    textExtraction,\n    scanPolicy,\n    onParentDelete = 'cascade',\n    sharable,\n    sharableDefaults,\n  } = options;\n\n  // Warn at schema creation if non-WILDO_MANAGED storage providers are configured (not yet supported)\n  // Uses deduplication to avoid console spam during tests or HMR\n  if (storageAccepted && storageAccepted.some(s => !_supportedProviders.has(s))) {\n    const unsupported = storageAccepted.filter(s => !_supportedProviders.has(s));\n    const warnKey = unsupported.sort().join(',');\n    if (!_warnedStorageProviders.has(warnKey)) {\n      _warnedStorageProviders.add(warnKey);\n      console.warn(\n        `[z_file] storageAccepted contains unsupported providers: ${unsupported.join(', ')}. ` +\n        `Only '${FileStorageAccepted.WILDO_MANAGED}' and '${FileStorageAccepted.LOCAL_DIRECTORY}' are currently implemented. ` +\n        `External storage providers (OneDrive, Google Drive, Dropbox) will be ignored until their integrations are available.`\n      );\n    }\n  }\n\n  if (filePathBinding) {\n    if (filePathBinding.multipleFilePolicy && !multiple) {\n      console.warn(\n        '[z_file] filePathBinding.multipleFilePolicy is set but multiple is false — multipleFilePolicy will be ignored. ' +\n        'Either set multiple: true or remove multipleFilePolicy.'\n      );\n    }\n    if (filePathBinding.fileName && multiple) {\n      console.warn(\n        '[z_file] filePathBinding.fileName is set on a multiple file field — fileName is ignored for multiple uploads. ' +\n        'Use filePathBinding.multipleFilePolicy.fileNameTemplate instead.'\n      );\n    }\n    // Warned for EVERY provider, not only WILDO_MANAGED. The condition used to exempt a field that\n    // named LOCAL_DIRECTORY, because that provider defaulted to `false` anyway and the warning would\n    // have fired on its own default. Both providers now default to `true` and both honour `false`\n    // identically, so `false` is an explicit opt-out of the tenant-scoped key shape wherever it is\n    // authored — and that is the thing worth saying out loud.\n    if (filePathBinding.includeApplicationId === false) {\n      console.warn(\n        '[z_file] filePathBinding.includeApplicationId is false. Storage keys for this field will carry ' +\n        'NO applications/<appId>/files/<resource>/<scope>/<scopeId>/ prefix, so per-tenant listing, ' +\n        'erasure sweeps and prefix-confined credentials cannot address them — ensure that is intended.'\n      );\n    }\n  }\n\n  // Resolve MIME type groups to actual MIME types\n  const resolvedMimeTypes = resolveMimeTypes(allowedMimeTypes);\n  assertGeneratedPdfFileOptions({ generation, multiple, resolvedMimeTypes, overridable, ragSource, scanPolicy });\n  const effectiveMimeTypes = generation ? [...GENERATED_PDF_MIME_TYPES] : resolvedMimeTypes;\n\n  // Create the file object schema based on single/multiple\n  const fileSchema = multiple\n    ? z.object({\n        fileIds: z.array(z.string().min(1)),\n        updatedAt: z.date(),\n      })\n    : z.object({\n        fileId: z.string().min(1),\n        updatedAt: z.date(),\n      });\n\n  // No longer stored in metadata — consumers derive accept from allowedMimeTypes via buildAcceptAttribute()\n\n  // Store file metadata in SCHEMA_METADATA.fileConfig\n  const fileMetadata: FileSchemaMetadata = {\n    isFile: true,\n    overridable,\n    ...(effectiveMimeTypes !== undefined && { allowedMimeTypes: effectiveMimeTypes }),\n    ...(maxSize !== undefined && { maxSize }),\n    ...(minSize !== undefined && { minSize }),\n    multiple,\n    ...(maxFiles !== undefined && { maxFiles }),\n    ...(nature !== undefined && { nature }),\n    ...(storageAccepted !== undefined && { storageAccepted }),\n    ...(filePathBinding !== undefined && { filePathBinding }),\n    ...(generation !== undefined && { generation }),\n    ...(imageConstraints !== undefined && { imageConstraints }),\n    ...(videoConstraints !== undefined && { videoConstraints }),\n    ...(audioConstraints !== undefined && { audioConstraints }),\n    ...(documentConstraints !== undefined && { documentConstraints }),\n    // Text-provider config only — the RAG declaration itself is NOT stored here (single source of\n    // truth is the RAG_SOURCE decorator registered below; read it with `getRagSourceConfig`).\n    ...(textExtraction !== undefined && { textExtraction }),\n    ...(scanPolicy !== undefined && { scanPolicy }),\n    onParentDelete,\n    ...(sharable !== undefined && { sharable }),\n    ...(sharableDefaults !== undefined && { sharableDefaults }),\n  };\n\n  // Initialize or extend SCHEMA_METADATA with file config\n  const existingMetadata: CustomFieldMetadata = (fileSchema as any)[SCHEMA_METADATA] || {};\n  (fileSchema as any)[SCHEMA_METADATA] = {\n    ...existingMetadata,\n    fileConfig: fileMetadata,\n  };\n\n  // Add chainable decorator methods to the file schema instance\n  addChainableMethods(fileSchema);\n\n  // Map the file-side `ragSource` option onto the SHARED RAG_SOURCE decorator — the same one\n  // `z.string().ragSource()` registers — so `RagSourceFieldDetection` sees one uniform declaration\n  // regardless of text provider. Registered through `addDecorators` (the escape-hatch door) because\n  // the fluent `.ragSource()` is deliberately not installed on ZodObject; the shared chokepoint\n  // still validates the config and enforces the refused companions identically.\n  if (ragSource !== undefined) {\n    addDecorators(fileSchema, [{ ref: ZodDecorator.RAG_SOURCE, params: ragSource }]);\n  }\n\n  if (multiple) {\n    return fileSchema as unknown as DecoratedMultipleFileSchema;\n  }\n  return fileSchema as unknown as DecoratedFileSchema;\n}\n\n/**\n * File schemas declare NO decorator surface of their own.\n *\n * They used to, via a `FileSchemaDecoratorMethods<TSelf>` mixin that re-declared `isDBIndexed`,\n * `isHidden`, `isNotEditable` and `showWhen` with the return narrowed to the file schema — necessary\n * only because the `ZodObject` module augmentation did not carry them. It now does (2026-08-12), and\n * re-declaring them made both interfaces below fail TS2320: an interface may not extend two types\n * whose same-named member differs, and `TSelf` is not `DecoratedPrimitiveZodType<this>`.\n *\n * Removing the mixin costs nothing, because `DecoratedPrimitiveZodType<T>` is `T & { … }` — an\n * INTERSECTION. `z_file().isHidden()` still returns something assignable to `DecoratedFileSchema`,\n * and the full decorator surface is now available rather than the four this mixin listed.\n */\n\n/**\n * Return type for single file schemas - includes decorator methods.\n * IS_DB_INDEXED will index the fileId field for query optimization.\n *\n * Uses `interface` instead of `type` to allow self-referencing without circular alias errors.\n */\nexport interface DecoratedFileSchema extends z.ZodObject<{\n  fileId: z.ZodString;\n  updatedAt: z.ZodDate;\n}> {}\n\n/**\n * Return type for multiple file schemas - includes decorator methods.\n * IS_DB_INDEXED will index the fileIds array for query optimization.\n *\n * Uses `interface` instead of `type` to allow self-referencing without circular alias errors.\n */\nexport interface DecoratedMultipleFileSchema extends z.ZodObject<{\n  fileIds: z.ZodArray<z.ZodString>;\n  updatedAt: z.ZodDate;\n}> {}\n\n/**\n * Creates a file schema for file uploads with reference storage.\n * Named z_file to indicate it's a Zod helper function exported standalone.\n *\n * Single file values are stored as: { fileId: string, updatedAt: Date }\n * Multiple file values are stored as: { fileIds: string[], updatedAt: Date }\n *\n * @example\n * ```typescript\n * import { z_file } from '@wildo-ai/zod-decorators';\n *\n * // Simple usage - single file, any type\n * z_file()\n *\n * // With MIME type groups (shortcuts)\n * z_file({ allowedMimeTypes: 'Images' })\n * z_file({ allowedMimeTypes: 'PDF' })\n * z_file({ allowedMimeTypes: ['Images', 'Video'] })\n * z_file({ allowedMimeTypes: 'Documents' }) // PDF + Office\n *\n * // With specific MIME types\n * z_file({ allowedMimeTypes: ['image/png', 'image/jpeg'] })\n *\n * // With size constraints\n * z_file({ maxSize: 10 * 1024 * 1024 }) // 10MB max\n *\n * // Multiple files (uses fileIds instead of fileId)\n * z_file({ multiple: true, maxFiles: 5 })\n *\n * // Non-overridable (append-only)\n * z_file({ overridable: false })\n *\n * // RAG corpus source — registers the shared RAG_SOURCE decorator on the returned schema\n * // (chunking config), with the file-side text-provider knobs beside it (OCR opt-in).\n * z_file({ allowedMimeTypes: 'Documents', ragSource: {}, textExtraction: { ocr: true } })\n *\n * // With decorators\n * z_file().fileUI({ edit: { editMode: FileEditMode.DROPZONE } })\n * z_file().isHidden({ display: true })\n * ```\n */\nexport function z_file(options?: FileSchemaOptions): DecoratedFileSchema | DecoratedMultipleFileSchema {\n  return createFileSchema(options);\n}\n/** @wildo_source:part:end zod.decorators.file-schema */\n\n// ============================================================================\n// UTILITY FUNCTIONS\n// ============================================================================\n\n/**\n * Format file size for display.\n */\nexport function formatFileSize(bytes: number): string {\n  if (!Number.isFinite(bytes)) return '—';\n  if (bytes === 0) return '0 B';\n  if (bytes < 0) return '-' + formatFileSize(Math.abs(bytes));\n\n  const units = ['B', 'KB', 'MB', 'GB', 'TB'];\n  const k = 1024;\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${units[i]}`;\n}\n\n/**\n * Build enhanced accept attribute string from MIME types.\n * Includes both MIME types and extensions for better browser compatibility.\n * Format: \"image/*,.jpg,.jpeg,.png\" or \"application/pdf,.pdf\"\n *\n * @param mimeTypes - Array of MIME type strings\n * @returns Accept attribute string with MIME types and extensions\n */\nexport function buildAcceptAttribute(mimeTypes: string[]): string {\n  if (!mimeTypes || mimeTypes.length === 0) return '';\n\n  const parts = new Set<string>();\n  const extensions = new Set<string>();\n\n  for (const mimeType of mimeTypes) {\n    // Add MIME type\n    parts.add(mimeType);\n\n    // Get extensions for this MIME type\n    const mimeExtensions = UnifiedFileFormatRegistry.getExtensions(mimeType);\n    for (const ext of mimeExtensions) {\n      if (ext) {\n        extensions.add(`.${ext}`);\n      }\n    }\n\n    // Also check if it's a wildcard MIME type (e.g., image/*)\n    // In that case, get all extensions for that nature\n    if (mimeType.endsWith('/*')) {\n      const formatType = UnifiedFileFormatRegistry.getFormatTypeFromMimeType(mimeType);\n\n      if (formatType && formatType.type === 'nature') {\n        const natureExtensions = UnifiedFileFormatRegistry.getExtensionsForNature(formatType.nature);\n        for (const ext of natureExtensions) {\n          if (ext) {\n            extensions.add(`.${ext}`);\n          }\n        }\n      }\n    }\n  }\n\n  // Combine MIME types and extensions\n  const allParts = [...parts, ...extensions];\n  return allParts.join(',');\n}\n\n/**\n * Get file extension from filename.\n * Uses UnifiedFileFormatRegistry for consistency.\n */\nexport function getFileExtension(filename: string): string {\n  return UnifiedFileFormatRegistry.getFileExtension(filename);\n}\n\n/**\n * Check if a MIME type is allowed based on allowed types.\n */\nexport function isMimeTypeAllowed(mimeType: string, allowedMimeTypes?: string[]): boolean {\n  if (!allowedMimeTypes || allowedMimeTypes.length === 0) return true;\n\n  // Check exact match\n  if (allowedMimeTypes.includes(mimeType)) return true;\n\n  // Check wildcard match (e.g., \"image/*\")\n  const [type] = mimeType.split('/');\n  if (allowedMimeTypes.includes(`${type}/*`)) return true;\n\n  return false;\n}\n\n/**\n * Get a human-readable description of allowed file types.\n * Uses UnifiedFileFormatRegistry for better format detection.\n */\nexport function getAcceptDescription(allowedMimeTypes?: string[]): string {\n  if (!allowedMimeTypes || allowedMimeTypes.length === 0) return 'All files';\n\n  const types = new Set<string>();\n\n  for (const mime of allowedMimeTypes) {\n    // Use registry to detect format type\n    const formatType = UnifiedFileFormatRegistry.getFormatTypeFromMimeType(mime);\n\n    if (formatType) {\n      if (formatType.type === 'nature') {\n        // Map FileNature to human-readable names\n        const natureNames: Record<string, string> = {\n          [FileNature.IMAGE]: 'Images',\n          [FileNature.VIDEO]: 'Videos',\n          [FileNature.AUDIO]: 'Audio files',\n          [FileNature.PDF]: 'PDF',\n          [FileNature.OFFICE]: 'Office documents',\n          [FileNature.ARCHIVE]: 'Archives',\n        };\n        const name = natureNames[formatType.nature];\n        if (name) {\n          types.add(name);\n          continue;\n        }\n      } else if (formatType.type === 'agent') {\n        // Map agent formats to human-readable names\n        const agentNames: Record<string, string> = {\n          'text': 'Text files',\n          'markdown': 'Markdown',\n          'json': 'JSON',\n          'typescript': 'TypeScript',\n          'typescript_react': 'TypeScript React',\n          'yaml': 'YAML',\n        };\n        const name = agentNames[formatType.format] || formatType.format.replace(/_/g, ' ').replace(/\\b\\w/g, l => l.toUpperCase());\n        types.add(name);\n        continue;\n      }\n    }\n\n    // Fallback: use MIME type patterns\n    if (mime === 'application/pdf') {\n      types.add('PDF');\n    } else if (mime.startsWith('image/')) {\n      types.add('Images');\n    } else if (mime.startsWith('video/')) {\n      types.add('Videos');\n    } else if (mime.startsWith('audio/')) {\n      types.add('Audio');\n    } else if (mime.includes('document') || mime.includes('word') || mime.includes('excel') || mime.includes('powerpoint')) {\n      types.add('Office documents');\n    } else {\n      // Get extension-like description\n      const ext = mime.split('/').pop()?.toUpperCase();\n      if (ext) types.add(ext);\n    }\n  }\n\n  return Array.from(types).join(', ') || 'Selected file types';\n}\n\n/**\n * Get file nature from schema metadata.\n * @param schema - Zod schema (must be a file schema)\n * @returns FileNature or undefined if not set\n */\nexport function getFileNature(schema: z.ZodTypeAny): FileNature | undefined {\n  const metadata = (schema as any)[SCHEMA_METADATA] as CustomFieldMetadata | undefined;\n  return metadata?.fileConfig?.nature;\n}\n\n/**\n * Get storage accepted from schema metadata.\n * @param schema - Zod schema (must be a file schema)\n * @returns Array of FileStorageAccepted or undefined if not set\n */\nexport function getStorageAccepted(schema: z.ZodTypeAny): FileStorageAccepted[] | undefined {\n  const metadata = (schema as any)[SCHEMA_METADATA] as CustomFieldMetadata | undefined;\n  return metadata?.fileConfig?.storageAccepted;\n}\n\n/**\n * Get file constraints from schema metadata.\n * @param schema - Zod schema (must be a file schema)\n * @returns Object with all constraint properties or undefined if not set\n */\nexport function getFileConstraints(schema: z.ZodTypeAny): {\n  imageConstraints?: FileNatureConstraints_Image;\n  videoConstraints?: FileNatureConstraints_Video;\n  audioConstraints?: FileNatureConstraints_Audio;\n  documentConstraints?: FileNatureConstraints_Document;\n} | undefined {\n  const metadata = (schema as any)[SCHEMA_METADATA] as CustomFieldMetadata | undefined;\n  const fileConfig = metadata?.fileConfig;\n  if (!fileConfig) return undefined;\n\n  const hasConstraints =\n    fileConfig.imageConstraints ||\n    fileConfig.videoConstraints ||\n    fileConfig.audioConstraints ||\n    fileConfig.documentConstraints;\n\n  if (!hasConstraints) return undefined;\n\n  return {\n    ...(fileConfig.imageConstraints && { imageConstraints: fileConfig.imageConstraints }),\n    ...(fileConfig.videoConstraints && { videoConstraints: fileConfig.videoConstraints }),\n    ...(fileConfig.audioConstraints && { audioConstraints: fileConfig.audioConstraints }),\n    ...(fileConfig.documentConstraints && { documentConstraints: fileConfig.documentConstraints }),\n  };\n}\n\n// ============================================================================\n// DISPLAY NATURE RESOLUTION\n// ============================================================================\n\n/**\n * Mapping from schema-level `FileNature` to rendering-level `FileDisplayNature`.\n *\n * PDF and OFFICE both render as DOCUMENT.\n * ARCHIVE and ALL are GENERIC (no specialized renderer).\n */\nconst FILE_NATURE_TO_DISPLAY_NATURE: Record<FileNature, FileDisplayNature> = {\n  [FileNature.IMAGE]: FileDisplayNature.IMAGE,\n  [FileNature.VIDEO]: FileDisplayNature.VIDEO,\n  [FileNature.AUDIO]: FileDisplayNature.AUDIO,\n  [FileNature.PDF]: FileDisplayNature.DOCUMENT,\n  [FileNature.OFFICE]: FileDisplayNature.DOCUMENT,\n  [FileNature.ARCHIVE]: FileDisplayNature.GENERIC,\n  [FileNature.ALL]: FileDisplayNature.GENERIC,\n};\n\n/**\n * Detect `FileDisplayNature` from a MIME type string.\n *\n * Used as a fallback when no `FileNature` is declared in schema metadata.\n */\nfunction detectDisplayNatureFromMimeType(mimeType: string): FileDisplayNature {\n  if (mimeType.startsWith('image/')) return FileDisplayNature.IMAGE;\n  if (mimeType.startsWith('video/')) return FileDisplayNature.VIDEO;\n  if (mimeType.startsWith('audio/')) return FileDisplayNature.AUDIO;\n  if (\n    mimeType === 'application/pdf' ||\n    mimeType.includes('document') || mimeType.includes('word') ||\n    mimeType.includes('spreadsheet') || mimeType.includes('excel') ||\n    mimeType.includes('presentation') || mimeType.includes('powerpoint')\n  ) return FileDisplayNature.DOCUMENT;\n  return FileDisplayNature.GENERIC;\n}\n\n/**\n * Resolve the rendering-level display nature for a file.\n *\n * Resolution priority:\n * 1. `schemaNature` (from `z_file({ nature: ... })` metadata) → mapped via `FILE_NATURE_TO_DISPLAY_NATURE`\n * 2. `mimeType` (from file metadata or browser File object) → detected via MIME prefix matching\n * 3. `FileDisplayNature.GENERIC` (fallback)\n *\n * @param schemaNature - The `FileNature` declared in schema metadata (from `getFileMetadata(schema)?.nature`)\n * @param mimeType - The MIME type of the actual file\n * @returns The `FileDisplayNature` to use for rendering\n *\n * @example\n * ```typescript\n * const displayNature = resolveFileDisplayNature(fileSchemaMetadata?.nature, metadata.mimeType)\n * // FileDisplayNature.IMAGE | .VIDEO | .AUDIO | .DOCUMENT | .GENERIC\n * ```\n */\nexport function resolveFileDisplayNature(\n  schemaNature?: FileNature,\n  mimeType?: string,\n): FileDisplayNature {\n  // Priority 1: Schema-declared nature\n  if (schemaNature) {\n    return FILE_NATURE_TO_DISPLAY_NATURE[schemaNature] ?? FileDisplayNature.GENERIC;\n  }\n  // Priority 2: MIME type detection\n  if (mimeType) {\n    return detectDisplayNatureFromMimeType(mimeType);\n  }\n  // Priority 3: Fallback\n  return FileDisplayNature.GENERIC;\n}\n\n// ============================================================================\n// DISPLAY POLICY RESOLUTION (presentation × activation, + the availability guard)\n// ============================================================================\n\n/**\n * Whether the engine can RENDER a file of this nature/MIME (i.e. whether\n * `THUMBNAIL` / `FULL` presentation and `OVERLAY` activation are satisfiable).\n *\n * Nature alone is not always enough: `DOCUMENT` covers PDF *and* Office, and only\n * PDF has a viewer — so the MIME decides when it is known. Extend this (and only\n * this) when a new displayer ships; every guard tier reads it, so availability can\n * never drift between the static and runtime answers.\n */\nexport function fileNatureHasDisplayer(\n  displayNature: FileDisplayNature,\n  mimeType?: string,\n): boolean {\n  switch (displayNature) {\n    case FileDisplayNature.IMAGE:\n    case FileDisplayNature.VIDEO:\n    case FileDisplayNature.AUDIO:\n      return true;\n    case FileDisplayNature.DOCUMENT:\n      // PDF renders (PDF.js); Office documents have no viewer yet. With no MIME\n      // known (the static tier on a declared PDF nature) the answer is yes,\n      // because `FileNature.PDF` maps here only for PDFs.\n      return mimeType === undefined || mimeType === 'application/pdf';\n    case FileDisplayNature.GENERIC:\n      return false;\n  }\n}\n\n/**\n * Whether a DECLARED schema nature can satisfy a display-requiring policy, decided\n * WITHOUT a MIME type. This is the static (registry-build) tier of the guard.\n *\n * Returns `undefined` for `FileNature.ALL` — genuinely undecidable before the file\n * exists, so the static tier must admit it and the runtime tier decides. Any other\n * nature yields a definite answer, which is what lets a misauthored\n * `ARCHIVE` + `FULL` fail at build instead of rendering nothing at runtime.\n */\nexport function declaredFileNatureCanDisplay(schemaNature: FileNature): boolean | undefined {\n  if (schemaNature === FileNature.ALL) return undefined;\n  return fileNatureHasDisplayer(FILE_NATURE_TO_DISPLAY_NATURE[schemaNature] ?? FileDisplayNature.GENERIC);\n}\n\n/** Outcome of {@link resolveFileDisplayPolicy}. */\nexport interface ResolvedFileDisplayPolicy {\n  /** Effective resting presentation after the availability guard. */\n  presentation: FileDisplayPresentation;\n  /** Effective activation after the availability guard. */\n  activation: FileActivationConfig;\n  /** The nature the effective policy was resolved against. */\n  displayNature: FileDisplayNature;\n  /** True when the authored policy could not be satisfied and was degraded. */\n  degraded: boolean;\n  /** Human-readable cause, for the dev-only warning. Set iff `degraded`. */\n  degradationReason?: string;\n}\n\n/**\n * Resolve the effective file display policy — the RUNTIME tier of the guard.\n *\n * Defaults, when nothing is authored: `CARD` presentation, and an activation derived\n * from the nature (`OVERLAY` when a displayer exists, `DOWNLOAD` otherwise) — so a\n * file is always useful without any authoring, and a document does not mount a\n * viewer just by being on the page.\n *\n * Degradation is deterministic, never a crash and never a dead control:\n * `FULL`/`THUMBNAIL` → `CARD`, `OVERLAY` → `DOWNLOAD`. It only fires when the file's\n * actual nature has no displayer — which is only reachable when the schema declared\n * an open nature (`FileNature.ALL`), because a narrow declared nature that cannot\n * display was already refused at registry build.\n *\n * `CUSTOM` is never degraded: it targets an operation, not a displayer, so displayer\n * availability is irrelevant to it.\n */\nexport function resolveFileDisplayPolicy(params: {\n  schemaNature?: FileNature;\n  mimeType?: string;\n  authored?: FileUIDisplayParams;\n}): ResolvedFileDisplayPolicy {\n  const { schemaNature, mimeType, authored } = params;\n  const displayNature = resolveFileDisplayNature(schemaNature, mimeType);\n  const hasDisplayer = fileNatureHasDisplayer(displayNature, mimeType);\n\n  const requestedPresentation = authored?.presentation ?? FileDisplayPresentation.CARD;\n  const requestedActivation: FileActivationConfig = authored?.activation ?? {\n    policy: hasDisplayer ? FileActivationPolicy.OVERLAY : FileActivationPolicy.DOWNLOAD,\n  };\n\n  const presentationNeedsDisplayer = requestedPresentation !== FileDisplayPresentation.CARD;\n  const activationNeedsDisplayer = requestedActivation.policy === FileActivationPolicy.OVERLAY;\n\n  if (hasDisplayer || (!presentationNeedsDisplayer && !activationNeedsDisplayer)) {\n    return { presentation: requestedPresentation, activation: requestedActivation, displayNature, degraded: false };\n  }\n\n  return {\n    presentation: presentationNeedsDisplayer ? FileDisplayPresentation.CARD : requestedPresentation,\n    activation: activationNeedsDisplayer ? { policy: FileActivationPolicy.DOWNLOAD } : requestedActivation,\n    displayNature,\n    degraded: true,\n    degradationReason:\n      `no displayer for ${displayNature}${mimeType ? ` (${mimeType})` : ''}: `\n      + `${presentationNeedsDisplayer ? `presentation ${requestedPresentation} → card` : ''}`\n      + `${presentationNeedsDisplayer && activationNeedsDisplayer ? ', ' : ''}`\n      + `${activationNeedsDisplayer ? 'activation overlay → download' : ''}`,\n  };\n}\n"]}

package/dist/esm/zod-money.d.ts

@@ -138,6 +138,57 @@ export type DecoratedMoneySchema = z.ZodObject<{
  */
 export declare function z_money(options?: MoneySchemaOptions): DecoratedMoneySchema;
 /** @wildo_source:part:end zod.factories.money */
+/**
+ * Why an amount could not be expressed in its currency's smallest unit.
+ *
+ * A named vocabulary rather than three bare strings, because each member has a DIFFERENT remedy and
+ * an operator reading a sync log needs to know which one they are looking at: an unknown minor unit
+ * is a catalogue problem, a precision loss is an authoring problem, and an unsafe magnitude is a
+ * limit of the provider's own number type.
+ */
+export declare enum MoneyMinorUnitConversionFailure {
+    /** The currency has no minor unit (`XDR`, `XXX`) or is not one this vocabulary knows. */
+    UNKNOWN_MINOR_UNIT = "unknown_minor_unit",
+    /** Converting down would discard a fraction of the provider's smallest unit. */
+    PRECISION_LOSS = "precision_loss",
+    /** The converted amount cannot be represented exactly as a JavaScript number. */
+    UNSAFE_MAGNITUDE = "unsafe_magnitude"
+}
+/** Thrown by {@link toCurrencyMinorUnitAmountOrThrow}; carries the reason so a caller can branch. */
+export declare class MoneyMinorUnitConversionError extends Error {
+    readonly reason: MoneyMinorUnitConversionFailure;
+    constructor(reason: MoneyMinorUnitConversionFailure, message: string);
+}
+/**
+ * Convert a {@link MoneyValue} to the amount a payment provider expects: an integer in the CURRENCY's
+ * smallest unit.
+ *
+ * Wildo stores money at an AUTHORED scale (`decimals` on the value); a provider reads it at the
+ * currency's own scale. Those are two different numbers whenever they disagree, and until 2026-09-08
+ * the billing boundary sent the stored amount straight through — so a price authored at any scale
+ * other than the currency's was charged at the wrong magnitude, by a factor of 10 per decimal place
+ * of disagreement.
+ *
+ * **All arithmetic is `bigint`.** The stored amount already is one, and the whole reason it is a
+ * bigint rather than a number is that money must not round; converting through a float to save a cast
+ * would give that back at exactly the boundary where it costs money.
+ *
+ * **Scaling UP is always exact. Scaling DOWN refuses on a remainder rather than rounding** — a price
+ * of 1.005 in a currency whose smallest unit is a cent is not 1.00 and not 1.01, it is a price the
+ * provider cannot express, and silently picking one is how a catalogue and an invoice come to
+ * disagree by a cent per unit forever.
+ *
+ * **Throws rather than returning a result union**, and the reason is the compiler rather than taste:
+ * this repository compiles with `strict: false` (`engine/tsconfig.common.json`), which disables the
+ * discriminant narrowing a `{ ok: true } | { ok: false }` result depends on — so every caller would
+ * need a cast to read the failure, at every boundary. A typed error narrows by `instanceof`, which
+ * works regardless. Callers that must not throw resolve the scale directly with
+ * `currencyMinorUnitDecimals` and decide for themselves.
+ *
+ * @param subject what the message names ("price p_1 tier 2 flat amount"), so an operator reading a
+ *   sync log knows which amount could not be expressed without opening the catalogue.
+ */
+export declare function toCurrencyMinorUnitAmountOrThrow(value: MoneyValue, subject: string): number;
 /**
  * Convert a decimal amount to bigint representation.
  *

package/dist/esm/zod-money.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod-money.d.ts","sourceRoot":"","sources":["../../../src/zod-money.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"zod-money.d.ts","sourceRoot":"","sources":["../../../src/zod-money.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAA6D,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAClM,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAA6B,MAAM,6BAA6B,CAAC;AAExF;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,SAAS,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,cAAc,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAA;CAAE,CAIxH,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,oBAAoB,CA+CtB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,SAAS,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,QAAQ,EAAE,OAAO,cAAc,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC;CACvB,CAAC,GAAG;IACH,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,oBAAoB,CAAC;IACrD,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,oBAAoB,CAAC;IACzG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IAErH,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IACnF,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;IAC/H,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,CAAC;IAC3D,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,CAAC;IAC3D,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,oBAAoB,CAAC;CACnE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,OAAO,CACrB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,oBAAoB,CAEtB;AACD,iDAAiD;AAMjD;;;;;;;GAOG;AACH,oBAAY,+BAA+B;IACzC,yFAAyF;IACzF,kBAAkB,uBAAuB;IACzC,gFAAgF;IAChF,cAAc,mBAAmB;IACjC,iFAAiF;IACjF,gBAAgB,qBAAqB;CACtC;AAED,qGAAqG;AACrG,qBAAa,6BAA8B,SAAQ,KAAK;aAEpC,MAAM,EAAE,+BAA+B;gBAAvC,MAAM,EAAE,+BAA+B,EACvD,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkC3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAItE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+BzF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgBrG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACtB,GACL,MAAM,CA8BR"}

package/dist/esm/zod-money.js

@@ -4,7 +4,7 @@
 import { SCHEMA_METADATA, ZodDecorator } from "./zod-decorators.types.js";
 import { z } from "zod";
 import { addChainableMethods } from "./zod.module-override.js";
-import { CurrencySchema } from "./currencies.shared.schemas.js";
+import { CurrencySchema, currencyMinorUnitDecimals } from "./currencies.shared.schemas.js";
 /**
  * Zod schema for MoneyValue.
  */
@@ -130,6 +130,86 @@ export function z_money(options) {
 // ============================================================================
 // MONEY UTILITY FUNCTIONS
 // ============================================================================
+/**
+ * Why an amount could not be expressed in its currency's smallest unit.
+ *
+ * A named vocabulary rather than three bare strings, because each member has a DIFFERENT remedy and
+ * an operator reading a sync log needs to know which one they are looking at: an unknown minor unit
+ * is a catalogue problem, a precision loss is an authoring problem, and an unsafe magnitude is a
+ * limit of the provider's own number type.
+ */
+export var MoneyMinorUnitConversionFailure;
+(function (MoneyMinorUnitConversionFailure) {
+    /** The currency has no minor unit (`XDR`, `XXX`) or is not one this vocabulary knows. */
+    MoneyMinorUnitConversionFailure["UNKNOWN_MINOR_UNIT"] = "unknown_minor_unit";
+    /** Converting down would discard a fraction of the provider's smallest unit. */
+    MoneyMinorUnitConversionFailure["PRECISION_LOSS"] = "precision_loss";
+    /** The converted amount cannot be represented exactly as a JavaScript number. */
+    MoneyMinorUnitConversionFailure["UNSAFE_MAGNITUDE"] = "unsafe_magnitude";
+})(MoneyMinorUnitConversionFailure || (MoneyMinorUnitConversionFailure = {}));
+/** Thrown by {@link toCurrencyMinorUnitAmountOrThrow}; carries the reason so a caller can branch. */
+export class MoneyMinorUnitConversionError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.reason = reason;
+        this.name = 'MoneyMinorUnitConversionError';
+    }
+}
+/**
+ * Convert a {@link MoneyValue} to the amount a payment provider expects: an integer in the CURRENCY's
+ * smallest unit.
+ *
+ * Wildo stores money at an AUTHORED scale (`decimals` on the value); a provider reads it at the
+ * currency's own scale. Those are two different numbers whenever they disagree, and until 2026-09-08
+ * the billing boundary sent the stored amount straight through — so a price authored at any scale
+ * other than the currency's was charged at the wrong magnitude, by a factor of 10 per decimal place
+ * of disagreement.
+ *
+ * **All arithmetic is `bigint`.** The stored amount already is one, and the whole reason it is a
+ * bigint rather than a number is that money must not round; converting through a float to save a cast
+ * would give that back at exactly the boundary where it costs money.
+ *
+ * **Scaling UP is always exact. Scaling DOWN refuses on a remainder rather than rounding** — a price
+ * of 1.005 in a currency whose smallest unit is a cent is not 1.00 and not 1.01, it is a price the
+ * provider cannot express, and silently picking one is how a catalogue and an invoice come to
+ * disagree by a cent per unit forever.
+ *
+ * **Throws rather than returning a result union**, and the reason is the compiler rather than taste:
+ * this repository compiles with `strict: false` (`engine/tsconfig.common.json`), which disables the
+ * discriminant narrowing a `{ ok: true } | { ok: false }` result depends on — so every caller would
+ * need a cast to read the failure, at every boundary. A typed error narrows by `instanceof`, which
+ * works regardless. Callers that must not throw resolve the scale directly with
+ * `currencyMinorUnitDecimals` and decide for themselves.
+ *
+ * @param subject what the message names ("price p_1 tier 2 flat amount"), so an operator reading a
+ *   sync log knows which amount could not be expressed without opening the catalogue.
+ */
+export function toCurrencyMinorUnitAmountOrThrow(value, subject) {
+    const target = currencyMinorUnitDecimals(value.currency);
+    if (target === undefined) {
+        throw new MoneyMinorUnitConversionError(MoneyMinorUnitConversionFailure.UNKNOWN_MINOR_UNIT, `Cannot express ${subject} for a payment provider: currency '${value.currency}' has no minor unit this framework can resolve. Cryptocurrencies are in this position deliberately — their decimals are protocol conventions, not a fiat provider's minor unit.`);
+    }
+    let converted;
+    if (value.decimals === target) {
+        converted = value.amount;
+    }
+    else if (value.decimals < target) {
+        converted = value.amount * 10n ** BigInt(target - value.decimals);
+    }
+    else {
+        const divisor = 10n ** BigInt(value.decimals - target);
+        if (value.amount % divisor !== 0n) {
+            throw new MoneyMinorUnitConversionError(MoneyMinorUnitConversionFailure.PRECISION_LOSS, `Cannot express ${subject} for a payment provider: amount ${value.amount} at scale ${value.decimals} cannot be written in ${value.currency}'s smallest unit (scale ${target}) without discarding a fraction of it. Author the amount at scale ${target}, or at a scale whose extra digits are zero.`);
+        }
+        converted = value.amount / divisor;
+    }
+    const asNumber = Number(converted);
+    if (!Number.isSafeInteger(asNumber)) {
+        throw new MoneyMinorUnitConversionError(MoneyMinorUnitConversionFailure.UNSAFE_MAGNITUDE, `Cannot express ${subject} for a payment provider: amount ${converted} in ${value.currency}'s smallest unit exceeds the range a JavaScript number represents exactly, so handing it over would silently change its value.`);
+    }
+    return asNumber;
+}
 /**
  * Convert a decimal amount to bigint representation.
  *