@miradorlabs/parallax-web 1.0.0

package/dist/index.esm.js

@@ -0,0 +1,243 @@
+import * as apiGateway from 'mirador-gateway-parallax-web/proto/gateway/parallax/v1/parallax_gateway';
+import { Observable } from 'rxjs';
+
+class GrpcWebRpc {
+    constructor(url, apiKey) {
+        Object.defineProperty(this, "url", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "apiKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.url = url;
+        this.apiKey = apiKey;
+    }
+    async request(service, method, data, metadata) {
+        console.log(`[gRPC-Web] Making request to ${this.url}/${service}/${method}`);
+        const headers = {
+            'Content-Type': 'application/grpc-web+proto',
+            'X-Grpc-Web': '1',
+        };
+        // Add API key to headers if provided
+        if (this.apiKey) {
+            headers['x-api-key'] = this.apiKey;
+        }
+        // Add custom metadata
+        if (metadata) {
+            Object.entries(metadata).forEach(([key, value]) => {
+                headers[key] = value;
+            });
+        }
+        try {
+            const response = await fetch(`${this.url}/${service}/${method}`, {
+                method: 'POST',
+                headers,
+                body: data.buffer,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`gRPC-Web error: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            const arrayBuffer = await response.arrayBuffer();
+            console.log(`[gRPC-Web] Success from ${this.url}/${service}/${method}`);
+            return new Uint8Array(arrayBuffer);
+        }
+        catch (error) {
+            console.error(`[gRPC-Web] Error from ${this.url}/${service}/${method}:`, error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+    }
+    clientStreamingRequest() {
+        throw new Error("Client streaming not yet implemented for gRPC-Web");
+    }
+    serverStreamingRequest(service, method, data) {
+        return new Observable((subscriber) => {
+            const headers = {
+                'Content-Type': 'application/grpc-web+proto',
+                'X-Grpc-Web': '1',
+            };
+            // Add API key to headers if provided
+            if (this.apiKey) {
+                headers['x-api-key'] = this.apiKey;
+            }
+            fetch(`${this.url}/${service}/${method}`, {
+                method: 'POST',
+                headers,
+                body: data.buffer,
+            })
+                .then(async (response) => {
+                if (!response.ok) {
+                    throw new Error(`gRPC-Web error: ${response.status} ${response.statusText}`);
+                }
+                if (!response.body) {
+                    throw new Error('Response body is null');
+                }
+                const reader = response.body.getReader();
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done) {
+                            subscriber.complete();
+                            break;
+                        }
+                        if (value) {
+                            subscriber.next(value);
+                        }
+                    }
+                }
+                catch (error) {
+                    subscriber.error(error);
+                }
+            })
+                .catch((error) => {
+                subscriber.error(error);
+            });
+            return () => {
+                // Cleanup logic if needed
+            };
+        });
+    }
+    bidirectionalStreamingRequest() {
+        throw new Error("Bidirectional streaming not yet implemented for gRPC-Web");
+    }
+}
+
+const GRPC_GATEWAY_API_URL = "https://gateway-parallax-dev.platform.svc.cluster.local:50053";
+const debugIssue = (trace, error) => {
+    // Handle our own debugging / logging here
+    console.error(`[ParallaxClient][${trace}] Error:`, error);
+};
+class ParallaxClient {
+    constructor(apiKey, apiUrl) {
+        Object.defineProperty(this, "apiKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: apiKey
+        });
+        Object.defineProperty(this, "apiUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: GRPC_GATEWAY_API_URL
+        });
+        Object.defineProperty(this, "apiGatewayRpc", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (apiUrl) {
+            this.apiUrl = apiUrl;
+        }
+        this.apiGatewayRpc = new GrpcWebRpc(this.apiUrl, apiKey);
+    }
+    /**
+     * Create a new trace
+     * @param params Parameters to create a new trace
+     * @returns Response from the create trace operation
+     */
+    async createTrace(params) {
+        try {
+            const apiGatewayClient = new apiGateway.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+            return await apiGatewayClient.CreateTrace(params);
+        }
+        catch (_error) {
+            debugIssue("createTrace", new Error('Error creating trace'));
+            throw _error;
+        }
+    }
+    /**
+     * Start a new span within a trace
+     * @param params Parameters to start a new span
+     */
+    async startSpan(params) {
+        try {
+            const apiGatewayClient = new apiGateway.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+            return await apiGatewayClient.StartSpan(params);
+        }
+        catch (_error) {
+            debugIssue("startSpan", new Error('Error starting span'));
+            throw _error;
+        }
+    }
+    /**
+     * Finish a span within a trace
+     * @param params Parameters to finish a span
+     */
+    async finishSpan(params) {
+        try {
+            const apiGatewayClient = new apiGateway.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+            return await apiGatewayClient.FinishSpan(params);
+        }
+        catch (_error) {
+            debugIssue("finishSpan", new Error('Error finishing span'));
+            throw _error;
+        }
+    }
+    /**
+     * Add attributes to a span
+     * @param params Parameters to add attributes to a span
+     */
+    async addSpanAttributes(params) {
+        try {
+            const apiGatewayClient = new apiGateway.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+            return await apiGatewayClient.AddSpanAttributes(params);
+        }
+        catch (_error) {
+            debugIssue("addSpanAttributes", new Error('Error adding span attributes'));
+            throw _error;
+        }
+    }
+    /**
+     * Add an event to a span
+     * @param params Parameters to add an event to a span
+     */
+    async addSpanEvent(params) {
+        try {
+            const apiGatewayClient = new apiGateway.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+            return await apiGatewayClient.AddSpanEvent(params);
+        }
+        catch (_error) {
+            debugIssue("addSpanEvent", new Error('Error adding span event'));
+            throw _error;
+        }
+    }
+    /**
+     * Add an error to a span
+     * @param params Parameters to add an error to a span
+     */
+    async addSpanError(params) {
+        try {
+            const apiGatewayClient = new apiGateway.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+            return await apiGatewayClient.AddSpanError(params);
+        }
+        catch (_error) {
+            debugIssue("addSpanError", new Error('Error adding span error'));
+            throw _error;
+        }
+    }
+    /**
+     * Add a hint to a span
+     * @param params Parameters to add a hint to a span
+     */
+    async addSpanHint(params) {
+        try {
+            const apiGatewayClient = new apiGateway.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+            return await apiGatewayClient.AddSpanHint(params);
+        }
+        catch (_error) {
+            debugIssue("addSpanHint", new Error('Error adding span hint'));
+            throw _error;
+        }
+    }
+}
+
+export { GrpcWebRpc, ParallaxClient };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../src/grpc/index.ts","../../src/parallax/index.ts"],"sourcesContent":[null,null],"names":[],"mappings":";;;MA8Ba,UAAU,CAAA;IAIrB,WAAA,CAAY,GAAW,EAAE,MAAe,EAAA;AAHhC,QAAA,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,KAAA,EAAA;;;;;AAAY,SAAA,CAAA;AACZ,QAAA,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,QAAA,EAAA;;;;;AAAgB,SAAA,CAAA;AAGtB,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;AACd,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;IACtB;IAEA,MAAM,OAAO,CACX,OAAe,EACf,MAAc,EACd,IAAgB,EAChB,QAAmB,EAAA;AAEnB,QAAA,OAAO,CAAC,GAAG,CAAC,CAAA,6BAAA,EAAgC,IAAI,CAAC,GAAG,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,EAAI,MAAM,CAAA,CAAE,CAAC;AAE5E,QAAA,MAAM,OAAO,GAAgB;AAC3B,YAAA,cAAc,EAAE,4BAA4B;AAC5C,YAAA,YAAY,EAAE,GAAG;SAClB;;AAGD,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;AACf,YAAA,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM;QACpC;;QAGA,IAAI,QAAQ,EAAE;AACZ,YAAA,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;AAChD,gBAAA,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK;AACtB,YAAA,CAAC,CAAC;QACJ;AAEA,QAAA,IAAI;AACF,YAAA,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,CAAA,EAAG,IAAI,CAAC,GAAG,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,EAAI,MAAM,EAAE,EAAE;AAC/D,gBAAA,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,MAAqB;AACjC,aAAA,CAAC;AAEF,YAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AAChB,gBAAA,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE;AACvC,gBAAA,MAAM,IAAI,KAAK,CAAC,CAAA,gBAAA,EAAmB,QAAQ,CAAC,MAAM,CAAA,CAAA,EAAI,QAAQ,CAAC,UAAU,CAAA,GAAA,EAAM,SAAS,CAAA,CAAE,CAAC;YAC7F;AAEA,YAAA,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE;AAChD,YAAA,OAAO,CAAC,GAAG,CAAC,CAAA,wBAAA,EAA2B,IAAI,CAAC,GAAG,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,EAAI,MAAM,CAAA,CAAE,CAAC;AACvE,YAAA,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC;QACpC;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,KAAK,CACX,CAAA,sBAAA,EAAyB,IAAI,CAAC,GAAG,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA,CAAG,EACzD,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CACvD;AACD,YAAA,MAAM,KAAK;QACb;IACF;IAEA,sBAAsB,GAAA;AACpB,QAAA,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC;IACtE;AAEA,IAAA,sBAAsB,CACpB,OAAe,EACf,MAAc,EACd,IAAgB,EAAA;AAEhB,QAAA,OAAO,IAAI,UAAU,CAAC,CAAC,UAAU,KAAI;AACnC,YAAA,MAAM,OAAO,GAAgB;AAC3B,gBAAA,cAAc,EAAE,4BAA4B;AAC5C,gBAAA,YAAY,EAAE,GAAG;aAClB;;AAGD,YAAA,IAAI,IAAI,CAAC,MAAM,EAAE;AACf,gBAAA,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM;YACpC;YAEA,KAAK,CAAC,CAAA,EAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAA,CAAA,EAAI,MAAM,CAAA,CAAE,EAAE;AACxC,gBAAA,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,MAAqB;aACjC;AACE,iBAAA,IAAI,CAAC,OAAO,QAAQ,KAAI;AACvB,gBAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AAChB,oBAAA,MAAM,IAAI,KAAK,CAAC,CAAA,gBAAA,EAAmB,QAAQ,CAAC,MAAM,CAAA,CAAA,EAAI,QAAQ,CAAC,UAAU,CAAA,CAAE,CAAC;gBAC9E;AAEA,gBAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;AAClB,oBAAA,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC;gBAC1C;gBAEA,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE;AAExC,gBAAA,IAAI;oBACF,OAAO,IAAI,EAAE;wBACX,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE;wBAE3C,IAAI,IAAI,EAAE;4BACR,UAAU,CAAC,QAAQ,EAAE;4BACrB;wBACF;wBAEA,IAAI,KAAK,EAAE;AACT,4BAAA,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;wBACxB;oBACF;gBACF;gBAAE,OAAO,KAAK,EAAE;AACd,oBAAA,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;gBACzB;AACF,YAAA,CAAC;AACA,iBAAA,KAAK,CAAC,CAAC,KAAK,KAAI;AACf,gBAAA,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;AACzB,YAAA,CAAC,CAAC;AAEJ,YAAA,OAAO,MAAK;;AAEZ,YAAA,CAAC;AACH,QAAA,CAAC,CAAC;IACJ;IAEA,6BAA6B,GAAA;AAC3B,QAAA,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC;IAC7E;AACD;;AC7ID,MAAM,oBAAoB,GAAG,+DAA+D;AAE5F,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,KAAY,KAAI;;IAEjD,OAAO,CAAC,KAAK,CAAC,CAAA,iBAAA,EAAoB,KAAK,CAAA,QAAA,CAAU,EAAE,KAAK,CAAC;AAC3D,CAAC;AAED,MAAM,cAAc,CAAA;IAIlB,WAAA,CAAmB,MAAe,EAAE,MAAe,EAAA;AAAvC,QAAA,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,QAAA,EAAA;;;;mBAAO;AAAe,SAAA,CAAA;AAH3B,QAAA,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,QAAA,EAAA;;;;mBAAiB;AAAqB,SAAA,CAAA;AACrC,QAAA,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,eAAA,EAAA;;;;;AAA0B,SAAA,CAAA;QAGhC,IAAI,MAAM,EAAE;AACV,YAAA,IAAI,CAAC,MAAM,GAAG,MAAM;QACtB;AACA,QAAA,IAAI,CAAC,aAAa,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAC1D;AAEA;;;;AAIG;IACH,MAAM,WAAW,CAAC,MAA0B,EAAA;AAC1C,QAAA,IAAI;YACF,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAC,gCAAgC,CACtE,IAAI,CAAC,aAAa,CACnB;AACD,YAAA,OAAO,MAAM,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC;QACnD;QAAE,OAAO,MAAM,EAAE;YACf,UAAU,CAAC,aAAa,EAAE,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAC5D,YAAA,MAAM,MAAM;QACd;IACF;AAEA;;;AAGG;IACH,MAAM,SAAS,CAAC,MAAwB,EAAA;AACtC,QAAA,IAAI;YACF,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAC,gCAAgC,CACtE,IAAI,CAAC,aAAa,CACnB;AACD,YAAA,OAAO,MAAM,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC;QACjD;QAAE,OAAO,MAAM,EAAE;YACf,UAAU,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;AACzD,YAAA,MAAM,MAAM;QACd;IACF;AAEA;;;AAGG;IACH,MAAM,UAAU,CAAC,MAAyB,EAAA;AACxC,QAAA,IAAI;YACF,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAC,gCAAgC,CACtE,IAAI,CAAC,aAAa,CACnB;AACD,YAAA,OAAO,MAAM,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC;QAClD;QAAE,OAAO,MAAM,EAAE;YACf,UAAU,CAAC,YAAY,EAAE,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAC3D,YAAA,MAAM,MAAM;QACd;IACF;AAEA;;;AAGG;IACH,MAAM,iBAAiB,CAAC,MAAgC,EAAA;AACtD,QAAA,IAAI;YACF,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAC,gCAAgC,CACtE,IAAI,CAAC,aAAa,CACnB;AACD,YAAA,OAAO,MAAM,gBAAgB,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACzD;QAAE,OAAO,MAAM,EAAE;YACf,UAAU,CAAC,mBAAmB,EAAE,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAC1E,YAAA,MAAM,MAAM;QACd;IACF;AAEA;;;AAGG;IACH,MAAM,YAAY,CAAC,MAA2B,EAAA;AAC5C,QAAA,IAAI;YACF,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAC,gCAAgC,CACtE,IAAI,CAAC,aAAa,CACnB;AACD,YAAA,OAAO,MAAM,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC;QACpD;QAAE,OAAO,MAAM,EAAE;YACf,UAAU,CAAC,cAAc,EAAE,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAChE,YAAA,MAAM,MAAM;QACd;IACF;AAEA;;;AAGG;IACH,MAAM,YAAY,CAAC,MAA2B,EAAA;AAC5C,QAAA,IAAI;YACF,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAC,gCAAgC,CACtE,IAAI,CAAC,aAAa,CACnB;AACD,YAAA,OAAO,MAAM,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC;QACpD;QAAE,OAAO,MAAM,EAAE;YACf,UAAU,CAAC,cAAc,EAAE,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAChE,YAAA,MAAM,MAAM;QACd;IACF;AAEA;;;AAGG;IACH,MAAM,WAAW,CAAC,MAA0B,EAAA;AAC1C,QAAA,IAAI;YACF,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAC,gCAAgC,CACtE,IAAI,CAAC,aAAa,CACnB;AACD,YAAA,OAAO,MAAM,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC;QACnD;QAAE,OAAO,MAAM,EAAE;YACf,UAAU,CAAC,aAAa,EAAE,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAC9D,YAAA,MAAM,MAAM;QACd;IACF;AACD;;;;"}

package/dist/index.umd.js

@@ -0,0 +1,268 @@
+(function (global, factory) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('mirador-gateway-parallax-web/proto/gateway/parallax/v1/parallax_gateway'), require('rxjs')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'mirador-gateway-parallax-web/proto/gateway/parallax/v1/parallax_gateway', 'rxjs'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.ParallaxWeb = {}, global.miradorGatewayParallaxWeb.parallaxGateway, global.rxjs));
+})(this, (function (exports, apiGateway, rxjs) { 'use strict';
+
+    function _interopNamespaceDefault(e) {
+        var n = Object.create(null);
+        if (e) {
+            Object.keys(e).forEach(function (k) {
+                if (k !== 'default') {
+                    var d = Object.getOwnPropertyDescriptor(e, k);
+                    Object.defineProperty(n, k, d.get ? d : {
+                        enumerable: true,
+                        get: function () { return e[k]; }
+                    });
+                }
+            });
+        }
+        n.default = e;
+        return Object.freeze(n);
+    }
+
+    var apiGateway__namespace = /*#__PURE__*/_interopNamespaceDefault(apiGateway);
+
+    class GrpcWebRpc {
+        constructor(url, apiKey) {
+            Object.defineProperty(this, "url", {
+                enumerable: true,
+                configurable: true,
+                writable: true,
+                value: void 0
+            });
+            Object.defineProperty(this, "apiKey", {
+                enumerable: true,
+                configurable: true,
+                writable: true,
+                value: void 0
+            });
+            this.url = url;
+            this.apiKey = apiKey;
+        }
+        async request(service, method, data, metadata) {
+            console.log(`[gRPC-Web] Making request to ${this.url}/${service}/${method}`);
+            const headers = {
+                'Content-Type': 'application/grpc-web+proto',
+                'X-Grpc-Web': '1',
+            };
+            // Add API key to headers if provided
+            if (this.apiKey) {
+                headers['x-api-key'] = this.apiKey;
+            }
+            // Add custom metadata
+            if (metadata) {
+                Object.entries(metadata).forEach(([key, value]) => {
+                    headers[key] = value;
+                });
+            }
+            try {
+                const response = await fetch(`${this.url}/${service}/${method}`, {
+                    method: 'POST',
+                    headers,
+                    body: data.buffer,
+                });
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    throw new Error(`gRPC-Web error: ${response.status} ${response.statusText} - ${errorText}`);
+                }
+                const arrayBuffer = await response.arrayBuffer();
+                console.log(`[gRPC-Web] Success from ${this.url}/${service}/${method}`);
+                return new Uint8Array(arrayBuffer);
+            }
+            catch (error) {
+                console.error(`[gRPC-Web] Error from ${this.url}/${service}/${method}:`, error instanceof Error ? error.message : String(error));
+                throw error;
+            }
+        }
+        clientStreamingRequest() {
+            throw new Error("Client streaming not yet implemented for gRPC-Web");
+        }
+        serverStreamingRequest(service, method, data) {
+            return new rxjs.Observable((subscriber) => {
+                const headers = {
+                    'Content-Type': 'application/grpc-web+proto',
+                    'X-Grpc-Web': '1',
+                };
+                // Add API key to headers if provided
+                if (this.apiKey) {
+                    headers['x-api-key'] = this.apiKey;
+                }
+                fetch(`${this.url}/${service}/${method}`, {
+                    method: 'POST',
+                    headers,
+                    body: data.buffer,
+                })
+                    .then(async (response) => {
+                    if (!response.ok) {
+                        throw new Error(`gRPC-Web error: ${response.status} ${response.statusText}`);
+                    }
+                    if (!response.body) {
+                        throw new Error('Response body is null');
+                    }
+                    const reader = response.body.getReader();
+                    try {
+                        while (true) {
+                            const { done, value } = await reader.read();
+                            if (done) {
+                                subscriber.complete();
+                                break;
+                            }
+                            if (value) {
+                                subscriber.next(value);
+                            }
+                        }
+                    }
+                    catch (error) {
+                        subscriber.error(error);
+                    }
+                })
+                    .catch((error) => {
+                    subscriber.error(error);
+                });
+                return () => {
+                    // Cleanup logic if needed
+                };
+            });
+        }
+        bidirectionalStreamingRequest() {
+            throw new Error("Bidirectional streaming not yet implemented for gRPC-Web");
+        }
+    }
+
+    const GRPC_GATEWAY_API_URL = "https://gateway-parallax-dev.platform.svc.cluster.local:50053";
+    const debugIssue = (trace, error) => {
+        // Handle our own debugging / logging here
+        console.error(`[ParallaxClient][${trace}] Error:`, error);
+    };
+    class ParallaxClient {
+        constructor(apiKey, apiUrl) {
+            Object.defineProperty(this, "apiKey", {
+                enumerable: true,
+                configurable: true,
+                writable: true,
+                value: apiKey
+            });
+            Object.defineProperty(this, "apiUrl", {
+                enumerable: true,
+                configurable: true,
+                writable: true,
+                value: GRPC_GATEWAY_API_URL
+            });
+            Object.defineProperty(this, "apiGatewayRpc", {
+                enumerable: true,
+                configurable: true,
+                writable: true,
+                value: void 0
+            });
+            if (apiUrl) {
+                this.apiUrl = apiUrl;
+            }
+            this.apiGatewayRpc = new GrpcWebRpc(this.apiUrl, apiKey);
+        }
+        /**
+         * Create a new trace
+         * @param params Parameters to create a new trace
+         * @returns Response from the create trace operation
+         */
+        async createTrace(params) {
+            try {
+                const apiGatewayClient = new apiGateway__namespace.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+                return await apiGatewayClient.CreateTrace(params);
+            }
+            catch (_error) {
+                debugIssue("createTrace", new Error('Error creating trace'));
+                throw _error;
+            }
+        }
+        /**
+         * Start a new span within a trace
+         * @param params Parameters to start a new span
+         */
+        async startSpan(params) {
+            try {
+                const apiGatewayClient = new apiGateway__namespace.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+                return await apiGatewayClient.StartSpan(params);
+            }
+            catch (_error) {
+                debugIssue("startSpan", new Error('Error starting span'));
+                throw _error;
+            }
+        }
+        /**
+         * Finish a span within a trace
+         * @param params Parameters to finish a span
+         */
+        async finishSpan(params) {
+            try {
+                const apiGatewayClient = new apiGateway__namespace.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+                return await apiGatewayClient.FinishSpan(params);
+            }
+            catch (_error) {
+                debugIssue("finishSpan", new Error('Error finishing span'));
+                throw _error;
+            }
+        }
+        /**
+         * Add attributes to a span
+         * @param params Parameters to add attributes to a span
+         */
+        async addSpanAttributes(params) {
+            try {
+                const apiGatewayClient = new apiGateway__namespace.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+                return await apiGatewayClient.AddSpanAttributes(params);
+            }
+            catch (_error) {
+                debugIssue("addSpanAttributes", new Error('Error adding span attributes'));
+                throw _error;
+            }
+        }
+        /**
+         * Add an event to a span
+         * @param params Parameters to add an event to a span
+         */
+        async addSpanEvent(params) {
+            try {
+                const apiGatewayClient = new apiGateway__namespace.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+                return await apiGatewayClient.AddSpanEvent(params);
+            }
+            catch (_error) {
+                debugIssue("addSpanEvent", new Error('Error adding span event'));
+                throw _error;
+            }
+        }
+        /**
+         * Add an error to a span
+         * @param params Parameters to add an error to a span
+         */
+        async addSpanError(params) {
+            try {
+                const apiGatewayClient = new apiGateway__namespace.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+                return await apiGatewayClient.AddSpanError(params);
+            }
+            catch (_error) {
+                debugIssue("addSpanError", new Error('Error adding span error'));
+                throw _error;
+            }
+        }
+        /**
+         * Add a hint to a span
+         * @param params Parameters to add a hint to a span
+         */
+        async addSpanHint(params) {
+            try {
+                const apiGatewayClient = new apiGateway__namespace.ParallaxGatewayServiceClientImpl(this.apiGatewayRpc);
+                return await apiGatewayClient.AddSpanHint(params);
+            }
+            catch (_error) {
+                debugIssue("addSpanHint", new Error('Error adding span hint'));
+                throw _error;
+            }
+        }
+    }
+
+    exports.GrpcWebRpc = GrpcWebRpc;
+    exports.ParallaxClient = ParallaxClient;
+
+}));
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../../src/grpc/index.ts","../../src/parallax/index.ts"],"sourcesContent":[null,null],"names":["Observable","apiGateway"],"mappings":"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"}

package/eslint.config.js

@@ -0,0 +1,40 @@
+import js from "@eslint/js";
+import globals from "globals";
+import tseslint from "typescript-eslint";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default [
+  {
+    ignores: ["dist/**", "node_modules/**", "*.config.{js,mjs}", "rollup.config.mjs"],
+  },
+  {
+    files: ["**/*.{js,mjs,cjs,ts}"],
+    ...js.configs.recommended,
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.es2020,
+      },
+    },
+  },
+  ...tseslint.configs.recommended.map(config => ({
+    ...config,
+    files: ["**/*.{ts,tsx}"],
+    rules: {
+      ...(config.rules || {}),
+      "react-refresh/only-export-components": "off",
+    },
+  })),
+  {
+    files: ["**/*.{ts,tsx}"],
+    languageOptions: {
+      parserOptions: {
+        project: "./tsconfig.json",
+        tsconfigRootDir: __dirname,
+      },
+    },
+  },
+];

package/index.ts

@@ -0,0 +1,2 @@
+export * from './src/parallax';
+export { GrpcWebRpc } from './src/grpc';

package/jest.config.ts

@@ -0,0 +1,26 @@
+import type { Config } from 'jest';
+
+const config: Config = {
+  preset: 'ts-jest',
+  testEnvironment: 'jsdom',
+  roots: ['<rootDir>/tests', '<rootDir>/src'],
+  testMatch: ['**/*.test.ts'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/**/index.ts'
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  verbose: true,
+  testTimeout: 10000,
+  transform: {
+    '^.+\\.tsx?$': 'ts-jest',
+  },
+  transformIgnorePatterns: [
+    'node_modules/(?!(mirador-gateway-parallax-web)/)'
+  ],
+};
+
+export default config;

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@miradorlabs/parallax-web",
+  "version": "1.0.0",
+  "description": "Parallax Web Client Side SDK ",
+  "main": "dist/index.umd.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "browser": "dist/index.umd.js",
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "prepare": "npm run build",
+    "build": "rm -rf dist/ && rollup -c",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "release:patch": "npm version patch && git push --follow-tags",
+    "release:minor": "npm version minor && git push --follow-tags",
+    "release:major": "npm version major && git push --follow-tags"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.1",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "globals": "^16.5.0",
+    "jest": "^30.2.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "jiti": "^2.6.1",
+    "prettier": "^3.6.2",
+    "rollup": "^4.53.3",
+    "rollup-plugin-dts": "^6.2.3",
+    "ts-jest": "^29.4.5",
+    "ts-node": "^10.9.2",
+    "ts-proto": "^2.8.3",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.47.0"
+  },
+  "dependencies": {
+    "google-protobuf": "^4.0.1",
+    "mirador-gateway-parallax-web": "https://storage.googleapis.com/mirador-shd-packages/gateway/parallax/grpc-web/mirador-gateway-parallax-grpc-web-1.0.9.tgz",
+    "rxjs": "^7.8.2"
+  },
+  "author": "@mirador",
+  "license": "ISC"
+}