@visulima/notification 1.0.16 → 1.1.0

package/dist/packem_shared/types.d-BXfGenMH.d.ts

@@ -0,0 +1,34 @@
+import { N as NotificationEvent } from "./types.d-C7l7qdMG.js";
+/**
+ * Case-insensitive map of inbound request headers. Values may be a single string or
+ * an array (mirroring `node:http` and `Headers`); verifiers normalise both forms.
+ */
+type WebhookHeaders = Record<string, string | string[] | undefined>;
+/**
+ * A provider inbound-webhook verifier: validates the request signature and normalises
+ * the body into a {@link NotificationEvent}.
+ */
+interface WebhookVerifier {
+  /**
+   * Normalises a verified webhook body into a {@link NotificationEvent}.
+   * @param body The raw request body (string).
+   * @returns The normalised event, or `undefined` when the body is not a delivery event.
+   */
+  parse: (body: string) => NotificationEvent | undefined;
+  /**
+   * Verifies the request signature against the shared secret.
+   * @param payload The raw request body (string).
+   * @param headers The inbound request headers.
+   * @param secret The provider signing secret / auth token.
+   * @returns `true` when the signature is valid.
+   */
+  verify: (payload: string, headers: WebhookHeaders, secret: string) => Promise<boolean>;
+}
+/**
+ * Reads a header value case-insensitively, coercing array values to their first entry.
+ * @param headers The inbound headers.
+ * @param name The header name to read.
+ * @returns The header value, or `undefined` when absent.
+ */
+declare const getHeader: (headers: WebhookHeaders, name: string) => string | undefined;
+export { WebhookHeaders as W, WebhookVerifier as a, getHeader as g };

package/dist/packem_shared/utils-DuaeYOiD.js

@@ -0,0 +1 @@
+const a=n=>{if(typeof n=="string")return n},i=n=>{if(typeof n=="string")return n;if(typeof n=="number")return String(n)},c=n=>{const s=n===void 0?Number.NaN:Date.parse(n);return Number.isNaN(s)?new Date:new Date(s)},d=n=>{const s={};return n.forEach((e,t)=>{s[t]=e}),s},o=(n,s=200)=>Response.json(n,{headers:{"content-type":"application/json"},status:s}),p=()=>new Response(void 0,{status:204}),u=async(n,s,e)=>{const t=await e?.(n,s);return t instanceof Response?t:o({error:n},n==="invalid_body"?400:401)},f=n=>{if(n instanceof Response)return n},R=n=>{if(!(n===void 0||n instanceof Response))return n};export{a,f as b,R as c,c as d,i as e,d as h,o as j,p as n,u as r};

package/dist/packem_shared/verifyEd25519-lmU3nhP0.js

@@ -0,0 +1 @@
+import{s as n,u as y,f}from"./webcrypto-BPm3NDEm.js";const u=/^[0-9a-f]*$/iu,o=t=>{if(t.length%2!==0||!u.test(t))return;const r=new Uint8Array(new ArrayBuffer(t.length/2));for(let e=0;e<r.length;e+=1)r[e]=Number.parseInt(t.slice(e*2,e*2+2),16);return r},l=async(t,r,e,a)=>{const s=o(t),i=o(r);if(s===void 0||i===void 0)return!1;try{const c=await n().importKey("raw",s,{name:"Ed25519"},!1,["verify"]);return await n().verify({name:"Ed25519"},c,i,y(`${e}${a}`))}catch{return!1}},m=async(t,r,e)=>{try{const a=await n().importKey("raw",f(t),{name:"Ed25519"},!1,["verify"]);return await n().verify({name:"Ed25519"},a,f(r),y(e))}catch{return!1}};export{o as hexToBytes,l as verifyEd25519,m as verifyEd25519Base64};

package/dist/packem_shared/{webcrypto-Cz40u9vp.js → webcrypto-BPm3NDEm.js}

@@ -1 +1 @@
-const c=e=>new Uint8Array(new ArrayBuffer(e)),i=e=>{if(e.buffer instanceof ArrayBuffer)return e;const t=c(e.length);return t.set(e),t},r=()=>globalThis.crypto.subtle,d=e=>{const t=c(e);return globalThis.crypto.getRandomValues(t),t},l=e=>{const t=new TextEncoder().encode(e),n=c(t.length);return n.set(t),n},h=(...e)=>{let t=0;for(const o of e)t+=o.length;const n=c(t);let s=0;for(const o of e)n.set(o,s),s+=o.length;return n},u=e=>{let t="";for(const n of e)t+=n.toString(16).padStart(2,"0");return t},f=e=>{let t="";for(const n of e)t+=String.fromCodePoint(n);return btoa(t)},g=e=>{let t=f(e).replaceAll("+","-").replaceAll("/","_");for(;t.endsWith("=");)t=t.slice(0,-1);return t},A=e=>{const t=e.replaceAll("-","+").replaceAll("_","/"),n=t.padEnd(t.length+(4-t.length%4)%4,"="),s=atob(n),o=c(s.length);for(let a=0;a<s.length;a+=1)o[a]=s.codePointAt(a)??0;return o},b=(e,t)=>{const n=c(t);let s=e;for(let o=t-1;o>=0;o-=1)n[o]=s%256,s=Math.floor(s/256);return n},p=async e=>{const t=await r().digest("SHA-256",e);return new Uint8Array(t)},w=async(e,t)=>{const n=await r().importKey("raw",e,{hash:"SHA-256",name:"HMAC"},!1,["sign"]),s=await r().sign("HMAC",n,t);return new Uint8Array(s)},m=async(e,t,n)=>{const s=typeof e=="string"?l(e):i(e),o=typeof t=="string"?l(t):i(t),a=await r().importKey("raw",s,{hash:n,name:"HMAC"},!1,["sign"]),y=await r().sign("HMAC",a,o);return new Uint8Array(y)},B=async(e,t,n,s)=>{const o=await r().importKey("raw",t,"HKDF",!1,["deriveBits"]),a=await r().deriveBits({hash:"SHA-256",info:n,name:"HKDF",salt:e},o,s*8);return new Uint8Array(a)};export{u as a,g as b,h as c,B as d,b as e,A as f,p as g,m as h,w as i,d as r,r as s,f as t,l as u};
+const c=e=>new Uint8Array(new ArrayBuffer(e)),i=e=>{if(e.buffer instanceof ArrayBuffer)return e;const t=c(e.length);return t.set(e),t},r=()=>globalThis.crypto.subtle,d=e=>{const t=c(e);return globalThis.crypto.getRandomValues(t),t},l=e=>{const t=new TextEncoder().encode(e),n=c(t.length);return n.set(t),n},h=(...e)=>{let t=0;for(const o of e)t+=o.length;const n=c(t);let s=0;for(const o of e)n.set(o,s),s+=o.length;return n},u=e=>{let t="";for(const n of e)t+=n.toString(16).padStart(2,"0");return t},f=e=>{let t="";for(const n of e)t+=String.fromCodePoint(n);return btoa(t)},g=e=>{let t=f(e).replaceAll("+","-").replaceAll("/","_");for(;t.endsWith("=");)t=t.slice(0,-1);return t},A=e=>{const t=e.replaceAll("-","+").replaceAll("_","/"),n=t.padEnd(t.length+(4-t.length%4)%4,"="),s=atob(n),o=c(s.length);for(let a=0;a<s.length;a+=1)o[a]=s.codePointAt(a)??0;return o},b=(e,t)=>{const n=c(t);let s=e;for(let o=t-1;o>=0;o-=1)n[o]=s%256,s=Math.floor(s/256);return n},p=async e=>{const t=await r().digest("SHA-256",e);return new Uint8Array(t)},w=async(e,t)=>{const n=await r().importKey("raw",e,{hash:"SHA-256",name:"HMAC"},!1,["sign"]),s=await r().sign("HMAC",n,t);return new Uint8Array(s)},m=async(e,t,n)=>{const s=typeof e=="string"?l(e):i(e),o=typeof t=="string"?l(t):i(t),a=await r().importKey("raw",s,{hash:n,name:"HMAC"},!1,["sign"]),y=await r().sign("HMAC",a,o);return new Uint8Array(y)},B=async(e,t,n,s)=>{const o=await r().importKey("raw",t,"HKDF",!1,["deriveBits"]),a=await r().deriveBits({hash:"SHA-256",info:n,name:"HKDF",salt:e},o,s*8);return new Uint8Array(a)};export{p as a,g as b,f as c,h as d,B as e,A as f,b as g,m as h,w as i,d as r,r as s,u as t,l as u};

package/dist/providers/chat/discord/index.d.ts

@@ -1,5 +1,7 @@
 import { d as BaseConfig, b as ChatPayload } from "../../../packem_shared/types.d-C7l7qdMG.js";
-import { a as ProviderFactory } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { a as ProviderFactory, P as Provider } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { l as ReceiverOptions, R as Receiver } from "../../../packem_shared/types.d-4T7bNo4x.js";
+import "../../../packem_shared/types.d-BXfGenMH.js";
 interface DiscordConfig extends BaseConfig {
   /** Override the bot username for the message. */
   username?: string;
@@ -10,5 +12,40 @@ interface DiscordConfig extends BaseConfig {
  * Discord chat provider via Incoming Webhooks. Edge-safe — `fetch` only.
  * @see https://discord.com/developers/docs/resources/webhook#execute-webhook
  */
-declare const discordProvider: ProviderFactory<DiscordConfig, ChatPayload>;
-export { type DiscordConfig, discordProvider };
+declare const discordProvider$1: ProviderFactory<DiscordConfig, ChatPayload>;
+/**
+ * Options for the Discord inbound receiver.
+ */
+interface DiscordReceiverOptions extends ReceiverOptions {
+  /**
+   * How long the handler may run before the interaction is deferred, in milliseconds.
+   *
+   * Discord discards an interaction whose endpoint does not answer within three seconds, so a
+   * handler that outruns this deadline gets a `DEFERRED_CHANNEL_MESSAGE` sent on its behalf and
+   * keeps running; its eventual reply has to go out through the Discord API (or `provider`).
+   * @default 2000
+   */
+  deferAfterMs?: number;
+  /**
+   * The outbound Discord chat provider used by `context.reply()`, which posts a message to
+   * the originating channel (use this instead of the deferred HTTP response). Optional.
+   */
+  provider?: Provider<unknown, ChatPayload>;
+  /** The application's Ed25519 public key (hex), from the Discord developer dashboard. */
+  publicKey: string;
+}
+/**
+ * Creates a Discord inbound receiver for the interactions endpoint. Requests are verified
+ * with Ed25519 (`X-Signature-Ed25519` over `timestamp + body`) before dispatch, and the
+ * `PING` handshake is answered with a `PONG` automatically.
+ *
+ * A handler may return an {@link ../types.InboundReply} to respond with a channel message
+ * (`CHANNEL_MESSAGE_WITH_SOURCE`); returning nothing defers the interaction
+ * (`DEFERRED_CHANNEL_MESSAGE`), after which you follow up through the Discord API.
+ * @param options Verification config, the message handler and an optional reply provider.
+ * @returns The inbound channel.
+ */
+declare const createDiscordReceiver: (options: DiscordReceiverOptions) => Receiver;
+/** @deprecated Renamed to `createDiscordProvider`; removed in the next major. */
+declare const discordProvider: typeof discordProvider$1;
+export { type DiscordConfig, type DiscordReceiverOptions, discordProvider$1 as createDiscordProvider, createDiscordReceiver, discordProvider };

package/dist/providers/chat/discord/index.js

@@ -1 +1 @@
-import{default as o}from"../../../packem_shared/discordProvider-B9rc2nrV.js";export{o as discordProvider};
+import r from"../../../packem_shared/createDiscordProvider-B9rc2nrV.js";import{createDiscordReceiver as c}from"../../../packem_shared/createDiscordReceiver-ErG7MJ_N.js";const e=r;export{r as createDiscordProvider,c as createDiscordReceiver,e as discordProvider};

package/dist/providers/chat/msteams/index.d.ts

@@ -1,5 +1,7 @@
 import { d as BaseConfig, b as ChatPayload } from "../../../packem_shared/types.d-C7l7qdMG.js";
-import { a as ProviderFactory } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { a as ProviderFactory, P as Provider } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { l as ReceiverOptions, R as Receiver } from "../../../packem_shared/types.d-4T7bNo4x.js";
+import "../../../packem_shared/types.d-BXfGenMH.js";
 interface MsTeamsConfig extends BaseConfig {
   /** Microsoft Teams Incoming Webhook URL. Required. */
   webhookUrl: string;
@@ -10,5 +12,31 @@ interface MsTeamsConfig extends BaseConfig {
  * built from `text`. Edge-safe — `fetch` only.
  * @see https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using
  */
-declare const msTeamsProvider: ProviderFactory<MsTeamsConfig, ChatPayload>;
-export { type MsTeamsConfig, msTeamsProvider };
+declare const msTeamsProvider$1: ProviderFactory<MsTeamsConfig, ChatPayload>;
+/**
+ * Options for the Microsoft Teams inbound receiver (outgoing webhook).
+ */
+interface MsTeamsReceiverOptions extends ReceiverOptions {
+  /** The outbound Teams chat provider used by `context.reply()`. Optional. */
+  provider?: Provider<unknown, ChatPayload>;
+  /**
+   * The security token (HMAC key) Teams issued when the outgoing webhook was created. It is
+   * base64-decoded to key the HMAC that verifies the `Authorization` header.
+   */
+  securityToken: string;
+}
+/**
+ * Creates a Microsoft Teams inbound receiver for outgoing webhooks. Requests are verified with
+ * Teams' HMAC scheme — base64 HMAC-SHA256 over the raw request body, keyed by the
+ * base64-decoded security token, carried in the `Authorization` header as `HMAC` plus the
+ * signature.
+ *
+ * A handler may return an {@link ../types.InboundReply}; its `text` is serialised into a Bot
+ * Framework message activity in the HTTP response, which Teams renders as the reply.
+ * @param options Verification config, the message handler and an optional reply provider.
+ * @returns The inbound channel.
+ */
+declare const createMsTeamsReceiver: (options: MsTeamsReceiverOptions) => Receiver;
+/** @deprecated Renamed to `createMsTeamsProvider`; removed in the next major. */
+declare const msTeamsProvider: typeof msTeamsProvider$1;
+export { type MsTeamsConfig, type MsTeamsReceiverOptions, msTeamsProvider$1 as createMsTeamsProvider, createMsTeamsReceiver, msTeamsProvider };

package/dist/providers/chat/msteams/index.js

@@ -1 +1 @@
-import{default as a}from"../../../packem_shared/msTeamsProvider-BAgW_ba5.js";export{a as msTeamsProvider};
+import e from"../../../packem_shared/createMsTeamsProvider-BAgW_ba5.js";import{createMsTeamsReceiver as a}from"../../../packem_shared/createMsTeamsReceiver-CKZsylzU.js";const s=e;export{e as createMsTeamsProvider,a as createMsTeamsReceiver,s as msTeamsProvider};

package/dist/providers/chat/slack/index.d.ts

@@ -1,5 +1,7 @@
 import { d as BaseConfig, b as ChatPayload } from "../../../packem_shared/types.d-C7l7qdMG.js";
-import { a as ProviderFactory } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { a as ProviderFactory, P as Provider } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { l as ReceiverOptions, R as Receiver } from "../../../packem_shared/types.d-4T7bNo4x.js";
+import "../../../packem_shared/types.d-BXfGenMH.js";
 interface SlackConfig extends BaseConfig {
   /** Default channel id/name used when the payload omits `to` (Web API mode). */
   defaultChannel?: string;
@@ -15,5 +17,31 @@ interface SlackConfig extends BaseConfig {
  * (`token` + channel). Edge-safe — `fetch` only.
  * @see https://api.slack.com/methods/chat.postMessage
  */
-declare const slackProvider: ProviderFactory<SlackConfig, ChatPayload>;
-export { type SlackConfig, slackProvider };
+declare const slackProvider$1: ProviderFactory<SlackConfig, ChatPayload>;
+/**
+ * Options for the Slack inbound receiver.
+ */
+interface SlackReceiverOptions extends ReceiverOptions {
+  /**
+   * The outbound Slack chat provider used by `context.reply()` (and for replying to Events
+   * API deliveries, which cannot answer in the HTTP response). Optional.
+   */
+  provider?: Provider<unknown, ChatPayload>;
+  /** The Slack app signing secret, used to verify `X-Slack-Signature`. */
+  signingSecret: string;
+}
+/**
+ * Creates a Slack inbound receiver covering the Events API, slash commands and interactive
+ * components. Requests are verified with Slack's v0 signing scheme (5-minute replay window)
+ * before dispatch, and the `url_verification` handshake is answered automatically.
+ *
+ * Slash-command and interaction handlers may return an {@link ../types.InboundReply} to post
+ * a synchronous message in the HTTP response; Events API deliveries are acknowledged with
+ * `200` and should be replied to through the outbound Slack provider.
+ * @param options Verification config, the message handler and an optional reply provider.
+ * @returns The inbound channel.
+ */
+declare const createSlackReceiver: (options: SlackReceiverOptions) => Receiver;
+/** @deprecated Renamed to `createSlackProvider`; removed in the next major. */
+declare const slackProvider: typeof slackProvider$1;
+export { type SlackConfig, type SlackReceiverOptions, slackProvider$1 as createSlackProvider, createSlackReceiver, slackProvider };

package/dist/providers/chat/slack/index.js

@@ -1 +1 @@
-import{default as e}from"../../../packem_shared/slackProvider-CP35fu9-.js";export{e as slackProvider};
+import r from"../../../packem_shared/createSlackProvider-CP35fu9-.js";import{createSlackReceiver as t}from"../../../packem_shared/createSlackReceiver-BHY2tumz.js";const o=r;export{r as createSlackProvider,t as createSlackReceiver,o as slackProvider};

package/dist/providers/chat/telegram/index.d.ts

@@ -1,5 +1,7 @@
 import { d as BaseConfig, b as ChatPayload } from "../../../packem_shared/types.d-C7l7qdMG.js";
-import { a as ProviderFactory } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { a as ProviderFactory, P as Provider } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { l as ReceiverOptions, R as Receiver } from "../../../packem_shared/types.d-4T7bNo4x.js";
+import "../../../packem_shared/types.d-BXfGenMH.js";
 interface TelegramConfig extends BaseConfig {
   /** Telegram bot token (`123456:ABC-DEF...`). Required. */
   botToken: string;
@@ -14,5 +16,32 @@ interface TelegramConfig extends BaseConfig {
  * Telegram chat provider via the Bot API. Edge-safe — `fetch` only.
  * @see https://core.telegram.org/bots/api#sendmessage
  */
-declare const telegramProvider: ProviderFactory<TelegramConfig, ChatPayload>;
-export { type TelegramConfig, telegramProvider };
+declare const telegramProvider$1: ProviderFactory<TelegramConfig, ChatPayload>;
+/**
+ * Options for the Telegram inbound receiver.
+ */
+interface TelegramReceiverOptions extends ReceiverOptions {
+  /** The outbound Telegram chat provider used by `context.reply()`. Optional. */
+  provider?: Provider<unknown, ChatPayload>;
+  /**
+   * The secret token configured via `setWebhook`'s `secret_token`. When set, the receiver
+   * requires a matching `X-Telegram-Bot-Api-Secret-Token` header. Strongly recommended —
+   * Telegram updates are otherwise unauthenticated.
+   */
+  secretToken?: string;
+}
+/**
+ * Creates a Telegram inbound receiver for bot webhook updates. When {@link
+ * TelegramReceiverOptions.secretToken} is set, the `X-Telegram-Bot-Api-Secret-Token` header is
+ * verified before dispatch.
+ *
+ * A handler may return an {@link ../types.InboundReply}; it is serialised into a Telegram
+ * `sendMessage` method call in the response body (`chat_id` taken from the originating chat),
+ * which Telegram executes as the reply. Return `raw` to invoke a different method.
+ * @param options Verification config, the message handler and an optional reply provider.
+ * @returns The inbound channel.
+ */
+declare const createTelegramReceiver: (options: TelegramReceiverOptions) => Receiver;
+/** @deprecated Renamed to `createTelegramProvider`; removed in the next major. */
+declare const telegramProvider: typeof telegramProvider$1;
+export { type TelegramConfig, type TelegramReceiverOptions, telegramProvider$1 as createTelegramProvider, createTelegramReceiver, telegramProvider };

package/dist/providers/chat/telegram/index.js

@@ -1 +1 @@
-import{default as a}from"../../../packem_shared/telegramProvider-CyaUiWkh.js";export{a as telegramProvider};
+import e from"../../../packem_shared/createTelegramProvider-CyaUiWkh.js";import{createTelegramReceiver as m}from"../../../packem_shared/createTelegramReceiver-BjZa0eVx.js";const o=e;export{e as createTelegramProvider,m as createTelegramReceiver,o as telegramProvider};

package/dist/providers/failover/index.d.ts

@@ -12,5 +12,7 @@ interface FailoverConfig {
  * @param config Optional config.
  * @returns A composite provider.
  */
-declare const failoverProvider: <PayloadT extends BaseNotificationPayload>(providers: Provider<unknown, PayloadT>[], config?: FailoverConfig) => Provider<unknown, PayloadT>;
-export { type FailoverConfig, failoverProvider };
+declare const failoverProvider$1: <PayloadT extends BaseNotificationPayload>(providers: Provider<unknown, PayloadT>[], config?: FailoverConfig) => Provider<unknown, PayloadT>;
+/** @deprecated Renamed to `createFailoverProvider`; removed in the next major. */
+declare const failoverProvider: typeof failoverProvider$1;
+export { type FailoverConfig, failoverProvider$1 as createFailoverProvider, failoverProvider };

package/dist/providers/failover/index.js

@@ -1 +1 @@
-import{failoverProvider as e}from"../../packem_shared/failoverProvider-CyYOOitI.js";export{e as failoverProvider};
+import{failoverProvider as r}from"../../packem_shared/createFailoverProvider-CyYOOitI.js";const e=r;export{r as createFailoverProvider,e as failoverProvider};

package/dist/providers/mock/index.d.ts

@@ -25,5 +25,7 @@ interface MockProviderInstance {
  * In-memory provider for tests and local development. Records every payload it is
  * asked to send and can be configured to fail deterministically.
  */
-declare const mockProvider: ProviderFactory<MockProviderConfig, BaseNotificationPayload, MockProviderInstance>;
-export { type MockProviderConfig, type MockProviderInstance, type MockSentMessage, mockProvider };
+declare const mockProvider$1: ProviderFactory<MockProviderConfig, BaseNotificationPayload, MockProviderInstance>;
+/** @deprecated Renamed to `createMockProvider`; removed in the next major. */
+declare const mockProvider: typeof mockProvider$1;
+export { type MockProviderConfig, type MockProviderInstance, type MockSentMessage, mockProvider$1 as createMockProvider, mockProvider };

package/dist/providers/mock/index.js

@@ -1 +1 @@
-import{mockProvider as e}from"../../packem_shared/mockProvider-OaWdPlKU.js";export{e as mockProvider};
+import{mockProvider as o}from"../../packem_shared/createMockProvider-OaWdPlKU.js";const e=o;export{o as createMockProvider,e as mockProvider};

package/dist/providers/opentelemetry/index.d.ts

@@ -17,5 +17,7 @@ interface OtelProviderConfig {
  * @param config Optional config; supply a `tracer` to emit real spans.
  * @returns A provider that delegates to `inner` while tracing each send.
  */
-declare const otelProvider: <PayloadT extends BaseNotificationPayload>(inner: Provider<unknown, PayloadT>, config?: OtelProviderConfig) => Provider<unknown, PayloadT>;
-export { type OtelProviderConfig, otelProvider };
+declare const otelProvider$1: <PayloadT extends BaseNotificationPayload>(inner: Provider<unknown, PayloadT>, config?: OtelProviderConfig) => Provider<unknown, PayloadT>;
+/** @deprecated Renamed to `createOtelProvider`; removed in the next major. */
+declare const otelProvider: typeof otelProvider$1;
+export { type OtelProviderConfig, otelProvider$1 as createOtelProvider, otelProvider };

package/dist/providers/opentelemetry/index.js

@@ -1 +1 @@
-import{otelProvider as e}from"../../packem_shared/otelProvider-DdnT7q6B.js";export{e as otelProvider};
+import{otelProvider as r}from"../../packem_shared/createOtelProvider-DdnT7q6B.js";const o=r;export{r as createOtelProvider,o as otelProvider};

package/dist/providers/push/apns/index.d.ts

@@ -20,5 +20,7 @@ interface ApnsConfig extends BaseConfig {
  * Web-only runtimes that lack `node:http2`.
  * @see https://developer.apple.com/documentation/usernotifications/sending-notification-requests-to-apns
  */
-declare const apnsProvider: ProviderFactory<ApnsConfig, PushPayload>;
-export { type ApnsConfig, apnsProvider };
+declare const apnsProvider$1: ProviderFactory<ApnsConfig, PushPayload>;
+/** @deprecated Renamed to `createApnsProvider`; removed in the next major. */
+declare const apnsProvider: typeof apnsProvider$1;
+export { type ApnsConfig, apnsProvider, apnsProvider$1 as createApnsProvider };

package/dist/providers/push/apns/index.js

@@ -1 +1 @@
-import{default as e}from"../../../packem_shared/apnsProvider-Dfgwt-6Z.js";export{e as apnsProvider};
+import r from"../../../packem_shared/createApnsProvider-Dfgwt-6Z.js";const e=r;export{e as apnsProvider,r as createApnsProvider};

package/dist/providers/push/expo/index.d.ts

@@ -10,5 +10,7 @@ interface ExpoConfig extends BaseConfig {
  * Expo push provider. Sends a batch of device tokens in one call. Edge-safe — `fetch` only.
  * @see https://docs.expo.dev/push-notifications/sending-notifications/
  */
-declare const expoProvider: ProviderFactory<ExpoConfig, PushPayload>;
-export { type ExpoConfig, expoProvider };
+declare const expoProvider$1: ProviderFactory<ExpoConfig, PushPayload>;
+/** @deprecated Renamed to `createExpoProvider`; removed in the next major. */
+declare const expoProvider: typeof expoProvider$1;
+export { type ExpoConfig, expoProvider$1 as createExpoProvider, expoProvider };

package/dist/providers/push/expo/index.js

@@ -1 +1 @@
-import{default as r}from"../../../packem_shared/expoProvider-DofT1sEf.js";export{r as expoProvider};
+import o from"../../../packem_shared/createExpoProvider-DofT1sEf.js";const e=o;export{o as createExpoProvider,e as expoProvider};

package/dist/providers/push/fcm/index.d.ts

@@ -22,5 +22,7 @@ interface FcmConfig extends BaseConfig {
  * (static or via `getAccessToken`), so no `node:crypto`/Google SDK is bundled.
  * @see https://firebase.google.com/docs/cloud-messaging/send-message
  */
-declare const fcmProvider: ProviderFactory<FcmConfig, PushPayload>;
-export { type FcmConfig, fcmProvider };
+declare const fcmProvider$1: ProviderFactory<FcmConfig, PushPayload>;
+/** @deprecated Renamed to `createFcmProvider`; removed in the next major. */
+declare const fcmProvider: typeof fcmProvider$1;
+export { type FcmConfig, fcmProvider$1 as createFcmProvider, fcmProvider };

package/dist/providers/push/fcm/index.js

@@ -1 +1 @@
-import{default as f}from"../../../packem_shared/fcmProvider-86S6m7zk.js";export{f as fcmProvider};
+import r from"../../../packem_shared/createFcmProvider-86S6m7zk.js";const e=r;export{r as createFcmProvider,e as fcmProvider};

package/dist/providers/push/web-push/index.d.ts

@@ -32,5 +32,7 @@ interface WebPushConfig extends BaseConfig {
  * @see https://datatracker.ietf.org/doc/html/rfc8291
  * @see https://datatracker.ietf.org/doc/html/rfc8292
  */
-declare const webPushProvider: ProviderFactory<WebPushConfig, PushPayload>;
-export { type PushSubscriptionLike, type WebPushConfig, webPushProvider };
+declare const webPushProvider$1: ProviderFactory<WebPushConfig, PushPayload>;
+/** @deprecated Renamed to `createWebPushProvider`; removed in the next major. */
+declare const webPushProvider: typeof webPushProvider$1;
+export { type PushSubscriptionLike, type WebPushConfig, webPushProvider$1 as createWebPushProvider, webPushProvider };

package/dist/providers/push/web-push/index.js

@@ -1 +1 @@
-import{default as o}from"../../../packem_shared/webPushProvider-CUDMDRKw.js";export{o as webPushProvider};
+import r from"../../../packem_shared/createWebPushProvider-BNu3bPeV.js";const o=r;export{r as createWebPushProvider,o as webPushProvider};

package/dist/providers/roundrobin/index.d.ts

@@ -13,5 +13,7 @@ interface RoundRobinConfig {
  * @param config Optional config.
  * @returns A composite provider.
  */
-declare const roundRobinProvider: <PayloadT extends BaseNotificationPayload>(providers: Provider<unknown, PayloadT>[], config?: RoundRobinConfig) => Provider<unknown, PayloadT>;
-export { type RoundRobinConfig, roundRobinProvider };
+declare const roundRobinProvider$1: <PayloadT extends BaseNotificationPayload>(providers: Provider<unknown, PayloadT>[], config?: RoundRobinConfig) => Provider<unknown, PayloadT>;
+/** @deprecated Renamed to `createRoundRobinProvider`; removed in the next major. */
+declare const roundRobinProvider: typeof roundRobinProvider$1;
+export { type RoundRobinConfig, roundRobinProvider$1 as createRoundRobinProvider, roundRobinProvider };

package/dist/providers/roundrobin/index.js

@@ -1 +1 @@
-import{roundRobinProvider as d}from"../../packem_shared/roundRobinProvider-BrujhDY6.js";export{d as roundRobinProvider};
+import{roundRobinProvider as o}from"../../packem_shared/createRoundRobinProvider-BrujhDY6.js";const i=o;export{o as createRoundRobinProvider,i as roundRobinProvider};

package/dist/providers/sms/messagebird/index.d.ts

@@ -1,5 +1,7 @@
 import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-C7l7qdMG.js";
-import { a as ProviderFactory } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { a as ProviderFactory, P as Provider } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { l as ReceiverOptions, R as Receiver } from "../../../packem_shared/types.d-4T7bNo4x.js";
+import "../../../packem_shared/types.d-BXfGenMH.js";
 interface MessageBirdConfig extends BaseConfig {
   /** MessageBird (Bird) access key. */
   accessKey: string;
@@ -12,5 +14,33 @@ interface MessageBirdConfig extends BaseConfig {
  * MessageBird (Bird) SMS provider. Sends to many recipients in one call.
  * @see https://docs.bird.com/api/sms-messaging
  */
-declare const messageBirdProvider: ProviderFactory<MessageBirdConfig, SmsPayload>;
-export { type MessageBirdConfig, messageBirdProvider };
+declare const messageBirdProvider$1: ProviderFactory<MessageBirdConfig, SmsPayload>;
+/**
+ * Options for the MessageBird inbound receiver.
+ */
+interface MessageBirdReceiverOptions extends ReceiverOptions {
+  /** The outbound MessageBird SMS provider used by `context.reply()`. Optional. */
+  provider?: Provider<unknown, SmsPayload>;
+  /** The webhook signing key from the MessageBird dashboard (verifies the JWT signature). */
+  signingKey: string;
+  /**
+   * The public URL MessageBird signed (the `url_hash` claim covers the full URL). Set this
+   * when `request.url` differs from the configured webhook URL (proxy/rewrite). Defaults to
+   * `request.url`.
+   */
+  url?: string;
+}
+/**
+ * Creates a MessageBird inbound receiver. Requests are verified with MessageBird's
+ * `messagebird-signature-jwt` scheme: an HS256 JWT signed with the signing key whose claims
+ * bind the request — `iss` (`MessageBird`), `jti`, `exp`, `url_hash` (SHA-256 of the full URL)
+ * and `payload_hash` (SHA-256 of the body) — each of which is checked before dispatch.
+ *
+ * MessageBird has no synchronous reply; acknowledge and answer via `context.reply()`.
+ * @param options Verification config, the message handler and an optional reply provider.
+ * @returns The inbound channel.
+ */
+declare const createMessageBirdReceiver: (options: MessageBirdReceiverOptions) => Receiver;
+/** @deprecated Renamed to `createMessageBirdProvider`; removed in the next major. */
+declare const messageBirdProvider: typeof messageBirdProvider$1;
+export { type MessageBirdConfig, type MessageBirdReceiverOptions, messageBirdProvider$1 as createMessageBirdProvider, createMessageBirdReceiver, messageBirdProvider };

package/dist/providers/sms/messagebird/index.js

@@ -1 +1 @@
-import{default as a}from"../../../packem_shared/messageBirdProvider-CnsBOuY6.js";export{a as messageBirdProvider};
+import e from"../../../packem_shared/createMessageBirdProvider-CnsBOuY6.js";import{createMessageBirdReceiver as a}from"../../../packem_shared/createMessageBirdReceiver-DNPoScxB.js";const s=e;export{e as createMessageBirdProvider,a as createMessageBirdReceiver,s as messageBirdProvider};

package/dist/providers/sms/plivo/index.d.ts

@@ -14,5 +14,7 @@ interface PlivoConfig extends BaseConfig {
  * Plivo SMS provider. Sends to many recipients in one call (`dst` joined by `<`).
  * @see https://www.plivo.com/docs/sms/api/message
  */
-declare const plivoProvider: ProviderFactory<PlivoConfig, SmsPayload>;
-export { type PlivoConfig, plivoProvider };
+declare const plivoProvider$1: ProviderFactory<PlivoConfig, SmsPayload>;
+/** @deprecated Renamed to `createPlivoProvider`; removed in the next major. */
+declare const plivoProvider: typeof plivoProvider$1;
+export { type PlivoConfig, plivoProvider$1 as createPlivoProvider, plivoProvider };

package/dist/providers/sms/plivo/index.js

@@ -1 +1 @@
-import{default as e}from"../../../packem_shared/plivoProvider-C27zpwI3.js";export{e as plivoProvider};
+import o from"../../../packem_shared/createPlivoProvider-C27zpwI3.js";const i=o;export{o as createPlivoProvider,i as plivoProvider};

package/dist/providers/sms/sns/index.d.ts

@@ -17,5 +17,7 @@ interface SnsConfig extends BaseConfig {
  * computed entirely via Web Crypto (HMAC-SHA256 + SHA-256), no `node:crypto`.
  * @see https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
  */
-declare const snsProvider: ProviderFactory<SnsConfig, SmsPayload>;
-export { type SnsConfig, snsProvider };
+declare const snsProvider$1: ProviderFactory<SnsConfig, SmsPayload>;
+/** @deprecated Renamed to `createSnsProvider`; removed in the next major. */
+declare const snsProvider: typeof snsProvider$1;
+export { type SnsConfig, snsProvider$1 as createSnsProvider, snsProvider };

package/dist/providers/sms/sns/index.js

@@ -1 +1 @@
-import{default as o}from"../../../packem_shared/snsProvider-BtlNUN7u.js";export{o as snsProvider};
+import r from"../../../packem_shared/createSnsProvider-Df9fqQ2A.js";const s=r;export{r as createSnsProvider,s as snsProvider};

package/dist/providers/sms/telnyx/index.d.ts

@@ -1,5 +1,7 @@
 import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-C7l7qdMG.js";
-import { a as ProviderFactory } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { a as ProviderFactory, P as Provider } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { l as ReceiverOptions, R as Receiver } from "../../../packem_shared/types.d-4T7bNo4x.js";
+import "../../../packem_shared/types.d-BXfGenMH.js";
 interface TelnyxConfig extends BaseConfig {
   /** Telnyx API key (v2). */
   apiKey: string;
@@ -14,5 +16,28 @@ interface TelnyxConfig extends BaseConfig {
  * Telnyx SMS/MMS provider (v2 API). Edge-safe — `fetch` + Bearer auth.
  * @see https://developers.telnyx.com/api/messaging/send-message
  */
-declare const telnyxProvider: ProviderFactory<TelnyxConfig, SmsPayload>;
-export { type TelnyxConfig, telnyxProvider };
+declare const telnyxProvider$1: ProviderFactory<TelnyxConfig, SmsPayload>;
+/**
+ * Options for the Telnyx inbound receiver.
+ */
+interface TelnyxReceiverOptions extends ReceiverOptions {
+  /** The outbound Telnyx SMS provider used by `context.reply()`. Optional. */
+  provider?: Provider<unknown, SmsPayload>;
+  /** The account's Ed25519 public key (base64), from the Telnyx Mission Control portal. */
+  publicKey: string;
+}
+/**
+ * Creates a Telnyx inbound receiver for incoming SMS/MMS. Requests are verified with Telnyx's
+ * Ed25519 scheme — the `telnyx-signature-ed25519` header (base64) over `{timestamp}|{body}`,
+ * checked against the account public key, with the `telnyx-timestamp` held to a 5-minute
+ * replay window.
+ *
+ * Telnyx has no synchronous reply, so acknowledge and answer through `context.reply()` (or the
+ * outbound Telnyx provider).
+ * @param options Verification config, the message handler and an optional reply provider.
+ * @returns The inbound channel.
+ */
+declare const createTelnyxReceiver: (options: TelnyxReceiverOptions) => Receiver;
+/** @deprecated Renamed to `createTelnyxProvider`; removed in the next major. */
+declare const telnyxProvider: typeof telnyxProvider$1;
+export { type TelnyxConfig, type TelnyxReceiverOptions, telnyxProvider$1 as createTelnyxProvider, createTelnyxReceiver, telnyxProvider };

package/dist/providers/sms/telnyx/index.js

@@ -1 +1 @@
-import{default as o}from"../../../packem_shared/telnyxProvider-M23jXIyu.js";export{o as telnyxProvider};
+import e from"../../../packem_shared/createTelnyxProvider-M23jXIyu.js";import{createTelnyxReceiver as i}from"../../../packem_shared/createTelnyxReceiver-Ev-ThOtu.js";const o=e;export{e as createTelnyxProvider,i as createTelnyxReceiver,o as telnyxProvider};

package/dist/providers/sms/twilio/index.d.ts

@@ -1,5 +1,7 @@
 import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-C7l7qdMG.js";
-import { a as ProviderFactory } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { a as ProviderFactory, P as Provider } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { l as ReceiverOptions, R as Receiver } from "../../../packem_shared/types.d-4T7bNo4x.js";
+import "../../../packem_shared/types.d-BXfGenMH.js";
 interface TwilioConfig extends BaseConfig {
   /** Twilio Account SID. */
   accountSid: string;
@@ -16,5 +18,36 @@ interface TwilioConfig extends BaseConfig {
  * Twilio SMS/MMS provider. Edge-safe — uses `fetch` + Basic auth, no Node built-ins.
  * @see https://www.twilio.com/docs/sms/api/message-resource
  */
-declare const twilioProvider: ProviderFactory<TwilioConfig, SmsPayload>;
-export { type TwilioConfig, twilioProvider };
+declare const twilioProvider$1: ProviderFactory<TwilioConfig, SmsPayload>;
+/**
+ * Options for the Twilio inbound receiver (SMS and WhatsApp).
+ */
+interface TwilioReceiverOptions extends ReceiverOptions {
+  /** The Twilio auth token, used to verify `X-Twilio-Signature`. */
+  authToken: string;
+  /**
+   * The outbound Twilio SMS provider used by `context.reply()`, which addresses the reply
+   * back to the sender (re-applying the `whatsapp:` prefix for WhatsApp). Optional.
+   */
+  provider?: Provider<unknown, SmsPayload>;
+  /**
+   * The public URL Twilio signed the request against. Twilio's signature covers the exact
+   * webhook URL it was configured with, so behind a proxy or rewrite (where `request.url`
+   * differs) set this to the configured URL. Defaults to `request.url`.
+   */
+  url?: string;
+}
+/**
+ * Creates a Twilio inbound receiver for incoming SMS and WhatsApp messages. Requests are
+ * verified with Twilio's signature scheme (base64 HMAC-SHA1 over the request URL plus sorted
+ * form parameters) before dispatch.
+ *
+ * A handler may return an {@link ../types.InboundReply}; its `text` is serialised into a TwiML
+ * message element. Returning nothing acknowledges with an empty TwiML document.
+ * @param options Verification config, the message handler and an optional reply provider.
+ * @returns The inbound channel.
+ */
+declare const createTwilioReceiver: (options: TwilioReceiverOptions) => Receiver;
+/** @deprecated Renamed to `createTwilioProvider`; removed in the next major. */
+declare const twilioProvider: typeof twilioProvider$1;
+export { type TwilioConfig, type TwilioReceiverOptions, twilioProvider$1 as createTwilioProvider, createTwilioReceiver, twilioProvider };

package/dist/providers/sms/twilio/index.js

@@ -1 +1 @@
-import{default as e}from"../../../packem_shared/twilioProvider-CaoTEqz-.js";export{e as twilioProvider};
+import r from"../../../packem_shared/createTwilioProvider-CaoTEqz-.js";import{createTwilioReceiver as c}from"../../../packem_shared/createTwilioReceiver-CQmdSCMX.js";const o=r;export{r as createTwilioProvider,c as createTwilioReceiver,o as twilioProvider};

package/dist/providers/sms/vonage/index.d.ts

@@ -1,5 +1,7 @@
 import { d as BaseConfig, S as SmsPayload } from "../../../packem_shared/types.d-C7l7qdMG.js";
-import { a as ProviderFactory } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { a as ProviderFactory, P as Provider } from "../../../packem_shared/provider.d-Dh32nRm9.js";
+import { l as ReceiverOptions, R as Receiver } from "../../../packem_shared/types.d-4T7bNo4x.js";
+import "../../../packem_shared/types.d-BXfGenMH.js";
 interface VonageConfig extends BaseConfig {
   /** Vonage (Nexmo) API key. */
   apiKey: string;
@@ -14,5 +16,27 @@ interface VonageConfig extends BaseConfig {
  * Vonage (Nexmo) SMS provider. Edge-safe — `fetch` + form auth.
  * @see https://developer.vonage.com/en/api/sms
  */
-declare const vonageProvider: ProviderFactory<VonageConfig, SmsPayload>;
-export { type VonageConfig, vonageProvider };
+declare const vonageProvider$1: ProviderFactory<VonageConfig, SmsPayload>;
+/**
+ * Options for the Vonage inbound receiver.
+ */
+interface VonageReceiverOptions extends ReceiverOptions {
+  /** The outbound Vonage SMS provider used by `context.reply()`. Optional. */
+  provider?: Provider<unknown, SmsPayload>;
+  /** The account signature secret (verifies the `Authorization: Bearer` JWT). */
+  signatureSecret: string;
+}
+/**
+ * Creates a Vonage inbound receiver for the Messages API. Requests carry an HS256 JWT in the
+ * `Authorization: Bearer` header, signed with the account signature secret; the JWT's
+ * `payload_hash` claim (SHA-256 of the raw body) binds it to this request. Both the signature
+ * and `payload_hash` are checked, along with the token's validity window, before dispatch.
+ *
+ * Vonage has no synchronous reply; acknowledge and answer via `context.reply()`.
+ * @param options Verification config, the message handler and an optional reply provider.
+ * @returns The inbound channel.
+ */
+declare const createVonageReceiver: (options: VonageReceiverOptions) => Receiver;
+/** @deprecated Renamed to `createVonageProvider`; removed in the next major. */
+declare const vonageProvider: typeof vonageProvider$1;
+export { type VonageConfig, type VonageReceiverOptions, vonageProvider$1 as createVonageProvider, createVonageReceiver, vonageProvider };

package/dist/providers/sms/vonage/index.js

@@ -1 +1 @@
-import{default as r}from"../../../packem_shared/vonageProvider-CYNivc-x.js";export{r as vonageProvider};
+import e from"../../../packem_shared/createVonageProvider-CYNivc-x.js";import{createVonageReceiver as v}from"../../../packem_shared/createVonageReceiver-BWVR3E7q.js";const o=e;export{e as createVonageProvider,v as createVonageReceiver,o as vonageProvider};