@seenn/node 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seenn
+
+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,188 @@
+# @seenn/node
+
+> **Open Source Backend SDK for Job State Transport**
+
+[![npm version](https://badge.fury.io/js/@seenn%2Fnode.svg)](https://www.npmjs.com/package/@seenn/node)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Real-time job progress tracking for AI video generation, image processing, and long-running async tasks.
+
+## Features
+
+- **Fluent API** - Chain job updates naturally
+- **Auto-retry** - Exponential backoff with jitter
+- **TypeScript** - Full type definitions
+- **Self-hosted** - Use with your own backend
+- **Open Source** - MIT License
+
+---
+
+## Installation
+
+```bash
+npm install @seenn/node
+# or
+yarn add @seenn/node
+# or
+pnpm add @seenn/node
+```
+
+---
+
+## Quick Start
+
+### Seenn Cloud
+
+```typescript
+import { SeennClient } from '@seenn/node';
+
+const seenn = new SeennClient({
+  apiKey: 'sk_live_your_api_key',
+});
+```
+
+### Self-Hosted (Your Own Backend)
+
+```typescript
+import { SeennClient } from '@seenn/node';
+
+const seenn = new SeennClient({
+  apiKey: 'sk_live_your_api_key',
+  baseUrl: 'https://api.yourapp.com', // Your backend URL
+});
+```
+
+---
+
+## Usage
+
+### Start a Job
+
+```typescript
+const job = await seenn.jobs.start({
+  jobType: 'video-generation',
+  userId: 'user_123',
+  title: 'Generating video...',
+  metadata: { prompt: 'A cat playing piano' },
+  queue: { position: 5, total: 20 },
+  stage: { name: 'queued', current: 1, total: 4 },
+});
+
+console.log(`Job started: ${job.id}`);
+```
+
+### Update Progress
+
+```typescript
+await job.setProgress(50, {
+  message: 'Rendering frames...',
+  stage: { name: 'render', current: 2, total: 4 },
+});
+```
+
+### Complete Job
+
+```typescript
+await job.complete({
+  result: {
+    type: 'video',
+    url: 'https://cdn.example.com/video.mp4',
+    data: { duration: 30, resolution: '1080p' },
+  },
+  message: 'Video ready!',
+});
+```
+
+### Fail Job
+
+```typescript
+await job.fail({
+  error: {
+    code: 'RENDER_FAILED',
+    message: 'GPU memory exceeded',
+    details: { gpuMemory: '16GB', required: '24GB' },
+  },
+  retryable: true,
+});
+```
+
+### Get / List Jobs
+
+```typescript
+// Get single job
+const job = await seenn.jobs.get('job_01ABC123');
+console.log(job.status, job.progress);
+
+// List user's jobs
+const { jobs, nextCursor } = await seenn.jobs.list('user_123', {
+  limit: 20,
+});
+```
+
+---
+
+## Configuration
+
+```typescript
+const seenn = new SeennClient({
+  apiKey: string;         // Required: sk_live_xxx or sk_test_xxx
+  baseUrl?: string;       // Default: https://api.seenn.io
+  timeout?: number;       // Default: 30000 (30s)
+  maxRetries?: number;    // Default: 3
+  debug?: boolean;        // Default: false
+});
+```
+
+---
+
+## Error Handling
+
+```typescript
+import { SeennError, RateLimitError, ValidationError, NotFoundError } from '@seenn/node';
+
+try {
+  await seenn.jobs.start({ ... });
+} catch (error) {
+  if (error instanceof RateLimitError) {
+    console.log(`Rate limited. Retry after ${error.retryAfter}s`);
+  } else if (error instanceof ValidationError) {
+    console.log('Invalid input:', error.details);
+  } else if (error instanceof NotFoundError) {
+    console.log('Job not found');
+  } else if (error instanceof SeennError) {
+    console.log(`Error ${error.code}: ${error.message}`);
+  }
+}
+```
+
+---
+
+## Self-Hosted Requirements
+
+To use this SDK with your own backend, implement these endpoints:
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/v1/jobs` | Create a new job |
+| GET | `/v1/jobs/:id` | Get job by ID |
+| GET | `/v1/jobs?userId=xxx` | List user's jobs |
+| POST | `/v1/jobs/:id/progress` | Update job progress |
+| POST | `/v1/jobs/:id/complete` | Mark job as completed |
+| POST | `/v1/jobs/:id/fail` | Mark job as failed |
+
+See [Self-Hosted Guide](https://docs.seenn.io/self-hosted) for full API specification.
+
+---
+
+## Links
+
+- [Documentation](https://docs.seenn.io)
+- [Website](https://seenn.io)
+- [GitHub](https://github.com/seenn-io/node)
+- [npm](https://www.npmjs.com/package/@seenn/node)
+
+---
+
+## License
+
+MIT © [Seenn](https://seenn.io)

package/dist/client.d.ts

@@ -0,0 +1,43 @@
+import { Job } from './job.js';
+import type { StartJobParams } from './types.js';
+export interface SeennConfig {
+    /** API key (sk_live_xxx or sk_test_xxx) */
+    apiKey: string;
+    /** Base URL (default: https://api.seenn.io) */
+    baseUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Max retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export declare class SeennClient {
+    private readonly http;
+    private readonly config;
+    constructor(config: SeennConfig);
+    /**
+     * Jobs resource
+     */
+    get jobs(): {
+        /**
+         * Start a new job
+         */
+        start: (params: StartJobParams) => Promise<Job>;
+        /**
+         * Get a job by ID
+         */
+        get: (jobId: string) => Promise<Job>;
+        /**
+         * List jobs for a user
+         */
+        list: (userId: string, options?: {
+            limit?: number;
+            cursor?: string;
+        }) => Promise<{
+            jobs: Job[];
+            nextCursor: string | undefined;
+        }>;
+    };
+}
+//# 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":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,MAAM,EAAE,WAAW;IAoB/B;;OAEG;IACH,IAAI,IAAI;QAEJ;;WAEG;wBACmB,cAAc,KAAG,OAAO,CAAC,GAAG,CAAC;QAKnD;;WAEG;qBACgB,MAAM,KAAG,OAAO,CAAC,GAAG,CAAC;QAKxC;;WAEG;uBACkB,MAAM,YAAY;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE;;;;MAgB7E;CACF"}

package/dist/client.js

@@ -0,0 +1,59 @@
+import { Job } from './job.js';
+import { HttpClient } from './http.js';
+export class SeennClient {
+    http;
+    config;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('apiKey is required');
+        }
+        if (!config.apiKey.startsWith('sk_')) {
+            throw new Error('apiKey must start with sk_live_ or sk_test_');
+        }
+        this.config = {
+            apiKey: config.apiKey,
+            baseUrl: config.baseUrl || 'https://api.seenn.io',
+            timeout: config.timeout || 30000,
+            maxRetries: config.maxRetries || 3,
+            debug: config.debug || false,
+        };
+        this.http = new HttpClient(this.config);
+    }
+    /**
+     * Jobs resource
+     */
+    get jobs() {
+        return {
+            /**
+             * Start a new job
+             */
+            start: async (params) => {
+                const response = await this.http.post('/v1/jobs', params);
+                return new Job(response, this.http);
+            },
+            /**
+             * Get a job by ID
+             */
+            get: async (jobId) => {
+                const response = await this.http.get(`/v1/jobs/${jobId}`);
+                return new Job(response, this.http);
+            },
+            /**
+             * List jobs for a user
+             */
+            list: async (userId, options) => {
+                const params = new URLSearchParams({ userId });
+                if (options?.limit)
+                    params.set('limit', String(options.limit));
+                if (options?.cursor)
+                    params.set('cursor', options.cursor);
+                const response = await this.http.get(`/v1/jobs?${params}`);
+                return {
+                    jobs: response.jobs.map((j) => new Job(j, this.http)),
+                    nextCursor: response.nextCursor,
+                };
+            },
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAgBvC,MAAM,OAAO,WAAW;IACL,IAAI,CAAa;IACjB,MAAM,CAAwB;IAE/C,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,sBAAsB;YACjD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YAClC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;SAC7B,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO;YACL;;eAEG;YACH,KAAK,EAAE,KAAK,EAAE,MAAsB,EAAgB,EAAE;gBACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAc,UAAU,EAAE,MAAM,CAAC,CAAC;gBACvE,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YAED;;eAEG;YACH,GAAG,EAAE,KAAK,EAAE,KAAa,EAAgB,EAAE;gBACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAc,YAAY,KAAK,EAAE,CAAC,CAAC;gBACvE,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YAED;;eAEG;YACH,IAAI,EAAE,KAAK,EAAE,MAAc,EAAE,OAA6C,EAAE,EAAE;gBAC5E,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC/C,IAAI,OAAO,EAAE,KAAK;oBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC/D,IAAI,OAAO,EAAE,MAAM;oBAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAE1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAGjC,YAAY,MAAM,EAAE,CAAC,CAAC;gBAEzB,OAAO;oBACL,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;oBACrD,UAAU,EAAE,QAAQ,CAAC,UAAU;iBAChC,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,32 @@
+export declare class SeennError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, statusCode?: number, details?: Record<string, unknown> | undefined);
+    toJSON(): {
+        name: string;
+        code: string;
+        message: string;
+        statusCode: number;
+        details: Record<string, unknown> | undefined;
+    };
+}
+export declare class ValidationError extends SeennError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class NotFoundError extends SeennError {
+    constructor(resource: string, id: string);
+}
+export declare class RateLimitError extends SeennError {
+    readonly retryAfter: number;
+    readonly limit: number;
+    readonly remaining: number;
+    constructor(retryAfter: number, limit: number, remaining: number);
+}
+export declare class AuthenticationError extends SeennError {
+    constructor(message?: string);
+}
+export declare class ConflictError extends SeennError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# 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,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;aAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAMnD,MAAM;;;;;;;CASP;AAED,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAIzC;AAED,qBAAa,cAAe,SAAQ,UAAU;aAE1B,UAAU,EAAE,MAAM;aAClB,KAAK,EAAE,MAAM;aACb,SAAS,EAAE,MAAM;gBAFjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;CASpC;AAED,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,GAAE,MAAqC;CAI3D;AAED,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D"}

package/dist/errors.js

@@ -0,0 +1,62 @@
+export class SeennError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(message, code, statusCode = 500, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'SeennError';
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            statusCode: this.statusCode,
+            details: this.details,
+        };
+    }
+}
+export class ValidationError extends SeennError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', 400, details);
+        this.name = 'ValidationError';
+    }
+}
+export class NotFoundError extends SeennError {
+    constructor(resource, id) {
+        super(`${resource} not found: ${id}`, 'NOT_FOUND', 404, { resource, id });
+        this.name = 'NotFoundError';
+    }
+}
+export class RateLimitError extends SeennError {
+    retryAfter;
+    limit;
+    remaining;
+    constructor(retryAfter, limit, remaining) {
+        super(`Rate limit exceeded. Retry after ${retryAfter} seconds`, 'RATE_LIMIT_EXCEEDED', 429, {
+            retryAfter,
+            limit,
+            remaining,
+        });
+        this.retryAfter = retryAfter;
+        this.limit = limit;
+        this.remaining = remaining;
+        this.name = 'RateLimitError';
+    }
+}
+export class AuthenticationError extends SeennError {
+    constructor(message = 'Invalid or missing API key') {
+        super(message, 'AUTHENTICATION_ERROR', 401);
+        this.name = 'AuthenticationError';
+    }
+}
+export class ConflictError extends SeennError {
+    constructor(message, details) {
+        super(message, 'CONFLICT', 409, details);
+        this.name = 'ConflictError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IACA;IAJlB,YACE,OAAe,EACC,IAAY,EACZ,aAAqB,GAAG,EACxB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAc;QACxB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,QAAgB,EAAE,EAAU;QACtC,KAAK,CAAC,GAAG,QAAQ,eAAe,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAE1B;IACA;IACA;IAHlB,YACkB,UAAkB,EAClB,KAAa,EACb,SAAiB;QAEjC,KAAK,CAAC,oCAAoC,UAAU,UAAU,EAAE,qBAAqB,EAAE,GAAG,EAAE;YAC1F,UAAU;YACV,KAAK;YACL,SAAS;SACV,CAAC,CAAC;QARa,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAQ;QACb,cAAS,GAAT,SAAS,CAAQ;QAOjC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,UAAkB,4BAA4B;QACxD,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,14 @@
+import type { SeennConfig } from './client.js';
+export declare class HttpClient {
+    private readonly config;
+    constructor(config: Required<SeennConfig>);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+    private request;
+    private executeWithRetry;
+    private handleErrorResponse;
+    private sleep;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiB/C,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC;IAInC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAI3B,OAAO;YAoDP,gBAAgB;YAyChB,mBAAmB;IAmCjC,OAAO,CAAC,KAAK;CAGd"}

package/dist/http.js

@@ -0,0 +1,125 @@
+import { SeennError, RateLimitError, ValidationError, NotFoundError, AuthenticationError, } from './errors.js';
+export class HttpClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async get(path) {
+        return this.request({ method: 'GET', path });
+    }
+    async post(path, body) {
+        return this.request({ method: 'POST', path, body });
+    }
+    async put(path, body) {
+        return this.request({ method: 'PUT', path, body });
+    }
+    async delete(path) {
+        return this.request({ method: 'DELETE', path });
+    }
+    async request(options) {
+        const { method, path, body } = options;
+        const url = `${this.config.baseUrl}${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.config.apiKey}`,
+            'Content-Type': 'application/json',
+            'User-Agent': '@seenn/node',
+        };
+        if (options.idempotencyKey) {
+            headers['Idempotency-Key'] = options.idempotencyKey;
+        }
+        return this.executeWithRetry(async () => {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+            try {
+                const response = await fetch(url, {
+                    method,
+                    headers,
+                    body: body ? JSON.stringify(body) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    await this.handleErrorResponse(response);
+                }
+                return (await response.json());
+            }
+            catch (error) {
+                clearTimeout(timeoutId);
+                if (error instanceof SeennError) {
+                    throw error;
+                }
+                if (error instanceof Error) {
+                    if (error.name === 'AbortError') {
+                        throw new SeennError('Request timeout', 'TIMEOUT', 408);
+                    }
+                    throw new SeennError(error.message, 'NETWORK_ERROR', 0);
+                }
+                throw new SeennError('Unknown error', 'UNKNOWN', 0);
+            }
+        }, method === 'GET' || !!options.idempotencyKey);
+    }
+    async executeWithRetry(fn, idempotent) {
+        let lastError;
+        const maxRetries = idempotent ? this.config.maxRetries : 1;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on client errors (4xx) except rate limits
+                if (error instanceof SeennError) {
+                    if (error.statusCode >= 400 && error.statusCode < 500) {
+                        if (!(error instanceof RateLimitError)) {
+                            throw error;
+                        }
+                    }
+                }
+                // Calculate delay with exponential backoff + jitter
+                if (attempt < maxRetries - 1) {
+                    const baseDelay = 1000; // 1 second
+                    const exponentialDelay = baseDelay * Math.pow(2, attempt);
+                    const jitter = Math.random() * 0.2 * exponentialDelay;
+                    const delay = Math.min(exponentialDelay + jitter, 30000); // Max 30s
+                    if (this.config.debug) {
+                        console.log(`[seenn] Retry attempt ${attempt + 1}/${maxRetries} after ${delay}ms`);
+                    }
+                    await this.sleep(delay);
+                }
+            }
+        }
+        throw lastError;
+    }
+    async handleErrorResponse(response) {
+        let errorData;
+        try {
+            errorData = (await response.json());
+        }
+        catch {
+            // Response might not be JSON
+        }
+        const message = errorData?.error?.message || response.statusText;
+        const code = errorData?.error?.code || 'UNKNOWN';
+        const details = errorData?.error?.details;
+        switch (response.status) {
+            case 400:
+                throw new ValidationError(message, details);
+            case 401:
+                throw new AuthenticationError(message);
+            case 404:
+                throw new NotFoundError('Resource', details?.id || 'unknown');
+            case 429: {
+                const retryAfter = parseInt(response.headers.get('Retry-After') || '60', 10);
+                const limit = parseInt(response.headers.get('X-RateLimit-Limit') || '0', 10);
+                const remaining = parseInt(response.headers.get('X-RateLimit-Remaining') || '0', 10);
+                throw new RateLimitError(retryAfter, limit, remaining);
+            }
+            default:
+                throw new SeennError(message, code, response.status, details);
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { SeennClient } from './client.js';
+export type { SeennConfig } from './client.js';
+export { Job } from './job.js';
+export type { JobStatus, JobData, ProgressOptions, CompleteOptions, FailOptions } from './job.js';
+export type { StartJobParams, ProgressParams, CompleteParams, FailParams, QueueInfo, StageInfo, JobResult, JobError, } from './types.js';
+export { SeennError, RateLimitError, ValidationError, NotFoundError } from './errors.js';
+//# 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":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAElG,YAAY,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// @seenn/node - Job State Transport SDK
+export { SeennClient } from './client.js';
+export { Job } from './job.js';
+export { SeennError, RateLimitError, ValidationError, NotFoundError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAc/B,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}