@pinixai/hub-client 0.1.0

package/src/helpers.ts

@@ -0,0 +1,47 @@
+import type { Client } from "@connectrpc/connect";
+import type { HubService } from "./gen/hub_pb";
+
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+
+/**
+ * Invoke a clip command via Hub and aggregate streaming output into a single result.
+ *
+ * The Hub's Invoke RPC is server-streaming: each response carries a chunk of output.
+ * This helper collects all chunks and returns the parsed JSON result.
+ */
+export async function hubInvoke(
+  client: Client<typeof HubService>,
+  clipName: string,
+  command: string,
+  input: unknown,
+  clipToken?: string,
+): Promise<unknown> {
+  const inputBytes = encoder.encode(JSON.stringify(input));
+  let outputBytes = new Uint8Array(0);
+
+  for await (const response of client.invoke({
+    clipName,
+    command,
+    input: inputBytes,
+    clipToken: clipToken ?? "",
+  })) {
+    if (response.error) {
+      throw new Error(
+        response.error.message || response.error.code || "Hub invoke error",
+      );
+    }
+
+    if (response.output.length > 0) {
+      const merged = new Uint8Array(outputBytes.length + response.output.length);
+      merged.set(outputBytes);
+      merged.set(response.output, outputBytes.length);
+      outputBytes = merged;
+    }
+  }
+
+  if (outputBytes.length === 0) return undefined;
+
+  const text = decoder.decode(outputBytes);
+  return JSON.parse(text) as unknown;
+}

package/src/index.ts

@@ -0,0 +1,36 @@
+export { createHubClient, type HubClientOptions } from "./client";
+export { hubInvoke } from "./helpers";
+
+export {
+  HubService,
+  type ClipInfo,
+  type CommandInfo,
+  type ClipManifest,
+  type ProviderInfo,
+  type DependencySlot,
+  type ClipBinding,
+  type InvokeRequest,
+  type InvokeResponse,
+  type ListClipsRequest,
+  type ListClipsResponse,
+  type ListProvidersRequest,
+  type ListProvidersResponse,
+  type GetManifestRequest,
+  type GetManifestResponse,
+  type GetClipWebRequest,
+  type GetClipWebResponse,
+  type AddClipRequest,
+  type AddClipResponse,
+  type RemoveClipRequest,
+  type RemoveClipResponse,
+  type GetBindingsRequest,
+  type GetBindingsResponse,
+  type SetBindingRequest,
+  type SetBindingResponse,
+  type RemoveBindingRequest,
+  type RemoveBindingResponse,
+  type HubError,
+  type ClipStatus,
+} from "./gen/hub_pb";
+
+export type { Interceptor } from "@connectrpc/connect";