busa-sdk 0.9.7 → 0.9.8

package/dist/index.d.ts

@@ -1405,6 +1405,71 @@ declare const cloudContract: {
         }, z.core.$strip>, z.ZodObject<{
             purged: z.ZodBoolean;
         }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+        updateVisibility: _orpc_contract.ContractProcedure<z.ZodObject<{
+            nodeId: z.ZodString;
+            visibility: z.ZodNullable<z.ZodEnum<{
+                private: "private";
+                workspace: "workspace";
+                public: "public";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            updated: z.ZodBoolean;
+        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+        toggleFavorite: _orpc_contract.ContractProcedure<z.ZodObject<{
+            nodeId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            favorited: z.ZodBoolean;
+        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+        listFavorites: _orpc_contract.ContractProcedure<_orpc_contract.Schema<unknown, unknown>, z.ZodArray<z.ZodType<NodeOutput, unknown, z.core.$ZodTypeInternals<NodeOutput, unknown>>>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+        principals: {
+            list: _orpc_contract.ContractProcedure<z.ZodObject<{
+                nodeId: z.ZodString;
+            }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                nodeId: z.ZodString;
+                principalType: z.ZodEnum<{
+                    space: "space";
+                    user: "user";
+                    team: "team";
+                }>;
+                principalId: z.ZodString;
+                role: z.ZodEnum<{
+                    read: "read";
+                    changeRequest: "changeRequest";
+                    write: "write";
+                    manage: "manage";
+                }>;
+                grantedBy: z.ZodString;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+            }, z.core.$strip>>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+            add: _orpc_contract.ContractProcedure<z.ZodObject<{
+                nodeId: z.ZodString;
+                principalType: z.ZodEnum<{
+                    space: "space";
+                    user: "user";
+                }>;
+                principalId: z.ZodString;
+                role: z.ZodEnum<{
+                    read: "read";
+                    changeRequest: "changeRequest";
+                    write: "write";
+                    manage: "manage";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                granted: z.ZodBoolean;
+            }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+            remove: _orpc_contract.ContractProcedure<z.ZodObject<{
+                nodeId: z.ZodString;
+                principalType: z.ZodEnum<{
+                    space: "space";
+                    user: "user";
+                }>;
+                principalId: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                removed: z.ZodBoolean;
+            }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+        };
     };
     auditEvents: {
         list: _orpc_contract.ContractProcedure<z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -3584,7 +3649,13 @@ declare const cloudContract: {
             slug: z.ZodString;
             name: z.ZodString;
             description: z.ZodString;
-            type: z.ZodLiteral<"table">;
+            type: z.ZodEnum<{
+                table: "table";
+                gallery: "gallery";
+                kanban: "kanban";
+                calendar: "calendar";
+                gantt: "gantt";
+            }>;
             config: z.ZodObject<{
                 filters: z.ZodDefault<z.ZodArray<z.ZodObject<{
                     fieldSlug: z.ZodString;
@@ -3608,6 +3679,25 @@ declare const cloudContract: {
                     fieldId: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>>;
                 visibleFieldSlugs: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                coverFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                coverFit: z.ZodOptional<z.ZodEnum<{
+                    cover: "cover";
+                    fit: "fit";
+                }>>;
+                cardSize: z.ZodOptional<z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    large: "large";
+                }>>;
+                showFieldLabels: z.ZodOptional<z.ZodBoolean>;
+                stackByFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                dateFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                startFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                endFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                ganttScale: z.ZodOptional<z.ZodEnum<{
+                    week: "week";
+                    month: "month";
+                }>>;
             }, z.core.$strip>;
             status: z.ZodEnum<{
                 archived: "archived";
@@ -3633,7 +3723,13 @@ declare const cloudContract: {
             slug: z.ZodString;
             name: z.ZodString;
             description: z.ZodString;
-            type: z.ZodLiteral<"table">;
+            type: z.ZodEnum<{
+                table: "table";
+                gallery: "gallery";
+                kanban: "kanban";
+                calendar: "calendar";
+                gantt: "gantt";
+            }>;
             config: z.ZodObject<{
                 filters: z.ZodDefault<z.ZodArray<z.ZodObject<{
                     fieldSlug: z.ZodString;
@@ -3657,6 +3753,25 @@ declare const cloudContract: {
                     fieldId: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>>;
                 visibleFieldSlugs: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                coverFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                coverFit: z.ZodOptional<z.ZodEnum<{
+                    cover: "cover";
+                    fit: "fit";
+                }>>;
+                cardSize: z.ZodOptional<z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    large: "large";
+                }>>;
+                showFieldLabels: z.ZodOptional<z.ZodBoolean>;
+                stackByFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                dateFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                startFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                endFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                ganttScale: z.ZodOptional<z.ZodEnum<{
+                    week: "week";
+                    month: "month";
+                }>>;
             }, z.core.$strip>;
             status: z.ZodEnum<{
                 archived: "archived";
@@ -4600,7 +4715,180 @@ declare const cloudContract: {
             message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             submittedBy: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             idempotencyKey: z.ZodOptional<z.ZodString>;
+            autoMerge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            baseId: z.ZodString;
+        }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+            id: z.ZodString;
             baseId: z.ZodString;
+            headCommitId: z.ZodString;
+            parentRecordId: z.ZodNullable<z.ZodString>;
+            parentCommitId: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                archived: "archived";
+                active: "active";
+            }>;
+            createdBy: z.ZodString;
+            createdByUser: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodNullable<z.ZodString>;
+                email: z.ZodNullable<z.ZodString>;
+                image: z.ZodNullable<z.ZodString>;
+                role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>>;
+            archivedAt: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            base: z.ZodObject<{
+                id: z.ZodString;
+                nodeId: z.ZodString;
+                slug: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodString;
+                reviewPolicy: z.ZodObject<{
+                    kind: z.ZodLiteral<"single">;
+                    requiredApprovals: z.ZodNumber;
+                }, z.core.$strip>;
+                createdAt: z.ZodString;
+                fields: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    baseId: z.ZodString;
+                    slug: z.ZodString;
+                    name: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodEnum<{
+                        en: "en";
+                        "zh-CN": "zh-CN";
+                        "zh-TW": "zh-TW";
+                        ja: "ja";
+                        ko: "ko";
+                        de: "de";
+                        fr: "fr";
+                        es: "es";
+                        pt: "pt";
+                    }> & z.core.$partial, z.ZodString>]>;
+                    type: z.ZodEnum<{
+                        number: "number";
+                        email: "email";
+                        date: "date";
+                        text: "text";
+                        longtext: "longtext";
+                        markdown: "markdown";
+                        html: "html";
+                        attachment: "attachment";
+                        relation: "relation";
+                        checkbox: "checkbox";
+                        select: "select";
+                        multiselect: "multiselect";
+                        url: "url";
+                        embed: "embed";
+                        phone: "phone";
+                        created_time: "created_time";
+                        updated_time: "updated_time";
+                        created_by: "created_by";
+                        updated_by: "updated_by";
+                        auto_number: "auto_number";
+                        ai_summary: "ai_summary";
+                        ai_tags: "ai_tags";
+                        code: "code";
+                        json: "json";
+                        yaml: "yaml";
+                    }>;
+                    required: z.ZodBoolean;
+                    position: z.ZodNumber;
+                    options: z.ZodDefault<z.ZodObject<{
+                        ai: z.ZodOptional<z.ZodObject<{
+                            model: z.ZodOptional<z.ZodString>;
+                            prompt: z.ZodOptional<z.ZodString>;
+                            reviewRequired: z.ZodOptional<z.ZodBoolean>;
+                            sourceFieldIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        }, z.core.$strip>>;
+                        attachment: z.ZodOptional<z.ZodObject<{
+                            maxFiles: z.ZodOptional<z.ZodNumber>;
+                            allowedMimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            maxFileSize: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$strip>>;
+                        choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            color: z.ZodOptional<z.ZodString>;
+                            id: z.ZodString;
+                            name: z.ZodString;
+                        }, z.core.$strip>>>;
+                        code: z.ZodOptional<z.ZodObject<{
+                            language: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>;
+                        embed: z.ZodOptional<z.ZodObject<{
+                            aspectRatio: z.ZodOptional<z.ZodEnum<{
+                                "16:9": "16:9";
+                                "4:3": "4:3";
+                                "1:1": "1:1";
+                            }>>;
+                            height: z.ZodOptional<z.ZodNumber>;
+                            providers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        }, z.core.$strip>>;
+                        inverseFieldId: z.ZodOptional<z.ZodString>;
+                        multiple: z.ZodOptional<z.ZodBoolean>;
+                        number: z.ZodOptional<z.ZodObject<{
+                            format: z.ZodOptional<z.ZodEnum<{
+                                plain: "plain";
+                                currency: "currency";
+                            }>>;
+                            currency: z.ZodOptional<z.ZodString>;
+                            locale: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>;
+                        targetBaseId: z.ZodOptional<z.ZodString>;
+                        targetBaseSlug: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            headCommit: z.ZodObject<{
+                id: z.ZodString;
+                baseId: z.ZodNullable<z.ZodString>;
+                targetType: z.ZodEnum<{
+                    base: "base";
+                    node: "node";
+                }>;
+                nodeId: z.ZodNullable<z.ZodString>;
+                operationId: z.ZodNullable<z.ZodString>;
+                parentCommitId: z.ZodNullable<z.ZodString>;
+                fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                operation: z.ZodEnum<{
+                    [x: `${string}_file_create`]: `${string}_file_create`;
+                    [x: `${string}_file_update`]: `${string}_file_update`;
+                    [x: `${string}_file_delete`]: `${string}_file_delete`;
+                    [x: `${string}_metadata_update`]: `${string}_metadata_update`;
+                    record_create: "record_create";
+                    record_update: "record_update";
+                    record_delete: "record_delete";
+                    record_variant: "record_variant";
+                    view_create: "view_create";
+                    view_update: "view_update";
+                    view_delete: "view_delete";
+                    view_restore: "view_restore";
+                    base_add_field: "base_add_field";
+                    base_delete_field: "base_delete_field";
+                    base_update_field: "base_update_field";
+                    base_convert_field: "base_convert_field";
+                    base_reorder_fields: "base_reorder_fields";
+                    base_restore_field: "base_restore_field";
+                    base_archive: "base_archive";
+                    base_restore: "base_restore";
+                    record_restore: "record_restore";
+                    doc_update: "doc_update";
+                    node_create: "node_create";
+                    node_rename: "node_rename";
+                    node_delete: "node_delete";
+                    node_restore: "node_restore";
+                    node_move: "node_move";
+                }>;
+                message: z.ZodString;
+                author: z.ZodString;
+                authorUser: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodNullable<z.ZodString>;
+                    email: z.ZodNullable<z.ZodString>;
+                    image: z.ZodNullable<z.ZodString>;
+                    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>>;
+                createdAt: z.ZodString;
+            }, z.core.$strip>;
+            materialized: z.ZodLiteral<true>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             baseId: z.ZodNullable<z.ZodString>;
@@ -4978,7 +5266,8 @@ declare const cloudContract: {
                 visibleOperationHeads: z.ZodRecord<z.ZodString, z.ZodString>;
                 createdAt: z.ZodString;
             }, z.core.$strip>>;
-        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+            materialized: z.ZodLiteral<false>;
+        }, z.core.$strip>]>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
         createBulkChangeRequest: _orpc_contract.ContractProcedure<z.ZodObject<{
             records: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -6034,10 +6323,36 @@ declare const cloudContract: {
                     fieldId: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>>;
                 visibleFieldSlugs: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                coverFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                coverFit: z.ZodOptional<z.ZodEnum<{
+                    cover: "cover";
+                    fit: "fit";
+                }>>;
+                cardSize: z.ZodOptional<z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    large: "large";
+                }>>;
+                showFieldLabels: z.ZodOptional<z.ZodBoolean>;
+                stackByFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                dateFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                startFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                endFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                ganttScale: z.ZodOptional<z.ZodEnum<{
+                    week: "week";
+                    month: "month";
+                }>>;
             }, z.core.$strip>>>;
             description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             name: z.ZodString;
+            type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                table: "table";
+                gallery: "gallery";
+                kanban: "kanban";
+                calendar: "calendar";
+                gantt: "gantt";
+            }>>>;
             slug: z.ZodOptional<z.ZodString>;
             submittedBy: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             baseId: z.ZodString;
@@ -11057,6 +11372,10 @@ declare const cloudContract: {
         runLocalNode: _orpc_contract.ContractProcedure<z.ZodObject<{
             nodeId: z.ZodString;
             files: z.ZodRecord<z.ZodString, z.ZodString>;
+            engine: z.ZodDefault<z.ZodEnum<{
+                "local-node": "local-node";
+                srt: "srt";
+            }>>;
         }, z.core.$strip>, _orpc_contract.Schema<AsyncIteratorObject<{
             type: "log";
             line: string;
@@ -14393,6 +14712,7 @@ declare const cloudContract: {
                 comments: "comments";
                 bases: "bases";
                 assets: "assets";
+                nodePrincipals: "nodePrincipals";
                 views: "views";
                 fieldValues: "fieldValues";
                 recordLinks: "recordLinks";
@@ -14423,6 +14743,7 @@ declare const cloudContract: {
                 comments: "comments";
                 bases: "bases";
                 assets: "assets";
+                nodePrincipals: "nodePrincipals";
                 views: "views";
                 fieldValues: "fieldValues";
                 recordLinks: "recordLinks";
@@ -16952,7 +17273,13 @@ declare const cloudContract: {
                 slug: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodString;
-                type: z.ZodLiteral<"table">;
+                type: z.ZodEnum<{
+                    table: "table";
+                    gallery: "gallery";
+                    kanban: "kanban";
+                    calendar: "calendar";
+                    gantt: "gantt";
+                }>;
                 config: z.ZodObject<{
                     filters: z.ZodDefault<z.ZodArray<z.ZodObject<{
                         fieldSlug: z.ZodString;
@@ -16976,6 +17303,25 @@ declare const cloudContract: {
                         fieldId: z.ZodOptional<z.ZodString>;
                     }, z.core.$strip>>>;
                     visibleFieldSlugs: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                    coverFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    coverFit: z.ZodOptional<z.ZodEnum<{
+                        cover: "cover";
+                        fit: "fit";
+                    }>>;
+                    cardSize: z.ZodOptional<z.ZodEnum<{
+                        small: "small";
+                        medium: "medium";
+                        large: "large";
+                    }>>;
+                    showFieldLabels: z.ZodOptional<z.ZodBoolean>;
+                    stackByFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    dateFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    startFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    endFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    ganttScale: z.ZodOptional<z.ZodEnum<{
+                        week: "week";
+                        month: "month";
+                    }>>;
                 }, z.core.$strip>;
                 status: z.ZodEnum<{
                     archived: "archived";
@@ -19694,10 +20040,36 @@ declare const cloudContract: {
                     fieldId: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>>;
                 visibleFieldSlugs: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                coverFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                coverFit: z.ZodOptional<z.ZodEnum<{
+                    cover: "cover";
+                    fit: "fit";
+                }>>;
+                cardSize: z.ZodOptional<z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    large: "large";
+                }>>;
+                showFieldLabels: z.ZodOptional<z.ZodBoolean>;
+                stackByFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                dateFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                startFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                endFieldSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                ganttScale: z.ZodOptional<z.ZodEnum<{
+                    week: "week";
+                    month: "month";
+                }>>;
             }, z.core.$strip>>;
             description: z.ZodOptional<z.ZodString>;
             message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             name: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<{
+                table: "table";
+                gallery: "gallery";
+                kanban: "kanban";
+                calendar: "calendar";
+                gantt: "gantt";
+            }>>;
             submittedBy: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             viewId: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
@@ -21067,10 +21439,23 @@ interface ViewSortVO {
     fieldSlug: string;
     fieldId?: string;
 }
+type ViewType = "table" | "gallery" | "kanban" | "calendar" | "gantt";
+type GalleryCoverFit = "cover" | "fit";
+type GalleryCardSize = "small" | "medium" | "large";
+type GanttScale = "week" | "month";
 interface ViewConfigVO {
     filters: ViewFilterVO[];
     sorts: ViewSortVO[];
     visibleFieldSlugs?: string[] | null;
+    coverFieldSlug?: string | null;
+    coverFit?: GalleryCoverFit;
+    cardSize?: GalleryCardSize;
+    showFieldLabels?: boolean;
+    stackByFieldSlug?: string | null;
+    dateFieldSlug?: string | null;
+    startFieldSlug?: string | null;
+    endFieldSlug?: string | null;
+    ganttScale?: GanttScale;
 }
 interface ViewVO {
     id: string;
@@ -21078,7 +21463,7 @@ interface ViewVO {
     slug: string;
     name: string;
     description: string;
-    type: "table";
+    type: ViewType;
     config: ViewConfigVO;
     status: "active" | "archived";
     createdBy: string;
@@ -22966,4 +23351,4 @@ declare class Busabase {
     }>>>>;
 }
 
-export { type ActivityItemVO, type AgentTaskVO, type FileTreeFileVO as AirAppFileVO, type FileTreeReadFileVO as AirAppReadFileVO, type FileTreeNodeVO as AirAppVO, type AssetAttachmentRef, type AssetDetailVO, type AssetTextStatus, type AssetUsageVO, type AssetVO, type AttachmentRef, type AuditAction, type AuditEventVO, type BaseFieldVO, type BaseVO, Busabase, type BusabaseClient, type BusabaseConfig, type BusabaseRpcConfig, CREATABLE_NODE_TYPES, type ChangeRequestBatchResultVO, type ChangeRequestCountsVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, DEFAULT_BASE_URL, type FileTreeFileVO as DriveFileVO, type FileTreeReadFileVO as DriveReadFileVO, type FileTreeNodeVO as DriveVO, type FieldType, type FileNodeMetadata, type FileNodeVO, type FileTreeFileVO, type FileTreeNodeVO, type FileTreeReadFileVO, type NodeType, type NodeVO, type OperationKind, type OperationStatus, type OperationVO, type RecordLinkVO, type RecordVO, type ResolvedConfig, type ReviewVO, type ReviewVerdict, type SearchResponseVO, type SearchResultKind, type SearchResultVO, type FileTreeFileVO as SkillFileVO, type FileTreeReadFileVO as SkillReadFileVO, type FileTreeNodeVO as SkillVO, type UpdateVaultSettingsDTO, type UserRefVO, type VaultAccessPolicy, type VaultEnvironment, type VaultItemInput, type VaultItemKind, type VaultItemVO, type VaultRuntimeEnv, type VaultScopeType, type VaultSettingsVO, type ViewConfigVO, type ViewFilterOperator, type ViewFilterVO, type ViewSortVO, type ViewVO, cloudContract, createBusabaseClient, createBusabaseRpcClient, normalizeBaseUrl, resolveConfig };
+export { type ActivityItemVO, type AgentTaskVO, type FileTreeFileVO as AirAppFileVO, type FileTreeReadFileVO as AirAppReadFileVO, type FileTreeNodeVO as AirAppVO, type AssetAttachmentRef, type AssetDetailVO, type AssetTextStatus, type AssetUsageVO, type AssetVO, type AttachmentRef, type AuditAction, type AuditEventVO, type BaseFieldVO, type BaseVO, Busabase, type BusabaseClient, type BusabaseConfig, type BusabaseRpcConfig, CREATABLE_NODE_TYPES, type ChangeRequestBatchResultVO, type ChangeRequestCountsVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, DEFAULT_BASE_URL, type FileTreeFileVO as DriveFileVO, type FileTreeReadFileVO as DriveReadFileVO, type FileTreeNodeVO as DriveVO, type FieldType, type FileNodeMetadata, type FileNodeVO, type FileTreeFileVO, type FileTreeNodeVO, type FileTreeReadFileVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type NodeType, type NodeVO, type OperationKind, type OperationStatus, type OperationVO, type RecordLinkVO, type RecordVO, type ResolvedConfig, type ReviewVO, type ReviewVerdict, type SearchResponseVO, type SearchResultKind, type SearchResultVO, type FileTreeFileVO as SkillFileVO, type FileTreeReadFileVO as SkillReadFileVO, type FileTreeNodeVO as SkillVO, type UpdateVaultSettingsDTO, type UserRefVO, type VaultAccessPolicy, type VaultEnvironment, type VaultItemInput, type VaultItemKind, type VaultItemVO, type VaultRuntimeEnv, type VaultScopeType, type VaultSettingsVO, type ViewConfigVO, type ViewFilterOperator, type ViewFilterVO, type ViewSortVO, type ViewType, type ViewVO, cloudContract, createBusabaseClient, createBusabaseRpcClient, normalizeBaseUrl, resolveConfig };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createORPCClient } from '@orpc/client';
+import { createORPCClient, ORPCError } from '@orpc/client';
 import { RPCLink } from '@orpc/client/fetch';
 import { oc, eventIterator, inferRPCMethodFromContractRouter } from '@orpc/contract';
 import { OpenAPILink } from '@orpc/openapi-client/fetch';
@@ -436,6 +436,16 @@ var nodeSchema = z.lazy(
     hasChildren: z.boolean().optional()
   })
 );
+var nodePrincipalSchema = z.object({
+  id: z.string(),
+  nodeId: z.string(),
+  principalType: z.enum(["user", "team", "space"]),
+  principalId: z.string(),
+  role: z.enum(["read", "changeRequest", "write", "manage"]),
+  grantedBy: z.string(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
 var listNodesInputSchema = z.object({
   parentId: z.string().nullable().optional().describe("Node to start from. Omit or null to start from the space root."),
   depth: z.coerce.number().int().min(1).max(5).optional().describe(
@@ -986,7 +996,13 @@ var airAppRunLocalNodeInputSchema = z.object({
   nodeId: z.string(),
   /** Text files to mount into the sandbox workdir before installing, keyed by
    *  path (same shape `RunPanel` already assembles for `NodepodRunner.mount`). */
-  files: z.record(z.string(), z.string())
+  files: z.record(z.string(), z.string()),
+  /** Server-side execution mode. `"local-node"` spawns a bare host Node.js
+   *  process (previewable, data bridge via reverse proxy, NOT OS-isolated);
+   *  `"srt"` wraps the same commands in the OS sandbox (isolated execution,
+   *  but live preview is unreachable). `"nodepod"` never calls this endpoint —
+   *  it runs entirely in-browser. */
+  engine: z.enum(["local-node", "srt"]).default("local-node")
 });
 var airAppRuntimeEventSchema = z.discriminatedUnion("type", [
   z.object({ type: z.literal("log"), line: z.string() }),
@@ -1335,10 +1351,30 @@ var viewSortSchema = z.object({
   fieldSlug: z.string(),
   fieldId: z.string().optional()
 });
+var viewTypeSchema = z.enum(["table", "gallery", "kanban", "calendar", "gantt"]);
+var ganttScaleSchema = z.enum(["week", "month"]);
+var galleryCoverFitSchema = z.enum(["cover", "fit"]);
+var galleryCardSizeSchema = z.enum(["small", "medium", "large"]);
 var viewConfigSchema = z.object({
   filters: z.array(viewFilterSchema).default([]),
   sorts: z.array(viewSortSchema).default([]),
-  visibleFieldSlugs: z.array(z.string()).nullable().optional()
+  visibleFieldSlugs: z.array(z.string()).nullable().optional(),
+  // ── Gallery-only presentation config (ignored by table views) ──
+  // Which attachment field supplies the cover image (null = no cover).
+  coverFieldSlug: z.string().nullable().optional(),
+  coverFit: galleryCoverFitSchema.optional(),
+  cardSize: galleryCardSizeSchema.optional(),
+  // Whether to render the field label above each value on a card.
+  showFieldLabels: z.boolean().optional(),
+  // ── Kanban-only: which single-select field stacks records into columns.
+  stackByFieldSlug: z.string().nullable().optional(),
+  // ── Calendar-only: which date field positions records on the month grid.
+  dateFieldSlug: z.string().nullable().optional(),
+  // ── Gantt-only: the start/end date fields bounding each record's bar, plus
+  // the time-axis granularity.
+  startFieldSlug: z.string().nullable().optional(),
+  endFieldSlug: z.string().nullable().optional(),
+  ganttScale: ganttScaleSchema.optional()
 });
 var viewSchema = z.object({
   id: z.string(),
@@ -1346,7 +1382,7 @@ var viewSchema = z.object({
   slug: z.string(),
   name: z.string(),
   description: z.string(),
-  type: z.literal("table"),
+  type: viewTypeSchema,
   config: viewConfigSchema,
   status: z.enum(["active", "archived"]),
   createdBy: z.string(),
@@ -1360,6 +1396,7 @@ var createViewInputSchema = z.object({
   description: z.string().optional().default(""),
   message: z.string().optional().default("Create view"),
   name: z.string().min(1),
+  type: viewTypeSchema.optional().default("table"),
   slug: z.string().min(1).regex(/^[a-z0-9-]+$/).optional(),
   submittedBy: z.string().optional().default("local-producer")
 });
@@ -1368,6 +1405,7 @@ var updateViewInputSchema = z.object({
   description: z.string().optional(),
   message: z.string().optional().default("Update view"),
   name: z.string().min(1).optional(),
+  type: viewTypeSchema.optional(),
   submittedBy: z.string().optional().default("local-producer")
 });
 var deleteViewInputSchema = z.object({
@@ -1443,7 +1481,13 @@ var createChangeRequestInputSchema = z.object({
   submittedBy: z.string().optional().default("local-producer"),
   idempotencyKey: z.string().optional().describe(
     "Optional client-supplied key that dedupes retries. Scoped per base + submitter: calling this endpoint again with the SAME idempotencyKey (e.g. after a timeout or a 5xx where you couldn't tell if the first call succeeded) returns the change request created by the first call instead of creating a duplicate. Omit for normal one-shot calls; only set it when you might retry."
-  )
+  ),
+  // Review-first by default: without `autoMerge: true`, this proposes the record
+  // as a pending ChangeRequest (status "in_review") instead of creating it
+  // immediately. Pass `autoMerge: true` only for callers that don't need human
+  // review — approves and merges the change request right away, returning the
+  // materialized record instead of the pending ChangeRequest.
+  autoMerge: z.boolean().optional().default(false)
 });
 var createBulkChangeRequestInputSchema = z.object({
   records: z.array(z.record(z.string(), z.unknown())).min(1).max(1e3).describe(
@@ -1554,8 +1598,13 @@ var baseContract = {
     path: "/bases/{baseId}/change-requests",
     tags: ["Bases", "Change Requests"],
     summary: "Create Change Request in Base",
-    successDescription: "Created change request for review."
-  }).input(createChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
+    successDescription: "Review-first by default: a pending ChangeRequest proposing the record (`materialized: false`). Returns the materialized record instead (`materialized: true`) when `autoMerge: true` is passed."
+  }).input(createChangeRequestInputSchema.extend({ baseId: z.string() })).output(
+    z.union([
+      recordSchema.extend({ materialized: z.literal(true) }),
+      changeRequestSchema.extend({ materialized: z.literal(false) })
+    ])
+  ),
   createBulkChangeRequest: oc.route({
     method: "POST",
     path: "/bases/{baseId}/records/bulk-change-request",
@@ -1826,6 +1875,9 @@ var docContract = {
 var driveContract = makeFileTreeContract("drives", "Drives");
 var DumpTableSchema = z.enum([
   "nodes",
+  /** Node-level access grants (permissions). Not secret — restore must keep them
+   * so a backed-up space's sharing/permission config survives a full restore. */
+  "nodePrincipals",
   "bases",
   "baseFields",
   "views",
@@ -2445,7 +2497,69 @@ var busabaseContractRoutes = {
       tags: ["Nodes"],
       summary: "Permanently delete an archived node",
       successDescription: "Irreversibly removed an archived folder/doc/skill (and its subtree). Refused unless archived and refused if the subtree contains a Base."
-    }).input(z.object({ nodeId: z.string() })).output(z.object({ purged: z.boolean() }))
+    }).input(z.object({ nodeId: z.string() })).output(z.object({ purged: z.boolean() })),
+    updateVisibility: oc.route({
+      method: "POST",
+      path: "/nodes/{nodeId}/visibility",
+      tags: ["Nodes", "Permissions"],
+      summary: "Set a node's visibility (private / workspace / public)",
+      successDescription: "Updated the node's own explicit visibility and re-materialized the subtree's effective visibility (a child can only ever be as open as its strictest ancestor). Requires `manage` level on the node. The workspace root cannot be made private. `public` currently behaves as `workspace` (no anonymous surface yet)."
+    }).input(
+      z.object({
+        nodeId: z.string(),
+        visibility: z.enum(["private", "workspace", "public"]).nullable()
+      })
+    ).output(z.object({ updated: z.boolean() })),
+    toggleFavorite: oc.route({
+      method: "POST",
+      path: "/nodes/{nodeId}/favorite",
+      tags: ["Nodes", "Favorites"],
+      summary: "Toggle the current actor's favorite on a node",
+      successDescription: "Upserted or deleted a row keyed by the (nodeId, actorId) unique pair \u2014 a true toggle, race-safe under a rapid double-click, never a duplicate. `favorited` reflects the node's new state for the acting user. Purely additive: never moves or hides the node from its real position in the Bases tree."
+    }).input(z.object({ nodeId: z.string() })).output(z.object({ favorited: z.boolean() })),
+    listFavorites: oc.route({
+      method: "GET",
+      path: "/nodes/favorites",
+      tags: ["Nodes", "Favorites"],
+      summary: "List the current actor's favorited nodes",
+      successDescription: "The acting user's favorited nodes, newest-favorited first, filtered through the same archived/deleted/visibility rules as the main tree \u2014 a favorited node that's later archived, purged, or (cloud) hidden from this actor silently drops out rather than erroring."
+    }).output(z.array(nodeSchema)),
+    principals: {
+      list: oc.route({
+        method: "GET",
+        path: "/nodes/{nodeId}/principals",
+        tags: ["Nodes", "Permissions"],
+        summary: "List a node's direct access grants",
+        successDescription: "Direct grants defined ON this node (inherited copies from ancestor folders are not listed). Requires the node to be visible to the caller."
+      }).input(z.object({ nodeId: z.string() })).output(z.array(nodePrincipalSchema)),
+      add: oc.route({
+        method: "POST",
+        path: "/nodes/{nodeId}/principals",
+        tags: ["Nodes", "Permissions"],
+        summary: "Grant (or update) a principal's access level on a node",
+        successDescription: "Upserted one direct grant (same principal twice updates its level) and re-materialized inherited copies down the subtree. Requires `manage` level on the node."
+      }).input(
+        z.object({
+          nodeId: z.string(),
+          principalType: z.enum(["user", "space"]),
+          principalId: z.string().min(1),
+          role: z.enum(["read", "changeRequest", "write", "manage"])
+        })
+      ).output(z.object({ granted: z.boolean() })),
+      remove: oc.route({
+        method: "DELETE",
+        path: "/nodes/{nodeId}/principals",
+        tags: ["Nodes", "Permissions"],
+        summary: "Revoke a principal's access grant on a node",
+        successDescription: "Removed the direct grant (and its materialized inherited copies). Requires `manage` level on the node."
+      }).input(
+        z.object({
+          nodeId: z.string(),
+          principalType: z.enum(["user", "space"]),
+          principalId: z.string().min(1)
+        })
+      ).output(z.object({ removed: z.boolean() }))
+    }
   },
   auditEvents: {
     list: oc.route({
@@ -2762,11 +2876,32 @@ function resolveConfig(config = {}) {
     fetch: config.fetch
   };
 }
+var decodeBusabaseError = (deserializedBody, response) => {
+  if (!deserializedBody || typeof deserializedBody !== "object") {
+    return void 0;
+  }
+  const body = deserializedBody;
+  if (typeof body.error !== "string") {
+    return void 0;
+  }
+  const code = typeof body.code === "string" ? body.code : `HTTP_${response.status}`;
+  const issues = body.data?.issues;
+  let message = body.error;
+  if (Array.isArray(issues) && issues.length > 0) {
+    const details = issues.map((issue) => {
+      const path = Array.isArray(issue?.path) ? issue.path.join(".") : void 0;
+      return path ? `${path}: ${issue?.message}` : String(issue?.message ?? issue);
+    }).join("; ");
+    message = `${message} \u2014 ${details}`;
+  }
+  return new ORPCError(code, { status: response.status, message, data: body.data });
+};
 function createBusabaseClient(config = {}) {
   const resolved = resolveConfig(config);
   const link = new OpenAPILink(cloudContract, {
     url: resolved.baseUrl,
     fetch: resolved.fetch,
+    customErrorResponseBodyDecoder: decodeBusabaseError,
     headers: async () => {
       const extra = typeof resolved.headers === "function" ? await resolved.headers() : resolved.headers;
       return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-sdk",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "description": "Typed TypeScript/JavaScript SDK for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server` (or Busabase Cloud). Short-name alias for busabase-sdk.",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-sdk",