@dereekb/dbx-cli 13.42.0 → 14.0.0

package/lint-cache/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@dereekb/dbx-cli-lint-cache",
-  "version": "13.42.0",
+  "version": "14.0.0",
   "private": true,
   "type": "module",
   "devDependencies": {
     "@types/yargs": "^17.0.35",
-    "eslint": "10.4.0"
+    "eslint": "10.9.1"
   },
   "peerDependencies": {
-    "@dereekb/util": "13.42.0",
+    "@dereekb/util": "14.0.0",
     "yargs": "^18.0.0"
   }
 }

package/manifest-extract/index.esm.js

@@ -9,9 +9,7 @@ function _define_property$1(obj, key, value) {
             configurable: true,
             writable: true
         });
-    } else {
-        obj[key] = value;
-    }
+    } else obj[key] = value;
     return obj;
 }
 function _object_spread$1(target) {
@@ -39,9 +37,8 @@ function ownKeys$1(object, enumerableOnly) {
 }
 function _object_spread_props$1(target, source) {
     source = source != null ? source : {};
-    if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-    } else {
+    if (Object.getOwnPropertyDescriptors) Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    else {
         ownKeys$1(Object(source)).forEach(function(key) {
             Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
         });
@@ -652,9 +649,7 @@ function _define_property(obj, key, value) {
             configurable: true,
             writable: true
         });
-    } else {
-        obj[key] = value;
-    }
+    } else obj[key] = value;
     return obj;
 }
 function _object_spread(target) {
@@ -682,9 +677,8 @@ function ownKeys(object, enumerableOnly) {
 }
 function _object_spread_props(target, source) {
     source = source != null ? source : {};
-    if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-    } else {
+    if (Object.getOwnPropertyDescriptors) Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    else {
         ownKeys(Object(source)).forEach(function(key) {
             Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
         });

package/manifest-extract/package.json

@@ -1,18 +1,17 @@
 {
   "name": "@dereekb/dbx-cli/manifest-extract",
-  "version": "13.42.0",
+  "version": "14.0.0",
   "type": "module",
   "sideEffects": false,
   "peerDependencies": {
-    "@dereekb/date": "13.15.0",
-    "@dereekb/dbx-cli": "13.42.0",
-    "@dereekb/firebase": "13.15.0",
-    "@dereekb/model": "13.15.0",
-    "@dereekb/nestjs": "13.15.0",
-    "@dereekb/rxjs": "13.15.0",
-    "@dereekb/util": "13.15.0",
-    "@dereekb/util-fetch": "13.15.0",
-    "ts-morph": "^21.0.0"
+    "@dereekb/date": "14.0.0",
+    "@dereekb/dbx-cli": "14.0.0",
+    "@dereekb/firebase": "14.0.0",
+    "@dereekb/model": "14.0.0",
+    "@dereekb/nestjs": "14.0.0",
+    "@dereekb/rxjs": "14.0.0",
+    "@dereekb/util": "14.0.0",
+    "ts-morph": "^28.0.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/model-test/index.esm.js

@@ -11,11 +11,8 @@ function asyncGeneratorStep$3(gen, resolve, reject, _next, _throw, key, arg) {
         reject(error);
         return;
     }
-    if (info.done) {
-        resolve(value);
-    } else {
-        Promise.resolve(value).then(_next, _throw);
-    }
+    if (info.done) resolve(value);
+    else Promise.resolve(value).then(_next, _throw);
 }
 function _async_to_generator$3(fn) {
     return function() {
@@ -2353,11 +2350,8 @@ function asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, key, arg) {
         reject(error);
         return;
     }
-    if (info.done) {
-        resolve(value);
-    } else {
-        Promise.resolve(value).then(_next, _throw);
-    }
+    if (info.done) resolve(value);
+    else Promise.resolve(value).then(_next, _throw);
 }
 function _async_to_generator$2(fn) {
     return function() {
@@ -2517,11 +2511,8 @@ function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
         reject(error);
         return;
     }
-    if (info.done) {
-        resolve(value);
-    } else {
-        Promise.resolve(value).then(_next, _throw);
-    }
+    if (info.done) resolve(value);
+    else Promise.resolve(value).then(_next, _throw);
 }
 function _async_to_generator$1(fn) {
     return function() {
@@ -2722,7 +2713,9 @@ function _array_without_holes$4(arr) {
     if (Array.isArray(arr)) return _array_like_to_array$4(arr);
 }
 function _iterable_to_array$4(iter) {
-    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) {
+        return Array.from(iter);
+    }
 }
 function _iterable_to_array_limit$2(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
@@ -2749,10 +2742,10 @@ function _iterable_to_array_limit$2(arr, i) {
     return _arr;
 }
 function _non_iterable_rest$2() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _non_iterable_spread$4() {
-    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _sliced_to_array$2(arr, i) {
     return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$4(arr, i) || _non_iterable_rest$2();
@@ -2979,11 +2972,8 @@ function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
         reject(error);
         return;
     }
-    if (info.done) {
-        resolve(value);
-    } else {
-        Promise.resolve(value).then(_next, _throw);
-    }
+    if (info.done) resolve(value);
+    else Promise.resolve(value).then(_next, _throw);
 }
 function _async_to_generator(fn) {
     return function() {
@@ -3001,22 +2991,16 @@ function _async_to_generator(fn) {
     };
 }
 function _iterable_to_array$3(iter) {
-    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) {
+        return Array.from(iter);
+    }
 }
 function _non_iterable_spread$3() {
-    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _to_consumable_array$3(arr) {
     return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$3(arr) || _non_iterable_spread$3();
 }
-function _unsupported_iterable_to_array$3(o, minLen) {
-    if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$3(o, minLen);
-    var n = Object.prototype.toString.call(o).slice(8, -1);
-    if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
-}
 function _ts_generator(thisArg, body) {
     var f, y, t, _ = {
         label: 0,
@@ -3118,18 +3102,32 @@ function _ts_generator(thisArg, body) {
 }
 function _ts_values(o) {
     var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m) return m.call(o);
-    if (o && typeof o.length === "number") return {
-        next: function() {
-            if (o && i >= o.length) o = void 0;
-            return {
-                value: o && o[i++],
-                done: !o
-            };
-        }
-    };
+    if (m) {
+        return m.call(o);
+    }
+    if (o && typeof o.length === "number") {
+        return {
+            next: function() {
+                if (o && i >= o.length) {
+                    o = void 0;
+                }
+                return {
+                    value: o && o[i++],
+                    done: !o
+                };
+            }
+        };
+    }
     throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
 }
+function _unsupported_iterable_to_array$3(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$3(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
+}
 /**
  * Finds the existing spec hotspots that reference a model's fixture (or its
  * parents), or the default files to create when there are none.
@@ -3615,13 +3613,13 @@ function _define_property$1(obj, key, value) {
             configurable: true,
             writable: true
         });
-    } else {
-        obj[key] = value;
-    }
+    } else obj[key] = value;
     return obj;
 }
 function _iterable_to_array$2(iter) {
-    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) {
+        return Array.from(iter);
+    }
 }
 function _iterable_to_array_limit$1(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
@@ -3648,10 +3646,10 @@ function _iterable_to_array_limit$1(arr, i) {
     return _arr;
 }
 function _non_iterable_rest$1() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _non_iterable_spread$2() {
-    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$1(target) {
     for(var i = 1; i < arguments.length; i++){
@@ -3678,9 +3676,8 @@ function ownKeys$1(object, enumerableOnly) {
 }
 function _object_spread_props$1(target, source) {
     source = source != null ? source : {};
-    if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-    } else {
+    if (Object.getOwnPropertyDescriptors) Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    else {
         ownKeys$1(Object(source)).forEach(function(key) {
             Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
         });
@@ -4027,13 +4024,13 @@ function _define_property(obj, key, value) {
             configurable: true,
             writable: true
         });
-    } else {
-        obj[key] = value;
-    }
+    } else obj[key] = value;
     return obj;
 }
 function _iterable_to_array$1(iter) {
-    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) {
+        return Array.from(iter);
+    }
 }
 function _iterable_to_array_limit(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
@@ -4060,10 +4057,10 @@ function _iterable_to_array_limit(arr, i) {
     return _arr;
 }
 function _non_iterable_rest() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _non_iterable_spread$1() {
-    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread(target) {
     for(var i = 1; i < arguments.length; i++){
@@ -4090,9 +4087,8 @@ function ownKeys(object, enumerableOnly) {
 }
 function _object_spread_props(target, source) {
     source = source != null ? source : {};
-    if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-    } else {
+    if (Object.getOwnPropertyDescriptors) Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    else {
         ownKeys(Object(source)).forEach(function(key) {
             Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
         });
@@ -5440,10 +5436,12 @@ function _array_without_holes(arr) {
     if (Array.isArray(arr)) return _array_like_to_array(arr);
 }
 function _iterable_to_array(iter) {
-    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) {
+        return Array.from(iter);
+    }
 }
 function _non_iterable_spread() {
-    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _to_consumable_array(arr) {
     return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();

package/model-test/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dereekb/dbx-cli/model-test",
-  "version": "13.42.0",
+  "version": "14.0.0",
   "type": "module",
   "sideEffects": false,
   "peerDependencies": {
-    "@dereekb/util": "13.42.0",
-    "ts-morph": "^21.0.0"
+    "@dereekb/util": "14.0.0",
+    "ts-morph": "^28.0.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli",
-  "version": "13.42.0",
+  "version": "14.0.0",
   "type": "module",
   "sideEffects": false,
   "bin": {
@@ -66,24 +66,24 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/date": "13.42.0",
-    "@dereekb/firebase": "13.42.0",
-    "@dereekb/model": "13.42.0",
-    "@dereekb/nestjs": "13.42.0",
-    "@dereekb/util": "13.42.0",
-    "@nestjs/common": "^11.1.19",
+    "@dereekb/date": "14.0.0",
+    "@dereekb/firebase": "14.0.0",
+    "@dereekb/model": "14.0.0",
+    "@dereekb/nestjs": "14.0.0",
+    "@dereekb/util": "14.0.0",
+    "@nestjs/common": "^12.0.1",
     "arktype": "^2.2.0",
-    "firebase": "^12.12.1",
-    "jiti": "2.6.1",
-    "prettier": "3.8.3",
-    "ts-morph": "^21.0.0",
-    "vitest": "4.1.5",
+    "firebase": "^12.18.0",
+    "jiti": "2.7.0",
+    "prettier": "3.9.6",
+    "ts-morph": "^28.0.0",
+    "vitest": "4.1.11",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@angular/core": "21.2.11",
+    "@angular/core": "22.1.4",
     "@types/yargs": "^17.0.35",
-    "eslint": "10.4.0"
+    "eslint": "10.9.1"
   },
   "module": "./index.esm.js",
   "main": "./index.esm.js",

package/route/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/dbx-cli/route",
-  "version": "13.42.0",
+  "version": "14.0.0",
   "type": "module",
   "sideEffects": false,
   "peerDependencies": {
-    "@dereekb/date": "13.42.0",
-    "@dereekb/dbx-cli": "13.42.0",
-    "@dereekb/firebase": "13.42.0",
-    "@dereekb/model": "13.42.0",
-    "@dereekb/nestjs": "13.42.0",
-    "@dereekb/util": "13.42.0"
+    "@dereekb/date": "14.0.0",
+    "@dereekb/dbx-cli": "14.0.0",
+    "@dereekb/firebase": "14.0.0",
+    "@dereekb/model": "14.0.0",
+    "@dereekb/nestjs": "14.0.0",
+    "@dereekb/util": "14.0.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/src/lib/doctor/build-drift.check.d.ts

@@ -0,0 +1,21 @@
+import { type InspectCliBuildDriftInput } from '../runner/build-stamp';
+import { type DoctorCheck } from './doctor.command.factory';
+/**
+ * Name reported by the check {@link createCliBuildDriftDoctorCheck} builds.
+ */
+export declare const BUILD_DRIFT_DOCTOR_CHECK_NAME = "cli-build-not-stale";
+/**
+ * Builds the doctor check that compares the running artifact against the `@dereekb/*` tree resolved
+ * at run time.
+ *
+ * Runs FIRST in the default check list, ahead of every network hop, because a stale artifact
+ * invalidates the answers those hops give: they exercise the framework that is loaded now, not the
+ * one the bundle was compiled against, so a green `token-refresh-round-trip` next to a red read is
+ * exactly the misleading report this check exists to pre-empt.
+ *
+ * @param input - Optional overrides forwarded to {@link inspectCliBuildDrift}; apps normally pass only
+ *   `manifestGeneratorVersion`.
+ * @returns The {@link DoctorCheck}.
+ * @__NO_SIDE_EFFECTS__
+ */
+export declare function createCliBuildDriftDoctorCheck(input?: InspectCliBuildDriftInput): DoctorCheck;

package/src/lib/doctor/doctor.command.factory.d.ts

@@ -16,11 +16,24 @@ export interface DoctorCheckResult {
 }
 export type DoctorCheck = (input: DoctorCheckInput) => Promise<DoctorCheckResult>;
 /**
- * Built-in checks: config file present, active env resolved, OIDC discovery, token refresh, API reachability.
+ * Input for {@link defaultDoctorChecks}.
+ */
+export interface DefaultDoctorChecksInput {
+    /**
+     * The `@dereekb/dbx-cli` version that emitted the app's generated manifests
+     * (`<NAMESPACE>_STAMP.generatorVersion`). Forwarded to the build-drift check so a manifest produced
+     * by a different generator than the one running it is flagged.
+     */
+    readonly manifestGeneratorVersion?: Maybe<string>;
+}
+/**
+ * Built-in checks: build not stale, config file present, active env resolved, OIDC discovery, token
+ * refresh, API reachability.
  *
+ * @param input - Optional configuration for the built-in checks.
  * @returns The default {@link DoctorCheck} list, in execution order.
  */
-export declare function defaultDoctorChecks(): DoctorCheck[];
+export declare function defaultDoctorChecks(input?: DefaultDoctorChecksInput): DoctorCheck[];
 export interface CreateDoctorCommandInput {
     readonly cliName: string;
     /**
@@ -32,6 +45,11 @@ export interface CreateDoctorCommandInput {
      * doctor can run against an env that only stores overrides on top of a registered default.
      */
     readonly defaultEnvs?: readonly CliEnvDefault[];
+    /**
+     * The generator version stamped into the app's generated manifests, forwarded to the built-in
+     * build-drift check.
+     */
+    readonly manifestGeneratorVersion?: Maybe<string>;
 }
 /**
  * Composable doctor command.
@@ -43,6 +61,7 @@ export interface CreateDoctorCommandInput {
  * @param input.cliName - The CLI's binary name.
  * @param input.checks - Additional checks to append after the default check list.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
+ * @param input.manifestGeneratorVersion - The generator version stamped into the app's generated manifests.
  * @returns A yargs `CommandModule` exposing the `doctor` command.
  * @__NO_SIDE_EFFECTS__
  */

package/src/lib/doctor/firestore-session.check.d.ts

@@ -120,7 +120,13 @@ export declare function buildFirestoreSessionDoctorReadRouting(input: {
  * 3. `GET /session/firestore` is reachable and mints a custom token (+ an App Check token when the
  *    API is configured with a web `appId`);
  * 4. `signInWithCustomToken` succeeds against the configured project;
- * 5. the app-supplied {@link FirestoreSessionDoctorProbe} performs one rules-protected read.
+ * 5. the session's Firestore handle is one the loaded client SDK accepts (`inspectCliFirestoreSdkIdentity`),
+ *    reported as `stage: 'firestore-sdk-identity'`. Sits between the sign-in and the read because it
+ *    is the hop whose failure otherwise MASQUERADES as the read's: the handshake returns a uid, and
+ *    the read then dies on the SDK's `Expected first argument to collection() to be …` — a message
+ *    that names neither the model nor the handle, and sends the operator to rules and App Check
+ *    instead of to a duplicated SDK or a stale artifact;
+ * 6. the app-supplied {@link FirestoreSessionDoctorProbe} performs one rules-protected read.
  *
  * Doctor checks run PRE-AUTH — `DoctorCheckInput` is only `{ cliName, envName, env, config }`, with no
  * token and no `CliContext` — so this loads credentials itself via `buildCliPaths` +

package/src/lib/doctor/index.d.ts

@@ -1,2 +1,3 @@
+export * from './build-drift.check';
 export * from './doctor.command.factory';
 export * from './firestore-session.check';