busabase-sdk 0.14.0 → 0.14.1

package/dist/index.d.ts

@@ -285,7 +285,7 @@ type OperationKind = GenericOperationKind | RegisteredOperationKind;
  * of truth). `schema/` is reserved for DB (PO); DTO/VO live here.
  *
  * Kernel-generic: `metadata` is an open record (apps layer their own typed
- * metadata on top — e.g. `apps/busabase-cloud`'s `AttachmentType` enum).
+ * metadata on top — e.g. Busabase Cloud's `AttachmentType` enum).
  */
 
 /**
@@ -662,6 +662,102 @@ declare const FormVOSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.core.$strip>;
 type FormVO = z.infer<typeof FormVOSchema>;
+declare const ListFormsInputSchema: z.ZodObject<{
+    targetBaseId: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ListFormsDTO = z.infer<typeof ListFormsInputSchema>;
+declare const ListFormsVOSchema: z.ZodObject<{
+    forms: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        nodeId: z.ZodString;
+        spaceId: z.ZodString;
+        targetBaseId: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        bindings: z.ZodArray<z.ZodObject<{
+            inputName: z.ZodString;
+            fieldSlug: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            label: z.ZodOptional<z.ZodString>;
+            help: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        boundFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            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";
+            }>;
+            choices: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+        page: z.ZodObject<{
+            code: z.ZodOptional<z.ZodString>;
+            theme: z.ZodOptional<z.ZodObject<{
+                logoUrl: z.ZodOptional<z.ZodString>;
+                coverUrl: z.ZodOptional<z.ZodString>;
+                brandColor: z.ZodOptional<z.ZodString>;
+                hideBranding: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        share: z.ZodObject<{
+            isPublic: z.ZodDefault<z.ZodBoolean>;
+            anonymousSubmit: z.ZodDefault<z.ZodBoolean>;
+            submitLimit: z.ZodOptional<z.ZodNumber>;
+            requireCaptcha: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        submissionCount: z.ZodDefault<z.ZodNumber>;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+        }>;
+        createdBy: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type ListFormsVO = z.infer<typeof ListFormsVOSchema>;
 declare const CreateFormInputSchema: z.ZodObject<{
     nodeId: z.ZodString;
     targetBaseId: z.ZodString;
@@ -2529,8 +2625,7 @@ interface UserRefVO {
     role?: string | null;
 }
 /**
- * Cheap, name/slug-only match from `nodes.searchByName` (see
- * `apps/busabase/content/spec/search-quick-jump.md`) — deliberately a much
+ * Cheap, name/slug-only match from `nodes.searchByName` — deliberately a much
  * smaller projection than `NodeVO` (no `description`/`metadata`/tree shape):
  * this backs the dashboard's instant quick-jump palette, not the sidebar tree
  * or a node's own detail view. `path` is the route this node navigates to
@@ -2729,7 +2824,7 @@ interface AuditEventVO {
 
 /**
  * Unified Grep (P2a files+docs, P2b records) — top-level, domain-agnostic
- * schemas for `POST /grep`. See apps/busabase/content/spec/unified-grep.md.
+ * schemas for `POST /grep`.
  *
  * Mirrors how `search`'s schemas live top-level in `contract/schemas.ts`
  * rather than inside a single domain's contract: `grep` composes multiple
@@ -12070,6 +12165,99 @@ declare const cloudContract: {
         }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
     };
     forms: {
+        list: _orpc_contract.ContractProcedure<z.ZodObject<{
+            targetBaseId: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            cursor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            forms: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                nodeId: z.ZodString;
+                spaceId: z.ZodString;
+                targetBaseId: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodString;
+                bindings: z.ZodArray<z.ZodObject<{
+                    inputName: z.ZodString;
+                    fieldSlug: z.ZodString;
+                    required: z.ZodOptional<z.ZodBoolean>;
+                    label: z.ZodOptional<z.ZodString>;
+                    help: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                boundFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    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";
+                    }>;
+                    choices: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        name: z.ZodString;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>>;
+                page: z.ZodObject<{
+                    code: z.ZodOptional<z.ZodString>;
+                    theme: z.ZodOptional<z.ZodObject<{
+                        logoUrl: z.ZodOptional<z.ZodString>;
+                        coverUrl: z.ZodOptional<z.ZodString>;
+                        brandColor: z.ZodOptional<z.ZodString>;
+                        hideBranding: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>;
+                share: z.ZodObject<{
+                    isPublic: z.ZodDefault<z.ZodBoolean>;
+                    anonymousSubmit: z.ZodDefault<z.ZodBoolean>;
+                    submitLimit: z.ZodOptional<z.ZodNumber>;
+                    requireCaptcha: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>;
+                submissionCount: z.ZodDefault<z.ZodNumber>;
+                status: z.ZodEnum<{
+                    active: "active";
+                    archived: "archived";
+                }>;
+                createdBy: z.ZodString;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
         getByNode: _orpc_contract.ContractProcedure<z.ZodObject<{
             nodeId: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
@@ -19653,4 +19841,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 BusabaseAssetsClient, type BusabaseChangeRequestsClient, type BusabaseClient, type BusabaseConfig, type BusabaseRecordsClient, CREATABLE_NODE_TYPES, type ChangeRequestBatchFailureVO, type ChangeRequestCountsVO, type ChangeRequestMergeBatchResultVO, type ChangeRequestReviewBatchResultVO, 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 FormBoundFieldVO, type FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type LookupRollup, type NodeDetailVO, type NodeSearchResultVO, type NodeType, type NodeVO, type OperationKind, type OperationStatus, type OperationVO, type RecordByFieldInput, 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, getRecordByField, grepAssets, normalizeBaseUrl, resolveConfig, toFilesOnlyGrepResult, toUnifiedFilesGrepInput };
+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 BusabaseAssetsClient, type BusabaseChangeRequestsClient, type BusabaseClient, type BusabaseConfig, type BusabaseRecordsClient, CREATABLE_NODE_TYPES, type ChangeRequestBatchFailureVO, type ChangeRequestCountsVO, type ChangeRequestMergeBatchResultVO, type ChangeRequestReviewBatchResultVO, 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 FormBoundFieldVO, type FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type ListFormsDTO, type ListFormsVO, type LookupRollup, type NodeDetailVO, type NodeSearchResultVO, type NodeType, type NodeVO, type OperationKind, type OperationStatus, type OperationVO, type RecordByFieldInput, 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, getRecordByField, grepAssets, normalizeBaseUrl, resolveConfig, toFilesOnlyGrepResult, toUnifiedFilesGrepInput };

package/dist/index.js

@@ -2328,6 +2328,16 @@ var FormVOSchema = z.object({
   createdAt: z.string(),
   updatedAt: z.string()
 });
+var ListFormsInputSchema = z.object({
+  targetBaseId: z.string().min(1),
+  limit: z.coerce.number().int().min(1).max(100).optional().default(50),
+  /** Opaque createdAt/id keyset cursor. */
+  cursor: z.string().optional()
+});
+var ListFormsVOSchema = z.object({
+  forms: z.array(FormVOSchema),
+  nextCursor: z.string().nullable()
+});
 var CreateFormInputSchema = z.object({
   nodeId: z.string().min(1),
   targetBaseId: z.string().min(1),
@@ -2355,6 +2365,13 @@ var FormSubmitResultSchema = z.object({
 
 // ../../packages/busabase-contract/src/domains/form/contract.ts
 var formContract = {
+  list: oc.route({
+    method: "GET",
+    path: "/forms",
+    tags: ["Forms"],
+    summary: "List forms bound to a Base",
+    successDescription: "A newest-first page of forms with a stable opaque cursor (null at the end)."
+  }).input(ListFormsInputSchema).output(ListFormsVOSchema),
   getByNode: oc.route({
     method: "GET",
     path: "/forms/{nodeId}",
@@ -3041,7 +3058,7 @@ var busabaseContractRoutes = {
       path: "/nodes/search",
       tags: ["Nodes", "Search"],
       summary: "Search nodes by name/slug (cheap, name-only quick-jump)",
-      successDescription: "Plain ilike match on name/slug across every registered node type, scoped by the same node-visibility ACL as `nodes.list`. No content scan and no full-text ranking \u2014 ordered exact-slug-match first, then by name. Backs the dashboard search dialog's 'Recent' tab cache-miss path (see apps/busabase/content/spec/search-quick-jump.md); the heavier `search` endpoint remains the dedicated full-text content search."
+      successDescription: "Plain ilike match on name/slug across every registered node type, scoped by the same node-visibility ACL as `nodes.list`. No content scan and no full-text ranking \u2014 ordered exact-slug-match first, then by name. Backs the dashboard search dialog's 'Recent' tab cache-miss path; the heavier `search` endpoint remains the dedicated full-text content search."
     }).input(searchNodesByNameInputSchema).output(z.array(nodeSearchResultSchema)),
     isDescendant: oc.route({
       method: "GET",
@@ -3556,9 +3573,9 @@ var cloudExtraRoutes = {
       })
     ).output(AgentTaskDetailSchema)
   },
-  // Relative-path twin of `embedLinksContract`
-  // (apps/busabase-cloud/src/domains/embed-links/contract.ts, served at the absolute
-  // `/api/v1/embed-links` paths) — same schemas imported from `./embed-link-schemas`, just
+  // Relative-path twin of the `embedLinksContract` the Busabase Cloud host
+  // serves at the absolute `/api/v1/embed-links` paths — same schemas
+  // imported from `./embed-link-schemas`, just
   // routed relative here so the shared `/api/v1` prefix below lands on the identical real path.
   embedLinks: {
     create: oc.route({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busabase-sdk",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Typed TypeScript/JavaScript SDK for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server` (or Busabase Cloud).",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-sdk",
@@ -49,9 +49,9 @@
     "tsx": "^4.20.5",
     "typescript": "^5.9.3",
     "vitest": "^2.1.8",
-    "busabase-contract": "0.14.0",
-    "openlib": "0.1.1",
-    "open-domains": "0.0.2"
+    "busabase-contract": "0.14.1",
+    "open-domains": "0.0.2",
+    "openlib": "0.1.1"
   },
   "engines": {
     "node": ">=24.18.0"