signalogy-sdk 1.0.0

package/README.md

@@ -0,0 +1,64 @@
+# Signalogy SDK
+
+Server and browser clients for Signalogy.
+
+## Installation
+
+```bash
+pnpm add signalogy-sdk
+```
+
+## Server usage
+
+```ts
+import { createSignalogyServer } from "signalogy-sdk";
+
+const server = createSignalogyServer({
+  secretId: "your-secret-id",
+  secretKey: "your-secret-key",
+});
+
+const token = await server.signJwt("user-123");
+
+await server.send({
+  userId: "user-123",
+  payload: { message: "Hello" },
+});
+```
+
+## Client usage
+
+```ts
+import {
+  createSignalogyClient,
+  createBrowserJwtStorage,
+} from "signalogy-sdk";
+
+const client = createSignalogyClient({
+  secretId: "your-secret-id",
+  jwtStorage: createBrowserJwtStorage("signalogy_token"),
+});
+
+const socket = client.connectWebSocket({
+  onMessage: (event) => {
+    console.log("Received", event.data);
+  },
+});
+```
+
+## React helper
+
+```ts
+import { useSignalogyClient } from "signalogy-sdk/signalogy/client/react";
+import { createBrowserJwtStorage } from "signalogy-sdk";
+
+const { client } = useSignalogyClient({
+  secretId: "your-secret-id",
+  jwtStorage: createBrowserJwtStorage("signalogy_token"),
+});
+```
+
+## Configuration
+
+- `baseUrl` defaults to `https://api-signa.logy.bd`
+- `fetcher` can be passed to override `fetch`

package/dist/chunk-0btcm6v6.js

@@ -0,0 +1,112 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/signalogy/shared/errors.ts
+class SignalogyError extends Error {
+  code;
+  status;
+  details;
+  constructor(params) {
+    super(params.message);
+    this.name = "SignalogyError";
+    this.code = params.code;
+    this.status = params.status ?? null;
+    this.details = params.details;
+  }
+}
+
+// src/signalogy/shared/fetcher.ts
+var readResponseBody = async (response) => {
+  const contentType = response.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    return response.json();
+  }
+  return response.text();
+};
+var createFetcher = (customFetch) => {
+  if (customFetch) {
+    return customFetch;
+  }
+  if (typeof fetch === "function") {
+    return fetch.bind(globalThis);
+  }
+  throw new SignalogyError({
+    code: "fetch_unavailable",
+    message: "Fetch API is not available in this environment."
+  });
+};
+var parseJsonResponse = async (response) => {
+  if (response.ok) {
+    return await readResponseBody(response);
+  }
+  const payload = await readResponseBody(response);
+  throw new SignalogyError({
+    code: "request_failed",
+    message: "Signalogy request failed",
+    status: response.status,
+    details: payload
+  });
+};
+
+// src/signalogy/shared/base-url.ts
+var DEFAULT_BASE_URL = "https://api-signa.logy.bd";
+
+// src/signalogy/shared/config.ts
+var normalizeConfig = (config) => ({
+  baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+  fetcher: config.fetcher
+});
+
+// src/signalogy/shared/env.ts
+var isBrowser = () => typeof window !== "undefined" && typeof document !== "undefined";
+
+export { __toESM, __toCommonJS, __commonJS, __export, __esm, __require, SignalogyError, createFetcher, parseJsonResponse, normalizeConfig, isBrowser };
+
+//# debugId=970F0C5E9B62A4DB64756E2164756E21

package/dist/chunk-0btcm6v6.js.map

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/signalogy/shared/errors.ts", "../src/signalogy/shared/fetcher.ts", "../src/signalogy/shared/base-url.ts", "../src/signalogy/shared/config.ts", "../src/signalogy/shared/env.ts"],
+  "sourcesContent": [
+    "export class SignalogyError extends Error {\n\tpublic readonly code: string;\n\tpublic readonly status: number | null;\n\tpublic readonly details: unknown;\n\n\tpublic constructor(params: {\n\t\tcode: string;\n\t\tmessage: string;\n\t\tstatus?: number | null;\n\t\tdetails?: unknown;\n\t}) {\n\t\tsuper(params.message);\n\t\tthis.name = \"SignalogyError\";\n\t\tthis.code = params.code;\n\t\tthis.status = params.status ?? null;\n\t\tthis.details = params.details;\n\t}\n}\n",
+    "import { SignalogyError } from \"./errors\";\n\nexport type Fetcher = (input: RequestInfo, init?: RequestInit) => Promise<Response>;\n\nconst readResponseBody = async (response: Response): Promise<unknown> => {\n\tconst contentType = response.headers.get(\"content-type\") ?? \"\";\n\tif (contentType.includes(\"application/json\")) {\n\t\treturn response.json();\n\t}\n\treturn response.text();\n};\n\nexport const createFetcher = (customFetch?: Fetcher): Fetcher => {\n\tif (customFetch) {\n\t\treturn customFetch;\n\t}\n\n\tif (typeof fetch === \"function\") {\n\t\treturn fetch.bind(globalThis);\n\t}\n\n\tthrow new SignalogyError({\n\t\tcode: \"fetch_unavailable\",\n\t\tmessage: \"Fetch API is not available in this environment.\",\n\t});\n};\n\nexport const parseJsonResponse = async <T>(\n\tresponse: Response,\n): Promise<T> => {\n\tif (response.ok) {\n\t\treturn (await readResponseBody(response)) as T;\n\t}\n\n\tconst payload = await readResponseBody(response);\n\tthrow new SignalogyError({\n\t\tcode: \"request_failed\",\n\t\tmessage: \"Signalogy request failed\",\n\t\tstatus: response.status,\n\t\tdetails: payload,\n\t});\n};\n",
+    "export const DEFAULT_BASE_URL = \"https://api-signa.logy.bd\";\n",
+    "import { DEFAULT_BASE_URL } from \"./base-url\";\nimport type { Fetcher } from \"./fetcher\";\n\nexport type SignalogyConfig = {\n\tbaseUrl: string;\n\tfetcher?: Fetcher;\n};\n\nexport const normalizeConfig = (config: {\n\tbaseUrl?: string;\n\tfetcher?: Fetcher;\n}): SignalogyConfig => ({\n\tbaseUrl: config.baseUrl ?? DEFAULT_BASE_URL,\n\tfetcher: config.fetcher,\n});\n",
+    "export const isBrowser = (): boolean =>\n\ttypeof window !== \"undefined\" && typeof document !== \"undefined\";\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAO,MAAM,uBAAuB,MAAM;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EAET,WAAW,CAAC,QAKhB;AAAA,IACF,MAAM,OAAO,OAAO;AAAA,IACpB,KAAK,OAAO;AAAA,IACZ,KAAK,OAAO,OAAO;AAAA,IACnB,KAAK,SAAS,OAAO,UAAU;AAAA,IAC/B,KAAK,UAAU,OAAO;AAAA;AAExB;;;ACbA,IAAM,mBAAmB,OAAO,aAAyC;AAAA,EACxE,MAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAAA,EAC5D,IAAI,YAAY,SAAS,kBAAkB,GAAG;AAAA,IAC7C,OAAO,SAAS,KAAK;AAAA,EACtB;AAAA,EACA,OAAO,SAAS,KAAK;AAAA;AAGf,IAAM,gBAAgB,CAAC,gBAAmC;AAAA,EAChE,IAAI,aAAa;AAAA,IAChB,OAAO;AAAA,EACR;AAAA,EAEA,IAAI,OAAO,UAAU,YAAY;AAAA,IAChC,OAAO,MAAM,KAAK,UAAU;AAAA,EAC7B;AAAA,EAEA,MAAM,IAAI,eAAe;AAAA,IACxB,MAAM;AAAA,IACN,SAAS;AAAA,EACV,CAAC;AAAA;AAGK,IAAM,oBAAoB,OAChC,aACgB;AAAA,EAChB,IAAI,SAAS,IAAI;AAAA,IAChB,OAAQ,MAAM,iBAAiB,QAAQ;AAAA,EACxC;AAAA,EAEA,MAAM,UAAU,MAAM,iBAAiB,QAAQ;AAAA,EAC/C,MAAM,IAAI,eAAe;AAAA,IACxB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,QAAQ,SAAS;AAAA,IACjB,SAAS;AAAA,EACV,CAAC;AAAA;;;ACxCK,IAAM,mBAAmB;;;ACQzB,IAAM,kBAAkB,CAAC,YAGR;AAAA,EACvB,SAAS,OAAO,WAAW;AAAA,EAC3B,SAAS,OAAO;AACjB;;;ACdO,IAAM,YAAY,MACxB,OAAO,WAAW,eAAe,OAAO,aAAa;",
+  "debugId": "970F0C5E9B62A4DB64756E2164756E21",
+  "names": []
+}

package/dist/chunk-5d3f1stk.js

@@ -0,0 +1,82 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/signalogy/shared/errors.ts
+class SignalogyError extends Error {
+  code;
+  status;
+  details;
+  constructor(params) {
+    super(params.message);
+    this.name = "SignalogyError";
+    this.code = params.code;
+    this.status = params.status ?? null;
+    this.details = params.details;
+  }
+}
+
+// src/signalogy/shared/fetcher.ts
+var readResponseBody = async (response) => {
+  const contentType = response.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    return response.json();
+  }
+  return response.text();
+};
+var createFetcher = (customFetch) => {
+  if (customFetch) {
+    return customFetch;
+  }
+  if (typeof fetch === "function") {
+    return fetch.bind(globalThis);
+  }
+  throw new SignalogyError({
+    code: "fetch_unavailable",
+    message: "Fetch API is not available in this environment."
+  });
+};
+var parseJsonResponse = async (response) => {
+  if (response.ok) {
+    return await readResponseBody(response);
+  }
+  const payload = await readResponseBody(response);
+  throw new SignalogyError({
+    code: "request_failed",
+    message: "Signalogy request failed",
+    status: response.status,
+    details: payload
+  });
+};
+
+// src/signalogy/shared/base-url.ts
+var DEFAULT_BASE_URL = "https://api-signa.logy.bd";
+
+// src/signalogy/shared/config.ts
+var normalizeConfig = (config) => ({
+  baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+  fetcher: config.fetcher
+});
+
+// src/signalogy/shared/env.ts
+var isBrowser = () => typeof window !== "undefined" && typeof document !== "undefined";
+
+export { __toESM, __commonJS, __require, SignalogyError, createFetcher, parseJsonResponse, normalizeConfig, isBrowser };
+
+//# debugId=B1D0C5FFFFD1E51464756E2164756E21

package/dist/chunk-5d3f1stk.js.map

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/signalogy/shared/errors.ts", "../src/signalogy/shared/fetcher.ts", "../src/signalogy/shared/base-url.ts", "../src/signalogy/shared/config.ts", "../src/signalogy/shared/env.ts"],
+  "sourcesContent": [
+    "export class SignalogyError extends Error {\n\tpublic readonly code: string;\n\tpublic readonly status: number | null;\n\tpublic readonly details: unknown;\n\n\tpublic constructor(params: {\n\t\tcode: string;\n\t\tmessage: string;\n\t\tstatus?: number | null;\n\t\tdetails?: unknown;\n\t}) {\n\t\tsuper(params.message);\n\t\tthis.name = \"SignalogyError\";\n\t\tthis.code = params.code;\n\t\tthis.status = params.status ?? null;\n\t\tthis.details = params.details;\n\t}\n}\n",
+    "import { SignalogyError } from \"./errors\";\n\nexport type Fetcher = (input: RequestInfo, init?: RequestInit) => Promise<Response>;\n\nconst readResponseBody = async (response: Response): Promise<unknown> => {\n\tconst contentType = response.headers.get(\"content-type\") ?? \"\";\n\tif (contentType.includes(\"application/json\")) {\n\t\treturn response.json();\n\t}\n\treturn response.text();\n};\n\nexport const createFetcher = (customFetch?: Fetcher): Fetcher => {\n\tif (customFetch) {\n\t\treturn customFetch;\n\t}\n\n\tif (typeof fetch === \"function\") {\n\t\treturn fetch.bind(globalThis);\n\t}\n\n\tthrow new SignalogyError({\n\t\tcode: \"fetch_unavailable\",\n\t\tmessage: \"Fetch API is not available in this environment.\",\n\t});\n};\n\nexport const parseJsonResponse = async <T>(\n\tresponse: Response,\n): Promise<T> => {\n\tif (response.ok) {\n\t\treturn (await readResponseBody(response)) as T;\n\t}\n\n\tconst payload = await readResponseBody(response);\n\tthrow new SignalogyError({\n\t\tcode: \"request_failed\",\n\t\tmessage: \"Signalogy request failed\",\n\t\tstatus: response.status,\n\t\tdetails: payload,\n\t});\n};\n",
+    "export const DEFAULT_BASE_URL = \"https://api-signa.logy.bd\";\n",
+    "import { DEFAULT_BASE_URL } from \"./base-url\";\nimport type { Fetcher } from \"./fetcher\";\n\nexport type SignalogyConfig = {\n\tbaseUrl: string;\n\tfetcher?: Fetcher;\n};\n\nexport const normalizeConfig = (config: {\n\tbaseUrl?: string;\n\tfetcher?: Fetcher;\n}): SignalogyConfig => ({\n\tbaseUrl: config.baseUrl ?? DEFAULT_BASE_URL,\n\tfetcher: config.fetcher,\n});\n",
+    "export const isBrowser = (): boolean =>\n\ttypeof window !== \"undefined\" && typeof document !== \"undefined\";\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAO,MAAM,uBAAuB,MAAM;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EAET,WAAW,CAAC,QAKhB;AAAA,IACF,MAAM,OAAO,OAAO;AAAA,IACpB,KAAK,OAAO;AAAA,IACZ,KAAK,OAAO,OAAO;AAAA,IACnB,KAAK,SAAS,OAAO,UAAU;AAAA,IAC/B,KAAK,UAAU,OAAO;AAAA;AAExB;;;ACbA,IAAM,mBAAmB,OAAO,aAAyC;AAAA,EACxE,MAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAAA,EAC5D,IAAI,YAAY,SAAS,kBAAkB,GAAG;AAAA,IAC7C,OAAO,SAAS,KAAK;AAAA,EACtB;AAAA,EACA,OAAO,SAAS,KAAK;AAAA;AAGf,IAAM,gBAAgB,CAAC,gBAAmC;AAAA,EAChE,IAAI,aAAa;AAAA,IAChB,OAAO;AAAA,EACR;AAAA,EAEA,IAAI,OAAO,UAAU,YAAY;AAAA,IAChC,OAAO,MAAM,KAAK,UAAU;AAAA,EAC7B;AAAA,EAEA,MAAM,IAAI,eAAe;AAAA,IACxB,MAAM;AAAA,IACN,SAAS;AAAA,EACV,CAAC;AAAA;AAGK,IAAM,oBAAoB,OAChC,aACgB;AAAA,EAChB,IAAI,SAAS,IAAI;AAAA,IAChB,OAAQ,MAAM,iBAAiB,QAAQ;AAAA,EACxC;AAAA,EAEA,MAAM,UAAU,MAAM,iBAAiB,QAAQ;AAAA,EAC/C,MAAM,IAAI,eAAe;AAAA,IACxB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,QAAQ,SAAS;AAAA,IACjB,SAAS;AAAA,EACV,CAAC;AAAA;;;ACxCK,IAAM,mBAAmB;;;ACQzB,IAAM,kBAAkB,CAAC,YAGR;AAAA,EACvB,SAAS,OAAO,WAAW;AAAA,EAC3B,SAAS,OAAO;AACjB;;;ACdO,IAAM,YAAY,MACxB,OAAO,WAAW,eAAe,OAAO,aAAa;",
+  "debugId": "B1D0C5FFFFD1E51464756E2164756E21",
+  "names": []
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./signalogy/server";
+export * from "./signalogy/client";

package/dist/index.js

@@ -0,0 +1,19 @@
+import {
+  createSignalogyServer
+} from "./signalogy/server/index.js";
+import {
+  createBrowserJwtStorage,
+  createCookieJwt,
+  createLocalStorageJwt,
+  createSignalogyClient
+} from "./signalogy/client/index.js";
+import"./chunk-5d3f1stk.js";
+export {
+  createSignalogyServer,
+  createSignalogyClient,
+  createLocalStorageJwt,
+  createCookieJwt,
+  createBrowserJwtStorage
+};
+
+//# debugId=DEBFF4A3EF01451D64756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "DEBFF4A3EF01451D64756E2164756E21",
+  "names": []
+}

package/dist/signalogy/client/index.d.ts

@@ -0,0 +1,17 @@
+import { type Fetcher } from "../shared/fetcher";
+import type { JwtStorage } from "./storage";
+import type { SignalogyWebSocketHandlers } from "./types";
+export type SignalogyClientOptions = {
+    secretId: string;
+    baseUrl?: string;
+    fetcher?: Fetcher;
+    jwtStorage?: JwtStorage;
+};
+export type SignalogyClient = {
+    connectWebSocket: (handlers: SignalogyWebSocketHandlers) => WebSocket;
+    getToken: () => string | null;
+    validateToken: () => Promise<Record<string, unknown>>;
+};
+export declare const createSignalogyClient: (options: SignalogyClientOptions) => SignalogyClient;
+export type SignalogyClientInstance = SignalogyClient;
+export { createCookieJwt, createLocalStorageJwt, createBrowserJwtStorage, } from "./storage";

package/dist/signalogy/client/index.js

@@ -0,0 +1,152 @@
+import {
+  SignalogyError,
+  createFetcher,
+  isBrowser,
+  normalizeConfig,
+  parseJsonResponse
+} from "../../chunk-5d3f1stk.js";
+
+// src/signalogy/client/storage.ts
+var hasLocalStorage = () => typeof window !== "undefined" && !!window.localStorage;
+var hasDocument = () => typeof document !== "undefined";
+var readCookie = (key) => {
+  if (!hasDocument()) {
+    return null;
+  }
+  const entries = document.cookie.split(";").map((entry) => entry.trim());
+  for (const entry of entries) {
+    if (entry.startsWith(`${key}=`)) {
+      return decodeURIComponent(entry.slice(key.length + 1));
+    }
+  }
+  return null;
+};
+var writeCookie = (key, value) => {
+  if (!hasDocument()) {
+    return;
+  }
+  document.cookie = `${key}=${encodeURIComponent(value)}; path=/`;
+};
+var clearCookie = (key) => {
+  if (!hasDocument()) {
+    return;
+  }
+  document.cookie = `${key}=; path=/; max-age=0`;
+};
+var createLocalStorageJwt = (key) => ({
+  get: () => {
+    if (!hasLocalStorage()) {
+      return null;
+    }
+    return window.localStorage.getItem(key);
+  },
+  set: (token) => {
+    if (!hasLocalStorage()) {
+      return;
+    }
+    window.localStorage.setItem(key, token);
+  },
+  clear: () => {
+    if (!hasLocalStorage()) {
+      return;
+    }
+    window.localStorage.removeItem(key);
+  }
+});
+var createCookieJwt = (key) => ({
+  get: () => readCookie(key),
+  set: (token) => writeCookie(key, token),
+  clear: () => clearCookie(key)
+});
+var createBrowserJwtStorage = (key) => ({
+  get: () => {
+    if (hasLocalStorage()) {
+      const value = window.localStorage.getItem(key);
+      if (value) {
+        return value;
+      }
+    }
+    return readCookie(key);
+  },
+  set: (token) => {
+    if (hasLocalStorage()) {
+      window.localStorage.setItem(key, token);
+      return;
+    }
+    writeCookie(key, token);
+  },
+  clear: () => {
+    if (hasLocalStorage()) {
+      window.localStorage.removeItem(key);
+    }
+    clearCookie(key);
+  }
+});
+
+// src/signalogy/client/index.ts
+var createSignalogyClient = (options) => {
+  const { baseUrl, fetcher: customFetch } = normalizeConfig({
+    baseUrl: options.baseUrl,
+    fetcher: options.fetcher
+  });
+  const fetcher = createFetcher(customFetch);
+  const jwtStorage = options.jwtStorage;
+  const getToken = () => jwtStorage?.get() ?? null;
+  const connectWebSocket = (handlers) => {
+    if (!isBrowser()) {
+      throw new SignalogyError({
+        code: "browser_required",
+        message: "Signalogy client SDK requires a browser environment."
+      });
+    }
+    const token = getToken();
+    if (!token) {
+      throw new SignalogyError({
+        code: "missing_token",
+        message: "No JWT token available. Provide a jwtStorage implementation."
+      });
+    }
+    const wsBase = baseUrl.replace(/^http/, "ws");
+    const wsUrl = `${wsBase}/api/notifications/ws?token=${encodeURIComponent(token)}&secret_id=${encodeURIComponent(options.secretId)}`;
+    const socket = new WebSocket(wsUrl);
+    if (handlers.onOpen) {
+      socket.addEventListener("open", () => handlers.onOpen?.());
+    }
+    if (handlers.onMessage) {
+      socket.addEventListener("message", (event) => handlers.onMessage?.(event));
+    }
+    if (handlers.onClose) {
+      socket.addEventListener("close", (event) => handlers.onClose?.(event));
+    }
+    if (handlers.onError) {
+      socket.addEventListener("error", () => handlers.onError?.());
+    }
+    return socket;
+  };
+  const validateToken = async () => {
+    const token = getToken();
+    if (!token) {
+      throw new SignalogyError({
+        code: "missing_token",
+        message: "No JWT token available. Provide a jwtStorage implementation."
+      });
+    }
+    const response = await fetcher(`${baseUrl}/api/notifications/validate?secret_id=${encodeURIComponent(options.secretId)}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ token })
+    });
+    return parseJsonResponse(response);
+  };
+  return { connectWebSocket, getToken, validateToken };
+};
+export {
+  createSignalogyClient,
+  createLocalStorageJwt,
+  createCookieJwt,
+  createBrowserJwtStorage
+};
+
+export { createLocalStorageJwt, createCookieJwt, createBrowserJwtStorage, createSignalogyClient };
+
+//# debugId=879F8C9F626965F864756E2164756E21

package/dist/signalogy/client/index.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/signalogy/client/storage.ts", "../src/signalogy/client/index.ts"],
+  "sourcesContent": [
+    "export type JwtStorage = {\n\tget: () => string | null;\n\tset: (token: string) => void;\n\tclear: () => void;\n};\n\nconst hasLocalStorage = (): boolean =>\n\ttypeof window !== \"undefined\" && !!window.localStorage;\n\nconst hasDocument = (): boolean => typeof document !== \"undefined\";\n\nconst readCookie = (key: string): string | null => {\n\tif (!hasDocument()) {\n\t\treturn null;\n\t}\n\tconst entries = document.cookie.split(\";\").map((entry) => entry.trim());\n\tfor (const entry of entries) {\n\t\tif (entry.startsWith(`${key}=`)) {\n\t\t\treturn decodeURIComponent(entry.slice(key.length + 1));\n\t\t}\n\t}\n\treturn null;\n};\n\nconst writeCookie = (key: string, value: string): void => {\n\tif (!hasDocument()) {\n\t\treturn;\n\t}\n\tdocument.cookie = `${key}=${encodeURIComponent(value)}; path=/`;\n};\n\nconst clearCookie = (key: string): void => {\n\tif (!hasDocument()) {\n\t\treturn;\n\t}\n\tdocument.cookie = `${key}=; path=/; max-age=0`;\n};\n\nexport const createLocalStorageJwt = (key: string): JwtStorage => ({\n\tget: () => {\n\t\tif (!hasLocalStorage()) {\n\t\t\treturn null;\n\t\t}\n\t\treturn window.localStorage.getItem(key);\n\t},\n\tset: (token: string) => {\n\t\tif (!hasLocalStorage()) {\n\t\t\treturn;\n\t\t}\n\t\twindow.localStorage.setItem(key, token);\n\t},\n\tclear: () => {\n\t\tif (!hasLocalStorage()) {\n\t\t\treturn;\n\t\t}\n\t\twindow.localStorage.removeItem(key);\n\t},\n});\n\nexport const createCookieJwt = (key: string): JwtStorage => ({\n\tget: () => readCookie(key),\n\tset: (token: string) => writeCookie(key, token),\n\tclear: () => clearCookie(key),\n});\n\nexport const createBrowserJwtStorage = (key: string): JwtStorage => ({\n\tget: () => {\n\t\tif (hasLocalStorage()) {\n\t\t\tconst value = window.localStorage.getItem(key);\n\t\t\tif (value) {\n\t\t\t\treturn value;\n\t\t\t}\n\t\t}\n\t\treturn readCookie(key);\n\t},\n\tset: (token: string) => {\n\t\tif (hasLocalStorage()) {\n\t\t\twindow.localStorage.setItem(key, token);\n\t\t\treturn;\n\t\t}\n\t\twriteCookie(key, token);\n\t},\n\tclear: () => {\n\t\tif (hasLocalStorage()) {\n\t\t\twindow.localStorage.removeItem(key);\n\t\t}\n\t\tclearCookie(key);\n\t},\n});\n",
+    "import { createFetcher, parseJsonResponse, type Fetcher } from \"../shared/fetcher\";\nimport { SignalogyError } from \"../shared/errors\";\nimport type { JwtStorage } from \"./storage\";\nimport type { SignalogyWebSocketHandlers } from \"./types\";\nimport { normalizeConfig } from \"../shared/config\";\nimport { isBrowser } from \"../shared/env\";\n\nexport type SignalogyClientOptions = {\n\tsecretId: string;\n\tbaseUrl?: string;\n\tfetcher?: Fetcher;\n\tjwtStorage?: JwtStorage;\n};\n\nexport type SignalogyClient = {\n\tconnectWebSocket: (handlers: SignalogyWebSocketHandlers) => WebSocket;\n\tgetToken: () => string | null;\n\tvalidateToken: () => Promise<Record<string, unknown>>;\n};\n\nexport const createSignalogyClient = (\n\toptions: SignalogyClientOptions,\n): SignalogyClient => {\n\tconst { baseUrl, fetcher: customFetch } = normalizeConfig({\n\t\tbaseUrl: options.baseUrl,\n\t\tfetcher: options.fetcher,\n\t});\n\tconst fetcher = createFetcher(customFetch);\n\tconst jwtStorage = options.jwtStorage;\n\n\tconst getToken = (): string | null => jwtStorage?.get() ?? null;\n\n\tconst connectWebSocket: SignalogyClient[\"connectWebSocket\"] = (\n\t\thandlers: SignalogyWebSocketHandlers,\n\t): WebSocket => {\n\t\tif (!isBrowser()) {\n\t\t\tthrow new SignalogyError({\n\t\t\t\tcode: \"browser_required\",\n\t\t\t\tmessage: \"Signalogy client SDK requires a browser environment.\",\n\t\t\t});\n\t\t}\n\n\t\tconst token = getToken();\n\t\tif (!token) {\n\t\t\tthrow new SignalogyError({\n\t\t\t\tcode: \"missing_token\",\n\t\t\t\tmessage: \"No JWT token available. Provide a jwtStorage implementation.\",\n\t\t\t});\n\t\t}\n\n\t\tconst wsBase = baseUrl.replace(/^http/, \"ws\");\n\t\tconst wsUrl = `${wsBase}/api/notifications/ws?token=${encodeURIComponent(\n\t\t\ttoken,\n\t\t)}&secret_id=${encodeURIComponent(options.secretId)}`;\n\t\tconst socket = new WebSocket(wsUrl);\n\n\t\tif (handlers.onOpen) {\n\t\t\tsocket.addEventListener(\"open\", () => handlers.onOpen?.());\n\t\t}\n\t\tif (handlers.onMessage) {\n\t\t\tsocket.addEventListener(\"message\", (event) =>\n\t\t\t\thandlers.onMessage?.(event),\n\t\t\t);\n\t\t}\n\t\tif (handlers.onClose) {\n\t\t\tsocket.addEventListener(\"close\", (event) => handlers.onClose?.(event));\n\t\t}\n\t\tif (handlers.onError) {\n\t\t\tsocket.addEventListener(\"error\", () => handlers.onError?.());\n\t\t}\n\n\t\treturn socket;\n\t};\n\n\tconst validateToken = async (): Promise<Record<string, unknown>> => {\n\t\tconst token = getToken();\n\t\tif (!token) {\n\t\t\tthrow new SignalogyError({\n\t\t\t\tcode: \"missing_token\",\n\t\t\t\tmessage: \"No JWT token available. Provide a jwtStorage implementation.\",\n\t\t\t});\n\t\t}\n\n\t\tconst response = await fetcher(\n\t\t\t`${baseUrl}/api/notifications/validate?secret_id=${encodeURIComponent(\n\t\t\t\toptions.secretId,\n\t\t\t)}`,\n\t\t\t{\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t\t\tbody: JSON.stringify({ token }),\n\t\t\t},\n\t\t);\n\n\t\treturn parseJsonResponse<Record<string, unknown>>(response);\n\t};\n\n\treturn { connectWebSocket, getToken, validateToken };\n};\n\nexport type SignalogyClientInstance = SignalogyClient;\nexport {\n\tcreateCookieJwt,\n\tcreateLocalStorageJwt,\n\tcreateBrowserJwtStorage,\n} from \"./storage\";\n"
+  ],
+  "mappings": "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",
+  "debugId": "879F8C9F626965F864756E2164756E21",
+  "names": []
+}

package/dist/signalogy/client/react/index.d.ts

@@ -0,0 +1,7 @@
+import type { SignalogyClientOptions, SignalogyClient } from "../index";
+export type UseSignalogyClientResult = {
+    client: SignalogyClient | null;
+    status: "idle" | "ready" | "error";
+    error: Error | null;
+};
+export declare const useSignalogyClient: (options: SignalogyClientOptions) => UseSignalogyClientResult;