@pellux/goodvibes-operator-sdk 0.18.3

package/README.md

@@ -0,0 +1,26 @@
+# @pellux/goodvibes-operator-sdk
+
+Contract-driven HTTP client for the GoodVibes operator and control-plane APIs.
+
+Install:
+
+```bash
+npm install @pellux/goodvibes-operator-sdk
+```
+
+```ts
+import { createOperatorSdk } from '@pellux/goodvibes-operator-sdk';
+
+const operator = createOperatorSdk({
+  baseUrl: 'http://127.0.0.1:3210',
+  authToken: process.env.GOODVIBES_TOKEN,
+});
+
+const snapshot = await operator.control.snapshot();
+const login = await operator.invoke('control.auth.login', {
+  username: 'alice',
+  password: 'secret',
+});
+```
+
+Use this package when you want only the operator/control-plane surface and do not need the umbrella SDK composition layer.

package/dist/client-core.d.ts

@@ -0,0 +1,104 @@
+import type { OperatorContractManifest, OperatorMethodContract } from '@pellux/goodvibes-contracts';
+import type { OperatorMethodInput, OperatorMethodOutput, OperatorStreamMethodId, OperatorTypedMethodId } from '@pellux/goodvibes-contracts';
+import type { HttpTransport } from '@pellux/goodvibes-transport-http';
+import { type ContractInvokeOptions, type ContractStreamOptions } from '@pellux/goodvibes-transport-http';
+export interface OperatorRemoteClientInvokeOptions extends ContractInvokeOptions {
+}
+export interface OperatorRemoteClientStreamOptions extends ContractStreamOptions {
+}
+type RequiredKeys<T extends object> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type MethodArgs<TInput, TOptions> = [
+    TInput
+] extends [undefined] ? [input?: undefined, options?: TOptions] : TInput extends object ? [RequiredKeys<TInput>] extends [never] ? [input?: TInput, options?: TOptions] : [input: TInput, options?: TOptions] : [input: TInput, options?: TOptions];
+type WithoutKeys<TInput, TKeys extends PropertyKey> = [
+    TInput
+] extends [undefined] ? undefined : TInput extends object ? Omit<TInput, Extract<keyof TInput, TKeys>> : TInput;
+type KnownMethodArgs<TMethodId extends OperatorTypedMethodId> = MethodArgs<OperatorMethodInput<TMethodId>, OperatorRemoteClientInvokeOptions>;
+type KnownPathMethodArgs<TMethodId extends OperatorTypedMethodId, TKeys extends PropertyKey> = MethodArgs<WithoutKeys<OperatorMethodInput<TMethodId>, TKeys>, OperatorRemoteClientInvokeOptions>;
+type KnownStreamArgs<TMethodId extends OperatorStreamMethodId> = MethodArgs<OperatorMethodInput<TMethodId>, OperatorRemoteClientStreamOptions>;
+export interface OperatorRemoteClient {
+    readonly transport: HttpTransport;
+    readonly contract: OperatorContractManifest;
+    listMethods(): readonly OperatorMethodContract[];
+    getMethod(methodId: string): OperatorMethodContract;
+    invoke<TMethodId extends OperatorTypedMethodId>(methodId: TMethodId, ...args: KnownMethodArgs<TMethodId>): Promise<OperatorMethodOutput<TMethodId>>;
+    invoke<T = unknown>(methodId: string, input?: Record<string, unknown>, options?: OperatorRemoteClientInvokeOptions): Promise<T>;
+    stream<TMethodId extends OperatorStreamMethodId>(methodId: TMethodId, ...args: KnownStreamArgs<TMethodId>): Promise<() => void>;
+    readonly sessions: {
+        create(...args: KnownMethodArgs<'sessions.create'>): Promise<OperatorMethodOutput<'sessions.create'>>;
+        get(sessionId: string, ...args: KnownPathMethodArgs<'sessions.get', 'sessionId'>): Promise<OperatorMethodOutput<'sessions.get'>>;
+        list(...args: KnownMethodArgs<'sessions.list'>): Promise<OperatorMethodOutput<'sessions.list'>>;
+        messages: {
+            create(sessionId: string, ...args: KnownPathMethodArgs<'sessions.messages.create', 'sessionId'>): Promise<OperatorMethodOutput<'sessions.messages.create'>>;
+            list(sessionId: string, ...args: KnownPathMethodArgs<'sessions.messages.list', 'sessionId'>): Promise<OperatorMethodOutput<'sessions.messages.list'>>;
+        };
+        inputs: {
+            cancel(sessionId: string, inputId: string, ...args: KnownPathMethodArgs<'sessions.inputs.cancel', 'sessionId' | 'inputId'>): Promise<OperatorMethodOutput<'sessions.inputs.cancel'>>;
+        };
+        followUp(...args: KnownMethodArgs<'sessions.followUp'>): Promise<OperatorMethodOutput<'sessions.followUp'>>;
+        steer(...args: KnownMethodArgs<'sessions.steer'>): Promise<OperatorMethodOutput<'sessions.steer'>>;
+        close(sessionId: string, ...args: KnownPathMethodArgs<'sessions.close', 'sessionId'>): Promise<OperatorMethodOutput<'sessions.close'>>;
+        reopen(sessionId: string, ...args: KnownPathMethodArgs<'sessions.reopen', 'sessionId'>): Promise<OperatorMethodOutput<'sessions.reopen'>>;
+    };
+    readonly tasks: {
+        create(...args: KnownMethodArgs<'tasks.create'>): Promise<OperatorMethodOutput<'tasks.create'>>;
+        get(taskId: string, ...args: KnownPathMethodArgs<'tasks.get', 'taskId'>): Promise<OperatorMethodOutput<'tasks.get'>>;
+        list(...args: KnownMethodArgs<'tasks.list'>): Promise<OperatorMethodOutput<'tasks.list'>>;
+        status(...args: KnownMethodArgs<'tasks.status'>): Promise<OperatorMethodOutput<'tasks.status'>>;
+        cancel(taskId: string, ...args: KnownPathMethodArgs<'tasks.cancel', 'taskId'>): Promise<OperatorMethodOutput<'tasks.cancel'>>;
+        retry(taskId: string, ...args: KnownPathMethodArgs<'tasks.retry', 'taskId'>): Promise<OperatorMethodOutput<'tasks.retry'>>;
+    };
+    readonly approvals: {
+        list(...args: KnownMethodArgs<'approvals.list'>): Promise<OperatorMethodOutput<'approvals.list'>>;
+        claim(approvalId: string, ...args: KnownPathMethodArgs<'approvals.claim', 'approvalId'>): Promise<OperatorMethodOutput<'approvals.claim'>>;
+        approve(approvalId: string, ...args: KnownPathMethodArgs<'approvals.approve', 'approvalId'>): Promise<OperatorMethodOutput<'approvals.approve'>>;
+        deny(approvalId: string, ...args: KnownPathMethodArgs<'approvals.deny', 'approvalId'>): Promise<OperatorMethodOutput<'approvals.deny'>>;
+        cancel(approvalId: string, ...args: KnownPathMethodArgs<'approvals.cancel', 'approvalId'>): Promise<OperatorMethodOutput<'approvals.cancel'>>;
+    };
+    readonly providers: {
+        list(...args: KnownMethodArgs<'providers.list'>): Promise<OperatorMethodOutput<'providers.list'>>;
+        get(providerId: string, ...args: KnownPathMethodArgs<'providers.get', 'providerId'>): Promise<OperatorMethodOutput<'providers.get'>>;
+        usage(providerId: string, ...args: KnownPathMethodArgs<'providers.usage.get', 'providerId'>): Promise<OperatorMethodOutput<'providers.usage.get'>>;
+    };
+    readonly accounts: {
+        snapshot(...args: KnownMethodArgs<'accounts.snapshot'>): Promise<OperatorMethodOutput<'accounts.snapshot'>>;
+    };
+    readonly localAuth: {
+        status(...args: KnownMethodArgs<'local_auth.status'>): Promise<OperatorMethodOutput<'local_auth.status'>>;
+    };
+    readonly control: {
+        snapshot(...args: KnownMethodArgs<'control.snapshot'>): Promise<OperatorMethodOutput<'control.snapshot'>>;
+        status(...args: KnownMethodArgs<'control.status'>): Promise<OperatorMethodOutput<'control.status'>>;
+        contract(...args: KnownMethodArgs<'control.contract'>): Promise<OperatorMethodOutput<'control.contract'>>;
+        methods: {
+            list(...args: KnownMethodArgs<'control.methods.list'>): Promise<OperatorMethodOutput<'control.methods.list'>>;
+            get(methodId: string, ...args: KnownPathMethodArgs<'control.methods.get', 'methodId'>): Promise<OperatorMethodOutput<'control.methods.get'>>;
+        };
+        auth: {
+            current(...args: KnownMethodArgs<'control.auth.current'>): Promise<OperatorMethodOutput<'control.auth.current'>>;
+            login(...args: KnownMethodArgs<'control.auth.login'>): Promise<OperatorMethodOutput<'control.auth.login'>>;
+        };
+        events: {
+            catalog(...args: KnownMethodArgs<'control.events.catalog'>): Promise<OperatorMethodOutput<'control.events.catalog'>>;
+            stream(...args: KnownStreamArgs<'control.events.stream'>): Promise<() => void>;
+        };
+    };
+    readonly telemetry: {
+        snapshot(...args: KnownMethodArgs<'telemetry.snapshot'>): Promise<OperatorMethodOutput<'telemetry.snapshot'>>;
+        events(...args: KnownMethodArgs<'telemetry.events.list'>): Promise<OperatorMethodOutput<'telemetry.events.list'>>;
+        errors(...args: KnownMethodArgs<'telemetry.errors.list'>): Promise<OperatorMethodOutput<'telemetry.errors.list'>>;
+        traces(...args: KnownMethodArgs<'telemetry.traces.list'>): Promise<OperatorMethodOutput<'telemetry.traces.list'>>;
+        metrics(...args: KnownMethodArgs<'telemetry.metrics.get'>): Promise<OperatorMethodOutput<'telemetry.metrics.get'>>;
+        otlp: {
+            traces(...args: KnownMethodArgs<'telemetry.otlp.traces'>): Promise<OperatorMethodOutput<'telemetry.otlp.traces'>>;
+            logs(...args: KnownMethodArgs<'telemetry.otlp.logs'>): Promise<OperatorMethodOutput<'telemetry.otlp.logs'>>;
+            metrics(...args: KnownMethodArgs<'telemetry.otlp.metrics'>): Promise<OperatorMethodOutput<'telemetry.otlp.metrics'>>;
+        };
+        stream(...args: KnownStreamArgs<'telemetry.stream'>): Promise<() => void>;
+    };
+}
+export declare function createOperatorRemoteClient(transport: HttpTransport, contract: OperatorContractManifest): OperatorRemoteClient;
+export {};
+//# sourceMappingURL=client-core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-core.d.ts","sourceRoot":"","sources":["../src/client-core.ts"],"names":[],"mappings":"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"}

package/dist/client-core.js

@@ -0,0 +1,184 @@
+import { buildContractInput, invokeContractRoute, openContractRouteStream, requireContractRoute, } from '@pellux/goodvibes-transport-http';
+function splitArgs(args) {
+    return args;
+}
+function requireMethod(contract, methodId) {
+    return requireContractRoute(contract.operator.methods, methodId, 'operator method');
+}
+function requireMethodRoute(contract, methodId) {
+    const method = requireMethod(contract, methodId);
+    if (!method.http) {
+        throw new Error(`Operator method "${methodId}" does not expose an HTTP binding`);
+    }
+    return method.http;
+}
+export function createOperatorRemoteClient(transport, contract) {
+    function invokeTyped(methodId, input, options = {}) {
+        return invokeContractRoute(transport, requireMethodRoute(contract, methodId), input, options);
+    }
+    function streamTyped(methodId, ...args) {
+        const [input, options] = splitArgs(args);
+        return openContractRouteStream(transport, requireMethodRoute(contract, methodId), input, options ?? { handlers: {} });
+    }
+    const client = {
+        transport,
+        contract,
+        listMethods() {
+            return contract.operator.methods;
+        },
+        getMethod(methodId) {
+            return requireMethod(contract, methodId);
+        },
+        invoke: invokeTyped,
+        stream: streamTyped,
+        sessions: {
+            create: (...args) => invokeTyped('sessions.create', ...args),
+            get: (sessionId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('sessions.get', buildContractInput('sessionId', sessionId, input), options);
+            },
+            list: (...args) => invokeTyped('sessions.list', ...args),
+            messages: {
+                create: (sessionId, ...args) => {
+                    const [input, options] = splitArgs(args);
+                    return invokeTyped('sessions.messages.create', buildContractInput('sessionId', sessionId, input), options);
+                },
+                list: (sessionId, ...args) => {
+                    const [input, options] = splitArgs(args);
+                    return invokeTyped('sessions.messages.list', buildContractInput('sessionId', sessionId, input), options);
+                },
+            },
+            inputs: {
+                cancel: (sessionId, inputId, ...args) => {
+                    const [input, options] = splitArgs(args);
+                    return invokeTyped('sessions.inputs.cancel', {
+                        sessionId,
+                        inputId,
+                        ...(input ?? {}),
+                    }, options);
+                },
+            },
+            followUp: (...args) => invokeTyped('sessions.followUp', ...args),
+            steer: (...args) => invokeTyped('sessions.steer', ...args),
+            close: (sessionId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('sessions.close', {
+                    sessionId,
+                    ...(input ?? {}),
+                }, options);
+            },
+            reopen: (sessionId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('sessions.reopen', {
+                    sessionId,
+                    ...(input ?? {}),
+                }, options);
+            },
+        },
+        tasks: {
+            create: (...args) => invokeTyped('tasks.create', ...args),
+            get: (taskId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('tasks.get', {
+                    taskId,
+                    ...(input ?? {}),
+                }, options);
+            },
+            list: (...args) => invokeTyped('tasks.list', ...args),
+            status: (...args) => invokeTyped('tasks.status', ...args),
+            cancel: (taskId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('tasks.cancel', {
+                    taskId,
+                    ...(input ?? {}),
+                }, options);
+            },
+            retry: (taskId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('tasks.retry', {
+                    taskId,
+                    ...(input ?? {}),
+                }, options);
+            },
+        },
+        approvals: {
+            list: (...args) => invokeTyped('approvals.list', ...args),
+            claim: (approvalId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('approvals.claim', buildContractInput('approvalId', approvalId, input), options);
+            },
+            approve: (approvalId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('approvals.approve', buildContractInput('approvalId', approvalId, input), options);
+            },
+            deny: (approvalId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('approvals.deny', buildContractInput('approvalId', approvalId, input), options);
+            },
+            cancel: (approvalId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('approvals.cancel', buildContractInput('approvalId', approvalId, input), options);
+            },
+        },
+        providers: {
+            list: (...args) => invokeTyped('providers.list', ...args),
+            get: (providerId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('providers.get', {
+                    providerId,
+                    ...(input ?? {}),
+                }, options);
+            },
+            usage: (providerId, ...args) => {
+                const [input, options] = splitArgs(args);
+                return invokeTyped('providers.usage.get', {
+                    providerId,
+                    ...(input ?? {}),
+                }, options);
+            },
+        },
+        accounts: {
+            snapshot: (...args) => invokeTyped('accounts.snapshot', ...args),
+        },
+        localAuth: {
+            status: (...args) => invokeTyped('local_auth.status', ...args),
+        },
+        control: {
+            snapshot: (...args) => invokeTyped('control.snapshot', ...args),
+            status: (...args) => invokeTyped('control.status', ...args),
+            contract: (...args) => invokeTyped('control.contract', ...args),
+            methods: {
+                list: (...args) => invokeTyped('control.methods.list', ...args),
+                get: (methodId, ...args) => {
+                    const [input, options] = splitArgs(args);
+                    return invokeTyped('control.methods.get', {
+                        methodId,
+                        ...(input ?? {}),
+                    }, options);
+                },
+            },
+            auth: {
+                current: (...args) => invokeTyped('control.auth.current', ...args),
+                login: (...args) => invokeTyped('control.auth.login', ...args),
+            },
+            events: {
+                catalog: (...args) => invokeTyped('control.events.catalog', ...args),
+                stream: (...args) => streamTyped('control.events.stream', ...args),
+            },
+        },
+        telemetry: {
+            snapshot: (...args) => invokeTyped('telemetry.snapshot', ...args),
+            events: (...args) => invokeTyped('telemetry.events.list', ...args),
+            errors: (...args) => invokeTyped('telemetry.errors.list', ...args),
+            traces: (...args) => invokeTyped('telemetry.traces.list', ...args),
+            metrics: (...args) => invokeTyped('telemetry.metrics.get', ...args),
+            otlp: {
+                traces: (...args) => invokeTyped('telemetry.otlp.traces', ...args),
+                logs: (...args) => invokeTyped('telemetry.otlp.logs', ...args),
+                metrics: (...args) => invokeTyped('telemetry.otlp.metrics', ...args),
+            },
+            stream: (...args) => streamTyped('telemetry.stream', ...args),
+        },
+    };
+    return client;
+}

package/dist/client.d.ts

@@ -0,0 +1,16 @@
+import type { OperatorMethodContract, OperatorMethodId } from '@pellux/goodvibes-contracts';
+import { type HttpTransport, type HttpTransportOptions, type ServerSentEventHandlers } from '@pellux/goodvibes-transport-http';
+import { type OperatorRemoteClient, type OperatorRemoteClientInvokeOptions, type OperatorRemoteClientStreamOptions } from './client-core.js';
+export interface OperatorSdkOptions extends HttpTransportOptions {
+}
+export interface OperatorInvokeOptions extends OperatorRemoteClientInvokeOptions {
+}
+export interface OperatorStreamOptions extends OperatorRemoteClientStreamOptions {
+    readonly handlers: ServerSentEventHandlers;
+}
+export type OperatorSdk = Omit<OperatorRemoteClient, 'getMethod'> & {
+    readonly transport: HttpTransport;
+    getMethod(methodId: OperatorMethodId): OperatorMethodContract;
+};
+export declare function createOperatorSdk(options: OperatorSdkOptions): OperatorSdk;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACvC,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;CAAG;AAEnE,MAAM,WAAW,qBAAsB,SAAQ,iCAAiC;CAAG;AAEnF,MAAM,WAAW,qBAAsB,SAAQ,iCAAiC;IAC9E,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,MAAM,WAAW,GACnB,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GACvC;IACA,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,sBAAsB,CAAC;CAC/D,CAAC;AAEJ,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAG1E"}

package/dist/client.js

@@ -0,0 +1,7 @@
+import { getOperatorContract } from '@pellux/goodvibes-contracts';
+import { createHttpTransport, } from '@pellux/goodvibes-transport-http';
+import { createOperatorRemoteClient, } from './client-core.js';
+export function createOperatorSdk(options) {
+    const transport = createHttpTransport(options);
+    return createOperatorRemoteClient(transport, getOperatorContract());
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { OperatorInvokeOptions, OperatorSdk, OperatorSdkOptions, OperatorStreamOptions, } from './client.js';
+export { createOperatorSdk } from './client.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,EACV,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { createOperatorSdk } from './client.js';

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@pellux/goodvibes-operator-sdk",
+  "version": "0.18.3",
+  "description": "Contract-driven HTTP client for the GoodVibes operator and control-plane APIs.",
+  "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",
+    "operator",
+    "control-plane",
+    "client"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pellux/goodvibes-contracts": "0.18.3",
+    "@pellux/goodvibes-errors": "0.18.3",
+    "@pellux/goodvibes-transport-http": "0.18.3"
+  }
+}