@aneuhold/be-ts-lib 3.1.10 → 3.1.12

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## 🔖 [3.1.12] (2026-04-21)
+
+### ✅ Added
+
+- Added `zod` as a direct dependency.
+- `ConfigDefinition` now exports a `ConfigSchema` alongside the `Config` type, with the type inferred from the schema.
+
+### 🏗️ Changed
+
+- `GitHubService.getContentFromRepo` now validates the Octokit response is a string at runtime instead of using an unsafe cast.
+- `ConfigService.useConfig` now validates the parsed JSONC config against `ConfigSchema` (Zod) instead of casting; removed the unused `insertPropertiesIntoEnv` private method.
+- `TranslationService.getTranslations` documents why it does not validate (arbitrary-key JSON) and uses an explicit cast rather than a structural guard that accepts any object.
+
+## 🔖 [3.1.11] (2026-04-17)
+
+### 🏗️ Changed
+
+- Updated dependency on `@aneuhold/core-ts-api-lib` to `^3.0.34`.
+
 ## 🔖 [3.1.10] (2026-04-15)
 
 ### 🏗️ Changed
@@ -295,6 +314,8 @@ No direct code changes; version bump for compatibility with new major versions o
 - Updated workflow permissions to allow repository write access
 
 <!-- Link References -->
+[3.1.12]: https://github.com/aneuhold/ts-libs/compare/be-ts-lib-v3.1.11...be-ts-lib-v3.1.12
+[3.1.11]: https://github.com/aneuhold/ts-libs/compare/be-ts-lib-v3.1.10...be-ts-lib-v3.1.11
 [3.1.10]: https://github.com/aneuhold/ts-libs/compare/be-ts-lib-v3.1.9...be-ts-lib-v3.1.10
 [3.1.9]: https://github.com/aneuhold/ts-libs/compare/be-ts-lib-v3.1.8...be-ts-lib-v3.1.9
 [3.1.8]: https://github.com/aneuhold/ts-libs/compare/be-ts-lib-v3.1.7...be-ts-lib-v3.1.8

package/lib/services/ConfigService/ConfigDefinition.d.ts

@@ -1,18 +1,23 @@
+import { z } from 'zod';
+/**
+ * Zod schema for the environment configuration pulled in for the current
+ * environment from the GitHub repository.
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    someKey: z.ZodString;
+    mongoRootUsername: z.ZodString;
+    mongoRootPassword: z.ZodString;
+    mongoUrl: z.ZodString;
+    jwtAccessSecret: z.ZodString;
+    testUserInfo: z.ZodObject<{
+        userName: z.ZodString;
+        password: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 /**
  * The environment configuration that is pulled in for the current environment
  * from the GitHub repository.
  */
-export default interface Config {
-    someKey: string;
-    mongoRootUsername: string;
-    mongoRootPassword: string;
-    mongoUrl: string;
-    /** Secret used to sign JWT access tokens. */
-    jwtAccessSecret: string;
-    /** Test user credentials for e2e tests. */
-    testUserInfo: {
-        userName: string;
-        password: string;
-    };
-}
+type Config = z.infer<typeof ConfigSchema>;
+export type { Config as default };
 //# sourceMappingURL=ConfigDefinition.d.ts.map

package/lib/services/ConfigService/ConfigDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigDefinition.d.ts","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigDefinition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,MAAM;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,YAAY,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH"}
+{"version":3,"file":"ConfigDefinition.d.ts","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;iBAYvB,CAAC;AAEH;;;GAGG;AACH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE3C,YAAY,EAAE,MAAM,IAAI,OAAO,EAAE,CAAC"}

package/lib/services/ConfigService/ConfigDefinition.js

@@ -1,2 +1,19 @@
-export {};
+import { z } from 'zod';
+/**
+ * Zod schema for the environment configuration pulled in for the current
+ * environment from the GitHub repository.
+ */
+export const ConfigSchema = z.object({
+    someKey: z.string(),
+    mongoRootUsername: z.string(),
+    mongoRootPassword: z.string(),
+    mongoUrl: z.string(),
+    /** Secret used to sign JWT access tokens. */
+    jwtAccessSecret: z.string(),
+    /** Test user credentials for e2e tests. */
+    testUserInfo: z.object({
+        userName: z.string(),
+        password: z.string()
+    })
+});
 //# sourceMappingURL=ConfigDefinition.js.map

package/lib/services/ConfigService/ConfigDefinition.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigDefinition.js","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigDefinition.ts"],"names":[],"mappings":""}
+{"version":3,"file":"ConfigDefinition.js","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,6CAA6C;IAC7C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,2CAA2C;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;CACH,CAAC,CAAC"}

package/lib/services/ConfigService/ConfigDefinition.ts

@@ -1,17 +1,27 @@
+import { z } from 'zod';
+
 /**
- * The environment configuration that is pulled in for the current environment
- * from the GitHub repository.
+ * Zod schema for the environment configuration pulled in for the current
+ * environment from the GitHub repository.
  */
-export default interface Config {
-  someKey: string;
-  mongoRootUsername: string;
-  mongoRootPassword: string;
-  mongoUrl: string;
+export const ConfigSchema = z.object({
+  someKey: z.string(),
+  mongoRootUsername: z.string(),
+  mongoRootPassword: z.string(),
+  mongoUrl: z.string(),
   /** Secret used to sign JWT access tokens. */
-  jwtAccessSecret: string;
+  jwtAccessSecret: z.string(),
   /** Test user credentials for e2e tests. */
-  testUserInfo: {
-    userName: string;
-    password: string;
-  };
-}
+  testUserInfo: z.object({
+    userName: z.string(),
+    password: z.string()
+  })
+});
+
+/**
+ * The environment configuration that is pulled in for the current environment
+ * from the GitHub repository.
+ */
+type Config = z.infer<typeof ConfigSchema>;
+
+export type { Config as default };

package/lib/services/ConfigService/ConfigService.d.ts

@@ -38,13 +38,5 @@ export default class ConfigService {
      * @throws {Error} If the configuration fails to load.
      */
     static useConfig(env: ConfigEnv): Promise<void>;
-    /**
-     * Inserts the provided configuration into the local environment.
-     *
-     * This may not actually need to happen.
-     *
-     * @param config - The configuration object to insert into the environment.
-     */
-    private static insertPropertiesIntoEnv;
 }
 //# sourceMappingURL=ConfigService.d.ts.map

package/lib/services/ConfigService/ConfigService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigService.d.ts","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigService.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAGvB,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAQ;IAEpC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAElD;;;;;;OAMG;IACH,MAAM,KAAK,MAAM,IAAI,MAAM,CAO1B;IAED;;;;OAIG;IACH,MAAM,KAAK,aAAa,IAAI,OAAO,CAElC;IAED;;;;;OAKG;WACU,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;CASvC"}
+{"version":3,"file":"ConfigService.d.ts","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigService.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAGvB,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAGhD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAQ;IAEpC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAElD;;;;;;OAMG;IACH,MAAM,KAAK,MAAM,IAAI,MAAM,CAO1B;IAED;;;;OAIG;IACH,MAAM,KAAK,aAAa,IAAI,OAAO,CAElC;IAED;;;;;OAKG;WACU,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAUtD"}

package/lib/services/ConfigService/ConfigService.js

@@ -2,6 +2,7 @@ import { DR } from '@aneuhold/core-ts-lib';
 import 'dotenv/config';
 import { parse } from 'jsonc-parser';
 import GitHubService from '../GitHubService.js';
+import { ConfigSchema } from './ConfigDefinition.js';
 /**
  * Service for managing configuration settings.
  *
@@ -49,29 +50,12 @@ export default class ConfigService {
         ConfigService.env = env;
         try {
             const jsonString = await GitHubService.getContentFromRepo('config', `${env}.jsonc`);
-            ConfigService.configObject = parse(jsonString);
+            ConfigService.configObject = ConfigSchema.parse(parse(jsonString));
         }
         catch (error) {
-            DR.logger.error(`Failed to load ${env}.json, error: ${error}`);
+            DR.logger.error(`Failed to load ${env}.json, error: ${String(error)}`);
             throw error;
         }
     }
-    /**
-     * Inserts the provided configuration into the local environment.
-     *
-     * This may not actually need to happen.
-     *
-     * @param config - The configuration object to insert into the environment.
-     */
-    static insertPropertiesIntoEnv(config) {
-        Object.entries(config).forEach(([key, value]) => {
-            if (typeof value === 'object') {
-                ConfigService.insertPropertiesIntoEnv(value);
-            }
-            else {
-                process.env[key] = value;
-            }
-        });
-    }
 }
 //# sourceMappingURL=ConfigService.js.map

package/lib/services/ConfigService/ConfigService.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigService.js","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAKhD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;OAEG;IACH,MAAM,CAAC,GAAG,GAAqB,IAAI,CAAC;IAE5B,MAAM,CAAC,YAAY,GAAkB,IAAI,CAAC;IAElD;;;;;;OAMG;IACH,MAAM,KAAK,MAAM;QACf,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,YAAY,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,MAAM,KAAK,aAAa;QACtB,OAAO,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,GAAc;QACnC,aAAa,CAAC,GAAG,GAAG,GAAG,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,kBAAkB,CAAC,QAAQ,EAAE,GAAG,GAAG,QAAQ,CAAC,CAAC;YACpF,aAAa,CAAC,YAAY,GAAG,KAAK,CAAC,UAAU,CAAW,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,iBAAiB,KAAe,EAAE,CAAC,CAAC;YACzE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,uBAAuB,CAAC,MAAc;QACnD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,aAAa,CAAC,uBAAuB,CAAC,KAAe,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAe,CAAC;YACrC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"ConfigService.js","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIrD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;OAEG;IACH,MAAM,CAAC,GAAG,GAAqB,IAAI,CAAC;IAE5B,MAAM,CAAC,YAAY,GAAkB,IAAI,CAAC;IAElD;;;;;;OAMG;IACH,MAAM,KAAK,MAAM;QACf,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,YAAY,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,MAAM,KAAK,aAAa;QACtB,OAAO,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,GAAc;QACnC,aAAa,CAAC,GAAG,GAAG,GAAG,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,kBAAkB,CAAC,QAAQ,EAAE,GAAG,GAAG,QAAQ,CAAC,CAAC;YACpF,aAAa,CAAC,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,iBAAiB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC"}

package/lib/services/ConfigService/ConfigService.ts

@@ -3,6 +3,7 @@ import 'dotenv/config';
 import { parse } from 'jsonc-parser';
 import GitHubService from '../GitHubService.js';
 import type Config from './ConfigDefinition.js';
+import { ConfigSchema } from './ConfigDefinition.js';
 
 export type ConfigEnv = 'local' | 'dev' | 'prod';
 
@@ -59,27 +60,10 @@ export default class ConfigService {
     ConfigService.env = env;
     try {
       const jsonString = await GitHubService.getContentFromRepo('config', `${env}.jsonc`);
-      ConfigService.configObject = parse(jsonString) as Config;
+      ConfigService.configObject = ConfigSchema.parse(parse(jsonString));
     } catch (error) {
-      DR.logger.error(`Failed to load ${env}.json, error: ${error as string}`);
+      DR.logger.error(`Failed to load ${env}.json, error: ${String(error)}`);
       throw error;
     }
   }
-
-  /**
-   * Inserts the provided configuration into the local environment.
-   *
-   * This may not actually need to happen.
-   *
-   * @param config - The configuration object to insert into the environment.
-   */
-  private static insertPropertiesIntoEnv(config: object) {
-    Object.entries(config).forEach(([key, value]) => {
-      if (typeof value === 'object') {
-        ConfigService.insertPropertiesIntoEnv(value as object);
-      } else {
-        process.env[key] = value as string;
-      }
-    });
-  }
 }

package/lib/services/GitHubService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GitHubService.d.ts","sourceRoot":"","sources":["../../src/services/GitHubService.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAGvB,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwB;IAE7C;;;;;;;OAOG;WACU,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBpF;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CAS/B"}
+{"version":3,"file":"GitHubService.d.ts","sourceRoot":"","sources":["../../src/services/GitHubService.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAGvB,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwB;IAE7C;;;;;;;OAOG;WACU,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BpF;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CAS/B"}

package/lib/services/GitHubService.js

@@ -27,10 +27,17 @@ export default class GitHubService {
                 repo: repoName,
                 path: filePath
             });
-            return result.data;
+            // When `mediaType.format === 'raw'`, the Octokit runtime returns the raw
+            // file contents as a string even though the published types don't
+            // narrow to that case. Verify at runtime.
+            const data = result.data;
+            if (typeof data !== 'string') {
+                throw new Error(`Expected raw content from ${repoName}/${filePath} to be a string.`);
+            }
+            return data;
         }
         catch (error) {
-            DR.logger.error(`Failed to load ${filePath} from ${repoName}, error: ${error}`);
+            DR.logger.error(`Failed to load ${filePath} from ${repoName}, error: ${String(error)}`);
             throw error;
         }
     }

package/lib/services/GitHubService.js.map

@@ -1 +1 @@
-{"version":3,"file":"GitHubService.js","sourceRoot":"","sources":["../../src/services/GitHubService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IACxB,MAAM,CAAC,MAAM,GAAmB,IAAI,CAAC;IAE7C;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAgB,EAAE,QAAgB;QAChE,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC1B,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,eAAe,EAAE,CAAC;QACzD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC9D,SAAS,EAAE;oBACT,MAAM,EAAE,KAAK;iBACd;gBACD,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAyB,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,QAAQ,SAAS,QAAQ,YAAY,KAAe,EAAE,CAAC,CAAC;YAC1F,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,eAAe;QAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,IAAI,OAAO,CAAC;YACjB,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"GitHubService.js","sourceRoot":"","sources":["../../src/services/GitHubService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IACxB,MAAM,CAAC,MAAM,GAAmB,IAAI,CAAC;IAE7C;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAgB,EAAE,QAAgB;QAChE,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC1B,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,eAAe,EAAE,CAAC;QACzD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC9D,SAAS,EAAE;oBACT,MAAM,EAAE,KAAK;iBACd;gBACD,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;YACH,yEAAyE;YACzE,kEAAkE;YAClE,0CAA0C;YAC1C,MAAM,IAAI,GAAY,MAAM,CAAC,IAAI,CAAC;YAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,IAAI,QAAQ,kBAAkB,CAAC,CAAC;YACvF,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,QAAQ,SAAS,QAAQ,YAAY,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,eAAe;QAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,IAAI,OAAO,CAAC;YACjB,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;IACL,CAAC"}

package/lib/services/GitHubService.ts

@@ -31,9 +31,16 @@ export default class GitHubService {
         repo: repoName,
         path: filePath
       });
-      return result.data as unknown as string;
+      // When `mediaType.format === 'raw'`, the Octokit runtime returns the raw
+      // file contents as a string even though the published types don't
+      // narrow to that case. Verify at runtime.
+      const data: unknown = result.data;
+      if (typeof data !== 'string') {
+        throw new Error(`Expected raw content from ${repoName}/${filePath} to be a string.`);
+      }
+      return data;
     } catch (error) {
-      DR.logger.error(`Failed to load ${filePath} from ${repoName}, error: ${error as string}`);
+      DR.logger.error(`Failed to load ${filePath} from ${repoName}, error: ${String(error)}`);
       throw error;
     }
   }

package/lib/services/TranslationService/TranslationService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TranslationService.d.ts","sourceRoot":"","sources":["../../../src/services/TranslationService/TranslationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,eAAe,CAAC;AAIvB;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,6CAA6C;IAC7C,SAAS,cAAc;CACxB;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACrC;;;;;OAKG;WACU,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;CAS/E"}
+{"version":3,"file":"TranslationService.d.ts","sourceRoot":"","sources":["../../../src/services/TranslationService/TranslationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,eAAe,CAAC;AAIvB;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,6CAA6C;IAC7C,SAAS,cAAc;CACxB;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACrC;;;;;OAKG;WACU,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;CAa/E"}

package/lib/services/TranslationService/TranslationService.js

@@ -28,10 +28,14 @@ export default class TranslationService {
     static async getTranslations(source) {
         try {
             const jsonString = await GitHubService.getContentFromRepo('translations', `${source}.jsonc`);
+            // The translations file has arbitrary string keys by design (including
+            // `$schema` metadata), so a structural type guard would accept any
+            // object anyway. Trust the source and cast.
+            // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
             return parse(jsonString);
         }
         catch (error) {
-            DR.logger.error(`Failed to load ${source}.json, error: ${error}`);
+            DR.logger.error(`Failed to load ${source}.json, error: ${String(error)}`);
             throw error;
         }
     }

package/lib/services/TranslationService/TranslationService.js.map

@@ -1 +1 @@
-{"version":3,"file":"TranslationService.js","sourceRoot":"","sources":["../../../src/services/TranslationService/TranslationService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,6CAA6C;IAC7C,4CAAuB,CAAA;AACzB,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACrC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAyB;QACpD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,kBAAkB,CAAC,cAAc,EAAE,GAAG,MAAM,QAAQ,CAAC,CAAC;YAC7F,OAAO,KAAK,CAAC,UAAU,CAAiB,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,iBAAiB,KAAe,EAAE,CAAC,CAAC;YAC5E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"TranslationService.js","sourceRoot":"","sources":["../../../src/services/TranslationService/TranslationService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,6CAA6C;IAC7C,4CAAuB,CAAA;AACzB,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACrC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAyB;QACpD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,kBAAkB,CAAC,cAAc,EAAE,GAAG,MAAM,QAAQ,CAAC,CAAC;YAC7F,uEAAuE;YACvE,mEAAmE;YACnE,4CAA4C;YAC5C,yEAAyE;YACzE,OAAO,KAAK,CAAC,UAAU,CAAiB,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,iBAAiB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/lib/services/TranslationService/TranslationService.ts

@@ -30,9 +30,13 @@ export default class TranslationService {
   static async getTranslations(source: TranslationSource): Promise<Translations> {
     try {
       const jsonString = await GitHubService.getContentFromRepo('translations', `${source}.jsonc`);
+      // The translations file has arbitrary string keys by design (including
+      // `$schema` metadata), so a structural type guard would accept any
+      // object anyway. Trust the source and cast.
+      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
       return parse(jsonString) as Translations;
     } catch (error) {
-      DR.logger.error(`Failed to load ${source}.json, error: ${error as string}`);
+      DR.logger.error(`Failed to load ${source}.json, error: ${String(error)}`);
       throw error;
     }
   }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@aneuhold/be-ts-lib",
   "author": "Anton G. Neuhold Jr.",
   "license": "MIT",
-  "version": "3.1.10",
+  "version": "3.1.12",
   "description": "A backend TypeScript library used for common functionality in personal backend projects.",
   "packageManager": "pnpm@10.25.0",
   "type": "module",
@@ -16,7 +16,7 @@
     "check": "tsc --noEmit",
     "test": "vitest run",
     "preparePkg": "tb pkg prepare",
-    "jsr:validate": "tb pkg validateJsr",
+    "jsr:validate": "tb pkg validateJsr --allow-slow-types",
     "npm:validate": "tb pkg validateNpm",
     "versionPropagation:validate": "tsx ../../scripts/validatePackageVersions.ts",
     "checkAll": "pnpm build && pnpm lint && pnpm test && pnpm jsr:validate",
@@ -54,16 +54,17 @@
     "TypeScript"
   ],
   "dependencies": {
-    "@aneuhold/core-ts-api-lib": "^3.0.33",
-    "@aneuhold/core-ts-lib": "^2.4.3",
+    "@aneuhold/core-ts-api-lib": "^3.0.35",
+    "@aneuhold/core-ts-lib": "^2.4.4",
     "dotenv": "^17.2.3",
     "jsonc-parser": "^3.3.1",
     "node-fetch": "^3.3.2",
-    "octokit": "^5.0.5"
+    "octokit": "^5.0.5",
+    "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@aneuhold/local-npm-registry": "^0.2.30",
-    "@aneuhold/main-scripts": "^2.8.3",
+    "@aneuhold/local-npm-registry": "^0.2.31",
+    "@aneuhold/main-scripts": "^2.9.3",
     "@types/node": "^25.0.2",
     "@types/node-fetch": "^2.6.13",
     "eslint": "^9.39.2",
@@ -71,7 +72,7 @@
     "prettier": "^3.7.4",
     "rimraf": "^6.1.2",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.3",
     "vitest": "^4.0.15"
   }
 }