@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,111 @@
|
|
|
1
|
+
import { randomUUID, createHash, createHmac } from 'node:crypto';
|
|
2
|
+
import { SaplingError } from './types.js';
|
|
3
|
+
export const now = () => new Date().toISOString();
|
|
4
|
+
export const fail = (message, code = 'INVALID_INPUT', status = 400) => {
|
|
5
|
+
throw new SaplingError(code, message, status);
|
|
6
|
+
};
|
|
7
|
+
export function text(x, name = 'value', max = 4096) {
|
|
8
|
+
if (typeof x !== 'string' || !x.trim() || x.length > max)
|
|
9
|
+
return fail(`${name} must be a nonempty string (max ${max})`);
|
|
10
|
+
return x;
|
|
11
|
+
}
|
|
12
|
+
export function integer(x, name = 'value', min = 0, max = Number.MAX_SAFE_INTEGER) {
|
|
13
|
+
if (typeof x !== 'number' || !Number.isSafeInteger(x) || x < min || x > max)
|
|
14
|
+
return fail(`${name} must be an integer from ${min} to ${max}`);
|
|
15
|
+
return x;
|
|
16
|
+
}
|
|
17
|
+
export function object(x) {
|
|
18
|
+
if (!x || typeof x !== 'object' || Array.isArray(x))
|
|
19
|
+
return fail('Expected an object');
|
|
20
|
+
let nodes = 0;
|
|
21
|
+
const visit = (v, depth) => {
|
|
22
|
+
if (++nodes > 50000 || depth > 32)
|
|
23
|
+
return fail('Object exceeds structural limits');
|
|
24
|
+
if (!v || typeof v !== 'object')
|
|
25
|
+
return;
|
|
26
|
+
if (Array.isArray(v)) {
|
|
27
|
+
for (const item of v)
|
|
28
|
+
visit(item, depth + 1);
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
const proto = Object.getPrototypeOf(v);
|
|
32
|
+
if (proto !== Object.prototype && proto !== null)
|
|
33
|
+
return fail('Expected plain JSON object');
|
|
34
|
+
for (const [k, d] of Object.entries(Object.getOwnPropertyDescriptors(v))) {
|
|
35
|
+
if (['__proto__', 'constructor', 'prototype'].includes(k) || !('value' in d))
|
|
36
|
+
return fail('Unsafe object property');
|
|
37
|
+
visit(d.value, depth + 1);
|
|
38
|
+
}
|
|
39
|
+
};
|
|
40
|
+
visit(x, 0);
|
|
41
|
+
return x;
|
|
42
|
+
}
|
|
43
|
+
export function strings(x) {
|
|
44
|
+
if (!Array.isArray(x) || x.length > 1000)
|
|
45
|
+
return fail('Expected a bounded string array');
|
|
46
|
+
return x.map((s) => text(s));
|
|
47
|
+
}
|
|
48
|
+
export function scope(ctx) {
|
|
49
|
+
text(ctx.tenantId, 'tenantId', 200);
|
|
50
|
+
text(ctx.actorId, 'actorId', 200);
|
|
51
|
+
if (ctx.tenantId.startsWith('__sapling_'))
|
|
52
|
+
fail('Reserved tenant namespace', 'FORBIDDEN', 403);
|
|
53
|
+
}
|
|
54
|
+
export function hash(s) {
|
|
55
|
+
return createHash('sha256').update(s).digest('hex');
|
|
56
|
+
}
|
|
57
|
+
export async function atomic(store, tenant, fn) {
|
|
58
|
+
if (!store.transaction)
|
|
59
|
+
return fail('Transactional store required', 'TRANSACTION_REQUIRED', 503);
|
|
60
|
+
return store.transaction(tenant, fn);
|
|
61
|
+
}
|
|
62
|
+
export async function read(store, ctx, collection, id) {
|
|
63
|
+
const row = await store.get(ctx.tenantId, collection, text(id, 'id', 200));
|
|
64
|
+
return row ?? fail('Resource not found', 'NOT_FOUND', 404);
|
|
65
|
+
}
|
|
66
|
+
export async function insert(store, ctx, collection, data, id = randomUUID()) {
|
|
67
|
+
scope(ctx);
|
|
68
|
+
const row = { ...data, id, createdAt: now(), updatedAt: now() };
|
|
69
|
+
await store.put(ctx.tenantId, collection, row);
|
|
70
|
+
return row;
|
|
71
|
+
}
|
|
72
|
+
export async function update(store, ctx, collection, id, changes) {
|
|
73
|
+
return atomic(store, ctx.tenantId, async (tx) => {
|
|
74
|
+
const old = await read(tx, ctx, collection, id);
|
|
75
|
+
const row = { ...old, ...changes, id: old.id, createdAt: old.createdAt, updatedAt: now() };
|
|
76
|
+
await tx.put(ctx.tenantId, collection, row);
|
|
77
|
+
return row;
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
export async function page(store, ctx, collection, input = {}) {
|
|
81
|
+
const limit = integer(input.limit ?? 50, 'limit', 1, 500);
|
|
82
|
+
const after = input.after === undefined ? undefined : text(input.after, 'after');
|
|
83
|
+
if (store.page)
|
|
84
|
+
return store.page(ctx.tenantId, collection, limit, after);
|
|
85
|
+
const rows = (await store.list(ctx.tenantId, collection))
|
|
86
|
+
.sort((a, b) => a.id.localeCompare(b.id))
|
|
87
|
+
.filter((r) => !after || r.id > after)
|
|
88
|
+
.slice(0, limit + 1);
|
|
89
|
+
return {
|
|
90
|
+
items: rows.slice(0, limit),
|
|
91
|
+
next: rows.length > limit ? rows[limit - 1].id : undefined,
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
export function redact(value, depth = 0) {
|
|
95
|
+
if (depth > 12)
|
|
96
|
+
return '[TRUNCATED]';
|
|
97
|
+
if (Array.isArray(value))
|
|
98
|
+
return value.slice(0, 1000).map((v) => redact(v, depth + 1));
|
|
99
|
+
if (value && typeof value === 'object')
|
|
100
|
+
return Object.fromEntries(Object.entries(value).map(([k, v]) => [
|
|
101
|
+
k,
|
|
102
|
+
/password|secret|token|authorization|cookie|api.?key|card.?number|digest/i.test(k)
|
|
103
|
+
? '[REDACTED]'
|
|
104
|
+
: redact(v, depth + 1),
|
|
105
|
+
]));
|
|
106
|
+
return value;
|
|
107
|
+
}
|
|
108
|
+
export function sign(payload, key) {
|
|
109
|
+
return createHmac('sha256', key).update(payload).digest('hex');
|
|
110
|
+
}
|
|
111
|
+
//# sourceMappingURL=primitives.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { ActorContext, JsonRecord, Store } from './types.js';
|
|
2
|
+
export type ProviderState = 'submitting' | 'accepted' | 'running' | 'succeeded' | 'failed' | 'unknown';
|
|
3
|
+
export interface ProviderObservation {
|
|
4
|
+
state: Exclude<ProviderState, 'submitting'>;
|
|
5
|
+
reference?: string;
|
|
6
|
+
}
|
|
7
|
+
export interface OperationDriver {
|
|
8
|
+
submit(ctx: ActorContext, operationId: string, input: JsonRecord, signal: AbortSignal): Promise<ProviderObservation>;
|
|
9
|
+
inspect(ctx: ActorContext, operationId: string, reference: string | undefined, signal: AbortSignal): Promise<ProviderObservation>;
|
|
10
|
+
}
|
|
11
|
+
/** Trusted service API. Call after operation-specific authorization; no generic public router. Unknown submissions are never automatically redispatched. */
|
|
12
|
+
export declare class ProviderOperations {
|
|
13
|
+
private store;
|
|
14
|
+
private drivers;
|
|
15
|
+
private deadlineMs;
|
|
16
|
+
private authorize?;
|
|
17
|
+
constructor(store: Store, drivers: Record<string, OperationDriver>, deadlineMs?: number, authorize?: ((ctx: ActorContext, kind: string, action: "submit" | "read" | "reconcile") => Promise<void>) | undefined);
|
|
18
|
+
private driver;
|
|
19
|
+
private owned;
|
|
20
|
+
private view;
|
|
21
|
+
get(ctx: ActorContext, id: string): Promise<{
|
|
22
|
+
id: string;
|
|
23
|
+
kind: string;
|
|
24
|
+
state: ProviderState;
|
|
25
|
+
reference: string | undefined;
|
|
26
|
+
updatedAt: string;
|
|
27
|
+
}>;
|
|
28
|
+
submit(ctx: ActorContext, kind: string, key: string, input: JsonRecord): Promise<{
|
|
29
|
+
id: string;
|
|
30
|
+
kind: string;
|
|
31
|
+
state: ProviderState;
|
|
32
|
+
reference: string | undefined;
|
|
33
|
+
updatedAt: string;
|
|
34
|
+
}>;
|
|
35
|
+
private settle;
|
|
36
|
+
reconcile(ctx: ActorContext, id: string): Promise<{
|
|
37
|
+
id: string;
|
|
38
|
+
kind: string;
|
|
39
|
+
state: ProviderState;
|
|
40
|
+
reference: string | undefined;
|
|
41
|
+
updatedAt: string;
|
|
42
|
+
}>;
|
|
43
|
+
}
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { atomic, fail, hash, object, text, scope } from './primitives.js';
|
|
3
|
+
import { timeout } from './reliability.js';
|
|
4
|
+
const collection = 'provider-operations';
|
|
5
|
+
const canonical = (v) => Array.isArray(v)
|
|
6
|
+
? v.map(canonical)
|
|
7
|
+
: v && typeof v === 'object'
|
|
8
|
+
? Object.fromEntries(Object.entries(v)
|
|
9
|
+
.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
|
|
10
|
+
.map(([k, x]) => [k, canonical(x)]))
|
|
11
|
+
: v;
|
|
12
|
+
/** Trusted service API. Call after operation-specific authorization; no generic public router. Unknown submissions are never automatically redispatched. */
|
|
13
|
+
export class ProviderOperations {
|
|
14
|
+
store;
|
|
15
|
+
drivers;
|
|
16
|
+
deadlineMs;
|
|
17
|
+
authorize;
|
|
18
|
+
constructor(store, drivers, deadlineMs = 15000, authorize) {
|
|
19
|
+
this.store = store;
|
|
20
|
+
this.drivers = drivers;
|
|
21
|
+
this.deadlineMs = deadlineMs;
|
|
22
|
+
this.authorize = authorize;
|
|
23
|
+
if (!Number.isSafeInteger(deadlineMs) || deadlineMs < 10 || deadlineMs > 120000)
|
|
24
|
+
throw Error('Invalid provider deadline');
|
|
25
|
+
}
|
|
26
|
+
driver(kind) {
|
|
27
|
+
if (!Object.hasOwn(this.drivers, kind))
|
|
28
|
+
return fail('Provider operation not configured', 'PROVIDER_REQUIRED', 503);
|
|
29
|
+
return this.drivers[kind];
|
|
30
|
+
}
|
|
31
|
+
async owned(ctx, id) {
|
|
32
|
+
scope(ctx);
|
|
33
|
+
const row = await this.store.get(ctx.tenantId, collection, id);
|
|
34
|
+
if (!row || row.actorId !== ctx.actorId)
|
|
35
|
+
return fail('Operation not found', 'NOT_FOUND', 404);
|
|
36
|
+
return row;
|
|
37
|
+
}
|
|
38
|
+
view(row) {
|
|
39
|
+
return {
|
|
40
|
+
id: row.id,
|
|
41
|
+
kind: row.kind,
|
|
42
|
+
state: row.state,
|
|
43
|
+
reference: row.reference,
|
|
44
|
+
updatedAt: row.updatedAt,
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
async get(ctx, id) {
|
|
48
|
+
const row = await this.owned(ctx, id);
|
|
49
|
+
await this.authorize?.(ctx, row.kind, 'read');
|
|
50
|
+
return this.view(row);
|
|
51
|
+
}
|
|
52
|
+
async submit(ctx, kind, key, input) {
|
|
53
|
+
scope(ctx);
|
|
54
|
+
await this.authorize?.(ctx, kind, 'submit');
|
|
55
|
+
const driver = this.driver(kind);
|
|
56
|
+
text(key, 'operation key', 200);
|
|
57
|
+
const payload = JSON.stringify(canonical(object(input)));
|
|
58
|
+
if (Buffer.byteLength(payload) > 1000000)
|
|
59
|
+
return fail('Operation payload too large');
|
|
60
|
+
const fingerprint = hash(payload), id = hash(JSON.stringify([ctx.tenantId, ctx.actorId, kind, key])), lease = randomUUID();
|
|
61
|
+
const claim = await atomic(this.store, ctx.tenantId, async (tx) => {
|
|
62
|
+
const old = await tx.get(ctx.tenantId, collection, id);
|
|
63
|
+
if (old) {
|
|
64
|
+
if (old.fingerprint !== fingerprint)
|
|
65
|
+
return fail('Operation key conflict', 'CONFLICT', 409);
|
|
66
|
+
return { row: old, claimed: false };
|
|
67
|
+
}
|
|
68
|
+
const row = {
|
|
69
|
+
id,
|
|
70
|
+
kind,
|
|
71
|
+
actorId: ctx.actorId,
|
|
72
|
+
fingerprint,
|
|
73
|
+
state: 'submitting',
|
|
74
|
+
lease,
|
|
75
|
+
leaseUntil: Date.now() + this.deadlineMs + 5000,
|
|
76
|
+
updatedAt: new Date().toISOString(),
|
|
77
|
+
};
|
|
78
|
+
await tx.put(ctx.tenantId, collection, row);
|
|
79
|
+
return { row, claimed: true };
|
|
80
|
+
});
|
|
81
|
+
if (!claim.claimed)
|
|
82
|
+
return this.view(claim.row);
|
|
83
|
+
let observation;
|
|
84
|
+
try {
|
|
85
|
+
observation = await timeout((signal) => driver.submit(ctx, id, JSON.parse(payload), signal), this.deadlineMs);
|
|
86
|
+
}
|
|
87
|
+
catch {
|
|
88
|
+
observation = { state: 'unknown' };
|
|
89
|
+
}
|
|
90
|
+
return this.settle(ctx, id, lease, observation);
|
|
91
|
+
}
|
|
92
|
+
async settle(ctx, id, lease, observation) {
|
|
93
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
94
|
+
const current = await tx.get(ctx.tenantId, collection, id);
|
|
95
|
+
if (!current || current.actorId !== ctx.actorId)
|
|
96
|
+
return fail('Operation not found', 'NOT_FOUND', 404);
|
|
97
|
+
if (current.lease !== lease || current.leaseUntil < Date.now())
|
|
98
|
+
return this.view(current);
|
|
99
|
+
const valid = ['accepted', 'running', 'succeeded', 'failed', 'unknown'].includes(observation?.state);
|
|
100
|
+
const reference = observation?.reference;
|
|
101
|
+
if (reference !== undefined && (typeof reference !== 'string' || reference.length > 200))
|
|
102
|
+
return fail('Invalid provider reference', 'PROVIDER_FAILED', 502);
|
|
103
|
+
if (current.reference && reference && current.reference !== reference)
|
|
104
|
+
return fail('Provider reference changed', 'CONFLICT', 409);
|
|
105
|
+
const next = {
|
|
106
|
+
...current,
|
|
107
|
+
state: valid ? observation.state : 'unknown',
|
|
108
|
+
reference: reference ?? current.reference,
|
|
109
|
+
lease: undefined,
|
|
110
|
+
leaseUntil: 0,
|
|
111
|
+
updatedAt: new Date().toISOString(),
|
|
112
|
+
};
|
|
113
|
+
await tx.put(ctx.tenantId, collection, next);
|
|
114
|
+
return this.view(next);
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
async reconcile(ctx, id) {
|
|
118
|
+
const owned = await this.owned(ctx, id);
|
|
119
|
+
await this.authorize?.(ctx, owned.kind, 'reconcile');
|
|
120
|
+
const lease = randomUUID();
|
|
121
|
+
const claim = await atomic(this.store, ctx.tenantId, async (tx) => {
|
|
122
|
+
const row = await tx.get(ctx.tenantId, collection, id);
|
|
123
|
+
if (!row || row.actorId !== ctx.actorId)
|
|
124
|
+
return fail('Operation not found', 'NOT_FOUND', 404);
|
|
125
|
+
if (['succeeded', 'failed'].includes(row.state) || row.leaseUntil > Date.now())
|
|
126
|
+
return { row, claimed: false };
|
|
127
|
+
const next = { ...row, lease, leaseUntil: Date.now() + this.deadlineMs + 5000 };
|
|
128
|
+
await tx.put(ctx.tenantId, collection, next);
|
|
129
|
+
return { row: next, claimed: true };
|
|
130
|
+
});
|
|
131
|
+
if (!claim.claimed)
|
|
132
|
+
return this.view(claim.row);
|
|
133
|
+
let observation;
|
|
134
|
+
try {
|
|
135
|
+
observation = await timeout((signal) => this.driver(claim.row.kind).inspect(ctx, id, claim.row.reference, signal), this.deadlineMs);
|
|
136
|
+
}
|
|
137
|
+
catch {
|
|
138
|
+
observation = { state: 'unknown' };
|
|
139
|
+
}
|
|
140
|
+
return this.settle(ctx, id, lease, observation);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
//# sourceMappingURL=provider-operations.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"provider-operations.js","sourceRoot":"","sources":["../src/provider-operations.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { ActorContext, Store, JsonRecord } from './types.js';
|
|
2
|
+
import type { ProviderOperations } from './provider-operations.js';
|
|
3
|
+
export interface ProviderWorkflowDefinition {
|
|
4
|
+
steps: readonly {
|
|
5
|
+
kind: string;
|
|
6
|
+
input: (ctx: ActorContext, params: Readonly<JsonRecord>) => JsonRecord;
|
|
7
|
+
}[];
|
|
8
|
+
revision: string;
|
|
9
|
+
}
|
|
10
|
+
/** Trusted definitions, fixed revision, one persisted provider operation per step. Unknown effects are reconciled, never blindly retried. Rollback is an explicit separately approved workflow. */
|
|
11
|
+
export declare class ProviderWorkflow {
|
|
12
|
+
private store;
|
|
13
|
+
private operations;
|
|
14
|
+
private definitions;
|
|
15
|
+
private authorize;
|
|
16
|
+
constructor(store: Store, operations: ProviderOperations, definitions: Readonly<Record<string, ProviderWorkflowDefinition>>, authorize: (ctx: ActorContext, name: string) => Promise<void>);
|
|
17
|
+
private definition;
|
|
18
|
+
start(ctx: ActorContext, name: string, key: string, params: JsonRecord): Promise<{
|
|
19
|
+
id: string;
|
|
20
|
+
state: "failed" | "running" | "succeeded";
|
|
21
|
+
step: number;
|
|
22
|
+
operationId: string | undefined;
|
|
23
|
+
revision: string;
|
|
24
|
+
}>;
|
|
25
|
+
private view;
|
|
26
|
+
advance(ctx: ActorContext, id: string): Promise<{
|
|
27
|
+
id: string;
|
|
28
|
+
state: "failed" | "running" | "succeeded";
|
|
29
|
+
step: number;
|
|
30
|
+
operationId: string | undefined;
|
|
31
|
+
revision: string;
|
|
32
|
+
}>;
|
|
33
|
+
}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import { atomic, fail, hash, scope, text, object, now } from './primitives.js';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
3
|
+
/** Trusted definitions, fixed revision, one persisted provider operation per step. Unknown effects are reconciled, never blindly retried. Rollback is an explicit separately approved workflow. */
|
|
4
|
+
export class ProviderWorkflow {
|
|
5
|
+
store;
|
|
6
|
+
operations;
|
|
7
|
+
definitions;
|
|
8
|
+
authorize;
|
|
9
|
+
constructor(store, operations, definitions, authorize) {
|
|
10
|
+
this.store = store;
|
|
11
|
+
this.operations = operations;
|
|
12
|
+
this.definitions = definitions;
|
|
13
|
+
this.authorize = authorize;
|
|
14
|
+
}
|
|
15
|
+
definition(name) {
|
|
16
|
+
if (!Object.hasOwn(this.definitions, name))
|
|
17
|
+
return fail('Workflow not configured', 'CONFIG_REQUIRED', 503);
|
|
18
|
+
const d = this.definitions[name];
|
|
19
|
+
if (!d.steps.length || d.steps.length > 30)
|
|
20
|
+
return fail('Invalid workflow definition');
|
|
21
|
+
text(d.revision, 'revision', 100);
|
|
22
|
+
return d;
|
|
23
|
+
}
|
|
24
|
+
async start(ctx, name, key, params) {
|
|
25
|
+
scope(ctx);
|
|
26
|
+
await this.authorize(ctx, name);
|
|
27
|
+
const d = this.definition(name);
|
|
28
|
+
text(key, 'key', 200);
|
|
29
|
+
const raw = JSON.stringify(object(params));
|
|
30
|
+
if (Buffer.byteLength(raw) > 100000)
|
|
31
|
+
return fail('Workflow input too large');
|
|
32
|
+
const id = hash(JSON.stringify([ctx.actorId, name, key])), fingerprint = hash(raw);
|
|
33
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
34
|
+
const old = await tx.get(ctx.tenantId, 'provider-workflows', id);
|
|
35
|
+
if (old) {
|
|
36
|
+
if (old.fingerprint !== fingerprint || old.revision !== d.revision)
|
|
37
|
+
return fail('Workflow key conflict', 'CONFLICT', 409);
|
|
38
|
+
return this.view(old);
|
|
39
|
+
}
|
|
40
|
+
const row = {
|
|
41
|
+
id,
|
|
42
|
+
actorId: ctx.actorId,
|
|
43
|
+
name,
|
|
44
|
+
revision: d.revision,
|
|
45
|
+
params: JSON.parse(raw),
|
|
46
|
+
fingerprint,
|
|
47
|
+
step: 0,
|
|
48
|
+
state: 'running',
|
|
49
|
+
leaseUntil: 0,
|
|
50
|
+
updatedAt: now(),
|
|
51
|
+
};
|
|
52
|
+
await tx.put(ctx.tenantId, 'provider-workflows', row);
|
|
53
|
+
return this.view(row);
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
view(row) {
|
|
57
|
+
return {
|
|
58
|
+
id: row.id,
|
|
59
|
+
state: row.state,
|
|
60
|
+
step: row.step,
|
|
61
|
+
operationId: row.operationId,
|
|
62
|
+
revision: row.revision,
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
async advance(ctx, id) {
|
|
66
|
+
scope(ctx);
|
|
67
|
+
const original = await this.store.get(ctx.tenantId, 'provider-workflows', id);
|
|
68
|
+
if (!original || original.actorId !== ctx.actorId)
|
|
69
|
+
return fail('Workflow not found', 'NOT_FOUND', 404);
|
|
70
|
+
await this.authorize(ctx, original.name);
|
|
71
|
+
const d = this.definition(original.name);
|
|
72
|
+
if (d.revision !== original.revision)
|
|
73
|
+
return fail('Workflow revision changed', 'CONFLICT', 409);
|
|
74
|
+
const lease = randomUUID(), claim = await atomic(this.store, ctx.tenantId, async (tx) => {
|
|
75
|
+
const row = await tx.get(ctx.tenantId, 'provider-workflows', id);
|
|
76
|
+
if (!row || row.actorId !== ctx.actorId)
|
|
77
|
+
return fail('Workflow not found', 'NOT_FOUND', 404);
|
|
78
|
+
if (row.state !== 'running' || row.leaseUntil > Date.now())
|
|
79
|
+
return { row, claimed: false };
|
|
80
|
+
const next = { ...row, lease, leaseUntil: Date.now() + 60000 };
|
|
81
|
+
await tx.put(ctx.tenantId, 'provider-workflows', next);
|
|
82
|
+
return { row: next, claimed: true };
|
|
83
|
+
});
|
|
84
|
+
if (!claim.claimed)
|
|
85
|
+
return this.view(claim.row);
|
|
86
|
+
const step = d.steps[claim.row.step];
|
|
87
|
+
if (!step)
|
|
88
|
+
return fail('Invalid workflow step');
|
|
89
|
+
const op = claim.row.operationId
|
|
90
|
+
? await this.operations.reconcile(ctx, claim.row.operationId)
|
|
91
|
+
: await this.operations.submit(ctx, step.kind, `${id}:${claim.row.step}`, step.input(ctx, structuredClone(claim.row.params)));
|
|
92
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
93
|
+
const row = await tx.get(ctx.tenantId, 'provider-workflows', id);
|
|
94
|
+
if (!row || row.lease !== lease || row.leaseUntil < Date.now())
|
|
95
|
+
return this.view(row ?? claim.row);
|
|
96
|
+
const success = op.state === 'succeeded', nextStep = success ? row.step + 1 : row.step;
|
|
97
|
+
const next = {
|
|
98
|
+
...row,
|
|
99
|
+
step: nextStep,
|
|
100
|
+
operationId: success ? undefined : op.id,
|
|
101
|
+
state: op.state === 'failed' ? 'failed' : nextStep === d.steps.length ? 'succeeded' : 'running',
|
|
102
|
+
lease: undefined,
|
|
103
|
+
leaseUntil: 0,
|
|
104
|
+
updatedAt: now(),
|
|
105
|
+
};
|
|
106
|
+
await tx.put(ctx.tenantId, 'provider-workflows', next);
|
|
107
|
+
return this.view(next);
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
//# sourceMappingURL=provider-workflow.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"provider-workflow.js","sourceRoot":"","sources":["../src/provider-workflow.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import type { ActorContext, AuthenticationAdapter, FeatureAdapter, JsonRecord } from './types.js';
|
|
2
|
+
/** Adapter for an existing trusted Sapling service. Endpoint is deployment configuration, never client input. */
|
|
3
|
+
export declare class HttpCapabilityAdapter implements FeatureAdapter {
|
|
4
|
+
private serviceToken;
|
|
5
|
+
private allowedActions;
|
|
6
|
+
private timeoutMs;
|
|
7
|
+
private bulkhead;
|
|
8
|
+
private breaker;
|
|
9
|
+
private url;
|
|
10
|
+
constructor(baseUrl: string, serviceToken: () => Promise<string>, allowedActions: Record<string, string[]>, timeoutMs?: number);
|
|
11
|
+
execute(request: {
|
|
12
|
+
ctx: ActorContext;
|
|
13
|
+
featureId: string;
|
|
14
|
+
action: string;
|
|
15
|
+
input: JsonRecord;
|
|
16
|
+
options: JsonRecord;
|
|
17
|
+
}): Promise<unknown>;
|
|
18
|
+
}
|
|
19
|
+
/** Pinned issuer/audience and JWKS URL, RS256 only; no untrusted jku or algorithm negotiation. */
|
|
20
|
+
export declare class JwksAuthenticationAdapter implements AuthenticationAdapter {
|
|
21
|
+
private options;
|
|
22
|
+
private keys;
|
|
23
|
+
private expires;
|
|
24
|
+
private loadedAt;
|
|
25
|
+
private refresh?;
|
|
26
|
+
private readonly url;
|
|
27
|
+
constructor(options: {
|
|
28
|
+
issuer: string;
|
|
29
|
+
audience: string;
|
|
30
|
+
jwksUrl: string;
|
|
31
|
+
tenantClaim?: string;
|
|
32
|
+
rolesClaim?: string;
|
|
33
|
+
permissionsClaim?: string;
|
|
34
|
+
});
|
|
35
|
+
private load;
|
|
36
|
+
verifyAccessToken(token: string): Promise<{
|
|
37
|
+
tenantId: string;
|
|
38
|
+
userId: string;
|
|
39
|
+
roles: string[];
|
|
40
|
+
permissions: string[];
|
|
41
|
+
} | undefined>;
|
|
42
|
+
}
|