@saplings/sdk 0.0.0-stage → 0.17.2

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 +32 -0
  2. package/LICENSE +21 -0
  3. package/README.md +60 -2
  4. package/dist/access.d.ts +3 -0
  5. package/dist/access.js +3 -0
  6. package/dist/access.js.map +1 -0
  7. package/dist/accounts.d.ts +3 -0
  8. package/dist/accounts.js +3 -0
  9. package/dist/accounts.js.map +1 -0
  10. package/dist/analytics.d.ts +45 -0
  11. package/dist/analytics.js +129 -0
  12. package/dist/analytics.js.map +1 -0
  13. package/dist/audit.d.ts +21 -0
  14. package/dist/audit.js +36 -0
  15. package/dist/audit.js.map +1 -0
  16. package/dist/automation.d.ts +49 -0
  17. package/dist/automation.js +210 -0
  18. package/dist/automation.js.map +1 -0
  19. package/dist/billing-policy.d.ts +15 -0
  20. package/dist/billing-policy.js +17 -0
  21. package/dist/billing-policy.js.map +1 -0
  22. package/dist/billing.d.ts +53 -0
  23. package/dist/billing.js +118 -0
  24. package/dist/billing.js.map +1 -0
  25. package/dist/business-workflows.d.ts +39 -0
  26. package/dist/business-workflows.js +137 -0
  27. package/dist/business-workflows.js.map +1 -0
  28. package/dist/capabilities.d.ts +49 -0
  29. package/dist/capabilities.js +78 -0
  30. package/dist/capabilities.js.map +1 -0
  31. package/dist/cashfree.d.ts +71 -0
  32. package/dist/cashfree.js +241 -0
  33. package/dist/cashfree.js.map +1 -0
  34. package/dist/commerce.d.ts +21 -0
  35. package/dist/commerce.js +198 -0
  36. package/dist/commerce.js.map +1 -0
  37. package/dist/config.d.ts +4 -0
  38. package/dist/config.js +177 -0
  39. package/dist/config.js.map +1 -0
  40. package/dist/control-plane.d.ts +129 -0
  41. package/dist/control-plane.js +314 -0
  42. package/dist/control-plane.js.map +1 -0
  43. package/dist/data.d.ts +58 -0
  44. package/dist/data.js +214 -0
  45. package/dist/data.js.map +1 -0
  46. package/dist/domain-policy.d.ts +36 -0
  47. package/dist/domain-policy.js +114 -0
  48. package/dist/domain-policy.js.map +1 -0
  49. package/dist/feature-types.d.ts +187 -0
  50. package/dist/feature-types.js +2 -0
  51. package/dist/feature-types.js.map +1 -0
  52. package/dist/federation.d.ts +66 -0
  53. package/dist/federation.js +162 -0
  54. package/dist/federation.js.map +1 -0
  55. package/dist/flags.d.ts +27 -0
  56. package/dist/flags.js +52 -0
  57. package/dist/flags.js.map +1 -0
  58. package/dist/governance.d.ts +45 -0
  59. package/dist/governance.js +128 -0
  60. package/dist/governance.js.map +1 -0
  61. package/dist/http-idempotency.d.ts +22 -0
  62. package/dist/http-idempotency.js +42 -0
  63. package/dist/http-idempotency.js.map +1 -0
  64. package/dist/http.d.ts +2 -0
  65. package/dist/http.js +28 -0
  66. package/dist/http.js.map +1 -0
  67. package/dist/identity.d.ts +3 -0
  68. package/dist/identity.js +3 -0
  69. package/dist/identity.js.map +1 -0
  70. package/dist/impersonation.d.ts +2 -0
  71. package/dist/impersonation.js +3 -0
  72. package/dist/impersonation.js.map +1 -0
  73. package/dist/index.d.ts +210 -0
  74. package/dist/index.js +519 -0
  75. package/dist/index.js.map +1 -0
  76. package/dist/integrations.d.ts +114 -0
  77. package/dist/integrations.js +358 -0
  78. package/dist/integrations.js.map +1 -0
  79. package/dist/jobs.d.ts +29 -0
  80. package/dist/jobs.js +77 -0
  81. package/dist/jobs.js.map +1 -0
  82. package/dist/media.d.ts +18 -0
  83. package/dist/media.js +48 -0
  84. package/dist/media.js.map +1 -0
  85. package/dist/offboarding.d.ts +43 -0
  86. package/dist/offboarding.js +140 -0
  87. package/dist/offboarding.js.map +1 -0
  88. package/dist/operations.d.ts +105 -0
  89. package/dist/operations.js +286 -0
  90. package/dist/operations.js.map +1 -0
  91. package/dist/primitives.d.ts +26 -0
  92. package/dist/primitives.js +119 -0
  93. package/dist/primitives.js.map +1 -0
  94. package/dist/provider-operations.d.ts +43 -0
  95. package/dist/provider-operations.js +143 -0
  96. package/dist/provider-operations.js.map +1 -0
  97. package/dist/provider-workflow.d.ts +33 -0
  98. package/dist/provider-workflow.js +111 -0
  99. package/dist/provider-workflow.js.map +1 -0
  100. package/dist/providers.d.ts +42 -0
  101. package/dist/providers.js +168 -0
  102. package/dist/providers.js.map +1 -0
  103. package/dist/quality-config.d.ts +50 -0
  104. package/dist/quality-config.js +2 -0
  105. package/dist/quality-config.js.map +1 -0
  106. package/dist/razorpay-webhook.d.ts +38 -0
  107. package/dist/razorpay-webhook.js +106 -0
  108. package/dist/razorpay-webhook.js.map +1 -0
  109. package/dist/recurring.d.ts +53 -0
  110. package/dist/recurring.js +241 -0
  111. package/dist/recurring.js.map +1 -0
  112. package/dist/registry.d.ts +58 -0
  113. package/dist/registry.js +839 -0
  114. package/dist/registry.js.map +1 -0
  115. package/dist/reliability.d.ts +45 -0
  116. package/dist/reliability.js +147 -0
  117. package/dist/reliability.js.map +1 -0
  118. package/dist/resources.d.ts +19 -0
  119. package/dist/resources.js +90 -0
  120. package/dist/resources.js.map +1 -0
  121. package/dist/security-state.d.ts +14 -0
  122. package/dist/security-state.js +39 -0
  123. package/dist/security-state.js.map +1 -0
  124. package/dist/storage.d.ts +54 -0
  125. package/dist/storage.js +100 -0
  126. package/dist/storage.js.map +1 -0
  127. package/dist/store.d.ts +21 -0
  128. package/dist/store.js +110 -0
  129. package/dist/store.js.map +1 -0
  130. package/dist/stripe-payment.d.ts +21 -0
  131. package/dist/stripe-payment.js +132 -0
  132. package/dist/stripe-payment.js.map +1 -0
  133. package/dist/stripe-recurring.d.ts +58 -0
  134. package/dist/stripe-recurring.js +226 -0
  135. package/dist/stripe-recurring.js.map +1 -0
  136. package/dist/totp.d.ts +2 -0
  137. package/dist/totp.js +3 -0
  138. package/dist/totp.js.map +1 -0
  139. package/dist/transactional-processing.d.ts +27 -0
  140. package/dist/transactional-processing.js +125 -0
  141. package/dist/transactional-processing.js.map +1 -0
  142. package/dist/types.d.ts +367 -0
  143. package/dist/types.js +2 -0
  144. package/dist/types.js.map +1 -0
  145. package/dist/valkey.d.ts +18 -0
  146. package/dist/valkey.js +22 -0
  147. package/dist/valkey.js.map +1 -0
  148. package/dist/worker.d.ts +28 -0
  149. package/dist/worker.js +201 -0
  150. package/dist/worker.js.map +1 -0
  151. package/package.json +34 -3
@@ -0,0 +1,168 @@
1
+ import { SaplingError } from './types.js';
2
+ import { Bulkhead, CircuitBreaker, timeout } from './reliability.js';
3
+ import { fail, object, strings, text } from './primitives.js';
4
+ import { boundedResponseText } from './http.js';
5
+ /** Adapter for an existing trusted Sapling service. Endpoint is deployment configuration, never client input. */
6
+ export class HttpCapabilityAdapter {
7
+ serviceToken;
8
+ allowedActions;
9
+ timeoutMs;
10
+ bulkhead = new Bulkhead(32);
11
+ breaker = new CircuitBreaker();
12
+ url;
13
+ constructor(baseUrl, serviceToken, allowedActions, timeoutMs = 8000) {
14
+ this.serviceToken = serviceToken;
15
+ this.allowedActions = allowedActions;
16
+ this.timeoutMs = timeoutMs;
17
+ this.url = new URL(baseUrl);
18
+ if (this.url.protocol !== 'https:' ||
19
+ this.url.username ||
20
+ this.url.password ||
21
+ this.url.search ||
22
+ this.url.hash)
23
+ throw new Error('Provider must use a fixed HTTPS service URL');
24
+ }
25
+ async execute(request) {
26
+ if (!Object.hasOwn(this.allowedActions, request.featureId) ||
27
+ !this.allowedActions[request.featureId].includes(request.action))
28
+ return fail('Provider action not allowed', 'FORBIDDEN', 403);
29
+ return this.bulkhead.run(() => this.breaker.run(() => timeout(async (signal) => {
30
+ const token = await this.serviceToken();
31
+ if (signal.aborted)
32
+ throw Error('Provider deadline');
33
+ const endpoint = new URL(this.url.href.replace(/\/$/, '') +
34
+ '/capabilities/' +
35
+ encodeURIComponent(request.featureId) +
36
+ '/' +
37
+ encodeURIComponent(request.action));
38
+ const res = await fetch(endpoint, {
39
+ method: 'POST',
40
+ redirect: 'error',
41
+ signal,
42
+ headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
43
+ body: JSON.stringify({
44
+ context: {
45
+ tenantId: request.ctx.tenantId,
46
+ actorId: request.ctx.actorId,
47
+ correlationId: request.ctx.correlationId,
48
+ },
49
+ input: request.input,
50
+ }),
51
+ });
52
+ if (!res.ok) {
53
+ await res.body?.cancel();
54
+ throw new SaplingError('PROVIDER_FAILED', `Provider returned ${res.status}`, 502);
55
+ }
56
+ const reader = res.body?.getReader();
57
+ if (!reader)
58
+ return null;
59
+ const parts = [];
60
+ let size = 0;
61
+ while (true) {
62
+ const r = await reader.read();
63
+ if (r.done)
64
+ break;
65
+ size += r.value.length;
66
+ if (size > 2_000_000) {
67
+ await reader.cancel();
68
+ return fail('Provider response too large', 'PROVIDER_FAILED', 502);
69
+ }
70
+ parts.push(r.value);
71
+ }
72
+ return JSON.parse(Buffer.concat(parts).toString('utf8'));
73
+ }, this.timeoutMs)));
74
+ }
75
+ }
76
+ /** Pinned issuer/audience and JWKS URL, RS256 only; no untrusted jku or algorithm negotiation. */
77
+ export class JwksAuthenticationAdapter {
78
+ options;
79
+ keys = new Map();
80
+ expires = 0;
81
+ loadedAt = 0;
82
+ refresh;
83
+ url;
84
+ constructor(options) {
85
+ this.options = options;
86
+ this.url = new URL(options.jwksUrl);
87
+ if (this.url.protocol !== 'https:' || this.url.username || this.url.password || this.url.hash)
88
+ throw new Error('JWKS endpoint must use fixed HTTPS URL');
89
+ }
90
+ async load() {
91
+ if (this.refresh)
92
+ return this.refresh;
93
+ this.refresh = (async () => {
94
+ const r = await fetch(this.url, { redirect: 'error', signal: AbortSignal.timeout(5000) });
95
+ if (!r.ok)
96
+ throw new Error('JWKS unavailable');
97
+ const body = await boundedResponseText(r, 1_000_000);
98
+ const jwks = JSON.parse(body);
99
+ if (!Array.isArray(jwks.keys) || jwks.keys.length > 100)
100
+ throw new Error('Invalid JWKS');
101
+ const keys = new Map();
102
+ for (const jwk of jwks.keys) {
103
+ if (!jwk.kid ||
104
+ jwk.kty !== 'RSA' ||
105
+ (jwk.alg && jwk.alg !== 'RS256') ||
106
+ (jwk.use && jwk.use !== 'sig'))
107
+ continue;
108
+ const key = await crypto.subtle.importKey('jwk', jwk, { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' }, false, ['verify']);
109
+ if (key.algorithm.modulusLength < 2048)
110
+ continue;
111
+ if (keys.has(jwk.kid))
112
+ throw new Error('Duplicate key ID');
113
+ keys.set(jwk.kid, key);
114
+ }
115
+ this.keys = keys;
116
+ this.loadedAt = Date.now();
117
+ this.expires = this.loadedAt + 300000;
118
+ })();
119
+ try {
120
+ await this.refresh;
121
+ }
122
+ finally {
123
+ this.refresh = undefined;
124
+ }
125
+ }
126
+ async verifyAccessToken(token) {
127
+ try {
128
+ if (token.length > 16384 || !/^[-\w]+\.[-\w]+\.[-\w]+$/.test(token))
129
+ return;
130
+ const [h, p, s] = token.split('.');
131
+ const header = object(JSON.parse(Buffer.from(h, 'base64url').toString('utf8'))), claims = object(JSON.parse(Buffer.from(p, 'base64url').toString('utf8')));
132
+ if (header.alg !== 'RS256' ||
133
+ header.crit !== undefined ||
134
+ typeof header.kid !== 'string' ||
135
+ header.kid.length > 200)
136
+ return;
137
+ const now = Date.now() / 1000;
138
+ if (claims.iss !== this.options.issuer ||
139
+ !(claims.aud === this.options.audience ||
140
+ (Array.isArray(claims.aud) && claims.aud.includes(this.options.audience))) ||
141
+ typeof claims.exp !== 'number' ||
142
+ claims.exp <= now ||
143
+ (claims.nbf !== undefined && (typeof claims.nbf !== 'number' || claims.nbf > now + 30)))
144
+ return;
145
+ if (Date.now() > this.expires)
146
+ await this.load();
147
+ if (!this.keys.has(header.kid) && Date.now() - this.loadedAt > 30000)
148
+ await this.load();
149
+ const key = this.keys.get(header.kid);
150
+ if (!key ||
151
+ !(await crypto.subtle.verify('RSASSA-PKCS1-v1_5', key, Buffer.from(s, 'base64url'), new TextEncoder().encode(h + '.' + p))))
152
+ return;
153
+ const tenantId = text(claims[this.options.tenantClaim ?? 'tenant_id'], 'tenant', 200);
154
+ if (tenantId.startsWith('__sapling_'))
155
+ return;
156
+ return {
157
+ tenantId,
158
+ userId: text(claims.sub, 'subject', 200),
159
+ roles: strings(claims[this.options.rolesClaim ?? 'roles'] ?? []),
160
+ permissions: strings(claims[this.options.permissionsClaim ?? 'permissions'] ?? []),
161
+ };
162
+ }
163
+ catch {
164
+ return undefined;
165
+ }
166
+ }
167
+ }
168
+ //# sourceMappingURL=providers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /** Development-only settings. No quality runner is imported by the SDK runtime. */
2
+ export type QualityCategory = 'performance' | 'load' | 'stress' | 'spike' | 'soak' | 'scalability' | 'security' | 'concurrency' | 'resilience' | 'recovery' | 'observability' | 'contract' | 'chaos' | 'disaster-recovery' | 'kubernetes';
3
+ export type QualityEngine = 'native' | 'k6' | 'autocannon' | 'toxiproxy' | 'zap' | 'schemathesis' | 'testcontainers' | 'chaos-mesh' | 'kubectl' | 'vitest' | 'node-test';
4
+ export interface QualityThresholds {
5
+ maxP95Ms?: number;
6
+ maxP99Ms?: number;
7
+ maxErrorRate?: number;
8
+ minRequestsPerSecond?: number;
9
+ }
10
+ export interface QualityProbe {
11
+ path: string;
12
+ statuses?: number[];
13
+ headers?: Record<string, string>;
14
+ }
15
+ export interface QualitySuiteConfig {
16
+ id: string;
17
+ category: QualityCategory;
18
+ engine: QualityEngine;
19
+ enabled?: boolean;
20
+ target?: string;
21
+ probes?: QualityProbe[];
22
+ concurrency?: number;
23
+ requests?: number;
24
+ durationSeconds?: number;
25
+ stages?: {
26
+ concurrency: number;
27
+ seconds: number;
28
+ }[];
29
+ thresholds?: QualityThresholds;
30
+ timeoutMs?: number;
31
+ script?: string;
32
+ namespace?: string;
33
+ deployment?: string;
34
+ manifest?: string;
35
+ replicas?: number;
36
+ disrupts?: boolean;
37
+ }
38
+ export interface BackendQualityConfig {
39
+ enabled?: boolean;
40
+ environment: 'local' | 'staging';
41
+ allowedOrigins: string[];
42
+ targets: Record<string, string>;
43
+ allowedNamespaces?: string[];
44
+ allowedDeployments?: string[];
45
+ suites: QualitySuiteConfig[];
46
+ outputDir?: string;
47
+ maxConcurrency?: number;
48
+ maxDurationSeconds?: number;
49
+ allowDisruptive?: boolean;
50
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=quality-config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quality-config.js","sourceRoot":"","sources":["../src/quality-config.ts"],"names":[],"mappings":""}
@@ -0,0 +1,38 @@
1
+ import type { FeatureAdapter, Store } from './types.js';
2
+ /** Invoke with original raw body and a server-resolved tenant. Never trust tenant IDs from callback input. */
3
+ export declare class RazorpayWebhookAdapter implements FeatureAdapter {
4
+ private store;
5
+ private webhookSecret;
6
+ constructor(store: Store, webhookSecret: string);
7
+ execute(request: Parameters<FeatureAdapter['execute']>[0]): Promise<{
8
+ processed: boolean;
9
+ duplicate: boolean;
10
+ paymentId?: undefined;
11
+ refundId?: undefined;
12
+ status?: undefined;
13
+ reason?: undefined;
14
+ } | {
15
+ processed: boolean;
16
+ paymentId: string;
17
+ duplicate?: undefined;
18
+ refundId?: undefined;
19
+ status?: undefined;
20
+ reason?: undefined;
21
+ } | {
22
+ processed: boolean;
23
+ refundId: string;
24
+ status: string;
25
+ duplicate?: undefined;
26
+ paymentId?: undefined;
27
+ reason?: undefined;
28
+ } | {
29
+ processed: boolean;
30
+ reason: string;
31
+ duplicate?: undefined;
32
+ paymentId?: undefined;
33
+ refundId?: undefined;
34
+ status?: undefined;
35
+ } | {
36
+ valid: boolean;
37
+ }>;
38
+ }
@@ -0,0 +1,106 @@
1
+ import { timingSafeEqual } from 'node:crypto';
2
+ import { atomic, fail, hash, object, sign, text } from './primitives.js';
3
+ /** Invoke with original raw body and a server-resolved tenant. Never trust tenant IDs from callback input. */
4
+ export class RazorpayWebhookAdapter {
5
+ store;
6
+ webhookSecret;
7
+ constructor(store, webhookSecret) {
8
+ this.store = store;
9
+ this.webhookSecret = webhookSecret;
10
+ if (webhookSecret.length < 16)
11
+ throw new Error('Webhook secret too short');
12
+ }
13
+ async execute(request) {
14
+ if (request.featureId !== 'SAAS-050' || !['verify', 'reconcile'].includes(request.action))
15
+ return fail('Unsupported action');
16
+ const raw = text(request.input.rawBody, 'rawBody', 1000000), signature = text(request.input.signature, 'signature', 64);
17
+ if (!/^[a-f0-9]{64}$/i.test(signature) ||
18
+ !timingSafeEqual(Buffer.from(signature, 'hex'), Buffer.from(sign(raw, this.webhookSecret), 'hex')))
19
+ return fail('Invalid webhook signature', 'UNAUTHENTICATED', 401);
20
+ if (request.action === 'verify')
21
+ return { valid: true };
22
+ const event = object(JSON.parse(raw)), type = String(event.event), tenant = request.ctx.tenantId, eventId = hash(raw);
23
+ return atomic(this.store, tenant, async (tx) => {
24
+ if (await tx.get(tenant, 'payment-webhook-inbox', eventId))
25
+ return { processed: false, duplicate: true };
26
+ if (type === 'payment.captured') {
27
+ const payment = object(object(object(event.payload).payment).entity), orderId = text(payment.order_id), paymentId = text(payment.id);
28
+ const order = await tx.get(tenant, 'payment-orders', orderId);
29
+ if (!order ||
30
+ (order.provider ?? 'razorpay') !== 'razorpay' ||
31
+ order.amountMinor !== payment.amount ||
32
+ order.currency !== payment.currency ||
33
+ payment.status !== 'captured' ||
34
+ (order.paymentId && order.paymentId !== paymentId))
35
+ return fail('Order not matched to tenant and amount', 'PAYMENT_MISMATCH', 409);
36
+ const old = await tx.get(tenant, 'verified-payments', paymentId);
37
+ if (old && old.orderId !== orderId)
38
+ return fail('Payment conflict', 'CONFLICT', 409);
39
+ if (order.invoiceId) {
40
+ const invoice = await tx.get(tenant, 'invoices', String(order.invoiceId));
41
+ if (!invoice ||
42
+ invoice.currency !== payment.currency ||
43
+ invoice.totalMinor !== payment.amount ||
44
+ (invoice.status !== 'open' && invoice.paymentId !== paymentId))
45
+ return fail('Invoice mismatch', 'PAYMENT_MISMATCH', 409);
46
+ await tx.put(tenant, 'invoices', {
47
+ ...invoice,
48
+ status: 'paid',
49
+ paymentId,
50
+ paidAt: new Date().toISOString(),
51
+ });
52
+ }
53
+ await tx.put(tenant, 'verified-payments', {
54
+ ...old,
55
+ id: paymentId,
56
+ provider: 'razorpay',
57
+ orderId,
58
+ amountMinor: payment.amount,
59
+ currency: payment.currency,
60
+ status: 'captured',
61
+ });
62
+ await tx.put(tenant, 'payment-orders', { ...order, status: 'captured', paymentId });
63
+ await tx.put(tenant, 'payment-webhook-inbox', { id: eventId, event: type });
64
+ return { processed: true, paymentId };
65
+ }
66
+ if (['refund.processed', 'refund.failed'].includes(type)) {
67
+ const refund = object(object(object(event.payload).refund).entity), refundId = text(refund.id), paymentId = text(refund.payment_id);
68
+ const r = await tx.get(tenant, 'provider-refunds', refundId), payment = await tx.get(tenant, 'verified-payments', paymentId);
69
+ if (!r ||
70
+ !payment ||
71
+ (payment.provider ?? 'razorpay') !== 'razorpay' ||
72
+ (r.provider ?? 'razorpay') !== 'razorpay' ||
73
+ r.paymentId !== paymentId ||
74
+ r.amountMinor !== refund.amount)
75
+ return fail('Refund not matched', 'PAYMENT_MISMATCH', 409);
76
+ const state = type === 'refund.processed' ? 'processed' : 'failed';
77
+ if (r.reconciled === true) {
78
+ if (r.status !== state)
79
+ return fail('Conflicting terminal refund state', 'CONFLICT', 409);
80
+ return { processed: false, duplicate: true };
81
+ }
82
+ await tx.put(tenant, 'provider-refunds', { ...r, status: state, reconciled: true });
83
+ const req = await tx.get(tenant, 'refund-requests', String(r.requestId));
84
+ if (req)
85
+ await tx.put(tenant, 'refund-requests', {
86
+ ...req,
87
+ status: state,
88
+ result: { id: refundId, status: state },
89
+ });
90
+ await tx.put(tenant, 'verified-payments', {
91
+ ...payment,
92
+ refundReservedMinor: state === 'failed'
93
+ ? Math.max(0, Number(payment.refundReservedMinor ?? 0) - Number(r.amountMinor))
94
+ : payment.refundReservedMinor,
95
+ refundedMinor: state === 'processed'
96
+ ? Number(payment.refundedMinor ?? 0) + Number(r.amountMinor)
97
+ : Number(payment.refundedMinor ?? 0),
98
+ });
99
+ await tx.put(tenant, 'payment-webhook-inbox', { id: eventId, event: type });
100
+ return { processed: true, refundId, status: state };
101
+ }
102
+ return { processed: false, reason: 'unsupported-event' };
103
+ });
104
+ }
105
+ }
106
+ //# sourceMappingURL=razorpay-webhook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"razorpay-webhook.js","sourceRoot":"","sources":["../src/razorpay-webhook.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import type { ActorContext, Store, JsonRecord } from './types.js';
2
+ import type { Row } from './primitives.js';
3
+ /** Provider must support idempotent charge attempts and return verified terminal outcomes only. */
4
+ export interface RecurringGateway {
5
+ charge(request: {
6
+ tenantId: string;
7
+ customerId: string;
8
+ invoiceId: string;
9
+ amountMinor: number;
10
+ currency: string;
11
+ idempotencyKey: string;
12
+ signal?: AbortSignal;
13
+ }): Promise<{
14
+ status: 'paid' | 'declined' | 'pending' | 'requires_action';
15
+ reference: string;
16
+ }>;
17
+ }
18
+ export interface RecurringSettings {
19
+ gateway?: RecurringGateway;
20
+ retryDays?: number[];
21
+ }
22
+ /** Fixed-day billing intervals, not calendar-month proration. All amounts are integer minor units. */
23
+ export declare class RecurringBilling {
24
+ private store;
25
+ private settings;
26
+ private delays;
27
+ constructor(store: Store, settings?: RecurringSettings);
28
+ schedule(ctx: ActorContext, input: JsonRecord): Promise<Row>;
29
+ /** Create at most one invoice for a schedule period; repeated scheduler calls do not duplicate invoices. */
30
+ issueDue(ctx: ActorContext, id: unknown, at?: number): Promise<Row | {
31
+ status: string;
32
+ }>;
33
+ /** Only a verified paid outcome closes the invoice; ambiguous outcomes reuse the same idempotency key. */
34
+ chargeDue(ctx: ActorContext, invoiceId: unknown, signal?: AbortSignal): Promise<{
35
+ status: string;
36
+ reference: string;
37
+ } | {
38
+ status: string;
39
+ }>;
40
+ /** Trusted billing service: request polling of an existing customer-action attempt, never create a new charge. */
41
+ resume(ctx: ActorContext, invoiceId: unknown): Promise<{
42
+ status: string;
43
+ }>;
44
+ /** Bounded scheduler page; caller persists/rotates cursors and repeats. No network inside store transaction. */
45
+ sweep(ctx: ActorContext, input?: JsonRecord, signal?: AbortSignal): Promise<{
46
+ issued: number;
47
+ charged: number;
48
+ errors: number;
49
+ scheduleAfter: string | undefined;
50
+ attemptAfter: string | undefined;
51
+ }>;
52
+ cancel(ctx: ActorContext, id: unknown): Promise<Row>;
53
+ }