@thisux/dunsocial-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) DunSocial / THISUX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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

@@ -0,0 +1,168 @@
+# @thisux/dunsocial-sdk
+
+TypeScript client for the DunSocial REST API. Schedule and publish posts, upload media, search brand memory, and verify webhook signatures.
+
+```ts
+import { DunSocial } from '@thisux/dunsocial-sdk';
+
+const dun = new DunSocial({
+  token: process.env.DUN_TOKEN,
+  workspaceId: process.env.DUN_WORKSPACE_ID
+});
+
+await dun.posts.schedule({
+  content: 'Shipping the TypeScript SDK.',
+  socialAccountIds: ['acc_x'],
+  scheduledAt: new Date(Date.now() + 60 * 60 * 1000)
+});
+```
+
+Requires Node 20+, Bun, or Cloudflare Workers. The package uses `fetch` and Web Crypto only.
+
+## Install
+
+```bash
+npm install @thisux/dunsocial-sdk
+# bun add @thisux/dunsocial-sdk
+# pnpm add @thisux/dunsocial-sdk
+```
+
+Create a personal access token in the app under **Settings → CLI**. Format: `dun_pat_…`.
+
+```bash
+export DUN_TOKEN=dun_pat_…
+export DUN_WORKSPACE_ID=your_workspace_id
+```
+
+Constructor options override env. Names match the CLI: `DUN_TOKEN`, `DUN_WORKSPACE_ID`, `DUN_API_URL`.
+
+## Auth
+
+Every request sends `Authorization: Bearer <token>` and `User-Agent: dunsocial-sdk/<version>`. Workspace-scoped methods also send `X-Workspace-Id`.
+
+| Method | Scope |
+|--------|--------|
+| `workspaces.list` / `get` | `workspace:read` |
+| `accounts.list` | `workspace:read` |
+| `personalization.get` | `workspace:read` |
+| `personalization.set` / `clear` | `workspace:write` |
+| `posts.list` / `get` / `validate` | `posts:read` |
+| `drafts.list` / `get` | `posts:read` |
+| `posts.schedule` / `reschedule` / `cancel` / threads | `posts:schedule` |
+| `posts.publish` / `publishThread` | `posts:publish` |
+| `posts.delete` | `posts:delete` |
+| `drafts.create` / `update` / `delete` | `drafts:write` |
+| `media.list` / `get` | `media:read` |
+| `media.upload` / `delete` | `media:write` |
+| `memory` GET (collections / list) | `memory:read` |
+| `memory.search` / save / collection writes | `memory:write` |
+
+`workspaces.list` works without a workspace id. A PAT bound to one workspace still lists that workspace.
+
+## Posts
+
+```ts
+const [post] = await dun.posts.publish({
+  content: 'Live now.',
+  socialAccountIds: ['acc_x'],
+  mediaIds: ['media_1']
+});
+
+const published = await dun.posts.wait(post.id);
+```
+
+`publish` queues the row (`status: scheduled`). `wait(id)` polls until `published`, `failed`, or `cancelled`.
+
+`validate` is HTTP 200 even when the post is invalid:
+
+```ts
+const result = await dun.posts.validate({
+  content: 'Hello Reddit',
+  socialAccountIds: ['acc_reddit'],
+  metadata: { reddit: { subreddit: 'startups', title: 'Hello', kind: 'self' } }
+});
+// result.valid === false → result.issues[]
+```
+
+Pass `throwOnInvalid: true` if you want a `DunSocialError` instead.
+
+`mediaIds` in the SDK map to API `mediaUrls`. `scheduledAt` accepts a `Date` or ISO string.
+
+## Media
+
+```ts
+const asset = await dun.media.upload({
+  file: new Uint8Array(await Bun.file('cover.png').arrayBuffer()),
+  filename: 'cover.png',
+  mimeType: 'image/png'
+});
+```
+
+`upload()` hides the three-step flow: request a signed URL, PUT the bytes, complete the gallery row. Images max 8MB; video max 512MB.
+
+## Webhooks
+
+```ts
+import { DunSocial } from '@thisux/dunsocial-sdk';
+
+export async function POST(request: Request) {
+  const rawBody = await request.text();
+  const event = await DunSocial.webhooks.constructEvent(
+    rawBody,
+    {
+      signature: request.headers.get('X-DunSocial-Signature') ?? '',
+      timestamp: request.headers.get('X-DunSocial-Timestamp') ?? ''
+    },
+    process.env.DUN_WEBHOOK_SECRET!
+  );
+  // event.type: post.published | post.publish_failed | …
+}
+```
+
+HMAC-SHA256 of `{timestamp}.{rawBody}`. Use the raw body; the default replay window is 300 seconds.
+
+## Errors
+
+```ts
+import { DunSocial, DunSocialError } from '@thisux/dunsocial-sdk';
+
+try {
+  await dun.posts.schedule({ /* … */ });
+} catch (err) {
+  if (err instanceof DunSocialError && err.code === 'subscription_required') {
+    console.log(err.billingUrl);
+  }
+}
+```
+
+| Code | HTTP | Retry? |
+|------|------|--------|
+| `missing_config` | — | no |
+| `unauthorized` | 401 | no |
+| `forbidden` | 403 | no |
+| `not_found` | 404 | no |
+| `subscription_required` | 402 | no — see `billingUrl` |
+| `rate_limited` | 429 | yes (`Retry-After`) |
+| `x_cap_exceeded` | 429 | no |
+| `timeout` / `network` | 5xx / abort | 5xx once |
+
+## CLI vs SDK vs MCP
+
+| Surface | Use when |
+|---------|----------|
+| **SDK** (`@thisux/dunsocial-sdk`) | Your app or backend talks to DunSocial in TypeScript |
+| **CLI** (`dunsocial` / `dun`) | Terminal, CI, local agents |
+| **MCP** | Claude, ChatGPT, Cursor call tools in chat |
+| **REST** | Any other language — [OpenAPI](https://api.dunsocial.com/api/openapi.json) |
+
+The SDK does not wrap the CLI. Both call the same HTTP API.
+
+## OpenAPI
+
+- File: [sdks/openapi/openapi.yaml](https://github.com/thisuxhq/dunpostsapp/blob/main/sdks/openapi/openapi.yaml)
+- Live: https://api.dunsocial.com/api/openapi.json
+- Docs: https://www.dunsocial.com/docs/sdk
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import type { DunSocialOptions, FetchLike } from './types';
+export interface ApiResponse<T = unknown> {
+    success?: boolean;
+    data?: T;
+    error?: string;
+    message?: string;
+    code?: string;
+    [key: string]: unknown;
+}
+export interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string | number | boolean | undefined | null>;
+    body?: unknown;
+    auth?: boolean;
+    workspace?: boolean;
+    headers?: Record<string, string>;
+    rawBody?: Uint8Array | ArrayBuffer | Blob;
+    contentType?: string;
+}
+export declare class HttpClient {
+    readonly baseUrl: string;
+    readonly token?: string;
+    readonly workspaceId?: string;
+    readonly fetchImpl: FetchLike;
+    readonly timeoutMs: number;
+    constructor(options: DunSocialOptions);
+    requireToken(): string;
+    requireWorkspace(): string;
+    get<T>(path: string, opts?: Omit<RequestOptions, 'method' | 'path'>): Promise<T>;
+    post<T>(path: string, body?: unknown, opts?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    patch<T>(path: string, body?: unknown, opts?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    delete<T>(path: string, body?: unknown, opts?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    putBytes(url: string, body: Uint8Array | ArrayBuffer | Blob, mimeType: string): Promise<void>;
+    request<T = unknown>(options: RequestOptions, attempt?: number): Promise<T>;
+    private shouldRetry;
+    private fetchWithTimeout;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IACrE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,UAAU;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,gBAAgB;IAWrC,YAAY,IAAI,MAAM;IAStB,gBAAgB,IAAI,MAAM;IAU1B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;IAInE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAI7F,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAI9F,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAIzF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7F,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IA8F5E,OAAO,CAAC,WAAW;YAOL,gBAAgB;CAgB9B"}

package/dist/client.js

@@ -0,0 +1,188 @@
+import { SDK_VERSION } from './version';
+import { DunSocialError, asRecord, billingUrlFrom, inferCode, isXCapError, retryAfterMsFrom } from './errors';
+export class HttpClient {
+    baseUrl;
+    token;
+    workspaceId;
+    fetchImpl;
+    timeoutMs;
+    constructor(options) {
+        this.baseUrl = (options.baseUrl ?? env('DUN_API_URL') ?? 'https://api.dunsocial.com').replace(/\/$/, '');
+        this.token = options.token ?? env('DUN_TOKEN');
+        this.workspaceId = options.workspaceId ?? env('DUN_WORKSPACE_ID');
+        this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.timeoutMs = options.timeoutMs ?? 60_000;
+    }
+    requireToken() {
+        if (!this.token) {
+            throw new DunSocialError('Missing API token. Pass token or set DUN_TOKEN.', {
+                code: 'missing_config'
+            });
+        }
+        return this.token;
+    }
+    requireWorkspace() {
+        if (!this.workspaceId) {
+            throw new DunSocialError('Missing workspace id. Pass workspaceId or set DUN_WORKSPACE_ID.', { code: 'missing_config' });
+        }
+        return this.workspaceId;
+    }
+    get(path, opts) {
+        return this.request({ ...opts, method: 'GET', path });
+    }
+    post(path, body, opts) {
+        return this.request({ ...opts, method: 'POST', path, body });
+    }
+    patch(path, body, opts) {
+        return this.request({ ...opts, method: 'PATCH', path, body });
+    }
+    delete(path, body, opts) {
+        return this.request({ ...opts, method: 'DELETE', path, body });
+    }
+    async putBytes(url, body, mimeType) {
+        const bytes = body instanceof Blob ? body : body instanceof ArrayBuffer ? new Uint8Array(body) : body;
+        const size = bytes instanceof Blob ? bytes.size : bytes.byteLength;
+        let response;
+        try {
+            response = await this.fetchWithTimeout(url, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': mimeType,
+                    'Content-Length': String(size)
+                },
+                body: bytes
+            });
+        }
+        catch (err) {
+            throw new DunSocialError(`Upload PUT failed: ${err.message}`, {
+                code: 'network',
+                details: { cause: String(err) }
+            });
+        }
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new DunSocialError(`Upload PUT failed with HTTP ${response.status}${text ? `: ${text.slice(0, 200)}` : ''}`, { status: response.status, code: 'network' });
+        }
+    }
+    async request(options, attempt = 0) {
+        const method = options.method ?? 'GET';
+        const url = new URL(options.path.startsWith('http') ? options.path : `${this.baseUrl}${options.path}`);
+        if (options.query) {
+            for (const [key, value] of Object.entries(options.query)) {
+                if (value === undefined || value === null || value === '')
+                    continue;
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const headers = {
+            Accept: 'application/json',
+            'User-Agent': `dunsocial-sdk/${SDK_VERSION}`,
+            ...(options.headers ?? {})
+        };
+        if (options.auth !== false) {
+            headers.Authorization = `Bearer ${this.requireToken()}`;
+        }
+        if (options.workspace) {
+            headers['X-Workspace-Id'] = this.requireWorkspace();
+        }
+        let body;
+        if (options.rawBody !== undefined) {
+            body = options.rawBody;
+            if (options.contentType)
+                headers['Content-Type'] = options.contentType;
+        }
+        else if (options.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            body = JSON.stringify(options.body);
+        }
+        let response;
+        try {
+            response = await this.fetchWithTimeout(url.toString(), { method, headers, body });
+        }
+        catch (err) {
+            if (err instanceof DunSocialError)
+                throw err;
+            throw new DunSocialError(`Network error: ${err.message}`, {
+                code: 'network',
+                details: { cause: String(err) }
+            });
+        }
+        const text = await response.text();
+        let parsed = null;
+        if (text) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = null;
+            }
+        }
+        if (!response.ok) {
+            const details = (parsed ?? { status: response.status, body: text.slice(0, 300) });
+            const code = inferCode(response.status, parsed);
+            const retryAfterMs = retryAfterMsFrom(response);
+            if (this.shouldRetry(response.status, parsed, attempt)) {
+                await sleep(retryAfterMs ?? (attempt === 0 ? 400 : 800));
+                return this.request(options, attempt + 1);
+            }
+            throw new DunSocialError(parsed?.error || parsed?.message || (text ? text.slice(0, 300) : `HTTP ${response.status}`), {
+                status: response.status,
+                code,
+                details,
+                billingUrl: billingUrlFrom(parsed),
+                retryAfterMs
+            });
+        }
+        if (parsed && typeof parsed === 'object' && 'success' in parsed) {
+            if (parsed.success === false) {
+                throw new DunSocialError(parsed.error || parsed.message || 'Request failed', {
+                    status: response.status,
+                    code: 'validation',
+                    details: parsed
+                });
+            }
+            return parsed.data;
+        }
+        return parsed ?? undefined;
+    }
+    shouldRetry(status, parsed, attempt) {
+        if (attempt >= 1)
+            return false;
+        if (status >= 500)
+            return true;
+        if (status !== 429)
+            return false;
+        return !isXCapError(asRecord(parsed));
+    }
+    async fetchWithTimeout(url, init) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            return await this.fetchImpl(url, { ...init, signal: controller.signal });
+        }
+        catch (err) {
+            if (err.name === 'AbortError') {
+                throw new DunSocialError(`Request timed out after ${this.timeoutMs}ms`, {
+                    code: 'timeout'
+                });
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+function env(name) {
+    try {
+        const value = globalThis.process
+            ?.env?.[name];
+        return value && value.length > 0 ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+export type DunSocialErrorCode = 'missing_config' | 'unauthorized' | 'forbidden' | 'not_found' | 'validation' | 'subscription_required' | 'rate_limited' | 'x_cap_exceeded' | 'network' | 'timeout' | 'webhook_signature' | 'webhook_timestamp' | string;
+export declare class DunSocialError extends Error {
+    readonly status: number;
+    readonly code: DunSocialErrorCode;
+    readonly details?: unknown;
+    readonly billingUrl?: string;
+    readonly retryAfterMs?: number;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: DunSocialErrorCode;
+        details?: unknown;
+        billingUrl?: string;
+        retryAfterMs?: number;
+    });
+}
+export declare function inferCode(status: number, details?: unknown): DunSocialErrorCode;
+export declare function isXCapError(body: Record<string, unknown> | null): boolean;
+export declare function asRecord(value: unknown): Record<string, unknown> | null;
+export declare function billingUrlFrom(details: unknown): string | undefined;
+export declare function retryAfterMsFrom(response: Response): number | undefined;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC3B,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,WAAW,GACX,YAAY,GACZ,uBAAuB,GACvB,cAAc,GACd,gBAAgB,GAChB,SAAS,GACT,SAAS,GACT,mBAAmB,GACnB,mBAAmB,GACnB,MAAM,CAAC;AAEV,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,kBAAkB,CAAC;QAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACjB;CAUP;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAgB/E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAKzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKvE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGnE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAQvE"}

package/dist/errors.js

@@ -0,0 +1,72 @@
+export class DunSocialError extends Error {
+    status;
+    code;
+    details;
+    billingUrl;
+    retryAfterMs;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = 'DunSocialError';
+        this.status = options.status ?? 0;
+        this.code = options.code ?? inferCode(options.status ?? 0, options.details);
+        this.details = options.details;
+        this.billingUrl = options.billingUrl;
+        this.retryAfterMs = options.retryAfterMs;
+    }
+}
+export function inferCode(status, details) {
+    const body = asRecord(details);
+    const explicit = typeof body?.code === 'string' ? body.code : undefined;
+    if (explicit === 'subscription_required')
+        return 'subscription_required';
+    if (explicit === 'x_cap_exceeded')
+        return 'x_cap_exceeded';
+    if (status === 401)
+        return 'unauthorized';
+    if (status === 402)
+        return 'subscription_required';
+    if (status === 403)
+        return 'forbidden';
+    if (status === 404)
+        return 'not_found';
+    if (status === 429) {
+        if (isXCapError(body))
+            return 'x_cap_exceeded';
+        return 'rate_limited';
+    }
+    if (status >= 400 && status < 500)
+        return 'validation';
+    if (status >= 500)
+        return 'network';
+    return explicit ?? 'network';
+}
+export function isXCapError(body) {
+    if (!body)
+        return false;
+    if (body.code === 'x_cap_exceeded')
+        return true;
+    const error = typeof body.error === 'string' ? body.error : '';
+    return /x monthly posting cap/i.test(error);
+}
+export function asRecord(value) {
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        return value;
+    }
+    return null;
+}
+export function billingUrlFrom(details) {
+    const body = asRecord(details);
+    return typeof body?.billingUrl === 'string' ? body.billingUrl : undefined;
+}
+export function retryAfterMsFrom(response) {
+    const header = response.headers.get('Retry-After');
+    if (!header)
+        return undefined;
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return Math.round(seconds * 1000);
+    const date = Date.parse(header);
+    if (!Number.isNaN(date))
+        return Math.max(0, date - Date.now());
+    return undefined;
+}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { Accounts } from './resources/accounts';
+import { Drafts } from './resources/drafts';
+import { Media } from './resources/media';
+import { Memory } from './resources/memory';
+import { PersonalizationResource } from './resources/personalization';
+import { Posts } from './resources/posts';
+import { Workspaces } from './resources/workspaces';
+import type { DunSocialOptions } from './types';
+import { constructEvent } from './webhooks';
+export declare class DunSocial {
+    readonly workspaces: Workspaces;
+    readonly accounts: Accounts;
+    readonly posts: Posts;
+    readonly drafts: Drafts;
+    readonly media: Media;
+    readonly memory: Memory;
+    readonly personalization: PersonalizationResource;
+    static webhooks: {
+        constructEvent: typeof constructEvent;
+    };
+    constructor(options?: DunSocialOptions);
+}
+export { DunSocialError } from './errors';
+export { constructEvent } from './webhooks';
+export { SDK_VERSION } from './version';
+export type { components, paths } from './generated/openapi';
+export type { ConstructEventOptions, CreateCollectionInput, CreateDraftInput, DunSocialOptions, InstagramPostOptions, MediaAsset, Paginated, Personalization, PinterestPostOptions, Post, PostMetadata, PostStatus, PublishPostInput, RedditPostOptions, SchedulePostInput, SocialAccount, TikTokPostOptions, UploadInput, ValidatePostInput, ValidatePostResult, WebhookEvent, WebhookEventType, WebhookHeaders, Workspace } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,SAAS;IACrB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAC;IAElD,MAAM,CAAC,QAAQ;;MAAsB;gBAEzB,OAAO,GAAE,gBAAqB;CAU1C;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EACX,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+import { HttpClient } from './client';
+import { Accounts } from './resources/accounts';
+import { Drafts } from './resources/drafts';
+import { Media } from './resources/media';
+import { Memory } from './resources/memory';
+import { PersonalizationResource } from './resources/personalization';
+import { Posts } from './resources/posts';
+import { Workspaces } from './resources/workspaces';
+import { constructEvent } from './webhooks';
+export class DunSocial {
+    workspaces;
+    accounts;
+    posts;
+    drafts;
+    media;
+    memory;
+    personalization;
+    static webhooks = { constructEvent };
+    constructor(options = {}) {
+        const http = new HttpClient(options);
+        this.workspaces = new Workspaces(http);
+        this.accounts = new Accounts(http);
+        this.posts = new Posts(http);
+        this.drafts = new Drafts(http);
+        this.media = new Media(http);
+        this.memory = new Memory(http);
+        this.personalization = new PersonalizationResource(http);
+    }
+}
+export { DunSocialError } from './errors';
+export { constructEvent } from './webhooks';
+export { SDK_VERSION } from './version';

package/dist/media-limits.d.ts

@@ -0,0 +1,16 @@
+export declare const MAX_IMAGE_SIZE: number;
+export declare const MAX_VIDEO_SIZE: number;
+export declare const ALLOWED_IMAGE_TYPES: readonly ["image/jpeg", "image/png", "image/gif", "image/webp"];
+export declare const ALLOWED_VIDEO_TYPES: readonly ["video/mp4", "video/quicktime", "video/webm"];
+export declare function byteLength(file: Uint8Array | ArrayBuffer | Blob): number;
+export declare function toBytes(file: Uint8Array | ArrayBuffer | Blob): Uint8Array | Blob;
+export declare function preflightMediaUpload(input: {
+    mimeType: string;
+    fileSize: number;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+//# sourceMappingURL=media-limits.d.ts.map

package/dist/media-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-limits.d.ts","sourceRoot":"","sources":["../src/media-limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,QAAkB,CAAC;AAC9C,eAAO,MAAM,cAAc,QAAoB,CAAC;AAEhD,eAAO,MAAM,mBAAmB,iEAKtB,CAAC;AAEX,eAAO,MAAM,mBAAmB,yDAA0D,CAAC;AAE3F,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,MAAM,CAIxE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,CAIhF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA2BhD"}

package/dist/media-limits.js

@@ -0,0 +1,49 @@
+export const MAX_IMAGE_SIZE = 8 * 1024 * 1024;
+export const MAX_VIDEO_SIZE = 512 * 1024 * 1024;
+export const ALLOWED_IMAGE_TYPES = [
+    'image/jpeg',
+    'image/png',
+    'image/gif',
+    'image/webp'
+];
+export const ALLOWED_VIDEO_TYPES = ['video/mp4', 'video/quicktime', 'video/webm'];
+export function byteLength(file) {
+    if (file instanceof Blob)
+        return file.size;
+    if (file instanceof ArrayBuffer)
+        return file.byteLength;
+    return file.byteLength;
+}
+export function toBytes(file) {
+    if (file instanceof Blob)
+        return file;
+    if (file instanceof ArrayBuffer)
+        return new Uint8Array(file);
+    return file;
+}
+export function preflightMediaUpload(input) {
+    const { mimeType, fileSize } = input;
+    const isImage = ALLOWED_IMAGE_TYPES.includes(mimeType);
+    const isVideo = ALLOWED_VIDEO_TYPES.includes(mimeType);
+    if (!isImage && !isVideo) {
+        return {
+            ok: false,
+            message: `Unsupported MIME type "${mimeType}". ` +
+                `Allowed images: ${ALLOWED_IMAGE_TYPES.join(', ')}; ` +
+                `videos: ${ALLOWED_VIDEO_TYPES.join(', ')}`
+        };
+    }
+    if (isVideo && fileSize > MAX_VIDEO_SIZE) {
+        return {
+            ok: false,
+            message: `Video files must be less than ${MAX_VIDEO_SIZE / 1024 / 1024}MB`
+        };
+    }
+    if (isImage && fileSize > MAX_IMAGE_SIZE) {
+        return {
+            ok: false,
+            message: `Image files must be less than ${MAX_IMAGE_SIZE / 1024 / 1024}MB`
+        };
+    }
+    return { ok: true };
+}

package/dist/pagination.d.ts

@@ -0,0 +1,4 @@
+import type { Paginated } from './types';
+export declare function asPage<T>(data: unknown): Paginated<T>;
+export declare function iteratePages<T>(fetchPage: (offset: number, limit: number) => Promise<Paginated<T>>, pageSize?: number): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAuBrD;AAED,wBAAuB,YAAY,CAAC,CAAC,EACpC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EACnE,QAAQ,SAAK,GACX,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAQpC"}