notiformer 1.1.0 → 1.1.2

package/README.md

@@ -1,10 +1,10 @@
 # notiformer
 
-Real-time push notifications and feature gates for your code.
+Real-time push notifications, approval gates, and feature flags for your code.
 
-Know the moment something important happens in your app — a new sale, an error, a spike in costs. Get notified on your phone via the **Notiformer app** (iOS & Android), or in your inbox.
+Pause your AI agent, ask your phone, and continue — or fire a one-line alert the moment something important happens.
 
-> **Works everywhere.** Use in Node.js, Express, Next.js API routes, serverless functions, Python, Go, or any HTTP client.
+> **Works everywhere.** Node.js, Express, Next.js, serverless functions, Python, Go, or any HTTP client.
 
 ---
 
@@ -25,89 +25,216 @@ const n = new Notiformer({
   apiKey: "ntf_live_...", // from app.notiformer.com/projects
 });
 
+// 🛑 Block and wait for approval
+const { approved } = await n.ask({
+  message: `Deploy v2 to production?`,
+  context: "Build #442 · 3 services affected",
+  timeout: 300,
+});
+if (approved) await deploy();
+
+// 🔀 Block and wait for a choice from multiple options
+const { selected } = await n.select({
+  message: "How to handle the failed payment?",
+  options: [
+    { value: "retry", label: "🔄 Retry in 1 hour" },
+    { value: "notify", label: "📧 Notify the customer" },
+    { value: "cancel", label: "✕ Cancel the order", isDestructive: true },
+  ],
+  fallback: "notify",
+  timeout: 300,
+});
+if (selected === "retry") await scheduleRetry();
+
+// 🔔 Fire-and-forget alert
 await n.event({
-  channel: "payments", // groups related events — auto-created on first use
-  event: "payment_success", // machine-readable event name
-  description: "$49.00 — john@example.com", // optional human-readable detail
-  icon: "💳", // optional emoji shown in the feed and notification
-  tags: { userId: "usr_123", plan: "pro" }, // optional key-value metadata
-  value: "$49.00", // optional value highlighted in the feed
-  notify: true, // true → push notification | false → silent log only
-  recipients: ["you@company.com"], // optional — notify specific people only (see below)
+  channel: "payments",
+  event: "payment_success",
+  description: "$49.00 — john@example.com",
+  icon: "💳",
+  value: "$49.00",
+  notify: true,
 });
+
+// 🚦 Feature gate check (cached 30s)
+if (await n.gate("new-checkout-flow")) {
+  return newCheckout(req);
+}
 ```
 
-> **Tip:** Use `apiKey: 'ntf_live_test'` to get started without a real key. The SDK will print setup instructions in your console and skip all API calls.
+> **Tip:** Use `apiKey: 'ntf_live_test'` to get started without a real key. The SDK prints setup instructions and skips all API calls.
 
 ---
 
 ## Get your API key
 
-1. Go to [app.notiformer.com](https://app.notiformer.com) and create an account (free)
+1. Go to [app.notiformer.com](https://app.notiformer.com) and create a free account
 2. Create a project
 3. Copy the API key from the project overview
-4. Replace `'ntf_live_test'` in your code with your real key
 
 ---
 
-## `event()` — Send an event
+## Configuration
 
 ```ts
-await n.event({
-  channel: "payments", // required — string, lowercase, a-z 0-9 - _
-  event: "payment_success", // required — machine-readable event name
+const n = new Notiformer({
+  apiKey: "ntf_live_...", // required
+  silent: false, // optional — true = no API calls (great for local dev)
+  throwOnError: false, // optional — true = throws instead of returning null
+  onError: (err) => {
+    // optional — called on any failure
+    Sentry.captureException(err);
+  },
+});
 
-  description: "$49.00 — john@example.com", // optional
-  icon: "💳", // optional — emoji
-  tags: { plan: "pro", userId: "123" }, // optional — displayed in the event feed
-  value: "$49.00", // optional — highlighted value in the feed
-  notify: true, // optional — default: true
-  recipients: ["alice@company.com"], // optional — see "Targeting specific people"
+// Silence in local development
+const n = new Notiformer({
+  apiKey: process.env.NOTIFORMER_API_KEY!,
+  silent: process.env.NODE_ENV !== "production",
 });
 ```
 
-### `notify`
+---
 
-| Value            | Behaviour                                                      |
-| ---------------- | -------------------------------------------------------------- |
-| `true` (default) | Sends push notification to subscribed members                  |
-| `false`          | Stores the event silently for analytics — no notification sent |
+## `ask()` — Approval gate (binary)
 
-### Return value
+Pause your code and wait for a **human to approve or deny** from the Notiformer app. The `Promise` resolves when you respond, or when the timeout expires.
+
+> **This is a blocking call.** Your agent stops at `await n.ask()` and waits.
 
 ```ts
-const result = await n.event({ ... });
-// result is null if the call failed (never throws by default)
-// result.rateLimited === true if you exceeded 60 events/minute (event is stored, notification skipped)
+const { approved, timedOut, respondedAt } = await n.ask({
+  message: "Send campaign to 3,241 users?", // required — shown as notification title
+  context: "Campaign: Black Friday · segment A", // optional — shown in notification body
+  details: "Full changelog:\n• Fix auth bug", // optional — shown in app detail screen, supports \n
+  timeout: 300, // optional — seconds to wait (default: 300)
+  fallback: "deny", // optional — 'deny' | 'approve' on timeout (default: 'deny')
+});
+
+if (approved) {
+  await sendEmails();
+} else {
+  console.log(timedOut ? "Timed out" : "Denied");
+}
 ```
 
-`event()` **never throws by default.** A failed notification will never crash your app. If you prefer it to throw, pass `throwOnError: true` in the config.
+### Return value
+
+| Field         | Type             | Description                                           |
+| ------------- | ---------------- | ----------------------------------------------------- |
+| `approved`    | `boolean`        | `true` if the user tapped Approve                     |
+| `timedOut`    | `boolean`        | `true` if nobody responded before the timeout         |
+| `respondedAt` | `string \| null` | ISO timestamp of the response, or `null` if timed out |
+
+### Plan limits
+
+| Plan     | Gates/month       | Max timeout |
+| -------- | ----------------- | ----------- |
+| Free     | — (not available) | —           |
+| Starter  | 200               | 5 min       |
+| Pro      | 2,000             | 15 min      |
+| Business | 20,000            | 60 min      |
 
 ---
 
-## Targeting specific people — `recipients`
+## `select()` — Approval gate (multi-option)
 
-By default, when `notify: true`, all members of the project who are subscribed to that channel receive a notification.
+Like `ask()`, but instead of Approve/Deny the user picks from **2–6 custom options**. Returns the `value` string of the chosen option.
 
-You can override this and target specific people by email:
+Uses the same monthly quota as `ask()`.
+
+```ts
+const { selected, timedOut, respondedAt } = await n.select({
+  message: "How should the agent handle the error?", // required
+  options: [
+    // required — min 2, max 6
+    { value: "retry", label: "🔄 Retry the request" },
+    { value: "skip", label: "⏭ Skip and continue" },
+    { value: "stop", label: "🛑 Stop the pipeline", isDestructive: true },
+  ],
+  context: "Step 4/10 failed — HTTP 503 from payments API", // optional
+  details: "Error: Connection timeout\nEndpoint: /v2/charge\nRetries: 3",
+  timeout: 300, // optional — seconds (default: 300)
+  fallback: "skip", // optional — value to return on timeout (must match an option)
+});
+
+if (selected === "retry") await retryStep();
+if (selected === "skip") await nextStep();
+if (selected === "stop") await abort();
+```
+
+### Return value
+
+| Field         | Type             | Description                                                                                      |
+| ------------- | ---------------- | ------------------------------------------------------------------------------------------------ |
+| `selected`    | `string \| null` | The value of the chosen option, or the fallback on timeout. `null` if timed out with no fallback |
+| `timedOut`    | `boolean`        | `true` if nobody responded in time                                                               |
+| `respondedAt` | `string \| null` | ISO timestamp of the response                                                                    |
+
+### Option shape
+
+```ts
+interface SelectOption {
+  value: string; // returned in result.selected — max 50 chars
+  label: string; // button text in the app — max 80 chars, supports emoji
+  isDestructive?: boolean; // if true, button is styled in red
+}
+```
+
+### Validation rules (enforced at call time)
+
+- At least 2 options, maximum 6
+- `fallback` must match one of the option `value` strings exactly
+- Each `value` max 50 chars, each `label` max 80 chars
+
+---
+
+## `event()` — Fire-and-forget alert
+
+Send an event notification. Never throws by default.
 
 ```ts
 await n.event({
-  channel: "payments",
-  event: "large_order",
-  description: "$2,400 — enterprise@client.com",
-  notify: true,
-  recipients: ["cto@company.com", "billing@company.com"], // only these two are notified
+  channel: "payments", // required — auto-created on first use
+  event: "payment_success", // required — machine-readable event name
+  description: "$49.00 — john@co.com", // optional — shown in notification + feed
+  icon: "💳", // optional — emoji
+  tags: { plan: "pro" }, // optional — metadata shown in feed
+  value: "$49.00", // optional — highlighted value in feed
+  notify: true, // optional — true = push notification (default)
+  recipients: ["you@company.com"], // optional — notify specific people only
 });
 ```
 
-**How it works:**
+### `notify` behaviour
+
+| Value            | Behaviour                                   |
+| ---------------- | ------------------------------------------- |
+| `true` (default) | Sends push to subscribed members            |
+| `false`          | Stores the event silently — no notification |
+
+### Return value
+
+```ts
+const result = await n.event({ ... });
+// result is null if the call failed (never throws by default)
+// result.id          → event ID
+// result.createdAt   → ISO timestamp
+// result.rateLimited → true if >60 events/min (event stored, notification skipped)
+```
+
+### Recipients
 
-- If a recipient has a Notiformer account linked to that email and has installed the app, they receive a **push notification**
-- Email notifications are **coming soon** — recipients will receive emails once this feature launches
-- If you don't specify `recipients`, all project members subscribed to the channel are notified
+By default, all project members subscribed to the channel are notified. Use `recipients` to target specific people:
 
-**Plan limits for `recipients`:**
+```ts
+await n.event({
+  channel: "sales",
+  event: "enterprise_signup",
+  notify: true,
+  recipients: ["cto@company.com"], // only this person gets the push
+});
+```
 
 | Plan     | Max recipients per event |
 | -------- | ------------------------ |
@@ -116,230 +243,189 @@ await n.event({
 | Pro      | 10                       |
 | Business | 30                       |
 
-> Members are managed from the project dashboard at [app.notiformer.com](https://app.notiformer.com/projects).
+### Monthly event quotas
+
+| Plan     | Events/month |
+| -------- | ------------ |
+| Free     | 500          |
+| Starter  | 20,000       |
+| Pro      | 75,000       |
+| Business | 300,000      |
+
+Rate limit: 60 events/minute per project. If exceeded, the event is stored but no notification is sent (`rateLimited: true` in the response).
 
 ---
 
-## `gate()` — Feature gates
+## `gate()` — Feature flags
 
-Toggle features in your code remotely from the Notiformer dashboard — no redeploy needed.
+Toggle features remotely from the dashboard — no redeploy needed. Results are **cached locally for 30 seconds** by default.
+
+> Available on **Pro and Business** plans only.
 
 ```ts
 const isEnabled = await n.gate("new-checkout-flow");
 
 if (isEnabled) {
-  // new behaviour
+  return newCheckout(req);
 } else {
-  // old behaviour
+  return legacyCheckout(req);
 }
 ```
 
-Gates are **cached locally for 30 seconds** by default to avoid hammering the API on every request.
-
 ### Options
 
 ```ts
 const isEnabled = await n.gate("my-gate", {
-  fallback: false, // optional — returned if the gate can't be fetched (default: false)
-  cacheTtl: 60, // optional — cache duration in seconds (default: 30)
+  fallback: false, // returned if the gate can't be fetched (default: false)
+  cacheTtl: 60, // local cache in seconds (default: 30)
 });
-```
 
-### Full gate result
-
-```ts
+// Full result with metadata
 const result = await n.gateDetails("my-gate");
-// { key: 'my-gate', enabled: true, cached: false, fetchedAt: '2025-...' }
-```
-
-### Clear the cache
+// { key: 'my-gate', enabled: true, cached: false, fetchedAt: '...' }
 
-```ts
-n.clearGateCache("my-gate"); // clear a specific gate
+// Cache management
+n.clearGateCache("my-gate"); // clear one gate
 n.clearGateCache(); // clear all gates
 ```
 
+| Plan     | Gate limit per project |
+| -------- | ---------------------- |
+| Free     | Not available          |
+| Starter  | Not available          |
+| Pro      | 50 gates               |
+| Business | 500 gates              |
+
 ---
 
-## Configuration
+## When quota is exceeded
+
+When you hit your monthly limit, the API returns HTTP 429 with an `upgradeUrl` field pointing to a direct Stripe Checkout for the next plan:
 
 ```ts
+// The SDK logs this automatically:
+// [notiformer] Plan limit reached. Upgrade your plan to continue:
+// → https://api.notiformer.com/v1/upgrade?plan=pro&uid=...&email=...
+
+// You can also handle it yourself:
 const n = new Notiformer({
-  apiKey: "ntf_live_...", // required — from app.notiformer.com/projects
-  silent: false, // optional — true = no API calls (great for local dev)
-  throwOnError: false, // optional — true = throws instead of returning null
+  apiKey: "ntf_live_...",
   onError: (err) => {
-    // optional — called when any call fails
-    Sentry.captureException(err);
+    if (err.message.includes("quota")) {
+      notifyAdmin("Notiformer quota exceeded");
+    }
   },
 });
 ```
 
-### Silence in local development
+---
+
+## REST API
+
+All SDK methods wrap REST endpoints. Use them from any language:
 
-```ts
-const n = new Notiformer({
-  apiKey: process.env.NOTIFORMER_API_KEY!,
-  silent: process.env.NODE_ENV !== "production", // no calls in dev/test
-});
+```
+POST   https://api.notiformer.com/v1/events       — n.event()
+POST   https://api.notiformer.com/v1/ask          — n.ask() create
+GET    https://api.notiformer.com/v1/ask/:id      — n.ask() poll
+POST   https://api.notiformer.com/v1/select       — n.select() create
+GET    https://api.notiformer.com/v1/select/:id   — n.select() poll
+GET    https://api.notiformer.com/v1/gates/:key   — n.gate()
+GET    https://api.notiformer.com/v1/health       — status check
 ```
 
----
+All endpoints require `Authorization: Bearer ntf_live_...`.
 
-## Rate limits & quotas
+### Python example
 
-| Limit                           | Value   |
-| ------------------------------- | ------- |
-| Events per minute (per project) | 60      |
-| Events per month (Free plan)    | 100     |
-| Events per month (Starter)      | 5,000   |
-| Events per month (Pro)          | 75,000  |
-| Events per month (Business)     | 300,000 |
+```python
+import requests, time
 
-If you exceed **60 events/minute**: the event is stored and visible in your feed, but no notification is sent. The API response includes `rateLimited: true`.
+NF_KEY  = "ntf_live_..."
+HEADERS = {"Authorization": f"Bearer {NF_KEY}"}
 
-If you exceed your **monthly quota**: the event is rejected with HTTP 429. Upgrade your plan at [app.notiformer.com/settings](https://app.notiformer.com/settings).
+# Create an approval request
+r = requests.post(
+    "https://api.notiformer.com/v1/ask",
+    headers=HEADERS,
+    json={"message": "Delete 500 rows?", "timeout": 300}
+)
+ask_id = r.json()["id"]
+
+# Poll until resolved
+while True:
+    poll = requests.get(
+        f"https://api.notiformer.com/v1/ask/{ask_id}",
+        headers=HEADERS
+    ).json()
+    if poll["status"] != "pending":
+        break
+    time.sleep(2)
+
+if poll["status"] == "approved":
+    db.execute(delete_query)
+```
 
 ---
 
 ## Common patterns
 
-### Alert on payment success
+### AI agent guard
 
 ```ts
-await n.event({
-  channel: "payments",
-  event: "payment_success",
-  description: `${amount} — ${user.email}`,
-  icon: "💳",
-  value: amount,
-  notify: true,
+// Stop the agent before any destructive action
+const { approved } = await n.ask({
+  message: `Agent wants to delete ${count} records`,
+  context: `Table: ${table} · Environment: production`,
+  details: `WHERE clause: ${query}\nEstimated rows: ${count}`,
+  timeout: 120,
+  fallback: "deny",
 });
+if (!approved) throw new Error("Action denied by human");
 ```
 
-### Alert on unhandled errors
+### Multi-step decision
 
 ```ts
-// Express error middleware
-app.use(async (err, req, res, next) => {
-  await n.event({
-    channel: "errors",
-    event: "unhandled_error",
-    description: err.message,
-    icon: "🔴",
-    tags: { path: req.path, method: req.method },
-    notify: true,
-  });
-  res.status(500).json({ error: "Internal server error" });
+const { selected } = await n.select({
+  message: `Build #${build.id} failed at step ${step}`,
+  options: [
+    { value: "retry", label: "🔄 Retry from this step" },
+    { value: "restart", label: "↩ Restart from scratch" },
+    { value: "abort", label: "🛑 Abort pipeline", isDestructive: true },
+  ],
+  fallback: "abort",
+  timeout: 600,
 });
 ```
 
-### Silent analytics (no notification)
+### Silent analytics
 
 ```ts
 await n.event({
   channel: "analytics",
   event: "page_view",
   tags: { path: req.path, userId: session.userId },
-  notify: false, // stored in feed, no push notification sent
+  notify: false, // stored in feed, no push
 });
 ```
 
-### Feature gate in an API route
-
-```ts
-// Next.js API route
-export async function POST(req: Request) {
-  const useNewFlow = await n.gate("new-checkout-flow");
-
-  if (useNewFlow) {
-    return newCheckoutHandler(req);
-  }
-  return legacyCheckoutHandler(req);
-}
-```
-
-### Notify a specific person
+### Error alert with context
 
 ```ts
-// Only notify the CTO for large orders
-await n.event({
-  channel: "sales",
-  event: "enterprise_signup",
-  description: `${company} — ${mrr}/mo`,
-  icon: "🏢",
-  value: mrr,
-  notify: true,
-  recipients: ["cto@yourcompany.com"], // only they get the push
+app.use(async (err, req, res, next) => {
+  await n.event({
+    channel: "errors",
+    event: "unhandled_error",
+    description: err.message,
+    icon: "🔴",
+    tags: { path: req.path, method: req.method, status: 500 },
+    notify: true,
+  });
+  res.status(500).json({ error: "Internal server error" });
 });
 ```
 
-### Using with Python (REST API)
-
-Notiformer works from any language via the REST API:
-
-```python
-import requests
-
-requests.post(
-  'https://api.notiformer.com/v1/events',
-  headers={ 'Authorization': f'Bearer {NF_KEY}' },
-  json={
-    'channel':     'ai-costs',
-    'event':       'cost_spike',
-    'description': '🤖 $180 spent in 10 min',
-    'notify':      True,
-    'recipients':  ['cto@company.com'],  # optional
-  }
-)
-```
-
----
-
-## Receiving notifications
-
-Push notifications are delivered via the **Notiformer app**, available for iOS and Android.
-
-1. Download the Notiformer app from the App Store or Google Play
-2. Sign in with your Notiformer account
-3. You'll automatically receive push notifications for projects you own or are a member of
-4. Manage which channels you're subscribed to from the app settings
-
-> **Email notifications** are in development and coming soon. Sign up at [notiformer.com](https://notiformer.com) to be notified when they launch.
-
----
-
-## REST API
-
-The same `event()` call maps to this endpoint:
-
-```
-POST https://api.notiformer.com/v1/events
-Authorization: Bearer ntf_live_...
-Content-Type: application/json
-
-{
-  "channel":     "payments",
-  "event":       "payment_success",
-  "description": "$49.00 — john@example.com",
-  "icon":        "💳",
-  "tags":        { "plan": "pro" },
-  "value":       "$49.00",
-  "notify":      true,
-  "recipients":  ["you@company.com"]
-}
-```
-
-Response:
-
-```json
-{
-  "id": "evt_abc123",
-  "createdAt": "2025-01-15T10:30:00.000Z",
-  "rateLimited": false
-}
-```
-
 ---
 
 ## Requirements
@@ -355,3 +441,4 @@ Response:
 - **Docs:** [docs.notiformer.com](https://docs.notiformer.com)
 - **Status:** [status.notiformer.com](https://status.notiformer.com)
 - **Pricing:** [notiformer.com/#pricing](https://notiformer.com/#pricing)
+- **npm:** [npmjs.com/package/notiformer](https://www.npmjs.com/package/notiformer)

package/dist/index.d.ts

@@ -8,19 +8,26 @@
  *
  * const n = new Notiformer({ apiKey: 'ntf_live_...' });
  *
- * // Notify everyone subscribed to the 'payments' channel
+ * // Fire-and-forget alert
  * await n.event({ channel: 'payments', event: 'new_sale', notify: true });
  *
- * // Notify specific people only
- * await n.event({
- *   channel: 'payments',
- *   event: 'refund_requested',
- *   notify: true,
- *   recipients: ['admin@company.com', 'billing@company.com'],
+ * // Block and wait for approval
+ * const { approved } = await n.ask({ message: 'Deploy to prod?' });
+ *
+ * // Block and wait for a choice from multiple options
+ * const { selected } = await n.select({
+ *   message: 'How to handle the failed payment?',
+ *   options: [
+ *     { value: 'retry',  label: '🔄 Retry in 1 hour' },
+ *     { value: 'notify', label: '📧 Notify customer' },
+ *     { value: 'cancel', label: '✕ Cancel order', isDestructive: true },
+ *   ],
+ *   fallback: 'notify',
  * });
  */
-import type { NotiformerConfig, EventPayload, EventResponse, GateOptions, GateResult, AskPayload, AskResult } from "./types";
-export type { NotiformerConfig, EventPayload, EventResponse, GateOptions, GateResult, AskPayload, AskResult, };
+import type { NotiformerConfig, EventPayload, EventResponse, GateOptions, GateResult, AskPayload, AskResult, SelectPayload, SelectResult } from "./types";
+export type { NotiformerConfig, EventPayload, EventResponse, GateOptions, GateResult, AskPayload, AskResult, SelectPayload, SelectResult, };
+export type { SelectOption } from "./types";
 export declare class Notiformer {
     private readonly apiKey;
     private readonly baseUrl;
@@ -34,49 +41,75 @@ export declare class Notiformer {
     constructor(config: NotiformerConfig);
     /**
      * Send an event and optionally notify recipients.
-     *
-     * - Without `recipients`: notifies the project owner + all members
-     *   subscribed to the event's channel.
-     * - With `recipients`: notifies only the specified email addresses
-     *   (must be project members). Overrides the default behaviour.
-     *
      * Never throws by default — returns null if the call fails.
      */
     event(payload: EventPayload): Promise<EventResponse | null>;
     /**
      * Check whether a feature gate is enabled.
      * Results are cached locally for 30 seconds by default.
-     * Returns false if the call fails.
+     * Returns false if the call fails or the plan doesn't support gates.
      */
     gate(key: string, options?: GateOptions): Promise<boolean>;
     gateDetails(key: string, options?: GateOptions): Promise<GateResult>;
     clearGateCache(key?: string): void;
     /**
-     * Pause execution and wait for a human to approve or deny from the Notiformer app.
+     * Pause execution and wait for a human to approve or deny.
      *
-     * Your agent stops here. A push notification is sent to your phone with
-     * Approve and Deny buttons. The method resolves when you respond,
-     * or when the timeout expires.
+     * A push notification is sent to the Notiformer app with Approve
+     * and Deny buttons. The Promise resolves when you respond or when
+     * the timeout expires.
      *
-     * Never throws by default — returns { approved: false, timedOut: false } on error.
+     * Never throws by default.
      *
      * @example
      * const { approved } = await n.ask({
      *   message: `Send campaign to ${count} users?`,
      *   context: `Campaign: Black Friday · ${count} recipients`,
-     *   details: `CHANGES\n• Segment: paying users only\n• Template: bf-2026\n\nROLLBACK\nSet campaign.active = false`,
      *   timeout: 300,
      * });
      * if (approved) await sendEmails();
      */
     ask(payload: AskPayload): Promise<AskResult>;
+    /**
+     * Pause execution and wait for a human to choose from multiple options.
+     *
+     * Unlike ask() which returns a boolean, select() returns the `value`
+     * string of the chosen option. Use it when you need more than two actions.
+     *
+     * Uses the same monthly quota as ask().
+     * Never throws by default.
+     *
+     * @example
+     * const { selected } = await n.select({
+     *   message: 'How should I handle the failed payment?',
+     *   options: [
+     *     { value: 'retry',  label: '🔄 Retry in 1 hour' },
+     *     { value: 'notify', label: '📧 Notify the customer' },
+     *     { value: 'cancel', label: '✕ Cancel the order', isDestructive: true },
+     *   ],
+     *   fallback: 'notify', // returned automatically on timeout
+     *   timeout: 300,
+     * });
+     *
+     * if (selected === 'retry')  await scheduleRetry();
+     * if (selected === 'notify') await sendEmail();
+     * if (selected === 'cancel') await cancelOrder();
+     */
+    select(payload: SelectPayload): Promise<SelectResult>;
     private pollAsk;
+    private pollSelect;
     private sleep;
+    /**
+     * If the API response includes an upgradeUrl (quota exceeded),
+     * print a visible warning in the developer's console.
+     */
+    private warnUpgrade;
     private failAsk;
+    private failSelect;
+    private fail;
     private post;
     private get;
     private request;
-    private fail;
     private friendlyNetworkError;
 }
 export default Notiformer;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACV,MAAM,SAAS,CAAC;AAIjB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,GACV,CAAC;AAOF,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,MAAM,EAAE,gBAAgB;IAoCpC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAiDjE;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB9D,WAAW,CACf,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAKtB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlC;;;;;;;;;;;;;;;;;OAiBG;IACG,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;YAgDpC,OAAO;IAiDrB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,OAAO;YAOD,IAAI;YAIJ,GAAG;YAIH,OAAO;IAmBrB,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,oBAAoB;CAmB7B;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,GACb,CAAC;AACF,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAO5C,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,MAAM,EAAE,gBAAgB;IAwCpC;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsDjE;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkC9D,WAAW,CACf,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAKtB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQlC;;;;;;;;;;;;;;;;OAgBG;IACG,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAoDlD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YA0E7C,OAAO;YAiDP,UAAU;IAmDxB,OAAO,CAAC,KAAK;IAIb;;;OAGG;IACH,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,IAAI;YAOE,IAAI;YAIJ,GAAG;YAIH,OAAO;IAmBrB,OAAO,CAAC,oBAAoB;CAmB7B;AAED,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -9,15 +9,21 @@
  *
  * const n = new Notiformer({ apiKey: 'ntf_live_...' });
  *
- * // Notify everyone subscribed to the 'payments' channel
+ * // Fire-and-forget alert
  * await n.event({ channel: 'payments', event: 'new_sale', notify: true });
  *
- * // Notify specific people only
- * await n.event({
- *   channel: 'payments',
- *   event: 'refund_requested',
- *   notify: true,
- *   recipients: ['admin@company.com', 'billing@company.com'],
+ * // Block and wait for approval
+ * const { approved } = await n.ask({ message: 'Deploy to prod?' });
+ *
+ * // Block and wait for a choice from multiple options
+ * const { selected } = await n.select({
+ *   message: 'How to handle the failed payment?',
+ *   options: [
+ *     { value: 'retry',  label: '🔄 Retry in 1 hour' },
+ *     { value: 'notify', label: '📧 Notify customer' },
+ *     { value: 'cancel', label: '✕ Cancel order', isDestructive: true },
+ *   ],
+ *   fallback: 'notify',
  * });
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -59,14 +65,11 @@ class Notiformer {
                 "└─────────────────────────────────────────────────────┘\n");
         }
     }
+    // ─────────────────────────────────────────────────────────────
+    // event()
+    // ─────────────────────────────────────────────────────────────
     /**
      * Send an event and optionally notify recipients.
-     *
-     * - Without `recipients`: notifies the project owner + all members
-     *   subscribed to the event's channel.
-     * - With `recipients`: notifies only the specified email addresses
-     *   (must be project members). Overrides the default behaviour.
-     *
      * Never throws by default — returns null if the call fails.
      */
     async event(payload) {
@@ -104,6 +107,7 @@ class Notiformer {
                 const data = await res
                     .json()
                     .catch(() => ({ error: `HTTP ${res.status}` }));
+                this.warnUpgrade(data);
                 return this.fail(new Error(`[notiformer] ${(_b = data.error) !== null && _b !== void 0 ? _b : res.statusText}`));
             }
             return (await res.json());
@@ -112,10 +116,13 @@ class Notiformer {
             return this.fail(this.friendlyNetworkError(err));
         }
     }
+    // ─────────────────────────────────────────────────────────────
+    // gate()
+    // ─────────────────────────────────────────────────────────────
     /**
      * Check whether a feature gate is enabled.
      * Results are cached locally for 30 seconds by default.
-     * Returns false if the call fails.
+     * Returns false if the call fails or the plan doesn't support gates.
      */
     async gate(key, options = {}) {
         var _a, _b;
@@ -130,8 +137,15 @@ class Notiformer {
             return cached;
         try {
             const res = await this.get(`/v1/gates/${encodeURIComponent(key)}`);
-            if (!res.ok)
+            if (!res.ok) {
+                // 403 = Feature Gates not available on this plan
+                if (res.status === 403) {
+                    const data = await res.json().catch(() => ({}));
+                    console.warn(`[notiformer] gate("${key}") — Feature Gates require Pro or Business plan.` +
+                        (data.upgradeUrl ? `\n→ Upgrade: ${data.upgradeUrl}` : ""));
+                }
                 return fallback;
+            }
             const data = (await res.json());
             this.gateCache.set(key, data.enabled, ttl);
             return data.enabled;
@@ -147,20 +161,22 @@ class Notiformer {
     clearGateCache(key) {
         key ? this.gateCache.delete(key) : this.gateCache.clear();
     }
+    // ─────────────────────────────────────────────────────────────
+    // ask()
+    // ─────────────────────────────────────────────────────────────
     /**
-     * Pause execution and wait for a human to approve or deny from the Notiformer app.
+     * Pause execution and wait for a human to approve or deny.
      *
-     * Your agent stops here. A push notification is sent to your phone with
-     * Approve and Deny buttons. The method resolves when you respond,
-     * or when the timeout expires.
+     * A push notification is sent to the Notiformer app with Approve
+     * and Deny buttons. The Promise resolves when you respond or when
+     * the timeout expires.
      *
-     * Never throws by default — returns { approved: false, timedOut: false } on error.
+     * Never throws by default.
      *
      * @example
      * const { approved } = await n.ask({
      *   message: `Send campaign to ${count} users?`,
      *   context: `Campaign: Black Friday · ${count} recipients`,
-     *   details: `CHANGES\n• Segment: paying users only\n• Template: bf-2026\n\nROLLBACK\nSet campaign.active = false`,
      *   timeout: 300,
      * });
      * if (approved) await sendEmails();
@@ -196,49 +212,183 @@ class Notiformer {
             const data = await createRes
                 .json()
                 .catch(() => ({ error: `HTTP ${createRes.status}` }));
+            this.warnUpgrade(data);
             return this.failAsk(new Error(`[notiformer] ${(_c = data.error) !== null && _c !== void 0 ? _c : createRes.statusText}`));
         }
         const created = (await createRes.json());
         return this.pollAsk(created.id, new Date(created.expiresAt).getTime());
     }
+    // ─────────────────────────────────────────────────────────────
+    // select()
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Pause execution and wait for a human to choose from multiple options.
+     *
+     * Unlike ask() which returns a boolean, select() returns the `value`
+     * string of the chosen option. Use it when you need more than two actions.
+     *
+     * Uses the same monthly quota as ask().
+     * Never throws by default.
+     *
+     * @example
+     * const { selected } = await n.select({
+     *   message: 'How should I handle the failed payment?',
+     *   options: [
+     *     { value: 'retry',  label: '🔄 Retry in 1 hour' },
+     *     { value: 'notify', label: '📧 Notify the customer' },
+     *     { value: 'cancel', label: '✕ Cancel the order', isDestructive: true },
+     *   ],
+     *   fallback: 'notify', // returned automatically on timeout
+     *   timeout: 300,
+     * });
+     *
+     * if (selected === 'retry')  await scheduleRetry();
+     * if (selected === 'notify') await sendEmail();
+     * if (selected === 'cancel') await cancelOrder();
+     */
+    async select(payload) {
+        var _a, _b;
+        if (!payload.message)
+            throw new Error("[notiformer] select.message is required.");
+        if (!payload.options || payload.options.length < 2) {
+            throw new Error("[notiformer] select.options requires at least 2 options.");
+        }
+        if (payload.options.length > 6) {
+            throw new Error("[notiformer] select.options supports a maximum of 6 options.");
+        }
+        if (this.isPlaceholder) {
+            console.warn('[notiformer] select() not sent — using example key "ntf_live_test".\n' +
+                "→ Replace it with your real key from https://app.notiformer.com/projects");
+            return { selected: null, timedOut: false, respondedAt: null };
+        }
+        if (this.silent)
+            return { selected: null, timedOut: false, respondedAt: null };
+        // Local validation: fallback must be a valid option value
+        if (payload.fallback !== undefined) {
+            const validValues = payload.options.map((o) => o.value);
+            if (!validValues.includes(payload.fallback)) {
+                throw new Error(`[notiformer] select.fallback "${payload.fallback}" must match one of the option values: ` +
+                    validValues.join(", "));
+            }
+        }
+        const body = {
+            message: payload.message,
+            options: payload.options,
+            timeout: (_a = payload.timeout) !== null && _a !== void 0 ? _a : 300,
+        };
+        if (payload.context !== undefined)
+            body.context = payload.context;
+        if (payload.details !== undefined)
+            body.details = payload.details;
+        if (payload.fallback !== undefined)
+            body.fallback = payload.fallback;
+        let createRes;
+        try {
+            createRes = await this.post("/v1/select", body);
+        }
+        catch (err) {
+            return this.failSelect(this.friendlyNetworkError(err));
+        }
+        if (!createRes.ok) {
+            const data = await createRes
+                .json()
+                .catch(() => ({ error: `HTTP ${createRes.status}` }));
+            this.warnUpgrade(data);
+            return this.failSelect(new Error(`[notiformer] ${(_b = data.error) !== null && _b !== void 0 ? _b : createRes.statusText}`));
+        }
+        const created = (await createRes.json());
+        return this.pollSelect(created.id, new Date(created.expiresAt).getTime());
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Private: polling
+    // ─────────────────────────────────────────────────────────────
     async pollAsk(askId, expiresAtMs) {
         var _a, _b;
-        const POLL_INTERVAL_MS = 2000;
+        const POLL_MS = 2000;
+        const GRACE_MS = 5000; // matches server grace period
         while (true) {
-            await this.sleep(POLL_INTERVAL_MS);
-            if (Date.now() >= expiresAtMs) {
-                return { approved: false, timedOut: true, respondedAt: null };
-            }
+            await this.sleep(POLL_MS);
+            // ── Poll FIRST, check expiry after ─────────────────────
+            // This ensures a response made at the last instant is not
+            // incorrectly returned as timedOut.
             try {
                 const res = await this.get(`/v1/ask/${encodeURIComponent(askId)}`);
-                if (!res.ok) {
-                    if (res.status >= 400 && res.status < 500) {
-                        const data = await res
-                            .json()
-                            .catch(() => ({ error: `HTTP ${res.status}` }));
-                        return this.failAsk(new Error(`[notiformer] ${(_a = data.error) !== null && _a !== void 0 ? _a : res.statusText}`));
+                if (res.ok) {
+                    const data = (await res.json());
+                    if (data.status !== "pending") {
+                        return {
+                            approved: data.status === "approved",
+                            timedOut: data.status === "timed_out",
+                            respondedAt: (_a = data.respondedAt) !== null && _a !== void 0 ? _a : null,
+                        };
                     }
-                    // 5xx — server error, retry on next interval
-                    continue;
                 }
-                const data = (await res.json());
-                if (data.status === "pending")
-                    continue;
-                return {
-                    approved: data.status === "approved",
-                    timedOut: data.status === "timed_out",
-                    respondedAt: (_b = data.respondedAt) !== null && _b !== void 0 ? _b : null,
-                };
+                else if (res.status >= 400 && res.status < 500) {
+                    const data = await res
+                        .json()
+                        .catch(() => ({ error: `HTTP ${res.status}` }));
+                    return this.failAsk(new Error(`[notiformer] ${(_b = data.error) !== null && _b !== void 0 ? _b : res.statusText}`));
+                }
+                // 5xx — fall through to expiry check, retry next loop
             }
             catch (_c) {
-                // Network error during a single poll — retry until expiry
-                continue;
+                // network error — fall through
+            }
+            // ── Only declare client-side timeout after grace period ─
+            if (Date.now() >= expiresAtMs + GRACE_MS) {
+                return { approved: false, timedOut: true, respondedAt: null };
+            }
+        }
+    }
+    async pollSelect(selectId, expiresAtMs) {
+        var _a, _b, _c;
+        const POLL_MS = 2000;
+        const GRACE_MS = 5000;
+        while (true) {
+            await this.sleep(POLL_MS);
+            try {
+                const res = await this.get(`/v1/select/${encodeURIComponent(selectId)}`);
+                if (res.ok) {
+                    const data = (await res.json());
+                    if (data.status !== "pending") {
+                        return {
+                            selected: (_a = data.selectedValue) !== null && _a !== void 0 ? _a : null,
+                            timedOut: data.status === "timed_out",
+                            respondedAt: (_b = data.respondedAt) !== null && _b !== void 0 ? _b : null,
+                        };
+                    }
+                }
+                else if (res.status >= 400 && res.status < 500) {
+                    const data = await res
+                        .json()
+                        .catch(() => ({ error: `HTTP ${res.status}` }));
+                    return this.failSelect(new Error(`[notiformer] ${(_c = data.error) !== null && _c !== void 0 ? _c : res.statusText}`));
+                }
+            }
+            catch (_d) {
+                // network error — fall through
+            }
+            if (Date.now() >= expiresAtMs + GRACE_MS) {
+                return { selected: null, timedOut: true, respondedAt: null };
             }
         }
     }
+    // ─────────────────────────────────────────────────────────────
+    // Private: helpers
+    // ─────────────────────────────────────────────────────────────
     sleep(ms) {
         return new Promise((resolve) => setTimeout(resolve, ms));
     }
+    /**
+     * If the API response includes an upgradeUrl (quota exceeded),
+     * print a visible warning in the developer's console.
+     */
+    warnUpgrade(data) {
+        if (data === null || data === void 0 ? void 0 : data.upgradeUrl) {
+            console.warn(`[notiformer] Plan limit reached. Upgrade your plan to continue:\n` +
+                `→ ${data.upgradeUrl}`);
+        }
+    }
     failAsk(error) {
         var _a;
         this.logger.error(error.message);
@@ -247,6 +397,22 @@ class Notiformer {
             throw error;
         return { approved: false, timedOut: false, respondedAt: null };
     }
+    failSelect(error) {
+        var _a;
+        this.logger.error(error.message);
+        (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, error);
+        if (this.throwOnError)
+            throw error;
+        return { selected: null, timedOut: false, respondedAt: null };
+    }
+    fail(error) {
+        var _a;
+        this.logger.error(error.message);
+        (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, error);
+        if (this.throwOnError)
+            throw error;
+        return null;
+    }
     async post(path, body) {
         return this.request(path, { method: "POST", body: JSON.stringify(body) });
     }
@@ -264,7 +430,7 @@ class Notiformer {
                 headers: {
                     "Content-Type": "application/json",
                     Authorization: `Bearer ${this.apiKey}`,
-                    "X-SDK-Version": "1.1.0",
+                    "X-SDK-Version": "1.1.2",
                     ...((_a = init.headers) !== null && _a !== void 0 ? _a : {}),
                 },
             });
@@ -273,14 +439,6 @@ class Notiformer {
             clearTimeout(timer);
         }
     }
-    fail(error) {
-        var _a;
-        this.logger.error(error.message);
-        (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, error);
-        if (this.throwOnError)
-            throw error;
-        return null;
-    }
     friendlyNetworkError(err) {
         const msg = err instanceof Error ? err.message.toLowerCase() : "";
         if (msg.includes("aborted") || msg.includes("timeout")) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -25,9 +25,6 @@ export interface EventPayload {
      * If set, **only** these emails receive notifications — the default
      * (owner + channel subscribers) is ignored.
      *
-     * Each email must belong to a member of your project
-     * (added from the Notiformer dashboard).
-     *
      * Plan limits: Free=1, Starter=3, Pro=10, Business=30.
      *
      * @example
@@ -57,12 +54,11 @@ export interface AskPayload {
     context?: string;
     /**
      * Optional long-form text shown in the approval detail screen of the
-     * Notiformer app. Supports newlines — use \n to structure content
-     * (changelogs, diffs, SQL queries, affected services, etc.).
+     * Notiformer app. Supports newlines — use \n to structure content.
      * Max 10,000 characters.
      *
      * @example
-     * details: `CHANGES\n• Fix auth bug\n• Add details field\n\nROLLBACK\n./rollback.sh v1.0.9`
+     * details: `CHANGES\n• Fix auth bug\n\nROLLBACK\n./rollback.sh v1.0.9`
      */
     details?: string;
     /**
@@ -85,5 +81,69 @@ export interface AskResult {
     /** ISO timestamp of when the user responded. null if timed out. */
     respondedAt: string | null;
 }
+export interface SelectOption {
+    /**
+     * The value returned in `result.selected` when this option is chosen.
+     * Max 50 chars. Use a short descriptive string.
+     *
+     * @example 'deploy' | 'rollback' | 'cancel'
+     */
+    value: string;
+    /**
+     * The button label shown in the Notiformer app.
+     * Max 80 chars. Supports emoji.
+     *
+     * @example '🚀 Deploy to production'
+     */
+    label: string;
+    /**
+     * If true, the button is styled destructively (red) in the mobile app.
+     * Use for dangerous or irreversible actions.
+     */
+    isDestructive?: boolean;
+}
+export interface SelectPayload {
+    /**
+     * The question shown as the push notification title. Required.
+     */
+    message: string;
+    /**
+     * The options shown as buttons in the Notiformer app.
+     * Minimum 2, maximum 6 options.
+     */
+    options: SelectOption[];
+    /** Optional detail shown in the notification body (max 500 chars). */
+    context?: string;
+    /**
+     * Optional long-form text shown in the approval detail screen.
+     * Supports newlines. Max 10,000 chars.
+     */
+    details?: string;
+    /**
+     * Seconds to wait before applying the fallback.
+     * Default: 300. Maximum depends on your plan.
+     */
+    timeout?: number;
+    /**
+     * The option value to return automatically if nobody responds.
+     * Must match one of the option values exactly.
+     * If omitted, `selected` is null on timeout.
+     *
+     * @example 'cancel' // safe default
+     */
+    fallback?: string;
+}
+export interface SelectResult {
+    /**
+     * The value string of the option the user selected,
+     * or the fallback value on timeout.
+     * Null if timed out with no fallback set.
+     */
+    selected: string | null;
+    /** True if nobody responded before the timeout expired. */
+    timedOut: boolean;
+    /** ISO timestamp of when the user responded. null if timed out. */
+    respondedAt: string | null;
+}
 export type LogLevel = "debug" | "info" | "warn" | "error" | "none" | "silent";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAMD,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "notiformer",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Human-in-the-loop approval gates and real-time push notifications for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",