better-supabase 0.12.0 → 0.13.0

package/dist/client-BMcjLG0V.d.ts

@@ -1,263 +0,0 @@
-/// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, b as DbError, f as Result, t as AsyncResult } from "./result-BREt7qOh.js";
-import { B as TableKey, a as AnyModels, i as AnyFunctions } from "./types-BrpW5ixT.js";
-import { n as Logger } from "./logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "./standard-BcUQuUgu.js";
-import { t as BlockTransport } from "./block-transport-DezJPPA0.js";
-import { i as CursorPageOptions, r as BlockTemporalOptions } from "./block-helpers-CjcQM1yA.js";
-import { n as BlockHooks } from "./block-hooks-DcPJHztl.js";
-import { n as ExtraFields, r as FieldsOf } from "./block-fields-DnaDbgZS.js";
-import { i as EventSink, t as CloudEvent } from "./cloud-event-DXkNoI6v.js";
-import { t as BetterSupabase } from "./define-DYZnvAbs.js";
-import { p as SubscriptionStatus } from "./topic-DAY_HOX2.js";
-import { n as TopicPort } from "./watch-topic-C79ZW5-R.js";
-import { i as ListDefinition } from "./list-query-aXr2WkGA.js";
-import { n as Controller, t as AuthPort } from "./controller-BZhiIb-N.js";
-//#region src/blocks/comments/comments.d.ts
-interface CommentsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
-  /**
-   * A Standard Schema for the comment's extra columns
-   * (`blocks.comments.options.extraColumns`), keyed by database name. It
-   * types and parses them on reads, and validates them on `create` and
-   * `edit`.
-   */
-  readonly fields?: S;
-  /** `withBlockHooks` hooks around the client's methods. */
-  readonly hooks?: NoInfer<BlockHooks<Comments<FieldsOf<S>>>>;
-  /** Receives the errors `after` hooks throw. Default: `console`. */
-  readonly logger?: Logger;
-  readonly transport: BlockTransport;
-  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. Default `better_supabase`. */
-  readonly schema?: string;
-  readonly mappers?: readonly ErrorMapper[];
-  /**
-   * The user ids a comment mentions when the call passes no `mentions`,
-   * such as the mention nodes of a rich-text `document`. Default
-   * `mentionsIn(body)`.
-   */
-  readonly mentionsOf?: (comment: {
-    readonly body: string;
-    readonly document: unknown;
-  }) => readonly string[];
-}
-/** A comment. `F` types the extra columns the `fields` schema describes. */
-interface Comment<F extends object = Record<never, never>> {
-  readonly id: string;
-  readonly organizationId: string;
-  readonly subjectType: string;
-  readonly subjectId: string;
-  /** `undefined` once the author's account is deleted. */
-  readonly authorId: string | undefined;
-  /** Empty for a deleted comment. */
-  readonly body: string;
-  /** The rich-text document an editor wrote, next to `body` as its plain text. */
-  readonly document: unknown;
-  readonly mentions: readonly string[];
-  readonly parentId: string | undefined;
-  readonly createdAt: Temporal.Instant;
-  readonly editedAt: Temporal.Instant | undefined;
-  readonly deletedAt: Temporal.Instant | undefined;
-  /** The extra columns, keyed by database name. */
-  readonly fields: ExtraFields<F>;
-}
-interface NewComment<F extends object = Record<never, never>> {
-  readonly organizationId: string;
-  readonly subjectType: string;
-  readonly subjectId: string;
-  readonly body: string;
-  /** A rich-text document (any JSON); keep `body` as its plain text. */
-  readonly document?: unknown;
-  /** User ids; default `mentionsOf`, or the ids `mentionsIn(body)` finds. */
-  readonly mentions?: readonly string[];
-  /** A reply: the parent must be on the same subject. */
-  readonly parentId?: string;
-  /** The extra columns to set, keyed by database name. */
-  readonly fields?: Partial<F>;
-}
-interface CommentEdit<F extends object = Record<never, never>> {
-  readonly body: string;
-  /** A new document; `null` removes it, and leaving it out keeps the current one. */
-  readonly document?: unknown;
-  /** Default `mentionsOf`, or the ids `mentionsIn(body)` finds. */
-  readonly mentions?: readonly string[];
-  /** The extra columns to set, keyed by database name; others keep their value. */
-  readonly fields?: Partial<F>;
-}
-/**
- * Where a timeline entry comes from: `event` for an `activity_entries` row
- * that `activitySink()` wrote, `audit` for an audit log entry on the
- * subject's row (with the `audit` and `subjects` modules), `delivery` for a
- * notification delivery about the subject (with `notifications`) and `run`
- * for a workflow run on it (with `workflows`).
- */
-type ActivitySource = "event" | "audit" | "delivery" | "run";
-interface ActivityEntry {
-  /** An `activity_entries` id, or the audit entry's, delivery's or run's id. */
-  readonly id: string;
-  readonly source: ActivitySource;
-  readonly organizationId: string;
-  readonly type: string;
-  readonly actorId: string | undefined;
-  readonly subjectType: string | undefined;
-  readonly subjectId: string | undefined;
-  readonly summary: string | undefined;
-  readonly data: Readonly<Record<string, unknown>>;
-  readonly occurredAt: Temporal.Instant;
-}
-interface ActivityHistoryOptions extends CursorPageOptions<Temporal.Instant> {
-  /** Entries before this instant, for paging back. */
-  readonly cursor?: Temporal.Instant;
-  /** Default 50, at most 500. */
-  readonly limit?: number;
-  /** The kinds of entry to return; all of them when left out. */
-  readonly sources?: readonly ActivitySource[];
-}
-interface ListCommentsOptions extends CursorPageOptions<Temporal.Instant> {
-  /** Comments created after this instant, for polling a thread. */
-  readonly cursor?: Temporal.Instant;
-  /**
-   * The id of the last comment you have, next to `cursor`, so comments
-   * created in the same instant as it aren't skipped.
-   */
-  readonly cursorId?: string;
-  /** Default 100, at most 500. */
-  readonly limit?: number;
-  /** Comments to skip, for page-number paging. */
-  readonly offset?: number;
-}
-/** `F` is the extra fields `options.fields` describes. */
-interface Comments<F extends object = Record<never, never>> {
-  create(comment: NewComment<F>): AsyncResult<Comment<F>>;
-  /** Only the author edits; `not_found` when the caller can't see it. */
-  edit(id: string, edit: CommentEdit<F>): AsyncResult<Comment<F>>;
-  /** Soft-deletes (the author, or a member with `comments.moderate`). */
-  remove(id: string): AsyncResult<boolean>;
-  /** A subject's thread, oldest first, deleted comments as placeholders. */
-  list(organizationId: string, subjectType: string, subjectId: string, options?: ListCommentsOptions): AsyncResult<readonly Comment<F>[]>;
-  /**
-   * How many comments each subject has that the caller can read, deleted
-   * ones left out, such as for a counter on each row of a list. Subjects
-   * without comments are 0.
-   */
-  counts(organizationId: string, subjectType: string, subjectIds: readonly string[]): AsyncResult<Readonly<Record<string, number>>>;
-  /**
-   * Copies a subject's thread to another subject in the tenant, keeping
-   * authors, times and replies; returns how many comments it copied. Needs a
-   * service-role transport.
-   */
-  copy(organizationId: string, from: {
-    readonly type: string;
-    readonly id: string;
-  }, to: {
-    readonly type: string;
-    readonly id: string;
-  }): AsyncResult<number>;
-  /**
-   * The activity feed of a tenant, newest first, or one subject's timeline
-   * with `subject`. Members with `activity.read` see it. With the `subjects`
-   * module, an entry on a registered subject type needs `can_subject` read,
-   * and a subject's timeline also lists its audit log entries
-   * (`source: "audit"`) when `audit` is installed with its read policy, the
-   * deliveries of notifications about it (`source: "delivery"`, for members
-   * who also hold `notifications.send`) and its workflow runs
-   * (`source: "run"`, as the runs' read policy allows).
-   */
-  history(organizationId: string, subject?: {
-    readonly type: string;
-    readonly id: string;
-  }, options?: ActivityHistoryOptions): AsyncResult<readonly ActivityEntry[]>;
-}
-/**
- * The user ids mentioned in a body written as `@[Ada](<user id>)`, the
- * markup mention inputs produce, in order and without repeats.
- */
-declare function mentionsIn(body: string): readonly string[];
-/** Comments over the `comments` module's functions, as the caller. */
-declare function createComments<S extends StandardSchemaV1 | undefined = undefined>(options: CommentsOptions<S>): Comments<FieldsOf<S>>;
-/** What an activity entry says about an event; `null` skips the event. */
-interface ActivityDescription {
-  readonly summary?: string;
-  readonly actorId?: string;
-  readonly subjectType?: string;
-  readonly subjectId?: string;
-  readonly data?: Readonly<Record<string, unknown>>;
-}
-interface ActivitySinkOptions {
-  /** A service-role transport: `record_activity()` is granted to `service_role` only. */
-  readonly transport: BlockTransport;
-  readonly schema?: string;
-  /** The outbox `typePrefix`, stripped from the stored type. Default `dev.better-supabase`. */
-  readonly typePrefix?: string;
-  /** Types to keep, exact or ending in `.*`. Default every event with a tenant. */
-  readonly types?: readonly string[];
-  /** Summarizes an event, or returns `null` to skip it. */
-  readonly describe?: (event: CloudEvent, type: string) => ActivityDescription | null | undefined;
-}
-/**
- * An outbox sink that writes events into the activity feed:
- * `outbox.relay('activity', activitySink({ transport }))`. Events without a
- * tenant (`partitionkey`) are skipped, and a replayed event writes nothing.
- */
-declare function activitySink(options: ActivitySinkOptions): EventSink;
-type ActivitySort = "newest" | "oldest";
-type ActivityFacet = "type" | "actor" | "subjectType" | "subjectId";
-/**
- * A cursor-paged list over `activity_entries` (generate types for the
- * `better_supabase` schema to get it in your models), newest first,
- * filtered by type, actor and subject. Members with `activity.read` see
- * their tenants' entries, less those on a registered subject that
- * `can_subject` doesn't let them read (with the `subjects` module). It
- * reads the table, so it lists no audit entries; `history()` does.
- */
-declare function activityListQuery<M extends AnyModels, D, Fn extends AnyFunctions, E, T extends TableKey<M>>(betterSupabase: BetterSupabase<M, D, Fn, E>, table: T, options?: {
-  readonly pageSize?: number;
-  readonly maxPageSize?: number;
-}): ListDefinition<M, T, E, ActivitySort, ActivityFacet>;
-//#endregion
-//#region src/blocks/comments/client.d.ts
-interface CommentsControllerOptions {
-  readonly client: Pick<Comments, "list" | "create" | "edit" | "remove">;
-  readonly auth: AuthPort;
-  readonly ports: {
-    readonly topic: TopicPort;
-  };
-  /** The organization; the thread waits without one. */
-  readonly organizationId: string | null;
-  readonly subjectType: string;
-  readonly subjectId: string;
-  /**
-   * A private topic that hears of new comments on the subject, such as a
-   * `realtime-tables` topic on the comments table. Each message loads the
-   * thread again. Default `null`: the thread loads again after its own
-   * writes only.
-   */
-  readonly topic?: string | null;
-  /** The most comments to load, default 100, at most 500. */
-  readonly limit?: number;
-}
-interface CommentsSnapshot {
-  /** The thread, oldest first, deleted comments as placeholders; `undefined` until the first load. */
-  readonly comments: readonly Comment[] | undefined;
-  readonly status: SubscriptionStatus;
-  readonly error: DbError | undefined;
-}
-/** A reply, a rich-text document or explicit mentions for `add`. */
-type CommentDraft = Pick<NewComment, "document" | "mentions" | "parentId">;
-interface CommentsActions {
-  /** Posts a comment on the subject; a failure is also kept in `error`. */
-  readonly add: (body: string, draft?: CommentDraft) => Promise<Result<Comment>>;
-  /** Edits one of the caller's comments. */
-  readonly edit: (id: string, edit: CommentEdit) => Promise<Result<Comment>>;
-  /** Soft-deletes a comment: it stays in the thread as a placeholder. */
-  readonly remove: (id: string) => Promise<Result<boolean>>;
-  readonly refresh: () => Promise<void>;
-}
-type CommentsController = Controller<CommentsSnapshot, CommentsActions>;
-/**
- * One subject's comment thread for the signed-in user: loads it, keeps it
- * current after `add`, `edit` and `remove`, and loads it again for each
- * message on `topic`.
- */
-declare function createCommentsController(options: CommentsControllerOptions): CommentsController;
-//#endregion
-export { mentionsIn as C, createComments as S, CommentsOptions as _, CommentsSnapshot as a, activityListQuery as b, ActivityEntry as c, ActivitySinkOptions as d, ActivitySort as f, Comments as g, CommentEdit as h, CommentsControllerOptions as i, ActivityFacet as l, Comment as m, CommentsActions as n, createCommentsController as o, ActivitySource as p, CommentsController as r, ActivityDescription as s, CommentDraft as t, ActivityHistoryOptions as u, ListCommentsOptions as v, activitySink as x, NewComment as y };

package/dist/client-BN_fXOs7.d.ts

@@ -1,39 +0,0 @@
-import { n as Controller } from "./controller-BZhiIb-N.js";
-import { a as UndoToken } from "./undo-BsdYRox7.js";
-//#region src/blocks/undo/client.d.ts
-interface UndoEntry {
-  readonly id: number;
-  /** What the toast or menu shows, e.g. "Moved 3 tasks". */
-  readonly label: string;
-  readonly token: UndoToken;
-}
-interface UndoStackOptions {
-  /** Applies a token, e.g. a server action that calls `createUndo().apply(token)`. */
-  readonly apply: (token: UndoToken) => Promise<unknown>;
-  /** How many entries to keep; older ones drop off. Default 20. */
-  readonly limit?: number | undefined;
-}
-interface UndoSnapshot {
-  /** Newest last. */
-  readonly entries: readonly UndoEntry[];
-  readonly canUndo: boolean;
-  /** Whether an undo is running. */
-  readonly pending: boolean;
-  /** What the last failed undo threw; cleared by the next push or undo. */
-  readonly error: unknown;
-}
-interface UndoActions {
-  /** Adds a token; a `null` token (a change with no inverse) is ignored. */
-  readonly push: (token: UndoToken | null | undefined, label?: string) => void;
-  /**
-   * Applies the newest entry and removes it. A failed undo removes it too,
-   * since its rows changed since, and sets `error`. Resolves whether it worked.
-   */
-  readonly undo: () => Promise<boolean>;
-  readonly clear: () => void;
-}
-type UndoController = Controller<UndoSnapshot, UndoActions>;
-/** A stack of undo tokens on the client, for a toast's Undo button or a Cmd+Z handler. */
-declare function createUndoController(options: UndoStackOptions): UndoController;
-//#endregion
-export { UndoStackOptions as a, UndoSnapshot as i, UndoController as n, createUndoController as o, UndoEntry as r, UndoActions as t };

package/dist/client-BONsuFYf.d.ts

@@ -1,100 +0,0 @@
-import { p as SubscriptionStatus } from "./topic-DAY_HOX2.js";
-import { n as TopicPort } from "./watch-topic-C79ZW5-R.js";
-import { l as StoragePort } from "./ports-BCDIbC_U.js";
-import { n as Controller, t as AuthPort } from "./controller-BZhiIb-N.js";
-//#region src/blocks/inbox/client.d.ts
-/** Loads one list, e.g. a server action that calls `inbox.conversations.list()`. */
-type InboxSource<T> = () => Promise<readonly T[]>;
-interface InboxListSnapshot<T> {
-  /** `undefined` until the first load. */
-  readonly items: readonly T[] | undefined;
-  readonly status: SubscriptionStatus;
-  readonly error: unknown;
-}
-interface InboxListActions {
-  readonly refresh: () => Promise<void>;
-}
-interface Ports {
-  readonly topic: TopicPort;
-}
-interface InboxControllerOptions<T> {
-  readonly auth: AuthPort;
-  readonly ports: Ports;
-  /** The organization; the controller joins `inbox:org:<id>`. `null` waits. */
-  readonly organizationId: string | null;
-  readonly load: InboxSource<T>;
-  /** `blockConfig.inbox.options.topic` from `blocks.generated.ts`. Defaults to `inbox`. */
-  readonly topic?: string;
-  /** Runs for each broadcast, e.g. to show a toast for `message`. */
-  readonly onMessage?: (event: string, payload: unknown) => void;
-}
-type InboxController<T> = Controller<InboxListSnapshot<T>, InboxListActions>;
-/**
- * The staff view of an organization's conversations, kept current: loads,
- * then loads again after each ping on `inbox:org:<id>` and on rejoin.
- */
-declare function createInboxController<T>(options: InboxControllerOptions<T>): InboxController<T>;
-interface ConversationSnapshot<T> extends InboxListSnapshot<T> {
-  /** User ids typing now, the caller left out. */
-  readonly typing: readonly string[];
-}
-interface ConversationActions extends InboxListActions {
-  /** Tells the others the caller is typing; call it on input, throttled. */
-  readonly setTyping: (typing: boolean) => void;
-}
-interface ConversationControllerOptions<T> {
-  readonly auth: AuthPort;
-  readonly ports: Ports;
-  /** `null` waits, e.g. before the widget opens a conversation. */
-  readonly conversationId: string | null;
-  /** The messages, oldest first. */
-  readonly load: InboxSource<T>;
-  readonly topic?: string;
-  /** How long a typing ping counts. Defaults to 5000 ms. */
-  readonly typingMs?: number;
-}
-type ConversationController<T> = Controller<ConversationSnapshot<T>, ConversationActions>;
-/**
- * One conversation's messages, kept current over `inbox:<id>`, with typing
- * pings between staff and the contact. Notes never reach this topic.
- */
-declare function createConversationController<T>(options: ConversationControllerOptions<T>): ConversationController<T>;
-interface InboxWidgetControllerOptions<T> {
-  readonly auth: AuthPort;
-  readonly ports: Ports & {
-    readonly storage?: StoragePort;
-  };
-  /**
-   * Opens the visitor's conversation, e.g. a server action that calls
-   * `inbox.conversations.open(inboxId, { message })` with the visitor's
-   * transport. Returns its id.
-   */
-  readonly open: (message: string) => Promise<string>;
-  /** Sends into the open conversation. */
-  readonly send: (conversationId: string, message: string) => Promise<void>;
-  readonly load: (conversationId: string) => Promise<readonly T[]>;
-  /**
-   * Remembers the conversation across reloads in the storage port.
-   * Defaults to `better-supabase:inbox-widget`; `null` forgets it.
-   */
-  readonly storageKey?: string | null;
-  readonly topic?: string;
-}
-interface InboxWidgetSnapshot<T> extends ConversationSnapshot<T> {
-  readonly conversationId: string | null;
-}
-interface InboxWidgetActions extends ConversationActions {
-  /** Opens the conversation with the first message, or sends into it. */
-  readonly submit: (message: string) => Promise<void>;
-  /** Forgets the conversation, so the next message opens a new one. */
-  readonly reset: () => void;
-}
-type InboxWidgetController<T> = Controller<InboxWidgetSnapshot<T>, InboxWidgetActions>;
-/**
- * The visitor side of an in-app inbox: the first message opens the
- * conversation, later ones go into it, and the messages and typing pings
- * stay current. Visitors without an account sign in anonymously first.
- */
-declare function createInboxWidgetController<T>(options: InboxWidgetControllerOptions<T>): InboxWidgetController<T>;
-//#endregion
-export { InboxController as a, InboxListSnapshot as c, InboxWidgetController as d, InboxWidgetControllerOptions as f, createInboxWidgetController as g, createInboxController as h, ConversationSnapshot as i, InboxSource as l, createConversationController as m, ConversationController as n, InboxControllerOptions as o, InboxWidgetSnapshot as p, ConversationControllerOptions as r, InboxListActions as s, ConversationActions as t, InboxWidgetActions as u };

package/dist/client-BPn9XhAM.d.ts

@@ -1,218 +0,0 @@
-/// <reference lib="esnext.temporal" />
-import { b as DbError, t as AsyncResult } from "./result-BREt7qOh.js";
-import { n as Logger } from "./logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "./standard-BcUQuUgu.js";
-import { n as BlockOptions } from "./block-helpers-CjcQM1yA.js";
-import { n as BlockHooks } from "./block-hooks-DcPJHztl.js";
-import { r as FieldsOf } from "./block-fields-DnaDbgZS.js";
-import { g as JobHandler } from "./types-BEEFkNFY.js";
-import { n as Controller } from "./controller-BZhiIb-N.js";
-import { t as VisibleRange } from "./range-p5V4rBhZ.js";
-//#region src/blocks/bookings/bookings.d.ts
-interface BookingsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockOptions {
-  /**
-   * A Standard Schema for the booking columns the app adds
-   * (`blocks.bookings.options.extraColumns`), keyed by column name. The
-   * customer object of `hold` and `public.hold` carries them; the schema
-   * validates them there, which returns a `validation` error for a bad
-   * value, and types and parses them on every booking read.
-   */
-  readonly fields?: S;
-  /** `withBlockHooks` hooks around the client's methods. */
-  readonly hooks?: NoInfer<BlockHooks<Bookings<FieldsOf<S>>>>;
-  /** Receives the errors `after` hooks throw. Default: `console`. */
-  readonly logger?: Logger;
-}
-/** The queue each hold enqueues a job on, to expire it when its time is up. */
-declare const BOOKING_EXPIRE_QUEUE = "bookings.expire-holds";
-/** A duration as a `Temporal.Duration` or an ISO 8601 / Postgres interval string. */
-type BookingDuration = Temporal.Duration | string;
-interface BookingRange {
-  readonly from: Temporal.Instant;
-  readonly until: Temporal.Instant;
-}
-interface BookingResourceInput {
-  readonly id?: string;
-  readonly name?: string;
-  /** What the resource is, matched against a service's `resourceKinds`. Default `staff`. */
-  readonly kind?: string;
-  /** How many bookings can overlap: seats in a class, desks in a room. Default 1. */
-  readonly capacity?: number;
-  /** The IANA zone its weekly hours are in. Default `UTC`. */
-  readonly tz?: string;
-  /** The calendar confirmed bookings are copied into, when the calendar block is installed. */
-  readonly calendarId?: string | null;
-  readonly active?: boolean;
-}
-/** Weekly opening hours: `weekday` 1 is Monday, times are `HH:MM` in the resource's zone. */
-interface WeeklyHours {
-  readonly weekday: 1 | 2 | 3 | 4 | 5 | 6 | 7;
-  readonly start: string;
-  readonly end: string;
-}
-interface BookingExceptionInput {
-  readonly startsAt: Temporal.Instant;
-  readonly endsAt: Temporal.Instant;
-  /** `true` opens the resource outside its hours. Default `false`, which closes it. */
-  readonly available?: boolean;
-  readonly reason?: string;
-}
-interface BookingServiceInput {
-  readonly id?: string;
-  readonly name?: string;
-  readonly duration?: BookingDuration;
-  readonly bufferBefore?: BookingDuration;
-  readonly bufferAfter?: BookingDuration;
-  /** The resource kinds that can serve it; empty means every resource. */
-  readonly resourceKinds?: readonly string[];
-  /** The distance between slot starts. Default the duration. */
-  readonly step?: BookingDuration | null;
-  /** How far ahead a slot must start. */
-  readonly minNotice?: BookingDuration;
-  /** How long a hold keeps the slot. Default 10 minutes. */
-  readonly holdFor?: BookingDuration;
-  /** Minutes before the start that reminders go out. Default one day. */
-  readonly reminderOffsets?: readonly number[];
-  readonly active?: boolean;
-}
-interface BookingSlot {
-  readonly resourceId: string;
-  readonly startsAt: Temporal.Instant;
-  readonly endsAt: Temporal.Instant;
-  /** The start as wall-clock time in the zone asked for, else the resource's. */
-  readonly localStart: Temporal.PlainDateTime;
-  /** Free seats at this time. */
-  readonly seats: number;
-}
-interface BookingCustomer {
-  readonly name?: string;
-  readonly email?: string;
-  /** Only managers can book for another user. */
-  readonly userId?: string;
-  readonly notes?: string;
-}
-type BookingStatus = "hold" | "confirmed" | "cancelled";
-interface Booking {
-  readonly id: string;
-  readonly resourceId: string;
-  readonly serviceId: string;
-  readonly seat: number;
-  readonly startsAt: Temporal.Instant;
-  readonly endsAt: Temporal.Instant;
-  readonly status: BookingStatus;
-  readonly holdExpiresAt?: Temporal.Instant;
-  readonly customerName?: string;
-  readonly customerEmail?: string;
-  readonly customerUserId?: string;
-  readonly notes?: string;
-  readonly createdAt?: Temporal.Instant;
-  readonly cancelledAt?: Temporal.Instant;
-  readonly cancelReason?: string;
-}
-/** A new booking with the token that confirms or cancels it without signing in. Shown once. */
-interface PlacedBooking extends Booking {
-  readonly accessToken: string;
-}
-interface PublicBookingService {
-  readonly id: string;
-  readonly name: string;
-  /** The duration as Postgres prints an interval, such as `00:30:00`. */
-  readonly duration: string;
-  readonly resources: readonly {
-    readonly id: string;
-    readonly name: string;
-    readonly kind: string;
-    readonly tz: string;
-  }[];
-}
-/** The payload a hold enqueues on `bookings.expire-holds`. */
-interface BookingExpirePayload {
-  readonly bookingId?: string;
-}
-/** `F` is the extra booking fields `options.fields` describes. */
-interface Bookings<F extends object = Record<never, never>> {
-  saveResource(organizationId: string, input: BookingResourceInput): AsyncResult<{
-    readonly id: string;
-  }>;
-  /** Replaces a resource's weekly hours. Resolves to the number of rows. */
-  setAvailability(resourceId: string, hours: readonly WeeklyHours[]): AsyncResult<number>;
-  addException(resourceId: string, exception: BookingExceptionInput): AsyncResult<{
-    readonly id: string;
-  }>;
-  deleteException(id: string): AsyncResult<boolean>;
-  saveService(organizationId: string, input: BookingServiceInput): AsyncResult<{
-    readonly id: string;
-  }>;
-  /** The open slots of a service, at most 62 days at a time. */
-  availableSlots(serviceId: string, range: BookingRange, options?: {
-    readonly tz?: string;
-    readonly resourceId?: string;
-  }): AsyncResult<BookingSlot[]>;
-  /** Holds a slot for the service's `holdFor`, or books it with `confirm`. */
-  hold(serviceId: string, resourceId: string, startsAt: Temporal.Instant, customer?: BookingCustomer & Partial<F>, options?: {
-    readonly confirm?: boolean;
-  }): AsyncResult<PlacedBooking & F>;
-  confirm(bookingId: string): AsyncResult<Booking & F>;
-  cancel(bookingId: string, reason?: string): AsyncResult<Booking & F>;
-  /** The bookings that overlap the range, as the caller's policies allow. */
-  list(organizationId: string, range: BookingRange, options?: {
-    readonly resourceId?: string;
-  }): AsyncResult<(Booking & F)[]>;
-  /** Cancels every hold whose time is up. Service only. */
-  expireHolds(): AsyncResult<number>;
-  /** The handler for the `bookings.expire-holds` queue. */
-  readonly job: JobHandler<unknown>;
-  /** The public side, through a share link to a service (`subjectType: "booking_service"`). */
-  readonly public: {
-    service(token: string): AsyncResult<PublicBookingService>;
-    slots(token: string, range: BookingRange, options?: {
-      readonly tz?: string;
-    }): AsyncResult<BookingSlot[]>;
-    /** Holds a slot for a guest, who must give a name and an email. */
-    hold(token: string, resourceId: string, startsAt: Temporal.Instant, customer: BookingCustomer & Partial<F> & {
-      readonly name: string;
-      readonly email: string;
-    }): AsyncResult<PlacedBooking & F>;
-    confirm(bookingId: string, accessToken: string): AsyncResult<Booking & F>;
-    cancel(bookingId: string, accessToken: string): AsyncResult<Booking & F>;
-  };
-}
-/** A booking row as `hold_booking`, `list_bookings` and the others return it. */
-declare function bookingOf(value: unknown): Booking;
-declare function createBookings<S extends StandardSchemaV1 | undefined = undefined>(options: BookingsOptions<S>): Bookings<FieldsOf<S>>;
-//#endregion
-//#region src/blocks/bookings/client.d.ts
-interface AvailableSlotsOptions {
-  readonly client: Pick<Bookings, "availableSlots" | "hold"> & {
-    readonly public: Pick<Bookings["public"], "slots" | "hold">;
-  };
-  readonly serviceId: string;
-  /** The visible range; `setRange` changes 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;
-}
-interface AvailableSlotsSnapshot {
-  /** `undefined` until the first load. */
-  readonly slots: readonly BookingSlot[] | undefined;
-  /** The slots by local date (`YYYY-MM-DD`), for a day-by-day picker. */
-  readonly days: ReadonlyMap<string, readonly BookingSlot[]>;
-  readonly error: DbError | undefined;
-  /** True until the slots of the current range arrive. */
-  readonly loading: boolean;
-}
-interface AvailableSlotsActions {
-  readonly refresh: () => Promise<void>;
-  /** Holds a slot, then loads the range again. With a token, `customer` needs a name and an email. */
-  readonly hold: (slot: BookingSlot, customer?: BookingCustomer) => Promise<PlacedBooking | undefined>;
-  /** Shows another range; the current slots stay until its slots arrive. */
-  readonly setRange: (range: VisibleRange) => void;
-}
-type AvailableSlotsController = Controller<AvailableSlotsSnapshot, AvailableSlotsActions>;
-/** The open slots of a service in the visible range, for a headless date and time picker. */
-declare function createAvailableSlotsController(options: AvailableSlotsOptions): AvailableSlotsController;
-//#endregion
-export { createBookings as C, bookingOf as S, Bookings as _, createAvailableSlotsController as a, PublicBookingService as b, BookingCustomer as c, BookingExpirePayload as d, BookingRange as f, BookingStatus as g, BookingSlot as h, AvailableSlotsSnapshot as i, BookingDuration as l, BookingServiceInput as m, AvailableSlotsController as n, BOOKING_EXPIRE_QUEUE as o, BookingResourceInput as p, AvailableSlotsOptions as r, Booking as s, AvailableSlotsActions as t, BookingExceptionInput as u, BookingsOptions as v, WeeklyHours as x, PlacedBooking as y };