better-supabase 0.12.0 → 0.14.0

package/dist/eve-BlJI8ZXL.d.ts

@@ -0,0 +1,157 @@
+import { d as KnowledgeSearchOptions, r as Knowledge } from "./knowledge-CFkCRxO9.js";
+import { t as Memory } from "./types-QHeku_6b.js";
+//#region src/eve/types.d.ts
+/**
+ * Eve's `SessionAuthContext`, typed structurally so this entry never imports
+ * eve. `attributes` carries `tenantId`, `roles` and `isAnonymous`.
+ */
+interface EveSessionAuth {
+  readonly authenticator: string;
+  readonly principalType: string;
+  readonly principalId: string;
+  readonly issuer?: string;
+  readonly subject?: string;
+  readonly attributes: Readonly<Record<string, string | readonly string[]>>;
+}
+/** The session part of the context eve passes to hooks, memory and connections. */
+interface EveSessionContext {
+  readonly session: {
+    readonly id: string;
+    readonly auth: {
+      readonly current: EveSessionAuth | null;
+      readonly initiator?: EveSessionAuth | null;
+    };
+  };
+}
+//#endregion
+//#region src/eve/eve.d.ts
+/** Eve's `MemoryDocumentConflictError`, matched by name. */
+declare class MemoryDocumentConflictError extends Error {
+  override readonly name = "MemoryDocumentConflictError";
+  readonly key: string;
+  constructor(key: string);
+}
+/** The backend eve's `fileMemory({ backend })` reads and writes. */
+interface EveDocumentBackend {
+  /** The document backend contract version. Omitted means 1. */
+  readonly apiVersion?: 1;
+  read(input: {
+    readonly key: string;
+    readonly signal?: AbortSignal;
+  }): Promise<{
+    readonly content: string;
+    readonly version: string;
+  } | null>;
+  write(input: {
+    readonly key: string;
+    readonly content: string;
+    readonly expectedVersion: string | null;
+    readonly signal?: AbortSignal;
+  }): Promise<{
+    readonly content: string;
+    readonly version: string;
+  }>;
+}
+interface SupabaseDocumentBackendOptions {
+  /** `createMemory` on a service transport. */
+  readonly memory: Memory;
+  /** Prefixes every key, so apps can share the table. Defaults to `eve`. */
+  readonly scope?: string;
+}
+/**
+ * A document backend for eve's `fileMemory()` over the memory module's
+ * `memory_documents` table. A write with a stale version throws
+ * `MemoryDocumentConflictError`, so eve retries with the current document.
+ */
+declare function supabaseDocumentBackend(options: SupabaseDocumentBackendOptions): EveDocumentBackend;
+interface EveMessagePart {
+  readonly type: string;
+  readonly text?: unknown;
+}
+interface EveModelMessage {
+  readonly role: string;
+  readonly content: string | readonly EveMessagePart[];
+}
+/** The context eve passes to a memory provider's `tools`. */
+interface EveMemoryToolsContext extends EveSessionContext {
+  readonly memory: {
+    readonly scope: {
+      readonly key: string;
+    };
+    readonly slot?: string;
+  };
+}
+/** The context eve passes to a memory provider's recall and capture handlers. */
+interface EveMemoryContext extends EveMemoryToolsContext {
+  readonly operationId: string;
+  readonly messages?: readonly EveModelMessage[];
+  readonly turn?: {
+    readonly id: string;
+    readonly input: readonly EveModelMessage[];
+    readonly sequence?: number;
+  } | null;
+  readonly abortSignal?: AbortSignal;
+}
+interface EveRecallMessage {
+  readonly id?: string;
+  readonly content: string;
+}
+interface EveRecallResult {
+  readonly messages: readonly EveRecallMessage[];
+}
+/**
+ * A provider for eve's `defineMemory({ provider })`; pass it through
+ * `defineMemoryProvider`.
+ */
+interface EveMemoryProvider {
+  readonly recall: {
+    "turn.started"(ctx: EveMemoryContext): Promise<EveRecallResult | null>;
+  };
+  readonly capture?: {
+    "turn.completed"?(ctx: EveMemoryContext): Promise<void>;
+  };
+  tools?(ctx: EveMemoryToolsContext): Promise<Readonly<Record<string, EveMemoryTool>> | null>;
+}
+/** A tool from eve's `defineTool`, as a memory provider returns it. */
+interface EveMemoryTool {
+  readonly description: string;
+  readonly inputSchema: unknown;
+  execute(input: never, context: never): unknown;
+}
+interface SupabaseMemoryOptions {
+  /**
+   * `createMemory` on a service transport: eve calls the provider outside a
+   * user request.
+   */
+  readonly memory: Memory;
+  /** Tenant documents to search alongside the memories. */
+  readonly knowledge?: Knowledge;
+  /**
+   * The knowledge scopes to search. Defaults to the tenant's shared documents:
+   * the provider searches as the service role, so a wider scope can show one
+   * user's documents to another.
+   */
+  readonly knowledgeScopes?: KnowledgeSearchOptions["scopes"];
+  /** Archival memories and knowledge chunks to recall per turn. Defaults to 5. */
+  readonly k?: number;
+  /** The tenant of a principal. Defaults to `attributes.tenantId`. */
+  readonly organizationOf?: (auth: EveSessionAuth) => string | undefined;
+  /**
+   * Facts to keep from a finished turn (an LLM call of yours). Without it the
+   * provider stores only what the model saves with its `remember` tool.
+   */
+  readonly extract?: (messages: readonly EveModelMessage[], ctx: EveMemoryContext) => Promise<readonly string[]>;
+  /** Adds the `remember` and `forget` tools. Defaults to true. */
+  readonly tools?: boolean;
+  /** Returns `eve/tools`; defaults to importing it on first use. */
+  readonly load?: () => Promise<unknown>;
+}
+/**
+ * An eve memory provider over the memory and knowledge blocks. Every read and
+ * write is partitioned by the scope key and the signed-in user; recall stores
+ * its answer under the operation id, so a replayed recall returns the same
+ * messages.
+ */
+declare function supabaseMemory(options: SupabaseMemoryOptions): EveMemoryProvider;
+//#endregion
+export { EveMemoryToolsContext as a, MemoryDocumentConflictError as c, supabaseDocumentBackend as d, supabaseMemory as f, EveMemoryTool as i, SupabaseDocumentBackendOptions as l, EveSessionContext as m, EveMemoryContext as n, EveRecallMessage as o, EveSessionAuth as p, EveMemoryProvider as r, EveRecallResult as s, EveDocumentBackend as t, SupabaseMemoryOptions as u };

package/dist/event-calendar-D3SVa3AE.d.ts

@@ -0,0 +1,65 @@
+/// <reference lib="esnext.temporal" />
+import { f as CalendarEvent, p as CalendarOccurrence } from "./availability-q3dZoZYM.js";
+//#region src/blocks/calendar/event-calendar.d.ts
+/**
+ * The event shape of a headless event calendar such as ReUI's Event Calendar
+ * (`CalendarEvent`), typed structurally: better-supabase imports no UI
+ * library.
+ */
+interface EventCalendarEvent<TData = unknown> {
+  readonly id: string;
+  readonly title: string;
+  readonly start: Date;
+  /** Exclusive. */
+  readonly end: Date;
+  readonly allDay?: boolean;
+  readonly recurringEventId?: string;
+  readonly originalStart?: Date;
+  readonly color?: string;
+  readonly readOnly?: boolean;
+  readonly resourceId?: string;
+  readonly data?: TData;
+}
+/** A row of a resource view (a person, room or calendar). */
+interface EventCalendarResource {
+  readonly id: string;
+  readonly title: string;
+  readonly color?: string;
+}
+interface EventCalendarOptions {
+  /** The resource an occurrence belongs to. Default its calendar id. */
+  readonly resourceOf?: (occurrence: CalendarOccurrence) => string | undefined;
+  /** Marks occurrences the user cannot move. */
+  readonly readOnly?: (occurrence: CalendarOccurrence) => boolean;
+}
+/**
+ * Occurrences as event calendar events. Each id is the occurrence key, so an
+ * overridden occurrence keeps its id; `data` carries the occurrence for
+ * `fromEventCalendarUpdate` and your own handlers.
+ */
+declare function toEventCalendarEvents(occurrences: readonly CalendarOccurrence[], options?: EventCalendarOptions): EventCalendarEvent<CalendarOccurrence>[];
+/** Calendars (or anything with an id and a name) as resources. */
+declare function toEventCalendarResources(items: readonly {
+  readonly id: string;
+  readonly name: string;
+  readonly color?: string;
+}[]): EventCalendarResource[];
+/** What a drag or resize asks for, in the shape `editOccurrence` takes. */
+interface OccurrenceMove {
+  readonly startsAt: Temporal.Instant;
+  readonly endsAt: Temporal.Instant;
+  readonly allDay?: boolean;
+}
+/**
+ * The new times of an `onEventUpdate` from an event calendar, for
+ * `calendar.editOccurrence(occurrence, move)` or `editFollowing`.
+ */
+declare function fromEventCalendarUpdate(update: {
+  readonly start: Date;
+  readonly end: Date;
+  readonly allDay?: boolean;
+}): OccurrenceMove;
+/** The series of an occurrence, or the event itself. */
+declare const seriesOf: (occurrence: CalendarOccurrence) => CalendarEvent;
+//#endregion
+export { fromEventCalendarUpdate as a, toEventCalendarResources as c, OccurrenceMove as i, EventCalendarOptions as n, seriesOf as o, EventCalendarResource as r, toEventCalendarEvents as s, EventCalendarEvent as t };

package/dist/event-map-CtPFhcOp.js

@@ -0,0 +1,19 @@
+//#region src/core/event-map.ts
+/** The event `type` and its data type `T`, for `defineEvents`. */
+function event() {
+	return {};
+}
+/**
+* Declares events by type, so blocks, `defineBlocks` and `onBlockEvent` type
+* their data: `defineEvents({ "invoice.sent": event<{ invoiceId: string }>()
+* })`.
+*/
+function defineEvents(spec) {
+	return { types: Object.keys(spec) };
+}
+/** Several `Events` as one, such as a block's events and the app's own. */
+function mergeEvents(...events) {
+	return { types: [...new Set(events.flatMap((each) => each.types))] };
+}
+//#endregion
+export { event as n, mergeEvents as r, defineEvents as t };

package/dist/events/index.d.ts

@@ -1,4 +1,5 @@
-import { $ as SaasEventData, A as CollaborationEventData, B as FormEventData, C as BillingEventData, Ct as EventSpec, D as BlockEventPattern, Dt as event, E as BlockEventMeta, Et as defineEvents, F as CredentialEventData, G as InviteCodeEventData, H as InboxEventData, I as DataExportEventData, J as NotificationEventData, K as LegalHoldEventData, M as CommerceEventData, N as CommerceSubjectEventData, O as BlockEventType, Ot as mergeEvents, P as ConnectorEventData, Q as PushDeviceEventData, S as BLOCK_EVENT_RENAMES, St as EventMapOf, T as BlockEvent, Tt as MergedEventMap, U as IncomingWebhookEventData, V as FormSubmissionEventData, W as InvitationEventData, X as OrganizationDomainEventData, Y as OrganizationDeletionEventData, Z as OrganizationEventData, _ as AnnouncementEventData, _t as WorkflowRunEventData, at as SsoProviderEventData, b as AuditRevealEventData, bt as onBlockEvent, ct as SubjectEventType, dt as TemplateEventData, et as SaasSubjectEventData, ft as TimeEntryEventData, g as AiToolEventData, gt as WorkflowEventData, h as AiProviderKeyEventData, ht as WebhookEventData, it as SignatureEventData, j as CommentEventData, k as BlockEventsMatching, lt as SupportEventData, m as AiChatEventData, mt as WaitlistEventData, nt as ScimEventData, ot as StorageObjectEventData, p as AgentEventData, pt as TimesheetEventData, q as NotificationDeliveryEventData, rt as SettingEventData, st as SubjectEventData, tt as SchedulingEventData, ut as TemplateApplicationEventData, v as ApiKeyEventData, vt as blockEventAttributes, w as BlockEmit, wt as Events, x as BLOCK_ATTRIBUTES, xt as EventMap, y as AttachmentEventData, yt as emitBlockEvent, z as FlagEventData } from "../events-P3raDX2E.js";
-import { C as QuoteEventData, S as PipelineStageEventData, T as WorkItemEventData, _ as EngagementEventData, a as RowEventData, b as PartyEventData, c as httpSink, d as toHttp, f as ApplicationEventData, g as EmployeeEventData, h as DealEventData, i as ROW_EVENT_TYPES, l as isCloudEvent, m as CollectionEventData, n as HttpMode, o as forwardMutations, p as CollectionEntryEventData, r as HttpSinkOptions, s as fromHttp, t as ForwardOptions, u as toCloudEvents, v as InvoiceEventData, w as SlaEventData, x as PipelineEventData, y as JobEventData } from "../index-BpyBH5O2.js";
-import { a as ForwardBlockOptions, i as EventSink, n as CloudEventOptions, o as blockCloudEvent, r as DataschemaContext, s as forwardBlockEvents, t as CloudEvent } from "../cloud-event-DXkNoI6v.js";
-export { type AgentEventData, type AiChatEventData, type AiProviderKeyEventData, type AiToolEventData, type AnnouncementEventData, type ApiKeyEventData, type ApplicationEventData, type AttachmentEventData, type AuditRevealEventData, BLOCK_ATTRIBUTES, BLOCK_EVENT_RENAMES, type BillingEventData, type BlockEmit, type BlockEvent, type BlockEventMeta, type BlockEventPattern, type BlockEventType, type BlockEventsMatching, type CloudEvent, type CloudEventOptions, type CollaborationEventData, type CollectionEntryEventData, type CollectionEventData, type CommentEventData, type CommerceEventData, type CommerceSubjectEventData, type ConnectorEventData, type CredentialEventData, type DataExportEventData, type DataschemaContext, type DealEventData, type EmployeeEventData, type EngagementEventData, type EventMap, type EventMapOf, type EventSink, type EventSpec, type Events, type FlagEventData, type FormEventData, type FormSubmissionEventData, type ForwardBlockOptions, ForwardOptions, HttpMode, HttpSinkOptions, type InboxEventData, type IncomingWebhookEventData, type InvitationEventData, type InviteCodeEventData, type InvoiceEventData, type JobEventData, type LegalHoldEventData, type MergedEventMap, type NotificationDeliveryEventData, type NotificationEventData, type OrganizationDeletionEventData, type OrganizationDomainEventData, type OrganizationEventData, type PartyEventData, type PipelineEventData, type PipelineStageEventData, type PushDeviceEventData, type QuoteEventData, ROW_EVENT_TYPES, RowEventData, type SaasEventData, type SaasSubjectEventData, type SchedulingEventData, type ScimEventData, type SettingEventData, type SignatureEventData, type SlaEventData, type SsoProviderEventData, type StorageObjectEventData, type SubjectEventData, type SubjectEventType, type SupportEventData, type TemplateApplicationEventData, type TemplateEventData, type TimeEntryEventData, type TimesheetEventData, type WaitlistEventData, type WebhookEventData, type WorkItemEventData, type WorkflowEventData, type WorkflowRunEventData, blockCloudEvent, blockEventAttributes, defineEvents, emitBlockEvent, event, forwardBlockEvents, forwardMutations, fromHttp, httpSink, isCloudEvent, mergeEvents, onBlockEvent, toCloudEvents, toHttp };
+import { $ as SaasEventData, A as CollaborationEventData, B as FormEventData, C as BillingEventData, Ct as Events, D as BlockEventPattern, Dt as mergeEvents, E as BlockEventMeta, Et as event, F as DataExportEventData, G as InviteCodeEventData, H as InboxEventData, J as NotificationEventData, K as LegalHoldEventData, M as CommerceSubjectEventData, N as ConnectorEventData, O as BlockEventType, P as CredentialEventData, Q as PushDeviceEventData, S as BLOCK_EVENT_RENAMES, St as EventSpec, T as BlockEvent, Tt as defineEvents, U as IncomingWebhookEventData, V as FormSubmissionEventData, W as InvitationEventData, X as OrganizationDomainEventData, Y as OrganizationDeletionEventData, Z as OrganizationEventData, _ as AnnouncementEventData, _t as WorkflowRunEventData, at as SsoProviderEventData, b as AuditRevealEventData, bt as EventMap, ct as SubjectEventType, dt as TemplateEventData, et as SaasSubjectEventData, ft as TimeEntryEventData, g as AiToolEventData, gt as WorkflowEventData, h as AiProviderKeyEventData, ht as WebhookEventData, it as SignatureEventData, j as CommerceEventData, k as BlockEventsMatching, lt as SupportEventData, m as AiChatEventData, mt as WaitlistEventData, nt as ScimEventData, ot as StorageObjectEventData, p as AgentEventData, pt as TimesheetEventData, q as NotificationDeliveryEventData, rt as SettingEventData, st as SubjectEventData, tt as SchedulingEventData, ut as TemplateApplicationEventData, v as ApiKeyEventData, vt as blockEventAttributes, w as BlockEmit, wt as MergedEventMap, x as BLOCK_ATTRIBUTES, xt as EventMapOf, y as AttachmentEventData, yt as emitBlockEvent, z as FlagEventData } from "../events-DbLjvxDX.js";
+import { a as RowEventData, c as httpSink, d as toHttp, f as onBlockEvent, i as ROW_EVENT_TYPES, l as isCloudEvent, n as HttpMode, o as forwardMutations, r as HttpSinkOptions, s as fromHttp, t as ForwardOptions, u as toCloudEvents } from "../index-D4420jLW.js";
+import { C as SavedItemEventData, D as WorkItemEventData, E as SlaEventData, S as QuoteEventData, T as SegmentMemberEventData, _ as MailTrackingEventData, a as CollectionEventData, b as PipelineEventData, c as EmployeeEventData, d as EnrichmentEventData, f as ForecastSnapshotEventData, g as MailMessageEventData, h as MailAccountEventData, i as CollectionEntryEventData, l as EngagementEventData, m as JobEventData, n as AssignmentEventData, p as InvoiceEventData, s as DealEventData, t as ApplicationEventData, u as EngagementRecordingEventData, w as SegmentEventData, x as PipelineStageEventData, y as PartyEventData } from "../block-events-records-BGVyoz57.js";
+import { a as ForwardBlockOptions, i as EventSink, n as CloudEventOptions, o as blockCloudEvent, r as DataschemaContext, s as forwardBlockEvents, t as CloudEvent } from "../cloud-event-SPyXMdcd.js";
+export { type AgentEventData, type AiChatEventData, type AiProviderKeyEventData, type AiToolEventData, type AnnouncementEventData, type ApiKeyEventData, type ApplicationEventData, type AssignmentEventData, type AttachmentEventData, type AuditRevealEventData, BLOCK_ATTRIBUTES, BLOCK_EVENT_RENAMES, type BillingEventData, type BlockEmit, type BlockEvent, type BlockEventMeta, type BlockEventPattern, type BlockEventType, type BlockEventsMatching, type CloudEvent, type CloudEventOptions, type CollaborationEventData, type CollectionEntryEventData, type CollectionEventData, type CommerceEventData, type CommerceSubjectEventData, type ConnectorEventData, type CredentialEventData, type DataExportEventData, type DataschemaContext, type DealEventData, type EmployeeEventData, type EngagementEventData, type EngagementRecordingEventData, type EnrichmentEventData, type EventMap, type EventMapOf, type EventSink, type EventSpec, type Events, type FlagEventData, type ForecastSnapshotEventData, type FormEventData, type FormSubmissionEventData, type ForwardBlockOptions, ForwardOptions, HttpMode, HttpSinkOptions, type InboxEventData, type IncomingWebhookEventData, type InvitationEventData, type InviteCodeEventData, type InvoiceEventData, type JobEventData, type LegalHoldEventData, type MailAccountEventData, type MailMessageEventData, type MailTrackingEventData, type MergedEventMap, type NotificationDeliveryEventData, type NotificationEventData, type OrganizationDeletionEventData, type OrganizationDomainEventData, type OrganizationEventData, type PartyEventData, type PipelineEventData, type PipelineStageEventData, type PushDeviceEventData, type QuoteEventData, ROW_EVENT_TYPES, RowEventData, type SaasEventData, type SaasSubjectEventData, type SavedItemEventData, type SchedulingEventData, type ScimEventData, type SegmentEventData, type SegmentMemberEventData, type SettingEventData, type SignatureEventData, type SlaEventData, type SsoProviderEventData, type StorageObjectEventData, type SubjectEventData, type SubjectEventType, type SupportEventData, type TemplateApplicationEventData, type TemplateEventData, type TimeEntryEventData, type TimesheetEventData, type WaitlistEventData, type WebhookEventData, type WorkItemEventData, type WorkflowEventData, type WorkflowRunEventData, blockCloudEvent, blockEventAttributes, defineEvents, emitBlockEvent, event, forwardBlockEvents, forwardMutations, fromHttp, httpSink, isCloudEvent, mergeEvents, onBlockEvent, toCloudEvents, toHttp };

package/dist/events/index.js

@@ -1,8 +1,9 @@
-import { s as nowInstant } from "../temporal-CB5Fpo5d.js";
-import { i as forwardBlockEvents, n as blockCloudEvent, r as dataschemaOf } from "../cloud-event-CTh9Sr5w.js";
-import { t as jsonReplacer } from "../json-CEnpTHlZ.js";
-import { n as event, r as mergeEvents, t as defineEvents } from "../event-map-Dy2vKHai.js";
-import { a as emitBlockEvent, i as blockEventAttributes, n as BLOCK_EVENT_RENAMES, o as onBlockEvent, t as BLOCK_ATTRIBUTES } from "../block-events-DD9Q_NUz.js";
+import { s as nowInstant } from "../temporal-DLZlWbOi.js";
+import { t as onBlockEvent } from "../block-event-listener-Bu6G0TFH.js";
+import { i as forwardBlockEvents, n as blockCloudEvent, r as dataschemaOf } from "../cloud-event-XsM53POL.js";
+import { t as jsonReplacer } from "../json-DaByVJpw.js";
+import { n as event, r as mergeEvents, t as defineEvents } from "../event-map-CtPFhcOp.js";
+import { a as emitBlockEvent, i as blockEventAttributes, n as BLOCK_EVENT_RENAMES, t as BLOCK_ATTRIBUTES } from "../block-events-pBXPzwnW.js";
 //#region src/events/index.ts
 const ROW_EVENT_TYPES = {
 	insert: "dev.better-supabase.row.created",
@@ -21,9 +22,9 @@ function subjectOf(meta, table, row) {
 /**
 * One CloudEvent per mutated row: `dev.better-supabase.row.created` with the
 * app-cased row and the actor in `data`, the primary key as `subject` and the
-* tenant as `partitionkey`. Writes that return no rows (soft
-* deletes, `returning: false`) send one event per known primary key, with the
-* key as `row`.
+* tenant as `partitionkey`. Writes that return no rows (soft deletes,
+* `returning: false`) send one event per known primary key, with the key as
+* `row`.
 */
 function toCloudEvents(notice, options) {
 	const intent = notice.intent ?? notice.kind;
@@ -59,8 +60,8 @@ function toCloudEvents(notice, options) {
 /**
 * Sends a CloudEvent for every mutation to `sink`. Returns a function that
 * stops forwarding. Sends in flight are tracked on `betterSupabase.events`
-* (`settled()`), which the Next adapter hands to `after()` and the edge
-* entry to `waitUntil`. Use an outbox (SQL modules) when events must not be lost.
+* (`settled()`), which the Next adapter hands to `after()` and the edge entry
+* to `waitUntil`. Use an outbox (SQL modules) when events must not be lost.
 */
 function forwardMutations(betterSupabase, sink, options) {
 	return betterSupabase.events.on("mutation", (notice) => {

package/dist/events-D6IZ5CE8.js

@@ -0,0 +1,82 @@
+import { n as deepFreeze, t as cloneValue } from "./clone-CkG0-hlI.js";
+import { t as consoleLogger } from "./logger-glM28NVN.js";
+//#region src/core/events.ts
+/**
+* The `error` event for `error`: a frozen copy, so a handler can't change the
+* `DbError` the caller gets back (invariant 5).
+*/
+function errorEvent(error, table) {
+	const copy = deepFreeze(cloneValue(error));
+	return table === void 0 ? { error: copy } : {
+		table,
+		error: copy
+	};
+}
+/** More handlers than this for one event usually means a missing unsubscribe. */
+const HANDLER_WARNING = 50;
+function isDevelopment() {
+	return typeof process !== "undefined" && process.env["NODE_ENV"] !== "production";
+}
+/**
+* Observers only: a handler that throws is reported to the logger and never
+* changes a result.
+*/
+var EventHub = class {
+	#handlers = /* @__PURE__ */ new Map();
+	#warned = /* @__PURE__ */ new Set();
+	#pending = /* @__PURE__ */ new Set();
+	logger;
+	/** The definition's `now` option; block events take their `time` from it. */
+	now;
+	constructor(logger = consoleLogger, now) {
+		this.logger = logger;
+		this.now = now;
+	}
+	on(name, handler) {
+		let set = this.#handlers.get(name);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.#handlers.set(name, set);
+		}
+		set.add(handler);
+		if (set.size > HANDLER_WARNING && !this.#warned.has(name) && isDevelopment()) {
+			this.#warned.add(name);
+			this.logger.warn(`${set.size} "${name}" handlers are registered; call the function on() returns to remove one you no longer need`);
+		}
+		return () => {
+			set.delete(handler);
+		};
+	}
+	has(name) {
+		return (this.#handlers.get(name)?.size ?? 0) > 0;
+	}
+	/**
+	* Keeps async work a handler started (a sink send) until it settles, so
+	* adapters can hand it to `after()` or `waitUntil`. Its outcome is ignored:
+	* handlers report their own failures.
+	*/
+	track(work) {
+		const settled = Promise.resolve(work).then(() => void 0, () => void 0);
+		this.#pending.add(settled);
+		settled.then(() => this.#pending.delete(settled));
+	}
+	/** Whether tracked work is still running. */
+	get pending() {
+		return this.#pending.size > 0;
+	}
+	/** Resolves once the work tracked so far has settled. Never rejects. */
+	async settled() {
+		await Promise.all(this.#pending);
+	}
+	emit(name, event) {
+		const set = this.#handlers.get(name);
+		if (!set) return;
+		for (const handler of set) try {
+			handler(event);
+		} catch (cause) {
+			this.logger.error(`"${name}" handler threw`, { cause });
+		}
+	}
+};
+//#endregion
+export { errorEvent as n, EventHub as t };