busa-sdk 0.9.5 → 0.9.6

package/dist/index.d.ts

@@ -239,6 +239,7 @@ type CreatableNodeType = Extract<BuiltinDefinition, {
         creatable: true;
     };
 }>["type"];
+declare const CREATABLE_NODE_TYPES: [CreatableNodeType, ...CreatableNodeType[]];
 type GenericOperationKind = (typeof GENERIC_NODE_OPERATIONS)[number]["kind"];
 type RegisteredOperationKind = BuiltinDefinition["operations"][number]["kind"];
 type OperationKind = GenericOperationKind | RegisteredOperationKind;
@@ -261,6 +262,17 @@ interface NodeOutput {
     updatedAt: string;
     baseId: string | null;
     children: NodeOutput[];
+    /**
+     * Whether this node has children beyond what `children` carries. Always
+     * accurate when the full subtree was loaded (equals `children.length > 0`).
+     * The one case it differs: a node sitting exactly at a `nodes.list` `depth`
+     * boundary — `children` is `[]` (not fetched) but `hasChildren` is `true`,
+     * telling the sidebar to render an expand affordance and lazy-fetch on
+     * click instead of rendering it as a leaf. Optional or missing means the
+     * caller can safely treat it as `children.length > 0` (which is exactly
+     * what it equals whenever it's omitted).
+     */
+    hasChildren?: boolean;
 }
 
 declare const cloudContract: {
@@ -387,6 +399,15 @@ declare const cloudContract: {
         query: z.ZodDefault<z.ZodString>;
         limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        sources: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodEnum<{
+            records: "records";
+            files: "files";
+            names: "names";
+        }>>, z.ZodEnum<{
+            records: "records";
+            files: "files";
+            names: "names";
+        }>]>, z.ZodTransform<("records" | "files" | "names")[], "records" | "files" | "names" | ("records" | "files" | "names")[]>>>;
     }, z.core.$strip>, z.ZodObject<{
         query: z.ZodString;
         limit: z.ZodNumber;
@@ -411,9 +432,9 @@ declare const cloudContract: {
         pattern: z.ZodString;
         flags: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            records: "records";
             files: "files";
             docs: "docs";
-            records: "records";
         }>>>;
         scope: z.ZodOptional<z.ZodObject<{
             files: z.ZodOptional<z.ZodObject<{
@@ -487,7 +508,16 @@ declare const cloudContract: {
         truncated: z.ZodBoolean;
     }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
     nodes: {
-        list: _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>>;
+        list: _orpc_contract.ContractProcedure<z.ZodOptional<z.ZodObject<{
+            parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            depth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strip>>, z.ZodArray<z.ZodType<NodeOutput, unknown, z.core.$ZodTypeInternals<NodeOutput, unknown>>>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+        isDescendant: _orpc_contract.ContractProcedure<z.ZodObject<{
+            nodeId: z.ZodString;
+            potentialAncestorId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            isDescendant: z.ZodBoolean;
+        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
         listArchived: _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>>;
         createChangeRequest: _orpc_contract.ContractProcedure<z.ZodObject<{
             message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -22543,6 +22573,13 @@ interface NodeVO {
     updatedAt: string;
     baseId: string | null;
     children: NodeVO[];
+    /**
+     * Whether this node has children beyond what `children` carries — see the
+     * matching field on the contract's `NodeOutput` (contract/schemas.ts) for
+     * the full depth-boundary explanation. Optional/omitted is safe to treat
+     * as `children.length > 0`.
+     */
+    hasChildren?: boolean;
 }
 
 interface CommitVO {
@@ -22844,4 +22881,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 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, 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, 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, normalizeBaseUrl, resolveConfig };

package/dist/index.js

@@ -429,9 +429,23 @@ var nodeSchema = z.lazy(
     createdAt: z.string(),
     updatedAt: z.string(),
     baseId: z.string().nullable(),
-    children: z.array(nodeSchema)
+    children: z.array(nodeSchema),
+    hasChildren: z.boolean().optional()
   })
 );
+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(
+    "How many levels beneath the start point to eagerly include (default 2 once either field is set). Capped at 5."
+  )
+}).optional();
+var isDescendantInputSchema = z.object({
+  nodeId: z.string(),
+  potentialAncestorId: z.string()
+});
+var isDescendantOutputSchema = z.object({
+  isDescendant: z.boolean()
+});
 var userRefSchema = z.object({
   id: z.string(),
   name: z.string().nullable(),
@@ -754,10 +768,21 @@ var changeRequestCountsSchema = z.object({
   merged: z.number().int().nonnegative(),
   rejected: z.number().int().nonnegative()
 });
+var SEARCH_SOURCES = ["records", "files", "names"];
 var searchInputSchema = z.object({
   query: z.string().default(""),
   limit: z.coerce.number().int().min(1).max(100).optional().default(20),
-  offset: z.coerce.number().int().min(0).optional().default(0)
+  offset: z.coerce.number().int().min(0).optional().default(0),
+  /**
+   * Restrict which content this call searches. Omitted means all three
+   * (unchanged behavior for every caller before this parameter existed).
+   *
+   * A GET query param that occurs exactly once (`?sources=records`) arrives
+   * as a bare string, not a 1-element array — only a REPEATED occurrence
+   * (`?sources=records&sources=files`) becomes an array. Accept both shapes
+   * and normalize to an array.
+   */
+  sources: z.union([z.array(z.enum(SEARCH_SOURCES)), z.enum(SEARCH_SOURCES)]).transform((value) => Array.isArray(value) ? value : [value]).optional()
 });
 var authSpaceSchema = z.object({
   id: z.string(),
@@ -2328,8 +2353,15 @@ var busabaseContractRoutes = {
       path: "/nodes",
       tags: ["Nodes"],
       summary: "List node tree",
-      successDescription: "Workspace node tree including folders, Bases, files, and agents."
-    }).output(z.array(nodeSchema)),
+      successDescription: "Workspace node tree including folders, Bases, files, and agents. With no `parentId`/`depth`, returns the FULL tree (legacy behavior, still what every non-sidebar caller gets). Passing `parentId` and/or `depth` switches to a depth-bounded fetch: `parentId` omitted/null starts from the space root and returns it wrapped exactly like the legacy call (just depth-limited); an explicit `parentId` returns that node's children directly, ready to merge into its `NodeVO.children` for a sidebar's lazy per-folder expand. See `NodeVO.hasChildren` for how a depth boundary is surfaced."
+    }).input(listNodesInputSchema).output(z.array(nodeSchema)),
+    isDescendant: oc.route({
+      method: "GET",
+      path: "/nodes/{nodeId}/is-descendant",
+      tags: ["Nodes"],
+      summary: "Check whether a node is a descendant of another",
+      successDescription: "Server-authoritative parentId-chain walk from nodeId up to potentialAncestorId. Used to gate cross-branch drag-and-drop drops in the sidebar, since the full tree is no longer guaranteed to be loaded client-side (depth-bounded lazy load) \u2014 a purely local walk could wrongly allow dropping a folder into its own unloaded descendant."
+    }).input(isDescendantInputSchema).output(isDescendantOutputSchema),
     listArchived: oc.route({
       method: "GET",
       path: "/nodes/archived",
@@ -2816,4 +2848,4 @@ var Busabase = class {
   }
 };
 
-export { Busabase, DEFAULT_BASE_URL, cloudContract, createBusabaseClient, 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.5",
+  "version": "0.9.6",
   "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",