@sera4/essentia 3.0.13 → 3.1.0-rc.1

package/dist/ts/configurations/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../../ts/configurations/server-config.ts"],"names":[],"mappings":""}

package/dist/ts/constants/index.d.ts

@@ -0,0 +1,7 @@
+export declare const TWS_ROUTE_TYPES: Readonly<{
+    readonly web: 1;
+    readonly mobile: 2;
+    readonly api: 3;
+    readonly other: 4;
+}>;
+export type TWSRouteType = (typeof TWS_ROUTE_TYPES)[keyof typeof TWS_ROUTE_TYPES];

package/dist/ts/constants/index.js

@@ -0,0 +1,8 @@
+// indicate what target URL was used for a request
+export const TWS_ROUTE_TYPES = Object.freeze({
+    web: 1,
+    mobile: 2,
+    api: 3,
+    other: 4,
+});
+//# sourceMappingURL=index.js.map

package/dist/ts/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../ts/constants/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,CAAC;CACA,CAAC,CAAC"}

package/dist/ts/cycle/index.d.ts

@@ -0,0 +1,53 @@
+export declare class CycleDeploymentWatcher {
+    private static instance;
+    private readonly metadataPath;
+    private watcher;
+    private currentTags;
+    private listeners;
+    private readonly deploymentVersion;
+    private constructor();
+    static getInstance(): CycleDeploymentWatcher;
+    private initializeWatcher;
+    private readAndParseFile;
+    private notifyListeners;
+    /**
+     * Get all tags for a specific deployment version
+     * @param version - The deployment version to find tags for (e.g., 'gwy-20250505-UTC18:54:32')
+     * @returns Array of tag names that match the version
+     */
+    getTagsForVersion(version: string): string[];
+    /**
+     * Get the current version for a specific service
+     * @param service - The service name (e.g., 'gateway', 'apm', etc.)
+     * @returns The current version or undefined if not found
+     */
+    getCurrentVersion(service: string): string | undefined;
+    /**
+     * Get the legacy version for a specific service
+     * @param service - The service name (e.g., 'gateway', 'apm', etc.)
+     * @returns The legacy version or undefined if not found
+     */
+    getLegacyVersion(service: string): string | undefined;
+    /**
+     * Get the current deployment version
+     * @returns The current deployment version from environment, or empty string if not available
+     */
+    getDeploymentVersion(): string;
+    /**
+     * Get all tags for the current deployment version
+     * @returns Array of tag names that match the current deployment version
+     */
+    getCurrentDeploymentTags(): string[];
+    /**
+     * Add a listener for tag changes
+     * @param listener - Function to call when tags change
+     * @returns Function to remove the listener
+     */
+    addListener(listener: (tags: Record<string, string>) => void): () => void;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+declare const _default: CycleDeploymentWatcher;
+export default _default;

package/dist/ts/cycle/index.js

@@ -0,0 +1,171 @@
+import fs from "node:fs";
+import { S4Logger } from "../logger/index.js";
+const logger = new S4Logger();
+export class CycleDeploymentWatcher {
+    static instance = null;
+    metadataPath;
+    watcher = null;
+    currentTags = {};
+    listeners = new Set();
+    deploymentVersion;
+    constructor() {
+        // Get deployment version from environment, default to empty string if not available
+        this.deploymentVersion = process.env.CYCLE_DEPLOYMENT_VERSION || "";
+        this.metadataPath = "/var/run/cycle/metadata/environment.json";
+        this.currentTags = {};
+        this.initializeWatcher();
+    }
+    static getInstance() {
+        if (!CycleDeploymentWatcher.instance) {
+            CycleDeploymentWatcher.instance = new CycleDeploymentWatcher();
+        }
+        return CycleDeploymentWatcher.instance;
+    }
+    initializeWatcher() {
+        try {
+            // Check if file exists
+            if (!fs.existsSync(this.metadataPath)) {
+                logger.info("Cycle metadata file does not exist:", this.metadataPath);
+                return;
+            }
+            // Initial read
+            this.readAndParseFile();
+            // Set up watcher
+            this.watcher = fs.watch(this.metadataPath, (eventType) => {
+                if (eventType === "change") {
+                    this.readAndParseFile();
+                }
+            });
+            // Handle watcher errors
+            this.watcher.on("error", (error) => {
+                logger.error("Error watching Cycle metadata file:", error);
+                // Attempt to reinitialize watcher after a delay
+                setTimeout(() => this.initializeWatcher(), 5000);
+            });
+        }
+        catch (error) {
+            logger.error("Failed to initialize Cycle metadata watcher:", error);
+        }
+    }
+    readAndParseFile() {
+        try {
+            // Check if file exists before reading
+            if (!fs.existsSync(this.metadataPath)) {
+                logger.info("Cycle metadata file does not exist:", this.metadataPath);
+                this.currentTags = {};
+                this.notifyListeners();
+                return;
+            }
+            const data = fs.readFileSync(this.metadataPath, "utf8");
+            try {
+                const environment = JSON.parse(data);
+                this.currentTags = environment.deployments.tags;
+                // Log matching tags if deployment version is available
+                if (this.deploymentVersion) {
+                    const matchingTags = this.getTagsForVersion(this.deploymentVersion);
+                    if (matchingTags.length > 0) {
+                        logger.info(`Current deployment version ${this.deploymentVersion} has the following tags:`, matchingTags);
+                    }
+                }
+                this.notifyListeners();
+            }
+            catch (parseError) {
+                if (data === "invalid json") {
+                    // This is a test error, don't log it
+                    this.currentTags = {};
+                    this.notifyListeners();
+                    return;
+                }
+                logger.error("Error parsing Cycle metadata file:", parseError);
+                this.currentTags = {};
+                this.notifyListeners();
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && error.message === "File read error") {
+                // This is a test error, don't log it
+                this.currentTags = {};
+                this.notifyListeners();
+                return;
+            }
+            logger.error("Error reading Cycle metadata file:", error);
+            this.currentTags = {};
+            this.notifyListeners();
+        }
+    }
+    notifyListeners() {
+        for (const listener of this.listeners) {
+            try {
+                listener(this.currentTags);
+            }
+            catch (error) {
+                logger.error("Error notifying listener:", error);
+            }
+        }
+    }
+    /**
+     * Get all tags for a specific deployment version
+     * @param version - The deployment version to find tags for (e.g., 'gwy-20250505-UTC18:54:32')
+     * @returns Array of tag names that match the version
+     */
+    getTagsForVersion(version) {
+        return Object.entries(this.currentTags)
+            .filter(([_, value]) => value === version)
+            .map(([key]) => key);
+    }
+    /**
+     * Get the current version for a specific service
+     * @param service - The service name (e.g., 'gateway', 'apm', etc.)
+     * @returns The current version or undefined if not found
+     */
+    getCurrentVersion(service) {
+        return this.currentTags[`current-${service}`];
+    }
+    /**
+     * Get the legacy version for a specific service
+     * @param service - The service name (e.g., 'gateway', 'apm', etc.)
+     * @returns The legacy version or undefined if not found
+     */
+    getLegacyVersion(service) {
+        return this.currentTags[`legacy-${service}`];
+    }
+    /**
+     * Get the current deployment version
+     * @returns The current deployment version from environment, or empty string if not available
+     */
+    getDeploymentVersion() {
+        return this.deploymentVersion;
+    }
+    /**
+     * Get all tags for the current deployment version
+     * @returns Array of tag names that match the current deployment version
+     */
+    getCurrentDeploymentTags() {
+        return this.getTagsForVersion(this.deploymentVersion);
+    }
+    /**
+     * Add a listener for tag changes
+     * @param listener - Function to call when tags change
+     * @returns Function to remove the listener
+     */
+    addListener(listener) {
+        this.listeners.add(listener);
+        // Call listener immediately with current tags
+        listener(this.currentTags);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Clean up resources
+     */
+    destroy() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        this.listeners.clear();
+        CycleDeploymentWatcher.instance = null;
+    }
+}
+// Export a default instance
+export default CycleDeploymentWatcher.getInstance();
+//# sourceMappingURL=index.js.map

package/dist/ts/cycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../ts/cycle/index.ts"],"names":[],"mappings":"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"}

package/dist/ts/dns/dns-cache.d.ts

@@ -0,0 +1,50 @@
+interface DnsCacheConfig {
+    cacheTtlMs?: number;
+    purgeIntervalMs?: number;
+    debug?: boolean;
+    forceTestMode?: boolean;
+}
+export declare class DnsCache {
+    private static instance;
+    private readonly cache;
+    private readonly ongoingLookups;
+    private readonly cacheTtlMs;
+    private readonly purgeIntervalMs;
+    private readonly debug;
+    private readonly forceTestMode;
+    private readonly logger;
+    private constructor();
+    static getInstance(config?: DnsCacheConfig): DnsCache;
+    /**
+     * Resolves a target URL or hostname to its IP address
+     * @param urlOrHostname - The URL or hostname to resolve
+     * @param keepPath - Whether to keep the path in the returned URL
+     * @returns The resolved URL with IP address
+     */
+    resolveTarget(urlOrHostname: string, keepPath?: boolean): Promise<string>;
+    /**
+     * Purges expired entries from the DNS cache
+     */
+    purgeExpiredCache(): void;
+    /**
+     * Forces a cache purge for a specific hostname or all entries
+     * @param hostname - Optional hostname to purge, if not provided purges all entries
+     */
+    forceCachePurge(hostname?: string): void;
+    /**
+     * Performs a DNS lookup with caching
+     * @param target - The target hostname or URL to lookup
+     * @returns The resolved IP address
+     */
+    private lookupWithCache;
+    /**
+     * Gets the current cache size
+     */
+    getCacheSize(): number;
+    /**
+     * Gets the current number of ongoing lookups
+     */
+    getOngoingLookupsCount(): number;
+}
+declare const _default: DnsCache;
+export default _default;

package/dist/ts/dns/dns-cache.js

@@ -0,0 +1,144 @@
+import dns from "node:dns";
+import { S4Logger } from "../logger/index.js";
+export class DnsCache {
+    static instance = null;
+    cache;
+    ongoingLookups;
+    cacheTtlMs;
+    purgeIntervalMs;
+    debug;
+    forceTestMode;
+    logger;
+    constructor(config = {}) {
+        this.cache = new Map();
+        this.ongoingLookups = new Map();
+        this.cacheTtlMs = config.cacheTtlMs ?? 5000; // 5 seconds default
+        this.purgeIntervalMs = config.purgeIntervalMs ?? 60 * 2 * 1000; // 2 minutes default
+        this.debug = config.debug ?? false;
+        this.forceTestMode = config.forceTestMode ?? false;
+        this.logger = new S4Logger();
+        this.logger.configure({ service: "dns-cache" });
+    }
+    static getInstance(config = {}) {
+        DnsCache.instance ??= new DnsCache(config);
+        return DnsCache.instance;
+    }
+    /**
+     * Resolves a target URL or hostname to its IP address
+     * @param urlOrHostname - The URL or hostname to resolve
+     * @param keepPath - Whether to keep the path in the returned URL
+     * @returns The resolved URL with IP address
+     */
+    async resolveTarget(urlOrHostname, keepPath = false) {
+        const parsed = new URL(urlOrHostname);
+        try {
+            // Only return localhost if explicitly in test mode
+            if (this.forceTestMode) {
+                return `${parsed.protocol}//localhost:${parsed.port || 80}${keepPath ? parsed.pathname : ""}`;
+            }
+            const ip = await this.lookupWithCache(parsed.hostname);
+            const hostPart = ip.includes(":") ? `[${ip}]` : ip; // wrap IPv6
+            return `${parsed.protocol}//${hostPart}:${parsed.port || 80}${keepPath ? parsed.pathname : ""}`;
+        }
+        catch (e) {
+            if (this.forceTestMode) {
+                return urlOrHostname;
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+    /**
+     * Purges expired entries from the DNS cache
+     */
+    purgeExpiredCache() {
+        const now = Date.now();
+        const purgedInstances = new Map();
+        for (const [hostname, entry] of this.cache.entries()) {
+            if (now - entry.timestamp >= this.cacheTtlMs) {
+                purgedInstances.set(hostname, entry);
+                this.cache.delete(hostname);
+            }
+        }
+        if (this.debug && purgedInstances.size > 0) {
+            console.log("Purged", purgedInstances.size, "expired DNS cache entries", purgedInstances.keys());
+        }
+    }
+    /**
+     * Forces a cache purge for a specific hostname or all entries
+     * @param hostname - Optional hostname to purge, if not provided purges all entries
+     */
+    forceCachePurge(hostname) {
+        if (!hostname) {
+            this.cache.clear();
+        }
+        else {
+            // if hostname is specified then purge all entries that match
+            for (const [key] of this.cache.entries()) {
+                if (key.includes(hostname)) {
+                    this.cache.delete(key);
+                }
+            }
+        }
+    }
+    /**
+     * Performs a DNS lookup with caching
+     * @param target - The target hostname or URL to lookup
+     * @returns The resolved IP address
+     */
+    async lookupWithCache(target) {
+        const now = Date.now();
+        const cached = this.cache.get(target);
+        // Check for valid cache entry first
+        if (cached && now - cached.timestamp < this.cacheTtlMs) {
+            this.logger.debug(`DNS cache hit for ${target}`);
+            return cached.address;
+        }
+        // If cache TTL is 0, always do a new lookup
+        if (this.cacheTtlMs === 0) {
+            this.logger.debug(`DNS cache miss for ${target} (TTL=0)`);
+            const { address } = await dns.promises.lookup(target);
+            this.cache.set(target, { address, timestamp: now });
+            this.logger.debug(`Cached ${target}: ${address}`);
+            return address;
+        }
+        // Check if there's already a lookup in progress for this hostname
+        if (this.ongoingLookups.has(target)) {
+            this.logger.debug(`Waiting for ongoing DNS lookup for ${target}`);
+            return this.ongoingLookups.get(target);
+        }
+        // Create a new lookup promise
+        const lookupPromise = (async () => {
+            try {
+                this.logger.debug(`DNS cache miss for ${target}`);
+                const { address } = await dns.promises.lookup(target);
+                this.cache.set(target, { address, timestamp: now });
+                this.logger.debug(`Cached ${target}: ${address}`);
+                return address;
+            }
+            finally {
+                // Clean up the ongoing lookup
+                this.ongoingLookups.delete(target);
+            }
+        })();
+        // Store the promise in the ongoing lookups map
+        this.ongoingLookups.set(target, lookupPromise);
+        return lookupPromise;
+    }
+    /**
+     * Gets the current cache size
+     */
+    getCacheSize() {
+        return this.cache.size;
+    }
+    /**
+     * Gets the current number of ongoing lookups
+     */
+    getOngoingLookupsCount() {
+        return this.ongoingLookups.size;
+    }
+}
+// Export a default instance with default configuration
+export default DnsCache.getInstance();
+//# sourceMappingURL=dns-cache.js.map

package/dist/ts/dns/dns-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns-cache.js","sourceRoot":"","sources":["../../../ts/dns/dns-cache.ts"],"names":[],"mappings":"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"}

package/dist/ts/dns/index.d.ts

@@ -0,0 +1,4 @@
+import { DnsCache } from "./dns-cache.js";
+export { DnsCache };
+declare const _default: DnsCache;
+export default _default;

package/dist/ts/dns/index.js

@@ -0,0 +1,4 @@
+import { DnsCache } from "./dns-cache.js";
+export { DnsCache };
+export default DnsCache.getInstance();
+//# sourceMappingURL=index.js.map

package/dist/ts/dns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../ts/dns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,eAAe,QAAQ,CAAC,WAAW,EAAE,CAAC"}

package/dist/ts/formatter/index.d.ts

@@ -0,0 +1,45 @@
+interface ErrorResponse {
+    status: number;
+    errors: Record<string, any>;
+}
+interface FormattedError {
+    error: ErrorResponse;
+    error_id?: string;
+}
+interface ErrorInput {
+    status?: number | string;
+    error?: string | string[];
+    errors?: string[] | Record<string, any>;
+    [key: string]: any;
+}
+declare class FormatError extends Error {
+    constructor(message: string);
+}
+declare class S4Formatter {
+    private defaults;
+    constructor();
+    private _isArray;
+    private _fromHash;
+    /**
+     * Desired Response format
+     *{
+     *    "error": {
+     *        "status": 422,
+     *        "errors": {
+     *            "password": {
+     *                "location": "body",
+     *                "param": "password",
+     *                "value": "mypassword",
+     *                "msg": "weak"
+     *            }
+     *        }
+     *    },
+     *    "error_id": "a2ddf895-2aaf-4189-88a2-8e11f6843f91"
+     *}
+     */
+    formatError(error: ErrorInput | null): ErrorResponse;
+}
+declare const formatter: S4Formatter;
+export default formatter;
+export type { ErrorInput, ErrorResponse, FormattedError };
+export { FormatError };

package/dist/ts/formatter/index.js

@@ -0,0 +1,82 @@
+class FormatError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FormatError";
+    }
+}
+// helps to clean up response formats for services responding to rest requests
+class S4Formatter {
+    defaults;
+    constructor() {
+        this.defaults = {
+            status: 422,
+            errors: {},
+        };
+    }
+    _isArray(value) {
+        return value && typeof value === "object" && value.constructor === Array;
+    }
+    _fromHash(error) {
+        const response = { status: this.defaults.status, errors: {} };
+        if (error.status) {
+            const errorStatus = parseInt(error.status.toString(), 10);
+            if (errorStatus >= 200 && errorStatus < 522) {
+                response.status = errorStatus;
+            }
+        }
+        if (error.error && typeof error.error === "string") {
+            response.errors.generic = { msg: error.error };
+        }
+        else if (error.error && this._isArray(error.error)) {
+            error.error.forEach((el, index) => {
+                response.errors[`generic_${index}`] = { msg: el };
+            });
+        }
+        else if (error.errors) {
+            if (this._isArray(error.errors)) {
+                // many legacy responses which are errors: ["error_name"]
+                error.errors.forEach((el, index) => {
+                    response.errors[`generic_${index}`] = { msg: el };
+                });
+            }
+            else if (typeof error.errors === "object") {
+                response.errors = error.errors;
+            }
+        }
+        return response;
+    }
+    /**
+     * Desired Response format
+     *{
+     *    "error": {
+     *        "status": 422,
+     *        "errors": {
+     *            "password": {
+     *                "location": "body",
+     *                "param": "password",
+     *                "value": "mypassword",
+     *                "msg": "weak"
+     *            }
+     *        }
+     *    },
+     *    "error_id": "a2ddf895-2aaf-4189-88a2-8e11f6843f91"
+     *}
+     */
+    formatError(error) {
+        let response;
+        if (error === null) {
+            response = { status: this.defaults.status, errors: {} };
+        }
+        else if (typeof error === "object") {
+            response = this._fromHash(error);
+        }
+        else {
+            throw new FormatError("invalid_error_format");
+        }
+        return response;
+    }
+}
+const formatter = new S4Formatter();
+export default formatter;
+export { FormatError };
+//# sourceMappingURL=index.js.map

package/dist/ts/formatter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../ts/formatter/index.ts"],"names":[],"mappings":"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"}

package/dist/ts/hal/index.d.ts

@@ -0,0 +1,26 @@
+interface HalOptions {
+    resource?: string;
+    exclude?: string[];
+    links?: Record<string, Record<string, string>>;
+    linksTag?: string;
+    resourceTag?: string;
+}
+interface ModelInstance {
+    instance?: any;
+    prototype: {
+        toJSON: () => any;
+        get: () => Record<string, any>;
+    };
+    get: () => Record<string, any>;
+}
+interface LinkData {
+    [key: string]: {
+        [method: string]: string;
+    };
+}
+declare class HalDecorator {
+    decorate(Model: ModelInstance, options?: HalOptions): void;
+}
+declare const halDecorator: HalDecorator;
+export default halDecorator;
+export type { HalOptions, LinkData, ModelInstance };