@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
@@ -0,0 +1,53 @@
1
+ import type { ActorContext, Store } from './types.js';
2
+ import { AccessService } from './access.js';
3
+ import { AuditService } from './audit.js';
4
+ interface Quota {
5
+ id: string;
6
+ limit: number;
7
+ period: string;
8
+ updatedAt: string;
9
+ }
10
+ export declare class BillingService {
11
+ private store;
12
+ private access;
13
+ private audit;
14
+ constructor(store: Store, access: AccessService, audit: AuditService);
15
+ setQuota(ctx: ActorContext, metric: string, limit: number, period?: string): Promise<Quota>;
16
+ getUsage(ctx: ActorContext, metric: string, period?: string): Promise<{
17
+ metric: string;
18
+ period: string;
19
+ quantity: number;
20
+ limit: number | null;
21
+ remaining: number | null;
22
+ }>;
23
+ /** Demo-only read-modify-write; requires atomic store operations for concurrent production metering. */
24
+ meter(ctx: ActorContext, metric: string, quantity?: number, period?: string, eventId?: string): Promise<{
25
+ metric: string;
26
+ period: string;
27
+ quantity: number;
28
+ limit: number | null;
29
+ replayed: boolean;
30
+ } | {
31
+ metric: string;
32
+ period: string;
33
+ quantity: number;
34
+ limit: number | null;
35
+ replayed?: undefined;
36
+ }>;
37
+ createPlan(ctx: ActorContext, input: {
38
+ name: string;
39
+ priceMinor: number;
40
+ currency: string;
41
+ features: string[];
42
+ }): Promise<{
43
+ createdAt: string;
44
+ name: string;
45
+ priceMinor: number;
46
+ currency: string;
47
+ features: string[];
48
+ id: string;
49
+ }>;
50
+ hasEntitlement(ctx: ActorContext, feature: string): Promise<boolean>;
51
+ setEntitlement(ctx: ActorContext, feature: string, enabled: boolean): Promise<void>;
52
+ }
53
+ export {};
@@ -0,0 +1,118 @@
1
+ import { atomic, hash, text, now } from './primitives.js';
2
+ import { randomUUID } from 'node:crypto';
3
+ import { SaplingError } from './types.js';
4
+ export class BillingService {
5
+ store;
6
+ access;
7
+ audit;
8
+ constructor(store, access, audit) {
9
+ this.store = store;
10
+ this.access = access;
11
+ this.audit = audit;
12
+ }
13
+ async setQuota(ctx, metric, limit, period = 'monthly') {
14
+ await this.access.requireService(ctx, 'billing:write');
15
+ if (!Number.isSafeInteger(limit) || limit < 0)
16
+ throw new SaplingError('BAD_QUOTA', 'Quota must be a nonnegative safe integer');
17
+ const row = {
18
+ id: `${period}:${metric}`,
19
+ limit,
20
+ period,
21
+ updatedAt: new Date().toISOString(),
22
+ };
23
+ await atomic(this.store, ctx.tenantId, async (tx) => {
24
+ await tx.put(ctx.tenantId, 'quotas', row);
25
+ await this.audit.record(ctx, 'quota.updated', 'quotas', row.id, { limit }, tx);
26
+ });
27
+ return row;
28
+ }
29
+ async getUsage(ctx, metric, period = 'monthly') {
30
+ await this.access.requireService(ctx, 'billing:read');
31
+ const id = `${period}:${metric}`;
32
+ const [usage, quota] = await Promise.all([
33
+ this.store.get(ctx.tenantId, 'usage', id),
34
+ this.store.get(ctx.tenantId, 'quotas', id),
35
+ ]);
36
+ return {
37
+ metric,
38
+ period,
39
+ quantity: usage?.quantity ?? 0,
40
+ limit: quota?.limit ?? null,
41
+ remaining: quota ? Math.max(0, quota.limit - (usage?.quantity ?? 0)) : null,
42
+ };
43
+ }
44
+ /** Demo-only read-modify-write; requires atomic store operations for concurrent production metering. */
45
+ async meter(ctx, metric, quantity = 1, period = 'monthly', eventId) {
46
+ await this.access.requireService(ctx, 'billing:meter');
47
+ if (!Number.isSafeInteger(quantity) || quantity <= 0)
48
+ throw new SaplingError('BAD_USAGE', 'Meter increments must be positive safe integers');
49
+ text(metric, 'metric', 100);
50
+ text(period, 'period', 100);
51
+ if (eventId !== undefined)
52
+ text(eventId, 'event ID', 200);
53
+ const id = `${period}:${metric}`;
54
+ return atomic(this.store, ctx.tenantId, async (tx) => {
55
+ const eventKey = eventId ? hash(JSON.stringify([metric, period, eventId])) : undefined;
56
+ if (eventKey) {
57
+ const old = await tx.get(ctx.tenantId, 'usage-events', eventKey);
58
+ if (old) {
59
+ if (old.increment !== quantity)
60
+ throw new SaplingError('CONFLICT', 'Conflicting usage event', 409);
61
+ const quota = await tx.get(ctx.tenantId, 'quotas', id);
62
+ return {
63
+ metric,
64
+ period,
65
+ quantity: old.quantity,
66
+ limit: quota?.limit ?? null,
67
+ replayed: true,
68
+ };
69
+ }
70
+ }
71
+ const usage = await tx.get(ctx.tenantId, 'usage', id);
72
+ const quota = await tx.get(ctx.tenantId, 'quotas', id);
73
+ const next = (usage?.quantity ?? 0) + quantity;
74
+ if (!Number.isSafeInteger(next))
75
+ throw new SaplingError('BAD_USAGE', 'Usage counter overflow');
76
+ if (quota && next > quota.limit)
77
+ throw new SaplingError('QUOTA_EXCEEDED', `Quota exceeded for ${metric}`, 429);
78
+ await tx.put(ctx.tenantId, 'usage', {
79
+ id,
80
+ quantity: next,
81
+ period,
82
+ updatedAt: new Date().toISOString(),
83
+ });
84
+ if (eventKey)
85
+ await tx.put(ctx.tenantId, 'usage-events', {
86
+ id: eventKey,
87
+ metric,
88
+ period,
89
+ eventId,
90
+ increment: quantity,
91
+ quantity: next,
92
+ createdAt: now(),
93
+ });
94
+ await this.audit.record(ctx, 'usage.metered', 'usage', id, { quantity }, tx);
95
+ return { metric, period, quantity: next, limit: quota?.limit ?? null };
96
+ });
97
+ }
98
+ async createPlan(ctx, input) {
99
+ await this.access.requireService(ctx, 'plans:write');
100
+ if (!Number.isSafeInteger(input.priceMinor) || input.priceMinor < 0)
101
+ throw new SaplingError('BAD_PRICE', 'Invalid price');
102
+ const plan = { id: randomUUID(), ...input, createdAt: new Date().toISOString() };
103
+ await this.store.put(ctx.tenantId, 'plans', plan);
104
+ return plan;
105
+ }
106
+ async hasEntitlement(ctx, feature) {
107
+ const ent = await this.store.get(ctx.tenantId, 'entitlements', feature);
108
+ return ent?.enabled ?? false;
109
+ }
110
+ async setEntitlement(ctx, feature, enabled) {
111
+ await this.access.requireService(ctx, 'billing:write');
112
+ await atomic(this.store, ctx.tenantId, async (tx) => {
113
+ await tx.put(ctx.tenantId, 'entitlements', { id: feature, enabled });
114
+ await this.audit.record(ctx, 'entitlement.changed', 'entitlements', feature, { enabled }, tx);
115
+ });
116
+ }
117
+ }
118
+ //# sourceMappingURL=billing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ import type { ActorContext, JsonRecord, Store } from './types.js';
2
+ import type { AccessService } from './access.js';
3
+ import type { AuditService } from './audit.js';
4
+ import type { Row } from './primitives.js';
5
+ /** Explicit domain state machines for high-risk catalog mutations; not a substitute for application policy. */
6
+ export declare class BusinessWorkflows {
7
+ private store;
8
+ private access;
9
+ private audit;
10
+ constructor(store: Store, access: AccessService, audit: AuditService);
11
+ private activeUser;
12
+ task(ctx: ActorContext, action: 'create' | 'assign' | 'complete', input: JsonRecord): Promise<Row | {
13
+ assigneeId: string;
14
+ updatedAt: string;
15
+ id: string;
16
+ createdAt?: string;
17
+ } | {
18
+ status: string;
19
+ completedBy: string;
20
+ completedAt: string;
21
+ updatedAt: string;
22
+ id: string;
23
+ createdAt?: string;
24
+ }>;
25
+ ticket(ctx: ActorContext, action: 'create' | 'update', input: JsonRecord): Promise<Row | {
26
+ status: string;
27
+ updatedBy: string;
28
+ updatedAt: string;
29
+ id: string;
30
+ createdAt?: string;
31
+ }>;
32
+ transfer(ctx: ActorContext, input: JsonRecord): Promise<{
33
+ ownerId: string;
34
+ updatedAt: string;
35
+ transferredBy: string;
36
+ id: string;
37
+ createdAt?: string;
38
+ }>;
39
+ }
@@ -0,0 +1,137 @@
1
+ import { atomic, fail, insert, now, read, scope, text } from './primitives.js';
2
+ /** Explicit domain state machines for high-risk catalog mutations; not a substitute for application policy. */
3
+ export class BusinessWorkflows {
4
+ store;
5
+ access;
6
+ audit;
7
+ constructor(store, access, audit) {
8
+ this.store = store;
9
+ this.access = access;
10
+ this.audit = audit;
11
+ }
12
+ async activeUser(tx, ctx, id) {
13
+ const user = await read(tx, ctx, 'users', text(id, 'user ID', 200));
14
+ if (user.disabled || user.verified !== true)
15
+ return fail('Verified active user required', 'FORBIDDEN', 403);
16
+ return user;
17
+ }
18
+ async task(ctx, action, input) {
19
+ scope(ctx);
20
+ return atomic(this.store, ctx.tenantId, async (tx) => {
21
+ if (action === 'create') {
22
+ await this.access.requireService(ctx, 'tasks:create', undefined, tx);
23
+ const assignee = await this.activeUser(tx, ctx, input.assigneeId);
24
+ const row = await insert(tx, ctx, 'tasks', {
25
+ title: text(input.title, 'title', 500),
26
+ assigneeId: assignee.id,
27
+ creatorId: ctx.actorId,
28
+ status: 'open',
29
+ });
30
+ await this.audit.record(ctx, 'task.created', 'tasks', row.id, undefined, tx);
31
+ return row;
32
+ }
33
+ const row = await read(tx, ctx, 'tasks', input.id);
34
+ if (row.status === 'completed' || row.status === 'cancelled')
35
+ return fail('Task is terminal', 'CONFLICT', 409);
36
+ if (row.creatorId !== ctx.actorId && row.assigneeId !== ctx.actorId)
37
+ await this.access.require(ctx, 'tasks:manage', row, tx);
38
+ if (action === 'assign') {
39
+ const target = await this.activeUser(tx, ctx, input.assigneeId);
40
+ const next = { ...row, assigneeId: target.id, updatedAt: now() };
41
+ await tx.put(ctx.tenantId, 'tasks', next);
42
+ await this.audit.record(ctx, 'task.assigned', 'tasks', row.id, { assigneeId: target.id }, tx);
43
+ return next;
44
+ }
45
+ const next = {
46
+ ...row,
47
+ status: 'completed',
48
+ completedBy: ctx.actorId,
49
+ completedAt: now(),
50
+ updatedAt: now(),
51
+ };
52
+ await tx.put(ctx.tenantId, 'tasks', next);
53
+ await this.audit.record(ctx, 'task.completed', 'tasks', row.id, undefined, tx);
54
+ return next;
55
+ });
56
+ }
57
+ async ticket(ctx, action, input) {
58
+ scope(ctx);
59
+ return atomic(this.store, ctx.tenantId, async (tx) => {
60
+ if (action === 'create') {
61
+ const row = await insert(tx, ctx, 'tickets', {
62
+ subject: text(input.subject, 'subject', 500),
63
+ body: text(input.body, 'body', 10000),
64
+ status: 'open',
65
+ requester: ctx.actorId,
66
+ });
67
+ await this.audit.record(ctx, 'ticket.created', 'tickets', row.id, undefined, tx);
68
+ return row;
69
+ }
70
+ const row = await read(tx, ctx, 'tickets', input.id), nextState = text(input.status, 'status', 30), transitions = {
71
+ open: ['pending', 'resolved', 'closed'],
72
+ pending: ['open', 'resolved', 'closed'],
73
+ resolved: ['open', 'closed'],
74
+ closed: [],
75
+ };
76
+ if (!transitions[String(row.status)]?.includes(nextState))
77
+ return fail('Invalid ticket transition', 'CONFLICT', 409);
78
+ await this.access.require(ctx, 'tickets:manage', row, tx);
79
+ const next = { ...row, status: nextState, updatedBy: ctx.actorId, updatedAt: now() };
80
+ await tx.put(ctx.tenantId, 'tickets', next);
81
+ await this.audit.record(ctx, 'ticket.transition', 'tickets', row.id, { from: row.status, to: nextState }, tx);
82
+ return next;
83
+ });
84
+ }
85
+ async transfer(ctx, input) {
86
+ scope(ctx);
87
+ const collection = text(input.collection, 'collection', 100), id = text(input.id, 'id', 200), targetId = text(input.ownerId, 'owner ID', 200);
88
+ if (![
89
+ 'organizations',
90
+ 'workspaces',
91
+ 'projects',
92
+ 'teams',
93
+ 'documents',
94
+ 'tasks',
95
+ 'contacts',
96
+ ].includes(collection))
97
+ return fail('Ownership transfer collection not supported', 'FORBIDDEN', 403);
98
+ return atomic(this.store, ctx.tenantId, async (tx) => {
99
+ const profile = await tx.get(ctx.tenantId, 'tenant-profile', 'profile');
100
+ if (profile && profile.status !== 'active')
101
+ return fail('Tenant frozen', 'TENANT_FROZEN', 403);
102
+ const resource = await read(tx, ctx, collection, id);
103
+ if (!resource.ownerId)
104
+ return fail('Resource has no owner', 'CONFLICT', 409);
105
+ if (resource.ownerId === targetId)
106
+ return fail('Owner unchanged', 'CONFLICT', 409);
107
+ if (input.expectedOwnerId !== undefined && input.expectedOwnerId !== resource.ownerId)
108
+ return fail('Owner changed', 'CONFLICT', 409);
109
+ if (resource.ownerId !== ctx.actorId)
110
+ await this.access.require(ctx, `${collection}:transfer`, resource, tx);
111
+ await this.activeUser(tx, ctx, targetId);
112
+ if ((await tx.get(ctx.tenantId, 'legal-holds', 'current'))?.active === true)
113
+ return fail('Legal hold active', 'LEGAL_HOLD', 409);
114
+ const org = resource.organizationId ?? resource.orgId;
115
+ if (org) {
116
+ const memberships = await tx.list(ctx.tenantId, 'memberships');
117
+ if (!memberships.some((r) => r.userId === targetId &&
118
+ r.status === 'active' &&
119
+ (r.organizationId === org || r.orgId === org)))
120
+ return fail('Target lacks organization membership', 'FORBIDDEN', 403);
121
+ }
122
+ const next = { ...resource, ownerId: targetId, updatedAt: now(), transferredBy: ctx.actorId };
123
+ await tx.put(ctx.tenantId, collection, next);
124
+ const ev = await insert(tx, ctx, 'ownership-transfers', {
125
+ collection,
126
+ resourceId: id,
127
+ previousOwnerId: resource.ownerId,
128
+ newOwnerId: targetId,
129
+ actorId: ctx.actorId,
130
+ reason: text(input.reason, 'reason', 500),
131
+ });
132
+ await this.audit.record(ctx, 'ownership.transferred', collection, id, { previousOwnerId: resource.ownerId, newOwnerId: targetId, transferId: ev.id }, tx);
133
+ return next;
134
+ });
135
+ }
136
+ }
137
+ //# sourceMappingURL=business-workflows.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"business-workflows.js","sourceRoot":"","sources":["../src/business-workflows.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ import type { ActorContext, JsonRecord, FeatureSettings, FeatureAdapter } from './types.js';
2
+ import { AccessService } from './access.js';
3
+ /** Uniform extension point for the whole SaaS catalog. Production capability behavior
4
+ * must come from an actual adapter, never merely from a feature flag. */
5
+ export declare class CapabilityService {
6
+ private settings;
7
+ private adapters;
8
+ private access;
9
+ private actions;
10
+ private providerRequired;
11
+ private configured;
12
+ private guard?;
13
+ constructor(settings: Record<string, FeatureSettings>, adapters: Record<string, FeatureAdapter>, access: AccessService, actions?: Record<string, string[]>, providerRequired?: string[], configured?: string[], guard?: ((ctx: ActorContext, id: string) => Promise<void>) | undefined);
14
+ get(id: string): {
15
+ providerConfigured: boolean;
16
+ available: boolean;
17
+ enabled?: boolean;
18
+ provider?: string;
19
+ options?: JsonRecord;
20
+ actions?: Record<string, import("./types.js").FeatureActionSettings>;
21
+ id: string;
22
+ category: string;
23
+ module: string;
24
+ name: string;
25
+ delivery: import("@saplings/catalog").Coverage;
26
+ status: string;
27
+ operations?: string;
28
+ providerPath?: string;
29
+ limitations?: string;
30
+ };
31
+ list(): {
32
+ providerConfigured: boolean;
33
+ available: boolean;
34
+ enabled?: boolean;
35
+ provider?: string;
36
+ options?: JsonRecord;
37
+ actions?: Record<string, import("./types.js").FeatureActionSettings>;
38
+ id: string;
39
+ category: string;
40
+ module: string;
41
+ name: string;
42
+ delivery: import("@saplings/catalog").Coverage;
43
+ status: string;
44
+ operations?: string;
45
+ providerPath?: string;
46
+ limitations?: string;
47
+ }[];
48
+ invoke(ctx: ActorContext, id: string, action: string, input?: JsonRecord): Promise<unknown>;
49
+ }
@@ -0,0 +1,78 @@
1
+ import { saasFeatures } from '@saplings/catalog';
2
+ import { SaplingError } from './types.js';
3
+ import { object } from './primitives.js';
4
+ /** Uniform extension point for the whole SaaS catalog. Production capability behavior
5
+ * must come from an actual adapter, never merely from a feature flag. */
6
+ export class CapabilityService {
7
+ settings;
8
+ adapters;
9
+ access;
10
+ actions;
11
+ providerRequired;
12
+ configured;
13
+ guard;
14
+ constructor(settings, adapters, access, actions = {}, providerRequired = [], configured = [], guard) {
15
+ this.settings = settings;
16
+ this.adapters = adapters;
17
+ this.access = access;
18
+ this.actions = actions;
19
+ this.providerRequired = providerRequired;
20
+ this.configured = configured;
21
+ this.guard = guard;
22
+ }
23
+ get(id) {
24
+ const feature = saasFeatures.find((f) => f.id === id);
25
+ if (!feature)
26
+ throw new SaplingError('UNKNOWN_FEATURE', `Unknown feature: ${id}`);
27
+ return {
28
+ ...feature,
29
+ ...(this.settings[id] ?? {}),
30
+ providerConfigured: this.configured.includes(id),
31
+ available: !this.providerRequired.includes(id) || this.configured.includes(id),
32
+ };
33
+ }
34
+ list() {
35
+ return saasFeatures.map((feature) => this.get(feature.id));
36
+ }
37
+ async invoke(ctx, id, action, input = {}) {
38
+ const feature = this.get(id);
39
+ input = object(input);
40
+ if (!ctx.tenantId || !ctx.actorId || ctx.tenantId.startsWith('__sapling_'))
41
+ throw new SaplingError('INVALID_CONTEXT', 'Verified tenant and actor required', 403);
42
+ await this.guard?.(ctx, id);
43
+ if (feature.enabled === false)
44
+ throw new SaplingError('FEATURE_DISABLED', `Feature ${id} disabled`, 403);
45
+ if (this.actions[id] && !this.actions[id].includes(action))
46
+ throw new SaplingError('UNKNOWN_ACTION', 'Unknown capability action', 404);
47
+ if (ctx.impersonatorId)
48
+ throw new SaplingError('FORBIDDEN', 'Support sessions may only access explicitly permitted read service routes', 403);
49
+ await this.access.requireService(ctx, `capabilities:${id}:${action}`);
50
+ const policy = this.settings[id]?.actions?.[action];
51
+ if (policy?.inputSchema) {
52
+ const parsed = await policy.inputSchema.safeParseAsync(input);
53
+ if (!parsed.success)
54
+ throw new SaplingError('INVALID_INPUT', 'Feature input schema rejected request', 400);
55
+ input = object(parsed.data);
56
+ }
57
+ if (policy?.authorize && (await policy.authorize(ctx, structuredClone(input))) !== true)
58
+ throw new SaplingError('FORBIDDEN', 'Feature action policy denied request', 403);
59
+ const adapter = this.adapters[id];
60
+ if (!adapter)
61
+ throw new SaplingError('NOT_CONFIGURED', `Feature ${id} needs an explicit capability adapter`);
62
+ const result = await adapter.execute({
63
+ ctx,
64
+ featureId: id,
65
+ action,
66
+ input,
67
+ options: feature.options ?? {},
68
+ });
69
+ if (policy?.outputSchema) {
70
+ const parsed = await policy.outputSchema.safeParseAsync(result);
71
+ if (!parsed.success)
72
+ throw new SaplingError('INVALID_OUTPUT', 'Feature output schema rejected result', 502);
73
+ return parsed.data;
74
+ }
75
+ return result;
76
+ }
77
+ }
78
+ //# sourceMappingURL=capabilities.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,71 @@
1
+ import type { ActorContext, PaymentAdapter, PaymentOrderInput, PaymentRefundInput, PaymentResult, Store, FeatureAdapter, JsonRecord } from './types.js';
2
+ export interface CashfreeOptions {
3
+ clientId: string;
4
+ clientSecret: string;
5
+ environment?: 'sandbox' | 'production';
6
+ apiVersion?: '2025-01-01' | '2026-01-01';
7
+ /** Resolve customer from trusted tenant-scoped records; never use a browser-supplied tenant ID. */
8
+ customer: (input: Readonly<PaymentOrderInput>) => Promise<{
9
+ id: string;
10
+ phone: string;
11
+ email?: string;
12
+ name?: string;
13
+ }> | {
14
+ id: string;
15
+ phone: string;
16
+ email?: string;
17
+ name?: string;
18
+ };
19
+ returnUrl?: string;
20
+ notifyUrl?: string;
21
+ webhookMaxAgeMs?: number;
22
+ }
23
+ export declare class CashfreeAdapter implements PaymentAdapter {
24
+ private options;
25
+ readonly name = "cashfree";
26
+ private base;
27
+ private version;
28
+ constructor(options: CashfreeOptions);
29
+ private request;
30
+ private validateOrder;
31
+ createOrder(i: PaymentOrderInput): Promise<PaymentResult>;
32
+ recoverOrder(i: PaymentOrderInput): Promise<PaymentResult>;
33
+ private validateRefund;
34
+ refund(i: PaymentRefundInput): Promise<PaymentResult>;
35
+ recoverRefund(i: PaymentRefundInput): Promise<PaymentResult>;
36
+ fetchPayment(order: string, payment: string): Promise<JsonRecord>;
37
+ verifyWebhook(raw: string | Uint8Array, timestamp: string, signature: string, at?: number): boolean;
38
+ /** Verified provider read + atomic tenant-local capture. Never use a browser callback as payment evidence. */
39
+ reconcilePayment(store: Store, ctx: ActorContext, orderId: string, paymentId: string): Promise<{
40
+ processed: boolean;
41
+ duplicate: boolean;
42
+ paymentId: string;
43
+ } | {
44
+ processed: boolean;
45
+ paymentId: string;
46
+ duplicate?: undefined;
47
+ }>;
48
+ }
49
+ /** Only mount on an authenticated provider callback route with a server-resolved tenant. */
50
+ export declare class CashfreeWebhookAdapter implements FeatureAdapter {
51
+ private store;
52
+ private gateway;
53
+ constructor(store: Store, gateway: CashfreeAdapter);
54
+ execute(r: Parameters<FeatureAdapter['execute']>[0]): Promise<{
55
+ processed: boolean;
56
+ duplicate: boolean;
57
+ paymentId: string;
58
+ } | {
59
+ processed: boolean;
60
+ paymentId: string;
61
+ duplicate?: undefined;
62
+ } | {
63
+ valid: boolean;
64
+ processed?: undefined;
65
+ reason?: undefined;
66
+ } | {
67
+ processed: boolean;
68
+ reason: string;
69
+ valid?: undefined;
70
+ }>;
71
+ }