@hasna/connectors 0.2.6 → 0.2.7

package/connectors/connect-reddit/CLAUDE.md

@@ -47,6 +47,26 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API & Pricing (2026)
+
+### Rate Limits
+- **Authenticated (OAuth)**: 60 requests/minute (10-minute rolling window, per OAuth client)
+- **Unauthenticated**: 10 requests/minute (IP-based)
+- Response headers: `X-Ratelimit-Used`, `X-Ratelimit-Remaining`, `X-Ratelimit-Reset`
+
+### Pricing Tiers (2023+, still in effect 2026)
+| Tier | Rate | Cost |
+|------|------|------|
+| Free | 100 req/min | Free (non-commercial only) |
+| Premium | 100-1000 req/min | From $12,000/year |
+| Enterprise | Custom | Custom (>1000 req/min) |
+
+Note: Free tier is 60 req/min for OAuth apps, ~100 req/min for elevated access.
+
+### Auth
+OAuth 2.0 (client_credentials for scripts, authorization_code for user apps).
+Required User-Agent format: `platform:app_name:version (by /u/username)`
+
 ## Authentication
 
 OAuth authentication. Credentials can be set via:

package/connectors/connect-reducto/CLAUDE.md

@@ -47,6 +47,22 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Updates (2025-2026)
+
+### New Endpoints
+- **`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.
+- **Pipeline IDs** — Run Studio pipelines from code using stable pipeline identifiers. Tracks latest deployed config.
+
+### Edit Endpoint (2026)
+Input: `document_url`, `edit_instructions`, `edit_options` (provider preference: OpenAI/Anthropic/Google, highlight color, overflow behavior), optional `form_schema`.
+Output: `document_url` + metadata of changes applied.
+
+### Enterprise Features
+- HIPAA/SOC 2 compliance
+- On-prem/air-gapped deployment
+- Zero data retention option
+- BAA support for healthcare
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-resend/CLAUDE.md

@@ -47,6 +47,27 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Updates (2025-2026)
+
+### New Endpoints
+- **`GET /emails`** (Oct 2025) — List sent emails with cursor-based pagination (`before`, `after`, `limit` params; max 100 per page)
+- **Email suppression status** (Jan 2026) — New `suppressed` delivery status in email responses when Resend prevents delivery due to bounce/complaint history
+
+### Email Suppression (Jan 2026)
+New `last_event: "suppressed"` status in email objects. New `email.suppressed` webhook event. Webhooks include suppression type (`OnAccountSuppressionList`) and message.
+
+### Endpoints Overview
+| Method | Path | Description |
+|--------|------|-------------|
+| POST | `/emails` | Send email |
+| GET | `/emails/{id}` | Get email |
+| GET | `/emails` | **New** List sent emails |
+| GET/POST/DELETE | `/domains` | Domain management |
+| GET/POST/DELETE | `/api-keys` | API key management |
+| GET/POST/DELETE | `/audiences` | Contact lists |
+| GET/POST/DELETE | `/contacts` | Contacts in audience |
+| GET/POST/DELETE | `/broadcasts` | Email broadcasts |
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-revolut/CLAUDE.md

@@ -47,6 +47,23 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Updates (2025-2026)
+
+### Open Banking API Breaking Changes (Mar 23, 2026)
+1. **OpenID issuer URL** changes from `https://oba.revolut.com` to `https://oba-auth.revolut.com`. Both will be accepted temporarily — update promptly.
+2. **AccountSubType for Credit Cards**: Changes from `Loan` → `CreditCard`
+3. **DCR scope parameter**: Unified to space-separated string (e.g., `"openid accounts payments"`) across all DCR endpoints. Was inconsistently array vs string.
+
+### New Endpoints (2025)
+- Merchant API: **Disputes endpoints** (Jun 2025) — retrieve, list, and now act on disputes directly
+- Merchant API: **Apple Pay unregistration endpoint** (Jun 2025)
+- **Pay by Bank** (May 2025) — new payment method for direct bank account payments
+
+### Auth Changes (Mar-Apr 2025)
+- FAPI 1.0 Advanced: API endpoint subdomain changed from `oba.revolut.com` to `oba-auth.revolut.com`
+- OAuth refresh token expiry updated (Apr 7, 2025)
+- Public API specs now available on GitHub (Jul 2025)
+
 ## Authentication
 
 Bearer Token authentication. Credentials can be set via:

package/connectors/connect-sedo/CLAUDE.md

@@ -47,6 +47,12 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Notes (2026)
+
+Sedo Domain Marketplace API: `https://api.sedo.com/api/v2/`
+Key endpoints: domain search, listings, pricing, transfers, parking statistics.
+Auth: API key + partner ID.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-sentry/CLAUDE.md

@@ -47,6 +47,17 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Design (2025+)
+
+Sentry overhauled API guidelines (Apr 2025). Key design principles now enforced:
+- All endpoints designed as public API
+- `PATCH` not used — `PUT` for updates
+- Noun-based nesting in responses (`{project: {...}}` not flat)
+- Identifiers accept both human-readable and numeric forms
+- Common names used (`organization` not `organization_id`)
+
+New endpoint (Jul 2025): `POST /api/0/repositories/{repo}/token/regen/` — Regenerate repository upload token.
+
 ## Authentication
 
 Bearer Token authentication. Credentials can be set via:

package/connectors/connect-shadcn/CLAUDE.md

@@ -47,6 +47,48 @@ src/
 └── index.ts       # Library exports
 ```
 
+## CLI v4 (Mar 2026) — Major Update
+
+shadcn CLI v4 released March 2026. Key new features:
+
+### New Inspection Flags
+```bash
+npx shadcn@latest add button --dry-run   # preview without writing
+npx shadcn@latest add button --diff      # show diff vs local changes
+npx shadcn@latest add button --view      # inspect registry payload
+```
+
+### Presets — Design System Codes
+Pack entire design system (colors, theme, icons, fonts, radius) into a short code:
+```bash
+npx shadcn@latest init --preset a1Dg5eFl   # scaffold with preset
+```
+
+### shadcn/skills — Agent Context
+Gives AI coding agents context for working with components:
+```bash
+npx skills add shadcn/ui
+```
+
+### New shadcn info command
+```bash
+npx shadcn@latest info   # framework, version, installed components, docs links
+```
+
+### shadcn docs command
+```bash
+npx shadcn@latest docs combobox   # get docs, code, examples for any component
+```
+
+### shadcn init Templates (--template, --monorepo, --base)
+```bash
+npx shadcn@latest init -t next --monorepo   # next.js monorepo
+npx shadcn@latest init --base radix          # choose Radix or Base UI primitives
+```
+
+### registry:base and registry:font
+Registries can now distribute entire design systems and fonts as first-class types.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-shopify/CLAUDE.md

@@ -47,6 +47,24 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Migration (2025-2026) — IMPORTANT
+
+### REST API is Legacy
+Shopify marked REST Admin API as **legacy as of October 1, 2024**.
+
+- **New public apps**: Must use GraphQL Admin API exclusively (since April 1, 2025)
+- **Custom apps**: Can still use REST but won't receive new features; can't increase product variants past 100
+- REST API for products/variants: Must migrate to GraphQL if supporting >100 variants
+- Current API version: **`2026-01`**
+
+### GraphQL Admin API
+All new development should use GraphQL:
+- Endpoint: `POST https://{shop}.myshopify.com/admin/api/2026-01/graphql.json`
+- Auth header: `X-Shopify-Access-Token: {access_token}`
+
+### Check Deprecated Calls
+Use `GET /admin/api/2026-01/deprecated_api_calls.json` to audit deprecated API usage in your custom app (last 30 days).
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-snap/CLAUDE.md

@@ -47,6 +47,12 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Notes (2026)
+
+Snapchat Marketing API (Ads API): `https://adsapi.snapchat.com/v1/`
+Auth: OAuth 2.0 (client credentials flow for server-to-server)
+Key resources: campaigns, ad_squads, ads, creatives, audiences, pixel, stats.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-stabilityai/CLAUDE.md

@@ -47,6 +47,19 @@ src/
 └── index.ts       # Library exports
 ```
 
+## Models (2025-2026)
+
+| Model | Endpoint | Description |
+|-------|----------|-------------|
+| `sd3.5-large` | `/v2beta/stable-image/generate/sd3` | Highest quality |
+| `sd3.5-large-turbo` | `/v2beta/stable-image/generate/sd3` | Fast SD 3.5 |
+| `sd3.5-medium` | `/v2beta/stable-image/generate/sd3` | Balanced, MMDiT-X arch |
+| `stable-image-ultra` | `/v2beta/stable-image/generate/ultra` | Ultra quality |
+| `stable-image-core` | `/v2beta/stable-image/generate/core` | Fast and affordable |
+
+SD 3.5 Medium: Keep prompts under 256 T5 tokens. Use Skip Layer Guidance for better anatomy.
+License: Community License free for <$1M annual revenue; Enterprise required above.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-stripe/CLAUDE.md

@@ -47,6 +47,25 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Version (2026)
+
+Current version: **`2026-02-25.clover`**
+
+Stripe uses versioned releases. The current major release is **Clover** (2026). Set `Stripe-Version` header to pin a version:
+```typescript
+'Stripe-Version': '2026-02-25.clover'
+```
+
+Notable Clover changes:
+- `adjustable_quantity` returned in LineItem objects (Checkout Sessions, Payment Links, Quotes)
+- Amount-off coupons with `duration=forever` re-enabled (was deprecated in Basil 2025-03-31)
+
+### Stripe Agent Toolkit (2025+)
+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).
+
+### Workbench
+Use [Stripe Workbench](https://dashboard.stripe.com/workbench) to manage your API version and test API changes in-browser. Replaces the old API Explorer.
+
 ## Authentication
 
 Bearer Token authentication. Credentials can be set via:

package/connectors/connect-stripeatlas/CLAUDE.md

@@ -47,6 +47,13 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Notes (2026)
+
+Stripe Atlas uses the standard Stripe API (same auth, same versioning as connect-stripe).
+Current API version: `2026-02-25.clover`
+Atlas-specific resources: company formation, bank account setup via Stripe API.
+See connect-stripe for full Stripe API update notes.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-substack/CLAUDE.md

@@ -47,6 +47,12 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Notes (2026)
+
+Substack does not have a fully public REST API. Available endpoints are unofficial/undocumented.
+Common patterns: `https://{publication}.substack.com/api/v1/` for posts, subscribers, etc.
+Auth: Cookie-based session or `substack-api-key` header for some endpoints.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-tiktok/CLAUDE.md

@@ -47,6 +47,31 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Products (2026)
+
+| API | Function | Auth |
+|-----|----------|------|
+| Login Kit | User sign-in with TikTok | OAuth 2.0 |
+| Display API | Read-only public content/profile | OAuth 2.0 |
+| Content Publishing API | Upload/publish videos | OAuth 2.0 (video.upload, video.publish scopes) |
+| Research API | Anonymized academic data | Separate research access approval |
+
+### Content Publishing API (2026)
+- Direct Post: video goes live immediately
+- Upload to Inbox: queued as draft for creator review
+- Max video size: 10GB
+- Avg upload time: ~60s for 1080p
+- OAuth access token TTL: 24 hours; refresh token TTL: 365 days
+- Required scopes: `video.upload`, `video.publish`, `user.info.basic`
+
+### OAuth 2.0 PKCE Flow
+```
+Authorization URL → exchange code → access_token + refresh_token
+```
+
+### Rate Limits
+TikTok enforces per-app rate limits. Monitor `X-Ratelimit-*` response headers.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-tinker/CLAUDE.md

@@ -47,6 +47,12 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Notes (2026)
+
+Tinker LLM fine-tuning and training API. Check https://tinker.ai/docs for latest API reference.
+Key operations: upload training data, create fine-tuning jobs, deploy models.
+Auth: Bearer token.
+
 ## Authentication
 
 Bearer Token authentication. Credentials can be set via:

package/connectors/connect-twilio/CLAUDE.md

@@ -47,6 +47,15 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Notes (2026)
+
+Base URL: `https://api.twilio.com/2010-04-01/`
+Auth: HTTP Basic Auth with Account SID + Auth Token (or API Key SID + Secret)
+
+Key services: SMS, Voice, Messaging (WhatsApp, RCS), Verify (OTP), Video, Email (via SendGrid)
+
+Current stable API version: `2010-04-01` (unchanged — Twilio uses stable versioned URLs)
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-uspto/CLAUDE.md

@@ -47,6 +47,14 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Notes (2026)
+
+USPTO (US Patent and Trademark Office) open data APIs — mostly free/no auth required.
+- Patent Center API: `https://patentcenter.uspto.gov/retrieval/public/v1/`
+- Patent Search API (PatentsView): `https://search.patentsview.org/api/v1/`
+- Trademark API: `https://tsdrapi.uspto.gov/ts/cd/casestatus/`
+Auth: Optional API key for higher rate limits.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-webflow/CLAUDE.md

@@ -47,6 +47,25 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Updates (2025-2026)
+
+### CMS Improvements
+- **Live CMS item management**: Endpoints for managing items live on site vs staged
+- **CMS item filtering and sorting**: Server-side filtering/sorting
+- **Bulk CMS authoring**: Bulk create/update/delete CMS items via Data API v2
+- **Localization support**: Multi-locale content management
+
+### Breaking Changes (Dec 2024 / Jul 2025)
+- **Dec 2024**: Breaking changes in JavaScript SDK — check changelog
+- **Jul 2025**: CMS item publishing updated — how items publish, draft, and remove from live sites
+- **Internal API deprecation (late 2026)**: Internal DOM sync endpoints (`/sites/{name}/dom`, `/pages/{id}/dom`) require version numbers in write requests since Sep 15, 2025. Will be removed late 2026.
+
+### New Features
+- **301 Redirects API**: Manage redirects programmatically
+- **Comments API**: Manage design comments via API
+- **Workspace Audit Logs**: Audit log endpoints
+- **Official MCP Server**: Webflow MCP server now supports the Designer (for AI agents)
+
 ## Authentication
 
 OAuth authentication. Credentials can be set via:

package/connectors/connect-wix/CLAUDE.md

@@ -47,6 +47,26 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Updates (2025-2026)
+
+### New APIs (Feb-Mar 2026)
+- **Disputes APIs** (Mar 2026) — manage payment disputes: Dispute History Records, Dispute Evidence Documents, Disputes API
+- **Site Authentication API** (Mar 2026) — manage site member authentication
+- **Wix AI APIs** (Feb 2026) — interact with multiple AI providers via Wix (handles auth + billing). REST + SDK.
+- **Intake Form Submissions API** (Feb 2026)
+- **Dashboard SDK update** (Mar 2026) — action required: update `@wix/dashboard-react >= 1.0.27` and `@wix/dashboard >= 1.3.43`
+
+### Headless CMS Updates (Feb 2026)
+- New article: Upload images to CMS collections requiring elevation
+- Multilingual support guide for headless projects
+- Wix-Managed Headless: `403` error handling guide
+
+### CLI Updates (Mar 2026)
+- New commands: `wix translation push` and `wix translation pull`
+
+### Deprecated (Aug 2026)
+Bookings Pricing API: `pricePerParticipant`, `numberOfParticipants`, `choices` fields deprecated — use `serviceChoices` object instead.
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-x/CLAUDE.md

@@ -47,6 +47,21 @@ src/
 └── index.ts       # Library exports
 ```
 
+## Pricing & Access (2026)
+
+### Pay-as-you-go Model (Feb 2026)
+X moved to **credit-based pay-as-you-go pricing** (Feb 6, 2026), replacing fixed $200/month Basic and $5,000/month Pro plans.
+
+- Purchase credits in advance; balance decreases per API call
+- Unit price varies by endpoint (check Developer Console for current prices)
+- Duplicate protection: same post/user fetched multiple times on same day is not double-charged (with exceptions)
+- Auto-recharge and spending limits available
+- **Public Utility apps** continue to receive free scaled access
+- Legacy free tier users receive a $10 one-time voucher when migrating
+- Existing Basic/Pro subscribers can opt-in to pay-as-you-go or keep their plan
+
+Pricing reference: https://docs.x.com/x-api/getting-started/pricing
+
 ## Authentication
 
 OAuth authentication. Credentials can be set via:

package/connectors/connect-xads/CLAUDE.md

@@ -47,6 +47,16 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Notes (2026)
+
+X Ads API (Twitter Ads API) — separate from X API v2.
+Base URL: `https://ads-api.x.com/12/` (version 12 as of 2026)
+Auth: OAuth 1.0a (consumer key/secret + user token/secret)
+
+Key resources: campaigns, line_items, creatives, targeting_criteria, stats/analytics.
+
+Note: X Ads API pricing/access is separate from X API v2 pay-as-you-go model. Contact X for Ads API access.
+
 ## Authentication
 
 OAuth authentication. Credentials can be set via:

package/connectors/connect-xai/CLAUDE.md

@@ -47,6 +47,21 @@ src/
 └── index.ts       # Library exports
 ```
 
+## Models (2026)
+
+| Model | Description |
+|-------|-------------|
+| `grok-4-0709` | Current flagship, 131K context — **recommended default** |
+| `grok-4` / `grok-4-fast` | Grok 4 variants |
+| `grok-4-1-fast-reasoning` | Grok 4.1 with reasoning |
+| `grok-4-1-fast-non-reasoning` | Grok 4.1 fast, no reasoning |
+| `grok-3` / `grok-3-mini` | Grok 3 series |
+| `grok-2-vision` | Vision tasks |
+| `grok-2-image` | Image generation |
+
+Base URL: `https://api.x.ai/v1` (OpenAI-compatible)
+Default: `grok-4-0709`
+
 ## Authentication
 
 Bearer Token authentication. Credentials can be set via:

package/connectors/connect-xai/src/types/index.ts

@@ -14,19 +14,35 @@ export interface XAIConfig {
 // ============================================
 
 export type XAIModel =
+  // Grok 4 series (2025-2026, latest)
+  | 'grok-4-0709'       // current flagship
+  | 'grok-4'
+  | 'grok-4-fast'
+  // Grok 4.1 (reasoning variants)
+  | 'grok-4-1-fast-reasoning'
+  | 'grok-4-1-fast-non-reasoning'
+  // Grok 3 series
   | 'grok-3'
   | 'grok-3-fast'
-  | 'grok-2'
-  | 'grok-2-vision';
+  | 'grok-3-mini'
+  // Grok 2 (legacy)
+  | 'grok-2-vision'
+  | 'grok-2-image';
 
 export const XAI_MODELS: XAIModel[] = [
+  'grok-4-0709',
+  'grok-4',
+  'grok-4-fast',
+  'grok-4-1-fast-reasoning',
+  'grok-4-1-fast-non-reasoning',
   'grok-3',
   'grok-3-fast',
-  'grok-2',
+  'grok-3-mini',
   'grok-2-vision',
+  'grok-2-image',
 ];
 
-export const DEFAULT_CHAT_MODEL: XAIModel = 'grok-2';
+export const DEFAULT_CHAT_MODEL: XAIModel = 'grok-4-0709';
 
 // ============================================
 // Chat Completions

package/connectors/connect-youtube/CLAUDE.md

@@ -47,6 +47,34 @@ src/
 └── index.ts       # Library exports
 ```
 
+## API Updates (2024-2025)
+
+### Quota Changes (Dec 2025)
+Video upload quota cost reduced: **~~1,600 units~~ → ~100 units**. This massively reduces the cost of uploading videos against the 10,000 unit/day default quota.
+
+### mostPopular Chart Change (Jul 2025)
+`video.list` `mostPopular` chart now features videos from Trending Music, Movies, and Gaming charts (was Trending page, which is deprecated).
+
+### Shorts View Count (Mar 2025)
+Views now count when a Short starts playing or replaying — no minimum watch time required.
+
+### New `status.containsSyntheticMedia` (Oct 2024)
+Set this property on `videos.insert`/`videos.update` to flag AI-generated or altered content (required per YouTube policy).
+
+### Quota Overview
+| Operation | Cost (units) |
+|-----------|-------------|
+| Default daily quota | 10,000 |
+| Video upload | ~100 (was ~1,600) |
+| Search list | 100 |
+| Videos list | 1 |
+| Channels list | 1 |
+
+### Three API Components
+- **Data API v3** — metadata, playlists, channels, upload, search
+- **Analytics API** — engagement metrics, demographics
+- **Reporting API** — bulk historical data downloads
+
 ## Authentication
 
 API Key authentication. Credentials can be set via:

package/connectors/connect-zoom/CLAUDE.md

@@ -47,6 +47,21 @@ src/
 └── index.ts       # Library exports
 ```
 
+## Auth & API Updates (2025-2026)
+
+### Server-to-Server OAuth (recommended)
+Use Server-to-Server OAuth for headless/automated integrations. Replaces deprecated JWT auth.
+- Create app in Zoom Marketplace → Server-to-Server OAuth
+- Exchange credentials for access token: `POST https://zoom.us/oauth/token?grant_type=account_credentials&account_id={id}`
+- Token expires in 1 hour — refresh as needed
+
+### Recent API Updates (Jan 2026)
+- **Summaries endpoints**: New fields added to meeting/webinar summary endpoints
+- **Meetings and Webinars webhooks**: New webhook payload fields
+
+### Meeting SDK Auth Update
+Meeting SDK authorization has been updated. See Zoom Developer docs for latest OBF (Obfuscated Function) migration requirements.
+
 ## Authentication
 
 OAuth authentication. Credentials can be set via:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {