@agentuity/frontend 0.1.13 → 0.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/dist/beacon-script.js +1 -1
  2. package/dist/beacon.js +1 -1
  3. package/package.json +4 -4
  4. package/dist/analytics/beacon-standalone.d.ts +0 -106
  5. package/dist/analytics/beacon-standalone.d.ts.map +0 -1
  6. package/dist/analytics/beacon-standalone.js +0 -584
  7. package/dist/analytics/beacon-standalone.js.map +0 -1
  8. package/dist/analytics/index.d.ts +0 -22
  9. package/dist/analytics/index.d.ts.map +0 -1
  10. package/dist/analytics/index.js +0 -28
  11. package/dist/analytics/index.js.map +0 -1
  12. package/dist/analytics/types.d.ts +0 -141
  13. package/dist/analytics/types.d.ts.map +0 -1
  14. package/dist/analytics/types.js +0 -2
  15. package/dist/analytics/types.js.map +0 -1
  16. package/dist/analytics/utils/storage.d.ts +0 -13
  17. package/dist/analytics/utils/storage.d.ts.map +0 -1
  18. package/dist/analytics/utils/storage.js +0 -63
  19. package/dist/analytics/utils/storage.js.map +0 -1
  20. package/dist/analytics/utils/utm.d.ts +0 -12
  21. package/dist/analytics/utils/utm.d.ts.map +0 -1
  22. package/dist/analytics/utils/utm.js +0 -27
  23. package/dist/analytics/utils/utm.js.map +0 -1
  24. package/dist/beacon-script.d.ts +0 -16
  25. package/dist/beacon-script.d.ts.map +0 -1
  26. package/dist/beacon-script.js.map +0 -1
  27. package/dist/client/eventstream.d.ts +0 -12
  28. package/dist/client/eventstream.d.ts.map +0 -1
  29. package/dist/client/eventstream.js +0 -39
  30. package/dist/client/eventstream.js.map +0 -1
  31. package/dist/client/index.d.ts +0 -33
  32. package/dist/client/index.d.ts.map +0 -1
  33. package/dist/client/index.js +0 -227
  34. package/dist/client/index.js.map +0 -1
  35. package/dist/client/stream.d.ts +0 -6
  36. package/dist/client/stream.d.ts.map +0 -1
  37. package/dist/client/stream.js +0 -49
  38. package/dist/client/stream.js.map +0 -1
  39. package/dist/client/types.d.ts +0 -168
  40. package/dist/client/types.d.ts.map +0 -1
  41. package/dist/client/types.js +0 -5
  42. package/dist/client/types.js.map +0 -1
  43. package/dist/client/websocket.d.ts +0 -6
  44. package/dist/client/websocket.d.ts.map +0 -1
  45. package/dist/client/websocket.js +0 -49
  46. package/dist/client/websocket.js.map +0 -1
  47. package/dist/env.d.ts +0 -2
  48. package/dist/env.d.ts.map +0 -1
  49. package/dist/env.js +0 -10
  50. package/dist/env.js.map +0 -1
  51. package/dist/eventstream-manager.d.ts +0 -85
  52. package/dist/eventstream-manager.d.ts.map +0 -1
  53. package/dist/eventstream-manager.js +0 -137
  54. package/dist/eventstream-manager.js.map +0 -1
  55. package/dist/index.d.ts +0 -13
  56. package/dist/index.d.ts.map +0 -1
  57. package/dist/index.js +0 -15
  58. package/dist/index.js.map +0 -1
  59. package/dist/memo.d.ts +0 -6
  60. package/dist/memo.d.ts.map +0 -1
  61. package/dist/memo.js +0 -20
  62. package/dist/memo.js.map +0 -1
  63. package/dist/reconnect.d.ts +0 -22
  64. package/dist/reconnect.d.ts.map +0 -1
  65. package/dist/reconnect.js +0 -47
  66. package/dist/reconnect.js.map +0 -1
  67. package/dist/serialization.d.ts +0 -6
  68. package/dist/serialization.d.ts.map +0 -1
  69. package/dist/serialization.js +0 -16
  70. package/dist/serialization.js.map +0 -1
  71. package/dist/types.d.ts +0 -42
  72. package/dist/types.d.ts.map +0 -1
  73. package/dist/types.js +0 -2
  74. package/dist/types.js.map +0 -1
  75. package/dist/url.d.ts +0 -3
  76. package/dist/url.d.ts.map +0 -1
  77. package/dist/url.js +0 -24
  78. package/dist/url.js.map +0 -1
  79. package/dist/websocket-manager.d.ts +0 -90
  80. package/dist/websocket-manager.d.ts.map +0 -1
  81. package/dist/websocket-manager.js +0 -163
  82. package/dist/websocket-manager.js.map +0 -1
package/dist/memo.js DELETED
@@ -1,20 +0,0 @@
1
- /**
2
- * Simple JSON-based equality check for memoization.
3
- * Compares stringified JSON to avoid deep equality overhead.
4
- */
5
- export function jsonEqual(a, b) {
6
- if (a === b)
7
- return true;
8
- if (a === undefined || b === undefined)
9
- return false;
10
- if (a === null || b === null)
11
- return a === b;
12
- try {
13
- return JSON.stringify(a) === JSON.stringify(b);
14
- }
15
- catch {
16
- // Fallback for non-serializable values
17
- return false;
18
- }
19
- }
20
- //# sourceMappingURL=memo.js.map
package/dist/memo.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"memo.js","sourceRoot":"","sources":["../src/memo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,CAAI,EAAE,CAAI;IACtC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACR,uCAAuC;QACvC,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}
@@ -1,22 +0,0 @@
1
- export interface ReconnectOptions {
2
- onReconnect: () => void;
3
- threshold?: number;
4
- baseDelay?: number;
5
- factor?: number;
6
- maxDelay?: number;
7
- jitter?: number;
8
- enabled?: () => boolean;
9
- }
10
- export interface ReconnectManager {
11
- recordFailure: () => {
12
- scheduled: boolean;
13
- delay: number | null;
14
- };
15
- recordSuccess: () => void;
16
- cancel: () => void;
17
- reset: () => void;
18
- dispose: () => void;
19
- getAttempts: () => number;
20
- }
21
- export declare function createReconnectManager(opts: ReconnectOptions): ReconnectManager;
22
- //# sourceMappingURL=reconnect.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"reconnect.d.ts","sourceRoot":"","sources":["../src/reconnect.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAqD/E"}
package/dist/reconnect.js DELETED
@@ -1,47 +0,0 @@
1
- export function createReconnectManager(opts) {
2
- let attempts = 0;
3
- let timer = null;
4
- const cancel = () => {
5
- if (timer) {
6
- clearTimeout(timer);
7
- timer = null;
8
- }
9
- };
10
- const reset = () => {
11
- attempts = 0;
12
- cancel();
13
- };
14
- const recordSuccess = () => reset();
15
- const computeDelay = (attemptAfterThreshold) => {
16
- const base = opts.baseDelay ?? 500;
17
- const factor = opts.factor ?? 2;
18
- const max = opts.maxDelay ?? 30000;
19
- const jitterMax = opts.jitter ?? 250;
20
- const backoff = Math.min(base * Math.pow(factor, attemptAfterThreshold), max);
21
- const jitter = jitterMax > 0 ? Math.random() * jitterMax : 0;
22
- return backoff + jitter;
23
- };
24
- const recordFailure = () => {
25
- attempts += 1;
26
- const threshold = opts.threshold ?? 0;
27
- if (opts.enabled && !opts.enabled()) {
28
- return { scheduled: false, delay: null };
29
- }
30
- if (attempts - threshold >= 0) {
31
- const after = Math.max(0, attempts - threshold);
32
- const delay = computeDelay(after);
33
- cancel();
34
- timer = setTimeout(() => {
35
- if (opts.enabled && !opts.enabled())
36
- return;
37
- opts.onReconnect();
38
- }, delay);
39
- return { scheduled: true, delay };
40
- }
41
- return { scheduled: false, delay: null };
42
- };
43
- const dispose = () => cancel();
44
- const getAttempts = () => attempts;
45
- return { recordFailure, recordSuccess, cancel, reset, dispose, getAttempts };
46
- }
47
- //# sourceMappingURL=reconnect.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"reconnect.js","sourceRoot":"","sources":["../src/reconnect.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC5D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAAK,GAAyC,IAAI,CAAC;IAEvD,MAAM,MAAM,GAAG,GAAG,EAAE;QACnB,IAAI,KAAK,EAAE,CAAC;YACX,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACd,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE;QAClB,QAAQ,GAAG,CAAC,CAAC;QACb,MAAM,EAAE,CAAC;IACV,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IAEpC,MAAM,YAAY,GAAG,CAAC,qBAA6B,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,OAAO,OAAO,GAAG,MAAM,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAG,EAAE;QAC1B,QAAQ,IAAI,CAAC,CAAC;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACrC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QAED,IAAI,QAAQ,GAAG,SAAS,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,EAAE,CAAC;YACT,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACvB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;oBAAE,OAAO;gBAC5C,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,CAAC,EAAE,KAAK,CAAC,CAAC;YACV,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;IAE/B,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC;IAEnC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAC9E,CAAC"}
@@ -1,6 +0,0 @@
1
- /**
2
- * Deserialize data received from WebSocket or EventStream.
3
- * Attempts to parse as JSON if the data looks like JSON, otherwise returns as-is.
4
- */
5
- export declare const deserializeData: <T>(data: string) => T;
6
- //# sourceMappingURL=serialization.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,MAAM,MAAM,KAAG,CASjD,CAAC"}
@@ -1,16 +0,0 @@
1
- /**
2
- * Deserialize data received from WebSocket or EventStream.
3
- * Attempts to parse as JSON if the data looks like JSON, otherwise returns as-is.
4
- */
5
- export const deserializeData = (data) => {
6
- if (data) {
7
- try {
8
- return JSON.parse(data);
9
- }
10
- catch {
11
- /* */
12
- }
13
- }
14
- return data;
15
- };
16
- //# sourceMappingURL=serialization.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"serialization.js","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,IAAY,EAAK,EAAE;IACrD,IAAI,IAAI,EAAE,CAAC;QACV,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACR,KAAK;QACN,CAAC;IACF,CAAC;IACD,OAAO,IAAS,CAAC;AAClB,CAAC,CAAC"}
package/dist/types.d.ts DELETED
@@ -1,42 +0,0 @@
1
- /**
2
- * Route registry containing all typed API routes in the application.
3
- * Auto-generated by the build tool from routes that use validator() middleware.
4
- *
5
- * @remarks
6
- * This interface is augmented by generated code via `declare module '@agentuity/frontend'`.
7
- * The augmentation provides type-safe routing for useAPI and other hooks.
8
- */
9
- export interface RouteRegistry {
10
- }
11
- /**
12
- * WebSocket route registry containing all typed WebSocket routes in the application.
13
- * Auto-generated by the build tool from routes that use validator() middleware.
14
- *
15
- * @remarks
16
- * This interface is augmented by generated code via `declare module '@agentuity/frontend'`.
17
- * The augmentation provides type-safe routing for useWebsocket and other hooks.
18
- */
19
- export interface WebSocketRouteRegistry {
20
- }
21
- /**
22
- * SSE route registry containing all typed SSE routes in the application.
23
- * Auto-generated by the build tool from routes that use validator() middleware.
24
- *
25
- * @remarks
26
- * This interface is augmented by generated code via `declare module '@agentuity/frontend'`.
27
- * The augmentation provides type-safe routing for useEventStream and other hooks.
28
- */
29
- export interface SSERouteRegistry {
30
- }
31
- /**
32
- * RPC route registry containing all typed RPC routes in the application.
33
- * Used by createClient() and createAPIClient() for type-safe RPC-style API calls.
34
- * Auto-generated by the build tool from route discovery.
35
- *
36
- * @remarks
37
- * This interface is augmented by generated code via `declare module '@agentuity/frontend'`.
38
- * The augmentation provides type-safe routing for createClient and createAPIClient.
39
- */
40
- export interface RPCRouteRegistry {
41
- }
42
- //# sourceMappingURL=types.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,aAAa;CAG7B;AAED;;;;;;;GAOG;AAEH,MAAM,WAAW,sBAAsB;CAGtC;AAED;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;CAGhC;AAED;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;CAGhC"}
package/dist/types.js DELETED
@@ -1,2 +0,0 @@
1
- export {};
2
- //# sourceMappingURL=types.js.map
package/dist/types.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
package/dist/url.d.ts DELETED
@@ -1,3 +0,0 @@
1
- export declare const buildUrl: (base: string, path: string, subpath?: string, query?: URLSearchParams) => string;
2
- export declare const defaultBaseUrl: string;
3
- //# sourceMappingURL=url.d.ts.map
package/dist/url.d.ts.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,GACpB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,QAAQ,eAAe,KACrB,MAWF,CAAC;AAQF,eAAO,MAAM,cAAc,EAAE,MAKL,CAAC"}
package/dist/url.js DELETED
@@ -1,24 +0,0 @@
1
- import { getProcessEnv } from './env';
2
- export const buildUrl = (base, path, subpath, query) => {
3
- path = path.startsWith('/') ? path : `/${path}`;
4
- let url = base.replace(/\/$/, '') + path;
5
- if (subpath) {
6
- subpath = subpath.startsWith('/') ? subpath : `/${subpath}`;
7
- url += `/${subpath}`;
8
- }
9
- if (query) {
10
- url += `?${query.toString()}`;
11
- }
12
- return url;
13
- };
14
- const tryOrigin = () => {
15
- if (typeof window !== 'undefined') {
16
- return window.location.origin;
17
- }
18
- };
19
- export const defaultBaseUrl = getProcessEnv('NEXT_PUBLIC_AGENTUITY_URL') ||
20
- getProcessEnv('VITE_AGENTUITY_URL') ||
21
- getProcessEnv('AGENTUITY_URL') ||
22
- tryOrigin() ||
23
- 'http://localhost:3500';
24
- //# sourceMappingURL=url.js.map
package/dist/url.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"url.js","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,QAAQ,GAAG,CACvB,IAAY,EACZ,IAAY,EACZ,OAAgB,EAChB,KAAuB,EACd,EAAE;IACX,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAChD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;IACzC,IAAI,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC5D,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACX,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,GAAG,EAAE;IACtB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/B,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAC1B,aAAa,CAAC,2BAA2B,CAAC;IAC1C,aAAa,CAAC,oBAAoB,CAAC;IACnC,aAAa,CAAC,eAAe,CAAC;IAC9B,SAAS,EAAE;IACX,uBAAuB,CAAC"}
@@ -1,90 +0,0 @@
1
- /**
2
- * Message handler callback type
3
- */
4
- export type MessageHandler<T = unknown> = (data: T) => void;
5
- /**
6
- * WebSocket state change callback types
7
- */
8
- export interface WebSocketCallbacks<TOutput = unknown> {
9
- /** Called when connection is established */
10
- onConnect?: () => void;
11
- /** Called when connection is closed */
12
- onDisconnect?: () => void;
13
- /** Called when an error occurs */
14
- onError?: (error: Error) => void;
15
- /** Called when a message is received */
16
- onMessage?: MessageHandler<TOutput>;
17
- }
18
- /**
19
- * Options for WebSocketManager
20
- */
21
- export interface WebSocketManagerOptions<TOutput = unknown> {
22
- /** WebSocket URL */
23
- url: string;
24
- /** Callbacks for state changes */
25
- callbacks?: WebSocketCallbacks<TOutput>;
26
- /** Reconnection configuration */
27
- reconnect?: {
28
- threshold?: number;
29
- baseDelay?: number;
30
- factor?: number;
31
- maxDelay?: number;
32
- jitter?: number;
33
- };
34
- }
35
- /**
36
- * WebSocket manager state
37
- */
38
- export interface WebSocketManagerState {
39
- /** Whether WebSocket is currently connected */
40
- isConnected: boolean;
41
- /** Current error, if any */
42
- error: Error | null;
43
- /** WebSocket ready state */
44
- readyState: number;
45
- }
46
- /**
47
- * Generic WebSocket connection manager with automatic reconnection,
48
- * message queuing, and handler management.
49
- *
50
- * Framework-agnostic - can be used with React, Svelte, Vue, or vanilla JS.
51
- */
52
- export declare class WebSocketManager<TInput = unknown, TOutput = unknown> {
53
- private ws;
54
- private manualClose;
55
- private pendingMessages;
56
- private queuedMessages;
57
- private messageHandler;
58
- private reconnectManager;
59
- private callbacks;
60
- private url;
61
- private reconnectConfig;
62
- constructor(options: WebSocketManagerOptions<TOutput>);
63
- /**
64
- * Connect to the WebSocket server
65
- */
66
- connect(): void;
67
- /**
68
- * Send data through the WebSocket.
69
- * Messages are queued if not currently connected.
70
- */
71
- send(data: TInput): void;
72
- /**
73
- * Set the message handler.
74
- * Any buffered messages will be delivered immediately.
75
- */
76
- setMessageHandler(handler: MessageHandler<TOutput>): void;
77
- /**
78
- * Get current state
79
- */
80
- getState(): WebSocketManagerState;
81
- /**
82
- * Close the WebSocket connection and cleanup
83
- */
84
- close(): void;
85
- /**
86
- * Dispose of the manager (alias for close)
87
- */
88
- dispose(): void;
89
- }
90
- //# sourceMappingURL=websocket-manager.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"websocket-manager.d.ts","sourceRoot":"","sources":["../src/websocket-manager.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,OAAO,GAAG,OAAO;IACpD,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,wCAAwC;IACxC,SAAS,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,GAAG,OAAO;IACzD,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,SAAS,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACxC,iCAAiC;IACjC,SAAS,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAChE,OAAO,CAAC,EAAE,CAAwB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,eAAe,CAAuE;gBAElF,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC;IAYrD;;OAEG;IACH,OAAO,IAAI,IAAI;IAmEf;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQxB;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI;IAOzD;;OAEG;IACH,QAAQ,IAAI,qBAAqB;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAqBb;;OAEG;IACH,OAAO,IAAI,IAAI;CAGf"}
@@ -1,163 +0,0 @@
1
- import { createReconnectManager } from './reconnect';
2
- import { deserializeData } from './serialization';
3
- /**
4
- * Serialize data for WebSocket transmission
5
- */
6
- const serializeWSData = (data) => {
7
- if (typeof data === 'string') {
8
- return data;
9
- }
10
- if (typeof data === 'object') {
11
- if (data instanceof ArrayBuffer || ArrayBuffer.isView(data) || data instanceof Blob) {
12
- return data;
13
- }
14
- return JSON.stringify(data);
15
- }
16
- throw new Error('unsupported data type for websocket: ' + typeof data);
17
- };
18
- /**
19
- * Generic WebSocket connection manager with automatic reconnection,
20
- * message queuing, and handler management.
21
- *
22
- * Framework-agnostic - can be used with React, Svelte, Vue, or vanilla JS.
23
- */
24
- export class WebSocketManager {
25
- ws;
26
- manualClose = false;
27
- pendingMessages = [];
28
- queuedMessages = [];
29
- messageHandler;
30
- reconnectManager;
31
- callbacks;
32
- url;
33
- reconnectConfig;
34
- constructor(options) {
35
- this.url = options.url;
36
- this.callbacks = options.callbacks || {};
37
- this.reconnectConfig = {
38
- threshold: options.reconnect?.threshold ?? 0,
39
- baseDelay: options.reconnect?.baseDelay ?? 500,
40
- factor: options.reconnect?.factor ?? 2,
41
- maxDelay: options.reconnect?.maxDelay ?? 30000,
42
- jitter: options.reconnect?.jitter ?? 500,
43
- };
44
- }
45
- /**
46
- * Connect to the WebSocket server
47
- */
48
- connect() {
49
- if (this.manualClose)
50
- return;
51
- this.ws = new WebSocket(this.url);
52
- this.ws.onopen = () => {
53
- this.reconnectManager?.recordSuccess();
54
- this.callbacks.onConnect?.();
55
- // Flush queued messages
56
- if (this.queuedMessages.length > 0) {
57
- this.queuedMessages.forEach((msg) => this.ws.send(serializeWSData(msg)));
58
- this.queuedMessages = [];
59
- }
60
- };
61
- this.ws.onerror = () => {
62
- const error = new Error('WebSocket error');
63
- this.callbacks.onError?.(error);
64
- };
65
- this.ws.onclose = (evt) => {
66
- this.ws = undefined;
67
- this.callbacks.onDisconnect?.();
68
- if (this.manualClose) {
69
- this.queuedMessages = [];
70
- return;
71
- }
72
- if (evt.code !== 1000) {
73
- const error = new Error(`WebSocket closed: ${evt.code} ${evt.reason || ''}`);
74
- this.callbacks.onError?.(error);
75
- }
76
- this.reconnectManager?.recordFailure();
77
- };
78
- this.ws.onmessage = (event) => {
79
- const payload = deserializeData(event.data);
80
- // Call the registered message handler
81
- if (this.messageHandler) {
82
- this.messageHandler(payload);
83
- }
84
- else {
85
- // Buffer messages until a handler is set
86
- this.pendingMessages.push(payload);
87
- }
88
- // Also call the callback if provided
89
- this.callbacks.onMessage?.(payload);
90
- };
91
- // Setup reconnect manager
92
- if (!this.reconnectManager) {
93
- this.reconnectManager = createReconnectManager({
94
- onReconnect: () => this.connect(),
95
- threshold: this.reconnectConfig.threshold,
96
- baseDelay: this.reconnectConfig.baseDelay,
97
- factor: this.reconnectConfig.factor,
98
- maxDelay: this.reconnectConfig.maxDelay,
99
- jitter: this.reconnectConfig.jitter,
100
- enabled: () => !this.manualClose,
101
- });
102
- }
103
- }
104
- /**
105
- * Send data through the WebSocket.
106
- * Messages are queued if not currently connected.
107
- */
108
- send(data) {
109
- if (this.ws?.readyState === WebSocket.OPEN) {
110
- this.ws.send(serializeWSData(data));
111
- }
112
- else {
113
- this.queuedMessages.push(data);
114
- }
115
- }
116
- /**
117
- * Set the message handler.
118
- * Any buffered messages will be delivered immediately.
119
- */
120
- setMessageHandler(handler) {
121
- this.messageHandler = handler;
122
- // Flush pending messages
123
- this.pendingMessages.forEach(handler);
124
- this.pendingMessages = [];
125
- }
126
- /**
127
- * Get current state
128
- */
129
- getState() {
130
- return {
131
- isConnected: this.ws?.readyState === WebSocket.OPEN,
132
- error: null, // Error state managed externally via callbacks
133
- readyState: this.ws?.readyState ?? WebSocket.CLOSED,
134
- };
135
- }
136
- /**
137
- * Close the WebSocket connection and cleanup
138
- */
139
- close() {
140
- this.manualClose = true;
141
- this.reconnectManager?.dispose();
142
- if (this.ws) {
143
- this.ws.onopen = null;
144
- this.ws.onerror = null;
145
- this.ws.onclose = null;
146
- this.ws.onmessage = null;
147
- this.ws.close();
148
- }
149
- this.ws = undefined;
150
- this.messageHandler = undefined;
151
- this.pendingMessages = [];
152
- this.queuedMessages = [];
153
- // Notify disconnect callback
154
- this.callbacks.onDisconnect?.();
155
- }
156
- /**
157
- * Dispose of the manager (alias for close)
158
- */
159
- dispose() {
160
- this.close();
161
- }
162
- }
163
- //# sourceMappingURL=websocket-manager.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"websocket-manager.js","sourceRoot":"","sources":["../src/websocket-manager.ts"],"names":[],"mappings":"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"}