@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
package/dist/index.js ADDED
@@ -0,0 +1,519 @@
1
+ import { RealtimeHub } from '@saplings/realtime';
2
+ import { Gateway, GatewayError, GatewayTransactionalBanStore, GatewayTransactionalRateLimitStore, GatewayHttpPolicies, } from '@saplings/harbor';
3
+ import { IdentityPlatform } from '@saplings/kingsman';
4
+ import { createMiddleware, errorHandler } from '@saplings/middleware';
5
+ import { randomUUID } from 'node:crypto';
6
+ export * from './providers.js';
7
+ export * from './recurring.js';
8
+ export * from './offboarding.js';
9
+ import { StoreRateState } from './security-state.js';
10
+ export { StoreRateState } from './security-state.js';
11
+ import { timeout } from './reliability.js';
12
+ import { WorkerRuntime } from './worker.js';
13
+ import { SaasServicesRegistry } from './registry.js';
14
+ export * from './reliability.js';
15
+ export { EnvelopeCrypto, validateRecord } from './data.js';
16
+ import { Defender } from '@saplings/security';
17
+ import { runScan } from '@saplings/security';
18
+ import { saasFeatures } from '@saplings/catalog';
19
+ import { resolveSaplingConfig, defineSaplingConfig } from './config.js';
20
+ import { SaplingError } from './types.js';
21
+ import { InMemoryStore } from './store.js';
22
+ import { InMemoryStorage, StorageService } from './storage.js';
23
+ import { AuditService } from './audit.js';
24
+ import { AccessService } from './access.js';
25
+ import { ResourceService } from './resources.js';
26
+ import { IdentityService } from './identity.js';
27
+ import { BillingService } from './billing.js';
28
+ import { FlagService } from './flags.js';
29
+ import { JobService } from './jobs.js';
30
+ import { EventService, NotificationService, PaymentService, WebhookService, TelemetryService, } from './integrations.js';
31
+ import { CashfreeAdapter, CashfreeWebhookAdapter } from './cashfree.js';
32
+ import { RazorpayWebhookAdapter } from './razorpay-webhook.js';
33
+ import { StripePaymentAdapter } from './stripe-payment.js';
34
+ import { RazorpayAdapter } from './integrations.js';
35
+ import { CapabilityService } from './capabilities.js';
36
+ export { defineSaplingConfig, resolveSaplingConfig, SaplingError, InMemoryStore, InMemoryStorage, AuditService, AccessService, ResourceService, IdentityService, BillingService, FlagService, JobService, EventService, NotificationService, PaymentService, WebhookService, TelemetryService, CapabilityService, };
37
+ export { RazorpayAdapter } from './integrations.js';
38
+ export * from './cashfree.js';
39
+ export * from './stripe-payment.js';
40
+ export { Defender, runScan } from '@saplings/security';
41
+ export { Gateway, GatewayError, GatewayHttpPolicies } from '@saplings/harbor';
42
+ export { IdentityPlatform as Kingsman } from '@saplings/kingsman';
43
+ export { Gateway as Harbor } from '@saplings/harbor';
44
+ export { IdentityPlatform, MemoryIdentityStore, IdentityError, createIdentityHttpHandler, } from '@saplings/kingsman';
45
+ export { saasFeatures, securityScanners, coverageSummary } from '@saplings/catalog';
46
+ export class SaplingSDK {
47
+ config;
48
+ realtime;
49
+ /** Renamed reusable Harbor gateway. */
50
+ harbor;
51
+ /** Renamed reusable Kingsman identity realm. */
52
+ kingsman;
53
+ /** @deprecated Use harbor. This is a view, not a second gateway instance. */
54
+ get gateway() {
55
+ return this.harbor;
56
+ }
57
+ /** @deprecated Use kingsman. This is a view, not a second identity instance. */
58
+ get identityPlatform() {
59
+ return this.kingsman;
60
+ }
61
+ store;
62
+ audit;
63
+ access;
64
+ identity;
65
+ billing;
66
+ flags;
67
+ jobs;
68
+ storage;
69
+ notifications;
70
+ payments;
71
+ webhooks;
72
+ telemetry;
73
+ /** Harbor-owned API contracts; does not perform ingress auth by itself. */
74
+ httpPolicies = new GatewayHttpPolicies();
75
+ events;
76
+ defender;
77
+ capabilities;
78
+ #services;
79
+ /** providerWorkflows service. */
80
+ get providerWorkflows() {
81
+ return this.#services.providerWorkflows;
82
+ }
83
+ /** governance service. */
84
+ get governance() {
85
+ return this.#services.governance;
86
+ }
87
+ /** domains service. */
88
+ get domains() {
89
+ return this.#services.domains;
90
+ }
91
+ /** providerOperations service. */
92
+ get providerOperations() {
93
+ return this.#services.providerOperations;
94
+ }
95
+ /** recurring service. */
96
+ get recurring() {
97
+ return this.#services.recurring;
98
+ }
99
+ /** offboarding service. */
100
+ get offboarding() {
101
+ return this.#services.offboarding;
102
+ }
103
+ /** impersonation service. */
104
+ get impersonation() {
105
+ return this.#services.impersonation;
106
+ }
107
+ /** operations service. */
108
+ get operations() {
109
+ return this.#services.operations;
110
+ }
111
+ /** accounts service. */
112
+ get accounts() {
113
+ return this.#services.accounts;
114
+ }
115
+ /** commerce service. */
116
+ get commerce() {
117
+ return this.#services.commerce;
118
+ }
119
+ /** data service. */
120
+ get data() {
121
+ return this.#services.data;
122
+ }
123
+ /** analytics service. */
124
+ get analytics() {
125
+ return this.#services.analytics;
126
+ }
127
+ /** automation service. */
128
+ get automation() {
129
+ return this.#services.automation;
130
+ }
131
+ /** lifecycle service. */
132
+ get lifecycle() {
133
+ return this.#services.lifecycle;
134
+ }
135
+ /** metrics service. */
136
+ get metrics() {
137
+ return this.#services.metrics;
138
+ }
139
+ worker;
140
+ organizations;
141
+ workspaces;
142
+ projects;
143
+ teams;
144
+ memberships;
145
+ eventsRepository;
146
+ appConfig;
147
+ activity;
148
+ constructor(config) {
149
+ this.config = resolveSaplingConfig(config);
150
+ if (this.config.realtime?.enabled === true)
151
+ this.realtime = new RealtimeHub(this.config.realtime);
152
+ this.store = config.providers?.store ?? new InMemoryStore();
153
+ this.audit = new AuditService(this.store, this.config.audit.enabled);
154
+ this.access = new AccessService(this.store, this.config.access);
155
+ this.identity = new IdentityService(this.store, this.access, this.audit, this.config.auth.apiKeys.defaultTtlDays);
156
+ const selectedKingsman = config.platforms?.kingsman ?? config.platforms?.identity;
157
+ if (selectedKingsman) {
158
+ const { config: realm, dependencies = {} } = selectedKingsman;
159
+ if (realm.metadata.environment === 'production' &&
160
+ this.store instanceof InMemoryStore &&
161
+ !dependencies.store)
162
+ throw new SaplingError('INSECURE_CONFIG', 'Production realms require a persistent store');
163
+ this.kingsman = new IdentityPlatform(realm, {
164
+ ...dependencies,
165
+ store: dependencies.store ??
166
+ (this.store.transaction
167
+ ? this.store
168
+ : undefined),
169
+ });
170
+ }
171
+ const selectedHarbor = config.platforms?.harbor ?? config.platforms?.gateway;
172
+ if (selectedHarbor) {
173
+ const { config: gw, dependencies = {} } = selectedHarbor;
174
+ const verification = dependencies.verifyJwt ??
175
+ (this.kingsman
176
+ ? async (token, policy) => {
177
+ if (policy.realmRef !== this.kingsman.realm ||
178
+ policy.algorithms?.some((a) => a !== 'RS256'))
179
+ throw new GatewayError('INVALID_REALM', 'Gateway realm/alg mismatch', 401);
180
+ return this.kingsman.verifyAccessToken(token, {
181
+ audiences: policy.audiences,
182
+ clockSkewMs: policy.clockSkewMs,
183
+ });
184
+ }
185
+ : undefined);
186
+ const shared = this.store.transaction
187
+ ? this.store
188
+ : undefined;
189
+ const keyVerifier = dependencies.verifyApiKey ??
190
+ (dependencies.keyTenantForRequest
191
+ ? async (key, context) => {
192
+ const tenantId = await dependencies.keyTenantForRequest(context);
193
+ if (!tenantId)
194
+ return undefined;
195
+ const verified = await this.identity.verifyApiKey(tenantId, key);
196
+ return verified ? { sub: verified.id, tenantId, scopes: verified.scopes } : undefined;
197
+ }
198
+ : undefined);
199
+ this.harbor = new Gateway(gw, {
200
+ ...dependencies,
201
+ verifyJwt: verification,
202
+ verifyApiKey: keyVerifier,
203
+ rateLimit: dependencies.rateLimit ??
204
+ (shared ? new GatewayTransactionalRateLimitStore(shared) : undefined),
205
+ ddosBans: dependencies.ddosBans ?? (shared ? new GatewayTransactionalBanStore(shared) : undefined),
206
+ });
207
+ }
208
+ this.billing = new BillingService(this.store, this.access, this.audit);
209
+ this.flags = new FlagService(this.store, this.access, this.audit);
210
+ this.jobs = new JobService(this.store, this.audit, this.config.workflows.maxAttempts);
211
+ this.storage = new StorageService(config.providers?.storage ?? new InMemoryStorage(), this.access, this.audit, this.config.storage.maxUploadBytes, this.config.storage.authorizeObject);
212
+ this.notifications = new NotificationService(config.providers?.notifications, this.audit);
213
+ const p = this.config.payments;
214
+ const paymentAdapter = !p.enabled
215
+ ? undefined
216
+ : (config.providers?.payments ??
217
+ (p.provider === 'cashfree' && p.cashfree
218
+ ? new CashfreeAdapter(p.cashfree)
219
+ : p.provider === 'razorpay' && p.razorpay
220
+ ? new RazorpayAdapter(p.razorpay.keyId, p.razorpay.secret)
221
+ : p.provider === 'stripe' && p.stripe
222
+ ? new StripePaymentAdapter(p.stripe.secret)
223
+ : undefined));
224
+ this.payments = new PaymentService(paymentAdapter, this.audit, this.store, this.access, p.provider);
225
+ const paymentCapabilities = paymentAdapter instanceof CashfreeAdapter
226
+ ? { 'SAAS-050': new CashfreeWebhookAdapter(this.store, paymentAdapter) }
227
+ : paymentAdapter instanceof RazorpayAdapter && p.razorpay?.webhookSecret
228
+ ? { 'SAAS-050': new RazorpayWebhookAdapter(this.store, p.razorpay.webhookSecret) }
229
+ : {};
230
+ this.webhooks = new WebhookService();
231
+ this.telemetry = new TelemetryService(config.providers?.telemetry);
232
+ this.events = new EventService();
233
+ const security = this.config.security.defender;
234
+ this.defender = new Defender({
235
+ ...security,
236
+ policy: {
237
+ ...security.policy,
238
+ rateState: security.policy?.rateState ??
239
+ (config.providers?.store?.transaction ? new StoreRateState(this.store) : undefined),
240
+ },
241
+ onThreat: async (event) => {
242
+ await this.store.put(event.tenantId ?? '__sapling_security_events', 'security-events', {
243
+ ...event,
244
+ });
245
+ await security.onThreat?.(event);
246
+ },
247
+ onAlert: async (event) => {
248
+ await this.store.put(event.tenantId ?? '__sapling_security_events', 'security-incidents', {
249
+ ...event,
250
+ status: 'open',
251
+ });
252
+ await security.onAlert?.(event);
253
+ },
254
+ });
255
+ this.organizations = new ResourceService('organizations', this.store, this.access, this.audit);
256
+ this.workspaces = new ResourceService('workspaces', this.store, this.access, this.audit);
257
+ this.projects = new ResourceService('projects', this.store, this.access, this.audit);
258
+ this.teams = new ResourceService('teams', this.store, this.access, this.audit);
259
+ this.memberships = new ResourceService('memberships', this.store, this.access, this.audit);
260
+ this.eventsRepository = new ResourceService('events', this.store, this.access, this.audit);
261
+ this.appConfig = new ResourceService('app-config', this.store, this.access, this.audit);
262
+ this.activity = new ResourceService('activity', this.store, this.access, this.audit);
263
+ this.#services = new SaasServicesRegistry(this);
264
+ this.worker = new WorkerRuntime(this, this.config.services?.worker);
265
+ const gates = {
266
+ identity: this.config.auth.enabled,
267
+ tenancy: this.config.tenancy.enabled,
268
+ billing: this.config.billing.enabled,
269
+ storage: this.config.storage.enabled,
270
+ notifications: this.config.notifications.enabled,
271
+ analytics: this.config.analytics.enabled,
272
+ workflows: this.config.workflows.enabled,
273
+ };
274
+ const settings = Object.fromEntries(saasFeatures.map((f) => [
275
+ f.id,
276
+ {
277
+ ...config.features?.[f.id],
278
+ enabled: gates[f.module] === false ||
279
+ (!p.enabled && ['SAAS-042', 'SAAS-043', 'SAAS-047', 'SAAS-050'].includes(f.id))
280
+ ? false
281
+ : (config.features?.[f.id]?.enabled ?? true),
282
+ },
283
+ ]));
284
+ const manifest = this.#services.manifest();
285
+ this.capabilities = new CapabilityService(settings, { ...this.#services.adapters(), ...paymentCapabilities, ...config.providers?.capabilities }, this.access, Object.fromEntries(manifest.map((m) => [m.featureId, m.actions])), manifest.filter((m) => m.kind === 'provider').map((m) => m.featureId), Object.keys({ ...paymentCapabilities, ...config.providers?.capabilities }), async (ctx, id) => {
286
+ if (id === 'SAAS-024')
287
+ return;
288
+ const profile = await this.store.get(ctx.tenantId, 'tenant-profile', 'profile');
289
+ if (profile && ['offboarding', 'offboarded'].includes(profile.status))
290
+ throw new SaplingError('TENANT_FROZEN', 'Tenant is offboarding', 403);
291
+ });
292
+ }
293
+ /** Runs an async trusted context resolver before the in-process runtime defender. */
294
+ middleware() {
295
+ return async (req, res, next) => {
296
+ try {
297
+ let context = await this.config.hooks?.resolveRequestContext?.(req);
298
+ const auth = req.headers.authorization;
299
+ if (!context &&
300
+ typeof auth === 'string' &&
301
+ auth.startsWith('Bearer ') &&
302
+ this.config.providers?.authentication) {
303
+ const verified = await this.config.providers.authentication.verifyAccessToken(auth.slice(7));
304
+ if (verified)
305
+ context = {
306
+ tenantId: verified.tenantId,
307
+ actorId: verified.userId,
308
+ roles: verified.roles,
309
+ permissions: verified.permissions,
310
+ };
311
+ }
312
+ if (context?.tenantId.startsWith('__sapling_'))
313
+ throw new SaplingError('INVALID_TENANT', 'Reserved tenant namespace', 403);
314
+ delete req.sapling;
315
+ if (context)
316
+ req.sapling = {
317
+ impersonatorId: context.impersonatorId,
318
+ tenantId: context.tenantId,
319
+ userId: context.actorId,
320
+ correlationId: context.correlationId ?? randomUUID(),
321
+ roles: context.roles,
322
+ permissions: context.permissions,
323
+ };
324
+ // Analyze unauthenticated requests too: otherwise login probing never reaches the defender.
325
+ await this.defender.middleware()(req, res, (err) => {
326
+ if (err) {
327
+ next(err);
328
+ return;
329
+ }
330
+ if (this.config.tenancy.enabled &&
331
+ this.config.tenancy.enforceContext &&
332
+ !context?.tenantId &&
333
+ !['/health', '/ready'].includes((req.path ?? req.url ?? '').split('?')[0])) {
334
+ res.statusCode = 401;
335
+ res.setHeader('content-type', 'application/json');
336
+ res.end(JSON.stringify({
337
+ error: {
338
+ code: 'CONTEXT_REQUIRED',
339
+ message: 'Authenticated tenant context required',
340
+ },
341
+ }));
342
+ return;
343
+ }
344
+ next();
345
+ });
346
+ }
347
+ catch (e) {
348
+ next(e);
349
+ }
350
+ };
351
+ }
352
+ /** Optional general HTTP middleware; install after trusted context, before route handlers. */
353
+ httpMiddleware() {
354
+ return createMiddleware(this.config.middleware ?? {});
355
+ }
356
+ httpErrorHandler() {
357
+ return errorHandler(this.config.middleware ?? {});
358
+ }
359
+ async closeRealtime() {
360
+ await this.realtime?.close();
361
+ }
362
+ /** Authorization must be called by route handlers for resource/action-specific checks. */
363
+ async authorize(ctx, permission, resource) {
364
+ return this.access.require(ctx, permission, resource);
365
+ }
366
+ /** Catalog metadata; does not expose the mutable internal registry. */
367
+ featureManifest() {
368
+ return this.#services.manifest();
369
+ }
370
+ /** Typed catalog invocation; provider payloads/results remain unknown until validated by the consumer. */
371
+ invokeCapability(ctx, id, action, input = {}) {
372
+ return this.capabilities.invoke(ctx, id, action, input);
373
+ }
374
+ getCapability(featureId) {
375
+ return this.capabilities.get(featureId);
376
+ }
377
+ listCapabilities() {
378
+ return this.capabilities.list();
379
+ }
380
+ async scan(root, url, allowedHosts) {
381
+ if (!this.config.security.scanner.enabled)
382
+ throw new SaplingError('SCANNER_DISABLED', 'Scanner is disabled');
383
+ return runScan({
384
+ root,
385
+ url,
386
+ allowedHosts: allowedHosts ?? this.config.security.scanner.allowedHosts,
387
+ adapters: this.config.security.scanner.adapters,
388
+ enabledScannerIds: this.config.security.scanner.enabledScannerIds,
389
+ reports: this.config.security.scanner.reports,
390
+ dns: this.config.security.scanner.dns,
391
+ threatIntelligence: this.config.security.scanner.threatIntelligence,
392
+ });
393
+ }
394
+ /** Export only approved tenant data and fields. Paginates from the store; never bypasses configured domain policies. */
395
+ async exportTenantData(ctx, collections = [
396
+ 'organizations',
397
+ 'workspaces',
398
+ 'projects',
399
+ 'teams',
400
+ 'memberships',
401
+ 'events',
402
+ 'activity',
403
+ ]) {
404
+ await this.access.require(ctx, 'data:export');
405
+ if (!ctx.tenantId || ctx.tenantId.startsWith('__sapling_') || !ctx.actorId)
406
+ throw new SaplingError('FORBIDDEN', 'Invalid export context', 403);
407
+ const approved = new Set([
408
+ 'organizations',
409
+ 'workspaces',
410
+ 'projects',
411
+ 'teams',
412
+ 'memberships',
413
+ 'events',
414
+ 'activity',
415
+ 'app-config',
416
+ ]);
417
+ if (!Array.isArray(collections) ||
418
+ !collections.length ||
419
+ collections.length > approved.size ||
420
+ new Set(collections).size !== collections.length)
421
+ throw new SaplingError('EXPORT_INVALID', 'Invalid export collections', 400);
422
+ const data = {};
423
+ let total = 0;
424
+ for (const collection of collections) {
425
+ if (!approved.has(collection))
426
+ throw new SaplingError('EXPORT_NOT_ALLOWED', `Export of ${collection} is not permitted`, 403);
427
+ if (this.config.app.environment === 'production' && !this.domains.hasPolicy(collection))
428
+ throw new SaplingError('DOMAIN_POLICY_REQUIRED', `Configure row and field export policy for ${collection}`, 503);
429
+ if (this.config.app.environment === 'production' && !this.store.page)
430
+ throw new SaplingError('EXPORT_PAGINATION_REQUIRED', 'Bounded store paging is required', 503);
431
+ const out = [];
432
+ let after;
433
+ const cursors = new Set();
434
+ for (;;) {
435
+ const result = this.domains.hasPolicy(collection)
436
+ ? await this.domains.list(ctx, collection, { limit: 250, after })
437
+ : this.store.page
438
+ ? await this.store.page(ctx.tenantId, collection, 250, after)
439
+ : {
440
+ items: await this.store.list(ctx.tenantId, collection),
441
+ next: undefined,
442
+ };
443
+ for (const item of result.items) {
444
+ if (this.domains.hasPolicy(collection) ||
445
+ (await this.access.has(ctx, `${collection}:read`, item))) {
446
+ out.push(item);
447
+ if (++total > 5000)
448
+ throw new SaplingError('EXPORT_LIMIT', 'Export exceeds 5000 authorized rows; use an approved async export worker', 413);
449
+ }
450
+ }
451
+ if (!result.next)
452
+ break;
453
+ if (cursors.has(result.next) || result.next === after)
454
+ throw new SaplingError('EXPORT_CURSOR', 'Store pagination failed to advance', 502);
455
+ cursors.add(result.next);
456
+ after = result.next;
457
+ }
458
+ data[collection] = out;
459
+ }
460
+ await this.audit.record(ctx, 'tenant.exported', 'data', undefined, {
461
+ collections,
462
+ rowCount: total,
463
+ });
464
+ return { tenantId: ctx.tenantId, exportedAt: new Date().toISOString(), collections: data };
465
+ }
466
+ health() {
467
+ return {
468
+ status: 'ok',
469
+ app: this.config.app.id,
470
+ environment: this.config.app.environment,
471
+ at: new Date().toISOString(),
472
+ };
473
+ }
474
+ async readiness() {
475
+ if (!this.lifecycle.ready)
476
+ return { status: 'not-ready', reason: 'shutting down' };
477
+ if (!this.store.health)
478
+ return { status: 'degraded', reason: 'Store health check unavailable' };
479
+ const checks = {
480
+ ...this.config.services?.operations?.readiness,
481
+ database: () => this.store.health(),
482
+ };
483
+ const result = await Promise.all(Object.entries(checks).map(async ([name, check]) => {
484
+ try {
485
+ await timeout(() => check(), 3000);
486
+ return [name, true];
487
+ }
488
+ catch {
489
+ return [name, false];
490
+ }
491
+ }));
492
+ return {
493
+ status: result.every(([, ok]) => ok) ? 'ready' : 'not-ready',
494
+ checks: Object.fromEntries(result),
495
+ };
496
+ }
497
+ }
498
+ export function createSapling(config) {
499
+ return new SaplingSDK(config);
500
+ }
501
+ export * from './valkey.js';
502
+ export * from './razorpay-webhook.js';
503
+ export * from './federation.js';
504
+ export * from './totp.js';
505
+ export * from './worker.js';
506
+ export * from './operations.js';
507
+ export * from './control-plane.js';
508
+ export * from './media.js';
509
+ export * from './impersonation.js';
510
+ export * from './http-idempotency.js';
511
+ export * from './provider-operations.js';
512
+ export * from './stripe-recurring.js';
513
+ export * from './transactional-processing.js';
514
+ export * from './governance.js';
515
+ export * from './domain-policy.js';
516
+ export * from './billing-policy.js';
517
+ export * from './provider-workflow.js';
518
+ export * from './business-workflows.js';
519
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,114 @@
1
+ import type { ActorContext, NotificationAdapter, PaymentAdapter, PaymentResult, PaymentOrderInput, JsonRecord, TelemetryAdapter, Store } from './types.js';
2
+ import { AccessService } from './access.js';
3
+ import { AuditService } from './audit.js';
4
+ export interface SaplingEvent {
5
+ id: string;
6
+ type: string;
7
+ tenantId: string;
8
+ at: string;
9
+ data: JsonRecord;
10
+ correlationId?: string;
11
+ }
12
+ export declare class EventService {
13
+ private listeners;
14
+ on(type: string, handler: (event: SaplingEvent) => void | Promise<void>): () => boolean;
15
+ emit(ctx: ActorContext, type: string, data: JsonRecord): Promise<SaplingEvent>;
16
+ }
17
+ export declare class NotificationService {
18
+ private provider;
19
+ private audit;
20
+ constructor(provider: NotificationAdapter | undefined, audit: AuditService);
21
+ send(ctx: ActorContext, input: {
22
+ channel: 'email' | 'sms' | 'push' | 'inapp';
23
+ to: string;
24
+ subject?: string;
25
+ body: string;
26
+ template?: string;
27
+ metadata?: JsonRecord;
28
+ }): Promise<{
29
+ id: string;
30
+ status: "queued" | "sent";
31
+ }>;
32
+ }
33
+ export declare class PaymentService {
34
+ private provider;
35
+ private audit;
36
+ private store?;
37
+ private access?;
38
+ private providerName;
39
+ constructor(provider: PaymentAdapter | undefined, audit: AuditService, store?: Store | undefined, access?: AccessService | undefined, providerName?: string);
40
+ private ready;
41
+ private order;
42
+ createOrder(ctx: ActorContext, input: Omit<PaymentOrderInput, 'tenantId'> & {
43
+ invoiceId?: string;
44
+ }): Promise<PaymentResult>;
45
+ /** Read-only provider recovery; never blindly resubmit an ambiguous mutation. */
46
+ recoverOrder(ctx: ActorContext, input: Omit<PaymentOrderInput, 'tenantId'> & {
47
+ invoiceId?: string;
48
+ }): Promise<PaymentResult>;
49
+ reconcilePayment(ctx: ActorContext, input: {
50
+ orderId: string;
51
+ paymentId: string;
52
+ }): Promise<{
53
+ processed: boolean;
54
+ duplicate?: boolean;
55
+ paymentId: string;
56
+ }>;
57
+ refund(ctx: ActorContext, input: {
58
+ paymentId: string;
59
+ amountMinor?: number;
60
+ idempotencyKey?: string;
61
+ }): Promise<PaymentResult>;
62
+ reconcileRefund(ctx: ActorContext, input: {
63
+ paymentId: string;
64
+ amountMinor?: number;
65
+ idempotencyKey?: string;
66
+ }): Promise<PaymentResult>;
67
+ private processRefund;
68
+ }
69
+ export declare class WebhookService {
70
+ /** Timestamp + payload are authenticated; callers must persist event IDs for durable replay protection. */
71
+ sign(payload: string, secret: string, timestampSeconds?: number): {
72
+ timestamp: number;
73
+ signature: any;
74
+ };
75
+ verify(payload: string, secret: string, timestamp: number, signature: string, maxAgeSeconds?: number): boolean;
76
+ }
77
+ export declare class TelemetryService {
78
+ private provider?;
79
+ constructor(provider?: TelemetryAdapter | undefined);
80
+ log(level: 'debug' | 'info' | 'warn' | 'error', event: string, fields?: JsonRecord): void | Promise<void> | undefined;
81
+ }
82
+ /** Sample S3 adapter: inject an AWS SDK v3 compatible client and configured bucket. */
83
+ export interface S3LikeClient {
84
+ send(command: unknown): Promise<any>;
85
+ }
86
+ export declare class S3StorageAdapterExample {
87
+ static guidance: string;
88
+ }
89
+ /** Razorpay: provider owns payment verification and idempotency; do not treat an order as paid. */
90
+ export declare class RazorpayAdapter implements PaymentAdapter {
91
+ private keyId;
92
+ private secret;
93
+ private apiBase;
94
+ readonly name = "razorpay";
95
+ constructor(keyId: string, secret: string, apiBase?: string);
96
+ private request;
97
+ createOrder(input: {
98
+ tenantId: string;
99
+ amountMinor: number;
100
+ currency: string;
101
+ reference: string;
102
+ }): Promise<{
103
+ id: string;
104
+ status: string;
105
+ }>;
106
+ refund(input: {
107
+ tenantId: string;
108
+ paymentId: string;
109
+ amountMinor?: number;
110
+ }): Promise<{
111
+ id: string;
112
+ status: string;
113
+ }>;
114
+ }