@nodii/dsar 0.19.0 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/dist/bind-pattern-a.d.ts +139 -2
  2. package/dist/bind-pattern-a.d.ts.map +1 -1
  3. package/dist/bind-pattern-a.js +571 -32
  4. package/dist/bind-pattern-a.js.map +1 -1
  5. package/dist/bind-pattern-b.d.ts.map +1 -1
  6. package/dist/bind-pattern-b.js +58 -3
  7. package/dist/bind-pattern-b.js.map +1 -1
  8. package/dist/grpc/dsar-service.d.ts +29 -0
  9. package/dist/grpc/dsar-service.d.ts.map +1 -1
  10. package/dist/grpc/dsar-service.js +34 -0
  11. package/dist/grpc/dsar-service.js.map +1 -1
  12. package/dist/grpc/proto-path.d.ts +33 -0
  13. package/dist/grpc/proto-path.d.ts.map +1 -0
  14. package/dist/grpc/proto-path.js +87 -0
  15. package/dist/grpc/proto-path.js.map +1 -0
  16. package/dist/hold-failure-mode.d.ts +24 -0
  17. package/dist/hold-failure-mode.d.ts.map +1 -1
  18. package/dist/hold-failure-mode.js +24 -0
  19. package/dist/hold-failure-mode.js.map +1 -1
  20. package/dist/hold-gate-probe.d.ts +61 -0
  21. package/dist/hold-gate-probe.d.ts.map +1 -0
  22. package/dist/hold-gate-probe.js +146 -0
  23. package/dist/hold-gate-probe.js.map +1 -0
  24. package/dist/holds.d.ts +60 -1
  25. package/dist/holds.d.ts.map +1 -1
  26. package/dist/holds.js +60 -3
  27. package/dist/holds.js.map +1 -1
  28. package/dist/index.d.ts +16 -6
  29. package/dist/index.d.ts.map +1 -1
  30. package/dist/index.js +28 -5
  31. package/dist/index.js.map +1 -1
  32. package/dist/migrations/index.d.ts.map +1 -1
  33. package/dist/migrations/index.js +10 -0
  34. package/dist/migrations/index.js.map +1 -1
  35. package/dist/orchestrator.d.ts +48 -0
  36. package/dist/orchestrator.d.ts.map +1 -1
  37. package/dist/orchestrator.js +297 -20
  38. package/dist/orchestrator.js.map +1 -1
  39. package/dist/register.d.ts +35 -1
  40. package/dist/register.d.ts.map +1 -1
  41. package/dist/register.js +26 -0
  42. package/dist/register.js.map +1 -1
  43. package/dist/retention-sweeper.d.ts +252 -0
  44. package/dist/retention-sweeper.d.ts.map +1 -0
  45. package/dist/retention-sweeper.js +356 -0
  46. package/dist/retention-sweeper.js.map +1 -0
  47. package/dist/retention.d.ts +109 -1
  48. package/dist/retention.d.ts.map +1 -1
  49. package/dist/retention.js +216 -3
  50. package/dist/retention.js.map +1 -1
  51. package/dist/subject-kinds.d.ts +74 -0
  52. package/dist/subject-kinds.d.ts.map +1 -0
  53. package/dist/subject-kinds.js +141 -0
  54. package/dist/subject-kinds.js.map +1 -0
  55. package/dist/types.d.ts +423 -7
  56. package/dist/types.d.ts.map +1 -1
  57. package/dist/types.js +164 -0
  58. package/dist/types.js.map +1 -1
  59. package/package.json +7 -4
  60. package/proto/nodii/dsar/v1/dsar.proto +202 -0
  61. package/src/migrations/001-lifecycle-requests.sql +422 -0
@@ -0,0 +1,61 @@
1
+ import type { SqlTransaction } from "./types.js";
2
+ import { DsarError } from "./types.js";
3
+ /** The narrow client surface the probe needs. */
4
+ type ProbeSqlClient = Pick<SqlTransaction, "unsafe">;
5
+ /** Default probe budget. One round-trip; a boot must not hang on it. */
6
+ export declare const HOLD_GATE_PROBE_TIMEOUT_MS = 3000;
7
+ /**
8
+ * `hold_gate_error` detail when the probe could not reach the database at all
9
+ * (connection refused, DNS, auth, timeout).
10
+ */
11
+ export declare const HOLD_GATE_PROBE_UNREACHABLE_DETAIL = "dsar hold gate: the configured sqlClient could not be reached at bind time \u2014 holds cannot be consulted, so erase/restrict are refused (fail-closed).";
12
+ /**
13
+ * `hold_gate_error` detail when the connection works but the holds relation is
14
+ * absent — an unmigrated database, or the right server and the wrong database.
15
+ */
16
+ export declare const HOLD_GATE_PROBE_TABLE_MISSING_DETAIL = "dsar hold gate: the configured sqlClient is reachable but the holds table does not exist \u2014 run `applyDsarMigrations` against THIS database (a pool pointed at the wrong database satisfies every structural check and fails only at the first erase).";
17
+ /**
18
+ * Thrown by {@link bindPatternAAndVerify}, and used to reject
19
+ * `impl.holdGateReady`, when the hold-gate probe fails.
20
+ *
21
+ * There is no opt-out and no "warn and continue": a participant that cannot
22
+ * consult holds cannot serve `EraseData` or `RestrictProcessing`, and the
23
+ * operator ruling of 2026-07-30 makes that a refusal, not a degradation.
24
+ */
25
+ export declare class HoldGateUnreachableError extends DsarError {
26
+ readonly code = "HOLD_GATE_UNREACHABLE";
27
+ /** The probe detail — one of the two exported constants above. */
28
+ readonly detail: string;
29
+ /** The underlying driver error text, when there was one. */
30
+ readonly cause: string | undefined;
31
+ constructor(serviceName: string, detail: string, cause?: string);
32
+ }
33
+ /** Outcome of one probe run. */
34
+ export type HoldGateProbeResult = {
35
+ ok: true;
36
+ } | {
37
+ ok: false;
38
+ detail: string;
39
+ cause: string | undefined;
40
+ };
41
+ /**
42
+ * Run the reachability probe ONCE, bounded by `timeoutMs`.
43
+ *
44
+ * Deliberately a SINGLE statement and a SINGLE attempt. It is a boot smoke test,
45
+ * not a health checker: retrying would delay every boot by the retry budget to
46
+ * tell us the same thing, and the running service already re-consults holds on
47
+ * every request. `to_regclass` returns NULL rather than raising for an absent
48
+ * relation, so one round-trip answers both questions — is the connection alive,
49
+ * and does the holds table exist.
50
+ *
51
+ * NEVER THROWS. A probe that threw would have to be caught at every call site,
52
+ * and one uncaught path would crash a boot on a transient blip. It returns the
53
+ * failure instead, and the caller decides how hard to fail.
54
+ */
55
+ export declare function probeHoldGate(args: {
56
+ sql: ProbeSqlClient;
57
+ holdsTableName: string;
58
+ timeoutMs?: number;
59
+ }): Promise<HoldGateProbeResult>;
60
+ export {};
61
+ //# sourceMappingURL=hold-gate-probe.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hold-gate-probe.d.ts","sourceRoot":"","sources":["../src/hold-gate-probe.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,iDAAiD;AACjD,KAAK,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAErD,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,kCAAkC,8JACyG,CAAC;AAEzJ;;;GAGG;AACH,eAAO,MAAM,oCAAoC,+PACwM,CAAC;AAE1P;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,QAAQ,CAAC,IAAI,2BAA2B;IACxC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBACvB,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAUhE;AAED,gCAAgC;AAChC,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,cAAc,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsD/B"}
@@ -0,0 +1,146 @@
1
+ // The hold-gate REACHABILITY probe.
2
+ //
3
+ // WHY A STRUCTURAL CHECK WAS NOT ENOUGH
4
+ // -------------------------------------
5
+ // `bindPatternA` refuses to bind without a `sqlClient`
6
+ // (`MissingSqlClientForHoldGateError`). That check is STRUCTURAL: it proves an
7
+ // object with an `unsafe` method was passed, and nothing else. A pool wired to a
8
+ // host that is down, to the WRONG database, or to a database that never had
9
+ // `applyDsarMigrations` run against it satisfies it completely and binds clean.
10
+ //
11
+ // The service then boots green, serves traffic, and refuses its first erase with
12
+ // `hold_consult_failed_fail_closed` — which is the correct fail-closed outcome,
13
+ // and is exactly as invisible at deploy time as the no-pool case was before the
14
+ // bind-time check existed. "There is a pool" and "holds can be consulted" are
15
+ // different claims, and only the second one is the one the gate depends on.
16
+ //
17
+ // The probe closes that gap: one bounded round-trip at bind that asserts the
18
+ // connection works AND the holds relation exists.
19
+ //
20
+ // WHY IT CANNOT THROW FROM `bindPatternA`
21
+ // ---------------------------------------
22
+ // `bindPatternA` is SYNCHRONOUS and returns a `DsarServiceImpl`. A database
23
+ // round-trip is not, and making the bind async would break every consumer's boot
24
+ // path — for a check whose whole purpose is to make boots safer. So the probe is
25
+ // FIRED at bind and its outcome is surfaced two ways:
26
+ //
27
+ // 1. `impl.holdGateReady` (via `holdGateReadyOf(impl)`) — the probe promise. A
28
+ // consumer that wants a HARD boot gate awaits it and lets a rejection abort
29
+ // the deploy. This is the recommended wiring.
30
+ // 2. `bindPatternAAndVerify(opts)` — the same thing pre-wired: awaits the probe
31
+ // and throws `HoldGateUnreachableError`. One call, no discipline required.
32
+ //
33
+ // WHAT DELIBERATELY IS NOT HERE: a third surface where the erase / restrict
34
+ // handlers await the verdict themselves.
35
+ //
36
+ // An earlier draft had exactly that, and called it "the floor". It is a bug. A
37
+ // service that booted during a five-second DB blip would then refuse every erase
38
+ // FOREVER, until redeployed — and the operator ruling the whole fail-closed
39
+ // posture rests on says the opposite: "it's just a matter of a retry when holds
40
+ // is accessible". A latched boot verdict is precisely the un-retryable refusal
41
+ // D650's non-memoization rule exists to prevent, relocated from the row cache
42
+ // into process memory. `ts/dsar/tests/hold-gate-probe.test.ts` pins the
43
+ // non-latching behaviour, and the pre-existing `RULING RETRY` integration test
44
+ // is what caught the draft.
45
+ //
46
+ // Nothing is lost. Every condition this probe detects — unreachable pool, wrong
47
+ // database, unmigrated schema — ALSO makes the per-request `isHeld` consult
48
+ // raise, and that already produces the branded, audited, non-memoizable refusal.
49
+ // The runtime floor was never the probe's job; the per-request consult is, and
50
+ // always was, the runtime authority. The probe's unique contribution is telling a
51
+ // DEPLOY, once, instead of telling the first production erase.
52
+ import { DsarError } from "./types.js";
53
+ /** Default probe budget. One round-trip; a boot must not hang on it. */
54
+ export const HOLD_GATE_PROBE_TIMEOUT_MS = 3_000;
55
+ /**
56
+ * `hold_gate_error` detail when the probe could not reach the database at all
57
+ * (connection refused, DNS, auth, timeout).
58
+ */
59
+ export const HOLD_GATE_PROBE_UNREACHABLE_DETAIL = "dsar hold gate: the configured sqlClient could not be reached at bind time — holds cannot be consulted, so erase/restrict are refused (fail-closed).";
60
+ /**
61
+ * `hold_gate_error` detail when the connection works but the holds relation is
62
+ * absent — an unmigrated database, or the right server and the wrong database.
63
+ */
64
+ export const HOLD_GATE_PROBE_TABLE_MISSING_DETAIL = "dsar hold gate: the configured sqlClient is reachable but the holds table does not exist — run `applyDsarMigrations` against THIS database (a pool pointed at the wrong database satisfies every structural check and fails only at the first erase).";
65
+ /**
66
+ * Thrown by {@link bindPatternAAndVerify}, and used to reject
67
+ * `impl.holdGateReady`, when the hold-gate probe fails.
68
+ *
69
+ * There is no opt-out and no "warn and continue": a participant that cannot
70
+ * consult holds cannot serve `EraseData` or `RestrictProcessing`, and the
71
+ * operator ruling of 2026-07-30 makes that a refusal, not a degradation.
72
+ */
73
+ export class HoldGateUnreachableError extends DsarError {
74
+ code = "HOLD_GATE_UNREACHABLE";
75
+ /** The probe detail — one of the two exported constants above. */
76
+ detail;
77
+ /** The underlying driver error text, when there was one. */
78
+ cause;
79
+ constructor(serviceName, detail, cause) {
80
+ super(`HOLD_GATE_UNREACHABLE: bindPatternA(${JSON.stringify(serviceName)}) could not verify the hold gate at boot. ${detail}${cause ? ` Underlying error: ${cause}` : ""}`);
81
+ this.name = "HoldGateUnreachableError";
82
+ this.detail = detail;
83
+ this.cause = cause;
84
+ }
85
+ }
86
+ /**
87
+ * Run the reachability probe ONCE, bounded by `timeoutMs`.
88
+ *
89
+ * Deliberately a SINGLE statement and a SINGLE attempt. It is a boot smoke test,
90
+ * not a health checker: retrying would delay every boot by the retry budget to
91
+ * tell us the same thing, and the running service already re-consults holds on
92
+ * every request. `to_regclass` returns NULL rather than raising for an absent
93
+ * relation, so one round-trip answers both questions — is the connection alive,
94
+ * and does the holds table exist.
95
+ *
96
+ * NEVER THROWS. A probe that threw would have to be caught at every call site,
97
+ * and one uncaught path would crash a boot on a transient blip. It returns the
98
+ * failure instead, and the caller decides how hard to fail.
99
+ */
100
+ export async function probeHoldGate(args) {
101
+ const budget = args.timeoutMs ?? HOLD_GATE_PROBE_TIMEOUT_MS;
102
+ let timer;
103
+ const timeout = new Promise((resolve) => {
104
+ timer = setTimeout(() => resolve({
105
+ ok: false,
106
+ detail: HOLD_GATE_PROBE_UNREACHABLE_DETAIL,
107
+ cause: `probe exceeded ${budget}ms`,
108
+ }), budget);
109
+ // A pending timer must not hold the process open — a boot probe should
110
+ // never be the reason a CLI or a short-lived job refuses to exit.
111
+ timer.unref?.();
112
+ });
113
+ const run = (async () => {
114
+ try {
115
+ // `to_regclass` is NULL-returning, not raising, so an absent relation is
116
+ // data rather than an exception — which is what lets one statement
117
+ // distinguish "cannot connect" from "connected, table missing".
118
+ const rows = (await args.sql.unsafe("SELECT to_regclass($1) IS NOT NULL AS holds_table_present", [args.holdsTableName]));
119
+ const raw = rows?.[0]?.holds_table_present;
120
+ const present = raw === true || raw === "t" || raw === "true" || raw === 1;
121
+ if (!present) {
122
+ return {
123
+ ok: false,
124
+ detail: HOLD_GATE_PROBE_TABLE_MISSING_DETAIL,
125
+ cause: `to_regclass(${args.holdsTableName}) returned ${rows?.length ? JSON.stringify(raw) : "no rows"}`,
126
+ };
127
+ }
128
+ return { ok: true };
129
+ }
130
+ catch (err) {
131
+ return {
132
+ ok: false,
133
+ detail: HOLD_GATE_PROBE_UNREACHABLE_DETAIL,
134
+ cause: err instanceof Error ? err.message : String(err),
135
+ };
136
+ }
137
+ })();
138
+ try {
139
+ return await Promise.race([run, timeout]);
140
+ }
141
+ finally {
142
+ if (timer !== undefined)
143
+ clearTimeout(timer);
144
+ }
145
+ }
146
+ //# sourceMappingURL=hold-gate-probe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hold-gate-probe.js","sourceRoot":"","sources":["../src/hold-gate-probe.ts"],"names":[],"mappings":"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"}
package/dist/holds.d.ts CHANGED
@@ -105,11 +105,70 @@ export interface LiftedHold {
105
105
  * the `lifted` rows (`id`, `subject_id`, `hold_kind`, `data_class`) via
106
106
  * `RETURNING`, so the caller (e.g. the tenant residency-holds outbox producer)
107
107
  * emits ONE event per lifted row atomically — no pre-SELECT race window.
108
+ *
109
+ * ## Scope (drift `4a72cce1`) — three scopes, none of them guessed
110
+ *
111
+ * | call | lifts |
112
+ * |---|---|
113
+ * | `subjectId: 's1'` | ONLY `subject_id = 's1'`. Tenant-level rows SURVIVE. |
114
+ * | `subjectId: null` / omitted | ONLY the tenant-level rows (`subject_id IS NULL`). |
115
+ * | `subjectId: null` + `sweepAllSubjects: true` | EVERY unlifted row in the tenant, subject-scoped rows included. |
116
+ *
117
+ * A concrete `subjectId` together with `sweepAllSubjects: true` throws
118
+ * {@link AmbiguousLiftScope} — the two say opposite things.
119
+ *
120
+ * `sweepAllSubjects` is deliberately NOT called `tenantWide`. The participant
121
+ * bind layer hands its lift handler a `tenant_level` boolean meaning "the
122
+ * request named no subject, so act on the tenant-level ROW"; under the old name
123
+ * the two read as synonyms, and forwarding one into the other silently converted
124
+ * a one-row tenant lift into a whole-tenant sweep — this function's own bug,
125
+ * re-entered through its caller. There is no flag to forward: a lift request
126
+ * reaches this function through `subjectId` (`null` for the tenant-level row).
127
+ * `sweepAllSubjects` is an OPERATOR action with no request-level equivalent.
128
+ *
129
+ * ### What this fixes
130
+ *
131
+ * The predicate used to be
132
+ * `($3::text IS NULL OR subject_id = $3 OR subject_id IS NULL)`. That trailing
133
+ * `OR subject_id IS NULL` is unconditional: it applies on the `subjectId = 's1'`
134
+ * branch too. So a lift scoped to ONE data subject also lifted every
135
+ * TENANT-LEVEL hold of the matching kinds — including a statutory
136
+ * `legal` / `aml_regulatory` hold placed over the whole tenant. One subject
137
+ * exercising Art. 17 silently released the tenant's litigation hold, and the
138
+ * next erase for ANY subject then passed the gate. The `RETURNING` rows made it
139
+ * worse rather than louder: the caller emitted a `lifted.v1` event per
140
+ * collaterally-lifted row, so the release propagated across the fleet.
141
+ *
142
+ * `isHeld` / `listActiveHolds` keep their `OR subject_id IS NULL` arm — and
143
+ * must. On a READ that arm is the fail-SAFE direction (a tenant hold correctly
144
+ * blocks every subject's erase, and correctly surfaces in every subject's hold
145
+ * list). On this WRITE the same arm is the fail-DANGEROUS direction, because it
146
+ * RELEASES protection rather than applying it. Same clause, opposite sign.
108
147
  */
109
148
  export declare function liftHold(opts: {
110
149
  sql: SqlClient;
111
150
  tenantId: string;
112
- subjectId: string | null;
151
+ /**
152
+ * The subject whose holds are lifted. `null` / omitted = a scope that is NOT
153
+ * a subject: tenant-level holds only, unless `sweepAllSubjects` widens it.
154
+ */
155
+ subjectId?: string | null;
156
+ /**
157
+ * Opt IN to the WHOLE-TENANT SWEEP: every unlifted row in the tenant,
158
+ * INCLUDING every subject's own holds. Requires `subjectId` to be `null` /
159
+ * omitted.
160
+ *
161
+ * This is the ONLY way to reach the pre-4a72cce1 `subjectId: null` behaviour.
162
+ * It is deliberately explicit and deliberately unattractive to type: releasing
163
+ * every subject's holds is a distinct, far higher-blast-radius operation than
164
+ * "release the tenant-level hold", and the old API spelled both of them
165
+ * `subjectId: null`.
166
+ *
167
+ * NEVER derive this from a `LiftRetentionHold` request. The bind layer's
168
+ * `tenant_level` flag is its OPPOSITE (one row vs. all rows) — see
169
+ * `RetentionHoldHandlers.lift`.
170
+ */
171
+ sweepAllSubjects?: boolean;
113
172
  holdKind: HoldKind | readonly HoldKind[];
114
173
  liftedBy: string;
115
174
  /** v0.4.0 — optional data-class narrowing. */
@@ -1 +1 @@
1
- {"version":3,"file":"holds.d.ts","sourceRoot":"","sources":["../src/holds.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG1E,KAAK,SAAS,GAAG;IAEf,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,QAAQ,EAAE,CAAC;IAC1C;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD;;;;;;;;;;;;GAYG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqCzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAyC7C;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,QAAQ,EAAE,CAAC;IAC1C,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAqDxB;AAED;2EAC2E;AAC3E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,QAAQ,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,QAAQ,GAAG,SAAS,QAAQ,EAAE,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CA+BnD"}
1
+ {"version":3,"file":"holds.d.ts","sourceRoot":"","sources":["../src/holds.ts"],"names":[],"mappings":"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"}
package/dist/holds.js CHANGED
@@ -14,7 +14,7 @@
14
14
  // - The consult can be invoked fail-closed by the caller (the consult
15
15
  // itself throws on SQL error; the caller decides open-vs-closed). See
16
16
  // `bind-pattern-a.ts` / `orchestrator.ts` (gap 3).
17
- import { DEFAULT_ERASE_BLOCKING_HOLD_KINDS } from "./types.js";
17
+ import { AmbiguousLiftScope, DEFAULT_ERASE_BLOCKING_HOLD_KINDS, } from "./types.js";
18
18
  function normalizeKinds(kind) {
19
19
  if (kind === undefined)
20
20
  return [...DEFAULT_ERASE_BLOCKING_HOLD_KINDS];
@@ -191,21 +191,78 @@ export async function listActiveHolds(opts) {
191
191
  * the `lifted` rows (`id`, `subject_id`, `hold_kind`, `data_class`) via
192
192
  * `RETURNING`, so the caller (e.g. the tenant residency-holds outbox producer)
193
193
  * emits ONE event per lifted row atomically — no pre-SELECT race window.
194
+ *
195
+ * ## Scope (drift `4a72cce1`) — three scopes, none of them guessed
196
+ *
197
+ * | call | lifts |
198
+ * |---|---|
199
+ * | `subjectId: 's1'` | ONLY `subject_id = 's1'`. Tenant-level rows SURVIVE. |
200
+ * | `subjectId: null` / omitted | ONLY the tenant-level rows (`subject_id IS NULL`). |
201
+ * | `subjectId: null` + `sweepAllSubjects: true` | EVERY unlifted row in the tenant, subject-scoped rows included. |
202
+ *
203
+ * A concrete `subjectId` together with `sweepAllSubjects: true` throws
204
+ * {@link AmbiguousLiftScope} — the two say opposite things.
205
+ *
206
+ * `sweepAllSubjects` is deliberately NOT called `tenantWide`. The participant
207
+ * bind layer hands its lift handler a `tenant_level` boolean meaning "the
208
+ * request named no subject, so act on the tenant-level ROW"; under the old name
209
+ * the two read as synonyms, and forwarding one into the other silently converted
210
+ * a one-row tenant lift into a whole-tenant sweep — this function's own bug,
211
+ * re-entered through its caller. There is no flag to forward: a lift request
212
+ * reaches this function through `subjectId` (`null` for the tenant-level row).
213
+ * `sweepAllSubjects` is an OPERATOR action with no request-level equivalent.
214
+ *
215
+ * ### What this fixes
216
+ *
217
+ * The predicate used to be
218
+ * `($3::text IS NULL OR subject_id = $3 OR subject_id IS NULL)`. That trailing
219
+ * `OR subject_id IS NULL` is unconditional: it applies on the `subjectId = 's1'`
220
+ * branch too. So a lift scoped to ONE data subject also lifted every
221
+ * TENANT-LEVEL hold of the matching kinds — including a statutory
222
+ * `legal` / `aml_regulatory` hold placed over the whole tenant. One subject
223
+ * exercising Art. 17 silently released the tenant's litigation hold, and the
224
+ * next erase for ANY subject then passed the gate. The `RETURNING` rows made it
225
+ * worse rather than louder: the caller emitted a `lifted.v1` event per
226
+ * collaterally-lifted row, so the release propagated across the fleet.
227
+ *
228
+ * `isHeld` / `listActiveHolds` keep their `OR subject_id IS NULL` arm — and
229
+ * must. On a READ that arm is the fail-SAFE direction (a tenant hold correctly
230
+ * blocks every subject's erase, and correctly surfaces in every subject's hold
231
+ * list). On this WRITE the same arm is the fail-DANGEROUS direction, because it
232
+ * RELEASES protection rather than applying it. Same clause, opposite sign.
194
233
  */
195
234
  export async function liftHold(opts) {
196
235
  const table = opts.tableName ?? "data_residency_holds";
197
236
  const kinds = normalizeKinds(opts.holdKind);
237
+ const subjectId = opts.subjectId ?? null;
238
+ if (opts.sweepAllSubjects === true && subjectId !== null) {
239
+ throw new AmbiguousLiftScope(subjectId);
240
+ }
241
+ // Every branch still REFERENCES $3 (bound to `subjectId`) so the parameter
242
+ // count matches the statement in all three scopes — postgres rejects a bind
243
+ // that supplies a parameter the statement never mentions.
244
+ const subjectScope = opts.sweepAllSubjects === true
245
+ ? // Guarded above: `sweepAllSubjects` implies subjectId === null, so this
246
+ // is unconditionally TRUE — no subject predicate at all (the sweep).
247
+ "$3::text IS NULL"
248
+ : subjectId === null
249
+ ? // Tenant-level holds ONLY. `$3::text IS NULL` is the guard that keeps
250
+ // this arm unreachable from the per-subject branch.
251
+ "(subject_id IS NULL AND $3::text IS NULL)"
252
+ : // Per-subject lift — STRICT. No `OR subject_id IS NULL`: a subject's
253
+ // lift must never release the tenant's hold (drift 4a72cce1).
254
+ "subject_id = $3";
198
255
  const stmt = `UPDATE ${table}
199
256
  SET lifted_at = now(), lifted_by = $4
200
257
  WHERE tenant_id = $1 AND hold_kind = ANY($2::text[]) AND lifted_at IS NULL
201
- AND ($3::text IS NULL OR subject_id = $3 OR subject_id IS NULL)
258
+ AND ${subjectScope}
202
259
  AND ($5::text IS NULL OR data_class IS NULL OR data_class = $5)
203
260
  AND ($6::text IS NULL OR hold_request_id = $6)
204
261
  RETURNING id::text AS id, subject_id, hold_kind, data_class`;
205
262
  const rows = (await opts.sql.unsafe(stmt, [
206
263
  opts.tenantId,
207
264
  kinds,
208
- opts.subjectId,
265
+ subjectId,
209
266
  opts.liftedBy,
210
267
  opts.dataClass ?? null,
211
268
  opts.holdRequestId ?? null,
package/dist/holds.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"holds.js","sourceRoot":"","sources":["../src/holds.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"holds.js","sourceRoot":"","sources":["../src/holds.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,WAAW;AACX,EAAE;AACF,yCAAyC;AACzC,yEAAyE;AACzE,4EAA4E;AAC5E,6DAA6D;AAC7D,0CAA0C;AAC1C,8EAA8E;AAC9E,eAAe;AACf,wEAAwE;AACxE,0EAA0E;AAC1E,uDAAuD;AAGvD,OAAO,EACL,kBAAkB,EAClB,iCAAiC,GAClC,MAAM,YAAY,CAAC;AA6BpB,SAAS,cAAc,CACrB,IAAgD;IAEhD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,iCAAiC,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAgB,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,sBAAsB,CAAC;IACvD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,wEAAwE;IACxE,6EAA6E;IAC7E,4DAA4D;IAC5D,MAAM,IAAI,GAAG;;WAEJ,KAAK;;;;;;;YAOJ,CAAC;IACX,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;QACxC,IAAI,CAAC,QAAQ;QACb,KAAK;QACL,IAAI,CAAC,SAAS,IAAI,IAAI;QACtB,IAAI,CAAC,SAAS,IAAI,IAAI;KACvB,CAAC,CAIC,CAAC;IACJ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC/B,OAAO;QACL,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;QACpC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,SAAS;KACtC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAa/B;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,sBAAsB,CAAC;IACvD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,0EAA0E;IAC1E,yEAAyE;IACzE,2EAA2E;IAC3E,6EAA6E;IAC7E,oEAAoE;IACpE,MAAM,QAAQ,GACZ,IAAI,CAAC,aAAa,KAAK,SAAS;QAC9B,CAAC,CAAC,0HAA0H;QAC5H,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,IAAI,GAAG,eAAe,KAAK;;;;MAI7B,QAAQ;yCAC2B,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;QACxC,EAAE;QACF,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,SAAS,IAAI,IAAI;QACtB,IAAI,CAAC,aAAa,IAAI,IAAI;QAC1B,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,SAAS,IAAI,IAAI;QACtB,IAAI,CAAC,QAAQ;KACd,CAAC,CAA0D,CAAC;IAC7D,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,0EAA0E;QAC1E,2EAA2E;QAC3E,yEAAyE;QACzE,oEAAoE;QACpE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,6EAA6E;IAC7E,4EAA4E;IAC5E,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,sFAAsF;AACtF,SAAS,UAAU,CAAC,CAA4B;IAC9C,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAWrC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,sBAAsB,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;IAChC,wCAAwC;IACxC,MAAM,KAAK,GACT,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG;;;;;;;;;;WAUJ,KAAK;;;;;;;;aAQH,CAAC;IACZ,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;QACxC,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,SAAS,IAAI,IAAI;QACtB,KAAK;QACL,IAAI,CAAC,SAAS,IAAI,IAAI;QACtB,KAAK;KACN,CAAC,CAUA,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;QAChC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;QACpC,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC,CAAC;AACN,CAAC;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IA+B9B;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,sBAAsB,CAAC;IACvD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IACzC,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACzD,MAAM,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IACD,2EAA2E;IAC3E,4EAA4E;IAC5E,0DAA0D;IAC1D,MAAM,YAAY,GAChB,IAAI,CAAC,gBAAgB,KAAK,IAAI;QAC5B,CAAC,CAAC,wEAAwE;YACxE,qEAAqE;YACrE,kBAAkB;QACpB,CAAC,CAAC,SAAS,KAAK,IAAI;YAClB,CAAC,CAAC,sEAAsE;gBACtE,oDAAoD;gBACpD,2CAA2C;YAC7C,CAAC,CAAC,qEAAqE;gBACrE,8DAA8D;gBAC9D,iBAAiB,CAAC;IAC1B,MAAM,IAAI,GAAG,UAAU,KAAK;;;YAGlB,YAAY;;;gEAGwC,CAAC;IAC/D,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;QACxC,IAAI,CAAC,QAAQ;QACb,KAAK;QACL,SAAS;QACT,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,SAAS,IAAI,IAAI;QACtB,IAAI,CAAC,aAAa,IAAI,IAAI;KAC3B,CAAC,CAKA,CAAC;IACH,MAAM,MAAM,GAAiB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;KACjC,CAAC,CAAC,CAAC;IACJ,sEAAsE;IACtE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC"}
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  export declare const LIB_NAME = "dsar";
2
- export declare const VERSION = "0.8.2";
2
+ export declare const VERSION = "0.22.0";
3
3
  export { initDsar, getDsarOrNull, requireDsar, _resetForTests, } from "./init.js";
4
4
  export type { InitDsarConfig, ResolvedDsarConfig } from "./init.js";
5
5
  export { InMemoryDsarStore } from "./store.js";
@@ -8,21 +8,31 @@ export { beginDsar, getDsar, listDsars, accessData, eraseData, portabilityExport
8
8
  export type { BeginDsarArgs, BeginDsarResult, GetDsarArgs, ListDsarsArgs, AccessDataArgs, AccessDataResult, EraseDataArgs, EraseDataResult, PortabilityExportArgs, PortabilityExportResult, RectifyArgs, RectifyResult, MarkCompleteArgs, MarkCompleteResult, AppealRejectionArgs, AppealRejectionResult, } from "./handlers.js";
9
9
  export { canonicalJson, CanonicalSerializationError, EventNonCanonical, } from "./canonical.js";
10
10
  export type { CanonicalValue } from "./canonical.js";
11
- export { AmbiguousHoldFailureMode, HELD_WRITE_FAILED_REASON, HOLD_CONSULT_FAILED_REASON, HOLD_GATE_INFRA_REFUSAL_REASONS, holdGateRefusalAuditPayload, isNonMemoizableOutcome, resolveFailClosedHolds, } from "./hold-failure-mode.js";
11
+ export { AmbiguousHoldFailureMode, HELD_WRITE_FAILED_REASON, HOLD_CONSULT_FAILED_REASON, HOLD_GATE_INFRA_REFUSAL_REASONS, HOLD_GATE_NO_SQL_CLIENT_DETAIL, holdGateRefusalAuditPayload, isNonMemoizableOutcome, resolveFailClosedHolds, } from "./hold-failure-mode.js";
12
12
  export type { HoldFailureModeOpts } from "./hold-failure-mode.js";
13
+ export { SUBJECT_KINDS, UNKNOWN_SUBJECT_KIND_REASON, UnknownSubjectKindError, assertSubjectKind, isSubjectKind, unknownSubjectKindRefusal, } from "./subject-kinds.js";
14
+ export type { SubjectKind } from "./subject-kinds.js";
13
15
  export { applyRetention } from "./retention.js";
14
16
  export type { RetentionMatch } from "./retention.js";
15
- export { DsarError, DsarNotInitialized, DsarNotFound, DsarStoreRequired, JustificationRequired, SubjectKindNotRegistered, DsarTerminalStateViolation, ExportGatherFailed, EraseExecutionFailed, HandlerAlreadyRegistered, CmkAdapterNotConfigured, CmkResolutionFailed, tenantCmkAliasAdapter, } from "./types.js";
17
+ export { DEFAULT_PII_BUCKET, PII_BUCKETS, RETENTION_ANCHORS, RestrictedMarkerNotWritten, STATUTORY_ALREADY_TENANT_SHREDDED_REASON, STATUTORY_NOT_RETENTION_KEYED_REASON, STATUTORY_RETENTION_PARTIAL_REASON, StatutoryBucketNotRetentionKeyed, isPiiBucket, isRetentionAnchor, } from "./types.js";
18
+ export type { PiiBucket, RetainedClass, RetentionAnchor, RetentionDekState, RetentionSchedule, } from "./types.js";
19
+ export { RETENTION_SCHEDULES_TABLE, addIsoDuration, applyRetentionSchedules, createRetentionSchedulesTable, parseIsoDuration, retentionSchedulesDdl, } from "./retention.js";
20
+ export type { ParsedDuration, RetentionScheduleMatch, RetentionScheduleQuery, RetentionSchedulesTable, } from "./retention.js";
21
+ export { RETENTION_SWEEPER_BATCH_SIZE, RETENTION_SWEEPER_INTERVAL_MS, RETENTION_SWEEPER_JOB_NAME, RetentionSweepHoldConsultFailed, makeRetentionSweeperJob, retentionPurgeTopic, } from "./retention-sweeper.js";
22
+ export type { RetentionPurgeEvent, RetentionPurgeOutboxEmitter, RetentionPurgeRecord, RetentionSweepResult, RetentionSweepTarget, RetentionSweeperJobDefinition, RetentionSweeperOpts, } from "./retention-sweeper.js";
23
+ export { DsarError, DsarNotInitialized, DsarNotFound, DsarStoreRequired, JustificationRequired, SubjectKindNotRegistered, DsarTerminalStateViolation, ExportGatherFailed, EraseExecutionFailed, HandlerAlreadyRegistered, CmkAdapterNotConfigured, CmkResolutionFailed, MissingSqlClientForHoldGateError, AmbiguousLiftScope, tenantCmkAliasAdapter, } from "./types.js";
16
24
  export type { ActiveHold, CompensationLogEntry, DsarRequestType, DsarRow, DsarStatus, DsarStore, DsarSubjectKind, EraseExecutorFn, ExportGatherFn, HoldKind, PortabilityFormat, RectifyHandlerFn, RetentionPolicy, LifecycleResponse, AggregatorStatus, SiblingState, PlatformLifecycleRequestRow, ListActiveHoldsRequest, ListActiveHoldsResponse, SubjectKindStr, PatternAEnvelope, PatternAHandlers, DecryptedExportBundle, RetentionHoldHandlers, HoldConsultResult, AuditEmitter, PiiAdapter, CmkRef, CmkLookupAdapter, DsarComplianceEvent, OutboxEmitter, SqlTransaction, } from "./types.js";
17
25
  export { DEFAULT_ERASE_BLOCKING_HOLD_KINDS, STATUTORY_HOLD_KINDS, CITATION_REQUIRED_HOLD_KINDS, MissingOutboxEmitterError, RPC_TO_COMPLIANCE_VERB, complianceTopic, } from "./types.js";
18
26
  export { type DsarServiceImpl, type DsarMethodHandler, type ListActiveHoldsMethodHandler, noDataServiceImpl, subjectKindFromProto, } from "./grpc/dsar-service.js";
19
- export { bindPatternA } from "./bind-pattern-a.js";
20
- export type { BindPatternAOpts } from "./bind-pattern-a.js";
27
+ export { dataLifecycleProtoFor, dataLifecycleProtoPath, dataLifecycleProtoSource, } from "./grpc/proto-path.js";
28
+ export { bindPatternA, bindPatternAAndVerify, complianceStatusFor, holdGateReadyOf, } from "./bind-pattern-a.js";
29
+ export { HOLD_GATE_PROBE_TABLE_MISSING_DETAIL, HOLD_GATE_PROBE_TIMEOUT_MS, HOLD_GATE_PROBE_UNREACHABLE_DETAIL, HoldGateUnreachableError, probeHoldGate, type HoldGateProbeResult, } from "./hold-gate-probe.js";
30
+ export type { BindPatternAOpts, RetentionBucketDeclaration, RetentionScheduleLookup, } from "./bind-pattern-a.js";
21
31
  export { bindPatternB } from "./bind-pattern-b.js";
22
32
  export type { BindPatternBOpts } from "./bind-pattern-b.js";
23
33
  export { bindPatternC } from "./bind-pattern-c.js";
24
34
  export type { BindPatternCOpts } from "./bind-pattern-c.js";
25
- export { bindOrchestrator, readAggregatorRow, dispatchModeFor, SYNC_RPCS, ASYNC_RPCS, } from "./orchestrator.js";
35
+ export { bindOrchestrator, readAggregatorRow, dispatchModeFor, SYNC_RPCS, ASYNC_RPCS, NO_SIBLING_REACHABLE_REASON, NO_SIBLING_REGISTERED_REASON, PARTIAL_SIBLING_FAILURE_REASON, PARTIAL_SIBLING_UNREACHABLE_REASON, } from "./orchestrator.js";
26
36
  export type { BindOrchestratorOpts, SiblingClient, } from "./orchestrator.js";
27
37
  export { registerWithOrchestrator } from "./register.js";
28
38
  export type { RegisterWithOrchestratorOpts, RegisterWithOrchestratorResult, DataClassRegistration, } from "./register.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -18,7 +18,7 @@
18
18
  // - isHeld() / placeHold() / liftHold() for data_residency_holds.
19
19
  // - Audit-action auto-naming via actionName() per 28-action family.
20
20
  export const LIB_NAME = "dsar";
21
- export const VERSION = "0.8.2";
21
+ export const VERSION = "0.22.0";
22
22
  // ---- Bootstrap ----
23
23
  export { initDsar, getDsarOrNull, requireDsar, _resetForTests, } from "./init.js";
24
24
  export { InMemoryDsarStore } from "./store.js";
@@ -45,19 +45,42 @@ export { canonicalJson, CanonicalSerializationError, EventNonCanonical, } from "
45
45
  // in `HOLD_GATE_INFRA_REFUSAL_REASONS`, and `isNonMemoizableOutcome` is the
46
46
  // rule that keeps them out of the `lifecycle_requests` response cache so the
47
47
  // ruling's "just a matter of a retry" is actually true.
48
- export { AmbiguousHoldFailureMode, HELD_WRITE_FAILED_REASON, HOLD_CONSULT_FAILED_REASON, HOLD_GATE_INFRA_REFUSAL_REASONS, holdGateRefusalAuditPayload, isNonMemoizableOutcome, resolveFailClosedHolds, } from "./hold-failure-mode.js";
48
+ export { AmbiguousHoldFailureMode, HELD_WRITE_FAILED_REASON, HOLD_CONSULT_FAILED_REASON, HOLD_GATE_INFRA_REFUSAL_REASONS, HOLD_GATE_NO_SQL_CLIENT_DETAIL, holdGateRefusalAuditPayload, isNonMemoizableOutcome, resolveFailClosedHolds, } from "./hold-failure-mode.js";
49
+ // ---- D719: the CLOSED data-subject vocabulary ----
50
+ // `SUBJECT_KINDS` is the single source of truth for what a `subject_kind` may
51
+ // be, in this library and on the wire. `DsarSubjectKind` + `SubjectKindStr`
52
+ // (below) are now aliases of `SubjectKind`; they used to be two DIFFERENT
53
+ // hand-maintained lists in the same file.
54
+ export { SUBJECT_KINDS, UNKNOWN_SUBJECT_KIND_REASON, UnknownSubjectKindError, assertSubjectKind, isSubjectKind, unknownSubjectKindRefusal, } from "./subject-kinds.js";
49
55
  export { applyRetention } from "./retention.js";
50
- export { DsarError, DsarNotInitialized, DsarNotFound, DsarStoreRequired, JustificationRequired, SubjectKindNotRegistered, DsarTerminalStateViolation, ExportGatherFailed, EraseExecutionFailed, HandlerAlreadyRegistered, CmkAdapterNotConfigured, CmkResolutionFailed, tenantCmkAliasAdapter, } from "./types.js";
56
+ // ---- D720: three-bucket retention + schedules + the purpose-spent sweeper ----
57
+ export { DEFAULT_PII_BUCKET, PII_BUCKETS, RETENTION_ANCHORS, RestrictedMarkerNotWritten, STATUTORY_ALREADY_TENANT_SHREDDED_REASON, STATUTORY_NOT_RETENTION_KEYED_REASON, STATUTORY_RETENTION_PARTIAL_REASON, StatutoryBucketNotRetentionKeyed, isPiiBucket, isRetentionAnchor, } from "./types.js";
58
+ export { RETENTION_SCHEDULES_TABLE, addIsoDuration, applyRetentionSchedules, createRetentionSchedulesTable, parseIsoDuration, retentionSchedulesDdl, } from "./retention.js";
59
+ export { RETENTION_SWEEPER_BATCH_SIZE, RETENTION_SWEEPER_INTERVAL_MS, RETENTION_SWEEPER_JOB_NAME, RetentionSweepHoldConsultFailed, makeRetentionSweeperJob, retentionPurgeTopic, } from "./retention-sweeper.js";
60
+ export { DsarError, DsarNotInitialized, DsarNotFound, DsarStoreRequired, JustificationRequired, SubjectKindNotRegistered, DsarTerminalStateViolation, ExportGatherFailed, EraseExecutionFailed, HandlerAlreadyRegistered, CmkAdapterNotConfigured, CmkResolutionFailed,
61
+ // libs#612 (bind-time leg) — a Pattern A bind with no holds pool.
62
+ MissingSqlClientForHoldGateError,
63
+ // drift 4a72cce1 — `liftHold` refuses to guess between the two scopes.
64
+ AmbiguousLiftScope, tenantCmkAliasAdapter, } from "./types.js";
51
65
  export { DEFAULT_ERASE_BLOCKING_HOLD_KINDS, STATUTORY_HOLD_KINDS, CITATION_REQUIRED_HOLD_KINDS,
52
66
  // D239 — participant-side outbox seam.
53
67
  MissingOutboxEmitterError, RPC_TO_COMPLIANCE_VERB, complianceTopic, } from "./types.js";
54
68
  // ---- v0.1.1: gRPC service descriptor + Pattern A/B/C bindings ----
55
69
  export { noDataServiceImpl, subjectKindFromProto, } from "./grpc/dsar-service.js";
56
- export { bindPatternA } from "./bind-pattern-a.js";
70
+ // drift dc5640d1 — the SHIPPED DataLifecycleService .proto + its per-host
71
+ // materializer (D417). `package.json#files` carries `proto/` into the tarball.
72
+ export { dataLifecycleProtoFor, dataLifecycleProtoPath, dataLifecycleProtoSource, } from "./grpc/proto-path.js";
73
+ export { bindPatternA, bindPatternAAndVerify, complianceStatusFor, holdGateReadyOf, } from "./bind-pattern-a.js";
74
+ // The bind-time hold-gate reachability probe (the behavioural half of the
75
+ // no-pool guard — a structurally-valid pool aimed at a down/wrong/unmigrated DB).
76
+ export { HOLD_GATE_PROBE_TABLE_MISSING_DETAIL, HOLD_GATE_PROBE_TIMEOUT_MS, HOLD_GATE_PROBE_UNREACHABLE_DETAIL, HoldGateUnreachableError, probeHoldGate, } from "./hold-gate-probe.js";
57
77
  export { bindPatternB } from "./bind-pattern-b.js";
58
78
  export { bindPatternC } from "./bind-pattern-c.js";
59
79
  // ---- v0.1.1: orchestrator + register ----
60
- export { bindOrchestrator, readAggregatorRow, dispatchModeFor, SYNC_RPCS, ASYNC_RPCS, } from "./orchestrator.js";
80
+ export { bindOrchestrator, readAggregatorRow, dispatchModeFor, SYNC_RPCS, ASYNC_RPCS,
81
+ // Read-fan-out outcome vocabulary — a caller classifies a partial result by
82
+ // these tokens instead of string-matching prose.
83
+ NO_SIBLING_REACHABLE_REASON, NO_SIBLING_REGISTERED_REASON, PARTIAL_SIBLING_FAILURE_REASON, PARTIAL_SIBLING_UNREACHABLE_REASON, } from "./orchestrator.js";
61
84
  export { registerWithOrchestrator } from "./register.js";
62
85
  // ---- v0.1.1: lifecycle store + migrations ----
63
86
  export { PostgresLifecycleRequestsStore, withLifecycleIdempotency, } from "./state-store/postgres-lifecycle.js";
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAQA,KAAK,SAAS,GAAG;IAEf,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACzD,CAAC;AAwMF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsC9C;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoCzD;AAmDD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,2BAA2B,kzaAkQvC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iCAAiC,4hBAQ9B,CAAC;AAEjB;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BrD"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAUA,KAAK,SAAS,GAAG;IAEf,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACzD,CAAC;AAiNF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsC9C;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoCzD;AAmDD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,2BAA2B,kzaAkQvC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iCAAiC,4hBAQ9B,CAAC;AAEjB;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BrD"}
@@ -5,6 +5,7 @@
5
5
  // `applySagaMigrations` in shape. The SQL source-of-truth lives at
6
6
  // `src/migrations/001-lifecycle-requests.sql` for downstream services that
7
7
  // prefer a different migration runner (Flyway, golang-migrate, alembic).
8
+ import { retentionSchedulesDdl } from "../retention.js";
8
9
  /**
9
10
  * The canonical CRUD verb set the A1 RLS policies cover (D412 § 2 — "SELECT /
10
11
  * INSERT / UPDATE / DELETE scoped by the `app.tenant_id` GUC + the nodii_owner
@@ -151,6 +152,15 @@ CREATE TABLE IF NOT EXISTS retention_policies (
151
152
  CREATE INDEX IF NOT EXISTS idx_retention_policies_active
152
153
  ON retention_policies (data_class, subject_kind)
153
154
  WHERE soft_deleted_at IS NULL;
155
+ -- D720 — retention_schedules: the platform-global, effective-dated statutory
156
+ -- window registry the purpose-spent sweeper consumes. Platform-global (no
157
+ -- <svc>_ prefix, beside retention_policies + data_residency_holds) because a
158
+ -- jurisdiction's statutory period is a property of the LAW, not of whichever
159
+ -- service holds the record. The ROWS are operator/counsel-owned data — this
160
+ -- migration ships the shape and seeds nothing.
161
+ -- Emitted from retentionSchedulesDdl() so the runner and the standalone
162
+ -- createRetentionSchedulesTable() artifact can never drift.
163
+ ${retentionSchedulesDdl()}
154
164
  CREATE TABLE IF NOT EXISTS data_residency_holds (
155
165
  id UUID PRIMARY KEY,
156
166
  tenant_id UUID NOT NULL,