happy2 0.0.5 → 0.0.11

package/packages/happy2-server/dist/modules/sync/chatSyncGetDifference.js

@@ -0,0 +1,103 @@
+import { CollaborationError } from "../chat/types.js";
+import {} from "../drizzle.js";
+import { and, asc, eq, gt, lte } from "drizzle-orm";
+import { chats, chatUpdates } from "../schema.js";
+import { number } from "../chat/number.js";
+import { optionalText } from "../chat/optionalText.js";
+import { text } from "../chat/text.js";
+import { chatGet } from "../chat/chatGet.js";
+import { messageGetProjection } from "../message/messageGetProjection.js";
+/**
+ * Reconciles one accessible chat from a membership epoch and points cursor, including affected message projections.
+ * Reset, retention, slicing, and future-cursor decisions live here so clients advance chat state without skipping durable updates.
+ */
+export async function chatSyncGetDifference(executor, input) {
+    const chat = await chatGet(executor, input.userId, input.chatId);
+    const currentPts = number(chat.pts);
+    const currentEpoch = chat.membershipEpoch;
+    if (input.untilPts !== undefined && input.untilPts > currentPts)
+        throw new CollaborationError("future_state", "Chat target is ahead of the server");
+    const target = Math.min(input.untilPts ?? currentPts, currentPts);
+    const base = {
+        updates: [],
+        messages: [],
+        chat,
+        state: {
+            membershipEpoch: currentEpoch,
+            pts: String(currentPts),
+        },
+        targetState: {
+            membershipEpoch: currentEpoch,
+            pts: String(currentPts),
+        },
+    };
+    if (currentEpoch !== input.membershipEpoch)
+        return {
+            kind: "reset",
+            ...base,
+        };
+    if (input.fromPts > currentPts || target < input.fromPts)
+        throw new CollaborationError("future_state", "Chat cursor is ahead of the server");
+    const [recoverable] = await executor
+        .select({
+        minRecoverablePts: chats.minRecoverablePts,
+    })
+        .from(chats)
+        .where(eq(chats.id, input.chatId));
+    if (input.fromPts < (recoverable?.minRecoverablePts ?? 0))
+        return {
+            kind: "tooLong",
+            ...base,
+        };
+    const result = await executor
+        .select({
+        pts: chatUpdates.pts,
+        pts_count: chatUpdates.ptsCount,
+        kind: chatUpdates.kind,
+        entity_id: chatUpdates.entityId,
+    })
+        .from(chatUpdates)
+        .where(and(eq(chatUpdates.chatId, input.chatId), gt(chatUpdates.pts, input.fromPts), lte(chatUpdates.pts, target)))
+        .orderBy(asc(chatUpdates.pts))
+        .limit(input.limit + 1);
+    const hasMore = result.length > input.limit;
+    const rows = result.slice(0, input.limit);
+    const intermediate = hasMore ? number(rows.at(-1)?.pts) : target;
+    const updates = rows.map((row) => ({
+        pts: text(row.pts),
+        ptsCount: 1,
+        kind: text(row.kind),
+        entityId: optionalText(row.entity_id),
+    }));
+    const messageIds = new Set(updates
+        .filter((update) => update.entityId &&
+        (update.kind.startsWith("message.") ||
+            update.kind.startsWith("reaction.") ||
+            update.kind.startsWith("thread.") ||
+            update.kind.startsWith("receipt.")))
+        .map((update) => update.entityId));
+    const messages = [];
+    for (const messageId of messageIds) {
+        const message = await messageGetProjection(executor, input.userId, messageId);
+        if (!message)
+            continue;
+        messages.push(message);
+    }
+    const state = {
+        membershipEpoch: currentEpoch,
+        pts: String(intermediate),
+    };
+    const targetState = {
+        membershipEpoch: currentEpoch,
+        pts: String(target),
+    };
+    return {
+        kind: rows.length === 0 ? "empty" : hasMore ? "slice" : "difference",
+        updates,
+        messages,
+        chat: await chatGet(executor, input.userId, input.chatId),
+        state,
+        targetState,
+    };
+}
+//# sourceMappingURL=chatSyncGetDifference.js.map

package/packages/happy2-server/dist/modules/sync/chatSyncGetDifference.js.map

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

package/packages/happy2-server/dist/modules/sync/impl/stateAt.d.ts

@@ -0,0 +1,3 @@
+import { type SyncState } from "../../chat/types.js";
+export declare function stateAt(generation: string, sequence: number): SyncState;
+//# sourceMappingURL=stateAt.d.ts.map

package/packages/happy2-server/dist/modules/sync/impl/stateAt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateAt.d.ts","sourceRoot":"","sources":["../../../../sources/modules/sync/impl/stateAt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAMvE"}

package/packages/happy2-server/dist/modules/sync/impl/stateAt.js

@@ -0,0 +1,9 @@
+import {} from "../../chat/types.js";
+export function stateAt(generation, sequence) {
+    return {
+        protocolVersion: 1,
+        generation,
+        sequence: String(sequence),
+    };
+}
+//# sourceMappingURL=stateAt.js.map

package/packages/happy2-server/dist/modules/sync/impl/stateAt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateAt.js","sourceRoot":"","sources":["../../../../sources/modules/sync/impl/stateAt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,MAAM,qBAAqB,CAAC;AACrD,MAAM,UAAU,OAAO,CAAC,UAAkB,EAAE,QAAgB;IACxD,OAAO;QACH,eAAe,EAAE,CAAC;QAClB,UAAU;QACV,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;KAC7B,CAAC;AACN,CAAC"}

package/packages/happy2-server/dist/modules/sync/impl/syncState.d.ts

@@ -0,0 +1,3 @@
+import { type SyncState } from "../../chat/types.js";
+export declare function syncState(row: Record<string, unknown>): SyncState;
+//# sourceMappingURL=syncState.d.ts.map

package/packages/happy2-server/dist/modules/sync/impl/syncState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncState.d.ts","sourceRoot":"","sources":["../../../../sources/modules/sync/impl/syncState.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAEjE"}

package/packages/happy2-server/dist/modules/sync/impl/syncState.js

@@ -0,0 +1,8 @@
+import { number } from "../../chat/number.js";
+import { stateAt } from "./stateAt.js";
+import {} from "../../chat/types.js";
+import { text } from "../../chat/text.js";
+export function syncState(row) {
+    return stateAt(text(row.generation), number(row.sequence));
+}
+//# sourceMappingURL=syncState.js.map

package/packages/happy2-server/dist/modules/sync/impl/syncState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncState.js","sourceRoot":"","sources":["../../../../sources/modules/sync/impl/syncState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAkB,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,MAAM,UAAU,SAAS,CAAC,GAA4B;IAClD,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/packages/happy2-server/dist/modules/sync/syncCompact.d.ts

@@ -0,0 +1,12 @@
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Records a syncCompactions boundary and prunes syncEvents, chatUpdates, clientMutations, and idempotencyKeys that fall safely behind retained cursors.
+ * One compaction transaction prevents clients from being told a boundary is usable before every associated history set has been pruned consistently.
+ */
+export declare function syncCompact(executor: DrizzleExecutor): Promise<{
+    minRecoverableSequence: string;
+    eventsDeleted: number;
+    mutationsDeleted: number;
+    chatUpdatesDeleted: number;
+}>;
+//# sourceMappingURL=syncCompact.d.ts.map

package/packages/happy2-server/dist/modules/sync/syncCompact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncCompact.d.ts","sourceRoot":"","sources":["../../../sources/modules/sync/syncCompact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,eAAe,CAAC;AAmBtE;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC;IAClE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC9B,CAAC,CAoJD"}

package/packages/happy2-server/dist/modules/sync/syncCompact.js

@@ -0,0 +1,141 @@
+import { withTransaction } from "../drizzle.js";
+import { and, eq, isNull, lte, or, sql } from "drizzle-orm";
+import { chats, chatSyncCompactions, chatUpdates, clientMutations, idempotencyKeys, serverSettings, serverSyncState, syncCompactions, syncConsumers, syncEvents, } from "../schema.js";
+import { createId } from "@paralleldrive/cuid2";
+import { number } from "../chat/number.js";
+/**
+ * Records a syncCompactions boundary and prunes syncEvents, chatUpdates, clientMutations, and idempotencyKeys that fall safely behind retained cursors.
+ * One compaction transaction prevents clients from being told a boundary is usable before every associated history set has been pruned consistently.
+ */
+export async function syncCompact(executor) {
+    return withTransaction(executor, async (tx) => {
+        const [state] = await tx
+            .select({
+            generation: serverSyncState.generation,
+            sequence: serverSyncState.sequence,
+            minRecoverableSequence: serverSyncState.minRecoverableSequence,
+        })
+            .from(serverSyncState)
+            .where(eq(serverSyncState.id, 1));
+        const [settings] = await tx
+            .select({
+            syncEventRetentionSeconds: serverSettings.syncEventRetentionSeconds,
+            chatUpdateRetentionSeconds: serverSettings.chatUpdateRetentionSeconds,
+            idempotencyRetentionSeconds: serverSettings.idempotencyRetentionSeconds,
+        })
+            .from(serverSettings)
+            .where(eq(serverSettings.id, 1));
+        if (!state || !settings)
+            throw new Error("Sync retention settings are missing");
+        const retentionSeconds = settings.syncEventRetentionSeconds;
+        const [candidate] = await tx
+            .select({
+            sequence: sql `coalesce(max(${syncEvents.sequence}), 0)`,
+        })
+            .from(syncEvents)
+            .where(sql `datetime(${syncEvents.createdAt}) < datetime('now', '-' || ${retentionSeconds} || ' seconds')`);
+        const [activeFloor] = await tx
+            .select({
+            sequence: sql `min(${syncConsumers.sequence})`,
+        })
+            .from(syncConsumers)
+            .where(and(isNull(syncConsumers.revokedAt), eq(syncConsumers.generation, state.generation), sql `datetime(${syncConsumers.lastSeenAt}) >= datetime('now', '-90 days')`));
+        const previousMin = state.minRecoverableSequence;
+        const candidateSequence = number(candidate?.sequence, 0);
+        const consumerSequence = activeFloor?.sequence === null || activeFloor?.sequence === undefined
+            ? state.sequence
+            : number(activeFloor.sequence);
+        const newMin = Math.max(previousMin, Math.min(candidateSequence, consumerSequence));
+        const compactionId = createId();
+        await tx.insert(syncCompactions).values({
+            id: compactionId,
+            generation: state.generation,
+            previousMinSequence: previousMin,
+            newMinSequence: newMin,
+        });
+        const deletedEvents = newMin > previousMin
+            ? await tx.delete(syncEvents).where(lte(syncEvents.sequence, newMin)).returning({
+                id: syncEvents.id,
+            })
+            : [];
+        const mutationRetention = settings.idempotencyRetentionSeconds;
+        const deletedMutations = await tx
+            .delete(clientMutations)
+            .where(or(and(sql `${clientMutations.expiresAt} IS NOT NULL`, sql `datetime(${clientMutations.expiresAt}) <= CURRENT_TIMESTAMP`), sql `datetime(${clientMutations.createdAt}) < datetime('now', '-' || ${mutationRetention} || ' seconds')`))
+            .returning({
+            actorUserId: clientMutations.actorUserId,
+        });
+        await tx
+            .delete(idempotencyKeys)
+            .where(sql `datetime(${idempotencyKeys.expiresAt}) <= CURRENT_TIMESTAMP`);
+        const chatRetention = settings.chatUpdateRetentionSeconds;
+        const compactedChats = await tx
+            .select({
+            chatId: chatUpdates.chatId,
+            newMinPts: sql `max(${chatUpdates.pts})`,
+        })
+            .from(chatUpdates)
+            .where(sql `datetime(${chatUpdates.createdAt}) < datetime('now', '-' || ${chatRetention} || ' seconds')`)
+            .groupBy(chatUpdates.chatId);
+        let chatUpdatesDeleted = 0;
+        for (const chat of compactedChats) {
+            const chatId = chat.chatId;
+            const newMinPts = chat.newMinPts;
+            const [current] = await tx
+                .select({
+                minRecoverablePts: chats.minRecoverablePts,
+            })
+                .from(chats)
+                .where(eq(chats.id, chatId));
+            const previousMinPts = current?.minRecoverablePts ?? 0;
+            if (newMinPts <= previousMinPts)
+                continue;
+            const deleted = await tx
+                .delete(chatUpdates)
+                .where(and(eq(chatUpdates.chatId, chatId), lte(chatUpdates.pts, newMinPts)))
+                .returning({
+                pts: chatUpdates.pts,
+            });
+            chatUpdatesDeleted += deleted.length;
+            await tx
+                .update(chats)
+                .set({
+                minRecoverablePts: newMinPts,
+            })
+                .where(eq(chats.id, chatId));
+            await tx.insert(chatSyncCompactions).values({
+                id: createId(),
+                chatId,
+                previousMinPts,
+                newMinPts,
+                updatesDeleted: deleted.length,
+            });
+        }
+        await tx
+            .update(serverSyncState)
+            .set({
+            minRecoverableSequence: newMin,
+            lastCompactedAt: sql `CURRENT_TIMESTAMP`,
+            compactionVersion: sql `${serverSyncState.compactionVersion} + 1`,
+        })
+            .where(eq(serverSyncState.id, 1));
+        await tx
+            .update(syncCompactions)
+            .set({
+            eventsDeleted: deletedEvents.length,
+            mutationsDeleted: deletedMutations.length,
+            completedAt: sql `CURRENT_TIMESTAMP`,
+            detailsJson: JSON.stringify({
+                chatUpdatesDeleted,
+            }),
+        })
+            .where(eq(syncCompactions.id, compactionId));
+        return {
+            minRecoverableSequence: String(newMin),
+            eventsDeleted: deletedEvents.length,
+            mutationsDeleted: deletedMutations.length,
+            chatUpdatesDeleted,
+        };
+    });
+}
+//# sourceMappingURL=syncCompact.js.map

package/packages/happy2-server/dist/modules/sync/syncCompact.js.map

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

package/packages/happy2-server/dist/modules/sync/syncConsumerAcknowledge.d.ts

@@ -0,0 +1,12 @@
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Upserts syncConsumers only after the active user and serverSyncState generation and recoverable range are validated.
+ * The max-sequence conflict update prevents a stale device acknowledgement from moving its durable cursor backward.
+ */
+export declare function syncConsumerAcknowledge(executor: DrizzleExecutor, input: {
+    userId: string;
+    deviceId: string;
+    generation: string;
+    sequence: number;
+}): Promise<void>;
+//# sourceMappingURL=syncConsumerAcknowledge.d.ts.map

package/packages/happy2-server/dist/modules/sync/syncConsumerAcknowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncConsumerAcknowledge.d.ts","sourceRoot":"","sources":["../../../sources/modules/sync/syncConsumerAcknowledge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAOrD;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACpB,GACF,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/packages/happy2-server/dist/modules/sync/syncConsumerAcknowledge.js

@@ -0,0 +1,49 @@
+import { CollaborationError } from "../chat/types.js";
+import {} from "../drizzle.js";
+import { createId } from "@paralleldrive/cuid2";
+import { eq, sql } from "drizzle-orm";
+import { number } from "../chat/number.js";
+import { serverSyncState, syncConsumers } from "../schema.js";
+import { userRequireActive } from "../chat/userRequireActive.js";
+/**
+ * Upserts syncConsumers only after the active user and serverSyncState generation and recoverable range are validated.
+ * The max-sequence conflict update prevents a stale device acknowledgement from moving its durable cursor backward.
+ */
+export async function syncConsumerAcknowledge(executor, input) {
+    await userRequireActive(executor, input.userId);
+    const [state] = await executor
+        .select({
+        generation: serverSyncState.generation,
+        sequence: serverSyncState.sequence,
+        min_recoverable_sequence: serverSyncState.minRecoverableSequence,
+    })
+        .from(serverSyncState)
+        .where(eq(serverSyncState.id, 1));
+    if (!state)
+        throw new Error("Sync state has not been initialized");
+    if (input.generation !== state.generation)
+        throw new CollaborationError("generation_mismatch", "Sync generation has changed");
+    if (input.sequence > number(state.sequence))
+        throw new CollaborationError("future_state", "Sync cursor is ahead of the server");
+    if (input.sequence < number(state.min_recoverable_sequence, 0))
+        throw new CollaborationError("conflict", "Sync cursor is no longer recoverable");
+    await executor
+        .insert(syncConsumers)
+        .values({
+        id: createId(),
+        userId: input.userId,
+        deviceId: input.deviceId,
+        generation: input.generation,
+        sequence: input.sequence,
+    })
+        .onConflictDoUpdate({
+        target: [syncConsumers.userId, syncConsumers.deviceId],
+        set: {
+            generation: input.generation,
+            sequence: sql `max(${syncConsumers.sequence}, excluded.sequence)`,
+            lastSeenAt: sql `CURRENT_TIMESTAMP`,
+            revokedAt: null,
+        },
+    });
+}
+//# sourceMappingURL=syncConsumerAcknowledge.js.map

package/packages/happy2-server/dist/modules/sync/syncConsumerAcknowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncConsumerAcknowledge.js","sourceRoot":"","sources":["../../../sources/modules/sync/syncConsumerAcknowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAwB,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,QAAyB,EACzB,KAKC;IAED,MAAM,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,QAAQ;SACzB,MAAM,CAAC;QACJ,UAAU,EAAE,eAAe,CAAC,UAAU;QACtC,QAAQ,EAAE,eAAe,CAAC,QAAQ;QAClC,wBAAwB,EAAE,eAAe,CAAC,sBAAsB;KACnE,CAAC;SACD,IAAI,CAAC,eAAe,CAAC;SACrB,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU;QACrC,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAC;IACvF,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QACvC,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,oCAAoC,CAAC,CAAC;IACvF,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,CAAC,CAAC;QAC1D,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,sCAAsC,CAAC,CAAC;IACrF,MAAM,QAAQ;SACT,MAAM,CAAC,aAAa,CAAC;SACrB,MAAM,CAAC;QACJ,EAAE,EAAE,QAAQ,EAAE;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KAC3B,CAAC;SACD,kBAAkB,CAAC;QAChB,MAAM,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC;QACtD,GAAG,EAAE;YACD,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,GAAG,CAAA,OAAO,aAAa,CAAC,QAAQ,sBAAsB;YAChE,UAAU,EAAE,GAAG,CAAA,mBAAmB;YAClC,SAAS,EAAE,IAAI;SAClB;KACJ,CAAC,CAAC;AACX,CAAC"}

package/packages/happy2-server/dist/modules/sync/syncEventInsert.d.ts

@@ -0,0 +1,15 @@
+import { type DrizzleTransaction } from "../drizzle.js";
+/**
+ * Records an entity, actor, target, and optional chat coordinates in syncEvents for an allocated sequence.
+ * Requiring the caller's transaction prevents a durable entity mutation from committing without its corresponding reconciliation event.
+ */
+export declare function syncEventInsert(tx: DrizzleTransaction, input: {
+    sequence: number;
+    kind: string;
+    chatId?: string;
+    chatPts?: number;
+    entityId?: string;
+    actorUserId?: string;
+    targetUserId?: string;
+}): Promise<void>;
+//# sourceMappingURL=syncEventInsert.d.ts.map

package/packages/happy2-server/dist/modules/sync/syncEventInsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncEventInsert.d.ts","sourceRoot":"","sources":["../../../sources/modules/sync/syncEventInsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;GAGG;AACH,wBAAsB,eAAe,CACjC,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GACF,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/packages/happy2-server/dist/modules/sync/syncEventInsert.js

@@ -0,0 +1,18 @@
+import {} from "../drizzle.js";
+import { syncEvents } from "../schema.js";
+/**
+ * Records an entity, actor, target, and optional chat coordinates in syncEvents for an allocated sequence.
+ * Requiring the caller's transaction prevents a durable entity mutation from committing without its corresponding reconciliation event.
+ */
+export async function syncEventInsert(tx, input) {
+    await tx.insert(syncEvents).values({
+        sequence: input.sequence,
+        kind: input.kind,
+        chatId: input.chatId,
+        chatPts: input.chatPts,
+        entityId: input.entityId,
+        actorUserId: input.actorUserId,
+        targetUserId: input.targetUserId,
+    });
+}
+//# sourceMappingURL=syncEventInsert.js.map

package/packages/happy2-server/dist/modules/sync/syncEventInsert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncEventInsert.js","sourceRoot":"","sources":["../../../sources/modules/sync/syncEventInsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,EAAsB,EACtB,KAQC;IAED,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;QAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;KACnC,CAAC,CAAC;AACP,CAAC"}

package/packages/happy2-server/dist/modules/sync/syncGetDifference.d.ts

@@ -0,0 +1,21 @@
+import { type ChatSummary, type SyncState } from "../chat/types.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Projects a global sync-event range into chats, removals, and product areas visible to one user.
+ * Generation resets, retention bounds, paging, and current access checks are combined here so a client cannot retain revoked or invisible state.
+ */
+export declare function syncGetDifference(executor: DrizzleExecutor, input: {
+    userId: string;
+    generation: string;
+    fromSequence: number;
+    untilSequence?: number;
+    limit: number;
+}): Promise<{
+    kind: "empty" | "difference" | "slice" | "reset";
+    changedChats: ChatSummary[];
+    removedChatIds: string[];
+    areas: string[];
+    state: SyncState;
+    targetState: SyncState;
+}>;
+//# sourceMappingURL=syncGetDifference.d.ts.map

package/packages/happy2-server/dist/modules/sync/syncGetDifference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncGetDifference.d.ts","sourceRoot":"","sources":["../../../sources/modules/sync/syncGetDifference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAExF,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAerD;;;GAGG;AACH,wBAAsB,iBAAiB,CACnC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB,GACF,OAAO,CAAC;IACP,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC;IACjD,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,SAAS,CAAC;CAC1B,CAAC,CAyID"}

package/packages/happy2-server/dist/modules/sync/syncGetDifference.js

@@ -0,0 +1,177 @@
+import { CollaborationError } from "../chat/types.js";
+import {} from "../drizzle.js";
+import { and, asc, eq, gt, inArray, lte } from "drizzle-orm";
+import { chatMembers, serverSyncState, syncEvents } from "../schema.js";
+import { number } from "../chat/number.js";
+import { optionalText } from "../chat/optionalText.js";
+import { stateAt } from "./impl/stateAt.js";
+import { text } from "../chat/text.js";
+import { chatGetAccess } from "../chat/chatGetAccess.js";
+import { chatCanAccess } from "../chat/chatCanAccess.js";
+import { syncGetState } from "./syncGetState.js";
+/**
+ * Projects a global sync-event range into chats, removals, and product areas visible to one user.
+ * Generation resets, retention bounds, paging, and current access checks are combined here so a client cannot retain revoked or invisible state.
+ */
+export async function syncGetDifference(executor, input) {
+    const current = await syncGetState(executor);
+    if (input.generation !== current.generation) {
+        return {
+            kind: "reset",
+            changedChats: [],
+            removedChatIds: [],
+            areas: ["all"],
+            state: current,
+            targetState: current,
+        };
+    }
+    const currentSequence = number(current.sequence);
+    const [retention] = await executor
+        .select({
+        minRecoverableSequence: serverSyncState.minRecoverableSequence,
+    })
+        .from(serverSyncState)
+        .where(eq(serverSyncState.id, 1));
+    if (input.fromSequence < (retention?.minRecoverableSequence ?? 0))
+        return {
+            kind: "reset",
+            changedChats: [],
+            removedChatIds: [],
+            areas: ["all"],
+            state: current,
+            targetState: current,
+        };
+    if (input.untilSequence !== undefined && input.untilSequence > currentSequence)
+        throw new CollaborationError("future_state", "Sync target is ahead of the server");
+    const target = Math.min(input.untilSequence ?? currentSequence, currentSequence);
+    if (input.fromSequence > currentSequence || target < input.fromSequence)
+        throw new CollaborationError("future_state", "Sync cursor is ahead of the server");
+    const page = await executor
+        .selectDistinct({
+        sequence: syncEvents.sequence,
+    })
+        .from(syncEvents)
+        .where(and(gt(syncEvents.sequence, input.fromSequence), lte(syncEvents.sequence, target)))
+        .orderBy(asc(syncEvents.sequence))
+        .limit(input.limit + 1);
+    const sequences = page.map((row) => row.sequence);
+    const hasMore = sequences.length > input.limit;
+    const included = sequences.slice(0, input.limit);
+    const intermediate = hasMore ? included.at(-1) : target;
+    if (included.length === 0) {
+        const state = stateAt(current.generation, target);
+        return {
+            kind: "empty",
+            changedChats: [],
+            removedChatIds: [],
+            areas: [],
+            state,
+            targetState: state,
+        };
+    }
+    const events = await executor
+        .select({
+        sequence: syncEvents.sequence,
+        kind: syncEvents.kind,
+        chat_id: syncEvents.chatId,
+        target_user_id: syncEvents.targetUserId,
+    })
+        .from(syncEvents)
+        .where(inArray(syncEvents.sequence, included))
+        .orderBy(syncEvents.sequence, syncEvents.id);
+    const changedChatIds = new Set();
+    const removedChatIds = new Set();
+    const areas = new Set();
+    for (const event of events) {
+        const targetUserId = optionalText(event.target_user_id);
+        const kind = text(event.kind);
+        const chatId = optionalText(event.chat_id);
+        if (targetUserId && targetUserId !== input.userId)
+            continue;
+        if (chatId &&
+            targetUserId === input.userId &&
+            (kind === "member.removed" || kind === "member.left")) {
+            if (!(await chatCanAccess(executor, input.userId, chatId)))
+                removedChatIds.add(chatId);
+            else
+                changedChatIds.add(chatId);
+            continue;
+        }
+        if (chatId && kind === "chat.deleted") {
+            const [wasMember] = await executor
+                .select({
+                userId: chatMembers.userId,
+            })
+                .from(chatMembers)
+                .where(and(eq(chatMembers.chatId, chatId), eq(chatMembers.userId, input.userId)))
+                .limit(1);
+            if (wasMember)
+                removedChatIds.add(chatId);
+            continue;
+        }
+        if (chatId && kind === "chat.visibilityChanged") {
+            if (await chatCanAccess(executor, input.userId, chatId))
+                changedChatIds.add(chatId);
+            else
+                removedChatIds.add(chatId);
+            continue;
+        }
+        if (kind.startsWith("call."))
+            areas.add("calls");
+        if (chatId && (await chatCanAccess(executor, input.userId, chatId))) {
+            changedChatIds.add(chatId);
+            continue;
+        }
+        if (kind.startsWith("preferences."))
+            areas.add("preferences");
+        else if (kind.startsWith("notification."))
+            areas.add("notifications");
+        else if (kind.startsWith("threadPreferences."))
+            areas.add("threads");
+        else if (kind.startsWith("scheduled."))
+            areas.add("scheduled-messages");
+        else if (kind.startsWith("automation."))
+            areas.add("automations");
+        else if (kind.startsWith("bot."))
+            areas.add("bots");
+        else if (kind.startsWith("integration."))
+            areas.add("integrations");
+        else if (kind.startsWith("plugin."))
+            areas.add("plugins");
+        else if (kind.startsWith("presence."))
+            areas.add("presence");
+        else if (kind.startsWith("user."))
+            areas.add("users");
+        else if (kind.startsWith("emoji."))
+            areas.add("emoji");
+        else if (kind.startsWith("server."))
+            areas.add("server");
+        else if (kind.startsWith("agentImage."))
+            areas.add("agent-images");
+        else if (kind.startsWith("agentSecret."))
+            areas.add("agent-secrets");
+        else if (kind.startsWith("setup."))
+            areas.add("setup");
+        else if (kind.startsWith("userOnboarding."))
+            areas.add("user-onboarding");
+        else if (!chatId)
+            areas.add("directories");
+    }
+    const changedChats = [];
+    for (const chatId of changedChatIds) {
+        const chat = await chatGetAccess(executor, input.userId, chatId, false);
+        if (chat)
+            changedChats.push(chat);
+    }
+    const state = stateAt(current.generation, intermediate);
+    const visibleChanges = changedChats.length + removedChatIds.size + areas.size;
+    return {
+        kind: hasMore ? "slice" : visibleChanges === 0 ? "empty" : "difference",
+        changedChats,
+        removedChatIds: [...removedChatIds],
+        areas: [...areas],
+        state,
+        targetState: stateAt(current.generation, target),
+    };
+}
+//# sourceMappingURL=syncGetDifference.js.map