@similie/hyphen-command-server-types 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### 1.0.1 (2025-12-27)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Similie
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# hyphen-command-center-sdk

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./models";
+export * from "./tools";
+export * from "./services";
+export * from "./modules";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./models";
+export * from "./tools";
+export * from "./services";
+export * from "./modules";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/models/base-model.d.ts

@@ -0,0 +1,13 @@
+import { type UUID as _UUID } from "@similie/ellipsies";
+export type UUID = _UUID;
+export interface BaseModel {
+    id: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface BaseUIDModel {
+    uid: UUID;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=base-model.d.ts.map

package/dist/models/base-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-model.d.ts","sourceRoot":"","sources":["../../src/models/base-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACxD,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC;AACzB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,IAAI,CAAC;IACV,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/models/base-model.js

@@ -0,0 +1,2 @@
+import {} from "@similie/ellipsies";
+//# sourceMappingURL=base-model.js.map

package/dist/models/base-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-model.js","sourceRoot":"","sources":["../../src/models/base-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,oBAAoB,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./base-model";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/models/index.js

@@ -0,0 +1,2 @@
+export * from "./base-model";
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/modules/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./loader";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/modules/index.js

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./loader";
+//# sourceMappingURL=index.js.map

package/dist/modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/modules/loader.d.ts

@@ -0,0 +1,4 @@
+import type { ModuleContext, LoadedModule } from "./types";
+export declare function loadModulesFromEnv(ctx: ModuleContext): Promise<LoadedModule[]>;
+export declare function shutdownModules(ctx: ModuleContext, loaded: LoadedModule[]): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/modules/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/modules/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzE,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CA6CzB;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,YAAY,EAAE,iBAYvB"}

package/dist/modules/loader.js

@@ -0,0 +1,53 @@
+export async function loadModulesFromEnv(ctx) {
+    const raw = process.env.HYPHEN_MODULES?.trim();
+    if (!raw)
+        return [];
+    const specList = raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const loaded = [];
+    for (const spec of specList) {
+        // spec can be:
+        // - "hyphen-rtsp-module"
+        // - "@similie/hyphen-rtsp-module"
+        // - "file:./dist/my-module.js" (dev)
+        try {
+            const imported = await import(spec);
+            const candidate = imported.default ?? imported.module ?? imported;
+            if (!candidate ||
+                typeof candidate.init !== "function" ||
+                !candidate.name) {
+                ctx.log(`[modules] invalid module export: ${spec}`, { spec });
+                continue;
+            }
+            ctx.log(`[modules] init ${candidate.name}`, {
+                spec,
+                version: candidate.version,
+            });
+            const res = await candidate.init(ctx);
+            loaded.push({ mod: candidate, res });
+            ctx.log(`[modules] ready ${candidate.name}`, { spec });
+        }
+        catch (e) {
+            ctx.log(`[modules] failed to load: ${spec}`, {
+                error: e?.message ?? String(e),
+            });
+        }
+    }
+    return loaded;
+}
+export async function shutdownModules(ctx, loaded) {
+    for (const { mod, res } of loaded) {
+        try {
+            res && (await res?.shutdown?.());
+            ctx.log(`[modules] shutdown ${mod.name}`);
+        }
+        catch (e) {
+            ctx.log(`[modules] shutdown failed ${mod.name}`, {
+                error: e?.message ?? String(e),
+            });
+        }
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/modules/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/modules/loader.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAkB;IAElB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,MAAM,QAAQ,GAAG,GAAG;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,eAAe;QACf,yBAAyB;QACzB,kCAAkC;QAClC,qCAAqC;QACrC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,SAAS,GACb,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC;YAElD,IACE,CAAC,SAAS;gBACV,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU;gBACpC,CAAC,SAAS,CAAC,IAAI,EACf,CAAC;gBACD,GAAG,CAAC,GAAG,CAAC,oCAAoC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9D,SAAS;YACX,CAAC;YAED,GAAG,CAAC,GAAG,CAAC,kBAAkB,SAAS,CAAC,IAAI,EAAE,EAAE;gBAC1C,IAAI;gBACJ,OAAO,EAAE,SAAS,CAAC,OAAO;aAC3B,CAAC,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YACrC,GAAG,CAAC,GAAG,CAAC,mBAAmB,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,GAAG,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,EAAE;gBAC3C,KAAK,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAkB,EAClB,MAAsB;IAEtB,KAAK,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,sBAAsB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,GAAG,CAAC,GAAG,CAAC,6BAA6B,GAAG,CAAC,IAAI,EAAE,EAAE;gBAC/C,KAAK,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/modules/types.d.ts

@@ -0,0 +1,29 @@
+import type { RedisCache, LeaderElector } from "../services";
+import type { Ellipsies } from "@similie/ellipsies";
+export type EllipsiesInstance = Ellipsies;
+export type CommandCenterSystemIdentity = {
+    name: string;
+    identity: string;
+    host: string;
+    port: number;
+};
+export type ModuleContext = {
+    ellipsies: EllipsiesInstance;
+    redis: typeof RedisCache;
+    leader: LeaderElector;
+    identity?: CommandCenterSystemIdentity;
+    log: (msg: string, extra?: Record<string, any>) => void;
+};
+export type ModuleInitResult = {
+    shutdown?: () => Promise<void> | void;
+};
+export interface HyphenModule {
+    name: string;
+    version?: string;
+    init(ctx: ModuleContext): Promise<ModuleInitResult | void> | (ModuleInitResult | void);
+}
+export type LoadedModule = {
+    mod: HyphenModule;
+    res?: ModuleInitResult | void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/modules/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE1C,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,OAAO,UAAU,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAE7B,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,IAAI,CACF,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,YAAY,CAAC;IAClB,GAAG,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC/B,CAAC"}

package/dist/modules/types.js

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

package/dist/modules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/modules/types.ts"],"names":[],"mappings":""}

package/dist/services/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./leader-lock";
+export * from "./redis";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,3 @@
+export * from "./leader-lock";
+export * from "./redis";
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC"}

package/dist/services/leader-lock.d.ts

@@ -0,0 +1,31 @@
+import { EventEmitter } from "events";
+export type LeaderEvents = {
+    elected: () => void;
+    revoked: () => void;
+    error: (err: Error) => void;
+};
+export declare class LeaderElector extends EventEmitter {
+    private static instance;
+    private redlock;
+    private redis;
+    private renewTimer?;
+    private acquireTimer?;
+    private lock?;
+    private readonly lockKey;
+    private readonly ttlMs;
+    private readonly renewEveryMs;
+    private readonly retryDelayMs;
+    private readonly instanceId;
+    private constructor();
+    static get(): LeaderElector;
+    init(redisUrl: string): void;
+    /** Pure check: true only if we *currently* hold a live lock. */
+    amLeader(): boolean;
+    /** Stop loops and release if we are leader. */
+    shutdown(): Promise<void>;
+    private startAcquireLoop;
+    private startRenewLoop;
+    private safeRevoke;
+    private safeRelease;
+}
+//# sourceMappingURL=leader-lock.d.ts.map

package/dist/services/leader-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leader-lock.d.ts","sourceRoot":"","sources":["../../src/services/leader-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B,CAAC;AAEF,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,IAAI,CAAC,CAAmB;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAE3C,OAAO;IAIP,MAAM,CAAC,GAAG,IAAI,aAAa;IAK3B,IAAI,CAAC,QAAQ,EAAE,MAAM;IAYrB,gEAAgE;IAChE,QAAQ,IAAI,OAAO;IAInB,+CAA+C;IACzC,QAAQ;IASd,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,cAAc;YAcR,UAAU;YAMV,WAAW;CAU1B"}

package/dist/services/leader-lock.js

@@ -0,0 +1,103 @@
+import { EventEmitter } from "events";
+import { Redis } from "ioredis";
+import Redlock, { Lock } from "redlock";
+import { randomUUID } from "crypto";
+export class LeaderElector extends EventEmitter {
+    static instance;
+    redlock;
+    redis;
+    renewTimer;
+    acquireTimer;
+    lock;
+    lockKey = "mqtt:leader:lock";
+    ttlMs = 10000; // lock TTL
+    renewEveryMs = 5000; // extend interval (< TTL)
+    retryDelayMs = 1500; // backoff when not leader
+    instanceId = randomUUID(); // for logging/diagnostics
+    constructor() {
+        super();
+    }
+    static get() {
+        if (!this.instance)
+            this.instance = new LeaderElector();
+        return this.instance;
+    }
+    init(redisUrl) {
+        this.redis = new Redis(redisUrl);
+        this.redlock = new Redlock([this.redis], {
+            // Redlock will keep retrying for us when we explicitly request it,
+            // but we’ll manage our own retry loop here.
+            driftFactor: 0.01,
+            retryCount: 0,
+            retryDelay: 0,
+        });
+        this.startAcquireLoop();
+    }
+    /** Pure check: true only if we *currently* hold a live lock. */
+    amLeader() {
+        return !!this.lock;
+    }
+    /** Stop loops and release if we are leader. */
+    async shutdown() {
+        clearTimeout(this.acquireTimer);
+        clearInterval(this.renewTimer);
+        await this.safeRelease();
+        await this.redis?.quit();
+    }
+    // -------- internal --------
+    startAcquireLoop() {
+        const tryAcquire = async () => {
+            if (this.lock)
+                return; // already leader
+            try {
+                // Acquire without retries; we run our own loop.
+                const lock = await this.redlock.acquire([this.lockKey], this.ttlMs);
+                this.lock = lock;
+                this.emit("elected");
+                this.startRenewLoop();
+            }
+            catch {
+                // Not acquired (someone else is leader). Back off a bit (with jitter).
+            }
+            finally {
+                const jitter = Math.floor(Math.random() * 500);
+                this.acquireTimer = setTimeout(tryAcquire, this.retryDelayMs + jitter);
+            }
+        };
+        tryAcquire().catch((err) => this.emit("error", err));
+    }
+    startRenewLoop() {
+        clearInterval(this.renewTimer);
+        this.renewTimer = setInterval(async () => {
+            if (!this.lock)
+                return;
+            try {
+                this.lock = await this.lock.extend(this.ttlMs);
+            }
+            catch (err) {
+                // Couldn’t extend: we lost leadership (expired or Redis issue)
+                await this.safeRevoke();
+                // acquisition loop is already running, it’ll try to reacquire
+            }
+        }, this.renewEveryMs);
+    }
+    async safeRevoke() {
+        clearInterval(this.renewTimer);
+        this.lock = undefined;
+        this.emit("revoked");
+    }
+    async safeRelease() {
+        if (!this.lock)
+            return;
+        try {
+            await this.lock.release();
+        }
+        catch {
+            // If already expired or released, ignore.
+        }
+        finally {
+            await this.safeRevoke();
+        }
+    }
+}
+//# sourceMappingURL=leader-lock.js.map

package/dist/services/leader-lock.js.map

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

package/dist/services/redis.d.ts

@@ -0,0 +1,27 @@
+export declare class RedisCache {
+    private static client;
+    private static DEFAULT_EXPIRATION_SECONDS;
+    /**
+     * Initializes the Redis client. Call this once on server startup.
+     */
+    static init(): Promise<void>;
+    /**
+     * Caches an object under a specified key.
+     * @param key The cache key.
+     * @param value The object to cache.
+     * @param expirationSeconds Optional expiration time in seconds (defaults to 15 minutes).
+     */
+    static set(key: string, value: any, expirationSeconds?: number): Promise<void>;
+    /**
+     * Retrieves a cached object by its key.
+     * @param key The cache key.
+     * @returns The cached object, or null if not found.
+     */
+    static get<T>(key: string): Promise<T | null>;
+    /**
+     * Deletes a cache entry.
+     * @param key The cache key.
+     */
+    static del(key: string): Promise<void>;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/services/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/services/redis.ts"],"names":[],"mappings":"AAKA,qBAAa,UAAU;IAErB,OAAO,CAAC,MAAM,CAAC,MAAM,CAA2C;IAChE,OAAO,CAAC,MAAM,CAAC,0BAA0B,CAAO;IAEhD;;OAEG;WACiB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYzC;;;;;OAKG;WACiB,GAAG,CACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,EACV,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;OAIG;WACiB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe1D;;;OAGG;WACiB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}

package/dist/services/redis.js

@@ -0,0 +1,62 @@
+// src/services/redis.ts
+import { createClient } from "redis";
+const getRedisConfig = () => {
+    return process.env.REDIS_CONFIG_URL || "redis://localhost:6379/1";
+};
+export class RedisCache {
+    // Create a Redis client instance.
+    static client = createClient({ url: getRedisConfig() });
+    static DEFAULT_EXPIRATION_SECONDS = 900; // 15 minutes
+    /**
+     * Initializes the Redis client. Call this once on server startup.
+     */
+    static async init() {
+        if (this.client.isOpen) {
+            return;
+        }
+        try {
+            await this.client.connect();
+            console.log("Connected to Redis");
+        }
+        catch (err) {
+            console.error("Error connecting to Redis:", err);
+        }
+    }
+    /**
+     * Caches an object under a specified key.
+     * @param key The cache key.
+     * @param value The object to cache.
+     * @param expirationSeconds Optional expiration time in seconds (defaults to 15 minutes).
+     */
+    static async set(key, value, expirationSeconds) {
+        const exp = expirationSeconds || this.DEFAULT_EXPIRATION_SECONDS;
+        const stringValue = JSON.stringify(value);
+        await this.client.set(key, stringValue, { EX: exp });
+    }
+    /**
+     * Retrieves a cached object by its key.
+     * @param key The cache key.
+     * @returns The cached object, or null if not found.
+     */
+    static async get(key) {
+        const data = await this.client.get(key);
+        if (data) {
+            try {
+                return JSON.parse(typeof data === "string" ? data : JSON.stringify(data));
+            }
+            catch (err) {
+                console.error("Error parsing cached data:", err);
+                return data;
+            }
+        }
+        return null;
+    }
+    /**
+     * Deletes a cache entry.
+     * @param key The cache key.
+     */
+    static async del(key) {
+        await this.client.del(key);
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/services/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/services/redis.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,MAAM,cAAc,GAAG,GAAG,EAAE;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;AACpE,CAAC,CAAC;AACF,MAAM,OAAO,UAAU;IACrB,kCAAkC;IAC1B,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAC,aAAa;IAE9D;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI;QACtB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,GAAG,CACrB,GAAW,EACX,KAAU,EACV,iBAA0B;QAE1B,MAAM,GAAG,GAAG,iBAAiB,IAAI,IAAI,CAAC,0BAA0B,CAAC;QACjE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAI,GAAW;QACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CACf,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CACvD,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;gBACjD,OAAO,IAA2B,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAW;QACjC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./utils";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/tools/index.js

@@ -0,0 +1,2 @@
+export * from "./utils";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/tools/utils.d.ts

@@ -0,0 +1,44 @@
+import type { UUID } from "../models";
+export type MQTTFunctionalResponse = {
+    value: any;
+    key: string;
+    id: string;
+    request: string;
+};
+export declare const mqttMessageIdentity: (payload: Buffer<ArrayBufferLike>) => string;
+export declare const emailRegex: RegExp;
+export declare const wrapModelSet: <T>(models: T[], wrapOn?: keyof T) => (key: keyof T) => T | null | undefined;
+export declare const URL_HOST_PATTERN_FOR_INPUT: RegExp;
+export declare const DOMAIN_PATTERN: RegExp;
+export declare function isNumeric(str: string): boolean;
+export declare const generateUniqueUUID: () => UUID;
+export declare function formatDate(date: Date | string, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+export declare function formatMoney(value: number, currencySymbol?: string): string;
+export declare const siteMoneyFormatConfig: (value: number, currencyDivisor?: number, currencySymbol?: string) => string;
+export declare const errorMessageWithCode: (message: string) => {
+    code: number;
+    message: string | undefined;
+};
+export declare const isDomainPattern: (str: string) => boolean;
+export declare const extractFormToJson: <T extends Record<string, any> = {}>(form: FormData) => T;
+export declare const delay: (timeout?: number) => Promise<unknown>;
+export declare const generateRandomInt: (min: number, max: number) => number;
+export declare const generateUniqueId: (numBytes?: number) => string;
+export declare const isUUID: (value: string | UUID) => boolean;
+export declare const validateEmail: (email: string) => boolean;
+export declare const generateRandomPassword: (length: number) => string;
+export declare const fileToUint8Array: (file: File) => Promise<Uint8Array>;
+export declare function sha256String(values: string): string;
+export declare const ParseSocketMessage: <T>(message: string) => T;
+export declare const stripStateFromObject: (obj: any) => any;
+export declare const buildShaValueString: (data: any) => string;
+export declare const hashFileContents: (file: File) => Promise<string>;
+export declare const fileListToFile: (file: File) => Promise<File>;
+export declare const formatMessageServerMessage: (message: string) => any;
+export declare const isOlderThanInDays: (created_at: Date, days: number) => boolean;
+export declare const removeDoubleSpaces: (text: string) => string;
+export declare const removeContentSpace: (text: string) => string;
+export declare const removeHtmlEntities: (text: string) => string;
+export declare function getLast30DaysLabels(locale?: string): string[];
+export declare function humanizeNumber(value: number, precision?: number): string;
+//# sourceMappingURL=utils.d.ts.map

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

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