@plyaz/config 1.6.0 → 1.6.2

package/dist/logger/index.cjs

@@ -0,0 +1,3 @@
+'use strict';// @plyaz package - Built with tsup
+var e={trace:10,debug:20,info:30,warn:40,error:50,fatal:60},r=["email","password","wallet","token","secret","ssn"];exports.LOGGER_LEVELS=e;exports.SENSITIVE_DATA=r;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/logger/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logger/constants.ts"],"names":["LOGGER_LEVELS","SENSITIVE_DATA"],"mappings":";AACO,IAAMA,CAAAA,CAAgB,CAC3B,KAAA,CAAO,EAAA,CACP,MAAO,EAAA,CACP,IAAA,CAAM,EAAA,CACN,IAAA,CAAM,EAAA,CACN,KAAA,CAAO,GACP,KAAA,CAAO,EACT,EAGaC,CAAAA,CAAiB,CAAC,QAAS,UAAA,CAAY,QAAA,CAAU,OAAA,CAAS,QAAA,CAAU,KAAK","file":"index.cjs","sourcesContent":["// levels of the loggers\nexport const LOGGER_LEVELS = {\n  trace: 10,\n  debug: 20,\n  info: 30,\n  warn: 40,\n  error: 50,\n  fatal: 60,\n};\n\n// Sensitive fields excluded from logs\nexport const SENSITIVE_DATA = ['email', 'password', 'wallet', 'token', 'secret', 'ssn'];\n"]}

package/dist/logger/index.mjs

@@ -0,0 +1,3 @@
+// @plyaz package - Built with tsup
+var e={trace:10,debug:20,info:30,warn:40,error:50,fatal:60},r=["email","password","wallet","token","secret","ssn"];export{e as LOGGER_LEVELS,r as SENSITIVE_DATA};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/logger/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logger/constants.ts"],"names":["LOGGER_LEVELS","SENSITIVE_DATA"],"mappings":";AACO,IAAMA,CAAAA,CAAgB,CAC3B,KAAA,CAAO,EAAA,CACP,MAAO,EAAA,CACP,IAAA,CAAM,EAAA,CACN,IAAA,CAAM,EAAA,CACN,KAAA,CAAO,GACP,KAAA,CAAO,EACT,EAGaC,CAAAA,CAAiB,CAAC,QAAS,UAAA,CAAY,QAAA,CAAU,OAAA,CAAS,QAAA,CAAU,KAAK","file":"index.mjs","sourcesContent":["// levels of the loggers\nexport const LOGGER_LEVELS = {\n  trace: 10,\n  debug: 20,\n  info: 30,\n  warn: 40,\n  error: 50,\n  fatal: 60,\n};\n\n// Sensitive fields excluded from logs\nexport const SENSITIVE_DATA = ['email', 'password', 'wallet', 'token', 'secret', 'ssn'];\n"]}

package/dist/network/constants.d.ts

@@ -93,6 +93,192 @@ export declare const NETWORK_SCORES: {
      */
     readonly OFFLINE: 0;
 };
+/**
+ * Network timeout constants in milliseconds
+ * Used for request timeout configuration based on network quality
+ */
+export declare const NETWORK_TIMEOUTS: {
+    /**
+     * Fast network timeout - 15 seconds
+     */
+    readonly FAST: 15000;
+    /**
+     * Medium network timeout - 30 seconds
+     */
+    readonly MEDIUM: 30000;
+    /**
+     * Slow network timeout - 60 seconds
+     */
+    readonly SLOW: 60000;
+    /**
+     * Very slow network timeout - 90 seconds
+     */
+    readonly VERY_SLOW: 90000;
+    /**
+     * Offline timeout - 5 seconds (fail fast)
+     */
+    readonly OFFLINE: 5000;
+};
+/**
+ * Cache TTL (Time-To-Live) constants in seconds
+ * Used for cache expiration strategies
+ */
+export declare const CACHE_TTL: {
+    /**
+     * Short cache TTL - 5 minutes
+     */
+    readonly SHORT: 300;
+    /**
+     * Medium cache TTL - 10 minutes
+     */
+    readonly MEDIUM: 600;
+    /**
+     * Long cache TTL - 30 minutes
+     */
+    readonly LONG: 1800;
+};
+/**
+ * Cache stale time constants in seconds
+ * Used to determine when cached data is considered stale
+ */
+export declare const CACHE_STALE: {
+    /**
+     * Short stale time - 1 minute
+     */
+    readonly SHORT: 60;
+    /**
+     * Medium stale time - 5 minutes
+     */
+    readonly MEDIUM: 300;
+    /**
+     * Long stale time - 15 minutes
+     */
+    readonly LONG: 900;
+};
+/**
+ * Request deduplication time constants in milliseconds
+ * Used to prevent duplicate requests within time windows
+ */
+export declare const DEDUPE_TIME: {
+    /**
+     * Aggressive deduplication - 1 second
+     */
+    readonly AGGRESSIVE: 1000;
+    /**
+     * Balanced deduplication - 2 seconds
+     */
+    readonly BALANCED: 2000;
+    /**
+     * Conservative deduplication - 5 seconds
+     */
+    readonly CONSERVATIVE: 5000;
+};
+/**
+ * Retry attempt constants
+ * Number of retry attempts for failed requests
+ */
+export declare const RETRY_ATTEMPTS: {
+    /**
+     * Few retry attempts - 2
+     */
+    readonly FEW: 2;
+    /**
+     * Standard retry attempts - 3
+     */
+    readonly STANDARD: 3;
+    /**
+     * Many retry attempts - 5
+     */
+    readonly MANY: 5;
+};
+/**
+ * Retry delay constants in milliseconds
+ * Initial delays between retry attempts
+ */
+export declare const RETRY_DELAYS: {
+    /**
+     * Short retry delay - 1 second
+     */
+    readonly SHORT: 1000;
+    /**
+     * Long retry delay - 2 seconds
+     */
+    readonly LONG: 2000;
+    /**
+     * Maximum retry delay - 30 seconds
+     */
+    readonly MAX: 30000;
+};
+/**
+ * Retry backoff multiplier constants
+ * Exponential backoff multipliers for retry delays
+ */
+export declare const RETRY_BACKOFF: {
+    /**
+     * Small backoff multiplier - 1.5x
+     */
+    readonly SMALL: 1.5;
+    /**
+     * Medium backoff multiplier - 2x
+     */
+    readonly MEDIUM: 2;
+    /**
+     * Large backoff multiplier - 2.5x
+     */
+    readonly LARGE: 2.5;
+};
+/**
+ * Batch size constants
+ * Number of items to process in a single batch
+ */
+export declare const BATCH_SIZES: {
+    /**
+     * Huge batch size - 50 items
+     */
+    readonly HUGE: 50;
+    /**
+     * Large batch size - 25 items
+     */
+    readonly LARGE: 25;
+    /**
+     * Medium batch size - 10 items
+     */
+    readonly MEDIUM: 10;
+    /**
+     * Small batch size - 5 items
+     */
+    readonly SMALL: 5;
+    /**
+     * No batching - 0 items
+     */
+    readonly NONE: 0;
+};
+/**
+ * Page size constants
+ * Number of items per page for pagination
+ */
+export declare const PAGE_SIZES: {
+    /**
+     * Huge page size - 100 items
+     */
+    readonly HUGE: 100;
+    /**
+     * Large page size - 50 items
+     */
+    readonly LARGE: 50;
+    /**
+     * Medium page size - 25 items
+     */
+    readonly MEDIUM: 25;
+    /**
+     * Small page size - 10 items
+     */
+    readonly SMALL: 10;
+    /**
+     * No pagination - 0 items
+     */
+    readonly NONE: 0;
+};
 /**
  * Type for network constant values
  */
@@ -109,3 +295,39 @@ export type SpeedThreshold = (typeof SPEED_THRESHOLDS)[keyof typeof SPEED_THRESH
  * Type for network score values
  */
 export type NetworkScore = (typeof NETWORK_SCORES)[keyof typeof NETWORK_SCORES];
+/**
+ * Type for network timeout values
+ */
+export type NetworkTimeout = (typeof NETWORK_TIMEOUTS)[keyof typeof NETWORK_TIMEOUTS];
+/**
+ * Type for cache TTL values
+ */
+export type CacheTTL = (typeof CACHE_TTL)[keyof typeof CACHE_TTL];
+/**
+ * Type for cache stale values
+ */
+export type CacheStale = (typeof CACHE_STALE)[keyof typeof CACHE_STALE];
+/**
+ * Type for dedupe time values
+ */
+export type DedupeTime = (typeof DEDUPE_TIME)[keyof typeof DEDUPE_TIME];
+/**
+ * Type for retry attempt values
+ */
+export type RetryAttempt = (typeof RETRY_ATTEMPTS)[keyof typeof RETRY_ATTEMPTS];
+/**
+ * Type for retry delay values
+ */
+export type RetryDelay = (typeof RETRY_DELAYS)[keyof typeof RETRY_DELAYS];
+/**
+ * Type for retry backoff values
+ */
+export type RetryBackoff = (typeof RETRY_BACKOFF)[keyof typeof RETRY_BACKOFF];
+/**
+ * Type for batch size values
+ */
+export type BatchSize = (typeof BATCH_SIZES)[keyof typeof BATCH_SIZES];
+/**
+ * Type for page size values
+ */
+export type PageSize = (typeof PAGE_SIZES)[keyof typeof PAGE_SIZES];

package/dist/network/index.cjs

@@ -1,3 +1,3 @@
 'use strict';// @plyaz package - Built with tsup
-var T={IPV4_OCTET_MIN:1,IPV4_OCTET_MAX:255,IPV4_OCTET_COUNT:4,RANDOM_BYTE_MAX:256,DEFAULT_PROCESS_ID_MAX:1e4},E={EXCELLENT:50,GOOD:150,FAIR:400},o={EXCELLENT:10,GOOD:2,FAIR:.5},t={EXCELLENT:100,GOOD:75,FAIR:50,POOR:25,OFFLINE:0};exports.NETWORK_CONSTANTS=T;exports.NETWORK_SCORES=t;exports.RTT_THRESHOLDS=E;exports.SPEED_THRESHOLDS=o;//# sourceMappingURL=index.cjs.map
+var t={IPV4_OCTET_MIN:1,IPV4_OCTET_MAX:255,IPV4_OCTET_COUNT:4,RANDOM_BYTE_MAX:256,DEFAULT_PROCESS_ID_MAX:1e4},E={EXCELLENT:50,GOOD:150,FAIR:400},e={EXCELLENT:10,GOOD:2,FAIR:.5},o={EXCELLENT:100,GOOD:75,FAIR:50,POOR:25,OFFLINE:0},T={FAST:15e3,MEDIUM:3e4,SLOW:6e4,VERY_SLOW:9e4,OFFLINE:5e3},S={SHORT:300,MEDIUM:600,LONG:1800},p={SHORT:60,MEDIUM:300,LONG:900},R={AGGRESSIVE:1e3,BALANCED:2e3,CONSERVATIVE:5e3},y={FEW:2,STANDARD:3,MANY:5},O={SHORT:1e3,LONG:2e3,MAX:3e4},A={SMALL:1.5,MEDIUM:2,LARGE:2.5},_={HUGE:50,LARGE:25,MEDIUM:10,SMALL:5,NONE:0},f={HUGE:100,LARGE:50,MEDIUM:25,SMALL:10,NONE:0};exports.BATCH_SIZES=_;exports.CACHE_STALE=p;exports.CACHE_TTL=S;exports.DEDUPE_TIME=R;exports.NETWORK_CONSTANTS=t;exports.NETWORK_SCORES=o;exports.NETWORK_TIMEOUTS=T;exports.PAGE_SIZES=f;exports.RETRY_ATTEMPTS=y;exports.RETRY_BACKOFF=A;exports.RETRY_DELAYS=O;exports.RTT_THRESHOLDS=E;exports.SPEED_THRESHOLDS=e;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/network/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/network/constants.ts"],"names":["NETWORK_CONSTANTS","RTT_THRESHOLDS","SPEED_THRESHOLDS","NETWORK_SCORES"],"mappings":";AAYO,IAAMA,EAAoB,CAI/B,cAAA,CAAgB,EAKhB,cAAA,CAAgB,GAAA,CAKhB,iBAAkB,CAAA,CAKlB,eAAA,CAAiB,IAKjB,sBAAA,CAAwB,GAC1B,EAMaC,CAAAA,CAAiB,CAI5B,UAAW,EAAA,CAKX,IAAA,CAAM,IAKN,IAAA,CAAM,GACR,CAAA,CAMaC,CAAAA,CAAmB,CAI9B,SAAA,CAAW,EAAA,CAKX,KAAM,CAAA,CAKN,IAAA,CAAM,EACR,CAAA,CAMaC,CAAAA,CAAiB,CAI5B,SAAA,CAAW,GAAA,CAKX,KAAM,EAAA,CAKN,IAAA,CAAM,GAKN,IAAA,CAAM,EAAA,CAKN,QAAS,CACX","file":"index.cjs","sourcesContent":["/**\n * Network-related Constants\n *\n * Constants for network operations including IP addresses,\n * byte ranges, and process identifiers.\n *\n * @module network/constants\n */\n\n/**\n * Network and connection constants\n */\nexport const NETWORK_CONSTANTS = {\n  /**\n   * Minimum value for an IPv4 octet (excluding 0 for first octet)\n   */\n  IPV4_OCTET_MIN: 1,\n\n  /**\n   * Maximum value for an IPv4 octet\n   */\n  IPV4_OCTET_MAX: 255,\n\n  /**\n   * Number of octets in an IPv4 address\n   */\n  IPV4_OCTET_COUNT: 4,\n\n  /**\n   * Maximum value for a random byte (256 exclusive)\n   */\n  RANDOM_BYTE_MAX: 256,\n\n  /**\n   * Default maximum process ID for testing\n   */\n  DEFAULT_PROCESS_ID_MAX: 10000,\n} as const;\n\n/**\n * Round-trip time (RTT) thresholds in milliseconds\n * Used to classify network latency quality\n */\nexport const RTT_THRESHOLDS = {\n  /**\n   * Excellent network latency - under 50ms\n   */\n  EXCELLENT: 50,\n\n  /**\n   * Good network latency - under 150ms\n   */\n  GOOD: 150,\n\n  /**\n   * Fair network latency - under 400ms\n   */\n  FAIR: 400,\n} as const;\n\n/**\n * Network speed thresholds in Mbps\n * Used to classify connection speed quality\n */\nexport const SPEED_THRESHOLDS = {\n  /**\n   * Excellent connection speed - 10+ Mbps\n   */\n  EXCELLENT: 10,\n\n  /**\n   * Good connection speed - 2+ Mbps\n   */\n  GOOD: 2,\n\n  /**\n   * Fair connection speed - 0.5+ Mbps\n   */\n  FAIR: 0.5,\n} as const;\n\n/**\n * Network quality scores (0-100 scale)\n * Used to quantify overall network performance\n */\nexport const NETWORK_SCORES = {\n  /**\n   * Excellent network quality score\n   */\n  EXCELLENT: 100,\n\n  /**\n   * Good network quality score\n   */\n  GOOD: 75,\n\n  /**\n   * Fair network quality score\n   */\n  FAIR: 50,\n\n  /**\n   * Poor network quality score\n   */\n  POOR: 25,\n\n  /**\n   * Offline - no network connection\n   */\n  OFFLINE: 0,\n} as const;\n\n/**\n * Type for network constant values\n */\nexport type NetworkConstant = (typeof NETWORK_CONSTANTS)[keyof typeof NETWORK_CONSTANTS];\n\n/**\n * Type for RTT threshold values\n */\nexport type RTTThreshold = (typeof RTT_THRESHOLDS)[keyof typeof RTT_THRESHOLDS];\n\n/**\n * Type for speed threshold values\n */\nexport type SpeedThreshold = (typeof SPEED_THRESHOLDS)[keyof typeof SPEED_THRESHOLDS];\n\n/**\n * Type for network score values\n */\nexport type NetworkScore = (typeof NETWORK_SCORES)[keyof typeof NETWORK_SCORES];\n"]}
+{"version":3,"sources":["../../src/network/constants.ts"],"names":["NETWORK_CONSTANTS","RTT_THRESHOLDS","SPEED_THRESHOLDS","NETWORK_SCORES","NETWORK_TIMEOUTS","CACHE_TTL","CACHE_STALE","DEDUPE_TIME","RETRY_ATTEMPTS","RETRY_DELAYS","RETRY_BACKOFF","BATCH_SIZES","PAGE_SIZES"],"mappings":";AAYO,IAAMA,CAAAA,CAAoB,CAI/B,cAAA,CAAgB,CAAA,CAKhB,cAAA,CAAgB,GAAA,CAKhB,gBAAA,CAAkB,CAAA,CAKlB,eAAA,CAAiB,GAAA,CAKjB,sBAAA,CAAwB,GAC1B,EAMaC,CAAAA,CAAiB,CAI5B,SAAA,CAAW,EAAA,CAKX,IAAA,CAAM,GAAA,CAKN,IAAA,CAAM,GACR,CAAA,CAMaC,CAAAA,CAAmB,CAI9B,SAAA,CAAW,EAAA,CAKX,IAAA,CAAM,CAAA,CAKN,IAAA,CAAM,EACR,CAAA,CAMaC,CAAAA,CAAiB,CAI5B,SAAA,CAAW,GAAA,CAKX,IAAA,CAAM,EAAA,CAKN,IAAA,CAAM,EAAA,CAKN,IAAA,CAAM,EAAA,CAKN,OAAA,CAAS,CACX,CAAA,CAMaC,CAAAA,CAAmB,CAI9B,KAAM,IAAA,CAKN,MAAA,CAAQ,GAAA,CAKR,IAAA,CAAM,GAAA,CAKN,SAAA,CAAW,GAAA,CAKX,OAAA,CAAS,GACX,CAAA,CAMaC,CAAAA,CAAY,CAIvB,KAAA,CAAO,GAAA,CAKP,MAAA,CAAQ,GAAA,CAKR,IAAA,CAAM,IACR,CAAA,CAMaC,CAAAA,CAAc,CAIzB,KAAA,CAAO,EAAA,CAKP,MAAA,CAAQ,GAAA,CAKR,IAAA,CAAM,GACR,CAAA,CAMaC,CAAAA,CAAc,CAIzB,UAAA,CAAY,GAAA,CAKZ,QAAA,CAAU,GAAA,CAKV,aAAc,GAChB,CAAA,CAMaC,CAAAA,CAAiB,CAI5B,GAAA,CAAK,CAAA,CAKL,QAAA,CAAU,CAAA,CAKV,KAAM,CACR,CAAA,CAMaC,CAAAA,CAAe,CAI1B,KAAA,CAAO,GAAA,CAKP,IAAA,CAAM,GAAA,CAKN,IAAK,GACP,CAAA,CAMaC,CAAAA,CAAgB,CAI3B,KAAA,CAAO,GAAA,CAKP,MAAA,CAAQ,CAAA,CAKR,KAAA,CAAO,GACT,CAAA,CAMaC,CAAAA,CAAc,CAIzB,IAAA,CAAM,EAAA,CAKN,KAAA,CAAO,GAKP,MAAA,CAAQ,EAAA,CAKR,KAAA,CAAO,CAAA,CAKP,IAAA,CAAM,CACR,CAAA,CAMaC,CAAAA,CAAa,CAIxB,IAAA,CAAM,GAAA,CAKN,KAAA,CAAO,EAAA,CAKP,MAAA,CAAQ,EAAA,CAKR,KAAA,CAAO,EAAA,CAKP,KAAM,CACR","file":"index.cjs","sourcesContent":["/**\n * Network-related Constants\n *\n * Constants for network operations including IP addresses,\n * byte ranges, and process identifiers.\n *\n * @module network/constants\n */\n\n/**\n * Network and connection constants\n */\nexport const NETWORK_CONSTANTS = {\n  /**\n   * Minimum value for an IPv4 octet (excluding 0 for first octet)\n   */\n  IPV4_OCTET_MIN: 1,\n\n  /**\n   * Maximum value for an IPv4 octet\n   */\n  IPV4_OCTET_MAX: 255,\n\n  /**\n   * Number of octets in an IPv4 address\n   */\n  IPV4_OCTET_COUNT: 4,\n\n  /**\n   * Maximum value for a random byte (256 exclusive)\n   */\n  RANDOM_BYTE_MAX: 256,\n\n  /**\n   * Default maximum process ID for testing\n   */\n  DEFAULT_PROCESS_ID_MAX: 10000,\n} as const;\n\n/**\n * Round-trip time (RTT) thresholds in milliseconds\n * Used to classify network latency quality\n */\nexport const RTT_THRESHOLDS = {\n  /**\n   * Excellent network latency - under 50ms\n   */\n  EXCELLENT: 50,\n\n  /**\n   * Good network latency - under 150ms\n   */\n  GOOD: 150,\n\n  /**\n   * Fair network latency - under 400ms\n   */\n  FAIR: 400,\n} as const;\n\n/**\n * Network speed thresholds in Mbps\n * Used to classify connection speed quality\n */\nexport const SPEED_THRESHOLDS = {\n  /**\n   * Excellent connection speed - 10+ Mbps\n   */\n  EXCELLENT: 10,\n\n  /**\n   * Good connection speed - 2+ Mbps\n   */\n  GOOD: 2,\n\n  /**\n   * Fair connection speed - 0.5+ Mbps\n   */\n  FAIR: 0.5,\n} as const;\n\n/**\n * Network quality scores (0-100 scale)\n * Used to quantify overall network performance\n */\nexport const NETWORK_SCORES = {\n  /**\n   * Excellent network quality score\n   */\n  EXCELLENT: 100,\n\n  /**\n   * Good network quality score\n   */\n  GOOD: 75,\n\n  /**\n   * Fair network quality score\n   */\n  FAIR: 50,\n\n  /**\n   * Poor network quality score\n   */\n  POOR: 25,\n\n  /**\n   * Offline - no network connection\n   */\n  OFFLINE: 0,\n} as const;\n\n/**\n * Network timeout constants in milliseconds\n * Used for request timeout configuration based on network quality\n */\nexport const NETWORK_TIMEOUTS = {\n  /**\n   * Fast network timeout - 15 seconds\n   */\n  FAST: 15000,\n\n  /**\n   * Medium network timeout - 30 seconds\n   */\n  MEDIUM: 30000,\n\n  /**\n   * Slow network timeout - 60 seconds\n   */\n  SLOW: 60000,\n\n  /**\n   * Very slow network timeout - 90 seconds\n   */\n  VERY_SLOW: 90000,\n\n  /**\n   * Offline timeout - 5 seconds (fail fast)\n   */\n  OFFLINE: 5000,\n} as const;\n\n/**\n * Cache TTL (Time-To-Live) constants in seconds\n * Used for cache expiration strategies\n */\nexport const CACHE_TTL = {\n  /**\n   * Short cache TTL - 5 minutes\n   */\n  SHORT: 300,\n\n  /**\n   * Medium cache TTL - 10 minutes\n   */\n  MEDIUM: 600,\n\n  /**\n   * Long cache TTL - 30 minutes\n   */\n  LONG: 1800,\n} as const;\n\n/**\n * Cache stale time constants in seconds\n * Used to determine when cached data is considered stale\n */\nexport const CACHE_STALE = {\n  /**\n   * Short stale time - 1 minute\n   */\n  SHORT: 60,\n\n  /**\n   * Medium stale time - 5 minutes\n   */\n  MEDIUM: 300,\n\n  /**\n   * Long stale time - 15 minutes\n   */\n  LONG: 900,\n} as const;\n\n/**\n * Request deduplication time constants in milliseconds\n * Used to prevent duplicate requests within time windows\n */\nexport const DEDUPE_TIME = {\n  /**\n   * Aggressive deduplication - 1 second\n   */\n  AGGRESSIVE: 1000,\n\n  /**\n   * Balanced deduplication - 2 seconds\n   */\n  BALANCED: 2000,\n\n  /**\n   * Conservative deduplication - 5 seconds\n   */\n  CONSERVATIVE: 5000,\n} as const;\n\n/**\n * Retry attempt constants\n * Number of retry attempts for failed requests\n */\nexport const RETRY_ATTEMPTS = {\n  /**\n   * Few retry attempts - 2\n   */\n  FEW: 2,\n\n  /**\n   * Standard retry attempts - 3\n   */\n  STANDARD: 3,\n\n  /**\n   * Many retry attempts - 5\n   */\n  MANY: 5,\n} as const;\n\n/**\n * Retry delay constants in milliseconds\n * Initial delays between retry attempts\n */\nexport const RETRY_DELAYS = {\n  /**\n   * Short retry delay - 1 second\n   */\n  SHORT: 1000,\n\n  /**\n   * Long retry delay - 2 seconds\n   */\n  LONG: 2000,\n\n  /**\n   * Maximum retry delay - 30 seconds\n   */\n  MAX: 30000,\n} as const;\n\n/**\n * Retry backoff multiplier constants\n * Exponential backoff multipliers for retry delays\n */\nexport const RETRY_BACKOFF = {\n  /**\n   * Small backoff multiplier - 1.5x\n   */\n  SMALL: 1.5,\n\n  /**\n   * Medium backoff multiplier - 2x\n   */\n  MEDIUM: 2,\n\n  /**\n   * Large backoff multiplier - 2.5x\n   */\n  LARGE: 2.5,\n} as const;\n\n/**\n * Batch size constants\n * Number of items to process in a single batch\n */\nexport const BATCH_SIZES = {\n  /**\n   * Huge batch size - 50 items\n   */\n  HUGE: 50,\n\n  /**\n   * Large batch size - 25 items\n   */\n  LARGE: 25,\n\n  /**\n   * Medium batch size - 10 items\n   */\n  MEDIUM: 10,\n\n  /**\n   * Small batch size - 5 items\n   */\n  SMALL: 5,\n\n  /**\n   * No batching - 0 items\n   */\n  NONE: 0,\n} as const;\n\n/**\n * Page size constants\n * Number of items per page for pagination\n */\nexport const PAGE_SIZES = {\n  /**\n   * Huge page size - 100 items\n   */\n  HUGE: 100,\n\n  /**\n   * Large page size - 50 items\n   */\n  LARGE: 50,\n\n  /**\n   * Medium page size - 25 items\n   */\n  MEDIUM: 25,\n\n  /**\n   * Small page size - 10 items\n   */\n  SMALL: 10,\n\n  /**\n   * No pagination - 0 items\n   */\n  NONE: 0,\n} as const;\n\n/**\n * Type for network constant values\n */\nexport type NetworkConstant = (typeof NETWORK_CONSTANTS)[keyof typeof NETWORK_CONSTANTS];\n\n/**\n * Type for RTT threshold values\n */\nexport type RTTThreshold = (typeof RTT_THRESHOLDS)[keyof typeof RTT_THRESHOLDS];\n\n/**\n * Type for speed threshold values\n */\nexport type SpeedThreshold = (typeof SPEED_THRESHOLDS)[keyof typeof SPEED_THRESHOLDS];\n\n/**\n * Type for network score values\n */\nexport type NetworkScore = (typeof NETWORK_SCORES)[keyof typeof NETWORK_SCORES];\n\n/**\n * Type for network timeout values\n */\nexport type NetworkTimeout = (typeof NETWORK_TIMEOUTS)[keyof typeof NETWORK_TIMEOUTS];\n\n/**\n * Type for cache TTL values\n */\nexport type CacheTTL = (typeof CACHE_TTL)[keyof typeof CACHE_TTL];\n\n/**\n * Type for cache stale values\n */\nexport type CacheStale = (typeof CACHE_STALE)[keyof typeof CACHE_STALE];\n\n/**\n * Type for dedupe time values\n */\nexport type DedupeTime = (typeof DEDUPE_TIME)[keyof typeof DEDUPE_TIME];\n\n/**\n * Type for retry attempt values\n */\nexport type RetryAttempt = (typeof RETRY_ATTEMPTS)[keyof typeof RETRY_ATTEMPTS];\n\n/**\n * Type for retry delay values\n */\nexport type RetryDelay = (typeof RETRY_DELAYS)[keyof typeof RETRY_DELAYS];\n\n/**\n * Type for retry backoff values\n */\nexport type RetryBackoff = (typeof RETRY_BACKOFF)[keyof typeof RETRY_BACKOFF];\n\n/**\n * Type for batch size values\n */\nexport type BatchSize = (typeof BATCH_SIZES)[keyof typeof BATCH_SIZES];\n\n/**\n * Type for page size values\n */\nexport type PageSize = (typeof PAGE_SIZES)[keyof typeof PAGE_SIZES];\n"]}

package/dist/network/index.mjs

@@ -1,3 +1,3 @@
 // @plyaz package - Built with tsup
-var T={IPV4_OCTET_MIN:1,IPV4_OCTET_MAX:255,IPV4_OCTET_COUNT:4,RANDOM_BYTE_MAX:256,DEFAULT_PROCESS_ID_MAX:1e4},E={EXCELLENT:50,GOOD:150,FAIR:400},o={EXCELLENT:10,GOOD:2,FAIR:.5},t={EXCELLENT:100,GOOD:75,FAIR:50,POOR:25,OFFLINE:0};export{T as NETWORK_CONSTANTS,t as NETWORK_SCORES,E as RTT_THRESHOLDS,o as SPEED_THRESHOLDS};//# sourceMappingURL=index.mjs.map
+var t={IPV4_OCTET_MIN:1,IPV4_OCTET_MAX:255,IPV4_OCTET_COUNT:4,RANDOM_BYTE_MAX:256,DEFAULT_PROCESS_ID_MAX:1e4},E={EXCELLENT:50,GOOD:150,FAIR:400},e={EXCELLENT:10,GOOD:2,FAIR:.5},o={EXCELLENT:100,GOOD:75,FAIR:50,POOR:25,OFFLINE:0},T={FAST:15e3,MEDIUM:3e4,SLOW:6e4,VERY_SLOW:9e4,OFFLINE:5e3},S={SHORT:300,MEDIUM:600,LONG:1800},p={SHORT:60,MEDIUM:300,LONG:900},R={AGGRESSIVE:1e3,BALANCED:2e3,CONSERVATIVE:5e3},y={FEW:2,STANDARD:3,MANY:5},O={SHORT:1e3,LONG:2e3,MAX:3e4},A={SMALL:1.5,MEDIUM:2,LARGE:2.5},_={HUGE:50,LARGE:25,MEDIUM:10,SMALL:5,NONE:0},f={HUGE:100,LARGE:50,MEDIUM:25,SMALL:10,NONE:0};export{_ as BATCH_SIZES,p as CACHE_STALE,S as CACHE_TTL,R as DEDUPE_TIME,t as NETWORK_CONSTANTS,o as NETWORK_SCORES,T as NETWORK_TIMEOUTS,f as PAGE_SIZES,y as RETRY_ATTEMPTS,A as RETRY_BACKOFF,O as RETRY_DELAYS,E as RTT_THRESHOLDS,e as SPEED_THRESHOLDS};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/network/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/network/constants.ts"],"names":["NETWORK_CONSTANTS","RTT_THRESHOLDS","SPEED_THRESHOLDS","NETWORK_SCORES"],"mappings":";AAYO,IAAMA,EAAoB,CAI/B,cAAA,CAAgB,EAKhB,cAAA,CAAgB,GAAA,CAKhB,iBAAkB,CAAA,CAKlB,eAAA,CAAiB,IAKjB,sBAAA,CAAwB,GAC1B,EAMaC,CAAAA,CAAiB,CAI5B,UAAW,EAAA,CAKX,IAAA,CAAM,IAKN,IAAA,CAAM,GACR,CAAA,CAMaC,CAAAA,CAAmB,CAI9B,SAAA,CAAW,EAAA,CAKX,KAAM,CAAA,CAKN,IAAA,CAAM,EACR,CAAA,CAMaC,CAAAA,CAAiB,CAI5B,SAAA,CAAW,GAAA,CAKX,KAAM,EAAA,CAKN,IAAA,CAAM,GAKN,IAAA,CAAM,EAAA,CAKN,QAAS,CACX","file":"index.mjs","sourcesContent":["/**\n * Network-related Constants\n *\n * Constants for network operations including IP addresses,\n * byte ranges, and process identifiers.\n *\n * @module network/constants\n */\n\n/**\n * Network and connection constants\n */\nexport const NETWORK_CONSTANTS = {\n  /**\n   * Minimum value for an IPv4 octet (excluding 0 for first octet)\n   */\n  IPV4_OCTET_MIN: 1,\n\n  /**\n   * Maximum value for an IPv4 octet\n   */\n  IPV4_OCTET_MAX: 255,\n\n  /**\n   * Number of octets in an IPv4 address\n   */\n  IPV4_OCTET_COUNT: 4,\n\n  /**\n   * Maximum value for a random byte (256 exclusive)\n   */\n  RANDOM_BYTE_MAX: 256,\n\n  /**\n   * Default maximum process ID for testing\n   */\n  DEFAULT_PROCESS_ID_MAX: 10000,\n} as const;\n\n/**\n * Round-trip time (RTT) thresholds in milliseconds\n * Used to classify network latency quality\n */\nexport const RTT_THRESHOLDS = {\n  /**\n   * Excellent network latency - under 50ms\n   */\n  EXCELLENT: 50,\n\n  /**\n   * Good network latency - under 150ms\n   */\n  GOOD: 150,\n\n  /**\n   * Fair network latency - under 400ms\n   */\n  FAIR: 400,\n} as const;\n\n/**\n * Network speed thresholds in Mbps\n * Used to classify connection speed quality\n */\nexport const SPEED_THRESHOLDS = {\n  /**\n   * Excellent connection speed - 10+ Mbps\n   */\n  EXCELLENT: 10,\n\n  /**\n   * Good connection speed - 2+ Mbps\n   */\n  GOOD: 2,\n\n  /**\n   * Fair connection speed - 0.5+ Mbps\n   */\n  FAIR: 0.5,\n} as const;\n\n/**\n * Network quality scores (0-100 scale)\n * Used to quantify overall network performance\n */\nexport const NETWORK_SCORES = {\n  /**\n   * Excellent network quality score\n   */\n  EXCELLENT: 100,\n\n  /**\n   * Good network quality score\n   */\n  GOOD: 75,\n\n  /**\n   * Fair network quality score\n   */\n  FAIR: 50,\n\n  /**\n   * Poor network quality score\n   */\n  POOR: 25,\n\n  /**\n   * Offline - no network connection\n   */\n  OFFLINE: 0,\n} as const;\n\n/**\n * Type for network constant values\n */\nexport type NetworkConstant = (typeof NETWORK_CONSTANTS)[keyof typeof NETWORK_CONSTANTS];\n\n/**\n * Type for RTT threshold values\n */\nexport type RTTThreshold = (typeof RTT_THRESHOLDS)[keyof typeof RTT_THRESHOLDS];\n\n/**\n * Type for speed threshold values\n */\nexport type SpeedThreshold = (typeof SPEED_THRESHOLDS)[keyof typeof SPEED_THRESHOLDS];\n\n/**\n * Type for network score values\n */\nexport type NetworkScore = (typeof NETWORK_SCORES)[keyof typeof NETWORK_SCORES];\n"]}
+{"version":3,"sources":["../../src/network/constants.ts"],"names":["NETWORK_CONSTANTS","RTT_THRESHOLDS","SPEED_THRESHOLDS","NETWORK_SCORES","NETWORK_TIMEOUTS","CACHE_TTL","CACHE_STALE","DEDUPE_TIME","RETRY_ATTEMPTS","RETRY_DELAYS","RETRY_BACKOFF","BATCH_SIZES","PAGE_SIZES"],"mappings":";AAYO,IAAMA,CAAAA,CAAoB,CAI/B,cAAA,CAAgB,CAAA,CAKhB,cAAA,CAAgB,GAAA,CAKhB,gBAAA,CAAkB,CAAA,CAKlB,eAAA,CAAiB,GAAA,CAKjB,sBAAA,CAAwB,GAC1B,EAMaC,CAAAA,CAAiB,CAI5B,SAAA,CAAW,EAAA,CAKX,IAAA,CAAM,GAAA,CAKN,IAAA,CAAM,GACR,CAAA,CAMaC,CAAAA,CAAmB,CAI9B,SAAA,CAAW,EAAA,CAKX,IAAA,CAAM,CAAA,CAKN,IAAA,CAAM,EACR,CAAA,CAMaC,CAAAA,CAAiB,CAI5B,SAAA,CAAW,GAAA,CAKX,IAAA,CAAM,EAAA,CAKN,IAAA,CAAM,EAAA,CAKN,IAAA,CAAM,EAAA,CAKN,OAAA,CAAS,CACX,CAAA,CAMaC,CAAAA,CAAmB,CAI9B,KAAM,IAAA,CAKN,MAAA,CAAQ,GAAA,CAKR,IAAA,CAAM,GAAA,CAKN,SAAA,CAAW,GAAA,CAKX,OAAA,CAAS,GACX,CAAA,CAMaC,CAAAA,CAAY,CAIvB,KAAA,CAAO,GAAA,CAKP,MAAA,CAAQ,GAAA,CAKR,IAAA,CAAM,IACR,CAAA,CAMaC,CAAAA,CAAc,CAIzB,KAAA,CAAO,EAAA,CAKP,MAAA,CAAQ,GAAA,CAKR,IAAA,CAAM,GACR,CAAA,CAMaC,CAAAA,CAAc,CAIzB,UAAA,CAAY,GAAA,CAKZ,QAAA,CAAU,GAAA,CAKV,aAAc,GAChB,CAAA,CAMaC,CAAAA,CAAiB,CAI5B,GAAA,CAAK,CAAA,CAKL,QAAA,CAAU,CAAA,CAKV,KAAM,CACR,CAAA,CAMaC,CAAAA,CAAe,CAI1B,KAAA,CAAO,GAAA,CAKP,IAAA,CAAM,GAAA,CAKN,IAAK,GACP,CAAA,CAMaC,CAAAA,CAAgB,CAI3B,KAAA,CAAO,GAAA,CAKP,MAAA,CAAQ,CAAA,CAKR,KAAA,CAAO,GACT,CAAA,CAMaC,CAAAA,CAAc,CAIzB,IAAA,CAAM,EAAA,CAKN,KAAA,CAAO,GAKP,MAAA,CAAQ,EAAA,CAKR,KAAA,CAAO,CAAA,CAKP,IAAA,CAAM,CACR,CAAA,CAMaC,CAAAA,CAAa,CAIxB,IAAA,CAAM,GAAA,CAKN,KAAA,CAAO,EAAA,CAKP,MAAA,CAAQ,EAAA,CAKR,KAAA,CAAO,EAAA,CAKP,KAAM,CACR","file":"index.mjs","sourcesContent":["/**\n * Network-related Constants\n *\n * Constants for network operations including IP addresses,\n * byte ranges, and process identifiers.\n *\n * @module network/constants\n */\n\n/**\n * Network and connection constants\n */\nexport const NETWORK_CONSTANTS = {\n  /**\n   * Minimum value for an IPv4 octet (excluding 0 for first octet)\n   */\n  IPV4_OCTET_MIN: 1,\n\n  /**\n   * Maximum value for an IPv4 octet\n   */\n  IPV4_OCTET_MAX: 255,\n\n  /**\n   * Number of octets in an IPv4 address\n   */\n  IPV4_OCTET_COUNT: 4,\n\n  /**\n   * Maximum value for a random byte (256 exclusive)\n   */\n  RANDOM_BYTE_MAX: 256,\n\n  /**\n   * Default maximum process ID for testing\n   */\n  DEFAULT_PROCESS_ID_MAX: 10000,\n} as const;\n\n/**\n * Round-trip time (RTT) thresholds in milliseconds\n * Used to classify network latency quality\n */\nexport const RTT_THRESHOLDS = {\n  /**\n   * Excellent network latency - under 50ms\n   */\n  EXCELLENT: 50,\n\n  /**\n   * Good network latency - under 150ms\n   */\n  GOOD: 150,\n\n  /**\n   * Fair network latency - under 400ms\n   */\n  FAIR: 400,\n} as const;\n\n/**\n * Network speed thresholds in Mbps\n * Used to classify connection speed quality\n */\nexport const SPEED_THRESHOLDS = {\n  /**\n   * Excellent connection speed - 10+ Mbps\n   */\n  EXCELLENT: 10,\n\n  /**\n   * Good connection speed - 2+ Mbps\n   */\n  GOOD: 2,\n\n  /**\n   * Fair connection speed - 0.5+ Mbps\n   */\n  FAIR: 0.5,\n} as const;\n\n/**\n * Network quality scores (0-100 scale)\n * Used to quantify overall network performance\n */\nexport const NETWORK_SCORES = {\n  /**\n   * Excellent network quality score\n   */\n  EXCELLENT: 100,\n\n  /**\n   * Good network quality score\n   */\n  GOOD: 75,\n\n  /**\n   * Fair network quality score\n   */\n  FAIR: 50,\n\n  /**\n   * Poor network quality score\n   */\n  POOR: 25,\n\n  /**\n   * Offline - no network connection\n   */\n  OFFLINE: 0,\n} as const;\n\n/**\n * Network timeout constants in milliseconds\n * Used for request timeout configuration based on network quality\n */\nexport const NETWORK_TIMEOUTS = {\n  /**\n   * Fast network timeout - 15 seconds\n   */\n  FAST: 15000,\n\n  /**\n   * Medium network timeout - 30 seconds\n   */\n  MEDIUM: 30000,\n\n  /**\n   * Slow network timeout - 60 seconds\n   */\n  SLOW: 60000,\n\n  /**\n   * Very slow network timeout - 90 seconds\n   */\n  VERY_SLOW: 90000,\n\n  /**\n   * Offline timeout - 5 seconds (fail fast)\n   */\n  OFFLINE: 5000,\n} as const;\n\n/**\n * Cache TTL (Time-To-Live) constants in seconds\n * Used for cache expiration strategies\n */\nexport const CACHE_TTL = {\n  /**\n   * Short cache TTL - 5 minutes\n   */\n  SHORT: 300,\n\n  /**\n   * Medium cache TTL - 10 minutes\n   */\n  MEDIUM: 600,\n\n  /**\n   * Long cache TTL - 30 minutes\n   */\n  LONG: 1800,\n} as const;\n\n/**\n * Cache stale time constants in seconds\n * Used to determine when cached data is considered stale\n */\nexport const CACHE_STALE = {\n  /**\n   * Short stale time - 1 minute\n   */\n  SHORT: 60,\n\n  /**\n   * Medium stale time - 5 minutes\n   */\n  MEDIUM: 300,\n\n  /**\n   * Long stale time - 15 minutes\n   */\n  LONG: 900,\n} as const;\n\n/**\n * Request deduplication time constants in milliseconds\n * Used to prevent duplicate requests within time windows\n */\nexport const DEDUPE_TIME = {\n  /**\n   * Aggressive deduplication - 1 second\n   */\n  AGGRESSIVE: 1000,\n\n  /**\n   * Balanced deduplication - 2 seconds\n   */\n  BALANCED: 2000,\n\n  /**\n   * Conservative deduplication - 5 seconds\n   */\n  CONSERVATIVE: 5000,\n} as const;\n\n/**\n * Retry attempt constants\n * Number of retry attempts for failed requests\n */\nexport const RETRY_ATTEMPTS = {\n  /**\n   * Few retry attempts - 2\n   */\n  FEW: 2,\n\n  /**\n   * Standard retry attempts - 3\n   */\n  STANDARD: 3,\n\n  /**\n   * Many retry attempts - 5\n   */\n  MANY: 5,\n} as const;\n\n/**\n * Retry delay constants in milliseconds\n * Initial delays between retry attempts\n */\nexport const RETRY_DELAYS = {\n  /**\n   * Short retry delay - 1 second\n   */\n  SHORT: 1000,\n\n  /**\n   * Long retry delay - 2 seconds\n   */\n  LONG: 2000,\n\n  /**\n   * Maximum retry delay - 30 seconds\n   */\n  MAX: 30000,\n} as const;\n\n/**\n * Retry backoff multiplier constants\n * Exponential backoff multipliers for retry delays\n */\nexport const RETRY_BACKOFF = {\n  /**\n   * Small backoff multiplier - 1.5x\n   */\n  SMALL: 1.5,\n\n  /**\n   * Medium backoff multiplier - 2x\n   */\n  MEDIUM: 2,\n\n  /**\n   * Large backoff multiplier - 2.5x\n   */\n  LARGE: 2.5,\n} as const;\n\n/**\n * Batch size constants\n * Number of items to process in a single batch\n */\nexport const BATCH_SIZES = {\n  /**\n   * Huge batch size - 50 items\n   */\n  HUGE: 50,\n\n  /**\n   * Large batch size - 25 items\n   */\n  LARGE: 25,\n\n  /**\n   * Medium batch size - 10 items\n   */\n  MEDIUM: 10,\n\n  /**\n   * Small batch size - 5 items\n   */\n  SMALL: 5,\n\n  /**\n   * No batching - 0 items\n   */\n  NONE: 0,\n} as const;\n\n/**\n * Page size constants\n * Number of items per page for pagination\n */\nexport const PAGE_SIZES = {\n  /**\n   * Huge page size - 100 items\n   */\n  HUGE: 100,\n\n  /**\n   * Large page size - 50 items\n   */\n  LARGE: 50,\n\n  /**\n   * Medium page size - 25 items\n   */\n  MEDIUM: 25,\n\n  /**\n   * Small page size - 10 items\n   */\n  SMALL: 10,\n\n  /**\n   * No pagination - 0 items\n   */\n  NONE: 0,\n} as const;\n\n/**\n * Type for network constant values\n */\nexport type NetworkConstant = (typeof NETWORK_CONSTANTS)[keyof typeof NETWORK_CONSTANTS];\n\n/**\n * Type for RTT threshold values\n */\nexport type RTTThreshold = (typeof RTT_THRESHOLDS)[keyof typeof RTT_THRESHOLDS];\n\n/**\n * Type for speed threshold values\n */\nexport type SpeedThreshold = (typeof SPEED_THRESHOLDS)[keyof typeof SPEED_THRESHOLDS];\n\n/**\n * Type for network score values\n */\nexport type NetworkScore = (typeof NETWORK_SCORES)[keyof typeof NETWORK_SCORES];\n\n/**\n * Type for network timeout values\n */\nexport type NetworkTimeout = (typeof NETWORK_TIMEOUTS)[keyof typeof NETWORK_TIMEOUTS];\n\n/**\n * Type for cache TTL values\n */\nexport type CacheTTL = (typeof CACHE_TTL)[keyof typeof CACHE_TTL];\n\n/**\n * Type for cache stale values\n */\nexport type CacheStale = (typeof CACHE_STALE)[keyof typeof CACHE_STALE];\n\n/**\n * Type for dedupe time values\n */\nexport type DedupeTime = (typeof DEDUPE_TIME)[keyof typeof DEDUPE_TIME];\n\n/**\n * Type for retry attempt values\n */\nexport type RetryAttempt = (typeof RETRY_ATTEMPTS)[keyof typeof RETRY_ATTEMPTS];\n\n/**\n * Type for retry delay values\n */\nexport type RetryDelay = (typeof RETRY_DELAYS)[keyof typeof RETRY_DELAYS];\n\n/**\n * Type for retry backoff values\n */\nexport type RetryBackoff = (typeof RETRY_BACKOFF)[keyof typeof RETRY_BACKOFF];\n\n/**\n * Type for batch size values\n */\nexport type BatchSize = (typeof BATCH_SIZES)[keyof typeof BATCH_SIZES];\n\n/**\n * Type for page size values\n */\nexport type PageSize = (typeof PAGE_SIZES)[keyof typeof PAGE_SIZES];\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/config",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared configs and constants for @playz ecosystem.",
@@ -87,6 +87,18 @@
       "require": "./dist/api/index.cjs",
       "default": "./dist/api/index.mjs"
     },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.mjs",
+      "require": "./dist/errors/index.cjs",
+      "default": "./dist/errors/index.mjs"
+    },
+    "./logger": {
+      "types": "./dist/logger/index.d.ts",
+      "import": "./dist/logger/index.mjs",
+      "require": "./dist/logger/index.cjs",
+      "default": "./dist/logger/index.mjs"
+    },
     "./translations": {
       "types": "./dist/translations/index.d.ts"
     },