@dereekb/dbx-cli 13.18.0 → 13.20.0

package/lint-cache/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli-lint-cache",
-  "version": "13.18.0",
+  "version": "13.20.0",
   "private": true,
   "type": "module",
   "devDependencies": {
@@ -8,7 +8,7 @@
     "eslint": "10.4.0"
   },
   "peerDependencies": {
-    "@dereekb/util": "13.18.0",
+    "@dereekb/util": "13.20.0",
     "yargs": "^18.0.0"
   }
 }

package/manifest-extract/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dereekb/dbx-cli/manifest-extract",
-  "version": "13.18.0",
+  "version": "13.20.0",
   "sideEffects": false,
   "peerDependencies": {
     "@dereekb/date": "13.15.0",
-    "@dereekb/dbx-cli": "13.18.0",
+    "@dereekb/dbx-cli": "13.20.0",
     "@dereekb/firebase": "13.15.0",
     "@dereekb/model": "13.15.0",
     "@dereekb/nestjs": "13.15.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli",
-  "version": "13.18.0",
+  "version": "13.20.0",
   "type": "module",
   "sideEffects": false,
   "bin": {
@@ -44,6 +44,12 @@
       "import": "./model-test/index.cjs.mjs",
       "default": "./model-test/index.cjs.js"
     },
+    "./route": {
+      "module": "./route/index.esm.js",
+      "types": "./route/index.d.ts",
+      "import": "./route/index.esm.js",
+      "default": "./route/index.cjs.js"
+    },
     "./test": {
       "module": "./test/index.esm.js",
       "types": "./test/index.d.ts",
@@ -60,11 +66,11 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/date": "13.18.0",
-    "@dereekb/firebase": "13.18.0",
-    "@dereekb/model": "13.18.0",
-    "@dereekb/nestjs": "13.18.0",
-    "@dereekb/util": "13.18.0",
+    "@dereekb/date": "13.20.0",
+    "@dereekb/firebase": "13.20.0",
+    "@dereekb/model": "13.20.0",
+    "@dereekb/nestjs": "13.20.0",
+    "@dereekb/util": "13.20.0",
     "@nestjs/common": "^11.1.19",
     "arktype": "^2.2.0",
     "jiti": "2.6.1",

package/route/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hapier Creative LLC.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/route/index.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./index.cjs.js').default;

package/route/index.cjs.js

@@ -0,0 +1,18 @@
+'use strict';
+
+var dbxCli = require('@dereekb/dbx-cli');
+
+
+
+Object.defineProperty(exports, "ROUTE_MANIFEST_VERSION", {
+	enumerable: true,
+	get: function () { return dbxCli.ROUTE_MANIFEST_VERSION; }
+});
+Object.defineProperty(exports, "buildRouteManifest", {
+	enumerable: true,
+	get: function () { return dbxCli.buildRouteManifest; }
+});
+Object.defineProperty(exports, "parseRouteModelTag", {
+	enumerable: true,
+	get: function () { return dbxCli.parseRouteModelTag; }
+});

package/route/index.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './index.cjs.js';
+export { _default as default } from './index.cjs.default.js';

package/route/index.d.ts

@@ -0,0 +1 @@
+export * from "./src/index";

package/route/index.esm.js

@@ -0,0 +1 @@
+export { ROUTE_MANIFEST_VERSION, buildRouteManifest, parseRouteModelTag } from '@dereekb/dbx-cli';

package/route/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@dereekb/dbx-cli/route",
+  "version": "13.20.0",
+  "sideEffects": false,
+  "peerDependencies": {
+    "@dereekb/date": "13.20.0",
+    "@dereekb/dbx-cli": "13.20.0",
+    "@dereekb/firebase": "13.20.0",
+    "@dereekb/model": "13.20.0",
+    "@dereekb/nestjs": "13.20.0",
+    "@dereekb/util": "13.20.0"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "module": "./index.esm.js",
+      "types": "./index.d.ts",
+      "import": "./index.cjs.mjs",
+      "default": "./index.cjs.js"
+    }
+  },
+  "module": "./index.esm.js",
+  "main": "./index.cjs.js",
+  "types": "./index.d.ts"
+}

package/route/src/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Focused `@dereekb/dbx-cli/route` namespace: re-exports just the route-manifest
+ * public API (builder, tag parser, version, and the diagnostic / model types) so
+ * a downstream can unit-test its `@dbxRouteModel*` tags without pulling the full
+ * `@dereekb/dbx-cli` CLI surface (ts-morph scanners, mcp-scan, validators, …).
+ *
+ * `external: 'all'` keeps this a thin re-export shim — the root module graph is
+ * still loaded at runtime; the win is import-surface ergonomics, not weight.
+ */
+export { buildRouteManifest, parseRouteModelTag, ROUTE_MANIFEST_VERSION } from '@dereekb/dbx-cli';
+export type { ParsedRouteModel, RouteModelKind, RouteManifest, RouteManifestStateEntry, RouteManifestModelEntry, RouteManifestWarning, RouteManifestWarningKind, RouteManifestSeverity, RouteSource } from '@dereekb/dbx-cli';

package/src/lib/route/route-manifest.d.ts

@@ -20,7 +20,7 @@ import type { RouteSource } from './route-types.js';
  * manifests whose `version` does not match. Mirror in firebase-server/mcp's
  * `ROUTE_MANIFEST_VERSION` — bump both together.
  */
-export declare const ROUTE_MANIFEST_VERSION: 1;
+export declare const ROUTE_MANIFEST_VERSION: 2;
 /**
  * One model an app page renders, after tag parsing + inheritance flattening.
  */

package/src/lib/route/route-model-tag.d.ts

@@ -14,6 +14,13 @@
  *   promoted to `<collectionName>/<id>` at runtime via the model identity).
  * - `gb/:id/gbe/{authUid}` — alternating literal / placeholder segments (even
  *   count) → `kind: 'key'` (a full FirestoreModelKey for a subcollection model).
+ *   An odd (id) segment may also be a `{const:<id>}` token for a fixed/singleton
+ *   id (e.g. `wk/:uid/wkn/{const:0}`); it is normalized to the bare literal in
+ *   the parsed `keyTemplate` so the runtime emits it verbatim, while a forgotten
+ *   `:` (a bare `note`) still fails as malformed.
+ * - `{flatKey:<param>}` — single token → `kind: 'flatKey'`: the `<param>` URL
+ *   value IS a whole two-way-flat FirestoreModelKey (`r_<id>_cs_<id>_d_<id>`),
+ *   un-flattened at runtime. For pages that pack a full key into one URL segment.
  * - (absent, list tag) → `kind: 'list'`.
  *
  * This module is deliberately runtime-dependency-free (no ts-morph): the same
@@ -23,10 +30,10 @@
  * `./route-models-extract.ts` and re-exports these symbols for existing importers.
  */
 /**
- * Whether a route-model entry resolves to a promoted id, a full key, or a
- * keyless list.
+ * Whether a route-model entry resolves to a promoted id, a full key, a
+ * single-param flattened key, or a keyless list.
  */
-export type RouteModelKind = 'id' | 'key' | 'list';
+export type RouteModelKind = 'id' | 'key' | 'flatKey' | 'list';
 /**
  * A successfully parsed `@dbxRouteModel*` tag.
  */

package/src/lib/route/url-match.d.ts

@@ -60,6 +60,18 @@ export interface MatchUrlAgainstEntriesInput<T> {
  * @returns The normalized pathname.
  */
 export declare function normalizePathname(pathname: string): string;
+/**
+ * Strips a UIRouter query string (`?…`) and/or hash (`#…`) suffix off a URL or
+ * URL pattern, keeping only the path portion. Mirrors the runtime
+ * `parseUrlModelsPathname` normalization (`firebase-server/mcp`) so build-time
+ * param extraction and runtime matching agree: a state url like
+ * `/:schoolJob?slotIndex` reduces to `/:schoolJob` rather than leaking the
+ * `?slotIndex` query param into the last path segment.
+ *
+ * @param url - The URL or composed URL pattern to normalize.
+ * @returns The url with any `?…` / `#…` suffix removed.
+ */
+export declare function stripUrlQueryAndHash(url: string): string;
 /**
  * Splits a path into its non-empty segments (the leading slash is dropped).
  *

package/test/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/dbx-cli/test",
-  "version": "13.18.0",
+  "version": "13.20.0",
   "peerDependencies": {
-    "@dereekb/date": "13.18.0",
-    "@dereekb/dbx-cli": "13.18.0",
-    "@dereekb/firebase": "13.18.0",
-    "@dereekb/firebase-server/test": "13.18.0",
-    "@dereekb/model": "13.18.0",
-    "@dereekb/nestjs": "13.18.0",
-    "@dereekb/rxjs": "13.18.0",
-    "@dereekb/util": "13.18.0",
+    "@dereekb/date": "13.20.0",
+    "@dereekb/dbx-cli": "13.20.0",
+    "@dereekb/firebase": "13.20.0",
+    "@dereekb/firebase-server/test": "13.20.0",
+    "@dereekb/model": "13.20.0",
+    "@dereekb/nestjs": "13.20.0",
+    "@dereekb/rxjs": "13.20.0",
+    "@dereekb/util": "13.20.0",
     "@nestjs/common": "^11.1.19",
     "arktype": "^2.2.0",
     "vitest": "4.1.5",

package/eslint/rollup.alias-internal.config.d.ts

@@ -1,11 +0,0 @@
-/**
- * @param config - The rollup config @nx/rollup hands to the hook.
- * @param _options - The @nx/rollup options (unused).
- * @returns The mutated rollup config.
- *
- * @nx /rollup `rollupConfig` hook that inlines the workspace's internal `@dereekb/*` imports into
- * the published ESLint plugin bundle. Prepends an alias plugin redirecting {@link INTERNAL_ALIASES}
- * to their TS sources and wraps the `external: "all"` callback so {@link BUNDLED_DEPENDENCIES} are
- * treated as internal.
- */
-export default function applyInternalAliases(config: any, _options: any): Promise<any>;