@seenn/node 0.1.0

package/dist/job.d.ts

@@ -0,0 +1,87 @@
+import type { HttpClient } from './http.js';
+import type { JobResponse, QueueInfo, StageInfo, JobResult, JobError } from './types.js';
+export type JobStatus = 'pending' | 'running' | 'completed' | 'failed';
+export interface JobData {
+    id: string;
+    appId: string;
+    userId: string;
+    jobType: string;
+    title: string;
+    status: JobStatus;
+    progress: number;
+    message?: string;
+    queue?: QueueInfo;
+    stage?: StageInfo;
+    result?: JobResult;
+    error?: JobError;
+    metadata?: Record<string, unknown>;
+    estimatedCompletionAt?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+}
+export interface ProgressOptions {
+    message?: string;
+    queue?: QueueInfo;
+    stage?: StageInfo;
+    estimatedCompletionAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CompleteOptions {
+    result?: JobResult;
+    message?: string;
+}
+export interface FailOptions {
+    error: JobError;
+    retryable?: boolean;
+}
+/**
+ * Job instance with fluent API for updates
+ */
+export declare class Job implements JobData {
+    readonly id: string;
+    readonly appId: string;
+    readonly userId: string;
+    readonly jobType: string;
+    readonly title: string;
+    status: JobStatus;
+    progress: number;
+    message?: string;
+    queue?: QueueInfo;
+    stage?: StageInfo;
+    result?: JobResult;
+    error?: JobError;
+    metadata?: Record<string, unknown>;
+    estimatedCompletionAt?: string;
+    readonly createdAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+    private readonly http;
+    constructor(data: JobResponse, http: HttpClient);
+    /**
+     * Update job progress (0-100)
+     */
+    setProgress(progress: number, options?: ProgressOptions): Promise<this>;
+    /**
+     * Mark job as completed
+     */
+    complete(options?: CompleteOptions): Promise<this>;
+    /**
+     * Mark job as failed
+     */
+    fail(options: FailOptions): Promise<this>;
+    /**
+     * Refresh job data from server
+     */
+    refresh(): Promise<this>;
+    /**
+     * Check if job is in a terminal state
+     */
+    get isTerminal(): boolean;
+    /**
+     * Get plain object representation
+     */
+    toJSON(): JobData;
+    private updateFromResponse;
+}
+//# sourceMappingURL=job.d.ts.map

package/dist/job.d.ts.map

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

package/dist/job.js

@@ -0,0 +1,125 @@
+/**
+ * Job instance with fluent API for updates
+ */
+export class Job {
+    id;
+    appId;
+    userId;
+    jobType;
+    title;
+    status;
+    progress;
+    message;
+    queue;
+    stage;
+    result;
+    error;
+    metadata;
+    estimatedCompletionAt;
+    createdAt;
+    updatedAt;
+    completedAt;
+    http;
+    constructor(data, http) {
+        this.id = data.id;
+        this.appId = data.appId;
+        this.userId = data.userId;
+        this.jobType = data.jobType;
+        this.title = data.title;
+        this.status = data.status;
+        this.progress = data.progress;
+        this.message = data.message;
+        this.queue = data.queue;
+        this.stage = data.stage;
+        this.result = data.result;
+        this.error = data.error;
+        this.metadata = data.metadata;
+        this.estimatedCompletionAt = data.estimatedCompletionAt;
+        this.createdAt = new Date(data.createdAt);
+        this.updatedAt = new Date(data.updatedAt);
+        this.completedAt = data.completedAt ? new Date(data.completedAt) : undefined;
+        this.http = http;
+    }
+    /**
+     * Update job progress (0-100)
+     */
+    async setProgress(progress, options) {
+        const params = {
+            progress,
+            ...options,
+        };
+        const response = await this.http.post(`/v1/jobs/${this.id}/progress`, params);
+        this.updateFromResponse(response);
+        return this;
+    }
+    /**
+     * Mark job as completed
+     */
+    async complete(options) {
+        const params = options || {};
+        const response = await this.http.post(`/v1/jobs/${this.id}/complete`, params);
+        this.updateFromResponse(response);
+        return this;
+    }
+    /**
+     * Mark job as failed
+     */
+    async fail(options) {
+        const params = options;
+        const response = await this.http.post(`/v1/jobs/${this.id}/fail`, params);
+        this.updateFromResponse(response);
+        return this;
+    }
+    /**
+     * Refresh job data from server
+     */
+    async refresh() {
+        const response = await this.http.get(`/v1/jobs/${this.id}`);
+        this.updateFromResponse(response);
+        return this;
+    }
+    /**
+     * Check if job is in a terminal state
+     */
+    get isTerminal() {
+        return this.status === 'completed' || this.status === 'failed';
+    }
+    /**
+     * Get plain object representation
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            appId: this.appId,
+            userId: this.userId,
+            jobType: this.jobType,
+            title: this.title,
+            status: this.status,
+            progress: this.progress,
+            message: this.message,
+            queue: this.queue,
+            stage: this.stage,
+            result: this.result,
+            error: this.error,
+            metadata: this.metadata,
+            estimatedCompletionAt: this.estimatedCompletionAt,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+            completedAt: this.completedAt,
+        };
+    }
+    updateFromResponse(response) {
+        this.status = response.status;
+        this.progress = response.progress;
+        this.message = response.message;
+        this.queue = response.queue;
+        this.stage = response.stage;
+        this.result = response.result;
+        this.error = response.error;
+        this.metadata = response.metadata;
+        this.estimatedCompletionAt = response.estimatedCompletionAt;
+        this.updatedAt = new Date(response.updatedAt);
+        this.completedAt = response.completedAt ? new Date(response.completedAt) : undefined;
+    }
+}
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+export interface StartJobParams {
+    /** Unique job type identifier (e.g., 'video-generation', 'image-processing') */
+    jobType: string;
+    /** User ID who owns this job */
+    userId: string;
+    /** Human-readable title for the job */
+    title: string;
+    /** Optional metadata (max 10KB) */
+    metadata?: Record<string, unknown>;
+    /** Optional initial queue information */
+    queue?: QueueInfo;
+    /** Optional initial stage information */
+    stage?: StageInfo;
+    /** Optional estimated completion time (ISO 8601) */
+    estimatedCompletionAt?: string;
+    /** Optional TTL in seconds (default: 30 days) */
+    ttlSeconds?: number;
+}
+export interface ProgressParams {
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Optional status message */
+    message?: string;
+    /** Optional updated queue information */
+    queue?: QueueInfo;
+    /** Optional updated stage information */
+    stage?: StageInfo;
+    /** Optional updated ETA */
+    estimatedCompletionAt?: string;
+    /** Optional metadata update (merged with existing) */
+    metadata?: Record<string, unknown>;
+}
+export interface CompleteParams {
+    /** Result data (max 100KB) */
+    result?: JobResult;
+    /** Optional completion message */
+    message?: string;
+}
+export interface FailParams {
+    /** Error information */
+    error: JobError;
+    /** Whether the job can be retried */
+    retryable?: boolean;
+}
+export interface QueueInfo {
+    /** Current position in queue (1-based) */
+    position: number;
+    /** Total items in queue */
+    total?: number;
+    /** Optional queue name/tier */
+    queueName?: string;
+}
+export interface StageInfo {
+    /** Current stage name */
+    name: string;
+    /** Current stage number (1-based) */
+    current: number;
+    /** Total number of stages */
+    total: number;
+    /** Optional stage description */
+    description?: string;
+}
+export interface JobResult {
+    /** Result type identifier */
+    type?: string;
+    /** Result URL (e.g., generated video URL) */
+    url?: string;
+    /** Additional result data */
+    data?: Record<string, unknown>;
+}
+export interface JobError {
+    /** Error code */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+}
+export interface JobResponse {
+    id: string;
+    appId: string;
+    userId: string;
+    jobType: string;
+    title: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    progress: number;
+    message?: string;
+    queue?: QueueInfo;
+    stage?: StageInfo;
+    result?: JobResult;
+    error?: JobError;
+    metadata?: Record<string, unknown>;
+    estimatedCompletionAt?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// Job Parameters
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iBAAiB"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@seenn/node",
+  "version": "0.1.0",
+  "description": "Seenn Node.js Backend SDK - Open source job state transport for real-time progress tracking",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "ulid": "^2.3.0"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "seenn",
+    "job",
+    "progress",
+    "realtime",
+    "push",
+    "notification",
+    "live-activity",
+    "sse",
+    "backend",
+    "api",
+    "open-source"
+  ],
+  "author": "Seenn <hello@seenn.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/seenn-io/node.git"
+  },
+  "homepage": "https://seenn.io",
+  "bugs": {
+    "url": "https://github.com/seenn-io/node/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,83 @@
+import { Job } from './job.js';
+import { HttpClient } from './http.js';
+import type { StartJobParams, JobResponse } 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 class SeennClient {
+  private readonly http: HttpClient;
+  private readonly config: Required<SeennConfig>;
+
+  constructor(config: SeennConfig) {
+    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: StartJobParams): Promise<Job> => {
+        const response = await this.http.post<JobResponse>('/v1/jobs', params);
+        return new Job(response, this.http);
+      },
+
+      /**
+       * Get a job by ID
+       */
+      get: async (jobId: string): Promise<Job> => {
+        const response = await this.http.get<JobResponse>(`/v1/jobs/${jobId}`);
+        return new Job(response, this.http);
+      },
+
+      /**
+       * List jobs for a user
+       */
+      list: async (userId: string, options?: { limit?: number; cursor?: string }) => {
+        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<{
+          jobs: JobResponse[];
+          nextCursor?: string;
+        }>(`/v1/jobs?${params}`);
+
+        return {
+          jobs: response.jobs.map((j) => new Job(j, this.http)),
+          nextCursor: response.nextCursor,
+        };
+      },
+    };
+  }
+}

package/src/errors.ts

@@ -0,0 +1,64 @@
+export class SeennError extends Error {
+  constructor(
+    message: string,
+    public readonly code: string,
+    public readonly statusCode: number = 500,
+    public readonly details?: Record<string, unknown>
+  ) {
+    super(message);
+    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: string, details?: Record<string, unknown>) {
+    super(message, 'VALIDATION_ERROR', 400, details);
+    this.name = 'ValidationError';
+  }
+}
+
+export class NotFoundError extends SeennError {
+  constructor(resource: string, id: string) {
+    super(`${resource} not found: ${id}`, 'NOT_FOUND', 404, { resource, id });
+    this.name = 'NotFoundError';
+  }
+}
+
+export class RateLimitError extends SeennError {
+  constructor(
+    public readonly retryAfter: number,
+    public readonly limit: number,
+    public readonly remaining: number
+  ) {
+    super(`Rate limit exceeded. Retry after ${retryAfter} seconds`, 'RATE_LIMIT_EXCEEDED', 429, {
+      retryAfter,
+      limit,
+      remaining,
+    });
+    this.name = 'RateLimitError';
+  }
+}
+
+export class AuthenticationError extends SeennError {
+  constructor(message: string = 'Invalid or missing API key') {
+    super(message, 'AUTHENTICATION_ERROR', 401);
+    this.name = 'AuthenticationError';
+  }
+}
+
+export class ConflictError extends SeennError {
+  constructor(message: string, details?: Record<string, unknown>) {
+    super(message, 'CONFLICT', 409, details);
+    this.name = 'ConflictError';
+  }
+}