@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,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 @@
|
|
|
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
|
+
}
|