@primebrick/sdk 0.1.0 → 0.1.1

package/LICENSE

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

@@ -1,21 +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
+# @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/migrations/patch-registry.js

@@ -1,11 +1,11 @@
 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 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`);

package/package.json

@@ -1,47 +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"
-}
+{
+  "name": "@primebrick/sdk",
+  "version": "0.1.1",
+  "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"
+}