permdock 0.7.0 → 0.9.0

package/dist/{types-g7Oy6Zg4.d.ts → types-CN0LsqbK.d.ts}

@@ -1,20 +1,22 @@
-import { Un as GrantedDecision, an as EmailCategory, nn as DeliveryEvent, rn as DeliveryFailureCause, tn as DeliveryChannel } from "./policy-types-B-F-qAZk.js";
-import { s as CloudEvent } from "./sink-Cp_Eot9W.js";
-import { t as ApprovalPrompt } from "./approval-prompt-K0faOLFp.js";
+import { Yn as GrantedDecision, cn as DeliveryEvent, dn as EmailCategory, ln as DeliveryFailureCause, sn as DeliveryChannel } from "./policy-types-DGIO_gxq.js";
+import { s as CloudEvent } from "./sink-B5zoUW_O.js";
+import { t as ApprovalPrompt } from "./approval-prompt-3BqWczTt.js";
 //#region src/delivery/types.d.ts
 /**
  * Who a delivery goes to. `{ principal }` names an app principal and the
  * address the server loaded for it on `channel`. `{ address }` alone is an
  * email or chat identity that resolves through
- * `PrincipalSource.principalByIdentity`; with no principal linked it is
- * refused unless `trusted` is set for an address the server loaded itself,
- * such as a customer's billing email, and then the sender must hold the
- * permission.
+ * `PrincipalSource.principalByIdentity`; with no principal linked it is refused
+ * unless `trusted` is set for an address the server loaded itself, such as a
+ * customer's billing email, and then the sender must hold the permission.
  */
 type Recipient = {
   readonly principal: string;
   readonly channel: DeliveryChannel;
-  /** An RFC 5322 `addr-spec`, a chat platform user id, or an https webhook endpoint. */
+  /**
+   * An RFC 5322 `addr-spec`, a chat platform user id, or an https webhook
+   * endpoint.
+   */
   readonly address: string;
   /** The chat platform (`slack`, `teams`, …). */
   readonly provider?: string;
@@ -26,28 +28,43 @@ type Recipient = {
   /** The chat platform; required for a chat address. */
   readonly provider?: string;
   readonly workspace?: string;
-  /** `true` only for an address the server loaded itself, never one from a request. */
+  /**
+   * `true` only for an address the server loaded itself, never one from a
+   * request.
+   */
   readonly trusted?: boolean;
 };
-/** One-click unsubscribe (RFC 8058): an https URL, plus an optional `mailto:` address. */
+/**
+ * One-click unsubscribe (RFC 8058): an https URL, plus an optional `mailto:`
+ * address.
+ */
 type EmailUnsubscribe = {
   readonly url: string;
   readonly mailto?: string;
 };
 type EmailMessage = {
-  /** Defaults to the router's `from`. A name-addr (`Acme <billing@acme.test>`) is allowed here. */
+  /**
+   * Defaults to the router's `from`. A name-addr (`Acme <billing@acme.test>`)
+   * is allowed here.
+   */
   readonly from?: string;
   readonly replyTo?: string;
   readonly subject: string;
   readonly text: string;
   readonly html?: string;
-  /** Extra headers. `Auto-Submitted` and the `List-Unsubscribe` pair are the router's. */
+  /**
+   * Extra headers. `Auto-Submitted` and the `List-Unsubscribe` pair are the
+   * router's.
+   */
   readonly headers?: Readonly<Record<string, string>>;
   readonly category: EmailCategory;
   /** Required on `notification`, ignored on every other category. */
   readonly unsubscribe?: EmailUnsubscribe | ((target: DeliveryTarget<"email">) => EmailUnsubscribe);
 };
-/** An email as a transport receives it: `from` set and the standards headers added. */
+/**
+ * An email as a transport receives it: `from` set and the standards headers
+ * added.
+ */
 type OutgoingEmail = Omit<EmailMessage, "from" | "unsubscribe" | "headers"> & {
   readonly from: string;
   readonly headers: Readonly<Record<string, string>>;
@@ -76,9 +93,9 @@ type TransportMessages = {
   readonly webhook: WebhookMessage;
 };
 /**
- * A recipient the router checked: the granted decision that let it through
- * and the address in the form the channel compares. A transport refuses a
- * target without a granted `decision` (`isDeliveryTarget`).
+ * A recipient the router checked: the granted decision that let it through and
+ * the address in the form the channel compares. A transport refuses a target
+ * without a granted `decision` (`isDeliveryTarget`).
  */
 type DeliveryTarget<C extends DeliveryChannel = DeliveryChannel> = {
   readonly channel: C;
@@ -91,7 +108,10 @@ type DeliveryTarget<C extends DeliveryChannel = DeliveryChannel> = {
   readonly decision: GrantedDecision;
 };
 type TransportOptions = {
-  /** Stable for one delivery id and recipient: the provider's `Idempotency-Key` and the `webhook-id`. */
+  /**
+   * Stable for one delivery id and recipient: the provider's `Idempotency-Key`
+   * and the `webhook-id`.
+   */
   readonly idempotencyKey: string;
   /** The delivery id every recipient of one `deliver` call shares. */
   readonly delivery: string;
@@ -113,19 +133,19 @@ type TransportItem<C extends DeliveryChannel = DeliveryChannel> = {
   readonly options: TransportOptions;
 };
 /**
- * One channel's sender. `deliver` resolves to a result; a throw or a
- * rejection counts as a retryable `unavailable` failure.
+ * One channel's sender. `deliver` resolves to a result; a throw or a rejection
+ * counts as a retryable `unavailable` failure.
  */
 type DeliveryTransport<C extends DeliveryChannel = DeliveryChannel> = {
   readonly channel: C;
   /** The provider name delivery events carry (`resend`, `chat-sdk`, `webhook`). */
   readonly name: string;
-  deliver(target: DeliveryTarget<C>, message: TransportMessages[C], options: TransportOptions): DeliveryResult | Promise<DeliveryResult>;
+  deliver: (target: DeliveryTarget<C>, message: TransportMessages[C], options: TransportOptions) => DeliveryResult | Promise<DeliveryResult>;
   /**
-   * Sends several deliveries in one provider call, one result per item in
-   * item order. The router uses it for two or more ready recipients.
+   * Sends several deliveries in one provider call, one result per item in item
+   * order. The router uses it for two or more ready recipients.
    */
-  deliverBatch?(items: readonly TransportItem<C>[]): readonly DeliveryResult[] | Promise<readonly DeliveryResult[]>;
+  deliverBatch?: (items: readonly TransportItem<C>[]) => readonly DeliveryResult[] | Promise<readonly DeliveryResult[]>;
   /** The most items one `deliverBatch` call takes. Defaults to 100. */
   readonly batchSize?: number;
 };
@@ -141,7 +161,10 @@ type DeliveryTransports = {
   readonly webhook?: WebhookTransport;
 };
 type DeliverOptions = {
-  /** Keep it across retries so each recipient's idempotency key repeats. Defaults to `dlv_` and a random UUID. */
+  /**
+   * Keep it across retries so each recipient's idempotency key repeats.
+   * Defaults to `dlv_` and a random UUID.
+   */
   readonly id?: string;
   /** The approval request id a prompt is delivered for, on every event. */
   readonly approval?: string;

package/dist/{types-CeIscIKp.d.ts → types-CWBsAwqn.d.ts}

@@ -1,24 +1,27 @@
-import { Gt as Snapshot, dt as TokenVerifier, ot as SnapshotSource } from "./policy-types-B-F-qAZk.js";
-import { n as DescribeMessages } from "./describe-O0SwYIK8.js";
-import { h as ClientStoreOptions } from "./types-CKV71kKh.js";
-import { t as PermDockDefaults } from "./types-CQVEQawv.js";
+import { Zt as Snapshot, ct as SnapshotSource, ht as TokenVerifier } from "./policy-types-DGIO_gxq.js";
+import { n as DescribeMessages } from "./describe-BbFPBSms.js";
+import { _ as ClientStoreOptions } from "./types-tQB2CEnY.js";
+import { t as PermDockDefaults } from "./types-rCRV4Ge-.js";
 import { ReactNode } from "react";
 //#region src/react-native/types.d.ts
 type SnapshotStorage = {
   /** Names the implementation in errors and events. */
   readonly name?: string;
-  getItem(key: string): string | null | Promise<string | null>;
-  setItem(key: string, value: string): void | Promise<void>;
-  removeItem(key: string): void | Promise<void>;
+  getItem: (key: string) => string | null | Promise<string | null>;
+  setItem: (key: string, value: string) => void | Promise<void>;
+  removeItem: (key: string) => void | Promise<void>;
 };
 type NativeRevalidate = "launch" | "focus" | number;
 /**
- * Calls `listener` when the app changes state; `active` is `false` when it
- * goes to the background. A listener called without an argument counts as
- * a return to the foreground.
+ * Calls `listener` when the app changes state; `active` is `false` when it goes
+ * to the background. A listener called without an argument counts as a return
+ * to the foreground.
  */
 type SubscribeForeground = (listener: (active?: boolean) => void) => () => void;
-/** Calls `listener` with `false` when the device loses connectivity and `true` when it returns. */
+/**
+ * Calls `listener` with `false` when the device loses connectivity and `true`
+ * when it returns.
+ */
 type SubscribeOnline = (listener: (online: boolean) => void) => () => void;
 type ReactNativePermDockProviderProps = {
   readonly storage: SnapshotStorage;
@@ -29,7 +32,10 @@ type ReactNativePermDockProviderProps = {
   readonly subjectId: string | null;
   readonly snapshot?: Snapshot | string;
   readonly snapshotUrl?: string;
-  /** Hydrates from the device's own rows (`localSnapshot`); with `snapshotUrl` too, the latest answer wins. */
+  /**
+   * Hydrates from the device's own rows (`localSnapshot`); with `snapshotUrl`
+   * too, the latest answer wins.
+   */
   readonly source?: SnapshotSource;
   readonly endpoint?: string;
   readonly approvals?: string;
@@ -51,6 +57,11 @@ type ReactNativePermDockProviderProps = {
   readonly onClear?: () => void;
   /** Milliseconds between approval status polls. Defaults to 2000. */
   readonly approvalInterval?: number;
+  /**
+   * Triggers that refresh the snapshot, such as `eventSourceRefresh(url)`; read
+   * when the store is built.
+   */
+  readonly refreshOn?: ClientStoreOptions["refreshOn"];
   readonly children: ReactNode;
 };
 //#endregion

package/dist/{types-DqzsnlSA.js → types-CcUXciSj.js}

@@ -1,4 +1,4 @@
-import { a as durationOf } from "./time-DkWjdL98.js";
+import { a as durationOf } from "./time-nR1JesoH.js";
 //#region src/approvals/errors.ts
 var ApprovalError = class extends Error {
 	name = "ApprovalError";
@@ -21,7 +21,10 @@ const CODES = /* @__PURE__ */ new Set([
 function isApprovalErrorCode(value) {
 	return typeof value === "string" && CODES.has(value);
 }
-/** Matches by `name` and `code`, so an error from another copy of the module still maps. */
+/**
+* Matches by `name` and `code`, so an error from another copy of the module
+* still maps.
+*/
 function isApprovalError(value) {
 	if (!(value instanceof Error) || value.name !== "ApprovalError") return false;
 	const code = Reflect.get(value, "code");
@@ -30,9 +33,15 @@ function isApprovalError(value) {
 //#endregion
 //#region src/approvals/types.ts
 const APPROVAL_HEADER = "PermDock-Approval";
-/** Seconds a request stays open when neither the store nor the call sets a `ttl`. */
+/**
+* Seconds a request stays open when neither the store nor the call sets a
+* `ttl`.
+*/
 const DEFAULT_APPROVAL_TTL = 3600;
-/** The approvals a request needs in total: `approvers.quorum` (or 1), or the sum of its stages' quorums. */
+/**
+* The approvals a request needs in total: `approvers.quorum` (or 1), or the sum
+* of its stages' quorums.
+*/
 function approvalQuorum(request) {
 	const stages = request.approvers?.stages;
 	if (stages !== void 0) return stages.reduce((sum, stage) => sum + (stage.quorum ?? 1), 0);
@@ -48,7 +57,10 @@ function escalationOpenAt(request) {
 	if (seconds === void 0) return;
 	return Date.parse(request.createdAt) + seconds * 1e3;
 }
-/** The instant from which a stage's own `escalation.to` may approve it, in epoch milliseconds; `undefined` when it has none or `after` does not parse. */
+/**
+* The instant from which a stage's own `escalation.to` may approve it, in epoch
+* milliseconds; `undefined` when it has none or `after` does not parse.
+*/
 function stageEscalationOpenAt(request, stage) {
 	const seconds = durationOf(stage.escalation?.after);
 	if (seconds === void 0) return;