@builderbot/manager 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @builderbot/manager
+ * Multi-tenant bot manager for BuilderBot
+ */
+export { BotManager } from './bot-manager';
+export { BotManagerApi } from './api';
+export { FlowRegistry, type FlowDefinition } from './flow-registry';
+export { RateLimiter, type RateLimiterConfig } from './rate-limiter';
+export { PersistenceManager, getDefaultPersistence, resetDefaultPersistence } from './persistence';
+export { createBotSchema, updateBotSchema, sendMessageSchema, restartBotSchema, createFlowSchema, updateFlowSchema, validate } from './schemas';
+export type { TenantConfig, BotInstance, BotManagerConfig, BotStatus, BotManagerEvent, BotManagerEventHandler, Flow, ProviderClass, DatabaseClass, ProviderFactory, DatabaseFactory, ReconnectState } from './types';
+export type { CreateBotInput, UpdateBotInput, SendMessageInput, RestartBotInput, CreateFlowInput, UpdateFlowInput, FlowStep, ValidationResult } from './schemas';
+export type { SerializableBotConfig, PersistenceConfig } from './persistence';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACT,MAAM,WAAW,CAAA;AAGlB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,sBAAsB,EACtB,IAAI,EACJ,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAA;AAGhB,YAAY,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,QAAQ,EACR,gBAAgB,EACjB,MAAM,WAAW,CAAA;AAGlB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,eAAe,CAAA"}

package/dist/persistence.d.ts

@@ -0,0 +1,90 @@
+import type { TenantConfig } from './types';
+/**
+ * Serializable bot configuration (without Flow objects)
+ */
+export interface SerializableBotConfig {
+    tenantId: string;
+    name?: string;
+    flowIds: string[];
+    port?: number;
+    providerOptions?: Record<string, any>;
+    databaseOptions?: Record<string, any>;
+    providerClassName?: string;
+    databaseClassName?: string;
+    createdAt: string;
+}
+/**
+ * Persistence configuration
+ */
+export interface PersistenceConfig {
+    /** Directory to store persistence files */
+    persistenceDir?: string;
+    /** File name for the persistence file */
+    fileName?: string;
+    /** Whether to auto-save on changes */
+    autoSave?: boolean;
+}
+/**
+ * Persistence manager for saving/loading bot configurations
+ */
+export declare class PersistenceManager {
+    private config;
+    private filePath;
+    private data;
+    constructor(config?: PersistenceConfig);
+    /**
+     * Save a bot configuration
+     */
+    save(tenantId: string, config: Omit<TenantConfig, 'flows'> & {
+        flowIds: string[];
+    }, providerClassName?: string, databaseClassName?: string): void;
+    /**
+     * Remove a bot configuration
+     */
+    remove(tenantId: string): boolean;
+    /**
+     * Get a bot configuration
+     */
+    get(tenantId: string): SerializableBotConfig | undefined;
+    /**
+     * Get all bot configurations
+     */
+    getAll(): SerializableBotConfig[];
+    /**
+     * Check if a bot configuration exists
+     */
+    has(tenantId: string): boolean;
+    /**
+     * Clear all configurations
+     */
+    clear(): void;
+    /**
+     * Get count of stored configurations
+     */
+    count(): number;
+    /**
+     * Persist data to file
+     */
+    persist(): void;
+    /**
+     * Load data from file
+     */
+    load(): void;
+    /**
+     * Delete the persistence file
+     */
+    deleteFile(): void;
+    /**
+     * Get the file path
+     */
+    getFilePath(): string;
+}
+/**
+ * Get or create the default persistence manager
+ */
+export declare function getDefaultPersistence(config?: PersistenceConfig): PersistenceManager;
+/**
+ * Reset the default persistence manager (useful for testing)
+ */
+export declare function resetDefaultPersistence(): void;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAQ,MAAM,SAAS,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,IAAI,CAAgD;gBAEhD,MAAM,GAAE,iBAAsB;IAU1C;;OAEG;IACH,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAC3D,iBAAiB,CAAC,EAAE,MAAM,EAC1B,iBAAiB,CAAC,EAAE,MAAM,GACzB,IAAI;IAoBP;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAUjC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAIxD;;OAEG;IACH,MAAM,IAAI,qBAAqB,EAAE;IAIjC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,OAAO,IAAI,IAAI;IAmBf;;OAEG;IACH,IAAI,IAAI,IAAI;IAkBZ;;OAEG;IACH,UAAU,IAAI,IAAI;IAWlB;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB;AAOD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,kBAAkB,CAKpF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/rate-limiter.d.ts

@@ -0,0 +1,65 @@
+import type { IncomingMessage, ServerResponse } from 'http';
+/**
+ * Rate limiter configuration
+ */
+export interface RateLimiterConfig {
+    /** Maximum number of requests per window */
+    maxRequests?: number;
+    /** Window size in milliseconds */
+    windowMs?: number;
+    /** Message to return when rate limited */
+    message?: string;
+    /** Skip rate limiting for certain paths */
+    skipPaths?: string[];
+    /** Custom key extractor (default: IP address) */
+    keyExtractor?: (req: IncomingMessage) => string;
+}
+/**
+ * Simple in-memory rate limiter
+ */
+export declare class RateLimiter {
+    private config;
+    private store;
+    private cleanupInterval;
+    constructor(config?: RateLimiterConfig);
+    /**
+     * Default key extractor - uses IP address
+     */
+    private defaultKeyExtractor;
+    /**
+     * Check if request should be rate limited
+     */
+    isRateLimited(req: IncomingMessage): {
+        limited: boolean;
+        remaining: number;
+        resetTime: number;
+    };
+    /**
+     * Create middleware function
+     */
+    middleware(): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
+    /**
+     * Reset rate limit for a specific key
+     */
+    reset(key: string): void;
+    /**
+     * Clear all rate limit data
+     */
+    clear(): void;
+    /**
+     * Cleanup expired entries
+     */
+    private cleanup;
+    /**
+     * Stop the cleanup interval
+     */
+    destroy(): void;
+    /**
+     * Get current stats
+     */
+    getStats(): {
+        activeKeys: number;
+        config: RateLimiterConfig;
+    };
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,iDAAiD;IACjD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAAA;CAChD;AAUD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,eAAe,CAA8C;gBAEzD,MAAM,GAAE,iBAAsB;IAa1C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IA8C/F;;OAEG;IACH,UAAU,KACA,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,IAAI;IAsBrE;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,QAAQ,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE;CAM9D"}

package/dist/schemas.d.ts

@@ -0,0 +1,213 @@
+import { z } from 'zod';
+/**
+ * Schema for creating a new bot
+ */
+export declare const createBotSchema: z.ZodObject<{
+    tenantId: z.ZodEffects<z.ZodString, string, string>;
+    name: z.ZodOptional<z.ZodString>;
+    flowIds: z.ZodArray<z.ZodString, "many">;
+    port: z.ZodOptional<z.ZodNumber>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    tenantId?: string;
+    name?: string;
+    flowIds?: string[];
+    port?: number;
+    providerOptions?: Record<string, any>;
+}, {
+    tenantId?: string;
+    name?: string;
+    flowIds?: string[];
+    port?: number;
+    providerOptions?: Record<string, any>;
+}>;
+/**
+ * Schema for updating a bot
+ */
+export declare const updateBotSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name?: string;
+}, {
+    name?: string;
+}>;
+/**
+ * Schema for sending a message
+ */
+export declare const sendMessageSchema: z.ZodObject<{
+    number: z.ZodString;
+    message: z.ZodString;
+    media: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    number?: string;
+    message?: string;
+    media?: string;
+}, {
+    number?: string;
+    message?: string;
+    media?: string;
+}>;
+/**
+ * Schema for restarting a bot
+ */
+export declare const restartBotSchema: z.ZodObject<{
+    flowIds: z.ZodArray<z.ZodString, "many">;
+    port: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name?: string;
+    flowIds?: string[];
+    port?: number;
+}, {
+    name?: string;
+    flowIds?: string[];
+    port?: number;
+}>;
+/**
+ * Flow step schema - defines a single step in the flow
+ */
+declare const flowStepSchema: z.ZodObject<{
+    /** The message to send */
+    answer: z.ZodString;
+    /** Optional delay before sending (ms) */
+    delay: z.ZodOptional<z.ZodNumber>;
+    /** Optional media URL to attach */
+    media: z.ZodOptional<z.ZodString>;
+    /** Whether to capture user response */
+    capture: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    media?: string;
+    answer?: string;
+    delay?: number;
+    capture?: boolean;
+}, {
+    media?: string;
+    answer?: string;
+    delay?: number;
+    capture?: boolean;
+}>;
+/**
+ * Schema for creating a dynamic flow
+ */
+export declare const createFlowSchema: z.ZodObject<{
+    /** Unique flow identifier */
+    id: z.ZodEffects<z.ZodString, string, string>;
+    /** Display name for the flow */
+    name: z.ZodString;
+    /** Keywords that trigger this flow */
+    keyword: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    /** Steps/answers in the flow */
+    steps: z.ZodArray<z.ZodObject<{
+        /** The message to send */
+        answer: z.ZodString;
+        /** Optional delay before sending (ms) */
+        delay: z.ZodOptional<z.ZodNumber>;
+        /** Optional media URL to attach */
+        media: z.ZodOptional<z.ZodString>;
+        /** Whether to capture user response */
+        capture: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        media?: string;
+        answer?: string;
+        delay?: number;
+        capture?: boolean;
+    }, {
+        media?: string;
+        answer?: string;
+        delay?: number;
+        capture?: boolean;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name?: string;
+    id?: string;
+    keyword?: string | string[];
+    steps?: {
+        media?: string;
+        answer?: string;
+        delay?: number;
+        capture?: boolean;
+    }[];
+}, {
+    name?: string;
+    id?: string;
+    keyword?: string | string[];
+    steps?: {
+        media?: string;
+        answer?: string;
+        delay?: number;
+        capture?: boolean;
+    }[];
+}>;
+/**
+ * Schema for updating a flow
+ */
+export declare const updateFlowSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** The message to send */
+        answer: z.ZodString;
+        /** Optional delay before sending (ms) */
+        delay: z.ZodOptional<z.ZodNumber>;
+        /** Optional media URL to attach */
+        media: z.ZodOptional<z.ZodString>;
+        /** Whether to capture user response */
+        capture: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        media?: string;
+        answer?: string;
+        delay?: number;
+        capture?: boolean;
+    }, {
+        media?: string;
+        answer?: string;
+        delay?: number;
+        capture?: boolean;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name?: string;
+    keyword?: string | string[];
+    steps?: {
+        media?: string;
+        answer?: string;
+        delay?: number;
+        capture?: boolean;
+    }[];
+}, {
+    name?: string;
+    keyword?: string | string[];
+    steps?: {
+        media?: string;
+        answer?: string;
+        delay?: number;
+        capture?: boolean;
+    }[];
+}>;
+/**
+ * Type exports inferred from schemas
+ */
+export type CreateBotInput = z.infer<typeof createBotSchema>;
+export type UpdateBotInput = z.infer<typeof updateBotSchema>;
+export type SendMessageInput = z.infer<typeof sendMessageSchema>;
+export type RestartBotInput = z.infer<typeof restartBotSchema>;
+export type CreateFlowInput = z.infer<typeof createFlowSchema>;
+export type UpdateFlowInput = z.infer<typeof updateFlowSchema>;
+export type FlowStep = z.infer<typeof flowStepSchema>;
+/**
+ * Validation result type
+ */
+export interface ValidationResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    errors?: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+/**
+ * Validate data against a Zod schema
+ */
+export declare function validate<T>(schema: z.ZodSchema<T>, data: unknown): ValidationResult<T>;
+export {};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAoBvB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAiB1B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;EAM1B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAc5B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAe3B,CAAA;AAOF;;GAEG;AACH,QAAA,MAAM,cAAc;IAClB,0BAA0B;;IAE1B,yCAAyC;;IAEzC,mCAAmC;;IAEnC,uCAAuC;;;;;;;;;;;;EAEvC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,6BAA6B;;IAU7B,gCAAgC;;IAEhC,sCAAsC;;IAKtC,gCAAgC;;QA/BhC,0BAA0B;;QAE1B,yCAAyC;;QAEzC,mCAAmC;;QAEnC,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BvC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;QAtC3B,0BAA0B;;QAE1B,yCAAyC;;QAEzC,mCAAmC;;QAEnC,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCvC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,CAAC,CAAA;IACR,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAoBtF"}