happy2 0.0.5 → 0.0.11

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

@@ -0,0 +1,23 @@
+import { and, eq } from "drizzle-orm";
+import { withTransaction } from "../drizzle.js";
+import { idempotencyKeys } from "../schema.js";
+import { idempotencyKeyFind, idempotencyLeaseToken } from "./impl/idempotencyKey.js";
+/**
+ * Releases an unfinished idempotencyKeys lease only when its owner token matches the caller that abandoned execution.
+ * The ownership guard makes the mutation retryable again without clearing a response or lease established by another request.
+ */
+export async function idempotencyLeaseRelease(executor, storageKey, leaseToken) {
+    return withTransaction(executor, async (tx) => {
+        const row = await idempotencyKeyFind(tx, storageKey);
+        if (!row ||
+            row.status !== "in_progress" ||
+            idempotencyLeaseToken(row.responseJson) !== leaseToken)
+            return false;
+        const changed = await tx
+            .delete(idempotencyKeys)
+            .where(and(eq(idempotencyKeys.id, row.id), eq(idempotencyKeys.status, "in_progress")))
+            .returning({ id: idempotencyKeys.id });
+        return changed.length === 1;
+    });
+}
+//# sourceMappingURL=idempotencyLeaseRelease.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyLeaseRelease.js","sourceRoot":"","sources":["../../../sources/modules/request/idempotencyLeaseRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAwB,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAErF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,QAAyB,EACzB,UAAkB,EAClB,UAAkB;IAElB,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrD,IACI,CAAC,GAAG;YACJ,GAAG,CAAC,MAAM,KAAK,aAAa;YAC5B,qBAAqB,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,UAAU;YAEtD,OAAO,KAAK,CAAC;QACjB,MAAM,OAAO,GAAG,MAAM,EAAE;aACnB,MAAM,CAAC,eAAe,CAAC;aACvB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;aACrF,SAAS,CAAC,EAAE,EAAE,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,7 @@
+import { type DrizzleExecutor } from "../drizzle.js";
+/**
+ * Deletes bounded batches of idempotencyKeys whose retention deadline has passed and whose result is no longer replayable.
+ * Centralizing expiry cleanup preserves active leases while preventing historical request bodies and responses from growing without limit.
+ */
+export declare function idempotencyRecordPurgeExpired(executor: DrizzleExecutor, now: number, limit?: number): Promise<number>;
+//# sourceMappingURL=idempotencyRecordPurgeExpired.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyRecordPurgeExpired.d.ts","sourceRoot":"","sources":["../../../sources/modules/request/idempotencyRecordPurgeExpired.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,eAAe,CAAC;AAItE;;;GAGG;AACH,wBAAsB,6BAA6B,CAC/C,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,MAAM,EACX,KAAK,SAAQ,GACd,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

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

@@ -0,0 +1,25 @@
+import { asc, inArray, lte } from "drizzle-orm";
+import { withTransaction } from "../drizzle.js";
+import { idempotencyKeys } from "../schema.js";
+import { idempotencyTimestamp } from "./impl/idempotencyKey.js";
+/**
+ * Deletes bounded batches of idempotencyKeys whose retention deadline has passed and whose result is no longer replayable.
+ * Centralizing expiry cleanup preserves active leases while preventing historical request bodies and responses from growing without limit.
+ */
+export async function idempotencyRecordPurgeExpired(executor, now, limit = 1_000) {
+    return withTransaction(executor, async (tx) => {
+        const due = await tx
+            .select({ id: idempotencyKeys.id })
+            .from(idempotencyKeys)
+            .where(lte(idempotencyKeys.expiresAt, idempotencyTimestamp(now)))
+            .orderBy(asc(idempotencyKeys.expiresAt), asc(idempotencyKeys.id))
+            .limit(limit);
+        if (due.length === 0)
+            return 0;
+        return (await tx
+            .delete(idempotencyKeys)
+            .where(inArray(idempotencyKeys.id, due.map(({ id }) => id)))
+            .returning({ id: idempotencyKeys.id })).length;
+    });
+}
+//# sourceMappingURL=idempotencyRecordPurgeExpired.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyRecordPurgeExpired.js","sourceRoot":"","sources":["../../../sources/modules/request/idempotencyRecordPurgeExpired.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAwB,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAC/C,QAAyB,EACzB,GAAW,EACX,KAAK,GAAG,KAAK;IAEb,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,EAAE;aACf,MAAM,CAAC,EAAE,EAAE,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC;aAClC,IAAI,CAAC,eAAe,CAAC;aACrB,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;aAChE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;aAChE,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CACH,MAAM,EAAE;aACH,MAAM,CAAC,eAAe,CAAC;aACvB,KAAK,CACF,OAAO,CACH,eAAe,CAAC,EAAE,EAClB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAC1B,CACJ;aACA,SAAS,CAAC,EAAE,EAAE,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC,CAC7C,CAAC,MAAM,CAAC;IACb,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { DrizzleExecutor } from "../../drizzle.js";
+import { idempotencyKeys } from "../../schema.js";
+export type IdempotencyKeyRow = typeof idempotencyKeys.$inferSelect;
+export declare function idempotencyRequestKey(storageKey: string): import("drizzle-orm").SQL<unknown> | undefined;
+export declare function idempotencyKeyFind(executor: DrizzleExecutor, storageKey: string): Promise<IdempotencyKeyRow | undefined>;
+export declare function idempotencyLeaseToken(value: unknown): string | undefined;
+export declare function idempotencyTimestamp(value: number): string;
+//# sourceMappingURL=idempotencyKey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKey.d.ts","sourceRoot":"","sources":["../../../../sources/modules/request/impl/idempotencyKey.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC;AAEpE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,kDAOvD;AAED,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAMxC;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQxE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/packages/happy2-server/dist/modules/request/impl/idempotencyKey.js

@@ -0,0 +1,27 @@
+import { and, eq } from "drizzle-orm";
+import { idempotencyKeys } from "../../schema.js";
+export function idempotencyRequestKey(storageKey) {
+    return and(eq(idempotencyKeys.principalType, "system"), eq(idempotencyKeys.principalId, "http"), eq(idempotencyKeys.scope, "request"), eq(idempotencyKeys.idempotencyKey, storageKey));
+}
+export async function idempotencyKeyFind(executor, storageKey) {
+    const rows = await executor
+        .select()
+        .from(idempotencyKeys)
+        .where(idempotencyRequestKey(storageKey));
+    return rows[0];
+}
+export function idempotencyLeaseToken(value) {
+    if (typeof value !== "string")
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        return typeof parsed.leaseToken === "string" ? parsed.leaseToken : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function idempotencyTimestamp(value) {
+    return new Date(value).toISOString();
+}
+//# sourceMappingURL=idempotencyKey.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKey.js","sourceRoot":"","sources":["../../../../sources/modules/request/impl/idempotencyKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACpD,OAAO,GAAG,CACN,EAAE,CAAC,eAAe,CAAC,aAAa,EAAE,QAAQ,CAAC,EAC3C,EAAE,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,EACvC,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,EACpC,EAAE,CAAC,eAAe,CAAC,cAAc,EAAE,UAAU,CAAC,CACjD,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,QAAyB,EACzB,UAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,QAAQ;SACtB,MAAM,EAAE;SACR,IAAI,CAAC,eAAe,CAAC;SACrB,KAAK,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA6B,CAAC;QAC7D,OAAO,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAC9C,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AACzC,CAAC"}

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

@@ -1,5 +1,8 @@
 export * from "./idempotency.js";
-export * from "./database-idempotency.js";
+export * from "./idempotencyLeaseAcquire.js";
+export * from "./idempotencyLeaseComplete.js";
+export * from "./idempotencyLeaseRelease.js";
+export * from "./idempotencyRecordPurgeExpired.js";
 export * from "./idempotency-hook.js";
 export * from "./rate-limit.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sources/modules/request/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sources/modules/request/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

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

@@ -1,5 +1,8 @@
 export * from "./idempotency.js";
-export * from "./database-idempotency.js";
+export * from "./idempotencyLeaseAcquire.js";
+export * from "./idempotencyLeaseComplete.js";
+export * from "./idempotencyLeaseRelease.js";
+export * from "./idempotencyRecordPurgeExpired.js";
 export * from "./idempotency-hook.js";
 export * from "./rate-limit.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../sources/modules/request/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../sources/modules/request/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

package/packages/happy2-server/dist/modules/retention/impl/asRetention.d.ts

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

package/packages/happy2-server/dist/modules/retention/impl/asRetention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asRetention.d.ts","sourceRoot":"","sources":["../../../../sources/modules/retention/impl/asRetention.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAuB,MAAM,2BAA2B,CAAC;AAGnF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAYtE"}

package/packages/happy2-server/dist/modules/retention/impl/asRetention.js

@@ -0,0 +1,19 @@
+import { number } from "../../operations/number.js";
+import { optionalText } from "../../operations/optionalText.js";
+import { parseJson } from "../../operations/parseJson.js";
+import {} from "../../operations/types.js";
+import { text } from "../../operations/text.js";
+export function asRetention(row) {
+    return {
+        id: text(row.id),
+        scope: text(row.scope),
+        status: text(row.status),
+        itemsExamined: number(row.items_examined),
+        itemsDeleted: number(row.items_deleted),
+        details: parseJson(row.details_json),
+        lastError: optionalText(row.last_error),
+        startedAt: text(row.started_at),
+        completedAt: optionalText(row.completed_at),
+    };
+}
+//# sourceMappingURL=asRetention.js.map

package/packages/happy2-server/dist/modules/retention/impl/asRetention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asRetention.js","sourceRoot":"","sources":["../../../../sources/modules/retention/impl/asRetention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAA0C,MAAM,2BAA2B,CAAC;AAEnF,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,MAAM,UAAU,WAAW,CAAC,GAA4B;IACpD,OAAO;QACH,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAmB;QACxC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAA2B;QAClD,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;QACzC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QACvC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC;QACpC,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC;QACvC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;QAC/B,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC;KAC9C,CAAC;AACN,CAAC"}

package/packages/happy2-server/dist/modules/retention/impl/retentionRunDb.d.ts

@@ -0,0 +1,8 @@
+import { type DrizzleExecutor } from "../../drizzle.js";
+import { type RetentionRun } from "../../operations/types.js";
+/**
+ * Loads the canonical retention-run projection by identifier and maps absence to the operations not-found error.
+ * Sharing this mapper across start and finish keeps scope, counts, timestamps, errors, and policy metadata consistent.
+ */
+export declare function retentionRunDb(executor: DrizzleExecutor, id: string): Promise<RetentionRun>;
+//# sourceMappingURL=retentionRunDb.d.ts.map

package/packages/happy2-server/dist/modules/retention/impl/retentionRunDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionRunDb.d.ts","sourceRoot":"","sources":["../../../../sources/modules/retention/impl/retentionRunDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM/E;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAQjG"}

package/packages/happy2-server/dist/modules/retention/impl/retentionRunDb.js

@@ -0,0 +1,21 @@
+import {} from "../../drizzle.js";
+import { OperationsError } from "../../operations/types.js";
+import { asRetention } from "./asRetention.js";
+import { eq } from "drizzle-orm";
+import { retentionRuns } from "../../schema.js";
+import { retentionSelection } from "./retentionSelection.js";
+/**
+ * Loads the canonical retention-run projection by identifier and maps absence to the operations not-found error.
+ * Sharing this mapper across start and finish keeps scope, counts, timestamps, errors, and policy metadata consistent.
+ */
+export async function retentionRunDb(executor, id) {
+    const [row] = await executor
+        .select(retentionSelection)
+        .from(retentionRuns)
+        .where(eq(retentionRuns.id, id))
+        .limit(1);
+    if (!row)
+        throw new OperationsError("not_found", "Retention run was not found");
+    return asRetention(row);
+}
+//# sourceMappingURL=retentionRunDb.js.map

package/packages/happy2-server/dist/modules/retention/impl/retentionRunDb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionRunDb.js","sourceRoot":"","sources":["../../../../sources/modules/retention/impl/retentionRunDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAqB,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAyB,EAAE,EAAU;IACtE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,QAAQ;SACvB,MAAM,CAAC,kBAAkB,CAAC;SAC1B,IAAI,CAAC,aAAa,CAAC;SACnB,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;SAC/B,KAAK,CAAC,CAAC,CAAC,CAAC;IACd,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,6BAA6B,CAAC,CAAC;IAChF,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/packages/happy2-server/dist/modules/retention/impl/retentionSelection.d.ts

@@ -0,0 +1,170 @@
+export declare const retentionSelection: {
+    id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "id";
+        tableName: "retention_runs";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    scope: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "scope";
+        tableName: "retention_runs";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "status";
+        tableName: "retention_runs";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    items_examined: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "items_examined";
+        tableName: "retention_runs";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    items_deleted: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "items_deleted";
+        tableName: "retention_runs";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    details_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "details_json";
+        tableName: "retention_runs";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    last_error: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "last_error";
+        tableName: "retention_runs";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    started_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "started_at";
+        tableName: "retention_runs";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    completed_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "completed_at";
+        tableName: "retention_runs";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+};
+//# sourceMappingURL=retentionSelection.d.ts.map

package/packages/happy2-server/dist/modules/retention/impl/retentionSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionSelection.d.ts","sourceRoot":"","sources":["../../../../sources/modules/retention/impl/retentionSelection.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,kBAAkB;IAC3B,EAAE;;;;;;;;;;;;;;;;;;;IACF,KAAK;;;;;;;;;;;;;;;;;;;IACL,MAAM;;;;;;;;;;;;;;;;;;;IACN,cAAc;;;;;;;;;;;;;;;;;IACd,aAAa;;;;;;;;;;;;;;;;;IACb,YAAY;;;;;;;;;;;;;;;;;;;IACZ,UAAU;;;;;;;;;;;;;;;;;;;IACV,UAAU;;;;;;;;;;;;;;;;;;;IACV,YAAY;;;;;;;;;;;;;;;;;;;CACf,CAAC"}

package/packages/happy2-server/dist/modules/retention/impl/retentionSelection.js

@@ -0,0 +1,13 @@
+import { retentionRuns } from "../../schema.js";
+export const retentionSelection = {
+    id: retentionRuns.id,
+    scope: retentionRuns.scope,
+    status: retentionRuns.status,
+    items_examined: retentionRuns.itemsExamined,
+    items_deleted: retentionRuns.itemsDeleted,
+    details_json: retentionRuns.detailsJson,
+    last_error: retentionRuns.lastError,
+    started_at: retentionRuns.startedAt,
+    completed_at: retentionRuns.completedAt,
+};
+//# sourceMappingURL=retentionSelection.js.map

package/packages/happy2-server/dist/modules/retention/impl/retentionSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionSelection.js","sourceRoot":"","sources":["../../../../sources/modules/retention/impl/retentionSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,EAAE,EAAE,aAAa,CAAC,EAAE;IACpB,KAAK,EAAE,aAAa,CAAC,KAAK;IAC1B,MAAM,EAAE,aAAa,CAAC,MAAM;IAC5B,cAAc,EAAE,aAAa,CAAC,aAAa;IAC3C,aAAa,EAAE,aAAa,CAAC,YAAY;IACzC,YAAY,EAAE,aAAa,CAAC,WAAW;IACvC,UAAU,EAAE,aAAa,CAAC,SAAS;IACnC,UAAU,EAAE,aAAa,CAAC,SAAS;IACnC,YAAY,EAAE,aAAa,CAAC,WAAW;CAC1C,CAAC"}

package/packages/happy2-server/dist/modules/retention/retentionRunFinish.d.ts

@@ -0,0 +1,18 @@
+import { type AuditContext } from "../operations/auditContext.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+import { type RetentionRun } from "../operations/types.js";
+/**
+ * Records the terminal outcome and deletion counts for an administrator-owned retentionRuns execution.
+ * Completing the run with its audit entry makes retention results attributable and prevents later updates to an already closed execution.
+ */
+export declare function retentionRunFinish(executor: DrizzleExecutor, input: {
+    actorUserId: string;
+    runId: string;
+    status: "complete" | "failed";
+    itemsExamined: number;
+    itemsDeleted: number;
+    details?: Record<string, unknown>;
+    lastError?: string;
+    context?: AuditContext;
+}): Promise<RetentionRun>;
+//# sourceMappingURL=retentionRunFinish.d.ts.map

package/packages/happy2-server/dist/modules/retention/retentionRunFinish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionRunFinish.d.ts","sourceRoot":"","sources":["../../../sources/modules/retention/retentionRunFinish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAU5E;;;GAGG;AACH,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,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,YAAY,CAAC,CAkCvB"}

package/packages/happy2-server/dist/modules/retention/retentionRunFinish.js

@@ -0,0 +1,48 @@
+import {} from "../operations/auditContext.js";
+import { withTransaction } from "../drizzle.js";
+import { OperationsError } from "../operations/types.js";
+import { eq, sql } from "drizzle-orm";
+import { json } from "../operations/json.js";
+import { retentionRuns } from "../schema.js";
+import { auditAppend } from "../operations/auditAppend.js";
+import { userRequireOperationsAdmin } from "../operations/userRequireOperationsAdmin.js";
+import { retentionRunDb } from "./impl/retentionRunDb.js";
+/**
+ * Records the terminal outcome and deletion counts for an administrator-owned retentionRuns execution.
+ * Completing the run with its audit entry makes retention results attributable and prevents later updates to an already closed execution.
+ */
+export async function retentionRunFinish(executor, input) {
+    return withTransaction(executor, async (tx) => {
+        await userRequireOperationsAdmin(tx, input.actorUserId);
+        const before = await retentionRunDb(tx, input.runId);
+        if (before.status !== "running")
+            throw new OperationsError("conflict", "Retention run is already finished");
+        if (input.status === "failed" && !input.lastError)
+            throw new OperationsError("invalid", "A failed retention run requires lastError");
+        await tx
+            .update(retentionRuns)
+            .set({
+            status: input.status,
+            itemsExamined: input.itemsExamined,
+            itemsDeleted: input.itemsDeleted,
+            detailsJson: input.details === undefined
+                ? sql `${retentionRuns.detailsJson}`
+                : json(input.details),
+            lastError: input.lastError ?? null,
+            completedAt: sql `CURRENT_TIMESTAMP`,
+        })
+            .where(eq(retentionRuns.id, input.runId));
+        const after = await retentionRunDb(tx, input.runId);
+        await auditAppend(tx, {
+            actorUserId: input.actorUserId,
+            action: `retention.${input.status}`,
+            targetType: "retention_run",
+            targetId: input.runId,
+            before,
+            after,
+            context: input.context,
+        });
+        return after;
+    });
+}
+//# sourceMappingURL=retentionRunFinish.js.map

package/packages/happy2-server/dist/modules/retention/retentionRunFinish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionRunFinish.js","sourceRoot":"","sources":["../../../sources/modules/retention/retentionRunFinish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAwB,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAAqB,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,QAAyB,EACzB,KASC;IAED,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,0BAA0B,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAC3B,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,mCAAmC,CAAC,CAAC;QAC/E,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,SAAS;YAC7C,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,2CAA2C,CAAC,CAAC;QACtF,MAAM,EAAE;aACH,MAAM,CAAC,aAAa,CAAC;aACrB,GAAG,CAAC;YACD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EACP,KAAK,CAAC,OAAO,KAAK,SAAS;gBACvB,CAAC,CAAC,GAAG,CAAA,GAAG,aAAa,CAAC,WAAW,EAAE;gBACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAC7B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;YAClC,WAAW,EAAE,GAAG,CAAA,mBAAmB;SACtC,CAAC;aACD,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,WAAW,CAAC,EAAE,EAAE;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,aAAa,KAAK,CAAC,MAAM,EAAE;YACnC,UAAU,EAAE,eAAe;YAC3B,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/retention/retentionRunList.d.ts

@@ -0,0 +1,13 @@
+import { type DrizzleExecutor } from "../drizzle.js";
+import { type Page, type RetentionRun, type RetentionScope } from "../operations/types.js";
+/**
+ * Returns an administrator-only reverse-chronological page of retention runs, optionally filtered by scope and continued before a start-time cursor.
+ * The shared page projection exposes durable cleanup outcomes without allowing ordinary users to inspect server policy execution.
+ */
+export declare function retentionRunList(executor: DrizzleExecutor, input: {
+    actorUserId: string;
+    scope?: RetentionScope;
+    before?: string;
+    limit: number;
+}): Promise<Page<RetentionRun>>;
+//# sourceMappingURL=retentionRunList.d.ts.map

package/packages/happy2-server/dist/modules/retention/retentionRunList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionRunList.d.ts","sourceRoot":"","sources":["../../../sources/modules/retention/retentionRunList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAY3F;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB,GACF,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAa7B"}

package/packages/happy2-server/dist/modules/retention/retentionRunList.js

@@ -0,0 +1,31 @@
+import {} from "../drizzle.js";
+import {} from "../operations/types.js";
+import { and, desc, eq } from "drizzle-orm";
+import { asRetention } from "./impl/asRetention.js";
+import { cursorCondition } from "../operations/cursorCondition.js";
+import { decodeCursor } from "../operations/decodeCursor.js";
+import { page } from "../operations/page.js";
+import { retentionRuns } from "../schema.js";
+import { retentionSelection } from "./impl/retentionSelection.js";
+import { userRequireOperationsAdmin } from "../operations/userRequireOperationsAdmin.js";
+/**
+ * Returns an administrator-only reverse-chronological page of retention runs, optionally filtered by scope and continued before a start-time cursor.
+ * The shared page projection exposes durable cleanup outcomes without allowing ordinary users to inspect server policy execution.
+ */
+export async function retentionRunList(executor, input) {
+    await userRequireOperationsAdmin(executor, input.actorUserId);
+    const conditions = [];
+    if (input.scope)
+        conditions.push(eq(retentionRuns.scope, input.scope));
+    const cursor = decodeCursor(input.before);
+    if (cursor)
+        conditions.push(cursorCondition(retentionRuns.startedAt, retentionRuns.id, cursor));
+    const rows = await executor
+        .select(retentionSelection)
+        .from(retentionRuns)
+        .where(and(...conditions))
+        .orderBy(desc(retentionRuns.startedAt), desc(retentionRuns.id))
+        .limit(input.limit + 1);
+    return page(rows, input.limit, asRetention, (item) => item.startedAt);
+}
+//# sourceMappingURL=retentionRunList.js.map

package/packages/happy2-server/dist/modules/retention/retentionRunList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionRunList.js","sourceRoot":"","sources":["../../../sources/modules/retention/retentionRunList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,eAAe,CAAC;AACrD,OAAO,EAAqD,MAAM,wBAAwB,CAAC;AAE3F,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAY,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,QAAyB,EACzB,KAKC;IAED,MAAM,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAU,EAAE,CAAC;IAC7B,IAAI,KAAK,CAAC,KAAK;QAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM;QAAE,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,MAAM,QAAQ;SACtB,MAAM,CAAC,kBAAkB,CAAC;SAC1B,IAAI,CAAC,aAAa,CAAC;SACnB,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;SACzB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;SAC9D,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC"}

package/packages/happy2-server/dist/modules/retention/retentionRunStart.d.ts

@@ -0,0 +1,14 @@
+import { type AuditContext } from "../operations/auditContext.js";
+import { type DrizzleExecutor } from "../drizzle.js";
+import { type RetentionRun, type RetentionScope } from "../operations/types.js";
+/**
+ * Opens a retentionRuns record with the requested policy snapshot after operations-administrator authorization.
+ * Capturing the immutable scope and audit evidence before deletion begins gives the asynchronous cleanup a reviewable execution boundary.
+ */
+export declare function retentionRunStart(executor: DrizzleExecutor, input: {
+    actorUserId: string;
+    scope: RetentionScope;
+    details?: Record<string, unknown>;
+    context?: AuditContext;
+}): Promise<RetentionRun>;
+//# sourceMappingURL=retentionRunStart.d.ts.map

package/packages/happy2-server/dist/modules/retention/retentionRunStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionRunStart.d.ts","sourceRoot":"","sources":["../../../sources/modules/retention/retentionRunStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAWjG;;;GAGG;AACH,wBAAsB,iBAAiB,CACnC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,YAAY,CAAC;CAC1B,GACF,OAAO,CAAC,YAAY,CAAC,CAgCvB"}

package/packages/happy2-server/dist/modules/retention/retentionRunStart.js

@@ -0,0 +1,45 @@
+import {} from "../operations/auditContext.js";
+import { withTransaction } from "../drizzle.js";
+import { OperationsError } from "../operations/types.js";
+import { and, eq } from "drizzle-orm";
+import { createId } from "@paralleldrive/cuid2";
+import { json } from "../operations/json.js";
+import { retentionRuns } from "../schema.js";
+import { auditAppend } from "../operations/auditAppend.js";
+import { userRequireOperationsAdmin } from "../operations/userRequireOperationsAdmin.js";
+import { retentionRunDb } from "./impl/retentionRunDb.js";
+/**
+ * Opens a retentionRuns record with the requested policy snapshot after operations-administrator authorization.
+ * Capturing the immutable scope and audit evidence before deletion begins gives the asynchronous cleanup a reviewable execution boundary.
+ */
+export async function retentionRunStart(executor, input) {
+    return withTransaction(executor, async (tx) => {
+        await userRequireOperationsAdmin(tx, input.actorUserId);
+        const [active] = await tx
+            .select({
+            id: retentionRuns.id,
+        })
+            .from(retentionRuns)
+            .where(and(eq(retentionRuns.scope, input.scope), eq(retentionRuns.status, "running")))
+            .limit(1);
+        if (active)
+            throw new OperationsError("conflict", "A retention run is already active for this scope");
+        const id = createId();
+        await tx.insert(retentionRuns).values({
+            id,
+            scope: input.scope,
+            detailsJson: json(input.details),
+        });
+        const run = await retentionRunDb(tx, id);
+        await auditAppend(tx, {
+            actorUserId: input.actorUserId,
+            action: "retention.started",
+            targetType: "retention_run",
+            targetId: id,
+            after: run,
+            context: input.context,
+        });
+        return run;
+    });
+}
+//# sourceMappingURL=retentionRunStart.js.map

package/packages/happy2-server/dist/modules/retention/retentionRunStart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retentionRunStart.js","sourceRoot":"","sources":["../../../sources/modules/retention/retentionRunStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAwB,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAA0C,MAAM,wBAAwB,CAAC;AAEjG,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,QAAyB,EACzB,KAKC;IAED,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,0BAA0B,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;aACpB,MAAM,CAAC;YACJ,EAAE,EAAE,aAAa,CAAC,EAAE;SACvB,CAAC;aACD,IAAI,CAAC,aAAa,CAAC;aACnB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;aACrF,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,IAAI,MAAM;YACN,MAAM,IAAI,eAAe,CACrB,UAAU,EACV,kDAAkD,CACrD,CAAC;QACN,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;YAClC,EAAE;YACF,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;SACnC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,WAAW,CAAC,EAAE,EAAE;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,mBAAmB;YAC3B,UAAU,EAAE,eAAe;YAC3B,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACf,CAAC,CAAC,CAAC;AACP,CAAC"}