@primebrick/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Sogos
+
+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,21 @@
+# @primebrick/sdk
+
+Shared microservice infrastructure for Primebrick v3 — config loading, migration runner, service registration, graceful shutdown, NATS client, health checks, env validation. DB-agnostic via port interfaces.
+
+## What the SDK provides
+
+- **Port interfaces** — `ConfigRepositoryPort`, `DatabasePort`, `ServiceRegistryPort`, `HealthCheckPort`. Abstract contracts the consumer implements using their DAL.
+- **ConfigLoader** — load config from a DB config table at startup, cache in memory, `get(key)` on hot path, `invalidate()` for refresh.
+- **IConfigEntity** — self-contained interface for dictionary-style config rows.
+- **Migration runner** — SHA256-based patch tracking, idempotent re-runs.
+- **ServiceRegistrar** — register microservice in `service_registry`, maintain heartbeat.
+- **IServiceRegistry** — self-contained interface for `service_registry` rows.
+- **GracefulShutdown** — re-entrancy guard, `Promise.allSettled` for parallel resource cleanup, signal handlers.
+- **NatsClient** — singleton NATS connection management.
+- **HttpServer** — minimal HTTP server with health endpoint.
+- **HealthCheck** — DB health check utility.
+- **EnvValidator** — centralized env var validation.
+
+## License
+
+MIT — Copyright (c) 2026 Michael Sogos

package/dist/config/config-loader.d.ts

@@ -0,0 +1,50 @@
+import type { ConfigRepositoryPort } from "../ports/config-repository-port.js";
+/**
+ * Dictionary-style config loader backed by a config table.
+ * Mirrors BE's loadAuthConfig / getAuthConfig / invalidateAuthConfig pattern
+ * (config.ts:150-180), generalized so every microservice can reuse it.
+ *
+ * DB-agnostic: depends on ConfigRepositoryPort, NOT on any specific DAL.
+ * The consumer provides an adapter that implements ConfigRepositoryPort
+ * using their DAL (e.g. @primebrick/dal-pg, or raw SQL).
+ *
+ * Load once at startup → cache in memory → get(key) on hot path (zero DB hits).
+ * Call invalidate() to force a reload on next load().
+ */
+export declare class ConfigLoader {
+    private readonly repo;
+    private cache;
+    constructor(repo: ConfigRepositoryPort);
+    /**
+     * Load all config rows from DB into in-memory cache.
+     * Call once at startup. Throws if DB is unreachable.
+     */
+    load(): Promise<Record<string, string | null>>;
+    /**
+     * Get a config value from cache. Returns null if key is missing or value is null.
+     * Throws if load() has not been called.
+     */
+    get(key: string): string | null;
+    /**
+     * Get a config value, throwing if it's missing or empty.
+     */
+    require(key: string): string;
+    /**
+     * Get a typed config value via a converter function.
+     * Returns null if the key is missing.
+     */
+    getTyped<T>(key: string, converter: (v: string) => T): T | null;
+    /**
+     * Get a typed config value, throwing if it's missing.
+     */
+    requireTyped<T>(key: string, converter: (v: string) => T): T;
+    /**
+     * Get all config as a plain object.
+     */
+    getAll(): Record<string, string | null>;
+    /**
+     * Invalidate the cache so the next load() re-reads from DB.
+     */
+    invalidate(): void;
+}
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,KAAK,CAA2C;gBAE3B,IAAI,EAAE,oBAAoB;IAEvD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IASpD;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQ5B;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAM/D;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC;IAK5D;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAOvC;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/config/config-loader.js

@@ -0,0 +1,84 @@
+/**
+ * Dictionary-style config loader backed by a config table.
+ * Mirrors BE's loadAuthConfig / getAuthConfig / invalidateAuthConfig pattern
+ * (config.ts:150-180), generalized so every microservice can reuse it.
+ *
+ * DB-agnostic: depends on ConfigRepositoryPort, NOT on any specific DAL.
+ * The consumer provides an adapter that implements ConfigRepositoryPort
+ * using their DAL (e.g. @primebrick/dal-pg, or raw SQL).
+ *
+ * Load once at startup → cache in memory → get(key) on hot path (zero DB hits).
+ * Call invalidate() to force a reload on next load().
+ */
+export class ConfigLoader {
+    repo;
+    cache = null;
+    constructor(repo) {
+        this.repo = repo;
+    }
+    /**
+     * Load all config rows from DB into in-memory cache.
+     * Call once at startup. Throws if DB is unreachable.
+     */
+    async load() {
+        const rows = await this.repo.findAll();
+        this.cache = new Map();
+        for (const row of rows) {
+            this.cache.set(row.key, row.value ?? null);
+        }
+        return Object.fromEntries(this.cache);
+    }
+    /**
+     * Get a config value from cache. Returns null if key is missing or value is null.
+     * Throws if load() has not been called.
+     */
+    get(key) {
+        if (this.cache === null) {
+            throw new Error("ConfigLoader.load() must be called before get()");
+        }
+        return this.cache.get(key) ?? null;
+    }
+    /**
+     * Get a config value, throwing if it's missing or empty.
+     */
+    require(key) {
+        const value = this.get(key);
+        if (value === null || value === "") {
+            throw new Error(`Missing required config key: ${key}`);
+        }
+        return value;
+    }
+    /**
+     * Get a typed config value via a converter function.
+     * Returns null if the key is missing.
+     */
+    getTyped(key, converter) {
+        const value = this.get(key);
+        if (value === null)
+            return null;
+        return converter(value);
+    }
+    /**
+     * Get a typed config value, throwing if it's missing.
+     */
+    requireTyped(key, converter) {
+        const value = this.require(key);
+        return converter(value);
+    }
+    /**
+     * Get all config as a plain object.
+     */
+    getAll() {
+        if (this.cache === null) {
+            throw new Error("ConfigLoader.load() must be called before getAll()");
+        }
+        return Object.fromEntries(this.cache);
+    }
+    /**
+     * Invalidate the cache so the next load() re-reads from DB.
+     */
+    invalidate() {
+        this.cache = null;
+    }
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/config/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IAGM;IAFrB,KAAK,GAAsC,IAAI,CAAC;IAExD,YAA6B,IAA0B;QAA1B,SAAI,GAAJ,IAAI,CAAsB;IAAG,CAAC;IAE3D;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,GAAW;QACb,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAW;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAI,GAAW,EAAE,SAA2B;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY,CAAI,GAAW,EAAE,SAA2B;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;CACF"}

package/dist/config/iconfig-entity.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shape of a dictionary-style config row. Every microservice config table
+ * mirrors this: one row per key, value stored as TEXT, type conversion
+ * performed at read time by ConfigLoader consumers.
+ *
+ * Self-contained — does NOT extend IAuditableEntity from @primebrick/dal-pg.
+ * The SDK is DB-agnostic; audit fields are a DAL-specific concern handled
+ * by the consumer's entity class and adapter.
+ */
+export interface IConfigEntity {
+    /** Unique config key, e.g. "brevo_api_key". */
+    key: string;
+    /** Raw TEXT value. null means "not set yet". Type conversion at read time. */
+    value: string | null;
+    /** Optional i18n translation key for a short title (used by BE/FE for display). */
+    label_key?: string;
+    /** Optional i18n translation key for a longer description (used by BE/FE for display). */
+    description_key?: string;
+}
+//# sourceMappingURL=iconfig-entity.d.ts.map

package/dist/config/iconfig-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconfig-entity.d.ts","sourceRoot":"","sources":["../../src/config/iconfig-entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/config/iconfig-entity.js

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

package/dist/config/iconfig-entity.js.map

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

package/dist/env/env-validator.d.ts

@@ -0,0 +1,25 @@
+export interface EnvSchema {
+    [key: string]: {
+        required: boolean;
+        default?: string;
+        description?: string;
+    };
+}
+export interface EnvValidationResult {
+    valid: boolean;
+    errors: string[];
+    env: Record<string, string | undefined>;
+}
+/**
+ * Centralized env var validation. Replaces scattered inline checks
+ * (emailsender: dal.ts:18-20, http-server.ts:5-9, webhook-service.ts:9-14,
+ * email-service.ts:12-17; BE: src/db/pool.ts).
+ *
+ * Pure process.env — no DB dependency.
+ */
+export declare function validateEnv(schema: EnvSchema): EnvValidationResult;
+/**
+ * Validate env vars and throw if any required ones are missing.
+ */
+export declare function requireEnv(schema: EnvSchema): Record<string, string | undefined>;
+//# sourceMappingURL=env-validator.d.ts.map

package/dist/env/env-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validator.d.ts","sourceRoot":"","sources":["../../src/env/env-validator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,mBAAmB,CAalE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAMhF"}

package/dist/env/env-validator.js

@@ -0,0 +1,30 @@
+/**
+ * Centralized env var validation. Replaces scattered inline checks
+ * (emailsender: dal.ts:18-20, http-server.ts:5-9, webhook-service.ts:9-14,
+ * email-service.ts:12-17; BE: src/db/pool.ts).
+ *
+ * Pure process.env — no DB dependency.
+ */
+export function validateEnv(schema) {
+    const errors = [];
+    const env = {};
+    for (const [key, spec] of Object.entries(schema)) {
+        const value = process.env[key] ?? spec.default;
+        env[key] = value;
+        if (spec.required && (value === undefined || value === "")) {
+            errors.push(`${key} is required${spec.description ? ` (${spec.description})` : ""}`);
+        }
+    }
+    return { valid: errors.length === 0, errors, env };
+}
+/**
+ * Validate env vars and throw if any required ones are missing.
+ */
+export function requireEnv(schema) {
+    const result = validateEnv(schema);
+    if (!result.valid) {
+        throw new Error(`Environment validation failed:\n  - ${result.errors.join("\n  - ")}`);
+    }
+    return result.env;
+}
+//# sourceMappingURL=env-validator.js.map

package/dist/env/env-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validator.js","sourceRoot":"","sources":["../../src/env/env-validator.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAiB;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAuC,EAAE,CAAC;IAEnD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC;QAC/C,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACjB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,eAAe,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC;AACpB,CAAC"}

package/dist/http/health-check.d.ts

@@ -0,0 +1,22 @@
+import type { HealthCheckPort } from "../ports/health-check-port.js";
+export interface HealthCheckResult {
+    ok: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Health check utility. Extracted from BE's index.ts:126-148 pattern.
+ * Checks DB connectivity (via HealthCheckPort) and optional custom checks.
+ *
+ * DB-agnostic: depends on HealthCheckPort, NOT on pg.Pool.
+ * The consumer provides an adapter that runs whatever their DB uses
+ * (e.g. `SELECT 1` for PG).
+ */
+export declare class HealthCheck {
+    private readonly dbPing;
+    private readonly customChecks;
+    constructor(dbPing: HealthCheckPort, customChecks?: Record<string, () => Promise<HealthCheckResult>>);
+    checkDb(): Promise<HealthCheckResult>;
+    runAll(): Promise<Record<string, HealthCheckResult>>;
+    isHealthy(results: Record<string, HealthCheckResult>): boolean;
+}
+//# sourceMappingURL=health-check.d.ts.map

package/dist/http/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../src/http/health-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,MAAM,EAAE,eAAe,EACvB,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAM;IAGhF,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IASrC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAc1D,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,OAAO;CAG/D"}

package/dist/http/health-check.js

@@ -0,0 +1,43 @@
+/**
+ * Health check utility. Extracted from BE's index.ts:126-148 pattern.
+ * Checks DB connectivity (via HealthCheckPort) and optional custom checks.
+ *
+ * DB-agnostic: depends on HealthCheckPort, NOT on pg.Pool.
+ * The consumer provides an adapter that runs whatever their DB uses
+ * (e.g. `SELECT 1` for PG).
+ */
+export class HealthCheck {
+    dbPing;
+    customChecks;
+    constructor(dbPing, customChecks = {}) {
+        this.dbPing = dbPing;
+        this.customChecks = customChecks;
+    }
+    async checkDb() {
+        try {
+            const ok = await this.dbPing.ping();
+            return { ok };
+        }
+        catch {
+            return { ok: false };
+        }
+    }
+    async runAll() {
+        const results = {
+            db: await this.checkDb(),
+        };
+        for (const [name, check] of Object.entries(this.customChecks)) {
+            try {
+                results[name] = await check();
+            }
+            catch (e) {
+                results[name] = { ok: false, error: e instanceof Error ? e.message : "Unknown error" };
+            }
+        }
+        return results;
+    }
+    isHealthy(results) {
+        return Object.values(results).every((r) => r.ok);
+    }
+}
+//# sourceMappingURL=health-check.js.map

package/dist/http/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.js","sourceRoot":"","sources":["../../src/http/health-check.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IAEH;IACA;IAFnB,YACmB,MAAuB,EACvB,eAAiE,EAAE;QADnE,WAAM,GAAN,MAAM,CAAiB;QACvB,iBAAY,GAAZ,YAAY,CAAuD;IACnF,CAAC;IAEJ,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO,EAAE,EAAE,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,OAAO,GAAsC;YACjD,EAAE,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE;SACzB,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;YACzF,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS,CAAC,OAA0C;QAClD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/http/http-server.d.ts

@@ -0,0 +1,16 @@
+import { type IncomingMessage, type ServerResponse, type Server } from "http";
+import type { HealthCheck } from "./health-check.js";
+export interface HttpServerOptions {
+    port: number;
+    healthCheck?: HealthCheck;
+    serviceName?: string;
+    /** Custom route handler — receives req/res, returns true if handled. */
+    routeHandler?: (req: IncomingMessage, res: ServerResponse, url: URL) => Promise<boolean>;
+}
+/**
+ * Minimal HTTP server with health endpoint. Extracted from emailsender's
+ * server/http-server.ts:1-64. Uses native http module (no Express).
+ * No DB dependency.
+ */
+export declare function createHttpServer(options: HttpServerOptions): Promise<Server>;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/http/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1F;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClF"}

package/dist/http/http-server.js

@@ -0,0 +1,38 @@
+import { createServer } from "http";
+/**
+ * Minimal HTTP server with health endpoint. Extracted from emailsender's
+ * server/http-server.ts:1-64. Uses native http module (no Express).
+ * No DB dependency.
+ */
+export async function createHttpServer(options) {
+    const server = createServer(async (req, res) => {
+        const url = new URL(req.url || "", `http://${req.headers.host}`);
+        // Health check endpoint
+        if (url.pathname === "/health" && req.method === "GET") {
+            if (options.healthCheck) {
+                const results = await options.healthCheck.runAll();
+                const healthy = options.healthCheck.isHealthy(results);
+                res.writeHead(healthy ? 200 : 503, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ status: healthy ? "healthy" : "degraded", checks: results }));
+            }
+            else {
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ status: "healthy" }));
+            }
+            return;
+        }
+        // Custom routes
+        if (options.routeHandler) {
+            const handled = await options.routeHandler(req, res, url);
+            if (handled)
+                return;
+        }
+        res.writeHead(404, { "Content-Type": "text/plain" });
+        res.end("Not Found");
+    });
+    server.listen(options.port, () => {
+        console.log(`HTTP server listening on port ${options.port}`);
+    });
+    return server;
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../../src/http/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA0D,MAAM,MAAM,CAAC;AAW5F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA0B;IAC/D,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAE,EAAE;QAC9E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAEjE,wBAAwB;QACxB,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACvD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACnD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACvD,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC3E,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YACzF,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YACjD,CAAC;YACD,OAAO;QACT,CAAC;QAED,gBAAgB;QAChB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YAC1D,IAAI,OAAO;gBAAE,OAAO;QACtB,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC;QACrD,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE;QAC/B,OAAO,CAAC,GAAG,CAAC,iCAAiC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @primebrick/sdk — Shared microservice infrastructure for Primebrick v3.
+ *
+ * DB-agnostic via port interfaces (dependency inversion).
+ * ZERO dependencies on any Primebrick library or DB driver.
+ *
+ * Modules:
+ * - ports: ConfigRepositoryPort, DatabasePort, ServiceRegistryPort, HealthCheckPort
+ * - config: ConfigLoader, IConfigEntity
+ * - migrations: applyPatches, patch-registry, patch-naming
+ * - service: ServiceRegistrar, IServiceRegistry
+ * - lifecycle: GracefulShutdown
+ * - nats: NatsClient (requires `nats` peer dependency)
+ * - http: createHttpServer, HealthCheck
+ * - env: validateEnv, requireEnv
+ */
+export { type ConfigRepositoryPort } from "./ports/config-repository-port.js";
+export { type DatabasePort } from "./ports/database-port.js";
+export { type ServiceRegistryPort } from "./ports/service-registry-port.js";
+export { type HealthCheckPort } from "./ports/health-check-port.js";
+export { type IConfigEntity } from "./config/iconfig-entity.js";
+export { ConfigLoader } from "./config/config-loader.js";
+export { PATCH_REGISTRY_DDL, PATCH_REGISTRY_FQNAME, isPatchBodyAlreadyRecorded, } from "./migrations/patch-registry.js";
+export { utcTimestampForFilename, slugifyPatchSegment, patchIdFromFilename, sha256Hex, } from "./migrations/patch-naming.js";
+export { applyPatches, type ApplyPatchesResult } from "./migrations/apply-patches.js";
+export { type IServiceRegistry } from "./service/service-registry.js";
+export { ServiceRegistrar, type ServiceRegistrarConfig } from "./service/service-registrar.js";
+export { GracefulShutdown, type CleanupFn } from "./lifecycle/graceful-shutdown.js";
+export { NatsClient } from "./nats/nats-client.js";
+export { createHttpServer, type HttpServerOptions } from "./http/http-server.js";
+export { HealthCheck, type HealthCheckResult } from "./http/health-check.js";
+export { validateEnv, requireEnv, type EnvSchema, type EnvValidationResult } from "./env/env-validator.js";
+//# 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;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGtF,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAG/F,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGpF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @primebrick/sdk — Shared microservice infrastructure for Primebrick v3.
+ *
+ * DB-agnostic via port interfaces (dependency inversion).
+ * ZERO dependencies on any Primebrick library or DB driver.
+ *
+ * Modules:
+ * - ports: ConfigRepositoryPort, DatabasePort, ServiceRegistryPort, HealthCheckPort
+ * - config: ConfigLoader, IConfigEntity
+ * - migrations: applyPatches, patch-registry, patch-naming
+ * - service: ServiceRegistrar, IServiceRegistry
+ * - lifecycle: GracefulShutdown
+ * - nats: NatsClient (requires `nats` peer dependency)
+ * - http: createHttpServer, HealthCheck
+ * - env: validateEnv, requireEnv
+ */
+export { ConfigLoader } from "./config/config-loader.js";
+// Migrations
+export { PATCH_REGISTRY_DDL, PATCH_REGISTRY_FQNAME, isPatchBodyAlreadyRecorded, } from "./migrations/patch-registry.js";
+export { utcTimestampForFilename, slugifyPatchSegment, patchIdFromFilename, sha256Hex, } from "./migrations/patch-naming.js";
+export { applyPatches } from "./migrations/apply-patches.js";
+export { ServiceRegistrar } from "./service/service-registrar.js";
+// Lifecycle
+export { GracefulShutdown } from "./lifecycle/graceful-shutdown.js";
+// NATS (optional — requires `nats` peer dependency)
+export { NatsClient } from "./nats/nats-client.js";
+// HTTP
+export { createHttpServer } from "./http/http-server.js";
+export { HealthCheck } from "./http/health-check.js";
+// Env validation
+export { validateEnv, requireEnv } from "./env/env-validator.js";
+//# 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;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,aAAa;AACb,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAA2B,MAAM,+BAA+B,CAAC;AAItF,OAAO,EAAE,gBAAgB,EAA+B,MAAM,gCAAgC,CAAC;AAE/F,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAkB,MAAM,kCAAkC,CAAC;AAEpF,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO;AACP,OAAO,EAAE,gBAAgB,EAA0B,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,WAAW,EAA0B,MAAM,wBAAwB,CAAC;AAE7E,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,UAAU,EAA4C,MAAM,wBAAwB,CAAC"}

package/dist/lifecycle/graceful-shutdown.d.ts

@@ -0,0 +1,24 @@
+export type CleanupFn = () => Promise<void>;
+/**
+ * Graceful shutdown manager. Extracted from emailsender's index.ts:55-95.
+ *
+ * - Re-entrancy guard: second signal is a no-op.
+ * - Runs all cleanup functions in parallel (Promise.allSettled).
+ * - Always calls process.exit() explicitly.
+ * - Installs SIGTERM, SIGINT, SIGHUP + uncaughtException + unhandledRejection handlers.
+ *
+ * Pure Node.js — no DB dependency. The consumer registers cleanup functions
+ * (e.g. getDal().close(), NatsClient.close()) via addCleanup().
+ */
+export declare class GracefulShutdown {
+    private shuttingDown;
+    private readonly cleanups;
+    private readonly serviceName;
+    constructor(serviceName: string);
+    /** Register a cleanup function to run on shutdown. */
+    addCleanup(fn: CleanupFn): void;
+    /** Install signal + crash handlers. */
+    install(): void;
+    shutdown(reason: string, code: number): Promise<void>;
+}
+//# sourceMappingURL=graceful-shutdown.d.ts.map

package/dist/lifecycle/graceful-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../../src/lifecycle/graceful-shutdown.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,EAAE,MAAM;IAI/B,sDAAsD;IACtD,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAI/B,uCAAuC;IACvC,OAAO,IAAI,IAAI;IAkBT,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAU5D"}

package/dist/lifecycle/graceful-shutdown.js

@@ -0,0 +1,55 @@
+import os from "node:os";
+/**
+ * Graceful shutdown manager. Extracted from emailsender's index.ts:55-95.
+ *
+ * - Re-entrancy guard: second signal is a no-op.
+ * - Runs all cleanup functions in parallel (Promise.allSettled).
+ * - Always calls process.exit() explicitly.
+ * - Installs SIGTERM, SIGINT, SIGHUP + uncaughtException + unhandledRejection handlers.
+ *
+ * Pure Node.js — no DB dependency. The consumer registers cleanup functions
+ * (e.g. getDal().close(), NatsClient.close()) via addCleanup().
+ */
+export class GracefulShutdown {
+    shuttingDown = false;
+    cleanups = [];
+    serviceName;
+    constructor(serviceName) {
+        this.serviceName = serviceName;
+    }
+    /** Register a cleanup function to run on shutdown. */
+    addCleanup(fn) {
+        this.cleanups.push(fn);
+    }
+    /** Install signal + crash handlers. */
+    install() {
+        const signals = ["SIGTERM", "SIGINT", "SIGHUP"];
+        for (const sig of signals) {
+            process.on(sig, () => {
+                const code = 128 + (os.constants.signals[sig] ?? 0);
+                void this.shutdown(sig, code);
+            });
+        }
+        process.on("uncaughtException", (err) => {
+            console.error(`[${this.serviceName}] uncaughtException`, err);
+            void this.shutdown("uncaughtException", 1);
+        });
+        process.on("unhandledRejection", (reason) => {
+            console.error(`[${this.serviceName}] unhandledRejection`, reason);
+            void this.shutdown("unhandledRejection", 1);
+        });
+    }
+    async shutdown(reason, code) {
+        if (this.shuttingDown)
+            return;
+        this.shuttingDown = true;
+        console.log(`[${this.serviceName}] shutting down (${reason})`);
+        try {
+            await Promise.allSettled(this.cleanups.map((fn) => fn()));
+        }
+        finally {
+            process.exit(code);
+        }
+    }
+}
+//# sourceMappingURL=graceful-shutdown.js.map

package/dist/lifecycle/graceful-shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.js","sourceRoot":"","sources":["../../src/lifecycle/graceful-shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IACnB,YAAY,GAAG,KAAK,CAAC;IACZ,QAAQ,GAAgB,EAAE,CAAC;IAC3B,WAAW,CAAS;IAErC,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,sDAAsD;IACtD,UAAU,CAAC,EAAa;QACtB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,uCAAuC;IACvC,OAAO;QACL,MAAM,OAAO,GAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;gBACnB,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,GAAwC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACzF,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;YACtC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,qBAAqB,EAAE,GAAG,CAAC,CAAC;YAC9D,KAAK,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAClE,KAAK,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,IAAY;QACzC,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,oBAAoB,MAAM,GAAG,CAAC,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/migrations/apply-patches.d.ts

@@ -0,0 +1,25 @@
+import type { DatabasePort } from "../ports/database-port.js";
+export interface ApplyPatchesResult {
+    appliedOrRegistered: number;
+    skipped: number;
+}
+/**
+ * Apply database SQL patches from a directory.
+ *
+ * Strategy (adapted from BE's scripts/database-patch-apply.ts:1-148):
+ * - Read .sql files from patchesDir sorted by filename.
+ * - For each file, consult public.primebrick_database_patches (patch_id + content_sha256):
+ *   - Same patch_id + same SHA → skip (already applied).
+ *   - Same patch_id + different SHA → fail (immutable patch changed).
+ *   - Missing patch_id but same SHA exists → register without re-executing.
+ *   - Otherwise → BEGIN; apply SQL; INSERT registry row; COMMIT.
+ *
+ * DB-agnostic: depends on DatabasePort, NOT on pg.Pool.
+ * The consumer provides an adapter that wraps their DB driver.
+ *
+ * @param patchesDir Absolute path to the directory containing .sql patch files.
+ * @param db DatabasePort adapter (wraps the consumer's DB driver).
+ * @returns Result with count of applied/registered and skipped patches.
+ */
+export declare function applyPatches(patchesDir: string, db: DatabasePort): Promise<ApplyPatchesResult>;
+//# sourceMappingURL=apply-patches.d.ts.map

package/dist/migrations/apply-patches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patches.d.ts","sourceRoot":"","sources":["../../src/migrations/apply-patches.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwEpG"}

package/dist/migrations/apply-patches.js

@@ -0,0 +1,75 @@
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { PATCH_REGISTRY_DDL, PATCH_REGISTRY_FQNAME } from "./patch-registry.js";
+import { patchIdFromFilename, sha256Hex } from "./patch-naming.js";
+/**
+ * Apply database SQL patches from a directory.
+ *
+ * Strategy (adapted from BE's scripts/database-patch-apply.ts:1-148):
+ * - Read .sql files from patchesDir sorted by filename.
+ * - For each file, consult public.primebrick_database_patches (patch_id + content_sha256):
+ *   - Same patch_id + same SHA → skip (already applied).
+ *   - Same patch_id + different SHA → fail (immutable patch changed).
+ *   - Missing patch_id but same SHA exists → register without re-executing.
+ *   - Otherwise → BEGIN; apply SQL; INSERT registry row; COMMIT.
+ *
+ * DB-agnostic: depends on DatabasePort, NOT on pg.Pool.
+ * The consumer provides an adapter that wraps their DB driver.
+ *
+ * @param patchesDir Absolute path to the directory containing .sql patch files.
+ * @param db DatabasePort adapter (wraps the consumer's DB driver).
+ * @returns Result with count of applied/registered and skipped patches.
+ */
+export async function applyPatches(patchesDir, db) {
+    await db.query(PATCH_REGISTRY_DDL);
+    let files = [];
+    try {
+        files = readdirSync(patchesDir).filter((f) => f.endsWith(".sql")).sort();
+    }
+    catch {
+        return { appliedOrRegistered: 0, skipped: 0 };
+    }
+    if (files.length === 0) {
+        return { appliedOrRegistered: 0, skipped: 0 };
+    }
+    let appliedOrRegistered = 0;
+    let skipped = 0;
+    for (const filename of files) {
+        const patchPath = join(patchesDir, filename);
+        const raw = readFileSync(patchPath, "utf8");
+        const sha = sha256Hex(raw);
+        const patchId = patchIdFromFilename(filename);
+        const byId = await db.query(`SELECT content_sha256 FROM ${PATCH_REGISTRY_FQNAME} WHERE patch_id = $1`, [patchId]);
+        if (byId.rows.length > 0) {
+            const recorded = byId.rows[0].content_sha256;
+            if (recorded === sha) {
+                console.log(`Skipping already applied patch: ${filename}`);
+                skipped++;
+                continue;
+            }
+            throw new Error(`Patch ${filename} (${patchId}) exists in registry with a different content_sha256 — refusing to run.`);
+        }
+        const bySha = await db.query(`SELECT patch_id FROM ${PATCH_REGISTRY_FQNAME} WHERE content_sha256 = $1 LIMIT 1`, [sha]);
+        if (bySha.rows.length > 0) {
+            const other = bySha.rows[0].patch_id;
+            await db.query(`INSERT INTO ${PATCH_REGISTRY_FQNAME} (patch_id, content_sha256) VALUES ($1, $2)`, [patchId, sha]);
+            console.log(`Registered ${filename} (same body as ${other}) — no SQL re-execution.`);
+            appliedOrRegistered++;
+            continue;
+        }
+        console.log(`Applying patch: ${filename}`);
+        try {
+            await db.query("BEGIN");
+            await db.query(raw);
+            await db.query(`INSERT INTO ${PATCH_REGISTRY_FQNAME} (patch_id, content_sha256) VALUES ($1, $2)`, [patchId, sha]);
+            await db.query("COMMIT");
+            appliedOrRegistered++;
+        }
+        catch (e) {
+            await db.query("ROLLBACK");
+            throw new Error(`Failed to apply patch ${filename}: ${e}`);
+        }
+    }
+    return { appliedOrRegistered, skipped };
+}
+//# sourceMappingURL=apply-patches.js.map

package/dist/migrations/apply-patches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patches.js","sourceRoot":"","sources":["../../src/migrations/apply-patches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAOnE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB,EAAE,EAAgB;IACrE,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAEnC,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,mBAAmB,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,mBAAmB,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAC5B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CACzB,8BAA8B,qBAAqB,sBAAsB,EACzE,CAAC,OAAO,CAAC,CACV,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAgC,CAAC,cAAc,CAAC;YAC7E,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;gBAC3D,OAAO,EAAE,CAAC;gBACV,SAAS;YACX,CAAC;YACD,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,KAAK,OAAO,yEAAyE,CACvG,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,KAAK,CAC1B,wBAAwB,qBAAqB,oCAAoC,EACjF,CAAC,GAAG,CAAC,CACN,CAAC;QACF,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAA0B,CAAC,QAAQ,CAAC;YAC/D,MAAM,EAAE,CAAC,KAAK,CACZ,eAAe,qBAAqB,6CAA6C,EACjF,CAAC,OAAO,EAAE,GAAG,CAAC,CACf,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,kBAAkB,KAAK,0BAA0B,CAAC,CAAC;YACrF,mBAAmB,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpB,MAAM,EAAE,CAAC,KAAK,CACZ,eAAe,qBAAqB,6CAA6C,EACjF,CAAC,OAAO,EAAE,GAAG,CAAC,CACf,CAAC;YACF,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACzB,mBAAmB,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/migrations/patch-naming.d.ts

@@ -0,0 +1,5 @@
+export declare function utcTimestampForFilename(d?: Date): string;
+export declare function slugifyPatchSegment(s: string): string;
+export declare function patchIdFromFilename(filename: string): string;
+export declare function sha256Hex(body: string): string;
+//# sourceMappingURL=patch-naming.d.ts.map

package/dist/migrations/patch-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-naming.d.ts","sourceRoot":"","sources":["../../src/migrations/patch-naming.ts"],"names":[],"mappings":"AAEA,wBAAgB,uBAAuB,CAAC,CAAC,OAAa,GAAG,MAAM,CAM9D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/migrations/patch-naming.js

@@ -0,0 +1,21 @@
+import { createHash } from "node:crypto";
+export function utcTimestampForFilename(d = new Date()) {
+    const p = (n) => String(n).padStart(2, "0");
+    return (`${d.getUTCFullYear()}${p(d.getUTCMonth() + 1)}${p(d.getUTCDate())}` +
+        `${p(d.getUTCHours())}${p(d.getUTCMinutes())}${p(d.getUTCSeconds())}`);
+}
+export function slugifyPatchSegment(s) {
+    return s
+        .replace(/[^a-zA-Z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .replace(/_+/g, "_")
+        .toLowerCase()
+        .slice(0, 72) || "patch";
+}
+export function patchIdFromFilename(filename) {
+    return filename.replace(/\.sql$/i, "");
+}
+export function sha256Hex(body) {
+    return createHash("sha256").update(body, "utf-8").digest("hex");
+}
+//# sourceMappingURL=patch-naming.js.map

package/dist/migrations/patch-naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-naming.js","sourceRoot":"","sources":["../../src/migrations/patch-naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,uBAAuB,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE;IACpD,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,CACL,GAAG,CAAC,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE;QACpE,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,EAAE,CACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,CAAS;IAC3C,OAAO,CAAC;SACL,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,WAAW,EAAE;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/migrations/patch-registry.d.ts

@@ -0,0 +1,5 @@
+import type { DatabasePort } from "../ports/database-port.js";
+export declare const PATCH_REGISTRY_FQNAME = "public.primebrick_database_patches";
+export declare const PATCH_REGISTRY_DDL = "CREATE TABLE IF NOT EXISTS public.primebrick_database_patches (\n  patch_id text PRIMARY KEY,\n  content_sha256 text NOT NULL,\n  applied_at timestamptz NOT NULL DEFAULT now()\n);\nCREATE INDEX IF NOT EXISTS primebrick_database_patches_sha_idx\n  ON public.primebrick_database_patches (content_sha256);\n";
+export declare function isPatchBodyAlreadyRecorded(db: DatabasePort, contentSha256: string): Promise<boolean>;
+//# sourceMappingURL=patch-registry.d.ts.map

package/dist/migrations/patch-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-registry.d.ts","sourceRoot":"","sources":["../../src/migrations/patch-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,eAAO,MAAM,qBAAqB,uCAAuC,CAAC;AAE1E,eAAO,MAAM,kBAAkB,qTAO9B,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW1G"}

package/dist/migrations/patch-registry.js

@@ -0,0 +1,18 @@
+export const PATCH_REGISTRY_FQNAME = "public.primebrick_database_patches";
+export const PATCH_REGISTRY_DDL = `CREATE TABLE IF NOT EXISTS public.primebrick_database_patches (
+  patch_id text PRIMARY KEY,
+  content_sha256 text NOT NULL,
+  applied_at timestamptz NOT NULL DEFAULT now()
+);
+CREATE INDEX IF NOT EXISTS primebrick_database_patches_sha_idx
+  ON public.primebrick_database_patches (content_sha256);
+`;
+export async function isPatchBodyAlreadyRecorded(db, contentSha256) {
+    const reg = await db.query(`SELECT to_regclass('${PATCH_REGISTRY_FQNAME}')::text AS oid`);
+    const oid = reg.rows[0]?.oid;
+    if (!oid || oid === "")
+        return false;
+    const hit = await db.query(`SELECT 1 FROM ${PATCH_REGISTRY_FQNAME} WHERE content_sha256 = $1 LIMIT 1`, [contentSha256]);
+    return hit.rows.length > 0;
+}
+//# sourceMappingURL=patch-registry.js.map

package/dist/migrations/patch-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-registry.js","sourceRoot":"","sources":["../../src/migrations/patch-registry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG,oCAAoC,CAAC;AAE1E,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;CAOjC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,EAAgB,EAAE,aAAqB;IACtF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,KAAK,CACxB,uBAAuB,qBAAqB,iBAAiB,CAC9D,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IAC7B,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,KAAK,CACxB,iBAAiB,qBAAqB,oCAAoC,EAC1E,CAAC,aAAa,CAAC,CAChB,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/nats/nats-client.d.ts

@@ -0,0 +1,17 @@
+import { type NatsConnection, type JetStreamClient } from "nats";
+/**
+ * Singleton NATS connection manager. Extracted from emailsender's
+ * nats/client.ts:1-31.
+ *
+ * Requires `nats` as a peer dependency — consumers that don't need NATS
+ * can skip installing it and won't import this module.
+ * No DB dependency.
+ */
+export declare class NatsClient {
+    private static nc;
+    private static js;
+    static getConnection(): Promise<NatsConnection>;
+    static getJetStream(): JetStreamClient;
+    static close(): Promise<void>;
+}
+//# sourceMappingURL=nats-client.d.ts.map

package/dist/nats/nats-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-client.d.ts","sourceRoot":"","sources":["../../src/nats/nats-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,MAAM,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,EAAE,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAgC;WAEpC,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IASrD,MAAM,CAAC,YAAY,IAAI,eAAe;WAOzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQpC"}

package/dist/nats/nats-client.js

@@ -0,0 +1,37 @@
+import { connect } from "nats";
+/**
+ * Singleton NATS connection manager. Extracted from emailsender's
+ * nats/client.ts:1-31.
+ *
+ * Requires `nats` as a peer dependency — consumers that don't need NATS
+ * can skip installing it and won't import this module.
+ * No DB dependency.
+ */
+export class NatsClient {
+    static nc = null;
+    static js = null;
+    static async getConnection() {
+        if (NatsClient.nc)
+            return NatsClient.nc;
+        const natsUrl = process.env.NATS_URL || "nats://127.0.0.1:4222";
+        NatsClient.nc = await connect({ servers: natsUrl });
+        NatsClient.js = NatsClient.nc.jetstream();
+        console.log(`Connected to NATS at ${natsUrl}`);
+        return NatsClient.nc;
+    }
+    static getJetStream() {
+        if (!NatsClient.js) {
+            throw new Error("NATS JetStream not initialized. Call NatsClient.getConnection() first.");
+        }
+        return NatsClient.js;
+    }
+    static async close() {
+        if (NatsClient.nc) {
+            await NatsClient.nc.close();
+            NatsClient.nc = null;
+            NatsClient.js = null;
+            console.log("NATS connection closed");
+        }
+    }
+}
+//# sourceMappingURL=nats-client.js.map

package/dist/nats/nats-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-client.js","sourceRoot":"","sources":["../../src/nats/nats-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA6C,MAAM,MAAM,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IACb,MAAM,CAAC,EAAE,GAA0B,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,GAA2B,IAAI,CAAC;IAEjD,MAAM,CAAC,KAAK,CAAC,aAAa;QACxB,IAAI,UAAU,CAAC,EAAE;YAAE,OAAO,UAAU,CAAC,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,uBAAuB,CAAC;QAChE,UAAU,CAAC,EAAE,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACpD,UAAU,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QAC/C,OAAO,UAAU,CAAC,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,KAAK;QAChB,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAC5B,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC;YACrB,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACxC,CAAC;IACH,CAAC"}

package/dist/ports/config-repository-port.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Port interface for reading config rows from a DB config table.
+ *
+ * The SDK's ConfigLoader depends on this port, NOT on any specific DAL.
+ * The consumer provides an adapter implementation using their DAL
+ * (e.g. @primebrick/dal-pg's dal.findAll, or a raw SQL query).
+ */
+export interface ConfigRepositoryPort {
+    /**
+     * Return all config rows as { key, value } pairs.
+     * value is null when the config key exists but has no value set.
+     */
+    findAll(): Promise<Array<{
+        key: string;
+        value: string | null;
+    }>>;
+}
+//# sourceMappingURL=config-repository-port.d.ts.map

package/dist/ports/config-repository-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-repository-port.d.ts","sourceRoot":"","sources":["../../src/ports/config-repository-port.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;CAClE"}

package/dist/ports/config-repository-port.js

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

package/dist/ports/config-repository-port.js.map

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

package/dist/ports/database-port.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Port interface for executing parameterized SQL queries.
+ *
+ * The SDK's migration runner (applyPatches) depends on this port,
+ * NOT on pg.Pool. The consumer provides an adapter that wraps their
+ * DB driver (pg.Pool, mssql.ConnectionPool, mariadb.Pool, etc.).
+ *
+ * The contract mirrors the minimal `query(text, params?)` shape that
+ * every SQL DB driver exposes.
+ */
+export interface DatabasePort {
+    /**
+     * Execute a SQL statement. Returns rows (empty for non-SELECT statements).
+     * Used by the migration runner for BEGIN/COMMIT/ROLLBACK and patch SQL.
+     */
+    query<T = unknown>(text: string, params?: unknown[]): Promise<{
+        rows: T[];
+    }>;
+}
+//# sourceMappingURL=database-port.d.ts.map

package/dist/ports/database-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-port.d.ts","sourceRoot":"","sources":["../../src/ports/database-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9E"}

package/dist/ports/database-port.js

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

package/dist/ports/database-port.js.map

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

package/dist/ports/health-check-port.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Port interface for a DB health check (connectivity ping).
+ *
+ * The SDK's HealthCheck depends on this port, NOT on pg.Pool.
+ * The consumer provides an adapter that runs whatever their DB uses
+ * (e.g. `SELECT 1` for PG, `SELECT 1` for MSSQL, etc.).
+ */
+export interface HealthCheckPort {
+    /** Returns true if the DB is reachable and responsive. */
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=health-check-port.d.ts.map

package/dist/ports/health-check-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-port.d.ts","sourceRoot":"","sources":["../../src/ports/health-check-port.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B"}

package/dist/ports/health-check-port.js

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

package/dist/ports/health-check-port.js.map

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

package/dist/ports/service-registry-port.d.ts

@@ -0,0 +1,17 @@
+import type { IServiceRegistry } from "../service/service-registry.js";
+/**
+ * Port interface for CRUD operations on the service_registry table.
+ *
+ * The SDK's ServiceRegistrar depends on this port, NOT on any specific DAL.
+ * The consumer provides an adapter implementation using their DAL
+ * (e.g. @primebrick/dal-pg's dal.find/dal.add/dal.update).
+ */
+export interface ServiceRegistryPort<T = IServiceRegistry> {
+    /** Find a service registry row by its code. Returns null if not found. */
+    findByCode(code: string): Promise<T | null>;
+    /** Insert a new service registry row. */
+    insert(row: T): Promise<void>;
+    /** Update an existing service registry row by code. */
+    updateByCode(code: string, row: Partial<T>): Promise<void>;
+}
+//# sourceMappingURL=service-registry-port.d.ts.map

package/dist/ports/service-registry-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry-port.d.ts","sourceRoot":"","sources":["../../src/ports/service-registry-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,gBAAgB;IACvD,0EAA0E;IAC1E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE5C,yCAAyC;IACzC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,uDAAuD;IACvD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D"}

package/dist/ports/service-registry-port.js

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

package/dist/ports/service-registry-port.js.map

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

package/dist/service/service-registrar.d.ts

@@ -0,0 +1,27 @@
+import type { ServiceRegistryPort } from "../ports/service-registry-port.js";
+export interface ServiceRegistrarConfig {
+    serviceCode: string;
+    baseUrl: string;
+    endpoints: Record<string, unknown>;
+    heartbeatIntervalMs?: number;
+}
+/**
+ * Registers a microservice in `service_registry` and maintains
+ * a heartbeat. Extracted from emailsender's ServiceRegistration
+ * (service-registration.ts:1-101).
+ *
+ * DB-agnostic: depends on ServiceRegistryPort, NOT on getDal() or
+ * @primebrick/dal-pg. The consumer provides an adapter that implements
+ * ServiceRegistryPort using their DAL.
+ */
+export declare class ServiceRegistrar {
+    private readonly repo;
+    private readonly config;
+    private heartbeatTimer;
+    constructor(repo: ServiceRegistryPort, config: ServiceRegistrarConfig);
+    register(): Promise<void>;
+    updateHeartbeat(): Promise<void>;
+    startHeartbeat(): ReturnType<typeof setInterval>;
+    stopHeartbeat(): void;
+}
+//# sourceMappingURL=service-registrar.d.ts.map

package/dist/service/service-registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registrar.d.ts","sourceRoot":"","sources":["../../src/service/service-registrar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAG7E,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,cAAc,CAA+C;gBAGlD,IAAI,EAAE,mBAAmB,EAC1C,MAAM,EAAE,sBAAsB;IAQ1B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBzB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtC,cAAc,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC;IAKhD,aAAa,IAAI,IAAI;CAMtB"}

package/dist/service/service-registrar.js

@@ -0,0 +1,61 @@
+/**
+ * Registers a microservice in `service_registry` and maintains
+ * a heartbeat. Extracted from emailsender's ServiceRegistration
+ * (service-registration.ts:1-101).
+ *
+ * DB-agnostic: depends on ServiceRegistryPort, NOT on getDal() or
+ * @primebrick/dal-pg. The consumer provides an adapter that implements
+ * ServiceRegistryPort using their DAL.
+ */
+export class ServiceRegistrar {
+    repo;
+    config;
+    heartbeatTimer = null;
+    constructor(repo, config) {
+        this.repo = repo;
+        this.config = {
+            heartbeatIntervalMs: 60000,
+            ...config,
+        };
+    }
+    async register() {
+        const existing = await this.repo.findByCode(this.config.serviceCode);
+        if (existing) {
+            await this.repo.updateByCode(this.config.serviceCode, {
+                code: this.config.serviceCode,
+                base_url: this.config.baseUrl,
+                endpoints: this.config.endpoints,
+            });
+            console.log(`Updated service registration: ${this.config.serviceCode}`);
+        }
+        else {
+            await this.repo.insert({
+                code: this.config.serviceCode,
+                base_url: this.config.baseUrl,
+                endpoints: this.config.endpoints,
+            });
+            console.log(`Registered new service: ${this.config.serviceCode}`);
+        }
+    }
+    async updateHeartbeat() {
+        try {
+            await this.repo.updateByCode(this.config.serviceCode, {
+                base_url: this.config.baseUrl,
+            });
+        }
+        catch (error) {
+            console.error("Error updating heartbeat:", error);
+        }
+    }
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(() => this.updateHeartbeat(), this.config.heartbeatIntervalMs);
+        return this.heartbeatTimer;
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=service-registrar.js.map

package/dist/service/service-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registrar.js","sourceRoot":"","sources":["../../src/service/service-registrar.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAKR;IAJF,MAAM,CAAyB;IACxC,cAAc,GAA0C,IAAI,CAAC;IAErE,YACmB,IAAyB,EAC1C,MAA8B;QADb,SAAI,GAAJ,IAAI,CAAqB;QAG1C,IAAI,CAAC,MAAM,GAAG;YACZ,mBAAmB,EAAE,KAAK;YAC1B,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAErE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;gBACpD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAC7B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;aACjC,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBACrB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAC7B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;aACjC,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;gBACpD,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;aAC9B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACjG,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;CACF"}

package/dist/service/service-registry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shape of a row in the `service_registry` table.
+ *
+ * Self-contained interface — NO decorators, NO IAuditableEntity.
+ * The SDK is DB-agnostic; the consumer keeps their own decorated
+ * entity class (e.g. ServiceRegistryEntity with @Entity/@Column from
+ * @primebrick/dal-pg) and maps it to/from this interface in their adapter.
+ *
+ * Previously duplicated in emailsender (service_registry_entity.ts:1-54)
+ * and BE (service_registry_entity.ts:1-42). Now the shared shape lives here.
+ */
+export interface IServiceRegistry {
+    code: string;
+    base_url: string;
+    endpoints: Record<string, unknown>;
+}
+//# sourceMappingURL=service-registry.d.ts.map

package/dist/service/service-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry.d.ts","sourceRoot":"","sources":["../../src/service/service-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/service/service-registry.js

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

package/dist/service/service-registry.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@primebrick/sdk",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "Shared microservice infrastructure for Primebrick v3 — config loading, migration runner, service registration, graceful shutdown, NATS client, health checks, env validation. DB-agnostic via port interfaces.",
+  "license": "MIT",
+  "author": "Michael Sogos",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/michaelsogos/primebrick-v3-sdk"
+  },
+  "homepage": "https://github.com/michaelsogos/primebrick-v3-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/michaelsogos/primebrick-v3-sdk/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" }
+  },
+  "files": ["dist/"],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "nats": "^2.28.1"
+  },
+  "peerDependenciesMeta": {
+    "nats": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.4",
+    "nats": "^2.28.1",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.0"
+  },
+  "packageManager": "pnpm@9.15.9"
+}