@dasasian/firebase-structured-logger 0.8.0 → 1.0.0

package/dist/shared/versionRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionRange.d.ts","sourceRoot":"","sources":["../../src/shared/versionRange.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAOhF;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGpE"}

package/dist/shared/versionRange.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * The one range shape this package's own `peerDependencies` use: `>=X.Y.Z`.
+ *
+ * Not a general semver comparator — `unsupported-peer` reads ranges from this
+ * package's own `package.json` at runtime rather than copying them into doctor
+ * (so the two cannot drift), and every peer range there is a plain minimum today.
+ * If a future range needs `^` or `||`, this returns `undefined` rather than a
+ * wrong answer, and the caller skips the check instead of guessing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.meetsMinimum = meetsMinimum;
+exports.leadingMajorVersion = leadingMajorVersion;
+const VERSION = /^(\d+)\.(\d+)\.(\d+)/;
+const MINIMUM_RANGE = /^>=\s*(\d+)\.(\d+)\.(\d+)/;
+function parseVersion(version) {
+    const match = VERSION.exec(version);
+    if (!match)
+        return undefined;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function compare(a, b) {
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i])
+            return a[i] - b[i];
+    }
+    return 0;
+}
+/**
+ * Whether `version` meets `range`, or `undefined` when `range` is not a plain
+ * `>=X.Y.Z` minimum — the caller's signal to skip rather than misreport.
+ */
+function meetsMinimum(version, range) {
+    const rangeMatch = MINIMUM_RANGE.exec(range.trim());
+    if (!rangeMatch)
+        return undefined;
+    const minimum = [Number(rangeMatch[1]), Number(rangeMatch[2]), Number(rangeMatch[3])];
+    const parsed = parseVersion(version);
+    if (!parsed)
+        return undefined;
+    return compare(parsed, minimum) >= 0;
+}
+/** The leading major version number in a string like `22.11.0`, `^22`, or `nodejs20`. */
+function leadingMajorVersion(text) {
+    const match = /(\d+)/.exec(text);
+    return match ? Number(match[1]) : undefined;
+}
+//# sourceMappingURL=versionRange.js.map

package/dist/shared/versionRange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionRange.js","sourceRoot":"","sources":["../../src/shared/versionRange.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAsBH,oCAOC;AAGD,kDAGC;AAjCD,MAAM,OAAO,GAAG,sBAAsB,CAAA;AACtC,MAAM,aAAa,GAAG,2BAA2B,CAAA;AAEjD,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED,SAAS,OAAO,CAAC,CAA2B,EAAE,CAA2B;IACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,OAAe,EAAE,KAAa;IACzD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACnD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IACjC,MAAM,OAAO,GAA6B,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/G,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IACpC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED,yFAAyF;AACzF,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChC,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7C,CAAC"}

package/dist/tools/doctor.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `fsl doctor` — checks a project's setup from disk and reports how it will behave.
+ *
+ * Every fact comes from a file with a fixed format: `firebase.json`, `package.json`,
+ * each installed package's own `package.json`, `dist/`, and the embedded `.release`
+ * marker. Nothing
+ * here parses source code or guesses at behavior — a check that cannot read what it
+ * needs reports `could-not-check`, never a pass (see CLAUDE.md, "fsl doctor — facts,
+ * not guesses"). The finding ids, levels, and the `--json` shape are the README's
+ * "Check your setup" section, verbatim; this file exists to make that section true.
+ */
+export type SetupKind = 'firebase' | 'node' | 'browser-only' | 'backend-only';
+export type LoggingPath = 'firebase-functions' | 'stdout' | 'none';
+export type TraceSource = 'trigger' | 'header' | 'none';
+export type StoragePath = 'firebase-admin' | 'google-cloud-storage' | 'none';
+export type FindingLevel = 'error' | 'warning';
+export type FindingId = 'maps-published' | 'node-version' | 'callable-without-firebase-functions' | 'could-not-check' | 'duplicate-storage' | 'unsupported-peer' | 'embedded-maps-without-release';
+export interface DoctorSetup {
+    kind: SetupKind;
+    backend: string | null;
+    dist: string | null;
+    logging: LoggingPath;
+    trace: TraceSource;
+    storage: StoragePath;
+    callable: boolean;
+}
+export interface DoctorFinding {
+    id: FindingId;
+    level: FindingLevel;
+    message: string;
+    fix: string;
+}
+export interface DoctorReport {
+    setup: DoctorSetup;
+    findings: DoctorFinding[];
+    exitCode: number;
+}
+export interface DoctorOptions {
+    projectRoot: string;
+    backend?: string;
+    dist?: string;
+}
+/**
+ * A peer whose supported range cannot be evaluated is `could-not-check`, never a pass:
+ * the ranges are read from this package's own `peerDependencies`, and a range shape
+ * `meetsMinimum` does not understand must surface rather than skip the check.
+ */
+export declare function checkUnsupportedPeers(searchDirs: string[], ownPeerDependencies: Record<string, string>, findings: DoctorFinding[]): void;
+export declare function runDoctor(options: DoctorOptions): DoctorReport;
+/** `report.exitCode` ignores `--strict`; the CLI applies it here. */
+export declare function exitCodeFor(report: DoctorReport, strict: boolean): number;
+/** Renders the human-readable report `fsl doctor` prints without `--json`. */
+export declare function formatDoctorReport(report: DoctorReport): string;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/tools/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/tools/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,cAAc,GAAG,cAAc,CAAA;AAC7E,MAAM,MAAM,WAAW,GAAG,oBAAoB,GAAG,QAAQ,GAAG,MAAM,CAAA;AAClE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AACvD,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,MAAM,CAAA;AAC5E,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,CAAA;AAE9C,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,cAAc,GACd,qCAAqC,GACrC,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,+BAA+B,CAAA;AAEnC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,WAAW,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,SAAS,CAAA;IACb,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAkMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAAE,EACpB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3C,QAAQ,EAAE,aAAa,EAAE,GACxB,IAAI,CAuBN;AA8BD,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAoC9D;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAIzE;AA2BD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA+B/D"}

package/dist/tools/doctor.js

@@ -0,0 +1,381 @@
+"use strict";
+/**
+ * `fsl doctor` — checks a project's setup from disk and reports how it will behave.
+ *
+ * Every fact comes from a file with a fixed format: `firebase.json`, `package.json`,
+ * each installed package's own `package.json`, `dist/`, and the embedded `.release`
+ * marker. Nothing
+ * here parses source code or guesses at behavior — a check that cannot read what it
+ * needs reports `could-not-check`, never a pass (see CLAUDE.md, "fsl doctor — facts,
+ * not guesses"). The finding ids, levels, and the `--json` shape are the README's
+ * "Check your setup" section, verbatim; this file exists to make that section true.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkUnsupportedPeers = checkUnsupportedPeers;
+exports.runDoctor = runDoctor;
+exports.exitCodeFor = exitCodeFor;
+exports.formatDoctorReport = formatDoctorReport;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const paths_js_1 = require("../shared/paths.js");
+const nodeModules_js_1 = require("../shared/nodeModules.js");
+const versionRange_js_1 = require("../shared/versionRange.js");
+const PEER_PACKAGES = ['firebase', 'firebase-admin', 'firebase-functions'];
+function readFirebaseJson(projectRoot) {
+    const file = path.join(projectRoot, 'firebase.json');
+    if (!fs.existsSync(file))
+        return { ok: 'absent' };
+    try {
+        return { ok: true, config: JSON.parse(fs.readFileSync(file, 'utf-8')) };
+    }
+    catch {
+        return {
+            ok: false,
+            finding: couldNotCheck('firebase.json could not be parsed as JSON.', 'Fix the syntax error in firebase.json.'),
+        };
+    }
+}
+function couldNotCheck(message, fix) {
+    return { id: 'could-not-check', level: 'error', message, fix };
+}
+function firstOf(value) {
+    return Array.isArray(value) ? value[0] : value;
+}
+function hostingPublicDirs(hosting) {
+    const configs = Array.isArray(hosting) ? hosting : hosting ? [hosting] : [];
+    return configs.map((c) => c.public).filter((p) => typeof p === 'string');
+}
+/**
+ * Determine the setup this project has, from `firebase.json` when present, or from
+ * `--backend`/`--dist` otherwise. `dist` here is "the folder hosting serves" — under
+ * Firebase that is `hosting.public`; outside Firebase it is whatever `--dist` names.
+ */
+function detectSetup(options, findings) {
+    const firebaseJson = readFirebaseJson(options.projectRoot);
+    if (firebaseJson.ok === false) {
+        findings.push(firebaseJson.finding);
+        return { kind: 'firebase', backendDir: null, distDirs: [] };
+    }
+    if (firebaseJson.ok === true) {
+        const functionsConfig = firstOf(firebaseJson.config.functions);
+        const backend = functionsConfig?.source ?? 'functions';
+        const distDirs = hostingPublicDirs(firebaseJson.config.hosting);
+        return {
+            kind: 'firebase',
+            backendDir: path.resolve(options.projectRoot, backend),
+            distDirs: distDirs.map((d) => path.resolve(options.projectRoot, d)),
+        };
+    }
+    const backendDir = options.backend ? path.resolve(options.projectRoot, options.backend) : null;
+    const distDirs = options.dist ? [path.resolve(options.projectRoot, options.dist)] : [];
+    const kind = backendDir && distDirs.length ? 'node' : backendDir ? 'backend-only' : distDirs.length ? 'browser-only' : 'backend-only';
+    return { kind, backendDir, distDirs };
+}
+function findMapFiles(dir) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    const walk = (current) => {
+        for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory())
+                walk(full);
+            else if (entry.isFile() && entry.name.endsWith('.map'))
+                results.push(full);
+        }
+    };
+    walk(dir);
+    return results;
+}
+function checkMapsPublished(distDirs, findings) {
+    for (const dist of distDirs) {
+        const maps = findMapFiles(dist);
+        if (maps.length === 0)
+            continue;
+        findings.push({
+            id: 'maps-published',
+            level: 'error',
+            message: `${maps.length} .map file(s) found under ${dist}, which hosting serves — your source code is public.`,
+            fix: `Run fsl upload-sourcemaps before deploying, so maps leave ${dist} instead of being published.`,
+        });
+        return;
+    }
+}
+function checkNodeVersion(backendDir, firebaseRuntime, findings) {
+    if (!backendDir)
+        return;
+    if (firebaseRuntime) {
+        const major = (0, versionRange_js_1.leadingMajorVersion)(firebaseRuntime);
+        if (major !== undefined && major < 22) {
+            findings.push({
+                id: 'node-version',
+                level: 'error',
+                message: `firebase.json sets the functions runtime to ${firebaseRuntime}, below the supported floor of Node 22.`,
+                fix: 'Set functions.runtime to "nodejs22" (or later) in firebase.json.',
+            });
+            return;
+        }
+        if (major !== undefined)
+            return;
+    }
+    const read = (0, nodeModules_js_1.readPackageJson)(backendDir);
+    if (!read.ok) {
+        if (read.reason === 'missing') {
+            findings.push(couldNotCheck(`No package.json in ${backendDir}. Run npm install first.`, 'Run npm install in the backend directory.'));
+        }
+        else {
+            findings.push(couldNotCheck(`${path.join(backendDir, 'package.json')} could not be parsed as JSON.`, 'Fix the syntax error in the backend package.json.'));
+        }
+        return;
+    }
+    const engines = read.pkg.engines;
+    const engineNode = engines?.node;
+    if (!engineNode)
+        return;
+    const major = (0, versionRange_js_1.leadingMajorVersion)(engineNode);
+    if (major !== undefined && major < 22) {
+        findings.push({
+            id: 'node-version',
+            level: 'error',
+            message: `${path.join(backendDir, 'package.json')} sets engines.node to "${engineNode}", below the supported floor of Node 22.`,
+            fix: 'Set engines.node to ">=22" in the backend package.json.',
+        });
+    }
+}
+function checkCallable(kind, backendDir, findings) {
+    if (kind !== 'firebase' || !backendDir)
+        return false;
+    const version = (0, nodeModules_js_1.findTopLevelVersion)([backendDir], 'firebase-functions');
+    if (version)
+        return true;
+    findings.push({
+        id: 'callable-without-firebase-functions',
+        level: 'error',
+        message: `firebase.json configures functions in ${backendDir}, but firebase-functions is not installed there.`,
+        fix: `Run npm install firebase-functions in ${backendDir}.`,
+    });
+    return false;
+}
+function checkDuplicateStorage(backendDir, findings) {
+    if (!backendDir || !fs.existsSync(path.join(backendDir, 'node_modules')))
+        return;
+    const copies = (0, nodeModules_js_1.findPackageCopies)(backendDir, '@google-cloud/storage');
+    const versions = [...new Set(copies.map((c) => c.version))];
+    if (versions.length <= 1)
+        return;
+    const placed = copies.map((c) => `${c.version} ${describeOwner(ownerOf(c.dir))}`);
+    findings.push({
+        id: 'duplicate-storage',
+        level: 'warning',
+        message: `${copies.length} copies of @google-cloud/storage (${placed.join(', ')})`,
+        fix: 'npm dedupe',
+    });
+}
+function displayPath(projectRoot, dir) {
+    const relative = path.relative(projectRoot, dir);
+    if (relative === '')
+        return '.';
+    return relative.startsWith('..') || path.isAbsolute(relative) ? relative : `./${relative}`;
+}
+function ownerOf(packageDir) {
+    const parts = packageDir.split(path.sep);
+    const nodeModules = parts.lastIndexOf('node_modules');
+    const previous = parts.lastIndexOf('node_modules', nodeModules - 1);
+    if (previous === -1)
+        return null;
+    const owner = parts.slice(previous + 1, nodeModules);
+    return owner.join('/');
+}
+function describeOwner(owner) {
+    return owner === null ? 'at the top level' : `inside ${owner}`;
+}
+/**
+ * A peer whose supported range cannot be evaluated is `could-not-check`, never a pass:
+ * the ranges are read from this package's own `peerDependencies`, and a range shape
+ * `meetsMinimum` does not understand must surface rather than skip the check.
+ */
+function checkUnsupportedPeers(searchDirs, ownPeerDependencies, findings) {
+    for (const peer of PEER_PACKAGES) {
+        const range = ownPeerDependencies[peer];
+        if (!range)
+            continue;
+        const installed = (0, nodeModules_js_1.findTopLevelVersion)(searchDirs, peer);
+        if (!installed)
+            continue;
+        const meets = (0, versionRange_js_1.meetsMinimum)(installed, range);
+        if (meets === undefined) {
+            findings.push({
+                id: 'could-not-check',
+                level: 'error',
+                message: `Could not compare ${peer} ${installed} with the supported range ${range}.`,
+                fix: 'Report this at https://github.com/dasasian/firebase-structured-logger/issues — doctor needs to learn this range shape.',
+            });
+        }
+        else if (meets === false) {
+            findings.push({
+                id: 'unsupported-peer',
+                level: 'warning',
+                message: `${peer} ${installed} is installed, outside this package's supported range (${range}).`,
+                fix: `Upgrade ${peer} to satisfy ${range}.`,
+            });
+        }
+    }
+}
+function checkEmbeddedMapsWithoutRelease(backendDir, findings) {
+    if (!backendDir)
+        return;
+    const dir = (0, paths_js_1.embeddedDir)(backendDir);
+    if (!fs.existsSync(dir))
+        return;
+    const hasMaps = fs.readdirSync(dir).some((f) => f.endsWith('.map'));
+    if (!hasMaps)
+        return;
+    if (fs.existsSync((0, paths_js_1.embeddedMarkerPath)(backendDir)))
+        return;
+    findings.push({
+        id: 'embedded-maps-without-release',
+        level: 'warning',
+        message: `${dir} has embedded maps but no ${paths_js_1.RELEASE_MARKER} marker — an older release's stack can resolve against the wrong map.`,
+        fix: 'Re-run fsl upload-sourcemaps --embed-sourcemaps, which writes the marker.',
+    });
+}
+/** This package's own `package.json`, read at runtime — never copied into doctor. */
+function readOwnPackageJson() {
+    const read = (0, nodeModules_js_1.readPackageJson)(path.join(__dirname, '..', '..'));
+    if (!read.ok)
+        throw new Error('fsl doctor could not read its own package.json');
+    return read.pkg;
+}
+function resolveStorage(searchDirs) {
+    if ((0, nodeModules_js_1.findTopLevelVersion)(searchDirs, 'firebase-admin'))
+        return 'firebase-admin';
+    if ((0, nodeModules_js_1.findTopLevelVersion)(searchDirs, '@google-cloud/storage'))
+        return 'google-cloud-storage';
+    return 'none';
+}
+function runDoctor(options) {
+    const findings = [];
+    const { kind, backendDir, distDirs } = detectSetup(options, findings);
+    const firebaseJson = readFirebaseJson(options.projectRoot);
+    const firebaseRuntime = firebaseJson.ok === true ? firstOf(firebaseJson.config.functions)?.runtime : undefined;
+    checkMapsPublished(distDirs, findings);
+    checkNodeVersion(backendDir, firebaseRuntime, findings);
+    const callable = checkCallable(kind, backendDir, findings);
+    checkDuplicateStorage(backendDir, findings);
+    const searchDirs = [backendDir, options.projectRoot].filter((d) => d !== null);
+    const ownPkg = readOwnPackageJson();
+    checkUnsupportedPeers(searchDirs, ownPkg.peerDependencies ?? {}, findings);
+    checkEmbeddedMapsWithoutRelease(backendDir, findings);
+    const hasFirebaseFunctions = backendDir !== null && (0, nodeModules_js_1.findTopLevelVersion)([backendDir], 'firebase-functions') !== undefined;
+    const logging = kind === 'firebase' && hasFirebaseFunctions ? 'firebase-functions' : backendDir ? 'stdout' : 'none';
+    const trace = kind === 'firebase' && hasFirebaseFunctions ? 'trigger' : backendDir ? 'header' : 'none';
+    const storage = resolveStorage(searchDirs);
+    const setup = {
+        kind,
+        backend: backendDir ? displayPath(options.projectRoot, backendDir) : null,
+        dist: distDirs[0] ? displayPath(options.projectRoot, distDirs[0]) : null,
+        logging,
+        trace,
+        storage,
+        callable,
+    };
+    const hasError = findings.some((f) => f.level === 'error');
+    const exitCode = hasError ? 1 : 0;
+    return { setup, findings, exitCode };
+}
+/** `report.exitCode` ignores `--strict`; the CLI applies it here. */
+function exitCodeFor(report, strict) {
+    if (report.findings.some((f) => f.level === 'error'))
+        return 1;
+    if (strict && report.findings.some((f) => f.level === 'warning'))
+        return 1;
+    return 0;
+}
+const SETUP_LABEL = {
+    firebase: 'Firebase',
+    node: 'Node',
+    'browser-only': 'browser only',
+    'backend-only': 'backend only',
+};
+const LOGGING_LABEL = {
+    'firebase-functions': 'firebase-functions write()',
+    stdout: 'stdout JSON (createHttpLogHandler)',
+    none: 'not applicable — no backend given',
+};
+const TRACE_LABEL = {
+    trigger: 'from each Cloud Functions trigger',
+    header: 'from the x-cloud-trace-context header',
+    none: 'not applicable — no backend given',
+};
+const STORAGE_LABEL = {
+    'firebase-admin': 'firebase-admin, default bucket',
+    'google-cloud-storage': '@google-cloud/storage — needs a bucket named in code (not checked)',
+    none: 'not configured',
+};
+/** Renders the human-readable report `fsl doctor` prints without `--json`. */
+function formatDoctorReport(report) {
+    const { setup, findings } = report;
+    const backendNoun = setup.kind === 'firebase' ? 'functions' : 'backend';
+    const location = setup.backend && setup.dist
+        ? `${backendNoun} in ${setup.backend}, web build in ${setup.dist}`
+        : setup.backend
+            ? `backend in ${setup.backend}`
+            : setup.dist
+                ? `web build in ${setup.dist}`
+                : 'nothing to check — pass --backend and/or --dist';
+    const lines = [
+        `Setup: ${SETUP_LABEL[setup.kind]} — ${location}`,
+        '',
+        pad('Logging', LOGGING_LABEL[setup.logging]),
+        pad('Trace ids', TRACE_LABEL[setup.trace]),
+        pad('Storage', STORAGE_LABEL[setup.storage]),
+        pad('Callable', setup.callable ? 'createClientLogFunction available' : 'not available'),
+    ];
+    if (findings.length > 0) {
+        lines.push('');
+        for (const finding of findings) {
+            const icon = finding.level === 'error' ? '✗' : '⚠';
+            const indent = ' '.repeat(4);
+            lines.push(`  ${icon} ${finding.id.padEnd(20)} ${finding.message}`);
+            lines.push(`${indent}${' '.repeat(20)}Fix: ${finding.fix}`);
+        }
+    }
+    return lines.join('\n');
+}
+function pad(label, value) {
+    return `  ${label.padEnd(15)}${value}`;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/tools/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/tools/doctor.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.js

@@ -38,6 +38,8 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const uploadSourceMaps_1 = require("./uploadSourceMaps");
 const installSkills_1 = require("./installSkills");
+const doctor_1 = require("./doctor");
+const deprecate_1 = require("../shared/deprecate");
 const [, , command, ...rawArgs] = process.argv;
 function parseArgs(args) {
     const result = {};
@@ -80,10 +82,14 @@ async function main() {
         case 'upload-sourcemaps': {
             const bucket = args.bucket ?? process.env.VITE_FIREBASE_STORAGE_BUCKET ?? process.env.FIREBASE_STORAGE_BUCKET;
             const embed = args['embed-sourcemaps'] === 'true';
+            if (args.functions !== undefined) {
+                (0, deprecate_1.warnDeprecated)('--functions', '--backend');
+            }
+            const backend = args.backend ?? args.functions;
             // A bucket is only required when something is going to be uploaded.
             // Embed-only is the whole flow for a backend that has no bucket — see #34.
             if (!bucket && !embed) {
-                console.error('Usage: fsl upload-sourcemaps [--bucket=<name>] [--functions=<path>] [--embed-sourcemaps] [--release=<id>] [--dist=<path>] [--prefix=<path>]');
+                console.error('Usage: fsl upload-sourcemaps [--bucket=<name>] [--backend=<path>] [--embed-sourcemaps] [--release=<id>] [--dist=<path>] [--prefix=<path>]');
                 console.error('Bucket can also be set via VITE_FIREBASE_STORAGE_BUCKET or FIREBASE_STORAGE_BUCKET env var (loaded from .env.local automatically).');
                 console.error('Omit the bucket only with --embed-sourcemaps, to embed the current release without uploading.');
                 process.exit(1);
@@ -92,7 +98,7 @@ async function main() {
                 bucket,
                 release: args.release,
                 distDir: args.dist,
-                functionsDir: args.functions,
+                functionsDir: backend,
                 embedSourcemaps: embed,
                 prefix: args.prefix,
             });
@@ -106,16 +112,31 @@ async function main() {
             await (0, installSkills_1.installSkills)({ global: args.global === 'true', force: args.force === 'true' });
             break;
         }
+        case 'doctor': {
+            const report = (0, doctor_1.runDoctor)({
+                projectRoot: process.cwd(),
+                backend: args.backend,
+                dist: args.dist,
+            });
+            if (args.json === 'true') {
+                console.log(JSON.stringify({ ...report, exitCode: (0, doctor_1.exitCodeFor)(report, args.strict === 'true') }));
+            }
+            else {
+                console.log((0, doctor_1.formatDoctorReport)(report));
+            }
+            process.exit((0, doctor_1.exitCodeFor)(report, args.strict === 'true'));
+        }
         default: {
             console.log(`
 firebase-structured-logger (fsl)
 
 Commands:
-  fsl upload-sourcemaps [--bucket=<name>] [--functions=<path>] [--embed-sourcemaps] [--release=<id>] [--dist=<path>] [--prefix=<path>]
+  fsl upload-sourcemaps [--bucket=<name>] [--backend=<path>] [--embed-sourcemaps] [--release=<id>] [--dist=<path>] [--prefix=<path>]
       Upload .map files from dist/ to Cloud Storage and delete them locally.
       --bucket defaults to VITE_FIREBASE_STORAGE_BUCKET or FIREBASE_STORAGE_BUCKET (loaded from .env.local automatically).
-      --functions path to Cloud Functions directory (e.g. ./functions or ./backend).
-      --embed-sourcemaps copies maps to {functions}/sourcemaps/current/ for fast lookup of current release.
+      --backend path to the backend directory (e.g. ./functions or ./backend). --functions is
+               a deprecated alias, kept for existing scripts.
+      --embed-sourcemaps copies maps to {backend}/sourcemaps/current/ for fast lookup of current release.
                Given without --bucket, embeds only and uploads nothing — for a backend with no
                bucket. Only the deployed release can then be symbolicated.
       --prefix Cloud Storage prefix to upload under (default sourcemaps/). Must match
@@ -123,6 +144,14 @@ Commands:
       Authenticates via FIREBASE_SERVICE_ACCOUNT_PATH if set, otherwise uses ADC.
       Release ID defaults to git rev-parse --short HEAD.
 
+  fsl doctor [--backend=<path>] [--dist=<path>] [--strict] [--json]
+      Check the project's setup from disk: how logging, trace ids, Storage and the
+      callable will behave, and any findings. Reads firebase.json when present;
+      otherwise --backend and --dist say where things are.
+      --strict  also fail (exit 1) on warnings, not just errors.
+      --json    print the same result as JSON instead of the human-readable report.
+      Exit code: 0 with no errors, 1 with an error (or a warning under --strict).
+
   fsl install-skills [--global] [--force]
       Copy skills/ to .claude/skills/ (project) or ~/.claude/skills/ (--global).
       Prompts before overwriting existing skills. Use --force to skip prompts.

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/uploadSourceMaps.d.ts

@@ -30,6 +30,13 @@ export interface UploadOptions {
     bucket?: string;
     release?: string;
     distDir?: string;
+    /**
+     * Path to the backend directory (e.g. './functions' or './backend').
+     *
+     * Named `functionsDir` internally; the CLI flag is `--backend` (`--functions` is
+     * kept as a deprecated alias) — this option also serves a Cloud Run backend that
+     * is not a Cloud Functions directory at all.
+     */
     functionsDir?: string;
     embedSourcemaps?: boolean;
     /**

package/dist/tools/uploadSourceMaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploadSourceMaps.d.ts","sourceRoot":"","sources":["../../src/tools/uploadSourceMaps.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,aAAiB,CAAA;AAErD,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CASpF;AA8BD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAkH7F"}
+{"version":3,"file":"uploadSourceMaps.d.ts","sourceRoot":"","sources":["../../src/tools/uploadSourceMaps.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,aAAiB,CAAA;AAErD,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CASpF;AA8BD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAkH7F"}