telemeister 0.1.0

package/dist/core/builder.js

@@ -0,0 +1,195 @@
+/**
+ * State Builder - Fluent API for configuring a single state
+ *
+ * @template TState - Union type of all valid states
+ */
+class StateBuilder {
+    state;
+    handlers;
+    constructor(state, handlers) {
+        this.state = state;
+        this.handlers = handlers;
+    }
+    /**
+     * Set the onEnter handler for this state
+     * Called when the user enters this state
+     * Can optionally return a state name to immediately transition to
+     *
+     * Example:
+     *   .onEnter(async (ctx) => {
+     *     await ctx.send('Welcome!');
+     *     // Optionally transition immediately:
+     *     return 'anotherState';
+     *   })
+     */
+    onEnter(handler) {
+        const existing = this.handlers.get(this.state) || {};
+        existing.onEnter = handler;
+        this.handlers.set(this.state, existing);
+        return this;
+    }
+    /**
+     * Set the onResponse handler for this state
+     * Called when the user sends a message while in this state
+     *
+     * Example:
+     *   .onResponse(async (ctx, response) => {
+     *     if (response === 'yes') {
+     *       return 'confirmed';
+     *     }
+     *     return 'cancelled';
+     *   })
+     */
+    onResponse(handler) {
+        const existing = this.handlers.get(this.state) || {};
+        existing.onResponse = handler;
+        this.handlers.set(this.state, existing);
+        return this;
+    }
+}
+/**
+ * Multi-State Builder - Registers handlers for multiple states at once
+ *
+ * @template TState - Union type of all valid states
+ */
+class MultiStateBuilder {
+    states;
+    handlers;
+    constructor(states, handlers) {
+        this.states = states;
+        this.handlers = handlers;
+    }
+    onEnter(handler) {
+        for (const state of this.states) {
+            const existing = this.handlers.get(state) || {};
+            existing.onEnter = handler;
+            this.handlers.set(state, existing);
+        }
+        return this;
+    }
+    onResponse(handler) {
+        for (const state of this.states) {
+            const existing = this.handlers.get(state) || {};
+            existing.onResponse = handler;
+            this.handlers.set(state, existing);
+        }
+        return this;
+    }
+}
+/**
+ * Bot Builder - Main API for registering state handlers
+ *
+ * For type-safe state returns, define your states as a union type:
+ *
+ * @example
+ * ```typescript
+ * // Define your states
+ * type MyStates = 'idle' | 'welcome' | 'menu' | 'collectName';
+ *
+ * // Create typed builder
+ * const typedBuilder = botBuilder as BotBuilder<MyStates>;
+ *
+ * typedBuilder
+ *   .forState('welcome')
+ *   .onEnter(async (ctx) => {
+ *     await ctx.send('Welcome!');
+ *     return 'menu'; // ✅ Type-safe: only 'idle' | 'welcome' | 'menu' | 'collectName' allowed
+ *   })
+ *   .onResponse(async (ctx, response) => {
+ *     return 'collectName'; // ✅ Also type-safe
+ *   });
+ * ```
+ *
+ * @template TState - Union type of all valid states (defaults to string)
+ */
+export class BotBuilder {
+    handlers = new Map();
+    forState(state) {
+        if (Array.isArray(state)) {
+            return new MultiStateBuilder(state, this.handlers);
+        }
+        return new StateBuilder(state, this.handlers);
+    }
+    /**
+     * Register an onEnter handler for a state
+     * @param state - State name
+     * @param handler - Handler function
+     * @returns this for chaining
+     */
+    onEnter(state, handler) {
+        const existing = this.handlers.get(state) || {};
+        existing.onEnter = handler;
+        this.handlers.set(state, existing);
+        return this;
+    }
+    /**
+     * Register an onResponse handler for a state
+     * @param state - State name
+     * @param handler - Handler function
+     * @returns this for chaining
+     */
+    onResponse(state, handler) {
+        const existing = this.handlers.get(state) || {};
+        existing.onResponse = handler;
+        this.handlers.set(state, existing);
+        return this;
+    }
+    /**
+     * Execute the onEnter handler for a given state
+     * @internal Called by the bot handlers
+     * @returns The next state to transition to (if any), or void
+     */
+    async executeOnEnter(state, context) {
+        const handlers = this.handlers.get(state);
+        const handler = handlers?.onEnter;
+        if (handler) {
+            return await handler(context);
+        }
+    }
+    /**
+     * Execute the onResponse handler for a given state
+     * @internal Called by the bot handlers
+     * @returns The next state to transition to, or void
+     */
+    async executeOnResponse(state, context, response) {
+        const handlers = this.handlers.get(state);
+        const handler = handlers?.onResponse;
+        if (handler) {
+            return await handler(context, response);
+        }
+    }
+    /**
+     * Check if a state has an onEnter handler
+     */
+    hasOnEnter(state) {
+        return !!this.handlers.get(state)?.onEnter;
+    }
+    /**
+     * Check if a state has an onResponse handler
+     */
+    hasOnResponse(state) {
+        return !!this.handlers.get(state)?.onResponse;
+    }
+    /**
+     * Get all registered state names
+     */
+    getRegisteredStates() {
+        return Array.from(this.handlers.keys());
+    }
+    /**
+     * Get handlers for a specific state
+     */
+    getHandlers(state) {
+        return this.handlers.get(state);
+    }
+}
+/**
+ * Global bot builder instance (untyped - accepts any string state)
+ *
+ * For type safety, cast to BotBuilder<YourStateUnion>:
+ * ```typescript
+ * const typedBuilder = botBuilder as BotBuilder<'idle' | 'welcome' | 'menu'>;
+ * ```
+ */
+export const botBuilder = new BotBuilder();
+//# sourceMappingURL=builder.js.map

package/dist/core/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/core/builder.ts"],"names":[],"mappings":"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"}

package/dist/core/compact-machine.d.ts

@@ -0,0 +1,57 @@
+import type { BotContext, BotMachineInput } from './types.js';
+/**
+ * Compact XState Machine for Telemeister
+ *
+ * Uses the "states as data" pattern - a single state node handles
+ * all bot states. The actual state value is stored in context.currentState.
+ *
+ * Benefits:
+ * - No need to modify machine when adding new states
+ * - Compact, maintainable code
+ * - Builder pattern is the source of truth for valid states
+ * - Re-entry triggers onEnter handler for new states
+ */
+export declare const compactMachine: import("xstate").StateMachine<BotContext, {
+    type: "USER_MESSAGE";
+    message: string;
+} | {
+    type: "TRANSITION";
+    toState: string;
+} | {
+    type: "REENTER";
+}, {}, never, {
+    type: "updateState";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "persistState";
+    params: unknown;
+}, never, never, "active", string, BotMachineInput, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "telemeister-bot";
+    states: {
+        readonly active: {};
+    };
+}>;
+/**
+ * Create a new machine instance with the given initial state
+ */
+export declare function createBotMachine(_input: BotMachineInput): import("xstate").StateMachine<BotContext, {
+    type: "USER_MESSAGE";
+    message: string;
+} | {
+    type: "TRANSITION";
+    toState: string;
+} | {
+    type: "REENTER";
+}, {}, never, {
+    type: "updateState";
+    params: import("xstate").NonReducibleUnknown;
+} | {
+    type: "persistState";
+    params: unknown;
+}, never, never, "active", string, BotMachineInput, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "telemeister-bot";
+    states: {
+        readonly active: {};
+    };
+}>;
+//# sourceMappingURL=compact-machine.d.ts.map

package/dist/core/compact-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-machine.d.ts","sourceRoot":"","sources":["../../src/core/compact-machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAY,eAAe,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAqDzB,CAAC;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;GA0CvD"}

package/dist/core/compact-machine.js

@@ -0,0 +1,113 @@
+import { setup, assign } from 'xstate';
+/**
+ * Compact XState Machine for Telemeister
+ *
+ * Uses the "states as data" pattern - a single state node handles
+ * all bot states. The actual state value is stored in context.currentState.
+ *
+ * Benefits:
+ * - No need to modify machine when adding new states
+ * - Compact, maintainable code
+ * - Builder pattern is the source of truth for valid states
+ * - Re-entry triggers onEnter handler for new states
+ */
+export const compactMachine = setup({
+    types: {
+        context: {},
+        events: {},
+        input: {},
+    },
+    actions: {
+        /**
+         * Update the current state in context
+         */
+        updateState: assign({
+            currentState: ({ event }) => (event.type === 'TRANSITION' ? event.toState : ''),
+        }),
+        /**
+         * Persist state to database
+         * This is called as an action, but actual DB calls happen
+         * in the bot handlers to keep the machine pure.
+         */
+        persistState: ({ context }) => {
+            // The actual persistence is handled by the bot layer
+            // This action serves as a hook for inspection/logging
+            console.log(`[XState] State changed to: ${context.currentState}`);
+        },
+    },
+}).createMachine({
+    id: 'telemeister-bot',
+    initial: 'active',
+    context: ({ input: _input }) => ({
+        userId: _input.userId,
+        telegramId: _input.telegramId,
+        chatId: _input.chatId,
+        currentState: _input.currentState,
+        stateData: _input.stateData,
+    }),
+    states: {
+        active: {
+            entry: ['persistState'],
+            on: {
+                TRANSITION: {
+                    actions: ['updateState', 'persistState'],
+                    // Self-transition with reentry to trigger onEnter
+                    target: 'active',
+                    reenter: true,
+                },
+                REENTER: {
+                    // Re-enter current state (e.g., to re-trigger onEnter)
+                    target: 'active',
+                    reenter: true,
+                },
+            },
+        },
+    },
+});
+/**
+ * Create a new machine instance with the given initial state
+ */
+export function createBotMachine(_input) {
+    return setup({
+        types: {
+            context: {},
+            events: {},
+            input: {},
+        },
+        actions: {
+            updateState: assign({
+                currentState: ({ event }) => (event.type === 'TRANSITION' ? event.toState : ''),
+            }),
+            persistState: ({ context }) => {
+                console.log(`[XState] State changed to: ${context.currentState}`);
+            },
+        },
+    }).createMachine({
+        id: 'telemeister-bot',
+        initial: 'active',
+        context: ({ input }) => ({
+            userId: input.userId,
+            telegramId: input.telegramId,
+            chatId: input.chatId,
+            currentState: input.currentState,
+            stateData: input.stateData,
+        }),
+        states: {
+            active: {
+                entry: ['persistState'],
+                on: {
+                    TRANSITION: {
+                        actions: ['updateState', 'persistState'],
+                        target: 'active',
+                        reenter: true,
+                    },
+                    REENTER: {
+                        target: 'active',
+                        reenter: true,
+                    },
+                },
+            },
+        },
+    });
+}
+//# sourceMappingURL=compact-machine.js.map

package/dist/core/compact-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-machine.js","sourceRoot":"","sources":["../../src/core/compact-machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGvC;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;IAClC,KAAK,EAAE;QACL,OAAO,EAAE,EAAgB;QACzB,MAAM,EAAE,EAAc;QACtB,KAAK,EAAE,EAAqB;KAC7B;IACD,OAAO,EAAE;QACP;;WAEG;QACH,WAAW,EAAE,MAAM,CAAC;YAClB,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,CAAC;QAEF;;;;WAIG;QACH,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YAC5B,qDAAqD;YACrD,sDAAsD;YACtD,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACpE,CAAC;KACF;CACF,CAAC,CAAC,aAAa,CAAC;IACf,EAAE,EAAE,iBAAiB;IACrB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE;YACN,KAAK,EAAE,CAAC,cAAc,CAAC;YACvB,EAAE,EAAE;gBACF,UAAU,EAAE;oBACV,OAAO,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;oBACxC,kDAAkD;oBAClD,MAAM,EAAE,QAAQ;oBAChB,OAAO,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE;oBACP,uDAAuD;oBACvD,MAAM,EAAE,QAAQ;oBAChB,OAAO,EAAE,IAAI;iBACd;aACF;SACF;KACF;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO,KAAK,CAAC;QACX,KAAK,EAAE;YACL,OAAO,EAAE,EAAgB;YACzB,MAAM,EAAE,EAAc;YACtB,KAAK,EAAE,EAAqB;SAC7B;QACD,OAAO,EAAE;YACP,WAAW,EAAE,MAAM,CAAC;gBAClB,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;aAChF,CAAC;YACF,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;gBAC5B,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;YACpE,CAAC;SACF;KACF,CAAC,CAAC,aAAa,CAAC;QACf,EAAE,EAAE,iBAAiB;QACrB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACvB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;QACF,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,KAAK,EAAE,CAAC,cAAc,CAAC;gBACvB,EAAE,EAAE;oBACF,UAAU,EAAE;wBACV,OAAO,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;wBACxC,MAAM,EAAE,QAAQ;wBAChB,OAAO,EAAE,IAAI;qBACd;oBACD,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;wBAChB,OAAO,EAAE,IAAI;qBACd;iBACF;aACF;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Core module for Telemeister
+ *
+ * This module exports the centralized state types and typed builder.
+ * Import from here in your handlers for type safety.
+ */
+export { BotBuilder, botBuilder } from './builder.js';
+export type { AppStates } from '../bot-state-types.js';
+export type { StateTransitions } from '../bot-state-types.js';
+export { appBuilder } from './types.js';
+export type { AppContext } from './types.js';
+export type { BotHandlerContext, BotState, EnterHandler, ResponseHandler, StateHandlers, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEtD,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * Core module for Telemeister
+ *
+ * This module exports the centralized state types and typed builder.
+ * Import from here in your handlers for type safety.
+ */
+export { BotBuilder, botBuilder } from './builder.js';
+export { appBuilder } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAKtD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,47 @@
+import type { AppStates } from '../bot-state-types.js';
+import { BotBuilder } from './builder.js';
+export declare const appBuilder: BotBuilder<AppStates>;
+export type AppContext = BotHandlerContext<AppStates>;
+export type BotState = string;
+export interface BotHandlerContext<TState extends BotState = BotState> {
+    userId: number;
+    telegramId: number;
+    chatId: number;
+    currentState: TState;
+    send: (text: string) => Promise<unknown>;
+    setData: <T>(key: string, value: T) => void;
+    getData: <T>(key: string) => T | undefined;
+    transition: (toState: TState) => Promise<void>;
+}
+export type EnterHandler<TState extends BotState = BotState> = (context: BotHandlerContext<TState>) => Promise<TState | void>;
+export type ResponseHandler<TState extends BotState = BotState> = (context: BotHandlerContext<TState>, response: string) => Promise<TState | void>;
+export interface StateHandlers<TState extends BotState = BotState> {
+    onEnter?: EnterHandler<TState>;
+    onResponse?: ResponseHandler<TState>;
+}
+export type ExtractStates<T> = T extends StateHandlers<infer S> ? S : never;
+export interface BotContext {
+    userId: number;
+    telegramId: number;
+    chatId: number;
+    currentState: string;
+    stateData: Record<string, unknown>;
+}
+export type BotEvent = {
+    type: 'USER_MESSAGE';
+    message: string;
+} | {
+    type: 'TRANSITION';
+    toState: string;
+} | {
+    type: 'REENTER';
+};
+export interface BotMachineInput {
+    userId: number;
+    telegramId: number;
+    chatId: number;
+    currentState: string;
+    stateData: Record<string, unknown>;
+}
+export type { StateTransitions } from '../bot-state-types.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,eAAO,MAAM,UAAU,uBAA8B,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAEtD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,iBAAiB,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IAC3C,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAC7D,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAChE,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAClC,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ;IAC/D,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE5E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+import { BotBuilder } from './builder.js';
+export const appBuilder = new BotBuilder();
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAa,CAAC"}

package/dist/database.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Database Entry Point
+ *
+ * Uses Prisma ORM 7.x with driver adapters for database operations.
+ *
+ * Switch between SQLite and MySQL by changing DATABASE_URL in .env:
+ * - SQLite: DATABASE_URL="file:./dev.db"
+ * - MySQL: DATABASE_URL="mysql://user:password@localhost:3306/dbname"
+ *
+ * Note: When switching providers, update the provider in prisma/schema.prisma:
+ * - SQLite: provider = "sqlite"
+ * - MySQL: provider = "mysql"
+ */
+import 'dotenv/config';
+import { User, UserInfo } from './generated/prisma/client.js';
+declare const prisma: import("./generated/prisma/internal/class.js").PrismaClient<never, import("./generated/prisma/internal/prismaNamespace.js").GlobalOmitConfig | undefined, import("@prisma/client/runtime/client").DefaultArgs>;
+export type { User, UserInfo };
+export type UserWithInfo = User & {
+    info: UserInfo | null;
+};
+/**
+ * Get user by Telegram ID with joined user info
+ */
+export declare function getUserByTelegramId(telegramId: number): Promise<UserWithInfo | null>;
+/**
+ * Create or update a user
+ */
+export declare function createOrUpdateUser(data: {
+    telegramId: number;
+    chatId: number;
+    currentState?: string;
+    stateData?: Record<string, unknown>;
+}): Promise<UserWithInfo>;
+/**
+ * Update user state and optional state data
+ */
+export declare function updateUserState(telegramId: number, currentState: string, stateData?: Record<string, unknown>): Promise<void>;
+/**
+ * Disconnect from database
+ */
+export declare function disconnectDB(): Promise<void>;
+export { prisma };
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAgB,IAAI,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAmB5E,QAAA,MAAM,MAAM,gNAAgC,CAAC;AAG7C,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAG/B,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG;IAChC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO1F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,GAAG,OAAO,CAAC,YAAY,CAAC,CAkDxB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/database.js

@@ -0,0 +1,127 @@
+/**
+ * Database Entry Point
+ *
+ * Uses Prisma ORM 7.x with driver adapters for database operations.
+ *
+ * Switch between SQLite and MySQL by changing DATABASE_URL in .env:
+ * - SQLite: DATABASE_URL="file:./dev.db"
+ * - MySQL: DATABASE_URL="mysql://user:password@localhost:3306/dbname"
+ *
+ * Note: When switching providers, update the provider in prisma/schema.prisma:
+ * - SQLite: provider = "sqlite"
+ * - MySQL: provider = "mysql"
+ */
+import 'dotenv/config';
+import { PrismaBetterSqlite3 } from '@prisma/adapter-better-sqlite3';
+import { PrismaClient } from './generated/prisma/client.js';
+// Determine database provider from URL
+const databaseUrl = process.env.DATABASE_URL || 'file:./dev.db';
+const isMysql = databaseUrl.startsWith('mysql:');
+// Create adapter based on database type
+// For now, SQLite is fully supported. MySQL adapter requires additional setup.
+const adapter = isMysql
+    ? (() => {
+        throw new Error('MySQL adapter not yet configured. Please configure @prisma/adapter-mariadb in src/database.ts');
+    })()
+    : new PrismaBetterSqlite3({
+        url: databaseUrl,
+    });
+// Prisma client instance with adapter
+const prisma = new PrismaClient({ adapter });
+/**
+ * Get user by Telegram ID with joined user info
+ */
+export async function getUserByTelegramId(telegramId) {
+    const user = await prisma.user.findUnique({
+        where: { telegramId },
+        include: { info: true },
+    });
+    return user;
+}
+/**
+ * Create or update a user
+ */
+export async function createOrUpdateUser(data) {
+    const existingUser = await getUserByTelegramId(data.telegramId);
+    if (existingUser) {
+        // Update existing user
+        const updatedUser = await prisma.user.update({
+            where: { telegramId: data.telegramId },
+            data: {
+                chatId: data.chatId,
+                ...(data.currentState && { currentState: data.currentState }),
+            },
+            include: { info: true },
+        });
+        // Update or create user info if stateData provided
+        if (data.stateData) {
+            await prisma.userInfo.upsert({
+                where: { userId: updatedUser.id },
+                create: {
+                    userId: updatedUser.id,
+                    stateData: JSON.stringify(data.stateData),
+                },
+                update: {
+                    stateData: JSON.stringify(data.stateData),
+                },
+            });
+            // Return updated user with info
+            return (await getUserByTelegramId(data.telegramId));
+        }
+        return updatedUser;
+    }
+    else {
+        // Create new user with info
+        const newUser = await prisma.user.create({
+            data: {
+                telegramId: data.telegramId,
+                chatId: data.chatId,
+                currentState: data.currentState || 'idle',
+                info: {
+                    create: {
+                        stateData: JSON.stringify(data.stateData || {}),
+                    },
+                },
+            },
+            include: { info: true },
+        });
+        return newUser;
+    }
+}
+/**
+ * Update user state and optional state data
+ */
+export async function updateUserState(telegramId, currentState, stateData) {
+    const user = await prisma.user.findUnique({
+        where: { telegramId },
+    });
+    if (!user) {
+        throw new Error(`User with telegramId ${telegramId} not found`);
+    }
+    // Update user state
+    await prisma.user.update({
+        where: { telegramId },
+        data: { currentState },
+    });
+    // Update state data if provided
+    if (stateData) {
+        await prisma.userInfo.upsert({
+            where: { userId: user.id },
+            create: {
+                userId: user.id,
+                stateData: JSON.stringify(stateData),
+            },
+            update: {
+                stateData: JSON.stringify(stateData),
+            },
+        });
+    }
+}
+/**
+ * Disconnect from database
+ */
+export async function disconnectDB() {
+    await prisma.$disconnect();
+}
+export { prisma };
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"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"}