@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
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# @saplings/sdk
|
|
2
|
+
|
|
3
|
+
## 0.17.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- cf8fe00: Prepare the reusable Sapling packages for their first release under the `@saplings` npm scope. Include package license notices and publish installable tarballs with resolved internal dependencies.
|
|
8
|
+
- Updated dependencies [cf8fe00]
|
|
9
|
+
- @saplings/catalog@0.17.1
|
|
10
|
+
- @saplings/harbor@0.17.1
|
|
11
|
+
- @saplings/kingsman@0.17.1
|
|
12
|
+
- @saplings/middleware@0.17.1
|
|
13
|
+
- @saplings/quality-contracts@0.17.1
|
|
14
|
+
- @saplings/realtime@0.17.1
|
|
15
|
+
- @saplings/security@0.17.1
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Sapling Unified SDK contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/dist/access.d.ts
ADDED
package/dist/access.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"access.js","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
|
package/dist/accounts.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../src/accounts.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { ActorContext, JsonRecord, Store } from './types.js';
|
|
2
|
+
import type { Row } from './primitives.js';
|
|
3
|
+
export declare class Analytics {
|
|
4
|
+
private store;
|
|
5
|
+
private maxEvents;
|
|
6
|
+
constructor(store: Store, maxEvents?: number);
|
|
7
|
+
track(ctx: ActorContext, input: JsonRecord): Promise<Row>;
|
|
8
|
+
identify(ctx: ActorContext, input: JsonRecord): Promise<{
|
|
9
|
+
id: string;
|
|
10
|
+
traits: JsonRecord;
|
|
11
|
+
updatedAt: string;
|
|
12
|
+
}>;
|
|
13
|
+
private events;
|
|
14
|
+
count(ctx: ActorContext, input: JsonRecord): Promise<{
|
|
15
|
+
total: number;
|
|
16
|
+
groups: {
|
|
17
|
+
key: string;
|
|
18
|
+
count: number;
|
|
19
|
+
}[];
|
|
20
|
+
}>;
|
|
21
|
+
funnel(ctx: ActorContext, input: JsonRecord): Promise<{
|
|
22
|
+
step: string;
|
|
23
|
+
users: number;
|
|
24
|
+
}[]>;
|
|
25
|
+
retention(ctx: ActorContext, input: JsonRecord): Promise<{
|
|
26
|
+
cohort: number;
|
|
27
|
+
days: {
|
|
28
|
+
day: number;
|
|
29
|
+
users: number;
|
|
30
|
+
rate: number | null;
|
|
31
|
+
}[];
|
|
32
|
+
}>;
|
|
33
|
+
cohort(ctx: ActorContext, input: JsonRecord): Promise<string[]>;
|
|
34
|
+
metric(ctx: ActorContext, input: JsonRecord): Promise<{
|
|
35
|
+
count: number;
|
|
36
|
+
sum: number;
|
|
37
|
+
mean: number | null;
|
|
38
|
+
}>;
|
|
39
|
+
experiment(ctx: ActorContext, input: JsonRecord): Promise<{
|
|
40
|
+
variant: string;
|
|
41
|
+
exposed: number;
|
|
42
|
+
converted: number;
|
|
43
|
+
rate: number | null;
|
|
44
|
+
}[]>;
|
|
45
|
+
}
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
import { fail, insert, integer, now, strings, text, object } from './primitives.js';
|
|
2
|
+
export class Analytics {
|
|
3
|
+
store;
|
|
4
|
+
maxEvents;
|
|
5
|
+
constructor(store, maxEvents = 50000) {
|
|
6
|
+
this.store = store;
|
|
7
|
+
this.maxEvents = maxEvents;
|
|
8
|
+
}
|
|
9
|
+
async track(ctx, input) {
|
|
10
|
+
return insert(this.store, ctx, 'product-events', {
|
|
11
|
+
name: text(input.name, 'event name', 100),
|
|
12
|
+
subjectId: text(input.subjectId ?? ctx.actorId, 'subjectId', 200),
|
|
13
|
+
groupId: input.groupId === undefined ? null : text(input.groupId),
|
|
14
|
+
properties: object(input.properties ?? {}),
|
|
15
|
+
occurredAt: now(),
|
|
16
|
+
});
|
|
17
|
+
}
|
|
18
|
+
async identify(ctx, input) {
|
|
19
|
+
const id = text(input.subjectId ?? ctx.actorId, 'subjectId');
|
|
20
|
+
const r = { id, traits: object(input.traits ?? {}), updatedAt: now() };
|
|
21
|
+
await this.store.put(ctx.tenantId, 'analytics-identities', r);
|
|
22
|
+
return r;
|
|
23
|
+
}
|
|
24
|
+
async events(ctx, input) {
|
|
25
|
+
const data = await this.store.list(ctx.tenantId, 'product-events');
|
|
26
|
+
if (data.length > this.maxEvents)
|
|
27
|
+
return fail('Analytics query exceeds local engine; configure analytics provider', 'QUERY_LIMIT', 413);
|
|
28
|
+
const from = input.from === undefined ? 0 : Date.parse(text(input.from)), to = input.to === undefined ? Date.now() : Date.parse(text(input.to));
|
|
29
|
+
if (!Number.isFinite(from) || !Number.isFinite(to) || from > to)
|
|
30
|
+
return fail('Invalid time window');
|
|
31
|
+
return data
|
|
32
|
+
.filter((r) => Date.parse(String(r.occurredAt)) >= from && Date.parse(String(r.occurredAt)) <= to)
|
|
33
|
+
.sort((a, b) => String(a.occurredAt).localeCompare(String(b.occurredAt)));
|
|
34
|
+
}
|
|
35
|
+
async count(ctx, input) {
|
|
36
|
+
const events = await this.events(ctx, input);
|
|
37
|
+
const by = String(input.by ?? 'name');
|
|
38
|
+
if (!['name', 'groupId', 'subjectId'].includes(by))
|
|
39
|
+
return fail('Unsupported dimension');
|
|
40
|
+
const counts = new Map();
|
|
41
|
+
for (const r of events) {
|
|
42
|
+
if (input.name && input.name !== r.name)
|
|
43
|
+
continue;
|
|
44
|
+
const key = String(r[by] ?? 'unknown');
|
|
45
|
+
counts.set(key, (counts.get(key) ?? 0) + 1);
|
|
46
|
+
}
|
|
47
|
+
return {
|
|
48
|
+
total: [...counts.values()].reduce((a, b) => a + b, 0),
|
|
49
|
+
groups: [...counts].map(([key, count]) => ({ key, count })),
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
async funnel(ctx, input) {
|
|
53
|
+
const steps = strings(input.steps);
|
|
54
|
+
if (!steps.length || steps.length > 20)
|
|
55
|
+
return fail('Expected 1–20 steps');
|
|
56
|
+
const progress = new Map();
|
|
57
|
+
for (const r of await this.events(ctx, input)) {
|
|
58
|
+
const id = String(r.subjectId), i = progress.get(id) ?? 0;
|
|
59
|
+
if (r.name === steps[i])
|
|
60
|
+
progress.set(id, i + 1);
|
|
61
|
+
}
|
|
62
|
+
return steps.map((step, i) => ({
|
|
63
|
+
step,
|
|
64
|
+
users: [...progress.values()].filter((n) => n > i).length,
|
|
65
|
+
}));
|
|
66
|
+
}
|
|
67
|
+
async retention(ctx, input) {
|
|
68
|
+
const first = text(input.firstEvent), returnEvent = text(input.returnEvent), days = integer(input.days ?? 30, 'days', 1, 365), events = await this.events(ctx, input);
|
|
69
|
+
const starts = new Map(), buckets = Array.from({ length: days + 1 }, () => new Set());
|
|
70
|
+
for (const r of events) {
|
|
71
|
+
const id = String(r.subjectId), at = Date.parse(String(r.occurredAt));
|
|
72
|
+
if (r.name === first && !starts.has(id))
|
|
73
|
+
starts.set(id, at);
|
|
74
|
+
const start = starts.get(id);
|
|
75
|
+
if (start !== undefined && r.name === returnEvent) {
|
|
76
|
+
const day = Math.floor((at - start) / 86400000);
|
|
77
|
+
if (day >= 0 && day <= days)
|
|
78
|
+
buckets[day].add(id);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
return {
|
|
82
|
+
cohort: starts.size,
|
|
83
|
+
days: buckets.map((b, day) => ({
|
|
84
|
+
day,
|
|
85
|
+
users: b.size,
|
|
86
|
+
rate: starts.size ? b.size / starts.size : null,
|
|
87
|
+
})),
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
async cohort(ctx, input) {
|
|
91
|
+
const name = text(input.name);
|
|
92
|
+
return [
|
|
93
|
+
...new Set((await this.events(ctx, input))
|
|
94
|
+
.filter((e) => e.name === name)
|
|
95
|
+
.map((e) => String(e.subjectId))),
|
|
96
|
+
];
|
|
97
|
+
}
|
|
98
|
+
async metric(ctx, input) {
|
|
99
|
+
const key = text(input.property), name = text(input.name);
|
|
100
|
+
const values = (await this.events(ctx, input))
|
|
101
|
+
.filter((e) => e.name === name)
|
|
102
|
+
.map((e) => object(e.properties ?? {})[key])
|
|
103
|
+
.filter((n) => typeof n === 'number' && Number.isFinite(n));
|
|
104
|
+
return {
|
|
105
|
+
count: values.length,
|
|
106
|
+
sum: values.reduce((a, b) => a + b, 0),
|
|
107
|
+
mean: values.length ? values.reduce((a, b) => a + b, 0) / values.length : null,
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
async experiment(ctx, input) {
|
|
111
|
+
const key = text(input.experimentId), events = (await this.events(ctx, input)).filter((e) => object(e.properties ?? {}).experimentId === key);
|
|
112
|
+
const variants = new Map();
|
|
113
|
+
for (const r of events) {
|
|
114
|
+
const variant = String(object(r.properties ?? {}).variant ?? 'unknown'), v = variants.get(variant) ?? { exposures: new Set(), conversions: new Set() };
|
|
115
|
+
variants.set(variant, v);
|
|
116
|
+
if (r.name === 'experiment.exposure')
|
|
117
|
+
v.exposures.add(String(r.subjectId));
|
|
118
|
+
if (r.name === input.conversionEvent && v.exposures.has(String(r.subjectId)))
|
|
119
|
+
v.conversions.add(String(r.subjectId));
|
|
120
|
+
}
|
|
121
|
+
return [...variants].map(([variant, v]) => ({
|
|
122
|
+
variant,
|
|
123
|
+
exposed: v.exposures.size,
|
|
124
|
+
converted: v.conversions.size,
|
|
125
|
+
rate: v.exposures.size ? v.conversions.size / v.exposures.size : null,
|
|
126
|
+
}));
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
//# sourceMappingURL=analytics.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"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"}
|
package/dist/audit.d.ts
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { ActorContext, Store, JsonRecord } from './types.js';
|
|
2
|
+
export interface AuditEvent {
|
|
3
|
+
id: string;
|
|
4
|
+
at: string;
|
|
5
|
+
tenantId: string;
|
|
6
|
+
actorId: string;
|
|
7
|
+
action: string;
|
|
8
|
+
resourceType: string;
|
|
9
|
+
resourceId?: string;
|
|
10
|
+
correlationId?: string;
|
|
11
|
+
impersonatorId?: string;
|
|
12
|
+
detail?: JsonRecord;
|
|
13
|
+
}
|
|
14
|
+
/** Append-only SDK interface; production storage must enforce append-only DB policy and retention. */
|
|
15
|
+
export declare class AuditService {
|
|
16
|
+
private store;
|
|
17
|
+
private enabled;
|
|
18
|
+
constructor(store: Store, enabled: boolean);
|
|
19
|
+
record(ctx: ActorContext, action: string, resourceType: string, resourceId?: string, detail?: JsonRecord, store?: Store): Promise<AuditEvent | undefined>;
|
|
20
|
+
list(ctx: ActorContext, limit?: number): Promise<AuditEvent[]>;
|
|
21
|
+
}
|
package/dist/audit.js
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { redact } from './primitives.js';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
3
|
+
/** Append-only SDK interface; production storage must enforce append-only DB policy and retention. */
|
|
4
|
+
export class AuditService {
|
|
5
|
+
store;
|
|
6
|
+
enabled;
|
|
7
|
+
constructor(store, enabled) {
|
|
8
|
+
this.store = store;
|
|
9
|
+
this.enabled = enabled;
|
|
10
|
+
}
|
|
11
|
+
async record(ctx, action, resourceType, resourceId, detail, store = this.store) {
|
|
12
|
+
if (!this.enabled)
|
|
13
|
+
return;
|
|
14
|
+
const event = {
|
|
15
|
+
id: randomUUID(),
|
|
16
|
+
at: new Date().toISOString(),
|
|
17
|
+
tenantId: ctx.tenantId,
|
|
18
|
+
actorId: ctx.actorId,
|
|
19
|
+
action,
|
|
20
|
+
resourceType,
|
|
21
|
+
resourceId,
|
|
22
|
+
correlationId: ctx.correlationId,
|
|
23
|
+
impersonatorId: ctx.impersonatorId,
|
|
24
|
+
detail: detail ? redact(detail) : undefined,
|
|
25
|
+
};
|
|
26
|
+
await store.put(ctx.tenantId, 'audit', event);
|
|
27
|
+
return event;
|
|
28
|
+
}
|
|
29
|
+
async list(ctx, limit = 100) {
|
|
30
|
+
const events = await this.store.list(ctx.tenantId, 'audit');
|
|
31
|
+
return events
|
|
32
|
+
.sort((a, b) => b.at.localeCompare(a.at))
|
|
33
|
+
.slice(0, Math.max(1, Math.min(limit, 500)));
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
//# sourceMappingURL=audit.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC,sGAAsG;AACtG,MAAM,OAAO,YAAY;IAEb;IACA;IAFV,YACU,KAAY,EACZ,OAAgB;QADhB,UAAK,GAAL,KAAK,CAAO;QACZ,YAAO,GAAP,OAAO,CAAS;IACvB,CAAC;IACJ,KAAK,CAAC,MAAM,CACV,GAAiB,EACjB,MAAc,EACd,YAAoB,EACpB,UAAmB,EACnB,MAAmB,EACnB,QAAe,IAAI,CAAC,KAAK;QAEzB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,KAAK,GAAe;YACxB,EAAE,EAAE,UAAU,EAAE;YAChB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM;YACN,YAAY;YACZ,UAAU;YACV,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAE,MAAM,CAAC,MAAM,CAAgB,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC;QACF,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAiB,EAAE,KAAK,GAAG,GAAG;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxE,OAAO,MAAM;aACV,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACxC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;CACF"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { ActorContext, JsonRecord, Store } from './types.js';
|
|
2
|
+
import type { Row } from './primitives.js';
|
|
3
|
+
export declare class Automation {
|
|
4
|
+
private store;
|
|
5
|
+
private handlers;
|
|
6
|
+
constructor(store: Store);
|
|
7
|
+
registered(name: string): boolean;
|
|
8
|
+
register(name: string, handler: (ctx: ActorContext, payload: JsonRecord, signal: AbortSignal) => Promise<unknown>): void;
|
|
9
|
+
enqueue(ctx: ActorContext, input: JsonRecord): Promise<Row>;
|
|
10
|
+
private outboxStatus;
|
|
11
|
+
claim(ctx: ActorContext, leaseMs?: number): Promise<Row | undefined>;
|
|
12
|
+
finish(ctx: ActorContext, job: Row, ok: boolean): Promise<{
|
|
13
|
+
status: string;
|
|
14
|
+
leaseId: null;
|
|
15
|
+
leaseUntil: null;
|
|
16
|
+
dueAt: string;
|
|
17
|
+
updatedAt: string;
|
|
18
|
+
id: string;
|
|
19
|
+
createdAt?: string;
|
|
20
|
+
}>;
|
|
21
|
+
work(ctx: ActorContext, deadlineMs?: number): Promise<{
|
|
22
|
+
status: string;
|
|
23
|
+
leaseId: null;
|
|
24
|
+
leaseUntil: null;
|
|
25
|
+
dueAt: string;
|
|
26
|
+
updatedAt: string;
|
|
27
|
+
id: string;
|
|
28
|
+
createdAt?: string;
|
|
29
|
+
} | undefined>;
|
|
30
|
+
requeue(ctx: ActorContext, id: unknown): Promise<{
|
|
31
|
+
status: string;
|
|
32
|
+
attempts: number;
|
|
33
|
+
dueAt: string;
|
|
34
|
+
id: string;
|
|
35
|
+
createdAt?: string;
|
|
36
|
+
updatedAt?: string;
|
|
37
|
+
}>;
|
|
38
|
+
approval(ctx: ActorContext, input: JsonRecord): Promise<Row>;
|
|
39
|
+
decide(ctx: ActorContext, input: JsonRecord): Promise<Row>;
|
|
40
|
+
outbox(ctx: ActorContext, input: JsonRecord): Promise<Row>;
|
|
41
|
+
/** Atomically append event alongside local state. External delivery is at-least-once. */
|
|
42
|
+
publishWithState(ctx: ActorContext, collection: string, data: JsonRecord, event: {
|
|
43
|
+
type: string;
|
|
44
|
+
payload: JsonRecord;
|
|
45
|
+
}): Promise<Row>;
|
|
46
|
+
rule(ctx: ActorContext, input: JsonRecord): Promise<{
|
|
47
|
+
matched: boolean;
|
|
48
|
+
}>;
|
|
49
|
+
}
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
import { timeout } from './reliability.js';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
3
|
+
import { atomic, fail, insert, integer, now, object, read, strings, text } from './primitives.js';
|
|
4
|
+
export class Automation {
|
|
5
|
+
store;
|
|
6
|
+
handlers = new Map();
|
|
7
|
+
constructor(store) {
|
|
8
|
+
this.store = store;
|
|
9
|
+
}
|
|
10
|
+
registered(name) {
|
|
11
|
+
return this.handlers.has(name);
|
|
12
|
+
}
|
|
13
|
+
register(name, handler) {
|
|
14
|
+
this.handlers.set(text(name), handler);
|
|
15
|
+
}
|
|
16
|
+
async enqueue(ctx, input) {
|
|
17
|
+
const type = text(input.type, 'job type'), key = input.idempotencyKey === undefined
|
|
18
|
+
? randomUUID()
|
|
19
|
+
: text(input.idempotencyKey, 'idempotencyKey', 200);
|
|
20
|
+
if (key.startsWith('outbox:'))
|
|
21
|
+
return fail('Reserved job key', 'FORBIDDEN', 403);
|
|
22
|
+
const dueAt = input.dueAt === undefined ? now() : new Date(text(input.dueAt)).toISOString();
|
|
23
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
24
|
+
const old = await tx.get(ctx.tenantId, 'durable-jobs', key);
|
|
25
|
+
if (old) {
|
|
26
|
+
if (old.type !== type ||
|
|
27
|
+
JSON.stringify(old.payload) !== JSON.stringify(input.payload ?? {}))
|
|
28
|
+
return fail('Job key conflict', 'CONFLICT', 409);
|
|
29
|
+
return old;
|
|
30
|
+
}
|
|
31
|
+
return insert(tx, ctx, 'durable-jobs', {
|
|
32
|
+
type,
|
|
33
|
+
payload: object(input.payload ?? {}),
|
|
34
|
+
status: 'queued',
|
|
35
|
+
attempts: 0,
|
|
36
|
+
maxAttempts: integer(input.maxAttempts ?? 5, 'maxAttempts', 1, 20),
|
|
37
|
+
dueAt,
|
|
38
|
+
actorId: ctx.actorId,
|
|
39
|
+
}, key);
|
|
40
|
+
});
|
|
41
|
+
}
|
|
42
|
+
async outboxStatus(tx, ctx, job, status) {
|
|
43
|
+
if (typeof job.outboxId !== 'string' || job.id !== `outbox:${job.outboxId}`)
|
|
44
|
+
return;
|
|
45
|
+
const row = await tx.get(ctx.tenantId, 'outbox', job.outboxId);
|
|
46
|
+
if (row?.jobId === job.id)
|
|
47
|
+
await tx.put(ctx.tenantId, 'outbox', { ...row, status, updatedAt: now() });
|
|
48
|
+
}
|
|
49
|
+
async claim(ctx, leaseMs = 60000) {
|
|
50
|
+
integer(leaseMs, 'leaseMs', 100, 300000);
|
|
51
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
52
|
+
const t = Date.now();
|
|
53
|
+
const jobs = (tx.claimableJobs
|
|
54
|
+
? await tx.claimableJobs(ctx.tenantId, t, 100)
|
|
55
|
+
: await tx.list(ctx.tenantId, 'durable-jobs'))
|
|
56
|
+
.filter((j) => (j.status === 'queued' && Date.parse(String(j.dueAt)) <= t) ||
|
|
57
|
+
(j.status === 'running' && Number(j.leaseUntil) <= t))
|
|
58
|
+
.sort((a, b) => String(a.dueAt).localeCompare(String(b.dueAt)));
|
|
59
|
+
for (const job of jobs) {
|
|
60
|
+
if (Number(job.attempts) >= Number(job.maxAttempts)) {
|
|
61
|
+
await tx.put(ctx.tenantId, 'durable-jobs', {
|
|
62
|
+
...job,
|
|
63
|
+
status: 'dead',
|
|
64
|
+
leaseId: null,
|
|
65
|
+
leaseUntil: null,
|
|
66
|
+
});
|
|
67
|
+
await this.outboxStatus(tx, ctx, job, 'dead');
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
const next = {
|
|
71
|
+
...job,
|
|
72
|
+
status: 'running',
|
|
73
|
+
attempts: Number(job.attempts) + 1,
|
|
74
|
+
leaseId: randomUUID(),
|
|
75
|
+
leaseUntil: t + leaseMs,
|
|
76
|
+
};
|
|
77
|
+
await tx.put(ctx.tenantId, 'durable-jobs', next);
|
|
78
|
+
return next;
|
|
79
|
+
}
|
|
80
|
+
return undefined;
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
async finish(ctx, job, ok) {
|
|
84
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
85
|
+
const current = await read(tx, ctx, 'durable-jobs', job.id);
|
|
86
|
+
if (current.status !== 'running' ||
|
|
87
|
+
current.leaseId !== job.leaseId ||
|
|
88
|
+
Number(current.leaseUntil) < Date.now())
|
|
89
|
+
return fail('Stale lease', 'CONFLICT', 409);
|
|
90
|
+
const status = ok
|
|
91
|
+
? 'completed'
|
|
92
|
+
: Number(current.attempts) >= Number(current.maxAttempts)
|
|
93
|
+
? 'dead'
|
|
94
|
+
: 'queued';
|
|
95
|
+
const next = {
|
|
96
|
+
...current,
|
|
97
|
+
status,
|
|
98
|
+
leaseId: null,
|
|
99
|
+
leaseUntil: null,
|
|
100
|
+
dueAt: new Date(Date.now() + Math.min(300000, 1000 * 2 ** Number(current.attempts))).toISOString(),
|
|
101
|
+
updatedAt: now(),
|
|
102
|
+
};
|
|
103
|
+
await tx.put(ctx.tenantId, 'durable-jobs', next);
|
|
104
|
+
if (status !== 'queued')
|
|
105
|
+
await this.outboxStatus(tx, ctx, current, status === 'completed' ? 'delivered' : 'dead');
|
|
106
|
+
return next;
|
|
107
|
+
});
|
|
108
|
+
}
|
|
109
|
+
async work(ctx, deadlineMs = 45000) {
|
|
110
|
+
integer(deadlineMs, 'deadlineMs', 10, 240000);
|
|
111
|
+
const job = await this.claim(ctx, deadlineMs + 15000);
|
|
112
|
+
if (!job)
|
|
113
|
+
return undefined;
|
|
114
|
+
let ok = false;
|
|
115
|
+
try {
|
|
116
|
+
const handler = this.handlers.get(String(job.type));
|
|
117
|
+
if (!handler)
|
|
118
|
+
throw new Error('Unregistered job');
|
|
119
|
+
await timeout((signal) => handler({ ...ctx, correlationId: String(job.id) }, object(job.payload), signal), deadlineMs);
|
|
120
|
+
ok = true;
|
|
121
|
+
}
|
|
122
|
+
catch {
|
|
123
|
+
/* retry without sensitive error text */
|
|
124
|
+
}
|
|
125
|
+
return this.finish(ctx, job, ok);
|
|
126
|
+
}
|
|
127
|
+
async requeue(ctx, id) {
|
|
128
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
129
|
+
const job = await read(tx, ctx, 'durable-jobs', id);
|
|
130
|
+
if (job.status !== 'dead')
|
|
131
|
+
return fail('Job is not dead', 'CONFLICT', 409);
|
|
132
|
+
const next = { ...job, status: 'queued', attempts: 0, dueAt: now() };
|
|
133
|
+
await tx.put(ctx.tenantId, 'durable-jobs', next);
|
|
134
|
+
await this.outboxStatus(tx, ctx, job, 'relayed');
|
|
135
|
+
return next;
|
|
136
|
+
});
|
|
137
|
+
}
|
|
138
|
+
async approval(ctx, input) {
|
|
139
|
+
return insert(this.store, ctx, 'approvals', {
|
|
140
|
+
resourceId: text(input.resourceId),
|
|
141
|
+
requestedBy: ctx.actorId,
|
|
142
|
+
approvers: strings(input.approvers),
|
|
143
|
+
status: 'pending',
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
async decide(ctx, input) {
|
|
147
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
148
|
+
const a = await read(tx, ctx, 'approvals', input.id);
|
|
149
|
+
if (a.status !== 'pending' ||
|
|
150
|
+
a.requestedBy === ctx.actorId ||
|
|
151
|
+
!strings(a.approvers).includes(ctx.actorId))
|
|
152
|
+
return fail('Not eligible to decide', 'FORBIDDEN', 403);
|
|
153
|
+
const decision = text(input.decision);
|
|
154
|
+
if (!['approved', 'rejected'].includes(decision))
|
|
155
|
+
return fail('Invalid decision');
|
|
156
|
+
await tx.put(ctx.tenantId, 'approvals', {
|
|
157
|
+
...a,
|
|
158
|
+
status: decision,
|
|
159
|
+
decidedBy: ctx.actorId,
|
|
160
|
+
decidedAt: now(),
|
|
161
|
+
});
|
|
162
|
+
return insert(tx, ctx, 'approval-history', {
|
|
163
|
+
approvalId: a.id,
|
|
164
|
+
decision,
|
|
165
|
+
actorId: ctx.actorId,
|
|
166
|
+
});
|
|
167
|
+
});
|
|
168
|
+
}
|
|
169
|
+
async outbox(ctx, input) {
|
|
170
|
+
return atomic(this.store, ctx.tenantId, (tx) => insert(tx, ctx, 'outbox', {
|
|
171
|
+
type: text(input.type),
|
|
172
|
+
payload: object(input.payload),
|
|
173
|
+
status: 'pending',
|
|
174
|
+
}));
|
|
175
|
+
}
|
|
176
|
+
/** Atomically append event alongside local state. External delivery is at-least-once. */
|
|
177
|
+
async publishWithState(ctx, collection, data, event) {
|
|
178
|
+
return atomic(this.store, ctx.tenantId, async (tx) => {
|
|
179
|
+
const row = await insert(tx, ctx, collection, data);
|
|
180
|
+
await insert(tx, ctx, 'outbox', { ...event, status: 'pending', resourceId: row.id });
|
|
181
|
+
return row;
|
|
182
|
+
});
|
|
183
|
+
}
|
|
184
|
+
async rule(ctx, input) {
|
|
185
|
+
const data = object(input.data), field = text(input.field), op = text(input.op);
|
|
186
|
+
if (!['eq', 'neq', 'gt', 'lt', 'in'].includes(op))
|
|
187
|
+
return fail('Unknown operator');
|
|
188
|
+
const v = data[field], expected = input.value;
|
|
189
|
+
return {
|
|
190
|
+
matched: op === 'eq'
|
|
191
|
+
? v === expected
|
|
192
|
+
: op === 'neq'
|
|
193
|
+
? v !== expected
|
|
194
|
+
: op === 'gt'
|
|
195
|
+
? typeof v === 'number' && typeof expected === 'number' && v > expected
|
|
196
|
+
: op === 'lt'
|
|
197
|
+
? typeof v === 'number' && typeof expected === 'number' && v < expected
|
|
198
|
+
: Array.isArray(expected) && expected.includes(v),
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
//# sourceMappingURL=automation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"automation.js","sourceRoot":"","sources":["../src/automation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/** Fixed-period proration in integer minor units. Round half away from zero; credits are explicit, not negative invoices. */
|
|
2
|
+
export declare function quotePlanChange(input: {
|
|
3
|
+
oldMinor: number;
|
|
4
|
+
newMinor: number;
|
|
5
|
+
periodStart: number;
|
|
6
|
+
periodEnd: number;
|
|
7
|
+
effectiveAt: number;
|
|
8
|
+
taxBps?: number;
|
|
9
|
+
}): {
|
|
10
|
+
chargeMinor: number;
|
|
11
|
+
creditMinor: number;
|
|
12
|
+
taxMinor: number;
|
|
13
|
+
totalMinor: number;
|
|
14
|
+
remainingMs: number;
|
|
15
|
+
};
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { integer, fail } from './primitives.js';
|
|
2
|
+
/** Fixed-period proration in integer minor units. Round half away from zero; credits are explicit, not negative invoices. */
|
|
3
|
+
export function quotePlanChange(input) {
|
|
4
|
+
const old = integer(input.oldMinor, 'old price'), next = integer(input.newMinor, 'new price'), start = integer(input.periodStart, 'start'), end = integer(input.periodEnd, 'end'), at = integer(input.effectiveAt, 'effective time'), bps = integer(input.taxBps ?? 0, 'tax bps', 0, 10000);
|
|
5
|
+
if (end <= start || at < start || at > end)
|
|
6
|
+
return fail('Invalid proration period');
|
|
7
|
+
const delta = BigInt(next) - BigInt(old), remaining = BigInt(end - at), duration = BigInt(end - start), absolute = delta < 0n ? -delta : delta, minor = (absolute * remaining * 2n + duration) / (2n * duration);
|
|
8
|
+
const charge = delta > 0n ? minor : 0n, credit = delta < 0n ? minor : 0n, tax = (charge * BigInt(bps) + 5000n) / 10000n;
|
|
9
|
+
return {
|
|
10
|
+
chargeMinor: integer(Number(charge), 'charge'),
|
|
11
|
+
creditMinor: integer(Number(credit), 'credit'),
|
|
12
|
+
taxMinor: integer(Number(tax), 'tax'),
|
|
13
|
+
totalMinor: integer(Number(charge + tax), 'total'),
|
|
14
|
+
remainingMs: end - at,
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=billing-policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"billing-policy.js","sourceRoot":"","sources":["../src/billing-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAChD,6HAA6H;AAC7H,MAAM,UAAU,eAAe,CAAC,KAO/B;IACC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,EAC9C,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,EAC3C,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,EAC3C,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,EACrC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,gBAAgB,CAAC,EACjD,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,IAAI,GAAG,IAAI,KAAK,IAAI,EAAE,GAAG,KAAK,IAAI,EAAE,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,EACtC,SAAS,GAAG,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC,EAC5B,QAAQ,GAAG,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,EAC9B,QAAQ,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EACtC,KAAK,GAAG,CAAC,QAAQ,GAAG,SAAS,GAAG,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EACpC,MAAM,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAChC,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC;IAChD,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAC9C,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAC9C,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;QACrC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,OAAO,CAAC;QAClD,WAAW,EAAE,GAAG,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC"}
|