core-services-sdk 1.3.74 → 1.3.75

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-services-sdk",
-  "version": "1.3.74",
+  "version": "1.3.75",
   "main": "src/index.js",
   "type": "module",
   "types": "types/index.d.ts",

package/src/index.js

@@ -11,3 +11,5 @@ export * from './templates/index.js'
 export * from './util/index.js'
 export * from './instant-messages/index.js'
 export * from './postgresql/index.js'
+export * from './env/env-validation.js'
+export * from './json/load-json.js'

package/src/json/load-json.js

@@ -0,0 +1,15 @@
+import fs from 'node:fs'
+
+/**
+ * Loads and parses a JSON file relative to a module URL.
+ *
+ * @param {string|URL} moduleUrl
+ * @param {string} relativePath
+ * @returns {any}
+ */
+export function loadJson(moduleUrl, relativePath) {
+  const fileUrl = new URL(relativePath, moduleUrl)
+  const raw = fs.readFileSync(fileUrl, 'utf8')
+
+  return JSON.parse(raw)
+}

package/tests/json/fixtures/invalid.json

@@ -0,0 +1,2 @@
+{
+    "foo": "bar"

package/tests/json/fixtures/valid.json

@@ -0,0 +1,4 @@
+{
+  "foo": "bar",
+  "answer": 42
+}

package/tests/json/load-json.test.js

@@ -0,0 +1,37 @@
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { describe, it, expect } from 'vitest'
+
+import { loadJson } from '../../src/json/load-json.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+describe('loadJson', () => {
+  it('loads and parses a JSON file relative to module URL', () => {
+    const moduleUrl = new URL(`file://${__dirname}/dummy.js`)
+
+    const result = loadJson(moduleUrl, './fixtures/valid.json')
+
+    expect(result).toEqual({
+      foo: 'bar',
+      answer: 42,
+    })
+  })
+
+  it('throws if file does not exist', () => {
+    const moduleUrl = new URL(`file://${__dirname}/dummy.js`)
+
+    expect(() => {
+      loadJson(moduleUrl, './fixtures/missing.json')
+    }).toThrow()
+  })
+
+  it('throws if JSON is invalid', () => {
+    const moduleUrl = new URL(`file://${__dirname}/dummy.js`)
+
+    expect(() => {
+      loadJson(moduleUrl, './fixtures/invalid.json')
+    }).toThrow(SyntaxError)
+  })
+})

package/types/index.d.ts

@@ -11,3 +11,5 @@ export * from './templates/index.js'
 export * from './util/index.js'
 export * from './instant-messages/index.js'
 export * from './postgresql/index.js'
+export * from './env/env-validation.js'
+export * from './json/load-json.js'

package/types/json/load-json.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Loads and parses a JSON file relative to a module URL.
+ *
+ * @param {string|URL} moduleUrl
+ * @param {string} relativePath
+ * @returns {any}
+ */
+export function loadJson(moduleUrl: string | URL, relativePath: string): any