vybekiit 0.7.18 → 0.7.19

package/dist/global-skills/resend/SKILL.md

@@ -156,7 +156,7 @@ export async function POST(req: Request) {
 | **Send batch emails** | [sending/overview.md](references/sending/overview.md) → [sending/batch-email-examples.md](references/sending/batch-email-examples.md) |
 | **Full SDK examples** (Node.js, Python, Go, cURL) | [sending/single-email-examples.md](references/sending/single-email-examples.md) |
 | **Idempotency, retries, error handling** | [sending/best-practices.md](references/sending/best-practices.md) |
-| **Get, list, reschedule, cancel emails** | [sending/email-management.md](references/sending/email-management.md) |
+| **Get, list, reschedule, cancel emails, retrieve metrics** | [sending/email-management.md](references/sending/email-management.md) |
 | **Receive inbound emails** | [receiving.md](references/receiving.md) — domain setup, webhooks, attachments |
 | **Manage templates** (CRUD, variables) | [templates.md](references/templates.md) — lifecycle, aliases, pagination |
 | **Set up webhooks** (events, verification) | [webhooks.md](references/webhooks.md) — verification, CRUD, retry schedule, IP allowlist |

package/dist/global-skills/resend/references/api-keys.md

@@ -1,6 +1,6 @@
 # API Keys
 
-Create, list, and delete API keys programmatically. No get or update endpoints exist.
+Create, list, update, and delete API keys programmatically. No get endpoint exists.
 
 ## SDK Methods
 
@@ -8,6 +8,7 @@ Create, list, and delete API keys programmatically. No get or update endpoints e
 |-----------|---------|--------|
 | Create | `resend.apiKeys.create(params)` | `resend.ApiKeys.create(params)` |
 | List | `resend.apiKeys.list(params?)` | `resend.ApiKeys.list()` |
+| Update | `resend.apiKeys.update(id, params)` | `resend.ApiKeys.update(params)` |
 | Delete | `resend.apiKeys.remove(id)` | `resend.ApiKeys.remove(id)` |
 
 ## Create Parameters
@@ -20,6 +21,12 @@ Create, list, and delete API keys programmatically. No get or update endpoints e
 - `domainId`: only applies when `permission` is `"sending_access"` — scopes the key to a single domain
 - `name`: max 50 characters
 
+## Update Parameters
+
+**Required:** `name`
+
+Only `name` can be changed. `permission` and `domainId` are fixed at creation — recreate the key to change either.
+
 ## Examples
 
 ### Node.js
@@ -47,6 +54,11 @@ console.log('Key ID:', data.id);
 // List all keys (tokens are NOT included in list response)
 const { data: keys, error: listError } = await resend.apiKeys.list();
 
+// Rename a key (only `name` is patchable)
+const { data: updated, error: updateError } = await resend.apiKeys.update('api_key_id', {
+  name: 'Production Sending Key v2',
+});
+
 // Delete a key
 const { data: deleted, error: deleteError } = await resend.apiKeys.remove('api_key_id');
 ```
@@ -71,6 +83,12 @@ print(f"API Key: {key['token']}")
 # List all keys
 keys = resend.ApiKeys.list()
 
+# Rename a key (only "name" is patchable)
+resend.ApiKeys.update({
+    "api_key_id": "api_key_id",
+    "name": "Production Sending Key v2",
+})
+
 # Delete a key
 resend.ApiKeys.remove("api_key_id")
 ```
@@ -80,7 +98,8 @@ resend.ApiKeys.remove("api_key_id")
 | Mistake | Fix |
 |---------|-----|
 | Not storing the token on create | The token is returned **once** — store it immediately |
-| Expecting a get or update endpoint | Neither exists — list returns metadata only (no tokens) |
+| Expecting a get endpoint | Doesn't exist — list returns metadata only (no tokens) |
+| Trying to update `permission` or `domainId` | Only `name` can be patched — recreate the key to change scope |
 | Setting `domainId` with `full_access` | `domainId` only applies to `sending_access` keys |
 | Calling `.delete()` instead of `.remove()` | Node.js SDK uses `.remove()` for all delete operations |
 | Ignoring `error` return | Node.js SDK returns `{ data, error }` — always check `error` |

package/dist/global-skills/resend/references/broadcasts.md

@@ -13,6 +13,8 @@ Send emails to audience segments. Broadcasts follow a two-step lifecycle: **crea
 | Cancel | `resend.broadcasts.cancel(id)` | `resend.Broadcasts.cancel(id)` |
 | Update | `resend.broadcasts.update(id, params)` | `resend.Broadcasts.update(params)` |
 | Delete | `resend.broadcasts.remove(id)` | `resend.Broadcasts.remove(id)` |
+| Clicked Links | `resend.broadcasts.clickedLinks(id, params?)` | `resend.Broadcasts.clicked_links(id, params?)` |
+| Recipients | `resend.broadcasts.recipients(id, params)` | `resend.Broadcasts.recipients(id, params)` |
 
 ## Create Parameters
 
@@ -88,8 +90,36 @@ const { data, error } = await resend.broadcasts.cancel('bc_abc123');
 // Delete — draft or scheduled only (deleting a scheduled broadcast also
 // cancels its delivery). Sent broadcasts cannot be deleted.
 const { data, error } = await resend.broadcasts.remove('bc_abc123');
+
+// Clicked links — ranked by total clicks, paginated with cursors
+const { data, error } = await resend.broadcasts.clickedLinks('bc_abc123', { limit: 10 });
+```
+
+## Recipients
+
+List who a broadcast was sent to, filtered by a single event `type`. Results are
+paginated with cursors (`after` / `before`).
+
+```typescript
+// Who opened it
+const { data, error } = await resend.broadcasts.recipients('bc_abc123', {
+  type: 'opened',
+});
+
+// Who bounced, filtered to permanent bounces only
+const { data, error } = await resend.broadcasts.recipients('bc_abc123', {
+  type: 'bounced',
+  bounceType: 'permanent',
+});
 ```
 
+`type` is required: `sent`, `delivered`, `opened`, `clicked`, `bounced`,
+`complained`, `unsubscribed`, or `suppressed`. Each recipient row always has
+`id` (an opaque pagination cursor, not a real entity id), `contact_id`
+(nullable), and `email`. Depending on `type`, rows also include `count`
+(opened/clicked), `bounce_type` (bounced), or `clicked_links` (clicked).
+`bounce_type` is only meaningful when `type` is `bounced`.
+
 ## Python Example
 
 ```python
@@ -131,3 +161,5 @@ Use triple-mustache with a pipe for fallbacks: `{{{PROPERTY_KEY|fallback}}}`
 | `{{VAR}}` instead of `{{{VAR}}}` | Triple braces required for variable interpolation |
 | Ignoring `error` return | Node.js SDK returns `{ data, error }` — always check `error` |
 | `scheduledAt` format confusion | Accepts both ISO 8601 (`2025-03-15T10:00:00Z`) and natural language (`in 1 hour`) |
+| Treating clicked links' `id` as an entity ID | It's an opaque pagination cursor for that row — use it with `after`/`before`, not to look up the link elsewhere |
+| Passing `bounceType` with a non-`bounced` type | Rejected with a 422 — only meaningful when `type: 'bounced'` |

package/dist/global-skills/resend/references/sending/email-management.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-After sending, emails can be retrieved, listed, rescheduled, or cancelled. Updates are limited to `scheduled_at` only — content cannot be changed after creation.
+After sending, emails can be retrieved, listed, rescheduled, cancelled, or shared. Updates are limited to `scheduled_at` only — content cannot be changed after creation.
 
 ## SDK Methods
 
@@ -14,6 +14,7 @@ After sending, emails can be retrieved, listed, rescheduled, or cancelled. Updat
 | List | `resend.emails.list({ limit, offset })` | Paginated list of sent emails |
 | Update | `resend.emails.update({ id, scheduledAt })` | Reschedule only — no content changes |
 | Cancel | `resend.emails.cancel(id)` | Cancel a scheduled email before it sends |
+| Share | `resend.emails.share(id, { expiresIn })` | Create a public link for a sent or received email; `expiresIn` defaults to and caps at 48h |
 
 ### Python
 
@@ -23,6 +24,7 @@ After sending, emails can be retrieved, listed, rescheduled, or cancelled. Updat
 | List | `resend.Emails.list(params)` |
 | Update | `resend.Emails.update(params)` — params: `{ "id": ..., "scheduled_at": ... }` |
 | Cancel | `resend.Emails.cancel(id)` |
+| Share | `resend.Emails.share(email_id, params)` — params: `{ "expires_in": ... }` |
 
 ## Examples
 
@@ -72,6 +74,26 @@ if (error) console.error(error);
 resend.Emails.cancel("email_abc123")
 ```
 
+### Share a Sent or Received Email
+
+Creates a public, unauthenticated link — anyone with the URL can view the email. Works for both sent and received emails; the API detects which type the ID belongs to.
+
+```typescript
+const { data, error } = await resend.emails.share('email_abc123', {
+  expiresIn: '2 hours', // optional — human-readable duration, defaults to and caps at 48h
+});
+if (error) {
+  console.error(error);
+} else {
+  console.log(data.url);
+}
+```
+
+```python
+shared = resend.Emails.share("email_abc123", {"expires_in": "2 hours"})
+print(shared["url"])
+```
+
 ## Retrieving Attachments
 
 List and download attachments for sent emails. Returns metadata and a signed download URL.
@@ -124,6 +146,84 @@ const buffer = await response.arrayBuffer();
 | `expires_at` | string | When the download URL expires |
 | `size` | number | Size in bytes |
 
+## Retrieving Metrics
+
+Account-level email delivery and engagement metrics (sent, delivered, bounced, opened, clicked, etc.) for a date range. With no options, returns totals only. Optionally broken down by one or more dimensions: `period`, `domain`, `email`, `broadcast`.
+
+`email` and `broadcast` are mutually exclusive — as dimensions, and as filters (`emailId`/`broadcastId`). Requesting both, in either form, is rejected.
+
+### SDK Methods
+
+| Operation | Node.js | Python |
+|-----------|---------|--------|
+| Get metrics | `resend.emails.metrics(options)` | `resend.Emails.metrics(params)` |
+
+`options`/`params` (all optional):
+
+| Field (Node.js / Python) | Type | Notes |
+|-------|------|-------|
+| `startDate` / `start_date` | string | ISO 8601 date or datetime. Defaults to 6 days before `endDate` |
+| `endDate` / `end_date` | string | ISO 8601 date or datetime. Defaults to now |
+| `timezone` | string | IANA timezone, e.g. `America/New_York`. Defaults to UTC |
+| `granularity` | string | `hourly`, `daily`, `weekly`, or `monthly` — bucket size when `period` is a dimension. Defaults to `daily` |
+| `metrics` | string[] | Which metrics to include. Defaults to all |
+| `dimensions` | string[] | `period`, `domain`, `email`, `broadcast` — combinable except `email`+`broadcast` |
+| `domainId` / `domain_id` | string[] | Restrict to these sending domain IDs (max 100) |
+| `emailId` / `email_id` | string[] | Restrict to these email IDs (max 100). Cannot combine with `broadcast` dimension/`broadcastId` |
+| `broadcastId` / `broadcast_id` | string[] | Restrict to these broadcast IDs (max 100). Cannot combine with `email` dimension/`emailId` |
+
+### Examples
+
+```typescript
+// Totals only, default 6-day window
+const { data, error } = await resend.emails.metrics();
+if (error) {
+  console.error(error);
+  return;
+}
+console.log(data.totals.sent, data.totals.delivered);
+```
+
+```python
+# Totals only, default 6-day window
+metrics = resend.Emails.metrics({})
+print(metrics["totals"]["sent"], metrics["totals"]["delivered"])
+```
+
+```typescript
+// Broken down by period and broadcast, filtered to one broadcast
+const { data, error } = await resend.emails.metrics({
+  startDate: '2026-07-01',
+  endDate: '2026-07-08',
+  dimensions: ['period', 'broadcast'],
+  broadcastId: ['bc_abc123'],
+});
+if (error) console.error(error);
+
+for (const row of data.data ?? []) {
+  console.log(row.period, row.broadcast_name, row.delivered);
+}
+```
+
+```python
+metrics = resend.Emails.metrics({
+    "start_date": "2026-07-01",
+    "end_date": "2026-07-08",
+    "dimensions": ["period", "broadcast"],
+    "broadcast_id": ["bc_abc123"],
+})
+
+for row in metrics.get("data", []):
+    print(row["period"], row["broadcast_name"], row["delivered"])
+```
+
+### Metrics Response Fields
+
+| Field | Type | Description |
+|-------|------|--------------|
+| `totals` | object | Metric totals for the whole date range, keyed by metric name |
+| `data` | array \| absent | Per-dimension breakdown rows. Absent when no `dimensions` were requested |
+
 ## Common Mistakes
 
 | Mistake | Fix |
@@ -133,3 +233,7 @@ const buffer = await response.arrayBuffer();
 | Cancelling too late | Cancel before the `scheduled_at` time — there's a brief processing window before send |
 | Not checking `error` in Node.js | SDK returns `{ data, error }`, does not throw — always destructure and check |
 | Using `.list()` without pagination | Pass `limit` and `offset` to paginate through results |
+| Combining `email` and `broadcast` in metrics | These are mutually exclusive as dimensions and as filters — the request is rejected |
+| Expecting `unique_opened`/`open_rate`-style metrics without tracking enabled | Open/click tracking must be enabled on the sending domain for these to be meaningful |
+| Assuming a longer `expiresIn` is possible | 48 hours is the maximum — requesting more returns a validation error |
+| Treating share links as revocable | There's no revoke endpoint — the link is valid until it expires, no early invalidation |

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "vybekiit",
-  "version": "0.7.18",
+  "version": "0.7.19",
   "description": "Choose your services, sign in, create a VybeKiit app, and open its verified local welcome page.",
   "license": "MIT",
+  "packageManager": "pnpm@10.33.2",
   "publishConfig": {
     "access": "public"
   },
@@ -13,36 +14,36 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup && node scripts/bundleGlobalSkills.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "@aws-sdk/client-dynamodb": "^3.1075.0",
     "@aws-sdk/client-s3": "^3.1075.0",
     "@aws-sdk/lib-dynamodb": "^3.1075.0",
-    "@clack/prompts": "1.7.0",
+    "@clack/prompts": "catalog:",
     "@neondatabase/serverless": "^0.10.4",
     "@supabase/supabase-js": "^2.47.10",
-    "effect": "3.21.4",
+    "effect": "catalog:",
     "firebase-admin": "^13.0.2",
     "mongodb": "^7.4.0",
-    "open": "11.0.0",
+    "open": "catalog:",
     "playwright": "^1.61.1"
   },
   "devDependencies": {
-    "@types/node": "22.20.0",
-    "tsup": "8.5.1",
-    "typescript": "5.7.2",
-    "vitest": "3.2.6",
-    "@vybekiit/db": "0.7.18",
-    "@vybekiit/agent-kit": "0.7.18",
-    "@vybekiit/deploy": "0.7.18",
-    "@vybekiit/core": "0.7.18",
-    "@vybekiit/agent-mcp": "0.7.18",
-    "@vybekiit/payments": "0.7.18",
-    "@vybekiit/report-mode": "0.7.18"
-  },
-  "scripts": {
-    "build": "tsup && node scripts/bundleGlobalSkills.mjs",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "@types/node": "catalog:",
+    "tsup": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "@vybekiit/agent-kit": "workspace:*",
+    "@vybekiit/agent-mcp": "workspace:*",
+    "@vybekiit/core": "workspace:*",
+    "@vybekiit/db": "workspace:*",
+    "@vybekiit/deploy": "workspace:*",
+    "@vybekiit/payments": "workspace:*",
+    "@vybekiit/report-mode": "workspace:*"
   }
-}
+}