happy2 0.0.5

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

@@ -0,0 +1,98 @@
+import { fingerprintFastifyRequest, IdempotencyStoreCapacityError, idempotencyRequestAction, idempotencyKeyFromRequest, } from "./idempotency.js";
+/** Adds optional Idempotency-Key support uniformly to authenticated JSON POST actions. */
+export function registerIdempotencyHooks(app, auth, coordinator) {
+    const leases = new WeakMap();
+    app.addHook("preHandler", async (request, reply) => {
+        if (request.method !== "POST")
+            return;
+        let key;
+        try {
+            key = idempotencyKeyFromRequest(request);
+        }
+        catch (error) {
+            return reply
+                .code(400)
+                .send({ error: "invalid_idempotency_key", message: message(error) });
+        }
+        if (!key)
+            return;
+        if (request.headers["content-type"]?.startsWith("multipart/form-data")) {
+            return reply.code(400).send({
+                error: "idempotency_not_supported_for_multipart",
+                message: "Use the resumable upload id for upload idempotency",
+            });
+        }
+        const current = await auth.authenticate(request);
+        if (!current)
+            return;
+        try {
+            const result = await coordinator.begin({
+                actorId: current.user.id,
+                scope: idempotencyRequestAction(request),
+                key,
+                fingerprint: fingerprintFastifyRequest(request),
+            });
+            if (result.kind === "conflict")
+                return reply.code(409).send({ error: "idempotency_key_reused" });
+            if (result.kind === "in_progress") {
+                const retryAfterSeconds = Math.max(1, Math.ceil(result.retryAfterMs / 1_000));
+                return reply
+                    .code(409)
+                    .header("retry-after", String(retryAfterSeconds))
+                    .send({ error: "idempotency_in_progress", retryAfterSeconds });
+            }
+            if (result.kind === "replay") {
+                if (result.response.contentType)
+                    reply.type(result.response.contentType);
+                reply.header("idempotency-replayed", "true").code(result.response.statusCode);
+                return reply.send(result.response.encoding === "base64"
+                    ? Buffer.from(result.response.payload, "base64")
+                    : result.response.payload);
+            }
+            leases.set(request, result.lease);
+        }
+        catch (error) {
+            if (error instanceof TypeError)
+                return reply
+                    .code(400)
+                    .send({ error: "invalid_idempotency_key", message: message(error) });
+            request.log.error(error, "Idempotency store failed");
+            if (error instanceof IdempotencyStoreCapacityError && error.retryAt) {
+                const retryAfter = Math.max(1, Math.ceil((error.retryAt - Date.now()) / 1_000));
+                reply.header("retry-after", String(retryAfter));
+            }
+            return reply.code(503).send({ error: "idempotency_unavailable" });
+        }
+    });
+    app.addHook("onSend", async (request, reply, payload) => {
+        const lease = leases.get(request);
+        if (!lease)
+            return payload;
+        leases.delete(request);
+        if (reply.statusCode >= 500) {
+            await coordinator.release(lease);
+            return payload;
+        }
+        const buffer = Buffer.isBuffer(payload) ? payload : undefined;
+        const response = {
+            statusCode: reply.statusCode,
+            contentType: reply.getHeader("content-type")?.toString(),
+            payload: buffer ? buffer.toString("base64") : String(payload ?? ""),
+            encoding: buffer ? "base64" : "utf8",
+        };
+        if (!(await coordinator.complete(lease, response)))
+            request.log.warn("Idempotency lease was lost before response completion");
+        return payload;
+    });
+    app.addHook("onError", async (request) => {
+        const lease = leases.get(request);
+        if (!lease)
+            return;
+        leases.delete(request);
+        await coordinator.release(lease).catch(() => false);
+    });
+}
+function message(error) {
+    return error instanceof Error ? error.message : "Invalid idempotency key";
+}
+//# sourceMappingURL=idempotency-hook.js.map

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

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

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

@@ -0,0 +1,146 @@
+import type { FastifyRequest } from "fastify";
+type Awaitable<T> = T | Promise<T>;
+export interface IdempotencyAcquireInput {
+    storageKey: string;
+    fingerprint: string;
+    leaseToken: string;
+    now: number;
+    leaseExpiresAt: number;
+    recordExpiresAt: number;
+}
+export type IdempotencyAcquireResult<TResponse> = {
+    kind: "acquired";
+} | {
+    kind: "replay";
+    response: TResponse;
+} | {
+    kind: "conflict";
+} | {
+    kind: "in_progress";
+    retryAt: number;
+};
+export interface IdempotencyCompleteInput<TResponse> {
+    storageKey: string;
+    leaseToken: string;
+    response: TResponse;
+    now: number;
+    recordExpiresAt: number;
+}
+/**
+ * Durable adapters must linearize operations per storageKey. The lease token is a
+ * fencing token: complete and release may mutate only the record owned by that
+ * token. Responses must be serializable by the selected adapter.
+ */
+export interface IdempotencyStore<TResponse> {
+    acquire(input: IdempotencyAcquireInput): Promise<IdempotencyAcquireResult<TResponse>>;
+    complete(input: IdempotencyCompleteInput<TResponse>): Promise<boolean>;
+    release(storageKey: string, leaseToken: string): Promise<boolean>;
+    purgeExpired(now: number, limit?: number): Promise<number>;
+    close?(): Awaitable<void>;
+}
+export interface LocalIdempotencyStoreOptions<TResponse> {
+    maxEntries?: number;
+    cleanupIntervalMs?: number;
+    cloneResponse?: (response: TResponse) => TResponse;
+}
+export declare class IdempotencyStoreCapacityError extends Error {
+    readonly retryAt?: number;
+    constructor(retryAt?: number);
+}
+/**
+ * A bounded single-process adapter. It is useful for local deployments and tests;
+ * multi-instance deployments should provide a database or Redis implementation of
+ * IdempotencyStore so acquisition and fencing remain shared and atomic.
+ */
+export declare class LocalIdempotencyStore<TResponse> implements IdempotencyStore<TResponse> {
+    private readonly entries;
+    private readonly maxEntries;
+    private readonly cleanupIntervalMs;
+    private readonly cloneResponse;
+    private lastCleanupAt;
+    constructor(options?: LocalIdempotencyStoreOptions<TResponse>);
+    get size(): number;
+    acquire(input: IdempotencyAcquireInput): Promise<IdempotencyAcquireResult<TResponse>>;
+    complete(input: IdempotencyCompleteInput<TResponse>): Promise<boolean>;
+    release(storageKey: string, leaseToken: string): Promise<boolean>;
+    purgeExpired(now: number, limit?: number): Promise<number>;
+    close(): void;
+    private earliestExpiry;
+}
+export interface IdempotencyCoordinatorOptions {
+    leaseMs?: number;
+    retentionMs?: number;
+    maxKeyLength?: number;
+    now?: () => number;
+    leaseToken?: () => string;
+}
+export interface BeginIdempotencyInput {
+    actorId: string;
+    scope: string;
+    key: string;
+    fingerprint: string;
+}
+export interface IdempotencyLease {
+    storageKey: string;
+    leaseToken: string;
+}
+export type BeginIdempotencyResult<TResponse> = {
+    kind: "acquired";
+    lease: IdempotencyLease;
+} | {
+    kind: "replay";
+    response: TResponse;
+} | {
+    kind: "conflict";
+} | {
+    kind: "in_progress";
+    retryAfterMs: number;
+};
+export type ExecuteIdempotencyResult<TResponse> = {
+    kind: "executed";
+    response: TResponse;
+} | {
+    kind: "replay";
+    response: TResponse;
+} | {
+    kind: "conflict";
+} | {
+    kind: "in_progress";
+    retryAfterMs: number;
+};
+export declare class IdempotencyLeaseLostError extends Error {
+    constructor();
+}
+export declare class IdempotencyCoordinator<TResponse> {
+    private readonly store;
+    private readonly leaseMs;
+    private readonly retentionMs;
+    private readonly maxKeyLength;
+    private readonly now;
+    private readonly leaseToken;
+    constructor(store: IdempotencyStore<TResponse>, options?: IdempotencyCoordinatorOptions);
+    begin(input: BeginIdempotencyInput): Promise<BeginIdempotencyResult<TResponse>>;
+    complete(lease: IdempotencyLease, response: TResponse): Promise<boolean>;
+    release(lease: IdempotencyLease): Promise<boolean>;
+    execute(input: BeginIdempotencyInput, operation: () => Promise<TResponse>): Promise<ExecuteIdempotencyResult<TResponse>>;
+    close(): Promise<void>;
+}
+export interface RequestFingerprintInput {
+    action: string;
+    method?: string;
+    contentType?: string;
+    query?: unknown;
+    payload?: unknown;
+}
+/** Hashes canonical JSON, so object key order does not create false conflicts. */
+export declare function createRequestFingerprint(input: RequestFingerprintInput): string;
+/**
+ * Uses Fastify's route template rather than the raw URL. Callers may override the
+ * payload when the body is not JSON (for example, with a precomputed file digest).
+ */
+export declare function fingerprintFastifyRequest(request: Pick<FastifyRequest, "body" | "headers" | "method" | "query" | "routeOptions" | "url">, payload?: unknown): string;
+export declare function idempotencyRequestAction(request: Pick<FastifyRequest, "method" | "url">): string;
+export declare function idempotencyKeyFromRequest(request: Pick<FastifyRequest, "headers">): string | undefined;
+export declare function createIdempotencyStorageKey(input: Pick<BeginIdempotencyInput, "actorId" | "scope" | "key">): string;
+export {};
+//# sourceMappingURL=idempotency.d.ts.map

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

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

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

@@ -0,0 +1,312 @@
+import { createHash } from "node:crypto";
+import { createId } from "@paralleldrive/cuid2";
+export class IdempotencyStoreCapacityError extends Error {
+    retryAt;
+    constructor(retryAt) {
+        super("Idempotency store capacity is exhausted");
+        this.name = "IdempotencyStoreCapacityError";
+        this.retryAt = retryAt;
+    }
+}
+/**
+ * A bounded single-process adapter. It is useful for local deployments and tests;
+ * multi-instance deployments should provide a database or Redis implementation of
+ * IdempotencyStore so acquisition and fencing remain shared and atomic.
+ */
+export class LocalIdempotencyStore {
+    entries = new Map();
+    maxEntries;
+    cleanupIntervalMs;
+    cloneResponse;
+    lastCleanupAt = Number.NEGATIVE_INFINITY;
+    constructor(options = {}) {
+        this.maxEntries = positiveInteger(options.maxEntries ?? 10_000, "maxEntries");
+        this.cleanupIntervalMs = positiveInteger(options.cleanupIntervalMs ?? 60_000, "cleanupIntervalMs");
+        this.cloneResponse = options.cloneResponse ?? ((response) => structuredClone(response));
+    }
+    get size() {
+        return this.entries.size;
+    }
+    async acquire(input) {
+        validateAcquireInput(input);
+        if (input.now - this.lastCleanupAt >= this.cleanupIntervalMs)
+            await this.purgeExpired(input.now);
+        let entry = this.entries.get(input.storageKey);
+        if (entry && entry.recordExpiresAt <= input.now) {
+            this.entries.delete(input.storageKey);
+            entry = undefined;
+        }
+        if (entry) {
+            if (entry.fingerprint !== input.fingerprint)
+                return { kind: "conflict" };
+            if (entry.state === "completed")
+                return { kind: "replay", response: this.cloneResponse(entry.response) };
+            if (entry.leaseExpiresAt > input.now)
+                return { kind: "in_progress", retryAt: entry.leaseExpiresAt };
+            this.entries.set(input.storageKey, pendingEntry(input));
+            return { kind: "acquired" };
+        }
+        if (this.entries.size >= this.maxEntries) {
+            await this.purgeExpired(input.now);
+            if (this.entries.size >= this.maxEntries)
+                throw new IdempotencyStoreCapacityError(this.earliestExpiry());
+        }
+        this.entries.set(input.storageKey, pendingEntry(input));
+        return { kind: "acquired" };
+    }
+    async complete(input) {
+        validateCompleteInput(input);
+        const entry = this.entries.get(input.storageKey);
+        if (!entry || entry.state !== "pending" || entry.leaseToken !== input.leaseToken)
+            return false;
+        this.entries.set(input.storageKey, {
+            state: "completed",
+            fingerprint: entry.fingerprint,
+            response: this.cloneResponse(input.response),
+            recordExpiresAt: input.recordExpiresAt,
+        });
+        return true;
+    }
+    async release(storageKey, leaseToken) {
+        boundedString(storageKey, "storageKey", 512);
+        boundedString(leaseToken, "leaseToken", 256);
+        const entry = this.entries.get(storageKey);
+        if (!entry || entry.state !== "pending" || entry.leaseToken !== leaseToken)
+            return false;
+        return this.entries.delete(storageKey);
+    }
+    async purgeExpired(now, limit = Number.MAX_SAFE_INTEGER) {
+        if (!Number.isFinite(now))
+            throw new TypeError("now must be finite");
+        positiveInteger(limit, "limit");
+        let deleted = 0;
+        for (const [key, entry] of this.entries) {
+            if (deleted >= limit)
+                break;
+            if (entry.recordExpiresAt > now)
+                continue;
+            this.entries.delete(key);
+            deleted += 1;
+        }
+        this.lastCleanupAt = now;
+        return deleted;
+    }
+    close() {
+        this.entries.clear();
+    }
+    earliestExpiry() {
+        let earliest;
+        for (const entry of this.entries.values()) {
+            if (earliest === undefined || entry.recordExpiresAt < earliest)
+                earliest = entry.recordExpiresAt;
+        }
+        return earliest;
+    }
+}
+export class IdempotencyLeaseLostError extends Error {
+    constructor() {
+        super("Idempotency lease was lost before its result could be recorded");
+        this.name = "IdempotencyLeaseLostError";
+    }
+}
+export class IdempotencyCoordinator {
+    store;
+    leaseMs;
+    retentionMs;
+    maxKeyLength;
+    now;
+    leaseToken;
+    constructor(store, options = {}) {
+        this.store = store;
+        this.leaseMs = positiveInteger(options.leaseMs ?? 30_000, "leaseMs");
+        this.retentionMs = positiveInteger(options.retentionMs ?? 24 * 60 * 60_000, "retentionMs");
+        if (this.retentionMs < this.leaseMs)
+            throw new TypeError("retentionMs must be greater than or equal to leaseMs");
+        this.maxKeyLength = positiveInteger(options.maxKeyLength ?? 200, "maxKeyLength");
+        this.now = options.now ?? Date.now;
+        this.leaseToken = options.leaseToken ?? createId;
+    }
+    async begin(input) {
+        validatePublicInput(input, this.maxKeyLength);
+        const now = this.now();
+        const leaseToken = this.leaseToken();
+        boundedString(leaseToken, "leaseToken", 256);
+        const storageKey = createIdempotencyStorageKey(input);
+        const result = await this.store.acquire({
+            storageKey,
+            fingerprint: input.fingerprint,
+            leaseToken,
+            now,
+            leaseExpiresAt: now + this.leaseMs,
+            recordExpiresAt: now + this.retentionMs,
+        });
+        if (result.kind === "acquired")
+            return { kind: "acquired", lease: { storageKey, leaseToken } };
+        if (result.kind === "in_progress")
+            return { kind: "in_progress", retryAfterMs: Math.max(1, result.retryAt - now) };
+        return result;
+    }
+    async complete(lease, response) {
+        const now = this.now();
+        return this.store.complete({
+            ...lease,
+            response,
+            now,
+            recordExpiresAt: now + this.retentionMs,
+        });
+    }
+    async release(lease) {
+        return this.store.release(lease.storageKey, lease.leaseToken);
+    }
+    async execute(input, operation) {
+        const result = await this.begin(input);
+        if (result.kind !== "acquired")
+            return result;
+        try {
+            const response = await operation();
+            if (!(await this.complete(result.lease, response)))
+                throw new IdempotencyLeaseLostError();
+            return { kind: "executed", response };
+        }
+        catch (error) {
+            // A failed release merely leaves the short lease in place; never mask the
+            // operation error. Side effects and completion should share a transaction
+            // whenever the durable adapter supports one.
+            await this.release(result.lease).catch(() => false);
+            throw error;
+        }
+    }
+    async close() {
+        await this.store.close?.();
+    }
+}
+/** Hashes canonical JSON, so object key order does not create false conflicts. */
+export function createRequestFingerprint(input) {
+    boundedString(input.action, "action", 512);
+    const envelope = {
+        action: input.action,
+        method: (input.method ?? "POST").toUpperCase(),
+        payload: input.payload ?? null,
+        query: input.query ?? null,
+    };
+    if (input.contentType)
+        envelope.contentType = normalizedContentType(input.contentType);
+    return createHash("sha256").update(canonicalJson(envelope), "utf8").digest("hex");
+}
+/**
+ * Uses Fastify's route template rather than the raw URL. Callers may override the
+ * payload when the body is not JSON (for example, with a precomputed file digest).
+ */
+export function fingerprintFastifyRequest(request, payload = request.body) {
+    return createRequestFingerprint({
+        action: idempotencyRequestAction(request),
+        method: request.method,
+        contentType: request.headers["content-type"],
+        query: request.query,
+        payload,
+    });
+}
+export function idempotencyRequestAction(request) {
+    const path = request.url.split("?", 1)[0] ?? request.url;
+    return `${request.method.toUpperCase()}:${path}`;
+}
+export function idempotencyKeyFromRequest(request) {
+    const value = request.headers["idempotency-key"];
+    if (value === undefined)
+        return undefined;
+    if (Array.isArray(value))
+        throw new TypeError("Idempotency-Key must occur exactly once");
+    return value;
+}
+export function createIdempotencyStorageKey(input) {
+    boundedString(input.actorId, "actorId", 256);
+    boundedString(input.scope, "scope", 256);
+    boundedString(input.key, "key", 1_024);
+    return createHash("sha256")
+        .update(canonicalJson([input.actorId, input.scope, input.key]), "utf8")
+        .digest("hex");
+}
+function pendingEntry(input) {
+    return {
+        state: "pending",
+        fingerprint: input.fingerprint,
+        leaseToken: input.leaseToken,
+        leaseExpiresAt: input.leaseExpiresAt,
+        recordExpiresAt: input.recordExpiresAt,
+    };
+}
+function validatePublicInput(input, maxKeyLength) {
+    boundedString(input.actorId, "actorId", 256);
+    boundedString(input.scope, "scope", 256);
+    boundedString(input.fingerprint, "fingerprint", 512);
+    boundedString(input.key, "key", maxKeyLength);
+    if (!/^[\x21-\x7e]+$/.test(input.key))
+        throw new TypeError("key must contain only visible ASCII characters without spaces");
+}
+function validateAcquireInput(input) {
+    boundedString(input.storageKey, "storageKey", 512);
+    boundedString(input.fingerprint, "fingerprint", 512);
+    boundedString(input.leaseToken, "leaseToken", 256);
+    finiteTimestamp(input.now, "now");
+    finiteTimestamp(input.leaseExpiresAt, "leaseExpiresAt");
+    finiteTimestamp(input.recordExpiresAt, "recordExpiresAt");
+    if (input.leaseExpiresAt <= input.now)
+        throw new TypeError("leaseExpiresAt must follow now");
+    if (input.recordExpiresAt < input.leaseExpiresAt)
+        throw new TypeError("recordExpiresAt must not precede leaseExpiresAt");
+}
+function validateCompleteInput(input) {
+    boundedString(input.storageKey, "storageKey", 512);
+    boundedString(input.leaseToken, "leaseToken", 256);
+    finiteTimestamp(input.now, "now");
+    finiteTimestamp(input.recordExpiresAt, "recordExpiresAt");
+    if (input.recordExpiresAt <= input.now)
+        throw new TypeError("recordExpiresAt must follow now");
+}
+function normalizedContentType(value) {
+    return value.split(";", 1)[0].trim().toLowerCase();
+}
+function canonicalJson(value, ancestors = new Set()) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string" || typeof value === "boolean")
+        return JSON.stringify(value);
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new TypeError("fingerprint values must be finite");
+        return JSON.stringify(value);
+    }
+    if (typeof value !== "object")
+        throw new TypeError("fingerprint values must contain only JSON-compatible data");
+    if (ancestors.has(value))
+        throw new TypeError("fingerprint values must not be cyclic");
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value))
+            return `[${value.map((item) => canonicalJson(item, ancestors)).join(",")}]`;
+        if (Object.getPrototypeOf(value) !== Object.prototype &&
+            Object.getPrototypeOf(value) !== null)
+            throw new TypeError("fingerprint objects must be plain objects");
+        return `{${Object.keys(value)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key], ancestors)}`)
+            .join(",")}}`;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value <= 0)
+        throw new TypeError(`${name} must be a positive safe integer`);
+    return value;
+}
+function finiteTimestamp(value, name) {
+    if (!Number.isFinite(value))
+        throw new TypeError(`${name} must be finite`);
+}
+function boundedString(value, name, maxLength) {
+    if (value.length === 0 || value.length > maxLength)
+        throw new TypeError(`${name} must contain 1-${maxLength} characters`);
+}
+//# sourceMappingURL=idempotency.js.map

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

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

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

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

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

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