@similie/hyphen-command-server-types 1.0.0 → 1.0.4

package/dist/services/sql.js

@@ -0,0 +1,86 @@
+import { Client } from "pg";
+export class SQLService {
+    _triggers;
+    _listeners;
+    static instance;
+    _client;
+    listerCallbacks = {};
+    constructor(_triggers = [], _listeners = {}) {
+        this._triggers = _triggers;
+        this._listeners = _listeners;
+        this._client = new Client({
+            host: process.env.DB_HOST,
+            port: Number(process.env.DB_PORT || 5432),
+            user: process.env.DB_USER,
+            password: process.env.DB_PASSWORD,
+            database: process.env.DB_DATABASE,
+        });
+    }
+    get client() {
+        return this._client;
+    }
+    static get i() {
+        if (!this.instance) {
+            throw new Error("SQLService not initialized. Call setup() first.");
+        }
+        return this.instance;
+    }
+    static setup(triggers = [], listeners = {}) {
+        if (!SQLService.instance) {
+            SQLService.instance = new SQLService(triggers, listeners);
+        }
+        return SQLService.instance;
+    }
+    getStartTriggersSQL() {
+        return this._triggers;
+    }
+    listenToChannel = async (channel) => {
+        const rawClient = this._client;
+        if (!rawClient) {
+            throw new Error("Could not obtain PG raw client. Check TypeORM driver internals.");
+        }
+        await rawClient.query(`LISTEN ${channel}`);
+        console.log(`[PG-LISTENER] Listening for ${channel}`);
+    };
+    applyClientListeners = () => {
+        this.client.on("notification", async (msg) => {
+            try {
+                // console.log("Notification received:", msg);
+                const payload = JSON.parse(msg.payload);
+                for (const callback of this.listerCallbacks[payload.context] || []) {
+                    await callback(payload);
+                }
+            }
+            catch (err) {
+                console.error(`[PG-LISTENER] Failed to process payload:`, err);
+            }
+        });
+        this.client.on("error", (err) => {
+            console.error(`[PG-LISTENER] PG error, reconnecting in 5 seconds`, err);
+            //   setTimeout(() => this.listenToChannel(channel), 5000);
+        });
+    };
+    seedTriggers = async () => {
+        const triggers = this.getStartTriggersSQL();
+        await this._client.connect();
+        for (const triggerSQL of triggers) {
+            await this._client.query(triggerSQL);
+        }
+        for (const key of Object.keys(this._listeners)) {
+            if (!this._listeners[key]) {
+                continue;
+            }
+            await this.listenToChannel(this._listeners[key]);
+        }
+        this.applyClientListeners();
+    };
+    addListener = async (key, cb) => {
+        const channel = this._listeners[key];
+        if (!channel) {
+            return;
+        }
+        this.listerCallbacks[key] = this.listerCallbacks[key] || [];
+        this.listerCallbacks[key].push(cb);
+    };
+}
+//# sourceMappingURL=sql.js.map

package/dist/services/sql.js.map

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

package/dist/tools/index.d.ts

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

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

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

package/dist/tools/index.js

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

package/dist/tools/index.js.map

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

package/dist/tools/utils.d.ts

@@ -1,4 +1,4 @@
-import type { UUID } from "../models";
+import type { UUID } from "../models/index.js";
 export type MQTTFunctionalResponse = {
     value: any;
     key: string;

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

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

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@similie/hyphen-command-server-types",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "description": "Adds common types for Hyphen Command Center modules.",
   "main": "./dist/index.js",
+  "type": "module",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "build": "tsc",
@@ -20,14 +21,23 @@
     "@similie/model-connect-entities": "^1.1.4",
     "crypto-js": "^4.2.0",
     "ioredis": "^5.8.2",
+    "jsonwebtoken": "^9.0.3",
+    "pg": "^8.16.3",
     "redis": "^5.10.0",
     "redlock": "5.0.0-beta.2",
     "ts-node-dev": "^2.0.0",
     "uuid": "^13.0.0"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "devDependencies": {
     "@types/crypto-js": "^4.2.2",
+    "@types/jsonwebtoken": "^9.0.10",
     "@types/node": "^24.7.0",
+    "@types/pg": "^8.16.0",
     "standard-version": "^9.5.0",
     "typescript": "^5.9.3"
   }

package/CHANGELOG.md

@@ -1,5 +0,0 @@
-# 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/src/index.ts

@@ -1,4 +0,0 @@
-export * from "./models";
-export * from "./tools";
-export * from "./services";
-export * from "./modules";

package/src/models/base-model.ts

@@ -1,13 +0,0 @@
-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; // TODO: needs to be UUID
-  createdAt: Date;
-  updatedAt: Date;
-}

package/src/models/index.ts

@@ -1 +0,0 @@
-export * from "./base-model";

package/src/modules/index.ts

@@ -1,2 +0,0 @@
-export * from "./types";
-export * from "./loader";

package/src/modules/loader.ts

@@ -1,67 +0,0 @@
-// src/modules/loader.ts
-import type { HyphenModule, ModuleContext, LoadedModule } from "./types";
-
-export async function loadModulesFromEnv(
-  ctx: ModuleContext,
-): Promise<LoadedModule[]> {
-  const raw = process.env.HYPHEN_MODULES?.trim();
-  if (!raw) return [];
-
-  const specList = raw
-    .split(",")
-    .map((s) => s.trim())
-    .filter(Boolean);
-
-  const loaded: LoadedModule[] = [];
-
-  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: HyphenModule =
-        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: any) {
-      ctx.log(`[modules] failed to load: ${spec}`, {
-        error: e?.message ?? String(e),
-      });
-    }
-  }
-
-  return loaded;
-}
-
-export async function shutdownModules(
-  ctx: ModuleContext,
-  loaded: LoadedModule[],
-) {
-  for (const { mod, res } of loaded) {
-    try {
-      res && (await res?.shutdown?.());
-      ctx.log(`[modules] shutdown ${mod.name}`);
-    } catch (e: any) {
-      ctx.log(`[modules] shutdown failed ${mod.name}`, {
-        error: e?.message ?? String(e),
-      });
-    }
-  }
-}

package/src/modules/types.ts

@@ -1,40 +0,0 @@
-// src/modules/types.ts
-import type { RedisCache, LeaderElector } from "../services"; // or your Redis wrapper type
-import type { Ellipsies } from "@similie/ellipsies";
-// If you have an Ellipsies instance type, use it. Otherwise keep as `any` and tighten later.
-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 = {
-  // Optional cleanup hook called on shutdown
-  shutdown?: () => Promise<void> | void;
-};
-
-export interface HyphenModule {
-  name: string;
-  version?: string;
-
-  // Called once per process on boot
-  init(
-    ctx: ModuleContext,
-  ): Promise<ModuleInitResult | void> | (ModuleInitResult | void);
-}
-
-export type LoadedModule = {
-  mod: HyphenModule;
-  res?: ModuleInitResult | void;
-};

package/src/services/index.ts

@@ -1,2 +0,0 @@
-export * from "./leader-lock";
-export * from "./redis";

package/src/services/leader-lock.ts

@@ -1,113 +0,0 @@
-import { EventEmitter } from "events";
-import { Redis } from "ioredis";
-import Redlock, { Lock } from "redlock";
-import { randomUUID } from "crypto";
-
-export type LeaderEvents = {
-  elected: () => void;
-  revoked: () => void;
-  error: (err: Error) => void;
-};
-
-export class LeaderElector extends EventEmitter {
-  private static instance: LeaderElector;
-  private redlock!: Redlock;
-  private redis!: Redis;
-  private renewTimer?: NodeJS.Timeout;
-  private acquireTimer?: NodeJS.Timeout;
-  private lock?: Lock | undefined;
-
-  private readonly lockKey = "mqtt:leader:lock";
-  private readonly ttlMs = 10000; // lock TTL
-  private readonly renewEveryMs = 5000; // extend interval (< TTL)
-  private readonly retryDelayMs = 1500; // backoff when not leader
-  private readonly instanceId = randomUUID(); // for logging/diagnostics
-
-  private constructor() {
-    super();
-  }
-
-  static get(): LeaderElector {
-    if (!this.instance) this.instance = new LeaderElector();
-    return this.instance;
-  }
-
-  init(redisUrl: string) {
-    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(): boolean {
-    return !!this.lock;
-  }
-
-  /** Stop loops and release if we are leader. */
-  async shutdown() {
-    clearTimeout(this.acquireTimer as any);
-    clearInterval(this.renewTimer as any);
-    await this.safeRelease();
-    await this.redis?.quit();
-  }
-
-  // -------- internal --------
-
-  private 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 as Error));
-  }
-
-  private startRenewLoop() {
-    clearInterval(this.renewTimer as any);
-    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);
-  }
-
-  private async safeRevoke() {
-    clearInterval(this.renewTimer as any);
-    this.lock = undefined;
-    this.emit("revoked");
-  }
-
-  private async safeRelease() {
-    if (!this.lock) return;
-    try {
-      await this.lock.release();
-    } catch {
-      // If already expired or released, ignore.
-    } finally {
-      await this.safeRevoke();
-    }
-  }
-}

package/src/services/redis.ts

@@ -1,69 +0,0 @@
-// 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.
-  private static client = createClient({ url: getRedisConfig() });
-  private static DEFAULT_EXPIRATION_SECONDS = 900; // 15 minutes
-
-  /**
-   * Initializes the Redis client. Call this once on server startup.
-   */
-  public static async init(): Promise<void> {
-    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).
-   */
-  public static async set(
-    key: string,
-    value: any,
-    expirationSeconds?: number,
-  ): Promise<void> {
-    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.
-   */
-  public static async get<T>(key: string): Promise<T | null> {
-    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 as unknown as T | null;
-      }
-    }
-    return null;
-  }
-
-  /**
-   * Deletes a cache entry.
-   * @param key The cache key.
-   */
-  public static async del(key: string): Promise<void> {
-    await this.client.del(key);
-  }
-}

package/src/tools/index.ts

@@ -1 +0,0 @@
-export * from "./utils";