@thenewlabs/entangle-utils 2.11.1 → 2.11.2

package/dist/version.d.ts

@@ -1,4 +1,10 @@
-export declare const VERSION = "2.11.1";
-export declare const BUILD_TIME: string;
-export declare function getVersionInfo(): string;
+/**
+ * The CALLING package's version. Pass the entry module's `import.meta.url`; the manifest is
+ * expected one level up (`src/index.ts` and `dist/index.js` both sit directly under the package
+ * root). Returns 'unknown' rather than throwing — a binary that cannot find its manifest should
+ * still start, just visibly unversioned.
+ */
+export declare function packageVersion(entryModuleUrl: string): string;
+/** Human-facing version string for banners and `--version`: `v<package version>`. */
+export declare function getVersionInfo(entryModuleUrl: string): string;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC;AAChC,eAAO,MAAM,UAAU,QAA2B,CAAC;AAEnD,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAU7D;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/version.js

@@ -1,6 +1,40 @@
-export const VERSION = '2.11.1';
-export const BUILD_TIME = new Date().toISOString();
-export function getVersionInfo() {
-    return `v${VERSION} (built: ${BUILD_TIME})`;
+/**
+ * Per-package version reporting with ONE source of truth: the package's own package.json.
+ *
+ * There is deliberately NO version constant in this module. A shared hardcoded string is how
+ * every entangle binary ended up announcing utils' stale version instead of its own (serve
+ * 2.12.0 shipped reporting "v2.11.1"); a drift-guard test can only pin such a constant to
+ * THIS package's manifest, never to the caller's. Instead each CLI entry module calls
+ * `getVersionInfo(import.meta.url)`:
+ *
+ * - workspace / tsc builds: the version is read at runtime from `../package.json` relative to
+ *   the calling entry module — which is that package's OWN manifest for `src/` (tsx dev) and
+ *   `dist/` (tsc output) alike;
+ * - standalone bundles (main/dist/*.js are CJS/IIFE where `import.meta.url` is gone and a
+ *   relative manifest lookup would find the wrong package.json): the bundling script injects
+ *   the right version at build time via esbuild `define` (`ENTANGLE_BUILD_VERSION` — see
+ *   scripts/build-dist.js and locus-server's build.mjs), which wins over the runtime read.
+ */
+import { readFileSync } from 'fs';
+/**
+ * The CALLING package's version. Pass the entry module's `import.meta.url`; the manifest is
+ * expected one level up (`src/index.ts` and `dist/index.js` both sit directly under the package
+ * root). Returns 'unknown' rather than throwing — a binary that cannot find its manifest should
+ * still start, just visibly unversioned.
+ */
+export function packageVersion(entryModuleUrl) {
+    if (typeof ENTANGLE_BUILD_VERSION === 'string')
+        return ENTANGLE_BUILD_VERSION;
+    try {
+        const pkg = JSON.parse(readFileSync(new URL('../package.json', entryModuleUrl), 'utf8'));
+        return typeof pkg.version === 'string' ? pkg.version : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/** Human-facing version string for banners and `--version`: `v<package version>`. */
+export function getVersionInfo(entryModuleUrl) {
+    return `v${packageVersion(entryModuleUrl)}`;
 }
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAChC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAEnD,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,OAAO,YAAY,UAAU,GAAG,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAMlC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,cAAsB;IACnD,IAAI,OAAO,sBAAsB,KAAK,QAAQ;QAAE,OAAO,sBAAsB,CAAC;IAC9E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAEtF,CAAC;QACF,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,cAAsB;IACnD,OAAO,IAAI,cAAc,CAAC,cAAc,CAAC,EAAE,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thenewlabs/entangle-utils",
-  "version": "2.11.1",
+  "version": "2.11.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",