@de-otio/trellis 0.4.0

package/dist/lib/friends-handler.d.ts

@@ -0,0 +1,78 @@
+import type { KVNamespace } from "../types/cloudflare-compat";
+/**
+ * Friends Handler class for managing user friendships and connection codes
+ *
+ * This handler manages:
+ * - Friend connections
+ * - Temporary connection codes for QR code scanning
+ * - Currently uses KV for storage, but can be extended to use database
+ */
+import { Session } from "./session-manager";
+export interface Friend {
+    id: string;
+    email: string;
+    actorUri?: string;
+    handle?: string;
+    status: "ACCEPTED" | "PENDING";
+    acceptedAt?: string;
+    friendshipId?: string;
+}
+export interface ConnectionCode {
+    code: string;
+    expiresAt: string;
+}
+export interface Env {
+    FRIENDS_KV?: KVNamespace;
+    CONNECTION_CODES_KV?: KVNamespace;
+    DATABASE_URL?: string;
+}
+export declare class FriendsHandler {
+    private readonly MAX_FRIENDS;
+    /**
+     * Generate a temporary, single-use connection code
+     */
+    generateConnectionCode(session: Session, env: Env): Promise<ConnectionCode>;
+    /**
+     * Use a connection code to create a friendship
+     */
+    useConnectionCode(session: Session, code: string, env: Env): Promise<{
+        success: boolean;
+        friendshipId?: string;
+    }>;
+    /**
+     * Get user's friends list
+     * Returns up to MAX_FRIENDS friends
+     */
+    getFriends(session: Session, status: "ACCEPTED" | "PENDING" | undefined, env: Env): Promise<Friend[]>;
+    /**
+     * Add friend to user's friends list (helper for maintaining list)
+     * Throws error if MAX_FRIENDS limit is reached
+     */
+    private addToFriendsList;
+    /**
+     * Generate a secure random code
+     */
+    private generateSecureCode;
+    /**
+     * Generate a unique ID
+     */
+    private generateId;
+    /**
+     * Handle GET request for friends list
+     */
+    handleGetFriends(request: Request, session: Session, env: Env): Promise<Response>;
+    /**
+     * Handle POST request for generating connection code
+     */
+    handleGenerateConnectionCode(request: Request, session: Session, env: Env): Promise<Response>;
+    /**
+     * Handle POST request for using connection code
+     */
+    handleConnect(request: Request, session: Session, env: Env): Promise<Response>;
+    /**
+     * Create friendship from invitation (after user confirms)
+     * POST /friends/connect-from-invitation
+     */
+    handleConnectFromInvitation(request: Request, session: Session, env: Env): Promise<Response>;
+}
+//# sourceMappingURL=friends-handler.d.ts.map

package/dist/lib/friends-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friends-handler.d.ts","sourceRoot":"","sources":["../../src/lib/friends-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,4BAA4B,CAAC;AACzF;;;;;;;GAOG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAI5C,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,GAAG;IAClB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,mBAAmB,CAAC,EAAE,WAAW,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAO;IAEnC;;OAEG;IACG,sBAAsB,CAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,cAAc,CAAC;IA8B1B;;OAEG;IACG,iBAAiB,CACrB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,GAAG,GACP,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmFvD;;;OAGG;IACG,UAAU,CACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,UAAU,GAAG,SAAS,YAAa,EAC3C,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,MAAM,EAAE,CAAC;IAwCpB;;;OAGG;YACW,gBAAgB;IAwB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,QAAQ,CAAC;IAyBpB;;OAEG;IACG,4BAA4B,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,QAAQ,CAAC;IAyBpB;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,QAAQ,CAAC;IAwCpB;;;OAGG;IACG,2BAA2B,CAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,QAAQ,CAAC;CA+IrB"}

package/dist/lib/friends-handler.js

@@ -0,0 +1,390 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FriendsHandler = void 0;
+const logger_1 = require("./logger");
+class FriendsHandler {
+    // Maximum number of friends a user can have
+    MAX_FRIENDS = 500;
+    /**
+     * Generate a temporary, single-use connection code
+     */
+    async generateConnectionCode(session, env) {
+        // Generate a secure random code (32 characters)
+        const code = this.generateSecureCode();
+        const expiresAt = new Date(Date.now() + 5 * 60 * 1000); // 5 minutes from now
+        // Store code in KV with user's ID
+        if (env.CONNECTION_CODES_KV || env.FRIENDS_KV) {
+            const kv = env.CONNECTION_CODES_KV || env.FRIENDS_KV;
+            const key = `connection-code:${code}`;
+            await kv.put(key, JSON.stringify({
+                userId: session.userId,
+                email: session.email,
+                createdAt: new Date().toISOString(),
+                expiresAt: expiresAt.toISOString(),
+                used: false,
+            }), {
+                expirationTtl: 300, // 5 minutes in seconds
+            });
+        }
+        return {
+            code,
+            expiresAt: expiresAt.toISOString(),
+        };
+    }
+    /**
+     * Use a connection code to create a friendship
+     */
+    async useConnectionCode(session, code, env) {
+        // Get code from KV
+        const kv = env.CONNECTION_CODES_KV || env.FRIENDS_KV;
+        if (!kv) {
+            throw new Error("Connection codes storage not available");
+        }
+        const key = `connection-code:${code}`;
+        const codeDataStr = await kv.get(key);
+        if (!codeDataStr) {
+            throw new Error("Invalid or expired connection code");
+        }
+        const codeData = JSON.parse(codeDataStr);
+        // Check if code is expired
+        if (new Date(codeData.expiresAt) < new Date()) {
+            await kv.delete(key);
+            throw new Error("Connection code has expired");
+        }
+        // Check if code has been used
+        if (codeData.used) {
+            throw new Error("Connection code has already been used");
+        }
+        // Check if user is trying to connect to themselves
+        if (codeData.userId === session.userId) {
+            throw new Error("Cannot connect to yourself");
+        }
+        // Mark code as used
+        codeData.used = true;
+        await kv.put(key, JSON.stringify(codeData), {
+            expirationTtl: 300, // Keep for 5 minutes even after use for audit
+        });
+        // Create friendship (using KV for now, can be migrated to database later)
+        const friendshipId = this.generateId();
+        const friendship = {
+            id: friendshipId,
+            requesterId: session.userId,
+            requesterEmail: session.email,
+            addresseeId: codeData.userId,
+            addresseeEmail: codeData.email,
+            status: "ACCEPTED", // QR code connection is automatically accepted
+            createdAt: new Date().toISOString(),
+            acceptedAt: new Date().toISOString(),
+        };
+        // Store friendship in KV
+        if (env.FRIENDS_KV) {
+            // Store bidirectional friendships
+            const requesterKey = `friendship:${session.userId}:${codeData.userId}`;
+            const addresseeKey = `friendship:${codeData.userId}:${session.userId}`;
+            await env.FRIENDS_KV.put(requesterKey, JSON.stringify(friendship));
+            await env.FRIENDS_KV.put(addresseeKey, JSON.stringify({
+                ...friendship,
+                requesterId: codeData.userId,
+                requesterEmail: codeData.email,
+                addresseeId: session.userId,
+                addresseeEmail: session.email,
+            }));
+            // Add to friends lists
+            await this.addToFriendsList(session.userId, codeData.userId, env);
+            await this.addToFriendsList(codeData.userId, session.userId, env);
+        }
+        // TODO: Future implementation - store in database when schema is ready
+        // TODO: Create bidirectional friendship records in database
+        return {
+            success: true,
+            friendshipId,
+        };
+    }
+    /**
+     * Get user's friends list
+     * Returns up to MAX_FRIENDS friends
+     */
+    async getFriends(session, status = "ACCEPTED", env) {
+        const friends = [];
+        if (env.FRIENDS_KV) {
+            // List all friendships for this user
+            // Note: KV doesn't support listing by prefix efficiently, so we'll need to store a list
+            // For now, we'll use a simple approach with a friends list key
+            const friendsListKey = `friends-list:${session.userId}`;
+            const friendsListStr = await env.FRIENDS_KV.get(friendsListKey);
+            if (friendsListStr) {
+                const friendsList = JSON.parse(friendsListStr);
+                // Limit iteration to MAX_FRIENDS for performance
+                const maxIterations = Math.min(friendsList.length, this.MAX_FRIENDS);
+                for (let i = 0; i < maxIterations; i++) {
+                    const friendId = friendsList[i];
+                    const friendshipKey = `friendship:${session.userId}:${friendId}`;
+                    const friendshipStr = await env.FRIENDS_KV.get(friendshipKey);
+                    if (friendshipStr) {
+                        const friendship = JSON.parse(friendshipStr);
+                        if (friendship.status === status) {
+                            friends.push({
+                                id: friendship.addresseeId,
+                                email: friendship.addresseeEmail,
+                                status: friendship.status,
+                                acceptedAt: friendship.acceptedAt,
+                                friendshipId: friendship.id,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // TODO: Future implementation - query from database when schema is ready
+        return friends;
+    }
+    /**
+     * Add friend to user's friends list (helper for maintaining list)
+     * Throws error if MAX_FRIENDS limit is reached
+     */
+    async addToFriendsList(userId, friendId, env) {
+        if (!env.FRIENDS_KV)
+            return;
+        const friendsListKey = `friends-list:${userId}`;
+        const friendsListStr = await env.FRIENDS_KV.get(friendsListKey);
+        const friendsList = friendsListStr ? JSON.parse(friendsListStr) : [];
+        if (!friendsList.includes(friendId)) {
+            // Check if user has reached the maximum number of friends
+            if (friendsList.length >= this.MAX_FRIENDS) {
+                throw new Error(`Maximum number of friends (${this.MAX_FRIENDS}) reached`);
+            }
+            friendsList.push(friendId);
+            await env.FRIENDS_KV.put(friendsListKey, JSON.stringify(friendsList));
+        }
+    }
+    /**
+     * Generate a secure random code
+     */
+    generateSecureCode() {
+        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+        let code = "";
+        for (let i = 0; i < 32; i++) {
+            code += chars.charAt(Math.floor(Math.random() * chars.length));
+        }
+        return code;
+    }
+    /**
+     * Generate a unique ID
+     */
+    generateId() {
+        return `friend_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Handle GET request for friends list
+     */
+    async handleGetFriends(request, session, env) {
+        try {
+            const url = new URL(request.url);
+            const status = (url.searchParams.get("status") || "ACCEPTED");
+            const friends = await this.getFriends(session, status, env);
+            return new Response(JSON.stringify({ friends }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            logger_1.Logger.getInstance(env).error("Error handling get friends:", error);
+            return new Response(JSON.stringify({ error: "Failed to get friends list" }), {
+                status: 500,
+                headers: { "content-type": "application/json" },
+            });
+        }
+    }
+    /**
+     * Handle POST request for generating connection code
+     */
+    async handleGenerateConnectionCode(request, session, env) {
+        try {
+            const connectionCode = await this.generateConnectionCode(session, env);
+            return new Response(JSON.stringify(connectionCode), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            logger_1.Logger.getInstance(env).error("Error handling generate connection code:", error);
+            return new Response(JSON.stringify({
+                error: error.message || "Failed to generate connection code",
+            }), {
+                status: 500,
+                headers: { "content-type": "application/json" },
+            });
+        }
+    }
+    /**
+     * Handle POST request for using connection code
+     */
+    async handleConnect(request, session, env) {
+        try {
+            const body = (await request.json());
+            const { code } = body;
+            if (!code || typeof code !== "string") {
+                return new Response(JSON.stringify({ error: "Connection code is required" }), {
+                    status: 400,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            const result = await this.useConnectionCode(session, code, env);
+            return new Response(JSON.stringify(result), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            logger_1.Logger.getInstance(env).error("Error handling connect:", error);
+            // Return 403 if maximum friends limit reached, otherwise 400
+            const isLimitError = error.message?.includes("Maximum number of friends");
+            const status = isLimitError ? 403 : 400;
+            return new Response(JSON.stringify({
+                error: error.message || "Failed to connect",
+            }), {
+                status,
+                headers: { "content-type": "application/json" },
+            });
+        }
+    }
+    /**
+     * Create friendship from invitation (after user confirms)
+     * POST /friends/connect-from-invitation
+     */
+    async handleConnectFromInvitation(request, session, env) {
+        try {
+            const body = (await request.json());
+            const { inviterId } = body;
+            if (!inviterId || typeof inviterId !== "string") {
+                return new Response(JSON.stringify({ error: "Inviter ID is required" }), {
+                    status: 400,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            // Check if user is trying to connect to themselves
+            if (inviterId === session.userId) {
+                return new Response(JSON.stringify({ error: "Cannot connect to yourself" }), {
+                    status: 400,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            // Get inviter's email from database
+            if (!env.DATABASE_URL) {
+                return new Response(JSON.stringify({ error: "Database not configured" }), {
+                    status: 500,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            // Get inviter with timeout/retry
+            const { sharedDatabaseConnectionManager } = await Promise.resolve().then(() => __importStar(require("./database-connection-manager")));
+            const { withQueryTimeoutAndRetry, QueryTimeoutPresets } = await Promise.resolve().then(() => __importStar(require("./db-query-helper")));
+            const { detectRegionSync } = await Promise.resolve().then(() => __importStar(require("./region-detection")));
+            const region = detectRegionSync(request, env);
+            const inviter = await withQueryTimeoutAndRetry(sharedDatabaseConnectionManager, region, env, async (db) => {
+                return await db.user.findUnique({
+                    where: { id: inviterId },
+                    select: { email: true },
+                });
+            }, {
+                ...QueryTimeoutPresets.USER_FACING,
+                maxRetries: 3,
+                baseDelayMs: 100,
+                context: {
+                    operation: "handleInvite_findInviter",
+                    userId: session.userId,
+                    inviterId,
+                },
+            });
+            if (!inviter || !inviter.email) {
+                return new Response(JSON.stringify({ error: "Inviter not found" }), {
+                    status: 404,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            // Create friendship using the same logic as useConnectionCode
+            const friendshipId = this.generateId();
+            const now = new Date().toISOString();
+            const friendship = {
+                id: friendshipId,
+                requesterId: session.userId,
+                requesterEmail: session.email,
+                addresseeId: inviterId,
+                addresseeEmail: inviter.email,
+                status: "ACCEPTED",
+                createdAt: now,
+                acceptedAt: now,
+            };
+            // Store bidirectional friendships in KV
+            if (env.FRIENDS_KV) {
+                const requesterKey = `friendship:${session.userId}:${inviterId}`;
+                const addresseeKey = `friendship:${inviterId}:${session.userId}`;
+                await env.FRIENDS_KV.put(requesterKey, JSON.stringify(friendship));
+                await env.FRIENDS_KV.put(addresseeKey, JSON.stringify({
+                    ...friendship,
+                    requesterId: inviterId,
+                    requesterEmail: inviter.email,
+                    addresseeId: session.userId,
+                    addresseeEmail: session.email,
+                }));
+                // Add to friends lists
+                await this.addToFriendsList(session.userId, inviterId, env);
+                await this.addToFriendsList(inviterId, session.userId, env);
+            }
+            return new Response(JSON.stringify({
+                success: true,
+                friendshipId,
+            }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        catch (error) {
+            logger_1.Logger.getInstance(env).error("Error handling connect from invitation:", error);
+            // Return 403 if maximum friends limit reached, otherwise 400
+            const isLimitError = error.message?.includes("Maximum number of friends");
+            const status = isLimitError ? 403 : 400;
+            return new Response(JSON.stringify({
+                error: error.message || "Failed to add friend",
+            }), {
+                status,
+                headers: { "content-type": "application/json" },
+            });
+        }
+    }
+}
+exports.FriendsHandler = FriendsHandler;
+//# sourceMappingURL=friends-handler.js.map

package/dist/lib/friends-handler.js.map

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

package/dist/lib/graph/dual-write-service.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Dual-Write Service Implementation
+ *
+ * Manages the consistency between Postgres (source of truth) and the graph
+ * database (Neo4j AuraDB / Docker Neo4j locally). Handlers call DualWriteService methods
+ * after a successful Prisma write to sync the corresponding graph state.
+ *
+ * Key responsibilities:
+ * - Inline retry with exponential backoff + jitter
+ * - Critical vs non-critical operation distinction
+ * - Async retry queue fallback for non-critical failures
+ * - In-memory failure tracking for MVP (SQS integration later)
+ *
+ * @see ./dual-write-strategy.md for the full design rationale
+ * @see ./dual-write.ts for the interface definition
+ */
+import type { GraphService } from "./graph-service";
+import type { DualWriteConfig, DualWriteFailure, DualWriteService, DualWriteSyncResult, ReconciliationProgress, ReconciliationResult, ConsistencyCheckResult } from "./dual-write";
+import type { SyncUserInput, SyncEntityInput, SyncPostInput, SyncPostSubjectsInput, SyncOwnershipInput } from "./types";
+/**
+ * Default implementation of the DualWriteService interface.
+ *
+ * Wraps a GraphService instance with retry logic and failure handling.
+ * Handlers call this instead of GraphService.sync* directly, so that
+ * retry, logging, and async fallback are centralized.
+ */
+export declare class DualWriteServiceImpl implements DualWriteService {
+    private readonly graphService;
+    private readonly maxRetries;
+    private readonly baseRetryDelayMs;
+    private readonly enableAsyncRetry;
+    /**
+     * In-memory queue of failed syncs for async retry.
+     * In production this would be backed by SQS (GRAPH_SYNC_QUEUE).
+     * For MVP, failures are accumulated here and can be processed via
+     * processRetry() or reconciliation.
+     */
+    private readonly failureQueue;
+    /**
+     * @param graphService - The underlying GraphService instance
+     * @param config - Optional retry and queue configuration
+     */
+    constructor(graphService: GraphService, config?: DualWriteConfig);
+    /** @inheritdoc */
+    syncUser(input: SyncUserInput): Promise<DualWriteSyncResult>;
+    /** @inheritdoc */
+    syncEntity(input: SyncEntityInput): Promise<DualWriteSyncResult>;
+    /** @inheritdoc */
+    syncPost(input: SyncPostInput): Promise<DualWriteSyncResult>;
+    /** @inheritdoc */
+    syncPostSubjects(input: SyncPostSubjectsInput): Promise<DualWriteSyncResult>;
+    /** @inheritdoc */
+    removeUser(userId: string): Promise<void>;
+    /** @inheritdoc */
+    removeEntity(entityId: string): Promise<void>;
+    /** @inheritdoc */
+    removePost(postId: string): Promise<DualWriteSyncResult>;
+    /** @inheritdoc */
+    syncOwnership(input: SyncOwnershipInput): Promise<void>;
+    /** @inheritdoc */
+    removeOwnership(entityId: string, userId: string): Promise<void>;
+    /** @inheritdoc */
+    processRetry(failure: DualWriteFailure): Promise<void>;
+    /** @inheritdoc */
+    reconcile(_options?: {
+        batchSize?: number;
+        maxRecordsPerModel?: number;
+        clearFirst?: boolean;
+        onProgress?: (progress: ReconciliationProgress) => void;
+    }): Promise<ReconciliationResult>;
+    /** @inheritdoc */
+    checkConsistency(_sampleSize?: number): Promise<ConsistencyCheckResult>;
+    /**
+     * Get a snapshot of the in-memory failure queue.
+     * In production, this would read from SQS instead.
+     */
+    getFailureQueue(): ReadonlyArray<DualWriteFailure>;
+    /**
+     * Get the number of queued failures.
+     */
+    getFailureCount(): number;
+    /**
+     * Execute a non-critical graph sync with inline retry and async fallback.
+     *
+     * On success: returns { status: "synced" }.
+     * On failure after retries: enqueues for async retry and returns
+     * { status: "queued", failureId } or { status: "failed", error }.
+     */
+    private executeNonCritical;
+    /**
+     * Execute a critical graph sync with inline retry.
+     *
+     * On success: returns void.
+     * On failure after retries: enqueues for async retry AND throws GraphSyncError.
+     */
+    private executeCritical;
+    /**
+     * Execute a function with inline retry (exponential backoff + jitter).
+     *
+     * @returns Success/failure result with attempt count and last error message.
+     */
+    private executeWithRetry;
+    /**
+     * Enqueue a failed sync for async retry.
+     *
+     * MVP: stores in an in-memory array (bounded to MAX_FAILURE_QUEUE_SIZE).
+     * Production: would send to SQS GRAPH_SYNC_QUEUE.
+     */
+    private enqueueFailure;
+    /**
+     * Map a DualWritePayload to the corresponding GraphService method call.
+     * Used by processRetry() to replay failed operations.
+     */
+    private getGraphServiceCall;
+}
+//# sourceMappingURL=dual-write-service.d.ts.map

package/dist/lib/graph/dual-write-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dual-write-service.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/dual-write-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAGhB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AA+DjB;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAE3C;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IAEvD;;;OAGG;gBACS,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,eAAe;IAWhE,kBAAkB;IACZ,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMlE,kBAAkB;IACZ,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMtE,kBAAkB;IACZ,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMlE,kBAAkB;IACZ,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAYlF,kBAAkB;IACZ,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,kBAAkB;IACZ,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD,kBAAkB;IACZ,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAU9D,kBAAkB;IACZ,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7D,kBAAkB;IACZ,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtE,kBAAkB;IACZ,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D,kBAAkB;IACZ,SAAS,CAAC,QAAQ,CAAC,EAAE;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;KACzD,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAUjC,kBAAkB;IACZ,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAY7E;;;OAGG;IACH,eAAe,IAAI,aAAa,CAAC,gBAAgB,CAAC;IAIlD;;OAEG;IACH,eAAe,IAAI,MAAM;IAQzB;;;;;;OAMG;YACW,kBAAkB;IAoBhC;;;;;OAKG;YACW,eAAe;IAmB7B;;;;OAIG;YACW,gBAAgB;IAuD9B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CA2B5B"}