@stacksjs/types 0.70.88 → 0.70.91

package/dist/push.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Push Notification Configuration Types
+ * Supports APNs (Apple) and FCM (Firebase/Google)
+ */
+/**
+ * Apple Push Notification Service (APNs) configuration
+ */
+export declare interface APNsProviderConfig {
+  keyId: string
+  teamId: string
+  privateKey: string
+  bundleId: string
+  production?: boolean
+}
+/**
+ * Firebase Cloud Messaging (FCM) configuration
+ */
+export declare interface FCMProviderConfig {
+  projectId: string
+  clientEmail: string
+  privateKey: string
+}
+/**
+ * Push notification provider configuration
+ */
+export declare interface PushProviderOptions {
+  apns?: APNsProviderConfig
+  fcm?: FCMProviderConfig
+}
+/**
+ * Push notification options
+ */
+export declare interface PushOptions {
+  enabled: boolean
+  defaultProvider?: 'apns' | 'fcm'
+  providers: PushProviderOptions
+}
+// Legacy types for backwards compatibility
+export declare interface FCMPushNotificationOptions {
+  eventName: string
+  to: {
+    subscriberId: string
+  }
+  payload: {
+    deviceTokens: Array<string>
+    badge: boolean
+    clickAction: string
+    color: string
+    icon: string
+    sound: string
+  }
+}
+export declare interface ExpoPushNotificationOptions {
+  eventName: string
+  to: {
+    subscriberId: string
+  }
+  payload: {
+    to: string[]
+    data: object
+    title: string
+    body: string
+    ttl: number
+    expiration: number
+    priority: 'default' | 'normal' | 'high'
+    subtitle: string
+    sound: 'default' | null
+    badge: number
+    channelId: string
+    categoryId: string
+    mutableContent: boolean
+  }
+}
+/**
+ * Result from a push notification operation
+ */
+export declare interface PushResult {
+  success: boolean
+  provider: string
+  message: string
+  messageId?: string
+  data?: Record<string, any>
+}
+/**
+ * Push message structure
+ */
+export declare interface PushMessage {
+  to: string | string[]
+  title?: string
+  body: string
+  data?: Record<string, any>
+  badge?: number
+  sound?: 'default' | null
+  priority?: 'default' | 'normal' | 'high'
+}
+/**
+ * Push ticket from Expo
+ */
+export declare interface PushTicket {
+  id?: string
+  status: 'ok' | 'error'
+  message?: string
+  details?: Record<string, any>
+}
+/**
+ * Push notification configuration type
+ */
+export type PushConfig = Partial<PushOptions>;

package/dist/queue.d.ts

@@ -0,0 +1,312 @@
+import type { DeepPartial } from './utils';
+import type { JobOptions } from './cron-jobs';
+/**
+ * Queue presets for common configurations
+ */
+export declare const QueuePresets: {
+  /**
+   * Development preset - uses sync driver
+   */
+  development: {
+  default: 'sync';
+  connections: {
+  sync: {
+  driver: 'sync'
+}
+};
+  failed: {
+  driver: 'database';
+  table: 'failed_jobs'
+}
+};
+  /**
+   * Production preset - uses Redis with bun-queue
+   */
+  production: {
+  default: 'redis';
+  connections: {
+  redis: {
+  driver: 'redis';
+  prefix: 'stacks:queue';
+  concurrency: 5;
+  distributedLock: true;
+  metrics: {
+  enabled: true
+};
+  defaultDeadLetterOptions: {
+  enabled: true;
+  maxRetries: 3
+}
+}
+};
+  failed: {
+  driver: 'redis';
+  prefix: 'stacks:failed'
+};
+  worker: {
+  concurrency: 5;
+  shutdownTimeout: 30000
+}
+};
+  /**
+   * High performance preset - optimized for throughput
+   */
+  highPerformance: {
+  default: 'redis';
+  connections: {
+  redis: {
+  driver: 'redis';
+  prefix: 'stacks:queue';
+  concurrency: 20;
+  distributedLock: true;
+  metrics: {
+  enabled: true;
+  collectInterval: 5000
+};
+  horizontalScaling: {
+  enabled: true;
+  maxWorkersPerInstance: 20;
+  jobsPerWorker: 50
+};
+  defaultDeadLetterOptions: {
+  enabled: true;
+  maxRetries: 5
+}
+}
+};
+  failed: {
+  driver: 'redis';
+  prefix: 'stacks:failed'
+};
+  worker: {
+  concurrency: 20;
+  shutdownTimeout: 60000
+}
+};
+  /**
+   * Database preset - uses database driver
+   */
+  database: {
+  default: 'database';
+  connections: {
+  database: {
+  driver: 'database';
+  table: 'jobs';
+  queue: 'default';
+  retryAfter: 90
+}
+};
+  failed: {
+  driver: 'database';
+  table: 'failed_jobs'
+}
+}
+};
+/**
+ * Rate limiter configuration
+ */
+export declare interface QueueRateLimiter {
+  max: number
+  duration: number
+  keyPrefix?: string | ((_data: any) => string)
+}
+/**
+ * Backoff configuration for job retries
+ */
+export declare interface QueueBackoff {
+  type: 'fixed' | 'exponential'
+  delay: number
+}
+/**
+ * Dead letter queue configuration
+ */
+export declare interface DeadLetterQueueConfig {
+  enabled?: boolean
+  queueSuffix?: string
+  maxRetries?: number
+  processFailed?: boolean
+  removeFromOriginalQueue?: boolean
+}
+/**
+ * Horizontal scaling configuration
+ */
+export declare interface HorizontalScalingConfig {
+  enabled?: boolean
+  instanceId?: string
+  maxWorkersPerInstance?: number
+  jobsPerWorker?: number
+  leaderElection?: {
+    heartbeatInterval?: number
+    leaderTimeout?: number
+  }
+  workCoordination?: {
+    pollInterval?: number
+    keyPrefix?: string
+  }
+}
+/**
+ * Metrics configuration
+ */
+export declare interface QueueMetricsConfig {
+  enabled: boolean
+  collectInterval?: number
+}
+/**
+ * Redis connection configuration for queue
+ */
+export declare interface QueueRedisConfig {
+  url?: string
+  host?: string
+  port?: number
+  password?: string
+  db?: number
+  prefix?: string
+}
+/**
+ * Job options for queue operations
+ */
+export declare interface QueueJobOptions {
+  delay?: number
+  attempts?: number
+  backoff?: QueueBackoff
+  removeOnComplete?: boolean | number
+  removeOnFail?: boolean | number
+  priority?: number
+  lifo?: boolean
+  timeout?: number
+  jobId?: string
+  dependsOn?: string | string[]
+  keepJobs?: boolean
+  deadLetter?: boolean | DeadLetterQueueConfig
+  repeat?: {
+    every?: number
+    limit?: number
+    cron?: string
+    tz?: string
+    startDate?: Date | number
+    endDate?: Date | number
+  }
+}
+/**
+ * Redis driver connection configuration
+ */
+export declare interface RedisConnectionConfig {
+  driver: 'redis'
+  redis?: QueueRedisConfig
+  prefix?: string
+  defaultJobOptions?: QueueJobOptions
+  limiter?: QueueRateLimiter
+  metrics?: QueueMetricsConfig
+  stalledJobCheckInterval?: number
+  maxStalledJobRetries?: number
+  distributedLock?: boolean
+  defaultDeadLetterOptions?: DeadLetterQueueConfig
+  horizontalScaling?: HorizontalScalingConfig
+  logLevel?: QueueLogLevel
+  concurrency?: number
+}
+/**
+ * Database driver connection configuration
+ */
+export declare interface DatabaseConnectionConfig {
+  driver: 'database'
+  table?: string
+  queue?: string
+  retryAfter?: number
+}
+/**
+ * SQS driver connection configuration
+ */
+export declare interface SqsConnectionConfig {
+  driver: 'sqs'
+  key?: string
+  secret?: string
+  prefix?: string
+  suffix?: string
+  queue?: string
+  region?: string
+}
+/**
+ * Sync driver connection configuration
+ */
+export declare interface SyncConnectionConfig {
+  driver: 'sync'
+}
+/**
+ * Memory driver connection configuration
+ */
+export declare interface MemoryConnectionConfig {
+  driver: 'memory'
+  maxSize?: number
+}
+export declare interface Dispatchable {
+  dispatch: () => Promise<void>
+  dispatchNow: () => Promise<void>
+  delay: (seconds: number) => this
+  afterResponse: () => this
+  chain: (jobs: Dispatchable[]) => this
+  onQueue: (queue: string) => this
+}
+export declare interface QueueOptions {
+  enabled?: boolean
+  env?: string[]
+  default: QueueDriver
+  connections: {
+    sync?: SyncConnectionConfig
+    database?: DatabaseConnectionConfig
+    redis?: RedisConnectionConfig
+    sqs?: SqsConnectionConfig
+    memory?: MemoryConnectionConfig
+    [key: string]: QueueConnectionConfig | undefined
+  }
+  failed: {
+    driver: 'database' | 'redis'
+    database?: string
+    table?: string
+    prefix?: string
+  }
+  batching?: {
+    driver: 'database' | 'redis'
+    table?: string
+    prefix?: string
+  }
+  worker?: {
+    concurrency?: number
+    shutdownTimeout?: number
+  }
+}
+// @ts-ignore - QueueOption extends JobOptions with compatible overrides
+export declare interface QueueOption extends JobOptions {
+  delay?: number
+  payload?: any
+  afterResponse?: any
+  context?: string
+  maxTries?: number
+  chainedJobs?: Dispatchable[]
+  queue?: string
+  priority?: number
+  backoff?: number[] | QueueBackoff
+  timeout?: number
+  immediate?: boolean
+}
+/**
+ * Queue driver type
+ */
+export type QueueDriver = 'sync' | 'database' | 'redis' | 'sqs' | 'memory';
+/**
+ * Job status
+ */
+export type JobStatus = 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused';
+/**
+ * Log level for queue operations
+ */
+export type QueueLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Queue connection configuration
+ */
+export type QueueConnectionConfig = | RedisConnectionConfig
+  | DatabaseConnectionConfig
+  | SqsConnectionConfig
+  | SyncConnectionConfig
+  | MemoryConnectionConfig;
+export type QueueConfig = DeepPartial<QueueOptions>;

package/dist/reactivity.d.ts

@@ -0,0 +1 @@
+export type { Ref } from '@stacksjs/stx';