better-supabase 0.8.0 → 0.9.0

package/dist/blocks/audit/react/index.d.ts

@@ -0,0 +1,26 @@
+import { a as AuditLogSnapshot, n as AuditLogActions, t as AuditFilters } from "../../../client-D5CZ2a34.js";
+//#region src/blocks/audit/react/index.d.ts
+export interface UseAuditLogOptions {
+  /** The organization; the table waits without one. */
+  readonly organizationId: string | null | undefined;
+  /** The filters of the first page; change them with `setFilters`. */
+  readonly filters?: AuditFilters;
+  /** Entries per page, default 50, at most 1000. */
+  readonly limit?: number;
+  /** The schema the calls go to: the module schema (default `better_supabase`), or the API schema from `blocks.<module>.api`. */
+  readonly schema?: string;
+}
+export interface AuditLogState extends AuditLogSnapshot, AuditLogActions {}
+/**
+ * One organization's audit trail through the browser client, newest first,
+ * with filters by actor, action or text and older pages on `loadMore`.
+ * The audit module's read policy decides what the caller sees. The same
+ * hook runs in React DOM and React Native.
+ *
+ * ```tsx
+ * const { entries, filters, setFilters, loadMore } = useAuditLog({ organizationId });
+ * ```
+ */
+export declare function useAuditLog(options: UseAuditLogOptions): AuditLogState;
+//#endregion
+export type { AuditFilters };

package/dist/blocks/audit/react/index.js

@@ -0,0 +1,44 @@
+"use client";
+import { r as rpcTransport } from "../../../block-transport-G4t1umrR.js";
+import { t as createAudit } from "../../../audit-log-BMMuGPdP.js";
+import { t as createAuditLogController } from "../../../client-B9CqzgPO.js";
+import { n as useLatest, t as useController } from "../../../react-controller-Xn-IU44p.js";
+import { t as useBlockEnv } from "../../../react-env-Cc7Vf6eb.js";
+//#region src/blocks/audit/react/index.ts
+/**
+* One organization's audit trail through the browser client, newest first,
+* with filters by actor, action or text and older pages on `loadMore`.
+* The audit module's read policy decides what the caller sees. The same
+* hook runs in React DOM and React Native.
+*
+* ```tsx
+* const { entries, filters, setFilters, loadMore } = useAuditLog({ organizationId });
+* ```
+*/
+function useAuditLog(options) {
+	const { supabase, auth } = useBlockEnv();
+	const latest = useLatest(options);
+	const { organizationId, limit, schema } = options;
+	return useController(() => {
+		const { filters } = latest.current;
+		return createAuditLogController({
+			client: createAudit({
+				transport: rpcTransport(supabase),
+				...schema === void 0 ? {} : { schema }
+			}),
+			auth,
+			organizationId: organizationId ?? null,
+			...filters === void 0 ? {} : { filters },
+			...limit === void 0 ? {} : { limit }
+		});
+	}, [
+		supabase,
+		auth,
+		organizationId,
+		limit,
+		schema,
+		latest
+	]).view;
+}
+//#endregion
+export { useAuditLog };

package/dist/blocks/audit/react/server.d.ts

@@ -0,0 +1,7 @@
+import { t as AuditFilters } from "../../../client-D5CZ2a34.js";
+import { AuditLogState, UseAuditLogOptions } from "./index.js";
+//#region src/blocks/audit/react/server.d.ts
+/** The `react-server` build of `useAuditLog`: call `audit.list()` instead. */
+export declare const useAuditLog: (options: UseAuditLogOptions) => AuditLogState;
+//#endregion
+export type { AuditFilters, AuditLogState, UseAuditLogOptions };

package/dist/blocks/audit/react/server.js

@@ -0,0 +1,7 @@
+//#region src/blocks/audit/react/server.ts
+/** The `react-server` build of `useAuditLog`: call `audit.list()` instead. */
+const useAuditLog = () => {
+	throw new Error("better-supabase: useAuditLog() runs in Client Components only. In Server Components call `audit.list()` instead.");
+};
+//#endregion
+export { useAuditLog };

package/dist/blocks/audit/solid/index.d.ts

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-DqlvYFZa.js";
+import { a as AuditLogSnapshot, i as AuditLogControllerOptions, n as AuditLogActions } from "../../../client-D5CZ2a34.js";
+//#region src/blocks/audit/solid/index.d.ts
+/**
+ * `createAuditLogController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useAuditLog(options: BlockOptions<AuditLogControllerOptions>): SolidController<AuditLogSnapshot, AuditLogActions>;
+//#endregion
+export type { AuditLogActions, AuditLogControllerOptions, AuditLogSnapshot, BlockOptions, SolidController };

package/dist/blocks/audit/solid/index.js

@@ -0,0 +1,14 @@
+import { t as createAuditLogController } from "../../../client-B9CqzgPO.js";
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+//#region src/blocks/audit/solid/index.ts
+/**
+* `createAuditLogController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useAuditLog(options) {
+	return useBlockController(createAuditLogController, options);
+}
+//#endregion
+export { useAuditLog };

package/dist/blocks/audit/svelte/index.d.ts

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DxxHEHxD.js";
+import { a as AuditLogSnapshot, i as AuditLogControllerOptions, n as AuditLogActions } from "../../../client-D5CZ2a34.js";
+//#region src/blocks/audit/svelte/index.d.ts
+/**
+ * `createAuditLogController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useAuditLog(options: BlockOptions<AuditLogControllerOptions>): SvelteController<AuditLogSnapshot, AuditLogActions>;
+//#endregion
+export type { AuditLogActions, AuditLogControllerOptions, AuditLogSnapshot, BlockOptions, SvelteController };

package/dist/blocks/audit/svelte/index.js

@@ -0,0 +1,14 @@
+import { t as createAuditLogController } from "../../../client-B9CqzgPO.js";
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+//#region src/blocks/audit/svelte/index.ts
+/**
+* `createAuditLogController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useAuditLog(options) {
+	return useBlockController(createAuditLogController, options);
+}
+//#endregion
+export { useAuditLog };

package/dist/blocks/audit/vue/index.d.ts

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-HPfMTDa2.js";
+import { a as AuditLogSnapshot, i as AuditLogControllerOptions, n as AuditLogActions } from "../../../client-D5CZ2a34.js";
+//#region src/blocks/audit/vue/index.d.ts
+/**
+ * `createAuditLogController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useAuditLog(options: BlockOptions<AuditLogControllerOptions>): VueController<AuditLogSnapshot, AuditLogActions>;
+//#endregion
+export type { AuditLogActions, AuditLogControllerOptions, AuditLogSnapshot, BlockOptions, VueController };

package/dist/blocks/audit/vue/index.js

@@ -0,0 +1,14 @@
+import { t as createAuditLogController } from "../../../client-B9CqzgPO.js";
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+//#region src/blocks/audit/vue/index.ts
+/**
+* `createAuditLogController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function useAuditLog(options) {
+	return useBlockController(createAuditLogController, options);
+}
+//#endregion
+export { useAuditLog };

package/dist/blocks/billing/index.d.ts

@@ -1,18 +1,39 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult, w as ErrorMapper } from "../../result-BchM1XZn.js";
-import { t as SqlClient } from "../../executor-ngjKL_Pe.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
-import { E as BlockEventType, a as EventHub, x as BillingEventData } from "../../events-D1BOCll8.js";
-import { i as CursorPageOptions, r as BlockTemporalOptions } from "../../block-helpers-C0Xj8War.js";
-import { n as StripeSource, r as StripeTaxId, t as StripeClient } from "../../stripe-D04h-QBT.js";
-import { i as EventSink } from "../../cloud-event-Dune0KI7.js";
-import { d as stripeInboxVerify, f as verifyStripeWebhook, u as signStripeWebhook } from "../../verify-C91Wyp40.js";
+import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
+import { C as BillingEventData, O as BlockEventType, o as EventHub, wt as Events } from "../../events-CTreRrgP.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { n as SqlClient } from "../../executor-BBHgjUJu.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { i as CursorPageOptions, r as BlockTemporalOptions } from "../../block-helpers-C86hPEjI.js";
+import { n as BlockHooks } from "../../block-hooks-BLPWD3Jt.js";
+import { n as StripeSource, r as StripeTaxId, t as StripeClient } from "../../stripe-NVcNOhHy.js";
+import { i as EventSink } from "../../cloud-event-5rCEzIgK.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { d as stripeInboxVerify, f as verifyStripeWebhook, u as signStripeWebhook } from "../../verify-D63A2ALE.js";
+import { a as PlanPickerController, c as createPlanPickerController, i as PlanPickerActions, n as PlanCatalog, o as PlanPickerControllerOptions, r as PlanOption, s as PlanPickerSnapshot, t as CheckoutStarted } from "../../client-DjTRlN3a.js";
+//#region src/blocks/billing/events.d.ts
+/** The events of the `billing` block: type to data. */
+type BillingEvents = {
+  readonly "billing.customer_linked": BillingEventData;
+  readonly "billing.checkout_completed": BillingEventData;
+  readonly "billing.subscription_created": BillingEventData;
+  readonly "billing.subscription_updated": BillingEventData;
+  readonly "billing.subscription_deleted": BillingEventData;
+  readonly "billing.seats_synced": BillingEventData;
+};
+/** The `billing` block's event types, for its manifest and `onBlockEvent`. */
+export declare const billingEvents: Events<BillingEvents>;
+//#endregion
 //#region src/blocks/billing/types.d.ts
 interface BillingOptions extends BlockTemporalOptions {
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: NoInfer<BlockHooks<Billing>>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
   readonly stripe: StripeSource;
   /** A service-role transport: linking customers and reading seats are granted to `service_role` only. */
   readonly transport: BlockTransport;
-  /** The module schema (`sql.modules.billing.schema`), default `better_supabase`. */
+  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. Default `better_supabase`. */
   readonly schema?: string;
   readonly mappers?: readonly ErrorMapper[];
   /** `betterSupabase.events`, for `billing.*` block events. */
@@ -39,7 +60,7 @@ interface CheckoutOptions extends CustomerDetails {
   /** A Stripe price id. Pass this or `plan`. */
   readonly price?: string;
   /**
-   * A plan key from `sql.modules.billing.options.plans`, resolved to its
+   * A plan key from `blocks.billing.options.plans`, resolved to its
    * Stripe price in the app's plan catalog (with `interval` when plans have
    * monthly and yearly prices).
    */
@@ -103,7 +124,7 @@ interface StripeEvent {
 }
 interface StripeEventOutcome {
   /** The `billing.*` block event it emitted, if any. */
-  readonly event: BlockEventType | undefined;
+  readonly event: BlockEventType<BillingEvents> | undefined;
   readonly organizationId: string | undefined;
   readonly customerId: string | undefined;
   /** Members whose sessions were invalidated. */
@@ -264,4 +285,8 @@ interface Billing {
 /** Stripe customers, checkout, the portal and seat sync over the `billing` module. */
 export declare function createBilling(options: BillingOptions): Billing;
 //#endregion
-export { type Billing, type BillingCustomer, type BillingCustomerUpdate, type BillingEventData, type BillingOptions, type BillingStatus, type BlockTransport, type CheckoutItem, type CheckoutOptions, type CustomerDetails, type PlanChange, type PlatformListOptions, type SeatSync, type StripeClient, type StripeEvent, type StripeEventOutcome, type StripeRow, type StripeSource, type StripeTaxId, type SubscriptionItem, type TenantStripeRow, dbTransport, rpcTransport, signStripeWebhook, sqlTransport, stripeInboxVerify, verifyStripeWebhook };
+//#region src/blocks/billing/manifest.d.ts
+/** The `billing` block's manifest (ADR 0029). */
+export declare const billingBlock: BlockOf<"billing", typeof createBilling, BillingEvents>;
+//#endregion
+export { type Billing, type BillingCustomer, type BillingCustomerUpdate, type BillingEventData, type BillingEvents, type BillingOptions, type BillingStatus, type BlockTransport, type CheckoutItem, type CheckoutOptions, type CheckoutStarted, type CustomerDetails, type PlanCatalog, type PlanChange, type PlanOption, type PlanPickerActions, type PlanPickerController, type PlanPickerControllerOptions, type PlanPickerSnapshot, type PlatformListOptions, type SeatSync, type StripeClient, type StripeEvent, type StripeEventOutcome, type StripeRow, type StripeSource, type StripeTaxId, type SubscriptionItem, type TenantStripeRow, createPlanPickerController, dbTransport, rpcTransport, signStripeWebhook, sqlTransport, stripeInboxVerify, verifyStripeWebhook };

package/dist/blocks/billing/index.js

@@ -1,17 +1,22 @@
-import { n as dbError } from "../../errors-2M6CKMP4.js";
-import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-DEqHCMKP.js";
+import { n as dbError } from "../../errors-8i6tSICm.js";
+import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-BlgnMB0H.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { r as blockEmitter } from "../../block-events-DTxU5tfr.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
-import { S as recordOf, _ as optionalInstant, i as blockCall, j as textOf, n as applyTemporal, v as optionalText, y as pageOf } from "../../block-helpers-Cy3pB96I.js";
-import { a as signStripeWebhook, o as stripeInboxVerify, s as verifyStripeWebhook } from "../../verify-CJbYfADA.js";
-import { n as entitlementMembers } from "../../entitlements-BYFf0Cdh.js";
-import { t as lazyStripe } from "../../stripe-v-Y2lmop.js";
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { r as blockEmitter } from "../../block-events-DD9Q_NUz.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { C as optionalText, D as recordOf, I as textOf, S as optionalInstant, n as applyTemporal, o as blockCall, w as pageOf } from "../../block-helpers-CfG_MvDR.js";
+import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { a as signStripeWebhook, o as stripeInboxVerify, s as verifyStripeWebhook } from "../../verify-EQcC3Khp.js";
+import { r as entitlementMembers } from "../../entitlements-BvU5dLpW.js";
+import { t as lazyStripe } from "../../stripe-XZrSmDTf.js";
+import { t as billingSqlOptions } from "../../options-CZk_fbbg.js";
+import { t as createPlanPickerController } from "../../client-i8glKhxh.js";
 //#region src/blocks/billing/stripe-helpers.ts
 const ORGANIZATION_KEY = "organization_id";
 const SEAT_EVENT = /(?:^|\.)organization\.(?:member_added|member_removed|member_left|role_changed)$/;
 function subscriptionItemOf(value) {
-	if (!isRecord(value)) return void 0;
+	if (!isRecord(value)) return;
 	return {
 		subscriptionId: textOf(value["subscription"]),
 		itemId: textOf(value["item"]),
@@ -248,7 +253,7 @@ function createBilling(options) {
 		max_rows: list.limit ?? 50
 	}, rows);
 	const ownInvoice = (organizationId, invoiceId) => invoices(organizationId, { limit: 500 }).andThen((list) => Promise.resolve(list.some((row) => row["id"] === invoiceId) ? ok(invoiceId) : err(dbError("not_found", "This tenant has no such invoice", { hint: "BILLING_INVOICE_NOT_FOUND" }))));
-	return {
+	return withBlockHooks({
 		customer,
 		ensureCustomer,
 		changePlan: (organizationId, change) => priceOf(change).andThen((price) => subscription(organizationId).andThen(async (found) => {
@@ -394,7 +399,33 @@ function createBilling(options) {
 			for (const [tenant, id] of latest) await syncSeats(tenant, { key: id }).orThrow();
 		} }),
 		handleStripeEvent
-	};
+	}, options.hooks, {
+		block: "billing",
+		...options.logger ? { logger: options.logger } : {}
+	});
 }
 //#endregion
-export { createBilling, dbTransport, rpcTransport, signStripeWebhook, sqlTransport, stripeInboxVerify, verifyStripeWebhook };
+//#region src/blocks/billing/events.ts
+/** The `billing` block's event types, for its manifest and `onBlockEvent`. */
+const billingEvents = defineEvents({
+	"billing.customer_linked": event(),
+	"billing.checkout_completed": event(),
+	"billing.subscription_created": event(),
+	"billing.subscription_updated": event(),
+	"billing.subscription_deleted": event(),
+	"billing.seats_synced": event()
+});
+//#endregion
+//#region src/blocks/billing/manifest.ts
+/** The `billing` block's manifest (ADR 0029). */
+const billingBlock = defineBlock({
+	name: "billing",
+	sql: ["billing"],
+	options: { billing: billingSqlOptions },
+	events: billingEvents,
+	create: createBilling,
+	category: "commerce",
+	recipes: ["plan-picker"]
+});
+//#endregion
+export { billingBlock, billingEvents, createBilling, createPlanPickerController, dbTransport, rpcTransport, signStripeWebhook, sqlTransport, stripeInboxVerify, verifyStripeWebhook };

package/dist/blocks/billing/react/index.d.ts

@@ -0,0 +1,34 @@
+import { f as Result } from "../../../result-Cj3yWhjH.js";
+import { i as PlanPickerActions, n as PlanCatalog, r as PlanOption, s as PlanPickerSnapshot, t as CheckoutStarted } from "../../../client-DjTRlN3a.js";
+//#region src/blocks/billing/react/index.d.ts
+export interface UsePlanPickerOptions<P extends {
+  readonly key: string;
+}> {
+  /** The plans and the current one, such as a server action; it throws on failure. */
+  readonly load: () => Promise<PlanCatalog<P>>;
+  /** What a server already loaded: the first load is skipped. */
+  readonly initial?: PlanCatalog<P>;
+  /** A server action that starts Checkout for a plan key and returns its URL. */
+  readonly checkout: (plan: string) => Promise<Result<CheckoutStarted>>;
+  /** Opens the Checkout URL: `location.assign` on the web, `WebBrowser.openBrowserAsync` in React Native. */
+  readonly open: (url: string) => void | Promise<void>;
+}
+export interface PlanPickerState<P> extends PlanPickerSnapshot<P>, PlanPickerActions {
+  /** The current plan's entry in `plans`. */
+  readonly active: P | undefined;
+}
+/**
+ * The plans with the tenant's current one, for a plan picker. `choose`
+ * starts Checkout through the server action you pass and opens the URL it
+ * returns; Stripe is only ever called on the server. The same hook runs in
+ * React DOM and React Native.
+ *
+ * ```tsx
+ * const { plans, current, pending, choose } = usePlanPicker({ load, checkout, open });
+ * ```
+ */
+export declare function usePlanPicker<P extends {
+  readonly key: string;
+} = PlanOption>(options: UsePlanPickerOptions<P>): PlanPickerState<P>;
+//#endregion
+export type { CheckoutStarted, PlanCatalog, PlanOption };

package/dist/blocks/billing/react/index.js

@@ -0,0 +1,36 @@
+"use client";
+import { n as useLatest, t as useController } from "../../../react-controller-Xn-IU44p.js";
+import { t as useBlockEnv } from "../../../react-env-Cc7Vf6eb.js";
+import { t as createPlanPickerController } from "../../../client-i8glKhxh.js";
+//#region src/blocks/billing/react/index.ts
+/**
+* The plans with the tenant's current one, for a plan picker. `choose`
+* starts Checkout through the server action you pass and opens the URL it
+* returns; Stripe is only ever called on the server. The same hook runs in
+* React DOM and React Native.
+*
+* ```tsx
+* const { plans, current, pending, choose } = usePlanPicker({ load, checkout, open });
+* ```
+*/
+function usePlanPicker(options) {
+	const { auth } = useBlockEnv();
+	const latest = useLatest(options);
+	const view = useController(() => {
+		const { initial } = latest.current;
+		return createPlanPickerController({
+			auth,
+			load: () => latest.current.load(),
+			...initial === void 0 ? {} : { initial },
+			checkout: (plan) => latest.current.checkout(plan),
+			open: (url) => latest.current.open(url)
+		});
+	}, [auth, latest]).view;
+	const active = view.plans?.find((plan) => plan.key === view.current);
+	return {
+		...view,
+		active
+	};
+}
+//#endregion
+export { usePlanPicker };

package/dist/blocks/billing/react/server.d.ts

@@ -0,0 +1,7 @@
+import { n as PlanCatalog, r as PlanOption, t as CheckoutStarted } from "../../../client-DjTRlN3a.js";
+import { PlanPickerState, UsePlanPickerOptions, usePlanPicker as usePlanPicker$1 } from "./index.js";
+//#region src/blocks/billing/react/server.d.ts
+/** The `react-server` build of `usePlanPicker`: read the plan catalog and `billing.status()` instead. */
+export declare const usePlanPicker: typeof usePlanPicker$1;
+//#endregion
+export type { CheckoutStarted, PlanCatalog, PlanOption, PlanPickerState, UsePlanPickerOptions };

package/dist/blocks/billing/react/server.js

@@ -0,0 +1,7 @@
+//#region src/blocks/billing/react/server.ts
+/** The `react-server` build of `usePlanPicker`: read the plan catalog and `billing.status()` instead. */
+const usePlanPicker = () => {
+	throw new Error("better-supabase: usePlanPicker() runs in Client Components only. In Server Components read your plan catalog and `billing.status()` instead.");
+};
+//#endregion
+export { usePlanPicker };

package/dist/blocks/billing/solid/index.d.ts

@@ -0,0 +1,15 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-DqlvYFZa.js";
+import { i as PlanPickerActions, o as PlanPickerControllerOptions, r as PlanOption, s as PlanPickerSnapshot } from "../../../client-DjTRlN3a.js";
+//#region src/blocks/billing/solid/index.d.ts
+/**
+ * `createPlanPickerController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function usePlanPicker<P extends {
+  readonly key: string;
+} = PlanOption>(options: BlockOptions<PlanPickerControllerOptions<P>>): SolidController<PlanPickerSnapshot<P>, PlanPickerActions>;
+//#endregion
+export type { BlockOptions, PlanOption, PlanPickerActions, PlanPickerControllerOptions, PlanPickerSnapshot, SolidController };

package/dist/blocks/billing/solid/index.js

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+import { t as createPlanPickerController } from "../../../client-i8glKhxh.js";
+//#region src/blocks/billing/solid/index.ts
+/**
+* `createPlanPickerController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function usePlanPicker(options) {
+	return useBlockController(createPlanPickerController, options);
+}
+//#endregion
+export { usePlanPicker };

package/dist/blocks/billing/svelte/index.d.ts

@@ -0,0 +1,15 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DxxHEHxD.js";
+import { i as PlanPickerActions, o as PlanPickerControllerOptions, r as PlanOption, s as PlanPickerSnapshot } from "../../../client-DjTRlN3a.js";
+//#region src/blocks/billing/svelte/index.d.ts
+/**
+ * `createPlanPickerController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function usePlanPicker<P extends {
+  readonly key: string;
+} = PlanOption>(options: BlockOptions<PlanPickerControllerOptions<P>>): SvelteController<PlanPickerSnapshot<P>, PlanPickerActions>;
+//#endregion
+export type { BlockOptions, PlanOption, PlanPickerActions, PlanPickerControllerOptions, PlanPickerSnapshot, SvelteController };

package/dist/blocks/billing/svelte/index.js

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+import { t as createPlanPickerController } from "../../../client-i8glKhxh.js";
+//#region src/blocks/billing/svelte/index.ts
+/**
+* `createPlanPickerController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function usePlanPicker(options) {
+	return useBlockController(createPlanPickerController, options);
+}
+//#endregion
+export { usePlanPicker };

package/dist/blocks/billing/vue/index.d.ts

@@ -0,0 +1,15 @@
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-HPfMTDa2.js";
+import { i as PlanPickerActions, o as PlanPickerControllerOptions, r as PlanOption, s as PlanPickerSnapshot } from "../../../client-DjTRlN3a.js";
+//#region src/blocks/billing/vue/index.d.ts
+/**
+ * `createPlanPickerController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function usePlanPicker<P extends {
+  readonly key: string;
+} = PlanOption>(options: BlockOptions<PlanPickerControllerOptions<P>>): VueController<PlanPickerSnapshot<P>, PlanPickerActions>;
+//#endregion
+export type { BlockOptions, PlanOption, PlanPickerActions, PlanPickerControllerOptions, PlanPickerSnapshot, VueController };

package/dist/blocks/billing/vue/index.js

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+import { t as createPlanPickerController } from "../../../client-i8glKhxh.js";
+//#region src/blocks/billing/vue/index.ts
+/**
+* `createPlanPickerController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function usePlanPicker(options) {
+	return useBlockController(createPlanPickerController, options);
+}
+//#endregion
+export { usePlanPicker };

package/dist/blocks/bookings/index.d.ts

@@ -0,0 +1,36 @@
+import { tt as SchedulingEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { C as createBookings, S as bookingOf, _ as Bookings, a as createAvailableSlotsController, b as PublicBookingService, c as BookingCustomer, d as BookingExpirePayload, f as BookingRange, g as BookingStatus, h as BookingSlot, i as AvailableSlotsSnapshot, l as BookingDuration, m as BookingServiceInput, n as AvailableSlotsController, o as BOOKING_EXPIRE_QUEUE, p as BookingResourceInput, r as AvailableSlotsOptions, s as Booking, t as AvailableSlotsActions, u as BookingExceptionInput, v as BookingsOptions, x as WeeklyHours, y as PlacedBooking } from "../../client-hyP_nS5R.js";
+import { t as EventCalendarEvent } from "../../event-calendar-DJXXMJ3x.js";
+//#region src/blocks/bookings/event-calendar.d.ts
+interface BookingEventOptions {
+  /** The title of a booking. Default the customer's name, else `Booking`. */
+  readonly titleOf?: (booking: Booking) => string;
+  /** The color of a booking. Default none; holds are always read-only. */
+  readonly colorOf?: (booking: Booking) => string | undefined;
+}
+/**
+ * Bookings as event calendar events for a resource view (ReUI's Event
+ * Calendar with `resources`, or a schedule): each booking sits on its
+ * resource's row. Cancelled bookings are left out.
+ */
+export declare function toEventCalendarBookings(bookings: readonly Booking[], options?: BookingEventOptions): EventCalendarEvent<Booking>[];
+/** Slots grouped by their local date (`YYYY-MM-DD`), in start order, for a day-by-day picker. */
+export declare function slotsByDay(slots: readonly BookingSlot[]): Map<string, BookingSlot[]>;
+//#endregion
+//#region src/blocks/bookings/events.d.ts
+/** The events of the `bookings` block: type to data. */
+type BookingsEvents = {
+  readonly "booking.reserved": SchedulingEventData;
+  readonly "booking.confirmed": SchedulingEventData;
+  readonly "booking.cancelled": SchedulingEventData;
+  readonly "booking.expired": SchedulingEventData;
+};
+/** The `bookings` block's event types, for its manifest and `onBlockEvent`. */
+export declare const bookingsEvents: Events<BookingsEvents>;
+//#endregion
+//#region src/blocks/bookings/manifest.d.ts
+/** The `bookings` block's manifest (ADR 0029). */
+export declare const bookingsBlock: BlockOf<"bookings", typeof createBookings, BookingsEvents>;
+//#endregion
+export { type AvailableSlotsActions, type AvailableSlotsController, type AvailableSlotsOptions, type AvailableSlotsSnapshot, BOOKING_EXPIRE_QUEUE, type Booking, type BookingCustomer, type BookingDuration, type BookingEventOptions, type BookingExceptionInput, type BookingExpirePayload, type BookingRange, type BookingResourceInput, type BookingServiceInput, type BookingSlot, type BookingStatus, type Bookings, type BookingsEvents, type BookingsOptions, type PlacedBooking, type PublicBookingService, type WeeklyHours, bookingOf, createAvailableSlotsController, createBookings };

package/dist/blocks/bookings/index.js

@@ -0,0 +1,28 @@
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { n as bookingOf, r as createBookings, t as BOOKING_EXPIRE_QUEUE } from "../../bookings-0XnhHNLM.js";
+import { n as slotsByDay, r as toEventCalendarBookings, t as createAvailableSlotsController } from "../../client-DG7FwgZD.js";
+import { t as bookingsSqlOptions } from "../../options-XgfTctbI.js";
+//#region src/blocks/bookings/events.ts
+/** The `bookings` block's event types, for its manifest and `onBlockEvent`. */
+const bookingsEvents = defineEvents({
+	"booking.reserved": event(),
+	"booking.confirmed": event(),
+	"booking.cancelled": event(),
+	"booking.expired": event()
+});
+//#endregion
+//#region src/blocks/bookings/manifest.ts
+/** The `bookings` block's manifest (ADR 0029). */
+const bookingsBlock = defineBlock({
+	name: "bookings",
+	sql: ["bookings"],
+	options: { bookings: bookingsSqlOptions },
+	events: bookingsEvents,
+	create: createBookings,
+	client: "bookings",
+	category: "scheduling",
+	recipes: ["booking-page", "availability-editor"]
+});
+//#endregion
+export { BOOKING_EXPIRE_QUEUE, bookingOf, bookingsBlock, bookingsEvents, createAvailableSlotsController, createBookings, slotsByDay, toEventCalendarBookings };

package/dist/blocks/bookings/react/index.d.ts

@@ -0,0 +1,31 @@
+import { _ as Bookings, i as AvailableSlotsSnapshot, t as AvailableSlotsActions } from "../../../client-hyP_nS5R.js";
+import { t as VisibleRange } from "../../../range-p5V4rBhZ.js";
+//#region src/blocks/bookings/react/index.d.ts
+export interface UseAvailableSlotsOptions {
+  readonly serviceId: string;
+  /** The visible range, as a date picker or schedule reports it. */
+  readonly range: VisibleRange;
+  /** The zone slot times are shown in. Default each resource's. */
+  readonly tz?: string;
+  readonly resourceId?: string;
+  /** A share-link token: loads and holds slots as a guest. */
+  readonly token?: string;
+  /** The schema the calls go to. Default `better_supabase`. */
+  readonly schema?: string;
+}
+export interface AvailableSlotsState extends AvailableSlotsSnapshot, Omit<AvailableSlotsActions, "setRange"> {
+  readonly client: Bookings;
+}
+/**
+ * The open slots of a service in the visible range, for a headless date and
+ * time picker or a schedule such as ReUI's.
+ *
+ * ```tsx
+ * const slots = useAvailableSlots({ serviceId, range });
+ * slots.days.get("2030-03-04")?.map((slot) => (
+ *   <button onClick={() => slots.hold(slot)}>{slot.localStart.toPlainTime().toString()}</button>
+ * ));
+ * ```
+ */
+export declare function useAvailableSlots(options: UseAvailableSlotsOptions): AvailableSlotsState;
+//#endregion