@hasna/connectors 0.2.5 → 0.2.7

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/dist/lib/test-endpoints.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Test endpoint definitions for verifying API credentials.
+ * Each entry maps a connector name to its health-check endpoint.
+ */
+export interface TestEndpoint {
+    url: string;
+    method?: string;
+    headers: (key: string) => Record<string, string>;
+    /** Expected successful status codes */
+    successCodes?: number[];
+}
+export declare const TEST_ENDPOINTS: Record<string, TestEndpoint>;

package/package.json

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