@dasasian/firebase-structured-logger 0.1.0

package/dist/tools/installSkills.js

@@ -0,0 +1,89 @@
+"use strict";
+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.installSkills = installSkills;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const readline = __importStar(require("readline"));
+function prompt(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => {
+        rl.question(question, answer => {
+            rl.close();
+            resolve(answer.trim().toLowerCase());
+        });
+    });
+}
+async function installSkills(options = {}) {
+    const { force = false } = options;
+    // Skills directory in this package
+    const packageSkillsDir = path.join(__dirname, '..', '..', 'skills');
+    if (!fs.existsSync(packageSkillsDir)) {
+        console.error('[fsl] Skills directory not found:', packageSkillsDir);
+        process.exit(1);
+    }
+    // Target: project-level by default, global with --global flag
+    const targetDir = options.global
+        ? path.join(os.homedir(), '.claude', 'skills')
+        : path.join(process.cwd(), '.claude', 'skills');
+    const targetLabel = options.global ? '~/.claude/skills' : '.claude/skills';
+    fs.mkdirSync(targetDir, { recursive: true });
+    let count = 0;
+    for (const entry of fs.readdirSync(packageSkillsDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const skillName = entry.name;
+        const srcDir = path.join(packageSkillsDir, skillName);
+        const destDir = path.join(targetDir, skillName);
+        for (const file of fs.readdirSync(srcDir)) {
+            const src = path.join(srcDir, file);
+            const dest = path.join(destDir, file);
+            if (fs.existsSync(dest) && !force) {
+                const answer = await prompt(`  Skill already exists: ${targetLabel}/${skillName}/${file}\n  Overwrite? [y/N] `);
+                if (answer !== 'y' && answer !== 'yes') {
+                    console.log(`  - skipped ${skillName}/${file}`);
+                    continue;
+                }
+            }
+            fs.mkdirSync(destDir, { recursive: true });
+            fs.copyFileSync(src, dest);
+            console.log(`  ✓ ${targetLabel}/${skillName}/${file}`);
+            count++;
+        }
+    }
+    console.log(`[fsl] Installed ${count} skill file(s) to ${targetLabel}/`);
+}
+//# sourceMappingURL=installSkills.js.map

package/dist/tools/installSkills.js.map

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

package/dist/tools/packDeploy.d.ts

@@ -0,0 +1,15 @@
+interface PackOptions {
+    functionsDir: string;
+}
+/**
+ * Build + pack firebase-structured-logger, copy tgz to functions/vendor/,
+ * and patch functions/package.json to reference it. Call before firebase deploy.
+ */
+export declare function pack(options: PackOptions): Promise<void>;
+/**
+ * Restore functions/package.json to its original file: reference.
+ * Call after firebase deploy (e.g. in postdeploy script).
+ */
+export declare function packRestore(options: PackOptions): Promise<void>;
+export {};
+//# sourceMappingURL=packDeploy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packDeploy.d.ts","sourceRoot":"","sources":["../../src/tools/packDeploy.ts"],"names":[],"mappings":"AASA,UAAU,WAAW;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAyBD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD9D;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCrE"}

package/dist/tools/packDeploy.js

@@ -0,0 +1,148 @@
+"use strict";
+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.pack = pack;
+exports.packRestore = packRestore;
+const crypto_1 = require("crypto");
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// __dirname resolves symlinks, so when consumed via file: reference this points
+// to the real firebase-structured-logger directory, not node_modules.
+const packageRoot = path.join(__dirname, '..', '..');
+function readPackageJson(dir) {
+    return JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf-8'));
+}
+function writePackageJson(dir, pkg) {
+    fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify(pkg, null, 2) + '\n');
+}
+function findFslDep(pkg) {
+    for (const field of ['dependencies', 'devDependencies']) {
+        const deps = pkg[field];
+        if (deps?.['firebase-structured-logger']) {
+            return { field, ref: deps['firebase-structured-logger'] };
+        }
+    }
+    return null;
+}
+/**
+ * Build + pack firebase-structured-logger, copy tgz to functions/vendor/,
+ * and patch functions/package.json to reference it. Call before firebase deploy.
+ */
+async function pack(options) {
+    const functionsDir = path.resolve(process.cwd(), options.functionsDir);
+    const vendorDir = path.join(functionsDir, 'vendor');
+    const manifestPath = path.join(vendorDir, '.fsl-restore.json');
+    // 1. Build
+    console.log('[fsl] Building firebase-structured-logger...');
+    (0, child_process_1.execSync)('npm run build', { cwd: packageRoot, stdio: 'inherit' });
+    // 2. Pack — use --json for reliable filename parsing
+    console.log('[fsl] Packing...');
+    const packOutput = (0, child_process_1.execSync)('npm pack --json', { cwd: packageRoot, encoding: 'utf-8' });
+    const [{ filename: baseTgzFileName }] = JSON.parse(packOutput);
+    const tgzSource = path.join(packageRoot, baseTgzFileName);
+    // Use a content hash so the filename is stable for identical builds and
+    // changes only when FSL itself changes — no calling-project release ID needed.
+    const contentHash = (0, crypto_1.createHash)('sha256').update(fs.readFileSync(tgzSource)).digest('hex').slice(0, 8);
+    const tgzFileName = baseTgzFileName.replace(/\.tgz$/, `-${contentHash}.tgz`);
+    // 3. Copy to functions/vendor/ (remove any previous fsl tarballs first)
+    fs.mkdirSync(vendorDir, { recursive: true });
+    for (const f of fs.readdirSync(vendorDir)) {
+        if (f.startsWith('firebase-structured-logger-') && f.endsWith('.tgz')) {
+            fs.unlinkSync(path.join(vendorDir, f));
+        }
+    }
+    const tgzDest = path.join(vendorDir, tgzFileName);
+    fs.copyFileSync(tgzSource, tgzDest);
+    fs.unlinkSync(tgzSource);
+    console.log(`[fsl] Copied ${tgzFileName} → functions/vendor/`);
+    // 4. Patch functions/package.json
+    const pkg = readPackageJson(functionsDir);
+    const existing = findFslDep(pkg);
+    if (!existing) {
+        console.error('[fsl] firebase-structured-logger not found in functions/package.json');
+        process.exit(1);
+    }
+    const manifest = { originalRef: existing.ref, tgzFileName };
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+    pkg[existing.field]['firebase-structured-logger'] =
+        `file:./vendor/${tgzFileName}`;
+    writePackageJson(functionsDir, pkg);
+    // 5. npm install to lock in the tgz
+    console.log('[fsl] Installing...');
+    (0, child_process_1.execSync)('npm install', { cwd: functionsDir, stdio: 'inherit' });
+    console.log('[fsl] Pack complete — ready to deploy.');
+}
+/**
+ * Restore functions/package.json to its original file: reference.
+ * Call after firebase deploy (e.g. in postdeploy script).
+ */
+async function packRestore(options) {
+    const functionsDir = path.resolve(process.cwd(), options.functionsDir);
+    const vendorDir = path.join(functionsDir, 'vendor');
+    const manifestPath = path.join(vendorDir, '.fsl-restore.json');
+    if (!fs.existsSync(manifestPath)) {
+        console.log('[fsl] No restore manifest found — nothing to restore.');
+        return;
+    }
+    const { originalRef, tgzFileName } = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    // 1. Restore package.json — skip if originalRef is a file: path that no longer exists
+    // (e.g. a previous vendor tarball that was cleaned up during pack).
+    const pkg = readPackageJson(functionsDir);
+    const existing = findFslDep(pkg);
+    const refMatch = originalRef.match(/^file:(.+)$/);
+    const refFilePath = refMatch ? path.resolve(functionsDir, refMatch[1]) : null;
+    const refFileExists = refFilePath ? fs.existsSync(refFilePath) : true;
+    if (existing) {
+        if (refFileExists) {
+            ;
+            pkg[existing.field]['firebase-structured-logger'] = originalRef;
+            writePackageJson(functionsDir, pkg);
+        }
+        else {
+            console.log(`[fsl] Original ref (${originalRef}) no longer exists — keeping vendor tgz reference.`);
+        }
+    }
+    // 2. Remove tgz + manifest — only remove tgz if we restored to a different ref
+    const tgzPath = path.join(vendorDir, tgzFileName);
+    if (refFileExists && fs.existsSync(tgzPath))
+        fs.unlinkSync(tgzPath);
+    fs.unlinkSync(manifestPath);
+    // 3. npm install to restore
+    console.log('[fsl] Restoring...');
+    (0, child_process_1.execSync)('npm install', { cwd: functionsDir, stdio: 'inherit' });
+    console.log('[fsl] Restore complete.');
+}
+//# sourceMappingURL=packDeploy.js.map

package/dist/tools/packDeploy.js.map

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

package/dist/tools/uploadSourceMaps.d.ts

@@ -0,0 +1,9 @@
+export interface UploadOptions {
+    bucket: string;
+    release?: string;
+    distDir?: string;
+    functionsDir?: string;
+    embedSourcemaps?: boolean;
+}
+export declare function uploadSourceMaps(options: UploadOptions): Promise<void>;
+//# sourceMappingURL=uploadSourceMaps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uploadSourceMaps.d.ts","sourceRoot":"","sources":["../../src/tools/uploadSourceMaps.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAsBD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmE5E"}

package/dist/tools/uploadSourceMaps.js

@@ -0,0 +1,120 @@
+"use strict";
+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.uploadSourceMaps = uploadSourceMaps;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const storage_1 = require("@google-cloud/storage");
+function findMapFiles(dir) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    function 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;
+}
+async function uploadSourceMaps(options) {
+    const releaseId = options.release ?? process.env.VITE_RELEASE_ID ?? process.env.RELEASE_ID;
+    if (!releaseId) {
+        console.error('[fsl] Release ID required. Set RELEASE_ID (or VITE_RELEASE_ID) in .env.local or pass --release=<id>.');
+        process.exit(1);
+    }
+    const distDir = options.distDir ?? path.join(process.cwd(), 'dist');
+    const mapFiles = findMapFiles(distDir);
+    if (mapFiles.length === 0) {
+        console.log('[fsl] No .map files found in', distDir);
+        return;
+    }
+    console.log(`[fsl] Uploading ${mapFiles.length} source map(s) for release ${releaseId}...`);
+    // Embed maps into functions directory before uploading (for fast lookup of current release)
+    if (options.embedSourcemaps && options.functionsDir) {
+        const embedDir = path.join(process.cwd(), options.functionsDir, 'sourcemaps', 'current');
+        fs.mkdirSync(embedDir, { recursive: true });
+        for (const f of fs.readdirSync(embedDir)) {
+            fs.unlinkSync(path.join(embedDir, f));
+        }
+        for (const localPath of mapFiles) {
+            const dest = path.join(embedDir, path.basename(localPath));
+            fs.copyFileSync(localPath, dest);
+            console.log(`  ✓ embedded ${path.basename(localPath)} → ${options.functionsDir}/sourcemaps/current/`);
+        }
+    }
+    // Authenticate via service account key if available, otherwise fall back to ADC
+    const serviceAccountPath = process.env.FIREBASE_SERVICE_ACCOUNT_PATH;
+    const storageOptions = serviceAccountPath && fs.existsSync(serviceAccountPath)
+        ? { keyFilename: serviceAccountPath }
+        : {};
+    const storage = new storage_1.Storage(storageOptions);
+    const bucket = storage.bucket(options.bucket);
+    try {
+        for (const localPath of mapFiles) {
+            const fileName = path.basename(localPath);
+            const destination = `sourcemaps/${releaseId}/${fileName}`;
+            await bucket.upload(localPath, { destination });
+            console.log(`  ✓ ${fileName} → gs://${options.bucket}/${destination}`);
+            // Delete local .map file after upload
+            fs.unlinkSync(localPath);
+            console.log(`  ✗ deleted ${path.relative(process.cwd(), localPath)}`);
+        }
+        console.log('[fsl] Source map upload complete.');
+    }
+    catch (err) {
+        if (options.embedSourcemaps) {
+            console.warn('[fsl] Warning: GCS upload failed — symbolication will work for this release only (via embedded maps). Previous releases will not be symbolicated.');
+            console.warn('[fsl] GCS error:', err?.message ?? err);
+            // Delete local .map files even though GCS upload failed — they are embedded and should not be deployed to hosting
+            for (const localPath of mapFiles) {
+                if (fs.existsSync(localPath)) {
+                    fs.unlinkSync(localPath);
+                    console.log(`  ✗ deleted ${path.relative(process.cwd(), localPath)}`);
+                }
+            }
+        }
+        else {
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=uploadSourceMaps.js.map

package/dist/tools/uploadSourceMaps.js.map

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

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@dasasian/firebase-structured-logger",
+  "version": "0.1.0",
+  "description": "Structured logging for Firebase apps — client, functions, and tools",
+  "license": "MIT",
+  "author": "Dasasian",
+  "keywords": [
+    "firebase",
+    "logging",
+    "structured-logging",
+    "cloud-logging",
+    "firebase-functions",
+    "source-maps",
+    "symbolication",
+    "observability",
+    "typescript"
+  ],
+  "homepage": "https://github.com/dasasian/firebase-structured-logger#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dasasian/firebase-structured-logger.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dasasian/firebase-structured-logger/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./functions": {
+      "types": "./dist/functions/index.d.ts",
+      "default": "./dist/functions/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "default": "./dist/tools/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "client": [
+        "dist/client/index.d.ts"
+      ],
+      "functions": [
+        "dist/functions/index.d.ts"
+      ],
+      "tools": [
+        "dist/tools/index.d.ts"
+      ]
+    }
+  },
+  "bin": {
+    "fsl": "./dist/tools/index.js"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx tests/logger.ts && FUNCTIONS_EMULATOR=true tsx tests/handler.ts && FUNCTIONS_EMULATOR=true tsx tests/symbolication.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@google-cloud/storage": "^7.0.0",
+    "@jridgewell/trace-mapping": "^0.3.31",
+    "ulid": "^2.3.0"
+  },
+  "peerDependencies": {
+    "firebase": ">=10.0.0",
+    "firebase-admin": ">=12.0.0",
+    "firebase-functions": ">=6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "firebase": {
+      "optional": true
+    },
+    "firebase-admin": {
+      "optional": true
+    },
+    "firebase-functions": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "firebase": "^12.0.0",
+    "firebase-admin": "^13.0.0",
+    "firebase-functions": "^7.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "~5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}