@seenn/types 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,416 @@
+/**
+ * @seenn/types - Shared TypeScript types for Seenn SDKs
+ *
+ * This package is the single source of truth for all Seenn type definitions.
+ * All SDK packages (react-native, node, flutter) should depend on this package.
+ *
+ * @version 0.1.0
+ * @license MIT
+ */
+/**
+ * Job status values
+ */
+type JobStatus = 'pending' | 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * How parent job progress is calculated from children
+ */
+type ChildProgressMode = 'average' | 'weighted' | 'sequential';
+/**
+ * Main job object returned by API and SSE
+ */
+interface SeennJob {
+    /** Unique job identifier (ULID format) */
+    jobId: string;
+    /** User who owns this job */
+    userId: string;
+    /** Application ID */
+    appId: string;
+    /** Current job status */
+    status: JobStatus;
+    /** Human-readable job title */
+    title: string;
+    /** Job type for categorization */
+    jobType: string;
+    /** Workflow ID for ETA tracking (default: jobType) */
+    workflowId?: string;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Current status message */
+    message?: string;
+    /** Stage information for multi-step jobs */
+    stage?: StageInfo;
+    /** Estimated completion timestamp (ISO 8601) */
+    estimatedCompletionAt?: string;
+    /** ETA confidence score (0.0 - 1.0) */
+    etaConfidence?: number;
+    /** Number of historical jobs used to calculate ETA */
+    etaBasedOn?: number;
+    /** Queue position info */
+    queue?: QueueInfo;
+    /** Job result on completion */
+    result?: JobResult;
+    /** Error details on failure */
+    error?: JobError;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    /** Parent info (if this is a child job) */
+    parent?: ParentInfo;
+    /** Children stats (if this is a parent job) */
+    children?: ChildrenStats;
+    /** Progress calculation mode for parent jobs */
+    childProgressMode?: ChildProgressMode;
+    /** Job creation timestamp (ISO 8601) */
+    createdAt: string;
+    /** Last update timestamp (ISO 8601) */
+    updatedAt: string;
+    /** When the job started running (ISO 8601) */
+    startedAt?: string;
+    /** Job completion timestamp (ISO 8601) */
+    completedAt?: string;
+}
+/**
+ * Stage information for multi-step jobs
+ */
+interface StageInfo {
+    /** Current stage name */
+    name: string;
+    /** Current stage index (1-based) */
+    current: number;
+    /** Total number of stages */
+    total: number;
+    /** Optional stage description */
+    description?: string;
+}
+/**
+ * Queue position information
+ */
+interface QueueInfo {
+    /** Position in queue (1-based) */
+    position: number;
+    /** Total items in queue */
+    total?: number;
+    /** Queue name/identifier */
+    queueName?: string;
+}
+/**
+ * Job result on successful completion
+ */
+interface JobResult {
+    /** Result type (e.g., 'video', 'image', 'file') */
+    type?: string;
+    /** Result URL if applicable */
+    url?: string;
+    /** Additional result data */
+    data?: Record<string, unknown>;
+}
+/**
+ * Error details on job failure
+ */
+interface JobError {
+    /** Error code for programmatic handling */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Parent info for child jobs
+ */
+interface ParentInfo {
+    /** Parent job ID */
+    parentJobId: string;
+    /** Child index within parent (0-based) */
+    childIndex: number;
+}
+/**
+ * Children stats for parent jobs
+ */
+interface ChildrenStats {
+    /** Total number of children */
+    total: number;
+    /** Number of completed children */
+    completed: number;
+    /** Number of failed children */
+    failed: number;
+    /** Number of running children */
+    running: number;
+    /** Number of pending children */
+    pending: number;
+}
+/**
+ * Summary of a child job (used in parent.children array)
+ */
+interface ChildJobSummary {
+    /** Child job ID */
+    id: string;
+    /** Child index within parent (0-based) */
+    childIndex: number;
+    /** Child job title */
+    title: string;
+    /** Child job status */
+    status: JobStatus;
+    /** Child progress (0-100) */
+    progress: number;
+    /** Child status message */
+    message?: string;
+    /** Child result */
+    result?: JobResult;
+    /** Child error */
+    error?: JobError;
+    /** Child creation timestamp */
+    createdAt: string;
+    /** Child last update timestamp */
+    updatedAt: string;
+    /** Child completion timestamp */
+    completedAt?: string;
+}
+/**
+ * Parent job with all its children
+ */
+interface ParentWithChildren {
+    /** Parent job */
+    parent: SeennJob;
+    /** List of child jobs */
+    children: ChildJobSummary[];
+}
+/**
+ * Connection state for SSE
+ */
+type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+/**
+ * SSE event types
+ */
+type SSEEventType = 'connected' | 'job.sync' | 'job.started' | 'job.progress' | 'job.completed' | 'job.failed' | 'job.cancelled' | 'child.progress' | 'parent.updated' | 'in_app_message' | 'connection.idle' | 'heartbeat' | 'error';
+/**
+ * SSE event wrapper
+ */
+interface SSEEvent {
+    /** Event type */
+    event: SSEEventType;
+    /** Event data */
+    data: unknown;
+    /** Event ID for replay */
+    id?: string;
+}
+/**
+ * In-app message types
+ */
+type InAppMessageType = 'job_complete_banner' | 'job_failed_modal' | 'job_toast';
+/**
+ * In-app message for UI notifications
+ */
+interface InAppMessage {
+    /** Message ID */
+    messageId: string;
+    /** Message type */
+    type: InAppMessageType;
+    /** Associated job ID */
+    jobId: string;
+    /** Message title */
+    title: string;
+    /** Message body */
+    body?: string;
+    /** Call-to-action text */
+    cta?: string;
+    /** Call-to-action URL */
+    ctaUrl?: string;
+}
+/**
+ * Create job request parameters
+ */
+interface CreateJobParams {
+    /** User ID */
+    userId: string;
+    /** Job type */
+    jobType: string;
+    /** Job title */
+    title: string;
+    /** Workflow ID for ETA tracking (default: jobType) */
+    workflowId?: string;
+    /** Initial message */
+    message?: string;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    /** Estimated duration in ms (for ETA default) */
+    estimatedDuration?: number;
+    /** Parent job ID (for child jobs) */
+    parentJobId?: string;
+    /** Child index (for child jobs) */
+    childIndex?: number;
+    /** Total children (for parent jobs) */
+    totalChildren?: number;
+    /** Child progress mode (for parent jobs) */
+    childProgressMode?: ChildProgressMode;
+}
+/**
+ * Update job request parameters
+ */
+interface UpdateJobParams {
+    /** New progress (0-100) */
+    progress?: number;
+    /** New message */
+    message?: string;
+    /** New stage info */
+    stage?: StageInfo;
+    /** Custom metadata to merge */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Complete job request parameters
+ */
+interface CompleteJobParams {
+    /** Job result */
+    result?: JobResult;
+    /** Final message */
+    message?: string;
+}
+/**
+ * Fail job request parameters
+ */
+interface FailJobParams {
+    /** Error details */
+    error: JobError;
+}
+/**
+ * Webhook event types
+ */
+type WebhookEventType = 'job.started' | 'job.progress' | 'job.completed' | 'job.failed' | 'job.cancelled';
+/**
+ * Webhook payload
+ */
+interface WebhookPayload {
+    /** Event type */
+    event: WebhookEventType;
+    /** Job data */
+    job: SeennJob;
+    /** Event timestamp (ISO 8601) */
+    timestamp: string;
+    /** Webhook delivery ID */
+    deliveryId: string;
+}
+/**
+ * ETA statistics for a workflow/jobType
+ */
+interface EtaStats {
+    /** ETA key (workflowId or jobType) */
+    etaKey: string;
+    /** Number of completed jobs */
+    count: number;
+    /** Average duration in ms */
+    avgDuration: number;
+    /** Minimum duration in ms */
+    minDuration: number;
+    /** Maximum duration in ms */
+    maxDuration: number;
+    /** Default duration if no history */
+    defaultDuration?: number;
+    /** Last updated timestamp */
+    lastUpdated: string;
+}
+/**
+ * Base SDK configuration
+ */
+interface SeennConfig {
+    /** API base URL */
+    baseUrl: string;
+    /** Authentication token (pk_* for client, sk_* for server) */
+    authToken?: string;
+    /** SSE endpoint URL (default: baseUrl + /v1/sse) */
+    sseUrl?: string;
+    /** Enable auto-reconnect (default: true) */
+    reconnect?: boolean;
+    /** Reconnect interval in ms (default: 1000) */
+    reconnectInterval?: number;
+    /** Max reconnect attempts (default: 10) */
+    maxReconnectAttempts?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+/**
+ * Live Activity start parameters
+ */
+interface LiveActivityStartParams {
+    /** Job ID */
+    jobId: string;
+    /** Activity title */
+    title: string;
+    /** Job type for icon selection */
+    jobType?: string;
+    /** Initial progress (0-100) */
+    initialProgress?: number;
+    /** Initial message */
+    initialMessage?: string;
+}
+/**
+ * Live Activity update parameters
+ */
+interface LiveActivityUpdateParams {
+    /** Job ID */
+    jobId: string;
+    /** New progress (0-100) */
+    progress?: number;
+    /** New status */
+    status?: JobStatus;
+    /** New message */
+    message?: string;
+    /** Stage info */
+    stage?: StageInfo;
+    /** ETA timestamp (Unix ms) */
+    estimatedEndTime?: number;
+}
+/**
+ * Live Activity end parameters
+ */
+interface LiveActivityEndParams {
+    /** Job ID */
+    jobId: string;
+    /** Final status */
+    finalStatus?: JobStatus;
+    /** Final progress */
+    finalProgress?: number;
+    /** Final message */
+    message?: string;
+    /** Result URL */
+    resultUrl?: string;
+    /** Error message */
+    errorMessage?: string;
+    /** Dismiss after seconds (default: 300) */
+    dismissAfter?: number;
+}
+/**
+ * Live Activity result
+ */
+interface LiveActivityResult {
+    /** Success flag */
+    success: boolean;
+    /** Activity ID (platform-specific) */
+    activityId?: string;
+    /** Associated job ID */
+    jobId?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Push token event for Live Activity updates
+ */
+interface LiveActivityPushTokenEvent {
+    /** Job ID */
+    jobId: string;
+    /** APNs push token */
+    token: string;
+}
+/**
+ * SDK version info
+ */
+declare const SDK_VERSION = "0.1.0";
+/**
+ * Minimum API version required
+ */
+declare const MIN_API_VERSION = "1.0.0";
+/**
+ * SSE protocol version
+ */
+declare const SSE_PROTOCOL_VERSION = "1.0";
+
+export { type ChildJobSummary, type ChildProgressMode, type ChildrenStats, type CompleteJobParams, type ConnectionState, type CreateJobParams, type EtaStats, type FailJobParams, type InAppMessage, type InAppMessageType, type JobError, type JobResult, type JobStatus, type LiveActivityEndParams, type LiveActivityPushTokenEvent, type LiveActivityResult, type LiveActivityStartParams, type LiveActivityUpdateParams, MIN_API_VERSION, type ParentInfo, type ParentWithChildren, type QueueInfo, SDK_VERSION, type SSEEvent, type SSEEventType, SSE_PROTOCOL_VERSION, type SeennConfig, type SeennJob, type StageInfo, type UpdateJobParams, type WebhookEventType, type WebhookPayload };

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MIN_API_VERSION: () => MIN_API_VERSION,
+  SDK_VERSION: () => SDK_VERSION,
+  SSE_PROTOCOL_VERSION: () => SSE_PROTOCOL_VERSION
+});
+module.exports = __toCommonJS(index_exports);
+var SDK_VERSION = "0.1.0";
+var MIN_API_VERSION = "1.0.0";
+var SSE_PROTOCOL_VERSION = "1.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MIN_API_VERSION,
+  SDK_VERSION,
+  SSE_PROTOCOL_VERSION
+});
+/**
+ * @seenn/types - Shared TypeScript types for Seenn SDKs
+ *
+ * This package is the single source of truth for all Seenn type definitions.
+ * All SDK packages (react-native, node, flutter) should depend on this package.
+ *
+ * @version 0.1.0
+ * @license MIT
+ */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @seenn/types - Shared TypeScript types for Seenn SDKs\n *\n * This package is the single source of truth for all Seenn type definitions.\n * All SDK packages (react-native, node, flutter) should depend on this package.\n *\n * @version 0.1.0\n * @license MIT\n */\n\n// ============================================\n// Core Job Types\n// ============================================\n\n/**\n * Job status values\n */\nexport type JobStatus =\n  | 'pending'\n  | 'queued'\n  | 'running'\n  | 'completed'\n  | 'failed'\n  | 'cancelled';\n\n/**\n * How parent job progress is calculated from children\n */\nexport type ChildProgressMode = 'average' | 'weighted' | 'sequential';\n\n/**\n * Main job object returned by API and SSE\n */\nexport interface SeennJob {\n  /** Unique job identifier (ULID format) */\n  jobId: string;\n  /** User who owns this job */\n  userId: string;\n  /** Application ID */\n  appId: string;\n  /** Current job status */\n  status: JobStatus;\n  /** Human-readable job title */\n  title: string;\n  /** Job type for categorization */\n  jobType: string;\n  /** Workflow ID for ETA tracking (default: jobType) */\n  workflowId?: string;\n  /** Progress percentage (0-100) */\n  progress: number;\n  /** Current status message */\n  message?: string;\n  /** Stage information for multi-step jobs */\n  stage?: StageInfo;\n  /** Estimated completion timestamp (ISO 8601) */\n  estimatedCompletionAt?: string;\n  /** ETA confidence score (0.0 - 1.0) */\n  etaConfidence?: number;\n  /** Number of historical jobs used to calculate ETA */\n  etaBasedOn?: number;\n  /** Queue position info */\n  queue?: QueueInfo;\n  /** Job result on completion */\n  result?: JobResult;\n  /** Error details on failure */\n  error?: JobError;\n  /** Custom metadata */\n  metadata?: Record<string, unknown>;\n  /** Parent info (if this is a child job) */\n  parent?: ParentInfo;\n  /** Children stats (if this is a parent job) */\n  children?: ChildrenStats;\n  /** Progress calculation mode for parent jobs */\n  childProgressMode?: ChildProgressMode;\n  /** Job creation timestamp (ISO 8601) */\n  createdAt: string;\n  /** Last update timestamp (ISO 8601) */\n  updatedAt: string;\n  /** When the job started running (ISO 8601) */\n  startedAt?: string;\n  /** Job completion timestamp (ISO 8601) */\n  completedAt?: string;\n}\n\n// ============================================\n// Stage & Queue Types\n// ============================================\n\n/**\n * Stage information for multi-step jobs\n */\nexport interface StageInfo {\n  /** Current stage name */\n  name: string;\n  /** Current stage index (1-based) */\n  current: number;\n  /** Total number of stages */\n  total: number;\n  /** Optional stage description */\n  description?: string;\n}\n\n/**\n * Queue position information\n */\nexport interface QueueInfo {\n  /** Position in queue (1-based) */\n  position: number;\n  /** Total items in queue */\n  total?: number;\n  /** Queue name/identifier */\n  queueName?: string;\n}\n\n// ============================================\n// Result & Error Types\n// ============================================\n\n/**\n * Job result on successful completion\n */\nexport interface JobResult {\n  /** Result type (e.g., 'video', 'image', 'file') */\n  type?: string;\n  /** Result URL if applicable */\n  url?: string;\n  /** Additional result data */\n  data?: Record<string, unknown>;\n}\n\n/**\n * Error details on job failure\n */\nexport interface JobError {\n  /** Error code for programmatic handling */\n  code: string;\n  /** Human-readable error message */\n  message: string;\n  /** Additional error details */\n  details?: Record<string, unknown>;\n}\n\n// ============================================\n// Parent-Child Types\n// ============================================\n\n/**\n * Parent info for child jobs\n */\nexport interface ParentInfo {\n  /** Parent job ID */\n  parentJobId: string;\n  /** Child index within parent (0-based) */\n  childIndex: number;\n}\n\n/**\n * Children stats for parent jobs\n */\nexport interface ChildrenStats {\n  /** Total number of children */\n  total: number;\n  /** Number of completed children */\n  completed: number;\n  /** Number of failed children */\n  failed: number;\n  /** Number of running children */\n  running: number;\n  /** Number of pending children */\n  pending: number;\n}\n\n/**\n * Summary of a child job (used in parent.children array)\n */\nexport interface ChildJobSummary {\n  /** Child job ID */\n  id: string;\n  /** Child index within parent (0-based) */\n  childIndex: number;\n  /** Child job title */\n  title: string;\n  /** Child job status */\n  status: JobStatus;\n  /** Child progress (0-100) */\n  progress: number;\n  /** Child status message */\n  message?: string;\n  /** Child result */\n  result?: JobResult;\n  /** Child error */\n  error?: JobError;\n  /** Child creation timestamp */\n  createdAt: string;\n  /** Child last update timestamp */\n  updatedAt: string;\n  /** Child completion timestamp */\n  completedAt?: string;\n}\n\n/**\n * Parent job with all its children\n */\nexport interface ParentWithChildren {\n  /** Parent job */\n  parent: SeennJob;\n  /** List of child jobs */\n  children: ChildJobSummary[];\n}\n\n// ============================================\n// SSE Types\n// ============================================\n\n/**\n * Connection state for SSE\n */\nexport type ConnectionState =\n  | 'disconnected'\n  | 'connecting'\n  | 'connected'\n  | 'reconnecting';\n\n/**\n * SSE event types\n */\nexport type SSEEventType =\n  | 'connected'\n  | 'job.sync'\n  | 'job.started'\n  | 'job.progress'\n  | 'job.completed'\n  | 'job.failed'\n  | 'job.cancelled'\n  | 'child.progress'\n  | 'parent.updated'\n  | 'in_app_message'\n  | 'connection.idle'\n  | 'heartbeat'\n  | 'error';\n\n/**\n * SSE event wrapper\n */\nexport interface SSEEvent {\n  /** Event type */\n  event: SSEEventType;\n  /** Event data */\n  data: unknown;\n  /** Event ID for replay */\n  id?: string;\n}\n\n// ============================================\n// In-App Message Types\n// ============================================\n\n/**\n * In-app message types\n */\nexport type InAppMessageType =\n  | 'job_complete_banner'\n  | 'job_failed_modal'\n  | 'job_toast';\n\n/**\n * In-app message for UI notifications\n */\nexport interface InAppMessage {\n  /** Message ID */\n  messageId: string;\n  /** Message type */\n  type: InAppMessageType;\n  /** Associated job ID */\n  jobId: string;\n  /** Message title */\n  title: string;\n  /** Message body */\n  body?: string;\n  /** Call-to-action text */\n  cta?: string;\n  /** Call-to-action URL */\n  ctaUrl?: string;\n}\n\n// ============================================\n// API Types\n// ============================================\n\n/**\n * Create job request parameters\n */\nexport interface CreateJobParams {\n  /** User ID */\n  userId: string;\n  /** Job type */\n  jobType: string;\n  /** Job title */\n  title: string;\n  /** Workflow ID for ETA tracking (default: jobType) */\n  workflowId?: string;\n  /** Initial message */\n  message?: string;\n  /** Custom metadata */\n  metadata?: Record<string, unknown>;\n  /** Estimated duration in ms (for ETA default) */\n  estimatedDuration?: number;\n  /** Parent job ID (for child jobs) */\n  parentJobId?: string;\n  /** Child index (for child jobs) */\n  childIndex?: number;\n  /** Total children (for parent jobs) */\n  totalChildren?: number;\n  /** Child progress mode (for parent jobs) */\n  childProgressMode?: ChildProgressMode;\n}\n\n/**\n * Update job request parameters\n */\nexport interface UpdateJobParams {\n  /** New progress (0-100) */\n  progress?: number;\n  /** New message */\n  message?: string;\n  /** New stage info */\n  stage?: StageInfo;\n  /** Custom metadata to merge */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Complete job request parameters\n */\nexport interface CompleteJobParams {\n  /** Job result */\n  result?: JobResult;\n  /** Final message */\n  message?: string;\n}\n\n/**\n * Fail job request parameters\n */\nexport interface FailJobParams {\n  /** Error details */\n  error: JobError;\n}\n\n// ============================================\n// Webhook Types\n// ============================================\n\n/**\n * Webhook event types\n */\nexport type WebhookEventType =\n  | 'job.started'\n  | 'job.progress'\n  | 'job.completed'\n  | 'job.failed'\n  | 'job.cancelled';\n\n/**\n * Webhook payload\n */\nexport interface WebhookPayload {\n  /** Event type */\n  event: WebhookEventType;\n  /** Job data */\n  job: SeennJob;\n  /** Event timestamp (ISO 8601) */\n  timestamp: string;\n  /** Webhook delivery ID */\n  deliveryId: string;\n}\n\n// ============================================\n// ETA Types\n// ============================================\n\n/**\n * ETA statistics for a workflow/jobType\n */\nexport interface EtaStats {\n  /** ETA key (workflowId or jobType) */\n  etaKey: string;\n  /** Number of completed jobs */\n  count: number;\n  /** Average duration in ms */\n  avgDuration: number;\n  /** Minimum duration in ms */\n  minDuration: number;\n  /** Maximum duration in ms */\n  maxDuration: number;\n  /** Default duration if no history */\n  defaultDuration?: number;\n  /** Last updated timestamp */\n  lastUpdated: string;\n}\n\n// ============================================\n// SDK Configuration Types\n// ============================================\n\n/**\n * Base SDK configuration\n */\nexport interface SeennConfig {\n  /** API base URL */\n  baseUrl: string;\n  /** Authentication token (pk_* for client, sk_* for server) */\n  authToken?: string;\n  /** SSE endpoint URL (default: baseUrl + /v1/sse) */\n  sseUrl?: string;\n  /** Enable auto-reconnect (default: true) */\n  reconnect?: boolean;\n  /** Reconnect interval in ms (default: 1000) */\n  reconnectInterval?: number;\n  /** Max reconnect attempts (default: 10) */\n  maxReconnectAttempts?: number;\n  /** Enable debug logging (default: false) */\n  debug?: boolean;\n}\n\n// ============================================\n// Live Activity Types (iOS/Android)\n// ============================================\n\n/**\n * Live Activity start parameters\n */\nexport interface LiveActivityStartParams {\n  /** Job ID */\n  jobId: string;\n  /** Activity title */\n  title: string;\n  /** Job type for icon selection */\n  jobType?: string;\n  /** Initial progress (0-100) */\n  initialProgress?: number;\n  /** Initial message */\n  initialMessage?: string;\n}\n\n/**\n * Live Activity update parameters\n */\nexport interface LiveActivityUpdateParams {\n  /** Job ID */\n  jobId: string;\n  /** New progress (0-100) */\n  progress?: number;\n  /** New status */\n  status?: JobStatus;\n  /** New message */\n  message?: string;\n  /** Stage info */\n  stage?: StageInfo;\n  /** ETA timestamp (Unix ms) */\n  estimatedEndTime?: number;\n}\n\n/**\n * Live Activity end parameters\n */\nexport interface LiveActivityEndParams {\n  /** Job ID */\n  jobId: string;\n  /** Final status */\n  finalStatus?: JobStatus;\n  /** Final progress */\n  finalProgress?: number;\n  /** Final message */\n  message?: string;\n  /** Result URL */\n  resultUrl?: string;\n  /** Error message */\n  errorMessage?: string;\n  /** Dismiss after seconds (default: 300) */\n  dismissAfter?: number;\n}\n\n/**\n * Live Activity result\n */\nexport interface LiveActivityResult {\n  /** Success flag */\n  success: boolean;\n  /** Activity ID (platform-specific) */\n  activityId?: string;\n  /** Associated job ID */\n  jobId?: string;\n  /** Error message if failed */\n  error?: string;\n}\n\n/**\n * Push token event for Live Activity updates\n */\nexport interface LiveActivityPushTokenEvent {\n  /** Job ID */\n  jobId: string;\n  /** APNs push token */\n  token: string;\n}\n\n// ============================================\n// Version & Compatibility\n// ============================================\n\n/**\n * SDK version info\n */\nexport const SDK_VERSION = '0.1.0';\n\n/**\n * Minimum API version required\n */\nexport const MIN_API_VERSION = '1.0.0';\n\n/**\n * SSE protocol version\n */\nexport const SSE_PROTOCOL_VERSION = '1.0';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkgBO,IAAM,cAAc;AAKpB,IAAM,kBAAkB;AAKxB,IAAM,uBAAuB;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,19 @@
+// src/index.ts
+var SDK_VERSION = "0.1.0";
+var MIN_API_VERSION = "1.0.0";
+var SSE_PROTOCOL_VERSION = "1.0";
+export {
+  MIN_API_VERSION,
+  SDK_VERSION,
+  SSE_PROTOCOL_VERSION
+};
+/**
+ * @seenn/types - Shared TypeScript types for Seenn SDKs
+ *
+ * This package is the single source of truth for all Seenn type definitions.
+ * All SDK packages (react-native, node, flutter) should depend on this package.
+ *
+ * @version 0.1.0
+ * @license MIT
+ */
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @seenn/types - Shared TypeScript types for Seenn SDKs\n *\n * This package is the single source of truth for all Seenn type definitions.\n * All SDK packages (react-native, node, flutter) should depend on this package.\n *\n * @version 0.1.0\n * @license MIT\n */\n\n// ============================================\n// Core Job Types\n// ============================================\n\n/**\n * Job status values\n */\nexport type JobStatus =\n  | 'pending'\n  | 'queued'\n  | 'running'\n  | 'completed'\n  | 'failed'\n  | 'cancelled';\n\n/**\n * How parent job progress is calculated from children\n */\nexport type ChildProgressMode = 'average' | 'weighted' | 'sequential';\n\n/**\n * Main job object returned by API and SSE\n */\nexport interface SeennJob {\n  /** Unique job identifier (ULID format) */\n  jobId: string;\n  /** User who owns this job */\n  userId: string;\n  /** Application ID */\n  appId: string;\n  /** Current job status */\n  status: JobStatus;\n  /** Human-readable job title */\n  title: string;\n  /** Job type for categorization */\n  jobType: string;\n  /** Workflow ID for ETA tracking (default: jobType) */\n  workflowId?: string;\n  /** Progress percentage (0-100) */\n  progress: number;\n  /** Current status message */\n  message?: string;\n  /** Stage information for multi-step jobs */\n  stage?: StageInfo;\n  /** Estimated completion timestamp (ISO 8601) */\n  estimatedCompletionAt?: string;\n  /** ETA confidence score (0.0 - 1.0) */\n  etaConfidence?: number;\n  /** Number of historical jobs used to calculate ETA */\n  etaBasedOn?: number;\n  /** Queue position info */\n  queue?: QueueInfo;\n  /** Job result on completion */\n  result?: JobResult;\n  /** Error details on failure */\n  error?: JobError;\n  /** Custom metadata */\n  metadata?: Record<string, unknown>;\n  /** Parent info (if this is a child job) */\n  parent?: ParentInfo;\n  /** Children stats (if this is a parent job) */\n  children?: ChildrenStats;\n  /** Progress calculation mode for parent jobs */\n  childProgressMode?: ChildProgressMode;\n  /** Job creation timestamp (ISO 8601) */\n  createdAt: string;\n  /** Last update timestamp (ISO 8601) */\n  updatedAt: string;\n  /** When the job started running (ISO 8601) */\n  startedAt?: string;\n  /** Job completion timestamp (ISO 8601) */\n  completedAt?: string;\n}\n\n// ============================================\n// Stage & Queue Types\n// ============================================\n\n/**\n * Stage information for multi-step jobs\n */\nexport interface StageInfo {\n  /** Current stage name */\n  name: string;\n  /** Current stage index (1-based) */\n  current: number;\n  /** Total number of stages */\n  total: number;\n  /** Optional stage description */\n  description?: string;\n}\n\n/**\n * Queue position information\n */\nexport interface QueueInfo {\n  /** Position in queue (1-based) */\n  position: number;\n  /** Total items in queue */\n  total?: number;\n  /** Queue name/identifier */\n  queueName?: string;\n}\n\n// ============================================\n// Result & Error Types\n// ============================================\n\n/**\n * Job result on successful completion\n */\nexport interface JobResult {\n  /** Result type (e.g., 'video', 'image', 'file') */\n  type?: string;\n  /** Result URL if applicable */\n  url?: string;\n  /** Additional result data */\n  data?: Record<string, unknown>;\n}\n\n/**\n * Error details on job failure\n */\nexport interface JobError {\n  /** Error code for programmatic handling */\n  code: string;\n  /** Human-readable error message */\n  message: string;\n  /** Additional error details */\n  details?: Record<string, unknown>;\n}\n\n// ============================================\n// Parent-Child Types\n// ============================================\n\n/**\n * Parent info for child jobs\n */\nexport interface ParentInfo {\n  /** Parent job ID */\n  parentJobId: string;\n  /** Child index within parent (0-based) */\n  childIndex: number;\n}\n\n/**\n * Children stats for parent jobs\n */\nexport interface ChildrenStats {\n  /** Total number of children */\n  total: number;\n  /** Number of completed children */\n  completed: number;\n  /** Number of failed children */\n  failed: number;\n  /** Number of running children */\n  running: number;\n  /** Number of pending children */\n  pending: number;\n}\n\n/**\n * Summary of a child job (used in parent.children array)\n */\nexport interface ChildJobSummary {\n  /** Child job ID */\n  id: string;\n  /** Child index within parent (0-based) */\n  childIndex: number;\n  /** Child job title */\n  title: string;\n  /** Child job status */\n  status: JobStatus;\n  /** Child progress (0-100) */\n  progress: number;\n  /** Child status message */\n  message?: string;\n  /** Child result */\n  result?: JobResult;\n  /** Child error */\n  error?: JobError;\n  /** Child creation timestamp */\n  createdAt: string;\n  /** Child last update timestamp */\n  updatedAt: string;\n  /** Child completion timestamp */\n  completedAt?: string;\n}\n\n/**\n * Parent job with all its children\n */\nexport interface ParentWithChildren {\n  /** Parent job */\n  parent: SeennJob;\n  /** List of child jobs */\n  children: ChildJobSummary[];\n}\n\n// ============================================\n// SSE Types\n// ============================================\n\n/**\n * Connection state for SSE\n */\nexport type ConnectionState =\n  | 'disconnected'\n  | 'connecting'\n  | 'connected'\n  | 'reconnecting';\n\n/**\n * SSE event types\n */\nexport type SSEEventType =\n  | 'connected'\n  | 'job.sync'\n  | 'job.started'\n  | 'job.progress'\n  | 'job.completed'\n  | 'job.failed'\n  | 'job.cancelled'\n  | 'child.progress'\n  | 'parent.updated'\n  | 'in_app_message'\n  | 'connection.idle'\n  | 'heartbeat'\n  | 'error';\n\n/**\n * SSE event wrapper\n */\nexport interface SSEEvent {\n  /** Event type */\n  event: SSEEventType;\n  /** Event data */\n  data: unknown;\n  /** Event ID for replay */\n  id?: string;\n}\n\n// ============================================\n// In-App Message Types\n// ============================================\n\n/**\n * In-app message types\n */\nexport type InAppMessageType =\n  | 'job_complete_banner'\n  | 'job_failed_modal'\n  | 'job_toast';\n\n/**\n * In-app message for UI notifications\n */\nexport interface InAppMessage {\n  /** Message ID */\n  messageId: string;\n  /** Message type */\n  type: InAppMessageType;\n  /** Associated job ID */\n  jobId: string;\n  /** Message title */\n  title: string;\n  /** Message body */\n  body?: string;\n  /** Call-to-action text */\n  cta?: string;\n  /** Call-to-action URL */\n  ctaUrl?: string;\n}\n\n// ============================================\n// API Types\n// ============================================\n\n/**\n * Create job request parameters\n */\nexport interface CreateJobParams {\n  /** User ID */\n  userId: string;\n  /** Job type */\n  jobType: string;\n  /** Job title */\n  title: string;\n  /** Workflow ID for ETA tracking (default: jobType) */\n  workflowId?: string;\n  /** Initial message */\n  message?: string;\n  /** Custom metadata */\n  metadata?: Record<string, unknown>;\n  /** Estimated duration in ms (for ETA default) */\n  estimatedDuration?: number;\n  /** Parent job ID (for child jobs) */\n  parentJobId?: string;\n  /** Child index (for child jobs) */\n  childIndex?: number;\n  /** Total children (for parent jobs) */\n  totalChildren?: number;\n  /** Child progress mode (for parent jobs) */\n  childProgressMode?: ChildProgressMode;\n}\n\n/**\n * Update job request parameters\n */\nexport interface UpdateJobParams {\n  /** New progress (0-100) */\n  progress?: number;\n  /** New message */\n  message?: string;\n  /** New stage info */\n  stage?: StageInfo;\n  /** Custom metadata to merge */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Complete job request parameters\n */\nexport interface CompleteJobParams {\n  /** Job result */\n  result?: JobResult;\n  /** Final message */\n  message?: string;\n}\n\n/**\n * Fail job request parameters\n */\nexport interface FailJobParams {\n  /** Error details */\n  error: JobError;\n}\n\n// ============================================\n// Webhook Types\n// ============================================\n\n/**\n * Webhook event types\n */\nexport type WebhookEventType =\n  | 'job.started'\n  | 'job.progress'\n  | 'job.completed'\n  | 'job.failed'\n  | 'job.cancelled';\n\n/**\n * Webhook payload\n */\nexport interface WebhookPayload {\n  /** Event type */\n  event: WebhookEventType;\n  /** Job data */\n  job: SeennJob;\n  /** Event timestamp (ISO 8601) */\n  timestamp: string;\n  /** Webhook delivery ID */\n  deliveryId: string;\n}\n\n// ============================================\n// ETA Types\n// ============================================\n\n/**\n * ETA statistics for a workflow/jobType\n */\nexport interface EtaStats {\n  /** ETA key (workflowId or jobType) */\n  etaKey: string;\n  /** Number of completed jobs */\n  count: number;\n  /** Average duration in ms */\n  avgDuration: number;\n  /** Minimum duration in ms */\n  minDuration: number;\n  /** Maximum duration in ms */\n  maxDuration: number;\n  /** Default duration if no history */\n  defaultDuration?: number;\n  /** Last updated timestamp */\n  lastUpdated: string;\n}\n\n// ============================================\n// SDK Configuration Types\n// ============================================\n\n/**\n * Base SDK configuration\n */\nexport interface SeennConfig {\n  /** API base URL */\n  baseUrl: string;\n  /** Authentication token (pk_* for client, sk_* for server) */\n  authToken?: string;\n  /** SSE endpoint URL (default: baseUrl + /v1/sse) */\n  sseUrl?: string;\n  /** Enable auto-reconnect (default: true) */\n  reconnect?: boolean;\n  /** Reconnect interval in ms (default: 1000) */\n  reconnectInterval?: number;\n  /** Max reconnect attempts (default: 10) */\n  maxReconnectAttempts?: number;\n  /** Enable debug logging (default: false) */\n  debug?: boolean;\n}\n\n// ============================================\n// Live Activity Types (iOS/Android)\n// ============================================\n\n/**\n * Live Activity start parameters\n */\nexport interface LiveActivityStartParams {\n  /** Job ID */\n  jobId: string;\n  /** Activity title */\n  title: string;\n  /** Job type for icon selection */\n  jobType?: string;\n  /** Initial progress (0-100) */\n  initialProgress?: number;\n  /** Initial message */\n  initialMessage?: string;\n}\n\n/**\n * Live Activity update parameters\n */\nexport interface LiveActivityUpdateParams {\n  /** Job ID */\n  jobId: string;\n  /** New progress (0-100) */\n  progress?: number;\n  /** New status */\n  status?: JobStatus;\n  /** New message */\n  message?: string;\n  /** Stage info */\n  stage?: StageInfo;\n  /** ETA timestamp (Unix ms) */\n  estimatedEndTime?: number;\n}\n\n/**\n * Live Activity end parameters\n */\nexport interface LiveActivityEndParams {\n  /** Job ID */\n  jobId: string;\n  /** Final status */\n  finalStatus?: JobStatus;\n  /** Final progress */\n  finalProgress?: number;\n  /** Final message */\n  message?: string;\n  /** Result URL */\n  resultUrl?: string;\n  /** Error message */\n  errorMessage?: string;\n  /** Dismiss after seconds (default: 300) */\n  dismissAfter?: number;\n}\n\n/**\n * Live Activity result\n */\nexport interface LiveActivityResult {\n  /** Success flag */\n  success: boolean;\n  /** Activity ID (platform-specific) */\n  activityId?: string;\n  /** Associated job ID */\n  jobId?: string;\n  /** Error message if failed */\n  error?: string;\n}\n\n/**\n * Push token event for Live Activity updates\n */\nexport interface LiveActivityPushTokenEvent {\n  /** Job ID */\n  jobId: string;\n  /** APNs push token */\n  token: string;\n}\n\n// ============================================\n// Version & Compatibility\n// ============================================\n\n/**\n * SDK version info\n */\nexport const SDK_VERSION = '0.1.0';\n\n/**\n * Minimum API version required\n */\nexport const MIN_API_VERSION = '1.0.0';\n\n/**\n * SSE protocol version\n */\nexport const SSE_PROTOCOL_VERSION = '1.0';\n"],"mappings":";AAkgBO,IAAM,cAAc;AAKpB,IAAM,kBAAkB;AAKxB,IAAM,uBAAuB;","names":[]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@seenn/types",
+  "version": "0.1.0",
+  "description": "Shared TypeScript types for Seenn SDKs",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/seenn-io/types.git"
+  },
+  "homepage": "https://github.com/seenn-io/types#readme",
+  "author": "Seenn <hello@seenn.io>",
+  "keywords": [
+    "seenn",
+    "types",
+    "typescript",
+    "job-tracking"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false
+}