@pindownai/client-js 0.0.1 → 0.2.0

package/LICENSE

@@ -20,3 +20,4 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
+

package/README.md

@@ -1,215 +1,215 @@
-# @pindownai/client-js
-
-Official TypeScript/JavaScript client for the [Pindown.ai](https://pindown.ai) API.
-
-## Features
-
-- ✅ **Full TypeScript support** with IntelliSense
-- ✅ **All 36 API endpoints** (Pins, Pinboards, Datasets, Blocks, Collaborators)
-- ✅ **Built-in client-side rate limiting** with automatic token tracking
-- ✅ **Organized by API** - Clean folder structure (pins/, pinboards/, datasets/, etc.)
-- ✅ **Works everywhere** - Node.js, browsers, edge runtimes
-- ✅ **Dual format** - ESM and CommonJS support
-- ✅ **Zero dependencies** - Only uses native fetch API
-
-## Installation
-
-```bash
-npm install @pindownai/client-js
-```
-
-## Quick Start
-
-```typescript
-import { PindownClient } from '@pindownai/client-js'
-
-const client = new PindownClient({
-  apiKey: 'pk_live_...'
-  // Tier is auto-detected from server!
-})
-
-// Create a pin
-const pin = await client.pins.createMarkdown('# Hello World')
-
-// Check your tier
-console.log(`Your tier: ${client.getTier()}`)
-
-// Check rate limits
-const info = client.getRateLimitInfo()
-if (info) {
-  console.log(`Used: ${info.minute.used}/${info.minute.limit} tokens`)
-}
-```
-
-## API Reference
-
-### Pins API (`client.pins`)
-
-```typescript
-// Create pins
-await client.pins.create({ data_type: 'markdown', content: '# Hello' })
-await client.pins.createMarkdown('# Hello')
-await client.pins.createStatCard({ title: 'Users', value: 1250 })
-await client.pins.createTable({ columns: [...], rows: [...] })
-await client.pins.createEmbed('https://youtube.com/watch?v=...')
-
-// CRUD operations
-await client.pins.get(pinId)
-await client.pins.list({ limit: 10, offset: 0 })
-await client.pins.update(pinId, { content: '# Updated' })
-await client.pins.delete(pinId)
-await client.pins.share(pinId, { is_public: true })
-```
-
-### Pinboards API (`client.pinboards`)
-
-```typescript
-// Create & manage pinboards
-await client.pinboards.create({ title: 'Dashboard' })
-await client.pinboards.get(boardId)
-await client.pinboards.list()
-await client.pinboards.update(boardId, { title: 'New Title' })
-await client.pinboards.delete(boardId)
-
-// Manage pins in pinboard
-await client.pinboards.addPin(boardId, { pin_id: pinId })
-await client.pinboards.removePin(boardId, pinId)
-await client.pinboards.updateLayout(boardId, { layout: {...} })
-await client.pinboards.share(boardId, { is_public: true })
-```
-
-### Datasets API (`client.datasets`)
-
-```typescript
-await client.datasets.create({ name: 'Sales', type: 'json', data: {...} })
-await client.datasets.get(datasetId)
-await client.datasets.list()
-await client.datasets.update(datasetId, { data: {...} })
-await client.datasets.delete(datasetId)
-```
-
-### Blocks API (`client.blocks`)
-
-```typescript
-await client.blocks.create(pinId, { name: 'Header', type: 'markdown', template: '# Title' })
-await client.blocks.get(pinId, blockId)
-await client.blocks.list(pinId)
-await client.blocks.update(pinId, blockId, { template: '# Updated' })
-await client.blocks.delete(pinId, blockId)
-```
-
-### Collaborators API (`client.collaborators`)
-
-```typescript
-// Pin collaborators
-await client.collaborators.listForPin(pinId)
-await client.collaborators.inviteToPin(pinId, { email: '...', role: 'editor' })
-await client.collaborators.updatePinRole(pinId, userId, { role: 'viewer' })
-await client.collaborators.removeFromPin(pinId, userId)
-await client.collaborators.getPinPermissions(pinId)
-
-// Pinboard collaborators
-await client.collaborators.listForPinboard(boardId)
-await client.collaborators.inviteToPinboard(boardId, { email: '...', role: 'editor' })
-await client.collaborators.updatePinboardRole(boardId, userId, { role: 'viewer' })
-await client.collaborators.removeFromPinboard(boardId, userId)
-await client.collaborators.getPinboardPermissions(boardId)
-```
-
-## Rate Limiting
-
-Your tier is **automatically detected** from the API server via the `X-RateLimit-Tier` header. The client tracks rate limits client-side and throws a `RateLimitError` **before** making requests that would exceed your tier's limits.
-
-```typescript
-// First request auto-detects your tier
-await client.pins.list()
-
-// Now you can check your tier
-console.log(`Your tier: ${client.getTier()}`) // e.g., "hobby"
-
-// Check current usage
-const info = client.getRateLimitInfo()
-if (info) {
-  console.log(`Minute: ${info.minute.used}/${info.minute.limit}`)
-  console.log(`Hour: ${info.hour.used}/${info.hour.limit}`)
-}
-
-// Client blocks requests that would exceed limits
-try {
-  await client.pins.create({...})
-} catch (error) {
-  if (error instanceof RateLimitError) {
-    console.log(`Rate limit exceeded: ${error.used}/${error.limit}`)
-    console.log(`Reset at: ${error.resetAt}`)
-  }
-}
-```
-
-### Tier Limits
-
-| Tier | Tokens/Minute | Tokens/Hour |
-|------|---------------|-------------|
-| Starter | - | 16 |
-| Hobby | 100 | 6,000 |
-| Pro | 400 | 24,000 |
-| Teams | 1,000 | 60,000 |
-| Agency | 4,000 | 240,000 |
-
-**Token Costs:**
-- Standard requests (GET, POST, PUT, DELETE): **1 token**
-- Invite/Share requests: **3 tokens** (email costs)
-- Batch operations: **3-10 tokens** (based on size)
-
-## Error Handling
-
-```typescript
-import {
-  AuthenticationError,
-  ForbiddenError,
-  NotFoundError,
-  ValidationError,
-  RateLimitError,
-  ServerError,
-  NetworkError
-} from '@pindown/api-client'
-
-try {
-  await client.pins.create({...})
-} catch (error) {
-  if (error instanceof RateLimitError) {
-    // Handle rate limit
-  } else if (error instanceof AuthenticationError) {
-    // Invalid API key
-  } else if (error instanceof ValidationError) {
-    // Invalid request data
-  }
-}
-```
-
-## Configuration
-
-```typescript
-const client = new PindownClient({
-  apiKey: 'pk_live_...',           // Required
-  tier: 'hobby',                   // Optional - auto-detected from server
-  baseURL: 'https://api.pindown.ai/api/v1', // Optional
-  enableRateLimitTracking: true,   // Optional (default: true)
-  maxRetries: 3,                   // Optional (default: 3)
-  timeout: 30000                   // Optional (default: 30s)
-})
-```
-
-**Note:** The `tier` parameter is optional and only for testing. In production, your tier is automatically detected from the server based on your API key.
-
-## Documentation
-
-Full API documentation: [docs.pindown.ai](https://docs.pindown.ai)
-
-## Support
-
-- Discord: [discord.gg/pindown](https://discord.gg/bDuUNBq5eS)
-- Documentation: [docs.pindown.ai](https://docs.pindown.ai)
-
-## License
-
-MIT
+# @pindownai/client-js
+
+Official TypeScript/JavaScript client for the [Pindown.ai](https://pindown.ai) API.
+
+## Features
+
+- ✅ **Full TypeScript support** with IntelliSense
+- ✅ **All 36 API endpoints** (Pins, Pinboards, Datasets, Blocks, Collaborators)
+- ✅ **Built-in client-side rate limiting** with automatic token tracking
+- ✅ **Organized by API** - Clean folder structure (pins/, pinboards/, datasets/, etc.)
+- ✅ **Works everywhere** - Node.js, browsers, edge runtimes
+- ✅ **Dual format** - ESM and CommonJS support
+- ✅ **Zero dependencies** - Only uses native fetch API
+
+## Installation
+
+```bash
+npm install @pindownai/client-js
+```
+
+## Quick Start
+
+```typescript
+import { PindownClient } from '@pindownai/client-js'
+
+const client = new PindownClient({
+  apiKey: 'pk_live_...'
+  // Tier is auto-detected from server!
+})
+
+// Create a pin
+const pin = await client.pins.createMarkdown('# Hello World')
+
+// Check your tier
+console.log(`Your tier: ${client.getTier()}`)
+
+// Check rate limits
+const info = client.getRateLimitInfo()
+if (info) {
+  console.log(`Used: ${info.minute.used}/${info.minute.limit} tokens`)
+}
+```
+
+## API Reference
+
+### Pins API (`client.pins`)
+
+```typescript
+// Create pins
+await client.pins.create({ data_type: 'markdown', content: '# Hello' })
+await client.pins.createMarkdown('# Hello')
+await client.pins.createStatCard({ title: 'Users', value: 1250 })
+await client.pins.createTable({ columns: [...], rows: [...] })
+await client.pins.createEmbed('https://youtube.com/watch?v=...')
+
+// CRUD operations
+await client.pins.get(pinId)
+await client.pins.list({ limit: 10, offset: 0 })
+await client.pins.update(pinId, { content: '# Updated' })
+await client.pins.delete(pinId)
+await client.pins.share(pinId, { is_public: true })
+```
+
+### Pinboards API (`client.pinboards`)
+
+```typescript
+// Create & manage pinboards
+await client.pinboards.create({ title: 'Dashboard' })
+await client.pinboards.get(boardId)
+await client.pinboards.list()
+await client.pinboards.update(boardId, { title: 'New Title' })
+await client.pinboards.delete(boardId)
+
+// Manage pins in pinboard
+await client.pinboards.addPin(boardId, { pin_id: pinId })
+await client.pinboards.removePin(boardId, pinId)
+await client.pinboards.updateLayout(boardId, { layout: {...} })
+await client.pinboards.share(boardId, { is_public: true })
+```
+
+### Datasets API (`client.datasets`)
+
+```typescript
+await client.datasets.create({ name: 'Sales', type: 'json', data: {...} })
+await client.datasets.get(datasetId)
+await client.datasets.list()
+await client.datasets.update(datasetId, { data: {...} })
+await client.datasets.delete(datasetId)
+```
+
+### Blocks API (`client.blocks`)
+
+```typescript
+await client.blocks.create(pinId, { name: 'Header', type: 'markdown', template: '# Title' })
+await client.blocks.get(pinId, blockId)
+await client.blocks.list(pinId)
+await client.blocks.update(pinId, blockId, { template: '# Updated' })
+await client.blocks.delete(pinId, blockId)
+```
+
+### Collaborators API (`client.collaborators`)
+
+```typescript
+// Pin collaborators
+await client.collaborators.listForPin(pinId)
+await client.collaborators.inviteToPin(pinId, { email: '...', role: 'editor' })
+await client.collaborators.updatePinRole(pinId, userId, { role: 'viewer' })
+await client.collaborators.removeFromPin(pinId, userId)
+await client.collaborators.getPinPermissions(pinId)
+
+// Pinboard collaborators
+await client.collaborators.listForPinboard(boardId)
+await client.collaborators.inviteToPinboard(boardId, { email: '...', role: 'editor' })
+await client.collaborators.updatePinboardRole(boardId, userId, { role: 'viewer' })
+await client.collaborators.removeFromPinboard(boardId, userId)
+await client.collaborators.getPinboardPermissions(boardId)
+```
+
+## Rate Limiting
+
+Your tier is **automatically detected** from the API server via the `X-RateLimit-Tier` header. The client tracks rate limits client-side and throws a `RateLimitError` **before** making requests that would exceed your tier's limits.
+
+```typescript
+// First request auto-detects your tier
+await client.pins.list()
+
+// Now you can check your tier
+console.log(`Your tier: ${client.getTier()}`) // e.g., "hobby"
+
+// Check current usage
+const info = client.getRateLimitInfo()
+if (info) {
+  console.log(`Minute: ${info.minute.used}/${info.minute.limit}`)
+  console.log(`Hour: ${info.hour.used}/${info.hour.limit}`)
+}
+
+// Client blocks requests that would exceed limits
+try {
+  await client.pins.create({...})
+} catch (error) {
+  if (error instanceof RateLimitError) {
+    console.log(`Rate limit exceeded: ${error.used}/${error.limit}`)
+    console.log(`Reset at: ${error.resetAt}`)
+  }
+}
+```
+
+### Tier Limits
+
+| Tier | Tokens/Minute | Tokens/Hour |
+|------|---------------|-------------|
+| Starter | - | 16 |
+| Hobby | 100 | 6,000 |
+| Pro | 400 | 24,000 |
+| Teams | 1,000 | 60,000 |
+| Agency | 4,000 | 240,000 |
+
+**Token Costs:**
+- Standard requests (GET, POST, PUT, DELETE): **1 token**
+- Invite/Share requests: **3 tokens** (email costs)
+- Batch operations: **3-10 tokens** (based on size)
+
+## Error Handling
+
+```typescript
+import {
+  AuthenticationError,
+  ForbiddenError,
+  NotFoundError,
+  ValidationError,
+  RateLimitError,
+  ServerError,
+  NetworkError
+} from '@pindown/api-client'
+
+try {
+  await client.pins.create({...})
+} catch (error) {
+  if (error instanceof RateLimitError) {
+    // Handle rate limit
+  } else if (error instanceof AuthenticationError) {
+    // Invalid API key
+  } else if (error instanceof ValidationError) {
+    // Invalid request data
+  }
+}
+```
+
+## Configuration
+
+```typescript
+const client = new PindownClient({
+  apiKey: 'pk_live_...',           // Required
+  tier: 'hobby',                   // Optional - auto-detected from server
+  baseURL: 'https://api.pindown.ai/v1', // Optional
+  enableRateLimitTracking: true,   // Optional (default: true)
+  maxRetries: 3,                   // Optional (default: 3)
+  timeout: 30000                   // Optional (default: 30s)
+})
+```
+
+**Note:** The `tier` parameter is optional and only for testing. In production, your tier is automatically detected from the server based on your API key.
+
+## Documentation
+
+Full API documentation: [docs.pindown.ai](https://docs.pindown.ai)
+
+## Support
+
+- Discord: [discord.gg/pindown](https://discord.gg/bDuUNBq5eS)
+- Documentation: [docs.pindown.ai](https://docs.pindown.ai)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -1,4 +1,4 @@
-'use strict';var C={starter:{tokensPerHour:16,tokensPerMinute:null},hobby:{tokensPerHour:6e3,tokensPerMinute:100},pro:{tokensPerHour:24e3,tokensPerMinute:400},teams:{tokensPerHour:6e4,tokensPerMinute:1e3},agency:{tokensPerHour:24e4,tokensPerMinute:4e3}};var E={GET:1,POST:1,PUT:1,DELETE:1,INVITE:3,SHARE:3,BATCH_1_10:3,BATCH_11_25:5,BATCH_26_50:10};var o=class extends Error{constructor(e){super(e),this.name="PindownError";}},d=class extends o{constructor(e="Authentication failed"){super(e),this.name="AuthenticationError";}},p=class extends o{constructor(e="Access forbidden"){super(e),this.name="ForbiddenError";}},m=class extends o{constructor(e){super(`${e} not found`),this.name="NotFoundError";}},c=class extends o{constructor(e,t){super(e),this.name="ValidationError",this.details=t;}},P=class extends o{constructor(e){super(`Rate limit exceeded: ${e.used}/${e.limit} tokens used in ${e.window} window. Resets at ${e.resetAt.toISOString()}`),this.name="RateLimitError",this.window=e.window,this.limit=e.limit,this.used=e.used,this.remaining=e.remaining,this.resetAt=e.resetAt,this.tier=e.tier;}},l=class extends o{constructor(e,t=500){super(e),this.name="ServerError",this.statusCode=t;}},h=class extends o{constructor(e="Network request failed"){super(e),this.name="NetworkError";}};var $=C,g=E,b=class{constructor(e){this.minuteTokens=new Map;this.hourTokens=new Map;this.tier=e,this.cleanupInterval=setInterval(()=>this.cleanup(),300*1e3);}checkLimit(e,t,r){let n=this.calculateTokenCost(e,t,r),a=this.getMinuteWindow(),u=this.getHourWindow(),i=$[this.tier];if(i.tokensPerMinute!==null){let k=this.minuteTokens.get(a)||0;if(k+n>i.tokensPerMinute)throw new P({window:"minute",limit:i.tokensPerMinute,used:k,remaining:Math.max(0,i.tokensPerMinute-k),resetAt:this.getMinuteResetTime(),tier:this.tier})}let y=this.hourTokens.get(u)||0;if(y+n>i.tokensPerHour)throw new P({window:"hour",limit:i.tokensPerHour,used:y,remaining:Math.max(0,i.tokensPerHour-y),resetAt:this.getHourResetTime(),tier:this.tier});this.incrementToken(a,n),this.incrementToken(u,n);}calculateTokenCost(e,t,r){if(t.includes("/batch")||t.includes("/sync")){if(r?.operations){let n=Array.isArray(r.operations)?r.operations.length:0;return n<=10?g.BATCH_1_10:n<=25?g.BATCH_11_25:(g.BATCH_26_50)}if(r?.pins){let n=Array.isArray(r.pins)?r.pins.length:0;return n<=16?5:(8)}}return t.includes("/collaborators")||t.includes("/invite")||t.includes("/share")?g.INVITE:g[e]||1}getMinuteWindow(){let e=new Date;return `minute_${e.getFullYear()}-${String(e.getMonth()+1).padStart(2,"0")}-${String(e.getDate()).padStart(2,"0")}-${String(e.getHours()).padStart(2,"0")}-${String(e.getMinutes()).padStart(2,"0")}`}getHourWindow(){let e=new Date;return `hour_${e.getFullYear()}-${String(e.getMonth()+1).padStart(2,"0")}-${String(e.getDate()).padStart(2,"0")}-${String(e.getHours()).padStart(2,"0")}`}incrementToken(e,t){if(e.startsWith("minute")){let r=this.minuteTokens.get(e)||0;this.minuteTokens.set(e,r+t);}else {let r=this.hourTokens.get(e)||0;this.hourTokens.set(e,r+t);}}getMinuteResetTime(){let e=new Date;return new Date(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes()+1,0,0)}getHourResetTime(){let e=new Date;return new Date(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours()+1,0,0,0)}getRateLimitInfo(){let e=$[this.tier],t=this.getMinuteWindow(),r=this.getHourWindow(),n=this.minuteTokens.get(t)||0,a=this.hourTokens.get(r)||0;return {tier:this.tier,minute:{limit:e.tokensPerMinute||0,used:n,remaining:e.tokensPerMinute?Math.max(0,e.tokensPerMinute-n):1/0,resetAt:this.getMinuteResetTime()},hour:{limit:e.tokensPerHour,used:a,remaining:Math.max(0,e.tokensPerHour-a),resetAt:this.getHourResetTime()}}}cleanup(){let t=Date.now()-7200*1e3;for(let[r]of this.minuteTokens)this.parseWindowTimestamp(r)<t&&this.minuteTokens.delete(r);for(let[r]of this.hourTokens)this.parseWindowTimestamp(r)<t&&this.hourTokens.delete(r);}parseWindowTimestamp(e){let t=e.split("_")[1].split("-"),r=parseInt(t[0]),n=parseInt(t[1])-1,a=parseInt(t[2]),u=parseInt(t[3]),i=e.startsWith("minute")?parseInt(t[4]):0;return new Date(r,n,a,u,i).getTime()}destroy(){this.cleanupInterval&&clearInterval(this.cleanupInterval);}};var T=class{constructor(e){this.client=e;}async create(e){return this.client.request("POST","/pins",e)}async get(e){return this.client.request("GET",`/pins/${e}`)}async list(e){let t=new URLSearchParams;e?.limit&&t.append("limit",e.limit.toString()),e?.offset&&t.append("offset",e.offset.toString());let r=t.toString(),n=r?`/pins?${r}`:"/pins";return this.client.request("GET",n)}async update(e,t){return this.client.request("PUT",`/pins/${e}`,t)}async delete(e){return this.client.request("DELETE",`/pins/${e}`)}async share(e,t){return this.client.request("POST",`/pins/${e}/share`,t)}async createMarkdown(e,t){return this.create({data_type:"markdown",content:e,metadata:t})}async createStatCard(e,t){return this.create({data_type:"pin-card",pin_card_type:"stat-cards",content:[e],metadata:t})}async createTable(e,t){return this.create({data_type:"pin-card",pin_card_type:"flexible-table",content:e,metadata:t})}async createEmbed(e,t){return this.create({data_type:"pin-card",pin_card_type:"embed",content:{url:e},metadata:t})}};var w=class{constructor(e){this.client=e;}async create(e){return this.client.request("POST","/pinboards",e)}async get(e){return this.client.request("GET",`/pinboards/${e}`)}async list(){return this.client.request("GET","/pinboards")}async update(e,t){return this.client.request("PUT",`/pinboards/${e}`,t)}async delete(e){return this.client.request("DELETE",`/pinboards/${e}`)}async addPin(e,t){return this.client.request("POST",`/pinboards/${e}/pins`,t)}async removePin(e,t){return this.client.request("DELETE",`/pinboards/${e}/pins/${t}`)}async updateLayout(e,t){return this.client.request("PUT",`/pinboards/${e}/layout`,t)}async share(e,t){return this.client.request("POST",`/pinboards/${e}/share`,t)}};var f=class{constructor(e){this.client=e;}async create(e){return this.client.request("POST","/datasets",e)}async get(e){return this.client.request("GET",`/datasets/${e}`)}async list(){return this.client.request("GET","/datasets")}async update(e,t){return this.client.request("PUT",`/datasets/${e}`,t)}async delete(e){return this.client.request("DELETE",`/datasets/${e}`)}};var R=class{constructor(e){this.client=e;}async create(e,t){return this.client.request("POST",`/pins/${e}/blocks`,t)}async get(e,t){return this.client.request("GET",`/pins/${e}/blocks/${t}`)}async list(e){return this.client.request("GET",`/pins/${e}/blocks`)}async update(e,t,r){return this.client.request("PUT",`/pins/${e}/blocks/${t}`,r)}async delete(e,t){return this.client.request("DELETE",`/pins/${e}/blocks/${t}`)}};var q=class{constructor(e){this.client=e;}async listForPin(e){return this.client.request("GET",`/pins/${e}/collaborators`)}async inviteToPin(e,t){return this.client.request("POST",`/pins/${e}/collaborators`,t)}async updatePinRole(e,t,r){return this.client.request("PUT",`/pins/${e}/collaborators/${t}`,r)}async removeFromPin(e,t){return this.client.request("DELETE",`/pins/${e}/collaborators/${t}`)}async getPinPermissions(e){return this.client.request("GET",`/pins/${e}/permissions`)}async listForPinboard(e){return this.client.request("GET",`/pinboards/${e}/collaborators`)}async inviteToPinboard(e,t){return this.client.request("POST",`/pinboards/${e}/collaborators`,t)}async updatePinboardRole(e,t,r){return this.client.request("PUT",`/pinboards/${e}/collaborators/${t}`,r)}async removeFromPinboard(e,t){return this.client.request("DELETE",`/pinboards/${e}/collaborators/${t}`)}async getPinboardPermissions(e){return this.client.request("GET",`/pinboards/${e}/permissions`)}};var v=class{constructor(e){this.tierDetected=false;if(!e.apiKey)throw new Error("API key is required");this.config={apiKey:e.apiKey,tier:e.tier,baseURL:e.baseURL||"https://api.pindown.ai/api/v1",enableRateLimitTracking:e.enableRateLimitTracking??true,maxRetries:e.maxRetries??3,timeout:e.timeout??3e4},this.config.tier&&(this.rateLimiter=new b(this.config.tier),this.tierDetected=true),this.pins=new T(this),this.pinboards=new w(this),this.datasets=new f(this),this.blocks=new R(this),this.collaborators=new q(this);}async request(e,t,r){this.config.enableRateLimitTracking&&this.rateLimiter&&this.rateLimiter.checkLimit(e,t,r);let n=`${this.config.baseURL}${t}`,a={Authorization:`Bearer ${this.config.apiKey}`,"Content-Type":"application/json"},u={method:e,headers:a,signal:AbortSignal.timeout(this.config.timeout)};r&&(e==="POST"||e==="PUT")&&(u.body=JSON.stringify(r));try{let i=await fetch(n,u);return !this.tierDetected&&this.config.enableRateLimitTracking&&this.detectTierFromHeaders(i.headers),i.ok||await this.handleErrorResponse(i),(await i.json()).data}catch(i){throw i instanceof d||i instanceof p||i instanceof m||i instanceof c||i instanceof l?i:i.name==="AbortError"||i.name==="TimeoutError"?new h("Request timeout"):new h(i.message||"Network request failed")}}async handleErrorResponse(e){let t;try{t=await e.json();}catch{t={message:e.statusText};}let r=t.error?.message||t.message||"Unknown error";switch(e.status){case 401:throw new d(r);case 403:throw new p(r);case 404:throw new m(r);case 400:case 422:throw new c(r,t.error?.details);case 429:throw new c("Rate limit exceeded (server)",t);case 500:case 502:case 503:throw new l(r,e.status);default:throw new l(r,e.status)}}detectTierFromHeaders(e){let t=e.get("X-RateLimit-Tier");if(t&&!this.rateLimiter){let r=t.toLowerCase();console.log(`[Pindown Client] Auto-detected tier: ${r}`),this.config.tier=r,this.rateLimiter=new b(r),this.tierDetected=true;}}getRateLimitInfo(){return this.rateLimiter?this.rateLimiter.getRateLimitInfo():null}getTier(){return this.config.tier||null}destroy(){this.rateLimiter&&this.rateLimiter.destroy();}};/**
+'use strict';var C={starter:{tokensPerHour:16,tokensPerMinute:null},hobby:{tokensPerHour:6e3,tokensPerMinute:100},pro:{tokensPerHour:24e3,tokensPerMinute:400},teams:{tokensPerHour:6e4,tokensPerMinute:1e3},agency:{tokensPerHour:24e4,tokensPerMinute:4e3}};var E={GET:1,POST:1,PUT:1,DELETE:1,INVITE:3,SHARE:3,BATCH_1_10:3,BATCH_11_25:5,BATCH_26_50:10};var o=class extends Error{constructor(t){super(t),this.name="PindownError";}},d=class extends o{constructor(t="Authentication failed"){super(t),this.name="AuthenticationError";}},p=class extends o{constructor(t="Access forbidden"){super(t),this.name="ForbiddenError";}},m=class extends o{constructor(t){super(`${t} not found`),this.name="NotFoundError";}},c=class extends o{constructor(t,e){super(t),this.name="ValidationError",this.details=e;}},P=class extends o{constructor(t){super(`Rate limit exceeded: ${t.used}/${t.limit} tokens used in ${t.window} window. Resets at ${t.resetAt.toISOString()}`),this.name="RateLimitError",this.window=t.window,this.limit=t.limit,this.used=t.used,this.remaining=t.remaining,this.resetAt=t.resetAt,this.tier=t.tier;}},l=class extends o{constructor(t,e=500){super(t),this.name="ServerError",this.statusCode=e;}},h=class extends o{constructor(t="Network request failed"){super(t),this.name="NetworkError";}};var $=C,g=E,b=class{constructor(t){this.minuteTokens=new Map;this.hourTokens=new Map;this.tier=t,this.cleanupInterval=setInterval(()=>this.cleanup(),300*1e3);}checkLimit(t,e,r){let n=this.calculateTokenCost(t,e,r),a=this.getMinuteWindow(),u=this.getHourWindow(),i=$[this.tier];if(i.tokensPerMinute!==null){let k=this.minuteTokens.get(a)||0;if(k+n>i.tokensPerMinute)throw new P({window:"minute",limit:i.tokensPerMinute,used:k,remaining:Math.max(0,i.tokensPerMinute-k),resetAt:this.getMinuteResetTime(),tier:this.tier})}let y=this.hourTokens.get(u)||0;if(y+n>i.tokensPerHour)throw new P({window:"hour",limit:i.tokensPerHour,used:y,remaining:Math.max(0,i.tokensPerHour-y),resetAt:this.getHourResetTime(),tier:this.tier});this.incrementToken(a,n),this.incrementToken(u,n);}calculateTokenCost(t,e,r){if(e.includes("/batch")||e.includes("/sync")){if(r?.operations){let n=Array.isArray(r.operations)?r.operations.length:0;return n<=10?g.BATCH_1_10:n<=25?g.BATCH_11_25:(g.BATCH_26_50)}if(r?.pins){let n=Array.isArray(r.pins)?r.pins.length:0;return n<=16?5:(8)}}return e.includes("/collaborators")||e.includes("/invite")||e.includes("/share")?g.INVITE:g[t]||1}getMinuteWindow(){let t=new Date;return `minute_${t.getFullYear()}-${String(t.getMonth()+1).padStart(2,"0")}-${String(t.getDate()).padStart(2,"0")}-${String(t.getHours()).padStart(2,"0")}-${String(t.getMinutes()).padStart(2,"0")}`}getHourWindow(){let t=new Date;return `hour_${t.getFullYear()}-${String(t.getMonth()+1).padStart(2,"0")}-${String(t.getDate()).padStart(2,"0")}-${String(t.getHours()).padStart(2,"0")}`}incrementToken(t,e){if(t.startsWith("minute")){let r=this.minuteTokens.get(t)||0;this.minuteTokens.set(t,r+e);}else {let r=this.hourTokens.get(t)||0;this.hourTokens.set(t,r+e);}}getMinuteResetTime(){let t=new Date;return new Date(t.getFullYear(),t.getMonth(),t.getDate(),t.getHours(),t.getMinutes()+1,0,0)}getHourResetTime(){let t=new Date;return new Date(t.getFullYear(),t.getMonth(),t.getDate(),t.getHours()+1,0,0,0)}getRateLimitInfo(){let t=$[this.tier],e=this.getMinuteWindow(),r=this.getHourWindow(),n=this.minuteTokens.get(e)||0,a=this.hourTokens.get(r)||0;return {tier:this.tier,minute:{limit:t.tokensPerMinute||0,used:n,remaining:t.tokensPerMinute?Math.max(0,t.tokensPerMinute-n):1/0,resetAt:this.getMinuteResetTime()},hour:{limit:t.tokensPerHour,used:a,remaining:Math.max(0,t.tokensPerHour-a),resetAt:this.getHourResetTime()}}}cleanup(){let e=Date.now()-7200*1e3;for(let[r]of this.minuteTokens)this.parseWindowTimestamp(r)<e&&this.minuteTokens.delete(r);for(let[r]of this.hourTokens)this.parseWindowTimestamp(r)<e&&this.hourTokens.delete(r);}parseWindowTimestamp(t){let e=t.split("_")[1].split("-"),r=parseInt(e[0]),n=parseInt(e[1])-1,a=parseInt(e[2]),u=parseInt(e[3]),i=t.startsWith("minute")?parseInt(e[4]):0;return new Date(r,n,a,u,i).getTime()}destroy(){this.cleanupInterval&&clearInterval(this.cleanupInterval);}};var T=class{constructor(t){this.client=t;}async create(t){return this.client.request("POST","/pins",t)}async get(t){return this.client.request("GET",`/pins/${t}`)}async list(t){let e=new URLSearchParams;t?.limit&&e.append("limit",t.limit.toString()),t?.offset&&e.append("offset",t.offset.toString());let r=e.toString(),n=r?`/pins?${r}`:"/pins";return this.client.request("GET",n)}async update(t,e){return this.client.request("PUT",`/pins/${t}`,e)}async delete(t){return this.client.request("DELETE",`/pins/${t}`)}async share(t,e){return this.client.request("POST",`/pins/${t}/share`,e)}async createMarkdown(t,e){return this.create({data_type:"markdown",metadata:{title:t,...e}})}async createStatCard(t,e,r){return this.create({data_type:"pin-card",metadata:{title:e,pin_card_type:"stat-cards",pin_card_config:[t],...r}})}async createTable(t,e,r){return this.create({data_type:"pin-card",metadata:{title:e,pin_card_type:"flexible-table",pin_card_config:t,...r}})}async createEmbed(t,e,r){return this.create({data_type:"pin-card",metadata:{title:e,pin_card_type:"embed",pin_card_config:{url:t},...r}})}};var f=class{constructor(t){this.client=t;}async create(t){return this.client.request("POST","/pinboards",t)}async get(t){return this.client.request("GET",`/pinboards/${t}`)}async list(){return this.client.request("GET","/pinboards")}async update(t,e){return this.client.request("PUT",`/pinboards/${t}`,e)}async delete(t){return this.client.request("DELETE",`/pinboards/${t}`)}async addPin(t,e){return this.client.request("POST",`/pinboards/${t}/pins`,e)}async removePin(t,e){return this.client.request("DELETE",`/pinboards/${t}/pins/${e}`)}async updateLayout(t,e){return this.client.request("PUT",`/pinboards/${t}/layout`,e)}async share(t,e){return this.client.request("POST",`/pinboards/${t}/share`,e)}};var w=class{constructor(t){this.client=t;}async create(t){return this.client.request("POST","/datasets",t)}async get(t){return this.client.request("GET",`/datasets/${t}`)}async list(){return this.client.request("GET","/datasets")}async update(t,e){return this.client.request("PUT",`/datasets/${t}`,e)}async delete(t){return this.client.request("DELETE",`/datasets/${t}`)}};var R=class{constructor(t){this.client=t;}async create(t,e){return this.client.request("POST",`/pins/${t}/blocks`,e)}async get(t,e){return this.client.request("GET",`/pins/${t}/blocks/${e}`)}async list(t){return this.client.request("GET",`/pins/${t}/blocks`)}async update(t,e,r){return this.client.request("PUT",`/pins/${t}/blocks/${e}`,r)}async delete(t,e){return this.client.request("DELETE",`/pins/${t}/blocks/${e}`)}};var q=class{constructor(t){this.client=t;}async listForPin(t){return this.client.request("GET",`/pins/${t}/collaborators`)}async inviteToPin(t,e){return this.client.request("POST",`/pins/${t}/collaborators`,e)}async updatePinRole(t,e,r){return this.client.request("PUT",`/pins/${t}/collaborators/${e}`,r)}async removeFromPin(t,e){return this.client.request("DELETE",`/pins/${t}/collaborators/${e}`)}async getPinPermissions(t){return this.client.request("GET",`/pins/${t}/permissions`)}async listForPinboard(t){return this.client.request("GET",`/pinboards/${t}/collaborators`)}async inviteToPinboard(t,e){return this.client.request("POST",`/pinboards/${t}/collaborators`,e)}async updatePinboardRole(t,e,r){return this.client.request("PUT",`/pinboards/${t}/collaborators/${e}`,r)}async removeFromPinboard(t,e){return this.client.request("DELETE",`/pinboards/${t}/collaborators/${e}`)}async getPinboardPermissions(t){return this.client.request("GET",`/pinboards/${t}/permissions`)}};var v=class{constructor(t){this.tierDetected=false;if(!t.apiKey)throw new Error("API key is required");this.config={apiKey:t.apiKey,tier:t.tier,baseURL:t.baseURL||"https://api.pindown.ai/v1",enableRateLimitTracking:t.enableRateLimitTracking??true,maxRetries:t.maxRetries??3,timeout:t.timeout??3e4},this.config.tier&&(this.rateLimiter=new b(this.config.tier),this.tierDetected=true),this.pins=new T(this),this.pinboards=new f(this),this.datasets=new w(this),this.blocks=new R(this),this.collaborators=new q(this);}async request(t,e,r){this.config.enableRateLimitTracking&&this.rateLimiter&&this.rateLimiter.checkLimit(t,e,r);let n=`${this.config.baseURL}${e}`,a={Authorization:`Bearer ${this.config.apiKey}`,"Content-Type":"application/json"},u={method:t,headers:a,signal:AbortSignal.timeout(this.config.timeout)};r&&(t==="POST"||t==="PUT")&&(u.body=JSON.stringify(r));try{let i=await fetch(n,u);return !this.tierDetected&&this.config.enableRateLimitTracking&&this.detectTierFromHeaders(i.headers),i.ok||await this.handleErrorResponse(i),(await i.json()).data}catch(i){throw i instanceof d||i instanceof p||i instanceof m||i instanceof c||i instanceof l?i:i.name==="AbortError"||i.name==="TimeoutError"?new h("Request timeout"):new h(i.message||"Network request failed")}}async handleErrorResponse(t){let e;try{e=await t.json();}catch{e={message:t.statusText};}let r=e.error?.message||e.message||"Unknown error";switch(t.status){case 401:throw new d(r);case 403:throw new p(r);case 404:throw new m(r);case 400:case 422:throw new c(r,e.error?.details);case 429:throw new c("Rate limit exceeded (server)",e);case 500:case 502:case 503:throw new l(r,t.status);default:throw new l(r,t.status)}}detectTierFromHeaders(t){let e=t.get("X-RateLimit-Tier");if(e&&!this.rateLimiter){let r=e.toLowerCase();console.log(`[Pindown Client] Auto-detected tier: ${r}`),this.config.tier=r,this.rateLimiter=new b(r),this.tierDetected=true;}}getRateLimitInfo(){return this.rateLimiter?this.rateLimiter.getRateLimitInfo():null}getTier(){return this.config.tier||null}destroy(){this.rateLimiter&&this.rateLimiter.destroy();}};/**
  * @pindownai/client-js
  * 
  * Official TypeScript/JavaScript client for Pindown.ai API