happy2 0.0.5

package/packages/happy2-server/dist/modules/realtime/local.js

@@ -0,0 +1,181 @@
+import { assertRealtimeEvent, assertRealtimeId, assertRealtimeTopic, DEFAULT_REALTIME_LIMITS, realtimeTopics, } from "./events.js";
+import { PubSubClosedError, } from "./pubsub.js";
+/** In-memory, process-local pubsub. All state disappears on close or restart. */
+export class LocalPubSub {
+    clock;
+    limits;
+    onSubscriberError;
+    subscribers = new Map();
+    connections = new Map();
+    connectionsByUser = new Map();
+    lastActivityByUser = new Map();
+    closed = false;
+    constructor(options = {}) {
+        this.clock = options.clock ?? Date.now;
+        this.limits = { ...DEFAULT_REALTIME_LIMITS, ...options.limits };
+        this.onSubscriberError = options.onSubscriberError;
+        assertLimits(this.limits);
+    }
+    async publish(topic, event) {
+        this.assertOpen();
+        assertRealtimeTopic(topic, this.limits);
+        assertRealtimeEvent(event, this.limits);
+        const safeEvent = deepFreeze(structuredClone(event));
+        const subscribers = [...(this.subscribers.get(topic) ?? [])];
+        await Promise.all(subscribers.map(async (subscriber) => {
+            try {
+                await subscriber(safeEvent);
+            }
+            catch (error) {
+                this.reportSubscriberError(error, { topic, event: safeEvent });
+            }
+        }));
+    }
+    subscribe(topic, subscriber) {
+        this.assertOpen();
+        assertRealtimeTopic(topic, this.limits);
+        if (typeof subscriber !== "function")
+            throw new Error("Subscriber must be a function");
+        const subscribers = this.subscribers.get(topic) ?? new Set();
+        subscribers.add(subscriber);
+        this.subscribers.set(topic, subscribers);
+        let subscribed = true;
+        return () => {
+            if (!subscribed)
+                return;
+            subscribed = false;
+            subscribers.delete(subscriber);
+            if (subscribers.size === 0)
+                this.subscribers.delete(topic);
+        };
+    }
+    async connectPresence(connection) {
+        this.assertOpen();
+        assertRealtimeId(connection.connectionId, "connection id", this.limits);
+        assertRealtimeId(connection.userId, "user id", this.limits);
+        const occurredAt = this.occurredAt(connection.occurredAt);
+        const existing = this.connections.get(connection.connectionId);
+        if (existing) {
+            if (existing.userId !== connection.userId)
+                throw new Error("Presence connection id is already in use");
+            if (occurredAt > existing.lastActiveAt) {
+                existing.lastActiveAt = occurredAt;
+                this.rememberActivity(existing.userId, occurredAt);
+            }
+            return this.snapshot(existing.userId);
+        }
+        const local = {
+            connectionId: connection.connectionId,
+            userId: connection.userId,
+            lastActiveAt: occurredAt,
+        };
+        this.connections.set(local.connectionId, local);
+        const userConnections = this.connectionsByUser.get(local.userId) ?? new Set();
+        userConnections.add(local.connectionId);
+        this.connectionsByUser.set(local.userId, userConnections);
+        this.rememberActivity(local.userId, occurredAt);
+        return this.emitPresence("connected", local.userId, occurredAt);
+    }
+    async recordPresenceActivity(connectionId, occurredAt) {
+        this.assertOpen();
+        assertRealtimeId(connectionId, "connection id", this.limits);
+        const connection = this.connections.get(connectionId);
+        if (!connection)
+            return undefined;
+        const time = this.occurredAt(occurredAt);
+        connection.lastActiveAt = Math.max(connection.lastActiveAt, time);
+        this.rememberActivity(connection.userId, connection.lastActiveAt);
+        return this.emitPresence("activity", connection.userId, time);
+    }
+    async disconnectPresence(connectionId, occurredAt) {
+        this.assertOpen();
+        assertRealtimeId(connectionId, "connection id", this.limits);
+        const connection = this.connections.get(connectionId);
+        if (!connection)
+            return undefined;
+        const time = this.occurredAt(occurredAt);
+        this.connections.delete(connectionId);
+        const userConnections = this.connectionsByUser.get(connection.userId);
+        userConnections?.delete(connectionId);
+        if (userConnections?.size === 0)
+            this.connectionsByUser.delete(connection.userId);
+        this.rememberActivity(connection.userId, Math.max(connection.lastActiveAt, time));
+        return this.emitPresence("disconnected", connection.userId, time);
+    }
+    async getPresenceSnapshot(userIds) {
+        this.assertOpen();
+        const ids = userIds
+            ? [...userIds]
+            : [...new Set([...this.connectionsByUser.keys(), ...this.lastActivityByUser.keys()])];
+        for (const userId of ids)
+            assertRealtimeId(userId, "user id", this.limits);
+        return ids.map((userId) => this.snapshot(userId));
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.subscribers.clear();
+        this.connections.clear();
+        this.connectionsByUser.clear();
+        this.lastActivityByUser.clear();
+    }
+    async emitPresence(change, userId, occurredAt) {
+        const snapshot = this.snapshot(userId);
+        const event = { type: "presence", change, snapshot, occurredAt };
+        await this.publish(realtimeTopics.presence, event);
+        return snapshot;
+    }
+    snapshot(userId) {
+        const connectionCount = this.connectionsByUser.get(userId)?.size ?? 0;
+        return Object.freeze({
+            userId,
+            status: connectionCount > 0 ? "online" : "offline",
+            connectionCount,
+            lastActiveAt: this.lastActivityByUser.get(userId),
+        });
+    }
+    rememberActivity(userId, occurredAt) {
+        this.lastActivityByUser.set(userId, Math.max(this.lastActivityByUser.get(userId) ?? 0, occurredAt));
+        while (this.lastActivityByUser.size > this.limits.maxPresenceUsers) {
+            const removable = [...this.lastActivityByUser.keys()].find((candidate) => !this.connectionsByUser.has(candidate));
+            if (!removable)
+                break;
+            this.lastActivityByUser.delete(removable);
+        }
+    }
+    occurredAt(value) {
+        const result = value ?? this.clock();
+        if (!Number.isSafeInteger(result) || result < 0)
+            throw new Error("Invalid presence time");
+        return result;
+    }
+    assertOpen() {
+        if (this.closed)
+            throw new PubSubClosedError();
+    }
+    reportSubscriberError(error, context) {
+        try {
+            const reported = this.onSubscriberError?.(error, context);
+            if (reported)
+                void reported.catch(() => undefined);
+        }
+        catch {
+            // Subscriber error reporting must never break fanout.
+        }
+    }
+}
+function deepFreeze(value) {
+    if (!value || typeof value !== "object" || Object.isFrozen(value))
+        return value;
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return Object.freeze(value);
+}
+function assertLimits(limits) {
+    for (const [name, value] of Object.entries(limits)) {
+        if (!Number.isSafeInteger(value) || value < 1)
+            throw new Error(`Realtime limit ${name} must be a positive safe integer`);
+    }
+}
+//# sourceMappingURL=local.js.map

package/packages/happy2-server/dist/modules/realtime/local.js.map

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

package/packages/happy2-server/dist/modules/realtime/local.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=local.test.d.ts.map

package/packages/happy2-server/dist/modules/realtime/local.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.test.d.ts","sourceRoot":"","sources":["../../../sources/modules/realtime/local.test.ts"],"names":[],"mappings":""}

package/packages/happy2-server/dist/modules/realtime/local.test.js

@@ -0,0 +1,186 @@
+import { describe, expect, it, vi } from "vitest";
+import { LocalPubSub, PubSubClosedError, realtimeTopics, } from "./index.js";
+const syncEvent = {
+    type: "sync",
+    sequence: "9007199254740993",
+    chats: [{ chatId: "chat-one", pts: "9007199254740992" }],
+    areas: ["messages"],
+};
+describe("LocalPubSub contract", () => {
+    it("fans out by topic, awaits async subscribers, and unsubscribes idempotently", async () => {
+        const pubsub = new LocalPubSub();
+        const received = [];
+        const listener = vi.fn(async (event) => {
+            await Promise.resolve();
+            received.push(event);
+        });
+        const unsubscribe = pubsub.subscribe(realtimeTopics.user("user-one"), listener);
+        await pubsub.publish(realtimeTopics.chat("chat-one"), syncEvent);
+        await pubsub.publish(realtimeTopics.user("user-one"), syncEvent);
+        expect(received).toEqual([syncEvent]);
+        expect(Object.isFrozen(received[0])).toBe(true);
+        expect(Object.isFrozen(received[0].chats)).toBe(true);
+        unsubscribe();
+        unsubscribe();
+        await pubsub.publish(realtimeTopics.user("user-one"), syncEvent);
+        expect(listener).toHaveBeenCalledTimes(1);
+    });
+    it("isolates subscriber failures so every async subscriber receives the event", async () => {
+        const errors = [];
+        const pubsub = new LocalPubSub({
+            onSubscriberError: (error) => {
+                errors.push(error);
+            },
+        });
+        const delivered = vi.fn();
+        pubsub.subscribe(realtimeTopics.server, async () => {
+            await Promise.resolve();
+            throw new Error("listener failed");
+        });
+        pubsub.subscribe(realtimeTopics.server, delivered);
+        await expect(pubsub.publish(realtimeTopics.server, syncEvent)).resolves.toBeUndefined();
+        expect(delivered).toHaveBeenCalledWith(syncEvent);
+        expect(errors).toHaveLength(1);
+    });
+    it("consumes asynchronous subscriber-error reporter failures", async () => {
+        const pubsub = new LocalPubSub({
+            onSubscriberError: async () => {
+                throw new Error("reporter failed");
+            },
+        });
+        pubsub.subscribe(realtimeTopics.server, () => {
+            throw new Error("subscriber failed");
+        });
+        await expect(pubsub.publish(realtimeTopics.server, syncEvent)).resolves.toBeUndefined();
+        await Promise.resolve();
+    });
+    it("bounds retained offline presence history", async () => {
+        let now = 1;
+        const pubsub = new LocalPubSub({
+            clock: () => now++,
+            limits: { maxPresenceUsers: 2 },
+        });
+        for (const userId of ["one", "two", "three"]) {
+            const connectionId = `connection-${userId}`;
+            await pubsub.connectPresence({ connectionId, userId });
+            await pubsub.disconnectPresence(connectionId);
+        }
+        expect(await pubsub.getPresenceSnapshot()).toHaveLength(2);
+    });
+    it("accepts lossless SQLite sequences and rejects malformed or oversized hints", async () => {
+        const pubsub = new LocalPubSub({ limits: { maxSyncChats: 1 } });
+        await expect(pubsub.publish(realtimeTopics.server, syncEvent)).resolves.toBeUndefined();
+        await expect(pubsub.publish(realtimeTopics.server, { ...syncEvent, sequence: "01" })).rejects.toThrow("unsigned decimal string");
+        await expect(pubsub.publish(realtimeTopics.server, {
+            ...syncEvent,
+            chats: [...syncEvent.chats, { chatId: "chat-two", pts: "1" }],
+        })).rejects.toThrow("at most 1 chats");
+        await expect(pubsub.publish(realtimeTopics.server, {
+            type: "unknown",
+        })).rejects.toThrow("Invalid realtime event type");
+    });
+    it("enforces typing expiry and WebRTC signaling bounds", async () => {
+        const pubsub = new LocalPubSub({
+            limits: { maxTypingTtlMs: 5_000, maxSessionDescriptionBytes: 16 },
+        });
+        const typing = {
+            type: "typing",
+            chatId: "chat-one",
+            userId: "user-one",
+            active: true,
+            occurredAt: 1_000,
+            expiresAt: 6_000,
+        };
+        const offer = {
+            type: "call.signal",
+            callId: "call-one",
+            chatId: "chat-one",
+            senderUserId: "user-one",
+            recipientUserId: "user-two",
+            signal: { kind: "offer", sdp: "v=0" },
+            occurredAt: 1_000,
+        };
+        await expect(pubsub.publish(realtimeTopics.chat("chat-one"), typing)).resolves.toBeUndefined();
+        await expect(pubsub.publish(realtimeTopics.call("call-one"), offer)).resolves.toBeUndefined();
+        await expect(pubsub.publish(realtimeTopics.chat("chat-one"), {
+            ...typing,
+            expiresAt: 6_001,
+        })).rejects.toThrow("within 5000 ms");
+        await expect(pubsub.publish(realtimeTopics.call("call-one"), {
+            ...offer,
+            signal: { kind: "offer", sdp: "x".repeat(17) },
+        })).rejects.toThrow("session description");
+    });
+    it("tracks multiple presence connections, activity, and offline snapshots", async () => {
+        let now = 100;
+        const pubsub = new LocalPubSub({ clock: () => now });
+        const events = [];
+        pubsub.subscribe(realtimeTopics.presence, (event) => {
+            if (event.type === "presence")
+                events.push(event);
+        });
+        await expect(pubsub.connectPresence({ connectionId: "connection-one", userId: "user-one" })).resolves.toEqual({
+            userId: "user-one",
+            status: "online",
+            connectionCount: 1,
+            lastActiveAt: 100,
+        });
+        now = 110;
+        await pubsub.connectPresence({ connectionId: "connection-two", userId: "user-one" });
+        now = 120;
+        await pubsub.recordPresenceActivity("connection-one");
+        now = 130;
+        await pubsub.disconnectPresence("connection-one");
+        expect(await pubsub.getPresenceSnapshot(["user-one", "never-online"])).toEqual([
+            {
+                userId: "user-one",
+                status: "online",
+                connectionCount: 1,
+                lastActiveAt: 130,
+            },
+            {
+                userId: "never-online",
+                status: "offline",
+                connectionCount: 0,
+                lastActiveAt: undefined,
+            },
+        ]);
+        now = 140;
+        await pubsub.disconnectPresence("connection-two");
+        expect(await pubsub.getPresenceSnapshot(["user-one"])).toEqual([
+            {
+                userId: "user-one",
+                status: "offline",
+                connectionCount: 0,
+                lastActiveAt: 140,
+            },
+        ]);
+        expect(events.map((event) => event.change)).toEqual([
+            "connected",
+            "connected",
+            "activity",
+            "disconnected",
+            "disconnected",
+        ]);
+    });
+    it("makes repeated presence connection safe but rejects cross-user reuse", async () => {
+        const pubsub = new LocalPubSub({ clock: () => 100 });
+        await pubsub.connectPresence({ connectionId: "same", userId: "user-one" });
+        await expect(pubsub.connectPresence({ connectionId: "same", userId: "user-one" })).resolves.toMatchObject({ connectionCount: 1 });
+        await expect(pubsub.connectPresence({ connectionId: "same", userId: "user-two" })).rejects.toThrow("already in use");
+        await expect(pubsub.recordPresenceActivity("unknown")).resolves.toBeUndefined();
+        await expect(pubsub.disconnectPresence("unknown")).resolves.toBeUndefined();
+    });
+    it("clears subscriptions and ephemeral presence state when closed", async () => {
+        const pubsub = new LocalPubSub();
+        const listener = vi.fn();
+        pubsub.subscribe(realtimeTopics.server, listener);
+        await pubsub.connectPresence({ connectionId: "connection-one", userId: "user-one" });
+        await pubsub.close();
+        await pubsub.close();
+        await expect(pubsub.publish(realtimeTopics.server, syncEvent)).rejects.toBeInstanceOf(PubSubClosedError);
+        await expect(pubsub.getPresenceSnapshot()).rejects.toBeInstanceOf(PubSubClosedError);
+        expect(listener).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=local.test.js.map

package/packages/happy2-server/dist/modules/realtime/local.test.js.map

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

package/packages/happy2-server/dist/modules/realtime/pubsub.d.ts

@@ -0,0 +1,26 @@
+import type { PresenceSnapshot, RealtimeEvent, RealtimeTopic } from "./events.js";
+export type RealtimeSubscriber = (event: RealtimeEvent) => void | Promise<void>;
+export type Unsubscribe = () => void;
+export interface PresenceConnection {
+    readonly connectionId: string;
+    readonly userId: string;
+    readonly occurredAt?: number;
+}
+/**
+ * Transport-neutral ephemeral fanout. A Redis adapter can implement the same
+ * contract without changing route code. No implementation may treat it as the
+ * source of truth for sync state.
+ */
+export interface PubSub {
+    publish(topic: RealtimeTopic, event: RealtimeEvent): Promise<void>;
+    subscribe(topic: RealtimeTopic, subscriber: RealtimeSubscriber): Unsubscribe;
+    connectPresence(connection: PresenceConnection): Promise<PresenceSnapshot>;
+    recordPresenceActivity(connectionId: string, occurredAt?: number): Promise<PresenceSnapshot | undefined>;
+    disconnectPresence(connectionId: string, occurredAt?: number): Promise<PresenceSnapshot | undefined>;
+    getPresenceSnapshot(userIds?: readonly string[]): Promise<readonly PresenceSnapshot[]>;
+    close(): Promise<void>;
+}
+export declare class PubSubClosedError extends Error {
+    constructor();
+}
+//# sourceMappingURL=pubsub.d.ts.map

package/packages/happy2-server/dist/modules/realtime/pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../../../sources/modules/realtime/pubsub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAChF,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACnB,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,GAAG,WAAW,CAAC;IAE7E,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3E,sBAAsB,CAClB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACzC,kBAAkB,CACd,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACzC,mBAAmB,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC;IAEvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,cAGC;CACJ"}

package/packages/happy2-server/dist/modules/realtime/pubsub.js

@@ -0,0 +1,7 @@
+export class PubSubClosedError extends Error {
+    constructor() {
+        super("PubSub is closed");
+        this.name = "PubSubClosedError";
+    }
+}
+//# sourceMappingURL=pubsub.js.map

package/packages/happy2-server/dist/modules/realtime/pubsub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../../../sources/modules/realtime/pubsub.ts"],"names":[],"mappings":"AAkCA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACxC;QACI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ"}

package/packages/happy2-server/dist/modules/request/database-idempotency.d.ts

@@ -0,0 +1,15 @@
+import { type Client } from "@libsql/client";
+import type { IdempotencyAcquireInput, IdempotencyAcquireResult, IdempotencyCompleteInput, IdempotencyStore } from "./idempotency.js";
+/** Shared SQLite/libSQL adapter; leases and fencing remain authoritative across processes. */
+export declare class DatabaseIdempotencyStore<TResponse> implements IdempotencyStore<TResponse> {
+    private readonly client;
+    private readonly db;
+    private readonly ownsClient;
+    constructor(source: string | Client, authToken?: string);
+    acquire(input: IdempotencyAcquireInput): Promise<IdempotencyAcquireResult<TResponse>>;
+    complete(input: IdempotencyCompleteInput<TResponse>): Promise<boolean>;
+    release(storageKey: string, token: string): Promise<boolean>;
+    purgeExpired(now: number, limit?: number): Promise<number>;
+    close(): void;
+}
+//# sourceMappingURL=database-idempotency.d.ts.map

package/packages/happy2-server/dist/modules/request/database-idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-idempotency.d.ts","sourceRoot":"","sources":["../../../sources/modules/request/database-idempotency.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,KAAK,EACR,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EACnB,MAAM,kBAAkB,CAAC;AAU1B,8FAA8F;AAC9F,qBAAa,wBAAwB,CAAC,SAAS,CAAE,YAAW,gBAAgB,CAAC,SAAS,CAAC;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC,YAAY,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAKtD;IAEK,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CA8C1F;IAEK,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB3E;IAEK,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBjE;IAEK,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB9D;IAED,KAAK,IAAI,IAAI,CAEZ;CACJ"}

package/packages/happy2-server/dist/modules/request/database-idempotency.js

@@ -0,0 +1,141 @@
+import { createId } from "@paralleldrive/cuid2";
+import { and, asc, eq, inArray, lte, sql } from "drizzle-orm";
+import { createClient } from "@libsql/client";
+import { createDatabase, retrySqliteBusy } from "../drizzle.js";
+import { idempotencyKeys } from "../schema.js";
+const requestKey = (storageKey) => and(eq(idempotencyKeys.principalType, "system"), eq(idempotencyKeys.principalId, "http"), eq(idempotencyKeys.scope, "request"), eq(idempotencyKeys.idempotencyKey, storageKey));
+/** Shared SQLite/libSQL adapter; leases and fencing remain authoritative across processes. */
+export class DatabaseIdempotencyStore {
+    client;
+    db;
+    ownsClient;
+    constructor(source, authToken) {
+        this.ownsClient = typeof source === "string";
+        this.client =
+            typeof source === "string" ? createClient({ url: source, authToken }) : source;
+        this.db = createDatabase(this.client);
+    }
+    async acquire(input) {
+        return retrySqliteBusy(() => this.db.transaction(async (tx) => {
+            let row = await find(tx, input.storageKey);
+            if (row && Date.parse(row.expiresAt) <= input.now) {
+                await tx.delete(idempotencyKeys).where(eq(idempotencyKeys.id, row.id));
+                row = undefined;
+            }
+            if (row) {
+                if (row.requestHash !== input.fingerprint)
+                    return { kind: "conflict" };
+                if (row.status === "completed")
+                    return {
+                        kind: "replay",
+                        response: JSON.parse(requiredJson(row.responseJson)),
+                    };
+                if (row.lockedUntil && Date.parse(row.lockedUntil) > input.now)
+                    return { kind: "in_progress", retryAt: Date.parse(row.lockedUntil) };
+                await tx
+                    .update(idempotencyKeys)
+                    .set({
+                    status: "in_progress",
+                    requestHash: input.fingerprint,
+                    responseStatus: null,
+                    responseJson: JSON.stringify({ leaseToken: input.leaseToken }),
+                    lockedUntil: iso(input.leaseExpiresAt),
+                    expiresAt: iso(input.recordExpiresAt),
+                    updatedAt: sql `CURRENT_TIMESTAMP`,
+                })
+                    .where(eq(idempotencyKeys.id, row.id));
+                return { kind: "acquired" };
+            }
+            await tx.insert(idempotencyKeys).values({
+                id: createId(),
+                principalType: "system",
+                principalId: "http",
+                scope: "request",
+                idempotencyKey: input.storageKey,
+                requestHash: input.fingerprint,
+                status: "in_progress",
+                responseJson: JSON.stringify({ leaseToken: input.leaseToken }),
+                lockedUntil: iso(input.leaseExpiresAt),
+                expiresAt: iso(input.recordExpiresAt),
+            });
+            return { kind: "acquired" };
+        }));
+    }
+    async complete(input) {
+        return retrySqliteBusy(() => this.db.transaction(async (tx) => {
+            const row = await find(tx, input.storageKey);
+            if (!row || row.status !== "in_progress")
+                return false;
+            if (leaseToken(row.responseJson) !== input.leaseToken)
+                return false;
+            const changed = await tx
+                .update(idempotencyKeys)
+                .set({
+                status: "completed",
+                responseJson: JSON.stringify(input.response),
+                lockedUntil: null,
+                expiresAt: iso(input.recordExpiresAt),
+                updatedAt: sql `CURRENT_TIMESTAMP`,
+            })
+                .where(and(eq(idempotencyKeys.id, row.id), eq(idempotencyKeys.status, "in_progress")))
+                .returning({ id: idempotencyKeys.id });
+            return changed.length === 1;
+        }));
+    }
+    async release(storageKey, token) {
+        return retrySqliteBusy(() => this.db.transaction(async (tx) => {
+            const row = await find(tx, storageKey);
+            if (!row || row.status !== "in_progress" || leaseToken(row.responseJson) !== token)
+                return false;
+            const changed = await tx
+                .delete(idempotencyKeys)
+                .where(and(eq(idempotencyKeys.id, row.id), eq(idempotencyKeys.status, "in_progress")))
+                .returning({ id: idempotencyKeys.id });
+            return changed.length === 1;
+        }));
+    }
+    async purgeExpired(now, limit = 1_000) {
+        return retrySqliteBusy(() => this.db.transaction(async (tx) => {
+            const due = await tx
+                .select({ id: idempotencyKeys.id })
+                .from(idempotencyKeys)
+                .where(lte(idempotencyKeys.expiresAt, iso(now)))
+                .orderBy(asc(idempotencyKeys.expiresAt), asc(idempotencyKeys.id))
+                .limit(limit);
+            if (due.length === 0)
+                return 0;
+            return (await tx
+                .delete(idempotencyKeys)
+                .where(inArray(idempotencyKeys.id, due.map(({ id }) => id)))
+                .returning({ id: idempotencyKeys.id })).length;
+        }));
+    }
+    close() {
+        if (this.ownsClient)
+            this.client.close();
+    }
+}
+async function find(executor, storageKey) {
+    const rows = await executor.select().from(idempotencyKeys).where(requestKey(storageKey));
+    return rows[0];
+}
+function leaseToken(value) {
+    if (typeof value !== "string")
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        return typeof parsed.leaseToken === "string" ? parsed.leaseToken : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function requiredJson(value) {
+    if (value === null)
+        throw new Error("Idempotency response is missing");
+    return value;
+}
+function iso(value) {
+    return new Date(value).toISOString();
+}
+//# sourceMappingURL=database-idempotency.js.map

package/packages/happy2-server/dist/modules/request/database-idempotency.js.map

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

package/packages/happy2-server/dist/modules/request/idempotency-hook.d.ts

@@ -0,0 +1,12 @@
+import type { FastifyInstance } from "fastify";
+import type { AuthService } from "../auth/service.js";
+import { type IdempotencyCoordinator } from "./idempotency.js";
+export interface StoredHttpResponse {
+    statusCode: number;
+    contentType?: string;
+    payload: string;
+    encoding: "utf8" | "base64";
+}
+/** Adds optional Idempotency-Key support uniformly to authenticated JSON POST actions. */
+export declare function registerIdempotencyHooks(app: FastifyInstance, auth: AuthService, coordinator: IdempotencyCoordinator<StoredHttpResponse>): void;
+//# sourceMappingURL=idempotency-hook.d.ts.map

package/packages/happy2-server/dist/modules/request/idempotency-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency-hook.d.ts","sourceRoot":"","sources":["../../../sources/modules/request/idempotency-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAKH,KAAK,sBAAsB,EAE9B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC/B;AAED,0FAA0F;AAC1F,wBAAgB,wBAAwB,CACpC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,GACxD,IAAI,CAwFN"}