@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.
- package/CHANGELOG.md +32 -0
- package/LICENSE +21 -0
- package/README.md +60 -2
- 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 +210 -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 +26 -0
- package/dist/primitives.js +119 -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 +90 -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 +125 -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 +201 -0
- package/dist/worker.js.map +1 -0
- package/package.json +34 -3
|
@@ -0,0 +1,358 @@
|
|
|
1
|
+
import { boundedResponseText } from './http.js';
|
|
2
|
+
import { atomic, fail, hash, integer, text } from './primitives.js';
|
|
3
|
+
import { randomUUID, createHmac, timingSafeEqual } from 'node:crypto';
|
|
4
|
+
import { SaplingError } from './types.js';
|
|
5
|
+
export class EventService {
|
|
6
|
+
listeners = new Map();
|
|
7
|
+
on(type, handler) {
|
|
8
|
+
const set = this.listeners.get(type) ?? new Set();
|
|
9
|
+
set.add(handler);
|
|
10
|
+
this.listeners.set(type, set);
|
|
11
|
+
return () => set.delete(handler);
|
|
12
|
+
}
|
|
13
|
+
async emit(ctx, type, data) {
|
|
14
|
+
const event = {
|
|
15
|
+
id: randomUUID(),
|
|
16
|
+
type,
|
|
17
|
+
tenantId: ctx.tenantId,
|
|
18
|
+
at: new Date().toISOString(),
|
|
19
|
+
data,
|
|
20
|
+
correlationId: ctx.correlationId,
|
|
21
|
+
};
|
|
22
|
+
for (const fn of [...(this.listeners.get(type) ?? []), ...(this.listeners.get('*') ?? [])])
|
|
23
|
+
await fn(event);
|
|
24
|
+
return event;
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
export class NotificationService {
|
|
28
|
+
provider;
|
|
29
|
+
audit;
|
|
30
|
+
constructor(provider, audit) {
|
|
31
|
+
this.provider = provider;
|
|
32
|
+
this.audit = audit;
|
|
33
|
+
}
|
|
34
|
+
async send(ctx, input) {
|
|
35
|
+
if (!this.provider)
|
|
36
|
+
throw new SaplingError('NOT_CONFIGURED', 'Notification provider required');
|
|
37
|
+
const result = await this.provider.send({ tenantId: ctx.tenantId, ...input });
|
|
38
|
+
await this.audit.record(ctx, 'notification.sent', 'notifications', result.id, {
|
|
39
|
+
channel: input.channel,
|
|
40
|
+
});
|
|
41
|
+
return result;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
export class PaymentService {
|
|
45
|
+
provider;
|
|
46
|
+
audit;
|
|
47
|
+
store;
|
|
48
|
+
access;
|
|
49
|
+
providerName;
|
|
50
|
+
constructor(provider, audit, store, access, providerName = provider?.name ?? 'custom') {
|
|
51
|
+
this.provider = provider;
|
|
52
|
+
this.audit = audit;
|
|
53
|
+
this.store = store;
|
|
54
|
+
this.access = access;
|
|
55
|
+
this.providerName = providerName;
|
|
56
|
+
}
|
|
57
|
+
async ready(ctx, permission) {
|
|
58
|
+
if (!ctx.tenantId ||
|
|
59
|
+
!ctx.actorId ||
|
|
60
|
+
ctx.impersonatorId ||
|
|
61
|
+
ctx.tenantId.startsWith('__sapling_'))
|
|
62
|
+
throw new SaplingError('FORBIDDEN', 'Verified non-impersonated tenant context required', 403);
|
|
63
|
+
await this.access?.requireService(ctx, permission);
|
|
64
|
+
if (this.store) {
|
|
65
|
+
const profile = await this.store.get(ctx.tenantId, 'tenant-profile', 'profile');
|
|
66
|
+
if (profile && ['offboarding', 'offboarded'].includes(String(profile.status)))
|
|
67
|
+
return fail('Tenant frozen', 'TENANT_FROZEN', 403);
|
|
68
|
+
}
|
|
69
|
+
if (!this.provider || !this.store)
|
|
70
|
+
throw new SaplingError('NOT_CONFIGURED', `${this.providerName} payment adapter and store required`, 503);
|
|
71
|
+
return { provider: this.provider, store: this.store };
|
|
72
|
+
}
|
|
73
|
+
async order(ctx, input, recover) {
|
|
74
|
+
const { provider, store } = await this.ready(ctx, 'payments:write');
|
|
75
|
+
integer(input.amountMinor, 'amount', 1);
|
|
76
|
+
if (!/^[A-Z]{3}$/.test(input.currency))
|
|
77
|
+
return fail('ISO currency required');
|
|
78
|
+
const idempotencyKey = text(input.idempotencyKey ?? input.reference, 'idempotencyKey', 200), key = hash(`order:${idempotencyKey}`);
|
|
79
|
+
text(input.reference, 'reference', 200);
|
|
80
|
+
const request = {
|
|
81
|
+
tenantId: ctx.tenantId,
|
|
82
|
+
amountMinor: input.amountMinor,
|
|
83
|
+
currency: input.currency,
|
|
84
|
+
reference: input.reference,
|
|
85
|
+
idempotencyKey,
|
|
86
|
+
};
|
|
87
|
+
const reservation = await atomic(store, ctx.tenantId, async (tx) => {
|
|
88
|
+
const old = await tx.get(ctx.tenantId, 'payment-requests', key);
|
|
89
|
+
if (old) {
|
|
90
|
+
if ((old.provider !== this.providerName &&
|
|
91
|
+
!(old.provider === undefined && this.providerName === 'razorpay')) ||
|
|
92
|
+
old.amountMinor !== input.amountMinor ||
|
|
93
|
+
old.currency !== input.currency ||
|
|
94
|
+
old.reference !== input.reference ||
|
|
95
|
+
old.invoiceId !== input.invoiceId)
|
|
96
|
+
return fail('Payment request key conflict', 'CONFLICT', 409);
|
|
97
|
+
if (old.result)
|
|
98
|
+
return { existing: old.result };
|
|
99
|
+
if (!recover)
|
|
100
|
+
return fail('Payment request outcome pending reconciliation', 'PAYMENT_PENDING', 409);
|
|
101
|
+
return {};
|
|
102
|
+
}
|
|
103
|
+
if (recover)
|
|
104
|
+
return fail('Payment request not found', 'NOT_FOUND', 404);
|
|
105
|
+
if (input.invoiceId) {
|
|
106
|
+
const invoice = await tx.get(ctx.tenantId, 'invoices', input.invoiceId);
|
|
107
|
+
if (!invoice ||
|
|
108
|
+
invoice.status !== 'open' ||
|
|
109
|
+
invoice.totalMinor !== input.amountMinor ||
|
|
110
|
+
invoice.currency !== input.currency)
|
|
111
|
+
return fail('Invoice does not match order', 'PAYMENT_MISMATCH', 409);
|
|
112
|
+
}
|
|
113
|
+
await tx.put(ctx.tenantId, 'payment-requests', {
|
|
114
|
+
id: key,
|
|
115
|
+
...input,
|
|
116
|
+
provider: this.providerName,
|
|
117
|
+
status: 'pending',
|
|
118
|
+
});
|
|
119
|
+
return {};
|
|
120
|
+
});
|
|
121
|
+
if (reservation.existing)
|
|
122
|
+
return reservation.existing;
|
|
123
|
+
const result = recover
|
|
124
|
+
? provider.recoverOrder
|
|
125
|
+
? await provider.recoverOrder(request)
|
|
126
|
+
: fail('Provider order recovery unavailable', 'PROVIDER_REQUIRED', 503)
|
|
127
|
+
: await provider.createOrder(request);
|
|
128
|
+
return atomic(store, ctx.tenantId, async (tx) => {
|
|
129
|
+
const old = await tx.get(ctx.tenantId, 'payment-requests', key);
|
|
130
|
+
if (old?.result) {
|
|
131
|
+
const previous = old.result;
|
|
132
|
+
if (previous.id !== result.id)
|
|
133
|
+
return fail('Provider returned conflicting order', 'CONFLICT', 409);
|
|
134
|
+
return previous;
|
|
135
|
+
}
|
|
136
|
+
const existing = await tx.get(ctx.tenantId, 'payment-orders', result.id);
|
|
137
|
+
if (existing)
|
|
138
|
+
return fail('Provider order already mapped', 'CONFLICT', 409);
|
|
139
|
+
await tx.put(ctx.tenantId, 'payment-orders', {
|
|
140
|
+
id: result.id,
|
|
141
|
+
provider: this.providerName,
|
|
142
|
+
amountMinor: input.amountMinor,
|
|
143
|
+
currency: input.currency,
|
|
144
|
+
reference: input.reference,
|
|
145
|
+
invoiceId: input.invoiceId,
|
|
146
|
+
status: result.status,
|
|
147
|
+
});
|
|
148
|
+
await tx.put(ctx.tenantId, 'payment-requests', {
|
|
149
|
+
id: key,
|
|
150
|
+
...input,
|
|
151
|
+
provider: this.providerName,
|
|
152
|
+
status: 'accepted',
|
|
153
|
+
result,
|
|
154
|
+
});
|
|
155
|
+
await this.audit.record(ctx, 'payment.order-created', 'payments', result.id, { amountMinor: input.amountMinor, currency: input.currency, provider: this.providerName }, tx);
|
|
156
|
+
return result;
|
|
157
|
+
});
|
|
158
|
+
}
|
|
159
|
+
createOrder(ctx, input) {
|
|
160
|
+
return this.order(ctx, input, false);
|
|
161
|
+
}
|
|
162
|
+
/** Read-only provider recovery; never blindly resubmit an ambiguous mutation. */
|
|
163
|
+
recoverOrder(ctx, input) {
|
|
164
|
+
return this.order(ctx, input, true);
|
|
165
|
+
}
|
|
166
|
+
async reconcilePayment(ctx, input) {
|
|
167
|
+
const { provider, store } = await this.ready(ctx, 'payments:reconcile');
|
|
168
|
+
if (!provider.reconcilePayment)
|
|
169
|
+
return fail('Provider payment reconciliation unavailable', 'PROVIDER_REQUIRED', 503);
|
|
170
|
+
return provider.reconcilePayment(store, ctx, text(input.orderId, 'order ID', 200), text(input.paymentId, 'payment ID', 200));
|
|
171
|
+
}
|
|
172
|
+
async refund(ctx, input) {
|
|
173
|
+
return this.processRefund(ctx, input, false);
|
|
174
|
+
}
|
|
175
|
+
async reconcileRefund(ctx, input) {
|
|
176
|
+
return this.processRefund(ctx, input, true);
|
|
177
|
+
}
|
|
178
|
+
async processRefund(ctx, input, recover) {
|
|
179
|
+
const { provider, store } = await this.ready(ctx, 'payments:refund');
|
|
180
|
+
const idempotencyKey = text(input.idempotencyKey, 'idempotencyKey', 200), key = hash(`refund:${idempotencyKey}`);
|
|
181
|
+
const reservation = await atomic(store, ctx.tenantId, async (tx) => {
|
|
182
|
+
const payment = await tx.get(ctx.tenantId, 'verified-payments', input.paymentId);
|
|
183
|
+
if (!payment ||
|
|
184
|
+
payment.status !== 'captured' ||
|
|
185
|
+
(payment.provider ?? 'razorpay') !== this.providerName)
|
|
186
|
+
return fail('Verified payment for selected provider required', 'PAYMENT_NOT_FOUND', 404);
|
|
187
|
+
const old = await tx.get(ctx.tenantId, 'refund-requests', key);
|
|
188
|
+
if (old) {
|
|
189
|
+
if ((old.provider ?? 'razorpay') !== this.providerName ||
|
|
190
|
+
old.paymentId !== input.paymentId ||
|
|
191
|
+
old.requestedAmount !== input.amountMinor)
|
|
192
|
+
return fail('Refund key conflict', 'CONFLICT', 409);
|
|
193
|
+
if (old.result && (!recover || old.reconciled === true))
|
|
194
|
+
return {
|
|
195
|
+
existing: old.result,
|
|
196
|
+
amountMinor: Number(old.amountMinor),
|
|
197
|
+
orderId: String(payment.orderId),
|
|
198
|
+
};
|
|
199
|
+
if (!recover)
|
|
200
|
+
return fail('Refund outcome pending reconciliation', 'PAYMENT_PENDING', 409);
|
|
201
|
+
return { amountMinor: Number(old.amountMinor), orderId: String(payment.orderId) };
|
|
202
|
+
}
|
|
203
|
+
if (recover)
|
|
204
|
+
return fail('Refund request not found', 'NOT_FOUND', 404);
|
|
205
|
+
const amount = integer(input.amountMinor ?? payment.amountMinor, 'amount', 1, Number(payment.amountMinor));
|
|
206
|
+
const reserved = Number(payment.refundReservedMinor ?? 0);
|
|
207
|
+
if (reserved + amount > Number(payment.amountMinor))
|
|
208
|
+
return fail('Refund exceeds remaining captured payment', 'CONFLICT', 409);
|
|
209
|
+
await tx.put(ctx.tenantId, 'verified-payments', {
|
|
210
|
+
...payment,
|
|
211
|
+
refundReservedMinor: reserved + amount,
|
|
212
|
+
});
|
|
213
|
+
await tx.put(ctx.tenantId, 'refund-requests', {
|
|
214
|
+
id: key,
|
|
215
|
+
provider: this.providerName,
|
|
216
|
+
paymentId: input.paymentId,
|
|
217
|
+
amountMinor: amount,
|
|
218
|
+
requestedAmount: input.amountMinor,
|
|
219
|
+
status: 'pending',
|
|
220
|
+
});
|
|
221
|
+
return { amountMinor: amount, orderId: String(payment.orderId) };
|
|
222
|
+
});
|
|
223
|
+
if (reservation.existing)
|
|
224
|
+
return reservation.existing;
|
|
225
|
+
const request = {
|
|
226
|
+
tenantId: ctx.tenantId,
|
|
227
|
+
paymentId: input.paymentId,
|
|
228
|
+
orderId: reservation.orderId,
|
|
229
|
+
amountMinor: reservation.amountMinor,
|
|
230
|
+
idempotencyKey,
|
|
231
|
+
};
|
|
232
|
+
const result = recover
|
|
233
|
+
? provider.recoverRefund
|
|
234
|
+
? await provider.recoverRefund(request)
|
|
235
|
+
: fail('Provider refund recovery unavailable', 'PROVIDER_REQUIRED', 503)
|
|
236
|
+
: await provider.refund(request);
|
|
237
|
+
return atomic(store, ctx.tenantId, async (tx) => {
|
|
238
|
+
const row = await tx.get(ctx.tenantId, 'refund-requests', key);
|
|
239
|
+
if (!row)
|
|
240
|
+
return fail('Refund reservation missing', 'CONFLICT', 409);
|
|
241
|
+
if (row.providerRefundId && row.providerRefundId !== result.id)
|
|
242
|
+
return fail('Refund reference conflict', 'CONFLICT', 409);
|
|
243
|
+
if (row.reconciled === true)
|
|
244
|
+
return row.result;
|
|
245
|
+
const terminal = ['cashfree', 'stripe'].includes(this.providerName) &&
|
|
246
|
+
['processed', 'failed'].includes(result.status);
|
|
247
|
+
if (terminal) {
|
|
248
|
+
const payment = await tx.get(ctx.tenantId, 'verified-payments', input.paymentId);
|
|
249
|
+
if (!payment)
|
|
250
|
+
return fail('Payment missing', 'CONFLICT', 409);
|
|
251
|
+
await tx.put(ctx.tenantId, 'verified-payments', {
|
|
252
|
+
...payment,
|
|
253
|
+
refundReservedMinor: result.status === 'failed'
|
|
254
|
+
? Number(payment.refundReservedMinor ?? 0) - reservation.amountMinor
|
|
255
|
+
: payment.refundReservedMinor,
|
|
256
|
+
refundedMinor: result.status === 'processed'
|
|
257
|
+
? Number(payment.refundedMinor ?? 0) + reservation.amountMinor
|
|
258
|
+
: Number(payment.refundedMinor ?? 0),
|
|
259
|
+
});
|
|
260
|
+
}
|
|
261
|
+
await tx.put(ctx.tenantId, 'refund-requests', {
|
|
262
|
+
...row,
|
|
263
|
+
status: result.status,
|
|
264
|
+
result,
|
|
265
|
+
providerRefundId: result.id,
|
|
266
|
+
reconciled: terminal,
|
|
267
|
+
});
|
|
268
|
+
await tx.put(ctx.tenantId, 'provider-refunds', {
|
|
269
|
+
id: result.id,
|
|
270
|
+
provider: this.providerName,
|
|
271
|
+
requestId: key,
|
|
272
|
+
paymentId: input.paymentId,
|
|
273
|
+
amountMinor: reservation.amountMinor,
|
|
274
|
+
status: result.status,
|
|
275
|
+
reconciled: terminal,
|
|
276
|
+
});
|
|
277
|
+
await this.audit.record(ctx, 'payment.refund-requested', 'payments', result.id, undefined, tx);
|
|
278
|
+
return result;
|
|
279
|
+
});
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
export class WebhookService {
|
|
283
|
+
/** Timestamp + payload are authenticated; callers must persist event IDs for durable replay protection. */
|
|
284
|
+
sign(payload, secret, timestampSeconds = Math.floor(Date.now() / 1000)) {
|
|
285
|
+
if (secret.length < 16)
|
|
286
|
+
throw new SaplingError('WEAK_WEBHOOK_SECRET', 'Webhook secret must be >=16 characters');
|
|
287
|
+
return {
|
|
288
|
+
timestamp: timestampSeconds,
|
|
289
|
+
signature: createHmac('sha256', secret)
|
|
290
|
+
.update(`${timestampSeconds}.${payload}`)
|
|
291
|
+
.digest('hex'),
|
|
292
|
+
};
|
|
293
|
+
}
|
|
294
|
+
verify(payload, secret, timestamp, signature, maxAgeSeconds = 300) {
|
|
295
|
+
if (!Number.isSafeInteger(timestamp) || Math.abs(Date.now() / 1000 - timestamp) > maxAgeSeconds)
|
|
296
|
+
return false;
|
|
297
|
+
if (!/^[a-f0-9]{64}$/i.test(signature))
|
|
298
|
+
return false;
|
|
299
|
+
const expected = this.sign(payload, secret, timestamp).signature;
|
|
300
|
+
return timingSafeEqual(Buffer.from(expected, 'hex'), Buffer.from(signature, 'hex'));
|
|
301
|
+
}
|
|
302
|
+
}
|
|
303
|
+
export class TelemetryService {
|
|
304
|
+
provider;
|
|
305
|
+
constructor(provider) {
|
|
306
|
+
this.provider = provider;
|
|
307
|
+
}
|
|
308
|
+
log(level, event, fields) {
|
|
309
|
+
return this.provider?.log({ level, event, at: new Date().toISOString(), fields });
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
export class S3StorageAdapterExample {
|
|
313
|
+
static guidance = 'Implement StorageAdapter using @aws-sdk/client-s3 commands; prefix object keys with tenant-scoped IDs, enforce IAM, SSE-KMS, and size controls.';
|
|
314
|
+
}
|
|
315
|
+
/** Razorpay: provider owns payment verification and idempotency; do not treat an order as paid. */
|
|
316
|
+
export class RazorpayAdapter {
|
|
317
|
+
keyId;
|
|
318
|
+
secret;
|
|
319
|
+
apiBase;
|
|
320
|
+
name = 'razorpay';
|
|
321
|
+
constructor(keyId, secret, apiBase = 'https://api.razorpay.com/v1') {
|
|
322
|
+
this.keyId = keyId;
|
|
323
|
+
this.secret = secret;
|
|
324
|
+
this.apiBase = apiBase;
|
|
325
|
+
const url = new URL(apiBase);
|
|
326
|
+
if (url.protocol !== 'https:' || url.username || url.password || url.search || url.hash)
|
|
327
|
+
throw Error('Fixed HTTPS Razorpay endpoint required');
|
|
328
|
+
}
|
|
329
|
+
async request(path, body) {
|
|
330
|
+
const header = 'Basic ' + Buffer.from(`${this.keyId}:${this.secret}`).toString('base64');
|
|
331
|
+
const response = await fetch(`${this.apiBase}${path}`, {
|
|
332
|
+
method: 'POST',
|
|
333
|
+
signal: AbortSignal.timeout(10000),
|
|
334
|
+
redirect: 'error',
|
|
335
|
+
headers: { authorization: header, 'content-type': 'application/json' },
|
|
336
|
+
body: JSON.stringify(body),
|
|
337
|
+
});
|
|
338
|
+
const data = JSON.parse(await boundedResponseText(response, 1000000));
|
|
339
|
+
if (!response.ok || !data.id)
|
|
340
|
+
throw new SaplingError('PAYMENT_PROVIDER_ERROR', 'Provider rejected request', 502);
|
|
341
|
+
return { id: data.id, status: data.status ?? 'created' };
|
|
342
|
+
}
|
|
343
|
+
async createOrder(input) {
|
|
344
|
+
return this.request('/orders', {
|
|
345
|
+
amount: input.amountMinor,
|
|
346
|
+
currency: input.currency,
|
|
347
|
+
receipt: input.reference,
|
|
348
|
+
notes: { tenantId: input.tenantId },
|
|
349
|
+
});
|
|
350
|
+
}
|
|
351
|
+
async refund(input) {
|
|
352
|
+
const payload = { notes: { tenantId: input.tenantId } };
|
|
353
|
+
if (input.amountMinor !== undefined)
|
|
354
|
+
payload.amount = input.amountMinor;
|
|
355
|
+
return this.request(`/payments/${encodeURIComponent(input.paymentId)}/refund`, payload);
|
|
356
|
+
}
|
|
357
|
+
}
|
|
358
|
+
//# sourceMappingURL=integrations.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../src/integrations.ts"],"names":[],"mappings":"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"}
|
package/dist/jobs.d.ts
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { ActorContext, Store, JsonRecord } from './types.js';
|
|
2
|
+
import { AuditService } from './audit.js';
|
|
3
|
+
export interface Job {
|
|
4
|
+
id: string;
|
|
5
|
+
type: string;
|
|
6
|
+
payload: JsonRecord;
|
|
7
|
+
status: 'queued' | 'running' | 'completed' | 'failed' | 'dead';
|
|
8
|
+
attempts: number;
|
|
9
|
+
maxAttempts: number;
|
|
10
|
+
dueAt: string;
|
|
11
|
+
lastError?: string;
|
|
12
|
+
createdAt: string;
|
|
13
|
+
}
|
|
14
|
+
export declare class JobService {
|
|
15
|
+
private store;
|
|
16
|
+
private audit;
|
|
17
|
+
private maxAttempts;
|
|
18
|
+
private handlers;
|
|
19
|
+
constructor(store: Store, audit: AuditService, maxAttempts: number);
|
|
20
|
+
register(type: string, handler: (ctx: ActorContext, payload: JsonRecord) => Promise<void>): void;
|
|
21
|
+
enqueue(ctx: ActorContext, type: string, payload: JsonRecord, options?: {
|
|
22
|
+
dueAt?: string;
|
|
23
|
+
maxAttempts?: number;
|
|
24
|
+
idempotencyKey?: string;
|
|
25
|
+
}): Promise<Job>;
|
|
26
|
+
/** Invoke explicitly from worker. Not an automatic durable distributed queue or lease mechanism. */
|
|
27
|
+
workNext(ctx: ActorContext): Promise<Job | undefined>;
|
|
28
|
+
list(ctx: ActorContext): Promise<Job[]>;
|
|
29
|
+
}
|
package/dist/jobs.js
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { SaplingError } from './types.js';
|
|
3
|
+
export class JobService {
|
|
4
|
+
store;
|
|
5
|
+
audit;
|
|
6
|
+
maxAttempts;
|
|
7
|
+
handlers = new Map();
|
|
8
|
+
constructor(store, audit, maxAttempts) {
|
|
9
|
+
this.store = store;
|
|
10
|
+
this.audit = audit;
|
|
11
|
+
this.maxAttempts = maxAttempts;
|
|
12
|
+
}
|
|
13
|
+
register(type, handler) {
|
|
14
|
+
this.handlers.set(type, handler);
|
|
15
|
+
}
|
|
16
|
+
async enqueue(ctx, type, payload, options = {}) {
|
|
17
|
+
if (!ctx.tenantId || !ctx.actorId)
|
|
18
|
+
throw new SaplingError('CONTEXT_REQUIRED', 'Verified context required');
|
|
19
|
+
const id = options.idempotencyKey ? `idem:${type}:${options.idempotencyKey}` : randomUUID();
|
|
20
|
+
const existing = await this.store.get(ctx.tenantId, 'jobs', id);
|
|
21
|
+
if (existing)
|
|
22
|
+
return existing;
|
|
23
|
+
const row = {
|
|
24
|
+
id,
|
|
25
|
+
type,
|
|
26
|
+
payload,
|
|
27
|
+
status: 'queued',
|
|
28
|
+
attempts: 0,
|
|
29
|
+
maxAttempts: options.maxAttempts ?? this.maxAttempts,
|
|
30
|
+
dueAt: options.dueAt ?? new Date().toISOString(),
|
|
31
|
+
createdAt: new Date().toISOString(),
|
|
32
|
+
};
|
|
33
|
+
if (row.maxAttempts < 1)
|
|
34
|
+
throw new SaplingError('BAD_RETRY', 'maxAttempts must be positive');
|
|
35
|
+
await this.store.put(ctx.tenantId, 'jobs', row);
|
|
36
|
+
await this.audit.record(ctx, 'job.enqueued', 'jobs', id, { type });
|
|
37
|
+
return row;
|
|
38
|
+
}
|
|
39
|
+
/** Invoke explicitly from worker. Not an automatic durable distributed queue or lease mechanism. */
|
|
40
|
+
async workNext(ctx) {
|
|
41
|
+
const jobs = await this.store.list(ctx.tenantId, 'jobs');
|
|
42
|
+
const row = jobs
|
|
43
|
+
.filter((j) => j.status === 'queued' && Date.parse(j.dueAt) <= Date.now())
|
|
44
|
+
.sort((a, b) => a.dueAt.localeCompare(b.dueAt))[0];
|
|
45
|
+
if (!row)
|
|
46
|
+
return undefined;
|
|
47
|
+
const handler = this.handlers.get(row.type);
|
|
48
|
+
const running = { ...row, attempts: row.attempts + 1, status: 'running' };
|
|
49
|
+
await this.store.put(ctx.tenantId, 'jobs', running);
|
|
50
|
+
try {
|
|
51
|
+
if (!handler)
|
|
52
|
+
throw new Error(`No handler registered for ${row.type}`);
|
|
53
|
+
await handler(ctx, row.payload);
|
|
54
|
+
const result = { ...running, status: 'completed' };
|
|
55
|
+
await this.store.put(ctx.tenantId, 'jobs', result);
|
|
56
|
+
await this.audit.record(ctx, 'job.completed', 'jobs', row.id);
|
|
57
|
+
return result;
|
|
58
|
+
}
|
|
59
|
+
catch (e) {
|
|
60
|
+
const attempts = running.attempts;
|
|
61
|
+
const status = attempts >= row.maxAttempts ? 'dead' : 'queued';
|
|
62
|
+
const next = {
|
|
63
|
+
...running,
|
|
64
|
+
status,
|
|
65
|
+
lastError: e instanceof Error ? e.message.slice(0, 200) : 'Unknown failure',
|
|
66
|
+
dueAt: new Date(Date.now() + Math.min(60000, 1000 * 2 ** attempts)).toISOString(),
|
|
67
|
+
};
|
|
68
|
+
await this.store.put(ctx.tenantId, 'jobs', next);
|
|
69
|
+
await this.audit.record(ctx, `job.${status}`, 'jobs', row.id);
|
|
70
|
+
return next;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
async list(ctx) {
|
|
74
|
+
return this.store.list(ctx.tenantId, 'jobs');
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=jobs.js.map
|
package/dist/jobs.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa1C,MAAM,OAAO,UAAU;IAGX;IACA;IACA;IAJF,QAAQ,GAAG,IAAI,GAAG,EAAqE,CAAC;IAChG,YACU,KAAY,EACZ,KAAmB,EACnB,WAAmB;QAFnB,UAAK,GAAL,KAAK,CAAO;QACZ,UAAK,GAAL,KAAK,CAAc;QACnB,gBAAW,GAAX,WAAW,CAAQ;IAC1B,CAAC;IACJ,QAAQ,CAAC,IAAY,EAAE,OAAkE;QACvF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,CAAC,OAAO,CACX,GAAiB,EACjB,IAAY,EACZ,OAAmB,EACnB,UAA6E,EAAE;QAE/E,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,OAAO;YAC/B,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,2BAA2B,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QAC5F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACrE,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,GAAG,GAAQ;YACf,EAAE;YACF,IAAI;YACJ,OAAO;YACP,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW;YACpD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAChD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,GAAG,CAAC,WAAW,GAAG,CAAC;YAAE,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;QAC7F,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,oGAAoG;IACpG,KAAK,CAAC,QAAQ,CAAC,GAAiB;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,IAAI;aACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;aACzE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAC;QACnF,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACvE,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,MAAM,GAAQ,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACxD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9D,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YAClC,MAAM,MAAM,GAAG,QAAQ,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/D,MAAM,IAAI,GAAQ;gBAChB,GAAG,OAAO;gBACV,MAAM;gBACN,SAAS,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB;gBAC3E,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE;aAClF,CAAC;YACF,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACjD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAiB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;CACF"}
|
package/dist/media.d.ts
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { FeatureAdapter, StorageAdapter } from './types.js';
|
|
2
|
+
import type { Store } from './types.js';
|
|
3
|
+
export interface ImageTransformer {
|
|
4
|
+
transform(input: Uint8Array, settings: {
|
|
5
|
+
width: number;
|
|
6
|
+
height: number;
|
|
7
|
+
format: 'webp' | 'png' | 'jpeg';
|
|
8
|
+
}): Promise<Uint8Array>;
|
|
9
|
+
}
|
|
10
|
+
export declare class MediaCapabilityAdapter implements FeatureAdapter {
|
|
11
|
+
private store;
|
|
12
|
+
private storage;
|
|
13
|
+
private processor;
|
|
14
|
+
private maxBytes;
|
|
15
|
+
private bulk;
|
|
16
|
+
constructor(store: Store, storage: StorageAdapter, processor: ImageTransformer, maxBytes?: number);
|
|
17
|
+
execute({ ctx, featureId, action, input }: Parameters<FeatureAdapter['execute']>[0]): Promise<unknown>;
|
|
18
|
+
}
|
package/dist/media.js
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { fail, hash, integer, text } from './primitives.js';
|
|
2
|
+
import { Bulkhead } from './reliability.js';
|
|
3
|
+
export class MediaCapabilityAdapter {
|
|
4
|
+
store;
|
|
5
|
+
storage;
|
|
6
|
+
processor;
|
|
7
|
+
maxBytes;
|
|
8
|
+
bulk = new Bulkhead(4);
|
|
9
|
+
constructor(store, storage, processor, maxBytes = 10 * 1024 * 1024) {
|
|
10
|
+
this.store = store;
|
|
11
|
+
this.storage = storage;
|
|
12
|
+
this.processor = processor;
|
|
13
|
+
this.maxBytes = maxBytes;
|
|
14
|
+
}
|
|
15
|
+
async execute({ ctx, featureId, action, input }) {
|
|
16
|
+
if (featureId !== 'SAAS-095')
|
|
17
|
+
return fail('Unsupported media operation');
|
|
18
|
+
if (action === 'status')
|
|
19
|
+
return this.store.get(ctx.tenantId, 'media-jobs', text(input.id));
|
|
20
|
+
if (action !== 'transform')
|
|
21
|
+
return fail('Unknown media action');
|
|
22
|
+
const source = text(input.key), width = integer(input.width, 'width', 1, 4096), height = integer(input.height, 'height', 1, 4096), format = text(input.format);
|
|
23
|
+
if (!['webp', 'png', 'jpeg'].includes(format))
|
|
24
|
+
return fail('Unsupported image format');
|
|
25
|
+
const src = await this.storage.get(ctx.tenantId, source);
|
|
26
|
+
if (!src || src.data.byteLength > this.maxBytes)
|
|
27
|
+
return fail('Invalid source image');
|
|
28
|
+
const id = hash(JSON.stringify([source, src.version, width, height, format]));
|
|
29
|
+
return this.bulk.run(async () => {
|
|
30
|
+
const old = await this.store.get(ctx.tenantId, 'media-jobs', id);
|
|
31
|
+
if (old)
|
|
32
|
+
return old;
|
|
33
|
+
const result = await this.processor.transform(src.data, {
|
|
34
|
+
width,
|
|
35
|
+
height,
|
|
36
|
+
format: format,
|
|
37
|
+
});
|
|
38
|
+
if (result.byteLength > this.maxBytes)
|
|
39
|
+
return fail('Output too large');
|
|
40
|
+
const key = `transformed/${id}.${format}`;
|
|
41
|
+
await this.storage.put(ctx.tenantId, key, result, { sourceVersion: src.version });
|
|
42
|
+
const row = { id, key, status: 'complete', bytes: result.byteLength };
|
|
43
|
+
await this.store.put(ctx.tenantId, 'media-jobs', row);
|
|
44
|
+
return row;
|
|
45
|
+
});
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=media.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"media.js","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { ActorContext, Store, JsonRecord } from './types.js';
|
|
2
|
+
import type { Row } from './primitives.js';
|
|
3
|
+
export declare const offboardingSteps: readonly ["freeze", "revoke", "export", "purge-external", "purge-records", "verify"];
|
|
4
|
+
export type OffboardingStep = (typeof offboardingSteps)[number];
|
|
5
|
+
export interface OffboardingSettings {
|
|
6
|
+
/** Trusted application callbacks must be idempotent, handle legal holds/retention, and return evidence IDs. */
|
|
7
|
+
deadlineMs?: number;
|
|
8
|
+
/** Trusted, current legal-hold decision. Any value other than false prevents destructive work. */
|
|
9
|
+
legalHold?: (ctx: ActorContext, signal: AbortSignal) => Promise<boolean>;
|
|
10
|
+
handlers: Record<OffboardingStep, (ctx: ActorContext, input: {
|
|
11
|
+
operationId: string;
|
|
12
|
+
signal?: AbortSignal;
|
|
13
|
+
}) => Promise<{
|
|
14
|
+
evidenceId: string;
|
|
15
|
+
}>>;
|
|
16
|
+
}
|
|
17
|
+
export declare class TenantOffboarding {
|
|
18
|
+
private store;
|
|
19
|
+
private settings?;
|
|
20
|
+
constructor(store: Store, settings?: OffboardingSettings | undefined);
|
|
21
|
+
request(ctx: ActorContext, input: JsonRecord): Promise<Row>;
|
|
22
|
+
approve(ctx: ActorContext): Promise<{
|
|
23
|
+
status: string;
|
|
24
|
+
approvedBy: string;
|
|
25
|
+
approvedAt: string;
|
|
26
|
+
id: string;
|
|
27
|
+
createdAt?: string;
|
|
28
|
+
updatedAt?: string;
|
|
29
|
+
}>;
|
|
30
|
+
status(ctx: ActorContext): Promise<Row>;
|
|
31
|
+
advance(ctx: ActorContext, signal?: AbortSignal): Promise<{
|
|
32
|
+
step: number;
|
|
33
|
+
status: string;
|
|
34
|
+
lease: null;
|
|
35
|
+
leaseUntil: number;
|
|
36
|
+
evidence: any[];
|
|
37
|
+
id: string;
|
|
38
|
+
createdAt?: string;
|
|
39
|
+
updatedAt?: string;
|
|
40
|
+
} | {
|
|
41
|
+
status: string;
|
|
42
|
+
}>;
|
|
43
|
+
}
|