@hazeljs/discovery 0.2.0-alpha.1

package/dist/utils/logger.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Pluggable logger for @hazeljs/discovery
+ *
+ * Consumers can supply their own logger via DiscoveryLogger.setLogger().
+ * The default logger writes to the console.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscoveryLogger = void 0;
+const defaultLogger = {
+    // eslint-disable-next-line no-console
+    debug: (msg, ...args) => console.debug(`[discovery] ${msg}`, ...args),
+    // eslint-disable-next-line no-console
+    info: (msg, ...args) => console.info(`[discovery] ${msg}`, ...args),
+    // eslint-disable-next-line no-console
+    warn: (msg, ...args) => console.warn(`[discovery] ${msg}`, ...args),
+    // eslint-disable-next-line no-console
+    error: (msg, ...args) => console.error(`[discovery] ${msg}`, ...args),
+};
+let currentLogger = defaultLogger;
+exports.DiscoveryLogger = {
+    /** Replace the default console logger with a custom implementation */
+    setLogger(logger) {
+        currentLogger = logger;
+    },
+    /** Reset to the default console logger */
+    resetLogger() {
+        currentLogger = defaultLogger;
+    },
+    /** Get the current logger instance */
+    getLogger() {
+        return currentLogger;
+    },
+};

package/dist/utils/validation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Runtime validation utilities for discovery configuration objects
+ */
+import { ServiceRegistryConfig, DiscoveryClientConfig } from '../types';
+import { RedisBackendConfig } from '../backends/redis-backend';
+import { ConsulBackendConfig } from '../backends/consul-backend';
+import { KubernetesBackendConfig } from '../backends/kubernetes-backend';
+import { ServiceClientConfig } from '../client/service-client';
+export declare class ConfigValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate ServiceRegistryConfig at runtime
+ */
+export declare function validateServiceRegistryConfig(config: ServiceRegistryConfig): void;
+/**
+ * Validate DiscoveryClientConfig at runtime
+ */
+export declare function validateDiscoveryClientConfig(config: DiscoveryClientConfig): void;
+/**
+ * Validate ServiceClientConfig at runtime
+ */
+export declare function validateServiceClientConfig(config: ServiceClientConfig): void;
+/**
+ * Validate RedisBackendConfig at runtime
+ */
+export declare function validateRedisBackendConfig(config: RedisBackendConfig): void;
+/**
+ * Validate ConsulBackendConfig at runtime
+ */
+export declare function validateConsulBackendConfig(config: ConsulBackendConfig): void;
+/**
+ * Validate KubernetesBackendConfig at runtime
+ */
+export declare function validateKubernetesBackendConfig(config: KubernetesBackendConfig): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAgCjF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAejF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAkC7E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAe3E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAkB7E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CASrF"}

package/dist/utils/validation.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Runtime validation utilities for discovery configuration objects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigValidationError = void 0;
+exports.validateServiceRegistryConfig = validateServiceRegistryConfig;
+exports.validateDiscoveryClientConfig = validateDiscoveryClientConfig;
+exports.validateServiceClientConfig = validateServiceClientConfig;
+exports.validateRedisBackendConfig = validateRedisBackendConfig;
+exports.validateConsulBackendConfig = validateConsulBackendConfig;
+exports.validateKubernetesBackendConfig = validateKubernetesBackendConfig;
+class ConfigValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigValidationError';
+    }
+}
+exports.ConfigValidationError = ConfigValidationError;
+/**
+ * Validate ServiceRegistryConfig at runtime
+ */
+function validateServiceRegistryConfig(config) {
+    if (!config.name || typeof config.name !== 'string' || config.name.trim().length === 0) {
+        throw new ConfigValidationError('ServiceRegistryConfig: "name" is required and must be a non-empty string');
+    }
+    if (config.port == null ||
+        typeof config.port !== 'number' ||
+        config.port < 0 ||
+        config.port > 65535) {
+        throw new ConfigValidationError('ServiceRegistryConfig: "port" is required and must be a number between 0 and 65535');
+    }
+    if (config.healthCheckInterval != null &&
+        (typeof config.healthCheckInterval !== 'number' || config.healthCheckInterval <= 0)) {
+        throw new ConfigValidationError('ServiceRegistryConfig: "healthCheckInterval" must be a positive number (ms)');
+    }
+    if (config.protocol && !['http', 'https', 'grpc'].includes(config.protocol)) {
+        throw new ConfigValidationError('ServiceRegistryConfig: "protocol" must be one of "http", "https", "grpc"');
+    }
+}
+/**
+ * Validate DiscoveryClientConfig at runtime
+ */
+function validateDiscoveryClientConfig(config) {
+    if (config.cacheTTL != null && (typeof config.cacheTTL !== 'number' || config.cacheTTL <= 0)) {
+        throw new ConfigValidationError('DiscoveryClientConfig: "cacheTTL" must be a positive number (ms)');
+    }
+    if (config.refreshInterval != null &&
+        (typeof config.refreshInterval !== 'number' || config.refreshInterval <= 0)) {
+        throw new ConfigValidationError('DiscoveryClientConfig: "refreshInterval" must be a positive number (ms)');
+    }
+}
+/**
+ * Validate ServiceClientConfig at runtime
+ */
+function validateServiceClientConfig(config) {
+    if (!config.serviceName ||
+        typeof config.serviceName !== 'string' ||
+        config.serviceName.trim().length === 0) {
+        throw new ConfigValidationError('ServiceClientConfig: "serviceName" is required and must be a non-empty string');
+    }
+    if (config.timeout != null && (typeof config.timeout !== 'number' || config.timeout <= 0)) {
+        throw new ConfigValidationError('ServiceClientConfig: "timeout" must be a positive number (ms)');
+    }
+    if (config.retries != null &&
+        (typeof config.retries !== 'number' || config.retries < 0 || !Number.isInteger(config.retries))) {
+        throw new ConfigValidationError('ServiceClientConfig: "retries" must be a non-negative integer');
+    }
+    if (config.retryDelay != null &&
+        (typeof config.retryDelay !== 'number' || config.retryDelay < 0)) {
+        throw new ConfigValidationError('ServiceClientConfig: "retryDelay" must be a non-negative number (ms)');
+    }
+}
+/**
+ * Validate RedisBackendConfig at runtime
+ */
+function validateRedisBackendConfig(config) {
+    if (config.ttl != null && (typeof config.ttl !== 'number' || config.ttl <= 0)) {
+        throw new ConfigValidationError('RedisBackendConfig: "ttl" must be a positive number (seconds)');
+    }
+    if (config.port != null &&
+        (typeof config.port !== 'number' || config.port < 0 || config.port > 65535)) {
+        throw new ConfigValidationError('RedisBackendConfig: "port" must be a number between 0 and 65535');
+    }
+}
+/**
+ * Validate ConsulBackendConfig at runtime
+ */
+function validateConsulBackendConfig(config) {
+    if (config.ttl != null && typeof config.ttl === 'string') {
+        const match = config.ttl.match(/^(\d+)([smh])$/);
+        if (!match) {
+            throw new ConfigValidationError('ConsulBackendConfig: "ttl" must match format like "30s", "5m", or "1h"');
+        }
+    }
+    if (config.port != null &&
+        (typeof config.port !== 'number' || config.port < 0 || config.port > 65535)) {
+        throw new ConfigValidationError('ConsulBackendConfig: "port" must be a number between 0 and 65535');
+    }
+}
+/**
+ * Validate KubernetesBackendConfig at runtime
+ */
+function validateKubernetesBackendConfig(config) {
+    if (config.namespace != null &&
+        (typeof config.namespace !== 'string' || config.namespace.trim().length === 0)) {
+        throw new ConfigValidationError('KubernetesBackendConfig: "namespace" must be a non-empty string');
+    }
+}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@hazeljs/discovery",
+  "version": "0.2.0-alpha.1",
+  "description": "Service discovery and registry for HazelJS microservices - Eureka-inspired with multiple backend support",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest --coverage --passWithNoTests",
+    "test:ci": "jest --coverage --coverageReporters=text --coverageReporters=lcov --coverageReporters=clover --no-coverage-threshold",
+    "test:watch": "jest --watch",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@hazeljs/core": "^0.2.0-alpha.1",
+    "@hazeljs/resilience": "^0.2.0-alpha.1",
+    "axios": "^1.6.0",
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.17.50",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "@hazeljs/core": ">=0.2.0-beta.0",
+    "@kubernetes/client-node": "^0.20.0",
+    "consul": "^1.2.0",
+    "ioredis": "^5.3.0"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    },
+    "consul": {
+      "optional": true
+    },
+    "@kubernetes/client-node": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hazel-js/hazeljs.git",
+    "directory": "packages/discovery"
+  },
+  "keywords": [
+    "hazeljs",
+    "microservices",
+    "service-discovery",
+    "service-registry",
+    "load-balancing",
+    "eureka",
+    "consul",
+    "kubernetes"
+  ],
+  "author": "Muhammad Arslan <muhammad.arslan@hazeljs.com>",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/hazeljs/hazel-js/issues"
+  },
+  "homepage": "https://hazeljs.com",
+  "gitHead": "cbc5ee2c12ced28fd0576faf13c5f078c1e8421e"
+}