@columnus/shared 0.1.54 → 0.1.56

package/dist/assetFamily.d.ts

@@ -0,0 +1,36 @@
+export declare const ASSET_FAMILIES: readonly ["image", "document", "audio", "video", "vector", "other"];
+export type AssetFamily = (typeof ASSET_FAMILIES)[number];
+/**
+ * Narrow an untyped `family` read off a row. Convex hands asset rows back
+ * untyped — the table is generated per tenant — so a reader that needs the
+ * union has to check it rather than assert it.
+ */
+export declare function isAssetFamily(value: unknown): value is AssetFamily;
+/** Vector types a browser can render in an `<img>`; the rest fall back to an icon. */
+export declare const DISPLAYABLE_VECTOR_CONTENT_TYPES: readonly ["image/svg+xml"];
+/** True when this MIME may be decoded into the G21 rendition graph. */
+export declare function isRasterRenditionSource(contentType: string | undefined): boolean;
+/** `accept` value for a file input restricted to family `vector`. */
+export declare const VECTOR_FILE_ACCEPT = ".svg,.eps,.ai,image/svg+xml,application/postscript,application/illustrator";
+export declare function isVectorContentType(contentType: string | undefined, filename?: string): boolean;
+/**
+ * True when the asset can be shown directly in an `<img>` even though it is
+ * not family `image`: SVG only, so EPS keeps the file icon.
+ */
+export declare function isDisplayableVectorContentType(contentType: string | undefined, filename?: string): boolean;
+/** Derive the stable family used by profiles, graphs, and library filtering. */
+export declare function assetFamilyForContentType(contentType: string | undefined, filename?: string): AssetFamily;
+/**
+ * G20: ExifTool extract runs for `image` and `vector` only. Rendition graphs
+ * are a stricter gate (`assetBuildsRenditions`: raster `image`).
+ */
+export declare function isExtractableFamily(family: AssetFamily | undefined): boolean;
+/**
+ * Library eligibility for an `image` field picker: family `image` plus vector
+ * assets a browser can display. EPS stays reachable from `file` fields only.
+ */
+export declare function isImageFieldPickable(asset: {
+    family?: string;
+    contentType?: string;
+    filename?: string;
+}): boolean;

package/dist/assetFamily.js

@@ -0,0 +1,73 @@
+// packages/@columnus/shared/src/assetFamily.ts
+var ASSET_FAMILIES = ["image", "document", "audio", "video", "vector", "other"];
+var ASSET_FAMILY_SET = new Set(ASSET_FAMILIES);
+function isAssetFamily(value) {
+  return typeof value === "string" && ASSET_FAMILY_SET.has(value);
+}
+var VECTOR_CONTENT_TYPES = /* @__PURE__ */ new Set([
+  "image/svg+xml",
+  "application/postscript",
+  "application/eps",
+  "application/x-eps",
+  "image/eps",
+  "image/x-eps",
+  "application/illustrator",
+  "application/vnd.adobe.illustrator"
+]);
+var DISPLAYABLE_VECTOR_CONTENT_TYPES = ["image/svg+xml"];
+var DISPLAYABLE_VECTOR_CONTENT_TYPE_SET = new Set(
+  DISPLAYABLE_VECTOR_CONTENT_TYPES
+);
+var RASTER_RENDITION_CONTENT_TYPES = /* @__PURE__ */ new Set([
+  "image/jpeg",
+  "image/pjpeg",
+  "image/png",
+  "image/webp",
+  "image/avif",
+  "image/tiff",
+  "image/heic",
+  "image/heif",
+  "image/gif"
+]);
+function isRasterRenditionSource(contentType) {
+  return RASTER_RENDITION_CONTENT_TYPES.has(normalizeContentType(contentType));
+}
+var VECTOR_FILE_ACCEPT = ".svg,.eps,.ai,image/svg+xml,application/postscript,application/illustrator";
+function normalizeContentType(contentType) {
+  return contentType?.split(";")[0]?.trim().toLowerCase() ?? "";
+}
+function hasVectorExtension(filename) {
+  return filename?.trim().toLowerCase().endsWith(".svg") ?? false;
+}
+function isVectorContentType(contentType, filename) {
+  const value = normalizeContentType(contentType);
+  if (!value) return hasVectorExtension(filename);
+  return VECTOR_CONTENT_TYPES.has(value);
+}
+function isDisplayableVectorContentType(contentType, filename) {
+  const value = normalizeContentType(contentType);
+  if (!value) return hasVectorExtension(filename);
+  return DISPLAYABLE_VECTOR_CONTENT_TYPE_SET.has(value);
+}
+function assetFamilyForContentType(contentType, filename) {
+  const value = normalizeContentType(contentType);
+  if (isVectorContentType(contentType, filename)) return "vector";
+  if (value.startsWith("image/")) return "image";
+  if (value.startsWith("audio/")) return "audio";
+  if (value.startsWith("video/")) return "video";
+  if (value === "application/pdf" || value.startsWith("text/") || value.startsWith("application/msword") || value.startsWith("application/vnd.openxmlformats-officedocument") || value.startsWith("application/vnd.oasis.opendocument")) {
+    return "document";
+  }
+  return "other";
+}
+function isExtractableFamily(family) {
+  return family === "image" || family === "vector";
+}
+function isImageFieldPickable(asset) {
+  if (asset.family === "image") return true;
+  return isDisplayableVectorContentType(asset.contentType, asset.filename);
+}
+
+export { ASSET_FAMILIES, DISPLAYABLE_VECTOR_CONTENT_TYPES, VECTOR_FILE_ACCEPT, assetFamilyForContentType, isAssetFamily, isDisplayableVectorContentType, isExtractableFamily, isImageFieldPickable, isRasterRenditionSource, isVectorContentType };
+//# sourceMappingURL=assetFamily.js.map
+//# sourceMappingURL=assetFamily.js.map

package/dist/assetFamily.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/assetFamily.ts"],"names":[],"mappings":";AAKO,IAAM,iBAAiB,CAAC,OAAA,EAAS,YAAY,OAAA,EAAS,OAAA,EAAS,UAAU,OAAO;AAGvF,IAAM,gBAAA,GAAwC,IAAI,GAAA,CAAI,cAAc,CAAA;AAO7D,SAAS,cAAc,KAAA,EAAsC;AAClE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,gBAAA,CAAiB,IAAI,KAAK,CAAA;AAChE;AAMA,IAAM,oBAAA,uBAA2B,GAAA,CAAI;AAAA,EACnC,eAAA;AAAA,EACA,wBAAA;AAAA,EACA,iBAAA;AAAA,EACA,mBAAA;AAAA,EACA,WAAA;AAAA,EACA,aAAA;AAAA,EACA,yBAAA;AAAA,EACA;AACF,CAAC,CAAA;AAGM,IAAM,gCAAA,GAAmC,CAAC,eAAe;AAChE,IAAM,sCAA2D,IAAI,GAAA;AAAA,EACnE;AACF,CAAA;AAQA,IAAM,8BAAA,uBAA0D,GAAA,CAAI;AAAA,EAClE,YAAA;AAAA,EACA,aAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,YAAA;AAAA,EACA,YAAA;AAAA,EACA,YAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF,CAAC,CAAA;AAGM,SAAS,wBAAwB,WAAA,EAA0C;AAChF,EAAA,OAAO,8BAAA,CAA+B,GAAA,CAAI,oBAAA,CAAqB,WAAW,CAAC,CAAA;AAC7E;AAGO,IAAM,kBAAA,GACX;AAEF,SAAS,qBAAqB,WAAA,EAAyC;AACrE,EAAA,OAAO,WAAA,EAAa,MAAM,GAAG,CAAA,CAAE,CAAC,CAAA,EAAG,IAAA,EAAK,CAAE,WAAA,EAAY,IAAK,EAAA;AAC7D;AAGA,SAAS,mBAAmB,QAAA,EAAuC;AACjE,EAAA,OAAO,UAAU,IAAA,EAAK,CAAE,aAAY,CAAE,QAAA,CAAS,MAAM,CAAA,IAAK,KAAA;AAC5D;AAEO,SAAS,mBAAA,CAAoB,aAAiC,QAAA,EAA4B;AAC/F,EAAA,MAAM,KAAA,GAAQ,qBAAqB,WAAW,CAAA;AAC9C,EAAA,IAAI,CAAC,KAAA,EAAO,OAAO,kBAAA,CAAmB,QAAQ,CAAA;AAC9C,EAAA,OAAO,oBAAA,CAAqB,IAAI,KAAK,CAAA;AACvC;AAMO,SAAS,8BAAA,CACd,aACA,QAAA,EACS;AACT,EAAA,MAAM,KAAA,GAAQ,qBAAqB,WAAW,CAAA;AAC9C,EAAA,IAAI,CAAC,KAAA,EAAO,OAAO,kBAAA,CAAmB,QAAQ,CAAA;AAC9C,EAAA,OAAO,mCAAA,CAAoC,IAAI,KAAK,CAAA;AACtD;AAGO,SAAS,yBAAA,CACd,aACA,QAAA,EACa;AACb,EAAA,MAAM,KAAA,GAAQ,qBAAqB,WAAW,CAAA;AAC9C,EAAA,IAAI,mBAAA,CAAoB,WAAA,EAAa,QAAQ,CAAA,EAAG,OAAO,QAAA;AACvD,EAAA,IAAI,KAAA,CAAM,UAAA,CAAW,QAAQ,CAAA,EAAG,OAAO,OAAA;AACvC,EAAA,IAAI,KAAA,CAAM,UAAA,CAAW,QAAQ,CAAA,EAAG,OAAO,OAAA;AACvC,EAAA,IAAI,KAAA,CAAM,UAAA,CAAW,QAAQ,CAAA,EAAG,OAAO,OAAA;AACvC,EAAA,IACE,UAAU,iBAAA,IACV,KAAA,CAAM,UAAA,CAAW,OAAO,KACxB,KAAA,CAAM,UAAA,CAAW,oBAAoB,CAAA,IACrC,MAAM,UAAA,CAAW,+CAA+C,KAChE,KAAA,CAAM,UAAA,CAAW,oCAAoC,CAAA,EACrD;AACA,IAAA,OAAO,UAAA;AAAA,EACT;AACA,EAAA,OAAO,OAAA;AACT;AAMO,SAAS,oBAAoB,MAAA,EAA0C;AAC5E,EAAA,OAAO,MAAA,KAAW,WAAW,MAAA,KAAW,QAAA;AAC1C;AAMO,SAAS,qBAAqB,KAAA,EAIzB;AACV,EAAA,IAAI,KAAA,CAAM,MAAA,KAAW,OAAA,EAAS,OAAO,IAAA;AACrC,EAAA,OAAO,8BAAA,CAA+B,KAAA,CAAM,WAAA,EAAa,KAAA,CAAM,QAAQ,CAAA;AACzE","file":"assetFamily.js","sourcesContent":["// Media family classification shared by the host, the component, Studio, and\n// the generated clients. `vector` was added by 059 S0 (061 grill 2026-08-23):\n// SVG/EPS/Illustrator are their own family so the raster rendition DAG (G38)\n// and the spinner-for-derived rule (G36) never apply to them.\n\nexport const ASSET_FAMILIES = [\"image\", \"document\", \"audio\", \"video\", \"vector\", \"other\"] as const;\nexport type AssetFamily = (typeof ASSET_FAMILIES)[number];\n\nconst ASSET_FAMILY_SET: ReadonlySet<string> = new Set(ASSET_FAMILIES);\n\n/**\n * Narrow an untyped `family` read off a row. Convex hands asset rows back\n * untyped — the table is generated per tenant — so a reader that needs the\n * union has to check it rather than assert it.\n */\nexport function isAssetFamily(value: unknown): value is AssetFamily {\n  return typeof value === \"string\" && ASSET_FAMILY_SET.has(value);\n}\n\n/**\n * Vector MIME table (G20/G38). `application/pdf` deliberately stays\n * `document`, which also covers PDF-based `.ai` files.\n */\nconst VECTOR_CONTENT_TYPES = new Set([\n  \"image/svg+xml\",\n  \"application/postscript\",\n  \"application/eps\",\n  \"application/x-eps\",\n  \"image/eps\",\n  \"image/x-eps\",\n  \"application/illustrator\",\n  \"application/vnd.adobe.illustrator\",\n]);\n\n/** Vector types a browser can render in an `<img>`; the rest fall back to an icon. */\nexport const DISPLAYABLE_VECTOR_CONTENT_TYPES = [\"image/svg+xml\"] as const;\nconst DISPLAYABLE_VECTOR_CONTENT_TYPE_SET: ReadonlySet<string> = new Set(\n  DISPLAYABLE_VECTOR_CONTENT_TYPES,\n);\n\n/**\n * G38 raster allowlist: only these get a rendition DAG (and therefore the G36\n * spinner). Animated GIF/WebP are included and rendered **first frame**.\n * Everything else that is family `image` — BMP, ICO, camera RAW — keeps its\n * original and never enters the render pipeline.\n */\nconst RASTER_RENDITION_CONTENT_TYPES: ReadonlySet<string> = new Set([\n  \"image/jpeg\",\n  \"image/pjpeg\",\n  \"image/png\",\n  \"image/webp\",\n  \"image/avif\",\n  \"image/tiff\",\n  \"image/heic\",\n  \"image/heif\",\n  \"image/gif\",\n]);\n\n/** True when this MIME may be decoded into the G21 rendition graph. */\nexport function isRasterRenditionSource(contentType: string | undefined): boolean {\n  return RASTER_RENDITION_CONTENT_TYPES.has(normalizeContentType(contentType));\n}\n\n/** `accept` value for a file input restricted to family `vector`. */\nexport const VECTOR_FILE_ACCEPT =\n  \".svg,.eps,.ai,image/svg+xml,application/postscript,application/illustrator\";\n\nfunction normalizeContentType(contentType: string | undefined): string {\n  return contentType?.split(\";\")[0]?.trim().toLowerCase() ?? \"\";\n}\n\n/** Only `.svg` is inferred from the filename, and only when the MIME is missing. */\nfunction hasVectorExtension(filename: string | undefined): boolean {\n  return filename?.trim().toLowerCase().endsWith(\".svg\") ?? false;\n}\n\nexport function isVectorContentType(contentType: string | undefined, filename?: string): boolean {\n  const value = normalizeContentType(contentType);\n  if (!value) return hasVectorExtension(filename);\n  return VECTOR_CONTENT_TYPES.has(value);\n}\n\n/**\n * True when the asset can be shown directly in an `<img>` even though it is\n * not family `image`: SVG only, so EPS keeps the file icon.\n */\nexport function isDisplayableVectorContentType(\n  contentType: string | undefined,\n  filename?: string,\n): boolean {\n  const value = normalizeContentType(contentType);\n  if (!value) return hasVectorExtension(filename);\n  return DISPLAYABLE_VECTOR_CONTENT_TYPE_SET.has(value);\n}\n\n/** Derive the stable family used by profiles, graphs, and library filtering. */\nexport function assetFamilyForContentType(\n  contentType: string | undefined,\n  filename?: string,\n): AssetFamily {\n  const value = normalizeContentType(contentType);\n  if (isVectorContentType(contentType, filename)) return \"vector\";\n  if (value.startsWith(\"image/\")) return \"image\";\n  if (value.startsWith(\"audio/\")) return \"audio\";\n  if (value.startsWith(\"video/\")) return \"video\";\n  if (\n    value === \"application/pdf\" ||\n    value.startsWith(\"text/\") ||\n    value.startsWith(\"application/msword\") ||\n    value.startsWith(\"application/vnd.openxmlformats-officedocument\") ||\n    value.startsWith(\"application/vnd.oasis.opendocument\")\n  ) {\n    return \"document\";\n  }\n  return \"other\";\n}\n\n/**\n * G20: ExifTool extract runs for `image` and `vector` only. Rendition graphs\n * are a stricter gate (`assetBuildsRenditions`: raster `image`).\n */\nexport function isExtractableFamily(family: AssetFamily | undefined): boolean {\n  return family === \"image\" || family === \"vector\";\n}\n\n/**\n * Library eligibility for an `image` field picker: family `image` plus vector\n * assets a browser can display. EPS stays reachable from `file` fields only.\n */\nexport function isImageFieldPickable(asset: {\n  family?: string;\n  contentType?: string;\n  filename?: string;\n}): boolean {\n  if (asset.family === \"image\") return true;\n  return isDisplayableVectorContentType(asset.contentType, asset.filename);\n}\n"]}

package/dist/assetFieldValues.d.ts

@@ -0,0 +1,21 @@
+import type { Field, FieldType } from "./schemaTypes.ts";
+export declare function isValidAssetId(value: string): boolean;
+/** Collect persisted asset ids from image/file fields, including nested objects. */
+export declare function collectAssetIds(value: unknown, type: FieldType, out?: Set<string>): Set<string>;
+export declare function collectAssetIdsFromRow(row: Record<string, unknown> | undefined, fields: readonly Field[], out?: Set<string>): Set<string>;
+/**
+ * One reverse-reference placement for a stored Media value. `fieldName` is a
+ * stable manifest path; a top-level file array uses `arrayIndex`, while deeper
+ * arrays include their index in the path to keep the component key unique.
+ */
+export type AssetFieldRef = {
+    assetId: string;
+    fieldName: string;
+    arrayIndex: number | null;
+};
+/**
+ * Collect placement-precise asset references from a row. This is deliberately
+ * separate from `collectAssetIdsFromRow`: display batching only needs ids,
+ * whereas the DAM ref index must distinguish two placements of the same id.
+ */
+export declare function collectAssetRefsFromRow(row: Record<string, unknown> | undefined, fields: readonly Field[]): AssetFieldRef[];

package/dist/{storageFieldValues.js → assetFieldValues.js}

@@ -4180,7 +4180,13 @@ var RESERVED_TABLE_NAMES = /* @__PURE__ */ new Set([
   "columnus_api_output_secrets",
   "columnus_api_sync_routes",
   "columnus_api_outbox",
-  "columnus_api_delivery"
+  "columnus_api_delivery",
+  "columnus_assets",
+  "columnus_asset_versions",
+  "columnus_asset_refs",
+  "columnus_asset_profiles",
+  "columnus_asset_settings",
+  "columnus_asset_jobs"
 ]);
 var displayTemplatesSchema = external_exports.object({
   id: external_exports.string().optional(),
@@ -4213,6 +4219,12 @@ var TABLE_COLORS = [
   "lavender"
 ];
 var tableColorSchema = external_exports.enum(TABLE_COLORS);
+var TABLE_KINDS = ["record", "asset"];
+var tableKindSchema = external_exports.enum(TABLE_KINDS);
+var assetBindingSchema = external_exports.object({
+  profile: external_exports.string().min(1),
+  enforced: external_exports.boolean().optional()
+});
 var fieldTypeSchema = external_exports.lazy(
   () => external_exports.discriminatedUnion("kind", [
     external_exports.object({ kind: external_exports.literal("string") }),
@@ -4240,7 +4252,9 @@ var fieldTypeSchema = external_exports.lazy(
           name: external_exports.string().regex(IDENT),
           label: external_exports.string().optional(),
           type: fieldTypeSchema,
-          optional: external_exports.boolean()
+          optional: external_exports.boolean(),
+          /** Nested image/file placements bind a Media profile like top-level ones. */
+          asset: assetBindingSchema.optional()
         })
       )
     }),
@@ -4254,7 +4268,9 @@ var fieldSchema = external_exports.object({
   name: external_exports.string().regex(IDENT, "must be a valid identifier"),
   label: external_exports.string().optional(),
   type: fieldTypeSchema,
-  optional: external_exports.boolean()
+  optional: external_exports.boolean(),
+  /** Image/file fields may pin a Media profile; existence is enforced at upload/pick. */
+  asset: assetBindingSchema.optional()
 });
 var indexSchema = external_exports.object({
   name: external_exports.string().regex(IDENT),
@@ -4271,6 +4287,8 @@ var tableSchema = external_exports.object({
   }),
   label: external_exports.string().optional(),
   color: tableColorSchema.optional(),
+  /** Asset metadata tables are typed root tables but never ordinary user records. */
+  kind: tableKindSchema.optional().default("record"),
   fields: external_exports.array(fieldSchema),
   indexes: external_exports.array(indexSchema).default([]),
   searchIndexes: external_exports.array(searchIndexSchema).default([]),
@@ -4280,6 +4298,7 @@ external_exports.object({
   tables: external_exports.array(tableSchema)
 }).superRefine((manifest, ctx) => {
   const tableNames = /* @__PURE__ */ new Set();
+  const tablesByName = /* @__PURE__ */ new Map();
   for (const t of manifest.tables) {
     if (tableNames.has(t.name)) {
       ctx.addIssue({
@@ -4289,6 +4308,37 @@ external_exports.object({
       });
     }
     tableNames.add(t.name);
+    tablesByName.set(t.name, t);
+    if (tableKind(t) === "asset") {
+      if (t.indexes.length > 0) {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          message: `${t.name} is an asset metadata table and cannot define indexes`,
+          path: ["tables"]
+        });
+      }
+      if (t.searchIndexes.length > 0) {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          message: `${t.name} is an asset metadata table and cannot define search indexes`,
+          path: ["tables"]
+        });
+      }
+      if (t.displayTemplates !== void 0) {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          message: `${t.name} is an asset metadata table and cannot define display templates`,
+          path: ["tables"]
+        });
+      }
+      if (t.color !== void 0) {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          message: `${t.name} is an asset metadata table and cannot define a color`,
+          path: ["tables"]
+        });
+      }
+    }
     const fieldNames = /* @__PURE__ */ new Set();
     for (const f of t.fields) {
       if (fieldNames.has(f.name)) {
@@ -4299,36 +4349,43 @@ external_exports.object({
         });
       }
       fieldNames.add(f.name);
+      assertAssetBindingAllowed(ctx, t, f);
     }
   }
   for (const t of manifest.tables) {
     for (const f of t.fields) {
-      const danglingRef = findDanglingRef(f.type, tableNames);
-      if (danglingRef) {
+      const invalidRef = findInvalidReference(f.type, tablesByName);
+      if (invalidRef) {
         ctx.addIssue({
           code: external_exports.ZodIssueCode.custom,
-          message: `${t.name}.${f.name} references unknown table: ${danglingRef}`,
+          message: `${t.name}.${f.name} ${invalidRef}`,
           path: ["tables"]
         });
       }
     }
   }
 });
-function findDanglingRef(t, known) {
+function findInvalidReference(t, tablesByName) {
   switch (t.kind) {
-    case "id":
-      return known.has(t.table) ? null : t.table;
+    case "id": {
+      const target = tablesByName.get(t.table);
+      if (!target) return `references unknown table: ${t.table}`;
+      if (tableKind(target) === "asset") {
+        return `cannot reference asset metadata table: ${t.table}`;
+      }
+      return null;
+    }
     case "array":
-      return findDanglingRef(t.element, known);
+      return findInvalidReference(t.element, tablesByName);
     case "object":
       for (const f of t.fields) {
-        const r = findDanglingRef(f.type, known);
+        const r = findInvalidReference(f.type, tablesByName);
         if (r) return r;
       }
       return null;
     case "union":
       for (const o of t.options) {
-        const r = findDanglingRef(o, known);
+        const r = findInvalidReference(o, tablesByName);
         if (r) return r;
       }
       return null;
@@ -4336,6 +4393,9 @@ function findDanglingRef(t, known) {
       return null;
   }
 }
+function tableKind(table) {
+  return table.kind ?? "record";
+}
 function isFileFieldType(t) {
   return t.kind === "file" || t.kind === "image";
 }
@@ -4345,6 +4405,37 @@ function isFileArrayFieldType(t) {
 function isStorageFieldType(t) {
   return isFileFieldType(t) || isFileArrayFieldType(t);
 }
+function assertAssetBindingAllowed(ctx, table, field) {
+  if (field.asset && tableKind(table) === "asset") {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      message: `${table.name}.${field.name} asset metadata fields cannot define a Media profile`,
+      path: ["tables"]
+    });
+  } else if (field.asset && !isStorageFieldType(field.type)) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      message: `${table.name}.${field.name} asset profile can only be set on image/file fields`,
+      path: ["tables"]
+    });
+  }
+  assertAssetBindingsInType(ctx, table, field.type);
+}
+function assertAssetBindingsInType(ctx, table, type) {
+  switch (type.kind) {
+    case "array":
+      assertAssetBindingsInType(ctx, table, type.element);
+      return;
+    case "object":
+      for (const field of type.fields) assertAssetBindingAllowed(ctx, table, field);
+      return;
+    case "union":
+      for (const option of type.options) assertAssetBindingsInType(ctx, table, option);
+      return;
+    default:
+      return;
+  }
+}
 
 // packages/@columnus/shared/src/displayLabel.ts
 function toDocumentId(value) {
@@ -4352,70 +4443,78 @@ function toDocumentId(value) {
   return typeof value === "string" ? value : String(value);
 }
 
-// packages/@columnus/shared/src/storageFieldValues.ts
-var STORAGE_ID = /^[a-z0-9]+$/i;
-function isValidStorageId(value) {
-  return STORAGE_ID.test(value) && value.length >= 10;
+// packages/@columnus/shared/src/assetFieldValues.ts
+var ASSET_ID = /^[a-z0-9]+$/i;
+function isValidAssetId(value) {
+  return ASSET_ID.test(value) && value.length >= 10;
 }
-function collectStorageIds(value, type, out = /* @__PURE__ */ new Set()) {
+function collectAssetIds(value, type, out = /* @__PURE__ */ new Set()) {
   if (isFileFieldType(type)) {
     const id = toDocumentId(value);
     if (id) out.add(id);
     return out;
   }
-  if (isFileArrayFieldType(type) && Array.isArray(value)) {
-    for (const item of value) {
-      const id = toDocumentId(item);
-      if (id) out.add(id);
+  if (type.kind === "array" && Array.isArray(value)) {
+    for (const item of value) collectAssetIds(item, type.element, out);
+    return out;
+  }
+  if (type.kind === "object" && value !== null && typeof value === "object" && !Array.isArray(value)) {
+    const record = value;
+    for (const field of type.fields) {
+      collectAssetIds(record[field.name], field.type, out);
     }
+    return out;
+  }
+  if (type.kind === "union") {
+    for (const option of type.options) collectAssetIds(value, option, out);
   }
   return out;
 }
-function collectStorageIdsFromRow(row, fields, out = /* @__PURE__ */ new Set()) {
+function collectAssetIdsFromRow(row, fields, out = /* @__PURE__ */ new Set()) {
   if (!row) return out;
   for (const field of fields) {
-    if (!isStorageFieldType(field.type)) continue;
-    collectStorageIds(row[field.name], field.type, out);
+    collectAssetIds(row[field.name], field.type, out);
   }
   return out;
 }
-function storageIdsRemovedByPatches(serverRowById, patches, fields) {
-  const removed = [];
-  for (const { id, patch } of patches) {
-    const before = serverRowById.get(id);
-    if (!before) continue;
-    const after = { ...before, ...patch };
-    for (const field of fields) {
-      if (!(field.name in patch)) continue;
-      if (!isStorageFieldType(field.type)) continue;
-      const beforeIds = collectStorageIds(before[field.name], field.type);
-      const afterIds = collectStorageIds(after[field.name], field.type);
-      for (const storageId of beforeIds) {
-        if (!afterIds.has(storageId)) removed.push(storageId);
+function collectAssetRefsFromRow(row, fields) {
+  if (!row) return [];
+  const refs = /* @__PURE__ */ new Map();
+  const add = (assetId, fieldName, arrayIndex) => {
+    const ref = { assetId, fieldName, arrayIndex };
+    refs.set(`${assetId}\0${fieldName}\0${arrayIndex ?? ""}`, ref);
+  };
+  const visit = (value, type, fieldName, arrayIndex) => {
+    if (isFileFieldType(type)) {
+      const assetId = toDocumentId(value);
+      if (assetId) add(assetId, fieldName, arrayIndex);
+      return;
+    }
+    if (type.kind === "array" && Array.isArray(value)) {
+      for (const [index, item] of value.entries()) {
+        if (isFileFieldType(type.element)) {
+          visit(item, type.element, fieldName, index);
+        } else {
+          visit(item, type.element, `${fieldName}[${index}]`, null);
+        }
       }
+      return;
     }
-  }
-  return removed;
-}
-function collectReferencedStorageIds(serverRowById, pendingEdits, draftRowIds, fields) {
-  const referenced = /* @__PURE__ */ new Set();
-  for (const row of serverRowById.values()) {
-    collectStorageIdsFromRow(row, fields, referenced);
-  }
-  for (const [rowId, patch] of pendingEdits) {
-    const baseline = isDraftRowId(rowId) ? patch : { ...serverRowById.get(rowId), ...patch };
-    collectStorageIdsFromRow(baseline, fields, referenced);
-  }
-  for (const rowId of draftRowIds) {
-    const patch = pendingEdits.get(rowId);
-    if (patch) collectStorageIdsFromRow(patch, fields, referenced);
-  }
-  return referenced;
-}
-function isDraftRowId(rowId) {
-  return rowId.startsWith("__draft__");
+    if (type.kind === "object" && value !== null && typeof value === "object" && !Array.isArray(value)) {
+      const record = value;
+      for (const field of type.fields) {
+        visit(record[field.name], field.type, `${fieldName}.${field.name}`, arrayIndex);
+      }
+      return;
+    }
+    if (type.kind === "union") {
+      for (const option of type.options) visit(value, option, fieldName, arrayIndex);
+    }
+  };
+  for (const field of fields) visit(row[field.name], field.type, field.name, null);
+  return [...refs.values()];
 }
 
-export { collectReferencedStorageIds, collectStorageIds, collectStorageIdsFromRow, isValidStorageId, storageIdsRemovedByPatches };
-//# sourceMappingURL=storageFieldValues.js.map
-//# sourceMappingURL=storageFieldValues.js.map
+export { collectAssetIds, collectAssetIdsFromRow, collectAssetRefsFromRow, isValidAssetId };
+//# sourceMappingURL=assetFieldValues.js.map
+//# sourceMappingURL=assetFieldValues.js.map