@hasna/connectors 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +6 -0
  2. package/bin/index.js +353 -3
  3. package/bin/mcp.js +1 -1
  4. package/connectors/connect-anthropic/AGENTS.md +22 -0
  5. package/connectors/connect-anthropic/CLAUDE.md +29 -0
  6. package/connectors/connect-anthropic/README.md +22 -3
  7. package/connectors/connect-anthropic/src/types/index.ts +46 -2
  8. package/connectors/connect-aws/CLAUDE.md +16 -0
  9. package/connectors/connect-brandsight/CLAUDE.md +5 -0
  10. package/connectors/connect-cloudflare/CLAUDE.md +21 -0
  11. package/connectors/connect-discord/CLAUDE.md +19 -0
  12. package/connectors/connect-docker/CLAUDE.md +8 -0
  13. package/connectors/connect-e2b/CLAUDE.md +21 -0
  14. package/connectors/connect-elevenlabs/CLAUDE.md +24 -0
  15. package/connectors/connect-exa/CLAUDE.md +35 -0
  16. package/connectors/connect-figma/CLAUDE.md +34 -0
  17. package/connectors/connect-firecrawl/CLAUDE.md +27 -0
  18. package/connectors/connect-github/CLAUDE.md +32 -2
  19. package/connectors/connect-gmail/CLAUDE.md +22 -0
  20. package/connectors/connect-google/CLAUDE.md +11 -0
  21. package/connectors/connect-googlecalendar/CLAUDE.md +9 -0
  22. package/connectors/connect-googlecloud/CLAUDE.md +12 -0
  23. package/connectors/connect-googlecontacts/CLAUDE.md +7 -0
  24. package/connectors/connect-googledocs/CLAUDE.md +7 -0
  25. package/connectors/connect-googledrive/CLAUDE.md +5 -0
  26. package/connectors/connect-googlegemini/CLAUDE.md +18 -0
  27. package/connectors/connect-googlegemini/src/types/index.ts +10 -3
  28. package/connectors/connect-googlemaps/CLAUDE.md +15 -0
  29. package/connectors/connect-googlesheets/CLAUDE.md +10 -0
  30. package/connectors/connect-googletasks/CLAUDE.md +6 -0
  31. package/connectors/connect-hedra/CLAUDE.md +15 -0
  32. package/connectors/connect-heygen/CLAUDE.md +14 -0
  33. package/connectors/connect-huggingface/CLAUDE.md +20 -0
  34. package/connectors/connect-icons8/CLAUDE.md +6 -0
  35. package/connectors/connect-maropost/CLAUDE.md +6 -0
  36. package/connectors/connect-mercury/CLAUDE.md +14 -0
  37. package/connectors/connect-meta/CLAUDE.md +16 -0
  38. package/connectors/connect-midjourney/CLAUDE.md +7 -0
  39. package/connectors/connect-mistral/CLAUDE.md +20 -0
  40. package/connectors/connect-mistral/src/types/index.ts +42 -7
  41. package/connectors/connect-mixpanel/CLAUDE.md +11 -0
  42. package/connectors/connect-notion/CLAUDE.md +30 -0
  43. package/connectors/connect-openai/AGENTS.md +15 -0
  44. package/connectors/connect-openai/CLAUDE.md +23 -0
  45. package/connectors/connect-openai/src/types/index.ts +36 -14
  46. package/connectors/connect-openweathermap/CLAUDE.md +8 -0
  47. package/connectors/connect-pandadoc/CLAUDE.md +18 -0
  48. package/connectors/connect-quo/CLAUDE.md +5 -0
  49. package/connectors/connect-reddit/CLAUDE.md +20 -0
  50. package/connectors/connect-reducto/CLAUDE.md +16 -0
  51. package/connectors/connect-resend/CLAUDE.md +21 -0
  52. package/connectors/connect-revolut/CLAUDE.md +17 -0
  53. package/connectors/connect-sedo/CLAUDE.md +6 -0
  54. package/connectors/connect-sentry/CLAUDE.md +11 -0
  55. package/connectors/connect-shadcn/CLAUDE.md +42 -0
  56. package/connectors/connect-shopify/CLAUDE.md +18 -0
  57. package/connectors/connect-snap/CLAUDE.md +6 -0
  58. package/connectors/connect-stabilityai/CLAUDE.md +13 -0
  59. package/connectors/connect-stripe/CLAUDE.md +19 -0
  60. package/connectors/connect-stripeatlas/CLAUDE.md +7 -0
  61. package/connectors/connect-substack/CLAUDE.md +6 -0
  62. package/connectors/connect-tiktok/CLAUDE.md +25 -0
  63. package/connectors/connect-tinker/CLAUDE.md +6 -0
  64. package/connectors/connect-twilio/CLAUDE.md +9 -0
  65. package/connectors/connect-uspto/CLAUDE.md +8 -0
  66. package/connectors/connect-webflow/CLAUDE.md +19 -0
  67. package/connectors/connect-wix/CLAUDE.md +20 -0
  68. package/connectors/connect-x/CLAUDE.md +15 -0
  69. package/connectors/connect-xads/CLAUDE.md +10 -0
  70. package/connectors/connect-xai/CLAUDE.md +15 -0
  71. package/connectors/connect-xai/src/types/index.ts +20 -4
  72. package/connectors/connect-youtube/CLAUDE.md +28 -0
  73. package/connectors/connect-zoom/CLAUDE.md +15 -0
  74. package/dist/lib/test-endpoints.d.ts +12 -0
  75. package/package.json +1 -1
@@ -47,6 +47,22 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Graph API Updates (2025-2026)
51
+
52
+ ### Current Version: v24.0 (Oct 2025)
53
+
54
+ ### Breaking Changes in v24.0
55
+ - **Advantage+ Shopping/App campaigns**: Cannot be created/updated via API from v24.0 (Feb 2025). Extends to ALL versions by May 19, 2026. Migrate to new Automation Unification workflow.
56
+ - **Customer file custom audiences**: Flagged audiences fail to update (effective Jan 6, 2026 for all versions)
57
+ - **Certificate Transparency**: All endpoints/webhooks removed (Oct 17, 2025)
58
+ - **Live Video API**: `overlay_url` field removed
59
+ - **Messenger lead ads**: Cannot create lead ads that generate leads in Messenger via API
60
+
61
+ ### Upcoming Changes (by Jun 2026)
62
+ - **Page Viewer Metric**: Replaces legacy reach metric — consistent cross-platform measurement (Facebook + Instagram)
63
+ - **Retiring**: Post/Page Reach, Video Impressions, Story Impressions metrics
64
+ - **Webhook permissions**: Updates coming
65
+
50
66
  ## Authentication
51
67
 
52
68
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,13 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Status (2026) — Important
51
+
52
+ No official public API. The official API is only available to Enterprise subscribers.
53
+ - Official API: `https://api.midjourney.com/v2` with Bearer token (Enterprise only)
54
+ - Current model: **v8** (2026) — text rendering, video gen (10s/60fps), 3D export, `--cref`
55
+ - Unofficial third-party wrappers (Apiframe, TTAPI) available but may violate ToS
56
+
50
57
  ## Authentication
51
58
 
52
59
  Bearer Token authentication. Credentials can be set via:
@@ -47,6 +47,26 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Models (2026)
51
+
52
+ | Model | Description |
53
+ |-------|-------------|
54
+ | `mistral-large-latest` | Large 3 (Dec 2025), top-tier |
55
+ | `mistral-medium-latest` | Medium 3.1 (Aug 2025), multimodal — **recommended default** |
56
+ | `magistral-medium-latest` | Magistral 1.2 (Sep 2025), reasoning + vision, 40K ctx |
57
+ | `codestral-latest` | Codestral 2508, code specialist, 256K context |
58
+ | `devstral-latest` | Devstral Medium, coding agents, multi-file editing |
59
+ | `ministral-8b-latest` | Edge model, fast and cheap |
60
+ | `ministral-3b-latest` | Fastest edge model |
61
+
62
+ New capabilities (2025-2026):
63
+ - **OCR / Document AI**: `mistral-ocr-2512` via `POST /v1/ocr`
64
+ - **Audio transcription**: `voxtral-mini-2602` via `POST /v1/audio/transcriptions` (with diarize, context biasing)
65
+ - **Reasoning**: Magistral series with extended thinking
66
+ - **Coding agents**: Devstral for multi-file codebase exploration
67
+
68
+ Default: `mistral-medium-latest`
69
+
50
70
  ## Authentication
51
71
 
52
72
  Bearer Token authentication. Credentials can be set via:
@@ -5,26 +5,61 @@ export interface MistralConfig {
5
5
  baseUrl?: string;
6
6
  }
7
7
 
8
- // Models
8
+ // Models (2026)
9
9
  export type MistralModel =
10
- | 'mistral-large-latest'
10
+ // Latest aliases (always point to newest)
11
+ | 'mistral-large-latest' // → mistral-large-2512
12
+ | 'mistral-medium-latest' // → mistral-medium-2508
11
13
  | 'mistral-small-latest'
12
- | 'codestral-latest'
14
+ | 'codestral-latest' // → codestral-2508
15
+ | 'magistral-medium-latest' // → magistral-medium-2509
13
16
  | 'ministral-8b-latest'
14
17
  | 'ministral-3b-latest'
15
- | 'open-mistral-nemo'
16
- | 'pixtral-large-latest';
18
+ | 'pixtral-large-latest'
19
+ | 'devstral-latest'
20
+ // Pinned versions (2025-2026)
21
+ | 'mistral-large-2512' // Mistral Large 3 (Dec 2025)
22
+ | 'mistral-medium-2508' // Mistral Medium 3.1 (Aug 2025)
23
+ | 'mistral-medium-2505' // Mistral Medium 3 (May 2025)
24
+ | 'magistral-medium-2509' // Magistral Medium 1.2 (Sep 2025, reasoning)
25
+ | 'magistral-medium-2507' // Magistral Medium 1.1
26
+ | 'magistral-medium-2506' // Magistral Medium 1.0
27
+ | 'magistral-small-2509' // Magistral Small 1.2
28
+ | 'codestral-2508' // Codestral (Jul 2025, 256K context)
29
+ | 'codestral-2501'
30
+ | 'devstral-medium-2507' // Devstral (coding agents)
31
+ | 'ministral-3b-2512'
32
+ | 'ministral-8b-2512'
33
+ | 'ministral-14b-2512'
34
+ | 'ministral-3b-2410'
35
+ | 'ministral-8b-2410'
36
+ | 'open-mistral-nemo';
17
37
 
18
38
  export type MistralEmbeddingModel = 'mistral-embed';
19
39
 
40
+ export type MistralOCRModel = 'mistral-ocr-2512' | 'mistral-ocr-2505';
41
+
42
+ export type MistralAudioModel = 'voxtral-mini-2602' | 'voxtral-mini-transcribe-realtime-2602' | 'voxtral-mini-2507';
43
+
20
44
  export const MISTRAL_MODELS: MistralModel[] = [
45
+ // Latest aliases
21
46
  'mistral-large-latest',
47
+ 'mistral-medium-latest',
22
48
  'mistral-small-latest',
23
49
  'codestral-latest',
50
+ 'magistral-medium-latest',
24
51
  'ministral-8b-latest',
25
52
  'ministral-3b-latest',
26
- 'open-mistral-nemo',
27
53
  'pixtral-large-latest',
54
+ 'devstral-latest',
55
+ // Pinned versions
56
+ 'mistral-large-2512',
57
+ 'mistral-medium-2508',
58
+ 'magistral-medium-2509',
59
+ 'codestral-2508',
60
+ 'devstral-medium-2507',
61
+ 'ministral-14b-2512',
62
+ 'open-mistral-nemo',
28
63
  ];
29
64
 
30
65
  // Chat Completions
@@ -156,7 +191,7 @@ export interface EmbeddingOptions {
156
191
  model?: MistralEmbeddingModel | string;
157
192
  }
158
193
 
159
- export const DEFAULT_CHAT_MODEL: MistralModel = 'mistral-small-latest';
194
+ export const DEFAULT_CHAT_MODEL: MistralModel = 'mistral-medium-latest';
160
195
  export const DEFAULT_EMBEDDING_MODEL: MistralEmbeddingModel = 'mistral-embed';
161
196
 
162
197
  // Common types
@@ -47,6 +47,17 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Base URLs:
53
+ - Ingestion: `https://api.mixpanel.com/`
54
+ - Query (EU): `https://eu.mixpanel.com/api/query/`
55
+
56
+ Auth: Service Account credentials (username:password as HTTP Basic Auth) for Query API. Project token for Ingestion API.
57
+
58
+ Key endpoints: `/track` (events), `/engage` (user profiles), `/groups` (group analytics), `/import` (batch import).
59
+ Query API: `/segmentation`, `/funnel`, `/retention`, `/events`.
60
+
50
61
  ## Authentication
51
62
 
52
63
  API Key authentication. Credentials can be set via:
@@ -56,6 +56,36 @@ src/
56
56
  └── index.ts # Library exports
57
57
  ```
58
58
 
59
+ ## API Version (2026) — BREAKING CHANGES
60
+
61
+ ### Current Version: `2026-03-11`
62
+ Set header: `Notion-Version: 2026-03-11`
63
+ SDK: upgrade to `@notionhq/client` v5.12.0+
64
+
65
+ ### Breaking Changes in `2026-03-11`
66
+
67
+ | Change | Old (`2025-09-03`) | New (`2026-03-11`) |
68
+ |--------|-------------------|-------------------|
69
+ | Block positioning | `after: "block-id"` string | `position: { type: "after_block", after_block: { id: "..." } }` |
70
+ | Trash status | `archived: true/false` | `in_trash: true/false` |
71
+ | Block type | `transcription` | `meeting_notes` |
72
+
73
+ #### 1. Replace `after` → `position` (Append Block Children)
74
+ ```json
75
+ // NEW: PATCH /v1/blocks/{id}/children
76
+ { "position": { "type": "after_block", "after_block": { "id": "b5d8fd79-..." } }, "children": [...] }
77
+ // position types: "after_block", "start", "end"
78
+ ```
79
+
80
+ #### 2. Replace `archived` → `in_trash`
81
+ ```json
82
+ // NEW: PATCH /v1/pages/{id}
83
+ { "in_trash": true }
84
+ ```
85
+ Applies to pages, databases, blocks, and data sources in both requests AND responses.
86
+
87
+ #### 3. Replace `transcription` → `meeting_notes` block type
88
+
59
89
  ## Authentication
60
90
 
61
91
  Two authentication methods supported:
@@ -6,6 +6,21 @@ This file provides guidance to AI coding agents when working with this repositor
6
6
 
7
7
  connect-openai is a TypeScript CLI and library for OpenAI's API. It provides chat completions, embeddings, and image generation with multi-profile support.
8
8
 
9
+ ## Models (2026)
10
+
11
+ | Model | Description |
12
+ |-------|-------------|
13
+ | `gpt-5.4` | Latest, most capable |
14
+ | `gpt-4.1-mini` | Fast, cheap — **use as default** |
15
+ | `gpt-4.1` | High capability |
16
+ | `o3` | Advanced reasoning |
17
+ | `o4-mini` | Fast reasoning |
18
+ | `gpt-image-1` | Image generation (preferred over DALL-E 3) |
19
+
20
+ Default: `gpt-4.1-mini`
21
+
22
+ Note: GPT-4o, GPT-4.1, o4-mini retired from **ChatGPT** Feb 2026 — still available in API.
23
+
9
24
  ## Build & Run Commands
10
25
 
11
26
  ```bash
@@ -47,6 +47,29 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Models (2026)
51
+
52
+ | Model | Description |
53
+ |-------|-------------|
54
+ | `gpt-5.4` | Latest GPT-5, most capable |
55
+ | `gpt-5.2` / `gpt-5.1` | GPT-5 variants |
56
+ | `gpt-4.1` | High-capability, cost-effective |
57
+ | `gpt-4.1-mini` | Fast and cheap — **recommended default** |
58
+ | `gpt-4o` | Still supported in API (retired from ChatGPT Feb 2026) |
59
+ | `o4-mini` | Reasoning model, fast |
60
+ | `o3` | Advanced reasoning |
61
+ | `gpt-image-1` | Native image generation (replaces DALL-E 3 for new projects) |
62
+
63
+ Default: `gpt-4.1-mini`
64
+
65
+ ## Responses API (2025+)
66
+
67
+ For agentic use cases, prefer the **Responses API** over Chat Completions:
68
+ - Built-in tools: file search, code interpreter, image generation, MCP support
69
+ - Stateful conversations
70
+ - Endpoint: `POST /v1/responses`
71
+ - Use Chat Completions for simple text generation; Responses API for agents
72
+
50
73
  ## Authentication
51
74
 
52
75
  Bearer Token authentication. Credentials can be set via:
@@ -6,39 +6,61 @@ export interface OpenAIConfig {
6
6
  organization?: string;
7
7
  }
8
8
 
9
- // Models
9
+ // Models (2026)
10
10
  export type OpenAIModel =
11
+ // GPT-5 series (2025-2026, latest)
12
+ | 'gpt-5.4'
13
+ | 'gpt-5.2'
14
+ | 'gpt-5.1'
15
+ | 'gpt-5'
16
+ // GPT-4.1 series (2025)
17
+ | 'gpt-4.1'
18
+ | 'gpt-4.1-mini'
19
+ // GPT-4o (still supported in API)
11
20
  | 'gpt-4o'
12
21
  | 'gpt-4o-mini'
22
+ // o-series reasoning models
23
+ | 'o4-mini'
24
+ | 'o3'
25
+ | 'o3-mini'
26
+ | 'o1'
27
+ // Legacy
13
28
  | 'gpt-4-turbo'
14
29
  | 'gpt-4'
15
- | 'gpt-3.5-turbo'
16
- | 'o1'
17
- | 'o1-mini'
18
- | 'o1-preview'
19
- | 'o3-mini';
30
+ | 'gpt-3.5-turbo';
20
31
 
21
32
  export type EmbeddingModel =
22
33
  | 'text-embedding-3-small'
23
34
  | 'text-embedding-3-large'
24
35
  | 'text-embedding-ada-002';
25
36
 
26
- export type ImageModel = 'dall-e-3' | 'dall-e-2';
37
+ export type ImageModel = 'gpt-image-1' | 'dall-e-3' | 'dall-e-2';
27
38
 
28
- export type TTSModel = 'tts-1' | 'tts-1-hd';
39
+ export type TTSModel = 'tts-1' | 'tts-1-hd' | 'gpt-4o-mini-tts';
29
40
 
30
- export type STTModel = 'whisper-1';
41
+ export type STTModel = 'whisper-1' | 'gpt-4o-transcribe';
31
42
 
32
43
  export const OPENAI_MODELS: OpenAIModel[] = [
44
+ // GPT-5 series
45
+ 'gpt-5.4',
46
+ 'gpt-5.2',
47
+ 'gpt-5.1',
48
+ 'gpt-5',
49
+ // GPT-4.1
50
+ 'gpt-4.1',
51
+ 'gpt-4.1-mini',
52
+ // GPT-4o
33
53
  'gpt-4o',
34
54
  'gpt-4o-mini',
55
+ // o-series
56
+ 'o4-mini',
57
+ 'o3',
58
+ 'o3-mini',
59
+ 'o1',
60
+ // Legacy
35
61
  'gpt-4-turbo',
36
62
  'gpt-4',
37
63
  'gpt-3.5-turbo',
38
- 'o1',
39
- 'o1-mini',
40
- 'o1-preview',
41
- 'o3-mini',
42
64
  ];
43
65
 
44
66
  // Chat Completions
@@ -213,7 +235,7 @@ export interface ImageOptions {
213
235
  n?: number;
214
236
  }
215
237
 
216
- export const DEFAULT_CHAT_MODEL: OpenAIModel = 'gpt-4o-mini';
238
+ export const DEFAULT_CHAT_MODEL: OpenAIModel = 'gpt-4.1-mini';
217
239
  export const DEFAULT_EMBEDDING_MODEL: EmbeddingModel = 'text-embedding-3-small';
218
240
  export const DEFAULT_IMAGE_MODEL: ImageModel = 'dall-e-3';
219
241
 
@@ -47,6 +47,14 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Current version: **API 3.0** (One Call API 3.0) — requires subscription.
53
+ - Free tier: `https://api.openweathermap.org/data/2.5/` (weather, forecast)
54
+ - API 3.0: `https://api.openweathermap.org/data/3.0/onecall` (includes minutely, hourly, daily, alerts)
55
+ - Air Pollution: `https://api.openweathermap.org/data/2.5/air_pollution`
56
+ - Auth: `?appid={API_KEY}` query parameter
57
+
50
58
  ## Authentication
51
59
 
52
60
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,24 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025)
51
+
52
+ ### New API Capabilities (Jun 2025)
53
+ - **Update documents with images** via API
54
+ - **Create templates from URLs** (no manual upload)
55
+ - **SMS consent tracking** via API
56
+ - **Editing session tokens** without adding users
57
+ - **Programmatic API key creation** for workspace setup automation
58
+
59
+ ### Document Settings Changes (v7.14.0)
60
+ - `expires_in` property added to `GET/PATCH /documents/{id}/settings` responses
61
+ - `qualified_electronic_signature` removed from template settings
62
+
63
+ ### Integrations (Jun 2025)
64
+ - PandaDoc CPQ for Pipedrive (two-way sync)
65
+ - QuickBooks Online integration (estimates + invoices)
66
+ - Recurring payments via Stripe from documents
67
+
50
68
  ## Authentication
51
69
 
52
70
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,11 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Quo business quoting and invoicing API. Check https://quo.app/docs for latest API reference.
53
+ Auth: API key via Authorization header.
54
+
50
55
  ## Authentication
51
56
 
52
57
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,26 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API & Pricing (2026)
51
+
52
+ ### Rate Limits
53
+ - **Authenticated (OAuth)**: 60 requests/minute (10-minute rolling window, per OAuth client)
54
+ - **Unauthenticated**: 10 requests/minute (IP-based)
55
+ - Response headers: `X-Ratelimit-Used`, `X-Ratelimit-Remaining`, `X-Ratelimit-Reset`
56
+
57
+ ### Pricing Tiers (2023+, still in effect 2026)
58
+ | Tier | Rate | Cost |
59
+ |------|------|------|
60
+ | Free | 100 req/min | Free (non-commercial only) |
61
+ | Premium | 100-1000 req/min | From $12,000/year |
62
+ | Enterprise | Custom | Custom (>1000 req/min) |
63
+
64
+ Note: Free tier is 60 req/min for OAuth apps, ~100 req/min for elevated access.
65
+
66
+ ### Auth
67
+ OAuth 2.0 (client_credentials for scripts, authorization_code for user apps).
68
+ Required User-Agent format: `platform:app_name:version (by /u/username)`
69
+
50
70
  ## Authentication
51
71
 
52
72
  OAuth authentication. Credentials can be set via:
@@ -47,6 +47,22 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025-2026)
51
+
52
+ ### New Endpoints
53
+ - **`POST /edit`** — Write-back document editing. Fill PDF forms and modify DOCX files using natural language instructions. Supports vision-based field detection for PDFs without native form fields.
54
+ - **Pipeline IDs** — Run Studio pipelines from code using stable pipeline identifiers. Tracks latest deployed config.
55
+
56
+ ### Edit Endpoint (2026)
57
+ Input: `document_url`, `edit_instructions`, `edit_options` (provider preference: OpenAI/Anthropic/Google, highlight color, overflow behavior), optional `form_schema`.
58
+ Output: `document_url` + metadata of changes applied.
59
+
60
+ ### Enterprise Features
61
+ - HIPAA/SOC 2 compliance
62
+ - On-prem/air-gapped deployment
63
+ - Zero data retention option
64
+ - BAA support for healthcare
65
+
50
66
  ## Authentication
51
67
 
52
68
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,27 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025-2026)
51
+
52
+ ### New Endpoints
53
+ - **`GET /emails`** (Oct 2025) — List sent emails with cursor-based pagination (`before`, `after`, `limit` params; max 100 per page)
54
+ - **Email suppression status** (Jan 2026) — New `suppressed` delivery status in email responses when Resend prevents delivery due to bounce/complaint history
55
+
56
+ ### Email Suppression (Jan 2026)
57
+ New `last_event: "suppressed"` status in email objects. New `email.suppressed` webhook event. Webhooks include suppression type (`OnAccountSuppressionList`) and message.
58
+
59
+ ### Endpoints Overview
60
+ | Method | Path | Description |
61
+ |--------|------|-------------|
62
+ | POST | `/emails` | Send email |
63
+ | GET | `/emails/{id}` | Get email |
64
+ | GET | `/emails` | **New** List sent emails |
65
+ | GET/POST/DELETE | `/domains` | Domain management |
66
+ | GET/POST/DELETE | `/api-keys` | API key management |
67
+ | GET/POST/DELETE | `/audiences` | Contact lists |
68
+ | GET/POST/DELETE | `/contacts` | Contacts in audience |
69
+ | GET/POST/DELETE | `/broadcasts` | Email broadcasts |
70
+
50
71
  ## Authentication
51
72
 
52
73
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,23 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025-2026)
51
+
52
+ ### Open Banking API Breaking Changes (Mar 23, 2026)
53
+ 1. **OpenID issuer URL** changes from `https://oba.revolut.com` to `https://oba-auth.revolut.com`. Both will be accepted temporarily — update promptly.
54
+ 2. **AccountSubType for Credit Cards**: Changes from `Loan` → `CreditCard`
55
+ 3. **DCR scope parameter**: Unified to space-separated string (e.g., `"openid accounts payments"`) across all DCR endpoints. Was inconsistently array vs string.
56
+
57
+ ### New Endpoints (2025)
58
+ - Merchant API: **Disputes endpoints** (Jun 2025) — retrieve, list, and now act on disputes directly
59
+ - Merchant API: **Apple Pay unregistration endpoint** (Jun 2025)
60
+ - **Pay by Bank** (May 2025) — new payment method for direct bank account payments
61
+
62
+ ### Auth Changes (Mar-Apr 2025)
63
+ - FAPI 1.0 Advanced: API endpoint subdomain changed from `oba.revolut.com` to `oba-auth.revolut.com`
64
+ - OAuth refresh token expiry updated (Apr 7, 2025)
65
+ - Public API specs now available on GitHub (Jul 2025)
66
+
50
67
  ## Authentication
51
68
 
52
69
  Bearer Token authentication. Credentials can be set via:
@@ -47,6 +47,12 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Sedo Domain Marketplace API: `https://api.sedo.com/api/v2/`
53
+ Key endpoints: domain search, listings, pricing, transfers, parking statistics.
54
+ Auth: API key + partner ID.
55
+
50
56
  ## Authentication
51
57
 
52
58
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,17 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Design (2025+)
51
+
52
+ Sentry overhauled API guidelines (Apr 2025). Key design principles now enforced:
53
+ - All endpoints designed as public API
54
+ - `PATCH` not used — `PUT` for updates
55
+ - Noun-based nesting in responses (`{project: {...}}` not flat)
56
+ - Identifiers accept both human-readable and numeric forms
57
+ - Common names used (`organization` not `organization_id`)
58
+
59
+ New endpoint (Jul 2025): `POST /api/0/repositories/{repo}/token/regen/` — Regenerate repository upload token.
60
+
50
61
  ## Authentication
51
62
 
52
63
  Bearer Token authentication. Credentials can be set via:
@@ -47,6 +47,48 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## CLI v4 (Mar 2026) — Major Update
51
+
52
+ shadcn CLI v4 released March 2026. Key new features:
53
+
54
+ ### New Inspection Flags
55
+ ```bash
56
+ npx shadcn@latest add button --dry-run # preview without writing
57
+ npx shadcn@latest add button --diff # show diff vs local changes
58
+ npx shadcn@latest add button --view # inspect registry payload
59
+ ```
60
+
61
+ ### Presets — Design System Codes
62
+ Pack entire design system (colors, theme, icons, fonts, radius) into a short code:
63
+ ```bash
64
+ npx shadcn@latest init --preset a1Dg5eFl # scaffold with preset
65
+ ```
66
+
67
+ ### shadcn/skills — Agent Context
68
+ Gives AI coding agents context for working with components:
69
+ ```bash
70
+ npx skills add shadcn/ui
71
+ ```
72
+
73
+ ### New shadcn info command
74
+ ```bash
75
+ npx shadcn@latest info # framework, version, installed components, docs links
76
+ ```
77
+
78
+ ### shadcn docs command
79
+ ```bash
80
+ npx shadcn@latest docs combobox # get docs, code, examples for any component
81
+ ```
82
+
83
+ ### shadcn init Templates (--template, --monorepo, --base)
84
+ ```bash
85
+ npx shadcn@latest init -t next --monorepo # next.js monorepo
86
+ npx shadcn@latest init --base radix # choose Radix or Base UI primitives
87
+ ```
88
+
89
+ ### registry:base and registry:font
90
+ Registries can now distribute entire design systems and fonts as first-class types.
91
+
50
92
  ## Authentication
51
93
 
52
94
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,24 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Migration (2025-2026) — IMPORTANT
51
+
52
+ ### REST API is Legacy
53
+ Shopify marked REST Admin API as **legacy as of October 1, 2024**.
54
+
55
+ - **New public apps**: Must use GraphQL Admin API exclusively (since April 1, 2025)
56
+ - **Custom apps**: Can still use REST but won't receive new features; can't increase product variants past 100
57
+ - REST API for products/variants: Must migrate to GraphQL if supporting >100 variants
58
+ - Current API version: **`2026-01`**
59
+
60
+ ### GraphQL Admin API
61
+ All new development should use GraphQL:
62
+ - Endpoint: `POST https://{shop}.myshopify.com/admin/api/2026-01/graphql.json`
63
+ - Auth header: `X-Shopify-Access-Token: {access_token}`
64
+
65
+ ### Check Deprecated Calls
66
+ Use `GET /admin/api/2026-01/deprecated_api_calls.json` to audit deprecated API usage in your custom app (last 30 days).
67
+
50
68
  ## Authentication
51
69
 
52
70
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,12 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Snapchat Marketing API (Ads API): `https://adsapi.snapchat.com/v1/`
53
+ Auth: OAuth 2.0 (client credentials flow for server-to-server)
54
+ Key resources: campaigns, ad_squads, ads, creatives, audiences, pixel, stats.
55
+
50
56
  ## Authentication
51
57
 
52
58
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,19 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Models (2025-2026)
51
+
52
+ | Model | Endpoint | Description |
53
+ |-------|----------|-------------|
54
+ | `sd3.5-large` | `/v2beta/stable-image/generate/sd3` | Highest quality |
55
+ | `sd3.5-large-turbo` | `/v2beta/stable-image/generate/sd3` | Fast SD 3.5 |
56
+ | `sd3.5-medium` | `/v2beta/stable-image/generate/sd3` | Balanced, MMDiT-X arch |
57
+ | `stable-image-ultra` | `/v2beta/stable-image/generate/ultra` | Ultra quality |
58
+ | `stable-image-core` | `/v2beta/stable-image/generate/core` | Fast and affordable |
59
+
60
+ SD 3.5 Medium: Keep prompts under 256 T5 tokens. Use Skip Layer Guidance for better anatomy.
61
+ License: Community License free for <$1M annual revenue; Enterprise required above.
62
+
50
63
  ## Authentication
51
64
 
52
65
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,25 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Version (2026)
51
+
52
+ Current version: **`2026-02-25.clover`**
53
+
54
+ Stripe uses versioned releases. The current major release is **Clover** (2026). Set `Stripe-Version` header to pin a version:
55
+ ```typescript
56
+ 'Stripe-Version': '2026-02-25.clover'
57
+ ```
58
+
59
+ Notable Clover changes:
60
+ - `adjustable_quantity` returned in LineItem objects (Checkout Sessions, Payment Links, Quotes)
61
+ - Amount-off coupons with `duration=forever` re-enabled (was deprecated in Basil 2025-03-31)
62
+
63
+ ### Stripe Agent Toolkit (2025+)
64
+ Stripe now has an official Agent Toolkit and MCP Server for AI integrations. See [docs.stripe.com/agent-toolkit](https://docs.stripe.com/agent-toolkit).
65
+
66
+ ### Workbench
67
+ Use [Stripe Workbench](https://dashboard.stripe.com/workbench) to manage your API version and test API changes in-browser. Replaces the old API Explorer.
68
+
50
69
  ## Authentication
51
70
 
52
71
  Bearer Token authentication. Credentials can be set via: