better-supabase 0.13.0 → 0.14.0

package/dist/blocks/drive/index.js

@@ -1,17 +1,23 @@
-import { n as dbError } from "../../errors-D7u24ZJH.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-DIT_qp4G.js";
+import { n as dbError } from "../../errors-03ysrOt4.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as driveSqlOptions } from "../../options-DCduTMST.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
+import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.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-DwE32_gT.js";
-import { r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { n as blockFields } from "../../block-fields-Cwd4c8m-.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { n as claimsUploads, t as claimUpload } from "../../upload-claim-DCuklVyh.js";
-import { a as stored, t as attachmentOf } from "../../attachments-CPkGJVfk.js";
+import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as claimsUploads, t as claimUpload } from "../../upload-claim-D_wgDbi7.js";
+import { o as stored, t as attachmentOf } from "../../attachments-Cjdgarpa.js";
 //#region src/blocks/drive/drive.ts
 const KINDS = ["folder", "file"];
+const APPROVAL_STATUSES = [
+	"pending",
+	"approved",
+	"rejected",
+	"cancelled",
+	"expired"
+];
 const PRINCIPALS = [
 	"user",
 	"team",
@@ -44,7 +50,34 @@ function nodeOf(value, fn) {
 		fields: isRecord(row["fields"]) ? row["fields"] : {},
 		role: optionalText(row["role"]),
 		starredAt: optionalInstant(row["starredAt"]),
-		openedAt: optionalInstant(row["openedAt"])
+		openedAt: optionalInstant(row["openedAt"]),
+		labels: Array.isArray(row["labels"]) ? recordsOf(row["labels"], fn).map((label) => ({
+			id: textOf(label["id"]),
+			name: textOf(label["name"]),
+			color: optionalText(label["color"])
+		})) : void 0,
+		approval: isRecord(row["approval"]) ? approvalStateOf(row["approval"]) : void 0
+	};
+}
+function approvalStateOf(row) {
+	return {
+		id: textOf(row["id"]),
+		status: enumOrThrow(row["status"], APPROVAL_STATUSES, "approval status"),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		decidedAt: optionalInstant(row["decidedAt"])
+	};
+}
+function approvalOf(value, fn) {
+	const row = recordOf(value, fn);
+	const revision = row["revision"];
+	return {
+		...approvalStateOf(row),
+		attachmentId: textOf(row["attachmentId"]),
+		revision: revision === null || revision === void 0 ? void 0 : Number(revision),
+		current: row["current"] === true,
+		step: Number(row["step"]),
+		reason: optionalText(row["reason"]),
+		requestedBy: optionalText(row["requestedBy"])
 	};
 }
 const nodesOf = (value, fn) => recordsOf(value, fn).map((row) => nodeOf(row, fn));
@@ -142,7 +175,9 @@ const NODE_METHODS = [
 	"open",
 	"starred",
 	"recent",
-	"link"
+	"link",
+	"label",
+	"labeled"
 ];
 const isNode = (value) => typeof value["kind"] === "string" && typeof value["organizationId"] === "string";
 /**
@@ -336,6 +371,22 @@ function createDrive(options) {
 			recent: true,
 			page_size: list.pageSize ?? null
 		}),
+		label: (id, tagId, applied = true) => call("drive_label", {
+			node: id,
+			tag: tagId,
+			applied
+		}, (value) => nodeOf(value, "drive_label")),
+		labeled: (organizationId, tagId, list = {}) => page("drive_labeled", {
+			tenant: organizationId,
+			tag: tagId,
+			page_size: list.pageSize ?? null
+		}),
+		requestApproval: (id, request = {}) => call("drive_request_approval", {
+			node: id,
+			attachment: request.attachmentId ?? null,
+			reason: request.reason ?? null
+		}, (value) => approvalOf(value, "drive_request_approval")),
+		approvals: (id) => call("drive_approvals", { node: id }, (value) => recordsOf(value, "drive_approvals").map((row) => approvalOf(row, "drive_approvals"))),
 		link: (token, link = {}) => call("drive_link", {
 			token,
 			node: link.nodeId ?? null

package/dist/blocks/employees/index.d.ts

@@ -1,197 +1,9 @@
-/// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-mijqfoJN.js";
-import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
-import { r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { wt as Events } from "../../events-DhGgwqQA.js";
-import { g as EmployeeEventData } from "../../index-CE0p3st5.js";
-import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-DyA5BAW4.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BadAniNI.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { t as SubjectConfig } from "../../subjects-DQ2SU4cA.js";
-import { n as Money } from "../../money-BNRdJQzA.js";
-import { t as RecordRef } from "../../sales-shared-DAAGwQwN.js";
-//#region src/blocks/employees/employees.d.ts
-type EmployeeStatus = "preboarding" | "active" | "on_leave" | "offboarded";
-type SalaryPeriod = "hour" | "week" | "month" | "year";
-/** An employee. `F` types the extra columns the `fields` schema describes. */
-interface Employee<F extends object = Record<never, never>> {
-  readonly id: string;
-  readonly organizationId: string;
-  readonly name: string;
-  readonly email?: string;
-  /**
-   * The account, when the employee has one; contractors and interns often
-   * don't.
-   */
-  readonly userId?: string;
-  readonly jobTitle?: string;
-  readonly teamId?: string;
-  readonly managerId?: string;
-  readonly employmentType?: string;
-  readonly status: EmployeeStatus;
-  readonly startDate?: Temporal.PlainDate;
-  readonly endDate?: Temporal.PlainDate;
-  readonly offboardReason?: string;
-  /** The record it was made from, such as `{ type: "application", id }`. */
-  readonly origin?: RecordRef;
-  readonly createdAt?: Temporal.Instant;
-  /** The app's extra columns (`options.extraColumns`), by column name. */
-  readonly fields: Readonly<Record<string, unknown>> & F;
-}
-/** An employee in the org chart or a manager's reports. */
-interface OrgChartEntry<F extends object = Record<never, never>> extends Employee<F> {
-  /** 0 for a root of the chart, 1 for a direct report. */
-  readonly depth: number;
-  readonly directReports: number;
-}
-interface EmployeeInput<F extends object = Record<never, never>> {
-  readonly name: string;
-  readonly email?: string;
-  readonly userId?: string;
-  readonly jobTitle?: string;
-  readonly teamId?: string;
-  readonly managerId?: string;
-  /** One of `options.employmentTypes`; the first one by default. */
-  readonly employmentType?: string;
-  /** Preboarding before the start date and active from it, by default. */
-  readonly status?: Exclude<EmployeeStatus, "offboarded">;
-  readonly startDate?: Temporal.PlainDate;
-  readonly endDate?: Temporal.PlainDate;
-  /** With an origin, creating again returns the same employee. */
-  readonly origin?: RecordRef;
-  readonly fields?: Partial<F> & Readonly<Record<string, unknown>>;
-}
-type EmployeeField = "name" | "email" | "userId" | "jobTitle" | "teamId" | "managerId" | "employmentType" | "status" | "startDate" | "endDate";
-/** One cell edit: a field above, or an extra column by name. `null` clears it. */
-interface EmployeeChange {
-  readonly employeeId: string;
-  readonly field: EmployeeField | (string & {});
-  readonly value: unknown;
-}
-interface EmployeeChangeResult {
-  readonly accepted: readonly {
-    readonly employeeId: string;
-    readonly field: string;
-  }[];
-  /** Each refused change, with the error hint and message. Others still applied. */
-  readonly rejected: readonly {
-    readonly employeeId: string;
-    readonly field: string;
-    readonly hint?: string;
-    readonly reason: string;
-  }[];
-}
-interface EmergencyContact {
-  readonly name: string;
-  readonly phone?: string;
-  readonly relation?: string;
-}
-interface PrivateDetails {
-  readonly employeeId: string;
-  readonly nationalId?: string;
-  readonly iban?: string;
-  readonly birthDate?: Temporal.PlainDate;
-  readonly personalEmail?: string;
-  readonly phone?: string;
-  readonly address?: Readonly<Record<string, unknown>>;
-  readonly emergencyContacts: readonly EmergencyContact[];
-  /** Set on offboarding, so an anonymize rule can start from it. */
-  readonly offboardedAt?: Temporal.Instant;
-  readonly anonymizedAt?: Temporal.Instant;
-}
-/** The details to save. Left out keeps the stored value; `null` clears it. */
-interface PrivateDetailsInput {
-  readonly nationalId?: string | null;
-  readonly iban?: string | null;
-  readonly birthDate?: Temporal.PlainDate | null;
-  readonly personalEmail?: string | null;
-  readonly phone?: string | null;
-  readonly address?: Readonly<Record<string, unknown>> | null;
-  readonly emergencyContacts?: readonly EmergencyContact[] | null;
-}
-/** A contract. */
-interface Contract {
-  readonly id: string;
-  readonly employeeId: string;
-  readonly startsOn: Temporal.PlainDate;
-  readonly endsOn?: Temporal.PlainDate;
-  readonly hoursPerWeek?: number;
-  readonly salary?: Money;
-  readonly salaryPeriod?: SalaryPeriod;
-  readonly note?: string;
-}
-interface ContractInput {
-  readonly startsOn: Temporal.PlainDate;
-  readonly endsOn?: Temporal.PlainDate;
-  readonly hoursPerWeek?: number;
-  readonly salary?: Money;
-  readonly salaryPeriod?: SalaryPeriod;
-  readonly note?: string;
-}
-interface Employees<F extends object = Record<never, never>> {
-  create(organizationId: string, input: EmployeeInput<F>): AsyncResult<Employee<F>>;
-  /** Applies each change on its own; one that fails doesn't stop the others. */
-  update(changes: readonly EmployeeChange[]): AsyncResult<EmployeeChangeResult>;
-  /**
-   * Sets the end date (today by default) and moves the reports to the
-   * employee's manager.
-   */
-  offboard(employeeId: string, options?: {
-    readonly endDate?: Temporal.PlainDate;
-    readonly reason?: string;
-  }): AsyncResult<Employee<F>>;
-  /** The chart under `rootId`, or under everyone without a manager. */
-  orgChart(organizationId: string, rootId?: string): AsyncResult<readonly OrgChartEntry<F>[]>;
-  /** Direct reports, or everyone under the manager with `indirect`. */
-  reportsOf(managerId: string, options?: {
-    readonly indirect?: boolean;
-  }): AsyncResult<readonly OrgChartEntry<F>[]>;
-  /**
-   * The employee for a hired application (the hiring module), in preboarding,
-   * made once. `overrides` replaces what the candidate and the job give.
-   */
-  fromApplication(applicationId: string, overrides?: Partial<EmployeeInput<F>>): AsyncResult<Employee<F>>;
-  /** Needs employees.view_sensitive, or being the employee. */
-  privateDetails(employeeId: string): AsyncResult<PrivateDetails | undefined>;
-  savePrivateDetails(employeeId: string, input: PrivateDetailsInput): AsyncResult<PrivateDetails>;
-  /** The newest first. */
-  contracts(employeeId: string): AsyncResult<readonly Contract[]>;
-  /** Starts after the latest contract, which ends the day before. */
-  addContract(employeeId: string, input: ContractInput): AsyncResult<Contract>;
-}
-interface EmployeesOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
-  readonly transport: BlockTransport;
-  readonly schema?: string;
-  /**
-   * A Standard Schema for the extra columns
-   * (`blocks.employees.options.extraColumns`), keyed by column name. It types
-   * and parses `fields` on reads and validates them on writes.
-   */
-  readonly fields?: S;
-  readonly hooks?: NoInfer<BlockHooks<Employees<FieldsOf<S>>>>;
-  readonly logger?: Logger;
-  readonly mappers?: readonly ErrorMapper[];
-}
-/**
- * The employees block: the people an organization employs, their manager, team
- * and status, the org chart, offboarding, and private details and contracts
- * behind employees.view_sensitive.
- */
-export declare function createEmployees<S extends StandardSchemaV1 | undefined = undefined>(options: EmployeesOptions<S>): Employees<FieldsOf<S>>;
-/**
- * The `config.subjects` entry for employees, so comments, files, tags and
- * search attach to them. Pass `schema` when the module isn't in
- * `better_supabase`.
- */
-export declare function employeesSubjects(options?: {
-  readonly schema?: string;
-  readonly url?: string;
-}): {
-  readonly employee: SubjectConfig;
-};
-//#endregion
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { c as EmployeeEventData } from "../../block-events-records-BGVyoz57.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
+import { c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { a as EmployeeChange, c as EmployeeInput, d as EmployeesOptions, f as OrgChartEntry, g as createEmployees, h as SalaryPeriod, i as Employee, l as EmployeeStatus, m as PrivateDetailsInput, n as ContractInput, o as EmployeeChangeResult, p as PrivateDetails, r as EmergencyContact, s as EmployeeField, t as Contract, u as Employees } from "../../employees-Dwyvxs4r.js";
 //#region src/blocks/employees/events.d.ts
 /** The events of the `employees` block: type to data. */
 type EmployeesEvents = {
@@ -207,4 +19,13 @@ export declare const employeesEvents: Events<EmployeesEvents>;
 /** The `employees` block's manifest (ADR 0029). */
 export declare const employeesBlock: BlockOf<"employees", typeof createEmployees, EmployeesEvents>;
 //#endregion
-export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Contract, type ContractInput, type EmergencyContact, type Employee, type EmployeeChange, type EmployeeChangeResult, type EmployeeField, type EmployeeInput, type EmployeeStatus, type Employees, type EmployeesEvents, type EmployeesOptions, type OrgChartEntry, type PrivateDetails, type PrivateDetailsInput, type RpcClient, type SalaryPeriod, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+//#region src/blocks/employees/schemas.d.ts
+/** What `create` takes, with the bounds the SQL checks. */
+export declare const employeeInputSchema: EntitySchema<EmployeeInput>;
+/**
+ * One edit `update` takes. `field` is a built-in field or an extra column, so
+ * any name passes; the SQL rejects an unknown one.
+ */
+export declare const employeeChangeSchema: EntitySchema<EmployeeChange>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Contract, type ContractInput, type EmergencyContact, type Employee, type EmployeeChange, type EmployeeChangeResult, type EmployeeField, type EmployeeInput, type EmployeeStatus, type Employees, type EmployeesEvents, type EmployeesOptions, type OrgChartEntry, type PrivateDetails, type PrivateDetailsInput, type RpcClient, type SalaryPeriod, createEmployees, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/employees/index.js

@@ -1,15 +1,15 @@
-import { t as temporal } from "../../temporal-required-Dt4mcPsi.js";
-import { a as ok, t as AsyncResult } from "../../result-DIT_qp4G.js";
+import { t as temporal } from "../../temporal-required-B8qQHYbI.js";
+import { a as ok, t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as employeesSqlOptions } from "../../options-DWpz3V3F.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { n as entitySchema } from "../../entity-schema-BXXC1NnT.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
-import { 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-DwE32_gT.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { n as blockFields } from "../../block-fields-Cwd4c8m-.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { o as optionalMoneyOf, t as amountText } from "../../money-codec-BdnIiFFX.js";
-import { i as refOf, n as compact, r as plainDate } from "../../sales-shared-CjXsy0NJ.js";
+import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { o as optionalMoneyOf, t as amountText } from "../../money-codec-jMP0PQLZ.js";
+import { i as refOf, n as compact, r as plainDate } from "../../sales-shared-C_u68eq2.js";
 //#region src/blocks/employees/employees.ts
 const STATUSES = [
 	"preboarding",
@@ -245,28 +245,6 @@ function createEmployees(options) {
 		...options.logger ? { logger: options.logger } : {}
 	});
 }
-/**
-* The `config.subjects` entry for employees, so comments, files, tags and
-* search attach to them. Pass `schema` when the module isn't in
-* `better_supabase`.
-*/
-function employeesSubjects(options = {}) {
-	return { employee: {
-		table: `${options.schema ?? "better_supabase"}.employees`,
-		idType: "uuid",
-		tenant: "tenant_id",
-		title: "name",
-		permissions: {
-			read: "employees.read",
-			write: "employees.write"
-		},
-		search: {
-			title: "name",
-			body: ["email", "job_title"]
-		},
-		...options.url === void 0 ? {} : { url: options.url }
-	} };
-}
 //#endregion
 //#region src/blocks/employees/events.ts
 /** The `employees` block's event types, for its manifest and `onBlockEvent`. */
@@ -277,6 +255,90 @@ const employeesEvents = defineEvents({
 	"employee.manager_changed": event()
 });
 //#endregion
+//#region src/blocks/employees/schemas.ts
+/** What `create` takes, with the bounds the SQL checks. */
+const employeeInputSchema = entitySchema({
+	title: "EmployeeInput",
+	fields: {
+		name: {
+			kind: "string",
+			minLength: 1,
+			maxLength: 200
+		},
+		email: {
+			kind: "string",
+			optional: true,
+			maxLength: 320
+		},
+		userId: {
+			kind: "uuid",
+			optional: true
+		},
+		jobTitle: {
+			kind: "string",
+			optional: true,
+			maxLength: 200
+		},
+		teamId: {
+			kind: "uuid",
+			optional: true
+		},
+		managerId: {
+			kind: "uuid",
+			optional: true
+		},
+		employmentType: {
+			kind: "string",
+			optional: true
+		},
+		status: {
+			kind: "enum",
+			values: [
+				"preboarding",
+				"active",
+				"on_leave"
+			],
+			optional: true
+		},
+		startDate: {
+			kind: "plainDate",
+			optional: true
+		},
+		endDate: {
+			kind: "plainDate",
+			optional: true
+		},
+		origin: {
+			kind: "json",
+			optional: true,
+			description: "A `{ type, id }` reference."
+		},
+		fields: {
+			kind: "json",
+			optional: true,
+			description: "The extra columns to set."
+		}
+	}
+});
+/**
+* One edit `update` takes. `field` is a built-in field or an extra column, so
+* any name passes; the SQL rejects an unknown one.
+*/
+const employeeChangeSchema = entitySchema({
+	title: "EmployeeChange",
+	fields: {
+		employeeId: { kind: "uuid" },
+		field: {
+			kind: "string",
+			minLength: 1
+		},
+		value: {
+			kind: "unknown",
+			description: "`null` clears the field."
+		}
+	}
+});
+//#endregion
 //#region src/blocks/employees/manifest.ts
 /** The `employees` block's manifest (ADR 0029). */
 const employeesBlock = defineBlock({
@@ -286,7 +348,11 @@ const employeesBlock = defineBlock({
 	events: employeesEvents,
 	create: createEmployees,
 	category: "people",
-	recipes: ["employee-directory"]
+	recipes: ["employee-directory"],
+	schemas: { employee: {
+		input: employeeInputSchema,
+		change: employeeChangeSchema
+	} }
 });
 //#endregion
-export { createEmployees, dbTransport, employeesBlock, employeesEvents, employeesSubjects, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { createEmployees, dbTransport, employeeChangeSchema, employeeInputSchema, employeesBlock, employeesEvents, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/engagements/index.d.ts

@@ -1,121 +1,10 @@
-/// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-mijqfoJN.js";
-import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
-import { r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { wt as Events } from "../../events-DhGgwqQA.js";
-import { _ as EngagementEventData } from "../../index-CE0p3st5.js";
-import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-DyA5BAW4.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BadAniNI.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-//#region src/blocks/engagements/engagements.d.ts
-/** A record an engagement is on. */
-interface EngagementSubject {
-  readonly type: string;
-  readonly id: string;
-}
-/** A call, email, meeting, note or task logged on one or more records. */
-interface Engagement<F extends object = Record<never, never>> {
-  readonly id: string;
-  readonly organizationId: string;
-  /** `call`, `email`, `meeting`, `note`, `task` or a configured type. */
-  readonly type: string;
-  readonly title: string;
-  readonly body?: string;
-  /** How it went, such as `connected`, `no_answer` or `replied`. */
-  readonly outcome?: string;
-  readonly ownerId?: string;
-  readonly dueAt?: Temporal.Instant;
-  readonly doneAt?: Temporal.Instant;
-  readonly durationSeconds?: number;
-  /** The id in the system it came from, such as a mail or calendar provider. */
-  readonly externalRef?: string;
-  /** The records it is on; the first is its main record. */
-  readonly subjects: readonly EngagementSubject[];
-  /** Open and past its due time. */
-  readonly overdue: boolean;
-  readonly createdBy?: string;
-  readonly createdAt: Temporal.Instant;
-  /** The app's extra columns (`options.extraColumns`), by column name. */
-  readonly fields: Readonly<Record<string, unknown>> & F;
-}
-/**
- * The fields of a write. On update, left out keeps the value and `null` clears
- * it.
- */
-interface EngagementInput<F extends object = Record<never, never>> {
-  readonly type?: string;
-  readonly title?: string;
-  readonly body?: string | null;
-  readonly outcome?: string | null;
-  /** Defaults to the caller on `log`. */
-  readonly ownerId?: string | null;
-  readonly dueAt?: Temporal.Instant | null;
-  readonly doneAt?: Temporal.Instant | null;
-  readonly durationSeconds?: number | null;
-  /** Logging the same `externalRef` again updates the engagement. */
-  readonly externalRef?: string | null;
-  /** Values for the extra columns, by column name. */
-  readonly fields?: Partial<F> & Readonly<Record<string, unknown>>;
-}
-/** `F` types the engagements' extra columns, from the `fields` schema. */
-interface Engagements<F extends object = Record<never, never>> {
-  /**
-   * Logs an engagement on the records in `subjects`, the first being its main
-   * record.
-   */
-  log(organizationId: string, input: EngagementInput<F> & {
-    readonly type: string;
-    readonly title: string;
-  }, subjects: readonly EngagementSubject[]): AsyncResult<Engagement<F>>;
-  /** Changes an engagement, and its records when `subjects` is given. */
-  update(id: string, input: EngagementInput<F>, subjects?: readonly EngagementSubject[]): AsyncResult<Engagement<F>>;
-  /** Marks it done now, with an outcome, or open again with `done: false`. */
-  complete(id: string, options?: {
-    readonly done?: boolean;
-    readonly outcome?: string;
-  }): AsyncResult<Engagement<F>>;
-  remove(id: string): AsyncResult<boolean>;
-  /** A record's engagements, newest first (50 by default, at most 200). */
-  of(subject: EngagementSubject, options?: {
-    readonly types?: readonly string[];
-    readonly before?: Temporal.Instant;
-    readonly limit?: number;
-  }): AsyncResult<Engagement<F>[]>;
-  /** The next open engagement with a due time on a record, or `undefined`. */
-  next(subject: EngagementSubject): AsyncResult<Engagement<F> | undefined>;
-  /** A member's open engagements, earliest due first. Default: the caller's. */
-  open(organizationId: string, options?: {
-    readonly ownerId?: string;
-    readonly dueBefore?: Temporal.Instant;
-    readonly limit?: number;
-  }): AsyncResult<Engagement<F>[]>;
-}
-interface EngagementsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
-  readonly transport: BlockTransport;
-  /**
-   * The module schema, or its API schema: `defineBlocks` passes it from
-   * `blocks.generated.ts`.
-   */
-  readonly schema?: string;
-  /**
-   * A Standard Schema for the engagements' extra columns
-   * (`blocks.engagements.options.extraColumns`), keyed by column name. It types
-   * and parses `fields` on reads and validates them on writes.
-   */
-  readonly fields?: S;
-  readonly hooks?: NoInfer<BlockHooks<Engagements<FieldsOf<S>>>>;
-  readonly logger?: Logger;
-  readonly mappers?: readonly ErrorMapper[];
-}
-/**
- * The engagements block: calls, emails, meetings, notes and tasks on any record
- * registered in `config.subjects`, for a record's activity panel, a "next step"
- * and a member's task list.
- */
-export declare function createEngagements<S extends StandardSchemaV1 | undefined = undefined>(options: EngagementsOptions<S>): Engagements<FieldsOf<S>>;
-//#endregion
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { l as EngagementEventData, u as EngagementRecordingEventData } from "../../block-events-records-BGVyoz57.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
+import { c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { a as EngagementRecording, c as NoteTakerInput, d as Transcript, f as TranscriptSegment, i as EngagementNotesInput, l as Transcriber, n as EngagementActionItem, o as EngagementRecordingStatus, p as TranscriptSegmentInput, r as EngagementNotes, s as NoteTaker, t as ENGAGEMENT_TRANSCRIBE_QUEUE, u as TranscriberInput } from "../../recordings-DgDu7AOt.js";
+import { a as EngagementsOptions, i as Engagements, n as EngagementInput, o as createEngagements, r as EngagementSubject, t as Engagement } from "../../engagements-CsJhf2OM.js";
 //#region src/blocks/engagements/events.d.ts
 /** The events of the `engagements` block: type to data. */
 type EngagementsEvents = {
@@ -123,12 +12,30 @@ type EngagementsEvents = {
   readonly "engagement.updated": EngagementEventData;
   readonly "engagement.completed": EngagementEventData;
   readonly "engagement.deleted": EngagementEventData;
+  /** A recording was attached (`options.recordings`). */
+  readonly "engagement.recorded": EngagementRecordingEventData;
+  /** A recording's transcript was saved. */
+  readonly "engagement.transcribed": EngagementRecordingEventData;
+  /** The engagement's notes were saved. */
+  readonly "engagement.summarized": EngagementEventData;
 };
 /** The `engagements` block's event types, for its manifest and `onBlockEvent`. */
 export declare const engagementsEvents: Events<EngagementsEvents>;
 //#endregion
 //#region src/blocks/engagements/manifest.d.ts
 /** The `engagements` block's manifest (ADR 0029). */
-export declare const engagementsBlock: BlockOf<"engagements", typeof createEngagements, EngagementsEvents>;
+export declare const engagementsBlock: BlockOf<"engagements", typeof createEngagements, EngagementsEvents, {
+  readonly files: "optional";
+}>;
+//#endregion
+//#region src/blocks/engagements/schemas.d.ts
+type EngagementLog = EngagementInput & {
+  readonly type: string;
+  readonly title: string;
+};
+/** What `log` takes: a type and a title, with the bounds the SQL checks. */
+export declare const engagementInputSchema: EntitySchema<EngagementLog>;
+/** What `update` takes: left out keeps the value, `null` clears it. */
+export declare const engagementChangeSchema: EntitySchema<EngagementInput>;
 //#endregion
-export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Engagement, type EngagementInput, type EngagementSubject, type Engagements, type EngagementsEvents, type EngagementsOptions, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, ENGAGEMENT_TRANSCRIBE_QUEUE, type Engagement, type EngagementActionItem, type EngagementInput, type EngagementNotes, type EngagementNotesInput, type EngagementRecording, type EngagementRecordingStatus, type EngagementSubject, type Engagements, type EngagementsEvents, type EngagementsOptions, type NoteTaker, type NoteTakerInput, type RpcClient, type Transcriber, type TranscriberInput, type Transcript, type TranscriptSegment, type TranscriptSegmentInput, createEngagements, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };