better-supabase 0.11.0 → 0.13.0

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

@@ -1,31 +1,34 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, f as Result, t as AsyncResult } from "../../result-BREt7qOh.js";
-import { J as NotificationEventData, o as EventHub, q as NotificationDeliveryEventData, st as SubjectEventData, wt as Events } from "../../events-P3raDX2E.js";
-import { m as RequestContext } from "../../plugin-D-95Q0w0.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { i as CursorPageOptions, r as BlockTemporalOptions } from "../../block-helpers-CjcQM1yA.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DcPJHztl.js";
-import { i as RowFields, r as FieldsOf } from "../../block-fields-DnaDbgZS.js";
-import { t as BlockProblemOptions } from "../../problem-DCDIQiTA.js";
-import { i as EventSink, t as CloudEvent } from "../../cloud-event-DXkNoI6v.js";
-import { g as SubscriberPolicy, i as AuthorizationHooks } from "../../authorization-hooks-mLi894KH.js";
-import { s as BlockOf } from "../../define-block-CPyJ95rq.js";
-import { n as VerifyOptions } from "../../signatures-BXlDXV3D.js";
-import { a as NotificationSubject, i as NotificationItem, n as NotificationMessage, o as RenderedText, r as NotificationSendResult, t as NotificationChannel } from "../../channel-D-LHCY11.js";
-import { a as DeliveryTransport, c as UnsubscribeTarget, i as DeliverySendOptions, l as mailHeaders, n as DeliveryMessages, o as EmailMessage, r as DeliveryReceipt, s as MailCategory, t as DeliveryChannel } from "../../delivery-BeHgwS3k.js";
-import { n as EmailChannelOptions, r as emailChannel, t as ComposedEmail } from "../../email-BcmbIWOX.js";
-import { a as NotificationsControllerOptions, c as unreadCount, i as NotificationsController, n as NotificationSource, o as NotificationsSnapshot, r as NotificationsActions, s as createNotificationsController, t as NotificationFeedOptions } from "../../client-ehjQ2tIT.js";
+import { T as ErrorMapper, f as Result, t as AsyncResult } from "../../result-mijqfoJN.js";
+import { i as RowFields, r as FieldsOf } from "../../block-fields-DnXkMney.js";
+import { J as NotificationEventData, o as EventHub, q as NotificationDeliveryEventData, st as SubjectEventData, wt as Events } from "../../events-DhGgwqQA.js";
+import { m as RequestContext } from "../../plugin-DouW0Kvg.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
+import { i as CursorPageOptions, r as BlockTemporalOptions } from "../../block-helpers-DyA5BAW4.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BadAniNI.js";
+import { t as BlockProblemOptions } from "../../problem-D_DEBfMn.js";
+import { i as EventSink, t as CloudEvent } from "../../cloud-event-CidL9jiw.js";
+import { g as SubscriberPolicy, i as AuthorizationHooks } from "../../authorization-hooks-HXVZXxUk.js";
+import { s as BlockOf } from "../../define-block-MyM4lH42.js";
+import { n as VerifyOptions } from "../../signatures-CzqfLlfV.js";
+import { a as NotificationSubject, i as NotificationItem, n as NotificationMessage, o as RenderedText, r as NotificationSendResult, t as NotificationChannel } from "../../channel-BjvGO39m.js";
+import { a as DeliveryTransport, c as UnsubscribeTarget, i as DeliverySendOptions, l as mailHeaders, n as DeliveryMessages, o as EmailMessage, r as DeliveryReceipt, s as MailCategory, t as DeliveryChannel } from "../../delivery-n6lZGuGx.js";
+import { n as EmailChannelOptions, r as emailChannel, t as ComposedEmail } from "../../email-tt2QqiSc.js";
+import { a as NotificationsControllerOptions, c as unreadCount, i as NotificationsController, n as NotificationSource, o as NotificationsSnapshot, r as NotificationsActions, s as createNotificationsController, t as NotificationFeedOptions } from "../../client-ysVOUgxM.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/blocks/notifications/api-types.d.ts
 /** Notification type to the Standard Schema of its `data`. */
 type NotificationTypes = Readonly<Record<string, StandardSchemaV1>>;
 type TypeName<K extends NotificationTypes> = keyof K & string;
 interface SendInput<D = unknown, F extends object = Record<never, never>> {
-  /** Who gets it. Watchers of `subject` and the `notification_audience` hook add more. */
+  /**
+   * Who gets it. Watchers of `subject` and the `notification_audience` hook add
+   * more.
+   */
   readonly recipients?: readonly string[];
   /**
-   * Also notify the users who hold this permission in `tenant`. Needs
-   * `tenant`. Without a holders template the send is refused.
+   * Also notify the users who hold this permission in `tenant`. Needs `tenant`.
+   * Without a holders template the send is refused.
    */
   readonly permission?: string;
   /** The organization; required when an authenticated user sends. */
@@ -43,8 +46,8 @@ interface SendInput<D = unknown, F extends object = Record<never, never>> {
   /** Also notify the user who caused it. Defaults to `false`. */
   readonly includeActor?: boolean;
   /**
-   * `participating` (default) reaches subject watchers at both levels;
-   * `all` is routine activity that only `all` watchers get.
+   * `participating` (default) reaches subject watchers at both levels; `all` is
+   * routine activity that only `all` watchers get.
    */
   readonly activity?: "participating" | "all";
   /** Create it already resolved, e.g. for a record of a finished approval. */
@@ -53,8 +56,8 @@ interface SendInput<D = unknown, F extends object = Record<never, never>> {
   readonly actorId?: string;
   /**
    * Add the watchers of `subject`. Defaults to `true`; `false` reaches only
-   * `recipients` and the audience hook (members ignoring the subject stay
-   * out either way).
+   * `recipients` and the audience hook (members ignoring the subject stay out
+   * either way).
    */
   readonly watchers?: boolean;
   /** Users left out after the watchers and the audience hook are added. */
@@ -155,8 +158,8 @@ interface DeliverOptions {
 interface DeliverResult {
   readonly sent: number;
   /**
-   * Deliveries not sent on purpose: the channel skipped them, the address
-   * is suppressed, or `audience` left the recipient out.
+   * Deliveries not sent on purpose: the channel skipped them, the address is
+   * suppressed, or `audience` left the recipient out.
    */
   readonly skipped: number;
   /**
@@ -166,7 +169,10 @@ interface DeliverResult {
   readonly failed: number;
 }
 type SuppressionReason = "bounce" | "complaint" | "manual";
-/** An address a channel stops sending to, written by a bounce or complaint webhook. */
+/**
+ * An address a channel stops sending to, written by a bounce or complaint
+ * webhook.
+ */
 interface SuppressInput {
   /** Stored in lower case. */
   readonly address: string;
@@ -260,37 +266,43 @@ interface Rendered<K extends string = string, D = unknown> extends NotificationI
   readonly actor?: NotificationActor | null;
 }
 /**
- * A notification as `get`, `list` and `page` return it: its `data` parsed
- * with its type's schema, so checking `type` narrows `data`.
+ * A notification as `get`, `list` and `page` return it: its `data` parsed with
+ * its type's schema, so checking `type` narrows `data`.
  */
 type NotificationOf<K extends NotificationTypes, F extends object = Record<never, never>> = { [N in TypeName<K>]: Rendered<N, StandardSchemaV1.InferOutput<K[N]>> & {
   readonly fields: RowFields<F>;
 }; }[TypeName<K>];
 interface NotificationsOptions<K extends NotificationTypes, H = undefined, S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
-  /** `sqlTransport(postgres.asUser(claims))`, or over `postgres.admin` for the service. */
+  /**
+   * `sqlTransport(postgres.asUser(claims))`, or over `postgres.admin` for the
+   * service.
+   */
   readonly transport: BlockTransport;
   /**
-   * Each type's `data` schema. `send` validates against it, and `get`,
-   * `list` and `page` parse stored data with it, so keep a schema able to
-   * read the notifications already sent (or purge them). A stored value it
-   * rejects is a `validation` error with the hint `NOTIFICATION_DATA_INVALID`;
-   * a type no longer listed keeps its data as stored.
+   * Each type's `data` schema. `send` validates against it, and `get`, `list`
+   * and `page` parse stored data with it, so keep a schema able to read the
+   * notifications already sent (or purge them). A stored value it rejects is a
+   * `validation` error with the hint `NOTIFICATION_DATA_INVALID`; a type no
+   * longer listed keeps its data as stored.
    */
   readonly types: K;
   /**
    * A Standard Schema for the events table's extra columns
-   * (`blocks.notifications.options.extraColumns`): `send` validates them,
-   * and `get`, `list` and `page` parse them.
+   * (`blocks.notifications.options.extraColumns`): `send` validates them, and
+   * `get`, `list` and `page` parse them.
    */
   readonly fields?: S;
   /** `withBlockHooks` hooks around the methods, such as a rule on `send`. */
   readonly hooks?: NoInfer<BlockHooks<Notifications<K, FieldsOf<S>>>>;
-  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. Default `better_supabase`. */
+  /**
+   * The module schema, or its API schema: `defineBlocks` passes it from
+   * `blocks.generated.ts`. Default `better_supabase`.
+   */
   readonly schema?: string;
   /**
-   * Loads what `render` needs for a whole page at once (actor names,
-   * subject titles), so a list of 50 items costs one query instead of 50.
-   * Its result reaches `render` as `context.hydrated`.
+   * Loads what `render` needs for a whole page at once (actor names, subject
+   * titles), so a list of 50 items costs one query instead of 50. Its result
+   * reaches `render` as `context.hydrated`.
    */
   readonly hydrate?: (items: readonly NotificationItem[], context: {
     readonly locale?: string;
@@ -307,21 +319,24 @@ interface NotificationsOptions<K extends NotificationTypes, H = undefined, S ext
   readonly channels?: readonly NotificationChannel[];
   /**
    * Adds the `email` channel (`emailChannel`) over a
-   * `DeliveryTransport<"email">`, such as `resendTransport`. Don't also
-   * list a channel named `email`.
+   * `DeliveryTransport<"email">`, such as `resendTransport`. Don't also list a
+   * channel named `email`.
    */
   readonly email?: EmailChannelOptions;
   /**
-   * Checks each claimed delivery's recipient before a channel sends it;
-   * a recipient it leaves out is skipped, and a throw retries the
-   * deliveries later. Defaults to `server.authorization.delivery.audience`;
-   * with `server.authorization` but no such policy, to
-   * `subjectReaders(transport)`, so a notification about a `config.subjects`
-   * record only reaches recipients who may read it. In-app recipients are
-   * decided in SQL (`holdersOf`, membership).
+   * Checks each claimed delivery's recipient before a channel sends it; a
+   * recipient it leaves out is skipped, and a throw retries the deliveries
+   * later. Defaults to `server.authorization.delivery.audience`; with
+   * `server.authorization` but no such policy, to `subjectReaders(transport)`,
+   * so a notification about a `config.subjects` record only reaches recipients
+   * who may read it. In-app recipients are decided in SQL (`holdersOf`,
+   * membership).
    */
   readonly audience?: SubscriberPolicy;
-  /** The `createServer` result, whose `authorization` hooks give the default `audience`. */
+  /**
+   * The `createServer` result, whose `authorization` hooks give the default
+   * `audience`.
+   */
   readonly server?: {
     readonly authorization?: AuthorizationHooks | undefined;
   };
@@ -340,19 +355,18 @@ interface NotificationsOptions<K extends NotificationTypes, H = undefined, S ext
   readonly mappers?: readonly ErrorMapper[];
 }
 /**
- * The `notifications` SQL module as typed calls. `send` validates the
- * data against its type's schema; the database checks the send permission,
- * leaves out the actor and non-members and applies subscriptions and
- * preferences.
+ * The `notifications` SQL module as typed calls. `send` validates the data
+ * against its type's schema; the database checks the send permission, leaves
+ * out the actor and non-members and applies subscriptions and preferences.
  */
 interface Notifications<K extends NotificationTypes, F extends object = Record<never, never>> {
   /** The notification id, or `null` when nobody was left to notify. */
   send<N extends TypeName<K>>(type: N, input: SendInput<StandardSchemaV1.InferInput<K[N]>, F>): AsyncResult<SentNotification | null>;
   /**
    * Sends up to 1000 notifications in one `send_notifications` call, with
-   * `send`'s checks per notification: one `Result` per item, in order, so a
-   * bad one never drops the others. The outer result fails only when the
-   * call does. Hooks on `send` don't run for these; hook `sendMany`.
+   * `send`'s checks per notification: one `Result` per item, in order, so a bad
+   * one never drops the others. The outer result fails only when the call does.
+   * Hooks on `send` don't run for these; hook `sendMany`.
    */
   sendMany(items: readonly SinkNotification<K, F>[]): AsyncResult<readonly Result<SentNotification | null>[]>;
   get(id: string, options?: Pick<ListOptions, "locale" | "include">): AsyncResult<NotificationOf<K, F> | null>;
@@ -414,14 +428,14 @@ interface Notifications<K extends NotificationTypes, F extends object = Record<n
   /** Sends pending deliveries through `channels`. Run it from a cron or a job. */
   deliver(options?: DeliverOptions): Promise<DeliverResult>;
   /**
-   * Deletes up to `batch` (10,000) notifications older than `olderThan`
-   * (`90 days`) with their recipients and deliveries. Service only.
+   * Deletes up to `batch` (10,000) notifications older than `olderThan` (`90
+   * days`) with their recipients and deliveries. Service only.
    */
   purge(olderThan?: string, batch?: number): AsyncResult<number>;
   /**
    * Stops `channel` from sending to an address; `deliver()` skips its
-   * deliveries. `true` when the address was not suppressed yet. Service
-   * only; `resendWebhook` calls it for bounces and complaints.
+   * deliveries. `true` when the address was not suppressed yet. Service only;
+   * `resendWebhook` calls it for bounces and complaints.
    */
   suppress(input: SuppressInput): AsyncResult<boolean>;
   /** Lifts a suppression. `true` when there was one. Service only. */
@@ -431,18 +445,18 @@ interface Notifications<K extends NotificationTypes, F extends object = Record<n
     readonly limit?: number;
   }): AsyncResult<readonly NotificationSuppression[]>;
   /**
-   * Records what a provider reported about a sent message: stores it on
-   * the delivery once per `providerEventId`, moves the delivery's provider
-   * status forward, suppresses the address on a bounce or a complaint, and
-   * emits `notification.<kind>` with the notification's subject. `null`
-   * when no delivery has that provider message id. Service only;
-   * `resendWebhook` calls it for every status.
+   * Records what a provider reported about a sent message: stores it on the
+   * delivery once per `providerEventId`, moves the delivery's provider status
+   * forward, suppresses the address on a bounce or a complaint, and emits
+   * `notification.<kind>` with the notification's subject. `null` when no
+   * delivery has that provider message id. Service only; `resendWebhook` calls
+   * it for every status.
    */
   recordDeliveryEvent(input: DeliveryEventInput): AsyncResult<RecordedDeliveryEvent | null>;
   /**
-   * The deliveries of the notifications about one record, newest first,
-   * each with its provider events: a record's sent emails. The service
-   * reads every tenant; a member needs the send permission in `tenant`.
+   * The deliveries of the notifications about one record, newest first, each
+   * with its provider events: a record's sent emails. The service reads every
+   * tenant; a member needs the send permission in `tenant`.
    */
   subjectDeliveries(options: {
     readonly subject: {
@@ -454,10 +468,10 @@ interface Notifications<K extends NotificationTypes, F extends object = Record<n
     readonly limit?: number;
   }): AsyncResult<readonly SubjectDelivery[]>;
   /**
-   * An `EventSink` that sends a notification for each event `map` returns
-   * one for. The key defaults to the event id and the tenant to its
-   * `partitionkey`, so a redelivered event sends nothing new. A failed send
-   * rejects, so the forwarder retries. The comments module already notifies
+   * An `EventSink` that sends a notification for each event `map` returns one
+   * for. The key defaults to the event id and the tenant to its `partitionkey`,
+   * so a redelivered event sends nothing new. A failed send rejects, so the
+   * forwarder retries. The comments module already notifies
    * `comment.mentioned`; don't map it again.
    */
   sink(options: NotificationSinkOptions<K>): EventSink;
@@ -467,9 +481,15 @@ type SinkNotification<K extends NotificationTypes, F extends object = Record<nev
   readonly type: N;
 } & SendInput<StandardSchemaV1.InferInput<K[N]>, F>; }[TypeName<K>];
 interface NotificationSinkOptions<K extends NotificationTypes> {
-  /** The notification for an event, or `null` to skip it. `event.type` has no `typePrefix`. */
+  /**
+   * The notification for an event, or `null` to skip it. `event.type` has no
+   * `typePrefix`.
+   */
   map(event: CloudEvent): SinkNotification<K> | null | Promise<SinkNotification<K> | null>;
-  /** Stripped from each event type before `map`. Defaults to `dev.better-supabase.`. */
+  /**
+   * Stripped from each event type before `map`. Defaults to
+   * `dev.better-supabase.`.
+   */
   readonly typePrefix?: string;
 }
 //#endregion
@@ -478,14 +498,20 @@ export declare function createNotifications<const K extends NotificationTypes, H
 //#endregion
 //#region src/blocks/notifications/transports/resend.d.ts
 interface ResendTransportOptions {
-  /** A Resend API key with sending access. Read it from your own env; the library never does. */
+  /**
+   * A Resend API key with sending access. Read it from your own env; the
+   * library never does.
+   */
   readonly apiKey: string;
   /** Defaults to `https://api.resend.com`. */
   readonly baseUrl?: string;
   /** Defaults to the global `fetch`. */
   readonly fetch?: typeof fetch;
 }
-/** A failed Resend call. `status` is the HTTP status, 0 when the request never got an answer. */
+/**
+ * A failed Resend call. `status` is the HTTP status, 0 when the request never
+ * got an answer.
+ */
 export declare class ResendError extends Error {
   readonly status: number;
   /** Resend's error name, such as `validation_error`. */
@@ -493,17 +519,17 @@ export declare class ResendError extends Error {
   constructor(status: number, message: string, code?: string);
 }
 /**
- * A `DeliveryTransport` over Resend's `POST /emails`. The delivery
- * id goes in the `Idempotency-Key` header, so a retried delivery sends one
- * email; the message category becomes a `category` tag.
+ * A `DeliveryTransport` over Resend's `POST /emails`. The delivery id goes in
+ * the `Idempotency-Key` header, so a retried delivery sends one email; the
+ * message category becomes a `category` tag.
  */
 export declare function resendTransport(options: ResendTransportOptions): DeliveryTransport;
 //#endregion
 //#region src/blocks/notifications/transports/resend-webhook.d.ts
 /**
  * What the handler writes through: `createNotifications` over the service
- * transport. Without `recordDeliveryEvent` (a custom writer), it only
- * writes suppressions.
+ * transport. Without `recordDeliveryEvent` (a custom writer), it only writes
+ * suppressions.
  */
 interface SuppressionWriter {
   suppress(input: SuppressInput): AsyncResult<boolean>;
@@ -512,8 +538,8 @@ interface SuppressionWriter {
 /**
  * The delivery event a Resend event reports, matched to the delivery by
  * `data.email_id`: `email.delivered`, `opened`, `clicked`, `bounced`,
- * `complained` and `delivery_delayed`. A `Transient` bounce doesn't
- * suppress the address. `undefined` for any other event.
+ * `complained` and `delivery_delayed`. A `Transient` bounce doesn't suppress
+ * the address. `undefined` for any other event.
  */
 export declare function resendDeliveryEvent(event: unknown, eventId?: string): DeliveryEventInput | undefined;
 interface ResendWebhookOptions extends BlockProblemOptions, VerifyOptions {
@@ -533,9 +559,9 @@ export declare function resendSuppressions(event: unknown, eventId?: string): Su
 /**
  * A `Request` handler for Resend's webhooks. It verifies the Svix (Standard
  * Webhooks) signature, records each delivery status on its delivery
- * (`recordDeliveryEvent`), writes a suppression for each bounced or
- * complaining address, and answers 204. A failed write answers 500 so
- * Resend retries; other events are acknowledged and ignored.
+ * (`recordDeliveryEvent`), writes a suppression for each bounced or complaining
+ * address, and answers 204. A failed write answers 500 so Resend retries; other
+ * events are acknowledged and ignored.
  */
 export declare function resendWebhook(options: ResendWebhookOptions): (request: Request) => Promise<Response>;
 //#endregion
@@ -548,7 +574,10 @@ type WatchedEventData = SubjectEventData & {
 interface WatcherRule<K extends NotificationTypes, N extends TypeName<K> = TypeName<K>> {
   /** The notification type to send. */
   readonly type: N;
-  /** `all` (the default) reaches only `all` watchers; `participating` reaches both levels. */
+  /**
+   * `all` (the default) reaches only `all` watchers; `participating` reaches
+   * both levels.
+   */
   readonly activity?: "participating" | "all";
   /** Users to notify besides the watchers, such as a reminder's owner. */
   readonly recipients?: (data: WatchedEventData) => readonly string[];
@@ -558,21 +587,21 @@ interface WatcherRule<K extends NotificationTypes, N extends TypeName<K> = TypeN
 }
 interface WatcherSinkOptions<K extends NotificationTypes> {
   /**
-   * Event type (without `typePrefix`) to the notification type, or a rule.
-   * Only subject-bound events (`SubjectEventType`) reach watchers; others
-   * are skipped.
+   * Event type (without `typePrefix`) to the notification type, or a rule. Only
+   * subject-bound events (`SubjectEventType`) reach watchers; others are
+   * skipped.
    */
   readonly types: Readonly<Record<string, TypeName<K> | WatcherRule<K> | undefined>>;
   /** Stripped from each event type. Defaults to `dev.better-supabase.`. */
   readonly typePrefix?: string;
 }
 /**
- * An outbox sink that notifies the watchers of the subject an event is
- * about: `outbox.relay('watchers', watcherSink(notifications, { types }))`.
- * It reads `SubjectEventData` (tenant, subject type and id) from any block's
- * event, leaves out the actor (`actorId` or `authorId`), and keys each
- * notification by the event id, so a replayed event sends nothing new.
- * Build `notifications` with a service transport.
+ * An outbox sink that notifies the watchers of the subject an event is about:
+ * `outbox.relay('watchers', watcherSink(notifications, { types }))`. It reads
+ * `SubjectEventData` (tenant, subject type and id) from any block's event,
+ * leaves out the actor (`actorId` or `authorId`), and keys each notification by
+ * the event id, so a replayed event sends nothing new. Build `notifications`
+ * with a service transport.
  */
 export declare function watcherSink<K extends NotificationTypes>(notifications: Pick<Notifications<K>, "sink">, options: WatcherSinkOptions<K>): EventSink;
 /** The outbox row fields `watcherHandler` reads; every `OutboxEvent` has them. */
@@ -586,11 +615,11 @@ interface WatchedOutboxEvent {
   readonly createdAt: Temporal.Instant;
 }
 /**
- * `watcherSink` as an outbox handler:
- * `outbox.consume('watchers', watcherHandler(notifications, { types }))`.
- * CloudEvents leave the actor out, so a sink can only skip the author a
- * payload names. The outbox row carries the actor of every event, so with
- * this handler whoever tags, moves or shares a subject is not notified of it.
+ * `watcherSink` as an outbox handler: `outbox.consume('watchers',
+ * watcherHandler(notifications, { types }))`. CloudEvents leave the actor out,
+ * so a sink can only skip the author a payload names. The outbox row carries
+ * the actor of every event, so with this handler whoever tags, moves or shares
+ * a subject is not notified of it.
  */
 export declare function watcherHandler<K extends NotificationTypes>(notifications: Pick<Notifications<K>, "sink">, options: WatcherSinkOptions<K>): (events: readonly WatchedOutboxEvent[]) => Promise<void>;
 //#endregion

package/dist/blocks/notifications/index.js

@@ -1,25 +1,25 @@
 import { t as DbException } from "../../db-exception-CnWcYPxL.js";
-import { n as dbError } from "../../errors-BV1SKTVs.js";
-import { t as temporal } from "../../temporal-required-nfZ87U-0.js";
-import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-DIeYscA3.js";
+import { n as dbError } from "../../errors-D7u24ZJH.js";
+import { t as temporal } from "../../temporal-required-Dt4mcPsi.js";
+import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-DIT_qp4G.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { n as validate } from "../../standard-B1BigegP.js";
-import { a as methodNotAllowed, o as problemResponse } from "../../problem-JRCohp1j.js";
+import { n as validate } from "../../standard-l10kE0yS.js";
+import { a as methodNotAllowed, o as problemResponse } from "../../problem-D0KDiYPk.js";
 import { t as MAX_BATCH } from "../../batch-limit-DKVQDz4o.js";
 import { t as notificationsSqlOptions } from "../../options-Dmg1Da9P.js";
-import { a as stripTypePrefix } from "../../cloud-event-CTh9Sr5w.js";
-import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
-import { r as blockEmitter } from "../../block-events-DD9Q_NUz.js";
-import { s as verifyWebhook } from "../../signatures-CeIoAelK.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-J7ZepTq2.js";
-import { C as optionalText, E as readBodyCapped, L as toBlockError, c as chunksOf, f as errorText, i as batchResultsOf, n as applyTemporal, o as blockCall, s as budget, v as nullableInstant, w as pageOf, y as nullableText } from "../../block-helpers-DkVZNDrj.js";
-import { t as subjectReaders } from "../../subject-readers-BpwUFJtp.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C22vuIUd.js";
-import { n as blockFields, s as rowFields } from "../../block-fields-Bv1hV855.js";
+import { a as stripTypePrefix } from "../../cloud-event-XsM53POL.js";
+import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
+import { r as blockEmitter } from "../../block-events-BURaqwyp.js";
+import { s as verifyWebhook } from "../../signatures-D8IoN3Rw.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
+import { C as optionalText, E as readBodyCapped, L as toBlockError, c as chunksOf, f as errorText, i as batchResultsOf, n as applyTemporal, o as blockCall, s as budget, v as nullableInstant, w as pageOf, y as nullableText } from "../../block-helpers-DwE32_gT.js";
+import { t as subjectReaders } from "../../subject-readers-BJzh7WF7.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
+import { n as blockFields, s as rowFields } from "../../block-fields-Cwd4c8m-.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { t as allowedSubscribers } from "../../subscribers-Cq--DL1E.js";
-import { t as mailHeaders } from "../../delivery-B1mKaOen.js";
-import { n as unreadCount, t as createNotificationsController } from "../../client-BpS8a6Fm.js";
+import { t as allowedSubscribers } from "../../subscribers-BvZxcd63.js";
+import { t as mailHeaders } from "../../delivery-Bm0jxmzI.js";
+import { n as unreadCount, t as createNotificationsController } from "../../client-Y_HnZGF4.js";
 //#region src/blocks/notifications/email.ts
 function defaultCompose(message) {
 	const text = message.text;
@@ -30,9 +30,9 @@ function defaultCompose(message) {
 	};
 }
 /**
-* A `NotificationChannel` named `email` that sends through `transport`,
-* with the delivery id as the idempotency key. A recipient without an
-* address is skipped.
+* A `NotificationChannel` named `email` that sends through `transport`, with
+* the delivery id as the idempotency key. A recipient without an address is
+* skipped.
 */
 function emailChannel(options) {
 	const { transport } = options;
@@ -199,7 +199,10 @@ const subjectDeliveryOf = (row) => ({
 		}];
 	})
 });
-/** The data of `notification.delivered` and `notification.failed` for one delivery. */
+/**
+* The data of `notification.delivered` and `notification.failed` for one
+* delivery.
+*/
 const deliveryData = (message, channel) => {
 	const notification = message.notification;
 	return {
@@ -218,7 +221,10 @@ function deliveryChannels(options) {
 	if (channels.some((channel) => channel.name === "email")) throw new TypeError("createNotifications: `email` adds the \"email\" channel; remove the channel named \"email\" from `channels`");
 	return [...channels, emailChannel(options.email)];
 }
-/** The event a delivery's audience check sees: the notification, as its recipients read it. */
+/**
+* The event a delivery's audience check sees: the notification, as its
+* recipients read it.
+*/
 const subscriberEventOf = (notification) => ({
 	type: notification.type,
 	tenant: notification.tenant,
@@ -272,7 +278,10 @@ function createNotifications(options) {
 		count: Number(isRecord(value) ? value["count"] ?? 0 : 0),
 		items: itemsOf(isRecord(value) ? value["items"] : [])
 	});
-	/** Parses each item's data with its type's schema, before `hydrate` and `render` see it. */
+	/**
+	* Parses each item's data with its type's schema, before `hydrate` and
+	* `render` see it.
+	*/
 	const parsed = async (items) => {
 		const out = [];
 		for (const item of items) {
@@ -366,8 +375,8 @@ function createNotifications(options) {
 		return "skipped";
 	};
 	/**
-	* Sends a claimed batch: suppressed addresses are skipped first, then
-	* each notification's remaining recipients go through `audience` once.
+	* Sends a claimed batch: suppressed addresses are skipped first, then each
+	* notification's remaining recipients go through `audience` once.
 	*/
 	async function deliverBatch(channel, rows, maxAttempts) {
 		const claimed = rows.map((row) => claimedOf(channel, row));
@@ -418,7 +427,10 @@ function createNotifications(options) {
 			return fail(channel, message, errorText(cause), maxAttempts);
 		}
 	}
-	/** `send_notification`'s argument for one send, after the type's schema and the fields. */
+	/**
+	* `send_notification`'s argument for one send, after the type's schema and
+	* the fields.
+	*/
 	const prepare = async (type, input) => {
 		const schemaOf = Object.hasOwn(options.types, type) ? options.types[type] : void 0;
 		if (schemaOf === void 0) return err(dbError("validation", `Unknown notification type "${type}"`, {
@@ -754,7 +766,10 @@ function createNotifications(options) {
 }
 //#endregion
 //#region src/blocks/notifications/transports/resend.ts
-/** A failed Resend call. `status` is the HTTP status, 0 when the request never got an answer. */
+/**
+* A failed Resend call. `status` is the HTTP status, 0 when the request never
+* got an answer.
+*/
 var ResendError = class extends Error {
 	status;
 	/** Resend's error name, such as `validation_error`. */
@@ -767,9 +782,9 @@ var ResendError = class extends Error {
 	}
 };
 /**
-* A `DeliveryTransport` over Resend's `POST /emails`. The delivery
-* id goes in the `Idempotency-Key` header, so a retried delivery sends one
-* email; the message category becomes a `category` tag.
+* A `DeliveryTransport` over Resend's `POST /emails`. The delivery id goes in
+* the `Idempotency-Key` header, so a retried delivery sends one email; the
+* message category becomes a `category` tag.
 */
 function resendTransport(options) {
 	if (options.apiKey === "") throw new TypeError("resendTransport needs an apiKey");
@@ -835,8 +850,8 @@ const instantOf = (value) => {
 /**
 * The delivery event a Resend event reports, matched to the delivery by
 * `data.email_id`: `email.delivered`, `opened`, `clicked`, `bounced`,
-* `complained` and `delivery_delayed`. A `Transient` bounce doesn't
-* suppress the address. `undefined` for any other event.
+* `complained` and `delivery_delayed`. A `Transient` bounce doesn't suppress
+* the address. `undefined` for any other event.
 */
 function resendDeliveryEvent(event, eventId) {
 	if (!isRecord(event) || !isRecord(event["data"])) return;
@@ -906,9 +921,9 @@ function resendSuppressions(event, eventId) {
 /**
 * A `Request` handler for Resend's webhooks. It verifies the Svix (Standard
 * Webhooks) signature, records each delivery status on its delivery
-* (`recordDeliveryEvent`), writes a suppression for each bounced or
-* complaining address, and answers 204. A failed write answers 500 so
-* Resend retries; other events are acknowledged and ignored.
+* (`recordDeliveryEvent`), writes a suppression for each bounced or complaining
+* address, and answers 204. A failed write answers 500 so Resend retries; other
+* events are acknowledged and ignored.
 */
 function resendWebhook(options) {
 	const limit = options.maxBodyBytes ?? 262144;
@@ -954,12 +969,12 @@ function subjectData(event) {
 	};
 }
 /**
-* An outbox sink that notifies the watchers of the subject an event is
-* about: `outbox.relay('watchers', watcherSink(notifications, { types }))`.
-* It reads `SubjectEventData` (tenant, subject type and id) from any block's
-* event, leaves out the actor (`actorId` or `authorId`), and keys each
-* notification by the event id, so a replayed event sends nothing new.
-* Build `notifications` with a service transport.
+* An outbox sink that notifies the watchers of the subject an event is about:
+* `outbox.relay('watchers', watcherSink(notifications, { types }))`. It reads
+* `SubjectEventData` (tenant, subject type and id) from any block's event,
+* leaves out the actor (`actorId` or `authorId`), and keys each notification by
+* the event id, so a replayed event sends nothing new. Build `notifications`
+* with a service transport.
 */
 function watcherSink(notifications, options) {
 	return notifications.sink({
@@ -990,11 +1005,11 @@ function watcherSink(notifications, options) {
 	});
 }
 /**
-* `watcherSink` as an outbox handler:
-* `outbox.consume('watchers', watcherHandler(notifications, { types }))`.
-* CloudEvents leave the actor out, so a sink can only skip the author a
-* payload names. The outbox row carries the actor of every event, so with
-* this handler whoever tags, moves or shares a subject is not notified of it.
+* `watcherSink` as an outbox handler: `outbox.consume('watchers',
+* watcherHandler(notifications, { types }))`. CloudEvents leave the actor out,
+* so a sink can only skip the author a payload names. The outbox row carries
+* the actor of every event, so with this handler whoever tags, moves or shares
+* a subject is not notified of it.
 */
 function watcherHandler(notifications, options) {
 	const sink = watcherSink(notifications, options);

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

@@ -1,11 +1,11 @@
-import { n as NotificationSource, o as NotificationsSnapshot, r as NotificationsActions, t as NotificationFeedOptions } from "../../../client-ehjQ2tIT.js";
+import { n as NotificationSource, o as NotificationsSnapshot, r as NotificationsActions, t as NotificationFeedOptions } from "../../../client-ysVOUgxM.js";
 //#region src/blocks/notifications/react/index.d.ts
 export type UseNotificationsOptions<T> = NotificationFeedOptions<T>;
 export interface NotificationsState<T> extends NotificationsSnapshot<T>, NotificationsActions {}
 /**
  * The signed-in user's notifications, kept current: loads them, then loads
- * again after each broadcast on `topic` and after the channel rejoins. The
- * same hook runs in React DOM and React Native.
+ * again after each broadcast on `topic` and after the channel rejoins. The same
+ * hook runs in React DOM and React Native.
  *
  * ```tsx
  * const { items, count } = useNotifications({