happy2 0.0.5 → 0.0.9

package/packages/happy2-server/dist/modules/data-export/dataExportCancel.js

@@ -0,0 +1,41 @@
+import {} from "../operations/auditContext.js";
+import { OperationsError } from "../operations/types.js";
+import { withTransaction } from "../drizzle.js";
+import { dataExportJobs } from "../schema.js";
+import { eq, sql } from "drizzle-orm";
+import { auditAppend } from "../operations/auditAppend.js";
+import { exportJobDb } from "./impl/exportJobDb.js";
+import { userRequireOperationsActive } from "../operations/userRequireOperationsActive.js";
+/**
+ * Cancels a requester-visible dataExportJobs item only while its lifecycle still permits cancellation.
+ * Persisting the terminal state with audit evidence gives workers an authoritative stop signal and explains who withdrew the export.
+ */
+export async function dataExportCancel(executor, input) {
+    return withTransaction(executor, async (tx) => {
+        const actor = await userRequireOperationsActive(tx, input.actorUserId);
+        const before = await exportJobDb(tx, input.jobId);
+        if (actor.role !== "admin" && before.requestedByUserId !== input.actorUserId)
+            throw new OperationsError("not_found", "Data export was not found");
+        if (before.status !== "pending" && before.status !== "running")
+            throw new OperationsError("conflict", "Data export can no longer be cancelled");
+        await tx
+            .update(dataExportJobs)
+            .set({
+            status: "cancelled",
+            completedAt: sql `CURRENT_TIMESTAMP`,
+        })
+            .where(eq(dataExportJobs.id, input.jobId));
+        const after = await exportJobDb(tx, input.jobId);
+        await auditAppend(tx, {
+            actorUserId: input.actorUserId,
+            action: "data_export.cancelled",
+            targetType: "data_export",
+            targetId: input.jobId,
+            before,
+            after,
+            context: input.context,
+        });
+        return after;
+    });
+}
+//# sourceMappingURL=dataExportCancel.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportCancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportCancel.js","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportCancel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAsB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAwB,eAAe,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAE3F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,QAAyB,EACzB,KAIC;IAED,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,MAAM,2BAA2B,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,iBAAiB,KAAK,KAAK,CAAC,WAAW;YACxE,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,2BAA2B,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAC1D,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,wCAAwC,CAAC,CAAC;QACpF,MAAM,EAAE;aACH,MAAM,CAAC,cAAc,CAAC;aACtB,GAAG,CAAC;YACD,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,GAAG,CAAA,mBAAmB;SACtC,CAAC;aACD,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,WAAW,CAAC,EAAE,EAAE;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,uBAAuB;YAC/B,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,KAAK,CAAC,KAAK;YACrB,MAAM;YACN,KAAK;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/packages/happy2-server/dist/modules/data-export/dataExportClaimPending.d.ts

@@ -0,0 +1,8 @@
+import { type ClaimedDataExport } from "./impl/claimedDataExport.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Claims the oldest eligible dataExportJobs item for a worker by moving it from pending to a leased running state.
+ * The conditional claim serializes competing exporters so a user's archive is built once even when several workers poll concurrently.
+ */
+export declare function dataExportClaimPending(executor: DrizzleExecutor, limit?: number, leaseMs?: number): Promise<ClaimedDataExport[]>;
+//# sourceMappingURL=dataExportClaimPending.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportClaimPending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportClaimPending.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportClaimPending.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,eAAe,CAAC;AAOtE;;;GAGG;AACH,wBAAsB,sBAAsB,CACxC,QAAQ,EAAE,eAAe,EACzB,KAAK,SAAI,EACT,OAAO,SAAa,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA8C9B"}

package/packages/happy2-server/dist/modules/data-export/dataExportClaimPending.js

@@ -0,0 +1,53 @@
+import {} from "./impl/claimedDataExport.js";
+import { withTransaction } from "../drizzle.js";
+import { and, eq, isNull, lte, or } from "drizzle-orm";
+import { asExport } from "./impl/asExport.js";
+import { dataExportJobs } from "../schema.js";
+import { exportSelection } from "./impl/exportSelection.js";
+/**
+ * Claims the oldest eligible dataExportJobs item for a worker by moving it from pending to a leased running state.
+ * The conditional claim serializes competing exporters so a user's archive is built once even when several workers poll concurrently.
+ */
+export async function dataExportClaimPending(executor, limit = 5, leaseMs = 5 * 60_000) {
+    const claimedAt = new Date().toISOString();
+    const staleBefore = new Date(Date.now() - leaseMs).toISOString();
+    const claimable = or(eq(dataExportJobs.status, "pending"), and(eq(dataExportJobs.status, "running"), or(isNull(dataExportJobs.startedAt), lte(dataExportJobs.startedAt, staleBefore))));
+    const [candidate] = await executor
+        .select({
+        id: dataExportJobs.id,
+    })
+        .from(dataExportJobs)
+        .where(claimable)
+        .limit(1);
+    if (!candidate)
+        return [];
+    return withTransaction(executor, async (tx) => {
+        const candidates = await tx
+            .select({
+            id: dataExportJobs.id,
+        })
+            .from(dataExportJobs)
+            .where(claimable)
+            .orderBy(dataExportJobs.createdAt, dataExportJobs.id)
+            .limit(limit);
+        const claimed = [];
+        for (const candidate of candidates) {
+            const [row] = await tx
+                .update(dataExportJobs)
+                .set({
+                status: "running",
+                startedAt: claimedAt,
+                lastError: null,
+            })
+                .where(and(eq(dataExportJobs.id, candidate.id), claimable))
+                .returning(exportSelection);
+            if (row)
+                claimed.push({
+                    ...asExport(row),
+                    claimStartedAt: claimedAt,
+                });
+        }
+        return claimed;
+    });
+}
+//# sourceMappingURL=dataExportClaimPending.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportClaimPending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportClaimPending.js","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportClaimPending.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAwB,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,QAAyB,EACzB,KAAK,GAAG,CAAC,EACT,OAAO,GAAG,CAAC,GAAG,MAAM;IAEpB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IACjE,MAAM,SAAS,GAAG,EAAE,CAChB,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,EACpC,GAAG,CACC,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,EACpC,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CACnF,CACJ,CAAC;IACF,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,QAAQ;SAC7B,MAAM,CAAC;QACJ,EAAE,EAAE,cAAc,CAAC,EAAE;KACxB,CAAC;SACD,IAAI,CAAC,cAAc,CAAC;SACpB,KAAK,CAAC,SAAS,CAAC;SAChB,KAAK,CAAC,CAAC,CAAC,CAAC;IACd,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,UAAU,GAAG,MAAM,EAAE;aACtB,MAAM,CAAC;YACJ,EAAE,EAAE,cAAc,CAAC,EAAE;SACxB,CAAC;aACD,IAAI,CAAC,cAAc,CAAC;aACpB,KAAK,CAAC,SAAS,CAAC;aAChB,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,CAAC;aACpD,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE;iBACjB,MAAM,CAAC,cAAc,CAAC;iBACtB,GAAG,CAAC;gBACD,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,IAAI;aAClB,CAAC;iBACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;iBAC1D,SAAS,CAAC,eAAe,CAAC,CAAC;YAChC,IAAI,GAAG;gBACH,OAAO,CAAC,IAAI,CAAC;oBACT,GAAG,QAAQ,CAAC,GAAG,CAAC;oBAChB,cAAc,EAAE,SAAS;iBAC5B,CAAC,CAAC;QACX,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/packages/happy2-server/dist/modules/data-export/dataExportCompleteClaim.d.ts

@@ -0,0 +1,8 @@
+import { type ClaimedDataExport } from "./impl/claimedDataExport.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Completes a leased dataExportJobs build and grants its requester access through fileAccessGrants to the produced archive.
+ * Verifying lease ownership and committing the file grant with completion prevents a ready export from pointing at an inaccessible or unrelated file.
+ */
+export declare function dataExportCompleteClaim(executor: DrizzleExecutor, claim: ClaimedDataExport, outputFileId: string): Promise<boolean>;
+//# sourceMappingURL=dataExportCompleteClaim.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportCompleteClaim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportCompleteClaim.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportCompleteClaim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,eAAe,CAAC;AAOtE;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAuDlB"}

package/packages/happy2-server/dist/modules/data-export/dataExportCompleteClaim.js

@@ -0,0 +1,63 @@
+import {} from "./impl/claimedDataExport.js";
+import { withTransaction } from "../drizzle.js";
+import { and, eq, isNull, sql } from "drizzle-orm";
+import { createId } from "@paralleldrive/cuid2";
+import { dataExportJobs, fileAccessGrants } from "../schema.js";
+import { auditAppend } from "../operations/auditAppend.js";
+/**
+ * Completes a leased dataExportJobs build and grants its requester access through fileAccessGrants to the produced archive.
+ * Verifying lease ownership and committing the file grant with completion prevents a ready export from pointing at an inaccessible or unrelated file.
+ */
+export async function dataExportCompleteClaim(executor, claim, outputFileId) {
+    const requesterId = claim.requestedByUserId;
+    if (!requesterId)
+        return false;
+    return withTransaction(executor, async (tx) => {
+        const [completed] = await tx
+            .update(dataExportJobs)
+            .set({
+            status: "complete",
+            outputFileId,
+            lastError: null,
+            completedAt: sql `CURRENT_TIMESTAMP`,
+        })
+            .where(and(eq(dataExportJobs.id, claim.id), eq(dataExportJobs.status, "running"), eq(dataExportJobs.startedAt, claim.claimStartedAt)))
+            .returning({
+            id: dataExportJobs.id,
+        });
+        if (!completed)
+            return false;
+        await tx
+            .insert(fileAccessGrants)
+            .values({
+            id: createId(),
+            fileId: outputFileId,
+            principalType: "user",
+            principalId: requesterId,
+            grantedByUserId: requesterId,
+            expiresAt: claim.expiresAt,
+        })
+            .onConflictDoUpdate({
+            target: [
+                fileAccessGrants.fileId,
+                fileAccessGrants.principalType,
+                fileAccessGrants.principalId,
+            ],
+            targetWhere: isNull(fileAccessGrants.sourceMessageId),
+            set: {
+                expiresAt: claim.expiresAt ?? null,
+            },
+        });
+        await auditAppend(tx, {
+            actorUserId: requesterId,
+            action: "data_export.complete",
+            targetType: "data_export",
+            targetId: claim.id,
+            after: {
+                outputFileId,
+            },
+        });
+        return true;
+    });
+}
+//# sourceMappingURL=dataExportCompleteClaim.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportCompleteClaim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportCompleteClaim.js","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportCompleteClaim.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAwB,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,QAAyB,EACzB,KAAwB,EACxB,YAAoB;IAEpB,MAAM,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAC5C,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,EAAE;aACvB,MAAM,CAAC,cAAc,CAAC;aACtB,GAAG,CAAC;YACD,MAAM,EAAE,UAAU;YAClB,YAAY;YACZ,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,GAAG,CAAA,mBAAmB;SACtC,CAAC;aACD,KAAK,CACF,GAAG,CACC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,EAC/B,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,EACpC,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CACrD,CACJ;aACA,SAAS,CAAC;YACP,EAAE,EAAE,cAAc,CAAC,EAAE;SACxB,CAAC,CAAC;QACP,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7B,MAAM,EAAE;aACH,MAAM,CAAC,gBAAgB,CAAC;aACxB,MAAM,CAAC;YACJ,EAAE,EAAE,QAAQ,EAAE;YACd,MAAM,EAAE,YAAY;YACpB,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,WAAW;YACxB,eAAe,EAAE,WAAW;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC;aACD,kBAAkB,CAAC;YAChB,MAAM,EAAE;gBACJ,gBAAgB,CAAC,MAAM;gBACvB,gBAAgB,CAAC,aAAa;gBAC9B,gBAAgB,CAAC,WAAW;aAC/B;YACD,WAAW,EAAE,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC;YACrD,GAAG,EAAE;gBACD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;aACrC;SACJ,CAAC,CAAC;QACP,MAAM,WAAW,CAAC,EAAE,EAAE;YAClB,WAAW,EAAE,WAAW;YACxB,MAAM,EAAE,sBAAsB;YAC9B,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,KAAK,CAAC,EAAE;YAClB,KAAK,EAAE;gBACH,YAAY;aACf;SACJ,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/packages/happy2-server/dist/modules/data-export/dataExportFailClaim.d.ts

@@ -0,0 +1,8 @@
+import { type ClaimedDataExport } from "./impl/claimedDataExport.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Marks dataExportJobs failed only while the same running claim still owns its startedAt fence and stores a bounded error message.
+ * Returning false tells the worker that a newer claimant won, so stale execution cannot overwrite the replacement job state.
+ */
+export declare function dataExportFailClaim(executor: DrizzleExecutor, claim: ClaimedDataExport, error: unknown): Promise<boolean>;
+//# sourceMappingURL=dataExportFailClaim.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportFailClaim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportFailClaim.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportFailClaim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAoBlB"}

package/packages/happy2-server/dist/modules/data-export/dataExportFailClaim.js

@@ -0,0 +1,24 @@
+import {} from "./impl/claimedDataExport.js";
+import {} from "../drizzle.js";
+import { and, eq, sql } from "drizzle-orm";
+import { dataExportJobs } from "../schema.js";
+/**
+ * Marks dataExportJobs failed only while the same running claim still owns its startedAt fence and stores a bounded error message.
+ * Returning false tells the worker that a newer claimant won, so stale execution cannot overwrite the replacement job state.
+ */
+export async function dataExportFailClaim(executor, claim, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const [failed] = await executor
+        .update(dataExportJobs)
+        .set({
+        status: "failed",
+        lastError: message.slice(0, 2_000),
+        completedAt: sql `CURRENT_TIMESTAMP`,
+    })
+        .where(and(eq(dataExportJobs.id, claim.id), eq(dataExportJobs.status, "running"), eq(dataExportJobs.startedAt, claim.claimStartedAt)))
+        .returning({
+        id: dataExportJobs.id,
+    });
+    return Boolean(failed);
+}
+//# sourceMappingURL=dataExportFailClaim.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportFailClaim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportFailClaim.js","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportFailClaim.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAwB,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,QAAyB,EACzB,KAAwB,EACxB,KAAc;IAEd,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,QAAQ;SAC1B,MAAM,CAAC,cAAc,CAAC;SACtB,GAAG,CAAC;QACD,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAClC,WAAW,EAAE,GAAG,CAAA,mBAAmB;KACtC,CAAC;SACD,KAAK,CACF,GAAG,CACC,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,EAC/B,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,EACpC,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CACrD,CACJ;SACA,SAAS,CAAC;QACP,EAAE,EAAE,cAAc,CAAC,EAAE;KACxB,CAAC,CAAC;IACP,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/packages/happy2-server/dist/modules/data-export/dataExportGet.d.ts

@@ -0,0 +1,8 @@
+import { type DataExportJob } from "../operations/types.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Returns a data-export job to its active requester or to a server administrator, hiding other users' jobs as not-found.
+ * Applying ownership after the canonical job projection keeps status visibility and authorization consistent across operations routes.
+ */
+export declare function dataExportGet(executor: DrizzleExecutor, actorUserId: string, jobId: string): Promise<DataExportJob>;
+//# sourceMappingURL=dataExportGet.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportGet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportGet.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportGet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD;;;GAGG;AACH,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAMxB"}

package/packages/happy2-server/dist/modules/data-export/dataExportGet.js

@@ -0,0 +1,16 @@
+import { OperationsError } from "../operations/types.js";
+import {} from "../drizzle.js";
+import { exportJobDb } from "./impl/exportJobDb.js";
+import { userRequireOperationsActive } from "../operations/userRequireOperationsActive.js";
+/**
+ * Returns a data-export job to its active requester or to a server administrator, hiding other users' jobs as not-found.
+ * Applying ownership after the canonical job projection keeps status visibility and authorization consistent across operations routes.
+ */
+export async function dataExportGet(executor, actorUserId, jobId) {
+    const actor = await userRequireOperationsActive(executor, actorUserId);
+    const job = await exportJobDb(executor, jobId);
+    if (actor.role !== "admin" && job.requestedByUserId !== actorUserId)
+        throw new OperationsError("not_found", "Data export was not found");
+    return job;
+}
+//# sourceMappingURL=dataExportGet.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportGet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportGet.js","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportGet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAwB,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,QAAyB,EACzB,WAAmB,EACnB,KAAa;IAEb,MAAM,KAAK,GAAG,MAAM,2BAA2B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,iBAAiB,KAAK,WAAW;QAC/D,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,2BAA2B,CAAC,CAAC;IACxE,OAAO,GAAG,CAAC;AACf,CAAC"}

package/packages/happy2-server/dist/modules/data-export/dataExportList.d.ts

@@ -0,0 +1,15 @@
+import { type DataExportJob, type DataExportStatus, type Page } from "../operations/types.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Returns a reverse-chronological export-job page for the active requester's own jobs or, for administrators, jobs filtered by requester and status.
+ * Enforcing ownOnly before query construction prevents ordinary users from broadening the operations listing through optional filters.
+ */
+export declare function dataExportList(executor: DrizzleExecutor, input: {
+    actorUserId: string;
+    status?: DataExportStatus;
+    requestedByUserId?: string;
+    before?: string;
+    limit: number;
+    ownOnly?: boolean;
+}): Promise<Page<DataExportJob>>;
+//# sourceMappingURL=dataExportList.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportList.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportList.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAErB,KAAK,IAAI,EACZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAYrD;;;GAGG;AACH,wBAAsB,cAAc,CAChC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,GACF,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAmB9B"}

package/packages/happy2-server/dist/modules/data-export/dataExportList.js

@@ -0,0 +1,37 @@
+import { OperationsError, } from "../operations/types.js";
+import {} from "../drizzle.js";
+import { and, desc, eq } from "drizzle-orm";
+import { asExport } from "./impl/asExport.js";
+import { cursorCondition } from "../operations/cursorCondition.js";
+import { dataExportJobs } from "../schema.js";
+import { decodeCursor } from "../operations/decodeCursor.js";
+import { exportSelection } from "./impl/exportSelection.js";
+import { page } from "../operations/page.js";
+import { userRequireOperationsActive } from "../operations/userRequireOperationsActive.js";
+/**
+ * Returns a reverse-chronological export-job page for the active requester's own jobs or, for administrators, jobs filtered by requester and status.
+ * Enforcing ownOnly before query construction prevents ordinary users from broadening the operations listing through optional filters.
+ */
+export async function dataExportList(executor, input) {
+    const actor = await userRequireOperationsActive(executor, input.actorUserId);
+    if (!input.ownOnly && actor.role !== "admin")
+        throw new OperationsError("forbidden", "Administrator access is required");
+    const conditions = [];
+    if (input.ownOnly)
+        conditions.push(eq(dataExportJobs.requestedByUserId, input.actorUserId));
+    else if (input.requestedByUserId)
+        conditions.push(eq(dataExportJobs.requestedByUserId, input.requestedByUserId));
+    if (input.status)
+        conditions.push(eq(dataExportJobs.status, input.status));
+    const cursor = decodeCursor(input.before);
+    if (cursor)
+        conditions.push(cursorCondition(dataExportJobs.createdAt, dataExportJobs.id, cursor));
+    const rows = await executor
+        .select(exportSelection)
+        .from(dataExportJobs)
+        .where(and(...conditions))
+        .orderBy(desc(dataExportJobs.createdAt), desc(dataExportJobs.id))
+        .limit(input.limit + 1);
+    return page(rows, input.limit, asExport);
+}
+//# sourceMappingURL=dataExportList.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportList.js","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportList.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,eAAe,GAElB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAwB,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAY,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,QAAyB,EACzB,KAOC;IAED,MAAM,KAAK,GAAG,MAAM,2BAA2B,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QACxC,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,kCAAkC,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAU,EAAE,CAAC;IAC7B,IAAI,KAAK,CAAC,OAAO;QAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,iBAAiB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;SACvF,IAAI,KAAK,CAAC,iBAAiB;QAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACnF,IAAI,KAAK,CAAC,MAAM;QAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM;QACN,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1F,MAAM,IAAI,GAAG,MAAM,QAAQ;SACtB,MAAM,CAAC,eAAe,CAAC;SACvB,IAAI,CAAC,cAAc,CAAC;SACpB,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;SACzB,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;SAChE,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC"}

package/packages/happy2-server/dist/modules/data-export/dataExportRequest.d.ts

@@ -0,0 +1,16 @@
+import { type AuditContext } from "../operations/auditContext.js";
+import { type DataExportJob, type DataExportKind } from "../operations/types.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Queues a dataExportJobs request only after validating the actor, target user, and access to every requested chat scope.
+ * Capturing authorization and audit context when the job is created prevents an asynchronous worker from exporting data the requester could not inspect.
+ */
+export declare function dataExportRequest(executor: DrizzleExecutor, input: {
+    actorUserId: string;
+    kind: DataExportKind;
+    targetId?: string;
+    options?: Record<string, unknown>;
+    expiresAt?: string;
+    context?: AuditContext;
+}): Promise<DataExportJob>;
+//# sourceMappingURL=dataExportRequest.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportRequest.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAmB,MAAM,wBAAwB,CAAC;AAElG,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,eAAe,CAAC;AAYtE;;;GAGG;AACH,wBAAsB,iBAAiB,CACnC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC;CAC1B,GACF,OAAO,CAAC,aAAa,CAAC,CA2CxB"}

package/packages/happy2-server/dist/modules/data-export/dataExportRequest.js

@@ -0,0 +1,61 @@
+import {} from "../operations/auditContext.js";
+import { OperationsError } from "../operations/types.js";
+import { withTransaction } from "../drizzle.js";
+import { createId } from "@paralleldrive/cuid2";
+import { dataExportJobs } from "../schema.js";
+import { futureTimestamp } from "../operations/futureTimestamp.js";
+import { json } from "../operations/json.js";
+import { auditAppend } from "../operations/auditAppend.js";
+import { dataExportCanAccessChat } from "./dataExportCanAccessChat.js";
+import { exportJobDb } from "./impl/exportJobDb.js";
+import { userRequireOperationsActive } from "../operations/userRequireOperationsActive.js";
+import { dataExportRequireExistingUser } from "./dataExportRequireExistingUser.js";
+/**
+ * Queues a dataExportJobs request only after validating the actor, target user, and access to every requested chat scope.
+ * Capturing authorization and audit context when the job is created prevents an asynchronous worker from exporting data the requester could not inspect.
+ */
+export async function dataExportRequest(executor, input) {
+    const expiresAt = futureTimestamp(input.expiresAt, "expiresAt");
+    return withTransaction(executor, async (tx) => {
+        const actor = await userRequireOperationsActive(tx, input.actorUserId);
+        let targetId = input.targetId;
+        if (input.kind === "user_data") {
+            targetId ??= input.actorUserId;
+            if (targetId !== input.actorUserId && actor.role !== "admin")
+                throw new OperationsError("forbidden", "Only administrators can export another user");
+            await dataExportRequireExistingUser(tx, targetId);
+        }
+        else if (input.kind === "chat_history") {
+            if (!targetId)
+                throw new OperationsError("invalid", "chat_history requires targetId");
+            if (!(await dataExportCanAccessChat(tx, input.actorUserId, targetId)))
+                throw new OperationsError("not_found", "Chat was not found");
+        }
+        else {
+            if (actor.role !== "admin")
+                throw new OperationsError("forbidden", "This export requires an administrator");
+            targetId = undefined;
+        }
+        const id = createId();
+        await tx.insert(dataExportJobs).values({
+            id,
+            requestedByUserId: input.actorUserId,
+            kind: input.kind,
+            targetId,
+            optionsJson: json(input.options),
+            expiresAt,
+        });
+        const job = await exportJobDb(tx, id);
+        await auditAppend(tx, {
+            actorUserId: input.actorUserId,
+            action: "data_export.requested",
+            targetType: "data_export",
+            targetId: id,
+            chatId: input.kind === "chat_history" ? targetId : undefined,
+            after: job,
+            context: input.context,
+        });
+        return job;
+    });
+}
+//# sourceMappingURL=dataExportRequest.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportRequest.js.map

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

package/packages/happy2-server/dist/modules/data-export/dataExportRequireExistingUser.d.ts

@@ -0,0 +1,7 @@
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Requires the target user profile to exist and not be soft-deleted before a data-export job references it.
+ * This guard checks durable target existence without conflating it with current account activity, which historical administrator exports may not require.
+ */
+export declare function dataExportRequireExistingUser(executor: DrizzleExecutor, userId: string): Promise<void>;
+//# sourceMappingURL=dataExportRequireExistingUser.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportRequireExistingUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportRequireExistingUser.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportRequireExistingUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAKrD;;;GAGG;AACH,wBAAsB,6BAA6B,CAC/C,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/packages/happy2-server/dist/modules/data-export/dataExportRequireExistingUser.js

@@ -0,0 +1,19 @@
+import {} from "../drizzle.js";
+import { OperationsError } from "../operations/types.js";
+import { and, eq, isNull } from "drizzle-orm";
+import { users } from "../schema.js";
+/**
+ * Requires the target user profile to exist and not be soft-deleted before a data-export job references it.
+ * This guard checks durable target existence without conflating it with current account activity, which historical administrator exports may not require.
+ */
+export async function dataExportRequireExistingUser(executor, userId) {
+    const [row] = await executor
+        .select({
+        id: users.id,
+    })
+        .from(users)
+        .where(and(eq(users.id, userId), isNull(users.deletedAt)));
+    if (!row)
+        throw new OperationsError("not_found", "User was not found");
+}
+//# sourceMappingURL=dataExportRequireExistingUser.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportRequireExistingUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportRequireExistingUser.js","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportRequireExistingUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAC/C,QAAyB,EACzB,MAAc;IAEd,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,QAAQ;SACvB,MAAM,CAAC;QACJ,EAAE,EAAE,KAAK,CAAC,EAAE;KACf,CAAC;SACD,IAAI,CAAC,KAAK,CAAC;SACX,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;AAC3E,CAAC"}

package/packages/happy2-server/dist/modules/data-export/dataExportRunDue.d.ts

@@ -0,0 +1,11 @@
+import type { DrizzleExecutor } from "../drizzle.js";
+import type { FileStorage } from "../files/storage.js";
+/**
+ * Claims pending export jobs, builds JSON for active requesters, stores each artifact, and records completion or failure under the claim lease.
+ * Removing artifacts after a lost or failed claim prevents external storage from retaining files that no durable export job owns.
+ */
+export declare function dataExportRunDue(executor: DrizzleExecutor, files: FileStorage, limit?: number): Promise<{
+    completed: number;
+    failed: number;
+}>;
+//# sourceMappingURL=dataExportRunDue.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportRunDue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportRunDue.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportRunDue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQvD;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,WAAW,EAClB,KAAK,SAAI,GACV,OAAO,CAAC;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC,CAiCD"}

package/packages/happy2-server/dist/modules/data-export/dataExportRunDue.js

@@ -0,0 +1,46 @@
+import { Readable } from "node:stream";
+import { userFindActive } from "../user/userFindActive.js";
+import { dataExportBuildArtifact } from "./dataExportBuildArtifact.js";
+import { dataExportClaimPending } from "./dataExportClaimPending.js";
+import { dataExportCompleteClaim } from "./dataExportCompleteClaim.js";
+import { dataExportFailClaim } from "./dataExportFailClaim.js";
+import { dataExportRemoveUnclaimedArtifact } from "./impl/dataExportRemoveUnclaimedArtifact.js";
+/**
+ * Claims pending export jobs, builds JSON for active requesters, stores each artifact, and records completion or failure under the claim lease.
+ * Removing artifacts after a lost or failed claim prevents external storage from retaining files that no durable export job owns.
+ */
+export async function dataExportRunDue(executor, files, limit = 5) {
+    const claims = await dataExportClaimPending(executor, limit);
+    let completed = 0;
+    let failed = 0;
+    for (const claim of claims) {
+        let artifact;
+        try {
+            const requesterId = claim.requestedByUserId;
+            if (!requesterId)
+                throw new Error("Data export requester no longer exists");
+            const requester = await userFindActive(executor, requesterId);
+            if (!requester)
+                throw new Error("Data export requester is no longer active");
+            const payload = await dataExportBuildArtifact(executor, claim);
+            const contents = Buffer.from(`${JSON.stringify(payload, null, 2)}\n`, "utf8");
+            artifact = await files.saveAttachmentUpload(requester, Readable.from([contents]), {
+                filename: `happy2-${claim.kind}-${claim.id}.json`,
+                contentType: "application/json",
+            });
+            if (!(await dataExportCompleteClaim(executor, claim, artifact.id))) {
+                await dataExportRemoveUnclaimedArtifact(executor, files, claim, artifact).catch(() => undefined);
+                continue;
+            }
+            completed += 1;
+        }
+        catch (error) {
+            if (artifact)
+                await dataExportRemoveUnclaimedArtifact(executor, files, claim, artifact).catch(() => undefined);
+            if (await dataExportFailClaim(executor, claim, error))
+                failed += 1;
+        }
+    }
+    return { completed, failed };
+}
+//# sourceMappingURL=dataExportRunDue.js.map

package/packages/happy2-server/dist/modules/data-export/dataExportRunDue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportRunDue.js","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportRunDue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAEhG;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,QAAyB,EACzB,KAAkB,EAClB,KAAK,GAAG,CAAC;IAKT,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7D,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,QAAgC,CAAC;QACrC,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC;YAC5C,IAAI,CAAC,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC5E,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC9D,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC7E,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC9E,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE;gBAC9E,QAAQ,EAAE,UAAU,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,OAAO;gBACjD,WAAW,EAAE,kBAAkB;aAClC,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,uBAAuB,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACjE,MAAM,iCAAiC,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,CAC3E,GAAG,EAAE,CAAC,SAAS,CAClB,CAAC;gBACF,SAAS;YACb,CAAC;YACD,SAAS,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,QAAQ;gBACR,MAAM,iCAAiC,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,CAC3E,GAAG,EAAE,CAAC,SAAS,CAClB,CAAC;YACN,IAAI,MAAM,mBAAmB,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;gBAAE,MAAM,IAAI,CAAC,CAAC;QACvE,CAAC;IACL,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC"}

package/packages/happy2-server/dist/modules/data-export/dataExportUpdate.d.ts

@@ -0,0 +1,17 @@
+import { type AuditContext } from "../operations/auditContext.js";
+import { type DataExportJob, type DataExportStatus } from "../operations/types.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Applies an administrator-reported progress, failure, or completion transition to dataExportJobs and manages any resulting fileAccessGrants.
+ * The transaction keeps the job lifecycle, archive visibility, and audit history consistent when operations staff repair or finalize an export.
+ */
+export declare function dataExportUpdate(executor: DrizzleExecutor, input: {
+    actorUserId: string;
+    jobId: string;
+    status: Exclude<DataExportStatus, "pending">;
+    outputFileId?: string;
+    lastError?: string;
+    expiresAt?: string;
+    context?: AuditContext;
+}): Promise<DataExportJob>;
+//# sourceMappingURL=dataExportUpdate.d.ts.map

package/packages/happy2-server/dist/modules/data-export/dataExportUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataExportUpdate.d.ts","sourceRoot":"","sources":["../../../sources/modules/data-export/dataExportUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAmB,MAAM,wBAAwB,CAAC;AAEpG,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,eAAe,CAAC;AAatE;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC;CAC1B,GACF,OAAO,CAAC,aAAa,CAAC,CA+ExB"}