@lssm/lib.contracts 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406
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/dist/app-config/app-config.feature.js +53 -1
- package/dist/app-config/contracts.d.ts +50 -50
- package/dist/app-config/contracts.js +396 -1
- package/dist/app-config/docs/app-config.docblock.js +22 -220
- package/dist/app-config/events.d.ts +27 -27
- package/dist/app-config/events.js +168 -1
- package/dist/app-config/index.js +8 -1
- package/dist/app-config/lifecycle-contracts.d.ts +80 -80
- package/dist/app-config/lifecycle-contracts.js +441 -1
- package/dist/app-config/runtime.js +617 -1
- package/dist/app-config/spec.js +36 -1
- package/dist/app-config/validation.js +538 -1
- package/dist/capabilities/docs/capabilities.docblock.js +22 -1
- package/dist/capabilities/openbanking.js +92 -1
- package/dist/capabilities.js +50 -1
- package/dist/client/index.js +9 -1
- package/dist/client/react/drivers/rn-reusables.js +21 -1
- package/dist/client/react/drivers/shadcn.js +11 -1
- package/dist/client/react/feature-render.js +43 -1
- package/dist/client/react/form-render.js +298 -1
- package/dist/client/react/index.js +8 -1
- package/dist/contract-registry/index.js +3 -1
- package/dist/contract-registry/schemas.js +61 -1
- package/dist/contracts-adapter-hydration.js +41 -1
- package/dist/contracts-adapter-input.js +77 -1
- package/dist/data-views/docs/data-views.docblock.js +22 -1
- package/dist/data-views/query-generator.js +48 -1
- package/dist/data-views/runtime.js +39 -1
- package/dist/data-views.js +35 -1
- package/dist/docs/PUBLISHING.docblock.js +17 -76
- package/dist/docs/accessibility_wcag_compliance_specs.docblock.js +17 -350
- package/dist/docs/index.js +33 -1
- package/dist/docs/meta.docs.js +15 -2
- package/dist/docs/presentations.js +77 -1
- package/dist/docs/registry.js +51 -1
- package/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js +17 -383
- package/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js +17 -68
- package/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js +17 -140
- package/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js +17 -86
- package/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js +17 -1
- package/dist/docs/tech/auth/better-auth-nextjs.docblock.js +25 -2
- package/dist/docs/tech/contracts/README.docblock.js +21 -1
- package/dist/docs/tech/contracts/create-subscription.docblock.js +21 -1
- package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.js +21 -180
- package/dist/docs/tech/contracts/migrations.docblock.js +21 -1
- package/dist/docs/tech/contracts/openapi-export.docblock.js +22 -2
- package/dist/docs/tech/contracts/ops-to-presentation-linking.docblock.js +19 -60
- package/dist/docs/tech/contracts/overlays.docblock.js +21 -68
- package/dist/docs/tech/contracts/tests.docblock.js +21 -132
- package/dist/docs/tech/contracts/themes.docblock.js +21 -1
- package/dist/docs/tech/contracts/vertical-pocket-family-office.docblock.js +21 -106
- package/dist/docs/tech/lifecycle-stage-system.docblock.js +17 -213
- package/dist/docs/tech/llm/llm-integration.docblock.js +74 -5
- package/dist/docs/tech/mcp-endpoints.docblock.js +38 -1
- package/dist/docs/tech/presentation-runtime.docblock.js +17 -1
- package/dist/docs/tech/schema/README.docblock.js +21 -262
- package/dist/docs/tech/studio/learning-events.docblock.js +49 -1
- package/dist/docs/tech/studio/learning-journeys.docblock.js +25 -2
- package/dist/docs/tech/studio/platform-admin-panel.docblock.js +24 -2
- package/dist/docs/tech/studio/project-access-teams.docblock.js +26 -16
- package/dist/docs/tech/studio/project-routing.docblock.js +68 -1
- package/dist/docs/tech/studio/sandbox-unlogged.docblock.js +23 -2
- package/dist/docs/tech/studio/team-invitations.docblock.js +41 -36
- package/dist/docs/tech/studio/workspace-ops.docblock.js +48 -1
- package/dist/docs/tech/studio/workspaces.docblock.js +24 -2
- package/dist/docs/tech/telemetry-ingest.docblock.js +37 -3
- package/dist/docs/tech/templates/runtime.docblock.js +21 -1
- package/dist/docs/tech/vscode-extension.docblock.js +37 -3
- package/dist/docs/tech/workflows/overview.docblock.js +21 -1
- package/dist/docs/tech-contracts.docs.js +19 -2
- package/dist/events.js +12 -1
- package/dist/experiments/docs/experiments.docblock.js +22 -128
- package/dist/experiments/evaluator.js +101 -1
- package/dist/experiments/spec.js +33 -1
- package/dist/features.js +68 -1
- package/dist/forms/docs/forms.docblock.js +22 -1
- package/dist/forms.js +119 -1
- package/dist/index.js +107 -1
- package/dist/install.js +40 -1
- package/dist/integrations/contracts.d.ts +102 -102
- package/dist/integrations/contracts.js +388 -1
- package/dist/integrations/docs/integrations.docblock.js +95 -1
- package/dist/integrations/health.js +69 -1
- package/dist/integrations/index.js +23 -1
- package/dist/integrations/openbanking/contracts/accounts.d.ts +66 -66
- package/dist/integrations/openbanking/contracts/accounts.js +237 -1
- package/dist/integrations/openbanking/contracts/balances.d.ts +34 -34
- package/dist/integrations/openbanking/contracts/balances.js +167 -1
- package/dist/integrations/openbanking/contracts/index.js +12 -1
- package/dist/integrations/openbanking/contracts/transactions.d.ts +48 -48
- package/dist/integrations/openbanking/contracts/transactions.js +218 -1
- package/dist/integrations/openbanking/guards.js +32 -1
- package/dist/integrations/openbanking/models.d.ts +55 -55
- package/dist/integrations/openbanking/models.js +242 -1
- package/dist/integrations/openbanking/openbanking.feature.js +68 -1
- package/dist/integrations/openbanking/telemetry.js +39 -1
- package/dist/integrations/providers/elevenlabs.js +56 -1
- package/dist/integrations/providers/gcs-storage.js +79 -1
- package/dist/integrations/providers/gmail.js +91 -1
- package/dist/integrations/providers/google-calendar.js +70 -1
- package/dist/integrations/providers/impls/elevenlabs-voice.js +95 -1
- package/dist/integrations/providers/impls/gcs-storage.js +88 -1
- package/dist/integrations/providers/impls/gmail-inbound.js +200 -1
- package/dist/integrations/providers/impls/gmail-outbound.js +104 -5
- package/dist/integrations/providers/impls/google-calendar.js +154 -1
- package/dist/integrations/providers/impls/index.js +16 -1
- package/dist/integrations/providers/impls/mistral-embedding.js +41 -1
- package/dist/integrations/providers/impls/mistral-llm.js +247 -1
- package/dist/integrations/providers/impls/postmark-email.js +55 -1
- package/dist/integrations/providers/impls/powens-client.js +171 -1
- package/dist/integrations/providers/impls/powens-openbanking.js +218 -1
- package/dist/integrations/providers/impls/provider-factory.js +142 -1
- package/dist/integrations/providers/impls/qdrant-vector.js +69 -1
- package/dist/integrations/providers/impls/stripe-payments.js +202 -1
- package/dist/integrations/providers/impls/twilio-sms.js +58 -1
- package/dist/integrations/providers/index.js +13 -1
- package/dist/integrations/providers/mistral.js +72 -1
- package/dist/integrations/providers/postmark.js +72 -1
- package/dist/integrations/providers/powens.js +120 -1
- package/dist/integrations/providers/qdrant.js +77 -1
- package/dist/integrations/providers/registry.js +34 -1
- package/dist/integrations/providers/stripe.js +87 -1
- package/dist/integrations/providers/twilio-sms.js +65 -1
- package/dist/integrations/runtime.js +186 -1
- package/dist/integrations/secrets/aws-secret-manager.js +231 -1
- package/dist/integrations/secrets/env-secret-provider.js +81 -1
- package/dist/integrations/secrets/gcp-secret-manager.js +229 -1
- package/dist/integrations/secrets/index.js +8 -1
- package/dist/integrations/secrets/manager.js +103 -1
- package/dist/integrations/secrets/provider.js +58 -1
- package/dist/integrations/secrets/scaleway-secret-manager.js +247 -1
- package/dist/integrations/spec.js +39 -1
- package/dist/jobs/define-job.js +16 -1
- package/dist/jobs/gcp-cloud-tasks.js +53 -1
- package/dist/jobs/gcp-pubsub.js +39 -1
- package/dist/jobs/handlers/gmail-sync-handler.js +9 -1
- package/dist/jobs/handlers/index.js +12 -1
- package/dist/jobs/handlers/ping-handler.js +15 -1
- package/dist/jobs/handlers/storage-document-handler.js +14 -1
- package/dist/jobs/index.js +4 -1
- package/dist/jobs/memory-queue.js +71 -1
- package/dist/jobs/queue.js +33 -1
- package/dist/jobs/scaleway-sqs-queue.js +153 -1
- package/dist/jsonschema.d.ts +3 -3
- package/dist/jsonschema.js +32 -1
- package/dist/knowledge/contracts.d.ts +66 -66
- package/dist/knowledge/contracts.js +317 -1
- package/dist/knowledge/docs/knowledge.docblock.js +22 -138
- package/dist/knowledge/index.js +10 -1
- package/dist/knowledge/ingestion/document-processor.js +54 -1
- package/dist/knowledge/ingestion/embedding-service.js +25 -1
- package/dist/knowledge/ingestion/gmail-adapter.js +50 -5
- package/dist/knowledge/ingestion/index.js +7 -1
- package/dist/knowledge/ingestion/storage-adapter.js +26 -1
- package/dist/knowledge/ingestion/vector-indexer.js +32 -1
- package/dist/knowledge/query/index.js +3 -1
- package/dist/knowledge/query/service.js +64 -2
- package/dist/knowledge/runtime.js +49 -1
- package/dist/knowledge/spaces/email-threads.js +38 -1
- package/dist/knowledge/spaces/financial-docs.js +38 -1
- package/dist/knowledge/spaces/financial-overview.js +42 -1
- package/dist/knowledge/spaces/index.js +8 -1
- package/dist/knowledge/spaces/product-canon.js +38 -1
- package/dist/knowledge/spaces/support-faq.js +41 -1
- package/dist/knowledge/spaces/uploaded-docs.js +38 -1
- package/dist/knowledge/spec.js +39 -1
- package/dist/llm/exporters.js +541 -8
- package/dist/llm/index.js +4 -1
- package/dist/llm/prompts.js +246 -56
- package/dist/markdown.js +116 -3
- package/dist/migrations.js +33 -1
- package/dist/onboarding-base.d.ts +29 -29
- package/dist/onboarding-base.js +196 -1
- package/dist/openapi.js +75 -1
- package/dist/openbanking/docs/openbanking.docblock.js +22 -109
- package/dist/ownership.js +40 -1
- package/dist/policy/docs/policy.docblock.js +22 -1
- package/dist/policy/engine.js +223 -1
- package/dist/policy/opa-adapter.js +71 -1
- package/dist/policy/spec.js +33 -1
- package/dist/presentations/docs/presentations-conventions.docblock.js +21 -7
- package/dist/presentations.backcompat.js +47 -1
- package/dist/presentations.d.ts +3 -3
- package/dist/presentations.js +66 -1
- package/dist/presentations.v2.js +278 -6
- package/dist/prompt.js +10 -1
- package/dist/promptRegistry.js +34 -1
- package/dist/regenerator/docs/regenerator.docblock.js +22 -184
- package/dist/regenerator/executor.js +86 -1
- package/dist/regenerator/index.js +6 -1
- package/dist/regenerator/service.js +92 -1
- package/dist/regenerator/sinks.js +32 -1
- package/dist/regenerator/utils.js +51 -1
- package/dist/registry.js +208 -1
- package/dist/resources.js +47 -1
- package/dist/schema/dist/EnumType.js +2 -1
- package/dist/schema/dist/FieldType.js +49 -1
- package/dist/schema/dist/ScalarTypeEnum.js +236 -1
- package/dist/schema/dist/SchemaModel.js +39 -1
- package/dist/schema/dist/entity/defineEntity.js +1 -1
- package/dist/schema/dist/entity/index.js +2 -1
- package/dist/schema/dist/entity/types.js +1 -1
- package/dist/schema/dist/index.js +6 -1
- package/dist/schema-to-markdown.js +214 -10
- package/dist/server/graphql-pothos.js +128 -1
- package/dist/server/index.js +10 -1
- package/dist/server/mcp/createMcpServer.js +28 -1
- package/dist/server/mcp/registerPresentations.js +151 -1
- package/dist/server/mcp/registerPrompts.js +36 -2
- package/dist/server/mcp/registerResources.js +35 -1
- package/dist/server/mcp/registerTools.js +22 -1
- package/dist/server/provider-mcp.js +3 -1
- package/dist/server/rest-elysia.js +20 -1
- package/dist/server/rest-express.js +39 -1
- package/dist/server/rest-generic.js +125 -1
- package/dist/server/rest-next-app.js +38 -1
- package/dist/server/rest-next-mcp.js +45 -1
- package/dist/server/rest-next-pages.js +25 -1
- package/dist/spec.js +35 -1
- package/dist/telemetry/anomaly.js +48 -1
- package/dist/telemetry/docs/telemetry.docblock.js +22 -139
- package/dist/telemetry/index.js +5 -1
- package/dist/telemetry/spec.js +69 -1
- package/dist/telemetry/tracker.js +76 -1
- package/dist/tests/index.js +4 -1
- package/dist/tests/runner.js +150 -1
- package/dist/tests/spec.js +33 -1
- package/dist/themes.js +39 -1
- package/dist/workflow/adapters/db-adapter.js +83 -1
- package/dist/workflow/adapters/file-adapter.js +11 -1
- package/dist/workflow/adapters/index.js +5 -1
- package/dist/workflow/adapters/memory-store.js +58 -1
- package/dist/workflow/expression.js +98 -1
- package/dist/workflow/index.js +9 -1
- package/dist/workflow/runner.js +337 -1
- package/dist/workflow/sla-monitor.js +47 -1
- package/dist/workflow/spec.js +32 -1
- package/dist/workflow/validation.js +175 -1
- package/package.json +11 -4
|
@@ -1 +1,92 @@
|
|
|
1
|
-
import{behaviorToEnvelope
|
|
1
|
+
import { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope } from "./utils.js";
|
|
2
|
+
import { setTimeout } from "node:timers/promises";
|
|
3
|
+
|
|
4
|
+
//#region src/regenerator/service.ts
|
|
5
|
+
const DEFAULT_POLL_INTERVAL = 6e4;
|
|
6
|
+
const DEFAULT_BATCH_DURATION = 5 * 6e4;
|
|
7
|
+
var RegeneratorService = class {
|
|
8
|
+
contexts;
|
|
9
|
+
lastPoll = /* @__PURE__ */ new Map();
|
|
10
|
+
timer;
|
|
11
|
+
running = false;
|
|
12
|
+
pollInterval;
|
|
13
|
+
batchDuration;
|
|
14
|
+
clock;
|
|
15
|
+
constructor(options) {
|
|
16
|
+
this.options = options;
|
|
17
|
+
this.contexts = new Map(options.contexts.map((ctx) => [ctx.id, ctx]));
|
|
18
|
+
this.pollInterval = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL;
|
|
19
|
+
this.batchDuration = options.batchDurationMs ?? DEFAULT_BATCH_DURATION;
|
|
20
|
+
this.clock = options.clock ?? (() => /* @__PURE__ */ new Date());
|
|
21
|
+
if (this.options.rules.length === 0) throw new Error("RegeneratorService requires at least one rule");
|
|
22
|
+
}
|
|
23
|
+
start() {
|
|
24
|
+
if (this.running) return;
|
|
25
|
+
this.running = true;
|
|
26
|
+
this.tick();
|
|
27
|
+
this.timer = setInterval(() => {
|
|
28
|
+
this.tick();
|
|
29
|
+
}, this.pollInterval);
|
|
30
|
+
}
|
|
31
|
+
stop() {
|
|
32
|
+
if (!this.running) return;
|
|
33
|
+
this.running = false;
|
|
34
|
+
if (this.timer) {
|
|
35
|
+
clearInterval(this.timer);
|
|
36
|
+
this.timer = void 0;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
async runOnce() {
|
|
40
|
+
await this.tick();
|
|
41
|
+
}
|
|
42
|
+
async tick() {
|
|
43
|
+
const now = this.clock();
|
|
44
|
+
const sinceDefault = new Date(now.getTime() - this.batchDuration);
|
|
45
|
+
for (const context of this.contexts.values()) {
|
|
46
|
+
const last = this.lastPoll.get(context.id) ?? sinceDefault;
|
|
47
|
+
await this.evaluateContext(context, last, now);
|
|
48
|
+
this.lastPoll.set(context.id, now);
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
async evaluateContext(context, since, until) {
|
|
52
|
+
const signals = await this.collectSignals(context, since, until);
|
|
53
|
+
if (signals.length === 0) return;
|
|
54
|
+
for (const rule of this.options.rules) {
|
|
55
|
+
let proposals = [];
|
|
56
|
+
try {
|
|
57
|
+
proposals = await rule.evaluate(context, signals);
|
|
58
|
+
} catch (error) {
|
|
59
|
+
console.error(`[regenerator] rule ${rule.id} failed`, error instanceof Error ? error : new Error(String(error)));
|
|
60
|
+
continue;
|
|
61
|
+
}
|
|
62
|
+
await this.flushProposals(context, proposals);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
async collectSignals(context, since, until) {
|
|
66
|
+
const envelopes = [];
|
|
67
|
+
const { adapters } = this.options;
|
|
68
|
+
if (adapters.telemetry) {
|
|
69
|
+
const telemetrySignals = await adapters.telemetry.pollTelemetry(context, since, until);
|
|
70
|
+
envelopes.push(...telemetrySignals.map((signal) => telemetryToEnvelope(context.id, signal, this.clock)));
|
|
71
|
+
}
|
|
72
|
+
if (adapters.errors) {
|
|
73
|
+
const errorSignals = await adapters.errors.pollErrors(context, since, until);
|
|
74
|
+
envelopes.push(...errorSignals.map((signal) => errorToEnvelope(context.id, signal, this.clock)));
|
|
75
|
+
}
|
|
76
|
+
if (adapters.behavior) {
|
|
77
|
+
const behaviorSignals = await adapters.behavior.pollBehavior(context, since, until);
|
|
78
|
+
envelopes.push(...behaviorSignals.map((signal) => behaviorToEnvelope(context.id, signal, this.clock)));
|
|
79
|
+
}
|
|
80
|
+
return envelopes;
|
|
81
|
+
}
|
|
82
|
+
async flushProposals(context, proposals) {
|
|
83
|
+
for (const proposal of proposals) {
|
|
84
|
+
if (proposal.signalIds.length === 0) continue;
|
|
85
|
+
await this.options.sink.submit(context, proposal);
|
|
86
|
+
if (proposals.length > 10) await setTimeout(0);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
};
|
|
90
|
+
|
|
91
|
+
//#endregion
|
|
92
|
+
export { RegeneratorService };
|
|
@@ -1 +1,32 @@
|
|
|
1
|
-
|
|
1
|
+
//#region src/regenerator/sinks.ts
|
|
2
|
+
var ExecutorProposalSink = class {
|
|
3
|
+
constructor(executor, options = {}) {
|
|
4
|
+
this.executor = executor;
|
|
5
|
+
this.options = options;
|
|
6
|
+
}
|
|
7
|
+
async submit(context, proposal) {
|
|
8
|
+
const dryRun = this.options.dryRun ?? false;
|
|
9
|
+
try {
|
|
10
|
+
const result = await this.executor.execute(context, proposal, { dryRun });
|
|
11
|
+
if (this.options.logger?.info) this.options.logger.info("[regenerator] proposal executed", {
|
|
12
|
+
proposalId: proposal.id,
|
|
13
|
+
contextId: context.id,
|
|
14
|
+
status: result.status
|
|
15
|
+
});
|
|
16
|
+
if (this.options.onResult) await this.options.onResult({
|
|
17
|
+
context,
|
|
18
|
+
proposal,
|
|
19
|
+
result
|
|
20
|
+
});
|
|
21
|
+
} catch (error) {
|
|
22
|
+
if (this.options.logger?.error) this.options.logger.error("[regenerator] proposal execution failed", error instanceof Error ? error : new Error(String(error)), {
|
|
23
|
+
proposalId: proposal.id,
|
|
24
|
+
contextId: context.id
|
|
25
|
+
});
|
|
26
|
+
throw error instanceof Error ? error : new Error(String(error));
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
//#endregion
|
|
32
|
+
export { ExecutorProposalSink };
|
|
@@ -1 +1,51 @@
|
|
|
1
|
-
|
|
1
|
+
//#region src/regenerator/utils.ts
|
|
2
|
+
function telemetryToEnvelope(contextId, signal, clock) {
|
|
3
|
+
return {
|
|
4
|
+
type: "telemetry",
|
|
5
|
+
contextId,
|
|
6
|
+
signal: normalizeTelemetryDates(signal, clock)
|
|
7
|
+
};
|
|
8
|
+
}
|
|
9
|
+
function errorToEnvelope(contextId, signal, clock) {
|
|
10
|
+
return {
|
|
11
|
+
type: "error",
|
|
12
|
+
contextId,
|
|
13
|
+
signal: normalizeErrorDates(signal, clock)
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
function behaviorToEnvelope(contextId, signal, clock) {
|
|
17
|
+
return {
|
|
18
|
+
type: "behavior",
|
|
19
|
+
contextId,
|
|
20
|
+
signal: normalizeBehaviorDates(signal, clock)
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
function normalizeTelemetryDates(signal, clock) {
|
|
24
|
+
return {
|
|
25
|
+
...signal,
|
|
26
|
+
windowStart: toDate(signal.windowStart, clock),
|
|
27
|
+
windowEnd: toDate(signal.windowEnd, clock)
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
function normalizeErrorDates(signal, clock) {
|
|
31
|
+
return {
|
|
32
|
+
...signal,
|
|
33
|
+
occurredAt: toDate(signal.occurredAt, clock)
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
function normalizeBehaviorDates(signal, clock) {
|
|
37
|
+
return {
|
|
38
|
+
...signal,
|
|
39
|
+
windowStart: toDate(signal.windowStart, clock),
|
|
40
|
+
windowEnd: toDate(signal.windowEnd, clock)
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
function toDate(value, clock) {
|
|
44
|
+
if (value instanceof Date) return value;
|
|
45
|
+
const parsed = new Date(value);
|
|
46
|
+
if (Number.isNaN(parsed.getTime())) return clock();
|
|
47
|
+
return parsed;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
//#endregion
|
|
51
|
+
export { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope };
|
package/dist/registry.js
CHANGED
|
@@ -1 +1,208 @@
|
|
|
1
|
-
import{eventKey
|
|
1
|
+
import { eventKey } from "./events.js";
|
|
2
|
+
import { isEmitDeclRef } from "./spec.js";
|
|
3
|
+
import { defaultDocRegistry, docId, registerDocBlocks } from "./docs/registry.js";
|
|
4
|
+
|
|
5
|
+
//#region src/registry.ts
|
|
6
|
+
/**
|
|
7
|
+
* SpecRegistry:
|
|
8
|
+
* - Registers ContractSpecs (unique by name+version)
|
|
9
|
+
* - Binds runtime handlers to specs
|
|
10
|
+
* - Provides lookup, iteration, and a safe execute() with validation/policy/enforcement
|
|
11
|
+
*
|
|
12
|
+
* Includes a minimal OpRegistry shim for backward-compat (deprecated).
|
|
13
|
+
*/
|
|
14
|
+
function opKey(name, version) {
|
|
15
|
+
return `${name}.v${version}`;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* In-memory registry for ContractSpecs and their bound handlers.
|
|
19
|
+
* Provides validation, policy enforcement, and guarded event emission at execute time.
|
|
20
|
+
*/
|
|
21
|
+
var SpecRegistry = class {
|
|
22
|
+
specs = /* @__PURE__ */ new Map();
|
|
23
|
+
handlers = /* @__PURE__ */ new Map();
|
|
24
|
+
/**
|
|
25
|
+
* Registers a ContractSpec definition.
|
|
26
|
+
*
|
|
27
|
+
* @param spec - The contract specification to register.
|
|
28
|
+
* @returns The registry instance for chaining.
|
|
29
|
+
* @throws If a spec with the same name and version is already registered.
|
|
30
|
+
*/
|
|
31
|
+
register(spec) {
|
|
32
|
+
const key = opKey(spec.meta.name, spec.meta.version);
|
|
33
|
+
if (this.specs.has(key)) throw new Error(`Duplicate spec ${key}`);
|
|
34
|
+
this.specs.set(key, spec);
|
|
35
|
+
return this;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Binds a runtime handler implementation to a previously registered spec.
|
|
39
|
+
*
|
|
40
|
+
* @param spec - The spec to bind to.
|
|
41
|
+
* @param handler - The async function implementing the business logic.
|
|
42
|
+
* @returns The registry instance for chaining.
|
|
43
|
+
* @throws If the spec is not found or a handler is already bound.
|
|
44
|
+
*/
|
|
45
|
+
bind(spec, handler) {
|
|
46
|
+
const key = opKey(spec.meta.name, spec.meta.version);
|
|
47
|
+
if (!this.specs.has(key)) throw new Error(`Cannot bind; spec not found: ${key}`);
|
|
48
|
+
if (this.handlers.has(key)) throw new Error(`Handler already bound for ${key}`);
|
|
49
|
+
this.handlers.set(key, handler);
|
|
50
|
+
return this;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Retrieves a registered spec by name and version.
|
|
54
|
+
* If version is omitted, returns the highest version found.
|
|
55
|
+
*
|
|
56
|
+
* @param name - Operation name.
|
|
57
|
+
* @param version - (Optional) Specific version.
|
|
58
|
+
*/
|
|
59
|
+
getSpec(name, version) {
|
|
60
|
+
if (version != null) return this.specs.get(opKey(name, version));
|
|
61
|
+
let found;
|
|
62
|
+
let maxV = -Infinity;
|
|
63
|
+
for (const [k, s] of this.specs.entries()) {
|
|
64
|
+
if (!k.startsWith(`${name}.v`)) continue;
|
|
65
|
+
if (s.meta.version > maxV) {
|
|
66
|
+
maxV = s.meta.version;
|
|
67
|
+
found = s;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
return found;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Retrieves the bound handler for a spec.
|
|
74
|
+
*/
|
|
75
|
+
getHandler(name, version) {
|
|
76
|
+
const spec = this.getSpec(name, version);
|
|
77
|
+
if (!spec) return void 0;
|
|
78
|
+
return this.handlers.get(opKey(spec.meta.name, spec.meta.version));
|
|
79
|
+
}
|
|
80
|
+
/** Iterate all registered specs. */
|
|
81
|
+
listSpecs() {
|
|
82
|
+
return [...this.specs.values()];
|
|
83
|
+
}
|
|
84
|
+
/** Iterate all bound operations (spec+handler). */
|
|
85
|
+
listBound() {
|
|
86
|
+
const out = [];
|
|
87
|
+
for (const [k, spec] of this.specs.entries()) {
|
|
88
|
+
const h = this.handlers.get(k);
|
|
89
|
+
if (h) out.push({
|
|
90
|
+
spec,
|
|
91
|
+
handler: h
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
return out;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Execute an operation by name/version with full runtime protections:
|
|
98
|
+
* 1. Validates input against Zod schema.
|
|
99
|
+
* 2. Enforces policy (Auth, RBAC, Rate Limits) via PDP.
|
|
100
|
+
* 3. Guards event emission to ensure only declared events are sent.
|
|
101
|
+
* 4. Validates output against Zod schema (if applicable).
|
|
102
|
+
* 5. Tracks telemetry (success/failure).
|
|
103
|
+
*
|
|
104
|
+
* @param name - Operation name.
|
|
105
|
+
* @param version - Operation version (optional, defaults to latest).
|
|
106
|
+
* @param rawInput - The raw input payload (e.g. from JSON body).
|
|
107
|
+
* @param ctx - The runtime context (actor, tenant, etc.).
|
|
108
|
+
*/
|
|
109
|
+
async execute(name, version, rawInput, ctx) {
|
|
110
|
+
const baseSpec = this.getSpec(name, version);
|
|
111
|
+
if (!baseSpec) throw new Error(`Spec not found for ${name}${version ? `.v${version}` : ""}`);
|
|
112
|
+
const spec = await ctx.specVariantResolver?.resolve({
|
|
113
|
+
name: baseSpec.meta.name,
|
|
114
|
+
version: baseSpec.meta.version,
|
|
115
|
+
kind: baseSpec.meta.kind
|
|
116
|
+
}, ctx) ?? baseSpec;
|
|
117
|
+
let key = opKey(spec.meta.name, spec.meta.version);
|
|
118
|
+
let handler = this.handlers.get(key);
|
|
119
|
+
if (!handler) {
|
|
120
|
+
const fallbackKey = opKey(baseSpec.meta.name, baseSpec.meta.version);
|
|
121
|
+
handler = this.handlers.get(fallbackKey);
|
|
122
|
+
key = fallbackKey;
|
|
123
|
+
}
|
|
124
|
+
if (!handler) throw new Error(`No handler bound for ${key}`);
|
|
125
|
+
const parsedInput = spec.io.input?.getZod().parse(rawInput);
|
|
126
|
+
if (ctx.decide) {
|
|
127
|
+
const [service, command] = spec.meta.name.split(".");
|
|
128
|
+
const decision = await ctx.decide({
|
|
129
|
+
service,
|
|
130
|
+
command,
|
|
131
|
+
version: spec.meta.version,
|
|
132
|
+
actor: ctx.actor ?? "anonymous",
|
|
133
|
+
channel: ctx.channel,
|
|
134
|
+
roles: ctx.roles,
|
|
135
|
+
organizationId: ctx.organizationId,
|
|
136
|
+
userId: ctx.userId,
|
|
137
|
+
flags: []
|
|
138
|
+
});
|
|
139
|
+
if (decision.effect === "deny") throw new Error(`PolicyDenied: ${spec.meta.name}.v${spec.meta.version}`);
|
|
140
|
+
if (decision.rateLimit && ctx.rateLimit) {
|
|
141
|
+
const key$1 = decision.rateLimit.key ?? "default";
|
|
142
|
+
const rpm = decision.rateLimit.rpm ?? 60;
|
|
143
|
+
await ctx.rateLimit(key$1, 1, rpm);
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
const allowedEvents = /* @__PURE__ */ new Map();
|
|
147
|
+
if (spec.sideEffects?.emits) for (const e of spec.sideEffects.emits) if (isEmitDeclRef(e)) allowedEvents.set(`${e.ref.name}.v${e.ref.version}`, e.ref.payload);
|
|
148
|
+
else allowedEvents.set(`${e.name}.v${e.version}`, e.payload);
|
|
149
|
+
const emitGuard = async (eventName, eventVersion, payload) => {
|
|
150
|
+
const key2 = eventKey(eventName, eventVersion);
|
|
151
|
+
const schema = allowedEvents.get(key2);
|
|
152
|
+
if (!schema) throw new Error(`UndeclaredEvent: ${key2} not allowed by ${opKey(spec.meta.name, spec.meta.version)}`);
|
|
153
|
+
const parsed = schema.getZod().parse(payload);
|
|
154
|
+
await ctx.eventPublisher?.({
|
|
155
|
+
name: eventName,
|
|
156
|
+
version: eventVersion,
|
|
157
|
+
payload: parsed,
|
|
158
|
+
traceId: ctx.traceId
|
|
159
|
+
});
|
|
160
|
+
};
|
|
161
|
+
if (ctx.appConfig) {
|
|
162
|
+
if (!ctx.branding) ctx.branding = ctx.appConfig.branding;
|
|
163
|
+
if (!ctx.translation) ctx.translation = { config: ctx.appConfig.translation };
|
|
164
|
+
else if (!ctx.translation.config) ctx.translation = {
|
|
165
|
+
...ctx.translation,
|
|
166
|
+
config: ctx.appConfig.translation
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
const telemetryContext = ctx.telemetry;
|
|
170
|
+
const trackTelemetry = async (trigger, details) => {
|
|
171
|
+
if (!telemetryContext || !trigger?.event) return;
|
|
172
|
+
try {
|
|
173
|
+
const props = trigger.properties?.(details) ?? {};
|
|
174
|
+
await telemetryContext.track(trigger.event.name, trigger.event.version ?? 1, props, {
|
|
175
|
+
tenantId: ctx.organizationId ?? void 0,
|
|
176
|
+
organizationId: ctx.organizationId,
|
|
177
|
+
userId: ctx.userId,
|
|
178
|
+
actor: ctx.actor,
|
|
179
|
+
channel: ctx.channel,
|
|
180
|
+
metadata: ctx.traceId ? { traceId: ctx.traceId } : void 0
|
|
181
|
+
});
|
|
182
|
+
} catch (_error) {}
|
|
183
|
+
};
|
|
184
|
+
let result;
|
|
185
|
+
try {
|
|
186
|
+
result = await handler(parsedInput, {
|
|
187
|
+
...ctx,
|
|
188
|
+
__emitGuard__: emitGuard
|
|
189
|
+
});
|
|
190
|
+
} catch (error) {
|
|
191
|
+
if (spec.telemetry?.failure) await trackTelemetry(spec.telemetry.failure, {
|
|
192
|
+
input: parsedInput ?? rawInput,
|
|
193
|
+
error
|
|
194
|
+
});
|
|
195
|
+
throw error;
|
|
196
|
+
}
|
|
197
|
+
if (spec.telemetry?.success) await trackTelemetry(spec.telemetry.success, {
|
|
198
|
+
input: parsedInput ?? rawInput,
|
|
199
|
+
output: result
|
|
200
|
+
});
|
|
201
|
+
const outputModel = spec.io.output;
|
|
202
|
+
if (outputModel?.getZod) return outputModel.getZod().parse(result);
|
|
203
|
+
return result;
|
|
204
|
+
}
|
|
205
|
+
};
|
|
206
|
+
|
|
207
|
+
//#endregion
|
|
208
|
+
export { SpecRegistry, defaultDocRegistry, docId, opKey, registerDocBlocks };
|
package/dist/resources.js
CHANGED
|
@@ -1 +1,47 @@
|
|
|
1
|
-
import"zod";
|
|
1
|
+
import "zod";
|
|
2
|
+
|
|
3
|
+
//#region src/resources.ts
|
|
4
|
+
function defineResourceTemplate(spec) {
|
|
5
|
+
return spec;
|
|
6
|
+
}
|
|
7
|
+
var ResourceRegistry = class {
|
|
8
|
+
templates = [];
|
|
9
|
+
register(tmpl) {
|
|
10
|
+
this.templates.push(tmpl);
|
|
11
|
+
return this;
|
|
12
|
+
}
|
|
13
|
+
listTemplates() {
|
|
14
|
+
return [...this.templates];
|
|
15
|
+
}
|
|
16
|
+
/** Try to match a concrete URI to a template by naive pattern substitution */
|
|
17
|
+
match(uri) {
|
|
18
|
+
for (const tmpl of this.templates) {
|
|
19
|
+
const re = /* @__PURE__ */ new RegExp("^" + tmpl.meta.uriTemplate.replace(/\{[^}]+\}/g, "([^/]+)") + "$");
|
|
20
|
+
const m = uri.match(re);
|
|
21
|
+
if (!m) continue;
|
|
22
|
+
const names = [...tmpl.meta.uriTemplate.matchAll(/\{([^}]+)\}/g)].map((x) => x[1]);
|
|
23
|
+
const params = {};
|
|
24
|
+
names.forEach((n, i) => params[n] = decodeURIComponent(m[i + 1]));
|
|
25
|
+
return {
|
|
26
|
+
tmpl,
|
|
27
|
+
params
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
};
|
|
32
|
+
function resourceRef(uriTemplate, opts) {
|
|
33
|
+
return {
|
|
34
|
+
kind: "resource_ref",
|
|
35
|
+
uriTemplate,
|
|
36
|
+
varName: opts.varName ?? "id",
|
|
37
|
+
graphQLType: opts.graphQLType,
|
|
38
|
+
many: opts.many
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
function isResourceRef(x) {
|
|
42
|
+
const o = x;
|
|
43
|
+
return !!o && o.kind === "resource_ref" && typeof o.uriTemplate === "string";
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
//#endregion
|
|
47
|
+
export { ResourceRegistry, defineResourceTemplate, isResourceRef, resourceRef };
|
|
@@ -1 +1,2 @@
|
|
|
1
|
-
import"zod";
|
|
1
|
+
import "zod";
|
|
2
|
+
import "graphql";
|
|
@@ -1 +1,49 @@
|
|
|
1
|
-
import"zod";
|
|
1
|
+
import "zod";
|
|
2
|
+
import { GraphQLScalarType } from "graphql";
|
|
3
|
+
|
|
4
|
+
//#region ../schema/dist/FieldType.js
|
|
5
|
+
/**
|
|
6
|
+
* GraphQL scalar wrapper that carries zod and JSON Schema metadata.
|
|
7
|
+
*
|
|
8
|
+
* TInternal is the runtime representation; TExternal is the GraphQL output.
|
|
9
|
+
*/
|
|
10
|
+
var FieldType = class extends GraphQLScalarType {
|
|
11
|
+
zodSchema;
|
|
12
|
+
jsonSchemaDef;
|
|
13
|
+
constructor(config) {
|
|
14
|
+
super(config);
|
|
15
|
+
this.zodSchema = config.zod;
|
|
16
|
+
this.jsonSchemaDef = config.jsonSchema;
|
|
17
|
+
}
|
|
18
|
+
/** Return the attached zod schema for validation. */
|
|
19
|
+
getZod() {
|
|
20
|
+
return this.zodSchema;
|
|
21
|
+
}
|
|
22
|
+
/** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
|
|
23
|
+
getPothos() {
|
|
24
|
+
return this;
|
|
25
|
+
}
|
|
26
|
+
/** Return the JSON Schema (evaluates factory if provided). */
|
|
27
|
+
getJson() {
|
|
28
|
+
return typeof this.jsonSchemaDef === "function" ? this.jsonSchemaDef() : this.jsonSchemaDef;
|
|
29
|
+
}
|
|
30
|
+
getJsonSchemaDef() {
|
|
31
|
+
return this.jsonSchemaDef;
|
|
32
|
+
}
|
|
33
|
+
getJsonSchema() {
|
|
34
|
+
const deepResolve = (v) => {
|
|
35
|
+
const value = typeof v === "function" ? v() : v;
|
|
36
|
+
if (Array.isArray(value)) return value.map((item) => deepResolve(item));
|
|
37
|
+
if (value && typeof value === "object") {
|
|
38
|
+
const obj = {};
|
|
39
|
+
for (const [k, val] of Object.entries(value)) obj[k] = deepResolve(val);
|
|
40
|
+
return obj;
|
|
41
|
+
}
|
|
42
|
+
return value;
|
|
43
|
+
};
|
|
44
|
+
return deepResolve(this.getJson());
|
|
45
|
+
}
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
//#endregion
|
|
49
|
+
export { FieldType };
|