@jungjaehoon/mama-os 0.1.1

package/dist/api/cron-handler.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Cron API router for /api/cron endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduleStoreAdapter = exports.InMemoryLogStore = void 0;
+exports.createCronRouter = createCronRouter;
+const express_1 = require("express");
+const types_js_1 = require("./types.js");
+const error_handler_js_1 = require("./error-handler.js");
+/**
+ * In-memory execution log store (placeholder until S6)
+ */
+class InMemoryLogStore {
+    logs = new Map();
+    async getLogs(jobId, limit, offset) {
+        const jobLogs = this.logs.get(jobId) || [];
+        return jobLogs.slice(offset, offset + limit);
+    }
+    async addLog(jobId, log) {
+        if (!this.logs.has(jobId)) {
+            this.logs.set(jobId, []);
+        }
+        this.logs.get(jobId).unshift(log); // Most recent first
+    }
+    async updateLog(logId, updates) {
+        for (const logs of this.logs.values()) {
+            const log = logs.find((l) => l.id === logId);
+            if (log) {
+                Object.assign(log, updates);
+                return;
+            }
+        }
+    }
+}
+exports.InMemoryLogStore = InMemoryLogStore;
+/**
+ * Adapter to use ScheduleStore as ExecutionLogStore
+ *
+ * Wraps ScheduleStore to provide ExecutionLogStore interface.
+ * This allows the API handlers to use persistent SQLite storage.
+ */
+class ScheduleStoreAdapter {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async getLogs(jobId, limit, offset) {
+        const logs = this.store.getLogs(jobId, limit, offset);
+        return logs.map((log) => ({
+            id: log.id,
+            started_at: log.started_at,
+            finished_at: log.finished_at,
+            status: log.status,
+            output: log.output,
+            error: log.error,
+        }));
+    }
+    async addLog(jobId, log) {
+        // Use logStart for initial log creation
+        const logId = this.store.logStart(jobId);
+        // If the log has a specific ID, we need to track the mapping
+        // For now, we just use the store's generated ID
+        if (log.status !== 'running') {
+            this.store.logFinish(logId, log.status === 'success' ? 'success' : 'failed', log.output || undefined, log.error || undefined);
+        }
+    }
+    async updateLog(logId, updates) {
+        if (updates.status && updates.status !== 'running') {
+            this.store.logFinish(logId, updates.status === 'success' ? 'success' : 'failed', updates.output || undefined, updates.error || undefined);
+        }
+    }
+}
+exports.ScheduleStoreAdapter = ScheduleStoreAdapter;
+/**
+ * Create cron API router
+ */
+function createCronRouter(scheduler, logStore = new InMemoryLogStore()) {
+    const router = (0, express_1.Router)();
+    // GET /api/cron - List all jobs
+    router.get('/', (0, error_handler_js_1.asyncHandler)(async (_req, res) => {
+        const jobs = scheduler.listJobs();
+        const apiJobs = jobs.map(types_js_1.toApiCronJob);
+        res.json({ jobs: apiJobs });
+    }));
+    // POST /api/cron - Create a new job
+    router.post('/', (0, error_handler_js_1.asyncHandler)(async (req, res) => {
+        const body = req.body;
+        (0, error_handler_js_1.validateRequired)(body, ['name', 'cron_expr', 'prompt']);
+        const id = `job_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        scheduler.addJob({
+            id,
+            name: body.name,
+            cronExpr: body.cron_expr,
+            prompt: body.prompt,
+            enabled: body.enabled ?? true,
+        });
+        res.json({ id, created: true });
+    }));
+    // GET /api/cron/:id - Get a specific job
+    router.get('/:id', (0, error_handler_js_1.asyncHandler)(async (req, res) => {
+        const id = req.params.id;
+        const job = scheduler.getJob(id);
+        if (!job) {
+            throw new types_js_1.ApiError(`Job not found: ${id}`, 404, 'NOT_FOUND');
+        }
+        res.json({ job: (0, types_js_1.toApiCronJob)(job) });
+    }));
+    // PUT /api/cron/:id - Update a job
+    router.put('/:id', (0, error_handler_js_1.asyncHandler)(async (req, res) => {
+        const id = req.params.id;
+        const body = req.body;
+        const job = scheduler.getJob(id);
+        if (!job) {
+            throw new types_js_1.ApiError(`Job not found: ${id}`, 404, 'NOT_FOUND');
+        }
+        // Update job - need to remove and re-add for scheduler
+        // First get current values
+        const currentJob = scheduler.getJob(id);
+        // Build updated config
+        const updatedConfig = {
+            id: id,
+            name: body.name ?? currentJob.name,
+            cronExpr: body.cron_expr ?? currentJob.cronExpr,
+            prompt: body.prompt ?? currentJob.prompt,
+            enabled: body.enabled ?? currentJob.enabled,
+        };
+        // Remove old job and add updated one
+        scheduler.removeJob(id);
+        scheduler.addJob(updatedConfig);
+        res.json({ updated: true });
+    }));
+    // DELETE /api/cron/:id - Delete a job
+    router.delete('/:id', (0, error_handler_js_1.asyncHandler)(async (req, res) => {
+        const id = req.params.id;
+        const job = scheduler.getJob(id);
+        if (!job) {
+            throw new types_js_1.ApiError(`Job not found: ${id}`, 404, 'NOT_FOUND');
+        }
+        scheduler.removeJob(id);
+        res.json({ deleted: true });
+    }));
+    // POST /api/cron/:id/run - Run job immediately
+    router.post('/:id/run', (0, error_handler_js_1.asyncHandler)(async (req, res) => {
+        const id = req.params.id;
+        const job = scheduler.getJob(id);
+        if (!job) {
+            throw new types_js_1.ApiError(`Job not found: ${id}`, 404, 'NOT_FOUND');
+        }
+        const executionId = `exec_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        // Create log entry for this execution
+        const log = {
+            id: executionId,
+            started_at: Date.now(),
+            finished_at: null,
+            status: 'running',
+            output: null,
+            error: null,
+        };
+        await logStore.addLog(id, log);
+        // Run the job asynchronously
+        scheduler
+            .runNow(id)
+            .then(async (result) => {
+            await logStore.updateLog(executionId, {
+                finished_at: Date.now(),
+                status: result.success ? 'success' : 'failed',
+                output: result.success ? 'Execution completed' : null,
+                error: result.error || null,
+            });
+        })
+            .catch(async (err) => {
+            await logStore.updateLog(executionId, {
+                finished_at: Date.now(),
+                status: 'failed',
+                error: err.message,
+            });
+        });
+        res.json({ execution_id: executionId, started: true });
+    }));
+    // GET /api/cron/:id/logs - Get execution logs
+    router.get('/:id/logs', (0, error_handler_js_1.asyncHandler)(async (req, res) => {
+        const id = req.params.id;
+        const limit = parseInt(req.query.limit) || 20;
+        const offset = parseInt(req.query.offset) || 0;
+        const job = scheduler.getJob(id);
+        if (!job) {
+            throw new types_js_1.ApiError(`Job not found: ${id}`, 404, 'NOT_FOUND');
+        }
+        const logs = await logStore.getLogs(id, limit, offset);
+        res.json({ logs });
+    }));
+    return router;
+}
+//# sourceMappingURL=cron-handler.js.map

package/dist/api/cron-handler.js.map

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

package/dist/api/error-handler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Error handling middleware for API
+ */
+import type { Request, Response, NextFunction } from 'express';
+export { ApiError } from './types.js';
+/**
+ * Express error handling middleware
+ */
+export declare function errorHandler(err: Error, _req: Request, res: Response, _next: NextFunction): void;
+/**
+ * Async handler wrapper to catch promise rejections
+ */
+export declare function asyncHandler<T>(fn: (req: Request, res: Response, next: NextFunction) => Promise<T>): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Validate required fields in request body
+ */
+export declare function validateRequired(body: Record<string, unknown>, fields: string[]): void;
+/**
+ * 404 handler for unmatched routes
+ */
+export declare function notFoundHandler(req: Request, res: Response, _next: NextFunction): void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/api/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/api/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI/D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CA0BhG;AAoCD;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAClE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAI3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAOtF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAMtF"}

package/dist/api/error-handler.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Error handling middleware for API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = void 0;
+exports.errorHandler = errorHandler;
+exports.asyncHandler = asyncHandler;
+exports.validateRequired = validateRequired;
+exports.notFoundHandler = notFoundHandler;
+const types_js_1 = require("./types.js");
+// Re-export ApiError for convenience
+var types_js_2 = require("./types.js");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return types_js_2.ApiError; } });
+const types_js_3 = require("../scheduler/types.js");
+/**
+ * Express error handling middleware
+ */
+function errorHandler(err, _req, res, _next) {
+    console.error('API Error:', err);
+    // Handle ApiError instances
+    if (err instanceof types_js_1.ApiError) {
+        res.status(err.statusCode).json(err.toResponse());
+        return;
+    }
+    // Handle SchedulerError instances
+    if (err instanceof types_js_3.SchedulerError) {
+        const statusCode = getStatusCodeForSchedulerError(err.code);
+        const response = {
+            error: err.message,
+            code: mapSchedulerErrorCode(err.code),
+        };
+        res.status(statusCode).json(response);
+        return;
+    }
+    // Handle generic errors
+    const response = {
+        error: 'Internal server error',
+        code: 'INTERNAL_ERROR',
+    };
+    res.status(500).json(response);
+}
+/**
+ * Map SchedulerError code to HTTP status code
+ */
+function getStatusCodeForSchedulerError(code) {
+    switch (code) {
+        case 'INVALID_CRON':
+        case 'JOB_EXISTS':
+            return 400;
+        case 'JOB_NOT_FOUND':
+            return 404;
+        case 'JOB_RUNNING':
+            return 409;
+        default:
+            return 500;
+    }
+}
+/**
+ * Map SchedulerError code to ApiErrorCode
+ */
+function mapSchedulerErrorCode(code) {
+    switch (code) {
+        case 'INVALID_CRON':
+        case 'JOB_EXISTS':
+            return 'VALIDATION_ERROR';
+        case 'JOB_NOT_FOUND':
+            return 'NOT_FOUND';
+        case 'JOB_RUNNING':
+            return 'JOB_RUNNING';
+        default:
+            return 'INTERNAL_ERROR';
+    }
+}
+/**
+ * Async handler wrapper to catch promise rejections
+ */
+function asyncHandler(fn) {
+    return (req, res, next) => {
+        Promise.resolve(fn(req, res, next)).catch(next);
+    };
+}
+/**
+ * Validate required fields in request body
+ */
+function validateRequired(body, fields) {
+    const missing = fields.filter((field) => body[field] === undefined);
+    if (missing.length > 0) {
+        throw new types_js_1.ApiError(`Missing required fields: ${missing.join(', ')}`, 400, 'BAD_REQUEST', {
+            missing,
+        });
+    }
+}
+/**
+ * 404 handler for unmatched routes
+ */
+function notFoundHandler(req, res, _next) {
+    const response = {
+        error: `Route not found: ${req.method} ${req.path}`,
+        code: 'NOT_FOUND',
+    };
+    res.status(404).json(response);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/api/error-handler.js.map

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

package/dist/api/heartbeat-handler.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Heartbeat API router for /api/heartbeat endpoints
+ */
+import { Router } from 'express';
+import { CronScheduler } from '../scheduler/index.js';
+import type { LastExecution } from './types.js';
+import type { ExecutionLogStore } from './cron-handler.js';
+/**
+ * Default heartbeat prompt for scheduled reports
+ */
+export declare const DEFAULT_HEARTBEAT_PROMPT = "\uD83D\uDEA8 \uC885\uD569\uBCF4\uACE0 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8:\n1. MAMA \uB85C\uB4DC: load_checkpoint\n2. \uB370\uC774\uD130 \uC218\uC9D1: \uCD5C\uADFC \uD65C\uB3D9 \uAC80\uC0C9\n3. \uBCF4\uACE0\uC11C \uC791\uC131: \uC694\uC57D \uC0DD\uC131\n4. \uBA54\uC2E0\uC800 \uC804\uC1A1 (\uC124\uC815\uB41C \uACBD\uC6B0)\n5. MAMA \uC800\uC7A5: checkpoint";
+/**
+ * Heartbeat execution tracker interface
+ */
+export interface HeartbeatTracker {
+    /** Get the last heartbeat execution */
+    getLastExecution(): Promise<LastExecution | null>;
+    /** Record a heartbeat execution */
+    recordExecution(execution: LastExecution): Promise<void>;
+}
+/**
+ * In-memory heartbeat tracker (placeholder until S6)
+ */
+export declare class InMemoryHeartbeatTracker implements HeartbeatTracker {
+    private lastExecution;
+    getLastExecution(): Promise<LastExecution | null>;
+    recordExecution(execution: LastExecution): Promise<void>;
+}
+/**
+ * Options for creating heartbeat router
+ */
+export interface HeartbeatRouterOptions {
+    /** Scheduler instance */
+    scheduler: CronScheduler;
+    /** Log store for execution logs */
+    logStore: ExecutionLogStore;
+    /** Heartbeat tracker */
+    tracker?: HeartbeatTracker;
+    /** Heartbeat execution callback */
+    onHeartbeat?: (prompt: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * Create heartbeat API router
+ */
+export declare function createHeartbeatRouter(options: HeartbeatRouterOptions): Router;
+//# sourceMappingURL=heartbeat-handler.d.ts.map

package/dist/api/heartbeat-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-handler.d.ts","sourceRoot":"","sources":["../../src/api/heartbeat-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAoD,aAAa,EAAE,MAAM,YAAY,CAAC;AAElG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,wBAAwB,oWAKd,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,gBAAgB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAClD,mCAAmC;IACnC,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,aAAa,CAA8B;IAE7C,gBAAgB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIjD,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,mCAAmC;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,wBAAwB;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,mCAAmC;IACnC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAqE7E"}

package/dist/api/heartbeat-handler.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Heartbeat API router for /api/heartbeat endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryHeartbeatTracker = exports.DEFAULT_HEARTBEAT_PROMPT = void 0;
+exports.createHeartbeatRouter = createHeartbeatRouter;
+const express_1 = require("express");
+const error_handler_js_1 = require("./error-handler.js");
+/**
+ * Default heartbeat prompt for scheduled reports
+ */
+exports.DEFAULT_HEARTBEAT_PROMPT = `🚨 종합보고 체크리스트:
+1. MAMA 로드: load_checkpoint
+2. 데이터 수집: 최근 활동 검색
+3. 보고서 작성: 요약 생성
+4. 메신저 전송 (설정된 경우)
+5. MAMA 저장: checkpoint`;
+/**
+ * In-memory heartbeat tracker (placeholder until S6)
+ */
+class InMemoryHeartbeatTracker {
+    lastExecution = null;
+    async getLastExecution() {
+        return this.lastExecution;
+    }
+    async recordExecution(execution) {
+        this.lastExecution = execution;
+    }
+}
+exports.InMemoryHeartbeatTracker = InMemoryHeartbeatTracker;
+/**
+ * Create heartbeat API router
+ */
+function createHeartbeatRouter(options) {
+    const { scheduler, tracker = new InMemoryHeartbeatTracker(), onHeartbeat } = options;
+    const router = (0, express_1.Router)();
+    // GET /api/heartbeat - Get heartbeat status
+    router.get('/', (0, error_handler_js_1.asyncHandler)(async (_req, res) => {
+        const jobs = scheduler.listJobs();
+        const activeJobs = jobs.filter((j) => j.enabled).length;
+        const lastExecution = await tracker.getLastExecution();
+        const response = {
+            status: activeJobs > 0 ? 'active' : 'inactive',
+            active_jobs: activeJobs,
+            last_execution: lastExecution,
+        };
+        res.json(response);
+    }));
+    // POST /api/heartbeat - Trigger manual heartbeat
+    router.post('/', (0, error_handler_js_1.asyncHandler)(async (req, res) => {
+        const body = req.body;
+        const prompt = body.prompt || exports.DEFAULT_HEARTBEAT_PROMPT;
+        const executionId = `heartbeat_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        const startedAt = Date.now();
+        // Execute heartbeat asynchronously
+        if (onHeartbeat) {
+            // Run asynchronously and track result
+            onHeartbeat(prompt)
+                .then(async (result) => {
+                const execution = {
+                    id: executionId,
+                    started_at: startedAt,
+                    status: result.success ? 'success' : 'failed',
+                };
+                await tracker.recordExecution(execution);
+            })
+                .catch(async () => {
+                const execution = {
+                    id: executionId,
+                    started_at: startedAt,
+                    status: 'failed',
+                };
+                await tracker.recordExecution(execution);
+            });
+        }
+        else {
+            // No handler, just record as pending
+            // The caller is responsible for executing the heartbeat
+            const execution = {
+                id: executionId,
+                started_at: startedAt,
+                status: 'success', // Assume success if no handler
+            };
+            await tracker.recordExecution(execution);
+        }
+        res.json({ execution_id: executionId, started: true });
+    }));
+    return router;
+}
+//# sourceMappingURL=heartbeat-handler.js.map

package/dist/api/heartbeat-handler.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * API module exports
+ *
+ * Provides HTTP API for cron job management and heartbeat functionality.
+ */
+import { type Express, type Router } from 'express';
+import { type ExecutionLogStore } from './cron-handler.js';
+import { type HeartbeatTracker } from './heartbeat-handler.js';
+import { CronScheduler } from '../scheduler/index.js';
+export * from './types.js';
+export type { ExecutionLogStore } from './cron-handler.js';
+export { InMemoryLogStore, ScheduleStoreAdapter } from './cron-handler.js';
+export type { HeartbeatTracker } from './heartbeat-handler.js';
+export { InMemoryHeartbeatTracker, DEFAULT_HEARTBEAT_PROMPT } from './heartbeat-handler.js';
+export { asyncHandler, validateRequired, ApiError } from './error-handler.js';
+/**
+ * API server options
+ */
+export interface ApiServerOptions {
+    /** Scheduler instance */
+    scheduler: CronScheduler;
+    /** Port to listen on (default: 3848) */
+    port?: number;
+    /** Log store for execution logs (default: InMemoryLogStore) */
+    logStore?: ExecutionLogStore;
+    /** Heartbeat tracker (default: InMemoryHeartbeatTracker) */
+    heartbeatTracker?: HeartbeatTracker;
+    /** Heartbeat execution callback */
+    onHeartbeat?: (prompt: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * API server instance
+ */
+export interface ApiServer {
+    /** Express app instance */
+    app: Express;
+    /** HTTP server instance */
+    server: ReturnType<(typeof import('express'))['application']['listen']> | null;
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server */
+    stop(): Promise<void>;
+    /** Get the port the server is listening on */
+    port: number;
+}
+/**
+ * Create and configure the API server
+ */
+export declare function createApiServer(options: ApiServerOptions): ApiServer;
+/**
+ * Create API routers without starting a server
+ * Useful for integrating into an existing Express app
+ */
+export declare function createApiRouters(options: ApiServerOptions): {
+    cronRouter: Router;
+    heartbeatRouter: Router;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAgB,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAsC,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mCAAmC;IACnC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,2BAA2B;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,2BAA2B;IAC3B,MAAM,EAAE,UAAU,CAAC,CAAC,cAAc,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/E,uBAAuB;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sBAAsB;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA+FpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB,CAiBA"}