@pellux/goodvibes-transport-core 0.18.3

package/README.md

@@ -0,0 +1,18 @@
+# @pellux/goodvibes-transport-core
+
+Shared client transport and event-feed primitives used by the GoodVibes SDK packages.
+
+Install:
+
+```bash
+npm install @pellux/goodvibes-transport-core
+```
+
+Use this package only when you are composing your own transport/client abstraction.
+
+Exports include:
+- event envelope helpers
+- runtime event feed primitives
+- generic client transport helpers
+
+Most consumers should use `@pellux/goodvibes-sdk`, `@pellux/goodvibes-operator-sdk`, or `@pellux/goodvibes-peer-sdk` instead.

package/dist/client-transport.d.ts

@@ -0,0 +1,9 @@
+export interface ClientTransport<TKind extends string, TOperator, TPeer> {
+    readonly kind: TKind;
+    readonly operator: TOperator;
+    readonly peer: TPeer;
+    getOperatorClient(): TOperator;
+    getPeerClient(): TPeer;
+}
+export declare function createClientTransport<TKind extends string, TOperator, TPeer>(kind: TKind, operator: TOperator, peer: TPeer): ClientTransport<TKind, TOperator, TPeer>;
+//# sourceMappingURL=client-transport.d.ts.map

package/dist/client-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-transport.d.ts","sourceRoot":"","sources":["../src/client-transport.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK;IACrE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,iBAAiB,IAAI,SAAS,CAAC;IAC/B,aAAa,IAAI,KAAK,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK,EAC1E,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAY1C"}

package/dist/client-transport.js

@@ -0,0 +1,13 @@
+export function createClientTransport(kind, operator, peer) {
+    return Object.freeze({
+        kind,
+        operator,
+        peer,
+        getOperatorClient() {
+            return operator;
+        },
+        getPeerClient() {
+            return peer;
+        },
+    });
+}

package/dist/event-envelope.d.ts

@@ -0,0 +1,21 @@
+export interface EventEnvelope<TType extends string, TPayload> {
+    readonly type: TType;
+    readonly ts: number;
+    readonly traceId: string;
+    readonly sessionId: string;
+    readonly turnId?: string;
+    readonly agentId?: string;
+    readonly taskId?: string;
+    readonly source: string;
+    readonly payload: TPayload;
+}
+export interface EventEnvelopeContext {
+    readonly sessionId: string;
+    readonly source: string;
+    readonly traceId?: string;
+    readonly turnId?: string;
+    readonly agentId?: string;
+    readonly taskId?: string;
+}
+export declare function createEventEnvelope<TType extends string, TPayload>(type: TType, payload: TPayload, context: EventEnvelopeContext): EventEnvelope<TType, TPayload>;
+//# sourceMappingURL=event-envelope.d.ts.map

package/dist/event-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-envelope.d.ts","sourceRoot":"","sources":["../src/event-envelope.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ;IAC3D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,EAChE,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAYhC"}

package/dist/event-envelope.js

@@ -0,0 +1,16 @@
+function generateTraceId() {
+    return crypto.randomUUID();
+}
+export function createEventEnvelope(type, payload, context) {
+    return Object.freeze({
+        type,
+        ts: Date.now(),
+        traceId: context.traceId ?? generateTraceId(),
+        sessionId: context.sessionId,
+        turnId: context.turnId,
+        agentId: context.agentId,
+        taskId: context.taskId,
+        source: context.source,
+        payload,
+    });
+}

package/dist/event-feeds.d.ts

@@ -0,0 +1,22 @@
+import type { EventEnvelope } from './event-envelope.js';
+type EventLike = {
+    readonly type: string;
+};
+type EventForType<TEvent extends EventLike, TType extends TEvent['type']> = Extract<TEvent, {
+    type: TType;
+}>;
+export interface RuntimeEventFeed<TEvent extends EventLike = EventLike> {
+    on<TType extends TEvent['type']>(type: TType, listener: (payload: EventForType<TEvent, TType>) => void): () => void;
+    onEnvelope<TType extends TEvent['type']>(type: TType, listener: (envelope: EventEnvelope<TType, EventForType<TEvent, TType>>) => void): () => void;
+}
+export type RuntimeEventFeeds<TDomain extends string, TEvent extends EventLike = EventLike> = {
+    readonly domains: readonly TDomain[];
+    domain(domain: TDomain): RuntimeEventFeed<TEvent>;
+} & {
+    readonly [K in TDomain]: RuntimeEventFeed<TEvent>;
+};
+export type EnvelopeSubscriber<TEvent extends EventLike> = <TType extends TEvent['type']>(type: TType, listener: (envelope: EventEnvelope<TType, EventForType<TEvent, TType>>) => void) => () => void;
+export declare function createRuntimeEventFeed<TEvent extends EventLike>(subscribe: EnvelopeSubscriber<TEvent>): RuntimeEventFeed<TEvent>;
+export declare function createRuntimeEventFeeds<TDomain extends string, TEvent extends EventLike>(domains: readonly TDomain[], createFeed: (domain: TDomain) => RuntimeEventFeed<TEvent>): RuntimeEventFeeds<TDomain, TEvent>;
+export {};
+//# sourceMappingURL=event-feeds.d.ts.map

package/dist/event-feeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-feeds.d.ts","sourceRoot":"","sources":["../src/event-feeds.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,KAAK,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,KAAK,YAAY,CACf,MAAM,SAAS,SAAS,EACxB,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,IAC1B,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAErC,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACpE,EAAE,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,GACvD,MAAM,IAAI,CAAC;IACd,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACrC,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,GAC9E,MAAM,IAAI,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,CAC3B,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,GAAG,SAAS,IAClC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACnD,GAAG;IACF,QAAQ,EAAE,CAAC,IAAI,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACtF,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,KAC5E,MAAM,IAAI,CAAC;AAEhB,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,SAAS,EAC7D,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACpC,gBAAgB,CAAC,MAAM,CAAC,CAiB1B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,EAExB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,gBAAgB,CAAC,MAAM,CAAC,GACxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAYpC"}

package/dist/event-feeds.js

@@ -0,0 +1,25 @@
+export function createRuntimeEventFeed(subscribe) {
+    return {
+        on(type, listener) {
+            return subscribe(type, (envelope) => {
+                listener(envelope.payload);
+            });
+        },
+        onEnvelope(type, listener) {
+            return subscribe(type, listener);
+        },
+    };
+}
+export function createRuntimeEventFeeds(domains, createFeed) {
+    const feeds = {};
+    for (const domain of domains) {
+        feeds[domain] = createFeed(domain);
+    }
+    return Object.freeze({
+        ...feeds,
+        domains,
+        domain(domain) {
+            return feeds[domain];
+        },
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { EventEnvelope, EventEnvelopeContext } from './event-envelope.js';
+export { createEventEnvelope } from './event-envelope.js';
+export type { RuntimeEventFeed, RuntimeEventFeeds, EnvelopeSubscriber } from './event-feeds.js';
+export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
+export type { ClientTransport } from './client-transport.js';
+export { createClientTransport } from './client-transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createEventEnvelope } from './event-envelope.js';
+export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
+export { createClientTransport } from './client-transport.js';

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@pellux/goodvibes-transport-core",
+  "version": "0.18.3",
+  "description": "Shared GoodVibes client transport primitives for direct, HTTP, and realtime integrations.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mgd34msu/goodvibes-sdk/issues"
+  },
+  "homepage": "https://github.com/mgd34msu/goodvibes-sdk",
+  "keywords": [
+    "goodvibes",
+    "sdk",
+    "transport",
+    "events",
+    "client"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}