@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.
Files changed (151) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/LICENSE +21 -0
  3. package/dist/access.d.ts +3 -0
  4. package/dist/access.js +3 -0
  5. package/dist/access.js.map +1 -0
  6. package/dist/accounts.d.ts +3 -0
  7. package/dist/accounts.js +3 -0
  8. package/dist/accounts.js.map +1 -0
  9. package/dist/analytics.d.ts +45 -0
  10. package/dist/analytics.js +129 -0
  11. package/dist/analytics.js.map +1 -0
  12. package/dist/audit.d.ts +21 -0
  13. package/dist/audit.js +36 -0
  14. package/dist/audit.js.map +1 -0
  15. package/dist/automation.d.ts +49 -0
  16. package/dist/automation.js +202 -0
  17. package/dist/automation.js.map +1 -0
  18. package/dist/billing-policy.d.ts +15 -0
  19. package/dist/billing-policy.js +17 -0
  20. package/dist/billing-policy.js.map +1 -0
  21. package/dist/billing.d.ts +53 -0
  22. package/dist/billing.js +118 -0
  23. package/dist/billing.js.map +1 -0
  24. package/dist/business-workflows.d.ts +39 -0
  25. package/dist/business-workflows.js +137 -0
  26. package/dist/business-workflows.js.map +1 -0
  27. package/dist/capabilities.d.ts +49 -0
  28. package/dist/capabilities.js +78 -0
  29. package/dist/capabilities.js.map +1 -0
  30. package/dist/cashfree.d.ts +71 -0
  31. package/dist/cashfree.js +241 -0
  32. package/dist/cashfree.js.map +1 -0
  33. package/dist/commerce.d.ts +21 -0
  34. package/dist/commerce.js +198 -0
  35. package/dist/commerce.js.map +1 -0
  36. package/dist/config.d.ts +4 -0
  37. package/dist/config.js +177 -0
  38. package/dist/config.js.map +1 -0
  39. package/dist/control-plane.d.ts +129 -0
  40. package/dist/control-plane.js +314 -0
  41. package/dist/control-plane.js.map +1 -0
  42. package/dist/data.d.ts +58 -0
  43. package/dist/data.js +214 -0
  44. package/dist/data.js.map +1 -0
  45. package/dist/domain-policy.d.ts +36 -0
  46. package/dist/domain-policy.js +114 -0
  47. package/dist/domain-policy.js.map +1 -0
  48. package/dist/feature-types.d.ts +187 -0
  49. package/dist/feature-types.js +2 -0
  50. package/dist/feature-types.js.map +1 -0
  51. package/dist/federation.d.ts +66 -0
  52. package/dist/federation.js +162 -0
  53. package/dist/federation.js.map +1 -0
  54. package/dist/flags.d.ts +27 -0
  55. package/dist/flags.js +52 -0
  56. package/dist/flags.js.map +1 -0
  57. package/dist/governance.d.ts +45 -0
  58. package/dist/governance.js +128 -0
  59. package/dist/governance.js.map +1 -0
  60. package/dist/http-idempotency.d.ts +22 -0
  61. package/dist/http-idempotency.js +42 -0
  62. package/dist/http-idempotency.js.map +1 -0
  63. package/dist/http.d.ts +2 -0
  64. package/dist/http.js +28 -0
  65. package/dist/http.js.map +1 -0
  66. package/dist/identity.d.ts +3 -0
  67. package/dist/identity.js +3 -0
  68. package/dist/identity.js.map +1 -0
  69. package/dist/impersonation.d.ts +2 -0
  70. package/dist/impersonation.js +3 -0
  71. package/dist/impersonation.js.map +1 -0
  72. package/dist/index.d.ts +210 -0
  73. package/dist/index.js +519 -0
  74. package/dist/index.js.map +1 -0
  75. package/dist/integrations.d.ts +114 -0
  76. package/dist/integrations.js +358 -0
  77. package/dist/integrations.js.map +1 -0
  78. package/dist/jobs.d.ts +29 -0
  79. package/dist/jobs.js +77 -0
  80. package/dist/jobs.js.map +1 -0
  81. package/dist/media.d.ts +18 -0
  82. package/dist/media.js +48 -0
  83. package/dist/media.js.map +1 -0
  84. package/dist/offboarding.d.ts +43 -0
  85. package/dist/offboarding.js +140 -0
  86. package/dist/offboarding.js.map +1 -0
  87. package/dist/operations.d.ts +105 -0
  88. package/dist/operations.js +286 -0
  89. package/dist/operations.js.map +1 -0
  90. package/dist/primitives.d.ts +24 -0
  91. package/dist/primitives.js +111 -0
  92. package/dist/primitives.js.map +1 -0
  93. package/dist/provider-operations.d.ts +43 -0
  94. package/dist/provider-operations.js +143 -0
  95. package/dist/provider-operations.js.map +1 -0
  96. package/dist/provider-workflow.d.ts +33 -0
  97. package/dist/provider-workflow.js +111 -0
  98. package/dist/provider-workflow.js.map +1 -0
  99. package/dist/providers.d.ts +42 -0
  100. package/dist/providers.js +168 -0
  101. package/dist/providers.js.map +1 -0
  102. package/dist/quality-config.d.ts +50 -0
  103. package/dist/quality-config.js +2 -0
  104. package/dist/quality-config.js.map +1 -0
  105. package/dist/razorpay-webhook.d.ts +38 -0
  106. package/dist/razorpay-webhook.js +106 -0
  107. package/dist/razorpay-webhook.js.map +1 -0
  108. package/dist/recurring.d.ts +53 -0
  109. package/dist/recurring.js +241 -0
  110. package/dist/recurring.js.map +1 -0
  111. package/dist/registry.d.ts +58 -0
  112. package/dist/registry.js +839 -0
  113. package/dist/registry.js.map +1 -0
  114. package/dist/reliability.d.ts +45 -0
  115. package/dist/reliability.js +147 -0
  116. package/dist/reliability.js.map +1 -0
  117. package/dist/resources.d.ts +19 -0
  118. package/dist/resources.js +87 -0
  119. package/dist/resources.js.map +1 -0
  120. package/dist/security-state.d.ts +14 -0
  121. package/dist/security-state.js +39 -0
  122. package/dist/security-state.js.map +1 -0
  123. package/dist/storage.d.ts +54 -0
  124. package/dist/storage.js +100 -0
  125. package/dist/storage.js.map +1 -0
  126. package/dist/store.d.ts +21 -0
  127. package/dist/store.js +110 -0
  128. package/dist/store.js.map +1 -0
  129. package/dist/stripe-payment.d.ts +21 -0
  130. package/dist/stripe-payment.js +132 -0
  131. package/dist/stripe-payment.js.map +1 -0
  132. package/dist/stripe-recurring.d.ts +58 -0
  133. package/dist/stripe-recurring.js +226 -0
  134. package/dist/stripe-recurring.js.map +1 -0
  135. package/dist/totp.d.ts +2 -0
  136. package/dist/totp.js +3 -0
  137. package/dist/totp.js.map +1 -0
  138. package/dist/transactional-processing.d.ts +27 -0
  139. package/dist/transactional-processing.js +129 -0
  140. package/dist/transactional-processing.js.map +1 -0
  141. package/dist/types.d.ts +367 -0
  142. package/dist/types.js +2 -0
  143. package/dist/types.js.map +1 -0
  144. package/dist/valkey.d.ts +18 -0
  145. package/dist/valkey.js +22 -0
  146. package/dist/valkey.js.map +1 -0
  147. package/dist/worker.d.ts +28 -0
  148. package/dist/worker.js +200 -0
  149. package/dist/worker.js.map +1 -0
  150. package/package.json +34 -3
  151. 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.
@@ -0,0 +1,3 @@
1
+ /** @deprecated IAM authorization lives in @saplings/kingsman. */
2
+ export { AccessService } from '@saplings/kingsman';
3
+ export type { Role, AbacRule } from '@saplings/kingsman';
package/dist/access.js ADDED
@@ -0,0 +1,3 @@
1
+ /** @deprecated IAM authorization lives in @saplings/kingsman. */
2
+ export { AccessService } from '@saplings/kingsman';
3
+ //# sourceMappingURL=access.js.map
@@ -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"}
@@ -0,0 +1,3 @@
1
+ /** @deprecated Legacy account lifecycle lives in @saplings/kingsman. */
2
+ export { Accounts } from '@saplings/kingsman';
3
+ export type { AccountPasswordPolicy } from '@saplings/kingsman';
@@ -0,0 +1,3 @@
1
+ /** @deprecated Legacy account lifecycle lives in @saplings/kingsman. */
2
+ export { Accounts } from '@saplings/kingsman';
3
+ //# sourceMappingURL=accounts.js.map
@@ -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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"}
@@ -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"}