@saplings/sdk 0.0.0-stage → 0.17.1

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 (151) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/LICENSE +21 -0
  3. package/dist/access.d.ts +3 -0
  4. package/dist/access.js +3 -0
  5. package/dist/access.js.map +1 -0
  6. package/dist/accounts.d.ts +3 -0
  7. package/dist/accounts.js +3 -0
  8. package/dist/accounts.js.map +1 -0
  9. package/dist/analytics.d.ts +45 -0
  10. package/dist/analytics.js +129 -0
  11. package/dist/analytics.js.map +1 -0
  12. package/dist/audit.d.ts +21 -0
  13. package/dist/audit.js +36 -0
  14. package/dist/audit.js.map +1 -0
  15. package/dist/automation.d.ts +49 -0
  16. package/dist/automation.js +202 -0
  17. package/dist/automation.js.map +1 -0
  18. package/dist/billing-policy.d.ts +15 -0
  19. package/dist/billing-policy.js +17 -0
  20. package/dist/billing-policy.js.map +1 -0
  21. package/dist/billing.d.ts +53 -0
  22. package/dist/billing.js +118 -0
  23. package/dist/billing.js.map +1 -0
  24. package/dist/business-workflows.d.ts +39 -0
  25. package/dist/business-workflows.js +137 -0
  26. package/dist/business-workflows.js.map +1 -0
  27. package/dist/capabilities.d.ts +49 -0
  28. package/dist/capabilities.js +78 -0
  29. package/dist/capabilities.js.map +1 -0
  30. package/dist/cashfree.d.ts +71 -0
  31. package/dist/cashfree.js +241 -0
  32. package/dist/cashfree.js.map +1 -0
  33. package/dist/commerce.d.ts +21 -0
  34. package/dist/commerce.js +198 -0
  35. package/dist/commerce.js.map +1 -0
  36. package/dist/config.d.ts +4 -0
  37. package/dist/config.js +177 -0
  38. package/dist/config.js.map +1 -0
  39. package/dist/control-plane.d.ts +129 -0
  40. package/dist/control-plane.js +314 -0
  41. package/dist/control-plane.js.map +1 -0
  42. package/dist/data.d.ts +58 -0
  43. package/dist/data.js +214 -0
  44. package/dist/data.js.map +1 -0
  45. package/dist/domain-policy.d.ts +36 -0
  46. package/dist/domain-policy.js +114 -0
  47. package/dist/domain-policy.js.map +1 -0
  48. package/dist/feature-types.d.ts +187 -0
  49. package/dist/feature-types.js +2 -0
  50. package/dist/feature-types.js.map +1 -0
  51. package/dist/federation.d.ts +66 -0
  52. package/dist/federation.js +162 -0
  53. package/dist/federation.js.map +1 -0
  54. package/dist/flags.d.ts +27 -0
  55. package/dist/flags.js +52 -0
  56. package/dist/flags.js.map +1 -0
  57. package/dist/governance.d.ts +45 -0
  58. package/dist/governance.js +128 -0
  59. package/dist/governance.js.map +1 -0
  60. package/dist/http-idempotency.d.ts +22 -0
  61. package/dist/http-idempotency.js +42 -0
  62. package/dist/http-idempotency.js.map +1 -0
  63. package/dist/http.d.ts +2 -0
  64. package/dist/http.js +28 -0
  65. package/dist/http.js.map +1 -0
  66. package/dist/identity.d.ts +3 -0
  67. package/dist/identity.js +3 -0
  68. package/dist/identity.js.map +1 -0
  69. package/dist/impersonation.d.ts +2 -0
  70. package/dist/impersonation.js +3 -0
  71. package/dist/impersonation.js.map +1 -0
  72. package/dist/index.d.ts +210 -0
  73. package/dist/index.js +519 -0
  74. package/dist/index.js.map +1 -0
  75. package/dist/integrations.d.ts +114 -0
  76. package/dist/integrations.js +358 -0
  77. package/dist/integrations.js.map +1 -0
  78. package/dist/jobs.d.ts +29 -0
  79. package/dist/jobs.js +77 -0
  80. package/dist/jobs.js.map +1 -0
  81. package/dist/media.d.ts +18 -0
  82. package/dist/media.js +48 -0
  83. package/dist/media.js.map +1 -0
  84. package/dist/offboarding.d.ts +43 -0
  85. package/dist/offboarding.js +140 -0
  86. package/dist/offboarding.js.map +1 -0
  87. package/dist/operations.d.ts +105 -0
  88. package/dist/operations.js +286 -0
  89. package/dist/operations.js.map +1 -0
  90. package/dist/primitives.d.ts +24 -0
  91. package/dist/primitives.js +111 -0
  92. package/dist/primitives.js.map +1 -0
  93. package/dist/provider-operations.d.ts +43 -0
  94. package/dist/provider-operations.js +143 -0
  95. package/dist/provider-operations.js.map +1 -0
  96. package/dist/provider-workflow.d.ts +33 -0
  97. package/dist/provider-workflow.js +111 -0
  98. package/dist/provider-workflow.js.map +1 -0
  99. package/dist/providers.d.ts +42 -0
  100. package/dist/providers.js +168 -0
  101. package/dist/providers.js.map +1 -0
  102. package/dist/quality-config.d.ts +50 -0
  103. package/dist/quality-config.js +2 -0
  104. package/dist/quality-config.js.map +1 -0
  105. package/dist/razorpay-webhook.d.ts +38 -0
  106. package/dist/razorpay-webhook.js +106 -0
  107. package/dist/razorpay-webhook.js.map +1 -0
  108. package/dist/recurring.d.ts +53 -0
  109. package/dist/recurring.js +241 -0
  110. package/dist/recurring.js.map +1 -0
  111. package/dist/registry.d.ts +58 -0
  112. package/dist/registry.js +839 -0
  113. package/dist/registry.js.map +1 -0
  114. package/dist/reliability.d.ts +45 -0
  115. package/dist/reliability.js +147 -0
  116. package/dist/reliability.js.map +1 -0
  117. package/dist/resources.d.ts +19 -0
  118. package/dist/resources.js +87 -0
  119. package/dist/resources.js.map +1 -0
  120. package/dist/security-state.d.ts +14 -0
  121. package/dist/security-state.js +39 -0
  122. package/dist/security-state.js.map +1 -0
  123. package/dist/storage.d.ts +54 -0
  124. package/dist/storage.js +100 -0
  125. package/dist/storage.js.map +1 -0
  126. package/dist/store.d.ts +21 -0
  127. package/dist/store.js +110 -0
  128. package/dist/store.js.map +1 -0
  129. package/dist/stripe-payment.d.ts +21 -0
  130. package/dist/stripe-payment.js +132 -0
  131. package/dist/stripe-payment.js.map +1 -0
  132. package/dist/stripe-recurring.d.ts +58 -0
  133. package/dist/stripe-recurring.js +226 -0
  134. package/dist/stripe-recurring.js.map +1 -0
  135. package/dist/totp.d.ts +2 -0
  136. package/dist/totp.js +3 -0
  137. package/dist/totp.js.map +1 -0
  138. package/dist/transactional-processing.d.ts +27 -0
  139. package/dist/transactional-processing.js +129 -0
  140. package/dist/transactional-processing.js.map +1 -0
  141. package/dist/types.d.ts +367 -0
  142. package/dist/types.js +2 -0
  143. package/dist/types.js.map +1 -0
  144. package/dist/valkey.d.ts +18 -0
  145. package/dist/valkey.js +22 -0
  146. package/dist/valkey.js.map +1 -0
  147. package/dist/worker.d.ts +28 -0
  148. package/dist/worker.js +200 -0
  149. package/dist/worker.js.map +1 -0
  150. package/package.json +34 -3
  151. package/README.md +0 -3
@@ -0,0 +1,187 @@
1
+ /** Generated from the canonical feature action inventory; checked against the runtime manifest. */
2
+ export interface FeatureActionMap {
3
+ "SAAS-001": "register";
4
+ "SAAS-002": "issue" | "consume";
5
+ "SAAS-003": "issue" | "consume";
6
+ "SAAS-004": "issue" | "consume";
7
+ "SAAS-005": "login" | "logout";
8
+ "SAAS-006": "verify" | "list" | "revoke";
9
+ "SAAS-007": "verify";
10
+ "SAAS-008": "create" | "list" | "revoke";
11
+ "SAAS-009": "enroll" | "confirm" | "challenge" | "verify" | "revoke";
12
+ "SAAS-010": "start" | "callback" | "metadata";
13
+ "SAAS-011": "authorize" | "callback" | "refresh" | "revoke";
14
+ "SAAS-012": "start" | "callback";
15
+ "SAAS-013": "register" | "revoke";
16
+ "SAAS-014": "create" | "revoke";
17
+ "SAAS-015": "setRole" | "check" | "assign";
18
+ "SAAS-016": "check";
19
+ "SAAS-017": "check";
20
+ "SAAS-018": "login";
21
+ "SAAS-019": "provision";
22
+ "SAAS-020": "context";
23
+ "SAAS-021": "check";
24
+ "SAAS-022": "context";
25
+ "SAAS-023": "get";
26
+ "SAAS-024": "request" | "approve" | "status" | "advance";
27
+ "SAAS-025": "create" | "get" | "list" | "update" | "delete";
28
+ "SAAS-026": "create" | "get" | "list" | "update" | "delete";
29
+ "SAAS-027": "create" | "get" | "list" | "update" | "delete";
30
+ "SAAS-028": "create" | "get" | "list" | "update" | "delete";
31
+ "SAAS-029": "create" | "get" | "list" | "update" | "delete";
32
+ "SAAS-030": "invite" | "accept";
33
+ "SAAS-031": "switch";
34
+ "SAAS-032": "set";
35
+ "SAAS-033": "start" | "stop";
36
+ "SAAS-034": "create" | "list";
37
+ "SAAS-035": "create" | "list";
38
+ "SAAS-036": "transition" | "schedule" | "issueDue" | "cancelSchedule" | "quoteChange";
39
+ "SAAS-037": "start";
40
+ "SAAS-038": "meter" | "get";
41
+ "SAAS-039": "set" | "get";
42
+ "SAAS-040": "set" | "check";
43
+ "SAAS-041": "create" | "get" | "list";
44
+ "SAAS-042": "order";
45
+ "SAAS-043": "attach" | "list" | "detach";
46
+ "SAAS-044": "calculate";
47
+ "SAAS-045": "create" | "redeem";
48
+ "SAAS-046": "post";
49
+ "SAAS-047": "refund";
50
+ "SAAS-048": "enqueue" | "chargeDue" | "resume" | "sweep";
51
+ "SAAS-049": "report";
52
+ "SAAS-050": "verify" | "reconcile";
53
+ "SAAS-051": "scan";
54
+ "SAAS-052": "assess";
55
+ "SAAS-053": "get" | "put" | "rotate";
56
+ "SAAS-054": "encrypt" | "decrypt";
57
+ "SAAS-055": "verify" | "configure";
58
+ "SAAS-056": "policy";
59
+ "SAAS-057": "policy";
60
+ "SAAS-058": "policy";
61
+ "SAAS-059": "policy";
62
+ "SAAS-060": "policy";
63
+ "SAAS-061": "run";
64
+ "SAAS-062": "delete";
65
+ "SAAS-063": "record" | "history";
66
+ "SAAS-064": "export";
67
+ "SAAS-065": "list" | "record";
68
+ "SAAS-066": "policy";
69
+ "SAAS-067": "policy";
70
+ "SAAS-068": "list" | "ack";
71
+ "SAAS-069": "create" | "get" | "list" | "update" | "delete";
72
+ "SAAS-070": "create" | "get" | "list" | "update" | "delete";
73
+ "SAAS-071": "send";
74
+ "SAAS-072": "enqueue";
75
+ "SAAS-073": "send";
76
+ "SAAS-074": "send";
77
+ "SAAS-075": "send" | "list" | "read";
78
+ "SAAS-076": "create" | "get" | "list" | "update" | "delete";
79
+ "SAAS-077": "set" | "get";
80
+ "SAAS-078": "list";
81
+ "SAAS-079": "enqueue";
82
+ "SAAS-080": "optOut";
83
+ "SAAS-081": "verify" | "reconcile";
84
+ "SAAS-082": "render";
85
+ "SAAS-083": "upload" | "download" | "list" | "delete";
86
+ "SAAS-084": "upload" | "download" | "list" | "delete";
87
+ "SAAS-085": "sign";
88
+ "SAAS-086": "get";
89
+ "SAAS-087": "get";
90
+ "SAAS-088": "create" | "get" | "list" | "update" | "delete";
91
+ "SAAS-089": "import";
92
+ "SAAS-090": "export";
93
+ "SAAS-091": "backup" | "restore" | "status";
94
+ "SAAS-092": "plan" | "apply" | "status";
95
+ "SAAS-093": "search";
96
+ "SAAS-094": "purge" | "configure";
97
+ "SAAS-095": "transform" | "status";
98
+ "SAAS-096": "validate";
99
+ "SAAS-097": "delete";
100
+ "SAAS-098": "archive";
101
+ "SAAS-099": "mask";
102
+ "SAAS-100": "track";
103
+ "SAAS-101": "identify";
104
+ "SAAS-102": "report";
105
+ "SAAS-103": "report";
106
+ "SAAS-104": "report";
107
+ "SAAS-105": "report";
108
+ "SAAS-106": "create" | "get" | "list" | "update" | "delete";
109
+ "SAAS-107": "report";
110
+ "SAAS-108": "schedule";
111
+ "SAAS-109": "report";
112
+ "SAAS-110": "capture" | "report";
113
+ "SAAS-111": "report";
114
+ "SAAS-112": "report";
115
+ "SAAS-113": "enqueue" | "list";
116
+ "SAAS-114": "enqueue" | "list";
117
+ "SAAS-115": "requeue";
118
+ "SAAS-116": "list" | "requeue";
119
+ "SAAS-117": "start";
120
+ "SAAS-118": "request" | "decide";
121
+ "SAAS-119": "evaluate";
122
+ "SAAS-120": "enqueue";
123
+ "SAAS-121": "verify" | "dispatch";
124
+ "SAAS-122": "record";
125
+ "SAAS-123": "append";
126
+ "SAAS-124": "envelope";
127
+ "SAAS-125": "execute" | "schema";
128
+ "SAAS-126": "document";
129
+ "SAAS-127": "generate";
130
+ "SAAS-128": "resolve";
131
+ "SAAS-129": "page";
132
+ "SAAS-130": "filter";
133
+ "SAAS-131": "headers";
134
+ "SAAS-132": "create" | "get" | "list" | "update" | "delete";
135
+ "SAAS-133": "check";
136
+ "SAAS-134": "sign" | "verify";
137
+ "SAAS-135": "enqueue";
138
+ "SAAS-136": "emit";
139
+ "SAAS-137": "get";
140
+ "SAAS-138": "envelope";
141
+ "SAAS-139": "set" | "evaluate";
142
+ "SAAS-140": "set" | "evaluate";
143
+ "SAAS-141": "set" | "evaluate";
144
+ "SAAS-142": "get";
145
+ "SAAS-143": "create" | "get" | "list" | "update" | "delete";
146
+ "SAAS-144": "create" | "get" | "list" | "update" | "delete";
147
+ "SAAS-145": "install" | "uninstall" | "list";
148
+ "SAAS-146": "create" | "get" | "list" | "update" | "delete";
149
+ "SAAS-147": "create" | "get" | "list" | "update" | "delete";
150
+ "SAAS-148": "request" | "verify" | "activate" | "remove";
151
+ "SAAS-149": "format";
152
+ "SAAS-150": "format";
153
+ "SAAS-151": "create" | "get" | "list" | "update" | "delete";
154
+ "SAAS-152": "create" | "get" | "list" | "update" | "delete";
155
+ "SAAS-153": "create" | "get" | "list" | "update" | "delete";
156
+ "SAAS-154": "log";
157
+ "SAAS-155": "export" | "status";
158
+ "SAAS-156": "observe" | "snapshot";
159
+ "SAAS-157": "get";
160
+ "SAAS-158": "get";
161
+ "SAAS-159": "describe";
162
+ "SAAS-160": "describe";
163
+ "SAAS-161": "describe";
164
+ "SAAS-162": "describe";
165
+ "SAAS-163": "report";
166
+ "SAAS-164": "record" | "list";
167
+ "SAAS-165": "deploy" | "status" | "rollback";
168
+ "SAAS-166": "plan" | "apply" | "destroy";
169
+ "SAAS-167": "scale" | "status";
170
+ "SAAS-168": "backup" | "restore" | "drill";
171
+ "SAAS-169": "status";
172
+ "SAAS-170": "validate";
173
+ "SAAS-171": "create" | "get" | "list" | "update" | "delete";
174
+ "SAAS-172": "create" | "get" | "list" | "update" | "delete";
175
+ "SAAS-173": "create" | "assign" | "complete" | "list";
176
+ "SAAS-174": "list";
177
+ "SAAS-175": "create" | "get" | "list" | "update" | "delete";
178
+ "SAAS-176": "create" | "get" | "list" | "update" | "delete";
179
+ "SAAS-177": "list";
180
+ "SAAS-178": "create" | "update" | "list";
181
+ "SAAS-179": "create" | "get" | "list" | "update" | "delete";
182
+ "SAAS-180": "overview";
183
+ "SAAS-181": "create" | "get" | "list" | "update" | "delete";
184
+ "SAAS-182": "transfer";
185
+ }
186
+ export type FeatureId = keyof FeatureActionMap;
187
+ export type FeatureAction<I extends FeatureId> = FeatureActionMap[I];
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=feature-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feature-types.js","sourceRoot":"","sources":["../src/feature-types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,66 @@
1
+ import type { AuthenticationAdapter, FeatureAdapter, Store } from './types.js';
2
+ export interface OidcSettings {
3
+ issuer: string;
4
+ clientId: string;
5
+ clientSecret?: string;
6
+ authorizationEndpoint: string;
7
+ tokenEndpoint: string;
8
+ revocationEndpoint?: string;
9
+ redirectUri: string;
10
+ scope?: string;
11
+ brokerHints?: {
12
+ saml?: Record<string, string>;
13
+ social?: Record<string, string>;
14
+ };
15
+ }
16
+ /** Authorization-code + PKCE confidential backend flow. SAML/social must be configured in a vetted OIDC identity broker.
17
+ * Both token verifiers must pin their intended issuer/audience; ID verifier must return tenant and subject. No auto-link by email. */
18
+ export declare class OidcFederationAdapter implements FeatureAdapter {
19
+ private store;
20
+ private config;
21
+ private accessVerifier;
22
+ private idVerifier;
23
+ private auth;
24
+ private token;
25
+ private revoke?;
26
+ private cipher;
27
+ private bulk;
28
+ constructor(store: Store, config: OidcSettings, key: Uint8Array, accessVerifier: AuthenticationAdapter, idVerifier: AuthenticationAdapter);
29
+ private post;
30
+ private verify;
31
+ execute({ ctx, featureId, action, input }: Parameters<FeatureAdapter['execute']>[0]): Promise<{
32
+ accessToken: string;
33
+ refreshToken: string | undefined;
34
+ expiresIn: unknown;
35
+ identity: {
36
+ tenantId: string;
37
+ userId: string;
38
+ roles: string[];
39
+ permissions: string[];
40
+ };
41
+ } | {
42
+ brokerIssuer: string;
43
+ redirectUri: string;
44
+ mode: string;
45
+ samlMetadataManagedByBroker: boolean;
46
+ url?: undefined;
47
+ expiresIn?: undefined;
48
+ revoked?: undefined;
49
+ } | {
50
+ url: string;
51
+ expiresIn: number;
52
+ brokerIssuer?: undefined;
53
+ redirectUri?: undefined;
54
+ mode?: undefined;
55
+ samlMetadataManagedByBroker?: undefined;
56
+ revoked?: undefined;
57
+ } | {
58
+ revoked: boolean;
59
+ brokerIssuer?: undefined;
60
+ redirectUri?: undefined;
61
+ mode?: undefined;
62
+ samlMetadataManagedByBroker?: undefined;
63
+ url?: undefined;
64
+ expiresIn?: undefined;
65
+ }>;
66
+ }
@@ -0,0 +1,162 @@
1
+ import { boundedResponseText } from './http.js';
2
+ import { randomBytes, createHash } from 'node:crypto';
3
+ import { atomic, fail, hash, object, text } from './primitives.js';
4
+ import { EnvelopeCrypto } from './data.js';
5
+ import { Bulkhead } from './reliability.js';
6
+ const secret = () => randomBytes(32).toString('base64url');
7
+ function https(raw) {
8
+ const u = new URL(raw);
9
+ if (u.protocol !== 'https:' || u.username || u.password || u.hash)
10
+ throw Error('Fixed HTTPS endpoint required');
11
+ return u;
12
+ }
13
+ /** Authorization-code + PKCE confidential backend flow. SAML/social must be configured in a vetted OIDC identity broker.
14
+ * Both token verifiers must pin their intended issuer/audience; ID verifier must return tenant and subject. No auto-link by email. */
15
+ export class OidcFederationAdapter {
16
+ store;
17
+ config;
18
+ accessVerifier;
19
+ idVerifier;
20
+ auth;
21
+ token;
22
+ revoke;
23
+ cipher;
24
+ bulk = new Bulkhead(16);
25
+ constructor(store, config, key, accessVerifier, idVerifier) {
26
+ this.store = store;
27
+ this.config = config;
28
+ this.accessVerifier = accessVerifier;
29
+ this.idVerifier = idVerifier;
30
+ https(config.issuer);
31
+ this.auth = https(config.authorizationEndpoint);
32
+ this.token = https(config.tokenEndpoint);
33
+ this.revoke = config.revocationEndpoint ? https(config.revocationEndpoint) : undefined;
34
+ https(config.redirectUri);
35
+ this.cipher = new EnvelopeCrypto(key, 'oidc-state-v1');
36
+ }
37
+ async post(endpoint, params) {
38
+ return this.bulk.run(async () => {
39
+ const body = new URLSearchParams({
40
+ ...params,
41
+ client_id: this.config.clientId,
42
+ ...(this.config.clientSecret ? { client_secret: this.config.clientSecret } : {}),
43
+ });
44
+ const r = await fetch(endpoint, {
45
+ method: 'POST',
46
+ body,
47
+ redirect: 'error',
48
+ signal: AbortSignal.timeout(10000),
49
+ headers: { accept: 'application/json' },
50
+ });
51
+ if (!r.ok) {
52
+ await r.body?.cancel();
53
+ return fail('Identity provider rejected operation', 'PROVIDER_FAILED', 502);
54
+ }
55
+ if (r.status === 204 || endpoint === this.revoke) {
56
+ await r.body?.cancel();
57
+ return {};
58
+ }
59
+ const raw = await boundedResponseText(r, 100000);
60
+ return object(JSON.parse(raw));
61
+ });
62
+ }
63
+ async verify(ctx, tokens, nonce) {
64
+ const accessToken = text(tokens.access_token, 'access token', 16384);
65
+ const access = await this.accessVerifier.verifyAccessToken(accessToken);
66
+ if (!access || access.tenantId !== ctx.tenantId)
67
+ return fail('Invalid federated tenant or access token', 'UNAUTHENTICATED', 401);
68
+ if (nonce !== undefined) {
69
+ const idToken = text(tokens.id_token, 'id token', 16384);
70
+ const id = await this.idVerifier.verifyAccessToken(idToken);
71
+ if (!id || id.tenantId !== access.tenantId || id.userId !== access.userId)
72
+ return fail('Invalid ID token', 'UNAUTHENTICATED', 401);
73
+ const claims = object(JSON.parse(Buffer.from(idToken.split('.')[1], 'base64url').toString('utf8')));
74
+ if (claims.nonce !== nonce ||
75
+ claims.iss !== this.config.issuer ||
76
+ (Array.isArray(claims.aud) && claims.aud.length > 1 && claims.azp !== this.config.clientId))
77
+ return fail('OIDC nonce or issuer mismatch', 'UNAUTHENTICATED', 401);
78
+ }
79
+ return {
80
+ accessToken,
81
+ refreshToken: typeof tokens.refresh_token === 'string' ? tokens.refresh_token : undefined,
82
+ expiresIn: tokens.expires_in,
83
+ identity: access,
84
+ };
85
+ }
86
+ async execute({ ctx, featureId, action, input }) {
87
+ if (!['SAAS-010', 'SAAS-011', 'SAAS-012'].includes(featureId))
88
+ return fail('Unsupported identity capability');
89
+ if (action === 'metadata' && featureId === 'SAAS-010')
90
+ return {
91
+ brokerIssuer: this.config.issuer,
92
+ redirectUri: this.config.redirectUri,
93
+ mode: 'oidc-broker',
94
+ samlMetadataManagedByBroker: true,
95
+ };
96
+ if (action === 'start' || action === 'authorize') {
97
+ const hints = featureId === 'SAAS-010'
98
+ ? this.config.brokerHints?.saml
99
+ : featureId === 'SAAS-012'
100
+ ? this.config.brokerHints?.social
101
+ : {};
102
+ if (!hints)
103
+ return fail('Broker connection not configured', 'CONFIG_REQUIRED', 503);
104
+ const state = secret(), nonce = secret(), verifier = secret();
105
+ const u = new URL(this.auth);
106
+ for (const [k, v] of Object.entries(hints))
107
+ u.searchParams.set(k, v);
108
+ for (const [k, v] of Object.entries({
109
+ response_type: 'code',
110
+ client_id: this.config.clientId,
111
+ redirect_uri: this.config.redirectUri,
112
+ scope: this.config.scope ?? 'openid profile email',
113
+ state,
114
+ nonce,
115
+ code_challenge: createHash('sha256').update(verifier).digest('base64url'),
116
+ code_challenge_method: 'S256',
117
+ }))
118
+ u.searchParams.set(k, v);
119
+ await this.store.put(ctx.tenantId, 'oidc-states', {
120
+ id: hash(state),
121
+ actorId: ctx.actorId,
122
+ featureId,
123
+ expires: Date.now() + 300000,
124
+ proof: this.cipher.encrypt(ctx, JSON.stringify({ nonce, verifier })),
125
+ });
126
+ return { url: u.href, expiresIn: 300 };
127
+ }
128
+ if (action === 'callback') {
129
+ const state = hash(text(input.state, 'state', 200));
130
+ const saved = await atomic(this.store, ctx.tenantId, async (tx) => {
131
+ const r = await tx.get(ctx.tenantId, 'oidc-states', state);
132
+ if (!r || r.actorId !== ctx.actorId || r.featureId !== featureId || r.expires < Date.now())
133
+ return fail('Invalid state', 'UNAUTHENTICATED', 401);
134
+ await tx.delete(ctx.tenantId, 'oidc-states', state);
135
+ return object(JSON.parse(this.cipher.decrypt(ctx, r.proof)));
136
+ });
137
+ const tokens = await this.post(this.token, {
138
+ grant_type: 'authorization_code',
139
+ code: text(input.code, 'code', 4096),
140
+ redirect_uri: this.config.redirectUri,
141
+ code_verifier: text(saved.verifier),
142
+ });
143
+ return this.verify(ctx, tokens, text(saved.nonce));
144
+ }
145
+ if (featureId === 'SAAS-011' && action === 'refresh')
146
+ return this.verify(ctx, await this.post(this.token, {
147
+ grant_type: 'refresh_token',
148
+ refresh_token: text(input.refreshToken, 'refresh token', 16384),
149
+ }));
150
+ if (featureId === 'SAAS-011' && action === 'revoke') {
151
+ if (!this.revoke)
152
+ return fail('Revocation endpoint not configured', 'CONFIG_REQUIRED', 503);
153
+ await this.post(this.revoke, {
154
+ token: text(input.refreshToken, 'refresh token', 16384),
155
+ token_type_hint: 'refresh_token',
156
+ });
157
+ return { revoked: true };
158
+ }
159
+ return fail('Unknown federation action', 'UNKNOWN_ACTION', 404);
160
+ }
161
+ }
162
+ //# sourceMappingURL=federation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"federation.js","sourceRoot":"","sources":["../src/federation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQtD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAW,CAAC;AACrE,SAAS,KAAK,CAAC,GAAW;IACxB,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI;QAC/D,MAAM,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC/C,OAAO,CAAC,CAAC;AACX,CAAC;AAmBD;sIACsI;AACtI,MAAM,OAAO,qBAAqB;IAOtB;IACA;IAEA;IACA;IAVF,IAAI,CAAM;IACV,KAAK,CAAM;IACX,MAAM,CAAO;IACb,MAAM,CAAiB;IACvB,IAAI,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChC,YACU,KAAY,EACZ,MAAoB,EAC5B,GAAe,EACP,cAAqC,EACrC,UAAiC;QAJjC,UAAK,GAAL,KAAK,CAAO;QACZ,WAAM,GAAN,MAAM,CAAc;QAEpB,mBAAc,GAAd,cAAc,CAAuB;QACrC,eAAU,GAAV,UAAU,CAAuB;QAEzC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACzD,CAAC;IACO,KAAK,CAAC,IAAI,CAAC,QAAa,EAAE,MAA8B;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;gBAC/B,GAAG,MAAM;gBACT,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC/B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjF,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;gBAC9B,MAAM,EAAE,MAAM;gBACd,IAAI;gBACJ,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;gBAClC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;aACxC,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC,sCAAsC,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;YAC9E,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjD,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACjD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IACO,KAAK,CAAC,MAAM,CAAC,GAAiB,EAAE,MAAkB,EAAE,KAAc;QACxE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ;YAC7C,OAAO,IAAI,CAAC,0CAA0C,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAClF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC5D,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;gBACvE,OAAO,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;YAC1D,MAAM,MAAM,GAAG,MAAM,CACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAC7E,CAAC;YACF,IACE,MAAM,CAAC,KAAK,KAAK,KAAK;gBACtB,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM;gBACjC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAE3F,OAAO,IAAI,CAAC,+BAA+B,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,OAAO;YACL,WAAW;YACX,YAAY,EAAE,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;YACzF,SAAS,EAAE,MAAM,CAAC,UAAU;YAC5B,QAAQ,EAAE,MAAM;SACjB,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAA4C;QACvF,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3D,OAAO,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,UAAU,IAAI,SAAS,KAAK,UAAU;YACnD,OAAO;gBACL,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAChC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACpC,IAAI,EAAE,aAAa;gBACnB,2BAA2B,EAAE,IAAI;aAClC,CAAC;QACJ,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YACjD,MAAM,KAAK,GACT,SAAS,KAAK,UAAU;gBACtB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI;gBAC/B,CAAC,CAAC,SAAS,KAAK,UAAU;oBACxB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM;oBACjC,CAAC,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC,kCAAkC,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;YACpF,MAAM,KAAK,GAAG,MAAM,EAAE,EACpB,KAAK,GAAG,MAAM,EAAE,EAChB,QAAQ,GAAG,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACrE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;gBAClC,aAAa,EAAE,MAAM;gBACrB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC/B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACrC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,sBAAsB;gBAClD,KAAK;gBACL,KAAK;gBACL,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;gBACzE,qBAAqB,EAAE,MAAM;aAC9B,CAAC;gBACA,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAQ,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE;gBACvD,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC;gBACf,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,SAAS;gBACT,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM;gBAC5B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;aACrE,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QACzC,CAAC;QACD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;gBAChE,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,CAAQ,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;gBAClE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE;oBACxF,OAAO,IAAI,CAAC,eAAe,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;gBACvD,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;gBACpD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;gBACzC,UAAU,EAAE,oBAAoB;gBAChC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC;gBACpC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACrC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;aACpC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,SAAS,KAAK,UAAU,IAAI,MAAM,KAAK,SAAS;YAClD,OAAO,IAAI,CAAC,MAAM,CAChB,GAAG,EACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC1B,UAAU,EAAE,eAAe;gBAC3B,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,eAAe,EAAE,KAAK,CAAC;aAChE,CAAC,CACH,CAAC;QACJ,IAAI,SAAS,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,oCAAoC,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;YAC5F,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,eAAe,EAAE,KAAK,CAAC;gBACvD,eAAe,EAAE,eAAe;aACjC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;CACF"}
@@ -0,0 +1,27 @@
1
+ import type { ActorContext, Store } from './types.js';
2
+ import { AccessService } from './access.js';
3
+ import { AuditService } from './audit.js';
4
+ export interface Flag {
5
+ id: string;
6
+ enabled: boolean;
7
+ rollout: number;
8
+ variants?: Record<string, number>;
9
+ updatedAt: string;
10
+ }
11
+ export declare class FlagService {
12
+ private store;
13
+ private access;
14
+ private audit;
15
+ constructor(store: Store, access: AccessService, audit: AuditService);
16
+ set(ctx: ActorContext, input: {
17
+ key: string;
18
+ enabled: boolean;
19
+ rollout?: number;
20
+ variants?: Record<string, number>;
21
+ }): Promise<Flag>;
22
+ private bucket;
23
+ evaluate(ctx: ActorContext, key: string, subjectId?: string): Promise<{
24
+ enabled: boolean;
25
+ variant?: string;
26
+ }>;
27
+ }
package/dist/flags.js ADDED
@@ -0,0 +1,52 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { SaplingError } from './types.js';
3
+ export class FlagService {
4
+ store;
5
+ access;
6
+ audit;
7
+ constructor(store, access, audit) {
8
+ this.store = store;
9
+ this.access = access;
10
+ this.audit = audit;
11
+ }
12
+ async set(ctx, input) {
13
+ await this.access.requireService(ctx, 'flags:write');
14
+ const rollout = input.rollout ?? 100;
15
+ if (rollout < 0 || rollout > 100 || !Number.isFinite(rollout))
16
+ throw new SaplingError('BAD_FLAG', 'Rollout must be between 0 and 100');
17
+ if (input.variants &&
18
+ (Object.values(input.variants).some((v) => v < 0 || !Number.isFinite(v)) ||
19
+ Math.abs(Object.values(input.variants).reduce((a, b) => a + b, 0) - 100) > 0.00001))
20
+ throw new SaplingError('BAD_FLAG', 'Variant weights must be nonnegative');
21
+ const flag = {
22
+ id: input.key,
23
+ enabled: input.enabled,
24
+ rollout,
25
+ variants: input.variants,
26
+ updatedAt: new Date().toISOString(),
27
+ };
28
+ await this.store.put(ctx.tenantId, 'flags', flag);
29
+ await this.audit.record(ctx, 'flag.changed', 'flags', input.key);
30
+ return flag;
31
+ }
32
+ bucket(tenantId, key, subject) {
33
+ const h = createHash('sha256').update([tenantId, key, subject].join(':')).digest();
34
+ return (h.readUInt32BE(0) / 0x100000000) * 100;
35
+ }
36
+ async evaluate(ctx, key, subjectId = ctx.actorId) {
37
+ const f = await this.store.get(ctx.tenantId, 'flags', key);
38
+ if (!f?.enabled || this.bucket(ctx.tenantId, key, subjectId) >= f.rollout)
39
+ return { enabled: false };
40
+ if (!f.variants)
41
+ return { enabled: true };
42
+ const bucket = this.bucket(ctx.tenantId, key + ':variant', subjectId);
43
+ let accumulated = 0;
44
+ for (const [variant, weight] of Object.entries(f.variants)) {
45
+ accumulated += weight;
46
+ if (bucket < accumulated)
47
+ return { enabled: true, variant };
48
+ }
49
+ return { enabled: true };
50
+ }
51
+ }
52
+ //# sourceMappingURL=flags.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flags.js","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import type { ActorContext, Store } from './types.js';
2
+ import type { Row } from './primitives.js';
3
+ /** Durable hold ledger. All governed deletions and hold mutations use the same tenant transaction. External systems need their own fencing. */
4
+ export declare class GovernanceService {
5
+ private store;
6
+ private authorize;
7
+ private policies;
8
+ constructor(store: Store, authorize: (ctx: ActorContext, permission: string) => Promise<void>, policies?: Readonly<Record<string, {
9
+ days: number;
10
+ terminalStatuses?: readonly string[];
11
+ }>>);
12
+ setHold(ctx: ActorContext, reason: string): Promise<Row | {
13
+ id: string;
14
+ active: boolean;
15
+ reason: string;
16
+ setBy: string;
17
+ setAt: string;
18
+ revision: number;
19
+ }>;
20
+ releaseHold(ctx: ActorContext, revision: number): Promise<{
21
+ active: boolean;
22
+ releasedBy: string;
23
+ releasedAt: string;
24
+ id: string;
25
+ createdAt?: string;
26
+ updatedAt?: string;
27
+ }>;
28
+ held(ctx: ActorContext): Promise<boolean>;
29
+ /** Explicitly configured domain collections only; never removes audit, replay or financial records by default. */
30
+ sweep(ctx: ActorContext, collection: string, opts?: {
31
+ after?: string;
32
+ limit?: number;
33
+ confirm?: boolean;
34
+ }): Promise<{
35
+ eligible: number;
36
+ deleted: number;
37
+ next: string | undefined;
38
+ }>;
39
+ /** Reconcile old outbox rows without redispatching ambiguous/terminal deliveries. */
40
+ reconcileOutbox(ctx: ActorContext, after?: string, limit?: number): Promise<{
41
+ repaired: number;
42
+ review: string[];
43
+ next: string | undefined;
44
+ }>;
45
+ }