better-supabase 0.7.1 → 0.9.0

package/dist/blocks/work-items/index.d.ts

@@ -0,0 +1,208 @@
+/// <reference lib="esnext.temporal" />
+import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
+import { wt as Events } from "../../events-CTreRrgP.js";
+import { T as WorkItemEventData } from "../../index-BlqrGvb3.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-C86hPEjI.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BLPWD3Jt.js";
+import { n as ExtraFields, r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { t as SubjectConfig } from "../../subjects-z8VWA_lF.js";
+//#region src/blocks/work-items/work-items.d.ts
+/** The state a stage's category sets; `completed` and `canceled` are closed. */
+type WorkItemState = "triage" | "backlog" | "unstarted" | "started" | "completed" | "canceled";
+type CloseReason = "completed" | "not_planned" | "duplicate";
+/** A work item. `F` types the extra columns the `fields` schema describes. */
+interface WorkItem<F extends object = Record<never, never>> {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly number: bigint;
+  /** `TASK-12`, or the number-sequences format. */
+  readonly identifier: string;
+  readonly title: string;
+  readonly body?: string;
+  readonly parentId?: string;
+  readonly teamId?: string;
+  readonly projectId?: string;
+  readonly iterationId?: string;
+  /** 0 none, 1 urgent, 2 high, 3 medium, 4 low. */
+  readonly priority: number;
+  readonly estimate?: number;
+  /** Its own progress; `tree` rolls children up when it has none. */
+  readonly progress?: number;
+  readonly startAt?: Temporal.Instant;
+  readonly endAt?: Temporal.Instant;
+  readonly dueAt?: Temporal.Instant;
+  readonly pipelineId?: string;
+  readonly stageId?: string;
+  readonly stageEnteredAt?: Temporal.Instant;
+  readonly state: WorkItemState;
+  readonly closeReason?: CloseReason;
+  readonly closedAt?: Temporal.Instant;
+  /** A locked item keeps its dates, as a locked Gantt bar. */
+  readonly locked: boolean;
+  readonly rank: string;
+  readonly assigneeIds: readonly string[];
+  /** The extra columns, keyed by database name. */
+  readonly fields: ExtraFields<F>;
+  readonly archived: boolean;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+}
+interface WorkItemInput<F extends object = Record<never, never>> {
+  readonly title: string;
+  readonly body?: string;
+  readonly parentId?: string;
+  readonly teamId?: string;
+  readonly projectId?: string;
+  readonly iterationId?: string;
+  readonly priority?: number;
+  readonly estimate?: number;
+  readonly progress?: number;
+  readonly startAt?: Temporal.Instant;
+  readonly endAt?: Temporal.Instant;
+  readonly dueAt?: Temporal.Instant;
+  readonly pipelineId?: string;
+  readonly stageId?: string;
+  /** The extra columns to set. */
+  readonly fields?: Partial<F>;
+}
+type WorkItemField = "title" | "body" | "parentId" | "teamId" | "projectId" | "iterationId" | "priority" | "estimate" | "progress" | "startAt" | "endAt" | "dueAt" | "stageId" | "closeReason";
+/** One cell edit or drag: a built-in field or an extra column. `null` clears the field. */
+interface WorkItemChange<F extends object = Record<never, never>> {
+  readonly workItemId: string;
+  readonly field: WorkItemField | (keyof F & string);
+  readonly value: unknown;
+}
+interface WorkItemChangeResult {
+  readonly accepted: readonly {
+    readonly workItemId: string;
+    readonly field: string;
+  }[];
+  readonly rejected: readonly {
+    readonly workItemId: string;
+    readonly field: string;
+    readonly hint?: string;
+    readonly reason: string;
+  }[];
+}
+/** A node of `tree`, for a Gantt chart or a nested list. */
+interface WorkItemNode {
+  readonly id: string;
+  readonly parentId?: string;
+  readonly identifier: string;
+  readonly title: string;
+  readonly state: WorkItemState;
+  readonly startAt?: Temporal.Instant;
+  readonly endAt?: Temporal.Instant;
+  readonly dueAt?: Temporal.Instant;
+  readonly locked: boolean;
+  readonly depth: number;
+  readonly progress: number;
+}
+interface WorkItemListOptions {
+  readonly teamId?: string;
+  readonly projectId?: string;
+  readonly iterationId?: string;
+  readonly parentId?: string;
+  readonly assigneeId?: string;
+  readonly states?: readonly WorkItemState[];
+  /** Only items that aren't completed or canceled. */
+  readonly open?: boolean;
+  /** Matches the title, or the start of the identifier. */
+  readonly search?: string;
+  /** Continues after this item. */
+  readonly after?: string;
+  readonly limit?: number;
+}
+interface Project {
+  readonly id: string;
+  readonly key: string;
+  readonly name: string;
+  readonly ownerId?: string;
+  readonly status: "planned" | "active" | "paused" | "completed" | "canceled";
+  readonly startOn?: Temporal.PlainDate;
+  readonly targetOn?: Temporal.PlainDate;
+  /** The share of its items that are completed, canceled ones left out. */
+  readonly progress?: number;
+}
+interface Iteration {
+  readonly id: string;
+  readonly teamId?: string;
+  readonly name: string;
+  readonly startsOn: Temporal.PlainDate;
+  readonly endsOn: Temporal.PlainDate;
+}
+interface WorkItems<F extends object = Record<never, never>> {
+  create(organizationId: string, input: WorkItemInput<F>, assigneeIds?: readonly string[]): AsyncResult<WorkItem<F>>;
+  /** Extra column changes are validated with the `fields` schema first. */
+  update(changes: readonly WorkItemChange<F>[]): AsyncResult<WorkItemChangeResult>;
+  /** Replaces the assignees; new ones are notified and every one watches. */
+  assign(workItemId: string, userIds: readonly string[]): AsyncResult<number>;
+  archive(workItemId: string, archived?: boolean): AsyncResult<boolean>;
+  remove(workItemId: string): AsyncResult<boolean>;
+  tree(rootId: string): AsyncResult<WorkItemNode[]>;
+  list(organizationId: string, options?: WorkItemListOptions): AsyncResult<WorkItem<F>[]>;
+  saveProject(organizationId: string, project: Partial<Omit<Project, "id" | "progress" | "startOn" | "targetOn">> & {
+    readonly id?: string;
+    readonly startOn?: Temporal.PlainDate | null;
+    readonly targetOn?: Temporal.PlainDate | null;
+    readonly archived?: boolean;
+  }): AsyncResult<Project>;
+  saveIteration(organizationId: string, iteration: Partial<Omit<Iteration, "id">> & {
+    readonly id?: string;
+  }): AsyncResult<Iteration>;
+}
+interface WorkItemsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
+  readonly transport: BlockTransport;
+  readonly schema?: string;
+  /**
+   * A Standard Schema for the item's extra columns
+   * (`blocks.work-items.options.extraColumns`), keyed by database name. It
+   * types and parses them on reads, and validates them on `create` and
+   * `update`.
+   */
+  readonly fields?: S;
+  readonly hooks?: NoInfer<BlockHooks<WorkItems<FieldsOf<S>>>>;
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+/**
+ * The work-items block: issues and tasks on pipelines, with batched edits
+ * for a grid or a Gantt chart, assignees, a progress tree, projects and
+ * iterations.
+ */
+export declare function createWorkItems<S extends StandardSchemaV1 | undefined = undefined>(options: WorkItemsOptions<S>): WorkItems<FieldsOf<S>>;
+/**
+ * The `config.subjects` entry for work items, so comments, tags, files,
+ * relations (`blocks` for Gantt dependencies), rank and search attach.
+ * The board moves an item by its stage id.
+ */
+export declare function workItemsSubjects(options?: {
+  readonly schema?: string;
+  readonly url?: string;
+}): {
+  readonly work_item: SubjectConfig;
+};
+//#endregion
+//#region src/blocks/work-items/events.d.ts
+/** The events of the `work-items` block: type to data. */
+type WorkItemsEvents = {
+  readonly "work_item.created": WorkItemEventData;
+  readonly "work_item.updated": WorkItemEventData;
+  readonly "work_item.assigned": WorkItemEventData;
+  readonly "work_item.closed": WorkItemEventData;
+  readonly "work_item.reopened": WorkItemEventData;
+  readonly "work_item.archived": WorkItemEventData;
+  readonly "work_item.deleted": WorkItemEventData;
+};
+/** The `work-items` block's event types, for its manifest and `onBlockEvent`. */
+export declare const workItemsEvents: Events<WorkItemsEvents>;
+//#endregion
+//#region src/blocks/work-items/manifest.d.ts
+/** The `work-items` block's manifest (ADR 0029). */
+export declare const workItemsBlock: BlockOf<"work-items", typeof createWorkItems, WorkItemsEvents>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type CloseReason, type Iteration, type Project, type RpcClient, type WorkItem, type WorkItemChange, type WorkItemChangeResult, type WorkItemField, type WorkItemInput, type WorkItemListOptions, type WorkItemNode, type WorkItemState, type WorkItems, type WorkItemsEvents, type WorkItemsOptions, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/work-items/index.js

@@ -0,0 +1,305 @@
+import { t as temporal } from "../../temporal-required-DqRzr7i0.js";
+import { a as ok, t as AsyncResult } from "../../result-BlgnMB0H.js";
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, S as optionalInstant, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { n as blockFields } from "../../block-fields-ffD6Gxe4.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as workItemsSqlOptions } from "../../options-D1blDihM.js";
+//#region src/blocks/work-items/work-items.ts
+const STATES = [
+	"triage",
+	"backlog",
+	"unstarted",
+	"started",
+	"completed",
+	"canceled"
+];
+/** The fields `update` writes without the `fields` schema. */
+const BUILT_IN = /* @__PURE__ */ new Set([
+	"title",
+	"body",
+	"parentId",
+	"teamId",
+	"projectId",
+	"iterationId",
+	"priority",
+	"estimate",
+	"progress",
+	"startAt",
+	"endAt",
+	"dueAt",
+	"stageId",
+	"closeReason"
+]);
+const KNOWN = /* @__PURE__ */ new Set([
+	"id",
+	"tenant_id",
+	"number",
+	"identifier",
+	"title",
+	"body",
+	"parent_id",
+	"team_id",
+	"project_id",
+	"iteration_id",
+	"priority",
+	"estimate",
+	"progress",
+	"start_at",
+	"end_at",
+	"due_at",
+	"pipeline_id",
+	"stage_id",
+	"stage_entered_at",
+	"state",
+	"close_reason",
+	"closed_at",
+	"locked",
+	"rank",
+	"archived_at",
+	"created_by",
+	"created_at",
+	"updated_at",
+	"assignees"
+]);
+function compact(value) {
+	return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0));
+}
+const num = (value) => {
+	if (typeof value === "number") return value;
+	if (typeof value === "string" && value !== "") return Number(value);
+};
+const date = (value) => typeof value === "string" ? temporal().PlainDate.from(value.slice(0, 10)) : void 0;
+function itemOf(value) {
+	const row = recordOf(value, "work item");
+	const reason = optionalText(row["close_reason"]);
+	return compact({
+		id: textOf(row["id"]),
+		organizationId: textOf(row["tenant_id"]),
+		number: BigInt(textOf(row["number"])),
+		identifier: textOf(row["identifier"]),
+		title: textOf(row["title"]),
+		body: optionalText(row["body"]),
+		parentId: optionalText(row["parent_id"]),
+		teamId: optionalText(row["team_id"]),
+		projectId: optionalText(row["project_id"]),
+		iterationId: optionalText(row["iteration_id"]),
+		priority: num(row["priority"]) ?? 0,
+		estimate: num(row["estimate"]),
+		progress: num(row["progress"]),
+		startAt: optionalInstant(row["start_at"]),
+		endAt: optionalInstant(row["end_at"]),
+		dueAt: optionalInstant(row["due_at"]),
+		pipelineId: optionalText(row["pipeline_id"]),
+		stageId: optionalText(row["stage_id"]),
+		stageEnteredAt: optionalInstant(row["stage_entered_at"]),
+		state: enumOrThrow(row["state"], STATES, "work item state"),
+		closeReason: reason === void 0 ? void 0 : enumOrThrow(reason, [
+			"completed",
+			"not_planned",
+			"duplicate"
+		], "close reason"),
+		closedAt: optionalInstant(row["closed_at"]),
+		locked: row["locked"] === true,
+		rank: textOf(row["rank"]),
+		assigneeIds: Array.isArray(row["assignees"]) ? row["assignees"].map(String) : [],
+		fields: Object.fromEntries(Object.entries(row).filter(([key]) => !KNOWN.has(key))),
+		archived: row["archived_at"] !== null && row["archived_at"] !== void 0,
+		createdAt: requiredInstant(row["created_at"], "createdAt"),
+		updatedAt: requiredInstant(row["updated_at"], "updatedAt")
+	});
+}
+function nodeOf(value) {
+	const row = recordOf(value, "work item node");
+	return compact({
+		id: textOf(row["id"]),
+		parentId: optionalText(row["parentId"]),
+		identifier: textOf(row["identifier"]),
+		title: textOf(row["title"]),
+		state: enumOrThrow(row["state"], STATES, "work item state"),
+		startAt: optionalInstant(row["startAt"]),
+		endAt: optionalInstant(row["endAt"]),
+		dueAt: optionalInstant(row["dueAt"]),
+		locked: row["locked"] === true,
+		depth: num(row["depth"]) ?? 0,
+		progress: num(row["progress"]) ?? 0
+	});
+}
+function projectOf(value) {
+	const row = recordOf(value, "project");
+	return compact({
+		id: textOf(row["id"]),
+		key: textOf(row["key"]),
+		name: textOf(row["name"]),
+		ownerId: optionalText(row["owner_user_id"]),
+		status: enumOrThrow(row["status"], [
+			"planned",
+			"active",
+			"paused",
+			"completed",
+			"canceled"
+		], "project status"),
+		startOn: date(row["start_on"]),
+		targetOn: date(row["target_on"]),
+		progress: num(row["progress"])
+	});
+}
+function iterationOf(value) {
+	const row = recordOf(value, "iteration");
+	return compact({
+		id: textOf(row["id"]),
+		teamId: optionalText(row["team_id"]),
+		name: textOf(row["name"]),
+		startsOn: date(row["starts_on"]) ?? temporal().PlainDate.from("1970-01-01"),
+		endsOn: date(row["ends_on"]) ?? temporal().PlainDate.from("1970-01-01")
+	});
+}
+/** A value as the database reads it: instants and dates as ISO text. */
+function valueArg(value) {
+	if (value instanceof temporal().Instant || value instanceof temporal().PlainDate) return value.toString();
+	return value;
+}
+const args = (input) => Object.fromEntries(Object.entries(input).map(([key, value]) => [key, valueArg(value)]));
+/**
+* The work-items block: issues and tasks on pipelines, with batched edits
+* for a grid or a Gantt chart, assignees, a progress tree, projects and
+* iterations.
+*/
+function createWorkItems(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const fields = blockFields(options.fields, "work item fields");
+	return withBlockHooks({
+		create: (organizationId, input, assigneeIds) => {
+			const { fields: extra, ...attrs } = input;
+			return fields.args(extra).andThen((checked) => call("create_work_item", {
+				tenant: organizationId,
+				attrs: {
+					...args(attrs),
+					...checked === void 0 ? {} : { fields: checked }
+				},
+				assignees: assigneeIds === void 0 ? null : [...assigneeIds]
+			}, itemOf).andThen(fields.row));
+		},
+		update: (changes) => AsyncResult.from(async () => {
+			for (const change of changes) {
+				if (BUILT_IN.has(change.field)) continue;
+				const valid = await fields.write({ [change.field]: change.value });
+				if (!valid.ok) return valid;
+			}
+			return ok(changes);
+		}).andThen((checked) => call("update_work_items", { changes: checked.map((change) => ({
+			workItemId: change.workItemId,
+			field: change.field,
+			value: valueArg(change.value)
+		})) }, (value) => {
+			const row = recordOf(value, "update_work_items");
+			return {
+				accepted: recordsOf(row["accepted"], "accepted").map((item) => ({
+					workItemId: textOf(item["workItemId"]),
+					field: textOf(item["field"])
+				})),
+				rejected: recordsOf(row["rejected"], "rejected").map((item) => compact({
+					workItemId: textOf(item["workItemId"]),
+					field: textOf(item["field"]),
+					hint: optionalText(item["hint"]),
+					reason: textOf(item["reason"])
+				}))
+			};
+		})),
+		assign: (workItemId, userIds) => call("set_work_item_assignees", {
+			work_item: workItemId,
+			users: [...userIds]
+		}, (value) => num(value) ?? 0),
+		archive: (workItemId, archived = true) => call("archive_work_item", {
+			work_item: workItemId,
+			archived
+		}, (value) => value === true),
+		remove: (workItemId) => call("delete_work_item", { work_item: workItemId }, (value) => value === true),
+		tree: (rootId) => call("work_item_tree", { root: rootId }, (value) => recordsOf(value, "work_item_tree").map(nodeOf)),
+		list: (organizationId, list = {}) => {
+			const { search, after, limit, ...filter } = list;
+			return call("list_work_items", {
+				tenant: organizationId,
+				filter,
+				search: search ?? null,
+				after: after ?? null,
+				page_size: limit ?? null
+			}, (value) => recordsOf(value, "list_work_items").map(itemOf)).andThen(fields.rows);
+		},
+		saveProject: (organizationId, project) => {
+			const { id, ...attrs } = project;
+			return call("save_project", {
+				tenant: organizationId,
+				project: id ?? null,
+				attrs: args(attrs)
+			}, projectOf);
+		},
+		saveIteration: (organizationId, iteration) => {
+			const { id, ...attrs } = iteration;
+			return call("save_iteration", {
+				tenant: organizationId,
+				iteration: id ?? null,
+				attrs: args(attrs)
+			}, iterationOf);
+		}
+	}, options.hooks, {
+		block: "work-items",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+/**
+* The `config.subjects` entry for work items, so comments, tags, files,
+* relations (`blocks` for Gantt dependencies), rank and search attach.
+* The board moves an item by its stage id.
+*/
+function workItemsSubjects(options = {}) {
+	return { work_item: {
+		table: `${options.schema ?? "better_supabase"}.work_items`,
+		idType: "uuid",
+		tenant: "tenant_id",
+		title: "title",
+		deletedAt: "archived_at",
+		permissions: {
+			read: "work_items.read",
+			write: "work_items.write"
+		},
+		rank: {
+			column: "rank",
+			group: "stage_id"
+		},
+		search: {
+			title: "title",
+			body: ["identifier", "body"]
+		},
+		...options.url === void 0 ? {} : { url: options.url }
+	} };
+}
+//#endregion
+//#region src/blocks/work-items/events.ts
+/** The `work-items` block's event types, for its manifest and `onBlockEvent`. */
+const workItemsEvents = defineEvents({
+	"work_item.created": event(),
+	"work_item.updated": event(),
+	"work_item.assigned": event(),
+	"work_item.closed": event(),
+	"work_item.reopened": event(),
+	"work_item.archived": event(),
+	"work_item.deleted": event()
+});
+//#endregion
+//#region src/blocks/work-items/manifest.ts
+/** The `work-items` block's manifest (ADR 0029). */
+const workItemsBlock = defineBlock({
+	name: "work-items",
+	sql: ["work-items"],
+	options: { "work-items": workItemsSqlOptions },
+	events: workItemsEvents,
+	create: createWorkItems,
+	category: "work",
+	recipes: ["work-item-board", "work-item-grid"]
+});
+//#endregion
+export { createWorkItems, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, workItemsBlock, workItemsEvents, workItemsSubjects, wrapTransport };

package/dist/blocks/workflow-builder/index.d.ts

@@ -1,6 +1,11 @@
-import { i as sqlTransport, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
-import { A as approved, C as WorkflowCondition, D as WorkflowGraphEdge, E as WorkflowGraphDiff, F as validateGraph, M as durationMs, N as evaluateCondition, O as WorkflowGraphNode, P as topologicalOrder, S as WorkflowVersionStatus, T as WorkflowGraph, _ as WorkflowNodeRunStatus, a as CredentialInput, b as WorkflowTriggerKind, c as NodeRunRecord, d as TriggerInput, f as WorkflowAlert, g as WorkflowNodeRun, h as WorkflowDefinition, i as BuilderStarter, j as diffGraphs, k as WorkflowNodeKind, l as OutboxLikeEvent, m as WorkflowCredential, n as BuilderOptions, o as DefinitionInput, p as WorkflowBuilder, r as BuilderStartCall, s as GraphCompiler, t as AlertInput, u as RunInput, v as WorkflowStepInfo, w as WorkflowConditionOperator, x as WorkflowVersion, y as WorkflowTrigger } from "../../types-AYOvcyep.js";
-import { i as executeGraph, n as GraphStepCall, r as approvalToken, t as GraphRuntime } from "../../executor-BVBFM86G.js";
+import { gt as WorkflowEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { $ as validateGraph, A as WorkflowVersion, B as WorkflowGraphDiff, C as WorkflowGrantAction, D as WorkflowStepInfo, E as WorkflowNodeRunStatus, F as WorkflowCondition, G as approved, H as WorkflowGraphNode, I as WorkflowConditionOperator, J as evaluateCondition, K as diffGraphs, L as WorkflowFilterCondition, M as WorkflowVersionStatus, N as GraphScope, O as WorkflowTrigger, P as TriggerEvent, Q as triggerMatches, R as WorkflowFilterField, S as WorkflowDefinitionScope, T as WorkflowNodeRun, U as WorkflowNodeCondition, V as WorkflowGraphEdge, W as WorkflowNodeKind, X as matchesFilter, Y as filterConditionOf, Z as topologicalOrder, _ as WorkflowBuilder, a as CredentialInput, b as WorkflowDefinition, c as GraphCompiler, d as PublishOptions, f as RunInput, g as WorkflowAlert, h as VersionSaveOptions, i as BuilderStarter, j as WorkflowVersionOwner, k as WorkflowTriggerKind, l as NodeRunRecord, m as TriggerInput, n as BuilderOptions, o as DefinitionInput, p as TestRunInput, q as durationMs, r as BuilderStartCall, s as GrantInput, t as AlertInput, u as OutboxLikeEvent, v as WorkflowBuilderHooks, w as WorkflowGrantPrincipal, x as WorkflowDefinitionGrant, y as WorkflowCredential, z as WorkflowGraph } from "../../types-vaoP9S9_.js";
+import { a as GraphSubject, c as graphRunFields, i as GraphStepCall, l as startNodeOf, n as GraphRunFields, o as approvalToken, r as GraphRuntime, s as executeGraph, t as GraphApprovalCall } from "../../executor-BINiCFNp.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, l as createWorkflowBuilderController, n as WorkflowBuilderController, o as WorkflowCanvasRunController, r as WorkflowBuilderControllerOptions, s as WorkflowCanvasRunControllerOptions, t as WorkflowBuilderActions, u as createWorkflowCanvasRunController } from "../../client-VvY0K3wr.js";
 //#region src/blocks/workflow-builder/workflow-builder.d.ts
 /**
  * The `workflow-builder` module's definitions, versions, triggers,
@@ -9,13 +14,28 @@ import { i as executeGraph, n as GraphStepCall, r as approvalToken, t as GraphRu
  * `credentials` providers.
  *
  * ```ts
- * const builder = createBuilder({
+ * const builder = createWorkflowBuilder({
  *   transport: rpcTransport(supabase),
  *   compile: compileGraph,
  *   start: graphStarter({ executor: builderWorkflow, steps: { runNode } }),
  * });
  * ```
  */
-export declare function createBuilder(options: BuilderOptions): WorkflowBuilder;
+export declare function createWorkflowBuilder<S extends StandardSchemaV1 | undefined = undefined>(options: BuilderOptions<S>): WorkflowBuilder<FieldsOf<S>>;
 //#endregion
-export { type AlertInput, type BlockTransport, type BuilderOptions, type BuilderStartCall, type BuilderStarter, type CredentialInput, type DefinitionInput, type GraphCompiler, type GraphRuntime, type GraphStepCall, type NodeRunRecord, type OutboxLikeEvent, type RunInput, type TriggerInput, type WorkflowAlert, type WorkflowBuilder, type WorkflowCondition, type WorkflowConditionOperator, type WorkflowCredential, type WorkflowDefinition, type WorkflowGraph, type WorkflowGraphDiff, type WorkflowGraphEdge, type WorkflowGraphNode, type WorkflowNodeKind, type WorkflowNodeRun, type WorkflowNodeRunStatus, type WorkflowStepInfo, type WorkflowTrigger, type WorkflowTriggerKind, type WorkflowVersion, type WorkflowVersionStatus, approvalToken, approved, diffGraphs, durationMs, evaluateCondition, executeGraph, rpcTransport, sqlTransport, topologicalOrder, validateGraph };
+//#region src/blocks/workflow-builder/events.d.ts
+/** The events of the `workflow-builder` block: type to data. */
+type WorkflowBuilderEvents = {
+  readonly "workflow.published": WorkflowEventData;
+  readonly "workflow_alert.triggered": WorkflowEventData;
+};
+/** The `workflow-builder` block's event types, for its manifest and `onBlockEvent`. */
+export declare const workflowBuilderEvents: Events<WorkflowBuilderEvents>;
+//#endregion
+//#region src/blocks/workflow-builder/manifest.d.ts
+/** The `workflow-builder` block's manifest (ADR 0029). */
+export declare const workflowBuilderBlock: BlockOf<"workflow-builder", typeof createWorkflowBuilder, WorkflowBuilderEvents, {
+  readonly workflows: "optional";
+}>;
+//#endregion
+export { type AlertInput, type BlockTransport, type BuilderOptions, type BuilderStartCall, type BuilderStarter, type CredentialInput, type DefinitionInput, type GrantInput, type GraphApprovalCall, type GraphCompiler, type GraphRunFields, type GraphRuntime, type GraphScope, type GraphStepCall, type GraphSubject, type NodeRunRecord, type OutboxLikeEvent, type PublishOptions, type RunInput, type TestRunInput, type TriggerEvent, type TriggerInput, type VersionSaveOptions, type WorkflowAlert, type WorkflowBuilder, type WorkflowBuilderActions, type WorkflowBuilderController, type WorkflowBuilderControllerOptions, type WorkflowBuilderEvents, type WorkflowBuilderHooks, type WorkflowBuilderSnapshot, type WorkflowCanvasRunActions, type WorkflowCanvasRunController, type WorkflowCanvasRunControllerOptions, type WorkflowCanvasRunSnapshot, type WorkflowCondition, type WorkflowConditionOperator, type WorkflowCredential, type WorkflowDefinition, type WorkflowDefinitionGrant, type WorkflowDefinitionScope, type WorkflowFilterCondition, type WorkflowFilterField, type WorkflowGrantAction, type WorkflowGrantPrincipal, type WorkflowGraph, type WorkflowGraphDiff, type WorkflowGraphEdge, type WorkflowGraphNode, type WorkflowNodeCondition, type WorkflowNodeKind, type WorkflowNodeRun, type WorkflowNodeRunStatus, type WorkflowStepInfo, type WorkflowTrigger, type WorkflowTriggerKind, type WorkflowVersion, type WorkflowVersionOwner, type WorkflowVersionStatus, approvalToken, approved, createWorkflowBuilderController, createWorkflowCanvasRunController, dbTransport, diffGraphs, durationMs, evaluateCondition, executeGraph, filterConditionOf, graphRunFields, matchesFilter, rpcTransport, sqlTransport, startNodeOf, topologicalOrder, triggerMatches, validateGraph };

package/dist/blocks/workflow-builder/index.js

@@ -1,5 +1,30 @@
-import { n as rpcTransport, r as sqlTransport } from "../../block-transport-BLr-ZgLc.js";
-import { a as evaluateCondition, c as topologicalOrder, i as durationMs, l as validateGraph, r as diffGraphs, t as approved } from "../../graph-BGyLLFLX.js";
-import { t as createBuilder } from "../../workflow-builder-DJ1oHn8g.js";
-import { n as executeGraph, t as approvalToken } from "../../executor-C-R4pucm.js";
-export { approvalToken, approved, createBuilder, diffGraphs, durationMs, evaluateCondition, executeGraph, rpcTransport, sqlTransport, topologicalOrder, validateGraph };
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { a as evaluateCondition, d as triggerMatches, i as durationMs, l as matchesFilter, o as filterConditionOf, p as validateGraph, r as diffGraphs, t as approved, u as topologicalOrder } from "../../graph-Cs28bOlK.js";
+import { t as createWorkflowBuilder } from "../../workflow-builder-OrglbXUh.js";
+import { i as startNodeOf, n as executeGraph, r as graphRunFields, t as approvalToken } from "../../executor-D3K3tycZ.js";
+import { n as createWorkflowCanvasRunController, t as createWorkflowBuilderController } from "../../client-BzCv4kKE.js";
+import { t as workflowBuilderSqlOptions } from "../../options-DsUgamiy.js";
+//#region src/blocks/workflow-builder/events.ts
+/** The `workflow-builder` block's event types, for its manifest and `onBlockEvent`. */
+const workflowBuilderEvents = defineEvents({
+	"workflow.published": event(),
+	"workflow_alert.triggered": event()
+});
+//#endregion
+//#region src/blocks/workflow-builder/manifest.ts
+/** The `workflow-builder` block's manifest (ADR 0029). */
+const workflowBuilderBlock = defineBlock({
+	name: "workflow-builder",
+	sql: ["workflow-builder"],
+	options: { "workflow-builder": workflowBuilderSqlOptions },
+	events: workflowBuilderEvents,
+	consumes: { workflows: "optional" },
+	create: createWorkflowBuilder,
+	client: "workflow-builder",
+	category: "automation",
+	recipes: ["workflow-canvas"]
+});
+//#endregion
+export { approvalToken, approved, createWorkflowBuilder, createWorkflowBuilderController, createWorkflowCanvasRunController, dbTransport, diffGraphs, durationMs, evaluateCondition, executeGraph, filterConditionOf, graphRunFields, matchesFilter, rpcTransport, sqlTransport, startNodeOf, topologicalOrder, triggerMatches, validateGraph, workflowBuilderBlock, workflowBuilderEvents };

package/dist/blocks/workflow-builder/react/index.d.ts

@@ -1,7 +1,5 @@
-import { b as DbError } from "../../../result-D7y2fT87.js";
-import { x as SubscriptionStatus } from "../../../index-DunNRdnT.js";
-import { t as WorkflowRun } from "../../../workflows-B0j9WKPu.js";
-import { g as WorkflowNodeRun, h as WorkflowDefinition, p as WorkflowBuilder, v as WorkflowStepInfo } from "../../../types-AYOvcyep.js";
+import { _ as WorkflowBuilder } from "../../../types-vaoP9S9_.js";
+import { a as WorkflowCanvasRunActions, c as WorkflowCanvasRunSnapshot, i as WorkflowBuilderSnapshot, t as WorkflowBuilderActions } from "../../../client-VvY0K3wr.js";
 //#region src/blocks/workflow-builder/react/index.d.ts
 export interface UseWorkflowBuilderOptions {
   /** The tenant whose definitions to list. */
@@ -9,13 +7,7 @@ export interface UseWorkflowBuilderOptions {
   /** The schema the calls go to (default `better_supabase`). */
   readonly schema?: string;
 }
-export interface WorkflowBuilderState {
-  /** `undefined` until the first load. */
-  readonly definitions: readonly WorkflowDefinition[] | undefined;
-  /** The step library, the canvas's palette. */
-  readonly steps: readonly WorkflowStepInfo[] | undefined;
-  readonly error: DbError | undefined;
-  readonly refresh: () => Promise<void>;
+export interface WorkflowBuilderState extends WorkflowBuilderSnapshot, WorkflowBuilderActions {
   /** The builder for the signed-in user, for saves, publishes and runs. */
   readonly builder: WorkflowBuilder;
 }
@@ -31,14 +23,7 @@ export declare function useWorkflowBuilder(options?: UseWorkflowBuilderOptions):
 export interface UseWorkflowCanvasRunOptions {
   readonly schema?: string;
 }
-export interface WorkflowCanvasRunState {
-  readonly run: WorkflowRun | undefined;
-  /** Each node's status by node id, for the canvas overlay. */
-  readonly nodes: Readonly<Record<string, WorkflowNodeRun>>;
-  readonly error: DbError | undefined;
-  readonly status: SubscriptionStatus;
-  readonly refresh: () => Promise<void>;
-}
+export interface WorkflowCanvasRunState extends WorkflowCanvasRunSnapshot, WorkflowCanvasRunActions {}
 /**
  * A run and the status of each of its nodes, loaded again on each message
  * on `workflow-run:<id>` (run status changes and node records).