better-supabase 0.11.0 → 0.13.0

package/dist/escape-like-DuKupGUV.d.ts

@@ -0,0 +1,15 @@
+import { b as DbError, x as DbErrorKind } from "./result-mijqfoJN.js";
+//#region src/core/db-exception.d.ts
+/** Thrown by `.orThrow()`. Carries the plain `DbError` as `error`. */
+declare class DbException extends Error {
+  override readonly name = "DbException";
+  readonly error: DbError;
+  constructor(error: DbError);
+  get kind(): DbErrorKind;
+}
+//#endregion
+//#region src/ir/escape-like.d.ts
+/** Escapes LIKE wildcards so user input matches literally. */
+declare function escapeLike(value: string): string;
+//#endregion
+export { DbException as n, escapeLike as t };

package/dist/eve/index.d.ts

@@ -1,10 +1,13 @@
-import { a as ResolveAuthOptions, r as AuthState } from "../resolve-Bqb8TMTt.js";
-import { i as CredentialRef, r as CredentialProvider } from "../provider-CNs0Jx0I.js";
-import { i as AiChat } from "../ai-chat-D-2MH1sU.js";
-import { a as Inbox } from "../inbox-Du5aPwKB.js";
-import { a as EveMemoryToolsContext, c as MemoryDocumentConflictError, d as supabaseDocumentBackend, f as supabaseMemory, i as EveMemoryTool, l as SupabaseDocumentBackendOptions, m as EveSessionContext, n as EveMemoryContext, o as EveRecallMessage, p as EveSessionAuth, r as EveMemoryProvider, s as EveRecallResult, t as EveDocumentBackend, u as SupabaseMemoryOptions } from "../eve-C_Onyk_j.js";
+import { a as ResolveAuthOptions, r as AuthState } from "../resolve-D57oDWNr.js";
+import { i as CredentialRef, r as CredentialProvider } from "../provider-Dmsbl8ug.js";
+import { i as AiChat } from "../ai-chat-B00sIOjY.js";
+import { a as Inbox } from "../inbox-CLsIrPXs.js";
+import { a as EveMemoryToolsContext, c as MemoryDocumentConflictError, d as supabaseDocumentBackend, f as supabaseMemory, i as EveMemoryTool, l as SupabaseDocumentBackendOptions, m as EveSessionContext, n as EveMemoryContext, o as EveRecallMessage, p as EveSessionAuth, r as EveMemoryProvider, s as EveRecallResult, t as EveDocumentBackend, u as SupabaseMemoryOptions } from "../eve-dWNqpd9Z.js";
 //#region src/eve/auth.d.ts
-/** Thrown by `supabaseAuth` so eve answers with `response` instead of downgrading to anonymous. */
+/**
+ * Thrown by `supabaseAuth` so eve answers with `response` instead of
+ * downgrading to anonymous.
+ */
 export declare class EveAuthRejection extends Error {
   override readonly name = "EveAuthRejection";
   readonly response: Response;
@@ -13,7 +16,10 @@ export declare class EveAuthRejection extends Error {
 interface SupabaseAuthOptions extends Omit<ResolveAuthOptions, "refresh" | "leeway" | "refreshTimeoutMs"> {
   /** The tenant claim, `config.claims.tenant`. Defaults to `tenant_id`. */
   readonly tenantClaim?: string;
-  /** The memberships claim, `config.claims.memberships`. Defaults to `memberships`. */
+  /**
+   * The memberships claim, `config.claims.memberships`. Defaults to
+   * `memberships`.
+   */
   readonly membershipsClaim?: string;
   /** Extra attributes from the verified claims, merged over the defaults. */
   readonly attributes?: (claims: Readonly<Record<string, unknown>>) => Readonly<Record<string, string | readonly string[]>>;
@@ -28,7 +34,7 @@ export declare function principalOf(auth: AuthState, options?: Pick<SupabaseAuth
 export declare function supabaseAuth(options: SupabaseAuthOptions): (request: Request) => Promise<EveSessionAuth | null>;
 //#endregion
 //#region src/eve/connections.d.ts
-/** eve's `ConnectionAuthorizationRequiredError`, matched by name. */
+/** Eve's `ConnectionAuthorizationRequiredError`, matched by name. */
 export declare class ConnectionAuthorizationRequiredError extends Error {
   override readonly name = "ConnectionAuthorizationRequiredError";
   readonly connectionName: string;
@@ -36,7 +42,7 @@ export declare class ConnectionAuthorizationRequiredError extends Error {
     readonly message?: string;
   });
 }
-/** eve's `ConnectionAuthorizationFailedError`, matched by name. */
+/** Eve's `ConnectionAuthorizationFailedError`, matched by name. */
 export declare class ConnectionAuthorizationFailedError extends Error {
   override readonly name = "ConnectionAuthorizationFailedError";
   readonly connectionName: string;
@@ -110,19 +116,25 @@ interface CredentialAuthOptions {
   /** The connection's name in errors. Defaults to the ref's provider. */
   readonly connection?: string;
   readonly scopes?: readonly string[];
-  /** For `user`: let eve send the user to connect the account when the provider can. Defaults to true. */
+  /**
+   * For `user`: let eve send the user to connect the account when the provider
+   * can. Defaults to true.
+   */
   readonly interactive?: boolean;
 }
 /**
- * An eve connection `authorization` over a better-supabase
- * `CredentialProvider` (Vault, Vercel Connect or your own): tokens come from
- * the provider for the app or for the session's user. A user without a stored
- * credential gets eve's authorization flow when the provider supports one.
+ * An eve connection `authorization` over a better-supabase `CredentialProvider`
+ * (Vault, Vercel Connect or your own): tokens come from the provider for the
+ * app or for the session's user. A user without a stored credential gets eve's
+ * authorization flow when the provider supports one.
  */
 export declare function credentialAuth(options: CredentialAuthOptions): EveConnectionAuthorization;
 //#endregion
 //#region src/eve/ids.d.ts
-/** A UUID (version 8) from the SHA-256 of `input`, so the same input always gets the same id. */
+/**
+ * A UUID (version 8) from the SHA-256 of `input`, so the same input always gets
+ * the same id.
+ */
 export declare function stableUuid(input: string): Promise<string>;
 //#endregion
 //#region src/eve/inbox.d.ts
@@ -153,7 +165,10 @@ interface EveChatSdkBridge<T extends EveChatThread = EveChatThread> {
 interface RouteInboxOptions {
   /** `createInbox` on a service transport. */
   readonly inbox: Inbox;
-  /** The session title for a new conversation. Defaults to the conversation's subject. */
+  /**
+   * The session title for a new conversation. Defaults to the conversation's
+   * subject.
+   */
   readonly title?: string;
 }
 /**
@@ -206,14 +221,17 @@ interface PersistSessionsOptions {
   /** The title of a new chat. Defaults to `eve session`. */
   readonly title?: string;
 }
-/** The `ai_chats` id of an eve session: the same session always maps to the same chat. */
+/**
+ * The `ai_chats` id of an eve session: the same session always maps to the same
+ * chat.
+ */
 export declare function chatIdOf(sessionId: string): Promise<string>;
 /**
- * Hook handlers that copy an eve session into the canonical chat tables, so
- * the chat UI, search, memory recall and analytics read eve sessions like any
- * other chat. Every write is keyed by the event, so eve's at-least-once
- * delivery stores each message once. Sessions without a signed-in user and
- * tenant are skipped.
+ * Hook handlers that copy an eve session into the canonical chat tables, so the
+ * chat UI, search, memory recall and analytics read eve sessions like any other
+ * chat. Every write is keyed by the event, so eve's at-least-once delivery
+ * stores each message once. Sessions without a signed-in user and tenant are
+ * skipped.
  */
 export declare function persistSessions(options: PersistSessionsOptions): EveSessionHooks;
 //#endregion

package/dist/eve/index.js

@@ -1,11 +1,14 @@
 import { t as DbException } from "../db-exception-CnWcYPxL.js";
 import { n as isRecord } from "../guards-6F2bCtQR.js";
-import { a as tenantClaimPaths, n as claimAt, t as DEFAULT_CLAIMS } from "../claims-PqzCxaTD.js";
-import { r as resolveAuth } from "../resolve-f8QNuYI3.js";
-import { t as isAnonymousUser } from "../view-CYX1wsgp.js";
-import { t as importOptionalPeer } from "../optional-peer-Dx8TaYXw.js";
+import { a as tenantClaimPaths, n as claimAt, t as DEFAULT_CLAIMS } from "../claims-Bp9My7XP.js";
+import { r as resolveAuth } from "../resolve-sy3_Gz0i.js";
+import { t as isAnonymousUser } from "../view-CfUd5vI9.js";
+import { t as importOptionalPeer } from "../optional-peer-C1NbBRJm.js";
 //#region src/eve/ids.ts
-/** A UUID (version 8) from the SHA-256 of `input`, so the same input always gets the same id. */
+/**
+* A UUID (version 8) from the SHA-256 of `input`, so the same input always gets
+* the same id.
+*/
 async function stableUuid(input) {
 	const bytes = new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(input))).slice(0, 16);
 	bytes[6] = (bytes[6] ?? 0) & 15 | 128;
@@ -15,7 +18,10 @@ async function stableUuid(input) {
 }
 //#endregion
 //#region src/eve/auth.ts
-/** Thrown by `supabaseAuth` so eve answers with `response` instead of downgrading to anonymous. */
+/**
+* Thrown by `supabaseAuth` so eve answers with `response` instead of
+* downgrading to anonymous.
+*/
 var EveAuthRejection = class extends Error {
 	name = "EveAuthRejection";
 	response;
@@ -69,7 +75,7 @@ function supabaseAuth(options) {
 }
 //#endregion
 //#region src/eve/connections.ts
-/** eve's `ConnectionAuthorizationRequiredError`, matched by name. */
+/** Eve's `ConnectionAuthorizationRequiredError`, matched by name. */
 var ConnectionAuthorizationRequiredError = class extends Error {
 	name = "ConnectionAuthorizationRequiredError";
 	connectionName;
@@ -78,7 +84,7 @@ var ConnectionAuthorizationRequiredError = class extends Error {
 		this.connectionName = connectionName;
 	}
 };
-/** eve's `ConnectionAuthorizationFailedError`, matched by name. */
+/** Eve's `ConnectionAuthorizationFailedError`, matched by name. */
 var ConnectionAuthorizationFailedError = class extends Error {
 	name = "ConnectionAuthorizationFailedError";
 	connectionName;
@@ -107,10 +113,10 @@ function connectionError(name, error) {
 	return new DbException(error);
 }
 /**
-* An eve connection `authorization` over a better-supabase
-* `CredentialProvider` (Vault, Vercel Connect or your own): tokens come from
-* the provider for the app or for the session's user. A user without a stored
-* credential gets eve's authorization flow when the provider supports one.
+* An eve connection `authorization` over a better-supabase `CredentialProvider`
+* (Vault, Vercel Connect or your own): tokens come from the provider for the
+* app or for the session's user. A user without a stored credential gets eve's
+* authorization flow when the provider supports one.
 */
 function credentialAuth(options) {
 	const name = options.connection ?? options.ref.provider;
@@ -210,17 +216,20 @@ function routeInbox(bridge, options) {
 }
 //#endregion
 //#region src/eve/sessions.ts
-/** The `ai_chats` id of an eve session: the same session always maps to the same chat. */
+/**
+* The `ai_chats` id of an eve session: the same session always maps to the same
+* chat.
+*/
 function chatIdOf(sessionId) {
 	return stableUuid(`eve-session:${sessionId}`);
 }
 const streamOf = (sessionId, turnId) => `eve:${sessionId}:${turnId}`;
 /**
-* Hook handlers that copy an eve session into the canonical chat tables, so
-* the chat UI, search, memory recall and analytics read eve sessions like any
-* other chat. Every write is keyed by the event, so eve's at-least-once
-* delivery stores each message once. Sessions without a signed-in user and
-* tenant are skipped.
+* Hook handlers that copy an eve session into the canonical chat tables, so the
+* chat UI, search, memory recall and analytics read eve sessions like any other
+* chat. Every write is keyed by the event, so eve's at-least-once delivery
+* stores each message once. Sessions without a signed-in user and tenant are
+* skipped.
 */
 function persistSessions(options) {
 	const { chats } = options;
@@ -306,7 +315,7 @@ function persistSessions(options) {
 }
 //#endregion
 //#region src/eve/eve.ts
-/** eve's `MemoryDocumentConflictError`, matched by name. */
+/** Eve's `MemoryDocumentConflictError`, matched by name. */
 var MemoryDocumentConflictError = class extends Error {
 	name = "MemoryDocumentConflictError";
 	key;
@@ -346,16 +355,16 @@ function textOfMessage(message) {
 }
 const isToolsModule = (value) => isRecord(value) && typeof value["defineTool"] === "function";
 /**
-* Loads `eve/tools` when the provider first builds its tools. The specifier
-* is a variable so bundlers leave the optional peer out.
+* Loads `eve/tools` when the provider first builds its tools. The specifier is
+* a variable so bundlers leave the optional peer out.
 */
 const loadTools = () => importOptionalPeer("eve/tools");
 const isRecallResult = (value) => isRecord(value) && Array.isArray(value["messages"]) && value["messages"].every((message) => isRecord(message) && typeof message["content"] === "string");
 /**
-* 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.
+* 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.
 */
 function supabaseMemory(options) {
 	const { memory } = options;

package/dist/eve-dWNqpd9Z.d.ts

@@ -0,0 +1,157 @@
+import { d as KnowledgeSearchOptions, r as Knowledge } from "./knowledge-CYdNJasZ.js";
+import { t as Memory } from "./types-EUrisY2U.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-E6AI-dgg.d.ts

@@ -0,0 +1,217 @@
+/// <reference lib="esnext.temporal" />
+//#region src/blocks/calendar/ics.d.ts
+/** How an attendee takes part (RFC 5545 `ROLE`), in lowercase. */
+type AttendeeRole = "chair" | "required" | "optional" | "non-participant";
+/** An attendee's answer (RFC 5545 `PARTSTAT`), in lowercase. */
+type AttendeeResponse = "needs-action" | "accepted" | "declined" | "tentative";
+type CalendarEventStatus = "confirmed" | "tentative" | "cancelled";
+interface CalendarAttendee {
+  readonly email: string;
+  readonly name?: string;
+  readonly userId?: string;
+  readonly role: AttendeeRole;
+  readonly response: AttendeeResponse;
+}
+/** One `VEVENT`, ready for `importIcs` or `save`. */
+interface IcsEvent {
+  readonly uid: string;
+  readonly title: string;
+  readonly description?: string;
+  readonly location?: string;
+  readonly startsAt: Temporal.Instant;
+  /** Exclusive, as in `DTEND`. */
+  readonly endsAt: Temporal.Instant;
+  readonly allDay: boolean;
+  /** The IANA zone the event's wall-clock times and recurrence follow. */
+  readonly tz: string;
+  readonly status: CalendarEventStatus;
+  readonly rrule?: string;
+  readonly exdates: readonly Temporal.Instant[];
+  /** `RECURRENCE-ID`: the occurrence of the series this event overrides. */
+  readonly originalStart?: Temporal.Instant;
+  readonly attendees: readonly CalendarAttendee[];
+}
+interface ParsedIcs {
+  /** `X-WR-CALNAME`, when the file has one. */
+  readonly name?: string;
+  /** `X-WR-TIMEZONE`, else `UTC`: the zone of floating and all-day times. */
+  readonly tz: string;
+  readonly events: readonly IcsEvent[];
+  /** `VEVENT`s without a `UID` or `DTSTART`, which are left out. */
+  readonly skipped: number;
+}
+/**
+ * Reads an iCalendar file (RFC 5545): unfolds lines, unescapes TEXT values and
+ * reads each `VEVENT`'s times, recurrence (`RRULE`, `EXDATE`, `RECURRENCE-ID`)
+ * and attendees. Times in a zone Temporal does not know, floating times and
+ * dates use `X-WR-TIMEZONE`, else UTC.
+ */
+declare function parseIcs(text: string): ParsedIcs;
+/** The event fields `toIcs` writes. `CalendarEvent` has all of them. */
+interface IcsSource {
+  readonly uid: string;
+  readonly title: string;
+  readonly description?: string;
+  readonly location?: string;
+  readonly startsAt: Temporal.Instant;
+  readonly endsAt: Temporal.Instant;
+  readonly allDay: boolean;
+  readonly tz: string;
+  readonly status: CalendarEventStatus;
+  readonly rrule?: string;
+  readonly exdates: readonly Temporal.Instant[];
+  readonly originalStart?: Temporal.Instant;
+  readonly attendees?: readonly CalendarAttendee[];
+  readonly updatedAt?: Temporal.Instant;
+}
+interface ToIcsOptions {
+  readonly name?: string;
+  /** `X-WR-TIMEZONE`. */
+  readonly tz?: string;
+  readonly prodId?: string;
+  /** `DTSTAMP` for events without `updatedAt`. Default now. */
+  readonly now?: Temporal.Instant;
+}
+/**
+ * Writes events as an iCalendar file (RFC 5545): CRLF line ends, lines folded
+ * at 75 octets, escaped TEXT, and a `VTIMEZONE` for every zone a timed event
+ * uses, so recurrence keeps its wall-clock time across DST.
+ */
+declare function toIcs(events: readonly IcsSource[], options?: ToIcsOptions): string;
+//#endregion
+//#region src/blocks/calendar/occurrences.d.ts
+/** One row of `calendar_events`: a single event, a series or an override. */
+interface CalendarEvent {
+  readonly id: string;
+  readonly calendarId: string;
+  readonly uid: string;
+  readonly title: string;
+  readonly description?: string;
+  readonly location?: string;
+  readonly startsAt: Temporal.Instant;
+  /** Exclusive. */
+  readonly endsAt: Temporal.Instant;
+  readonly allDay: boolean;
+  readonly tz: string;
+  readonly status: CalendarEventStatus;
+  /** The RFC 5545 `RRULE` value of a series, without the `RRULE:` prefix. */
+  readonly rrule?: string;
+  readonly exdates: readonly Temporal.Instant[];
+  /** The series an override belongs to. */
+  readonly recurrenceId?: string;
+  /** The occurrence of the series an override replaces. */
+  readonly originalStart?: Temporal.Instant;
+  readonly subjectType?: string;
+  readonly subjectId?: string;
+  readonly color?: string;
+  readonly attendees: readonly CalendarAttendee[];
+  readonly updatedAt?: Temporal.Instant;
+}
+/** One occurrence in a range: a single event, or one instance of a series. */
+interface CalendarOccurrence {
+  /** `${seriesId}::${originalStart}`, stable across edits of the occurrence. */
+  readonly key: string;
+  /** The row the occurrence comes from: the event, the series or its override. */
+  readonly event: CalendarEvent;
+  /** The series, for an occurrence of one (also when it is overridden). */
+  readonly series?: CalendarEvent;
+  readonly start: Temporal.Instant;
+  readonly end: Temporal.Instant;
+  /** Where the series put this occurrence before any override moved it. */
+  readonly originalStart: Temporal.Instant;
+  readonly allDay: boolean;
+  readonly recurring: boolean;
+}
+interface OccurrenceRange {
+  readonly from: Temporal.Instant;
+  readonly until: Temporal.Instant;
+}
+interface OccurrenceOptions {
+  /** Keep cancelled events and occurrences. Default false. */
+  readonly includeCancelled?: boolean;
+}
+/**
+ * Expands events into the occurrences that overlap `[from, until)`. Series
+ * expand with the reminders block's `expandRule` in their own zone, so a weekly
+ * 09:00 meeting stays at 09:00 across DST. `EXDATE`s drop occurrences, and
+ * overrides replace the occurrence they name, also when they move it out of the
+ * range.
+ */
+declare function expandOccurrences(events: readonly CalendarEvent[], range: OccurrenceRange, options?: OccurrenceOptions): CalendarOccurrence[];
+/** The rules of a series split at one of its occurrences. */
+interface SplitRules {
+  /** The series up to the occurrence before `at`: `UNTIL` instead of `COUNT`. */
+  readonly before: string;
+  /** The series from `at` on: the remaining `COUNT`, or the old `UNTIL`. */
+  readonly after: string;
+}
+/**
+ * Splits a series for "this and following": the first rule ends one second
+ * before `at` (RFC 5545 forbids `COUNT` with `UNTIL`, so it drops `COUNT`), and
+ * the second keeps the occurrences that are left.
+ */
+declare function splitRule(rrule: string, dtstart: Temporal.ZonedDateTime, at: Temporal.Instant): SplitRules;
+//#endregion
+//#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 { ToIcsOptions as C, ParsedIcs as S, toIcs as T, AttendeeRole as _, fromEventCalendarUpdate as a, IcsEvent as b, toEventCalendarResources as c, OccurrenceOptions as d, OccurrenceRange as f, AttendeeResponse as g, splitRule as h, OccurrenceMove as i, CalendarEvent as l, expandOccurrences as m, EventCalendarOptions as n, seriesOf as o, SplitRules as p, EventCalendarResource as r, toEventCalendarEvents as s, EventCalendarEvent as t, CalendarOccurrence as u, CalendarAttendee as v, parseIcs as w, IcsSource as x, CalendarEventStatus as y };

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,4 @@
-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";
+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-DhGgwqQA.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-CE0p3st5.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-CidL9jiw.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 };