@dereekb/firebase-server 13.12.2 → 13.12.3

package/mcp/package.json

@@ -1,20 +1,21 @@
 {
   "name": "@dereekb/firebase-server/mcp",
-  "version": "13.12.2",
+  "version": "13.12.3",
   "peerDependencies": {
-    "@dereekb/analytics": "13.12.2",
-    "@dereekb/date": "13.12.2",
-    "@dereekb/firebase": "13.12.2",
-    "@dereekb/firebase-server": "13.12.2",
-    "@dereekb/firebase-server/oidc": "13.12.2",
-    "@dereekb/model": "13.12.2",
-    "@dereekb/nestjs": "13.12.2",
-    "@dereekb/rxjs": "13.12.2",
-    "@dereekb/util": "13.12.2",
-    "@dereekb/zoho": "13.12.2",
+    "@dereekb/analytics": "13.12.3",
+    "@dereekb/date": "13.12.3",
+    "@dereekb/firebase": "13.12.3",
+    "@dereekb/firebase-server": "13.12.3",
+    "@dereekb/firebase-server/oidc": "13.12.3",
+    "@dereekb/model": "13.12.3",
+    "@dereekb/nestjs": "13.12.3",
+    "@dereekb/rxjs": "13.12.3",
+    "@dereekb/util": "13.12.3",
+    "@dereekb/zoho": "13.12.3",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/core": "^11.1.19",
+    "arktype": "^2.2.0",
     "express": "^5.2.1",
     "firebase-admin": "^13.8.0"
   },

package/mcp/src/lib/service/tools/mcp.tool.model-info.d.ts

@@ -14,6 +14,15 @@ export declare const MODEL_INFO_DISPATCH_CALL = "info";
  * apps avoiding collisions should not register a real model literally named "model".
  */
 export declare const MODEL_INFO_DISPATCH_MODEL_TYPE = "model";
+/**
+ * Group label applied to manifest entries that declare no `modelGroup`. Keeps the `groups` mode
+ * total reconcilable with the catalog size (sum of group counts always equals `totalModels`).
+ */
+export declare const MODEL_INFO_UNGROUPED_LABEL = "(ungrouped)";
+/**
+ * Hint string surfaced alongside the default `groups` response so callers know how to drill in.
+ */
+export declare const MODEL_INFO_GROUPS_HINT = "Pass `model` for one/many models, `modelGroup` for a group, or `all:true` for the full catalog.";
 /**
  * Constructor dependencies for {@link createModelInfoTool}.
  */
@@ -25,13 +34,43 @@ export interface CreateModelInfoToolDeps {
     readonly manifest: readonly McpManifestModelEntry[];
 }
 /**
- * Shape of the `model-info` tool input. Omit `model` to list every model in the manifest.
+ * Public shape of the `model-info` tool input. Every field is optional; the combination selects
+ * the response mode (see {@link createModelInfoTool}).
  */
 export interface ModelInfoToolInput {
-    readonly model?: string;
+    /**
+     * One model (string) or many (string array), each matched by `modelType`, `identityConst`, or
+     * `collectionPrefix`. A string yields `mode: 'single'`; an array yields `mode: 'multiple'`.
+     */
+    readonly model?: string | ReadonlyArray<string>;
+    /**
+     * Returns the summary list of models in this group (`mode: 'list'`). Matched case-insensitively.
+     */
+    readonly modelGroup?: string;
+    /**
+     * Opt in to the full catalog summary (every model). Never the default.
+     */
+    readonly all?: boolean;
+    /**
+     * Forces (`true`) or suppresses (`false`) full persisted-field detail in `list` / `multiple`
+     * modes. Defaults to summary rows for `list`, full entries for `single` / `multiple`.
+     */
+    readonly fields?: boolean;
 }
 /**
- * Summary row returned in list mode.
+ * Normalized form of {@link ModelInfoToolInput} produced by {@link parseModelInfoInput}. The
+ * `model` arg is collapsed to a query array plus a flag recording whether it arrived as an array
+ * (which drives `single` vs `multiple` mode).
+ */
+export interface ParsedModelInfoInput {
+    readonly modelQueries?: ReadonlyArray<string>;
+    readonly modelIsArray: boolean;
+    readonly modelGroup?: string;
+    readonly all: boolean;
+    readonly fields?: boolean;
+}
+/**
+ * Summary row returned in list/group modes and (when `fields: false`) in single/multiple modes.
  */
 export interface ModelInfoSummaryRow {
     readonly modelType: string;
@@ -47,22 +86,63 @@ export interface ModelInfoSummaryRow {
     readonly serviceFactoryExport?: string;
 }
 /**
- * Output payload for the `model-info` tool. `mode === 'list'` carries `models[]`;
- * `mode === 'single'` carries the full `model` entry.
+ * One row in a model-bearing response: either a compact {@link ModelInfoSummaryRow} or the full
+ * {@link McpManifestModelEntry} (including persisted `fields`). The `fields` toggle and the active
+ * mode decide which form is emitted.
+ */
+export type ModelInfoModelRow = ModelInfoSummaryRow | McpManifestModelEntry;
+/**
+ * One model group and the number of models it contains. Returned in the default `groups` mode.
+ */
+export interface ModelInfoGroupCount {
+    readonly modelGroup: string;
+    readonly modelCount: number;
+}
+/**
+ * A model query that matched nothing. Mirrors `model-get`'s per-key `{ key, message }` error shape
+ * with `query` standing in for `key`.
+ */
+export interface ModelInfoNotFound {
+    readonly query: string;
+    readonly message: string;
+}
+/**
+ * Output payload for the `model-info` tool. The `mode` field discriminates the variant:
+ * - `groups`: model groups + counts (the default, no-arg response).
+ * - `list`: a summary (or, with `fields: true`, full) list — used by `modelGroup` and `all`.
+ * - `single`: full detail for one `model` string.
+ * - `multiple`: full detail per match for a `model` array, with misses in `notFound`.
  */
 export type ModelInfoToolOutput = {
+    readonly mode: 'groups';
+    readonly groups: ReadonlyArray<ModelInfoGroupCount>;
+    readonly totalModels: number;
+    readonly hint: string;
+} | {
     readonly mode: 'list';
-    readonly models: ReadonlyArray<ModelInfoSummaryRow>;
+    readonly models: ReadonlyArray<ModelInfoModelRow>;
+    readonly modelGroup?: string;
 } | {
     readonly mode: 'single';
-    readonly model: McpManifestModelEntry;
+    readonly model: ModelInfoModelRow;
+} | {
+    readonly mode: 'multiple';
+    readonly models: ReadonlyArray<ModelInfoModelRow>;
+    readonly notFound?: ReadonlyArray<ModelInfoNotFound>;
 };
 /**
  * Builds the built-in `model-info` MCP tool definition.
  *
- * Mirrors dbx-cli's `model-info [model]` command:
- * - Without a `model` arg: returns a summary list (modelType, modelName, prefix, group, identity, field count).
- * - With a `model` arg: matches by `modelType`, `identityConst`, or `collectionPrefix` and returns the full entry.
+ * Modes (selected by input):
+ * - No args: returns model groups + counts (`mode: 'groups'`) — the cheap default for browsing.
+ * - `model` (string): returns the full entry for one model (`mode: 'single'`).
+ * - `model` (string array): returns full detail per match (`mode: 'multiple'`); misses land in `notFound`.
+ * - `modelGroup`: returns the summary list of that group's models (`mode: 'list'`).
+ * - `all: true`: returns the full catalog summary (`mode: 'list'`).
+ * - `fields`: forces (`true`) or suppresses (`false`) full persisted-field detail in list/multiple modes.
+ *
+ * Each `model` query matches by `modelType`, `identityConst`, or `collectionPrefix`. When several
+ * params are supplied, precedence is `model` > `modelGroup` > `all` > the default `groups` view.
  *
  * Output is delivered as both stringified JSON in `content[0].text` and `structuredContent`
  * so MCP clients can consume either form.

package/model/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/model",
-  "version": "13.12.2",
+  "version": "13.12.3",
   "peerDependencies": {
-    "@dereekb/analytics": "13.12.2",
-    "@dereekb/date": "13.12.2",
-    "@dereekb/firebase": "13.12.2",
-    "@dereekb/firebase-server": "13.12.2",
-    "@dereekb/model": "13.12.2",
-    "@dereekb/nestjs": "13.12.2",
-    "@dereekb/rxjs": "13.12.2",
-    "@dereekb/util": "13.12.2",
+    "@dereekb/analytics": "13.12.3",
+    "@dereekb/date": "13.12.3",
+    "@dereekb/firebase": "13.12.3",
+    "@dereekb/firebase-server": "13.12.3",
+    "@dereekb/model": "13.12.3",
+    "@dereekb/nestjs": "13.12.3",
+    "@dereekb/rxjs": "13.12.3",
+    "@dereekb/util": "13.12.3",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "archiver": "^7.0.1",

package/oidc/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@dereekb/firebase-server/oidc",
-  "version": "13.12.2",
+  "version": "13.12.3",
   "peerDependencies": {
-    "@dereekb/analytics": "13.12.2",
-    "@dereekb/date": "13.12.2",
-    "@dereekb/firebase": "13.12.2",
-    "@dereekb/firebase-server": "13.12.2",
-    "@dereekb/model": "13.12.2",
-    "@dereekb/nestjs": "13.12.2",
-    "@dereekb/rxjs": "13.12.2",
-    "@dereekb/util": "13.12.2",
-    "@dereekb/zoho": "13.12.2",
+    "@dereekb/analytics": "13.12.3",
+    "@dereekb/date": "13.12.3",
+    "@dereekb/firebase": "13.12.3",
+    "@dereekb/firebase-server": "13.12.3",
+    "@dereekb/model": "13.12.3",
+    "@dereekb/nestjs": "13.12.3",
+    "@dereekb/rxjs": "13.12.3",
+    "@dereekb/util": "13.12.3",
+    "@dereekb/zoho": "13.12.3",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase-server",
-  "version": "13.12.2",
+  "version": "13.12.3",
   "sideEffects": false,
   "exports": {
     "./test": {
@@ -56,17 +56,19 @@
   "main": "./index.cjs.js",
   "types": "./src/index.d.ts",
   "peerDependencies": {
-    "@dereekb/analytics": "13.12.2",
-    "@dereekb/date": "13.12.2",
-    "@dereekb/dbx-core": "13.12.2",
-    "@dereekb/firebase": "13.12.2",
-    "@dereekb/model": "13.12.2",
-    "@dereekb/nestjs": "13.12.2",
-    "@dereekb/rxjs": "13.12.2",
-    "@dereekb/util": "13.12.2",
-    "@dereekb/zoho": "13.12.2",
+    "@cantoo/pdf-lib": "^2.6.5",
+    "@dereekb/analytics": "13.12.3",
+    "@dereekb/date": "13.12.3",
+    "@dereekb/dbx-core": "13.12.3",
+    "@dereekb/firebase": "13.12.3",
+    "@dereekb/model": "13.12.3",
+    "@dereekb/nestjs": "13.12.3",
+    "@dereekb/rxjs": "13.12.3",
+    "@dereekb/util": "13.12.3",
+    "@dereekb/zoho": "13.12.3",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
+    "@modelcontextprotocol/sdk": "1.29.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "@nestjs/core": "^11.1.19",
@@ -84,6 +86,7 @@
     "nanoid": "^5.1.9",
     "oidc-provider": "^9.8.2",
     "rxjs": "^7.8.2",
+    "sharp": "0.34.5",
     "supertest": "^7.2.2",
     "ts-essentials": "^10.2.0"
   },

package/src/lib/env/env.service.d.ts

@@ -18,11 +18,11 @@ export declare abstract class FirebaseServerEnvService {
      */
     abstract readonly isTestingEnv: boolean;
     /**
-     * Whether the server is running in production.
+     * Whether the server is running in production mode. (This may be true in both prod or a staging running as production).
      */
     abstract readonly isProduction: boolean;
     /**
-     * Whether the server is running in a staging environment.
+     * Whether the server is running in a staging environment. isProduction is also typically true when this is true.
      */
     abstract readonly isStaging: boolean;
     /**

package/test/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@dereekb/firebase-server/test",
-  "version": "13.12.2",
+  "version": "13.12.3",
   "peerDependencies": {
-    "@dereekb/analytics": "13.12.2",
-    "@dereekb/date": "13.12.2",
-    "@dereekb/firebase": "13.12.2",
-    "@dereekb/firebase-server": "13.12.2",
-    "@dereekb/firebase-server/oidc": "13.12.2",
-    "@dereekb/model": "13.12.2",
-    "@dereekb/nestjs": "13.12.2",
-    "@dereekb/rxjs": "13.12.2",
-    "@dereekb/util": "13.12.2",
+    "@dereekb/analytics": "13.12.3",
+    "@dereekb/date": "13.12.3",
+    "@dereekb/firebase": "13.12.3",
+    "@dereekb/firebase-server": "13.12.3",
+    "@dereekb/firebase-server/oidc": "13.12.3",
+    "@dereekb/model": "13.12.3",
+    "@dereekb/nestjs": "13.12.3",
+    "@dereekb/rxjs": "13.12.3",
+    "@dereekb/util": "13.12.3",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.19",
@@ -23,7 +23,7 @@
     "supertest": "^7.2.2"
   },
   "devDependencies": {
-    "@dereekb/nestjs": "13.12.2"
+    "@dereekb/nestjs": "13.12.3"
   },
   "exports": {
     "./package.json": "./package.json",

package/twilio/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@dereekb/firebase-server/twilio",
-  "version": "13.12.2",
+  "version": "13.12.3",
   "peerDependencies": {
-    "@dereekb/date": "13.12.2",
-    "@dereekb/firebase": "13.12.2",
-    "@dereekb/firebase-server": "13.12.2",
-    "@dereekb/model": "13.12.2",
-    "@dereekb/nestjs": "13.12.2",
-    "@dereekb/rxjs": "13.12.2",
-    "@dereekb/util": "13.12.2"
+    "@dereekb/date": "13.12.3",
+    "@dereekb/firebase": "13.12.3",
+    "@dereekb/firebase-server": "13.12.3",
+    "@dereekb/model": "13.12.3",
+    "@dereekb/nestjs": "13.12.3",
+    "@dereekb/rxjs": "13.12.3",
+    "@dereekb/util": "13.12.3"
   },
   "exports": {
     "./package.json": "./package.json",

package/zoho/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/zoho",
-  "version": "13.12.2",
+  "version": "13.12.3",
   "peerDependencies": {
-    "@dereekb/analytics": "13.12.2",
-    "@dereekb/date": "13.12.2",
-    "@dereekb/model": "13.12.2",
-    "@dereekb/nestjs": "13.12.2",
-    "@dereekb/rxjs": "13.12.2",
-    "@dereekb/firebase": "13.12.2",
-    "@dereekb/util": "13.12.2",
-    "@dereekb/zoho": "13.12.2"
+    "@dereekb/analytics": "13.12.3",
+    "@dereekb/date": "13.12.3",
+    "@dereekb/model": "13.12.3",
+    "@dereekb/nestjs": "13.12.3",
+    "@dereekb/rxjs": "13.12.3",
+    "@dereekb/firebase": "13.12.3",
+    "@dereekb/util": "13.12.3",
+    "@dereekb/zoho": "13.12.3"
   },
   "exports": {
     "./package.json": "./package.json",