@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,100 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { SaplingError } from './types.js';
3
+ function cleanKey(key) {
4
+ if (!key ||
5
+ key.length > 1024 ||
6
+ key.startsWith('/') ||
7
+ key.includes('\\') ||
8
+ key.split('/').some((s) => s === '..' || s === '.' || !s) ||
9
+ /[\x00-\x1f]/.test(key))
10
+ throw new SaplingError('BAD_OBJECT_KEY', 'Unsafe object key');
11
+ return key;
12
+ }
13
+ export class InMemoryStorage {
14
+ data = new Map();
15
+ key(tenant, key) {
16
+ return JSON.stringify([tenant, cleanKey(key)]);
17
+ }
18
+ async put(tenantId, key, data, metadata = {}) {
19
+ const version = randomUUID(), k = this.key(tenantId, key), versions = this.data.get(k) ?? [];
20
+ versions.push({ version, data: new Uint8Array(data), metadata: { ...metadata } });
21
+ this.data.set(k, versions);
22
+ return { key, version, size: data.byteLength };
23
+ }
24
+ async get(tenantId, key, version) {
25
+ const versions = this.data.get(this.key(tenantId, key)) ?? [];
26
+ const item = version ? versions.find((v) => v.version === version) : versions.at(-1);
27
+ return item
28
+ ? { version: item.version, data: new Uint8Array(item.data), metadata: { ...item.metadata } }
29
+ : undefined;
30
+ }
31
+ async list(tenantId, prefix = '') {
32
+ const result = [];
33
+ for (const [encoded, versions] of this.data) {
34
+ const [tenant, key] = JSON.parse(encoded);
35
+ if (tenant !== tenantId || !key.startsWith(prefix))
36
+ continue;
37
+ const latest = versions.at(-1);
38
+ if (latest)
39
+ result.push({ key, version: latest.version, size: latest.data.byteLength });
40
+ }
41
+ return result;
42
+ }
43
+ async delete(tenantId, key) {
44
+ this.data.delete(this.key(tenantId, key));
45
+ }
46
+ }
47
+ export class StorageService {
48
+ provider;
49
+ access;
50
+ audit;
51
+ maxBytes;
52
+ authorizeObject;
53
+ constructor(provider, access, audit, maxBytes, authorizeObject) {
54
+ this.provider = provider;
55
+ this.access = access;
56
+ this.audit = audit;
57
+ this.maxBytes = maxBytes;
58
+ this.authorizeObject = authorizeObject;
59
+ }
60
+ async requireObject(ctx, action, key) {
61
+ if (this.authorizeObject && !(await this.authorizeObject(ctx, action, key)))
62
+ throw new SaplingError('FORBIDDEN', 'Object access denied', 403);
63
+ }
64
+ async upload(ctx, input) {
65
+ await this.access.requireService(ctx, 'storage:write');
66
+ await this.requireObject(ctx, 'write', cleanKey(input.key));
67
+ if (input.data.byteLength > this.maxBytes)
68
+ throw new SaplingError('FILE_TOO_LARGE', 'Upload exceeds configured maximum', 413);
69
+ const result = await this.provider.put(ctx.tenantId, cleanKey(input.key), input.data, input.metadata);
70
+ await this.audit.record(ctx, 'storage.uploaded', 'storage', input.key, {
71
+ bytes: input.data.byteLength,
72
+ version: result.version,
73
+ });
74
+ return result;
75
+ }
76
+ async download(ctx, key, version) {
77
+ await this.access.requireService(ctx, 'storage:read');
78
+ await this.requireObject(ctx, 'read', cleanKey(key));
79
+ return this.provider.get(ctx.tenantId, cleanKey(key), version);
80
+ }
81
+ async list(ctx, prefix = '') {
82
+ await this.access.requireService(ctx, 'storage:read');
83
+ await this.requireObject(ctx, 'list', prefix);
84
+ const results = await this.provider.list(ctx.tenantId, prefix);
85
+ if (!this.authorizeObject)
86
+ return results;
87
+ const visible = [];
88
+ for (const item of results)
89
+ if (await this.authorizeObject(ctx, 'read', item.key))
90
+ visible.push(item);
91
+ return visible;
92
+ }
93
+ async delete(ctx, key) {
94
+ await this.access.requireService(ctx, 'storage:delete');
95
+ await this.requireObject(ctx, 'delete', cleanKey(key));
96
+ await this.provider.delete(ctx.tenantId, cleanKey(key));
97
+ await this.audit.record(ctx, 'storage.deleted', 'storage', key);
98
+ }
99
+ }
100
+ //# sourceMappingURL=storage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { Store } from './types.js';
2
+ /** Volatile, per-process reference store. Never deploy it as a distributed production database. */
3
+ export declare class InMemoryStore implements Store {
4
+ private data;
5
+ health(): Promise<void>;
6
+ private tail;
7
+ transaction<T>(tenantId: string, work: (tx: Store) => Promise<T>): Promise<T>;
8
+ page<T>(t: string, c: string, limit: number, after?: string): Promise<{
9
+ items: (T & {
10
+ id: string;
11
+ })[];
12
+ next: string | undefined;
13
+ }>;
14
+ private key;
15
+ put<T extends {
16
+ id: string;
17
+ }>(tenantId: string, collection: string, record: T): Promise<void>;
18
+ get<T>(tenantId: string, collection: string, id: string): Promise<T | undefined>;
19
+ list<T>(tenantId: string, collection: string): Promise<T[]>;
20
+ delete(tenantId: string, collection: string, id: string): Promise<boolean>;
21
+ }
package/dist/store.js ADDED
@@ -0,0 +1,110 @@
1
+ import { SaplingError } from './types.js';
2
+ /** Volatile, per-process reference store. Never deploy it as a distributed production database. */
3
+ export class InMemoryStore {
4
+ data = new Map();
5
+ async health() { }
6
+ tail = new Map();
7
+ async transaction(tenantId, work) {
8
+ const previous = this.tail.get(tenantId) ?? Promise.resolve();
9
+ let release;
10
+ const gate = new Promise((r) => {
11
+ release = r;
12
+ });
13
+ const tail = previous.then(() => gate);
14
+ this.tail.set(tenantId, tail);
15
+ await previous;
16
+ const prefix = JSON.stringify([tenantId]).slice(0, -1) + ',';
17
+ // Stage all writes; outside readers never observe uncommitted state. Direct writes
18
+ // serialize on the same tenant lock. Nested transactions share the outer transaction.
19
+ const staged = new Map([...this.data].filter(([k]) => k.startsWith(prefix)));
20
+ let active = true;
21
+ const guard = (tenant) => {
22
+ if (!active)
23
+ throw new SaplingError('TRANSACTION_CLOSED', 'Transaction is closed', 409);
24
+ if (tenant !== tenantId)
25
+ throw new SaplingError('INVALID_SCOPE', 'Cross-tenant transaction access', 403);
26
+ };
27
+ const lookup = async (t, c, id) => {
28
+ guard(t);
29
+ const value = staged.get(this.key(t, c, id));
30
+ return value === undefined ? undefined : structuredClone(value);
31
+ };
32
+ const list = async (t, c) => {
33
+ guard(t);
34
+ const p = JSON.stringify([t, c]).slice(0, -1) + ',';
35
+ return [...staged].filter(([k]) => k.startsWith(p)).map(([, v]) => structuredClone(v));
36
+ };
37
+ const tx = {
38
+ transaction: async (t, fn) => {
39
+ guard(t);
40
+ return fn(tx);
41
+ },
42
+ put: async (t, c, r) => {
43
+ guard(t);
44
+ const k = this.key(t, c, r.id);
45
+ if (c === 'audit' && staged.has(k))
46
+ throw new SaplingError('CONFLICT', 'Audit is append-only', 409);
47
+ staged.set(k, structuredClone(r));
48
+ },
49
+ get: lookup,
50
+ list,
51
+ delete: async (t, c, id) => {
52
+ guard(t);
53
+ if (c === 'audit')
54
+ throw new SaplingError('FORBIDDEN', 'Audit is append-only', 403);
55
+ return staged.delete(this.key(t, c, id));
56
+ },
57
+ page: async (t, c, l, a) => {
58
+ const rows = (await list(t, c))
59
+ .sort((x, y) => (x.id < y.id ? -1 : x.id > y.id ? 1 : 0))
60
+ .filter((x) => !a || x.id > a)
61
+ .slice(0, l + 1);
62
+ return { items: rows.slice(0, l), next: rows.length > l ? rows[l - 1].id : undefined };
63
+ },
64
+ };
65
+ try {
66
+ const result = await work(tx);
67
+ for (const k of this.data.keys())
68
+ if (k.startsWith(prefix))
69
+ this.data.delete(k);
70
+ for (const [k, v] of staged)
71
+ this.data.set(k, v);
72
+ return result;
73
+ }
74
+ finally {
75
+ active = false;
76
+ release();
77
+ if (this.tail.get(tenantId) === tail)
78
+ this.tail.delete(tenantId);
79
+ }
80
+ }
81
+ async page(t, c, limit, after) {
82
+ const all = (await this.list(t, c))
83
+ .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0))
84
+ .filter((x) => !after || x.id > after)
85
+ .slice(0, limit + 1);
86
+ return { items: all.slice(0, limit), next: all.length > limit ? all[limit - 1].id : undefined };
87
+ }
88
+ key(t, c, id) {
89
+ if (!t?.trim() || !c?.trim() || !id?.trim())
90
+ throw new SaplingError('INVALID_SCOPE', 'Nonempty tenant, collection and id required');
91
+ return JSON.stringify([t, c, id]);
92
+ }
93
+ async put(tenantId, collection, record) {
94
+ return this.transaction(tenantId, (tx) => tx.put(tenantId, collection, record));
95
+ }
96
+ async get(tenantId, collection, id) {
97
+ const value = this.data.get(this.key(tenantId, collection, id));
98
+ return value === undefined ? undefined : structuredClone(value);
99
+ }
100
+ async list(tenantId, collection) {
101
+ const prefix = JSON.stringify([tenantId, collection]).slice(0, -1) + ',';
102
+ return Array.from(this.data.entries())
103
+ .filter(([k]) => k.startsWith(prefix))
104
+ .map(([, v]) => structuredClone(v));
105
+ }
106
+ async delete(tenantId, collection, id) {
107
+ return this.transaction(tenantId, (tx) => tx.delete(tenantId, collection, id));
108
+ }
109
+ }
110
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { PaymentAdapter, PaymentOrderInput, PaymentRefundInput, PaymentResult, Store, ActorContext } from './types.js';
2
+ /** Basic Stripe PaymentIntent checkout. Recurring gateway and tokenized methods remain separate. */
3
+ export declare class StripePaymentAdapter implements PaymentAdapter {
4
+ private secret;
5
+ readonly name = "stripe";
6
+ constructor(secret: string);
7
+ private post;
8
+ createOrder(i: PaymentOrderInput): Promise<PaymentResult>;
9
+ refund(i: PaymentRefundInput): Promise<PaymentResult>;
10
+ private refundStatus;
11
+ private get;
12
+ reconcilePayment(store: Store, ctx: ActorContext, orderId: string, paymentId: string): Promise<{
13
+ processed: boolean;
14
+ duplicate: boolean;
15
+ paymentId: string;
16
+ } | {
17
+ processed: boolean;
18
+ paymentId: string;
19
+ duplicate?: undefined;
20
+ }>;
21
+ }
@@ -0,0 +1,132 @@
1
+ import { atomic, fail, hash, integer, object, text } from './primitives.js';
2
+ import { boundedResponseText } from './http.js';
3
+ /** Basic Stripe PaymentIntent checkout. Recurring gateway and tokenized methods remain separate. */
4
+ export class StripePaymentAdapter {
5
+ secret;
6
+ name = 'stripe';
7
+ constructor(secret) {
8
+ this.secret = secret;
9
+ text(secret, 'Stripe secret', 500);
10
+ }
11
+ async post(path, fields, key) {
12
+ const r = await fetch('https://api.stripe.com/v1' + path, {
13
+ method: 'POST',
14
+ headers: {
15
+ authorization: `Bearer ${this.secret}`,
16
+ 'content-type': 'application/x-www-form-urlencoded',
17
+ 'idempotency-key': key,
18
+ },
19
+ body: new URLSearchParams(fields),
20
+ redirect: 'error',
21
+ signal: AbortSignal.timeout(10000),
22
+ });
23
+ const raw = await boundedResponseText(r, 1000000);
24
+ if (!r.ok)
25
+ return fail(`Stripe HTTP ${r.status}`, 'PAYMENT_PROVIDER_ERROR', 502);
26
+ return object(JSON.parse(raw));
27
+ }
28
+ async createOrder(i) {
29
+ integer(i.amountMinor, 'amount', 1);
30
+ if (!/^[A-Z]{3}$/.test(i.currency))
31
+ return fail('Invalid currency');
32
+ const id = hash(JSON.stringify(['stripe-order', i.tenantId, i.idempotencyKey ?? i.reference]));
33
+ const r = await this.post('/payment_intents', {
34
+ amount: String(i.amountMinor),
35
+ currency: i.currency.toLowerCase(),
36
+ 'automatic_payment_methods[enabled]': 'true',
37
+ 'metadata[sapling_order]': id,
38
+ }, id);
39
+ if (r.amount !== i.amountMinor ||
40
+ r.currency !== i.currency.toLowerCase() ||
41
+ object(r.metadata).sapling_order !== id)
42
+ return fail('Stripe order mismatch', 'PAYMENT_MISMATCH', 409);
43
+ return {
44
+ id: text(r.id),
45
+ status: text(r.status),
46
+ provider: 'stripe',
47
+ clientSecret: text(r.client_secret, 'client secret', 4096),
48
+ };
49
+ }
50
+ async refund(i) {
51
+ const key = hash(JSON.stringify(['stripe-refund', i.tenantId, text(i.idempotencyKey)]));
52
+ const paymentIntent = text(i.orderId ?? i.paymentId);
53
+ if (!/^pi_[A-Za-z0-9]+$/.test(paymentIntent))
54
+ return fail('Verified Stripe PaymentIntent required');
55
+ const r = await this.post('/refunds', { payment_intent: paymentIntent, amount: String(integer(i.amountMinor, 'refund amount', 1)) }, key);
56
+ if (r.payment_intent !== paymentIntent || r.amount !== i.amountMinor)
57
+ return fail('Stripe refund mismatch', 'PAYMENT_MISMATCH', 409);
58
+ return { id: text(r.id), status: this.refundStatus(r.status), provider: 'stripe' };
59
+ }
60
+ refundStatus(status) {
61
+ return status === 'succeeded'
62
+ ? 'processed'
63
+ : status === 'failed' || status === 'canceled'
64
+ ? 'failed'
65
+ : 'pending';
66
+ }
67
+ async get(path) {
68
+ const r = await fetch('https://api.stripe.com/v1' + path, {
69
+ headers: { authorization: `Bearer ${this.secret}` },
70
+ redirect: 'error',
71
+ signal: AbortSignal.timeout(10000),
72
+ });
73
+ const raw = await boundedResponseText(r, 1000000);
74
+ if (!r.ok)
75
+ return fail(`Stripe HTTP ${r.status}`, 'PAYMENT_PROVIDER_ERROR', 502);
76
+ return object(JSON.parse(raw));
77
+ }
78
+ async reconcilePayment(store, ctx, orderId, paymentId) {
79
+ if (orderId !== paymentId || !/^pi_[A-Za-z0-9]+$/.test(orderId))
80
+ return fail('Stripe payment intent ID required');
81
+ const order = await store.get(ctx.tenantId, 'payment-orders', orderId);
82
+ if (!order || order.provider !== 'stripe')
83
+ return fail('Stripe tenant order not found', 'PAYMENT_MISMATCH', 409);
84
+ const p = await this.get('/payment_intents/' + orderId);
85
+ if (p.id !== orderId ||
86
+ p.status !== 'succeeded' ||
87
+ p.amount_received !== order.amountMinor ||
88
+ p.currency !== String(order.currency).toLowerCase())
89
+ return fail('Stripe payment mismatch', 'PAYMENT_MISMATCH', 409);
90
+ return atomic(store, ctx.tenantId, async (tx) => {
91
+ const o = await tx.get(ctx.tenantId, 'payment-orders', orderId);
92
+ if (!o ||
93
+ o.provider !== 'stripe' ||
94
+ o.amountMinor !== order.amountMinor ||
95
+ o.currency !== order.currency ||
96
+ o.invoiceId !== order.invoiceId ||
97
+ (o.paymentId && o.paymentId !== paymentId))
98
+ return fail('Stripe order changed', 'PAYMENT_MISMATCH', 409);
99
+ const old = await tx.get(ctx.tenantId, 'verified-payments', paymentId);
100
+ if (old) {
101
+ if (old.provider !== 'stripe' || old.orderId !== orderId)
102
+ return fail('Payment conflict', 'CONFLICT', 409);
103
+ return { processed: false, duplicate: true, paymentId };
104
+ }
105
+ if (o.invoiceId) {
106
+ const invoice = await tx.get(ctx.tenantId, 'invoices', String(o.invoiceId));
107
+ if (!invoice ||
108
+ invoice.status !== 'open' ||
109
+ invoice.totalMinor !== o.amountMinor ||
110
+ invoice.currency !== o.currency)
111
+ return fail('Invoice mismatch', 'PAYMENT_MISMATCH', 409);
112
+ await tx.put(ctx.tenantId, 'invoices', {
113
+ ...invoice,
114
+ status: 'paid',
115
+ paymentId,
116
+ paidAt: new Date().toISOString(),
117
+ });
118
+ }
119
+ await tx.put(ctx.tenantId, 'verified-payments', {
120
+ id: paymentId,
121
+ provider: 'stripe',
122
+ orderId,
123
+ status: 'captured',
124
+ amountMinor: o.amountMinor,
125
+ currency: o.currency,
126
+ });
127
+ await tx.put(ctx.tenantId, 'payment-orders', { ...o, status: 'captured', paymentId });
128
+ return { processed: true, paymentId };
129
+ });
130
+ }
131
+ }
132
+ //# sourceMappingURL=stripe-payment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stripe-payment.js","sourceRoot":"","sources":["../src/stripe-payment.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ import type { RecurringGateway } from './recurring.js';
2
+ import type { Store } from './types.js';
3
+ export interface StripeCustomerMandate {
4
+ customer: string;
5
+ paymentMethod: string;
6
+ offSessionApproved: boolean;
7
+ }
8
+ type Charge = Parameters<RecurringGateway['charge']>[0];
9
+ /** Fixed Stripe account and trusted mandate resolver. No card data is accepted. Never blindly recreate an ambiguous PaymentIntent. */
10
+ export declare class StripeRecurringGateway implements RecurringGateway {
11
+ private store;
12
+ private token;
13
+ private mandate;
14
+ private bulkhead;
15
+ constructor(store: Store, token: () => Promise<string>, mandate: (tenantId: string, customerId: string) => Promise<StripeCustomerMandate>);
16
+ private request;
17
+ private fingerprint;
18
+ private mapping;
19
+ private verify;
20
+ private persist;
21
+ charge(req: Charge): Promise<{
22
+ status: "pending";
23
+ reference: string;
24
+ } | {
25
+ status: "paid";
26
+ reference: string;
27
+ } | {
28
+ status: "declined";
29
+ reference: string;
30
+ } | {
31
+ status: "requires_action";
32
+ reference: string;
33
+ }>;
34
+ /** Trusted reconciliation only, after provider-side discovery; verify amount/customer/metadata before binding. */
35
+ recover(req: Charge, providerIntentId: string): Promise<{
36
+ reference: string;
37
+ }>;
38
+ }
39
+ /** 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. */
40
+ export declare class StripeRecurringWebhook {
41
+ private store;
42
+ private secret;
43
+ private toleranceSeconds;
44
+ constructor(store: Store, secret: string, toleranceSeconds?: number);
45
+ receive(tenant: string, raw: string, header: string, at?: number): Promise<{
46
+ processed: boolean;
47
+ duplicate: boolean;
48
+ woken?: undefined;
49
+ } | {
50
+ processed: boolean;
51
+ woken: boolean;
52
+ duplicate?: undefined;
53
+ } | {
54
+ processed: boolean;
55
+ reason: string;
56
+ }>;
57
+ }
58
+ export {};