vybekiit 0.4.0 → 0.6.0

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

@@ -0,0 +1,119 @@
+# Events
+
+## Overview
+
+Events are named signals that can trigger automations and track contact activity. Define an event with an optional schema, then send it to associate it with a contact. Events are the primary way to start automation workflows.
+
+## SDK Methods
+
+### Node.js
+
+| Operation | Method | Notes |
+|-----------|--------|-------|
+| Create | `resend.events.create(params)` | Define a new event with optional schema |
+| Get | `resend.events.get(identifier)` | By ID (UUID) or event name |
+| List | `resend.events.list(params?)` | Cursor-paginated |
+| Update | `resend.events.update(params)` | Only `schema` can be updated |
+| Delete | `resend.events.remove(identifier)` | By ID or event name |
+| Send | `resend.events.send(params)` | Fire an event for a contact |
+
+### Python
+
+`resend.Events.create/get/list/update/remove/send` — same operations with snake_case params.
+
+## Event Schema
+
+Events can have an optional schema — a flat key/type map that defines the expected payload structure.
+
+Supported types: `string`, `number`, `boolean`, `date`
+
+```typescript
+const { data, error } = await resend.events.create({
+  name: 'order.completed',
+  schema: {
+    order_id: 'string',
+    total: 'number',
+    is_first_order: 'boolean',
+    completed_at: 'date',
+  },
+});
+```
+
+```python
+event = resend.Events.create({
+    "name": "order.completed",
+    "schema": {
+        "order_id": "string",
+        "total": "number",
+        "is_first_order": "boolean",
+        "completed_at": "date",
+    },
+})
+```
+
+Schema is optional — events without a schema accept any payload.
+
+## Sending Events
+
+Send an event to associate it with a contact. Provide either `contactId` (Node.js) / `contact_id` (Python) or `email` — exactly one, mutually exclusive.
+
+```typescript
+const { data, error } = await resend.events.send({
+  event: 'order.completed',
+  contactId: 'contact_abc123',
+  payload: {
+    order_id: 'ord_789',
+    total: 99.99,
+    is_first_order: true,
+    completed_at: '2026-04-10T12:00:00Z',
+  },
+});
+```
+
+```python
+resend.Events.send({
+    "event": "order.completed",
+    "email": "customer@example.com",  # or "contact_id": "contact_abc123"
+    "payload": {
+        "order_id": "ord_789",
+        "total": 99.99,
+        "is_first_order": True,
+        "completed_at": "2026-04-10T12:00:00Z",
+    },
+})
+```
+
+Returns `202 Accepted` — the event is processed asynchronously.
+
+## Update and Delete
+
+Only the `schema` field can be updated. Set to `null` to clear it. Get, update, and delete all accept either the event ID (UUID) or event name as `identifier`.
+
+```typescript
+// Update schema
+const { data, error } = await resend.events.update({
+  identifier: 'order.completed',
+  schema: { order_id: 'string', total: 'number' },
+});
+
+// Clear schema
+const { data, error } = await resend.events.update({
+  identifier: 'order.completed',
+  schema: null,
+});
+
+// Delete by name
+const { data, error } = await resend.events.remove('order.completed');
+```
+
+## Common Mistakes
+
+| Mistake | Fix |
+|---------|-----|
+| Event name starting with `resend:` | The `resend:` prefix is reserved for system events |
+| Providing both `contactId`/`contact_id` and `email` on send | Provide exactly one — not both |
+| Providing neither `contactId`/`contact_id` nor `email` on send | Exactly one is required to associate the event with a contact |
+| Expecting synchronous response from send | Send returns `202 Accepted` — processing is async |
+| Trying to update the event name | Only `schema` can be updated — delete and recreate for name changes |
+| Schema type mismatch in payload | Payload values should match the schema types (`string`, `number`, `boolean`, `date`) |
+| Not checking `error` in Node.js | SDK returns `{ data, error }`, does not throw — always destructure and check |

package/dist/global-skills/resend/references/fetch-all-templates.mjs

@@ -0,0 +1,37 @@
+// Requires: npm install resend
+import { Resend } from 'resend';
+
+const resend = new Resend(process.env.RESEND_API_KEY);
+
+async function fetchAllTemplates() {
+  const allTemplates = [];
+  let cursor = null;
+  let hasMore = true;
+
+  while (hasMore) {
+    const listParams = { limit: 100 };
+    if (cursor) {
+      listParams.after = cursor;
+    }
+
+    const { data, error } = await resend.templates.list(listParams);
+
+    if (error) {
+      console.error('Error fetching templates:', error);
+      throw new Error(`Failed to fetch templates: ${error.message}`);
+    }
+
+    allTemplates.push(...data.data);
+
+    hasMore = data.has_more;
+    if (hasMore && data.data.length > 0) {
+      cursor = data.data[data.data.length - 1].id;
+    }
+  }
+
+  return allTemplates;
+}
+
+const templates = await fetchAllTemplates();
+console.log(`Fetched ${templates.length} templates`);
+console.log(templates);

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

@@ -0,0 +1,142 @@
+# Resend SDK Installation Guide
+
+Always install the latest SDK version to ensure you have support for all features including webhook verification (`webhooks.verify()`), email receiving (`emails.receiving.get()`), and domain claiming (`domains.claims.*`). Older versions may not include these methods.
+
+## Minimum SDK Versions
+
+These are the minimum versions required for full functionality (sending, receiving, and webhook verification). Always prefer the latest version when possible.
+
+| Language | Package | Min Version | Install |
+|----------|---------|-------------|---------|
+| Node.js | `resend` | >= 6.14.0 | `npm install resend` |
+| Python | `resend` | >= 2.21.0 | `pip install resend` |
+| Go | `resend-go/v3` | >= 3.1.0 | `go get github.com/resend/resend-go/v3` |
+| Ruby | `resend` | >= 1.0.0 | `gem install resend` |
+| PHP | `resend/resend-php` | >= 1.1.0 | `composer require resend/resend-php` |
+| Rust | `resend-rs` | >= 0.20.0 | `cargo add resend-rs` |
+| Java | `resend-java` | >= 4.11.0 | See [Maven/Gradle](#java) below |
+| .NET | `Resend` | >= 0.2.1 | `dotnet add package Resend` |
+
+> **If the project already has a Resend SDK installed**, check the version and upgrade if it's below the minimum. Older SDKs may be missing `webhooks.verify()`, `emails.receiving.get()`, or `domains.claims.*`, which power webhook security, inbound email, and domain claiming.
+
+## Detecting Project Language
+
+Check for these files to determine the project's language/framework:
+
+| File | Language | SDK |
+|------|----------|-----|
+| `package.json` | Node.js/TypeScript | resend |
+| `requirements.txt` or `pyproject.toml` | Python | resend |
+| `go.mod` | Go | resend-go/v3 |
+| `Gemfile` | Ruby | resend |
+| `composer.json` | PHP | resend/resend-php |
+| `Cargo.toml` | Rust | resend-rs |
+| `pom.xml` or `build.gradle` | Java | resend-java |
+| `*.csproj` or `*.sln` | .NET | Resend |
+| `mix.exs` | Elixir | resend |
+
+## Installation Commands
+
+### Node.js
+
+```bash
+npm install resend
+```
+
+Alternative package managers:
+```bash
+yarn add resend
+pnpm add resend
+bun add resend
+```
+
+### Python
+
+```bash
+pip install resend
+```
+
+### Go
+
+```bash
+go get github.com/resend/resend-go/v3
+```
+
+### Ruby
+
+```bash
+gem install resend
+```
+
+Or add to Gemfile:
+```ruby
+gem 'resend'
+```
+
+### PHP
+
+```bash
+composer require resend/resend-php
+```
+
+### Rust
+
+```bash
+cargo add resend-rs
+cargo add tokio -F macros,rt-multi-thread
+```
+
+### Java
+
+Gradle:
+```gradle
+implementation 'com.resend:resend-java:4.11.0'
+```
+
+Maven:
+```xml
+<dependency>
+  <groupId>com.resend</groupId>
+  <artifactId>resend-java</artifactId>
+  <version>4.11.0</version>
+</dependency>
+```
+
+### .NET
+
+```bash
+dotnet add package Resend
+```
+
+### Elixir
+
+Add to `mix.exs`:
+```elixir
+def deps do
+  [
+    {:resend, "~> 0.4.0"}
+  ]
+end
+```
+
+## API Key Setup
+
+All SDKs require a Resend API key. Get one at https://resend.com/api-keys
+
+Recommended: Store API key in environment variable `RESEND_API_KEY` rather than hardcoding.
+
+## cURL (No SDK)
+
+For quick tests or languages without an SDK, use the REST API directly:
+
+```bash
+curl -X POST 'https://api.resend.com/emails' \
+  -H 'Authorization: Bearer re_xxxxxxxxx' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "from": "Acme <onboarding@resend.dev>",
+    "to": ["delivered@resend.dev"],
+    "subject": "hello world",
+    "html": "<p>it works!</p>"
+  }'
+```

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

@@ -0,0 +1,161 @@
+# Logs
+
+View API request logs programmatically. Useful for debugging, auditing API usage, and monitoring integrations. Each log captures a single API request with its endpoint, method, status code, and user agent. Retrieve a specific log to see the full request and response bodies.
+
+## SDK Methods
+
+| Operation | Node.js | Python |
+|-----------|---------|--------|
+| List | `resend.logs.list(params)` | Not yet available |
+| Get | `resend.logs.get(id)` | Not yet available |
+
+> **SDK availability:** Logs are currently only available in the Node.js SDK and via cURL. Other SDKs (Python, Go, Ruby, PHP, Rust, Java, .NET) do not yet support logs — use cURL as a fallback.
+
+## List Logs
+
+`GET /logs`
+
+### Parameters
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `limit` | number | Yes | 20 | Number of logs to return. Min 1, max 100. |
+| `after` | string | No | — | Log ID to paginate forward from. Cannot combine with `before`. |
+| `before` | string | No | — | Log ID to paginate backward from. Cannot combine with `after`. |
+
+### Node.js
+
+```typescript
+import { Resend } from 'resend';
+const resend = new Resend(process.env.RESEND_API_KEY);
+
+// List recent logs
+const { data, error } = await resend.logs.list({ limit: 20 });
+
+if (error) {
+  console.error(error);
+  return;
+}
+
+console.log(data.has_more); // true if more pages exist
+for (const log of data.data) {
+  console.log(`${log.method} ${log.endpoint} → ${log.response_status}`);
+}
+
+// Paginate forward
+const { data: nextPage } = await resend.logs.list({
+  limit: 20,
+  after: data.data[data.data.length - 1].id,
+});
+```
+
+### cURL
+
+```bash
+curl -s "https://api.resend.com/logs?limit=20" \
+  -H "Authorization: Bearer $RESEND_API_KEY" \
+  -H "User-Agent: curl"
+```
+
+### Response
+
+```json
+{
+  "object": "list",
+  "has_more": true,
+  "data": [
+    {
+      "id": "37e4414c-5e25-4dbc-a071-43552a4bd53b",
+      "created_at": "2026-03-30 13:43:54.622865+00",
+      "endpoint": "/emails",
+      "method": "POST",
+      "response_status": 200,
+      "user_agent": "resend-node:6.0.3"
+    }
+  ]
+}
+```
+
+## Retrieve Log
+
+`GET /logs/{log_id}`
+
+Returns a single log with full request and response bodies.
+
+### Node.js
+
+```typescript
+const { data, error } = await resend.logs.get('37e4414c-5e25-4dbc-a071-43552a4bd53b');
+
+if (error) {
+  console.error(error);
+  return;
+}
+
+console.log(data.request_body);   // original request payload
+console.log(data.response_body);  // original response payload
+console.log(data.response_status); // HTTP status code
+```
+
+### cURL
+
+```bash
+curl -s "https://api.resend.com/logs/37e4414c-5e25-4dbc-a071-43552a4bd53b" \
+  -H "Authorization: Bearer $RESEND_API_KEY" \
+  -H "User-Agent: curl"
+```
+
+### Response
+
+```json
+{
+  "object": "log",
+  "id": "37e4414c-5e25-4dbc-a071-43552a4bd53b",
+  "created_at": "2026-03-30 13:43:54.622865+00",
+  "endpoint": "/emails",
+  "method": "POST",
+  "response_status": 200,
+  "user_agent": "resend-node:6.0.3",
+  "request_body": {
+    "from": "Acme <onboarding@resend.dev>",
+    "to": ["delivered@resend.dev"],
+    "subject": "Hello World"
+  },
+  "response_body": {
+    "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c"
+  }
+}
+```
+
+## Response Fields
+
+| Field | In List | In Get | Description |
+|-------|---------|--------|-------------|
+| `id` | Yes | Yes | Log UUID |
+| `created_at` | Yes | Yes | Timestamp with timezone |
+| `endpoint` | Yes | Yes | API path called (e.g., `/emails`, `/domains`) |
+| `method` | Yes | Yes | HTTP method (GET, POST, DELETE, etc.) |
+| `response_status` | Yes | Yes | HTTP response status code |
+| `user_agent` | Yes | Yes | Client user agent (includes SDK name/version) |
+| `request_body` | No | Yes | Original request payload |
+| `response_body` | No | Yes | Original response payload |
+
+## Pagination
+
+Cursor-based using `after` and `before` parameters:
+
+- **Forward:** pass `after` with the last log's `id` to get the next page
+- **Backward:** pass `before` with the first log's `id` to get the previous page
+- **Cannot combine** `after` and `before` in the same request (returns 422)
+- Check `has_more` to know if more pages exist
+
+## Common Mistakes
+
+| Mistake | Fix |
+|---------|-----|
+| Expecting `request_body`/`response_body` in list response | These fields are only returned by the get endpoint — call `resend.logs.get(id)` for full details |
+| Using both `after` and `before` together | Pick one — they are mutually exclusive (returns 422) |
+| Using Python/Go/Ruby SDK for logs | Logs are only in the Node.js SDK currently — use cURL for other languages |
+| Not passing `limit` | `limit` is required — set it explicitly (1–100, default 20) |
+| Calling `.delete()` or `.remove()` | Logs are read-only — there are no create, update, or delete operations |
+| Missing `User-Agent` header in cURL | Resend API requires a `User-Agent` header — omitting it returns 403 |