@f-inverse/jammi-client 0.14.0

package/dist/gen/jammi/v1/trigger_pb.js

@@ -0,0 +1,80 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=ts"
+// @generated from file jammi/v1/trigger.proto (package jammi.v1.trigger, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_empty, file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file jammi/v1/trigger.proto.
+ */
+export const file_jammi_v1_trigger = /*@__PURE__*/ fileDesc("ChZqYW1taS92MS90cmlnZ2VyLnByb3RvEhBqYW1taS52MS50cmlnZ2VyItIBChRSZWdpc3RlclRvcGljUmVxdWVzdBIMCgRuYW1lGAEgASgJEg4KBnNjaGVtYRgCIAEoDBJTCg9icm9rZXJfbWV0YWRhdGEYAyADKAsyOi5qYW1taS52MS50cmlnZ2VyLlJlZ2lzdGVyVG9waWNSZXF1ZXN0LkJyb2tlck1ldGFkYXRhRW50cnkSEAoIdG9waWNfaWQYBCABKAkaNQoTQnJva2VyTWV0YWRhdGFFbnRyeRILCgNrZXkYASABKAkSDQoFdmFsdWUYAiABKAk6AjgBIikKFVJlZ2lzdGVyVG9waWNSZXNwb25zZRIQCgh0b3BpY19pZBgBIAEoCSI3ChBEcm9wVG9waWNSZXF1ZXN0EhAKCHRvcGljX2lkGAEgASgJEhEKCWlmX2V4aXN0cxgCIAEoCCIZCglUb3BpY05hbWUSDAoEbmFtZRgBIAEoCSJKCgpBcnJvd0JhdGNoEhMKC2RhdGFfaGVhZGVyGAEgASgMEhEKCWRhdGFfYm9keRgCIAEoDBIUCgxhcHBfbWV0YWRhdGEYAyABKAwifAoOUHVibGlzaFJlcXVlc3QSKgoFdG9waWMYASABKAsyGy5qYW1taS52MS50cmlnZ2VyLlRvcGljTmFtZRIrCgViYXRjaBgCIAEoCzIcLmphbW1pLnYxLnRyaWdnZXIuQXJyb3dCYXRjaBIRCgl0ZW5hbnRfaWQYAyABKAkiUwoPUHVibGlzaFJlc3BvbnNlEg4KBm9mZnNldBgBIAEoBBIwCgxjb21taXR0ZWRfYXQYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIo4BChBTdWJzY3JpYmVSZXF1ZXN0EioKBXRvcGljGAEgASgLMhsuamFtbWkudjEudHJpZ2dlci5Ub3BpY05hbWUSEQoJcHJlZGljYXRlGAIgASgJEhgKC2Zyb21fb2Zmc2V0GAMgASgESACIAQESEQoJdGVuYW50X2lkGAQgASgJQg4KDF9mcm9tX29mZnNldCJ/Cg9TdWJzY3JpYmVkQmF0Y2gSDgoGb2Zmc2V0GAEgASgEEi8KC3Byb2R1Y2VkX2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIrCgViYXRjaBgDIAEoCzIcLmphbW1pLnYxLnRyaWdnZXIuQXJyb3dCYXRjaCJNChFMaXN0VG9waWNzUmVxdWVzdBIRCglwYWdlX3NpemUYASABKAUSEgoKcGFnZV90b2tlbhgCIAEoCRIRCgl0ZW5hbnRfaWQYAyABKAkixwEKBVRvcGljEhAKCHRvcGljX2lkGAEgASgJEgwKBG5hbWUYAiABKAkSDgoGc2NoZW1hGAMgASgMEhEKCXRlbmFudF9pZBgEIAEoCRJECg9icm9rZXJfbWV0YWRhdGEYBSADKAsyKy5qYW1taS52MS50cmlnZ2VyLlRvcGljLkJyb2tlck1ldGFkYXRhRW50cnkaNQoTQnJva2VyTWV0YWRhdGFFbnRyeRILCgNrZXkYASABKAkSDQoFdmFsdWUYAiABKAk6AjgBIlYKEkxpc3RUb3BpY3NSZXNwb25zZRInCgZ0b3BpY3MYASADKAsyFy5qYW1taS52MS50cmlnZ2VyLlRvcGljEhcKD25leHRfcGFnZV90b2tlbhgCIAEoCTK6AwoOVHJpZ2dlclNlcnZpY2USYAoNUmVnaXN0ZXJUb3BpYxImLmphbW1pLnYxLnRyaWdnZXIuUmVnaXN0ZXJUb3BpY1JlcXVlc3QaJy5qYW1taS52MS50cmlnZ2VyLlJlZ2lzdGVyVG9waWNSZXNwb25zZRJHCglEcm9wVG9waWMSIi5qYW1taS52MS50cmlnZ2VyLkRyb3BUb3BpY1JlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkSTgoHUHVibGlzaBIgLmphbW1pLnYxLnRyaWdnZXIuUHVibGlzaFJlcXVlc3QaIS5qYW1taS52MS50cmlnZ2VyLlB1Ymxpc2hSZXNwb25zZRJUCglTdWJzY3JpYmUSIi5qYW1taS52MS50cmlnZ2VyLlN1YnNjcmliZVJlcXVlc3QaIS5qYW1taS52MS50cmlnZ2VyLlN1YnNjcmliZWRCYXRjaDABElcKCkxpc3RUb3BpY3MSIy5qYW1taS52MS50cmlnZ2VyLkxpc3RUb3BpY3NSZXF1ZXN0GiQuamFtbWkudjEudHJpZ2dlci5MaXN0VG9waWNzUmVzcG9uc2ViBnByb3RvMw", [file_google_protobuf_empty, file_google_protobuf_timestamp]);
+/**
+ * Describes the message jammi.v1.trigger.RegisterTopicRequest.
+ * Use `create(RegisterTopicRequestSchema)` to create a new message.
+ */
+export const RegisterTopicRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 0);
+/**
+ * Describes the message jammi.v1.trigger.RegisterTopicResponse.
+ * Use `create(RegisterTopicResponseSchema)` to create a new message.
+ */
+export const RegisterTopicResponseSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 1);
+/**
+ * Describes the message jammi.v1.trigger.DropTopicRequest.
+ * Use `create(DropTopicRequestSchema)` to create a new message.
+ */
+export const DropTopicRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 2);
+/**
+ * Describes the message jammi.v1.trigger.TopicName.
+ * Use `create(TopicNameSchema)` to create a new message.
+ */
+export const TopicNameSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 3);
+/**
+ * Describes the message jammi.v1.trigger.ArrowBatch.
+ * Use `create(ArrowBatchSchema)` to create a new message.
+ */
+export const ArrowBatchSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 4);
+/**
+ * Describes the message jammi.v1.trigger.PublishRequest.
+ * Use `create(PublishRequestSchema)` to create a new message.
+ */
+export const PublishRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 5);
+/**
+ * Describes the message jammi.v1.trigger.PublishResponse.
+ * Use `create(PublishResponseSchema)` to create a new message.
+ */
+export const PublishResponseSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 6);
+/**
+ * Describes the message jammi.v1.trigger.SubscribeRequest.
+ * Use `create(SubscribeRequestSchema)` to create a new message.
+ */
+export const SubscribeRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 7);
+/**
+ * Describes the message jammi.v1.trigger.SubscribedBatch.
+ * Use `create(SubscribedBatchSchema)` to create a new message.
+ */
+export const SubscribedBatchSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 8);
+/**
+ * Describes the message jammi.v1.trigger.ListTopicsRequest.
+ * Use `create(ListTopicsRequestSchema)` to create a new message.
+ */
+export const ListTopicsRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 9);
+/**
+ * Describes the message jammi.v1.trigger.Topic.
+ * Use `create(TopicSchema)` to create a new message.
+ */
+export const TopicSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 10);
+/**
+ * Describes the message jammi.v1.trigger.ListTopicsResponse.
+ * Use `create(ListTopicsResponseSchema)` to create a new message.
+ */
+export const ListTopicsResponseSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_trigger, 11);
+/**
+ * TriggerService — primitive pub/sub over Arrow record batches.
+ *
+ * Verb vocabulary is closed: RegisterTopic, DropTopic, Publish, Subscribe,
+ * ListTopics. No domain-shaped verbs (no Discover, no Ingest*, no Run*). See
+ * ADR-01 §3.4.
+ *
+ * @generated from service jammi.v1.trigger.TriggerService
+ */
+export const TriggerService = /*@__PURE__*/ serviceDesc(file_jammi_v1_trigger, 0);
+//# sourceMappingURL=trigger_pb.js.map

package/dist/gen/jammi/v1/trigger_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger_pb.js","sourceRoot":"","sources":["../../../../src/gen/jammi/v1/trigger_pb.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,wFAAwF;AACxF,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAElF,OAAO,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGpG;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAY,aAAa,CACzD,QAAQ,CAAC,ozEAAozE,EAAE,CAAC,0BAA0B,EAAE,8BAA8B,CAAC,CAAC,CAAC;AA0C/3E;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAcxC;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsC,aAAa,CACzF,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAuBxC;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAgBxC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,aAAa,CACjE,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AA+BxC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B,aAAa,CACnE,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAyBxC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAmBxC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAmCxC;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAsBxC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AA0BxC;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AA+CxC;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAsB,aAAa,CACzD,WAAW,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;AAiBzC;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,aAAa,CACnF,WAAW,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAyDtB,aAAa,CAChB,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+import { type Client, type Interceptor } from "@connectrpc/connect";
+import { SessionService } from "./gen/jammi/v1/session_pb.js";
+import { EmbeddingService } from "./gen/jammi/v1/embedding_pb.js";
+import { InferenceService } from "./gen/jammi/v1/inference_pb.js";
+import { EvalService } from "./gen/jammi/v1/eval_pb.js";
+import { FineTuneService } from "./gen/jammi/v1/fine_tune_pb.js";
+import { MutableTableService } from "./gen/jammi/v1/mutable_table_pb.js";
+import { ChannelService } from "./gen/jammi/v1/channel_pb.js";
+import { TriggerService } from "./gen/jammi/v1/trigger_pb.js";
+import { AuditService } from "./gen/jammi/v1/audit_pb.js";
+export * from "./gen/jammi/v1/session_pb.js";
+export * from "./gen/jammi/v1/embedding_pb.js";
+export * from "./gen/jammi/v1/inference_pb.js";
+export * from "./gen/jammi/v1/eval_pb.js";
+export * from "./gen/jammi/v1/fine_tune_pb.js";
+export * from "./gen/jammi/v1/mutable_table_pb.js";
+export * from "./gen/jammi/v1/channel_pb.js";
+export * from "./gen/jammi/v1/trigger_pb.js";
+export * from "./gen/jammi/v1/audit_pb.js";
+export * from "./gen/jammi/v1/error_pb.js";
+/**
+ * The request header carrying a connection's opaque session id. The server's
+ * Tonic TenantInterceptor reads it on every request and resolves the bound
+ * tenant; it is the same header the Rust SDK and Flight SQL lane use. Kept in
+ * one place so the value never drifts across the seam.
+ */
+export declare const SESSION_HEADER = "jammi-session-id";
+/** Options for {@link connect}. */
+export interface ConnectOptions {
+    /**
+     * The opaque session id to scope this connection's tenant binding by. The
+     * server keys tenant state against it, so two connections that must stay
+     * tenant-isolated MUST pass distinct ids. Defaults to a fresh UUID, matching
+     * the Rust `RemoteSession::connect` behavior (each connection isolated).
+     */
+    sessionId?: string;
+    /**
+     * Extra Connect interceptors, applied outside the session-header interceptor
+     * (e.g. auth, logging). Optional.
+     */
+    interceptors?: Interceptor[];
+}
+/**
+ * A client per Jammi service, all sharing one gRPC-web transport and one
+ * session-scoped tenant binding. This is the value {@link connect} returns.
+ */
+export interface JammiClient {
+    /** The session id this connection scopes its tenant binding by. */
+    readonly sessionId: string;
+    readonly session: Client<typeof SessionService>;
+    readonly embedding: Client<typeof EmbeddingService>;
+    readonly inference: Client<typeof InferenceService>;
+    readonly eval: Client<typeof EvalService>;
+    readonly fineTune: Client<typeof FineTuneService>;
+    readonly mutableTable: Client<typeof MutableTableService>;
+    readonly channel: Client<typeof ChannelService>;
+    readonly trigger: Client<typeof TriggerService>;
+    readonly audit: Client<typeof AuditService>;
+}
+/**
+ * Connect to a Jammi engine's `jammi.v1` gRPC-web endpoint and return a client
+ * for every service.
+ *
+ * @param endpoint The engine's base URL (e.g. `"https://engine.example.com"`).
+ *   Requests go to `<endpoint>/<package>.<Service>/<Method>`.
+ */
+export declare function connect(endpoint: string, opts?: ConnectOptions): JammiClient;
+//# 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":"AAqBA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;CAC7C;AASD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,WAAW,CA4BhF"}

package/dist/index.js

@@ -0,0 +1,89 @@
+// @f-inverse/jammi-client — the official TypeScript gRPC-web client for the Jammi engine.
+//
+// The wire surface is GENERATED from the canonical jammi.v1 proto by
+// protoc-gen-es (see buf.gen.yaml + the `generate` script); this module is the
+// thin ergonomic seam over it. It does three things and nothing more:
+//
+//   1. Re-export the generated message types + service descriptors, so a
+//      consumer imports everything from one entry point.
+//   2. Provide `connect(endpoint, opts?)`, which builds ONE gRPC-web transport
+//      (fetch-based — runs in a Cloudflare Worker / V8 isolate, interoperating
+//      with the server's tonic-web surface) and returns a client for every
+//      service over that shared transport.
+//   3. Centralize tenant scoping: like the Rust `RemoteSession::connect`, it
+//      mints one opaque session id per connection and injects it on every
+//      outbound request as the `jammi-session-id` header — the key the server's
+//      tenant interceptor binds tenant state against (set via the SessionService
+//      tenant trio). No per-call header plumbing leaks to consumers.
+//
+// Encoding/decoding is entirely the generated code's job; this file holds no
+// hand-rolled protobuf logic.
+import { createClient } from "@connectrpc/connect";
+import { createGrpcWebTransport } from "@connectrpc/connect-web";
+import { SessionService } from "./gen/jammi/v1/session_pb.js";
+import { EmbeddingService } from "./gen/jammi/v1/embedding_pb.js";
+import { InferenceService } from "./gen/jammi/v1/inference_pb.js";
+import { EvalService } from "./gen/jammi/v1/eval_pb.js";
+import { FineTuneService } from "./gen/jammi/v1/fine_tune_pb.js";
+import { MutableTableService } from "./gen/jammi/v1/mutable_table_pb.js";
+import { ChannelService } from "./gen/jammi/v1/channel_pb.js";
+import { TriggerService } from "./gen/jammi/v1/trigger_pb.js";
+import { AuditService } from "./gen/jammi/v1/audit_pb.js";
+// Re-export the full generated surface (messages, enums, service descriptors).
+export * from "./gen/jammi/v1/session_pb.js";
+export * from "./gen/jammi/v1/embedding_pb.js";
+export * from "./gen/jammi/v1/inference_pb.js";
+export * from "./gen/jammi/v1/eval_pb.js";
+export * from "./gen/jammi/v1/fine_tune_pb.js";
+export * from "./gen/jammi/v1/mutable_table_pb.js";
+export * from "./gen/jammi/v1/channel_pb.js";
+export * from "./gen/jammi/v1/trigger_pb.js";
+export * from "./gen/jammi/v1/audit_pb.js";
+export * from "./gen/jammi/v1/error_pb.js";
+/**
+ * The request header carrying a connection's opaque session id. The server's
+ * Tonic TenantInterceptor reads it on every request and resolves the bound
+ * tenant; it is the same header the Rust SDK and Flight SQL lane use. Kept in
+ * one place so the value never drifts across the seam.
+ */
+export const SESSION_HEADER = "jammi-session-id";
+/** Mint an opaque per-connection session id (a v4 UUID). */
+function mintSessionId() {
+    // `crypto.randomUUID` is available in every target runtime: browsers,
+    // Cloudflare Workers / V8 isolates, and Node >= 18.
+    return crypto.randomUUID();
+}
+/**
+ * Connect to a Jammi engine's `jammi.v1` gRPC-web endpoint and return a client
+ * for every service.
+ *
+ * @param endpoint The engine's base URL (e.g. `"https://engine.example.com"`).
+ *   Requests go to `<endpoint>/<package>.<Service>/<Method>`.
+ */
+export function connect(endpoint, opts = {}) {
+    const sessionId = opts.sessionId ?? mintSessionId();
+    // Inject the session header on every outbound request (unary and streaming),
+    // mirroring the Rust SDK's SessionHeader interceptor. Applied innermost so a
+    // consumer-supplied interceptor cannot accidentally drop it.
+    const sessionHeader = (next) => (req) => {
+        req.header.set(SESSION_HEADER, sessionId);
+        return next(req);
+    };
+    const transport = createGrpcWebTransport({
+        baseUrl: endpoint,
+        interceptors: [...(opts.interceptors ?? []), sessionHeader],
+    });
+    return {
+        sessionId,
+        session: createClient(SessionService, transport),
+        embedding: createClient(EmbeddingService, transport),
+        inference: createClient(InferenceService, transport),
+        eval: createClient(EvalService, transport),
+        fineTune: createClient(FineTuneService, transport),
+        mutableTable: createClient(MutableTableService, transport),
+        channel: createClient(ChannelService, transport),
+        trigger: createClient(TriggerService, transport),
+        audit: createClient(AuditService, transport),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@f-inverse/jammi-client",
+  "version": "0.14.0",
+  "description": "Official TypeScript gRPC-web client for the Jammi engine, generated from the canonical jammi.v1 proto. Runs on fetch (Cloudflare Workers / V8 isolates).",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/f-inverse/jammi-ai.git",
+    "directory": "clients/typescript"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "generate": "buf generate ../../crates/jammi-ai/proto",
+    "clean": "rm -rf dist src/gen",
+    "prebuild": "npm run clean && npm run generate",
+    "build": "tsc -p tsconfig.build.json",
+    "pretypecheck": "npm run generate",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pretest": "npm run generate",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.12.0",
+    "@connectrpc/connect": "^2.1.1",
+    "@connectrpc/connect-web": "^2.1.1"
+  },
+  "devDependencies": {
+    "@bufbuild/buf": "^1.70.0",
+    "@bufbuild/protoc-gen-es": "^2.12.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.0"
+  }
+}