better-supabase 0.12.0 → 0.14.0

package/dist/executor-D1hECPGG.d.ts

@@ -1,39 +0,0 @@
-import { r as Executor } from "./executor-BnMC0lj3.js";
-//#region src/postgres/executor.d.ts
-/**
- * Anything that runs parameterized SQL: `ctx.postgres` from
- * `@supabase/server/middleware/postgres`, or a client from `createPostgres()`.
- */
-interface SqlClient {
-  queryRaw<T = Record<string, unknown>>(text: string, params?: unknown[]): Promise<T[]>;
-  /**
-   * Runs `fn` on one connection in one transaction. Optional; without it
-   * `db.$many` sends its statements separately.
-   */
-  transaction?<T>(fn: (client: SqlClient) => Promise<T>): Promise<T>;
-}
-interface PostgresExecutorOptions {
-  /**
-   * Rows an `estimated` count counts exactly before it switches to the
-   * planner's estimate, like PostgREST's `db-max-rows`. Defaults to 1000.
-   */
-  readonly estimatedCountThreshold?: number;
-}
-/**
- * Executes repository operations as SQL on a direct Postgres connection.
- * Rows have the same shape as over PostgREST. RLS applies when the client
- * runs as the caller (`ctx.postgres`, `createPostgres().asUser()`).
- *
- * `maxAffected` fails the statement itself, so its writes roll back.
- * A call's `timeout` is checked before the statement starts; set
- * `statement_timeout` on the connection to bound a running statement.
- * `retry` does nothing here.
- *
- * `count: "planned"` reads the planner's row estimate from
- * `explain (format json)`; `count: "estimated"` counts exactly up to
- * `estimatedCountThreshold` rows and uses the estimate past it, like
- * PostgREST.
- */
-declare function postgresExecutor(client: SqlClient, options?: PostgresExecutorOptions): Executor;
-//#endregion
-export { SqlClient as n, postgresExecutor as r, PostgresExecutorOptions as t };

package/dist/executor-D3K3tycZ.js

@@ -1,147 +0,0 @@
-import { a as evaluateCondition, c as isGraphRecord, i as durationMs, n as conditionOf, p as validateGraph, t as approved, u as topologicalOrder } from "./graph-Cs28bOlK.js";
-//#region src/blocks/workflow-builder/executor.ts
-/** The hook token of an approval node without `requestApproval`. */
-const approvalToken = (runKey, node) => `${runKey}:${node}`;
-const active = (edge, ran) => {
-	const outcome = ran.get(edge.source);
-	if (outcome === void 0) return false;
-	return edge.branch === void 0 || String(outcome) === edge.branch;
-};
-/**
-* The runtime fields of a static executor's `meta`: spread them into the
-* runtime passed to `executeGraph`, so a run starts at its trigger node,
-* conditions read its subject, and a test run returns its stubs instead of
-* running steps.
-*/
-function graphRunFields(meta) {
-	const record = isGraphRecord(meta) ? meta : {};
-	const text = (key) => typeof record[key] === "string" ? record[key] : void 0;
-	const subject = record["subject"];
-	const stubs = record["stubs"];
-	const version = text("versionId");
-	const tenant = text("tenant");
-	const triggerNode = text("triggerNode");
-	return {
-		runKey: text("runKey") ?? "",
-		...version === void 0 ? {} : { version },
-		...tenant === void 0 ? {} : { tenant },
-		...isGraphRecord(subject) ? { subject: {
-			type: String(subject["type"]),
-			id: String(subject["id"])
-		} } : {},
-		...triggerNode === void 0 ? {} : { triggerNode },
-		...record["mode"] === "test" ? { stubs: isGraphRecord(stubs) ? stubs : {} } : {}
-	};
-}
-/** A test run's stub for `node`, or `fallback` when it has none. */
-function stubOf(stubs, node, fallback) {
-	return Object.hasOwn(stubs, node) ? stubs[node] : fallback;
-}
-/**
-* The trigger node a run starts at: `requested` when the graph has it, else
-* the graph's only trigger. Throws when neither picks one.
-*/
-function startNodeOf(graph, requested) {
-	const triggers = graph.nodes.filter((node) => node.kind === "trigger");
-	const start = requested === void 0 ? triggers.length === 1 ? triggers[0]?.id : void 0 : triggers.find((node) => node.id === requested)?.id;
-	if (start === void 0) throw new TypeError("workflow-builder: pass the trigger node the run starts at, the id of one of the graph's trigger nodes");
-	return start;
-}
-/**
-* Runs `graph` in dependency order from its start trigger
-* (`runtime.triggerNode`): a node runs when the trigger reaches it through
-* edges whose sources ran (and, from a condition or an approval, took the
-* edge's branch). Returns each node's output by id. It only calls
-* `runtime`, so it is deterministic and runs inside a `"use workflow"`
-* function as the static executor.
-*/
-async function executeGraph(graph, input, runtime) {
-	const errors = validateGraph(graph);
-	if (errors.length > 0) throw new TypeError(`workflow-builder: ${errors.join("; ")}`);
-	const start = startNodeOf(graph, runtime.triggerNode);
-	const order = topologicalOrder(graph) ?? [];
-	const incoming = /* @__PURE__ */ new Map();
-	for (const edge of graph.edges) incoming.set(edge.target, [...incoming.get(edge.target) ?? [], edge]);
-	const results = {};
-	const ran = /* @__PURE__ */ new Map();
-	for (const node of order) {
-		if (node.kind === "trigger") {
-			if (node.id !== start) continue;
-		} else if (!(incoming.get(node.id) ?? []).some((edge) => active(edge, ran))) continue;
-		const { output, outcome } = await runNode(node, input, results, runtime);
-		results[node.id] = output;
-		ran.set(node.id, outcome);
-	}
-	return results;
-}
-const extrasOf = (runtime) => ({
-	...runtime.version === void 0 ? {} : { version: runtime.version },
-	...runtime.tenant === void 0 ? {} : { tenant: runtime.tenant },
-	...runtime.subject === void 0 ? {} : { subject: runtime.subject }
-});
-async function runNode(node, input, results, runtime) {
-	switch (node.kind) {
-		case "trigger": return {
-			output: input,
-			outcome: true
-		};
-		case "step": return {
-			output: (runtime.stubs === void 0 ? await runtime.step({
-				node: node.id,
-				step: node.step ?? "",
-				config: node.config ?? {},
-				input,
-				results: { ...results },
-				runKey: runtime.runKey,
-				...extrasOf(runtime)
-			}) : stubOf(runtime.stubs, node.id, { stubbed: true })) ?? null,
-			outcome: true
-		};
-		case "sleep":
-			if (runtime.stubs === void 0) await runtime.sleep(durationMs(node.config?.["duration"]) ?? 0);
-			return {
-				output: null,
-				outcome: true
-			};
-		case "approval": {
-			if (runtime.stubs !== void 0) {
-				const payload = stubOf(runtime.stubs, node.id, { approved: true });
-				return {
-					output: payload ?? null,
-					outcome: approved(payload)
-				};
-			}
-			const token = runtime.requestApproval === void 0 ? approvalToken(runtime.runKey, node.id) : await runtime.requestApproval({
-				node: node.id,
-				config: node.config ?? {},
-				input,
-				results: { ...results },
-				runKey: runtime.runKey,
-				...extrasOf(runtime)
-			});
-			const payload = await runtime.approval(token, node.id);
-			return {
-				output: payload ?? null,
-				outcome: approved(payload)
-			};
-		}
-		case "condition": {
-			const condition = conditionOf(node);
-			const outcome = condition !== void 0 && evaluateCondition(condition, {
-				input,
-				results,
-				subject: runtime.subject
-			});
-			return {
-				output: outcome,
-				outcome
-			};
-		}
-		default: {
-			const unknown = node.kind;
-			throw new TypeError(`workflow-builder: unknown node kind ${String(unknown)}`);
-		}
-	}
-}
-//#endregion
-export { startNodeOf as i, executeGraph as n, graphRunFields as r, approvalToken as t };

package/dist/field-errors-DZVRWRkf.js

@@ -1,13 +0,0 @@
-//#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
-export { fieldErrorsOf as t };

package/dist/field-errors-Z-sgsdoN.d.ts

@@ -1,113 +0,0 @@
-import { b as DbError } from "./result-BREt7qOh.js";
-import { O as TemplateValues } from "./bucket-BbePDVwc.js";
-import { at as QuerySpec } from "./define-DYZnvAbs.js";
-import { _ as TopicMessage, c as RealtimeClient, d as SubscribeOptions, i as PresenceOptions, s as PresenceSubscription } from "./topic-DAY_HOX2.js";
-import { t as ClientPorts } from "./ports-BCDIbC_U.js";
-import { a as ClientAuth } from "./bind-Bfo40o63.js";
-import { a as LiveSource, r as LiveCountSeed } from "./index-DTQSeHx2.js";
-import { SupabaseClient } from "@supabase/supabase-js";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-import { QueryClient } from "@tanstack/query-core";
-//#region src/bindings/client.d.ts
-/** The parts of `createClient()` the bindings need. */
-interface ClientLike {
-  readonly betterSupabase: LiveSource;
-  readonly supabase: SupabaseClient;
-  readonly auth: ClientAuth;
-  readonly db: object;
-  readonly queries: object;
-  /** The platform services block controllers use; see `ClientPorts`. */
-  readonly ports?: ClientPorts;
-}
-/** What a `bs.action()` Server Action or server function resolves to. */
-type ActionResultOf<T> = {
-  readonly ok: true;
-  readonly data: T;
-  readonly error: null;
-} | {
-  readonly ok: false;
-  readonly data: null;
-  readonly error: DbError;
-};
-/**
- * The input `useAction` passes: a `bs.action()` with an `input` schema also
- * accepts `FormData`, which belongs to `useActionForm`.
- */
-type ActionInputOf<I> = [Exclude<I, FormData>] extends [never] ? I : Exclude<I, FormData>;
-interface UseActionOptions<I, T> {
-  readonly onSuccess?: (data: T, input: I) => void;
-  readonly onError?: (error: DbError, input: I) => void;
-}
-interface BroadcastOptions extends Omit<SubscribeOptions, "onStatus"> {
-  /**
-   * A supabase-js client to subscribe with, for apps without the provider.
-   * It resubscribes when the client's user changes. Defaults to the
-   * provider's client.
-   */
-  readonly client?: SupabaseClient;
-  /** The query client `invalidate` refetches with. Defaults to the provider's. */
-  readonly queryClient?: QueryClient;
-  /**
-   * Refetch after each message: table keys (every query that read one of
-   * them), or a function returning query keys. Needs a `queryClient`, here
-   * or on the provider.
-   */
-  readonly invalidate?: readonly string[] | ((message: TopicMessage) => readonly (readonly unknown[])[]);
-}
-interface LiveQueryHookOptions {
-  /**
-   * Tenant for tenant-scoped tables. Defaults to the `config.claims.tenant`
-   * claim (`tenant_id`, top-level or in `app_metadata`).
-   */
-  readonly tenant?: string;
-  /** Defaults to 100 ms. */
-  readonly debounceMs?: number;
-}
-interface LiveCountHookOptions extends LiveQueryHookOptions {
-  /** The count to show before the first fetch, e.g. from the server. */
-  readonly initial?: number;
-}
-interface PresenceHookOptions<I> {
-  /**
-   * The state this client shares while joined. It is tracked after the
-   * join and tracked again when its JSON changes; `null` stays untracked.
-   */
-  readonly state?: I | null;
-  /** A supabase-js client for apps without the provider. */
-  readonly client?: SupabaseClient;
-}
-/** The parts of a `defineTopic(..., { presence })` topic the bindings use. */
-interface PresenceTopic<P extends string, I, O> {
-  topic(values: TemplateValues<P>): string;
-  match(topic: string): TemplateValues<P> | null;
-  subscribe(client: RealtimeClient, values: TemplateValues<P>, handlers: Readonly<Record<string, never>>, options?: SubscribeOptions & PresenceOptions<O>): PresenceSubscription<I, O>;
-}
-/** Who a subscription runs as. */
-/** The claims type of a client's `betterSupabase.claims(schema)`, `unknown` without one. */
-type ClaimsOf<B extends ClientLike> = B["betterSupabase"] extends {
-  readonly claimsSchema: StandardSchemaV1<unknown, infer C> | undefined;
-} ? C : unknown;
-/** The profile type of a client's `betterSupabase.userMetadata(schema)`, `unknown` without one. */
-type ProfileOf<B extends ClientLike> = B["betterSupabase"] extends {
-  readonly userMetadataSchema: StandardSchemaV1<unknown, infer P> | undefined;
-} ? P : unknown;
-/** A count spec or a `bs.liveCount()` seed. */
-type LiveCountSource = QuerySpec<string, "count", number> | LiveCountSeed | null | undefined;
-interface ActionState<I, T> {
-  /** True while a run is in flight. */
-  readonly pending: boolean;
-  /** The inputs of the runs in flight, e.g. to dim one table row. */
-  readonly pendingInputs: readonly I[];
-  /** The input of the latest run in flight. */
-  readonly pendingInput: I | undefined;
-  /** The data of the last successful run. */
-  readonly data: T | undefined;
-  /** The error of the last run, until the next one starts. */
-  readonly error: DbError | undefined;
-}
-//#endregion
-//#region src/bindings/field-errors.d.ts
-/** The first message per top-level field of a `validation` error. */
-declare function fieldErrorsOf(error: DbError | undefined): Readonly<Partial<Record<string, string>>>;
-//#endregion
-export { BroadcastOptions as a, LiveCountHookOptions as c, PresenceHookOptions as d, PresenceTopic as f, ActionState as i, LiveCountSource as l, UseActionOptions as m, ActionInputOf as n, ClaimsOf as o, ProfileOf as p, ActionResultOf as r, ClientLike as s, fieldErrorsOf as t, LiveQueryHookOptions as u };

package/dist/field-formats-Cif5gr7c.js

@@ -1,102 +0,0 @@
-//#region src/core/contracts/field-formats.ts
-const FIELD_FORMAT_NAMES = [
-	"email",
-	"url",
-	"phone",
-	"long_text",
-	"color",
-	"rating",
-	"percent",
-	"currency"
-];
-/** The stars a `rating` takes, for a column and for a custom field. */
-const RATING_BOUNDS = [1, 5];
-const EMAIL = String.raw`^[^@\s]+@[^@\s]+\.[^@\s]+$`;
-const URL = String.raw`^https?://\S+$`;
-/**
-* Money is a `currency` `bigint` of minor units next to a `text` column of
-* 3 characters for the code (ADR 0037).
-*/
-const FIELD_FORMATS = {
-	email: {
-		types: ["text"],
-		pattern: EMAIL,
-		input: "email",
-		formType: "email"
-	},
-	url: {
-		types: ["text"],
-		pattern: URL,
-		input: "url",
-		formType: "url"
-	},
-	phone: {
-		types: ["text"],
-		input: "tel",
-		formType: "text"
-	},
-	long_text: {
-		types: ["text"],
-		input: "textarea",
-		formType: "textarea"
-	},
-	color: {
-		types: ["text"],
-		input: "color",
-		formType: "text"
-	},
-	rating: {
-		types: ["integer", "bigint"],
-		bounds: RATING_BOUNDS,
-		input: "number",
-		formType: "integer"
-	},
-	percent: {
-		types: ["integer", "numeric"],
-		bounds: [0, 100],
-		input: "number",
-		formType: "number"
-	},
-	currency: {
-		types: ["bigint"],
-		input: "number",
-		formType: "integer"
-	}
-};
-/**
-* The types of a custom field definition. A value is stored as text either
-* way; the type tells the form and the UI what it holds. `user` holds a user
-* id, `currency` an integer of minor units, and `multi_option` a JSON array
-* of option values.
-*/
-const CUSTOM_FIELD_TYPES = [
-	"text",
-	"number",
-	"date",
-	"bool",
-	"option",
-	"json",
-	"email",
-	"url",
-	"multi_option",
-	"user",
-	"rating",
-	"currency"
-];
-/** The forms block field type that answers each custom field type. */
-const CUSTOM_FIELD_FORM_TYPES = {
-	text: "text",
-	number: "number",
-	date: "date",
-	bool: "bool",
-	option: "option",
-	json: "json",
-	email: FIELD_FORMATS.email.formType,
-	url: FIELD_FORMATS.url.formType,
-	multi_option: "multi",
-	user: "text",
-	rating: FIELD_FORMATS.rating.formType,
-	currency: FIELD_FORMATS.currency.formType
-};
-//#endregion
-export { RATING_BOUNDS as a, FIELD_FORMAT_NAMES as i, CUSTOM_FIELD_TYPES as n, FIELD_FORMATS as r, CUSTOM_FIELD_FORM_TYPES as t };

package/dist/field-formats-DCvOQlOy.d.ts

@@ -1,39 +0,0 @@
-import { s as FormFieldType } from "./form-definition-sagoefQr.js";
-//#region src/core/contracts/field-formats.d.ts
-/**
- * The one field vocabulary: the formats an app table column takes and the
- * types a custom field takes. App tables render each format's check from
- * here, `scaffold screens` picks the input, and the forms block answers a
- * custom field with the form field type it maps to.
- */
-/** The Postgres column types a format fits. */
-type FieldFormatColumnType = "text" | "integer" | "bigint" | "numeric";
-/** The HTML input a format edits with. */
-type FieldFormatInput = "email" | "url" | "tel" | "textarea" | "color" | "number";
-interface FieldFormat {
-  readonly types: readonly FieldFormatColumnType[];
-  /** A POSIX regular expression the value matches, ignoring case. */
-  readonly pattern?: string;
-  /** The bounds when the column sets no `min` or `max`. */
-  readonly bounds?: readonly [min: number, max: number];
-  readonly input: FieldFormatInput;
-  /** The forms block field type that collects the value. */
-  readonly formType: FormFieldType;
-}
-declare const FIELD_FORMAT_NAMES: readonly ["email", "url", "phone", "long_text", "color", "rating", "percent", "currency"];
-type FieldFormatName = (typeof FIELD_FORMAT_NAMES)[number];
-/**
- * Money is a `currency` `bigint` of minor units next to a `text` column of
- * 3 characters for the code (ADR 0037).
- */
-declare const FIELD_FORMATS: Readonly<Record<FieldFormatName, FieldFormat>>;
-/**
- * The types of a custom field definition. A value is stored as text either
- * way; the type tells the form and the UI what it holds. `user` holds a user
- * id, `currency` an integer of minor units, and `multi_option` a JSON array
- * of option values.
- */
-declare const CUSTOM_FIELD_TYPES: readonly ["text", "number", "date", "bool", "option", "json", "email", "url", "multi_option", "user", "rating", "currency"];
-type CustomFieldType = (typeof CUSTOM_FIELD_TYPES)[number];
-//#endregion
-export { FieldFormat as a, FIELD_FORMAT_NAMES as i, CustomFieldType as n, FieldFormatInput as o, FIELD_FORMATS as r, FieldFormatName as s, CUSTOM_FIELD_TYPES as t };

package/dist/filter-evaluate-BJcaL3o1.d.ts

@@ -1,34 +0,0 @@
-import { h as FilterQuery, l as FilterFieldType, r as FilterClock } from "./filter-query-Bc_Qa8V_.js";
-//#region src/list/filter-evaluate.d.ts
-/**
- * A field a filter tree can test on a plain record. `FilterFieldInfo` from a
- * list definition fits; the rules block builds these from its field catalog.
- */
-interface FilterRecordField {
-  readonly id: string;
-  readonly type: FilterFieldType;
-  /** The record key the value is read from, dotted for a nested value. */
-  readonly column: string;
-  readonly columnMeta: {
-    /** The Postgres type: `date`, `timestamp` and `timestamptz` pick how dates compare. */
-    readonly type: string;
-    readonly nullable: boolean;
-  };
-}
-/**
- * The outcome of a tree on one record. `results` holds every rule and group
- * that took part, by node id: `null` when a comparison met a missing value,
- * which SQL treats as unknown and a match treats as false.
- */
-interface FilterEvaluation {
-  readonly matched: boolean;
-  readonly results: Readonly<Record<string, boolean | null>>;
-}
-/**
- * Tests a checked filter tree on one record, with the same operators and
- * null handling as `filterWhere` compiles to SQL. Unfinished rules, unknown
- * fields and empty groups take no part, and a tree with nothing left matches.
- */
-declare function evaluateFilterQuery(query: FilterQuery, record: unknown, fields: readonly FilterRecordField[], clock?: FilterClock): FilterEvaluation;
-//#endregion
-export { FilterRecordField as n, evaluateFilterQuery as r, FilterEvaluation as t };