better-supabase 0.13.0 → 0.14.0

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

@@ -1,7 +1,7 @@
-import { n as SqlClient } from "../../executor-DXfgDsKd.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
-import { s as BlockOf } from "../../define-block-MyM4lH42.js";
-import { a as OutboxEvent, c as OutboxPurgeOptions, d as RegisterOptions, f as RelayOptions, h as outboxCloudEvent, i as OutboxDeadLetter, l as OutboxRouteOptions, m as createOutbox, n as HistoryFilter, o as OutboxHandler, p as RelayResult, r as Outbox, s as OutboxOptions, t as EmitOptions, u as OutboxRouteResult } from "../../outbox-Bsk-HJnq.js";
+import { n as SqlClient } from "../../executor-CsTaO3AT.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { a as OutboxEvent, c as OutboxPurgeOptions, d as RegisterOptions, f as RelayOptions, h as outboxCloudEvent, i as OutboxDeadLetter, l as OutboxRouteOptions, m as createOutbox, n as HistoryFilter, o as OutboxHandler, p as RelayResult, r as Outbox, s as OutboxOptions, t as EmitOptions, u as OutboxRouteResult } from "../../outbox-CsF_iKjx.js";
 //#region src/blocks/outbox/manifest.d.ts
 /**
  * The `outbox` block's manifest (ADR 0029). Set the CloudEvents source with

package/dist/blocks/outbox/index.js

@@ -1,12 +1,11 @@
-import { t as DbException } from "../../db-exception-CnWcYPxL.js";
-import { s as toDbError } from "../../result-DIT_qp4G.js";
+import { t as DbException } from "../../db-exception-Lngc1W49.js";
+import { s as toDbError } from "../../result-B3m7xtRY.js";
 import { t as outboxSqlOptions } from "../../options-SViK_2x2.js";
+import { B as dbTransport, H as rpcTransport, R as toInstant, U as sqlTransport, j as run, n as applyTemporal, o as blockCall, r as asDbError, s as budget, w as pageOf, z as workerId } from "../../block-helpers-CiKtrb6g.js";
+import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
 import "../../cloud-event-XsM53POL.js";
-import { t as cronRoute } from "../../cron-route-BbVtwXZz.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
-import { R as toInstant, j as run, n as applyTemporal, o as blockCall, r as asDbError, s as budget, w as pageOf, z as workerId } from "../../block-helpers-DwE32_gT.js";
-import { r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as cronRoute } from "../../cron-route-Y0eJ-FNi.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
 //#region src/blocks/outbox/outbox.ts
 function isOutboxRow(value) {
 	return typeof value === "object" && value !== null && "position" in value && "type" in value && "created_at" in value;

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

@@ -1,14 +1,13 @@
-import { T as ErrorMapper, t as AsyncResult } from "../../result-mijqfoJN.js";
-import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
-import { i as RowFields, r as FieldsOf } from "../../block-fields-DnXkMney.js";
-import { wt as Events } from "../../events-DhGgwqQA.js";
-import { b as PartyEventData } from "../../index-CE0p3st5.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
+import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
+import { i as RowFields, r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
+import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { y as PartyEventData } from "../../block-events-records-BGVyoz57.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 { i as CursorPageOptions } 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 { i as CursorPageOptions } 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, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
 //#region src/blocks/parties/parties.d.ts
 /** Where a page of a list stops: the last row's name and id. */
 interface PartyCursor {
@@ -150,21 +149,6 @@ interface PartiesOptions<S extends StandardSchemaV1 | undefined = undefined> {
  * pipelines and deals can point at them.
  */
 export declare function createParties<S extends StandardSchemaV1 | undefined = undefined>(options: PartiesOptions<S>): Parties<FieldsOf<S>>;
-/**
- * `config.subjects` entries for the parties tables, so subject-bound blocks
- * attach to companies and people. Pass `schema` when the module isn't in
- * `better_supabase`.
- */
-export declare function partiesSubjects(options?: {
-  readonly schema?: string;
-  readonly url?: {
-    readonly company?: string;
-    readonly person?: string;
-  };
-}): {
-  readonly company: SubjectConfig;
-  readonly person: SubjectConfig;
-};
 //#endregion
 //#region src/blocks/parties/events.d.ts
 /** The events of the `parties` block: type to data. */
@@ -187,4 +171,12 @@ export declare const partiesEvents: Events<PartiesEvents>;
 /** The `parties` block's manifest (ADR 0029). */
 export declare const partiesBlock: BlockOf<"parties", typeof createParties, PartiesEvents>;
 //#endregion
+//#region src/blocks/parties/schemas.d.ts
+/** What `saveCompany` takes, with the bounds the SQL checks. */
+export declare const companyInputSchema: EntitySchema<CompanyInput>;
+/** What `savePerson` takes, with the bounds the SQL checks. */
+export declare const personInputSchema: EntitySchema<PersonInput>;
+/** The options `listCompanies` and `listPeople` take. */
+export declare const partyListFilterSchema: EntitySchema<PartyListOptions>;
+//#endregion
 export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Company, type CompanyInput, type CompanyPerson, type Parties, type PartiesEvents, type PartiesOptions, type PartyCursor, type PartyListOptions, type PartyPage, type Person, type PersonInput, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/parties/index.js

@@ -1,11 +1,11 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as partiesSqlOptions } from "../../options-xVAy3UsV.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, k as recordsOf, o as blockCall, w as pageOf } 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, k as recordsOf, o as blockCall, w as pageOf } from "../../block-helpers-DwE32_gT.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
-import { a as readAllFields, l as writeFields, n as blockFields, o as readFields } from "../../block-fields-Cwd4c8m-.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { a as readAllFields, l as writeFields, n as blockFields, o as readFields } from "../../block-fields-DBSJSeaO.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
 //#region src/blocks/parties/parties.ts
 const COMMON = [
 	"id",
@@ -190,46 +190,6 @@ function createParties(options) {
 		...options.logger ? { logger: options.logger } : {}
 	});
 }
-/**
-* `config.subjects` entries for the parties tables, so subject-bound blocks
-* attach to companies and people. Pass `schema` when the module isn't in
-* `better_supabase`.
-*/
-function partiesSubjects(options = {}) {
-	const schema = options.schema ?? "better_supabase";
-	return {
-		company: {
-			table: `${schema}.companies`,
-			idType: "uuid",
-			tenant: "tenant_id",
-			title: "name",
-			permissions: {
-				read: "parties.read",
-				write: "parties.write"
-			},
-			search: {
-				title: "name",
-				body: ["domain"]
-			},
-			...options.url?.company === void 0 ? {} : { url: options.url.company }
-		},
-		person: {
-			table: `${schema}.people`,
-			idType: "uuid",
-			tenant: "tenant_id",
-			title: "name",
-			permissions: {
-				read: "parties.read",
-				write: "parties.write"
-			},
-			search: {
-				title: "name",
-				body: ["email", "title"]
-			},
-			...options.url?.person === void 0 ? {} : { url: options.url.person }
-		}
-	};
-}
 //#endregion
 //#region src/blocks/parties/events.ts
 /** The `parties` block's event types, for its manifest and `onBlockEvent`. */
@@ -246,6 +206,133 @@ const partiesEvents = defineEvents({
 	"person.merged": event()
 });
 //#endregion
+//#region src/blocks/parties/schemas.ts
+const NAME = {
+	kind: "string",
+	optional: true,
+	minLength: 1,
+	maxLength: 300,
+	description: "Required when `id` is left out."
+};
+/** What `saveCompany` takes, with the bounds the SQL checks. */
+const companyInputSchema = entitySchema({
+	title: "CompanyInput",
+	fields: {
+		id: {
+			kind: "uuid",
+			optional: true
+		},
+		name: NAME,
+		domain: {
+			kind: "string",
+			optional: true,
+			nullable: true
+		},
+		website: {
+			kind: "string",
+			optional: true,
+			nullable: true
+		},
+		vatId: {
+			kind: "string",
+			optional: true,
+			nullable: true
+		},
+		lifecycle: {
+			kind: "string",
+			optional: true
+		},
+		ownerId: {
+			kind: "uuid",
+			optional: true,
+			nullable: true
+		},
+		address: {
+			kind: "json",
+			optional: true,
+			nullable: true
+		},
+		fields: {
+			kind: "json",
+			optional: true,
+			description: "The extra columns to set."
+		}
+	}
+});
+/** What `savePerson` takes, with the bounds the SQL checks. */
+const personInputSchema = entitySchema({
+	title: "PersonInput",
+	fields: {
+		id: {
+			kind: "uuid",
+			optional: true
+		},
+		name: NAME,
+		email: {
+			kind: "string",
+			optional: true,
+			nullable: true
+		},
+		phone: {
+			kind: "string",
+			optional: true,
+			nullable: true
+		},
+		title: {
+			kind: "string",
+			optional: true,
+			nullable: true
+		},
+		lifecycle: {
+			kind: "string",
+			optional: true
+		},
+		ownerId: {
+			kind: "uuid",
+			optional: true,
+			nullable: true
+		},
+		userId: {
+			kind: "uuid",
+			optional: true,
+			nullable: true
+		},
+		fields: {
+			kind: "json",
+			optional: true,
+			description: "The extra columns to set."
+		}
+	}
+});
+/** The options `listCompanies` and `listPeople` take. */
+const partyListFilterSchema = entitySchema({
+	title: "PartyListOptions",
+	fields: {
+		search: {
+			kind: "string",
+			optional: true
+		},
+		lifecycle: {
+			kind: "string",
+			optional: true
+		},
+		ownerId: {
+			kind: "uuid",
+			optional: true
+		},
+		limit: {
+			kind: "integer",
+			optional: true,
+			minimum: 1
+		},
+		cursor: {
+			kind: "json",
+			optional: true,
+			description: "The last row's `{ name, id }`."
+		}
+	}
+});
+//#endregion
 //#region src/blocks/parties/manifest.ts
 /** The `parties` block's manifest (ADR 0029). */
 const partiesBlock = defineBlock({
@@ -255,7 +342,17 @@ const partiesBlock = defineBlock({
 	events: partiesEvents,
 	create: createParties,
 	category: "crm",
-	recipes: ["contact-detail"]
+	recipes: ["contact-detail"],
+	schemas: {
+		company: {
+			input: companyInputSchema,
+			listFilter: partyListFilterSchema
+		},
+		person: {
+			input: personInputSchema,
+			listFilter: partyListFilterSchema
+		}
+	}
 });
 //#endregion
-export { createParties, dbTransport, extendBlock, partiesBlock, partiesEvents, partiesSubjects, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { companyInputSchema, createParties, dbTransport, extendBlock, partiesBlock, partiesEvents, partyListFilterSchema, personInputSchema, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -0,0 +1,308 @@
+/// <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 { n as passesSqlOptions, t as PassesSqlOptions } from "../../options-te6d5-yz.js";
+import { Gt as SectionWrite, Lt as Section, Wt as SectionRowInput, c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
+import { n as Booking } from "../../bookings-CC7IeiRa.js";
+import { n as Jwks } from "../../jws-D0toeQlA.js";
+import { o as Signer } from "../../signing-keys-B3RHGMMu.js";
+//#region src/blocks/passes/passes.d.ts
+/** The `typ` header of a pass token: `vnd.pass+jwt`. */
+export declare const PASS_TOKEN_TYPE: string;
+type PassStatus = "active" | "revoked";
+/** How a pass reached the door. `manual`: staff looked the holder up. */
+type PassMethod = "qr" | "nfc" | "manual";
+/** Why a scan turned the holder away. */
+type PassRejection = "invalid" | "revoked" | "not_yet_valid" | "expired" | "used_up" | "booking_cancelled" | "booking_unconfirmed" | "outside_window" | "wrong_resource" | "full";
+interface PassesOptions extends BlockTemporalOptions, BlockTenantOptions {
+  readonly transport: BlockTransport;
+  /**
+   * The module schema, or its API schema: `defineBlocks` passes it from
+   * `blocks.generated.ts`.
+   */
+  readonly schema?: string;
+  /**
+   * Signs pass tokens, on the server: `signingKeys.signer({ type:
+   * "organization", id })`. `token` fails without it.
+   */
+  readonly signer?: Signer;
+  /**
+   * The keys a scanner verifies tokens with: the JWKS the app publishes, or a
+   * function that loads it. `checkIn` fails without it.
+   */
+  readonly jwks?: Jwks | (() => Promise<Jwks>);
+  /**
+   * The longest a token stays valid; a pass that outlives it gets a new token
+   * from `token`. Default: 30 days.
+   */
+  readonly tokenLifetime?: Temporal.Duration;
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: NoInfer<BlockHooks<Passes>>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+/**
+ * An admission pass: a ticket for a booking, or a pass for a resource or
+ * record.
+ */
+interface Pass {
+  readonly id: string;
+  readonly organizationId: string;
+  /** Free text such as `ticket`, `membership` or `visitor`. */
+  readonly kind: string;
+  readonly holderUserId?: string;
+  readonly holderName?: string;
+  readonly holderEmail?: string;
+  /** The record the pass is for, such as an event or a membership. */
+  readonly subject?: SubjectRef;
+  readonly bookingId?: string;
+  readonly resourceId?: string;
+  /** How many check-ins it admits; missing means no limit. */
+  readonly usesAllowed?: number;
+  readonly uses: number;
+  readonly validFrom: Temporal.Instant;
+  readonly validUntil?: Temporal.Instant;
+  readonly status: PassStatus;
+  readonly issuedBy?: string;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+  readonly revokedAt?: Temporal.Instant;
+}
+/** A pass with the nonce its token carries, for the holder or a manager. */
+interface IssuedPass extends Pass {
+  readonly nonce: string;
+}
+/** One scan at a door, admitted or not. */
+interface PassCheckIn {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly passId: string;
+  readonly resourceId?: string;
+  readonly bookingId?: string;
+  readonly gate?: string;
+  readonly method: PassMethod;
+  readonly admitted: boolean;
+  readonly reason?: PassRejection;
+  readonly checkedInBy?: string;
+  readonly createdAt: Temporal.Instant;
+}
+/** What `checkIn` returns: the scan and the pass after it. */
+interface PassScan extends PassCheckIn {
+  readonly pass: Pass;
+}
+/** How full a resource is now, for a door display. */
+interface PassOccupancy {
+  readonly resourceId: string;
+  readonly capacity: number;
+  /** Seats held or confirmed by bookings running now. */
+  readonly booked: number;
+  /** Passes without a booking admitted within the drop-in length. */
+  readonly dropIns: number;
+  readonly free: number;
+}
+interface PassInput {
+  /** Default `ticket`. */
+  readonly kind?: string;
+  readonly holderUserId?: string;
+  readonly holderName?: string;
+  readonly holderEmail?: string;
+  readonly subject?: SubjectRef;
+  /**
+   * A ticket for this booking: valid until the booking ends and good for one
+   * check-in unless the other fields say otherwise.
+   */
+  readonly bookingId?: string;
+  /** A pass for this resource; check-ins count against its capacity. */
+  readonly resourceId?: string;
+  readonly usesAllowed?: number;
+  readonly validFrom?: Temporal.Instant;
+  readonly validUntil?: Temporal.Instant;
+}
+interface PassListOptions {
+  readonly holderUserId?: string;
+  readonly subject?: SubjectRef;
+  readonly status?: PassStatus;
+  /** Pages back from a pass's `createdAt`. */
+  readonly before?: Temporal.Instant;
+  readonly pageSize?: number;
+}
+interface PassCheckInOptions {
+  /** Default `qr`. */
+  readonly method?: Exclude<PassMethod, "manual">;
+  /** The door or scanner, for the log. */
+  readonly gate?: string;
+  /** The resource the door belongs to: a pass for another one is turned away. */
+  readonly resourceId?: string;
+}
+interface PassManualCheckInOptions {
+  readonly gate?: string;
+  readonly resourceId?: string;
+}
+interface PassCheckInListOptions {
+  readonly before?: Temporal.Instant;
+  readonly pageSize?: number;
+}
+/** The claims of a pass token. */
+type PassTokenClaims = {
+  /** The pass. */
+  readonly sub: string;
+  /** The pass's nonce; revoking or reissuing the pass changes what it matches. */
+  readonly jti: string;
+  readonly org: string;
+  readonly kind: string;
+  readonly name?: string;
+  readonly nbf: number;
+  readonly exp: number;
+};
+interface Passes {
+  /** Issues a pass in the block's tenant. Needs `passes.manage`. */
+  issue(input: PassInput): AsyncResult<IssuedPass>;
+  /** Needs `passes.manage`. Its tokens stop admitting. */
+  revoke(passId: string): AsyncResult<Pass>;
+  /** One pass with its nonce, for its holder or a manager; `null` otherwise. */
+  get(passId: string): AsyncResult<IssuedPass | null>;
+  /** The tenant's passes, newest first. Needs `passes.read`. */
+  list(options?: PassListOptions): AsyncResult<readonly Pass[]>;
+  /** The caller's live passes, for a wallet screen. */
+  mine(): AsyncResult<readonly IssuedPass[]>;
+  /**
+   * The signed token to put in a QR code or on an NFC tag. Needs `signer`. It
+   * expires with the pass, or after `tokenLifetime`.
+   */
+  token(pass: IssuedPass): AsyncResult<string>;
+  /**
+   * Verifies a scanned token against `jwks`, then checks the holder in. Needs
+   * `passes.check_in`. A bad signature fails with `PASS_TOKEN_INVALID` and an
+   * expired token with `PASS_TOKEN_EXPIRED`, before the database is asked; a
+   * pass the database turns away comes back with `admitted: false` and a
+   * `reason`.
+   */
+  checkIn(token: string, options?: PassCheckInOptions): AsyncResult<PassScan>;
+  /** Checks a holder in by pass id, for staff at the door. */
+  checkInManually(passId: string, options?: PassManualCheckInOptions): AsyncResult<PassScan>;
+  /** A pass's scans, newest first. */
+  checkIns(passId: string, options?: PassCheckInListOptions): AsyncResult<readonly PassCheckIn[]>;
+  /** How full a resource is now. Needs the bookings block. */
+  occupancy(resourceId: string): AsyncResult<PassOccupancy>;
+  /**
+   * Books a class with one credit of a pass with a number of uses
+   * (`options.credits`): its holder, or a passes manager for the holder. The
+   * booking is confirmed; cancelling it before `creditRefundBefore` gives the
+   * credit back.
+   */
+  bookWithCredit(passId: string, input: PassCreditBookingInput): AsyncResult<PassCreditBooking>;
+  /** A pass's credit ledger, newest first. */
+  credits(passId: string): AsyncResult<readonly PassCreditEntry[]>;
+}
+interface PassCreditBookingInput {
+  readonly serviceId: string;
+  readonly resourceId: string;
+  readonly startsAt: Temporal.Instant;
+  /** Overrides the holder's name and email on the booking. */
+  readonly customer?: {
+    readonly name?: string;
+    readonly email?: string;
+  };
+}
+/** A booking a credit paid for. */
+interface PassCreditBooking extends Booking {
+  readonly passId: string;
+  /** The uses the pass has left after this booking. */
+  readonly creditsLeft: number;
+}
+/** One movement in a pass's credit ledger. */
+interface PassCreditEntry {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly passId: string;
+  /** `-1` for a booking, `1` for a refund. */
+  readonly delta: -1 | 1;
+  readonly reason: "booking" | "refund";
+  readonly createdAt: Temporal.Instant;
+  readonly bookingId?: string;
+  readonly createdBy?: string;
+}
+/** The `passes` SQL module as typed calls. */
+export declare function createPasses(options: PassesOptions): Passes;
+//#endregion
+//#region src/blocks/passes/events.d.ts
+/** `pass.issued`. */
+interface PassIssuedEventData {
+  readonly organizationId: string;
+  /** The pass. */
+  readonly id: string;
+  readonly kind: string;
+  readonly holderUserId: string | null;
+  readonly bookingId: string | null;
+}
+/** `pass.revoked`. */
+interface PassRevokedEventData {
+  readonly organizationId: string;
+  readonly id: string;
+}
+/** `pass.admitted`: a scan that admitted the holder. */
+interface PassAdmittedEventData {
+  readonly organizationId: string;
+  /** The pass. */
+  readonly id: string;
+  readonly checkInId: string;
+  readonly resourceId: string | null;
+  readonly bookingId: string | null;
+}
+/** `pass.rejected`: a scan that turned the holder away. */
+interface PassRejectedEventData extends PassAdmittedEventData {
+  /** Why, such as `expired` or `full`. */
+  readonly reason: string;
+}
+/** `pass.credit_used` and `pass.credit_refunded`: a class-credit movement. */
+interface PassCreditEventData {
+  readonly organizationId: string;
+  /** The pass. */
+  readonly id: string;
+  /** The ledger entry. */
+  readonly entryId: string;
+  readonly bookingId: string | null;
+}
+/** The events of the `passes` block: type to data. */
+type PassesEvents = {
+  readonly "pass.issued": PassIssuedEventData;
+  readonly "pass.revoked": PassRevokedEventData;
+  readonly "pass.admitted": PassAdmittedEventData;
+  readonly "pass.rejected": PassRejectedEventData;
+  readonly "pass.credit_used": PassCreditEventData;
+  readonly "pass.credit_refunded": PassCreditEventData;
+};
+/** The `passes` block's event types, for its manifest and `onBlockEvent`. */
+export declare const passesEvents: Events<PassesEvents>;
+//#endregion
+//#region src/blocks/passes/schemas.d.ts
+/** What `issue` takes, with the bounds the SQL checks. */
+export declare const passInputSchema: EntitySchema<PassInput>;
+/** What the section's `issue` write takes: the record is the pass's subject. */
+type PassSectionInput = Omit<PassInput, "subject">;
+export declare const passSectionInputSchema: EntitySchema<PassSectionInput>;
+//#endregion
+//#region src/blocks/passes/section.d.ts
+/** The writes of the passes section. */
+type PassesWrites = {
+  /** Issues a pass for the record, such as a ticket for an event. */
+  readonly issue: SectionWrite<Passes, PassSectionInput, IssuedPass>;
+  /** Revokes one of the record's passes. */
+  readonly revoke: SectionWrite<Passes, SectionRowInput, Pass>;
+};
+/** The passes issued for a record: an event's tickets, a member's cards. */
+export declare const passesSection: Section<Passes, readonly Pass[], undefined, never, PassesWrites>;
+//#endregion
+//#region src/blocks/passes/manifest.d.ts
+/** The `passes` block's manifest (ADR 0029). */
+export declare const passesBlock: BlockOf<"passes", typeof createPasses, PassesEvents, Record<never, never>, never, {
+  readonly passes: typeof passesSection;
+}>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type IssuedPass, type Pass, type PassAdmittedEventData, type PassCheckIn, type PassCheckInListOptions, type PassCheckInOptions, type PassCreditBooking, type PassCreditBookingInput, type PassCreditEntry, type PassCreditEventData, type PassInput, type PassIssuedEventData, type PassListOptions, type PassManualCheckInOptions, type PassMethod, type PassOccupancy, type PassRejectedEventData, type PassRejection, type PassRevokedEventData, type PassScan, type PassSectionInput, type PassStatus, type PassTokenClaims, type Passes, type PassesEvents, type PassesOptions, type PassesSqlOptions, type PassesWrites, type RpcClient, dbTransport, extendBlock, passesSqlOptions, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };