better-supabase 0.14.0 → 0.15.0

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

@@ -1,15 +1,15 @@
 /// <reference lib="esnext.temporal" />
-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 { Ct as Events, R as DriveEventData } from "../../events-DbLjvxDX.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { Ct as Events, R as DriveEventData } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.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 { Q as AttachmentDownload, X as Attachment, c as BlockOf, lt as Attachments, ot as AttachmentStorage } from "../../define-block-COpcS6aT.js";
-import { s as ApprovalStatus } from "../../approvals-bMb7dsBY.js";
-import { t as SubjectConfig } from "../../subjects-B6p4oAZJ.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { Ot as Attachments, Tt as AttachmentStorage, _t as AttachmentDownload, c as BlockOf, ht as Attachment } from "../../define-block-BVcLQ3DF.js";
+import { s as ApprovalStatus } from "../../approvals-Crutd4-o.js";
+import { t as SubjectConfig } from "../../subjects-DvmQeF_F.js";
 //#region src/blocks/drive/drive.d.ts
 interface DriveOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
   /** The caller's transport (`rpcTransport(supabase)`), so grants apply. */

package/dist/blocks/drive/index.js

@@ -1,14 +1,14 @@
-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 dbError } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-ntFBW2p2.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 { 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-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.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";
+import { n as blockFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { n as claimsUploads, t as claimUpload } from "../../upload-claim-B1ZU8ydB.js";
+import { o as stored, t as attachmentOf } from "../../attachments-aJYgdYtB.js";
 //#region src/blocks/drive/drive.ts
 const KINDS = ["folder", "file"];
 const APPROVAL_STATUSES = [

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

@@ -1,9 +1,186 @@
-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";
+/// <reference lib="esnext.temporal" />
+import { T as ErrorMapper, f as Result, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { $ as RecordRef } from "../../types-DFdg_4yN.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
+import { y as EmployeeEventData } from "../../index-CG9rA8H8.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { Bt as Action, Sn as EntitySchema, c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { n as Money } from "../../money-BNRdJQzA.js";
+import { n as ConversionContext, t as ConversionClients } from "../../conversion-BAbucuXq.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>>;
+//#endregion
 //#region src/blocks/employees/events.d.ts
 /** The events of the `employees` block: type to data. */
 type EmployeesEvents = {
@@ -28,4 +205,24 @@ export declare const employeeInputSchema: EntitySchema<EmployeeInput>;
  */
 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 };
+//#region src/blocks/employees/actions.d.ts
+/** `blocks.employees` and `blocks.relations` for one organization. */
+interface EmployeeFromApplicationClients extends ConversionClients {
+  readonly employees: {
+    fromApplication(applicationId: string, overrides?: Partial<EmployeeInput>): PromiseLike<Result<Employee>>;
+  };
+}
+interface EmployeeFromApplicationOptions {
+  /** The clients for one organization, over a service connection. */
+  readonly clients: (tenant: string) => EmployeeFromApplicationClients | PromiseLike<EmployeeFromApplicationClients>;
+  /** Overrides what the employee takes from the candidate and the job. */
+  readonly map?: (context: ConversionContext<EmployeeFromApplicationClients>) => Partial<EmployeeInput>;
+}
+/**
+ * The `employees.from_application` action, which the hiring block's default
+ * automation runs on `application.hired`: an employee in preboarding through
+ * `employees.fromApplication`, which records the `created_from` link itself.
+ */
+export declare function employeeFromApplicationAction(options: EmployeeFromApplicationOptions): Action;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Contract, type ContractInput, type EmergencyContact, type Employee, type EmployeeChange, type EmployeeChangeResult, type EmployeeField, type EmployeeFromApplicationClients, type EmployeeFromApplicationOptions, 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 };

package/dist/blocks/employees/index.js

@@ -1,15 +1,16 @@
-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 temporal } from "../../temporal-required-Dy0GGD8E.js";
+import { a as ok, t as AsyncResult } from "../../result-ntFBW2p2.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 { 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-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as entitySchema } from "../../entity-schema-BDv6w-OQ.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.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";
+import { n as blockFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as defineConversionAction } from "../../conversion-Dq1S7xzE.js";
+import { o as optionalMoneyOf, t as amountText } from "../../money-codec-BzddguAQ.js";
+import { i as refOf, n as compact, r as plainDate } from "../../sales-shared-DXGFJP4g.js";
 //#region src/blocks/employees/employees.ts
 const STATUSES = [
 	"preboarding",
@@ -349,10 +350,35 @@ const employeesBlock = defineBlock({
 	create: createEmployees,
 	category: "people",
 	recipes: ["employee-directory"],
+	actions: [{
+		kind: "employees.from_application",
+		title: "Preboard the hired candidate"
+	}],
 	schemas: { employee: {
 		input: employeeInputSchema,
 		change: employeeChangeSchema
 	} }
 });
 //#endregion
-export { createEmployees, dbTransport, employeeChangeSchema, employeeInputSchema, employeesBlock, employeesEvents, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+//#region src/blocks/employees/actions.ts
+/**
+* The `employees.from_application` action, which the hiring block's default
+* automation runs on `application.hired`: an employee in preboarding through
+* `employees.fromApplication`, which records the `created_from` link itself.
+*/
+function employeeFromApplicationAction(options) {
+	return defineConversionAction({
+		kind: "employees.from_application",
+		title: "Preboard the hired candidate",
+		targetType: "employee",
+		clients: options.clients,
+		map: (_, context) => options.map?.(context) ?? {},
+		create: async (overrides, { clients, source }) => {
+			const created = await clients.employees.fromApplication(source.id, overrides);
+			return created.ok ? ok({ id: created.data.id }) : created;
+		},
+		linksItself: true
+	});
+}
+//#endregion
+export { createEmployees, dbTransport, employeeChangeSchema, employeeFromApplicationAction, employeeInputSchema, employeesBlock, employeesEvents, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,12 +1,12 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
-import { Ct as Events } from "../../events-DbLjvxDX.js";
-import { d as EnrichmentEventData } from "../../block-events-records-BGVyoz57.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
+import { S as EnrichmentEventData } from "../../index-CG9rA8H8.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 { r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/enrichment/providers.d.ts
 /** What a provider looks up a company by. */
 interface CompanyLookup {

package/dist/blocks/enrichment/index.js

@@ -1,10 +1,10 @@
-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 dbError } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, 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 { a as ok, r as err, t as AsyncResult } from "../../result-ntFBW2p2.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/enrichment/providers.ts
 /** Checks the provider's `apiVersion` and name before the block uses it. */
 function enrichmentProviderOf(provider) {
@@ -237,7 +237,15 @@ const enrichmentBlock = defineBlock({
 	sql: ["enrichment"],
 	events: enrichmentEvents,
 	create: createEnrichment,
-	category: "crm"
+	category: "crm",
+	providers: [{
+		option: "provider",
+		type: "EnrichmentProvider",
+		from: "better-supabase/blocks/enrichment",
+		required: true,
+		description: "Looks companies and people up.",
+		example: "peopleDataLabsEnrichment({ apiKey: process.env[\"PDL_API_KEY\"] ?? \"\" })"
+	}]
 });
 //#endregion
 export { createEnrichment, dbTransport, domainOf, enrichmentBlock, enrichmentEvents, enrichmentProviderOf, extendBlock, peopleDataLabsEnrichment, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,13 +1,13 @@
 /// <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 { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { $ as RecordRef } from "../../types-DFdg_4yN.js";
+import { Ct as Events } from "../../events-vcqenSYU.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 { a as BlockTenantOptions, r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
 import { t as EnrollmentsSqlOptions } from "../../options-CSCXNYJO.js";
-import { Lt as Section, c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { c as BlockOf, rn as RecordBinding } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/enrollments/enrollments.d.ts
 interface EnrollmentsOptions extends BlockTemporalOptions, BlockTenantOptions {
   readonly transport: BlockTransport;
@@ -79,7 +79,7 @@ interface Enrollment {
   /** The program key; `onboarding:<checklist>` for an onboarding checklist. */
   readonly program: string;
   readonly programVersion?: number;
-  readonly subject: SubjectRef;
+  readonly subject: RecordRef;
   readonly status: EnrollmentStatus;
   /** The program's step ids when it enrolled or last changed. */
   readonly steps: readonly string[];
@@ -95,7 +95,7 @@ interface Enrollment {
 }
 interface EnrollmentsFilter {
   readonly program?: string;
-  readonly subject?: SubjectRef;
+  readonly subject?: RecordRef;
   readonly status?: EnrollmentStatus;
   /** Default 50, at most 200. */
   readonly pageSize?: number;
@@ -113,9 +113,9 @@ interface Enrollments {
    * Enrolls a subject. An enrolled subject keeps its enrollment, and a
    * cancelled one starts again with its completed steps.
    */
-  enroll(program: string, subject: SubjectRef): AsyncResult<Enrollment>;
+  enroll(program: string, subject: RecordRef): AsyncResult<Enrollment>;
   /** A subject's enrollment in a program, or `null`. */
-  enrollment(program: string, subject: SubjectRef): AsyncResult<Enrollment | null>;
+  enrollment(program: string, subject: RecordRef): AsyncResult<Enrollment | null>;
   /**
    * The organization's enrollments, most recently changed first. Without
    * `enrollments.read`, the caller's own.
@@ -171,14 +171,12 @@ type EnrollmentsEvents = {
 /** The `enrollments` block's event types, for its manifest and `onBlockEvent`. */
 export declare const enrollmentsEvents: Events<EnrollmentsEvents>;
 //#endregion
-//#region src/blocks/enrollments/section.d.ts
+//#region src/blocks/enrollments/record-binding.d.ts
 /** A record's enrollments: the programs it is in, with their progress. */
-export declare const enrollmentsSection: Section<Enrollments, readonly Enrollment[]>;
+export declare const enrollmentsBinding: RecordBinding<Enrollments, readonly Enrollment[]>;
 //#endregion
 //#region src/blocks/enrollments/manifest.d.ts
 /** The `enrollments` block's manifest (ADR 0029). */
-export declare const enrollmentsBlock: BlockOf<"enrollments", typeof createEnrollments, EnrollmentsEvents, Record<never, never>, never, {
-  readonly enrollments: typeof enrollmentsSection;
-}>;
+export declare const enrollmentsBlock: BlockOf<"enrollments", typeof createEnrollments, EnrollmentsEvents, Record<never, never>, never, typeof enrollmentsBinding>;
 //#endregion
 export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Enrollment, type EnrollmentEventData, type EnrollmentProgram, type EnrollmentProgramEventData, type EnrollmentProgramInput, type EnrollmentProgress, type EnrollmentStatus, type EnrollmentStep, type Enrollments, type EnrollmentsEvents, type EnrollmentsFilter, type EnrollmentsOptions, type EnrollmentsSqlOptions, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/enrollments/index.js

@@ -1,11 +1,11 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as enrollmentsSqlOptions } from "../../options-BYOtaF7w.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, m as instantArg, 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 { t as defineSection } from "../../sections-DjxYmpu-.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, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { t as defineRecordBinding } from "../../record-bindings-DkBJpC5A.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
-import { t as requireTenant } from "../../block-tenant-C1sNV8_4.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as requireOrganization } from "../../block-tenant-DHp7subc.js";
 //#region src/blocks/enrollments/enrollments.ts
 const STATUSES = [
 	"active",
@@ -85,7 +85,7 @@ function programArg(program) {
 function createEnrollments(options) {
 	applyTemporal(options);
 	const call = blockCall(options.transport, options.schema, options.mappers);
-	const tenant = () => requireTenant(options.tenant);
+	const tenant = () => requireOrganization(options.tenant);
 	const one = (fn) => (value) => enrollmentOf(value, fn);
 	return withBlockHooks({
 		saveProgram: (program) => tenant().andThen((organizationId) => call("save_enrollment_program", {
@@ -141,9 +141,9 @@ const enrollmentsEvents = defineEvents({
 	"enrollment.cancelled": event()
 });
 //#endregion
-//#region src/blocks/enrollments/section.ts
+//#region src/blocks/enrollments/record-binding.ts
 /** A record's enrollments: the programs it is in, with their progress. */
-const enrollmentsSection = defineSection({
+const enrollmentsBinding = defineRecordBinding({
 	permissions: {
 		read: "read",
 		write: "enroll"
@@ -166,8 +166,8 @@ const enrollmentsBlock = defineBlock({
 	options: { enrollments: enrollmentsSqlOptions },
 	events: enrollmentsEvents,
 	create: createEnrollments,
-	sections: { enrollments: enrollmentsSection },
+	record: enrollmentsBinding,
 	category: "collaboration"
 });
 //#endregion
-export { createEnrollments, dbTransport, enrollmentsBlock, enrollmentsEvents, enrollmentsSection, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { createEnrollments, dbTransport, enrollmentsBinding, enrollmentsBlock, enrollmentsEvents, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -1,11 +1,11 @@
-import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
 import { n as Logger } from "../../logger-DWVYUmwi.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 { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
-import { i as hasEntitlement, n as EntitlementKey, t as EntitlementClaimOptions } from "../../entitlements-DDevu4ZE.js";
-import { a as createFeatureGateController, i as FeatureGateSnapshot, n as FeatureGateController, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../client-D-LPdEDQ.js";
+import { n as SqlClient } from "../../executor-hGjrop3A.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { n as Controller, t as AuthPort } from "../../controller-BrP0gn47.js";
+import { i as hasEntitlement, n as EntitlementKey, t as EntitlementClaimOptions } from "../../entitlements-CJpYQXeE.js";
 //#region src/blocks/entitlements/entitlements.d.ts
 /** The Stripe event sent when a customer's active entitlements change. */
 export declare const ENTITLEMENTS_UPDATED = "entitlements.active_entitlement_summary.updated";
@@ -53,4 +53,44 @@ export declare function createEntitlements(options: EntitlementsOptions): Entitl
 /** The `entitlements` block's manifest (ADR 0029). */
 export declare const entitlementsBlock: BlockOf<"entitlements", typeof createEntitlements>;
 //#endregion
-export { type BlockTransport, type EntitlementClaimOptions, type EntitlementKey, type Entitlements, type EntitlementsOptions, type FeatureGateActions, type FeatureGateController, type FeatureGateControllerOptions, type FeatureGateSnapshot, createFeatureGateController, dbTransport, hasEntitlement, rpcTransport, sqlTransport };
+//#region src/blocks/entitlements/client.d.ts
+interface FeatureGateControllerOptions {
+  readonly auth: AuthPort;
+  /** The plan feature, such as `exports`: a key of `entitlements.source.plans`. */
+  readonly feature: string;
+  /**
+   * The organization to check. Default the session's active one, from the
+   * tenant claim.
+   */
+  readonly organizationId?: string | null;
+  /**
+   * `config.claims.features` (default `features`), or `{ claim, keys }` for
+   * short codes.
+   */
+  readonly claim?: string | EntitlementClaimOptions;
+  /** The tenant claim, `config.claims.tenant` (default `tenant_id`). */
+  readonly tenantClaim?: string;
+}
+interface FeatureGateSnapshot {
+  /**
+   * `undefined` while the session loads; false when signed out or outside an
+   * organization.
+   */
+  readonly allowed: boolean | undefined;
+  /** The organization the check ran for. */
+  readonly organizationId: string | undefined;
+}
+interface FeatureGateActions {
+  /** Checks the session again, such as after a refresh the gate did not hear of. */
+  readonly recheck: () => void;
+}
+type FeatureGateController = Controller<FeatureGateSnapshot, FeatureGateActions>;
+/**
+ * Whether the active organization's plan includes `feature`, from the session's
+ * plan-features claim. It updates when the session does, so a session refresh
+ * after checkout opens the gate. UX only: enforce the feature in RLS with
+ * `better_supabase.has_entitlement()`.
+ */
+export declare function createFeatureGateController(options: FeatureGateControllerOptions): FeatureGateController;
+//#endregion
+export { type BlockTransport, type EntitlementClaimOptions, type EntitlementKey, type Entitlements, type EntitlementsOptions, type FeatureGateActions, type FeatureGateController, type FeatureGateControllerOptions, type FeatureGateSnapshot, dbTransport, hasEntitlement, rpcTransport, sqlTransport };