better-supabase 0.8.0 → 0.10.0

package/dist/blocks/organizations/react/server.js

@@ -0,0 +1,15 @@
+//#region src/blocks/organizations/react/server.ts
+/** The `react-server` build of `useOrganizations`: call `organizations.mine()` instead. */
+const useOrganizations = () => {
+	throw new Error("better-supabase: useOrganizations() runs in Client Components only. In Server Components call `organizations.mine()` instead.");
+};
+/** The `react-server` build of `useMembers`: call `organizations.members()` instead. */
+const useMembers = () => {
+	throw new Error("better-supabase: useMembers() runs in Client Components only. In Server Components call `organizations.members()` instead.");
+};
+/** The `react-server` build of `useInvitations`: call `organizations.invitations()` instead. */
+const useInvitations = () => {
+	throw new Error("better-supabase: useInvitations() runs in Client Components only. In Server Components call `organizations.invitations()` instead.");
+};
+//#endregion
+export { useInvitations, useMembers, useOrganizations };

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

@@ -0,0 +1,34 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-CZrt1Tg6.js";
+import { A as OrganizationInvitationRow, M as OrganizationMembership, _ as OrganizationsSnapshot, a as InvitationsControllerOptions, c as MembersActions, d as MembersSnapshot, g as OrganizationsControllerOptions, j as OrganizationMember, m as OrganizationsActions, o as InvitationsSnapshot, r as InvitationsActions, u as MembersControllerOptions } from "../../../client-Cgxj38RS.js";
+//#region src/blocks/organizations/solid/index.d.ts
+/**
+ * `createOrganizationsController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useOrganizations<T extends {
+  readonly id: string;
+} = OrganizationMembership>(options: BlockOptions<OrganizationsControllerOptions<T>>): SolidController<OrganizationsSnapshot<T>, OrganizationsActions>;
+/**
+ * `createMembersController` as a Solid primitive: `state()` reads the snapshot.
+ * Call it in a component; the work starts on mount and the controller is
+ * disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useMembers<T extends {
+  readonly userId: string;
+  readonly role: string;
+} = OrganizationMember>(options: BlockOptions<MembersControllerOptions<T>>): SolidController<MembersSnapshot<T>, MembersActions<T["role"]>>;
+/**
+ * `createInvitationsController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useInvitations<T extends {
+  readonly id: string;
+} = OrganizationInvitationRow>(options: BlockOptions<InvitationsControllerOptions<T>>): SolidController<InvitationsSnapshot<T>, InvitationsActions>;
+//#endregion
+export type { BlockOptions, InvitationsActions, InvitationsControllerOptions, InvitationsSnapshot, MembersActions, MembersControllerOptions, MembersSnapshot, OrganizationInvitationRow, OrganizationMember, OrganizationMembership, OrganizationsActions, OrganizationsControllerOptions, OrganizationsSnapshot, SolidController };

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

@@ -0,0 +1,32 @@
+import { n as createMembersController, r as createOrganizationsController, t as createInvitationsController } from "../../../client-kI6vCKVI.js";
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+//#region src/blocks/organizations/solid/index.ts
+/**
+* `createOrganizationsController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useOrganizations(options) {
+	return useBlockController(createOrganizationsController, options);
+}
+/**
+* `createMembersController` as a Solid primitive: `state()` reads the snapshot.
+* Call it in a component; the work starts on mount and the controller is
+* disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useMembers(options) {
+	return useBlockController(createMembersController, options);
+}
+/**
+* `createInvitationsController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useInvitations(options) {
+	return useBlockController(createInvitationsController, options);
+}
+//#endregion
+export { useInvitations, useMembers, useOrganizations };

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

@@ -0,0 +1,34 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DDbju9CW.js";
+import { A as OrganizationInvitationRow, M as OrganizationMembership, _ as OrganizationsSnapshot, a as InvitationsControllerOptions, c as MembersActions, d as MembersSnapshot, g as OrganizationsControllerOptions, j as OrganizationMember, m as OrganizationsActions, o as InvitationsSnapshot, r as InvitationsActions, u as MembersControllerOptions } from "../../../client-Cgxj38RS.js";
+//#region src/blocks/organizations/svelte/index.d.ts
+/**
+ * `createOrganizationsController` as a Svelte readable store of the snapshot,
+ * with the actions on `.actions`. Call it in a component's script; the work
+ * starts on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useOrganizations<T extends {
+  readonly id: string;
+} = OrganizationMembership>(options: BlockOptions<OrganizationsControllerOptions<T>>): SvelteController<OrganizationsSnapshot<T>, OrganizationsActions>;
+/**
+ * `createMembersController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useMembers<T extends {
+  readonly userId: string;
+  readonly role: string;
+} = OrganizationMember>(options: BlockOptions<MembersControllerOptions<T>>): SvelteController<MembersSnapshot<T>, MembersActions<T["role"]>>;
+/**
+ * `createInvitationsController` as a Svelte readable store of the snapshot,
+ * with the actions on `.actions`. Call it in a component's script; the work
+ * starts on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useInvitations<T extends {
+  readonly id: string;
+} = OrganizationInvitationRow>(options: BlockOptions<InvitationsControllerOptions<T>>): SvelteController<InvitationsSnapshot<T>, InvitationsActions>;
+//#endregion
+export type { BlockOptions, InvitationsActions, InvitationsControllerOptions, InvitationsSnapshot, MembersActions, MembersControllerOptions, MembersSnapshot, OrganizationInvitationRow, OrganizationMember, OrganizationMembership, OrganizationsActions, OrganizationsControllerOptions, OrganizationsSnapshot, SvelteController };

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

@@ -0,0 +1,32 @@
+import { n as createMembersController, r as createOrganizationsController, t as createInvitationsController } from "../../../client-kI6vCKVI.js";
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+//#region src/blocks/organizations/svelte/index.ts
+/**
+* `createOrganizationsController` as a Svelte readable store of the snapshot,
+* with the actions on `.actions`. Call it in a component's script; the work
+* starts on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useOrganizations(options) {
+	return useBlockController(createOrganizationsController, options);
+}
+/**
+* `createMembersController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useMembers(options) {
+	return useBlockController(createMembersController, options);
+}
+/**
+* `createInvitationsController` as a Svelte readable store of the snapshot,
+* with the actions on `.actions`. Call it in a component's script; the work
+* starts on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useInvitations(options) {
+	return useBlockController(createInvitationsController, options);
+}
+//#endregion
+export { useInvitations, useMembers, useOrganizations };

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

@@ -0,0 +1,34 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-D_ohttBZ.js";
+import { A as OrganizationInvitationRow, M as OrganizationMembership, _ as OrganizationsSnapshot, a as InvitationsControllerOptions, c as MembersActions, d as MembersSnapshot, g as OrganizationsControllerOptions, j as OrganizationMember, m as OrganizationsActions, o as InvitationsSnapshot, r as InvitationsActions, u as MembersControllerOptions } from "../../../client-Cgxj38RS.js";
+//#region src/blocks/organizations/vue/index.d.ts
+/**
+ * `createOrganizationsController` as a Vue composable: `state` is a shallow ref
+ * of the snapshot. Call it in `setup` or an effect scope; the work starts on
+ * mount and the controller is disposed with the scope. `auth` and `ports`
+ * default to the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useOrganizations<T extends {
+  readonly id: string;
+} = OrganizationMembership>(options: BlockOptions<OrganizationsControllerOptions<T>>): VueController<OrganizationsSnapshot<T>, OrganizationsActions>;
+/**
+ * `createMembersController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useMembers<T extends {
+  readonly userId: string;
+  readonly role: string;
+} = OrganizationMember>(options: BlockOptions<MembersControllerOptions<T>>): VueController<MembersSnapshot<T>, MembersActions<T["role"]>>;
+/**
+ * `createInvitationsController` as a Vue composable: `state` is a shallow ref
+ * of the snapshot. Call it in `setup` or an effect scope; the work starts on
+ * mount and the controller is disposed with the scope. `auth` and `ports`
+ * default to the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useInvitations<T extends {
+  readonly id: string;
+} = OrganizationInvitationRow>(options: BlockOptions<InvitationsControllerOptions<T>>): VueController<InvitationsSnapshot<T>, InvitationsActions>;
+//#endregion
+export type { BlockOptions, InvitationsActions, InvitationsControllerOptions, InvitationsSnapshot, MembersActions, MembersControllerOptions, MembersSnapshot, OrganizationInvitationRow, OrganizationMember, OrganizationMembership, OrganizationsActions, OrganizationsControllerOptions, OrganizationsSnapshot, VueController };

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

@@ -0,0 +1,32 @@
+import { n as createMembersController, r as createOrganizationsController, t as createInvitationsController } from "../../../client-kI6vCKVI.js";
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+//#region src/blocks/organizations/vue/index.ts
+/**
+* `createOrganizationsController` as a Vue composable: `state` is a shallow ref
+* of the snapshot. Call it in `setup` or an effect scope; the work starts on
+* mount and the controller is disposed with the scope. `auth` and `ports`
+* default to the client of `app.use(betterSupabase(bs))`.
+*/
+function useOrganizations(options) {
+	return useBlockController(createOrganizationsController, options);
+}
+/**
+* `createMembersController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function useMembers(options) {
+	return useBlockController(createMembersController, options);
+}
+/**
+* `createInvitationsController` as a Vue composable: `state` is a shallow ref
+* of the snapshot. Call it in `setup` or an effect scope; the work starts on
+* mount and the controller is disposed with the scope. `auth` and `ports`
+* default to the client of `app.use(betterSupabase(bs))`.
+*/
+function useInvitations(options) {
+	return useBlockController(createInvitationsController, options);
+}
+//#endregion
+export { useInvitations, useMembers, useOrganizations };

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

@@ -1,3 +1,12 @@
-import { t as SqlClient } from "../../executor-ngjKL_Pe.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-DZfAvfzC.js";
-export { type EmitOptions, type HistoryFilter, type Outbox, type OutboxDeadLetter, type OutboxEvent, type OutboxHandler, type OutboxOptions, type OutboxPurgeOptions, type OutboxRouteOptions, type OutboxRouteResult, type RegisterOptions, type RelayOptions, type RelayResult, type SqlClient, createOutbox, outboxCloudEvent };
+import { n as SqlClient } from "../../executor-DzJQVTE2.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.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-BCGHl9X6.js";
+//#region src/blocks/outbox/manifest.d.ts
+/**
+ * The `outbox` block's manifest (ADR 0029). Set the CloudEvents source with
+ * `outboxBlock.with({ source: "https://app.example.com" })`.
+ */
+export declare const outboxBlock: BlockOf<"outbox", typeof createOutbox>;
+//#endregion
+export { type BlockTransport, type EmitOptions, type HistoryFilter, type Outbox, type OutboxDeadLetter, type OutboxEvent, type OutboxHandler, type OutboxOptions, type OutboxPurgeOptions, type OutboxRouteOptions, type OutboxRouteResult, type RegisterOptions, type RelayOptions, type RelayResult, type SqlClient, createOutbox, dbTransport, outboxCloudEvent, rpcTransport, sqlTransport };

package/dist/blocks/outbox/index.js

@@ -1,8 +1,12 @@
-import { s as toDbError } from "../../result-DEqHCMKP.js";
+import { t as DbException } from "../../db-exception-CnWcYPxL.js";
+import { s as toDbError } from "../../result-COkvI9t5.js";
+import { t as outboxSqlOptions } from "../../options-SViK_2x2.js";
 import "../../cloud-event-CTh9Sr5w.js";
-import { i as sqlIdent } from "../../template-lPVh-EwW.js";
-import { t as cronRoute } from "../../cron-route-D2AN9SA1.js";
-import { E as run, N as toInstant, P as workerId, a as budget, n as applyTemporal, r as asDbError, y as pageOf } from "../../block-helpers-Cy3pB96I.js";
+import { t as cronRoute } from "../../cron-route-BsgbJ-g4.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.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-BfVCR5Fc.js";
+import { r as withBlockHooks } from "../../block-hooks-ByKlh8Qy.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.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;
@@ -45,7 +49,7 @@ function outboxCloudEvent(event, options) {
 		...event.source ? { producer: event.source } : {}
 	};
 }
-/** The outbox functions' argument names, for calls through a `BlockTransport`. */
+/** The outbox functions' argument names, in the order the client passes them. */
 const PARAMS = {
 	emit_event: [
 		"event_type",
@@ -109,34 +113,53 @@ function toDeadLetters(value) {
 		}];
 	});
 }
-const isTransport = (source) => "call" in source;
 /**
-* The outbox over a server connection (`SqlClient`), or over a
-* `BlockTransport` such as `rpcTransport(serviceClient, { schema: "api" })`
-* for apps that reach the database only through the Data API. Over a
-* transport, `emit` writes in its own transaction.
+* The outbox over a `BlockTransport`: `sqlTransport(postgres)` on a server
+* connection, where `emit` joins the caller's transaction, or
+* `rpcTransport(serviceClient)` for apps that reach the database only
+* through the Data API, where `emit` writes in its own transaction.
 */
-function createOutbox(source, options) {
+function createOutbox(options) {
 	applyTemporal(options);
-	const name = options.schema ?? "better_supabase";
-	const schema = sqlIdent(name);
-	const transport = isTransport(source) ? source : void 0;
-	const call = async (fn, args) => {
-		if (isTransport(source)) {
-			const names = PARAMS[fn] ?? [];
-			return await source.call(name, fn, Object.fromEntries(names.map((param, index) => [param, args[index]]))) ?? null;
-		}
-		const sql = source;
-		const params = args.map((_, index) => `$${String(index + 1)}`).join(", ");
-		const [row] = await sql.queryRaw(`select ${schema}.${sqlIdent(fn)}(${params}) as value`, args);
-		return row?.value ?? null;
+	const callers = {
+		user: blockCall(options.transport, options.schema, options.mappers),
+		service: blockCall(options.service ?? options.transport, options.schema, options.mappers)
 	};
+	/** Calls `fn` with positional `args`, named by `PARAMS`; a failure throws its `DbError`. */
+	const callAs = (as) => async (fn, args) => callers[as](fn, Object.fromEntries((PARAMS[fn] ?? []).map((param, index) => [param, args[index]])), (value) => value ?? null).orThrow();
+	const userCall = callAs("user");
+	const call = callAs("service");
 	const toSink = (sink) => (events) => sink.send(events.map((event) => outboxCloudEvent(event, options)));
+	const subscribers = options.subscribers ?? options.authorization?.delivery?.subscribers;
+	/** The events `subscribers` lets `consumer` have; all of them without a policy. */
+	async function permitted(consumer, events) {
+		if (!subscribers) return events;
+		const allowed = await Promise.all(events.map(async (event) => {
+			const subscriber = {
+				principal: consumer,
+				kind: "service"
+			};
+			return (await subscribers({
+				type: event.type,
+				tenant: event.tenant,
+				actorId: event.actorId,
+				payload: event.payload,
+				subject: event.subject
+			}, [subscriber])).includes(subscriber);
+		}));
+		return events.filter((_, index) => allowed[index]);
+	}
 	async function relay(consumer, handler, relayOptions = {}, spent = budget(relayOptions.budgetMs)) {
 		const owner = relayOptions.owner ?? workerId();
 		const batch = relayOptions.batch ?? 100;
 		const lease = relayOptions.lease ?? "1 minute";
 		let delivered = 0;
+		let refused = 0;
+		const done = (result) => ({
+			delivered,
+			...refused > 0 ? { refused } : {},
+			...result
+		});
 		while (!spent.expired()) {
 			let events;
 			try {
@@ -147,10 +170,7 @@ function createOutbox(source, options) {
 					lease
 				]));
 			} catch (cause) {
-				return {
-					delivered,
-					error: asDbError(cause)
-				};
+				return done({ error: asDbError(cause) });
 			}
 			const last = events.at(-1);
 			if (last === void 0) {
@@ -161,8 +181,17 @@ function createOutbox(source, options) {
 				]).catch(() => null);
 				break;
 			}
+			let handed;
 			try {
-				await handler(events);
+				handed = await permitted(consumer, events);
+				if (handed.length > 0) {
+					const outcome = await handler(handed);
+					if (typeof outcome === "object" && outcome !== null && "ok" in outcome && outcome.ok === false && "error" in outcome) {
+						const { error } = outcome;
+						if (typeof error === "object" && error !== null && "kind" in error) throw new DbException(error);
+						throw new Error(String(error));
+					}
+				}
 			} catch (cause) {
 				const error = toDbError(cause);
 				return await call("outbox_fail", [
@@ -172,14 +201,10 @@ function createOutbox(source, options) {
 					error.message,
 					relayOptions.maxAttempts ?? 10,
 					relayOptions.maxBackoff ?? "10 minutes"
-				]).catch(() => null) === "dead" ? {
-					delivered,
+				]).catch(() => null) === "dead" ? done({
 					error,
 					deadLettered: 1
-				} : {
-					delivered,
-					error
-				};
+				}) : done({ error });
 			}
 			try {
 				await call("outbox_ack", [
@@ -188,20 +213,18 @@ function createOutbox(source, options) {
 					last.position
 				]);
 			} catch (cause) {
-				return {
-					delivered,
-					error: asDbError(cause)
-				};
+				return done({ error: asDbError(cause) });
 			}
-			delivered += events.length;
+			delivered += handed.length;
+			refused += events.length - handed.length;
 			if (events.length < batch) break;
 		}
-		return { delivered };
+		return done({});
 	}
-	return {
-		emit: (type, payload = {}, emitOptions = {}) => run(async () => String(await call("emit_event", [
+	return withBlockHooks({
+		emit: (type, payload = {}, emitOptions = {}) => run(async () => String(await userCall("emit_event", [
 			type,
-			transport ? payload : JSON.stringify(payload),
+			payload,
 			emitOptions.subject ?? null,
 			emitOptions.tenant ?? null,
 			emitOptions.key ?? null,
@@ -239,7 +262,7 @@ function createOutbox(source, options) {
 				return Response.json(result);
 			});
 		},
-		history: (filter = {}) => run(async () => toEvents(await call("outbox_history", [
+		history: (filter = {}) => run(async () => toEvents(await userCall("outbox_history", [
 			filter.subject ?? null,
 			filter.type ?? null,
 			pageOf(filter).cursor ?? 0,
@@ -251,7 +274,23 @@ function createOutbox(source, options) {
 			batch ?? null,
 			purgeOptions.ignoreIdle ?? null
 		])))
-	};
+	}, options.hooks, {
+		block: "outbox",
+		...options.logger ? { logger: options.logger } : {}
+	});
 }
 //#endregion
-export { createOutbox, outboxCloudEvent };
+//#region src/blocks/outbox/manifest.ts
+/**
+* The `outbox` block's manifest (ADR 0029). Set the CloudEvents source with
+* `outboxBlock.with({ source: "https://app.example.com" })`.
+*/
+const outboxBlock = defineBlock({
+	name: "outbox",
+	sql: ["outbox"],
+	options: { outbox: outboxSqlOptions },
+	create: createOutbox,
+	category: "automation"
+});
+//#endregion
+export { createOutbox, dbTransport, outboxBlock, outboxCloudEvent, rpcTransport, sqlTransport };

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

@@ -0,0 +1,181 @@
+import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
+import { wt as Events } from "../../events-CtAHxPal.js";
+import { b as PartyEventData } from "../../index-DL8z_oDo.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { i as CursorPageOptions } from "../../block-helpers-7pMBVsE6.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-C_WaodoA.js";
+import { i as RowFields, r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
+import { t as SubjectConfig } from "../../subjects-DP-fvFkk.js";
+//#region src/blocks/parties/parties.d.ts
+/** Where a page of a list stops: the last row's name and id. */
+interface PartyCursor {
+  readonly name: string;
+  readonly id: string;
+}
+interface PartyPage<T> {
+  readonly items: readonly T[];
+  /** Pass as `cursor` for the next page; `undefined` on the last page. */
+  readonly next?: PartyCursor;
+}
+interface PartyRecord {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly name: string;
+  readonly lifecycle: string;
+  readonly ownerId?: string;
+  /** Set when this record was merged into another and archived. */
+  readonly mergedInto?: string;
+  readonly archived: boolean;
+  /** The app's extra columns (`options.extraColumns`), by column name. */
+  readonly fields: Readonly<Record<string, unknown>>;
+}
+/** A company. `F` types the extra columns the `fields` schema describes. */
+interface Company<F extends object = Record<never, never>> extends PartyRecord {
+  /** The app's extra columns (`options.extraColumns`), by column name. */
+  readonly fields: RowFields<F>;
+  readonly domain?: string;
+  readonly website?: string;
+  readonly vatId?: string;
+  readonly address?: Readonly<Record<string, unknown>>;
+}
+interface Person extends PartyRecord {
+  readonly email?: string;
+  readonly phone?: string;
+  readonly title?: string;
+  /** The user this person signs in as, for a portal. */
+  readonly userId?: string;
+}
+/** A person at a company. */
+interface CompanyPerson extends Person {
+  readonly role?: string;
+  /** Whether this is the company's primary contact. */
+  readonly primary: boolean;
+}
+/**
+ * The fields of a write. Left out keeps the stored value; `null` clears it
+ * (a name and a lifecycle can't be cleared).
+ */
+interface CompanyInput<F extends object = Record<never, never>> {
+  /** Leave out to create a company; `name` is then required. */
+  readonly id?: string;
+  readonly name?: string;
+  readonly domain?: string | null;
+  readonly website?: string | null;
+  readonly vatId?: string | null;
+  readonly lifecycle?: string;
+  readonly ownerId?: string | null;
+  readonly address?: Readonly<Record<string, unknown>> | null;
+  /** Values for the app's extra columns, by column name; `options.fields` checks them. */
+  readonly fields?: Partial<F> & Readonly<Record<string, unknown>>;
+}
+interface PersonInput {
+  /** Leave out to create a person; `name` is then required. */
+  readonly id?: string;
+  readonly name?: string;
+  readonly email?: string | null;
+  readonly phone?: string | null;
+  readonly title?: string | null;
+  readonly lifecycle?: string;
+  readonly ownerId?: string | null;
+  readonly userId?: string | null;
+  readonly fields?: Readonly<Record<string, unknown>>;
+}
+interface PartyListOptions extends CursorPageOptions<PartyCursor> {
+  /** Matches the name, and a company's domain or a person's email. */
+  readonly search?: string;
+  readonly lifecycle?: string;
+  readonly ownerId?: string;
+}
+interface Parties<F extends object = Record<never, never>> {
+  saveCompany(organizationId: string, input: CompanyInput<F>): AsyncResult<Company<F>>;
+  savePerson(organizationId: string, input: PersonInput): AsyncResult<Person>;
+  /** Archives a company, or restores it with `archived: false`. */
+  archiveCompany(id: string, archived?: boolean): AsyncResult<boolean>;
+  archivePerson(id: string, archived?: boolean): AsyncResult<boolean>;
+  /** Links a person to a company. `primary` replaces the company's primary contact. */
+  linkPerson(companyId: string, personId: string, link?: {
+    readonly role?: string;
+    readonly primary?: boolean;
+  }): AsyncResult<boolean>;
+  unlinkPerson(companyId: string, personId: string): AsyncResult<boolean>;
+  /** Merges `drop` into `keep`. Needs `parties.manage`. */
+  mergeCompanies(keep: string, drop: string): AsyncResult<Company<F>>;
+  mergePeople(keep: string, drop: string): AsyncResult<Person>;
+  /** A page of active companies by name (50 by default, at most 200). */
+  listCompanies(organizationId: string, options?: PartyListOptions): AsyncResult<PartyPage<Company<F>>>;
+  listPeople(organizationId: string, options?: PartyListOptions): AsyncResult<PartyPage<Person>>;
+  /** A company's people with their role, primary contact first. */
+  peopleOf(companyId: string): AsyncResult<CompanyPerson[]>;
+  /** Links an inbox contact to a person. Needs the inbox module. */
+  linkInboxContact(personId: string, contactId: string): AsyncResult<boolean>;
+  unlinkInboxContact(contactId: string): AsyncResult<boolean>;
+  /**
+   * The person an inbox contact is: its link, else the person with its
+   * email (then linked), else with `create` a new lead from the contact.
+   */
+  personForInboxContact(contactId: string, options?: {
+    readonly create?: boolean;
+  }): AsyncResult<Person | undefined>;
+}
+interface PartiesOptions<S extends StandardSchemaV1 | undefined = undefined> {
+  readonly transport: BlockTransport;
+  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. */
+  readonly schema?: string;
+  /**
+   * A Standard Schema for the extra columns of the companies table
+   * (`blocks.parties.options.extraColumns`): writes are validated, reads
+   * parsed.
+   */
+  readonly fields?: S;
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: NoInfer<BlockHooks<Parties<FieldsOf<S>>>>;
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+/**
+ * The parties block: companies and people an organization works with.
+ * Register them in `config.subjects` with `partiesSubjects()` so comments,
+ * tags, files, 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. */
+type PartiesEvents = {
+  readonly "company.created": PartyEventData;
+  readonly "company.updated": PartyEventData;
+  readonly "company.archived": PartyEventData;
+  readonly "company.merged": PartyEventData;
+  readonly "company.person_linked": PartyEventData;
+  readonly "company.person_unlinked": PartyEventData;
+  readonly "person.created": PartyEventData;
+  readonly "person.updated": PartyEventData;
+  readonly "person.archived": PartyEventData;
+  readonly "person.merged": PartyEventData;
+};
+/** The `parties` block's event types, for its manifest and `onBlockEvent`. */
+export declare const partiesEvents: Events<PartiesEvents>;
+//#endregion
+//#region src/blocks/parties/manifest.d.ts
+/** The `parties` block's manifest (ADR 0029). */
+export declare const partiesBlock: BlockOf<"parties", typeof createParties, PartiesEvents>;
+//#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 };