@stackwright-services/runtime 0.1.0 → 0.3.0

package/dist/index.d.mts

@@ -689,7 +689,7 @@ interface DataSourceDescriptor {
      */
     id: string;
     /** Transport protocol this source is backed by */
-    transport: 'openapi' | 'pulse';
+    transport: 'openapi' | 'pulse' | 'websocket' | 'sse';
     /** List of named operations this source supports */
     operations: string[];
     /** Human-readable description (optional, from adapter metadata) */
@@ -794,14 +794,30 @@ declare const noopDataSourceProvider: NoopDataSourceProvider;
  * });
  * ```
  *
+ * @example Streaming WebSocket/SSE provider
+ * ```typescript
+ * const provider = createDataSourceProvider({
+ *   provider: 'websocket',
+ *   config: {
+ *     sources: [{
+ *       id: 'ais-vessels',
+ *       transport: 'websocket',
+ *       operations: { getLatestPositions: () => vesselCache.snapshot() },
+ *     }],
+ *   },
+ * });
+ * ```
+ *
  * @example Environment-level override (force noop in isolated tests)
  * ```bash
  * DATA_SOURCE_PROVIDER=noop node my-service.js
  * DATA_SOURCE_PROVIDER=pulse node my-service.js  # force pulse even if openapi is installed
+ * DATA_SOURCE_PROVIDER=websocket node my-service.js  # force streaming (WebSocket)
+ * DATA_SOURCE_PROVIDER=sse node my-service.js  # force streaming (SSE)
  * ```
  */
 declare function createDataSourceProvider(options?: {
-    /** Override the provider type ('openapi' | 'pulse' | 'noop') */
+    /** Override the provider type ('openapi' | 'pulse' | 'websocket' | 'sse' | 'noop') */
     provider?: string;
     /** Provider-specific config passed through to the adapter */
     config?: Record<string, unknown>;

package/dist/index.d.ts

@@ -689,7 +689,7 @@ interface DataSourceDescriptor {
      */
     id: string;
     /** Transport protocol this source is backed by */
-    transport: 'openapi' | 'pulse';
+    transport: 'openapi' | 'pulse' | 'websocket' | 'sse';
     /** List of named operations this source supports */
     operations: string[];
     /** Human-readable description (optional, from adapter metadata) */
@@ -794,14 +794,30 @@ declare const noopDataSourceProvider: NoopDataSourceProvider;
  * });
  * ```
  *
+ * @example Streaming WebSocket/SSE provider
+ * ```typescript
+ * const provider = createDataSourceProvider({
+ *   provider: 'websocket',
+ *   config: {
+ *     sources: [{
+ *       id: 'ais-vessels',
+ *       transport: 'websocket',
+ *       operations: { getLatestPositions: () => vesselCache.snapshot() },
+ *     }],
+ *   },
+ * });
+ * ```
+ *
  * @example Environment-level override (force noop in isolated tests)
  * ```bash
  * DATA_SOURCE_PROVIDER=noop node my-service.js
  * DATA_SOURCE_PROVIDER=pulse node my-service.js  # force pulse even if openapi is installed
+ * DATA_SOURCE_PROVIDER=websocket node my-service.js  # force streaming (WebSocket)
+ * DATA_SOURCE_PROVIDER=sse node my-service.js  # force streaming (SSE)
  * ```
  */
 declare function createDataSourceProvider(options?: {
-    /** Override the provider type ('openapi' | 'pulse' | 'noop') */
+    /** Override the provider type ('openapi' | 'pulse' | 'websocket' | 'sse' | 'noop') */
     provider?: string;
     /** Provider-specific config passed through to the adapter */
     config?: Record<string, unknown>;

package/dist/index.js

@@ -856,6 +856,7 @@ var OpenApiDataSourceProvider = class {
     this.config = config;
     this.sourcesMap = new Map(config.sources.map((s) => [s.id, s]));
   }
+  config;
   name = "openapi";
   sourcesMap;
   listSources() {
@@ -903,6 +904,7 @@ var PulseDataSourceProvider = class {
     this.config = config;
     this.sourcesMap = new Map(config.sources.map((s) => [s.id, s]));
   }
+  config;
   name = "pulse";
   sourcesMap;
   listSources() {
@@ -943,6 +945,51 @@ function listDataSources2() {
   return [];
 }
 
+// src/datasource/streaming-adapter.ts
+var LOG_PREFIX4 = "stackwright-services:datasource:streaming";
+var StreamingDataSourceProvider = class {
+  constructor(config) {
+    this.config = config;
+    this.sourcesMap = new Map(config.sources.map((s) => [s.id, s]));
+  }
+  config;
+  name = "streaming";
+  sourcesMap;
+  listSources() {
+    return Array.from(this.sourcesMap.values()).map((s) => ({
+      id: s.id,
+      transport: s.transport,
+      operations: Object.keys(s.operations),
+      ...s.description !== void 0 && { description: s.description }
+    }));
+  }
+  async execute(source, operation, params) {
+    const registration = this.sourcesMap.get(source);
+    if (!registration) {
+      const knownSources = Array.from(this.sourcesMap.keys());
+      return Promise.reject(
+        new Error(
+          `${LOG_PREFIX4} Unknown source "${source}". ` + (knownSources.length > 0 ? `Known sources: ${knownSources.join(", ")}.` : "No sources are registered. Pass sources in StreamingAdapterConfig.")
+        )
+      );
+    }
+    const handler = registration.operations[operation];
+    if (!handler) {
+      const knownOps = Object.keys(registration.operations);
+      return Promise.reject(
+        new Error(
+          `${LOG_PREFIX4} Unknown operation "${operation}" on source "${source}". ` + (knownOps.length > 0 ? `Known operations: ${knownOps.join(", ")}.` : "No operations are registered for this source.")
+        )
+      );
+    }
+    const data = await handler(params);
+    return { data };
+  }
+};
+function createStreamingDataSourceProvider(config) {
+  return new StreamingDataSourceProvider(config);
+}
+
 // src/datasource/factory.ts
 function createDataSourceProvider(options) {
   const providerType = options?.provider ?? process.env["DATA_SOURCE_PROVIDER"] ?? _autoDiscover();
@@ -959,6 +1006,12 @@ function createDataSourceProvider(options) {
         options?.config ?? { sources: [] }
       );
     }
+    case "websocket":
+    case "sse": {
+      return createStreamingDataSourceProvider(
+        options?.config ?? { sources: [] }
+      );
+    }
     default:
       if (providerType !== "noop") {
         console.warn(
@@ -976,7 +1029,10 @@ function _autoDiscover() {
     // registration and does NOT trigger auto-discovery.
     { pkg: "@stackwright-pro/openapi/datasource-adapter", providerType: "openapi" },
     // @stackwright-pro/pulse follows the same pattern for Pulse-backed data sources.
-    { pkg: "@stackwright-pro/pulse/datasource-adapter", providerType: "pulse" }
+    { pkg: "@stackwright-pro/pulse/datasource-adapter", providerType: "pulse" },
+    // @stackwright-pro/pulse also ships a streaming-datasource-adapter for WebSocket/SSE sources.
+    // websocket wins if both pulse and streaming are installed (use DATA_SOURCE_PROVIDER to override).
+    { pkg: "@stackwright-pro/pulse/streaming-datasource-adapter", providerType: "websocket" }
   ];
   for (const { pkg, providerType } of candidates) {
     try {