@ai-matrx/media 0.8.0 → 0.9.0

package/dist/files/engine/filesDb.d.ts

@@ -0,0 +1,1913 @@
+/**
+ * features/files/filesDb.ts
+ *
+ * The cloud-files tables live in the dedicated `files` Postgres schema (moved
+ * out of `public` in the 2026 DB restructure; the `cld_` prefix was dropped).
+ * supabase-js reaches a non-public schema via `.schema(...)`, so every table
+ * read/write for these tables must go through `client.schema('files')`.
+ *
+ * Use this helper instead of inlining `.schema('files')` everywhere:
+ *
+ *   const db = filesDb(supabase);
+ *   const { data } = await db.from('files').select(FILES_TABLE_COLUMNS);
+ *   await db.from('folders').upsert(...);                  // files.folders
+ *
+ * NEVER `select('*')` on `files.files` / `files.file_versions` — the
+ * server-only `storage_uri` column grant is REVOKEd and `*` errors.
+ *
+ * Works with the browser client, the SSR server client, and the admin client —
+ * they all expose `.schema()`.
+ *
+ * NOTE: file-permission grants are NOT in this schema — they live in the
+ * canonical `iam.permissions` store (resource_type='file'/'folder'). Reach
+ * those via `iamDb(supabase).rpc('fn_list_resource_permissions', ...)` (see
+ * utils/supabase/iamDb.ts) — list/grant/revoke are admin-gated inside the
+ * RPC (iam.has_access), never a plain `.from('permissions')` select.
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+import type { Database } from "./db-types.js";
+/** A supabase client scoped to the `files` schema. */
+export declare function filesDb<C extends SupabaseClient<Database>>(client: C): import("@supabase/postgrest-js").PostgrestClient<import("./db-types.js").FilesDatabase, {
+    PostgrestVersion: "14.5";
+}, "files", {
+    Tables: {
+        account_tiers: {
+            Row: {
+                created_at: string;
+                created_by: string | null;
+                deleted_at: string | null;
+                features: import("./db-types.js").Json;
+                id: string;
+                is_default_for_guests: boolean;
+                is_default_for_users: boolean;
+                max_bulk_items: number | null;
+                max_daily_upload_bytes: number | null;
+                max_daily_uploads: number | null;
+                max_file_size_bytes: number | null;
+                max_files: number | null;
+                max_share_links_per_resource: number | null;
+                max_storage_bytes: number | null;
+                max_versions_per_file: number | null;
+                metadata: import("./db-types.js").Json;
+                name: string;
+                organization_id: string;
+                published_to_web: boolean;
+                published_to_web_at: string | null;
+                published_to_web_by: string | null;
+                rate_limit_downloads_per_min: number | null;
+                rate_limit_general_per_min: number | null;
+                rate_limit_uploads_per_min: number | null;
+                shown_to: Database["platform"]["Enums"]["shown_to"] | null;
+                tier_key: string;
+                updated_at: string;
+                updated_by: string | null;
+                version: number;
+                visibility: Database["platform"]["Enums"]["visibility"];
+            };
+            Insert: {
+                created_at?: string;
+                created_by?: string | null;
+                deleted_at?: string | null;
+                features?: import("./db-types.js").Json;
+                id?: string;
+                is_default_for_guests?: boolean;
+                is_default_for_users?: boolean;
+                max_bulk_items?: number | null;
+                max_daily_upload_bytes?: number | null;
+                max_daily_uploads?: number | null;
+                max_file_size_bytes?: number | null;
+                max_files?: number | null;
+                max_share_links_per_resource?: number | null;
+                max_storage_bytes?: number | null;
+                max_versions_per_file?: number | null;
+                metadata?: import("./db-types.js").Json;
+                name: string;
+                organization_id: string;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                rate_limit_downloads_per_min?: number | null;
+                rate_limit_general_per_min?: number | null;
+                rate_limit_uploads_per_min?: number | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                tier_key: string;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+            };
+            Update: {
+                created_at?: string;
+                created_by?: string | null;
+                deleted_at?: string | null;
+                features?: import("./db-types.js").Json;
+                id?: string;
+                is_default_for_guests?: boolean;
+                is_default_for_users?: boolean;
+                max_bulk_items?: number | null;
+                max_daily_upload_bytes?: number | null;
+                max_daily_uploads?: number | null;
+                max_file_size_bytes?: number | null;
+                max_files?: number | null;
+                max_share_links_per_resource?: number | null;
+                max_storage_bytes?: number | null;
+                max_versions_per_file?: number | null;
+                metadata?: import("./db-types.js").Json;
+                name?: string;
+                organization_id?: string;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                rate_limit_downloads_per_min?: number | null;
+                rate_limit_general_per_min?: number | null;
+                rate_limit_uploads_per_min?: number | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                tier_key?: string;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+            };
+            Relationships: [];
+        };
+        analysis: {
+            Row: {
+                analyzer_version: string;
+                classification: import("./db-types.js").Json | null;
+                completed_at: string | null;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                detectors_run: import("./db-types.js").Json;
+                file_id: string;
+                id: string;
+                metadata: import("./db-types.js").Json;
+                mime_type: string | null;
+                organization_id: string;
+                owner_id: string;
+                page_count: number | null;
+                progress: import("./db-types.js").Json;
+                started_at: string;
+                status: string;
+                summary_counts: import("./db-types.js").Json;
+                text_source_map: import("./db-types.js").Json | null;
+                thumbnail_url: string | null;
+                updated_at: string;
+            };
+            Insert: {
+                analyzer_version?: string;
+                classification?: import("./db-types.js").Json | null;
+                completed_at?: string | null;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                detectors_run?: import("./db-types.js").Json;
+                file_id: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                mime_type?: string | null;
+                organization_id: string;
+                owner_id: string;
+                page_count?: number | null;
+                progress?: import("./db-types.js").Json;
+                started_at?: string;
+                status?: string;
+                summary_counts?: import("./db-types.js").Json;
+                text_source_map?: import("./db-types.js").Json | null;
+                thumbnail_url?: string | null;
+                updated_at?: string;
+            };
+            Update: {
+                analyzer_version?: string;
+                classification?: import("./db-types.js").Json | null;
+                completed_at?: string | null;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                detectors_run?: import("./db-types.js").Json;
+                file_id?: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                mime_type?: string | null;
+                organization_id?: string;
+                owner_id?: string;
+                page_count?: number | null;
+                progress?: import("./db-types.js").Json;
+                started_at?: string;
+                status?: string;
+                summary_counts?: import("./db-types.js").Json;
+                text_source_map?: import("./db-types.js").Json | null;
+                thumbnail_url?: string | null;
+                updated_at?: string;
+            };
+            Relationships: [{
+                foreignKeyName: "file_analysis_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: true;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }];
+        };
+        analysis_result: {
+            Row: {
+                confidence_tier: string;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                detector_kind: string;
+                detector_version: string;
+                elapsed_ms: number;
+                error: string | null;
+                file_id: string;
+                id: string;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                page_id: string | null;
+                payload: import("./db-types.js").Json | null;
+                payload_bytes: number;
+                payload_uri: string | null;
+                status: string;
+                summary: import("./db-types.js").Json;
+                text_sources: string[];
+            };
+            Insert: {
+                confidence_tier?: string;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                detector_kind: string;
+                detector_version?: string;
+                elapsed_ms?: number;
+                error?: string | null;
+                file_id: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                organization_id: string;
+                page_id?: string | null;
+                payload?: import("./db-types.js").Json | null;
+                payload_bytes?: number;
+                payload_uri?: string | null;
+                status?: string;
+                summary?: import("./db-types.js").Json;
+                text_sources?: string[];
+            };
+            Update: {
+                confidence_tier?: string;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                detector_kind?: string;
+                detector_version?: string;
+                elapsed_ms?: number;
+                error?: string | null;
+                file_id?: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                organization_id?: string;
+                page_id?: string | null;
+                payload?: import("./db-types.js").Json | null;
+                payload_bytes?: number;
+                payload_uri?: string | null;
+                status?: string;
+                summary?: import("./db-types.js").Json;
+                text_sources?: string[];
+            };
+            Relationships: [{
+                foreignKeyName: "file_analysis_result_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }, {
+                foreignKeyName: "file_analysis_result_page_id_fkey";
+                columns: ["page_id"];
+                isOneToOne: false;
+                referencedRelation: "pages";
+                referencedColumns: ["id"];
+            }];
+        };
+        entities: {
+            Row: {
+                canonical_value: string;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                file_id: string;
+                id: string;
+                is_user_named: boolean;
+                label: string;
+                label_category: string;
+                metadata: import("./db-types.js").Json;
+                normalized_value: import("./db-types.js").Json | null;
+                organization_id: string;
+                owner_id: string;
+                source_annotation_id: string | null;
+                updated_at: string;
+                version: number;
+            };
+            Insert: {
+                canonical_value: string;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                file_id: string;
+                id?: string;
+                is_user_named?: boolean;
+                label: string;
+                label_category?: string;
+                metadata?: import("./db-types.js").Json;
+                normalized_value?: import("./db-types.js").Json | null;
+                organization_id: string;
+                owner_id: string;
+                source_annotation_id?: string | null;
+                updated_at?: string;
+                version?: number;
+            };
+            Update: {
+                canonical_value?: string;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                file_id?: string;
+                id?: string;
+                is_user_named?: boolean;
+                label?: string;
+                label_category?: string;
+                metadata?: import("./db-types.js").Json;
+                normalized_value?: import("./db-types.js").Json | null;
+                organization_id?: string;
+                owner_id?: string;
+                source_annotation_id?: string | null;
+                updated_at?: string;
+                version?: number;
+            };
+            Relationships: [{
+                foreignKeyName: "file_entities_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }, {
+                foreignKeyName: "file_entities_source_annotation_id_fkey";
+                columns: ["source_annotation_id"];
+                isOneToOne: false;
+                referencedRelation: "page_annotations";
+                referencedColumns: ["id"];
+            }];
+        };
+        file_rag_jobs: {
+            Row: {
+                attempt_count: number;
+                completed_at: string | null;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                error: import("./db-types.js").Json | null;
+                file_id: string;
+                id: string;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                scheduled_for: string;
+                skipped_reason: string | null;
+                started_at: string | null;
+                status: string;
+                trigger_source: string;
+                updated_at: string;
+                user_id: string;
+            };
+            Insert: {
+                attempt_count?: number;
+                completed_at?: string | null;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                error?: import("./db-types.js").Json | null;
+                file_id: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                organization_id: string;
+                scheduled_for?: string;
+                skipped_reason?: string | null;
+                started_at?: string | null;
+                status?: string;
+                trigger_source?: string;
+                updated_at?: string;
+                user_id: string;
+            };
+            Update: {
+                attempt_count?: number;
+                completed_at?: string | null;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                error?: import("./db-types.js").Json | null;
+                file_id?: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                organization_id?: string;
+                scheduled_for?: string;
+                skipped_reason?: string | null;
+                started_at?: string | null;
+                status?: string;
+                trigger_source?: string;
+                updated_at?: string;
+                user_id?: string;
+            };
+            Relationships: [{
+                foreignKeyName: "cld_file_rag_jobs_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }];
+        };
+        file_versions: {
+            Row: {
+                change_summary: string | null;
+                checksum: string | null;
+                created_at: string;
+                created_by: string | null;
+                custom_fields: import("./db-types.js").Json;
+                file_id: string;
+                id: string;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                size_bytes: number | null;
+                storage_uri: string;
+                version_number: number;
+            };
+            Insert: {
+                change_summary?: string | null;
+                checksum?: string | null;
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                file_id: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                organization_id: string;
+                size_bytes?: number | null;
+                storage_uri: string;
+                version_number: number;
+            };
+            Update: {
+                change_summary?: string | null;
+                checksum?: string | null;
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                file_id?: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                organization_id?: string;
+                size_bytes?: number | null;
+                storage_uri?: string;
+                version_number?: number;
+            };
+            Relationships: [{
+                foreignKeyName: "cld_file_versions_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }];
+        };
+        files: {
+            Row: {
+                artifact_kind: string | null;
+                canonical_processed_document_id: string | null;
+                checksum: string | null;
+                client_modified_at: string | null;
+                created_at: string;
+                created_by: string;
+                current_version: number;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                derivation_kind: string | null;
+                derivation_metadata: import("./db-types.js").Json;
+                duplicate_of_file_id: string | null;
+                duration_ms: number | null;
+                file_name: string;
+                file_path: string;
+                height: number | null;
+                id: string;
+                metadata: import("./db-types.js").Json;
+                mime_type: string | null;
+                organization_id: string;
+                origin_device_id: string | null;
+                parent_file_id: string | null;
+                parent_folder_id: string | null;
+                parent_record_id: string | null;
+                parent_record_type: string | null;
+                provider_session_id: string | null;
+                published_to_web: boolean;
+                published_to_web_at: string | null;
+                published_to_web_by: string | null;
+                shown_to: Database["platform"]["Enums"]["shown_to"] | null;
+                size_bytes: number | null;
+                storage_uri: string;
+                updated_at: string;
+                updated_by: string | null;
+                version: number;
+                visibility: Database["platform"]["Enums"]["visibility"];
+                width: number | null;
+            };
+            Insert: {
+                artifact_kind?: string | null;
+                canonical_processed_document_id?: string | null;
+                checksum?: string | null;
+                client_modified_at?: string | null;
+                created_at?: string;
+                created_by: string;
+                current_version?: number;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                derivation_kind?: string | null;
+                derivation_metadata?: import("./db-types.js").Json;
+                duplicate_of_file_id?: string | null;
+                duration_ms?: number | null;
+                file_name: string;
+                file_path: string;
+                height?: number | null;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                mime_type?: string | null;
+                organization_id: string;
+                origin_device_id?: string | null;
+                parent_file_id?: string | null;
+                parent_folder_id?: string | null;
+                parent_record_id?: string | null;
+                parent_record_type?: string | null;
+                provider_session_id?: string | null;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                size_bytes?: number | null;
+                storage_uri: string;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+                width?: number | null;
+            };
+            Update: {
+                artifact_kind?: string | null;
+                canonical_processed_document_id?: string | null;
+                checksum?: string | null;
+                client_modified_at?: string | null;
+                created_at?: string;
+                created_by?: string;
+                current_version?: number;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                derivation_kind?: string | null;
+                derivation_metadata?: import("./db-types.js").Json;
+                duplicate_of_file_id?: string | null;
+                duration_ms?: number | null;
+                file_name?: string;
+                file_path?: string;
+                height?: number | null;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                mime_type?: string | null;
+                organization_id?: string;
+                origin_device_id?: string | null;
+                parent_file_id?: string | null;
+                parent_folder_id?: string | null;
+                parent_record_id?: string | null;
+                parent_record_type?: string | null;
+                provider_session_id?: string | null;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                size_bytes?: number | null;
+                storage_uri?: string;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+                width?: number | null;
+            };
+            Relationships: [{
+                foreignKeyName: "cld_files_duplicate_of_file_id_fkey";
+                columns: ["duplicate_of_file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }, {
+                foreignKeyName: "cld_files_parent_file_id_fkey";
+                columns: ["parent_file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }, {
+                foreignKeyName: "cld_files_parent_folder_id_fkey";
+                columns: ["parent_folder_id"];
+                isOneToOne: false;
+                referencedRelation: "folders";
+                referencedColumns: ["id"];
+            }];
+        };
+        folders: {
+            Row: {
+                created_at: string;
+                created_by: string;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                folder_name: string;
+                folder_path: string;
+                id: string;
+                is_system: boolean;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                parent_id: string | null;
+                published_to_web: boolean;
+                published_to_web_at: string | null;
+                published_to_web_by: string | null;
+                shown_to: Database["platform"]["Enums"]["shown_to"] | null;
+                updated_at: string;
+                updated_by: string | null;
+                version: number;
+                visibility: Database["platform"]["Enums"]["visibility"];
+            };
+            Insert: {
+                created_at?: string;
+                created_by: string;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                folder_name: string;
+                folder_path: string;
+                id?: string;
+                is_system?: boolean;
+                metadata?: import("./db-types.js").Json;
+                organization_id: string;
+                parent_id?: string | null;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+            };
+            Update: {
+                created_at?: string;
+                created_by?: string;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                folder_name?: string;
+                folder_path?: string;
+                id?: string;
+                is_system?: boolean;
+                metadata?: import("./db-types.js").Json;
+                organization_id?: string;
+                parent_id?: string | null;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+            };
+            Relationships: [{
+                foreignKeyName: "cld_folders_parent_id_fkey";
+                columns: ["parent_id"];
+                isOneToOne: false;
+                referencedRelation: "folders";
+                referencedColumns: ["id"];
+            }];
+        };
+        idempotency: {
+            Row: {
+                created_at: string;
+                endpoint: string;
+                expires_at: string;
+                idempotency_key: string;
+                owner_id: string;
+                request_hash: string;
+                resource_id: string | null;
+                resource_type: string | null;
+                response_body: import("./db-types.js").Json;
+                status_code: number;
+            };
+            Insert: {
+                created_at?: string;
+                endpoint: string;
+                expires_at?: string;
+                idempotency_key: string;
+                owner_id: string;
+                request_hash: string;
+                resource_id?: string | null;
+                resource_type?: string | null;
+                response_body: import("./db-types.js").Json;
+                status_code: number;
+            };
+            Update: {
+                created_at?: string;
+                endpoint?: string;
+                expires_at?: string;
+                idempotency_key?: string;
+                owner_id?: string;
+                request_hash?: string;
+                resource_id?: string | null;
+                resource_type?: string | null;
+                response_body?: import("./db-types.js").Json;
+                status_code?: number;
+            };
+            Relationships: [];
+        };
+        machine_written_prefixes: {
+            Row: {
+                created_at: string;
+                created_by: string | null;
+                deleted_at: string | null;
+                description: string | null;
+                deselect_by_default: boolean;
+                id: string;
+                is_active: boolean;
+                label: string;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                prefix: string;
+                published_to_web: boolean;
+                published_to_web_at: string | null;
+                published_to_web_by: string | null;
+                shown_to: Database["platform"]["Enums"]["shown_to"] | null;
+                updated_at: string;
+                updated_by: string | null;
+                version: number;
+                visibility: Database["platform"]["Enums"]["visibility"];
+                writer: string;
+            };
+            Insert: {
+                created_at?: string;
+                created_by?: string | null;
+                deleted_at?: string | null;
+                description?: string | null;
+                deselect_by_default?: boolean;
+                id?: string;
+                is_active?: boolean;
+                label: string;
+                metadata?: import("./db-types.js").Json;
+                organization_id: string;
+                prefix: string;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+                writer: string;
+            };
+            Update: {
+                created_at?: string;
+                created_by?: string | null;
+                deleted_at?: string | null;
+                description?: string | null;
+                deselect_by_default?: boolean;
+                id?: string;
+                is_active?: boolean;
+                label?: string;
+                metadata?: import("./db-types.js").Json;
+                organization_id?: string;
+                prefix?: string;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+                writer?: string;
+            };
+            Relationships: [];
+        };
+        overrides: {
+            Row: {
+                created_at: string;
+                created_by: string | null;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                file_id: string;
+                id: string;
+                metadata: import("./db-types.js").Json;
+                notes: string | null;
+                organization_id: string;
+                override_kind: string;
+                override_value: import("./db-types.js").Json;
+                owner_id: string;
+                page_id: string | null;
+                updated_at: string;
+                version: number;
+            };
+            Insert: {
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                file_id: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                notes?: string | null;
+                organization_id: string;
+                override_kind: string;
+                override_value: import("./db-types.js").Json;
+                owner_id: string;
+                page_id?: string | null;
+                updated_at?: string;
+                version?: number;
+            };
+            Update: {
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                file_id?: string;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                notes?: string | null;
+                organization_id?: string;
+                override_kind?: string;
+                override_value?: import("./db-types.js").Json;
+                owner_id?: string;
+                page_id?: string | null;
+                updated_at?: string;
+                version?: number;
+            };
+            Relationships: [{
+                foreignKeyName: "file_overrides_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }, {
+                foreignKeyName: "file_overrides_page_id_fkey";
+                columns: ["page_id"];
+                isOneToOne: false;
+                referencedRelation: "pages";
+                referencedColumns: ["id"];
+            }];
+        };
+        page_annotations: {
+            Row: {
+                bbox: import("./db-types.js").Json;
+                created_at: string;
+                created_by: string | null;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                entity_id: string | null;
+                extracted_text: string | null;
+                extracted_text_source: string;
+                file_id: string;
+                id: string;
+                is_user_locked: boolean;
+                label: string;
+                label_category: string;
+                last_edited_by: string | null;
+                metadata: import("./db-types.js").Json;
+                normalized_value: import("./db-types.js").Json | null;
+                notes: string | null;
+                organization_id: string;
+                owner_id: string;
+                page_id: string | null;
+                page_number: number;
+                parent_result_id: string | null;
+                redact: boolean;
+                redaction_span_id: string | null;
+                source: string;
+                status: string;
+                updated_at: string;
+                version: number;
+            };
+            Insert: {
+                bbox: import("./db-types.js").Json;
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                entity_id?: string | null;
+                extracted_text?: string | null;
+                extracted_text_source?: string;
+                file_id: string;
+                id?: string;
+                is_user_locked?: boolean;
+                label: string;
+                label_category?: string;
+                last_edited_by?: string | null;
+                metadata?: import("./db-types.js").Json;
+                normalized_value?: import("./db-types.js").Json | null;
+                notes?: string | null;
+                organization_id: string;
+                owner_id: string;
+                page_id?: string | null;
+                page_number: number;
+                parent_result_id?: string | null;
+                redact?: boolean;
+                redaction_span_id?: string | null;
+                source?: string;
+                status?: string;
+                updated_at?: string;
+                version?: number;
+            };
+            Update: {
+                bbox?: import("./db-types.js").Json;
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                entity_id?: string | null;
+                extracted_text?: string | null;
+                extracted_text_source?: string;
+                file_id?: string;
+                id?: string;
+                is_user_locked?: boolean;
+                label?: string;
+                label_category?: string;
+                last_edited_by?: string | null;
+                metadata?: import("./db-types.js").Json;
+                normalized_value?: import("./db-types.js").Json | null;
+                notes?: string | null;
+                organization_id?: string;
+                owner_id?: string;
+                page_id?: string | null;
+                page_number?: number;
+                parent_result_id?: string | null;
+                redact?: boolean;
+                redaction_span_id?: string | null;
+                source?: string;
+                status?: string;
+                updated_at?: string;
+                version?: number;
+            };
+            Relationships: [{
+                foreignKeyName: "file_page_annotations_entity_fk";
+                columns: ["entity_id"];
+                isOneToOne: false;
+                referencedRelation: "entities";
+                referencedColumns: ["id"];
+            }, {
+                foreignKeyName: "file_page_annotations_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }, {
+                foreignKeyName: "file_page_annotations_page_id_fkey";
+                columns: ["page_id"];
+                isOneToOne: false;
+                referencedRelation: "pages";
+                referencedColumns: ["id"];
+            }, {
+                foreignKeyName: "file_page_annotations_parent_result_id_fkey";
+                columns: ["parent_result_id"];
+                isOneToOne: false;
+                referencedRelation: "analysis_result";
+                referencedColumns: ["id"];
+            }];
+        };
+        pages: {
+            Row: {
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                excluded_at: string | null;
+                excluded_by: string | null;
+                excluded_reason: string | null;
+                file_id: string;
+                height_pt: number | null;
+                id: string;
+                metadata: import("./db-types.js").Json;
+                ocr_confidence: number | null;
+                organization_id: string;
+                owner_id: string;
+                page_index: number;
+                processed_document_page_id: string | null;
+                rotation: number;
+                source_page_index: number;
+                status: string;
+                text_source: string;
+                thumbnail_url: string | null;
+                updated_at: string;
+                user_modified: boolean;
+                width_pt: number | null;
+            };
+            Insert: {
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                excluded_at?: string | null;
+                excluded_by?: string | null;
+                excluded_reason?: string | null;
+                file_id: string;
+                height_pt?: number | null;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                ocr_confidence?: number | null;
+                organization_id: string;
+                owner_id: string;
+                page_index: number;
+                processed_document_page_id?: string | null;
+                rotation?: number;
+                source_page_index: number;
+                status?: string;
+                text_source?: string;
+                thumbnail_url?: string | null;
+                updated_at?: string;
+                user_modified?: boolean;
+                width_pt?: number | null;
+            };
+            Update: {
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                excluded_at?: string | null;
+                excluded_by?: string | null;
+                excluded_reason?: string | null;
+                file_id?: string;
+                height_pt?: number | null;
+                id?: string;
+                metadata?: import("./db-types.js").Json;
+                ocr_confidence?: number | null;
+                organization_id?: string;
+                owner_id?: string;
+                page_index?: number;
+                processed_document_page_id?: string | null;
+                rotation?: number;
+                source_page_index?: number;
+                status?: string;
+                text_source?: string;
+                thumbnail_url?: string | null;
+                updated_at?: string;
+                user_modified?: boolean;
+                width_pt?: number | null;
+            };
+            Relationships: [{
+                foreignKeyName: "file_pages_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }];
+        };
+        rate_limit_buckets: {
+            Row: {
+                actor_id: string;
+                bucket_kind: string;
+                counter: number;
+                minute_bucket: string;
+            };
+            Insert: {
+                actor_id: string;
+                bucket_kind: string;
+                counter?: number;
+                minute_bucket: string;
+            };
+            Update: {
+                actor_id?: string;
+                bucket_kind?: string;
+                counter?: number;
+                minute_bucket?: string;
+            };
+            Relationships: [];
+        };
+        structure: {
+            Row: {
+                bucket_id: string;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                file_id: string | null;
+                id: string;
+                is_folder: boolean;
+                metadata: import("./db-types.js").Json;
+                name: string;
+                organization_id: string;
+                parent_path: string | null;
+                path: string;
+                updated_at: string | null;
+            };
+            Insert: {
+                bucket_id: string;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                file_id?: string | null;
+                id?: string;
+                is_folder: boolean;
+                metadata?: import("./db-types.js").Json;
+                name: string;
+                organization_id: string;
+                parent_path?: string | null;
+                path: string;
+                updated_at?: string | null;
+            };
+            Update: {
+                bucket_id?: string;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                file_id?: string | null;
+                id?: string;
+                is_folder?: boolean;
+                metadata?: import("./db-types.js").Json;
+                name?: string;
+                organization_id?: string;
+                parent_path?: string | null;
+                path?: string;
+                updated_at?: string | null;
+            };
+            Relationships: [{
+                foreignKeyName: "structure_file_id_fkey";
+                columns: ["file_id"];
+                isOneToOne: false;
+                referencedRelation: "files";
+                referencedColumns: ["id"];
+            }];
+        };
+        sync_mappings: {
+            Row: {
+                bytes_total: number | null;
+                created_at: string;
+                created_by: string | null;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                desired_state: string;
+                device_id: string;
+                direction: string;
+                folder_id: string | null;
+                id: string;
+                items_total: number | null;
+                knobs: import("./db-types.js").Json;
+                last_seen_at: string | null;
+                last_synced_at: string | null;
+                local_path: string;
+                local_path_display: string | null;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                published_to_web: boolean;
+                published_to_web_at: string | null;
+                published_to_web_by: string | null;
+                shown_to: Database["platform"]["Enums"]["shown_to"] | null;
+                state: string;
+                state_changed_at: string | null;
+                state_reason: string | null;
+                updated_at: string;
+                updated_by: string | null;
+                version: number;
+                visibility: Database["platform"]["Enums"]["visibility"];
+            };
+            Insert: {
+                bytes_total?: number | null;
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                desired_state?: string;
+                device_id: string;
+                direction?: string;
+                folder_id?: string | null;
+                id?: string;
+                items_total?: number | null;
+                knobs?: import("./db-types.js").Json;
+                last_seen_at?: string | null;
+                last_synced_at?: string | null;
+                local_path: string;
+                local_path_display?: string | null;
+                metadata?: import("./db-types.js").Json;
+                organization_id: string;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                state?: string;
+                state_changed_at?: string | null;
+                state_reason?: string | null;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+            };
+            Update: {
+                bytes_total?: number | null;
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                desired_state?: string;
+                device_id?: string;
+                direction?: string;
+                folder_id?: string | null;
+                id?: string;
+                items_total?: number | null;
+                knobs?: import("./db-types.js").Json;
+                last_seen_at?: string | null;
+                last_synced_at?: string | null;
+                local_path?: string;
+                local_path_display?: string | null;
+                metadata?: import("./db-types.js").Json;
+                organization_id?: string;
+                published_to_web?: boolean;
+                published_to_web_at?: string | null;
+                published_to_web_by?: string | null;
+                shown_to?: Database["platform"]["Enums"]["shown_to"] | null;
+                state?: string;
+                state_changed_at?: string | null;
+                state_reason?: string | null;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+                visibility?: Database["platform"]["Enums"]["visibility"];
+            };
+            Relationships: [{
+                foreignKeyName: "sync_mappings_folder_id_fkey";
+                columns: ["folder_id"];
+                isOneToOne: false;
+                referencedRelation: "folders";
+                referencedColumns: ["id"];
+            }];
+        };
+        uploads_inflight: {
+            Row: {
+                bucket: string;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                expires_at: string;
+                file_id: string;
+                file_name: string;
+                file_path: string;
+                id: string;
+                idempotency_key: string | null;
+                key: string;
+                metadata: import("./db-types.js").Json;
+                mime_type: string | null;
+                multipart_upload_id: string;
+                owner_id: string;
+                parts: import("./db-types.js").Json;
+                status: string;
+                updated_at: string;
+                upload_length: number;
+                upload_offset: number;
+                visibility: string;
+            };
+            Insert: {
+                bucket: string;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                expires_at?: string;
+                file_id: string;
+                file_name: string;
+                file_path: string;
+                id?: string;
+                idempotency_key?: string | null;
+                key: string;
+                metadata?: import("./db-types.js").Json;
+                mime_type?: string | null;
+                multipart_upload_id: string;
+                owner_id: string;
+                parts?: import("./db-types.js").Json;
+                status?: string;
+                updated_at?: string;
+                upload_length: number;
+                upload_offset?: number;
+                visibility?: string;
+            };
+            Update: {
+                bucket?: string;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                expires_at?: string;
+                file_id?: string;
+                file_name?: string;
+                file_path?: string;
+                id?: string;
+                idempotency_key?: string | null;
+                key?: string;
+                metadata?: import("./db-types.js").Json;
+                mime_type?: string | null;
+                multipart_upload_id?: string;
+                owner_id?: string;
+                parts?: import("./db-types.js").Json;
+                status?: string;
+                updated_at?: string;
+                upload_length?: number;
+                upload_offset?: number;
+                visibility?: string;
+            };
+            Relationships: [];
+        };
+        user_account: {
+            Row: {
+                blocked_reason: string | null;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                custom_limits: import("./db-types.js").Json;
+                is_blocked: boolean;
+                metadata: import("./db-types.js").Json;
+                notes: string | null;
+                tier_id: string;
+                updated_at: string;
+                user_id: string;
+            };
+            Insert: {
+                blocked_reason?: string | null;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                custom_limits?: import("./db-types.js").Json;
+                is_blocked?: boolean;
+                metadata?: import("./db-types.js").Json;
+                notes?: string | null;
+                tier_id: string;
+                updated_at?: string;
+                user_id: string;
+            };
+            Update: {
+                blocked_reason?: string | null;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                custom_limits?: import("./db-types.js").Json;
+                is_blocked?: boolean;
+                metadata?: import("./db-types.js").Json;
+                notes?: string | null;
+                tier_id?: string;
+                updated_at?: string;
+                user_id?: string;
+            };
+            Relationships: [{
+                foreignKeyName: "cld_user_account_tier_id_fkey";
+                columns: ["tier_id"];
+                isOneToOne: false;
+                referencedRelation: "account_tiers";
+                referencedColumns: ["tier_key"];
+            }];
+        };
+        user_storage_usage: {
+            Row: {
+                bytes_used: number;
+                custom_fields: import("./db-types.js").Json;
+                daily_reset_at: string;
+                daily_upload_bytes: number;
+                daily_upload_count: number;
+                files_count: number;
+                updated_at: string;
+                user_id: string;
+            };
+            Insert: {
+                bytes_used?: number;
+                custom_fields?: import("./db-types.js").Json;
+                daily_reset_at?: string;
+                daily_upload_bytes?: number;
+                daily_upload_count?: number;
+                files_count?: number;
+                updated_at?: string;
+                user_id: string;
+            };
+            Update: {
+                bytes_used?: number;
+                custom_fields?: import("./db-types.js").Json;
+                daily_reset_at?: string;
+                daily_upload_bytes?: number;
+                daily_upload_count?: number;
+                files_count?: number;
+                updated_at?: string;
+                user_id?: string;
+            };
+            Relationships: [];
+        };
+        webhook_deliveries: {
+            Row: {
+                activity_log_id: number | null;
+                attempt: number;
+                completed_at: string | null;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                dispatched_at: string | null;
+                error_message: string | null;
+                http_status: number | null;
+                id: string;
+                latency_ms: number | null;
+                metadata: import("./db-types.js").Json;
+                net_request_id: number | null;
+                next_attempt_at: string | null;
+                organization_id: string;
+                signature: string | null;
+                status: string;
+                webhook_id: string;
+            };
+            Insert: {
+                activity_log_id?: number | null;
+                attempt?: number;
+                completed_at?: string | null;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                dispatched_at?: string | null;
+                error_message?: string | null;
+                http_status?: number | null;
+                id?: string;
+                latency_ms?: number | null;
+                metadata?: import("./db-types.js").Json;
+                net_request_id?: number | null;
+                next_attempt_at?: string | null;
+                organization_id: string;
+                signature?: string | null;
+                status?: string;
+                webhook_id: string;
+            };
+            Update: {
+                activity_log_id?: number | null;
+                attempt?: number;
+                completed_at?: string | null;
+                created_at?: string;
+                custom_fields?: import("./db-types.js").Json;
+                dispatched_at?: string | null;
+                error_message?: string | null;
+                http_status?: number | null;
+                id?: string;
+                latency_ms?: number | null;
+                metadata?: import("./db-types.js").Json;
+                net_request_id?: number | null;
+                next_attempt_at?: string | null;
+                organization_id?: string;
+                signature?: string | null;
+                status?: string;
+                webhook_id?: string;
+            };
+            Relationships: [{
+                foreignKeyName: "cld_webhook_deliveries_webhook_id_fkey";
+                columns: ["webhook_id"];
+                isOneToOne: false;
+                referencedRelation: "webhooks";
+                referencedColumns: ["id"];
+            }];
+        };
+        webhook_dispatch_state: {
+            Row: {
+                id: boolean;
+                last_activity_log_id: number;
+                updated_at: string;
+            };
+            Insert: {
+                id?: boolean;
+                last_activity_log_id?: number;
+                updated_at?: string;
+            };
+            Update: {
+                id?: boolean;
+                last_activity_log_id?: number;
+                updated_at?: string;
+            };
+            Relationships: [];
+        };
+        webhooks: {
+            Row: {
+                consecutive_failures: number;
+                created_at: string;
+                created_by: string | null;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                description: string | null;
+                event_types: string[] | null;
+                id: string;
+                is_active: boolean;
+                last_attempt_at: string | null;
+                last_success_at: string | null;
+                max_consecutive_failures: number;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                resource_types: string[] | null;
+                secret: string;
+                target_url: string;
+                updated_at: string;
+                updated_by: string | null;
+                version: number;
+            };
+            Insert: {
+                consecutive_failures?: number;
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                description?: string | null;
+                event_types?: string[] | null;
+                id?: string;
+                is_active?: boolean;
+                last_attempt_at?: string | null;
+                last_success_at?: string | null;
+                max_consecutive_failures?: number;
+                metadata?: import("./db-types.js").Json;
+                organization_id: string;
+                resource_types?: string[] | null;
+                secret: string;
+                target_url: string;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+            };
+            Update: {
+                consecutive_failures?: number;
+                created_at?: string;
+                created_by?: string | null;
+                custom_fields?: import("./db-types.js").Json;
+                deleted_at?: string | null;
+                description?: string | null;
+                event_types?: string[] | null;
+                id?: string;
+                is_active?: boolean;
+                last_attempt_at?: string | null;
+                last_success_at?: string | null;
+                max_consecutive_failures?: number;
+                metadata?: import("./db-types.js").Json;
+                organization_id?: string;
+                resource_types?: string[] | null;
+                secret?: string;
+                target_url?: string;
+                updated_at?: string;
+                updated_by?: string | null;
+                version?: number;
+            };
+            Relationships: [];
+        };
+    };
+    Views: {
+        sync_mapping_admin_status: {
+            Row: {
+                bytes_total: number | null;
+                created_at: string | null;
+                desired_state: string | null;
+                device_id: string | null;
+                direction: string | null;
+                id: string | null;
+                items_total: number | null;
+                last_seen_at: string | null;
+                last_synced_at: string | null;
+                organization_id: string | null;
+                state: string | null;
+                state_changed_at: string | null;
+                user_id: string | null;
+            };
+            Insert: {
+                bytes_total?: number | null;
+                created_at?: string | null;
+                desired_state?: string | null;
+                device_id?: string | null;
+                direction?: string | null;
+                id?: string | null;
+                items_total?: number | null;
+                last_seen_at?: string | null;
+                last_synced_at?: string | null;
+                organization_id?: string | null;
+                state?: string | null;
+                state_changed_at?: string | null;
+                user_id?: string | null;
+            };
+            Update: {
+                bytes_total?: number | null;
+                created_at?: string | null;
+                desired_state?: string | null;
+                device_id?: string | null;
+                direction?: string | null;
+                id?: string | null;
+                items_total?: number | null;
+                last_seen_at?: string | null;
+                last_synced_at?: string | null;
+                organization_id?: string | null;
+                state?: string | null;
+                state_changed_at?: string | null;
+                user_id?: string | null;
+            };
+            Relationships: [];
+        };
+    };
+    Functions: {
+        _adopt_chat_attachment_ids: {
+            Args: {
+                p_conversation_id: string;
+                p_file_ids: string[];
+            };
+            Returns: number;
+        };
+        _adopt_chat_output_ids: {
+            Args: {
+                p_conversation_id: string;
+                p_file_ids: string[];
+            };
+            Returns: number;
+        };
+        assert_safe_file_name: {
+            Args: {
+                p_max_segment?: number;
+                p_raw: string;
+            };
+            Returns: string;
+        };
+        assert_storable_file_name: {
+            Args: {
+                p_max_segment?: number;
+                p_raw: string;
+            };
+            Returns: string;
+        };
+        chat_file_ids_in: {
+            Args: {
+                p_text: string;
+            };
+            Returns: string[];
+        };
+        crawl_site_conveys: {
+            Args: {
+                p_file_id: string;
+                p_user_id: string;
+            };
+            Returns: boolean;
+        };
+        crawl_variant_tagging_drift: {
+            Args: never;
+            Returns: {
+                bad_visibility: boolean;
+                master_id: string;
+                missing_tags: boolean;
+                org_mismatch: boolean;
+                variant_id: string;
+            }[];
+        };
+        file_path_matches_parent: {
+            Args: {
+                p_file_id: string;
+            };
+            Returns: boolean;
+        };
+        has_access_for: {
+            Args: {
+                p_file_id: string;
+                p_required?: Database["public"]["Enums"]["permission_level"];
+                p_user_id: string;
+            };
+            Returns: boolean;
+        };
+        is_crawl_artifact: {
+            Args: {
+                p_file_id: string;
+            };
+            Returns: boolean;
+        };
+        is_dictation_chunk: {
+            Args: {
+                p_file_name: string;
+                p_file_path: string;
+                p_metadata: import("./db-types.js").Json;
+            };
+            Returns: boolean;
+        };
+        is_discoverable_for: {
+            Args: {
+                p_file_id: string;
+                p_required?: Database["public"]["Enums"]["permission_level"];
+                p_user_id: string;
+            };
+            Returns: boolean;
+        };
+        is_listable_for: {
+            Args: {
+                p_file_id: string;
+                p_user_id: string;
+            };
+            Returns: boolean;
+        };
+        is_recent_activity: {
+            Args: {
+                p_row: Database["files"]["Tables"]["files"]["Row"];
+            };
+            Returns: boolean;
+        };
+        is_recent_activity_path: {
+            Args: {
+                p_file_path: string;
+            };
+            Returns: boolean;
+        };
+        is_safe_webhook_url: {
+            Args: {
+                p_url: string;
+            };
+            Returns: boolean;
+        };
+        is_user_visible: {
+            Args: {
+                p_row: Database["files"]["Tables"]["files"]["Row"];
+            };
+            Returns: boolean;
+        };
+        is_user_visible_folder_path: {
+            Args: {
+                p_folder_path: string;
+            };
+            Returns: boolean;
+        };
+        is_user_visible_path: {
+            Args: {
+                p_file_path: string;
+            };
+            Returns: boolean;
+        };
+        is_user_visible_paths: {
+            Args: {
+                p_paths: string[];
+            };
+            Returns: import("./db-types.js").Json;
+        };
+        min_tombstone_retention_days: {
+            Args: never;
+            Returns: number;
+        };
+        my_rag_jobs: {
+            Args: {
+                p_status?: string;
+            };
+            Returns: {
+                attempt_count: number;
+                completed_at: string | null;
+                created_at: string;
+                custom_fields: import("./db-types.js").Json;
+                error: import("./db-types.js").Json | null;
+                file_id: string;
+                id: string;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                scheduled_for: string;
+                skipped_reason: string | null;
+                started_at: string | null;
+                status: string;
+                trigger_source: string;
+                updated_at: string;
+                user_id: string;
+            }[];
+            SetofOptions: {
+                from: "*";
+                to: "file_rag_jobs";
+                isOneToOne: false;
+                isSetofReturn: true;
+            };
+        };
+        private_children_missing_parent: {
+            Args: never;
+            Returns: {
+                check_name: string;
+                file_id: string;
+                parent_id: string;
+                parent_type: string;
+            }[];
+        };
+        ultimate_parent_record: {
+            Args: {
+                p_file_id: string;
+            };
+            Returns: Record<string, unknown>;
+        };
+        webhook_create: {
+            Args: {
+                p_description?: string;
+                p_event_types?: string[];
+                p_organization_id: string;
+                p_resource_types?: string[];
+                p_target_url: string;
+            };
+            Returns: {
+                consecutive_failures: number;
+                created_at: string;
+                created_by: string | null;
+                custom_fields: import("./db-types.js").Json;
+                deleted_at: string | null;
+                description: string | null;
+                event_types: string[] | null;
+                id: string;
+                is_active: boolean;
+                last_attempt_at: string | null;
+                last_success_at: string | null;
+                max_consecutive_failures: number;
+                metadata: import("./db-types.js").Json;
+                organization_id: string;
+                resource_types: string[] | null;
+                secret: string;
+                target_url: string;
+                updated_at: string;
+                updated_by: string | null;
+                version: number;
+            };
+            SetofOptions: {
+                from: "*";
+                to: "webhooks";
+                isOneToOne: true;
+                isSetofReturn: false;
+            };
+        };
+        webhook_dispatch: {
+            Args: {
+                p_limit?: number;
+            };
+            Returns: number;
+        };
+        webhook_event_payload: {
+            Args: {
+                p_event_id: number;
+                p_webhook_id: string;
+            };
+            Returns: import("./db-types.js").Json;
+        };
+        webhook_reconcile: {
+            Args: never;
+            Returns: number;
+        };
+        webhook_redeliver: {
+            Args: {
+                p_delivery_id: string;
+            };
+            Returns: string;
+        };
+        webhook_rotate_secret: {
+            Args: {
+                p_webhook_id: string;
+            };
+            Returns: string;
+        };
+        webhook_send_test: {
+            Args: {
+                p_webhook_id: string;
+            };
+            Returns: string;
+        };
+        webhook_sign: {
+            Args: {
+                p_payload: string;
+                p_secret: string;
+            };
+            Returns: string;
+        };
+        webhook_tick: {
+            Args: never;
+            Returns: undefined;
+        };
+    };
+    Enums: { [_ in never]: never; };
+    CompositeTypes: { [_ in never]: never; };
+}>;
+/**
+ * The ONLY legal column list for reading `files.files` from the client.
+ *
+ * `storage_uri` (the native S3 location) is server-only: the column grant is
+ * REVOKEd from `authenticated`, so `select("*")` on `files.files` ERRORS with
+ * "permission denied for column storage_uri". Never select `*` on this table
+ * and never add `storage_uri` here. Renderable URLs come from the server's
+ * FileRecord/FileRef URL contract (`url` / `cdn_url` / `download_url`),
+ * never assembled client-side from a storage location.
+ */
+export declare const FILES_TABLE_COLUMNS = "id, created_by, updated_by, version, file_path, file_name, mime_type, size_bytes, checksum, visibility, current_version, parent_folder_id, metadata, created_at, updated_at, deleted_at, organization_id, parent_file_id, derivation_kind, derivation_metadata, duplicate_of_file_id, canonical_processed_document_id, width, height, duration_ms, origin_device_id, artifact_kind";
+/**
+ * Same rule for `files.file_versions` — its `storage_uri` is server-only.
+ * Version bytes download via the server (`/files/{id}/versions/{n}/download`).
+ */
+export declare const FILE_VERSIONS_TABLE_COLUMNS = "id, file_id, version_number, size_bytes, checksum, created_by, created_at, change_summary, organization_id, metadata";
+/**
+ * Read one complete, RLS-authorized file row by durable identity.
+ *
+ * REST `FileRecord` is a render/navigation envelope and historically omitted
+ * the owning organization. Mutation preparation must use this canonical DB
+ * row so a path-targeted version write can preserve ownership exactly.
+ */
+export declare function readFileRowById<C extends SupabaseClient<Database>>(client: C, fileId: string): Promise<{
+    id: string;
+    created_by: string;
+    updated_by: string | null;
+    version: number;
+    file_path: string;
+    file_name: string;
+    mime_type: string | null;
+    size_bytes: number | null;
+    checksum: string | null;
+    visibility: "personal" | "internal" | "link" | "public";
+    current_version: number;
+    parent_folder_id: string | null;
+    metadata: unknown;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+    organization_id: string;
+    parent_file_id: string | null;
+    derivation_kind: string | null;
+    derivation_metadata: unknown;
+    duplicate_of_file_id: string | null;
+    canonical_processed_document_id: string | null;
+    width: number | null;
+    height: number | null;
+    duration_ms: number | null;
+    origin_device_id: string | null;
+    artifact_kind: string | null;
+} | null>;
+/**
+ * Batch-read just the byte size for a set of file ids, RLS-authorized like
+ * every other read here.
+ *
+ * Built for a source list that names files by id (a Rulebook's attached
+ * sources, a resource pile) and needs to show — before any run touches
+ * them — which of those files are genuinely empty. `size_bytes` alone (no
+ * `storage_uri`, no need for the single-row reader's full column list) keeps
+ * this cheap enough to call for a whole pile at once.
+ */
+export declare function readFileSizesByIds<C extends SupabaseClient<Database>>(client: C, fileIds: string[]): Promise<Map<string, number | null>>;