@cogenta/core 0.4.0 → 0.7.0

package/dist/version.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Reads the `version` field of the `package.json` that sits at `packageRoot`
+ * — self-describing, not looked up through `node_modules` resolution or
+ * copied into a generated constant at build time.
+ *
+ * `packageRoot` is meant to be computed once, at each caller's own top level,
+ * as `new URL('../', import.meta.url)` from a module that sits exactly one
+ * directory below its package's root — which is true of `src/version.ts`
+ * here, of `src/index.ts` in `@cogenta/cli`, and of any future caller that
+ * keeps the same `rootDir: "./src"` / `outDir: "./dist"` layout every
+ * `tsconfig.json` in this monorepo already uses (`src/foo.ts` compiles to
+ * `dist/foo.js`, one level below the package root either way — in dev, under
+ * `vitest`, `import.meta.url` still points at the `.ts` file in `src/`, so
+ * the same relative path resolves there too).
+ *
+ * Deliberately synchronous and local: an installed package always carries
+ * its own `package.json` (npm never excludes it, regardless of `"files"`),
+ * so reading a package's own version never needs the network the way
+ * checking npm for a *newer* one does (`@cogenta/cli`'s `update` module).
+ */
+export declare function readOwnPackageVersion(packageRoot: URL): string;
+/**
+ * `@cogenta/core`'s own installed version — see `readOwnPackageVersion`.
+ *
+ * **Deliberately lazy, never a top-level constant.** `@cogenta/core` is the
+ * one package nearly everything in this monorepo imports, including, via
+ * `import type` re-exports, packages that end up loaded inside a bundler or
+ * a browser-like test environment (`@cogenta/admin`'s Vitest+jsdom suite
+ * really does execute this module's top level — confirmed by a real crash
+ * while building this: `import.meta.url` there is not a `file://` URL,
+ * `fileURLToPath` throws, and merely *importing* `@cogenta/core` broke
+ * every admin test that happened to pull it in transitively). A function
+ * that only touches the filesystem when actually called — and only ever
+ * is, in this codebase, from Node-only call sites (`@cogenta/cli`) — costs
+ * nothing at import time in any environment, cached after the first real
+ * call.
+ */
+export declare function getCoreVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,GAAG,GAAG,MAAM,CAsC9D;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC"}

package/dist/version.js

@@ -0,0 +1,84 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { CogentaError } from './errors/cogenta-error.js';
+/**
+ * Reads the `version` field of the `package.json` that sits at `packageRoot`
+ * — self-describing, not looked up through `node_modules` resolution or
+ * copied into a generated constant at build time.
+ *
+ * `packageRoot` is meant to be computed once, at each caller's own top level,
+ * as `new URL('../', import.meta.url)` from a module that sits exactly one
+ * directory below its package's root — which is true of `src/version.ts`
+ * here, of `src/index.ts` in `@cogenta/cli`, and of any future caller that
+ * keeps the same `rootDir: "./src"` / `outDir: "./dist"` layout every
+ * `tsconfig.json` in this monorepo already uses (`src/foo.ts` compiles to
+ * `dist/foo.js`, one level below the package root either way — in dev, under
+ * `vitest`, `import.meta.url` still points at the `.ts` file in `src/`, so
+ * the same relative path resolves there too).
+ *
+ * Deliberately synchronous and local: an installed package always carries
+ * its own `package.json` (npm never excludes it, regardless of `"files"`),
+ * so reading a package's own version never needs the network the way
+ * checking npm for a *newer* one does (`@cogenta/cli`'s `update` module).
+ */
+export function readOwnPackageVersion(packageRoot) {
+    const path = fileURLToPath(new URL('package.json', packageRoot));
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch (error) {
+        throw new CogentaError({
+            code: 'PACKAGE_VERSION_UNREADABLE',
+            message: `Could not read ${path} to determine this package's own version.`,
+            hint: 'This indicates a broken install — an installed package always ships its own package.json.',
+            cause: error,
+            details: { path },
+        });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new CogentaError({
+            code: 'PACKAGE_VERSION_UNREADABLE',
+            message: `${path} is not valid JSON.`,
+            hint: 'This indicates a corrupted install.',
+            cause: error,
+            details: { path },
+        });
+    }
+    const version = parsed.version;
+    if (typeof version !== 'string' || version === '') {
+        throw new CogentaError({
+            code: 'PACKAGE_VERSION_UNREADABLE',
+            message: `${path} has no valid "version" field.`,
+            hint: 'This indicates a corrupted package.json.',
+            details: { path },
+        });
+    }
+    return version;
+}
+let cachedCoreVersion;
+/**
+ * `@cogenta/core`'s own installed version — see `readOwnPackageVersion`.
+ *
+ * **Deliberately lazy, never a top-level constant.** `@cogenta/core` is the
+ * one package nearly everything in this monorepo imports, including, via
+ * `import type` re-exports, packages that end up loaded inside a bundler or
+ * a browser-like test environment (`@cogenta/admin`'s Vitest+jsdom suite
+ * really does execute this module's top level — confirmed by a real crash
+ * while building this: `import.meta.url` there is not a `file://` URL,
+ * `fileURLToPath` throws, and merely *importing* `@cogenta/core` broke
+ * every admin test that happened to pull it in transitively). A function
+ * that only touches the filesystem when actually called — and only ever
+ * is, in this codebase, from Node-only call sites (`@cogenta/cli`) — costs
+ * nothing at import time in any environment, cached after the first real
+ * call.
+ */
+export function getCoreVersion() {
+    cachedCoreVersion ??= readOwnPackageVersion(new URL('../', import.meta.url));
+    return cachedCoreVersion;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAgB;IACpD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAA;IAChE,IAAI,GAAW,CAAA;IACf,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,kBAAkB,IAAI,2CAA2C;YAC1E,IAAI,EAAE,2FAA2F;YACjG,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,EAAE,IAAI,EAAE;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,GAAG,IAAI,qBAAqB;YACrC,IAAI,EAAE,qCAAqC;YAC3C,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,EAAE,IAAI,EAAE;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,OAAO,GAAI,MAAgC,CAAC,OAAO,CAAA;IACzD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,GAAG,IAAI,gCAAgC;YAChD,IAAI,EAAE,0CAA0C;YAChD,OAAO,EAAE,EAAE,IAAI,EAAE;SAClB,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,IAAI,iBAAqC,CAAA;AAEzC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc;IAC5B,iBAAiB,KAAK,qBAAqB,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC5E,OAAO,iBAAiB,CAAA;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogenta/core",
-  "version": "0.4.0",
+  "version": "0.7.0",
   "description": "Configuration, typed errors, structured logging and the driver system behind Cogenta.",
   "license": "MPL-2.0",
   "type": "module",
@@ -12,7 +12,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.11.0"