better-supabase 0.13.0 → 0.14.0

package/dist/blocks/forms/index.js

@@ -1,12 +1,12 @@
-import { a as ok, t as AsyncResult } from "../../result-DIT_qp4G.js";
+import { a as ok, t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { a as formDefinitionProblems, c as formsSqlOptions, i as FORM_SCHEMA_DIALECT, l as signaturesSqlOptions, n as FORM_FIELD_TYPES, o as formSchema, s as isFormDefinition, t as FORM_DEFINITION_SCHEMA } from "../../form-definition-BjeElHsB.js";
+import { t as formsSqlOptions } from "../../options-70OsM-wK.js";
+import { a as NPS_MAX, c as formSchema, i as FORM_SCHEMA_DIALECT, l as isFormDefinition, n as FORM_FIELD_TYPES, o as UNSCORED_FIELD_TYPES, s as formDefinitionProblems, t as FORM_DEFINITION_SCHEMA } from "../../form-definition-BTpM_tz1.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, O as recordOrEmpty, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, m as instantArg, 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, O as recordOrEmpty, S as optionalInstant, d as enumOrThrow, k as recordsOf, m as instantArg, 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 blockFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
 import { a as pruneAnswers, c as stepIssues, d as answersSchema, f as validateAnswers, i as initialQuestionnaire, l as visibleFields, n as conditionHolds, o as questionnaireReducer, r as finishQuestionnaire, s as questionnaireSteps, t as createQuestionnaireController, u as visibleSteps } from "../../client-BKGVUgo7.js";
 //#region src/blocks/forms/forms.ts
 const FORM_STATUSES = [
@@ -26,7 +26,7 @@ const SOURCES = [
 	"public",
 	"service"
 ];
-function optional$1(key, value) {
+function optional(key, value) {
 	return value === void 0 ? {} : { [key]: value };
 }
 function formOf(value, fn) {
@@ -39,9 +39,9 @@ function formOf(value, fn) {
 		status: enumOrThrow(row["status"], FORM_STATUSES, "form status"),
 		createdAt: requiredInstant(row["createdAt"], "createdAt"),
 		updatedAt: requiredInstant(row["updatedAt"], "updatedAt"),
-		...optional$1("description", optionalText(row["description"])),
-		...optional$1("currentVersionId", optionalText(row["currentVersionId"])),
-		...optional$1("createdBy", optionalText(row["createdBy"])),
+		...optional("description", optionalText(row["description"])),
+		...optional("currentVersionId", optionalText(row["currentVersionId"])),
+		...optional("createdBy", optionalText(row["createdBy"])),
 		fields: isRecord(row["fields"]) ? row["fields"] : {}
 	};
 }
@@ -58,7 +58,7 @@ function versionOf(value, fn) {
 		definition: definitionOf(row["definition"], fn),
 		schema: recordOf(row["schema"], fn),
 		createdAt: requiredInstant(row["createdAt"], "createdAt"),
-		...optional$1("createdBy", optionalText(row["createdBy"]))
+		...optional("createdBy", optionalText(row["createdBy"]))
 	};
 }
 function submissionOf(value, fn) {
@@ -73,12 +73,42 @@ function submissionOf(value, fn) {
 		source: enumOrThrow(row["source"], SOURCES, "submission source"),
 		createdAt: requiredInstant(row["createdAt"], "createdAt"),
 		updatedAt: requiredInstant(row["updatedAt"], "updatedAt"),
-		...optional$1("subjectType", optionalText(row["subjectType"])),
-		...optional$1("subjectId", optionalText(row["subjectId"])),
-		...optional$1("respondentId", optionalText(row["respondentId"])),
-		...optional$1("reviewedBy", optionalText(row["reviewedBy"])),
-		...optional$1("reviewedAt", optionalInstant(row["reviewedAt"])),
-		...optional$1("submittedAt", optionalInstant(row["submittedAt"]))
+		...optional("subjectType", optionalText(row["subjectType"])),
+		...optional("subjectId", optionalText(row["subjectId"])),
+		...optional("respondentId", optionalText(row["respondentId"])),
+		...optional("reviewedBy", optionalText(row["reviewedBy"])),
+		...optional("reviewedAt", optionalInstant(row["reviewedAt"])),
+		...optional("submittedAt", optionalInstant(row["submittedAt"])),
+		...optional("score", scoreOf(row))
+	};
+}
+function scoreOf(row) {
+	if (row["score"] === null || row["score"] === void 0) return;
+	const passed = row["passed"];
+	return {
+		score: Number(row["score"]),
+		maxScore: Number(row["maxScore"]),
+		...typeof passed === "boolean" ? { passed } : {}
+	};
+}
+function npsCountsOf(row) {
+	return {
+		responses: Number(row["responses"]),
+		promoters: Number(row["promoters"]),
+		passives: Number(row["passives"]),
+		detractors: Number(row["detractors"]),
+		...optional("score", row["score"] === null || row["score"] === void 0 ? void 0 : Number(row["score"]))
+	};
+}
+function npsOf(value) {
+	const row = recordOf(value, "form_nps");
+	return {
+		...npsCountsOf(row),
+		field: textOf(row["field"]),
+		periods: recordsOf(row["periods"], "form_nps").map((period) => ({
+			...npsCountsOf(period),
+			start: requiredInstant(period["start"], "start")
+		}))
 	};
 }
 /** The `forms` SQL module as typed calls. */
@@ -118,7 +148,7 @@ function createForms(options) {
 			const row = recordOf(value, "get_form");
 			return {
 				...formOf(row, "get_form"),
-				...optional$1("version", row["version"] === null || row["version"] === void 0 ? void 0 : versionOf(row["version"], "get_form"))
+				...optional("version", row["version"] === null || row["version"] === void 0 ? void 0 : versionOf(row["version"], "get_form"))
 			};
 		}).andThen(parsed),
 		getVersion: (versionId) => call("get_form_version", { version_id: versionId }, (value) => versionOf(value, "get_form_version")),
@@ -148,7 +178,7 @@ function createForms(options) {
 				id: textOf(row["id"]),
 				title: textOf(row["title"]),
 				version: versionOf(row["version"], "get_public_form"),
-				...optional$1("description", optionalText(row["description"]))
+				...optional("description", optionalText(row["description"]))
 			};
 		}),
 		submitPublic: (token, answers, submit = {}) => call("submit_public_form", {
@@ -160,7 +190,7 @@ function createForms(options) {
 			return {
 				id: textOf(row["id"]),
 				status: enumOrThrow(row["status"], SUBMISSION_STATUSES, "submission status"),
-				...optional$1("submittedAt", optionalInstant(row["submittedAt"]))
+				...optional("submittedAt", optionalInstant(row["submittedAt"]))
 			};
 		}),
 		getSubmission: (id) => call("get_form_submission", { submission_id: id }, (value) => submissionOf(value, "get_form_submission")),
@@ -174,131 +204,79 @@ function createForms(options) {
 			submission_id: id,
 			status
 		}, (value) => submissionOf(value, "review_form_submission")),
-		deleteSubmission: (id) => call("delete_form_submission", { submission_id: id }, (value) => value === true)
+		deleteSubmission: (id) => call("delete_form_submission", { submission_id: id }, (value) => value === true),
+		nps: (formId, nps = {}) => call("form_nps", {
+			form_id: formId,
+			field: nps.field ?? null,
+			since: instantArg(nps.since) ?? null,
+			until: instantArg(nps.until) ?? null,
+			bucket: nps.bucket ?? null
+		}, npsOf)
 	}, options.hooks, {
 		block: "forms",
 		...options.logger ? { logger: options.logger } : {}
 	});
 }
 //#endregion
-//#region src/blocks/forms/signatures.ts
-const STATUSES = [
-	"pending",
-	"completed",
-	"declined",
-	"cancelled"
-];
-const ORDERS = ["parallel", "sequential"];
-const METHODS = [
-	"drawn",
-	"typed",
-	"click"
-];
-function optional(key, value) {
-	return value === void 0 ? {} : { [key]: value };
+//#region src/blocks/forms/scoring.ts
+const trimmed = (value) => value.replaceAll(/^ +| +$/g, "").toLowerCase();
+const TEXT_TYPES = /* @__PURE__ */ new Set([
+	"text",
+	"textarea",
+	"email",
+	"url"
+]);
+/** Whether `answer` earns a field's points. */
+function matches(field, answer, correct) {
+	if (TEXT_TYPES.has(field.type ?? "")) return typeof answer === "string" && typeof correct === "string" && trimmed(answer) === trimmed(correct);
+	if (field.type === "multi") return Array.isArray(answer) && Array.isArray(correct) && answer.every((value) => correct.includes(value)) && correct.every((value) => answer.includes(value));
+	return JSON.stringify(answer) === JSON.stringify(correct);
 }
-const textsOf = (value) => Array.isArray(value) ? value.map((item) => textOf(item)) : [];
-function requestOf(value, fn) {
-	const row = recordOf(value, fn);
-	return {
-		id: textOf(row["id"]),
-		organizationId: textOf(row["organizationId"]),
-		subjectType: textOf(row["subjectType"]),
-		subjectId: textOf(row["subjectId"]),
-		versionId: textOf(row["versionId"]),
-		contentHash: textOf(row["contentHash"]),
-		signers: textsOf(row["signers"]),
-		order: enumOrThrow(row["order"], ORDERS, "signing order"),
-		status: enumOrThrow(row["status"], STATUSES, "signature request status"),
-		createdAt: requiredInstant(row["createdAt"], "createdAt"),
-		...optional("approvalRequestId", optionalText(row["approvalRequestId"])),
-		...optional("message", optionalText(row["message"])),
-		...optional("requestedBy", optionalText(row["requestedBy"])),
-		...optional("completedAt", optionalInstant(row["completedAt"])),
-		fields: isRecord(row["fields"]) ? row["fields"] : {}
+/**
+* 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.
+*/
+function formScore(definition, answers) {
+	if (!definition.steps.some((step) => step.fields.some((field) => field.correct !== void 0))) return;
+	let score = 0;
+	let maxScore = 0;
+	for (const step of definition.steps) {
+		if (!conditionHolds(step.showIf, answers)) continue;
+		for (const field of step.fields) {
+			if (field.correct === void 0 || !conditionHolds(field.showIf, answers)) continue;
+			const points = field.points ?? 1;
+			const answer = answers[field.key];
+			maxScore += points;
+			if (answer !== void 0 && matches(field, answer, field.correct)) score += points;
+		}
+	}
+	const passMark = definition.scoring?.passMark;
+	return passMark === void 0 ? {
+		score,
+		maxScore
+	} : {
+		score,
+		maxScore,
+		passed: score * 100 >= passMark * maxScore
 	};
 }
-function signatureOf(value, fn) {
-	const row = recordOf(value, fn);
-	return {
-		id: textOf(row["id"]),
-		requestId: textOf(row["requestId"]),
-		signer: textOf(row["signer"]),
-		method: enumOrThrow(row["method"], METHODS, "signature method"),
-		signedHash: textOf(row["signedHash"]),
-		signedAt: requiredInstant(row["signedAt"], "signedAt"),
-		...optional("typedName", optionalText(row["typedName"])),
-		...optional("imageAttachmentId", optionalText(row["imageAttachmentId"])),
-		...optional("ip", optionalText(row["ip"])),
-		...optional("userAgent", optionalText(row["userAgent"]))
-	};
+/** The bucket of an `nps` answer from 0 to 10. */
+function npsCategory(answer) {
+	if (answer >= 9) return "promoter";
+	return answer >= 7 ? "passive" : "detractor";
 }
-function verificationOf(value, fn) {
-	const row = recordOf(value, fn);
-	return {
-		valid: row["valid"] === true,
-		contentMatches: row["contentMatches"] === true,
-		changedSince: row["changedSince"] === true,
-		signatures: recordsOf(row["signatures"], fn).map((item) => ({
-			id: textOf(item["id"]),
-			signer: textOf(item["signer"]),
-			valid: item["valid"] === true
-		})),
-		...optional("latestVersionId", optionalText(row["latestVersionId"]))
-	};
-}
-/** The `signatures` SQL module as typed calls. */
-function createSignatures(options) {
-	applyTemporal(options);
-	const call = blockCall(options.transport, options.schema, options.mappers);
-	const fields = blockFields(options.fields, "signature request fields");
-	return withBlockHooks({
-		request: (input) => fields.args(input.fields).andThen((checked) => call("create_signature_request", {
-			tenant: input.organizationId,
-			subject_type: input.subjectType,
-			subject_id: input.subjectId,
-			signers: input.signers,
-			version_id: input.versionId ?? null,
-			sign_order: input.order ?? "parallel",
-			approval_request_id: input.approvalRequestId ?? null,
-			message: input.message ?? null,
-			fields: checked
-		}, (value) => requestOf(value, "create_signature_request")).andThen(fields.row)),
-		sign: (requestId, input) => call("sign_signature", {
-			request_id: requestId,
-			method: input.method,
-			typed_name: input.method === "typed" ? input.typedName : null,
-			image_attachment_id: input.method === "drawn" ? input.imageAttachmentId : null
-		}, (value) => ({
-			...signatureOf(value, "sign_signature"),
-			requestStatus: enumOrThrow(recordOf(value, "sign_signature")["requestStatus"], STATUSES, "signature request status")
-		})),
-		decline: (requestId, reason) => call("decline_signature_request", {
-			request_id: requestId,
-			reason: reason ?? null
-		}, (value) => requestOf(value, "decline_signature_request")).andThen(fields.row),
-		cancel: (requestId) => call("cancel_signature_request", { request_id: requestId }, (value) => requestOf(value, "cancel_signature_request")).andThen(fields.row),
-		get: (requestId) => call("get_signature_request", { request_id: requestId }, (value) => {
-			const row = recordOf(value, "get_signature_request");
-			return {
-				...requestOf(row, "get_signature_request"),
-				signatures: recordsOf(row["signatures"], "get_signature_request").map((item) => signatureOf(item, "get_signature_request")),
-				verification: verificationOf(row["verification"], "get_signature_request")
-			};
-		}).andThen(fields.row),
-		list: (organizationId, list = {}) => call("list_signature_requests", {
-			tenant: organizationId,
-			subject_type: list.subjectType ?? null,
-			subject_id: list.subjectId ?? null,
-			status: list.status ?? null,
-			mine: list.mine ?? false,
-			page_size: list.pageSize ?? null,
-			before: instantArg(list.before) ?? null
-		}, (value) => recordsOf(value, "list_signature_requests").map((row) => requestOf(row, "list_signature_requests"))).andThen(fields.rows)
-	}, options.hooks, {
-		block: "signatures",
-		...options.logger ? { logger: options.logger } : {}
-	});
+/**
+* The Net Promoter Score of the counts: the promoters' share minus the
+* detractors', from -100 to 100, to one decimal. `undefined` without answers.
+*/
+function npsScore(counts) {
+	const total = counts.promoters + counts.passives + counts.detractors;
+	if (total === 0) return;
+	const tenths = (counts.promoters - counts.detractors) * 1e3 / total;
+	const rounded = Math.round(Math.abs(tenths)) / 10;
+	return tenths < 0 && rounded > 0 ? -rounded : rounded;
 }
 //#endregion
 //#region src/blocks/forms/events.ts
@@ -310,14 +288,6 @@ const formsEvents = defineEvents({
 	"form_submission.reviewed": event(),
 	"form_submission.deleted": event()
 });
-/** The `signatures` block's event types, for its manifest and `onBlockEvent`. */
-const signaturesEvents = defineEvents({
-	"signature.requested": event(),
-	"signature.signed": event(),
-	"signature.completed": event(),
-	"signature.declined": event(),
-	"signature.cancelled": event()
-});
 //#endregion
 //#region src/blocks/forms/manifest.ts
 /** The `forms` block's manifest (ADR 0029). */
@@ -331,14 +301,5 @@ const formsBlock = defineBlock({
 	category: "content",
 	recipes: ["form-builder"]
 });
-/** The `signatures` block's manifest (ADR 0029). */
-const signaturesBlock = defineBlock({
-	name: "signatures",
-	sql: ["signatures"],
-	options: { signatures: signaturesSqlOptions },
-	events: signaturesEvents,
-	create: createSignatures,
-	category: "content"
-});
 //#endregion
-export { FORM_DEFINITION_SCHEMA, FORM_FIELD_TYPES, FORM_SCHEMA_DIALECT, answersSchema, conditionHolds, createForms, createQuestionnaireController, createSignatures, dbTransport, finishQuestionnaire, formDefinitionProblems, formSchema, formsBlock, formsEvents, initialQuestionnaire, isFormDefinition, pruneAnswers, questionnaireReducer, questionnaireSteps, rpcTransport, signaturesBlock, signaturesEvents, sqlTransport, stepIssues, validateAnswers, visibleFields, visibleSteps };
+export { FORM_DEFINITION_SCHEMA, FORM_FIELD_TYPES, FORM_SCHEMA_DIALECT, NPS_MAX, UNSCORED_FIELD_TYPES, answersSchema, conditionHolds, createForms, createQuestionnaireController, dbTransport, finishQuestionnaire, formDefinitionProblems, formSchema, formScore, formsBlock, formsEvents, initialQuestionnaire, isFormDefinition, npsCategory, npsScore, pruneAnswers, questionnaireReducer, questionnaireSteps, rpcTransport, sqlTransport, stepIssues, validateAnswers, visibleFields, visibleSteps };

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

@@ -1,4 +1,4 @@
-import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-BsfsRHae.js";
+import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-Bni68sve.js";
 //#region src/blocks/forms/react/index.d.ts
 export type UseQuestionnaireOptions = QuestionnaireOptions;
 export interface QuestionnaireView extends QuestionnaireSnapshot, QuestionnaireActions {}

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

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
-import { t as SolidController } from "../../../solid-controller-BnF3ovwV.js";
-import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-BsfsRHae.js";
+import { t as SolidController } from "../../../solid-bind-C1jeq4Qm.js";
+import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-Bni68sve.js";
 //#region src/blocks/forms/solid/index.d.ts
 /**
  * `createQuestionnaireController` as a Solid primitive: `state()` reads the

package/dist/blocks/forms/solid/index.js

@@ -1,4 +1,4 @@
-import { t as useBlockController } from "../../../solid-controller-7TxGaJNy.js";
+import { t as useBlockController } from "../../../solid-controller-DGuv7V8a.js";
 import { t as createQuestionnaireController } from "../../../client-BKGVUgo7.js";
 //#region src/blocks/forms/solid/index.ts
 /**

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

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
-import { t as SvelteController } from "../../../svelte-controller-DXO7gsmS.js";
-import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-BsfsRHae.js";
+import { t as SvelteController } from "../../../svelte-bind-Ja6CtQGp.js";
+import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-Bni68sve.js";
 //#region src/blocks/forms/svelte/index.d.ts
 /**
  * `createQuestionnaireController` as a Svelte readable store of the snapshot,

package/dist/blocks/forms/svelte/index.js

@@ -1,4 +1,4 @@
-import { t as useBlockController } from "../../../svelte-controller-BmRhHvFz.js";
+import { t as useBlockController } from "../../../svelte-controller-oFKC9AYu.js";
 import { t as createQuestionnaireController } from "../../../client-BKGVUgo7.js";
 //#region src/blocks/forms/svelte/index.ts
 /**

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

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
-import { t as VueController } from "../../../vue-controller-DCOtUOA_.js";
-import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-BsfsRHae.js";
+import { t as VueController } from "../../../vue-bind-TPkbLl4z.js";
+import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-Bni68sve.js";
 //#region src/blocks/forms/vue/index.d.ts
 /**
  * `createQuestionnaireController` as a Vue composable: `state` is a shallow ref

package/dist/blocks/forms/vue/index.js

@@ -1,4 +1,4 @@
-import { t as useBlockController } from "../../../vue-controller-EzyTjqca.js";
+import { t as useBlockController } from "../../../vue-controller-WtbuT-Ux.js";
 import { t as createQuestionnaireController } from "../../../client-BKGVUgo7.js";
 //#region src/blocks/forms/vue/index.ts
 /**

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

@@ -0,0 +1,200 @@
+/// <reference lib="esnext.temporal" />
+import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
+import { dt as SubjectRef } from "../../executor-CPyrQdjh.js";
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { a as BlockTenantOptions, 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 { Gt as SectionWrite, Lt as Section, Wt as SectionRowInput, c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { t as GuestAction } from "../../guest-actions-1T1DeS5Y.js";
+//#region src/blocks/guests/guests.d.ts
+interface GuestsOptions extends BlockTemporalOptions, BlockTenantOptions {
+  readonly transport: BlockTransport;
+  /**
+   * The module schema, or its API schema: `defineBlocks` passes it from
+   * `blocks.generated.ts`.
+   */
+  readonly schema?: string;
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: NoInfer<BlockHooks<Guests>>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+type GuestStatus = "invited" | "active" | "revoked";
+/** Someone outside the organization, invited by email. Never a member. */
+interface Guest {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly email: string;
+  readonly name?: string;
+  /** Set once the guest accepts. */
+  readonly userId?: string;
+  /**
+   * The party the guest acts for, such as a customer company: they see its
+   * invoices and bookings.
+   */
+  readonly party?: SubjectRef;
+  readonly status: GuestStatus;
+  readonly invitedBy?: string;
+  readonly expiresAt?: Temporal.Instant;
+  readonly acceptedAt?: Temporal.Instant;
+  readonly revokedAt?: Temporal.Instant;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+}
+/** A guest with the one-time token for the invite link. */
+interface GuestInvite extends Guest {
+  /**
+   * Send it in the invite link; `accept` takes it. Missing when the guest had
+   * already accepted, so no new token was issued.
+   */
+  readonly token?: string;
+}
+/** One record a guest reaches. */
+interface GuestGrant {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly guestId: string;
+  readonly subject: SubjectRef;
+  /** Always holds `read`. */
+  readonly actions: readonly GuestAction[];
+  readonly grantedBy?: string;
+  readonly expiresAt?: Temporal.Instant;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+}
+/** A grant on a record, with its guest, for the record's sharing panel. */
+interface RecordGuestGrant extends GuestGrant {
+  readonly guest: Guest;
+}
+/** One organization the caller is a guest of, with their live grants. */
+interface GuestMembership extends Guest {
+  readonly grants: readonly GuestGrant[];
+}
+interface GuestInviteInput {
+  readonly email: string;
+  readonly name?: string;
+  /** The customer company or person the guest acts for. */
+  readonly party?: SubjectRef;
+  /** When the invite stops working. */
+  readonly expiresAt?: Temporal.Instant;
+}
+interface GuestGrantInput {
+  /** Default `["read"]`; `read` is always added. */
+  readonly actions?: readonly GuestAction[];
+  readonly expiresAt?: Temporal.Instant;
+}
+interface GuestListOptions {
+  readonly status?: GuestStatus;
+  /** Pages back from a guest's `createdAt`. */
+  readonly before?: Temporal.Instant;
+  readonly pageSize?: number;
+}
+interface Guests {
+  /**
+   * Invites an email to the block's tenant. Needs `guests.manage`. Inviting the
+   * email again issues a new token, or restores a revoked guest.
+   */
+  invite(input: GuestInviteInput): AsyncResult<GuestInvite>;
+  /**
+   * The signed-in user accepts an invite. Their confirmed email must match the
+   * invite's.
+   */
+  accept(token: string): AsyncResult<Guest>;
+  /** Needs `guests.manage`. Their grants stop counting. */
+  revoke(guestId: string): AsyncResult<Guest>;
+  /** The tenant's guests, newest first. Needs `guests.read`. */
+  list(options?: GuestListOptions): AsyncResult<readonly Guest[]>;
+  /**
+   * Lets a guest reach one record. Needs `guests.manage`; the record must be in
+   * the guest's organization.
+   */
+  grant(guestId: string, subject: SubjectRef, input?: GuestGrantInput): AsyncResult<GuestGrant>;
+  /** `false` when the grant is gone or the caller can't manage it. */
+  revokeGrant(grantId: string): AsyncResult<boolean>;
+  /** The guests who reach a record. The record decides the tenant. */
+  grants(subject: SubjectRef): AsyncResult<readonly RecordGuestGrant[]>;
+  /** What the caller reaches as a guest, for a portal's home page. */
+  mine(): AsyncResult<readonly GuestMembership[]>;
+  /** Whether the caller reaches a record as a guest for an action. */
+  can(subject: SubjectRef, action?: GuestAction): AsyncResult<boolean>;
+}
+/** The `guests` SQL module as typed calls. */
+export declare function createGuests(options: GuestsOptions): Guests;
+//#endregion
+//#region src/blocks/guests/events.d.ts
+/** `guest.invited`. */
+interface GuestInvitedEventData {
+  readonly organizationId: string;
+  /** The guest. */
+  readonly id: string;
+  readonly email: string;
+  /** The party the guest acts for, such as a customer company, when set. */
+  readonly partyType: string | null;
+  readonly partyId: string | null;
+}
+/** `guest.accepted`. */
+interface GuestAcceptedEventData {
+  readonly organizationId: string;
+  readonly id: string;
+  /** The user who accepted the invite. */
+  readonly userId: string;
+}
+/** `guest.revoked`. */
+interface GuestRevokedEventData {
+  readonly organizationId: string;
+  readonly id: string;
+}
+/** `guest_grant.created` and `guest_grant.revoked`. */
+interface GuestGrantEventData {
+  readonly organizationId: string;
+  /** The grant. */
+  readonly id: string;
+  readonly guestId: string;
+  readonly subjectType: string;
+  readonly subjectId: string;
+  /** `read`, `comment` and `upload`, in that order. */
+  readonly actions: readonly string[];
+}
+/** The events of the `guests` block: type to data. */
+type GuestsEvents = {
+  readonly "guest.invited": GuestInvitedEventData;
+  readonly "guest.accepted": GuestAcceptedEventData;
+  readonly "guest.revoked": GuestRevokedEventData;
+  readonly "guest_grant.created": GuestGrantEventData;
+  readonly "guest_grant.revoked": GuestGrantEventData;
+};
+/** The `guests` block's event types, for its manifest and `onBlockEvent`. */
+export declare const guestsEvents: Events<GuestsEvents>;
+//#endregion
+//#region src/blocks/guests/schemas.d.ts
+/** What `invite` takes, with the bounds the SQL checks. */
+export declare const guestInviteSchema: EntitySchema<GuestInviteInput>;
+/** What `grant` takes after the guest and the record. */
+export declare const guestGrantSchema: EntitySchema<GuestGrantInput>;
+/** What the section's `grant` write takes. */
+interface GuestSectionGrantInput extends GuestGrantInput {
+  readonly guestId: string;
+}
+export declare const guestSectionGrantSchema: EntitySchema<GuestSectionGrantInput>;
+//#endregion
+//#region src/blocks/guests/section.d.ts
+/** The writes of the guests section. */
+type GuestsWrites = {
+  /** Lets a guest reach the record. */
+  readonly grant: SectionWrite<Guests, GuestSectionGrantInput, GuestGrant>;
+  /** Takes one guest's access to the record away. */
+  readonly revoke: SectionWrite<Guests, SectionRowInput, boolean>;
+};
+/** The guests who reach a record: a sharing panel. */
+export declare const guestsSection: Section<Guests, readonly RecordGuestGrant[], undefined, never, GuestsWrites>;
+//#endregion
+//#region src/blocks/guests/manifest.d.ts
+/** The `guests` block's manifest (ADR 0029). */
+export declare const guestsBlock: BlockOf<"guests", typeof createGuests, GuestsEvents, Record<never, never>, never, {
+  readonly guests: typeof guestsSection;
+}>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Guest, type GuestAcceptedEventData, type GuestAction, type GuestGrant, type GuestGrantEventData, type GuestGrantInput, type GuestInvite, type GuestInviteInput, type GuestInvitedEventData, type GuestListOptions, type GuestMembership, type GuestRevokedEventData, type GuestSectionGrantInput, type GuestStatus, type Guests, type GuestsEvents, type GuestsOptions, type GuestsWrites, type RecordGuestGrant, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };