better-supabase 0.13.0 → 0.14.0

package/dist/blocks/flags/index.js

@@ -1,12 +1,11 @@
-import { a as ok, t as AsyncResult } from "../../result-DIT_qp4G.js";
+import { a as ok, t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { t as flagsSqlOptions } from "../../options-DDzggjN7.js";
+import { B as dbTransport, H as rpcTransport, U as sqlTransport, 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 { 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 { a as flagContext, i as flagBucket, n as createFlagsProvider, o as flagDefinitionsOf, r as evaluateFlag, t as createFlagClient } from "../../flags-C--SBMT9.js";
+import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { a as flagContext, i as flagBucket, n as createFlagsProvider, o as flagDefinitionsOf, r as evaluateFlag, t as createFlagClient } from "../../flags-BhYByvP1.js";
 //#region src/blocks/flags/admin.ts
 const rowOf = (input, fields) => {
 	const row = {};

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

@@ -0,0 +1,119 @@
+/// <reference lib="esnext.temporal" />
+import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { f as ForecastSnapshotEventData } from "../../block-events-records-BGVyoz57.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-BaugZlJV.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 } from "../../define-block-COpcS6aT.js";
+import { n as Money } from "../../money-BNRdJQzA.js";
+import { t as DealForecast } from "../../deal-forecast-LwO-Z4_C.js";
+//#region src/blocks/forecasts/forecasts.d.ts
+/** A stored forecast call. */
+interface ForecastSnapshot {
+  readonly id: string;
+  readonly organizationId: string;
+  /** `undefined` for a snapshot of every pipeline. */
+  readonly pipelineId: string | undefined;
+  readonly since: Temporal.PlainDate;
+  readonly until: Temporal.PlainDate;
+  readonly currency: string;
+  readonly target: Money | undefined;
+  /** The totals by forecast category, as `deals.forecast` returned them. */
+  readonly totals: DealForecast;
+  readonly dealCount: number;
+  readonly takenBy: string | undefined;
+  readonly takenAt: Temporal.Instant;
+}
+/** A deal as a snapshot counted it. */
+interface ForecastSnapshotDeal {
+  readonly dealId: string;
+  readonly name: string;
+  readonly ownerId: string | undefined;
+  readonly stageId: string | undefined;
+  /** `undefined` when the deal was not called. */
+  readonly forecast: string | undefined;
+  readonly outcome: string;
+  readonly amount: Money;
+  readonly closeOn: Temporal.PlainDate | undefined;
+  readonly closedAt: Temporal.Instant | undefined;
+}
+/** How a deal moved between two snapshots. */
+type ForecastChangeKind = "added" | "removed" | "won" | "lost" | "changed";
+interface ForecastDealChange {
+  readonly dealId: string;
+  readonly name: string;
+  readonly change: ForecastChangeKind;
+  /** `undefined` for an added deal. */
+  readonly before: ForecastSnapshotDeal | undefined;
+  /** `undefined` for a removed deal. */
+  readonly after: ForecastSnapshotDeal | undefined;
+}
+interface ForecastChanges {
+  readonly from: ForecastSnapshot;
+  readonly to: ForecastSnapshot;
+  /** The deals that changed, the largest amount first. */
+  readonly deals: readonly ForecastDealChange[];
+}
+interface Forecasts {
+  /**
+   * Stores the forecast call for the period with every deal it counted. Needs
+   * `forecasts.snapshot`; a cron calls it with the service role.
+   */
+  snapshot(organizationId: string, period: {
+    readonly since: Temporal.PlainDate;
+    readonly until: Temporal.PlainDate;
+    readonly currency: string;
+    /** In `currency`. */
+    readonly target?: Money;
+    readonly pipelineId?: string;
+  }): AsyncResult<ForecastSnapshot>;
+  /** Snapshots, newest first, of one pipeline or period when given. */
+  list(organizationId: string, filter?: {
+    readonly pipelineId?: string;
+    readonly since?: Temporal.PlainDate;
+    readonly until?: Temporal.PlainDate;
+    /** At most this many. Default: 50, at most 200. */
+    readonly limit?: number;
+  }): AsyncResult<ForecastSnapshot[]>;
+  /** One snapshot with the deals it counted, the largest amount first. */
+  get(snapshotId: string): AsyncResult<ForecastSnapshot & {
+    readonly deals: readonly ForecastSnapshotDeal[];
+  }>;
+  /**
+   * The deals that were added, removed, won, lost or changed between two
+   * snapshots of one organization and currency.
+   */
+  changes(fromSnapshotId: string, toSnapshotId: string): AsyncResult<ForecastChanges>;
+}
+interface ForecastsOptions extends BlockTemporalOptions {
+  readonly transport: BlockTransport;
+  /**
+   * The module schema, or its API schema: `defineBlocks` passes it from
+   * `blocks.generated.ts`.
+   */
+  readonly schema?: string;
+  readonly hooks?: NoInfer<BlockHooks<Forecasts>>;
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+/**
+ * The forecasts block: snapshots of the deals forecast call over time, each
+ * with the deals it counted, and what moved between two of them.
+ */
+export declare function createForecasts(options: ForecastsOptions): Forecasts;
+//#endregion
+//#region src/blocks/forecasts/events.d.ts
+/** The events of the `forecasts` block: type to data. */
+type ForecastsEvents = {
+  readonly "forecast.snapshotted": ForecastSnapshotEventData;
+};
+/** The `forecasts` block's event types, for its manifest and `onBlockEvent`. */
+export declare const forecastsEvents: Events<ForecastsEvents>;
+//#endregion
+//#region src/blocks/forecasts/manifest.d.ts
+/** The `forecasts` block's manifest (ADR 0029). */
+export declare const forecastsBlock: BlockOf<"forecasts", typeof createForecasts, ForecastsEvents>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type DealForecast, type ForecastChangeKind, type ForecastChanges, type ForecastDealChange, type ForecastSnapshot, type ForecastSnapshotDeal, type Forecasts, type ForecastsEvents, type ForecastsOptions, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/forecasts/index.js

@@ -0,0 +1,129 @@
+import { t as AsyncResult } from "../../result-B3m7xtRY.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, 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 event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { a as optionalAmountText, i as moneyOf, n as amountsError, o as optionalMoneyOf } from "../../money-codec-jMP0PQLZ.js";
+import { t as forecastOf } from "../../deal-forecast-CBlp20PY.js";
+import { r as plainDate } from "../../sales-shared-C_u68eq2.js";
+//#region src/blocks/forecasts/forecasts.ts
+function requiredDate(value, field) {
+	const date = plainDate(value);
+	if (date === void 0) throw new TypeError(`${field} is missing`);
+	return date;
+}
+function snapshotOf(value) {
+	const row = recordOf(value, "forecast_snapshot");
+	const currency = textOf(row["currency"]);
+	const count = row["dealCount"];
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		pipelineId: optionalText(row["pipelineId"]),
+		since: requiredDate(row["since"], "since"),
+		until: requiredDate(row["until"], "until"),
+		currency,
+		target: optionalMoneyOf(row["target"], currency, "forecast_snapshot target"),
+		totals: forecastOf(row["totals"], "forecast_snapshot totals"),
+		dealCount: typeof count === "number" ? count : 0,
+		takenBy: optionalText(row["takenBy"]),
+		takenAt: requiredInstant(row["takenAt"], "takenAt")
+	};
+}
+function dealOf(value, currency) {
+	const row = recordOf(value, "forecast_snapshot deal");
+	return {
+		dealId: textOf(row["dealId"]),
+		name: textOf(row["name"]),
+		ownerId: optionalText(row["ownerId"]),
+		stageId: optionalText(row["stageId"]),
+		forecast: optionalText(row["forecast"]),
+		outcome: textOf(row["outcome"]),
+		amount: moneyOf(row["amount"], currency, "forecast_snapshot deal amount"),
+		closeOn: plainDate(row["closeOn"]),
+		closedAt: optionalInstant(row["closedAt"])
+	};
+}
+const CHANGES = [
+	"added",
+	"removed",
+	"won",
+	"lost"
+];
+const isChangeKind = (value) => CHANGES.some((kind) => kind === value);
+const changeKind = (value) => isChangeKind(value) ? value : "changed";
+function changesOf(value) {
+	const row = recordOf(value, "forecast_changes");
+	const from = snapshotOf(row["from"]);
+	const side = (entry) => entry === null || entry === void 0 ? void 0 : dealOf(entry, from.currency);
+	return {
+		from,
+		to: snapshotOf(row["to"]),
+		deals: recordsOf(row["deals"], "forecast_changes deals").map((deal) => ({
+			dealId: textOf(deal["dealId"]),
+			name: textOf(deal["name"]),
+			change: changeKind(deal["change"]),
+			before: side(deal["before"]),
+			after: side(deal["after"])
+		}))
+	};
+}
+/**
+* The forecasts block: snapshots of the deals forecast call over time, each
+* with the deals it counted, and what moved between two of them.
+*/
+function createForecasts(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	return withBlockHooks({
+		snapshot: (organizationId, period) => {
+			const invalid = amountsError(period.currency, [period.target]);
+			return invalid === void 0 ? call("take_forecast_snapshot", {
+				tenant: organizationId,
+				pipeline: period.pipelineId ?? null,
+				since: period.since.toString(),
+				until: period.until.toString(),
+				currency: period.currency,
+				target: optionalAmountText(period.target)
+			}, snapshotOf) : AsyncResult.err(invalid);
+		},
+		list: (organizationId, filter = {}) => call("forecast_snapshots", {
+			tenant: organizationId,
+			pipeline: filter.pipelineId ?? null,
+			since: filter.since?.toString() ?? null,
+			until: filter.until?.toString() ?? null,
+			max_count: filter.limit ?? null
+		}, (value) => recordsOf(value, "forecast_snapshots").map((row) => snapshotOf(row))),
+		get: (snapshotId) => call("forecast_snapshot", { snapshot: snapshotId }, (value) => {
+			const snapshot = snapshotOf(value);
+			const row = recordOf(value, "forecast_snapshot");
+			return {
+				...snapshot,
+				deals: recordsOf(row["deals"], "forecast_snapshot deals").map((deal) => dealOf(deal, snapshot.currency))
+			};
+		}),
+		changes: (fromSnapshotId, toSnapshotId) => call("forecast_changes", {
+			from_snapshot: fromSnapshotId,
+			to_snapshot: toSnapshotId
+		}, changesOf)
+	}, options.hooks, {
+		block: "forecasts",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/forecasts/events.ts
+/** The `forecasts` block's event types, for its manifest and `onBlockEvent`. */
+const forecastsEvents = defineEvents({ "forecast.snapshotted": event() });
+//#endregion
+//#region src/blocks/forecasts/manifest.ts
+/** The `forecasts` block's manifest (ADR 0029). */
+const forecastsBlock = defineBlock({
+	name: "forecasts",
+	sql: ["forecasts"],
+	events: forecastsEvents,
+	create: createForecasts,
+	category: "crm"
+});
+//#endregion
+export { createForecasts, dbTransport, extendBlock, forecastsBlock, forecastsEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,15 +1,46 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-mijqfoJN.js";
-import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { B as FormEventData, V as FormSubmissionEventData, it as SignatureEventData, wt as Events } from "../../events-DhGgwqQA.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
+import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
+import { r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
+import { B as FormEventData, Ct as Events, V as FormSubmissionEventData } from "../../events-DbLjvxDX.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { n as BlockOptions, r as BlockTemporalOptions } from "../../block-helpers-DyA5BAW4.js";
-import { n as BlockHooks } from "../../block-hooks-BadAniNI.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { a as FormDefinition, c as FormJson, d as FormStep, f as formDefinitionProblems, i as FormCondition, l as FormJsonSchema, m as isFormDefinition, n as FORM_FIELD_TYPES, o as FormField, p as formSchema, r as FORM_SCHEMA_DIALECT, s as FormFieldType, t as FORM_DEFINITION_SCHEMA, u as FormOption } from "../../form-definition-DcVnFzl4.js";
-import { _ as visibleFields, a as createQuestionnaireController, b as answersSchema, c as QuestionnaireState, d as finishQuestionnaire, f as initialQuestionnaire, g as stepIssues, h as questionnaireSteps, i as QuestionnaireSnapshot, l as QuestionnaireStepView, m as questionnaireReducer, n as QuestionnaireController, o as QuestionnaireAction, p as pruneAnswers, r as QuestionnaireOptions, s as QuestionnaireForm, t as QuestionnaireActions, u as conditionHolds, v as visibleSteps, x as validateAnswers, y as FormAnswers } from "../../client-BsfsRHae.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-BaugZlJV.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
+import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { _ as isFormDefinition, a as FormDefinition, c as FormJson, d as FormScoring, f as FormStep, g as formSchema, h as formDefinitionProblems, i as FormCondition, l as FormJsonSchema, m as UNSCORED_FIELD_TYPES, n as FORM_FIELD_TYPES, o as FormField, p as NPS_MAX, r as FORM_SCHEMA_DIALECT, s as FormFieldType, t as FORM_DEFINITION_SCHEMA, u as FormOption } from "../../form-definition-BjEtH8BT.js";
+import { _ as visibleFields, a as createQuestionnaireController, b as answersSchema, c as QuestionnaireState, d as finishQuestionnaire, f as initialQuestionnaire, g as stepIssues, h as questionnaireSteps, i as QuestionnaireSnapshot, l as QuestionnaireStepView, m as questionnaireReducer, n as QuestionnaireController, o as QuestionnaireAction, p as pruneAnswers, r as QuestionnaireOptions, s as QuestionnaireForm, t as QuestionnaireActions, u as conditionHolds, v as visibleSteps, x as validateAnswers, y as FormAnswers } from "../../client-Bni68sve.js";
+//#region src/blocks/forms/scoring.d.ts
+/** A scored submission's grade, as `form_score` computes it in Postgres. */
+interface FormScore {
+  /** The points the correct answers earned. */
+  readonly score: number;
+  /** The points of every scored field that showed. */
+  readonly maxScore: number;
+  /** Against `scoring.passMark`; `undefined` without one. */
+  readonly passed?: boolean;
+}
+/** An `nps` answer's bucket: 9 and 10 promote, 7 and 8 are passive. */
+type NpsCategory = "promoter" | "passive" | "detractor";
+/**
+ * The grade of `answers` against a definition with its `correct` answers: the
+ * TypeScript twin of `form_score`, for a preview before submitting. A field
+ * hidden by its `showIf` (or its step's) counts toward neither score.
+ * `undefined` when no field has a correct answer.
+ */
+export declare function formScore(definition: FormDefinition, answers: FormAnswers): FormScore | undefined;
+/** The bucket of an `nps` answer from 0 to 10. */
+export declare function npsCategory(answer: number): NpsCategory;
+/**
+ * The Net Promoter Score of the counts: the promoters' share minus the
+ * detractors', from -100 to 100, to one decimal. `undefined` without answers.
+ */
+export declare function npsScore(counts: {
+  readonly promoters: number;
+  readonly passives: number;
+  readonly detractors: number;
+}): number | undefined;
+//#endregion
 //#region src/blocks/forms/forms.d.ts
 interface FormsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
   readonly transport: BlockTransport;
@@ -87,6 +118,41 @@ interface FormSubmission {
   readonly createdAt: Temporal.Instant;
   readonly submittedAt?: Temporal.Instant;
   readonly updatedAt: Temporal.Instant;
+  /**
+   * The grade Postgres gave a submission to a scored version; `undefined` for a
+   * draft or a form without correct answers.
+   */
+  readonly score?: FormScore;
+}
+/** The NPS counts of one period, or of every answer. */
+interface NpsCounts {
+  readonly responses: number;
+  readonly promoters: number;
+  readonly passives: number;
+  readonly detractors: number;
+  /** From -100 to 100, to one decimal; `undefined` without responses. */
+  readonly score?: number;
+}
+interface NpsPeriod extends NpsCounts {
+  /** The period's first instant (UTC). */
+  readonly start: Temporal.Instant;
+}
+/** `nps`: the counts over every answer, and per period with a `bucket`. */
+interface FormNps extends NpsCounts {
+  /** The `nps` field the counts are for. */
+  readonly field: string;
+  readonly periods: readonly NpsPeriod[];
+}
+type NpsBucket = "day" | "week" | "month" | "quarter" | "year";
+interface NpsOptions {
+  /** Default: the current version's first `nps` field. */
+  readonly field?: string;
+  /** Submissions from this instant on. */
+  readonly since?: Temporal.Instant;
+  /** Submissions before this instant. */
+  readonly until?: Temporal.Instant;
+  /** Adds `periods`, by UTC day, week, month, quarter or year. */
+  readonly bucket?: NpsBucket;
 }
 interface PublicSubmission {
   readonly id: string;
@@ -156,132 +222,14 @@ interface Forms<F extends object = Record<never, never>> {
   listSubmissions(formId: string, options?: SubmissionListOptions): AsyncResult<readonly FormSubmission[]>;
   review(id: string, status: "accepted" | "rejected" | "submitted"): AsyncResult<FormSubmission>;
   deleteSubmission(id: string): AsyncResult<boolean>;
-}
-/** The `forms` SQL module as typed calls. */
-export declare function createForms<S extends StandardSchemaV1 | undefined = undefined>(options: FormsOptions<S>): Forms<FieldsOf<S>>;
-//#endregion
-//#region src/blocks/forms/signatures.d.ts
-interface SignaturesOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockOptions {
   /**
-   * A Standard Schema for the request's extra columns
-   * (`blocks.signatures.options.extraColumns`), keyed by database name. It
-   * types and parses them on the request reads, and validates them on
-   * `request`.
+   * The Net Promoter Score of the form's submitted and accepted answers, for
+   * reviewers.
    */
-  readonly fields?: S;
-  /** `withBlockHooks` hooks around the client's methods. */
-  readonly hooks?: NoInfer<BlockHooks<Signatures<FieldsOf<S>>>>;
-  /** Receives the errors `after` hooks throw. Default: `console`. */
-  readonly logger?: Logger;
+  nps(formId: string, options?: NpsOptions): AsyncResult<FormNps>;
 }
-type SignatureMethod = "drawn" | "typed" | "click";
-type SignatureOrder = "parallel" | "sequential";
-type SignatureRequestStatus = "pending" | "completed" | "declined" | "cancelled";
-/** A request. `F` types the extra columns the `fields` schema describes. */
-interface SignatureRequest<F extends object = Record<never, never>> {
-  readonly id: string;
-  readonly organizationId: string;
-  readonly subjectType: string;
-  readonly subjectId: string;
-  /** The frozen version the signers sign. */
-  readonly versionId: string;
-  /** The version's content hash when the request was made. */
-  readonly contentHash: string;
-  readonly signers: readonly string[];
-  readonly order: SignatureOrder;
-  readonly status: SignatureRequestStatus;
-  readonly approvalRequestId?: string;
-  readonly message?: string;
-  readonly requestedBy?: string;
-  readonly createdAt: Temporal.Instant;
-  readonly completedAt?: Temporal.Instant;
-  /** The extra columns, keyed by database name. */
-  readonly fields: ExtraFields<F>;
-}
-interface Signature {
-  readonly id: string;
-  readonly requestId: string;
-  readonly signer: string;
-  readonly method: SignatureMethod;
-  readonly typedName?: string;
-  /** The attachment that holds a drawn signature's image. */
-  readonly imageAttachmentId?: string;
-  /**
-   * SHA-256 over the request, the content hash, the signer, the method and the
-   * time.
-   */
-  readonly signedHash: string;
-  readonly ip?: string;
-  readonly userAgent?: string;
-  readonly signedAt: Temporal.Instant;
-}
-interface SignatureVerification {
-  /** The signed version is unchanged and every signature hash matches. */
-  readonly valid: boolean;
-  /** The signed version's content still hashes to the requested hash. */
-  readonly contentMatches: boolean;
-  /** The record has a newer version than the one signed. */
-  readonly changedSince: boolean;
-  readonly latestVersionId?: string;
-  readonly signatures: readonly {
-    readonly id: string;
-    readonly signer: string;
-    readonly valid: boolean;
-  }[];
-}
-/** A request with its signatures and their verification, from `get`. */
-interface SignatureRequestDetail<F extends object = Record<never, never>> extends SignatureRequest<F> {
-  readonly signatures: readonly Signature[];
-  readonly verification: SignatureVerification;
-}
-interface SignatureRequestInput<F extends object = Record<never, never>> {
-  readonly organizationId: string;
-  readonly subjectType: string;
-  readonly subjectId: string;
-  /** Members of the organization, in signing order for `sequential`. */
-  readonly signers: readonly string[];
-  /** Default: a new snapshot of the record's versioned columns. */
-  readonly versionId?: string;
-  /** Default: `parallel`. */
-  readonly order?: SignatureOrder;
-  /** An approval request on the same record that a signer's signature decides. */
-  readonly approvalRequestId?: string;
-  readonly message?: string;
-  /** The extra columns to set. */
-  readonly fields?: Partial<F>;
-}
-type SignInput = {
-  readonly method: "click";
-} | {
-  readonly method: "typed";
-  readonly typedName: string;
-} | {
-  readonly method: "drawn";
-  readonly imageAttachmentId: string;
-};
-interface SignatureRequestListOptions {
-  readonly subjectType?: string;
-  readonly subjectId?: string;
-  readonly status?: SignatureRequestStatus;
-  /** Only the requests the caller is asked to sign. */
-  readonly mine?: boolean;
-  readonly pageSize?: number;
-  /** Requests created before this time, for the next page. */
-  readonly before?: Temporal.Instant;
-}
-interface Signatures<F extends object = Record<never, never>> {
-  request(input: SignatureRequestInput<F>): AsyncResult<SignatureRequest<F>>;
-  sign(requestId: string, input: SignInput): AsyncResult<Signature & {
-    readonly requestStatus: SignatureRequestStatus;
-  }>;
-  decline(requestId: string, reason?: string): AsyncResult<SignatureRequest<F>>;
-  cancel(requestId: string): AsyncResult<SignatureRequest<F>>;
-  get(requestId: string): AsyncResult<SignatureRequestDetail<F>>;
-  /** Newest first. */
-  list(organizationId: string, options?: SignatureRequestListOptions): AsyncResult<readonly SignatureRequest<F>[]>;
-}
-/** The `signatures` SQL module as typed calls. */
-export declare function createSignatures<S extends StandardSchemaV1 | undefined = undefined>(options: SignaturesOptions<S>): Signatures<FieldsOf<S>>;
+/** The `forms` SQL module as typed calls. */
+export declare function createForms<S extends StandardSchemaV1 | undefined = undefined>(options: FormsOptions<S>): Forms<FieldsOf<S>>;
 //#endregion
 //#region src/blocks/forms/events.d.ts
 /** The events of the `forms` block: type to data. */
@@ -294,21 +242,9 @@ type FormsEvents = {
 };
 /** The `forms` block's event types, for its manifest and `onBlockEvent`. */
 export declare const formsEvents: Events<FormsEvents>;
-/** The events of the `signatures` block: type to data. */
-type SignaturesEvents = {
-  readonly "signature.requested": SignatureEventData;
-  readonly "signature.signed": SignatureEventData;
-  readonly "signature.completed": SignatureEventData;
-  readonly "signature.declined": SignatureEventData;
-  readonly "signature.cancelled": SignatureEventData;
-};
-/** The `signatures` block's event types, for its manifest and `onBlockEvent`. */
-export declare const signaturesEvents: Events<SignaturesEvents>;
 //#endregion
 //#region src/blocks/forms/manifest.d.ts
 /** The `forms` block's manifest (ADR 0029). */
 export declare const formsBlock: BlockOf<"forms", typeof createForms, FormsEvents>;
-/** The `signatures` block's manifest (ADR 0029). */
-export declare const signaturesBlock: BlockOf<"signatures", typeof createSignatures, SignaturesEvents>;
 //#endregion
-export { type BlockTransport, FORM_DEFINITION_SCHEMA, FORM_FIELD_TYPES, FORM_SCHEMA_DIALECT, type Form, type FormAnswers, type FormCondition, type FormDefinition, type FormDetail, type FormField, type FormFieldType, type FormInput, type FormJson, type FormJsonSchema, type FormOption, type FormStatus, type FormStep, type FormSubmission, type FormSubmissionSource, type FormSubmissionStatus, type FormUpdate, type FormVersion, type Forms, type FormsEvents, type FormsOptions, type PublicForm, type PublicSubmission, type PublicSubmitOptions, type QuestionnaireAction, type QuestionnaireActions, type QuestionnaireController, type QuestionnaireForm, type QuestionnaireOptions, type QuestionnaireSnapshot, type QuestionnaireState, type QuestionnaireStepView, type SignInput, type Signature, type SignatureMethod, type SignatureOrder, type SignatureRequest, type SignatureRequestDetail, type SignatureRequestInput, type SignatureRequestListOptions, type SignatureRequestStatus, type SignatureVerification, type Signatures, type SignaturesEvents, type SignaturesOptions, type SubmissionListOptions, type SubmitOptions, answersSchema, conditionHolds, createQuestionnaireController, dbTransport, finishQuestionnaire, formDefinitionProblems, formSchema, initialQuestionnaire, isFormDefinition, pruneAnswers, questionnaireReducer, questionnaireSteps, rpcTransport, sqlTransport, stepIssues, validateAnswers, visibleFields, visibleSteps };
+export { type BlockTransport, FORM_DEFINITION_SCHEMA, FORM_FIELD_TYPES, FORM_SCHEMA_DIALECT, type Form, type FormAnswers, type FormCondition, type FormDefinition, type FormDetail, type FormField, type FormFieldType, type FormInput, type FormJson, type FormJsonSchema, type FormNps, type FormOption, type FormScore, type FormScoring, type FormStatus, type FormStep, type FormSubmission, type FormSubmissionSource, type FormSubmissionStatus, type FormUpdate, type FormVersion, type Forms, type FormsEvents, type FormsOptions, NPS_MAX, type NpsBucket, type NpsCategory, type NpsCounts, type NpsOptions, type NpsPeriod, type PublicForm, type PublicSubmission, type PublicSubmitOptions, type QuestionnaireAction, type QuestionnaireActions, type QuestionnaireController, type QuestionnaireForm, type QuestionnaireOptions, type QuestionnaireSnapshot, type QuestionnaireState, type QuestionnaireStepView, type SubmissionListOptions, type SubmitOptions, UNSCORED_FIELD_TYPES, answersSchema, conditionHolds, createQuestionnaireController, dbTransport, finishQuestionnaire, formDefinitionProblems, formSchema, initialQuestionnaire, isFormDefinition, pruneAnswers, questionnaireReducer, questionnaireSteps, rpcTransport, sqlTransport, stepIssues, validateAnswers, visibleFields, visibleSteps };