busa-sdk 0.9.17 → 0.10.1

package/dist/index.d.ts

@@ -586,6 +586,10 @@ declare const cloudContract: {
                 name: z.ZodString;
                 slug: z.ZodNullable<z.ZodString>;
                 plan: z.ZodNullable<z.ZodString>;
+                nodeVisibilityMode: z.ZodOptional<z.ZodEnum<{
+                    open: "open";
+                    restricted: "restricted";
+                }>>;
             }, z.core.$strip>;
             user: z.ZodObject<{
                 id: z.ZodString;
@@ -603,6 +607,10 @@ declare const cloudContract: {
                 name: z.ZodString;
                 slug: z.ZodNullable<z.ZodString>;
                 plan: z.ZodNullable<z.ZodString>;
+                nodeVisibilityMode: z.ZodOptional<z.ZodEnum<{
+                    open: "open";
+                    restricted: "restricted";
+                }>>;
             }, z.core.$strip>>;
             createdSpace: z.ZodOptional<z.ZodBoolean>;
             bootstrapRequired: z.ZodOptional<z.ZodBoolean>;
@@ -20512,6 +20520,202 @@ declare const cloudContract: {
             author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             baseCommitId: z.ZodOptional<z.ZodString>;
             recordId: z.ZodString;
+            autoMerge: z.ZodOptional<z.ZodBoolean>;
+        }, 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";
+                        whiteboard: "whiteboard";
+                        html: "html";
+                        longtext: "longtext";
+                        markdown: "markdown";
+                        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";
+                        formula: "formula";
+                        lookup: "lookup";
+                    }>;
+                    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>>;
+                        formula: z.ZodOptional<z.ZodObject<{
+                            expression: z.ZodString;
+                        }, z.core.$strip>>;
+                        inverseFieldId: z.ZodOptional<z.ZodString>;
+                        lookup: z.ZodOptional<z.ZodObject<{
+                            relationFieldSlug: z.ZodString;
+                            targetFieldSlug: z.ZodString;
+                            rollup: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                                values: "values";
+                                count: "count";
+                                sum: "sum";
+                                average: "average";
+                                min: "min";
+                                max: "max";
+                                concatenate: "concatenate";
+                            }>>>;
+                            limit: z.ZodOptional<z.ZodEnum<{
+                                all: "all";
+                                first: "first";
+                            }>>;
+                        }, z.core.$strip>>;
+                        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>;
@@ -20912,7 +21116,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>>;
         deleteChangeRequest: _orpc_contract.ContractProcedure<z.ZodObject<{
             message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             submittedBy: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -23445,8 +23650,11 @@ interface BusabaseConfig {
      */
     baseUrl?: string;
     /**
-     * Bearer token. Only Busabase Cloud requires it; a local OSS server is open.
-     * Falls back to `BUSABASE_API_KEY`.
+     * Bearer token. Falls back to `BUSABASE_API_KEY`. Omit it in the two cases
+     * where the server authenticates you some other way: a local OSS server
+     * (`apps/busabase`) is open, and a *same-origin browser* call (e.g. from an
+     * AirApp running inside Busabase) authenticates as the logged-in user via
+     * the ambient session cookie.
      */
     apiKey?: string;
     /**
@@ -23484,43 +23692,25 @@ declare function resolveConfig(config?: BusabaseConfig): ResolvedConfig;
  * Config fields default from `BUSABASE_BASE_URL` / `BUSABASE_API_KEY` /
  * `BUSABASE_SPACE_ID` when omitted.
  *
+ * This is the *only* client the SDK ships. Browser code (an AirApp) and
+ * server/CLI code use the same one — they differ only in where `baseUrl` and
+ * the credential come from: an AirApp running inside Busabase passes
+ * `baseUrl: window.location.origin` and no key (the ambient session cookie
+ * authenticates it), while the same app run locally against a dev server
+ * passes that server's URL and, for Busabase Cloud, an API key.
+ *
  * @example
  * ```ts
+ * // Server / CLI, against Busabase Cloud:
  * const client = createBusabaseClient({ apiKey: process.env.BUSABASE_API_KEY });
  * const bases = await client.bases.list();
  * const record = await client.records.get({ recordId });
+ *
+ * // Browser (AirApp), same-origin — no key, the session cookie authenticates:
+ * const client = createBusabaseClient({ baseUrl: window.location.origin });
  * ```
  */
 declare function createBusabaseClient(config?: BusabaseConfig): BusabaseClient;
-/** Options for {@link createBusabaseRpcClient}. No `apiKey`/`spaceId` — this
- * transport authenticates purely via the browser's ambient session cookie. */
-interface BusabaseRpcConfig {
-    /**
-     * Path to the internal RPC endpoint: either a full URL, or a path resolved
-     * against `window.location.origin` (browser only — there is no ambient
-     * session outside one).
-     *
-     * **The default (`/api/rpc`) only matches `apps/busabase` (the OSS app)**,
-     * which mounts busabase's procedures unnamespaced. `apps/busabase-cloud`
-     * mounts the *same* procedures under a `core` prefix instead — pass
-     * `apiBasePath: "/api/rpc/core"` there, or this client will 404 on every
-     * call. There is no single default that works for both; which one you're
-     * targeting is something the caller has to know (this SDK doesn't probe
-     * for it).
-     *
-     * From inside an AirApp running via Nodepod, prepend
-     * `/__busabase_api__` to whichever of the above applies, to route through
-     * the service-worker bridge instead of the sandboxed virtual server — e.g.
-     * `/__busabase_api__/api/rpc/core` for busabase-cloud. See
-     * apps/busabase/docs/node-types.md.
-     */
-    apiBasePath?: string;
-    /** Extra headers merged into every request. Static object or a (possibly async) factory. */
-    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
-    /** Custom `fetch` implementation (e.g. a proxy-aware or instrumented fetch). */
-    fetch?: typeof fetch;
-}
-declare function createBusabaseRpcClient(config?: BusabaseRpcConfig): BusabaseClient;
 
 /**
  * Attachments — DTO/VO Zod schemas + inferred types (the contract's type source
@@ -25834,4 +26024,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, type CreateFormDTO, 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 FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type LookupRollup, type NodeSearchResultVO, 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 SubmitFormDTO, type UpdateFormDTO, type UpdateVaultSettingsDTO, type UserRefVO, VIEW_FIELD_MAX_WIDTH, VIEW_FIELD_MIN_WIDTH, 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 };
+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, CREATABLE_NODE_TYPES, type ChangeRequestBatchResultVO, type ChangeRequestCountsVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, type CreateFormDTO, 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 FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type LookupRollup, type NodeSearchResultVO, 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 SubmitFormDTO, type UpdateFormDTO, type UpdateVaultSettingsDTO, type UserRefVO, VIEW_FIELD_MAX_WIDTH, VIEW_FIELD_MIN_WIDTH, 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, normalizeBaseUrl, resolveConfig };

package/dist/index.js

@@ -1,7 +1,6 @@
 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';
+import { oc, eventIterator } from '@orpc/contract';
 import { z } from 'zod';
 
 // src/client.ts
@@ -890,7 +889,23 @@ var authSpaceSchema = z.object({
   id: z.string(),
   name: z.string(),
   slug: z.string().nullable(),
-  plan: z.string().nullable()
+  plan: z.string().nullable(),
+  /**
+   * The space's DEFAULT content visibility for its members — the same
+   * `spaces.nodeVisibilityMode` the cloud dashboard reads. `"open"` = a node
+   * with no explicit visibility anywhere in its ancestor chain is visible to
+   * every member; `"restricted"` = such a node is hidden from non-managers
+   * until it is explicitly opened (per-node visibility or a grant).
+   *
+   * Clients need it to describe a node's EFFECTIVE access truthfully ("everyone
+   * in this space can see this" is a lie in a restricted space) and to decide
+   * whether per-node grants are meaningful to show at all.
+   *
+   * OPTIONAL on purpose: it was added after this VO shipped, so an older server
+   * (or a host that doesn't model a space default at all) simply omits it.
+   * Treat an absent value as `"open"` — the historical behaviour.
+   */
+  nodeVisibilityMode: z.enum(["open", "restricted"]).optional()
 });
 var authUserSchema = z.object({
   id: z.string(),
@@ -1845,8 +1860,18 @@ var recordContract = {
     path: "/records/{recordId}/change-requests",
     tags: ["Records", "Change Requests"],
     summary: "Create record update change request",
-    successDescription: "Created change request that proposes updating a canonical record."
-  }).input(reviseOperationInputSchema.extend({ recordId: z.string() })).output(changeRequestSchema),
+    successDescription: "Permission-aware by default: updates the record immediately when the actor has write access, otherwise returns a pending ChangeRequest. Pass `autoMerge: false` to force review."
+  }).input(
+    reviseOperationInputSchema.extend({
+      recordId: z.string(),
+      autoMerge: z.boolean().optional()
+    })
+  ).output(
+    z.union([
+      recordSchema.extend({ materialized: z.literal(true) }),
+      changeRequestSchema.extend({ materialized: z.literal(false) })
+    ])
+  ),
   deleteChangeRequest: oc.route({
     method: "DELETE",
     path: "/records/{recordId}/change-requests",
@@ -3062,6 +3087,9 @@ var busabaseContractRoutes = {
   live: {
     // RPC-only by design: no `.route(...)`, so OpenAPI generation and MCP tool
     // discovery skip this long-lived Event Iterator while `/api/rpc` stays typed.
+    // (MCP discovery only skips it because `discoverOpenApiTools` now requires a
+    // route with a method or path — omitting `.route()` still leaves `route: {}`,
+    // which is truthy, and that used to publish this as a callable REST tool.)
     subscribe: oc.output(eventIterator(liveEventSchema))
   },
   bases: baseContract,
@@ -3481,26 +3509,6 @@ function createBusabaseClient(config = {}) {
   });
   return createORPCClient(link);
 }
-var getBrowserWindow = () => globalThis.window;
-function createBusabaseRpcClient(config = {}) {
-  const apiBasePath = config.apiBasePath ?? "/api/rpc";
-  const isAbsolute = /^https?:\/\//.test(apiBasePath);
-  if (!isAbsolute && typeof getBrowserWindow() === "undefined") {
-    throw new Error(
-      "createBusabaseRpcClient: apiBasePath must be an absolute URL (http:// or https://) outside a browser \u2014 this client authenticates via the browser's ambient session cookie, which only exists client-side."
-    );
-  }
-  const link = new RPCLink({
-    method: inferRPCMethodFromContractRouter(cloudContract),
-    url: () => isAbsolute ? apiBasePath : `${getBrowserWindow()?.location.origin}${apiBasePath}`,
-    fetch: config.fetch,
-    headers: async () => {
-      const extra = typeof config.headers === "function" ? await config.headers() : config.headers;
-      return { ...extra };
-    }
-  });
-  return createORPCClient(link);
-}
 
 // src/index.ts
 var Busabase = class {
@@ -3630,4 +3638,4 @@ var Busabase = class {
   }
 };
 
-export { Busabase, CREATABLE_NODE_TYPES, DEFAULT_BASE_URL, cloudContract, createBusabaseClient, createBusabaseRpcClient, normalizeBaseUrl, resolveConfig };
+export { Busabase, CREATABLE_NODE_TYPES, DEFAULT_BASE_URL, cloudContract, createBusabaseClient, normalizeBaseUrl, resolveConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-sdk",
-  "version": "0.9.17",
+  "version": "0.10.1",
   "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",