@sera4/essentia 3.0.12 → 3.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sera4/essentia",
-  "version": "3.0.12",
+  "version": "3.0.13",
   "description": "A library of utilities for Teleporte Web Services",
   "main": "dist/ts/index.js",
   "type": "module",
@@ -34,7 +34,8 @@
     "last-commit": "node last-commit.js",
     "build": "tsc",
     "build:watch": "tsc -w",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "publish:package": "scripts/publish.sh"
   },
   "author": "Dev DM <dev@sera4.com>",
   "repository": {
@@ -43,6 +44,7 @@
   },
   "license": "UNLICENSED",
   "devDependencies": {
+    "@types/amqplib": "^0.10.8",
     "@types/argparse": "^2.0.17",
     "@types/chai": "^4.3.11",
     "@types/express": "^4.17.21",
@@ -50,9 +52,12 @@
     "@types/mocha": "^10.0.10",
     "@types/morgan": "^1.9.9",
     "@types/node": "^20.17.32",
+    "@types/node-cron": "^3.0.11",
     "@types/prompt": "^1.1.9",
     "@types/sinon": "^10.0.20",
     "@types/sinon-chai": "^4.0.0",
+    "@types/url-parse": "^1.4.11",
+    "@types/uuid": "^10.0.0",
     "c8": "^8.0.1",
     "chai": "^5.2.0",
     "express": "^4.17.1",
@@ -67,7 +72,7 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "amqplib": "^0.10.7",
+    "amqplib": "^0.10.9",
     "argparse": "^2.0.1",
     "async": "^3.2.2",
     "axios": "^1.7.7",
@@ -77,6 +82,7 @@
     "git-rev": "^0.2.1",
     "lodash": "^4.17.21",
     "morgan": "^1.10.0",
+    "node-cron": "^4.2.1",
     "prompt": "^1.3.0",
     "recursive-iterator": "^3.3.0",
     "url-parse": "^1.5.10",

package/scripts/publish.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+
+# ── Version resolution ────────────────────────────────────────────────────────
+VERSION="${BUILD_VERSION:-}"
+
+if [ -z "$VERSION" ]; then
+  VERSION=$(node -p "require('./package.json').version")
+fi
+
+if [ -z "$VERSION" ] || [ "$VERSION" = "0.0.0" ]; then
+  echo "error: no version specified — set BUILD_VERSION or package.json version" >&2
+  exit 1
+fi
+
+PACKAGE=$(node -p "require('./package.json').name")
+echo "publishing $PACKAGE@$VERSION"
+
+# ── Stamp version, restore on exit ───────────────────────────────────────────
+ORIGINAL_VERSION=$(node -p "require('./package.json').version")
+restore_version() {
+  npm pkg set version="$ORIGINAL_VERSION" --silent
+}
+trap restore_version EXIT
+
+npm pkg set version="$VERSION" --silent
+
+# ── Build ─────────────────────────────────────────────────────────────────────
+echo "building..."
+npm run build
+
+# ── Dist-tag: prerelease versions get 'next', stable versions get 'latest' ───
+if [[ "$VERSION" =~ -[a-zA-Z] ]]; then
+  DIST_TAG="next"
+else
+  DIST_TAG="latest"
+fi
+
+# ── Publish ───────────────────────────────────────────────────────────────────
+echo "publishing with tag: $DIST_TAG"
+npm publish --access public --tag "$DIST_TAG"
+
+echo "done: $PACKAGE@$VERSION"

package/dist/ts/cache/index.d.ts

@@ -1,33 +0,0 @@
-interface CacheConfig {
-    password?: string;
-    database?: number;
-    host?: string;
-    port?: number;
-    fake?: boolean;
-    [key: string]: any;
-}
-declare class CacheConfigError extends Error {
-    constructor(message: string);
-}
-declare class Cache {
-    private redisClient;
-    private servicePrefix;
-    constructor(config: CacheConfig, servicePrefix: string);
-    ping(): Promise<string>;
-    properKey(key: string, path?: string): string;
-    writeHash(path: string, key: string, value: any): Promise<number>;
-    writeHashBlocking(path: string, key: string, value: any): void;
-    writeMultiHash(path: string, j: Record<string, any>): Promise<string>;
-    readHashKey(obj: string, key: string, autoConvert?: boolean): Promise<any>;
-    readHash(path: string): Promise<Record<string, any> | null>;
-    deleteHashKey(hash: string, key: string): Promise<void>;
-    get(key: string): Promise<string | null>;
-    getAsync(key: string): Promise<string | null>;
-    writeKey(key: string, value: any, expiry?: number): Promise<string>;
-    deleteKey(key: string): Promise<number>;
-    expire(path: string, expiry: number): Promise<number>;
-    exists(path: string): Promise<number>;
-    deleteAllKeys(): Promise<string>;
-}
-export default function (config: CacheConfig, servicePrefix: string): Cache;
-export { Cache, CacheConfigError };

package/dist/ts/cache/index.js

@@ -1,171 +0,0 @@
-import { promisify } from "util";
-import { S4Logger } from "../logger/s4-logger.js";
-const logger = new S4Logger();
-const isEmpty = (obj) => {
-    return [Object, Array].includes((obj || {}).constructor) && !Object.entries((obj || {})).length;
-};
-class CacheConfigError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "CacheConfigError";
-    }
-}
-/* Redis cache helper
- * Example use: Place the following code in your project to setup redis use
- *
- *    import { cache } from "@sera4/essentia";
- *    const cacheHelper = cache({ password: .., database: .., host: .., port: .. }, "service:"));
- *
- */
-const convertRedisKeyValueToJson = (v) => {
-    return (v && v.length > 0 && v[0] !== null) ? JSON.parse(v) : null;
-};
-const convertRedisHashToJson = (v) => {
-    if (v) {
-        const result = {};
-        for (const k in v) {
-            if (v.hasOwnProperty(k)) {
-                result[k] = JSON.parse(v[k]);
-            }
-        }
-        return result;
-    }
-    else {
-        return null;
-    }
-};
-function convertJsonToRedisValue(j) {
-    const result = {};
-    for (const key in j) {
-        if (j.hasOwnProperty(key)) {
-            result[key] = JSON.stringify(j[key]);
-        }
-    }
-    return result;
-}
-class Cache {
-    constructor(config, servicePrefix) {
-        if ((config == undefined) || isEmpty(config)) {
-            throw new CacheConfigError("Invalid cache configuration");
-        }
-        if (servicePrefix == null) {
-            throw new CacheConfigError("Invalid service prefix");
-        }
-        if (config.fake) {
-            // used in testing
-            this.redisClient = require("fakeredis").createClient("fake backend");
-        }
-        else {
-            this.redisClient = require("redis").createClient(config);
-        }
-        this.redisClient.on("error", (err) => {
-            logger.error("Cache/Redis error: ", err);
-        });
-        this.servicePrefix = servicePrefix;
-    }
-    ping() {
-        return this.redisClient.ping();
-    }
-    properKey(key, path) {
-        let p = this.servicePrefix + key;
-        if (path) {
-            p += path;
-        }
-        return p;
-    }
-    writeHash(path, key, value) {
-        return this.redisClient.hsetAsync(this.properKey(key), key, value);
-    }
-    writeHashBlocking(path, key, value) {
-        return this.redisClient.hset(this.properKey(key), key, value);
-    }
-    // write multiple hash keys and stringify every value
-    writeMultiHash(path, j) {
-        return this.redisClient.hmsetAsync(this.properKey(path), convertJsonToRedisValue(j));
-    }
-    readHashKey(obj, key, autoConvert = true) {
-        return new Promise((resolve, reject) => {
-            this.redisClient.hget(this.properKey(key, obj), key, (e, r) => {
-                if (e) {
-                    logger.error("Redis hmget error:", e);
-                    reject(e);
-                }
-                else {
-                    resolve(autoConvert ? convertRedisKeyValueToJson(r) : r);
-                }
-            });
-        });
-    }
-    readHash(path) {
-        return new Promise((resolve, reject) => {
-            this.redisClient.hgetall(this.properKey(path), (e, r) => {
-                if (e) {
-                    console.log("Redis hget error:", e);
-                    reject(e);
-                }
-                else {
-                    resolve(convertRedisHashToJson(r));
-                }
-            });
-        });
-    }
-    deleteHashKey(hash, key) {
-        return new Promise((resolve, reject) => {
-            this.redisClient.hdel(this.properKey(key, hash), key, (err) => {
-                if (err) {
-                    logger.error("Redis hdel error:", err);
-                    reject(err);
-                }
-                else {
-                    resolve();
-                }
-            });
-        });
-    }
-    get(key) {
-        return this.redisClient.getAsync(this.properKey(key));
-    }
-    getAsync(key) {
-        return promisify(this.redisClient.get.bind(this.redisClient))(this.properKey(key));
-    }
-    /* a single key write with optional expiry */
-    // returns bluebird promise
-    writeKey(key, value, expiry) {
-        const fullKey = this.servicePrefix + key;
-        if (expiry) {
-            return this.redisClient.setAsync(fullKey, value, "EX", expiry);
-        }
-        else {
-            return this.redisClient.setAsync(fullKey, value);
-        }
-    }
-    deleteKey(key) {
-        return this.redisClient.delAsync(this.properKey(key));
-    }
-    expire(path, expiry) {
-        return this.redisClient.expire(path, expiry);
-    }
-    exists(path) {
-        return this.redisClient.exists(path);
-    }
-    deleteAllKeys() {
-        return new Promise((resolve, reject) => {
-            if (process.env.NODE_ENV === "production") {
-                throw new Error("Clearing system cache is not permitted in production");
-            }
-            this.redisClient.flushdb((err, res) => {
-                if (err) {
-                    reject(err);
-                }
-                else {
-                    resolve(res);
-                }
-            });
-        });
-    }
-}
-export default function (config, servicePrefix) {
-    return new Cache(config, servicePrefix);
-}
-export { Cache, CacheConfigError };
-//# sourceMappingURL=index.js.map

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

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

package/dist/ts/configurations/server-config.d.ts

@@ -1,4 +0,0 @@
-export interface ServerConfig {
-    s4_identity_endpoint: string;
-    debug_dns?: boolean;
-}

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

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=server-config.js.map

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

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

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

@@ -1,7 +0,0 @@
-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

@@ -1,8 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;CACF,CAAC,CAAC"}

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

@@ -1,53 +0,0 @@
-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

@@ -1,169 +0,0 @@
-import fs from 'node:fs';
-import { S4Logger } from '../logger/index.js';
-const logger = new S4Logger();
-export class CycleDeploymentWatcher {
-    constructor() {
-        this.watcher = null;
-        this.currentTags = {};
-        this.listeners = new Set();
-        // 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;
-    }
-}
-CycleDeploymentWatcher.instance = null;
-// Export a default instance
-export default CycleDeploymentWatcher.getInstance();
-//# sourceMappingURL=index.js.map

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

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

package/dist/ts/dns/DnsCache.d.ts

@@ -1,50 +0,0 @@
-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;