busa-sdk 0.90.2 → 0.95.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as AssetTextStatus, $t as NodeType, A as NodeVO, At as GalleryCardSize, B as UpdatePreviewFileCredentialDTO, Bt as ViewSortVO, C as CommentVO, Ct as ListFormsDTO, D as MentionInboxItemVO, Dt as AssetAttachmentRef, E as LookupRollup, Et as UpdateFormDTO, F as SearchResponseVO, Ft as VIEW_FIELD_MAX_WIDTH, G as VaultItemKind, Gt as CloudContract, H as VaultAccessPolicy, Ht as ViewVO, I as SearchResultKind, It as VIEW_FIELD_MIN_WIDTH, J as VaultScopeType, Jt as NodeIconSchema, K as VaultItemVO, Kt as cloudContract, L as SearchResultVO, Lt as ViewConfigVO, M as OperationVO, Mt as GanttScale, N as ReviewVO, Nt as RecordLinkVO, O as MentionInboxPageVO, Ot as BaseFieldVO, P as ReviewVerdict, Pt as RecordVO, Q as AssetDetailVO, Qt as CreatableNodeType, R as SourceAttributionVO, Rt as ViewFilterOperator, S as CommentSubjectType, St as FormVO, T as FieldType, Tt as SubmitFormDTO, U as VaultEnvironment, Ut as AttachmentRef, V as UpdateVaultSettingsDTO, Vt as ViewType, W as VaultItemInput, Wt as PlaybookAttributionVO, X as FileNodeMetadata, Xt as resolveNodeIconSource, Y as VaultSettingsVO, Yt as NodeIconSource, Z as FileNodeVO, Zt as CREATABLE_NODE_TYPES, _ as ChangeRequestVO, _t as FormFieldBindingVO, a as createBusabaseClient, at as FilePreviewConfigurationStatus, b as CommentMentionTargetType, bt as FormSubmitResultVO, c as AuditAction, ct as FilePreviewUnavailableReason, d as ChangeRequestBatchFailureVO, dt as FileTreeNodeVO, en as OperationKind, et as AssetUsageVO, f as ChangeRequestCountsVO, ft as FileTreeReadFileVO, g as ChangeRequestTargetType, gt as FormBoundFieldVO, h as ChangeRequestStatus, ht as CreateFormDTO, i as ResolvedConfig, it as FilePreviewConfigVO, j as OperationStatus, jt as GalleryCoverFit, k as NodeSearchResultVO, kt as BaseVO, l as AuditEventVO, lt as FilePreviewVO, m as ChangeRequestReviewBatchResultVO, mt as ActivityItemVO, n as BusabaseConfig, nt as GrepInputDTO, o as resolveConfig, ot as FilePreviewCredentialSource, p as ChangeRequestMergeBatchResultVO, pt as NodeDetailVO, q as VaultRuntimeEnv, qt as NodeIcon, r as DEFAULT_BASE_URL, rt as GrepResultVO, s as AgentTaskVO, st as FilePreviewProvider, t as BusabaseClient, tt as AssetVO, u as BusabaseSourceChannel, ut as FileTreeFileVO, v as CommentMentionDispatchStatus, vt as FormPageSourceVO, w as CommitVO, wt as ListFormsVO, x as CommentMentionVO, xt as FormThemeVO, y as CommentMentionInputDTO, yt as FormShareVO, z as UserRefVO, zt as ViewFilterVO } from "./client-tKN7nBHR.js";
+import { $ as AssetTextStatus, $t as NodeType, A as NodeVO, At as GalleryCardSize, B as UpdatePreviewFileCredentialDTO, Bt as ViewSortVO, C as CommentVO, Ct as ListFormsDTO, D as MentionInboxItemVO, Dt as AssetAttachmentRef, E as LookupRollup, Et as UpdateFormDTO, F as SearchResponseVO, Ft as VIEW_FIELD_MAX_WIDTH, G as VaultItemKind, Gt as CloudContract, H as VaultAccessPolicy, Ht as ViewVO, I as SearchResultKind, It as VIEW_FIELD_MIN_WIDTH, J as VaultScopeType, Jt as NodeIconSchema, K as VaultItemVO, Kt as cloudContract, L as SearchResultVO, Lt as ViewConfigVO, M as OperationVO, Mt as GanttScale, N as ReviewVO, Nt as RecordLinkVO, O as MentionInboxPageVO, Ot as BaseFieldVO, P as ReviewVerdict, Pt as RecordVO, Q as AssetDetailVO, Qt as CreatableNodeType, R as SourceAttributionVO, Rt as ViewFilterOperator, S as CommentSubjectType, St as FormVO, T as FieldType, Tt as SubmitFormDTO, U as VaultEnvironment, Ut as AttachmentRef, V as UpdateVaultSettingsDTO, Vt as ViewType, W as VaultItemInput, Wt as PlaybookAttributionVO, X as FileNodeMetadata, Xt as resolveNodeIconSource, Y as VaultSettingsVO, Yt as NodeIconSource, Z as FileNodeVO, Zt as CREATABLE_NODE_TYPES, _ as ChangeRequestVO, _t as FormFieldBindingVO, a as createBusabaseClient, at as FilePreviewConfigurationStatus, b as CommentMentionTargetType, bt as FormSubmitResultVO, c as AuditAction, ct as FilePreviewUnavailableReason, d as ChangeRequestBatchFailureVO, dt as FileTreeNodeVO, en as OperationKind, et as AssetUsageVO, f as ChangeRequestCountsVO, ft as FileTreeReadFileVO, g as ChangeRequestTargetType, gt as FormBoundFieldVO, h as ChangeRequestStatus, ht as CreateFormDTO, i as ResolvedConfig, it as FilePreviewConfigVO, j as OperationStatus, jt as GalleryCoverFit, k as NodeSearchResultVO, kt as BaseVO, l as AuditEventVO, lt as FilePreviewVO, m as ChangeRequestReviewBatchResultVO, mt as ActivityItemVO, n as BusabaseConfig, nt as GrepInputDTO, o as resolveConfig, ot as FilePreviewCredentialSource, p as ChangeRequestMergeBatchResultVO, pt as NodeDetailVO, q as VaultRuntimeEnv, qt as NodeIcon, r as DEFAULT_BASE_URL, rt as GrepResultVO, s as AgentTaskVO, st as FilePreviewProvider, t as BusabaseClient, tt as AssetVO, u as BusabaseSourceChannel, ut as FileTreeFileVO, v as CommentMentionDispatchStatus, vt as FormPageSourceVO, w as CommitVO, wt as ListFormsVO, x as CommentMentionVO, xt as FormThemeVO, y as CommentMentionInputDTO, yt as FormShareVO, z as UserRefVO, zt as ViewFilterVO } from "./client-BlHnsVv8.js";
 import { z } from "zod";
 //#region src/url.d.ts
 /**

package/dist/index.js

@@ -530,6 +530,10 @@ const fieldOptionsSchema = z.object({
 		name: z.string()
 	})).optional(),
 	code: z.object({ language: z.string().optional() }).optional(),
+	date: z.object({
+		includeTime: z.boolean().optional(),
+		timezone: z.string().optional().describe("IANA time zone, e.g. \"Asia/Shanghai\". Omit to show each reader their own local time.")
+	}).optional(),
 	embed: z.object({
 		aspectRatio: z.enum([
 			"16:9",
@@ -1517,7 +1521,8 @@ const nodeSchema = z.lazy(() => z.object({
 	baseId: z.string().nullable(),
 	children: z.array(nodeSchema),
 	hasChildren: z.boolean().optional(),
-	shared: z.boolean().optional()
+	shared: z.boolean().optional(),
+	sharedViaAncestor: z.boolean().optional()
 }));
 const nodePrincipalSchema = z.object({
 	id: z.string(),
@@ -3109,8 +3114,15 @@ const createViewInputSchema = z.object({
 	submittedBy: z.string().optional().default("local-producer"),
 	autoMerge: autoMergeSchema
 });
+const viewConfigPatchSchema = viewConfigSchema.omit({
+	filters: true,
+	sorts: true
+}).extend({
+	filters: z.array(viewFilterSchema).optional(),
+	sorts: z.array(viewSortSchema).optional()
+});
 const updateViewInputSchema = z.object({
-	config: viewConfigSchema.optional(),
+	config: viewConfigPatchSchema.optional().describe("Only supplied config keys change; empty arrays and null clear supported settings."),
 	description: z.string().optional(),
 	message: z.string().optional().default("Update view"),
 	name: z.string().min(1).optional(),
@@ -3706,8 +3718,11 @@ const recordContract = {
 		path: "/records/{recordId}/change-requests",
 		tags: ["Records", "Change Requests"],
 		summary: "List record change request history",
-		successDescription: "Change requests and operations connected to the canonical record."
-	}).input(z.object({ recordId: z.string() })).output(z.array(changeRequestSchema)),
+		successDescription: "Change requests connected to the canonical record, newest first. Omit limit for the full legacy history. With limit, returns recent summaries with up to five record-scoped operations per change request, capped field payloads, and no embedded reviews. Get the change request for its complete diff and reviews."
+	}).input(z.object({
+		recordId: z.string(),
+		limit: z.coerce.number().int().min(1).max(100).optional().describe("Recent change request summaries to return. Omit to retain the full legacy history.")
+	})).output(z.array(changeRequestSchema)),
 	listLinks: oc.route({
 		method: "GET",
 		path: "/records/{recordId}/links",
@@ -4033,7 +4048,12 @@ const FormBoundFieldSchema = z.object({
 	choices: z.array(z.object({
 		id: z.string(),
 		name: z.string()
-	})).default([])
+	})).default([]),
+	/** A `date` field's time settings (see the Base field `options.date`). */
+	date: z.object({
+		includeTime: z.boolean().optional(),
+		timezone: z.string().optional()
+	}).optional()
 });
 /** Optional theme tokens layered over the agent-authored page. */
 const FormThemeSchema = z.object({
@@ -4890,6 +4910,11 @@ const listRecordActivityInputSchema = z.object({
 	recordId: z.string().min(1).describe("Activity for this record's own history."),
 	limit: z.coerce.number().int().min(1).max(100).optional().default(50).describe("Most recent events to return, capped at 100. This stream has NO cursor — it is a recent window, not a pageable history; use `/api/v1/activity/paged` to walk further back.")
 });
+const listRecordActivityPagedInputSchema = z.object({
+	recordId: z.string().min(1).describe("Activity is scoped to this record's own history."),
+	limit: z.coerce.number().int().min(1).max(100).optional().default(50).describe("Items per page. Defaults to 50 and is capped at 100."),
+	cursor: z.string().optional().describe("Opaque page cursor: pass back the `nextCursor` from the previous response. Do not construct or parse it.")
+});
 const EMBED_LINK_MAX_MINUTES = 1440;
 const EmbedNodeTypeSchema = z.enum([
 	"base",
@@ -5532,6 +5557,49 @@ const NodeRouteStateVOSchema = z.discriminatedUnion("status", [
 	z.object({ status: z.literal("unavailable") })
 ]);
 //#endregion
+//#region ../../packages/busabase-contract/src/contract/node-subscription-schemas.ts
+/**
+* The current actor's subscription to one node, as the node `[...]` menu shows it.
+*
+* - `subscribed` — a live row on THIS node (`source` says whether it was created
+*   automatically by creating/submitting/commenting/voting, or by a manual
+*   Subscribe).
+* - `inherited` — no row on this node, but the nearest ancestor with a row is
+*   subscribed; `via` names that folder.
+* - `muted` — the nearest row is THIS node's, and it is muted (the actor
+*   unsubscribed here). Auto triggers never undo this.
+* - `none` — no row on the node or any ancestor, or the nearest row is an
+*   ancestor's mute.
+*/
+const NodeSubscriptionStateSchema = z.enum([
+	"subscribed",
+	"inherited",
+	"muted",
+	"none"
+]);
+const NodeSubscriptionViaSchema = z.object({
+	id: z.string(),
+	name: z.string(),
+	type: z.enum(NODE_TYPES),
+	slug: z.string()
+});
+const NodeSubscriptionVOSchema = z.object({
+	nodeId: z.string(),
+	state: NodeSubscriptionStateSchema,
+	source: z.enum(["auto", "manual"]).nullable(),
+	via: NodeSubscriptionViaSchema.nullable()
+});
+const GetNodeSubscriptionInputSchema = z.object({ nodeId: z.string() });
+const SetNodeSubscriptionInputSchema = z.object({
+	nodeId: z.string(),
+	/**
+	* `true` subscribes (manual, clears any mute on this node); `false` mutes this
+	* node for the actor — even when the subscription is inherited from a folder,
+	* in which case only this node is muted and the folder subscription stays.
+	*/
+	subscribed: z.boolean()
+});
+//#endregion
 //#region ../../packages/busabase-contract/src/contract/busabase.ts
 const changeRequestBatchFailureSchema = z.object({
 	changeRequestId: z.string(),
@@ -5774,6 +5842,18 @@ const busabaseContractRoutes = {
 			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 — a favorited node that's later archived, purged, or (cloud) hidden from this actor silently drops out rather than erroring."
 		}).output(z.array(nodeSchema)),
+		/**
+		* The acting user's notification subscription to one node — the node
+		* `[...]` menu's Subscribe / Unsubscribe item. RPC-only by design (no
+		* `.route(...)`): the actor comes from context, so on an agent's API key it
+		* would resolve to the key's OWNER, and an agent toggling its owner's
+		* notifications is exactly the silent-drop this feature exists to prevent.
+		* Not in `/api/v1`, not in any MCP tool catalog.
+		*/
+		subscription: {
+			get: oc.input(GetNodeSubscriptionInputSchema).output(NodeSubscriptionVOSchema),
+			set: oc.input(SetNodeSubscriptionInputSchema).output(NodeSubscriptionVOSchema)
+		},
 		get: oc.route({
 			method: "GET",
 			path: "/nodes/{nodeId}",
@@ -5888,6 +5968,13 @@ const busabaseContractRoutes = {
 		}).input(createAuditEventInputSchema).output(auditEventSchema)
 	},
 	activity: {
+		listForRecordPaged: oc.route({
+			method: "GET",
+			path: "/activity/record/paged",
+			tags: ["Activity"],
+			summary: "List a record's activity with keyset pagination",
+			successDescription: "Record-scoped operations and audit events, newest first, with an opaque nextCursor (null at the end). Embedded change requests include this page's operations with capped field payloads and no reviews. Embedded records are summaries with capped field payloads and Base identity, without Base fields, people cells, or lookups. Get the change request for the complete diff and reviews; get the record for all field values."
+		}).input(listRecordActivityPagedInputSchema).output(listActivityResponseSchema),
 		listPaged: oc.route({
 			method: "GET",
 			path: "/activity/paged",
@@ -5982,6 +6069,12 @@ members: oc.output(z.array(userRefSchema)) },
 	templates: templatesContract,
 	guides: guidesContract,
 	changeRequests: {
+		createPreviewLink: oc.route({
+			method: "POST",
+			path: "/change-requests/{changeRequestId}/preview-link",
+			tags: ["Change Requests"],
+			summary: "Create a short-lived preview link for a visible Change Request"
+		}).input(z.object({ changeRequestId: z.string().min(1) }).strict()).output(CreatedEmbedLinkVOSchema),
 		list: oc.route({
 			method: "GET",
 			path: "/change-requests",

package/package.json

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