@principal-ai/subsystems-core 0.29.0
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/README.md +124 -0
- package/dist/ConfigurationLoader.d.ts +76 -0
- package/dist/ConfigurationLoader.d.ts.map +1 -0
- package/dist/ConfigurationLoader.js +148 -0
- package/dist/ConfigurationLoader.js.map +1 -0
- package/dist/ConfigurationValidator.d.ts +31 -0
- package/dist/ConfigurationValidator.d.ts.map +1 -0
- package/dist/ConfigurationValidator.js +239 -0
- package/dist/ConfigurationValidator.js.map +1 -0
- package/dist/EventProcessor.d.ts +49 -0
- package/dist/EventProcessor.d.ts.map +1 -0
- package/dist/EventProcessor.js +220 -0
- package/dist/EventProcessor.js.map +1 -0
- package/dist/EventRecorderService.d.ts +305 -0
- package/dist/EventRecorderService.d.ts.map +1 -0
- package/dist/EventRecorderService.js +467 -0
- package/dist/EventRecorderService.js.map +1 -0
- package/dist/LibraryLoader.d.ts +65 -0
- package/dist/LibraryLoader.d.ts.map +1 -0
- package/dist/LibraryLoader.js +197 -0
- package/dist/LibraryLoader.js.map +1 -0
- package/dist/PathBasedEventProcessor.d.ts +77 -0
- package/dist/PathBasedEventProcessor.d.ts.map +1 -0
- package/dist/PathBasedEventProcessor.js +136 -0
- package/dist/PathBasedEventProcessor.js.map +1 -0
- package/dist/SessionManager.d.ts +194 -0
- package/dist/SessionManager.d.ts.map +1 -0
- package/dist/SessionManager.js +302 -0
- package/dist/SessionManager.js.map +1 -0
- package/dist/ValidationEngine.d.ts +31 -0
- package/dist/ValidationEngine.d.ts.map +1 -0
- package/dist/ValidationEngine.js +162 -0
- package/dist/ValidationEngine.js.map +1 -0
- package/dist/agent-sessions/fixture.d.ts +80 -0
- package/dist/agent-sessions/fixture.d.ts.map +1 -0
- package/dist/agent-sessions/fixture.js +130 -0
- package/dist/agent-sessions/fixture.js.map +1 -0
- package/dist/agent-sessions/index.d.ts +3 -0
- package/dist/agent-sessions/index.d.ts.map +1 -0
- package/dist/agent-sessions/index.js +6 -0
- package/dist/agent-sessions/index.js.map +1 -0
- package/dist/auxiliary/AuxiliaryManifestValidator.d.ts +41 -0
- package/dist/auxiliary/AuxiliaryManifestValidator.d.ts.map +1 -0
- package/dist/auxiliary/AuxiliaryManifestValidator.js +100 -0
- package/dist/auxiliary/AuxiliaryManifestValidator.js.map +1 -0
- package/dist/auxiliary/index.d.ts +9 -0
- package/dist/auxiliary/index.d.ts.map +1 -0
- package/dist/auxiliary/index.js +14 -0
- package/dist/auxiliary/index.js.map +1 -0
- package/dist/auxiliary/validateAreaScopeDisjoint.d.ts +24 -0
- package/dist/auxiliary/validateAreaScopeDisjoint.d.ts.map +1 -0
- package/dist/auxiliary/validateAreaScopeDisjoint.js +61 -0
- package/dist/auxiliary/validateAreaScopeDisjoint.js.map +1 -0
- package/dist/cli/codegen.d.ts +41 -0
- package/dist/cli/codegen.d.ts.map +1 -0
- package/dist/cli/codegen.js +257 -0
- package/dist/cli/codegen.js.map +1 -0
- package/dist/codegen/type-generator.d.ts +123 -0
- package/dist/codegen/type-generator.d.ts.map +1 -0
- package/dist/codegen/type-generator.js +433 -0
- package/dist/codegen/type-generator.js.map +1 -0
- package/dist/codegen/usage-example.d.ts +103 -0
- package/dist/codegen/usage-example.d.ts.map +1 -0
- package/dist/codegen/usage-example.js +258 -0
- package/dist/codegen/usage-example.js.map +1 -0
- package/dist/dashboard/DashboardValidator.d.ts +85 -0
- package/dist/dashboard/DashboardValidator.d.ts.map +1 -0
- package/dist/dashboard/DashboardValidator.js +775 -0
- package/dist/dashboard/DashboardValidator.js.map +1 -0
- package/dist/dashboard/index.d.ts +6 -0
- package/dist/dashboard/index.d.ts.map +1 -0
- package/dist/dashboard/index.js +10 -0
- package/dist/dashboard/index.js.map +1 -0
- package/dist/discovery/CanvasDiscovery.d.ts +160 -0
- package/dist/discovery/CanvasDiscovery.d.ts.map +1 -0
- package/dist/discovery/CanvasDiscovery.js +865 -0
- package/dist/discovery/CanvasDiscovery.js.map +1 -0
- package/dist/discovery/CanvasFileManifest.d.ts +86 -0
- package/dist/discovery/CanvasFileManifest.d.ts.map +1 -0
- package/dist/discovery/CanvasFileManifest.js +338 -0
- package/dist/discovery/CanvasFileManifest.js.map +1 -0
- package/dist/discovery/LibraryDiscovery.d.ts +108 -0
- package/dist/discovery/LibraryDiscovery.d.ts.map +1 -0
- package/dist/discovery/LibraryDiscovery.js +263 -0
- package/dist/discovery/LibraryDiscovery.js.map +1 -0
- package/dist/discovery/types.d.ts +403 -0
- package/dist/discovery/types.d.ts.map +1 -0
- package/dist/discovery/types.js +6 -0
- package/dist/discovery/types.js.map +1 -0
- package/dist/events/EventsCanvasValidator.d.ts +139 -0
- package/dist/events/EventsCanvasValidator.d.ts.map +1 -0
- package/dist/events/EventsCanvasValidator.js +281 -0
- package/dist/events/EventsCanvasValidator.js.map +1 -0
- package/dist/events/NamespacePathIndex.d.ts +61 -0
- package/dist/events/NamespacePathIndex.d.ts.map +1 -0
- package/dist/events/NamespacePathIndex.js +74 -0
- package/dist/events/NamespacePathIndex.js.map +1 -0
- package/dist/events/OtelEventPathsValidator.d.ts +75 -0
- package/dist/events/OtelEventPathsValidator.d.ts.map +1 -0
- package/dist/events/OtelEventPathsValidator.js +126 -0
- package/dist/events/OtelEventPathsValidator.js.map +1 -0
- package/dist/events/ScopeEventsValidator.d.ts +68 -0
- package/dist/events/ScopeEventsValidator.d.ts.map +1 -0
- package/dist/events/ScopeEventsValidator.js +91 -0
- package/dist/events/ScopeEventsValidator.js.map +1 -0
- package/dist/events/index.d.ts +9 -0
- package/dist/events/index.d.ts.map +1 -0
- package/dist/events/index.js +12 -0
- package/dist/events/index.js.map +1 -0
- package/dist/events/path-helpers.d.ts +33 -0
- package/dist/events/path-helpers.d.ts.map +1 -0
- package/dist/events/path-helpers.js +59 -0
- package/dist/events/path-helpers.js.map +1 -0
- package/dist/execution/ExecutionLoader.d.ts +135 -0
- package/dist/execution/ExecutionLoader.d.ts.map +1 -0
- package/dist/execution/ExecutionLoader.js +266 -0
- package/dist/execution/ExecutionLoader.js.map +1 -0
- package/dist/execution/ExecutionValidator.d.ts +94 -0
- package/dist/execution/ExecutionValidator.d.ts.map +1 -0
- package/dist/execution/ExecutionValidator.js +503 -0
- package/dist/execution/ExecutionValidator.js.map +1 -0
- package/dist/generated/graph-converter-execution.types.d.ts +177 -0
- package/dist/generated/graph-converter-execution.types.d.ts.map +1 -0
- package/dist/generated/graph-converter-execution.types.js +12 -0
- package/dist/generated/graph-converter-execution.types.js.map +1 -0
- package/dist/helpers/GraphInstrumentationHelper.d.ts +93 -0
- package/dist/helpers/GraphInstrumentationHelper.d.ts.map +1 -0
- package/dist/helpers/GraphInstrumentationHelper.js +252 -0
- package/dist/helpers/GraphInstrumentationHelper.js.map +1 -0
- package/dist/index.d.ts +82 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +214 -0
- package/dist/index.js.map +1 -0
- package/dist/matchers/SpanMatcher.d.ts +107 -0
- package/dist/matchers/SpanMatcher.d.ts.map +1 -0
- package/dist/matchers/SpanMatcher.js +274 -0
- package/dist/matchers/SpanMatcher.js.map +1 -0
- package/dist/node.d.ts +78 -0
- package/dist/node.d.ts.map +1 -0
- package/dist/node.js +177 -0
- package/dist/node.js.map +1 -0
- package/dist/opencode/OpenCodeEventStore.d.ts +25 -0
- package/dist/opencode/OpenCodeEventStore.d.ts.map +1 -0
- package/dist/opencode/OpenCodeEventStore.js +182 -0
- package/dist/opencode/OpenCodeEventStore.js.map +1 -0
- package/dist/opencode/agent-sessions.d.ts +46 -0
- package/dist/opencode/agent-sessions.d.ts.map +1 -0
- package/dist/opencode/agent-sessions.js +302 -0
- package/dist/opencode/agent-sessions.js.map +1 -0
- package/dist/opencode/index.d.ts +6 -0
- package/dist/opencode/index.d.ts.map +1 -0
- package/dist/opencode/index.js +15 -0
- package/dist/opencode/index.js.map +1 -0
- package/dist/opencode/node-path-adapter.d.ts +25 -0
- package/dist/opencode/node-path-adapter.d.ts.map +1 -0
- package/dist/opencode/node-path-adapter.js +188 -0
- package/dist/opencode/node-path-adapter.js.map +1 -0
- package/dist/opencode/pipeline.d.ts +42 -0
- package/dist/opencode/pipeline.d.ts.map +1 -0
- package/dist/opencode/pipeline.js +90 -0
- package/dist/opencode/pipeline.js.map +1 -0
- package/dist/opencode/types.d.ts +39 -0
- package/dist/opencode/types.d.ts.map +1 -0
- package/dist/opencode/types.js +3 -0
- package/dist/opencode/types.js.map +1 -0
- package/dist/orchestration/TraceOrchestrator.d.ts +71 -0
- package/dist/orchestration/TraceOrchestrator.d.ts.map +1 -0
- package/dist/orchestration/TraceOrchestrator.js +416 -0
- package/dist/orchestration/TraceOrchestrator.js.map +1 -0
- package/dist/parsers/OtlpTraceParser.d.ts +131 -0
- package/dist/parsers/OtlpTraceParser.d.ts.map +1 -0
- package/dist/parsers/OtlpTraceParser.js +310 -0
- package/dist/parsers/OtlpTraceParser.js.map +1 -0
- package/dist/registry/CompositeRegistry.d.ts +71 -0
- package/dist/registry/CompositeRegistry.d.ts.map +1 -0
- package/dist/registry/CompositeRegistry.js +113 -0
- package/dist/registry/CompositeRegistry.js.map +1 -0
- package/dist/registry/EventRegistry.d.ts +79 -0
- package/dist/registry/EventRegistry.d.ts.map +1 -0
- package/dist/registry/EventRegistry.js +165 -0
- package/dist/registry/EventRegistry.js.map +1 -0
- package/dist/registry/LocalRegistry.d.ts +111 -0
- package/dist/registry/LocalRegistry.d.ts.map +1 -0
- package/dist/registry/LocalRegistry.js +335 -0
- package/dist/registry/LocalRegistry.js.map +1 -0
- package/dist/registry/RemoteRegistry.d.ts +122 -0
- package/dist/registry/RemoteRegistry.d.ts.map +1 -0
- package/dist/registry/RemoteRegistry.js +399 -0
- package/dist/registry/RemoteRegistry.js.map +1 -0
- package/dist/registry/VersionRegistry.d.ts +51 -0
- package/dist/registry/VersionRegistry.d.ts.map +1 -0
- package/dist/registry/VersionRegistry.js +105 -0
- package/dist/registry/VersionRegistry.js.map +1 -0
- package/dist/rules/config.d.ts +57 -0
- package/dist/rules/config.d.ts.map +1 -0
- package/dist/rules/config.js +382 -0
- package/dist/rules/config.js.map +1 -0
- package/dist/rules/engine.d.ts +70 -0
- package/dist/rules/engine.d.ts.map +1 -0
- package/dist/rules/engine.js +373 -0
- package/dist/rules/engine.js.map +1 -0
- package/dist/rules/implementations/connection-type-references.d.ts +7 -0
- package/dist/rules/implementations/connection-type-references.d.ts.map +1 -0
- package/dist/rules/implementations/connection-type-references.js +107 -0
- package/dist/rules/implementations/connection-type-references.js.map +1 -0
- package/dist/rules/implementations/dead-end-states.d.ts +17 -0
- package/dist/rules/implementations/dead-end-states.d.ts.map +1 -0
- package/dist/rules/implementations/dead-end-states.js +75 -0
- package/dist/rules/implementations/dead-end-states.js.map +1 -0
- package/dist/rules/implementations/index.d.ts +23 -0
- package/dist/rules/implementations/index.d.ts.map +1 -0
- package/dist/rules/implementations/index.js +73 -0
- package/dist/rules/implementations/index.js.map +1 -0
- package/dist/rules/implementations/minimum-node-sources.d.ts +24 -0
- package/dist/rules/implementations/minimum-node-sources.d.ts.map +1 -0
- package/dist/rules/implementations/minimum-node-sources.js +59 -0
- package/dist/rules/implementations/minimum-node-sources.js.map +1 -0
- package/dist/rules/implementations/no-unknown-fields.d.ts +7 -0
- package/dist/rules/implementations/no-unknown-fields.d.ts.map +1 -0
- package/dist/rules/implementations/no-unknown-fields.js +216 -0
- package/dist/rules/implementations/no-unknown-fields.js.map +1 -0
- package/dist/rules/implementations/orphaned-edge-types.d.ts +7 -0
- package/dist/rules/implementations/orphaned-edge-types.d.ts.map +1 -0
- package/dist/rules/implementations/orphaned-edge-types.js +50 -0
- package/dist/rules/implementations/orphaned-edge-types.js.map +1 -0
- package/dist/rules/implementations/orphaned-node-types.d.ts +7 -0
- package/dist/rules/implementations/orphaned-node-types.d.ts.map +1 -0
- package/dist/rules/implementations/orphaned-node-types.js +53 -0
- package/dist/rules/implementations/orphaned-node-types.js.map +1 -0
- package/dist/rules/implementations/required-metadata.d.ts +7 -0
- package/dist/rules/implementations/required-metadata.d.ts.map +1 -0
- package/dist/rules/implementations/required-metadata.js +48 -0
- package/dist/rules/implementations/required-metadata.js.map +1 -0
- package/dist/rules/implementations/state-transition-references.d.ts +7 -0
- package/dist/rules/implementations/state-transition-references.d.ts.map +1 -0
- package/dist/rules/implementations/state-transition-references.js +138 -0
- package/dist/rules/implementations/state-transition-references.js.map +1 -0
- package/dist/rules/implementations/unreachable-states.d.ts +7 -0
- package/dist/rules/implementations/unreachable-states.d.ts.map +1 -0
- package/dist/rules/implementations/unreachable-states.js +83 -0
- package/dist/rules/implementations/unreachable-states.js.map +1 -0
- package/dist/rules/implementations/valid-action-patterns.d.ts +17 -0
- package/dist/rules/implementations/valid-action-patterns.d.ts.map +1 -0
- package/dist/rules/implementations/valid-action-patterns.js +112 -0
- package/dist/rules/implementations/valid-action-patterns.js.map +1 -0
- package/dist/rules/implementations/valid-color-format.d.ts +7 -0
- package/dist/rules/implementations/valid-color-format.d.ts.map +1 -0
- package/dist/rules/implementations/valid-color-format.js +94 -0
- package/dist/rules/implementations/valid-color-format.js.map +1 -0
- package/dist/rules/implementations/valid-edge-types.d.ts +7 -0
- package/dist/rules/implementations/valid-edge-types.d.ts.map +1 -0
- package/dist/rules/implementations/valid-edge-types.js +248 -0
- package/dist/rules/implementations/valid-edge-types.js.map +1 -0
- package/dist/rules/implementations/valid-node-types.d.ts +7 -0
- package/dist/rules/implementations/valid-node-types.d.ts.map +1 -0
- package/dist/rules/implementations/valid-node-types.js +187 -0
- package/dist/rules/implementations/valid-node-types.js.map +1 -0
- package/dist/rules/index.d.ts +28 -0
- package/dist/rules/index.d.ts.map +1 -0
- package/dist/rules/index.js +70 -0
- package/dist/rules/index.js.map +1 -0
- package/dist/rules/types.d.ts +309 -0
- package/dist/rules/types.d.ts.map +1 -0
- package/dist/rules/types.js +40 -0
- package/dist/rules/types.js.map +1 -0
- package/dist/scopes/ScopePathIndex.d.ts +56 -0
- package/dist/scopes/ScopePathIndex.d.ts.map +1 -0
- package/dist/scopes/ScopePathIndex.js +67 -0
- package/dist/scopes/ScopePathIndex.js.map +1 -0
- package/dist/scopes/ScopesCanvasValidator.d.ts +76 -0
- package/dist/scopes/ScopesCanvasValidator.d.ts.map +1 -0
- package/dist/scopes/ScopesCanvasValidator.js +221 -0
- package/dist/scopes/ScopesCanvasValidator.js.map +1 -0
- package/dist/scopes/index.d.ts +12 -0
- package/dist/scopes/index.d.ts.map +1 -0
- package/dist/scopes/index.js +30 -0
- package/dist/scopes/index.js.map +1 -0
- package/dist/scopes/utils.d.ts +85 -0
- package/dist/scopes/utils.d.ts.map +1 -0
- package/dist/scopes/utils.js +143 -0
- package/dist/scopes/utils.js.map +1 -0
- package/dist/scopes/validateScopeNamespaceNesting.d.ts +38 -0
- package/dist/scopes/validateScopeNamespaceNesting.d.ts.map +1 -0
- package/dist/scopes/validateScopeNamespaceNesting.js +69 -0
- package/dist/scopes/validateScopeNamespaceNesting.js.map +1 -0
- package/dist/spans/index.d.ts +12 -0
- package/dist/spans/index.d.ts.map +1 -0
- package/dist/spans/index.js +25 -0
- package/dist/spans/index.js.map +1 -0
- package/dist/spans/utils.d.ts +70 -0
- package/dist/spans/utils.d.ts.map +1 -0
- package/dist/spans/utils.js +205 -0
- package/dist/spans/utils.js.map +1 -0
- package/dist/storage/topic-types.d.ts +203 -0
- package/dist/storage/topic-types.d.ts.map +1 -0
- package/dist/storage/topic-types.js +60 -0
- package/dist/storage/topic-types.js.map +1 -0
- package/dist/storage/topicStore.d.ts +135 -0
- package/dist/storage/topicStore.d.ts.map +1 -0
- package/dist/storage/topicStore.js +389 -0
- package/dist/storage/topicStore.js.map +1 -0
- package/dist/storyboard/builder.d.ts +135 -0
- package/dist/storyboard/builder.d.ts.map +1 -0
- package/dist/storyboard/builder.js +235 -0
- package/dist/storyboard/builder.js.map +1 -0
- package/dist/storyboard/index.d.ts +9 -0
- package/dist/storyboard/index.d.ts.map +1 -0
- package/dist/storyboard/index.js +18 -0
- package/dist/storyboard/index.js.map +1 -0
- package/dist/storyboard/types.d.ts +101 -0
- package/dist/storyboard/types.d.ts.map +1 -0
- package/dist/storyboard/types.js +10 -0
- package/dist/storyboard/types.js.map +1 -0
- package/dist/telemetry/coverage.d.ts +92 -0
- package/dist/telemetry/coverage.d.ts.map +1 -0
- package/dist/telemetry/coverage.js +335 -0
- package/dist/telemetry/coverage.js.map +1 -0
- package/dist/telemetry/event-validator.d.ts +86 -0
- package/dist/telemetry/event-validator.d.ts.map +1 -0
- package/dist/telemetry/event-validator.js +257 -0
- package/dist/telemetry/event-validator.js.map +1 -0
- package/dist/types/audit.d.ts +236 -0
- package/dist/types/audit.d.ts.map +1 -0
- package/dist/types/audit.js +53 -0
- package/dist/types/audit.js.map +1 -0
- package/dist/types/auxiliary.d.ts +54 -0
- package/dist/types/auxiliary.d.ts.map +1 -0
- package/dist/types/auxiliary.js +27 -0
- package/dist/types/auxiliary.js.map +1 -0
- package/dist/types/canvas-scope.d.ts +156 -0
- package/dist/types/canvas-scope.d.ts.map +1 -0
- package/dist/types/canvas-scope.js +62 -0
- package/dist/types/canvas-scope.js.map +1 -0
- package/dist/types/canvas.d.ts +1138 -0
- package/dist/types/canvas.d.ts.map +1 -0
- package/dist/types/canvas.js +178 -0
- package/dist/types/canvas.js.map +1 -0
- package/dist/types/dashboard.d.ts +170 -0
- package/dist/types/dashboard.d.ts.map +1 -0
- package/dist/types/dashboard.js +14 -0
- package/dist/types/dashboard.js.map +1 -0
- package/dist/types/index.d.ts +352 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +39 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/library.d.ts +227 -0
- package/dist/types/library.d.ts.map +1 -0
- package/dist/types/library.js +16 -0
- package/dist/types/library.js.map +1 -0
- package/dist/types/otel.d.ts +465 -0
- package/dist/types/otel.d.ts.map +1 -0
- package/dist/types/otel.js +163 -0
- package/dist/types/otel.js.map +1 -0
- package/dist/types/path-based-config.d.ts +235 -0
- package/dist/types/path-based-config.d.ts.map +1 -0
- package/dist/types/path-based-config.js +11 -0
- package/dist/types/path-based-config.js.map +1 -0
- package/dist/types/registered-trace.d.ts +337 -0
- package/dist/types/registered-trace.d.ts.map +1 -0
- package/dist/types/registered-trace.js +16 -0
- package/dist/types/registered-trace.js.map +1 -0
- package/dist/types/resource-match.d.ts +207 -0
- package/dist/types/resource-match.d.ts.map +1 -0
- package/dist/types/resource-match.js +74 -0
- package/dist/types/resource-match.js.map +1 -0
- package/dist/types/subsystem-model.d.ts +265 -0
- package/dist/types/subsystem-model.d.ts.map +1 -0
- package/dist/types/subsystem-model.js +35 -0
- package/dist/types/subsystem-model.js.map +1 -0
- package/dist/types/version-registry.d.ts +137 -0
- package/dist/types/version-registry.d.ts.map +1 -0
- package/dist/types/version-registry.js +10 -0
- package/dist/types/version-registry.js.map +1 -0
- package/dist/utils/CanvasConverter.d.ts +148 -0
- package/dist/utils/CanvasConverter.d.ts.map +1 -0
- package/dist/utils/CanvasConverter.js +530 -0
- package/dist/utils/CanvasConverter.js.map +1 -0
- package/dist/utils/GraphConverter.d.ts +18 -0
- package/dist/utils/GraphConverter.d.ts.map +1 -0
- package/dist/utils/GraphConverter.js +80 -0
- package/dist/utils/GraphConverter.js.map +1 -0
- package/dist/utils/PathMatcher.d.ts +55 -0
- package/dist/utils/PathMatcher.d.ts.map +1 -0
- package/dist/utils/PathMatcher.js +178 -0
- package/dist/utils/PathMatcher.js.map +1 -0
- package/dist/utils/TraceToCanvas.d.ts +83 -0
- package/dist/utils/TraceToCanvas.d.ts.map +1 -0
- package/dist/utils/TraceToCanvas.js +336 -0
- package/dist/utils/TraceToCanvas.js.map +1 -0
- package/dist/utils/YamlParser.d.ts +36 -0
- package/dist/utils/YamlParser.d.ts.map +1 -0
- package/dist/utils/YamlParser.js +92 -0
- package/dist/utils/YamlParser.js.map +1 -0
- package/dist/utils/registeredTraceHelpers.d.ts +76 -0
- package/dist/utils/registeredTraceHelpers.d.ts.map +1 -0
- package/dist/utils/registeredTraceHelpers.js +203 -0
- package/dist/utils/registeredTraceHelpers.js.map +1 -0
- package/dist/utils/traceAggregation.d.ts +25 -0
- package/dist/utils/traceAggregation.d.ts.map +1 -0
- package/dist/utils/traceAggregation.js +140 -0
- package/dist/utils/traceAggregation.js.map +1 -0
- package/dist/validation/OtelCanvasValidator.d.ts +40 -0
- package/dist/validation/OtelCanvasValidator.d.ts.map +1 -0
- package/dist/validation/OtelCanvasValidator.js +59 -0
- package/dist/validation/OtelCanvasValidator.js.map +1 -0
- package/dist/validation/index.d.ts +8 -0
- package/dist/validation/index.d.ts.map +1 -0
- package/dist/validation/index.js +13 -0
- package/dist/validation/index.js.map +1 -0
- package/dist/validation/libraryValidation.d.ts +53 -0
- package/dist/validation/libraryValidation.d.ts.map +1 -0
- package/dist/validation/libraryValidation.js +115 -0
- package/dist/validation/libraryValidation.js.map +1 -0
- package/dist/workflow/edge-derivation.d.ts +111 -0
- package/dist/workflow/edge-derivation.d.ts.map +1 -0
- package/dist/workflow/edge-derivation.js +174 -0
- package/dist/workflow/edge-derivation.js.map +1 -0
- package/dist/workflow/edge-validation.d.ts +170 -0
- package/dist/workflow/edge-validation.d.ts.map +1 -0
- package/dist/workflow/edge-validation.js +332 -0
- package/dist/workflow/edge-validation.js.map +1 -0
- package/dist/workflow/example.d.ts +11 -0
- package/dist/workflow/example.d.ts.map +1 -0
- package/dist/workflow/example.js +310 -0
- package/dist/workflow/example.js.map +1 -0
- package/dist/workflow/index.d.ts +20 -0
- package/dist/workflow/index.d.ts.map +1 -0
- package/dist/workflow/index.js +49 -0
- package/dist/workflow/index.js.map +1 -0
- package/dist/workflow/scenario-matcher.d.ts +63 -0
- package/dist/workflow/scenario-matcher.d.ts.map +1 -0
- package/dist/workflow/scenario-matcher.js +215 -0
- package/dist/workflow/scenario-matcher.js.map +1 -0
- package/dist/workflow/template-parser.d.ts +73 -0
- package/dist/workflow/template-parser.d.ts.map +1 -0
- package/dist/workflow/template-parser.js +280 -0
- package/dist/workflow/template-parser.js.map +1 -0
- package/dist/workflow/template-renderer.d.ts +45 -0
- package/dist/workflow/template-renderer.d.ts.map +1 -0
- package/dist/workflow/template-renderer.js +401 -0
- package/dist/workflow/template-renderer.js.map +1 -0
- package/dist/workflow/types.d.ts +393 -0
- package/dist/workflow/types.d.ts.map +1 -0
- package/dist/workflow/types.js +40 -0
- package/dist/workflow/types.js.map +1 -0
- package/dist/workflow/validator.d.ts +363 -0
- package/dist/workflow/validator.d.ts.map +1 -0
- package/dist/workflow/validator.js +2283 -0
- package/dist/workflow/validator.js.map +1 -0
- package/package.json +84 -0
- package/schemas/auxiliary.manifest.schema.json +56 -0
- package/schemas/subsystem-model.schema.json +767 -0
- package/src/ConfigurationLoader.test.ts +466 -0
- package/src/ConfigurationLoader.ts +184 -0
- package/src/ConfigurationValidator.test.ts +200 -0
- package/src/ConfigurationValidator.ts +273 -0
- package/src/EventProcessor.test.ts +405 -0
- package/src/EventProcessor.ts +256 -0
- package/src/EventRecorderService.test.ts +543 -0
- package/src/EventRecorderService.ts +741 -0
- package/src/LibraryLoader.ts +194 -0
- package/src/PathBasedEventProcessor.test.ts +336 -0
- package/src/PathBasedEventProcessor.ts +196 -0
- package/src/SessionManager.test.ts +424 -0
- package/src/SessionManager.ts +471 -0
- package/src/ValidationEngine.test.ts +520 -0
- package/src/ValidationEngine.ts +200 -0
- package/src/agent-sessions/fixture.ts +225 -0
- package/src/agent-sessions/index.ts +10 -0
- package/src/auxiliary/AuxiliaryManifestValidator.test.ts +93 -0
- package/src/auxiliary/AuxiliaryManifestValidator.ts +132 -0
- package/src/auxiliary/index.ts +18 -0
- package/src/auxiliary/validateAreaScopeDisjoint.test.ts +85 -0
- package/src/auxiliary/validateAreaScopeDisjoint.ts +72 -0
- package/src/browser-safety.test.ts +170 -0
- package/src/cli/codegen.ts +286 -0
- package/src/codegen/type-generator.test.ts +219 -0
- package/src/codegen/type-generator.ts +560 -0
- package/src/codegen/usage-example.ts +357 -0
- package/src/dashboard/DashboardValidator.ts +904 -0
- package/src/dashboard/index.ts +14 -0
- package/src/discovery/CanvasDiscovery.test.ts +691 -0
- package/src/discovery/CanvasDiscovery.ts +1114 -0
- package/src/discovery/CanvasFileManifest.test.ts +521 -0
- package/src/discovery/CanvasFileManifest.ts +419 -0
- package/src/discovery/LibraryDiscovery.test.ts +329 -0
- package/src/discovery/LibraryDiscovery.ts +386 -0
- package/src/discovery/types.ts +453 -0
- package/src/events/EventsCanvasValidator.test.ts +191 -0
- package/src/events/EventsCanvasValidator.ts +428 -0
- package/src/events/NamespacePathIndex.test.ts +97 -0
- package/src/events/NamespacePathIndex.ts +100 -0
- package/src/events/OtelEventPathsValidator.test.ts +243 -0
- package/src/events/OtelEventPathsValidator.ts +191 -0
- package/src/events/ScopeEventsValidator.test.ts +173 -0
- package/src/events/ScopeEventsValidator.ts +158 -0
- package/src/events/index.ts +27 -0
- package/src/events/path-helpers.ts +53 -0
- package/src/execution/ExecutionLoader.test.ts +378 -0
- package/src/execution/ExecutionLoader.ts +331 -0
- package/src/execution/ExecutionValidator.test.ts +503 -0
- package/src/execution/ExecutionValidator.ts +617 -0
- package/src/generated/graph-converter-execution.types.ts +193 -0
- package/src/helpers/GraphInstrumentationHelper.test.ts +364 -0
- package/src/helpers/GraphInstrumentationHelper.ts +323 -0
- package/src/index.ts +587 -0
- package/src/matchers/SpanMatcher.test.ts +1105 -0
- package/src/matchers/SpanMatcher.ts +381 -0
- package/src/node.ts +316 -0
- package/src/opencode/EVENT_MAPPING.md +82 -0
- package/src/opencode/OpenCodeEventStore.ts +214 -0
- package/src/opencode/__fixtures__/event-shapes.json +443 -0
- package/src/opencode/__fixtures__/session-events.json +13491 -0
- package/src/opencode/agent-sessions.ts +376 -0
- package/src/opencode/index.ts +23 -0
- package/src/opencode/node-path-adapter.ts +205 -0
- package/src/opencode/pipeline.ts +141 -0
- package/src/opencode/types.ts +43 -0
- package/src/orchestration/TraceOrchestrator.ts +560 -0
- package/src/orchestration/__tests__/TraceOrchestrator.test.ts +1098 -0
- package/src/parsers/OtlpTraceParser.ts +401 -0
- package/src/parsers/__tests__/OtlpTraceParser.test.ts +197 -0
- package/src/registry/CompositeRegistry.ts +140 -0
- package/src/registry/EventRegistry.test.ts +387 -0
- package/src/registry/EventRegistry.ts +191 -0
- package/src/registry/LocalRegistry.ts +416 -0
- package/src/registry/RemoteRegistry.ts +499 -0
- package/src/registry/VersionRegistry.test.ts +223 -0
- package/src/registry/VersionRegistry.ts +121 -0
- package/src/rules/config.test.ts +277 -0
- package/src/rules/config.ts +450 -0
- package/src/rules/engine.test.ts +331 -0
- package/src/rules/engine.ts +448 -0
- package/src/rules/implementations/connection-type-references.ts +117 -0
- package/src/rules/implementations/dead-end-states.ts +101 -0
- package/src/rules/implementations/index.ts +66 -0
- package/src/rules/implementations/minimum-node-sources.ts +84 -0
- package/src/rules/implementations/no-unknown-fields.ts +372 -0
- package/src/rules/implementations/orphaned-edge-types.ts +55 -0
- package/src/rules/implementations/orphaned-node-types.ts +58 -0
- package/src/rules/implementations/required-metadata.ts +52 -0
- package/src/rules/implementations/state-transition-references.ts +155 -0
- package/src/rules/implementations/unreachable-states.ts +94 -0
- package/src/rules/implementations/valid-action-patterns.ts +140 -0
- package/src/rules/implementations/valid-color-format.ts +152 -0
- package/src/rules/implementations/valid-edge-types.ts +273 -0
- package/src/rules/implementations/valid-node-types.ts +200 -0
- package/src/rules/index.ts +92 -0
- package/src/rules/types.ts +426 -0
- package/src/scopes/ScopePathIndex.test.ts +94 -0
- package/src/scopes/ScopePathIndex.ts +89 -0
- package/src/scopes/ScopesCanvasValidator.test.ts +127 -0
- package/src/scopes/ScopesCanvasValidator.ts +305 -0
- package/src/scopes/__tests__/utils.test.ts +383 -0
- package/src/scopes/index.ts +42 -0
- package/src/scopes/utils.ts +182 -0
- package/src/scopes/validateScopeNamespaceNesting.test.ts +127 -0
- package/src/scopes/validateScopeNamespaceNesting.ts +88 -0
- package/src/spans/index.ts +24 -0
- package/src/spans/utils.ts +249 -0
- package/src/storage/topic-types.ts +235 -0
- package/src/storage/topicStore.test.ts +193 -0
- package/src/storage/topicStore.ts +489 -0
- package/src/storyboard/builder.ts +308 -0
- package/src/storyboard/index.ts +26 -0
- package/src/storyboard/types.ts +117 -0
- package/src/telemetry/coverage.ts +480 -0
- package/src/telemetry/event-validator.ts +312 -0
- package/src/types/audit.ts +314 -0
- package/src/types/auxiliary.ts +63 -0
- package/src/types/canvas-scope.ts +190 -0
- package/src/types/canvas.test.ts +199 -0
- package/src/types/canvas.ts +1395 -0
- package/src/types/dashboard.ts +257 -0
- package/src/types/index.ts +460 -0
- package/src/types/library.ts +283 -0
- package/src/types/otel.test.ts +219 -0
- package/src/types/otel.ts +620 -0
- package/src/types/path-based-config.ts +285 -0
- package/src/types/registered-trace.ts +432 -0
- package/src/types/resource-match.ts +263 -0
- package/src/types/subsystem-model.ts +352 -0
- package/src/types/version-registry.ts +150 -0
- package/src/utils/CanvasConverter.ts +670 -0
- package/src/utils/GraphConverter.test.ts +322 -0
- package/src/utils/GraphConverter.ts +84 -0
- package/src/utils/PathMatcher.test.ts +139 -0
- package/src/utils/PathMatcher.ts +185 -0
- package/src/utils/TraceToCanvas.test.ts +310 -0
- package/src/utils/TraceToCanvas.ts +510 -0
- package/src/utils/YamlParser.ts +77 -0
- package/src/utils/registeredTraceHelpers.ts +251 -0
- package/src/utils/traceAggregation.test.ts +385 -0
- package/src/utils/traceAggregation.ts +173 -0
- package/src/validation/OtelCanvasValidator.ts +86 -0
- package/src/validation/index.ts +17 -0
- package/src/validation/libraryValidation.ts +206 -0
- package/src/workflow/README.md +408 -0
- package/src/workflow/__tests__/edge-derivation.test.ts +449 -0
- package/src/workflow/__tests__/edge-validation.test.ts +417 -0
- package/src/workflow/__tests__/scenario-matcher.test.ts +225 -0
- package/src/workflow/__tests__/template-parser.test.ts +276 -0
- package/src/workflow/__tests__/template-renderer.test.ts +509 -0
- package/src/workflow/__tests__/types.test.ts +187 -0
- package/src/workflow/__tests__/validator.test.ts +3225 -0
- package/src/workflow/edge-derivation.ts +265 -0
- package/src/workflow/edge-validation.ts +503 -0
- package/src/workflow/example.ts +330 -0
- package/src/workflow/index.ts +86 -0
- package/src/workflow/scenario-matcher.ts +253 -0
- package/src/workflow/template-parser.ts +350 -0
- package/src/workflow/template-renderer.ts +453 -0
- package/src/workflow/types.ts +511 -0
- package/src/workflow/validator.ts +2737 -0
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Example: Using Generated Types
|
|
4
|
+
*
|
|
5
|
+
* This demonstrates how to use generated types for type-safe event emission.
|
|
6
|
+
* Types are generated from canvas schemas using the type generator.
|
|
7
|
+
*
|
|
8
|
+
* Similar to:
|
|
9
|
+
* - GraphQL Code Generator usage
|
|
10
|
+
* - OpenAPI generated client usage
|
|
11
|
+
* - Protobuf generated message usage
|
|
12
|
+
*
|
|
13
|
+
* NOTE: In real code, you would import from the generated types file:
|
|
14
|
+
* ```typescript
|
|
15
|
+
* import type {
|
|
16
|
+
* GraphConverter,
|
|
17
|
+
* Validation,
|
|
18
|
+
* NodeEmitterByName,
|
|
19
|
+
* } from '@generated/graph-converter-execution.types';
|
|
20
|
+
* ```
|
|
21
|
+
*
|
|
22
|
+
* For this example file, we define the types inline to avoid import errors.
|
|
23
|
+
*/
|
|
24
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
25
|
+
if (k2 === undefined) k2 = k;
|
|
26
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
27
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
28
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
29
|
+
}
|
|
30
|
+
Object.defineProperty(o, k2, desc);
|
|
31
|
+
}) : (function(o, m, k, k2) {
|
|
32
|
+
if (k2 === undefined) k2 = k;
|
|
33
|
+
o[k2] = m[k];
|
|
34
|
+
}));
|
|
35
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
36
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
37
|
+
}) : function(o, v) {
|
|
38
|
+
o["default"] = v;
|
|
39
|
+
});
|
|
40
|
+
var __importStar = (this && this.__importStar) || function (mod) {
|
|
41
|
+
if (mod && mod.__esModule) return mod;
|
|
42
|
+
var result = {};
|
|
43
|
+
if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
|
|
44
|
+
__setModuleDefault(result, mod);
|
|
45
|
+
return result;
|
|
46
|
+
};
|
|
47
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
48
|
+
exports.exampleWithValidator = exports.exampleEventNameChecking = exports.exampleEventHandler = exports.exampleMultipleNodes = exports.GraphConverterService = exports.exampleEventEmitterByName = exports.exampleFullEventEmitter = void 0;
|
|
49
|
+
/**
|
|
50
|
+
* Example 1: Type-safe event emitter with full event objects
|
|
51
|
+
*/
|
|
52
|
+
function exampleFullEventEmitter() {
|
|
53
|
+
// Define an emitter that accepts GraphConverter events
|
|
54
|
+
const emit = (event) => {
|
|
55
|
+
console.log('Event:', event.name);
|
|
56
|
+
console.log('Attributes:', event.attributes);
|
|
57
|
+
};
|
|
58
|
+
// ✅ Valid: all required fields present
|
|
59
|
+
emit({
|
|
60
|
+
name: 'conversion.started',
|
|
61
|
+
attributes: {
|
|
62
|
+
'config.nodeTypes': 2,
|
|
63
|
+
'config.edgeTypes': 1,
|
|
64
|
+
},
|
|
65
|
+
});
|
|
66
|
+
// ✅ Valid: optional field included
|
|
67
|
+
emit({
|
|
68
|
+
name: 'conversion.complete',
|
|
69
|
+
attributes: {
|
|
70
|
+
'result.nodes.count': 5,
|
|
71
|
+
'result.edges.count': 3,
|
|
72
|
+
'duration.ms': 150, // Optional field
|
|
73
|
+
},
|
|
74
|
+
});
|
|
75
|
+
// ❌ TypeScript error: missing required field
|
|
76
|
+
// emit({
|
|
77
|
+
// name: 'conversion.started',
|
|
78
|
+
// attributes: {
|
|
79
|
+
// 'config.nodeTypes': 2,
|
|
80
|
+
// // Missing 'config.edgeTypes' - TypeScript error!
|
|
81
|
+
// },
|
|
82
|
+
// });
|
|
83
|
+
// ❌ TypeScript error: wrong field type
|
|
84
|
+
// emit({
|
|
85
|
+
// name: 'conversion.started',
|
|
86
|
+
// attributes: {
|
|
87
|
+
// 'config.nodeTypes': 'two', // Should be number! TypeScript error!
|
|
88
|
+
// 'config.edgeTypes': 1,
|
|
89
|
+
// },
|
|
90
|
+
// });
|
|
91
|
+
// ❌ TypeScript error: invalid event name
|
|
92
|
+
// emit({
|
|
93
|
+
// name: 'conversion.unknown', // Not a valid event! TypeScript error!
|
|
94
|
+
// attributes: {},
|
|
95
|
+
// });
|
|
96
|
+
}
|
|
97
|
+
exports.exampleFullEventEmitter = exampleFullEventEmitter;
|
|
98
|
+
/**
|
|
99
|
+
* Example 2: Type-safe event emitter by name (more ergonomic)
|
|
100
|
+
*/
|
|
101
|
+
function exampleEventEmitterByName() {
|
|
102
|
+
// Define an emitter that accepts event name + attributes
|
|
103
|
+
const emit = ((eventName, attributes) => {
|
|
104
|
+
console.log('Event:', eventName);
|
|
105
|
+
console.log('Attributes:', attributes);
|
|
106
|
+
});
|
|
107
|
+
// ✅ Valid: TypeScript infers the attributes type based on event name
|
|
108
|
+
emit('conversion.started', {
|
|
109
|
+
'config.nodeTypes': 2,
|
|
110
|
+
'config.edgeTypes': 1,
|
|
111
|
+
});
|
|
112
|
+
// ✅ Valid: TypeScript knows 'duration.ms' is optional for 'conversion.complete'
|
|
113
|
+
emit('conversion.complete', {
|
|
114
|
+
'result.nodes.count': 5,
|
|
115
|
+
'result.edges.count': 3,
|
|
116
|
+
});
|
|
117
|
+
// ✅ Valid: optional field included
|
|
118
|
+
emit('conversion.complete', {
|
|
119
|
+
'result.nodes.count': 5,
|
|
120
|
+
'result.edges.count': 3,
|
|
121
|
+
'duration.ms': 150,
|
|
122
|
+
});
|
|
123
|
+
// ❌ TypeScript error: wrong attributes for this event
|
|
124
|
+
// emit('conversion.started', {
|
|
125
|
+
// 'result.nodes.count': 5, // Wrong attributes! TypeScript error!
|
|
126
|
+
// });
|
|
127
|
+
// ❌ TypeScript error: invalid event name
|
|
128
|
+
// emit('unknown.event', {});
|
|
129
|
+
}
|
|
130
|
+
exports.exampleEventEmitterByName = exampleEventEmitterByName;
|
|
131
|
+
/**
|
|
132
|
+
* Example 3: Production service with type-safe telemetry
|
|
133
|
+
*/
|
|
134
|
+
class GraphConverterService {
|
|
135
|
+
constructor(emitter) {
|
|
136
|
+
this.emit = emitter;
|
|
137
|
+
}
|
|
138
|
+
convert(config) {
|
|
139
|
+
// ✅ Type-safe event emission
|
|
140
|
+
this.emit('conversion.started', {
|
|
141
|
+
'config.nodeTypes': config.nodeTypes.length,
|
|
142
|
+
'config.edgeTypes': config.edgeTypes.length,
|
|
143
|
+
});
|
|
144
|
+
try {
|
|
145
|
+
// ... conversion logic
|
|
146
|
+
// ✅ TypeScript ensures all required fields are present
|
|
147
|
+
this.emit('conversion.complete', {
|
|
148
|
+
'result.nodes.count': 10,
|
|
149
|
+
'result.edges.count': 5,
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
catch (error) {
|
|
153
|
+
// ✅ Type-safe error event
|
|
154
|
+
this.emit('conversion.error', {
|
|
155
|
+
'error.message': error.message,
|
|
156
|
+
'error.phase': 'conversion', // Optional field
|
|
157
|
+
});
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
exports.GraphConverterService = GraphConverterService;
|
|
162
|
+
/**
|
|
163
|
+
* Example 4: Multiple node types
|
|
164
|
+
*/
|
|
165
|
+
function exampleMultipleNodes() {
|
|
166
|
+
// Can use different event types for different nodes
|
|
167
|
+
const emitValidation = ((name, attrs) => {
|
|
168
|
+
console.log('Validation:', name, attrs);
|
|
169
|
+
});
|
|
170
|
+
const emitConverter = ((name, attrs) => {
|
|
171
|
+
console.log('Converter:', name, attrs);
|
|
172
|
+
});
|
|
173
|
+
// ✅ Each emitter is type-safe to its node's events
|
|
174
|
+
emitValidation('validation.started', {
|
|
175
|
+
'config.size': 100,
|
|
176
|
+
});
|
|
177
|
+
emitConverter('conversion.started', {
|
|
178
|
+
'config.nodeTypes': 2,
|
|
179
|
+
'config.edgeTypes': 1,
|
|
180
|
+
});
|
|
181
|
+
// ❌ TypeScript error: can't use validation events with converter emitter
|
|
182
|
+
// emitConverter('validation.started', {
|
|
183
|
+
// 'config.size': 100,
|
|
184
|
+
// });
|
|
185
|
+
}
|
|
186
|
+
exports.exampleMultipleNodes = exampleMultipleNodes;
|
|
187
|
+
/**
|
|
188
|
+
* Example 5: Generic event handler with type narrowing
|
|
189
|
+
*/
|
|
190
|
+
function exampleEventHandler(event) {
|
|
191
|
+
// TypeScript knows the structure based on event name
|
|
192
|
+
switch (event.name) {
|
|
193
|
+
case 'conversion.started':
|
|
194
|
+
// TypeScript knows event.attributes has 'config.nodeTypes' and 'config.edgeTypes'
|
|
195
|
+
console.log(`Starting conversion with ${event.attributes['config.nodeTypes']} node types`);
|
|
196
|
+
break;
|
|
197
|
+
case 'conversion.complete':
|
|
198
|
+
// TypeScript knows event.attributes has 'result.nodes.count' and 'result.edges.count'
|
|
199
|
+
console.log(`Completed: ${event.attributes['result.nodes.count']} nodes`);
|
|
200
|
+
// TypeScript knows 'duration.ms' might be undefined
|
|
201
|
+
if (event.attributes['duration.ms']) {
|
|
202
|
+
console.log(`Duration: ${event.attributes['duration.ms']}ms`);
|
|
203
|
+
}
|
|
204
|
+
break;
|
|
205
|
+
case 'conversion.error':
|
|
206
|
+
// TypeScript knows event.attributes has 'error.message'
|
|
207
|
+
console.error(`Error: ${event.attributes['error.message']}`);
|
|
208
|
+
break;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
exports.exampleEventHandler = exampleEventHandler;
|
|
212
|
+
/**
|
|
213
|
+
* Example 6: Type-safe event name checking
|
|
214
|
+
*/
|
|
215
|
+
function exampleEventNameChecking(eventName) {
|
|
216
|
+
// Type-safe event name validation
|
|
217
|
+
if (isConverterEvent(eventName)) {
|
|
218
|
+
// TypeScript knows eventName is GraphConverter.EventName
|
|
219
|
+
console.log('Valid converter event:', eventName);
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
exports.exampleEventNameChecking = exampleEventNameChecking;
|
|
223
|
+
function isConverterEvent(name) {
|
|
224
|
+
const validNames = [
|
|
225
|
+
'conversion.started',
|
|
226
|
+
'conversion.processingNodes',
|
|
227
|
+
'conversion.processingEdges',
|
|
228
|
+
'conversion.complete',
|
|
229
|
+
'conversion.error',
|
|
230
|
+
];
|
|
231
|
+
return validNames.includes(name);
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* Example 7: Integration with event validator
|
|
235
|
+
*/
|
|
236
|
+
async function exampleWithValidator() {
|
|
237
|
+
const { EventValidator, createValidatedEmitter } = await Promise.resolve().then(() => __importStar(require('../telemetry/event-validator')));
|
|
238
|
+
const fs = await Promise.resolve().then(() => __importStar(require('fs')));
|
|
239
|
+
// Load canvas with schema
|
|
240
|
+
const canvas = JSON.parse(fs.readFileSync('.principal-views/graph-converter-execution.otel.canvas', 'utf-8'));
|
|
241
|
+
const validator = new EventValidator(canvas);
|
|
242
|
+
// Create validated emitter with generated types
|
|
243
|
+
const emit = createValidatedEmitter(validator, 'graph-converter', (eventName, attributes) => {
|
|
244
|
+
console.log('Validated event:', eventName, attributes);
|
|
245
|
+
});
|
|
246
|
+
// ✅ Both type-safe (TypeScript) AND runtime validated (EventValidator)
|
|
247
|
+
emit('conversion.started', {
|
|
248
|
+
'config.nodeTypes': 2,
|
|
249
|
+
'config.edgeTypes': 1,
|
|
250
|
+
});
|
|
251
|
+
// ❌ TypeScript error at compile-time
|
|
252
|
+
// ❌ Runtime validation error
|
|
253
|
+
// emit('conversion.started', {
|
|
254
|
+
// 'config.nodeTypes': 'wrong', // TypeScript + runtime error!
|
|
255
|
+
// });
|
|
256
|
+
}
|
|
257
|
+
exports.exampleWithValidator = exampleWithValidator;
|
|
258
|
+
//# sourceMappingURL=usage-example.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"usage-example.js","sourceRoot":"","sources":["../../src/codegen/usage-example.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Dashboard File Validator
|
|
3
|
+
*
|
|
4
|
+
* Validates dashboard definition files (.dashboard.json) that define metrics,
|
|
5
|
+
* layout, and data sources for observability dashboards.
|
|
6
|
+
*/
|
|
7
|
+
import type { DashboardDefinition } from '../types/dashboard';
|
|
8
|
+
/**
|
|
9
|
+
* Validation error details
|
|
10
|
+
*/
|
|
11
|
+
export interface DashboardValidationError {
|
|
12
|
+
path: string;
|
|
13
|
+
message: string;
|
|
14
|
+
severity: 'error' | 'warning';
|
|
15
|
+
suggestion?: string;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Validation result
|
|
19
|
+
*/
|
|
20
|
+
export interface DashboardValidationResult {
|
|
21
|
+
valid: boolean;
|
|
22
|
+
errors: DashboardValidationError[];
|
|
23
|
+
warnings: DashboardValidationError[];
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Context for cross-reference validation (optional)
|
|
27
|
+
*/
|
|
28
|
+
export interface DashboardValidationContext {
|
|
29
|
+
/** Known storyboard names for source validation */
|
|
30
|
+
storyboards?: string[];
|
|
31
|
+
/** Known workflow names per storyboard */
|
|
32
|
+
workflows?: Record<string, string[]>;
|
|
33
|
+
/** Known event names */
|
|
34
|
+
events?: string[];
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Validator for dashboard definition files
|
|
38
|
+
*/
|
|
39
|
+
export declare class DashboardValidator {
|
|
40
|
+
/**
|
|
41
|
+
* Validate dashboard definition structure
|
|
42
|
+
*/
|
|
43
|
+
validate(data: unknown, filePath?: string, context?: DashboardValidationContext): DashboardValidationResult;
|
|
44
|
+
/**
|
|
45
|
+
* Validate a single metric definition
|
|
46
|
+
*/
|
|
47
|
+
private validateMetric;
|
|
48
|
+
/**
|
|
49
|
+
* Validate a metric source
|
|
50
|
+
*/
|
|
51
|
+
private validateSource;
|
|
52
|
+
/**
|
|
53
|
+
* Validate a metric query
|
|
54
|
+
*/
|
|
55
|
+
private validateQuery;
|
|
56
|
+
/**
|
|
57
|
+
* Validate metric display options
|
|
58
|
+
*/
|
|
59
|
+
private validateDisplay;
|
|
60
|
+
/**
|
|
61
|
+
* Validate dashboard layout
|
|
62
|
+
*/
|
|
63
|
+
private validateLayout;
|
|
64
|
+
/**
|
|
65
|
+
* Validate a layout row
|
|
66
|
+
*/
|
|
67
|
+
private validateRow;
|
|
68
|
+
/**
|
|
69
|
+
* Validate a panel placement
|
|
70
|
+
*/
|
|
71
|
+
private validatePanel;
|
|
72
|
+
/**
|
|
73
|
+
* Validate and throw if invalid
|
|
74
|
+
*/
|
|
75
|
+
validateOrThrow(data: unknown, filePath?: string, context?: DashboardValidationContext): DashboardDefinition;
|
|
76
|
+
/**
|
|
77
|
+
* Format validation result as human-readable report
|
|
78
|
+
*/
|
|
79
|
+
formatReport(result: DashboardValidationResult): string;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Create a new dashboard validator instance
|
|
83
|
+
*/
|
|
84
|
+
export declare function createDashboardValidator(): DashboardValidator;
|
|
85
|
+
//# sourceMappingURL=DashboardValidator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"DashboardValidator.d.ts","sourceRoot":"","sources":["../../src/dashboard/DashboardValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAYpB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAqCD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,0BAA0B,GACnC,yBAAyB;IAmJ5B;;OAEG;IACH,OAAO,CAAC,cAAc;IA+JtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6GtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkErB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsCvB;;OAEG;IACH,OAAO,CAAC,cAAc;IA2DtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAwDnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqFrB;;OAEG;IACH,eAAe,CACb,IAAI,EAAE,OAAO,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,0BAA0B,GACnC,mBAAmB;IAatB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM;CAkCxD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}
|