better-supabase 0.13.0 → 0.14.0

package/dist/eve/index.js

@@ -1,8 +1,8 @@
-import { t as DbException } from "../db-exception-CnWcYPxL.js";
+import { t as DbException } from "../db-exception-Lngc1W49.js";
 import { n as isRecord } from "../guards-6F2bCtQR.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 { r as resolveAuth } from "../resolve-DAYdcs22.js";
+import { t as isAnonymousUser } from "../view-BtgqxQLM.js";
 import { t as importOptionalPeer } from "../optional-peer-C1NbBRJm.js";
 //#region src/eve/ids.ts
 /**

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/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-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 };
+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-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, o as onBlockEvent, t as BLOCK_ATTRIBUTES } from "../block-events-BURaqwyp.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",