@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,226 @@
1
+ import { timingSafeEqual } from 'node:crypto';
2
+ import { atomic, fail, hash, integer, object, text, sign } from './primitives.js';
3
+ import { boundedResponseText } from './http.js';
4
+ import { Bulkhead, timeout } from './reliability.js';
5
+ /** Fixed Stripe account and trusted mandate resolver. No card data is accepted. Never blindly recreate an ambiguous PaymentIntent. */
6
+ export class StripeRecurringGateway {
7
+ store;
8
+ token;
9
+ mandate;
10
+ bulkhead = new Bulkhead(16);
11
+ constructor(store, token, mandate) {
12
+ this.store = store;
13
+ this.token = token;
14
+ this.mandate = mandate;
15
+ }
16
+ async request(path, signal, params, key) {
17
+ return this.bulkhead.run(() => timeout(async (deadline) => {
18
+ const token = await this.token();
19
+ const combined = signal ? AbortSignal.any([signal, deadline]) : deadline;
20
+ if (combined.aborted)
21
+ throw Error('Aborted');
22
+ const response = await fetch('https://api.stripe.com/v1' + path, {
23
+ method: params ? 'POST' : 'GET',
24
+ redirect: 'error',
25
+ signal: combined,
26
+ headers: {
27
+ authorization: `Bearer ${token}`,
28
+ ...(params ? { 'content-type': 'application/x-www-form-urlencoded' } : {}),
29
+ ...(key ? { 'idempotency-key': key } : {}),
30
+ },
31
+ body: params ? new URLSearchParams(params) : undefined,
32
+ });
33
+ const parsed = object(JSON.parse(await boundedResponseText(response, 1_000_000)));
34
+ if (response.ok)
35
+ return parsed;
36
+ if (response.status === 402) {
37
+ const err = object(parsed.error ?? {});
38
+ if (err.payment_intent)
39
+ return object(err.payment_intent);
40
+ }
41
+ throw Error(`Stripe HTTP ${response.status}`);
42
+ }, 12000));
43
+ }
44
+ fingerprint(req) {
45
+ return hash(JSON.stringify([
46
+ req.tenantId,
47
+ req.customerId,
48
+ req.invoiceId,
49
+ req.amountMinor,
50
+ req.currency.toLowerCase(),
51
+ ]));
52
+ }
53
+ async mapping(req) {
54
+ if (req.signal?.aborted)
55
+ throw Error('Aborted');
56
+ text(req.tenantId, 'tenant', 200);
57
+ text(req.customerId, 'customer', 200);
58
+ text(req.invoiceId, 'invoice', 200);
59
+ text(req.idempotencyKey, 'idempotency key', 200);
60
+ integer(req.amountMinor, 'amount', 1);
61
+ if (!/^[A-Za-z]{3}$/.test(req.currency))
62
+ throw Error('Invalid currency');
63
+ const mandate = await timeout(() => this.mandate(req.tenantId, req.customerId), 5000);
64
+ if (!mandate.offSessionApproved ||
65
+ !/^cus_[A-Za-z0-9]+$/.test(mandate.customer) ||
66
+ !/^pm_[A-Za-z0-9]+$/.test(mandate.paymentMethod))
67
+ return fail('Verified off-session mandate required', 'FORBIDDEN', 403);
68
+ return mandate;
69
+ }
70
+ verify(intent, req, mandate, id) {
71
+ const reference = text(intent.id, 'intent', 200);
72
+ if (!/^pi_[A-Za-z0-9]+$/.test(reference) ||
73
+ intent.customer !== mandate.customer ||
74
+ intent.amount !== req.amountMinor ||
75
+ intent.currency !== req.currency.toLowerCase() ||
76
+ object(intent.metadata ?? {}).sapling_attempt !== id)
77
+ return fail('Stripe intent does not match invoice', 'PROVIDER_FAILED', 502);
78
+ return reference;
79
+ }
80
+ async persist(req, id, reference) {
81
+ return atomic(this.store, req.tenantId, async (tx) => {
82
+ const row = await tx.get(req.tenantId, 'stripe-recurring-attempts', id);
83
+ if (!row ||
84
+ row.fingerprint !== this.fingerprint(req) ||
85
+ (row.intent && row.intent !== reference))
86
+ return fail('Payment reconciliation conflict', 'CONFLICT', 409);
87
+ await tx.put(req.tenantId, 'stripe-recurring-attempts', { ...row, intent: reference });
88
+ });
89
+ }
90
+ async charge(req) {
91
+ const mandate = await this.mapping(req);
92
+ const id = hash(JSON.stringify([req.tenantId, req.idempotencyKey])), fingerprint = this.fingerprint(req);
93
+ const claim = await atomic(this.store, req.tenantId, async (tx) => {
94
+ const row = await tx.get(req.tenantId, 'stripe-recurring-attempts', id);
95
+ if (row) {
96
+ if (row.fingerprint !== fingerprint)
97
+ return fail('Payment idempotency conflict', 'CONFLICT', 409);
98
+ return { row, created: false };
99
+ }
100
+ const next = {
101
+ id,
102
+ fingerprint,
103
+ createdAt: new Date().toISOString(),
104
+ invoiceId: req.invoiceId,
105
+ customer: mandate.customer,
106
+ amountMinor: req.amountMinor,
107
+ currency: req.currency.toLowerCase(),
108
+ chargeKey: req.idempotencyKey,
109
+ };
110
+ await tx.put(req.tenantId, 'stripe-recurring-attempts', next);
111
+ return { row: next, created: true };
112
+ });
113
+ if (!claim.created && !claim.row.intent)
114
+ return { status: 'pending', reference: `pending:${id}` };
115
+ const intent = claim.row.intent
116
+ ? await this.request('/payment_intents/' + encodeURIComponent(claim.row.intent), req.signal)
117
+ : await this.request('/payment_intents', req.signal, {
118
+ amount: String(req.amountMinor),
119
+ currency: req.currency.toLowerCase(),
120
+ customer: mandate.customer,
121
+ payment_method: mandate.paymentMethod,
122
+ confirm: 'true',
123
+ off_session: 'true',
124
+ 'payment_method_types[0]': 'card',
125
+ 'metadata[sapling_attempt]': id,
126
+ }, id);
127
+ const reference = this.verify(intent, req, mandate, id);
128
+ if (claim.row.intent && claim.row.intent !== reference)
129
+ throw Error('Unexpected intent reference');
130
+ await this.persist(req, id, reference);
131
+ if (intent.status === 'succeeded' && intent.amount_received === req.amountMinor)
132
+ return { status: 'paid', reference };
133
+ if (intent.status === 'canceled')
134
+ return { status: 'declined', reference };
135
+ if (intent.status === 'requires_action' || intent.status === 'requires_payment_method')
136
+ return { status: 'requires_action', reference };
137
+ return { status: 'pending', reference };
138
+ }
139
+ /** Trusted reconciliation only, after provider-side discovery; verify amount/customer/metadata before binding. */
140
+ async recover(req, providerIntentId) {
141
+ if (!/^pi_[A-Za-z0-9]+$/.test(providerIntentId))
142
+ throw Error('Invalid intent ID');
143
+ const mandate = await this.mapping(req), id = hash(JSON.stringify([req.tenantId, req.idempotencyKey]));
144
+ const intent = await this.request('/payment_intents/' + encodeURIComponent(providerIntentId), req.signal);
145
+ const reference = this.verify(intent, req, mandate, id);
146
+ if (reference !== providerIntentId)
147
+ throw Error('Unexpected intent reference');
148
+ await this.persist(req, id, reference);
149
+ return { reference };
150
+ }
151
+ }
152
+ /** Trusted raw-body webhook endpoint. Tenant must be resolved from verified account routing, never payload. Wakes polling; never marks an invoice paid from a webhook alone. */
153
+ export class StripeRecurringWebhook {
154
+ store;
155
+ secret;
156
+ toleranceSeconds;
157
+ constructor(store, secret, toleranceSeconds = 300) {
158
+ this.store = store;
159
+ this.secret = secret;
160
+ this.toleranceSeconds = toleranceSeconds;
161
+ if (secret.length < 16)
162
+ throw Error('Webhook secret too short');
163
+ integer(toleranceSeconds, 'tolerance', 1, 600);
164
+ }
165
+ async receive(tenant, raw, header, at = Date.now()) {
166
+ text(tenant, 'tenant', 200);
167
+ text(raw, 'raw', 1_000_000);
168
+ if (Buffer.byteLength(raw) > 1_000_000)
169
+ throw Error('Webhook too large');
170
+ text(header, 'signature', 2048);
171
+ const parts = header.split(',').map((s) => s.trim());
172
+ const timestamps = parts.filter((s) => s.startsWith('t='));
173
+ const signatures = parts.filter((s) => /^v1=[a-f0-9]{64}$/i.test(s)).map((s) => s.slice(3));
174
+ if (timestamps.length !== 1 || !/^t=\d{1,12}$/.test(timestamps[0]) || !signatures.length)
175
+ return fail('Invalid webhook signature', 'UNAUTHENTICATED', 401);
176
+ const stamp = Number(timestamps[0].slice(2));
177
+ const expected = Buffer.from(sign(`${stamp}.${raw}`, this.secret), 'hex');
178
+ if (Math.abs(at / 1000 - stamp) > this.toleranceSeconds ||
179
+ !signatures.some((s) => timingSafeEqual(Buffer.from(s, 'hex'), expected)))
180
+ return fail('Invalid webhook signature', 'UNAUTHENTICATED', 401);
181
+ const event = object(JSON.parse(raw)), eventId = text(event.id, 'event ID', 200);
182
+ if (!/^evt_[A-Za-z0-9]+$/.test(eventId))
183
+ return fail('Invalid event ID');
184
+ if (![
185
+ 'payment_intent.succeeded',
186
+ 'payment_intent.canceled',
187
+ 'payment_intent.payment_failed',
188
+ 'payment_intent.requires_action',
189
+ 'payment_intent.processing',
190
+ ].includes(String(event.type)))
191
+ return { processed: false, reason: 'unsupported' };
192
+ const intent = object(object(event.data).object), attemptId = text(object(intent.metadata).sapling_attempt, 'attempt ID', 64);
193
+ if (!/^[a-f0-9]{64}$/.test(attemptId))
194
+ return fail('Invalid attempt ID');
195
+ return atomic(this.store, tenant, async (tx) => {
196
+ const prior = await tx.get(tenant, 'stripe-webhook-inbox', eventId);
197
+ if (prior)
198
+ return { processed: false, duplicate: true };
199
+ const map = await tx.get(tenant, 'stripe-recurring-attempts', attemptId);
200
+ if (!map ||
201
+ !map.invoiceId ||
202
+ !map.chargeKey ||
203
+ !map.intent ||
204
+ map.intent !== intent.id ||
205
+ map.customer !== intent.customer ||
206
+ map.amountMinor !== intent.amount ||
207
+ map.currency !== intent.currency)
208
+ return fail('Unmatched recurring intent', 'PAYMENT_MISMATCH', 409);
209
+ const a = await tx.get(tenant, 'billing-attempts', map.invoiceId);
210
+ if (!a || a.idempotencyKey !== map.chargeKey)
211
+ return fail('Unmatched billing attempt', 'PAYMENT_MISMATCH', 409);
212
+ let woken = false;
213
+ if (['requires_action', 'pending'].includes(String(a.status))) {
214
+ await tx.put(tenant, 'billing-attempts', a.lease ? { ...a, wakeRequested: true } : { ...a, status: 'pending', nextAttemptAt: at });
215
+ woken = true;
216
+ }
217
+ await tx.put(tenant, 'stripe-webhook-inbox', {
218
+ id: eventId,
219
+ attemptId,
220
+ receivedAt: new Date(at).toISOString(),
221
+ });
222
+ return { processed: true, woken };
223
+ });
224
+ }
225
+ }
226
+ //# sourceMappingURL=stripe-recurring.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stripe-recurring.js","sourceRoot":"","sources":["../src/stripe-recurring.ts"],"names":[],"mappings":"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"}
package/dist/totp.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ /** @deprecated Import TOTP helpers from @saplings/kingsman. */
2
+ export * from '@saplings/kingsman';
package/dist/totp.js ADDED
@@ -0,0 +1,3 @@
1
+ /** @deprecated Import TOTP helpers from @saplings/kingsman. */
2
+ export * from '@saplings/kingsman';
3
+ //# sourceMappingURL=totp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"totp.js","sourceRoot":"","sources":["../src/totp.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,cAAc,oBAAoB,CAAC"}
@@ -0,0 +1,27 @@
1
+ import type { ActorContext, JsonRecord, Store } from './types.js';
2
+ import type { EventJournal, RealtimeEvent } from '@saplings/realtime';
3
+ export interface TransactionalHttpResponse {
4
+ status: number;
5
+ body: unknown;
6
+ }
7
+ export interface TransactionalHttpRequest {
8
+ operation: string;
9
+ key: string;
10
+ method: string;
11
+ input: JsonRecord;
12
+ }
13
+ /** Trusted route handler helper. Authorize each request BEFORE calling, including replay. Only DB effects on tx (or an outbox insert) are safe. */
14
+ export declare function transactionalHttpOperation(store: Store, ctx: ActorContext, request: TransactionalHttpRequest, execute: (tx: Store) => Promise<TransactionalHttpResponse>): Promise<TransactionalHttpResponse & {
15
+ replayed: boolean;
16
+ }>;
17
+ /** Durable transactional consumer for trusted service identities. Handler must use supplied tx only; remote side effects use outbox. No wire ACK protocol. */
18
+ export declare class TransactionalEventConsumer {
19
+ private readonly store;
20
+ private readonly journal;
21
+ constructor(store: Store, journal: EventJournal);
22
+ process(ctx: ActorContext, channel: string, consumer: string, handle: (tx: Store, event: RealtimeEvent) => Promise<void>, limit?: number): Promise<{
23
+ processed: number;
24
+ cursor: string;
25
+ contended: boolean;
26
+ }>;
27
+ }
@@ -0,0 +1,129 @@
1
+ import { atomic, fail, hash, integer, scope, text } from './primitives.js';
2
+ /** Canonical, bounded JSON; no getters, functions, non-finite numbers, undefined or cyclic values. */
3
+ function canonical(value, maxBytes = 1_000_000) {
4
+ let nodes = 0;
5
+ const visit = (v, depth) => {
6
+ if (++nodes > 50000 || depth > 32)
7
+ return fail('JSON complexity exceeds limit');
8
+ if (v === null || typeof v === 'boolean' || typeof v === 'string')
9
+ return v;
10
+ if (typeof v === 'number' && Number.isFinite(v))
11
+ return v;
12
+ if (!v || typeof v !== 'object')
13
+ return fail('Expected JSON value');
14
+ if (Array.isArray(v)) {
15
+ if (Object.keys(v).length !== v.length)
16
+ return fail('Sparse or extended array');
17
+ return Array.from({ length: v.length }, (_, i) => {
18
+ const d = Object.getOwnPropertyDescriptor(v, String(i));
19
+ if (!d || !('value' in d))
20
+ return fail('Invalid array property');
21
+ return visit(d.value, depth + 1);
22
+ });
23
+ }
24
+ const proto = Object.getPrototypeOf(v);
25
+ if (proto !== Object.prototype && proto !== null)
26
+ return fail('Expected plain JSON object');
27
+ const entries = Object.entries(Object.getOwnPropertyDescriptors(v)).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
28
+ return Object.fromEntries(entries.map(([k, d]) => {
29
+ if (['__proto__', 'constructor', 'prototype'].includes(k) ||
30
+ !('value' in d) ||
31
+ !d.enumerable)
32
+ return fail('Unsafe JSON property');
33
+ return [k, visit(d.value, depth + 1)];
34
+ }));
35
+ };
36
+ const serialized = JSON.stringify(visit(value, 0));
37
+ if (Buffer.byteLength(serialized) > maxBytes)
38
+ return fail('JSON exceeds size limit');
39
+ return serialized;
40
+ }
41
+ /** Trusted route handler helper. Authorize each request BEFORE calling, including replay. Only DB effects on tx (or an outbox insert) are safe. */
42
+ export async function transactionalHttpOperation(store, ctx, request, execute) {
43
+ scope(ctx);
44
+ const operation = text(request.operation, 'operation', 200), key = text(request.key, 'key', 200), method = request.method.toUpperCase();
45
+ if (!['POST', 'PUT', 'PATCH', 'DELETE'].includes(method))
46
+ return fail('Unsupported mutation method');
47
+ if (!request.input || typeof request.input !== 'object' || Array.isArray(request.input))
48
+ return fail('Expected request object');
49
+ const raw = canonical(request.input), fingerprint = hash(raw), id = hash(JSON.stringify([ctx.actorId, operation, method, key]));
50
+ return atomic(store, ctx.tenantId, async (tx) => {
51
+ const profile = await tx.get(ctx.tenantId, 'tenant-profile', 'profile');
52
+ if (profile && profile.status !== 'active')
53
+ return fail('Tenant is not active', 'TENANT_FROZEN', 403);
54
+ const previous = await tx.get(ctx.tenantId, 'transactional-http', id);
55
+ if (previous) {
56
+ if (previous.fingerprint !== fingerprint)
57
+ return fail('Operation key conflict', 'CONFLICT', 409);
58
+ return { ...previous.result, replayed: true };
59
+ }
60
+ const result = await execute(tx);
61
+ integer(result.status, 'status', 200, 299);
62
+ const body = JSON.parse(canonical(result.body));
63
+ const saved = { status: result.status, body };
64
+ await tx.put(ctx.tenantId, 'transactional-http', {
65
+ id,
66
+ fingerprint,
67
+ result: saved,
68
+ createdAt: new Date().toISOString(),
69
+ });
70
+ return { ...saved, replayed: false };
71
+ });
72
+ }
73
+ const identifier = (s) => typeof s === 'string' && /^[A-Za-z0-9_.:-]{1,128}$/.test(s) && !s.startsWith('__sapling_');
74
+ /** Durable transactional consumer for trusted service identities. Handler must use supplied tx only; remote side effects use outbox. No wire ACK protocol. */
75
+ export class TransactionalEventConsumer {
76
+ store;
77
+ journal;
78
+ constructor(store, journal) {
79
+ this.store = store;
80
+ this.journal = journal;
81
+ }
82
+ async process(ctx, channel, consumer, handle, limit = 20) {
83
+ scope(ctx);
84
+ if (!identifier(ctx.tenantId) || !identifier(channel) || !identifier(consumer))
85
+ return fail('Invalid consumer scope');
86
+ integer(limit, 'limit', 1, 100);
87
+ const id = hash(JSON.stringify([consumer, channel])), topic = `${encodeURIComponent(ctx.tenantId)}/${encodeURIComponent(channel)}`, collection = 'realtime-consumer-cursors';
88
+ const snapshot = await this.store.get(ctx.tenantId, collection, id), cursor = snapshot?.cursor ?? '0';
89
+ const batch = await this.journal.read(topic, cursor, limit);
90
+ if (batch.gap)
91
+ return fail('Consumer cursor expired: explicit snapshot recovery required', 'REPLAY_GAP', 409);
92
+ if (!Array.isArray(batch.events) || batch.events.length > limit)
93
+ return fail('Invalid journal batch', 'INVALID_JOURNAL', 502);
94
+ let prev = cursor;
95
+ const seen = new Set();
96
+ for (const event of batch.events) {
97
+ if (!event ||
98
+ typeof event.id !== 'string' ||
99
+ !event.id ||
100
+ event.id === prev ||
101
+ seen.has(event.id) ||
102
+ event.tenantId !== ctx.tenantId ||
103
+ event.channel !== channel)
104
+ return fail('Invalid journal event', 'INVALID_JOURNAL', 502);
105
+ seen.add(event.id);
106
+ prev = event.id;
107
+ }
108
+ return atomic(this.store, ctx.tenantId, async (tx) => {
109
+ const profile = await tx.get(ctx.tenantId, 'tenant-profile', 'profile');
110
+ if (profile && profile.status !== 'active')
111
+ return fail('Tenant is not active', 'TENANT_FROZEN', 403);
112
+ const current = await tx.get(ctx.tenantId, collection, id);
113
+ if ((current?.cursor ?? '0') !== cursor)
114
+ return { processed: 0, cursor: current?.cursor ?? '0', contended: true };
115
+ for (const event of batch.events)
116
+ await handle(tx, event);
117
+ if (batch.events.length)
118
+ await tx.put(ctx.tenantId, collection, {
119
+ id,
120
+ consumer,
121
+ channel,
122
+ cursor: prev,
123
+ updatedAt: new Date().toISOString(),
124
+ });
125
+ return { processed: batch.events.length, cursor: prev, contended: false };
126
+ });
127
+ }
128
+ }
129
+ //# sourceMappingURL=transactional-processing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transactional-processing.js","sourceRoot":"","sources":["../src/transactional-processing.ts"],"names":[],"mappings":"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"}