@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.
- package/CHANGELOG.md +15 -0
- package/LICENSE +21 -0
- package/dist/access.d.ts +3 -0
- package/dist/access.js +3 -0
- package/dist/access.js.map +1 -0
- package/dist/accounts.d.ts +3 -0
- package/dist/accounts.js +3 -0
- package/dist/accounts.js.map +1 -0
- package/dist/analytics.d.ts +45 -0
- package/dist/analytics.js +129 -0
- package/dist/analytics.js.map +1 -0
- package/dist/audit.d.ts +21 -0
- package/dist/audit.js +36 -0
- package/dist/audit.js.map +1 -0
- package/dist/automation.d.ts +49 -0
- package/dist/automation.js +202 -0
- package/dist/automation.js.map +1 -0
- package/dist/billing-policy.d.ts +15 -0
- package/dist/billing-policy.js +17 -0
- package/dist/billing-policy.js.map +1 -0
- package/dist/billing.d.ts +53 -0
- package/dist/billing.js +118 -0
- package/dist/billing.js.map +1 -0
- package/dist/business-workflows.d.ts +39 -0
- package/dist/business-workflows.js +137 -0
- package/dist/business-workflows.js.map +1 -0
- package/dist/capabilities.d.ts +49 -0
- package/dist/capabilities.js +78 -0
- package/dist/capabilities.js.map +1 -0
- package/dist/cashfree.d.ts +71 -0
- package/dist/cashfree.js +241 -0
- package/dist/cashfree.js.map +1 -0
- package/dist/commerce.d.ts +21 -0
- package/dist/commerce.js +198 -0
- package/dist/commerce.js.map +1 -0
- package/dist/config.d.ts +4 -0
- package/dist/config.js +177 -0
- package/dist/config.js.map +1 -0
- package/dist/control-plane.d.ts +129 -0
- package/dist/control-plane.js +314 -0
- package/dist/control-plane.js.map +1 -0
- package/dist/data.d.ts +58 -0
- package/dist/data.js +214 -0
- package/dist/data.js.map +1 -0
- package/dist/domain-policy.d.ts +36 -0
- package/dist/domain-policy.js +114 -0
- package/dist/domain-policy.js.map +1 -0
- package/dist/feature-types.d.ts +187 -0
- package/dist/feature-types.js +2 -0
- package/dist/feature-types.js.map +1 -0
- package/dist/federation.d.ts +66 -0
- package/dist/federation.js +162 -0
- package/dist/federation.js.map +1 -0
- package/dist/flags.d.ts +27 -0
- package/dist/flags.js +52 -0
- package/dist/flags.js.map +1 -0
- package/dist/governance.d.ts +45 -0
- package/dist/governance.js +128 -0
- package/dist/governance.js.map +1 -0
- package/dist/http-idempotency.d.ts +22 -0
- package/dist/http-idempotency.js +42 -0
- package/dist/http-idempotency.js.map +1 -0
- package/dist/http.d.ts +2 -0
- package/dist/http.js +28 -0
- package/dist/http.js.map +1 -0
- package/dist/identity.d.ts +3 -0
- package/dist/identity.js +3 -0
- package/dist/identity.js.map +1 -0
- package/dist/impersonation.d.ts +2 -0
- package/dist/impersonation.js +3 -0
- package/dist/impersonation.js.map +1 -0
- package/dist/index.d.ts +210 -0
- package/dist/index.js +519 -0
- package/dist/index.js.map +1 -0
- package/dist/integrations.d.ts +114 -0
- package/dist/integrations.js +358 -0
- package/dist/integrations.js.map +1 -0
- package/dist/jobs.d.ts +29 -0
- package/dist/jobs.js +77 -0
- package/dist/jobs.js.map +1 -0
- package/dist/media.d.ts +18 -0
- package/dist/media.js +48 -0
- package/dist/media.js.map +1 -0
- package/dist/offboarding.d.ts +43 -0
- package/dist/offboarding.js +140 -0
- package/dist/offboarding.js.map +1 -0
- package/dist/operations.d.ts +105 -0
- package/dist/operations.js +286 -0
- package/dist/operations.js.map +1 -0
- package/dist/primitives.d.ts +24 -0
- package/dist/primitives.js +111 -0
- package/dist/primitives.js.map +1 -0
- package/dist/provider-operations.d.ts +43 -0
- package/dist/provider-operations.js +143 -0
- package/dist/provider-operations.js.map +1 -0
- package/dist/provider-workflow.d.ts +33 -0
- package/dist/provider-workflow.js +111 -0
- package/dist/provider-workflow.js.map +1 -0
- package/dist/providers.d.ts +42 -0
- package/dist/providers.js +168 -0
- package/dist/providers.js.map +1 -0
- package/dist/quality-config.d.ts +50 -0
- package/dist/quality-config.js +2 -0
- package/dist/quality-config.js.map +1 -0
- package/dist/razorpay-webhook.d.ts +38 -0
- package/dist/razorpay-webhook.js +106 -0
- package/dist/razorpay-webhook.js.map +1 -0
- package/dist/recurring.d.ts +53 -0
- package/dist/recurring.js +241 -0
- package/dist/recurring.js.map +1 -0
- package/dist/registry.d.ts +58 -0
- package/dist/registry.js +839 -0
- package/dist/registry.js.map +1 -0
- package/dist/reliability.d.ts +45 -0
- package/dist/reliability.js +147 -0
- package/dist/reliability.js.map +1 -0
- package/dist/resources.d.ts +19 -0
- package/dist/resources.js +87 -0
- package/dist/resources.js.map +1 -0
- package/dist/security-state.d.ts +14 -0
- package/dist/security-state.js +39 -0
- package/dist/security-state.js.map +1 -0
- package/dist/storage.d.ts +54 -0
- package/dist/storage.js +100 -0
- package/dist/storage.js.map +1 -0
- package/dist/store.d.ts +21 -0
- package/dist/store.js +110 -0
- package/dist/store.js.map +1 -0
- package/dist/stripe-payment.d.ts +21 -0
- package/dist/stripe-payment.js +132 -0
- package/dist/stripe-payment.js.map +1 -0
- package/dist/stripe-recurring.d.ts +58 -0
- package/dist/stripe-recurring.js +226 -0
- package/dist/stripe-recurring.js.map +1 -0
- package/dist/totp.d.ts +2 -0
- package/dist/totp.js +3 -0
- package/dist/totp.js.map +1 -0
- package/dist/transactional-processing.d.ts +27 -0
- package/dist/transactional-processing.js +129 -0
- package/dist/transactional-processing.js.map +1 -0
- package/dist/types.d.ts +367 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/dist/valkey.d.ts +18 -0
- package/dist/valkey.js +22 -0
- package/dist/valkey.js.map +1 -0
- package/dist/worker.d.ts +28 -0
- package/dist/worker.js +200 -0
- package/dist/worker.js.map +1 -0
- package/package.json +34 -3
- 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 @@
|
|
|
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":"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"}
|
package/dist/flags.d.ts
ADDED
|
@@ -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
|
+
}
|