@columnus/shared 0.1.54 → 0.1.56

package/dist/schemaGenerator.d.ts

@@ -1,4 +1,13 @@
-import type { Manifest } from "./schemaTypes.ts";
+import { type Manifest } from "./schemaTypes.ts";
+/**
+ * How `image`/`file` fields are validated in generated `schema.ts`.
+ *
+ * `storage-or-assets` is the G14 cutover window: Convex will not push a
+ * schema that existing documents fail, so the first deploy must still accept
+ * legacy `_storage` ids. After `migrateLegacyAssetFieldsPage` rewrites those
+ * values, the second deploy uses `assets`.
+ */
+export type AssetFieldIdContract = "assets" | "storage-or-assets";
 export type GenerateSchemaOptions = {
     includeColumnusTables?: boolean;
     /** @deprecated Use includeColumnusTables */
@@ -11,6 +20,14 @@ export type GenerateSchemaOptions = {
     includeAuditTable?: boolean;
     /** When includeColumnusTables, omit columnus_display_values (owned by @columnus/component). Default true. */
     includeDisplayValuesTable?: boolean;
+    /** Default `assets`. Use `storage-or-assets` only for the G14 first push. */
+    assetFieldIds?: AssetFieldIdContract;
+    /**
+     * Convex document validation on push. Default true. The G14 first push sets
+     * this false so existing `_storage` field values cannot block the kernel that
+     * contains the migrator.
+     */
+    schemaValidation?: boolean;
 };
 /** User tables only — component tables live in @columnus/component. */
 export declare const HOST_SCHEMA_PROFILE: {
@@ -28,4 +45,11 @@ export declare const API_SYNC_ROUTES_TABLE_NAME = "columnus_api_sync_routes";
 export declare const API_OUTBOX_TABLE_NAME = "columnus_api_outbox";
 export declare const API_DELIVERY_TABLE_NAME = "columnus_api_delivery";
 export declare const INCOMING_REFS_TABLE_NAME = "columnus_incoming_refs";
+export declare const ASSETS_TABLE_NAME = "columnus_assets";
+export declare const ASSET_VERSIONS_TABLE_NAME = "columnus_asset_versions";
+export declare const ASSET_REFS_TABLE_NAME = "columnus_asset_refs";
+export declare const ASSET_PROFILES_TABLE_NAME = "columnus_asset_profiles";
+export declare const ASSET_SETTINGS_TABLE_NAME = "columnus_asset_settings";
 export declare function generateSchemaTs(manifest: Manifest, opts?: GenerateSchemaOptions): string;
+/** True when G14 must loosen `image`/`file` validators before rewriting `_storage` ids. */
+export declare function manifestHasFileOrImageFields(manifest: Manifest): boolean;