@seenn/types 0.2.0 → 0.2.1

package/dist/index.d.mts

@@ -318,8 +318,8 @@ type ConnectionMode = 'sse' | 'polling';
 interface SeennConfig {
     /** API base URL */
     baseUrl: string;
-    /** Authentication token (pk_* for client, sk_* for server) */
-    authToken?: string;
+    /** API key (pk_* for client SDKs, sk_* for server SDKs) */
+    apiKey?: string;
     /** SSE endpoint URL (default: baseUrl + /v1/sse) */
     sseUrl?: string;
     /** Connection mode: 'sse' (default) or 'polling' (for self-hosted) */

package/dist/index.d.ts

@@ -318,8 +318,8 @@ type ConnectionMode = 'sse' | 'polling';
 interface SeennConfig {
     /** API base URL */
     baseUrl: string;
-    /** Authentication token (pk_* for client, sk_* for server) */
-    authToken?: string;
+    /** API key (pk_* for client SDKs, sk_* for server SDKs) */
+    apiKey?: string;
     /** SSE endpoint URL (default: baseUrl + /v1/sse) */
     sseUrl?: string;
     /** Connection mode: 'sse' (default) or 'polling' (for self-hosted) */

package/dist/index.js.map

@@ -1 +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 * Connection mode for real-time updates\n */\nexport type ConnectionMode = 'sse' | 'polling';\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  /** Connection mode: 'sse' (default) or 'polling' (for self-hosted) */\n  mode?: ConnectionMode;\n  /** Polling interval in ms (default: 5000, only used when mode is 'polling') */\n  pollInterval?: number;\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.2.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;AA2gBO,IAAM,cAAc;AAKpB,IAAM,kBAAkB;AAKxB,IAAM,uBAAuB;","names":[]}
+{"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 * Connection mode for real-time updates\n */\nexport type ConnectionMode = 'sse' | 'polling';\n\n/**\n * Base SDK configuration\n */\nexport interface SeennConfig {\n  /** API base URL */\n  baseUrl: string;\n  /** API key (pk_* for client SDKs, sk_* for server SDKs) */\n  apiKey?: string;\n  /** SSE endpoint URL (default: baseUrl + /v1/sse) */\n  sseUrl?: string;\n  /** Connection mode: 'sse' (default) or 'polling' (for self-hosted) */\n  mode?: ConnectionMode;\n  /** Polling interval in ms (default: 5000, only used when mode is 'polling') */\n  pollInterval?: number;\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.2.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;AA2gBO,IAAM,cAAc;AAKpB,IAAM,kBAAkB;AAKxB,IAAM,uBAAuB;","names":[]}

package/dist/index.mjs.map

@@ -1 +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 * Connection mode for real-time updates\n */\nexport type ConnectionMode = 'sse' | 'polling';\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  /** Connection mode: 'sse' (default) or 'polling' (for self-hosted) */\n  mode?: ConnectionMode;\n  /** Polling interval in ms (default: 5000, only used when mode is 'polling') */\n  pollInterval?: number;\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.2.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":";AA2gBO,IAAM,cAAc;AAKpB,IAAM,kBAAkB;AAKxB,IAAM,uBAAuB;","names":[]}
+{"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 * Connection mode for real-time updates\n */\nexport type ConnectionMode = 'sse' | 'polling';\n\n/**\n * Base SDK configuration\n */\nexport interface SeennConfig {\n  /** API base URL */\n  baseUrl: string;\n  /** API key (pk_* for client SDKs, sk_* for server SDKs) */\n  apiKey?: string;\n  /** SSE endpoint URL (default: baseUrl + /v1/sse) */\n  sseUrl?: string;\n  /** Connection mode: 'sse' (default) or 'polling' (for self-hosted) */\n  mode?: ConnectionMode;\n  /** Polling interval in ms (default: 5000, only used when mode is 'polling') */\n  pollInterval?: number;\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.2.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":";AA2gBO,IAAM,cAAc;AAKpB,IAAM,kBAAkB;AAKxB,IAAM,uBAAuB;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seenn/types",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Shared TypeScript types for Seenn SDKs",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/index.ts

@@ -414,8 +414,8 @@ export type ConnectionMode = 'sse' | 'polling';
 export interface SeennConfig {
   /** API base URL */
   baseUrl: string;
-  /** Authentication token (pk_* for client, sk_* for server) */
-  authToken?: string;
+  /** API key (pk_* for client SDKs, sk_* for server SDKs) */
+  apiKey?: string;
   /** SSE endpoint URL (default: baseUrl + /v1/sse) */
   sseUrl?: string;
   /** Connection mode: 'sse' (default) or 'polling' (for self-hosted) */