@hiliosai/sdk 0.1.12 → 0.1.15

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@hiliosai/sdk",
-  "version": "0.1.12",
+  "version": "0.1.15",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup",
     "format": "bunx prettier --write ./**/*.{ts,json}",

package/src/configs/constants.ts

@@ -1,135 +0,0 @@
-import env from '@ltv/env';
-
-/**
- * Base namespace for all channels
- */
-export const NAMESPACE = env.string('NAMESPACE', 'hios').toLowerCase();
-
-export const CHANNELS = {
-  // Webhook processing channels
-  WEBHOOK: {
-    // Pattern: hios.webhook.{tenantId}.{platform}
-    PATTERN: `${NAMESPACE}.webhook.*.*`,
-    PREFIX: `${NAMESPACE}.webhook`,
-    build: (tenantId: string, platform: string) =>
-      `${NAMESPACE}.webhook.${tenantId}.${platform}`,
-  },
-
-  // Message processing channels
-  PROCESSING: {
-    // Pattern: hios.processing.{tenantId}.{messageType}
-    PATTERN: `${NAMESPACE}.processing.*.*`,
-    PREFIX: `${NAMESPACE}.processing`,
-    build: (tenantId: string, messageType: string) =>
-      `${NAMESPACE}.processing.${tenantId}.${messageType}`,
-  },
-
-  // Response/outbound message channels
-  RESPONSE: {
-    // Pattern: hios.response.{tenantId}.{platform}
-    PATTERN: `${NAMESPACE}.response.*.*`,
-    PREFIX: `${NAMESPACE}.response`,
-    build: (tenantId: string, platform: string) =>
-      `${NAMESPACE}.response.${tenantId}.${platform}`,
-  },
-
-  // System channels
-  SYSTEM: {
-    // Error handling
-    ERRORS: `${NAMESPACE}.system.errors`,
-
-    // Metrics and monitoring
-    METRICS: `${NAMESPACE}.system.metrics`,
-
-    // Health checks
-    HEALTH: `${NAMESPACE}.system.health`,
-
-    // Integration lifecycle events
-    INTEGRATION_REGISTERED: `${NAMESPACE}.system.integration.registered`,
-    INTEGRATION_UNREGISTERED: `${NAMESPACE}.system.integration.unregistered`,
-  },
-
-  // Dead letter queues
-  DLQ: {
-    // Failed webhook processing
-    WEBHOOK_FAILED: `${NAMESPACE}.dlq.webhook.failed`,
-
-    // Failed message sends
-    SEND_FAILED: `${NAMESPACE}.dlq.send.failed`,
-
-    // Failed processing
-    PROCESSING_FAILED: `${NAMESPACE}.dlq.processing.failed`,
-
-    // Build DLQ name for specific integration
-    buildSendFailed: (platform: string) =>
-      `${NAMESPACE}.dlq.send.${platform}.failed`,
-  },
-} as const;
-
-/**
- * Integration-specific channel names
- */
-export const INTEGRATION_CHANNELS = {
-  // Message events
-  MESSAGE_RECEIVED: `${NAMESPACE}.processing.message.received`,
-  MESSAGE_SENT: `${NAMESPACE}.processing.message.sent`,
-  MESSAGE_FAILED: `${NAMESPACE}.processing.message.failed`,
-} as const;
-
-export type IntegrationChannelName =
-  (typeof INTEGRATION_CHANNELS)[keyof typeof INTEGRATION_CHANNELS];
-
-/**
- * Channel Configuration Constants
- */
-export const CHANNEL_CONFIG = {
-  // Default settings for message channels
-  DEFAULTS: {
-    maxInFlight: 10,
-    maxRetries: 3,
-    deadLettering: {
-      enabled: true,
-    },
-  },
-
-  // High-priority channels (webhooks)
-  HIGH_PRIORITY: {
-    maxInFlight: 50,
-    maxRetries: 5,
-    deadLettering: {
-      enabled: true,
-    },
-  },
-
-  // Low-priority channels (metrics, logs)
-  LOW_PRIORITY: {
-    maxInFlight: 5,
-    maxRetries: 1,
-    deadLettering: {
-      enabled: false,
-    },
-  },
-} as const;
-
-/**
- * Subject patterns for NATS JetStream
- */
-export const SUBJECTS = {
-  // All webhook subjects
-  WEBHOOK_ALL: `${NAMESPACE}.webhook.>`,
-
-  // All processing subjects
-  PROCESSING_ALL: `${NAMESPACE}.processing.>`,
-
-  // All response subjects
-  RESPONSE_ALL: `${NAMESPACE}.response.>`,
-
-  // All system subjects
-  SYSTEM_ALL: `${NAMESPACE}.system.>`,
-
-  // All DLQ subjects
-  DLQ_ALL: `${NAMESPACE}.dlq.>`,
-
-  // Wildcard for all HIOS subjects
-  ALL: `${NAMESPACE}.>`,
-} as const;

package/src/configs/index.ts

@@ -1,2 +0,0 @@
-export * from './permissions';
-export {default as moleculer} from './moleculer';

package/src/configs/moleculer/bulkhead.ts

@@ -1,8 +0,0 @@
-export const bulkheadConfig = {
-  // Enable feature.
-  enabled: false,
-  // Maximum concurrent executions.
-  concurrency: 10,
-  // Maximum size of queue
-  maxQueueSize: 100,
-};

package/src/configs/moleculer/channels.ts

@@ -1,102 +0,0 @@
-import env from '@ltv/env';
-import {Middleware as createChannelsMiddleware} from '@moleculer/channels';
-import {type Middleware} from 'moleculer';
-
-import {SUBJECTS, NAMESPACE as cfgNamespace} from '../constants';
-
-const NAMESPACE = cfgNamespace.toUpperCase();
-
-const middleware = createChannelsMiddleware({
-  adapter: {
-    type: 'NATS',
-    options: {
-      nats: {
-        url: env.string('NATS_URL', 'nats://localhost:4222'),
-
-        /** Connection options for reliability */
-        connectionOptions: {
-          name: 'hios',
-          timeout: 10000,
-          reconnect: true,
-          maxReconnectAttempts: 10,
-          reconnectTimeWait: 2000,
-          maxReconnectTimeWait: 30000,
-          pingInterval: 20000,
-          maxPingOut: 2,
-        },
-
-        /**
-         * Stream configuration for multi-tenant messaging
-         *
-         * Environment variables for production:
-         * - NATS_MAX_MESSAGES: Default 100K (dev) -> 10M+ (prod)
-         * - NATS_MAX_BYTES_GB: Default 1GB (dev) -> 100GB+ (prod)
-         * - NATS_MAX_AGE_DAYS: Default 7 (dev) -> 30+ (prod)
-         * - NATS_MAX_MSG_SIZE_MB: Default 1MB (dev) -> 5MB (prod)
-         * - NATS_REPLICAS: Default 1 (dev) -> 3 (prod)
-         */
-        streamConfig: {
-          name: `${NAMESPACE}_MESSAGES`,
-          subjects: [
-            SUBJECTS.WEBHOOK_ALL,
-            SUBJECTS.PROCESSING_ALL,
-            SUBJECTS.RESPONSE_ALL,
-            SUBJECTS.SYSTEM_ALL,
-            SUBJECTS.DLQ_ALL,
-          ],
-          retention: 'limits',
-          max_msgs: env.int('NATS_MAX_MESSAGES', 100_000), // 100K for dev, 10M+ for prod
-          max_bytes: env.int('NATS_MAX_BYTES_GB', 1) * 1024 * 1024 * 1024, // 1GB for dev, 100GB+ for prod
-          max_age: env.int('NATS_MAX_AGE_DAYS', 7) * 24 * 60 * 60 * 1000000000, // 7 days dev, 30+ days prod
-          max_msg_size: env.int('NATS_MAX_MSG_SIZE_MB', 1) * 1024 * 1024, // 1MB dev, 5MB prod
-          storage: 'file', // Persistent storage
-          num_replicas: env.int('NATS_REPLICAS', 1), // 1 for dev, 3 for prod
-          discard: 'old', // Remove old messages when limits hit
-          duplicate_window: 2 * 60 * 1000000000, // 2 minutes dedup window
-        },
-
-        /** Consumer options optimized for LLM processing */
-        consumerOptions: {
-          config: {
-            // Start with new messages (don't replay old ones on restart)
-            deliver_policy: 'new',
-
-            // Explicit acknowledgment required (critical for LLM processing)
-            ack_policy: 'explicit',
-
-            // Allow 5 unacknowledged messages per consumer (rate limiting)
-            max_ack_pending: 5,
-
-            // Acknowledgment timeout for LLM processing (2 minutes)
-            ack_wait: 120 * 1000000000, // 2 minutes in nanoseconds
-
-            // Maximum delivery attempts before dead letter
-            max_deliver: 3,
-
-            // Backoff for failed message retries
-            backoff: [
-              1000000000, // 1 second
-              5000000000, // 5 seconds
-              30000000000, // 30 seconds
-            ],
-          },
-        },
-      },
-
-      /** Application-level flow control */
-      maxInFlight: 5, // Limit concurrent LLM requests per service
-      maxRetries: 2, // App-level retries (NATS handles delivery retries)
-
-      /** Dead letter queue for failed messages */
-      deadLettering: {
-        enabled: true,
-        queueName: 'FAILED_MESSAGES',
-        // Send to dead letter after NATS max_deliver attempts
-      },
-    },
-  },
-}) as unknown as Middleware;
-
-export const ChannelsMiddleware: Middleware = {
-  ...middleware,
-};

package/src/configs/moleculer/circuit-breaker.ts

@@ -1,17 +0,0 @@
-import type {Errors} from 'moleculer';
-
-export const circuitBreakerConfig = {
-  // Enable feature
-  enabled: false,
-  // Threshold value. 0.5 means that 50% should be failed for tripping.
-  threshold: 0.5,
-  // Minimum request count. Below it, CB does not trip.
-  minRequestCount: 20,
-  // Number of seconds for time window.
-  windowTime: 60,
-  // Number of milliseconds to switch from open to half-open state
-  halfOpenTime: 10 * 1000,
-  // A function to check failed requests.
-  check: (err: Errors.MoleculerError | Error) =>
-    (err as Errors.MoleculerError).code >= 500,
-};

package/src/configs/moleculer/index.ts

@@ -1,98 +0,0 @@
-import env from '@ltv/env';
-import type {BrokerOptions, Middleware} from 'moleculer';
-import os from 'os';
-
-import {
-  ContextHelpersMiddleware,
-  PermissionsMiddleware,
-} from '../../middlewares';
-import {bulkheadConfig} from './bulkhead';
-import {ChannelsMiddleware} from './channels';
-import {circuitBreakerConfig} from './circuit-breaker';
-import logger from './logger';
-import {metricsConfig} from './metrics';
-import {registryConfig} from './registry';
-import {retryPolicyConfig} from './retry-policy';
-import {tracingConfig} from './tracing';
-import {trackingConfig} from './tracking';
-
-const pkgNm = env.string('NAMESPACE', 'hios');
-
-const nodeID =
-  env.string('NODE_ID') ?? `${pkgNm}-${os.hostname()}-${process.pid}`;
-
-// Export default config for backward compatibility
-const configs: BrokerOptions = {
-  namespace: pkgNm,
-  nodeID,
-  metadata: {},
-  logger,
-  // Default log level for built-in console logger. It can be overwritten in logger options above.
-  // Available values: trace, debug, info, warn, error, fatal
-  logLevel: 'info',
-
-  cacher: env.string('REDIS_URL', 'Memory'),
-
-  // Define a serializer.
-  // Available values: "JSON", "Avro", "ProtoBuf", "MsgPack", "Notepack", "Thrift".
-  // More info: https://moleculer.services/docs/0.14/networking.html#Serialization
-  serializer: 'JSON',
-
-  // Number of milliseconds to wait before reject a request with a RequestTimeout error. Disabled: 0
-  requestTimeout: 10 * 1000,
-
-  // Retry policy settings. More info: https://moleculer.services/docs/0.14/fault-tolerance.html#Retry
-  retryPolicy: retryPolicyConfig,
-
-  // Limit of calling level. If it reaches the limit, broker will throw an MaxCallLevelError error. (Infinite loop protection)
-  maxCallLevel: 100,
-
-  // Number of seconds to send heartbeat packet to other nodes.
-  heartbeatInterval: 10,
-  // Number of seconds to wait before setting node to unavailable status.
-  heartbeatTimeout: 30,
-
-  // Cloning the params of context if enabled. High performance impact, use it with caution!
-  contextParamsCloning: false,
-
-  // Tracking requests and waiting for running requests before shuting down. More info: https://moleculer.services/docs/0.14/context.html#Context-tracking
-  tracking: trackingConfig,
-
-  // Disable built-in request & emit balancer. (Transporter must support it, as well.). More info: https://moleculer.services/docs/0.14/networking.html#Disabled-balancer
-  disableBalancer: false,
-
-  // Settings of Service Registry. More info: https://moleculer.services/docs/0.14/registry.html
-  registry: registryConfig,
-
-  // Settings of Circuit Breaker. More info: https://moleculer.services/docs/0.14/fault-tolerance.html#Circuit-Breaker
-  circuitBreaker: circuitBreakerConfig,
-
-  // Settings of bulkhead feature. More info: https://moleculer.services/docs/0.14/fault-tolerance.html#Bulkhead
-  bulkhead: bulkheadConfig,
-
-  // Enable action & event parameter validation. More info: https://moleculer.services/docs/0.14/validating.html
-  validator: 'Fastest',
-
-  // errorHandler: null,
-
-  transporter: env.string('TRANSPORTER_URL'),
-
-  // Enable/disable built-in metrics function. More info: https://moleculer.services/docs/0.14/metrics.html
-  metrics: metricsConfig,
-
-  // Enable built-in tracing function. More info: https://moleculer.services/docs/0.14/tracing.html
-  tracing: tracingConfig,
-
-  middlewares: [
-    ChannelsMiddleware,
-    PermissionsMiddleware as Middleware,
-    ContextHelpersMiddleware as Middleware,
-  ],
-};
-
-export const createConfig = (customConfig: BrokerOptions) => ({
-  ...configs,
-  ...customConfig,
-});
-
-export default configs;

package/src/configs/moleculer/logger.ts

@@ -1,17 +0,0 @@
-const loggerConfig = {
-  type: 'Console',
-  options: {
-    // Using colors on the output
-    colors: true,
-    // Print module names with different colors (like docker-compose for containers)
-    moduleColors: false,
-    // Line formatter. It can be "json", "short", "simple", "full", a `Function` or a template string like "{timestamp} {level} {nodeID}/{mod}: {msg}"
-    formatter: 'full',
-    // Custom object printer. If not defined, it uses the `util.inspect` method.
-    objectPrinter: null,
-    // Auto-padding the module name in order to messages begin at the same column.
-    autoPadding: false,
-  },
-};
-
-export default loggerConfig;

package/src/configs/moleculer/metrics.ts

@@ -1,20 +0,0 @@
-import type {MetricRegistry} from 'moleculer';
-
-export const metricsConfig = {
-  enabled: false,
-  // Available built-in reporters: "Console", "CSV", "Event", "Prometheus", "Datadog", "StatsD"
-  reporter: {
-    type: 'Prometheus',
-    options: {
-      // HTTP port
-      port: 3030,
-      // HTTP URL path
-      path: '/metrics',
-      // Default labels which are appended to all metrics labels
-      defaultLabels: (registry: MetricRegistry) => ({
-        namespace: registry.broker.namespace,
-        nodeID: registry.broker.nodeID,
-      }),
-    },
-  },
-};

package/src/configs/moleculer/registry.ts

@@ -1,7 +0,0 @@
-export const registryConfig = {
-  // Define balancing strategy. More info: https://moleculer.services/docs/0.14/balancing.html
-  // Available values: "RoundRobin", "Random", "CpuUsage", "Latency", "Shard"
-  strategy: 'RoundRobin',
-  // Enable local action call preferring. Always call the local action instance if available.
-  preferLocal: true,
-};

package/src/configs/moleculer/retry-policy.ts

@@ -1,17 +0,0 @@
-import type {Errors} from 'moleculer';
-
-export const retryPolicyConfig = {
-  // Enable feature
-  enabled: false,
-  // Count of retries
-  retries: 5,
-  // First delay in milliseconds.
-  delay: 100,
-  // Maximum delay in milliseconds.
-  maxDelay: 1000,
-  // Backoff factor for delay. 2 means exponential backoff.
-  factor: 2,
-  // A function to check failed requests.
-  check: (err: Errors.MoleculerError | Error) =>
-    !!(err as Errors.MoleculerError).retryable,
-};

package/src/configs/moleculer/tracing.ts

@@ -1,6 +0,0 @@
-export const tracingConfig = {
-  enabled: true,
-  exporter: 'Console',
-  events: true,
-  stackTrace: true,
-};

package/src/configs/moleculer/tracking.ts

@@ -1,6 +0,0 @@
-export const trackingConfig = {
-  // Enable feature
-  enabled: false,
-  // Number of milliseconds to wait before shuting down the process.
-  shutdownTimeout: 5000,
-};

package/src/configs/permissions.ts

@@ -1,109 +0,0 @@
-// Permission constants
-export const PERMISSIONS = {
-  // Authentication required
-  AUTHENTICATED: 'authenticated',
-
-  // Role-based permissions
-  OWNER: 'OWNER',
-  ADMIN: 'ADMIN',
-  MANAGER: 'MANAGER',
-  AGENT: 'AGENT',
-  VIEWER: 'VIEWER',
-  DEVELOPER: 'DEVELOPER',
-
-  // Entity-specific permissions
-  TENANT_OWNER: 'tenant.owner',
-  TENANT_MEMBER: 'tenant.member',
-
-  // Resource permissions
-  'users.read': 'users.read',
-  'users.write': 'users.write',
-  'users.delete': 'users.delete',
-  'tenants.read': 'tenants.read',
-  'tenants.write': 'tenants.write',
-  'tenants.delete': 'tenants.delete',
-  'conversations.read': 'conversations.read',
-  'conversations.write': 'conversations.write',
-  'conversations.delete': 'conversations.delete',
-  'messages.read': 'messages.read',
-  'messages.write': 'messages.write',
-  'settings.read': 'settings.read',
-  'settings.write': 'settings.write',
-  'config.read': 'config.read',
-  'config.write': 'config.write',
-  'billing.read': 'billing.read',
-  'billing.write': 'billing.write',
-} as const;
-
-// Role hierarchy and permissions mapping
-export const ROLE_PERMISSIONS: Record<string, string[]> = {
-  [PERMISSIONS.OWNER]: [
-    PERMISSIONS.AUTHENTICATED,
-    PERMISSIONS['users.read'],
-    PERMISSIONS['users.write'],
-    PERMISSIONS['users.delete'],
-    PERMISSIONS['tenants.read'],
-    PERMISSIONS['tenants.write'],
-    PERMISSIONS['tenants.delete'],
-    PERMISSIONS['conversations.read'],
-    PERMISSIONS['conversations.write'],
-    PERMISSIONS['conversations.delete'],
-    PERMISSIONS['messages.read'],
-    PERMISSIONS['messages.write'],
-    PERMISSIONS['settings.read'],
-    PERMISSIONS['settings.write'],
-    PERMISSIONS['config.read'],
-    PERMISSIONS['config.write'],
-    PERMISSIONS['billing.read'],
-    PERMISSIONS['billing.write'],
-  ],
-  [PERMISSIONS.ADMIN]: [
-    PERMISSIONS.AUTHENTICATED,
-    PERMISSIONS['users.read'],
-    PERMISSIONS['users.write'],
-    PERMISSIONS['users.delete'],
-    PERMISSIONS['tenants.read'],
-    PERMISSIONS['tenants.write'],
-    PERMISSIONS['tenants.delete'],
-    PERMISSIONS['conversations.read'],
-    PERMISSIONS['conversations.write'],
-    PERMISSIONS['conversations.delete'],
-    PERMISSIONS['messages.read'],
-    PERMISSIONS['messages.write'],
-    PERMISSIONS['settings.read'],
-    PERMISSIONS['settings.write'],
-    PERMISSIONS['config.read'],
-    PERMISSIONS['config.write'],
-    PERMISSIONS['billing.read'],
-  ],
-  [PERMISSIONS.MANAGER]: [
-    PERMISSIONS.AUTHENTICATED,
-    PERMISSIONS['users.read'],
-    PERMISSIONS['users.write'],
-    PERMISSIONS['conversations.read'],
-    PERMISSIONS['conversations.write'],
-    PERMISSIONS['messages.read'],
-    PERMISSIONS['messages.write'],
-    PERMISSIONS['settings.read'],
-    PERMISSIONS['settings.write'],
-  ],
-  [PERMISSIONS.AGENT]: [
-    PERMISSIONS.AUTHENTICATED,
-    PERMISSIONS['conversations.read'],
-    PERMISSIONS['conversations.write'],
-    PERMISSIONS['messages.read'],
-    PERMISSIONS['messages.write'],
-  ],
-  [PERMISSIONS.VIEWER]: [
-    PERMISSIONS.AUTHENTICATED,
-    PERMISSIONS['conversations.read'],
-    PERMISSIONS['messages.read'],
-  ],
-  [PERMISSIONS.DEVELOPER]: [
-    PERMISSIONS.AUTHENTICATED,
-    // Only specific debug/development permissions, not full access
-    'system.debug',
-    'health.check',
-    PERMISSIONS['config.read'],
-  ],
-};

package/src/datasources/base.datasource.ts

@@ -1,111 +0,0 @@
-import type {ServiceBroker} from 'moleculer';
-
-import type {AppContext} from '../types/context';
-
-/**
- * Base datasource interface that all datasources should implement
- * Provides common structure and optional lifecycle methods
- */
-export interface BaseDatasource<TContext = AppContext> {
-  /**
-   * Datasource name for identification and logging
-   */
-  readonly name: string;
-
-  /**
-   * Service broker instance for logging, events, and service calls
-   * Always available after datasource initialization
-   */
-  broker: ServiceBroker;
-
-  /**
-   * Current service context (only available during action execution)
-   * Will be undefined in lifecycle hooks or background tasks
-   */
-  context?: TContext;
-
-  /**
-   * Optional initialization method
-   * Called when datasource is instantiated
-   */
-  init?(): Promise<void> | void;
-
-  /**
-   * Optional connection method
-   * Called when service starts if implemented
-   */
-  connect?(): Promise<void> | void;
-
-  /**
-   * Optional disconnection method
-   * Called when service stops if implemented
-   */
-  disconnect?(): Promise<void> | void;
-
-  /**
-   * Optional health check method
-   * Can be used to verify datasource is working correctly
-   */
-  healthCheck?(): Promise<boolean> | boolean;
-
-  /**
-   * Optional method to clear/reset the datasource
-   */
-  clear?(): Promise<void> | void;
-}
-
-/**
- * Abstract base class for datasources that provides default implementations
- * @example
- * ```typescript
- * export class UserDatasource extends AbstractDatasource {
- *   readonly name = 'users';
- *
- *   private users: User[] = [];
- *
- *   async findById(id: string): Promise<User | undefined> {
- *     this.broker?.logger.info('Finding user by ID:', id);
- *     return this.users.find(u => u.id === id);
- *   }
- *
- *   async healthCheck(): Promise<boolean> {
- *     this.broker?.logger.info('Health check for datasource', this.name);
- *     return true;
- *   }
- * }
- * ```
- */
-export abstract class AbstractDatasource<TContext = AppContext>
-  implements BaseDatasource<TContext>
-{
-  abstract readonly name: string;
-
-  /**
-   * Service broker instance - injected by mixin
-   * Always available after initialization
-   */
-  broker!: ServiceBroker; // Using definite assignment assertion since it's injected
-
-  /**
-   * Current service context - injected per action
-   * Only available during action execution
-   */
-  context?: TContext;
-
-  /**
-   * Default health check - always returns true
-   * Override for custom health check logic
-   */
-  async healthCheck(): Promise<boolean> {
-    this.broker.logger.info(`Health check for datasource - ${this.name}`);
-    return true;
-  }
-
-  /**
-   * Default clear method - does nothing
-   * Override to implement clearing logic
-   */
-  async clear(): Promise<void> {
-    // Default implementation - does nothing
-  }
-}