better-supabase 0.14.0 → 0.15.1

package/dist/bind-Dz8y3T5T.d.ts

@@ -1,95 +0,0 @@
-import { M as AnyFunctions, N as AnyModels } from "./executor-CPyrQdjh.js";
-import { o as BlockTenant } from "./block-helpers-BaugZlJV.js";
-import { o as Db, t as BetterSupabase } from "./define-Dw7pRO4h.js";
-import { cn as GeneratedBlocks } from "./define-block-COpcS6aT.js";
-import { nt as BetterQueries } from "./index-DbXWcrOI.js";
-import { t as ClientPorts } from "./ports-DsJicwI2.js";
-import { SupabaseClient } from "@supabase/supabase-js";
-//#region src/client/bind.d.ts
-interface AuthUser {
-  readonly id: string;
-  readonly email?: string;
-  readonly role?: string;
-}
-/**
- * What the UI needs to know. Claims are decoded, not verified: RLS enforces
- * access. A token refresh that changes only `exp`, `iat`, `nbf` or `jti` keeps
- * the previous snapshot, so read expiry from the session, not here.
- */
-type AuthSnapshot = {
-  readonly status: "loading";
-  readonly user: null;
-  readonly claims: null;
-} | {
-  readonly status: "signed-out";
-  readonly user: null;
-  readonly claims: null;
-} | {
-  readonly status: "signed-in";
-  readonly user: AuthUser;
-  readonly claims: Readonly<Record<string, unknown>>;
-};
-interface ClientAuth {
-  readonly current: () => AuthSnapshot;
-  /** `useSyncExternalStore`-compatible. */
-  readonly subscribe: (listener: () => void) => () => void;
-}
-interface BetterClient<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown> {
-  /**
-   * The definition the client was created from (schema metadata, specs, live
-   * queries).
-   */
-  readonly betterSupabase: BetterSupabase<M, unknown, F, E, C, P>;
-  readonly supabase: SupabaseClient;
-  /** Repositories with the current session's actor and claims. */
-  readonly db: Db<M, F, E, SupabaseClient>;
-  /** TanStack Query option factories over `db`. */
-  readonly queries: BetterQueries<M, E, F>;
-  readonly auth: ClientAuth;
-  /**
-   * The platform services block controllers use: storage, shortcuts, files,
-   * push, links.
-   */
-  readonly ports: ClientPorts;
-  /** `blockConfig` from `blocks.generated.ts`, when passed. */
-  readonly blocks?: GeneratedBlocks;
-  /**
-   * The tenant block hooks act in: the `tenant` option, or the session's tenant
-   * claim.
-   */
-  readonly tenant?: BlockTenant;
-  /**
-   * Stops following `supabase`'s session. Call it when the client goes away
-   * before the app does: Fast Refresh, tests, a client per account.
-   */
-  readonly dispose: () => void;
-}
-interface BindClientOptions {
-  /**
-   * `staleTime` for every query option in `queries`. Above zero, a remount or a
-   * window focus reuses cached rows instead of refetching them.
-   */
-  readonly staleTime?: number;
-  /**
-   * Platform services for the block hooks. React Native apps pass
-   * `nativePorts()` from `better-supabase/client/native`.
-   */
-  readonly ports?: ClientPorts;
-  /**
-   * `blockConfig` from `blocks.generated.ts`: the block hooks call the schema,
-   * function names and topics `gen` wrote.
-   */
-  readonly blocks?: GeneratedBlocks;
-  /**
-   * The tenant the block hooks act in. Default the session's tenant claim
-   * (`config.claims.tenant`); pass a function for a tenant picked in the UI.
-   */
-  readonly tenant?: BlockTenant;
-}
-/**
- * Repositories that follow `supabase`'s session, TanStack Query options and an
- * auth store, for a supabase-js client you created yourself.
- */
-declare function bindClient<M extends AnyModels, D, F extends AnyFunctions, E, C = unknown, P = unknown>(betterSupabase: BetterSupabase<M, D, F, E, C, P>, supabase: SupabaseClient, options?: BindClientOptions): BetterClient<M, F, E, C, P>;
-//#endregion
-export { ClientAuth as a, BindClientOptions as i, AuthUser as n, bindClient as o, BetterClient as r, AuthSnapshot as t };

package/dist/block-authors-BRTlT0qv.js

@@ -1,14 +0,0 @@
-import { n as isRecord } from "./guards-6F2bCtQR.js";
-import { C as optionalText } from "./block-helpers-CiKtrb6g.js";
-//#region src/core/block-authors.ts
-/** A row's `author` object as an `Author`, or `undefined`. */
-function authorOf(value) {
-	if (!isRecord(value) || typeof value["id"] !== "string") return;
-	return {
-		id: value["id"],
-		name: optionalText(value["name"]),
-		avatarUrl: optionalText(value["avatarUrl"] ?? value["avatar_url"])
-	};
-}
-//#endregion
-export { authorOf as t };

package/dist/block-controller-DTGuBemi.js

@@ -1,112 +0,0 @@
-import { t as defineController } from "./controller-BEliOBOv.js";
-import { t as onBlockEvent } from "./block-event-listener-Bu6G0TFH.js";
-import { n as methodOf } from "./block-method-Bvsao626.js";
-//#region src/bindings/field-errors.ts
-/** The first message per top-level field of a `validation` error. */
-function fieldErrorsOf(error) {
-	if (error?.kind !== "validation") return {};
-	const fields = {};
-	for (const issue of error.issues) {
-		const key = issue.path?.[0];
-		if (typeof key === "string" && fields[key] === void 0) fields[key] = issue.message;
-	}
-	return fields;
-}
-//#endregion
-//#region src/blocks/block-controller.ts
-/**
-* Calls one read method of a block client while the controller has listeners,
-* and again on `refetch` or a `refetchOn` event. Works for every block, renamed
-* or not.
-*/
-function createBlockQuery(client, method, args, options = {}) {
-	const call = methodOf(client, method);
-	return defineController({
-		status: "idle",
-		data: void 0,
-		error: void 0
-	}, (state) => {
-		const load = () => {
-			const run = state.run();
-			state.set({ status: "loading" });
-			Promise.resolve(call(...args)).then((result) => {
-				if (run !== state.run()) return;
-				state.set(result.ok ? {
-					status: "success",
-					data: result.data,
-					error: void 0
-				} : {
-					status: "error",
-					error: result.error
-				});
-			});
-		};
-		return {
-			actions: { refetch: load },
-			start: () => {
-				load();
-				const refetchOn = options.refetchOn;
-				if (refetchOn === void 0) return;
-				const types = new Set(refetchOn.types);
-				return refetchOn.source.events.on("block", (event) => {
-					if (types.has(event.type)) load();
-				});
-			}
-		};
-	});
-}
-/** Calls one write method of a block client and tracks its state. */
-function createBlockMutation(client, method) {
-	const call = methodOf(client, method);
-	const initial = {
-		status: "idle",
-		data: void 0,
-		error: void 0
-	};
-	return defineController(initial, (state) => {
-		let latest = 0;
-		return { actions: {
-			mutate: async (...args) => {
-				latest += 1;
-				const mine = latest;
-				state.set({
-					status: "pending",
-					error: void 0
-				});
-				const result = await call(...args);
-				if (mine === latest) state.set(result.ok ? {
-					status: "success",
-					data: result.data,
-					error: void 0
-				} : {
-					status: "error",
-					error: result.error
-				});
-				return result;
-			},
-			reset: () => {
-				latest += 1;
-				state.set(initial);
-			}
-		} };
-	});
-}
-/**
-* A stable key for a method's arguments, so a hook makes a new controller only
-* when they change. A `bigint` becomes its digits.
-*/
-function blockArgsKey(args) {
-	return JSON.stringify(args, (_key, value) => typeof value === "bigint" ? `${value.toString()}n` : value);
-}
-/**
-* Listens to the block events matching `pattern`, typed by `events`
-* (`blockEvents` from `blocks.generated.ts`), calling `handler()` for the
-* latest handler. Returns the function that stops listening.
-*/
-function listenToBlockEvents(source, events, pattern, handler) {
-	return onBlockEvent(source, events, pattern, (event) => {
-		handler()(event);
-	});
-}
-//#endregion
-export { fieldErrorsOf as a, listenToBlockEvents as i, createBlockMutation as n, createBlockQuery as r, blockArgsKey as t };

package/dist/block-env-DJiUu1fq.js

@@ -1,35 +0,0 @@
-import { t as currentTenant } from "./tenant-source-bqWpSr86.js";
-import { t as topicPort } from "./watch-topic-CuaWfCuv.js";
-//#region src/blocks/block-env.ts
-/**
-* The client's session and ports; the topic port defaults to its supabase-js
-* client.
-*/
-function blockEnv(client) {
-	return {
-		supabase: client.supabase,
-		auth: client.auth,
-		ports: {
-			...client.ports,
-			topic: client.ports?.topic ?? topicPort(client.supabase)
-		},
-		config: client.blocks,
-		tenant: () => currentTenant(client.tenant)
-	};
-}
-/**
-* Fills `auth` and `ports` from `env` when `options` leaves them out; `env`
-* runs only then. Without `env` the controller takes neither key.
-*/
-function withEnv(options, env) {
-	const given = new Map(Object.entries(options));
-	if (env === void 0 || given.get("auth") !== void 0 && given.get("ports") !== void 0) return options;
-	const { auth, ports } = env();
-	return {
-		auth,
-		ports,
-		...options
-	};
-}
-//#endregion
-export { withEnv as n, blockEnv as t };

package/dist/block-env-kFcaaJLM.d.ts

@@ -1,10 +0,0 @@
-import { SupabaseClient } from "@supabase/supabase-js";
-//#region src/blocks/block-env.d.ts
-type EnvKey = "auth" | "ports";
-/**
- * A controller's options as a binding takes them: `auth` and `ports` come from
- * the provider unless the caller passes its own.
- */
-type BlockOptions<O> = Omit<O, EnvKey> & Partial<Pick<O, Extract<keyof O, EnvKey>>>;
-//#endregion
-export { BlockOptions as t };

package/dist/block-env-options-2e6IQrSw.js

@@ -1,26 +0,0 @@
-import { H as rpcTransport } from "./block-helpers-CiKtrb6g.js";
-import { i as wrapTransport } from "./block-hooks-BymdcD0V.js";
-import { t as blockNames } from "./block-names-Dbv_2wmE.js";
-//#region src/blocks/block-env-options.ts
-/**
-* A block's transport and schema for a hook: the supabase-js client calls the
-* schema and the function names `gen` wrote for `block` in `blockConfig`, or
-* the module defaults when the client has no config.
-*/
-function envBlockOptions(env, block) {
-	const entry = env.config?.[block];
-	const transport = rpcTransport(env.supabase);
-	return {
-		transport: entry?.names === void 0 ? transport : wrapTransport(transport, blockNames(entry.names)),
-		...entry === void 0 ? {} : { schema: entry.api ?? entry.schema }
-	};
-}
-/**
-* The options `gen` wrote for `block`, such as the reactions `topic`; empty
-* when the client has no config.
-*/
-function envBlockSettings(env, block) {
-	return env.config?.[block]?.options ?? {};
-}
-//#endregion
-export { envBlockSettings as n, envBlockOptions as t };

package/dist/block-events-records-BGVyoz57.d.ts

@@ -1,343 +0,0 @@
-import { st as SubjectEventData } from "./events-DbLjvxDX.js";
-//#region src/core/block-events-records.d.ts
-/** Events from the parties module: a company, a person, or a link between them. */
-interface PartyEventData {
-  readonly organizationId: string;
-  readonly companyId?: string;
-  readonly personId?: string;
-  readonly name?: string;
-  /** For `*.merged`: the record merged into this one, now archived. */
-  readonly mergedId?: string;
-  /** For `company.person_*`: the person's role at the company. */
-  readonly role?: string | null;
-}
-/**
- * Events from the engagements module. `subjectType` and `subjectId` name the
- * engagement's main record; `subjects` lists every record it is on.
- */
-interface EngagementEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly engagementId: string;
-  /** `call`, `email`, `meeting`, `note`, `task` or a configured type. */
-  readonly type: string;
-  readonly subjects: readonly {
-    readonly type: string;
-    readonly id: string;
-  }[];
-}
-/** `engagement.recorded` and `engagement.transcribed`: a recording's turn. */
-interface EngagementRecordingEventData extends EngagementEventData {
-  readonly recordingId: string;
-}
-/** `mail_account.connected` and `mail_account.disconnected`: a synced mailbox. */
-interface MailAccountEventData {
-  readonly organizationId: string;
-  readonly accountId: string;
-  /** The member whose mailbox it is. */
-  readonly userId: string;
-  /** `gmail`, `outlook` or a custom provider name. */
-  readonly provider: string;
-  readonly address: string;
-}
-/**
- * `mail_message.received` and `mail_message.sent`: a message stored on a
- * thread. `subjects` lists the records the thread is linked to.
- */
-interface MailMessageEventData {
-  readonly organizationId: string;
-  readonly accountId: string;
-  readonly userId: string;
-  readonly threadId: string;
-  readonly messageId: string;
-  readonly direction: "inbound" | "outbound";
-  readonly fromAddress: string | null;
-  readonly subjects: readonly {
-    readonly type: string;
-    readonly id: string;
-  }[];
-}
-/**
- * `mail_message.opened` (the first open) and `mail_message.clicked` (each
- * click): a tracked message its recipient opened, or a link in it they followed
- * (`url`, null for an open).
- */
-interface MailTrackingEventData {
-  readonly organizationId: string;
-  readonly accountId: string;
-  readonly userId: string;
-  readonly threadId: string;
-  readonly messageId: string;
-  /** The template version the message was sent from, when it had one. */
-  readonly templateVersionId: string | null;
-  readonly url: string | null;
-  readonly subjects: readonly {
-    readonly type: string;
-    readonly id: string;
-  }[];
-}
-/**
- * `segment.saved` and `segment.removed`: a tenant's filter over one subject
- * type.
- */
-interface SegmentEventData {
-  readonly organizationId: string;
-  readonly segmentId: string;
-  readonly subjectType: string;
-  readonly name: string;
-}
-/**
- * `segment.entered` and `segment.left`: a record started or stopped matching a
- * segment's conditions when the segment was refreshed.
- */
-interface SegmentMemberEventData {
-  readonly organizationId: string;
-  readonly segmentId: string;
-  readonly subjectType: string;
-  readonly subjectId: string;
-}
-/** `subject.assigned`: an assignment queue picked an owner for a record. */
-interface AssignmentEventData {
-  readonly organizationId: string;
-  readonly queueId: string;
-  readonly subjectType: string;
-  readonly subjectId: string;
-  /** The member the queue picked. */
-  readonly userId: string;
-  readonly strategy: "round_robin" | "weighted";
-}
-/**
- * `party.enriched`: a provider's result for a company or a person was stored,
- * with the empty columns the match filled.
- */
-interface EnrichmentEventData {
-  readonly organizationId: string;
-  readonly subjectType: string;
-  readonly subjectId: string;
-  readonly provider: string;
-  readonly status: "matched" | "not_found";
-  /** The record's columns the match filled, such as `domain` or `title`. */
-  readonly filled: readonly string[];
-}
-/**
- * `forecast.snapshotted`: the forecast call for a period and currency was
- * stored with the deals it counted.
- */
-interface ForecastSnapshotEventData {
-  readonly organizationId: string;
-  readonly snapshotId: string;
-  /** `null` for a snapshot of every pipeline. */
-  readonly pipelineId: string | null;
-  /** ISO dates. */
-  readonly since: string;
-  readonly until: string;
-  readonly currency: string;
-  readonly dealCount: number;
-}
-/** `collection.created` and `collection.archived`: a list of one subject type. */
-interface CollectionEventData {
-  readonly organizationId: string;
-  readonly collectionId: string;
-  /** The type of the records the collection holds. */
-  readonly subjectType: string;
-  readonly name: string;
-  /** For `collection.created`: `user`, `team` or `tenant`. */
-  readonly scope?: string;
-}
-/** `collection.entry_added` and `collection.entry_removed`: a record in a list. */
-interface CollectionEntryEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly collectionId: string;
-}
-/**
- * `saved_item.reminded`: a record a member saved for later reached its reminder
- * time.
- */
-interface SavedItemEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly savedItemId: string;
-  /** The member who saved it. */
-  readonly userId: string;
-  readonly note?: string;
-  readonly remindAt: string;
-}
-/** Events from the deals module. Amounts are minor units as text. */
-interface DealEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly dealId: string;
-  readonly name: string;
-  readonly amount?: string;
-  readonly currency?: string;
-  /** For `deal.closed`: `won` or `lost`. */
-  readonly outcome?: string;
-  /** For `deal.closed` as lost: why. */
-  readonly reason?: string | null;
-  /** For `deal.updated`: the fields the batch changed. */
-  readonly fields?: readonly string[];
-}
-/** Events from the work-items module. */
-interface WorkItemEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly workItemId: string;
-  readonly title: string;
-  /** For `work_item.updated`: the fields the batch changed. */
-  readonly fields?: readonly string[];
-  /** For `work_item.assigned`: everyone assigned now. */
-  readonly assigneeIds?: readonly string[];
-  /** For `work_item.closed`: `completed` or `canceled`, and why. */
-  readonly state?: string;
-  readonly closeReason?: string;
-}
-/** Events from the quotes module. Amounts are minor units as text. */
-interface QuoteEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly quoteId: string;
-  readonly identifier: string;
-  readonly total?: string;
-  readonly currency?: string;
-  /** For `quote.accepted`: who accepted, by name. */
-  readonly byName?: string;
-  /** For `quote.rejected` and `quote.changes_requested`. */
-  readonly note?: string | null;
-  /** For `quote.revised`: the new revision. */
-  readonly revisionId?: string;
-}
-/** Events from the invoices module. Amounts are minor units as text. */
-interface InvoiceEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly invoiceId: string;
-  /** Null while the invoice is a draft. */
-  readonly identifier: string | null;
-  readonly total?: string;
-  readonly currency?: string;
-  readonly dueOn?: string;
-  readonly paymentId?: string;
-  readonly amount?: string;
-  readonly balance?: string;
-  readonly creditNoteId?: string;
-  readonly reason?: string | null;
-}
-/** Events from the sla module: a clock on a record warned, breached or was met. */
-interface SlaEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly clockId: string;
-  /** `first_response`, `next_response` or `resolution`. */
-  readonly metric: string;
-  readonly dueAt: string;
-  /** For `sla.completed`: whether it was met after its due time. */
-  readonly late?: boolean;
-}
-/** Events from the hiring module about a job. */
-interface JobEventData {
-  readonly organizationId: string;
-  readonly jobId: string;
-  readonly title: string;
-}
-/** Events from the hiring module about an application. */
-interface ApplicationEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly applicationId: string;
-  readonly jobId: string;
-  /** The candidate's record in config.subjects, a person by default. */
-  readonly candidateType: string;
-  readonly candidateId: string;
-  /** For `application.rejected`. */
-  readonly reason?: string | null;
-  /** For `scorecard.submitted`. */
-  readonly reviewerId?: string;
-  readonly recommendation?: string;
-  /** For `interview.scheduled`. */
-  readonly interviewId?: string;
-  readonly startsAt?: string;
-}
-/** Events from the employees module. */
-interface EmployeeEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly employeeId: string;
-  readonly name: string;
-  /** For `employee.created`. */
-  readonly userId?: string | null;
-  readonly managerId?: string | null;
-  readonly status?: string;
-  /** For `employee.updated`: the fields the batch changed, or `contract`. */
-  readonly fields?: readonly string[];
-  /** For `employee.offboarded`: the last day and why. */
-  readonly endDate?: string;
-  readonly reason?: string | null;
-  /** For `employee.manager_changed`. */
-  readonly fromManagerId?: string | null;
-  readonly toManagerId?: string | null;
-}
-/**
- * Events from the pipelines module. `pipeline.stage_changed` carries the record
- * that moved as `subjectType` and `subjectId`; the configuration events
- * (`pipeline.created`, `pipeline_stage.saved`) carry none.
- */
-interface PipelineEventData {
-  readonly organizationId: string;
-  readonly pipelineId: string;
-  readonly subjectType?: string;
-  readonly subjectId?: string;
-  readonly key?: string;
-  readonly stageId?: string;
-  readonly fromStageId?: string | null;
-  readonly toStageId?: string;
-  /** The stage category, such as `won` or `started`. */
-  readonly category?: string;
-  /** `open`, `success` or `failure`. */
-  readonly outcome?: string;
-}
-/** `pipeline.stage_changed`: the record that moved and its stages. */
-type PipelineStageEventData = PipelineEventData & SubjectEventData;
-/** Events from the messaging module about a conversation. */
-interface ConversationEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly conversationId: string;
-  /** `channel`, `dm`, `group_dm`, `subject` or `inbox`. */
-  readonly kind: string;
-  /** For `conversation.created` of a record conversation: the record. */
-  readonly recordType?: string | null;
-  readonly recordId?: string | null;
-  /** For `conversation.member_added` and `member_removed`. */
-  readonly userId?: string;
-}
-/** Events from the messaging module about a message. */
-interface MessageEventData extends SubjectEventData {
-  readonly organizationId: string;
-  readonly conversationId: string;
-  readonly messageId: string;
-  readonly authorId: string | null;
-  /** The thread's root message, null for a top-level message. */
-  readonly threadId: string | null;
-  /** The conversation's kind: `subject` for a record's comments. */
-  readonly conversationKind?: string;
-  /** The record a `subject` conversation discusses, null otherwise. */
-  readonly recordType?: string | null;
-  readonly recordId?: string | null;
-  /** For `message.sent`: the users it mentions. */
-  readonly mentionIds?: readonly string[];
-  /**
-   * For `message.sent`: the records it mentions
-   * (`@[Name](subject:<type>/<id>)`).
-   */
-  readonly recordMentions?: readonly {
-    readonly type: string;
-    readonly id: string;
-  }[];
-  /** For `message.pinned` and `message.resolved`: the new state. */
-  readonly pinned?: boolean;
-  readonly resolved?: boolean;
-}
-/** Events from the channels module. */
-interface ChannelEventData extends SubjectEventData {
-  readonly organizationId: string;
-  /** The channel's id, which is also its conversation's id. */
-  readonly channelId: string;
-  readonly name: string;
-  /** `public` or `private`. */
-  readonly visibility: string;
-  /** The record the channel is linked to. */
-  readonly recordType: string | null;
-  readonly recordId: string | null;
-}
-//#endregion
-export { SavedItemEventData as C, WorkItemEventData as D, SlaEventData as E, QuoteEventData as S, SegmentMemberEventData as T, MailTrackingEventData as _, CollectionEventData as a, PipelineEventData as b, EmployeeEventData as c, EnrichmentEventData as d, ForecastSnapshotEventData as f, MailMessageEventData as g, MailAccountEventData as h, CollectionEntryEventData as i, EngagementEventData as l, JobEventData as m, AssignmentEventData as n, ConversationEventData as o, InvoiceEventData as p, ChannelEventData as r, DealEventData as s, ApplicationEventData as t, EngagementRecordingEventData as u, MessageEventData as v, SegmentEventData as w, PipelineStageEventData as x, PartyEventData as y };