@plyaz/config 1.9.5 → 1.10.0

package/dist/streaming/constants.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Streaming Configuration Constants
+ *
+ * Default configuration values for the SSE/WebSocket streaming system.
+ * These can be overridden at runtime through configuration objects.
+ *
+ * @module src/streaming/constants
+ */
+import type { StreamChannel } from '@plyaz/types/core';
+/**
+ * Server Configuration
+ *
+ * Default values for StreamServer and transport adapters
+ */
+export declare const STREAMING_SERVER_CONFIG: {
+    /**
+     * Default heartbeat interval in milliseconds
+     * Keeps connections alive and detects stale clients
+     */
+    readonly HEARTBEAT_INTERVAL_MS: 30000;
+    /**
+     * Maximum number of concurrent connections per server
+     */
+    readonly MAX_CONNECTIONS: 1000;
+    /**
+     * Default channels to subscribe new connections to
+     */
+    readonly DEFAULT_CHANNELS: StreamChannel[];
+};
+/**
+ * Client Configuration
+ *
+ * Default values for client-side streaming hooks
+ */
+export declare const STREAMING_CLIENT_CONFIG: {
+    /**
+     * Delay before attempting to reconnect after disconnect
+     */
+    readonly RECONNECT_DELAY_MS: 1000;
+    /**
+     * Maximum reconnection attempts before giving up
+     */
+    readonly MAX_RECONNECT_ATTEMPTS: 10;
+    /**
+     * Default SSE endpoint path
+     */
+    readonly SSE_ENDPOINT: "/api/events/stream";
+};
+/**
+ * Buffer Configuration
+ *
+ * Default values for message buffering
+ */
+export declare const STREAMING_BUFFER_CONFIG: {
+    /**
+     * Default buffer size for queued messages (1KB)
+     */
+    readonly DEFAULT_BUFFER_SIZE: 1024;
+    /**
+     * Flush interval for buffered messages
+     */
+    readonly FLUSH_INTERVAL_MS: 1000;
+    /**
+     * Maximum buffer size before forced flush (10MB)
+     */
+    readonly MAX_BUFFER_SIZE: number;
+};
+/**
+ * Streaming Package Configuration
+ *
+ * Aggregated configuration object for streaming system
+ */
+export declare const STREAMING_PACKAGE_CONFIG: {
+    readonly SERVER: {
+        /**
+         * Default heartbeat interval in milliseconds
+         * Keeps connections alive and detects stale clients
+         */
+        readonly HEARTBEAT_INTERVAL_MS: 30000;
+        /**
+         * Maximum number of concurrent connections per server
+         */
+        readonly MAX_CONNECTIONS: 1000;
+        /**
+         * Default channels to subscribe new connections to
+         */
+        readonly DEFAULT_CHANNELS: StreamChannel[];
+    };
+    readonly CLIENT: {
+        /**
+         * Delay before attempting to reconnect after disconnect
+         */
+        readonly RECONNECT_DELAY_MS: 1000;
+        /**
+         * Maximum reconnection attempts before giving up
+         */
+        readonly MAX_RECONNECT_ATTEMPTS: 10;
+        /**
+         * Default SSE endpoint path
+         */
+        readonly SSE_ENDPOINT: "/api/events/stream";
+    };
+    readonly BUFFER: {
+        /**
+         * Default buffer size for queued messages (1KB)
+         */
+        readonly DEFAULT_BUFFER_SIZE: 1024;
+        /**
+         * Flush interval for buffered messages
+         */
+        readonly FLUSH_INTERVAL_MS: 1000;
+        /**
+         * Maximum buffer size before forced flush (10MB)
+         */
+        readonly MAX_BUFFER_SIZE: number;
+    };
+};
+/**
+ * Streaming Defaults (Flat)
+ *
+ * Flattened defaults for direct import compatibility
+ * with existing code using STREAMING_DEFAULTS
+ */
+export declare const STREAMING_DEFAULTS: {
+    readonly HEARTBEAT_INTERVAL_MS: 30000;
+    readonly MAX_CONNECTIONS: 1000;
+    readonly DEFAULT_CHANNELS: StreamChannel[];
+    readonly RECONNECT_DELAY_MS: 1000;
+    readonly MAX_RECONNECT_ATTEMPTS: 10;
+    readonly SSE_ENDPOINT: "/api/events/stream";
+};
+/**
+ * Type for streaming defaults
+ */
+export type StreamingDefaults = typeof STREAMING_DEFAULTS;
+//# sourceMappingURL=constants.d.ts.map

package/dist/streaming/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/streaming/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;IAClC;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;+BACwC,aAAa,EAAE;CAClD,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;IAClC;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEK,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;IAClC;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAGK,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;QAnEnC;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;mCACwC,aAAa,EAAE;;;QAS1D;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;QAUH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;CAcK,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC"}

package/dist/streaming/index.cjs

@@ -0,0 +1,3 @@
+'use strict';// @plyaz package - Built with tsup
+var E={HEARTBEAT_INTERVAL_MS:3e4,MAX_CONNECTIONS:1e3,DEFAULT_CHANNELS:["uploads","system"]},N={RECONNECT_DELAY_MS:1e3,MAX_RECONNECT_ATTEMPTS:10,SSE_ENDPOINT:"/api/events/stream"},T={DEFAULT_BUFFER_SIZE:1024,FLUSH_INTERVAL_MS:1e3,MAX_BUFFER_SIZE:10*1024*1024},_={SERVER:E,CLIENT:N,BUFFER:T},A={HEARTBEAT_INTERVAL_MS:E.HEARTBEAT_INTERVAL_MS,MAX_CONNECTIONS:E.MAX_CONNECTIONS,DEFAULT_CHANNELS:E.DEFAULT_CHANNELS,RECONNECT_DELAY_MS:N.RECONNECT_DELAY_MS,MAX_RECONNECT_ATTEMPTS:N.MAX_RECONNECT_ATTEMPTS,SSE_ENDPOINT:N.SSE_ENDPOINT};exports.STREAMING_BUFFER_CONFIG=T;exports.STREAMING_CLIENT_CONFIG=N;exports.STREAMING_DEFAULTS=A;exports.STREAMING_PACKAGE_CONFIG=_;exports.STREAMING_SERVER_CONFIG=E;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/streaming/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/streaming/constants.ts"],"names":["STREAMING_SERVER_CONFIG","STREAMING_CLIENT_CONFIG","STREAMING_BUFFER_CONFIG","STREAMING_PACKAGE_CONFIG","STREAMING_DEFAULTS"],"mappings":";AAgBO,IAAMA,CAAAA,CAA0B,CAKrC,qBAAA,CAAuB,GAAA,CAKvB,eAAA,CAAiB,GAAA,CAKjB,gBAAA,CAAkB,CAAC,SAAA,CAAW,QAAQ,CACxC,CAAA,CAOaC,CAAAA,CAA0B,CAIrC,kBAAA,CAAoB,GAAA,CAKpB,sBAAA,CAAwB,EAAA,CAKxB,YAAA,CAAc,oBAChB,CAAA,CAOaC,CAAAA,CAA0B,CAIrC,mBAAA,CAAqB,IAAA,CAKrB,iBAAA,CAAmB,GAAA,CAMnB,eAAA,CAAiB,EAAA,CAAK,IAAA,CAAO,IAC/B,CAAA,CAOaC,CAAAA,CAA2B,CACtC,MAAA,CAAQH,CAAAA,CACR,MAAA,CAAQC,CAAAA,CACR,MAAA,CAAQC,CACV,CAAA,CAQaE,CAAAA,CAAqB,CAChC,qBAAA,CAAuBJ,CAAAA,CAAwB,qBAAA,CAC/C,eAAA,CAAiBA,CAAAA,CAAwB,eAAA,CACzC,gBAAA,CAAkBA,CAAAA,CAAwB,gBAAA,CAC1C,kBAAA,CAAoBC,CAAAA,CAAwB,kBAAA,CAC5C,sBAAA,CAAwBA,CAAAA,CAAwB,sBAAA,CAChD,YAAA,CAAcA,CAAAA,CAAwB,YACxC","file":"index.cjs","sourcesContent":["/**\n * Streaming Configuration Constants\n *\n * Default configuration values for the SSE/WebSocket streaming system.\n * These can be overridden at runtime through configuration objects.\n *\n * @module src/streaming/constants\n */\n\nimport type { StreamChannel } from '@plyaz/types/core';\n\n/**\n * Server Configuration\n *\n * Default values for StreamServer and transport adapters\n */\nexport const STREAMING_SERVER_CONFIG = {\n  /**\n   * Default heartbeat interval in milliseconds\n   * Keeps connections alive and detects stale clients\n   */\n  HEARTBEAT_INTERVAL_MS: 30000,\n\n  /**\n   * Maximum number of concurrent connections per server\n   */\n  MAX_CONNECTIONS: 1000,\n\n  /**\n   * Default channels to subscribe new connections to\n   */\n  DEFAULT_CHANNELS: ['uploads', 'system'] as StreamChannel[],\n} as const;\n\n/**\n * Client Configuration\n *\n * Default values for client-side streaming hooks\n */\nexport const STREAMING_CLIENT_CONFIG = {\n  /**\n   * Delay before attempting to reconnect after disconnect\n   */\n  RECONNECT_DELAY_MS: 1000,\n\n  /**\n   * Maximum reconnection attempts before giving up\n   */\n  MAX_RECONNECT_ATTEMPTS: 10,\n\n  /**\n   * Default SSE endpoint path\n   */\n  SSE_ENDPOINT: '/api/events/stream',\n} as const;\n\n/**\n * Buffer Configuration\n *\n * Default values for message buffering\n */\nexport const STREAMING_BUFFER_CONFIG = {\n  /**\n   * Default buffer size for queued messages (1KB)\n   */\n  DEFAULT_BUFFER_SIZE: 1024,\n\n  /**\n   * Flush interval for buffered messages\n   */\n  FLUSH_INTERVAL_MS: 1000,\n\n  /**\n   * Maximum buffer size before forced flush (10MB)\n   */\n  // eslint-disable-next-line no-magic-numbers\n  MAX_BUFFER_SIZE: 10 * 1024 * 1024,\n} as const;\n\n/**\n * Streaming Package Configuration\n *\n * Aggregated configuration object for streaming system\n */\nexport const STREAMING_PACKAGE_CONFIG = {\n  SERVER: STREAMING_SERVER_CONFIG,\n  CLIENT: STREAMING_CLIENT_CONFIG,\n  BUFFER: STREAMING_BUFFER_CONFIG,\n} as const;\n\n/**\n * Streaming Defaults (Flat)\n *\n * Flattened defaults for direct import compatibility\n * with existing code using STREAMING_DEFAULTS\n */\nexport const STREAMING_DEFAULTS = {\n  HEARTBEAT_INTERVAL_MS: STREAMING_SERVER_CONFIG.HEARTBEAT_INTERVAL_MS,\n  MAX_CONNECTIONS: STREAMING_SERVER_CONFIG.MAX_CONNECTIONS,\n  DEFAULT_CHANNELS: STREAMING_SERVER_CONFIG.DEFAULT_CHANNELS,\n  RECONNECT_DELAY_MS: STREAMING_CLIENT_CONFIG.RECONNECT_DELAY_MS,\n  MAX_RECONNECT_ATTEMPTS: STREAMING_CLIENT_CONFIG.MAX_RECONNECT_ATTEMPTS,\n  SSE_ENDPOINT: STREAMING_CLIENT_CONFIG.SSE_ENDPOINT,\n} as const;\n\n/**\n * Type for streaming defaults\n */\nexport type StreamingDefaults = typeof STREAMING_DEFAULTS;\n"]}

package/dist/streaming/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Streaming Configuration Module
+ *
+ * Exports all streaming-related configuration constants.
+ *
+ * @module src/streaming
+ */
+export * from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/streaming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC"}

package/dist/streaming/index.mjs

@@ -0,0 +1,3 @@
+// @plyaz package - Built with tsup
+var E={HEARTBEAT_INTERVAL_MS:3e4,MAX_CONNECTIONS:1e3,DEFAULT_CHANNELS:["uploads","system"]},N={RECONNECT_DELAY_MS:1e3,MAX_RECONNECT_ATTEMPTS:10,SSE_ENDPOINT:"/api/events/stream"},T={DEFAULT_BUFFER_SIZE:1024,FLUSH_INTERVAL_MS:1e3,MAX_BUFFER_SIZE:10*1024*1024},_={SERVER:E,CLIENT:N,BUFFER:T},A={HEARTBEAT_INTERVAL_MS:E.HEARTBEAT_INTERVAL_MS,MAX_CONNECTIONS:E.MAX_CONNECTIONS,DEFAULT_CHANNELS:E.DEFAULT_CHANNELS,RECONNECT_DELAY_MS:N.RECONNECT_DELAY_MS,MAX_RECONNECT_ATTEMPTS:N.MAX_RECONNECT_ATTEMPTS,SSE_ENDPOINT:N.SSE_ENDPOINT};export{T as STREAMING_BUFFER_CONFIG,N as STREAMING_CLIENT_CONFIG,A as STREAMING_DEFAULTS,_ as STREAMING_PACKAGE_CONFIG,E as STREAMING_SERVER_CONFIG};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/streaming/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/streaming/constants.ts"],"names":["STREAMING_SERVER_CONFIG","STREAMING_CLIENT_CONFIG","STREAMING_BUFFER_CONFIG","STREAMING_PACKAGE_CONFIG","STREAMING_DEFAULTS"],"mappings":";AAgBO,IAAMA,CAAAA,CAA0B,CAKrC,qBAAA,CAAuB,GAAA,CAKvB,eAAA,CAAiB,GAAA,CAKjB,gBAAA,CAAkB,CAAC,SAAA,CAAW,QAAQ,CACxC,CAAA,CAOaC,CAAAA,CAA0B,CAIrC,kBAAA,CAAoB,GAAA,CAKpB,sBAAA,CAAwB,EAAA,CAKxB,YAAA,CAAc,oBAChB,CAAA,CAOaC,CAAAA,CAA0B,CAIrC,mBAAA,CAAqB,IAAA,CAKrB,iBAAA,CAAmB,GAAA,CAMnB,eAAA,CAAiB,EAAA,CAAK,IAAA,CAAO,IAC/B,CAAA,CAOaC,CAAAA,CAA2B,CACtC,MAAA,CAAQH,CAAAA,CACR,MAAA,CAAQC,CAAAA,CACR,MAAA,CAAQC,CACV,CAAA,CAQaE,CAAAA,CAAqB,CAChC,qBAAA,CAAuBJ,CAAAA,CAAwB,qBAAA,CAC/C,eAAA,CAAiBA,CAAAA,CAAwB,eAAA,CACzC,gBAAA,CAAkBA,CAAAA,CAAwB,gBAAA,CAC1C,kBAAA,CAAoBC,CAAAA,CAAwB,kBAAA,CAC5C,sBAAA,CAAwBA,CAAAA,CAAwB,sBAAA,CAChD,YAAA,CAAcA,CAAAA,CAAwB,YACxC","file":"index.mjs","sourcesContent":["/**\n * Streaming Configuration Constants\n *\n * Default configuration values for the SSE/WebSocket streaming system.\n * These can be overridden at runtime through configuration objects.\n *\n * @module src/streaming/constants\n */\n\nimport type { StreamChannel } from '@plyaz/types/core';\n\n/**\n * Server Configuration\n *\n * Default values for StreamServer and transport adapters\n */\nexport const STREAMING_SERVER_CONFIG = {\n  /**\n   * Default heartbeat interval in milliseconds\n   * Keeps connections alive and detects stale clients\n   */\n  HEARTBEAT_INTERVAL_MS: 30000,\n\n  /**\n   * Maximum number of concurrent connections per server\n   */\n  MAX_CONNECTIONS: 1000,\n\n  /**\n   * Default channels to subscribe new connections to\n   */\n  DEFAULT_CHANNELS: ['uploads', 'system'] as StreamChannel[],\n} as const;\n\n/**\n * Client Configuration\n *\n * Default values for client-side streaming hooks\n */\nexport const STREAMING_CLIENT_CONFIG = {\n  /**\n   * Delay before attempting to reconnect after disconnect\n   */\n  RECONNECT_DELAY_MS: 1000,\n\n  /**\n   * Maximum reconnection attempts before giving up\n   */\n  MAX_RECONNECT_ATTEMPTS: 10,\n\n  /**\n   * Default SSE endpoint path\n   */\n  SSE_ENDPOINT: '/api/events/stream',\n} as const;\n\n/**\n * Buffer Configuration\n *\n * Default values for message buffering\n */\nexport const STREAMING_BUFFER_CONFIG = {\n  /**\n   * Default buffer size for queued messages (1KB)\n   */\n  DEFAULT_BUFFER_SIZE: 1024,\n\n  /**\n   * Flush interval for buffered messages\n   */\n  FLUSH_INTERVAL_MS: 1000,\n\n  /**\n   * Maximum buffer size before forced flush (10MB)\n   */\n  // eslint-disable-next-line no-magic-numbers\n  MAX_BUFFER_SIZE: 10 * 1024 * 1024,\n} as const;\n\n/**\n * Streaming Package Configuration\n *\n * Aggregated configuration object for streaming system\n */\nexport const STREAMING_PACKAGE_CONFIG = {\n  SERVER: STREAMING_SERVER_CONFIG,\n  CLIENT: STREAMING_CLIENT_CONFIG,\n  BUFFER: STREAMING_BUFFER_CONFIG,\n} as const;\n\n/**\n * Streaming Defaults (Flat)\n *\n * Flattened defaults for direct import compatibility\n * with existing code using STREAMING_DEFAULTS\n */\nexport const STREAMING_DEFAULTS = {\n  HEARTBEAT_INTERVAL_MS: STREAMING_SERVER_CONFIG.HEARTBEAT_INTERVAL_MS,\n  MAX_CONNECTIONS: STREAMING_SERVER_CONFIG.MAX_CONNECTIONS,\n  DEFAULT_CHANNELS: STREAMING_SERVER_CONFIG.DEFAULT_CHANNELS,\n  RECONNECT_DELAY_MS: STREAMING_CLIENT_CONFIG.RECONNECT_DELAY_MS,\n  MAX_RECONNECT_ATTEMPTS: STREAMING_CLIENT_CONFIG.MAX_RECONNECT_ATTEMPTS,\n  SSE_ENDPOINT: STREAMING_CLIENT_CONFIG.SSE_ENDPOINT,\n} as const;\n\n/**\n * Type for streaming defaults\n */\nexport type StreamingDefaults = typeof STREAMING_DEFAULTS;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/config",
-  "version": "1.9.5",
+  "version": "1.10.0",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared configs and constants for @playz ecosystem.",
@@ -126,6 +126,12 @@
     "./translations": {
       "types": "./dist/translations/index.d.ts"
     },
+    "./streaming": {
+      "types": "./dist/streaming/index.d.ts",
+      "import": "./dist/streaming/index.mjs",
+      "require": "./dist/streaming/index.cjs",
+      "default": "./dist/streaming/index.mjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -139,7 +145,7 @@
   "packageManager": "pnpm@10.11.0",
   "dependencies": {
     "@plyaz/devtools": "^1.9.4",
-    "@plyaz/types": "^1.31.1",
+    "@plyaz/types": "^1.36.2",
     "globals": "^16.4.0",
     "viem": "^2.31.7"
   },