grm-shared-library 1.1.191 → 1.1.193

package/dist/types/modules/system-user/utils/system-user.util.d.ts

@@ -0,0 +1,41 @@
+import { SystemUserEnvSource } from '../interfaces/system-user-env-source';
+export interface ResolveSystemUserIdOptions {
+    /**
+     * Deprecated keys to fall back to, in order, when the canonical key is
+     * unset. Defaults to {@link LEGACY_SYSTEM_USER_ID_ENV_KEYS}; pass `[]` to
+     * disable legacy support entirely.
+     */
+    legacyKeys?: readonly string[];
+    /**
+     * Value to return when nothing resolves, instead of throwing. Use only
+     * where a missing system user must not stop the process from booting.
+     */
+    fallback?: number;
+    /**
+     * Invoked once per legacy-key hit so the service can surface the
+     * deprecation in its own logger.
+     */
+    onLegacyKeyUsed?: (key: string) => void;
+}
+/**
+ * Parses a raw environment value into a usable user id.
+ *
+ * Returns `null` for anything that is not a positive integer — including
+ * `'0'`, `'-1'`, `'abc'` and the empty string — so that a typo'd ConfigMap
+ * entry surfaces as a clear failure rather than silently stamping user `0`
+ * onto production records.
+ */
+export declare function parseSystemUserId(raw: unknown): number | null;
+/**
+ * Resolves the platform system user id from the environment.
+ *
+ * Precedence: {@link SYSTEM_USER_ID_ENV_KEY} → each legacy key in order →
+ * `options.fallback`. Throws when nothing resolves and no fallback is given,
+ * which is the intended behaviour at startup: a service that stamps records
+ * with the system user should refuse to boot rather than write a wrong id.
+ *
+ * @example
+ * // In a Nest provider that already injects ConfigService:
+ * this.systemUserId = resolveSystemUserId(this.configService);
+ */
+export declare function resolveSystemUserId(source: SystemUserEnvSource, options?: ResolveSystemUserIdOptions): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grm-shared-library",
-  "version": "1.1.191",
+  "version": "1.1.193",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -57,7 +57,8 @@
     "grm-shared-library": "^1.1.101",
     "libphonenumber-js": "^1.13.8",
     "rxjs": "^7.8.2",
-    "swagger-ui-express": "^5.0.1"
+    "swagger-ui-express": "^5.0.1",
+    "@nestjs/config": "^4.0.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",
@@ -65,6 +66,7 @@
     "@nestjs/microservices": "^11.0.0",
     "@sentry/node": "^8.0.0",
     "class-transformer": "^0.5.0",
-    "class-validator": "^0.14.0"
+    "class-validator": "^0.14.0",
+    "@nestjs/config": "^4.0.0"
   }
 }