@ourofoundation/ouro-js 3.5.0 → 3.5.2

package/dist/schema/datasets.d.cts

@@ -1,5 +1,98 @@
 import { z } from 'zod';
 
+/**
+ * Per-column asset reference declarations.
+ *
+ * A column becomes an asset reference when the backend adds a real Postgres FK
+ * to public.assets(id). The optional asset_type refines validation/display.
+ */
+declare const DatasetAssetRefsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    asset_type: z.ZodOptional<z.ZodEnum<{
+        organization: "organization";
+        file: "file";
+        user: "user";
+        team: "team";
+        dataset: "dataset";
+        service: "service";
+        route: "route";
+        post: "post";
+        quest: "quest";
+        comment: "comment";
+        conversation: "conversation";
+    }>>;
+}, z.core.$strip>>;
+/**
+ * A single column from GET /datasets/:id/schema, enriched server-side.
+ *
+ * The FK fields come straight from get_table_schema. `semantic_type` is pure
+ * inference: "asset_ref" when the column has an FK to public.assets. The
+ * optional `asset_type` is the declared target-type hint from
+ * metadata.asset_refs (display + soft validation only).
+ */
+declare const EnrichedDatasetSchemaFieldSchema: z.ZodObject<{
+    column_name: z.ZodString;
+    data_type: z.ZodString;
+    fk_constraint_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    foreign_table_schema: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    foreign_table_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    foreign_column_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    semantic_type: z.ZodOptional<z.ZodNullable<z.ZodLiteral<"asset_ref">>>;
+    asset_type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        organization: "organization";
+        file: "file";
+        user: "user";
+        team: "team";
+        dataset: "dataset";
+        service: "service";
+        route: "route";
+        post: "post";
+        quest: "quest";
+        comment: "comment";
+        conversation: "conversation";
+    }>>>;
+}, z.core.$strip>;
+/**
+ * A resolved asset reference returned in the `resolved_asset_refs` sidecar of
+ * GET /datasets/:id/data?resolve_asset_refs=true. Reuses the platform-wide
+ * { asset_id, asset_type } vocabulary (see KeyedAssetRefsSchema).
+ */
+declare const ResolvedAssetRefSchema: z.ZodObject<{
+    asset_id: z.ZodUUID;
+    asset_type: z.ZodEnum<{
+        organization: "organization";
+        file: "file";
+        user: "user";
+        team: "team";
+        dataset: "dataset";
+        service: "service";
+        route: "route";
+        post: "post";
+        quest: "quest";
+        comment: "comment";
+        conversation: "conversation";
+    }>;
+    name: z.ZodNullable<z.ZodString>;
+    web_url: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** column -> (referenced uuid -> resolved asset). */
+declare const ResolvedAssetRefsSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+    asset_id: z.ZodUUID;
+    asset_type: z.ZodEnum<{
+        organization: "organization";
+        file: "file";
+        user: "user";
+        team: "team";
+        dataset: "dataset";
+        service: "service";
+        route: "route";
+        post: "post";
+        quest: "quest";
+        comment: "comment";
+        conversation: "conversation";
+    }>;
+    name: z.ZodNullable<z.ZodString>;
+    web_url: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>>;
 declare const DatasetSchema: z.ZodObject<{
     id: z.ZodUUID;
     user_id: z.ZodUUID;
@@ -108,9 +201,9 @@ declare const DatasetSchema: z.ZodObject<{
             none: "none";
         }>>;
         visibility: z.ZodOptional<z.ZodEnum<{
-            organization: "organization";
             public: "public";
             private: "private";
+            organization: "organization";
             monetized: "monetized";
             inherit: "inherit";
         }>>;
@@ -182,9 +275,9 @@ declare const DatasetSchema: z.ZodObject<{
         text: z.ZodString;
     }, z.core.$strip>>>;
     visibility: z.ZodEnum<{
-        organization: "organization";
         public: "public";
         private: "private";
+        organization: "organization";
         monetized: "monetized";
         inherit: "inherit";
     }>;
@@ -209,15 +302,16 @@ declare const DatasetSchema: z.ZodObject<{
     stripe_meter_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     state: z.ZodEnum<{
         success: "success";
+        error: "error";
         queued: "queued";
         "in-progress": "in-progress";
         "timed-out": "timed-out";
-        error: "error";
     }>;
     source: z.ZodEnum<{
-        api: "api";
         web: "web";
+        api: "api";
     }>;
+    is_pinned_in_team: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     created_at: z.ZodString;
     last_updated: z.ZodString;
     asset_type: z.ZodDefault<z.ZodLiteral<"dataset">>;
@@ -225,6 +319,21 @@ declare const DatasetSchema: z.ZodObject<{
         table_name: z.ZodString;
         schema: z.ZodDefault<z.ZodLiteral<"datasets">>;
         columns: z.ZodArray<z.ZodString>;
+        asset_refs: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+            asset_type: z.ZodOptional<z.ZodEnum<{
+                organization: "organization";
+                file: "file";
+                user: "user";
+                team: "team";
+                dataset: "dataset";
+                service: "service";
+                route: "route";
+                post: "post";
+                quest: "quest";
+                comment: "comment";
+                conversation: "conversation";
+            }>>;
+        }, z.core.$strip>>>>;
         doi_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         external_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         paper_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -251,15 +360,15 @@ declare const DatasetSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     parent: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        json: z.ZodRecord<z.ZodString, z.ZodAny>;
-        text: z.ZodString;
-    }, z.core.$strip>>>>;
     monetization: z.ZodOptional<z.ZodEnum<{
         none: "none";
         "pay-to-unlock": "pay-to-unlock";
         "pay-per-use": "pay-per-use";
     }>>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        json: z.ZodRecord<z.ZodString, z.ZodAny>;
+        text: z.ZodString;
+    }, z.core.$strip>>>>;
     parent_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUUID>>>;
     license_id: z.ZodOptional<z.ZodString>;
     price: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
@@ -283,19 +392,19 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     name_url_slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         success: "success";
+        error: "error";
         queued: "queued";
         "in-progress": "in-progress";
         "timed-out": "timed-out";
-        error: "error";
     }>>>;
     source: z.ZodDefault<z.ZodEnum<{
-        api: "api";
         web: "web";
+        api: "api";
     }>>;
     visibility: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        organization: "organization";
         public: "public";
         private: "private";
+        organization: "organization";
         monetized: "monetized";
         inherit: "inherit";
     }>>>;
@@ -306,6 +415,21 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
         table_name: z.ZodString;
         schema: z.ZodDefault<z.ZodLiteral<"datasets">>;
         columns: z.ZodArray<z.ZodString>;
+        asset_refs: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+            asset_type: z.ZodOptional<z.ZodEnum<{
+                organization: "organization";
+                file: "file";
+                user: "user";
+                team: "team";
+                dataset: "dataset";
+                service: "service";
+                route: "route";
+                post: "post";
+                quest: "quest";
+                comment: "comment";
+                conversation: "conversation";
+            }>>;
+        }, z.core.$strip>>>>;
         doi_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         external_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         paper_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -334,9 +458,9 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     team_id: string | null;
     org_id: string | null;
     name: string;
-    state: "success" | "queued" | "in-progress" | "timed-out" | "error";
-    source: "api" | "web";
-    visibility: "organization" | "public" | "private" | "monetized" | "inherit";
+    state: "success" | "error" | "queued" | "in-progress" | "timed-out";
+    source: "web" | "api";
+    visibility: "public" | "private" | "organization" | "monetized" | "inherit";
     created_at: string;
     last_updated: string;
     asset_type: "dataset";
@@ -351,6 +475,9 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
         name: string;
         id: string;
         bucket: "public-files" | "files";
+        asset_refs?: Record<string, {
+            asset_type?: "organization" | "file" | "user" | "team" | "dataset" | "service" | "route" | "post" | "quest" | "comment" | "conversation" | undefined;
+        }> | null | undefined;
         doi_url?: string | null | undefined;
         external_url?: string | null | undefined;
         paper_url?: string | null | undefined;
@@ -361,11 +488,11 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     };
     preview: Record<string, any>[];
     parent?: Record<string, any> | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     price?: number | null | undefined;
@@ -382,9 +509,9 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     team_id: string | null;
     org_id: string | null;
     name: string;
-    state: "success" | "queued" | "in-progress" | "timed-out" | "error";
-    source: "api" | "web";
-    visibility: "organization" | "public" | "private" | "monetized" | "inherit";
+    state: "success" | "error" | "queued" | "in-progress" | "timed-out";
+    source: "web" | "api";
+    visibility: "public" | "private" | "organization" | "monetized" | "inherit";
     created_at: string;
     last_updated: string;
     asset_type: "dataset";
@@ -399,6 +526,9 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
         name: string;
         id: string;
         bucket: "public-files" | "files";
+        asset_refs?: Record<string, {
+            asset_type?: "organization" | "file" | "user" | "team" | "dataset" | "service" | "route" | "post" | "quest" | "comment" | "conversation" | undefined;
+        }> | null | undefined;
         doi_url?: string | null | undefined;
         external_url?: string | null | undefined;
         paper_url?: string | null | undefined;
@@ -409,11 +539,11 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
     };
     preview: Record<string, any>[];
     parent?: Record<string, any> | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     price?: number | null | undefined;
@@ -428,15 +558,15 @@ declare const CreateDatasetFromFileSchema: z.ZodPipe<z.ZodObject<{
 }>>;
 declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     parent: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        json: z.ZodRecord<z.ZodString, z.ZodAny>;
-        text: z.ZodString;
-    }, z.core.$strip>>>>;
     monetization: z.ZodOptional<z.ZodEnum<{
         none: "none";
         "pay-to-unlock": "pay-to-unlock";
         "pay-per-use": "pay-per-use";
     }>>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        json: z.ZodRecord<z.ZodString, z.ZodAny>;
+        text: z.ZodString;
+    }, z.core.$strip>>>>;
     parent_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUUID>>>;
     license_id: z.ZodOptional<z.ZodString>;
     price: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
@@ -460,19 +590,19 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     name_url_slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         success: "success";
+        error: "error";
         queued: "queued";
         "in-progress": "in-progress";
         "timed-out": "timed-out";
-        error: "error";
     }>>>;
     source: z.ZodDefault<z.ZodEnum<{
-        api: "api";
         web: "web";
+        api: "api";
     }>>;
     visibility: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        organization: "organization";
         public: "public";
         private: "private";
+        organization: "organization";
         monetized: "monetized";
         inherit: "inherit";
     }>>>;
@@ -483,6 +613,21 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
         table_name: z.ZodString;
         schema: z.ZodDefault<z.ZodLiteral<"datasets">>;
         columns: z.ZodArray<z.ZodString>;
+        asset_refs: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+            asset_type: z.ZodOptional<z.ZodEnum<{
+                organization: "organization";
+                file: "file";
+                user: "user";
+                team: "team";
+                dataset: "dataset";
+                service: "service";
+                route: "route";
+                post: "post";
+                quest: "quest";
+                comment: "comment";
+                conversation: "conversation";
+            }>>;
+        }, z.core.$strip>>>>;
         doi_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         external_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         paper_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -501,9 +646,9 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     team_id: string | null;
     org_id: string | null;
     name: string;
-    state: "success" | "queued" | "in-progress" | "timed-out" | "error";
-    source: "api" | "web";
-    visibility: "organization" | "public" | "private" | "monetized" | "inherit";
+    state: "success" | "error" | "queued" | "in-progress" | "timed-out";
+    source: "web" | "api";
+    visibility: "public" | "private" | "organization" | "monetized" | "inherit";
     created_at: string;
     last_updated: string;
     asset_type: "dataset";
@@ -511,6 +656,9 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
         table_name: string;
         schema: "datasets";
         columns: string[];
+        asset_refs?: Record<string, {
+            asset_type?: "organization" | "file" | "user" | "team" | "dataset" | "service" | "route" | "post" | "quest" | "comment" | "conversation" | undefined;
+        }> | null | undefined;
         doi_url?: string | null | undefined;
         external_url?: string | null | undefined;
         paper_url?: string | null | undefined;
@@ -521,11 +669,11 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     };
     preview: Record<string, any>[];
     parent?: Record<string, any> | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     price?: number | null | undefined;
@@ -542,9 +690,9 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     team_id: string | null;
     org_id: string | null;
     name: string;
-    state: "success" | "queued" | "in-progress" | "timed-out" | "error";
-    source: "api" | "web";
-    visibility: "organization" | "public" | "private" | "monetized" | "inherit";
+    state: "success" | "error" | "queued" | "in-progress" | "timed-out";
+    source: "web" | "api";
+    visibility: "public" | "private" | "organization" | "monetized" | "inherit";
     created_at: string;
     last_updated: string;
     asset_type: "dataset";
@@ -552,6 +700,9 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
         table_name: string;
         schema: "datasets";
         columns: string[];
+        asset_refs?: Record<string, {
+            asset_type?: "organization" | "file" | "user" | "team" | "dataset" | "service" | "route" | "post" | "quest" | "comment" | "conversation" | undefined;
+        }> | null | undefined;
         doi_url?: string | null | undefined;
         external_url?: string | null | undefined;
         paper_url?: string | null | undefined;
@@ -562,11 +713,11 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     };
     preview: Record<string, any>[];
     parent?: Record<string, any> | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     price?: number | null | undefined;
@@ -580,51 +731,18 @@ declare const CreateDatasetFromSchemaSchema: z.ZodPipe<z.ZodObject<{
     name_url_slug?: string | null | undefined;
 }>>;
 declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
-    org_id: z.ZodOptional<z.ZodUUID>;
     parent: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-    metadata: z.ZodOptional<z.ZodObject<{
-        table_name: z.ZodString;
-        schema: z.ZodDefault<z.ZodLiteral<"datasets">>;
-        columns: z.ZodArray<z.ZodString>;
-        doi_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        external_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        paper_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        github_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        originality: z.ZodOptional<z.ZodEnum<{
-            original: "original";
-            derivative: "derivative";
-            "third-party": "third-party";
-        }>>;
-        source: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        reply_to_comment_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-        type: z.ZodOptional<z.ZodString>;
-        size: z.ZodOptional<z.ZodNumber>;
-        path: z.ZodOptional<z.ZodString>;
-        extension: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        id: z.ZodOptional<z.ZodUUID>;
-        bucket: z.ZodOptional<z.ZodEnum<{
-            "public-files": "public-files";
-            files: "files";
-        }>>;
-    }, z.core.$strip>>;
-    name: z.ZodOptional<z.ZodString>;
-    team_id: z.ZodOptional<z.ZodUUID>;
+    source: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        api: "api";
+    }>>;
     visibility: z.ZodOptional<z.ZodEnum<{
-        organization: "organization";
         public: "public";
         private: "private";
+        organization: "organization";
         monetized: "monetized";
         inherit: "inherit";
     }>>;
-    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        json: z.ZodRecord<z.ZodString, z.ZodAny>;
-        text: z.ZodString;
-    }, z.core.$strip>>>>;
-    source: z.ZodOptional<z.ZodEnum<{
-        api: "api";
-        web: "web";
-    }>>;
     monetization: z.ZodOptional<z.ZodEnum<{
         none: "none";
         "pay-to-unlock": "pay-to-unlock";
@@ -632,11 +750,18 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
     }>>;
     state: z.ZodOptional<z.ZodEnum<{
         success: "success";
+        error: "error";
         queued: "queued";
         "in-progress": "in-progress";
         "timed-out": "timed-out";
-        error: "error";
     }>>;
+    name: z.ZodOptional<z.ZodString>;
+    org_id: z.ZodOptional<z.ZodUUID>;
+    team_id: z.ZodOptional<z.ZodUUID>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        json: z.ZodRecord<z.ZodString, z.ZodAny>;
+        text: z.ZodString;
+    }, z.core.$strip>>>>;
     parent_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUUID>>>;
     license_id: z.ZodOptional<z.ZodString>;
     license: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
@@ -655,18 +780,84 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
     stripe_product_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     stripe_price_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     stripe_meter_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        table_name: z.ZodString;
+        schema: z.ZodDefault<z.ZodLiteral<"datasets">>;
+        columns: z.ZodArray<z.ZodString>;
+        asset_refs: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+            asset_type: z.ZodOptional<z.ZodEnum<{
+                organization: "organization";
+                file: "file";
+                user: "user";
+                team: "team";
+                dataset: "dataset";
+                service: "service";
+                route: "route";
+                post: "post";
+                quest: "quest";
+                comment: "comment";
+                conversation: "conversation";
+            }>>;
+        }, z.core.$strip>>>>;
+        doi_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        external_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        paper_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        github_url: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        originality: z.ZodOptional<z.ZodEnum<{
+            original: "original";
+            derivative: "derivative";
+            "third-party": "third-party";
+        }>>;
+        source: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        reply_to_comment_id: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        type: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        path: z.ZodOptional<z.ZodString>;
+        extension: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodUUID>;
+        bucket: z.ZodOptional<z.ZodEnum<{
+            "public-files": "public-files";
+            files: "files";
+        }>>;
+    }, z.core.$strip>>;
     preview: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
     asset_type: z.ZodDefault<z.ZodLiteral<"dataset">>;
     last_updated: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>, z.ZodTransform<{
     asset_type: "dataset";
     last_updated: string;
-    org_id?: string | undefined;
     parent?: Record<string, any> | undefined;
+    source?: "web" | "api" | undefined;
+    visibility?: "public" | "private" | "organization" | "monetized" | "inherit" | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
+    state?: "success" | "error" | "queued" | "in-progress" | "timed-out" | undefined;
+    name?: string | undefined;
+    org_id?: string | undefined;
+    team_id?: string | undefined;
+    description?: {
+        json: Record<string, any>;
+        text: string;
+    } | null | undefined;
+    parent_id?: string | null | undefined;
+    license_id?: string | undefined;
+    license?: Record<string, any> | undefined;
+    name_url_slug?: string | null | undefined;
+    price?: number | null | undefined;
+    unit_cost?: number | null | undefined;
+    cost_accounting?: "fixed" | "variable" | null | undefined;
+    cost_unit?: string | null | undefined;
+    price_currency?: "usd" | "btc" | undefined;
+    stripe_product_id?: string | null | undefined;
+    stripe_price_id?: string | null | undefined;
+    stripe_meter_id?: string | null | undefined;
     metadata?: {
         table_name: string;
         schema: "datasets";
         columns: string[];
+        asset_refs?: Record<string, {
+            asset_type?: "organization" | "file" | "user" | "team" | "dataset" | "service" | "route" | "post" | "quest" | "comment" | "conversation" | undefined;
+        }> | null | undefined;
         doi_url?: string | null | undefined;
         external_url?: string | null | undefined;
         paper_url?: string | null | undefined;
@@ -682,16 +873,22 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
         id?: string | undefined;
         bucket?: "public-files" | "files" | undefined;
     } | undefined;
+    preview?: Record<string, any>[] | undefined;
+}, {
+    asset_type: "dataset";
+    last_updated: string;
+    parent?: Record<string, any> | undefined;
+    source?: "web" | "api" | undefined;
+    visibility?: "public" | "private" | "organization" | "monetized" | "inherit" | undefined;
+    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
+    state?: "success" | "error" | "queued" | "in-progress" | "timed-out" | undefined;
     name?: string | undefined;
+    org_id?: string | undefined;
     team_id?: string | undefined;
-    visibility?: "organization" | "public" | "private" | "monetized" | "inherit" | undefined;
     description?: {
         json: Record<string, any>;
         text: string;
     } | null | undefined;
-    source?: "api" | "web" | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
-    state?: "success" | "queued" | "in-progress" | "timed-out" | "error" | undefined;
     parent_id?: string | null | undefined;
     license_id?: string | undefined;
     license?: Record<string, any> | undefined;
@@ -704,16 +901,13 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
     stripe_product_id?: string | null | undefined;
     stripe_price_id?: string | null | undefined;
     stripe_meter_id?: string | null | undefined;
-    preview?: Record<string, any>[] | undefined;
-}, {
-    asset_type: "dataset";
-    last_updated: string;
-    org_id?: string | undefined;
-    parent?: Record<string, any> | undefined;
     metadata?: {
         table_name: string;
         schema: "datasets";
         columns: string[];
+        asset_refs?: Record<string, {
+            asset_type?: "organization" | "file" | "user" | "team" | "dataset" | "service" | "route" | "post" | "quest" | "comment" | "conversation" | undefined;
+        }> | null | undefined;
         doi_url?: string | null | undefined;
         external_url?: string | null | undefined;
         paper_url?: string | null | undefined;
@@ -729,28 +923,6 @@ declare const updateDatasetSchema: z.ZodPipe<z.ZodObject<{
         id?: string | undefined;
         bucket?: "public-files" | "files" | undefined;
     } | undefined;
-    name?: string | undefined;
-    team_id?: string | undefined;
-    visibility?: "organization" | "public" | "private" | "monetized" | "inherit" | undefined;
-    description?: {
-        json: Record<string, any>;
-        text: string;
-    } | null | undefined;
-    source?: "api" | "web" | undefined;
-    monetization?: "none" | "pay-to-unlock" | "pay-per-use" | undefined;
-    state?: "success" | "queued" | "in-progress" | "timed-out" | "error" | undefined;
-    parent_id?: string | null | undefined;
-    license_id?: string | undefined;
-    license?: Record<string, any> | undefined;
-    name_url_slug?: string | null | undefined;
-    price?: number | null | undefined;
-    unit_cost?: number | null | undefined;
-    cost_accounting?: "fixed" | "variable" | null | undefined;
-    cost_unit?: string | null | undefined;
-    price_currency?: "usd" | "btc" | undefined;
-    stripe_product_id?: string | null | undefined;
-    stripe_price_id?: string | null | undefined;
-    stripe_meter_id?: string | null | undefined;
     preview?: Record<string, any>[] | undefined;
 }>>;
 
@@ -758,5 +930,9 @@ type Dataset = z.infer<typeof DatasetSchema>;
 type CreateFromFileDataset = z.infer<typeof CreateDatasetFromFileSchema>;
 type CreateFromSchemaDataset = z.infer<typeof CreateDatasetFromSchemaSchema>;
 type UpdateDataset = z.infer<typeof updateDatasetSchema>;
+type DatasetAssetRefs = z.infer<typeof DatasetAssetRefsSchema>;
+type EnrichedDatasetSchemaField = z.infer<typeof EnrichedDatasetSchemaFieldSchema>;
+type ResolvedAssetRef = z.infer<typeof ResolvedAssetRefSchema>;
+type ResolvedAssetRefs = z.infer<typeof ResolvedAssetRefsSchema>;
 
-export { CreateDatasetFromFileSchema, CreateDatasetFromSchemaSchema, type CreateFromFileDataset, type CreateFromSchemaDataset, type Dataset, DatasetSchema, type UpdateDataset, updateDatasetSchema };
+export { CreateDatasetFromFileSchema, CreateDatasetFromSchemaSchema, type CreateFromFileDataset, type CreateFromSchemaDataset, type Dataset, type DatasetAssetRefs, DatasetAssetRefsSchema, DatasetSchema, type EnrichedDatasetSchemaField, EnrichedDatasetSchemaFieldSchema, type ResolvedAssetRef, ResolvedAssetRefSchema, type ResolvedAssetRefs, ResolvedAssetRefsSchema, type UpdateDataset, updateDatasetSchema };