@more-ink/irt-edge 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# @more-ink/irt-edge
+
+Production HTTP API server for the streaming IRT engine, built with Hono for deployment on Aliyun Function Compute.
+
+## Features
+
+- RESTful IRT API with Redis storage (Upstash)
+- Aliyun FC lifecycle hooks (`/initialize`, `/pre-stop`)
+- Graceful shutdown and health checks
+
+## Quick Start
+
+```bash
+# From repo root
+pnpm install
+
+# Create .env file
+# UPSTASH_REDIS_REST_URL=https://...
+# UPSTASH_REDIS_REST_TOKEN=...
+
+# Run dev server
+pnpm --filter @more-ink/irt-edge dev
+
+# Seed data
+pnpm --filter @more-ink/irt-edge seed
+```
+
+## Deployment
+
+To deploy to Aliyun FC from the repo root, run:
+
+```bash
+pnpm --filter @more-ink/irt-edge run deploy
+```
+or
+```bash
+pnpm dp
+```
+
+### How Deployment Works
+
+The deploy process handles pnpm's symlinked `node_modules` by:
+1. Building TypeScript to `dist/`
+2. Running `pnpm deploy --prod` to create `deploy-output/` with flat, real `node_modules` (no symlinks)
+3. Uploading from `deploy-output/` as an FC layer
+
+This ensures all dependencies are included in the layer, not just symlinks to pnpm's store.
+
+## API Endpoints
+
+### IRT Operations
+- `POST /api/irt/answer` - Record response and get next item
+- `POST /api/irt/next-item` - Get next item without recording response
+- `GET /api/irt/health` - Health check
+
+### Aliyun FC Lifecycle
+- `POST /initialize` - Instance startup (verifies Redis)
+- `GET /pre-stop` - Instance shutdown (closes Redis)
+
+### System
+- `GET /` - Service info
+
+## Environment Variables
+
+```bash
+UPSTASH_REDIS_URL_DK=https://...
+UPSTASH_REDIS_TOKEN_DK=...
+ALIYUN_ACCESS_KEY=...
+ALIYUN_SECRET_ACCESS_KEY=...
+FEISHU_APP_ID=...
+FEISHU_APP_SECRET=...
+FEISHU_CHAT_ID=...
+PORT=9000  # optional
+```
+
+See `src/index.ts` for default IRT engine parameters (learning rates, selection options).
+

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_server_1 = require("@hono/node-server");
+const hono_1 = require("hono");
+const irt_core_1 = require("@more-ink/irt-core");
+const routes_1 = require("./routes");
+const redis_1 = require("./storage/redis");
+const app = new hono_1.Hono();
+// Initialize Redis client and repositories
+const redis = (0, redis_1.createRedisClient)();
+const userRepo = (0, redis_1.createRedisUserSkillStateRepo)(redis);
+const itemRepo = (0, redis_1.createRedisItemRepo)(redis);
+const engine = (0, irt_core_1.createStreamingIrtEngine)({
+    userRepo,
+    itemRepo,
+    hooks: {
+        onUpdateUserAndItem: async (payload) => {
+            console.log('[IRT Update]', {
+                userId: payload.userAfter.userId,
+                skillId: payload.userAfter.skillId,
+                itemId: payload.itemAfter.id,
+                score: payload.score,
+                thetaBefore: payload.userBefore.theta.toFixed(3),
+                thetaAfter: payload.userAfter.theta.toFixed(3),
+                se: payload.se.toFixed(3),
+                itemA: payload.itemAfter.a.toFixed(3),
+                itemB: payload.itemAfter.b.toFixed(3),
+                infoSum: payload.userAfter.infoSum.toFixed(3),
+            });
+        },
+        onSelectNextItem: async (payload) => {
+            console.log('[IRT Selection]', {
+                userId: payload.user.userId,
+                skillId: payload.user.skillId,
+                theta: payload.user.theta.toFixed(3),
+                candidatesCount: payload.candidates.length,
+                chosenItemId: payload.chosen?.id ?? 'none',
+                chosenItemDifficulty: payload.chosen?.b.toFixed(3) ?? 'N/A',
+            });
+        },
+    },
+    config: {
+        updateDefaults: {
+            thetaLR: 0.05, // Learning rate for ability
+            aLR: 0.001, // Learning rate for discrimination
+            bLR: 0.01, // Learning rate for difficulty
+            minA: 0.2, // Min discrimination bound
+            maxA: 3.0, // Max discrimination bound
+        },
+        selectionDefaults: {
+            minGapMs: 10 * 60_000, // Don't repeat item within 10 minutes
+            difficultyPenaltyWidth: 1.0, // Gaussian width for difficulty penalty
+            maxTimesSeen: 100, // Cap on item exposure
+            topKRandomize: 5, // Randomize among top 5 items
+            explorationChance: 0.1, // 10% random exploration
+        },
+    },
+});
+// Mount IRT routes
+const irtRouter = (0, routes_1.createIrtRouter)(engine);
+app.route('/api/irt', irtRouter);
+// Mount Redis test routes
+const redisRouter = (0, routes_1.createRedisRouter)(redis);
+app.route('/api/redis', redisRouter);
+// Aliyun Function Compute lifecycle hooks
+app.post('/initialize', async (c) => {
+    console.log('[Lifecycle] Function instance initializing...');
+    try {
+        await redis.ping();
+        console.log('[Lifecycle] Redis connection verified');
+        return c.body(null, 200);
+    }
+    catch (error) {
+        console.error('[Lifecycle] Initialization failed:', error);
+        return c.body(null, 500);
+    }
+});
+app.get('/pre-stop', async (c) => {
+    console.log('[Lifecycle] Function instance stopping...');
+    try {
+        await redis.quit();
+        console.log('[Lifecycle] Redis connection closed');
+        return c.body(null, 200);
+    }
+    catch (error) {
+        console.error('[Lifecycle] Pre-stop error:', error);
+        return c.body(null, 500);
+    }
+});
+// Health check at root
+app.get('/', c => c.json({
+    status: 'ok',
+}));
+const port = Number(process.env.PORT) || 9000;
+const server = (0, node_server_1.serve)({
+    fetch: app.fetch,
+    port,
+});
+console.log(`IRT Edge listening on http://localhost:${port}`);
+// graceful shutdown
+process.on('SIGINT', async () => {
+    server.close();
+    await redis.quit();
+    process.exit(0);
+});
+process.on('SIGTERM', async () => {
+    server.close((err) => {
+        if (err) {
+            console.error(err);
+            process.exit(1);
+        }
+    });
+    await redis.quit();
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/routes.d.ts

@@ -0,0 +1,24 @@
+import { Hono } from 'hono';
+import type { StreamingIrtEngine } from '@more-ink/irt-core';
+/**
+ * Creates the IRT API router with the following endpoints:
+ *
+ * POST /api/irt/answer
+ *   - Record a response and get next item
+ *   - Body: { userId, skillId, itemId, score, updateOptions?, selectionOptions? }
+ *   - Returns: { theta, se, nextItem, updatedUser, updatedItem }
+ *
+ * POST /api/irt/next-item
+ *   - Select next item without recording response
+ *   - Body: { userId, skillId, selectionOptions? }
+ *   - Returns: { user, nextItem }
+ *
+ * GET /api/irt/users/:userId/skills/:skillId
+ *   - Get current user skill state
+ *   - Returns: { user, se }
+ */
+export declare function createIrtRouter(engine: StreamingIrtEngine): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+/**
+ * Creates Redis testing/info router
+ */
+export declare function createRedisRouter(redis: any): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIrtRouter = createIrtRouter;
+exports.createRedisRouter = createRedisRouter;
+const hono_1 = require("hono");
+/**
+ * Creates the IRT API router with the following endpoints:
+ *
+ * POST /api/irt/answer
+ *   - Record a response and get next item
+ *   - Body: { userId, skillId, itemId, score, updateOptions?, selectionOptions? }
+ *   - Returns: { theta, se, nextItem, updatedUser, updatedItem }
+ *
+ * POST /api/irt/next-item
+ *   - Select next item without recording response
+ *   - Body: { userId, skillId, selectionOptions? }
+ *   - Returns: { user, nextItem }
+ *
+ * GET /api/irt/users/:userId/skills/:skillId
+ *   - Get current user skill state
+ *   - Returns: { user, se }
+ */
+function createIrtRouter(engine) {
+    const router = new hono_1.Hono();
+    /**
+     * POST /api/irt/answer
+     * Record a response and get the next recommended item
+     */
+    router.post('/answer', async (c) => {
+        try {
+            const body = await c.req.json();
+            const { userId, skillId, itemId, score, timestamp, updateOptions, selectionOptions } = body;
+            // Validate required fields
+            if (!userId || !skillId || !itemId || score === undefined) {
+                return c.json({ error: 'Missing required fields: userId, skillId, itemId, score' }, 400);
+            }
+            // Validate score range
+            if (typeof score !== 'number' || score < 0 || score > 1) {
+                return c.json({ error: 'score must be a number between 0 and 1' }, 400);
+            }
+            const result = await engine.recordResponseAndSelectNext({
+                userId,
+                skillId,
+                itemId,
+                score,
+                timestamp,
+                updateOptions,
+                selectionOptions,
+            });
+            return c.json({
+                success: true,
+                data: {
+                    theta: result.theta,
+                    se: result.se,
+                    nextItem: result.nextItem,
+                    updatedUser: result.updatedUser,
+                    updatedItem: result.updatedItem,
+                },
+            });
+        }
+        catch (error) {
+            console.error('Error recording response:', error);
+            return c.json({ error: 'Internal server error', message: error instanceof Error ? error.message : 'Unknown error' }, 500);
+        }
+    });
+    /**
+     * POST /api/irt/next-item
+     * Select the next item for a user/skill without recording a response
+     */
+    router.post('/next-item', async (c) => {
+        try {
+            const body = await c.req.json();
+            const { userId, skillId, selectionOptions } = body;
+            if (!userId || !skillId) {
+                return c.json({ error: 'Missing required fields: userId, skillId' }, 400);
+            }
+            const result = await engine.selectNextItem({
+                userId,
+                skillId,
+                selectionOptions,
+            });
+            return c.json({
+                success: true,
+                data: {
+                    user: result.user,
+                    nextItem: result.nextItem,
+                },
+            });
+        }
+        catch (error) {
+            console.error('Error selecting next item:', error);
+            return c.json({ error: 'Internal server error', message: error instanceof Error ? error.message : 'Unknown error' }, 500);
+        }
+    });
+    /**
+     * GET /api/irt/users/:userId/skills/:skillId
+     * Get current user skill state (read-only, no updates)
+     *
+     * Note: This requires the engine to expose a way to read user state.
+     * For now, we'll return a placeholder indicating this needs implementation.
+     */
+    router.get('/users/:userId/skills/:skillId', async (c) => {
+        try {
+            const userId = c.req.param('userId');
+            const skillId = c.req.param('skillId');
+            // The current engine interface doesn't expose a direct getUserState method
+            // Host apps would typically implement this via their userRepo directly
+            return c.json({
+                success: false,
+                error: 'User state retrieval should be implemented via userRepo in host app',
+                suggestion: 'Use selectNextItem with no selection to get user state, or extend engine interface',
+            }, 501);
+        }
+        catch (error) {
+            console.error('Error getting user state:', error);
+            return c.json({ error: 'Internal server error', message: error instanceof Error ? error.message : 'Unknown error' }, 500);
+        }
+    });
+    /**
+     * Health check endpoint
+     */
+    router.get('/health', (c) => {
+        return c.json({
+            success: true,
+            service: 'irt-edge',
+            status: 'healthy',
+            timestamp: Date.now(),
+        });
+    });
+    return router;
+}
+/**
+ * Creates Redis testing/info router
+ */
+function createRedisRouter(redis) {
+    const router = new hono_1.Hono();
+    /**
+     * GET /api/redis/test
+     * Test Redis connection and return server info
+     */
+    router.get('/test', async (c) => {
+        const diagnostics = {
+            connectionState: redis.status,
+            redisUrl: process.env.REDIS_URL ? 'configured' : 'not configured',
+        };
+        try {
+            console.log('[Redis Test] Starting test, connection state:', redis.status);
+            // Wait for Redis to be ready if not already
+            if (redis.status !== 'ready') {
+                console.log('[Redis Test] Waiting for Redis to be ready...');
+                await new Promise((resolve, reject) => {
+                    const timeout = setTimeout(() => {
+                        reject(new Error('Redis did not become ready in time'));
+                    }, 10000);
+                    redis.once('ready', () => {
+                        clearTimeout(timeout);
+                        console.log('[Redis Test] Redis is now ready');
+                        resolve(true);
+                    });
+                    redis.once('error', (err) => {
+                        clearTimeout(timeout);
+                        reject(err);
+                    });
+                });
+            }
+            // Add timeout to prevent hanging
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    console.error('[Redis Test] Operation timed out after 10s');
+                    reject(new Error('Redis operation timeout after 10s'));
+                }, 10000);
+            });
+            // Test Redis with SET/GET/DEL operations
+            const testKey = `irt:test:${Date.now()}`;
+            const testValue = 'ping';
+            const start = Date.now();
+            const testOperation = (async () => {
+                console.log('[Redis Test] Attempting SET...');
+                await redis.set(testKey, testValue, 'EX', 10);
+                console.log('[Redis Test] SET successful, attempting GET...');
+                const retrieved = await redis.get(testKey);
+                console.log('[Redis Test] GET successful, attempting DEL...');
+                await redis.del(testKey);
+                console.log('[Redis Test] All operations successful');
+                return retrieved;
+            })();
+            const retrieved = await Promise.race([testOperation, timeoutPromise]);
+            const durationMs = Date.now() - start;
+            const isValid = retrieved === testValue;
+            return c.json({
+                success: isValid,
+                status: isValid ? 'connected' : 'error',
+                operationMs: durationMs,
+                diagnostics,
+                timestamp: Date.now(),
+            });
+        }
+        catch (error) {
+            console.error('[Redis Test] Error:', error);
+            diagnostics.error = error instanceof Error ? error.message : 'Unknown error';
+            diagnostics.stack = error instanceof Error ? error.stack : undefined;
+            return c.json({
+                success: false,
+                status: 'error',
+                diagnostics,
+                timestamp: Date.now(),
+            }, 503);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

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

package/dist/seed.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Seed script to populate Redis with initial test data:
+ * - A few items for testing with different difficulties
+ * - Optional: sample user states
+ *
+ * Run with: pnpm pe tsx src/seed.ts
+ */
+export {};

package/dist/seed.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Seed script to populate Redis with initial test data:
+ * - A few items for testing with different difficulties
+ * - Optional: sample user states
+ *
+ * Run with: pnpm pe tsx src/seed.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const redis_1 = require("./storage/redis");
+async function seed() {
+    console.log('Starting seed...');
+    const redis = (0, redis_1.createRedisClient)();
+    const itemRepo = (0, redis_1.createRedisItemRepo)(redis);
+    // Define test items for skill "math"
+    const mathItems = [
+        { id: 'item-001', skillId: 'math', a: 1.2, b: -1.5, timesSeen: 0 }, // Easy
+        { id: 'item-002', skillId: 'math', a: 1.0, b: -0.5, timesSeen: 0 },
+        { id: 'item-003', skillId: 'math', a: 1.5, b: 0.0, timesSeen: 0 }, // Medium
+        { id: 'item-004', skillId: 'math', a: 1.3, b: 0.5, timesSeen: 0 },
+        { id: 'item-005', skillId: 'math', a: 1.8, b: 1.0, timesSeen: 0 }, // Hard
+        { id: 'item-006', skillId: 'math', a: 2.0, b: 1.5, timesSeen: 0 },
+    ];
+    // Define test items for skill "vocab"
+    const vocabItems = [
+        { id: 'item-101', skillId: 'vocab', a: 1.0, b: -1.0, timesSeen: 0 },
+        { id: 'item-102', skillId: 'vocab', a: 1.2, b: 0.0, timesSeen: 0 },
+        { id: 'item-103', skillId: 'vocab', a: 1.5, b: 0.5, timesSeen: 0 },
+        { id: 'item-104', skillId: 'vocab', a: 1.8, b: 1.2, timesSeen: 0 },
+    ];
+    const allItems = [...mathItems, ...vocabItems];
+    console.log(`Seeding ${allItems.length} items...`);
+    for (const item of allItems) {
+        await itemRepo.saveItem(item);
+        console.log(`  ✓ Saved ${item.id} (skill: ${item.skillId}, b: ${item.b})`);
+    }
+    console.log('\nSeed complete!');
+    console.log('\nTest the API with:');
+    console.log('  POST /api/irt/answer');
+    console.log('  Body: { "userId": "user-1", "skillId": "math", "itemId": "item-001", "score": 0.8 }');
+    console.log('\n  POST /api/irt/next-item');
+    console.log('  Body: { "userId": "user-1", "skillId": "math" }');
+    await redis.quit();
+    process.exit(0);
+}
+seed().catch((err) => {
+    console.error('Seed failed:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=seed.js.map

package/dist/seed.js.map

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

package/dist/storage/redis.d.ts

@@ -0,0 +1,24 @@
+import Redis from 'ioredis';
+import type { UserSkillStateRepo, ItemRepo } from '@more-ink/irt-core';
+/**
+ * Redis-backed implementation of UserSkillStateRepo.
+ *
+ * Keys: `irt:user:{userId}:skill:{skillId}`
+ * Value: JSON { theta, infoSum, se }
+ */
+export declare function createRedisUserSkillStateRepo<TSkillId = string>(redis: Redis): UserSkillStateRepo<TSkillId>;
+/**
+ * Redis-backed implementation of ItemRepo.
+ *
+ * Keys:
+ *  - `irt:item:{itemId}:skill:{skillId}` - individual item
+ *  - `irt:skill:{skillId}:items` - set of itemIds for a skill
+ *
+ * Value: JSON { id, skillId, a, b, lastSeenAt, timesSeen }
+ */
+export declare function createRedisItemRepo<TSkillId = string>(redis: Redis): ItemRepo<TSkillId>;
+/**
+ * Create a Redis client from REDIS_URL env var or default to localhost.
+ * Note: For Upstash, use the Redis protocol endpoint (rediss://...), not the REST API (https://...)
+ */
+export declare function createRedisClient(): Redis;

package/dist/storage/redis.js

@@ -0,0 +1,171 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRedisUserSkillStateRepo = createRedisUserSkillStateRepo;
+exports.createRedisItemRepo = createRedisItemRepo;
+exports.createRedisClient = createRedisClient;
+const ioredis_1 = __importDefault(require("ioredis"));
+const PREFIX = 'irt';
+/**
+ * Redis-backed implementation of UserSkillStateRepo.
+ *
+ * Keys: `irt:user:{userId}:skill:{skillId}`
+ * Value: JSON { theta, infoSum, se }
+ */
+function createRedisUserSkillStateRepo(redis) {
+    return {
+        async getUserSkillState(userId, skillId) {
+            const key = `${PREFIX}:user:${userId}:skill:${String(skillId)}`;
+            const data = await redis.get(key);
+            if (!data)
+                return null;
+            const parsed = JSON.parse(data);
+            const state = {
+                userId,
+                skillId,
+                theta: parsed.theta ?? 0,
+                infoSum: parsed.infoSum ?? 0,
+            };
+            return state;
+        },
+        async saveUserSkillState(state) {
+            const key = `${PREFIX}:user:${state.userId}:skill:${String(state.skillId)}`;
+            const value = JSON.stringify({
+                theta: state.theta,
+                infoSum: state.infoSum,
+                se: state.se,
+                updatedAt: Date.now(),
+            });
+            await redis.set(key, value);
+        },
+    };
+}
+/**
+ * Redis-backed implementation of ItemRepo.
+ *
+ * Keys:
+ *  - `irt:item:{itemId}:skill:{skillId}` - individual item
+ *  - `irt:skill:{skillId}:items` - set of itemIds for a skill
+ *
+ * Value: JSON { id, skillId, a, b, lastSeenAt, timesSeen }
+ */
+function createRedisItemRepo(redis) {
+    return {
+        async getItem(itemId, skillId) {
+            const key = `${PREFIX}:item:${itemId}:skill:${String(skillId)}`;
+            const data = await redis.get(key);
+            if (!data)
+                return null;
+            const parsed = JSON.parse(data);
+            const item = {
+                id: parsed.id ?? itemId,
+                skillId: parsed.skillId ?? skillId,
+                a: parsed.a ?? 1,
+                b: parsed.b ?? 0,
+                lastSeenAt: parsed.lastSeenAt,
+                timesSeen: parsed.timesSeen ?? 0,
+            };
+            return item;
+        },
+        async saveItem(item) {
+            const key = `${PREFIX}:item:${item.id}:skill:${String(item.skillId)}`;
+            const value = JSON.stringify({
+                id: item.id,
+                skillId: item.skillId,
+                a: item.a,
+                b: item.b,
+                lastSeenAt: item.lastSeenAt ?? null,
+                timesSeen: item.timesSeen ?? 0,
+                updatedAt: Date.now(),
+            });
+            // Save item data
+            await redis.set(key, value);
+            // Add to skill's item set for listCandidateItems
+            const setKey = `${PREFIX}:skill:${String(item.skillId)}:items`;
+            await redis.sadd(setKey, item.id);
+        },
+        async listCandidateItems(userId, skillId) {
+            // Get all item IDs for this skill
+            const setKey = `${PREFIX}:skill:${String(skillId)}:items`;
+            const itemIds = await redis.smembers(setKey);
+            if (itemIds.length === 0)
+                return [];
+            // Fetch all items in parallel
+            const items = await Promise.all(itemIds.map(async (itemId) => {
+                const key = `${PREFIX}:item:${itemId}:skill:${String(skillId)}`;
+                const data = await redis.get(key);
+                if (!data)
+                    return null;
+                const parsed = JSON.parse(data);
+                const item = {
+                    id: parsed.id ?? itemId,
+                    skillId: parsed.skillId ?? skillId,
+                    a: parsed.a ?? 1,
+                    b: parsed.b ?? 0,
+                    lastSeenAt: parsed.lastSeenAt,
+                    timesSeen: parsed.timesSeen ?? 0,
+                };
+                return item;
+            }));
+            // Filter out any nulls (items that were deleted)
+            return items.filter((item) => item !== null);
+        },
+    };
+}
+/**
+ * Create a Redis client from REDIS_URL env var or default to localhost.
+ * Note: For Upstash, use the Redis protocol endpoint (rediss://...), not the REST API (https://...)
+ */
+function createRedisClient() {
+    const redisUrl = process.env.REDIS_URL || 'redis://localhost:6379';
+    console.log('Creating Redis client with URL:', redisUrl.replace(/:[^:@]+@/, ':***@'));
+    const redis = new ioredis_1.default(redisUrl, {
+        maxRetriesPerRequest: 3,
+        connectTimeout: 10000, // 10s connection timeout
+        commandTimeout: 30000, // 30s command timeout (increase for VPC)
+        enableOfflineQueue: true, // Queue commands until ready
+        lazyConnect: false, // Connect immediately
+        retryStrategy: (times) => {
+            console.log(`Redis retry attempt ${times}`);
+            if (times > 3) {
+                console.error('Redis max retries reached');
+                return null; // Stop retrying
+            }
+            const delay = Math.min(times * 50, 2000);
+            return delay;
+        },
+        reconnectOnError: (err) => {
+            console.error('Redis reconnect on error:', err.message);
+            const targetErrors = ['READONLY', 'ECONNREFUSED'];
+            if (targetErrors.some((targetError) => err.message.includes(targetError))) {
+                return true;
+            }
+            return false;
+        },
+    });
+    redis.on('error', (err) => {
+        console.error('[Redis] Error:', err.message);
+    });
+    redis.on('connect', () => {
+        console.log('[Redis] TCP connection established');
+    });
+    redis.on('ready', () => {
+        console.log('[Redis] Ready to accept commands');
+    });
+    redis.on('reconnecting', (delay) => {
+        console.log(`[Redis] Reconnecting in ${delay}ms`);
+    });
+    redis.on('close', () => {
+        console.log('[Redis] Connection closed');
+    });
+    redis.on('end', () => {
+        console.log('[Redis] Connection ended');
+    });
+    redis.on('wait', () => {
+        console.log('[Redis] Waiting for reconnection...');
+    });
+    return redis;
+}
+//# sourceMappingURL=redis.js.map

package/dist/storage/redis.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@more-ink/irt-edge",
+  "version": "1.0.0",
+  "description": "Edge-function wrapper around the node-irt core library.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@hono/node-server": "^1.19.6",
+    "hono": "^4.10.7",
+    "ioredis": "^5.8.2",
+    "@more-ink/irt-core": "1.0.0"
+  },
+  "devDependencies": {
+    "@larksuiteoapi/node-sdk": "^1.55.0",
+    "@upstash/redis": "^1.35.7",
+    "dotenv": "^16.6.1",
+    "fc-deploy": "^1.2.3",
+    "tslib": "^2.8.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "lint": "echo \"Add ESLint config\" && exit 0",
+    "format": "echo \"Add Prettier config\" && exit 0",
+    "dev": "tsx watch src/index.ts",
+    "seed": "tsx src/seed.ts",
+    "predeploy": "pnpm run build && rm -rf deploy-output && pnpm deploy --prod --legacy --filter=@more-ink/irt-edge deploy-output && tsx scripts/flattenNodeModules.ts",
+    "deploy": "tsx scripts/deploy.ts"
+  }
+}