nugi-ts-logs-sdk 1.0.0

package/dist/instrumentation/db-error.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Detect and normalize database / ORM errors so we can report them with
+ * name, message, stack, SQL, and driver codes.
+ */
+export interface NormalizedDbError {
+    name: string;
+    message: string;
+    stack?: string;
+    code?: string | number;
+    orm?: string;
+    sql?: string;
+    /** Extra ORM-specific fields (safe scalars / short strings only). */
+    details?: Record<string, unknown>;
+}
+/** True when `err` looks like a database / ORM failure. */
+export declare function isDatabaseError(err: unknown): boolean;
+/** Pull a stable reportable shape from any ORM / driver error. */
+export declare function normalizeDbError(err: unknown, hint?: {
+    orm?: string;
+    sql?: string;
+}): NormalizedDbError;
+/**
+ * Build a synthetic Error that preserves the original name/stack for ReportError,
+ * while keeping a reference to the original via `cause` when available.
+ */
+export declare function toReportableError(normalized: NormalizedDbError, original?: unknown): Error;
+//# sourceMappingURL=db-error.d.ts.map

package/dist/instrumentation/db-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-error.d.ts","sourceRoot":"","sources":["../../src/instrumentation/db-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AA0BD,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA2BrD;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,iBAAiB,CA4DnB;AAuBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAY1F"}

package/dist/instrumentation/db-error.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Detect and normalize database / ORM errors so we can report them with
+ * name, message, stack, SQL, and driver codes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDatabaseError = isDatabaseError;
+exports.normalizeDbError = normalizeDbError;
+exports.toReportableError = toReportableError;
+const ORM_NAME_HINTS = [
+    { match: /^Sequelize/i, orm: 'sequelize' },
+    { match: /^Prisma/i, orm: 'prisma' },
+    { match: /^QueryFailedError$/i, orm: 'typeorm' },
+    { match: /^TypeORM/i, orm: 'typeorm' },
+    { match: /^Mongo(Server|Network|Error)/i, orm: 'mongodb' },
+    { match: /^MongooseError/i, orm: 'mongoose' },
+    { match: /^Knex/i, orm: 'knex' },
+    { match: /^Drizzle/i, orm: 'drizzle' },
+];
+const DRIVER_CODE_KEYS = [
+    'code',
+    'errno',
+    'sqlState',
+    'sqlMessage',
+    'constraint',
+    'table',
+    'schema',
+    'detail',
+    'severity',
+    'routine',
+];
+/** True when `err` looks like a database / ORM failure. */
+function isDatabaseError(err) {
+    if (!err || typeof err !== 'object')
+        return false;
+    const e = err;
+    const name = typeof e.name === 'string' ? e.name : '';
+    if (ORM_NAME_HINTS.some(({ match }) => match.test(name)))
+        return true;
+    // Sequelize / TypeORM often nest the driver error.
+    if (e.parent || e.original || e.driverError)
+        return true;
+    // Prisma client errors expose `clientVersion` + `code` (P2xxx).
+    if (typeof e.clientVersion === 'string' && (e.code != null || name.startsWith('Prisma'))) {
+        return true;
+    }
+    // pg / mysql2 style
+    if (typeof e.code === 'string' && (e.severity != null || e.sqlState != null || e.errno != null)) {
+        return true;
+    }
+    // Message heuristics as last resort
+    const msg = typeof e.message === 'string' ? e.message : '';
+    if (/SQLSTATE|ER_DUP_ENTRY|ECONNREFUSED.*:(3306|5432|27017)|deadlock|duplicate key/i.test(msg)) {
+        return true;
+    }
+    return false;
+}
+/** Pull a stable reportable shape from any ORM / driver error. */
+function normalizeDbError(err, hint) {
+    if (!(err instanceof Error) && (!err || typeof err !== 'object')) {
+        return {
+            name: 'DatabaseError',
+            message: String(err),
+            orm: hint?.orm,
+            sql: hint?.sql,
+        };
+    }
+    const e = err;
+    const name = e.name || 'DatabaseError';
+    const orm = hint?.orm ||
+        ORM_NAME_HINTS.find(({ match }) => match.test(name))?.orm ||
+        (typeof e.clientVersion === 'string' ? 'prisma' : undefined);
+    const nested = (e.parent || e.original || e.driverError || e.cause);
+    const code = pickCode(e) ??
+        (nested ? pickCode(nested) : undefined) ??
+        (typeof e.meta?.code === 'string' || typeof e.meta?.code === 'number'
+            ? e.meta.code
+            : undefined);
+    const sql = hint?.sql ||
+        (typeof e.sql === 'string' ? e.sql : undefined) ||
+        (typeof e.query === 'string' ? e.query : undefined) ||
+        (typeof nested?.sql === 'string' ? nested.sql : undefined);
+    const stack = typeof e.stack === 'string' && e.stack.trim() ? e.stack : nested?.stack;
+    const details = {};
+    collectDriverFields(e, details);
+    if (nested)
+        collectDriverFields(nested, details);
+    if (e.meta && typeof e.meta === 'object') {
+        for (const [k, v] of Object.entries(e.meta)) {
+            if (isShortScalar(v) && details[k] == null)
+                details[k] = v;
+        }
+    }
+    if (Array.isArray(e.parameters) && e.parameters.length <= 20) {
+        details.parameters = e.parameters.map((p) => isShortScalar(p) ? p : typeof p);
+    }
+    if (typeof e.clientVersion === 'string')
+        details.clientVersion = e.clientVersion;
+    return {
+        name,
+        message: e.message || String(err),
+        stack,
+        code,
+        orm,
+        sql: sql && sql.length > 4000 ? `${sql.slice(0, 4000)}…` : sql,
+        details: Object.keys(details).length ? details : undefined,
+    };
+}
+function pickCode(e) {
+    if (typeof e.code === 'string' || typeof e.code === 'number')
+        return e.code;
+    if (typeof e.errno === 'number')
+        return e.errno;
+    if (typeof e.sqlState === 'string')
+        return e.sqlState;
+    return undefined;
+}
+function collectDriverFields(e, out) {
+    for (const key of DRIVER_CODE_KEYS) {
+        const v = e[key];
+        if (isShortScalar(v) && out[key] == null)
+            out[key] = v;
+    }
+}
+function isShortScalar(v) {
+    if (v == null)
+        return false;
+    if (typeof v === 'boolean' || typeof v === 'number')
+        return true;
+    if (typeof v === 'string')
+        return v.length <= 500;
+    return false;
+}
+/**
+ * Build a synthetic Error that preserves the original name/stack for ReportError,
+ * while keeping a reference to the original via `cause` when available.
+ */
+function toReportableError(normalized, original) {
+    const err = new Error(normalized.message);
+    err.name = normalized.name;
+    if (normalized.stack)
+        err.stack = normalized.stack;
+    if (original instanceof Error && 'cause' in Error.prototype) {
+        try {
+            err.cause = original;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return err;
+}
+//# sourceMappingURL=db-error.js.map

package/dist/instrumentation/db-error.js.map

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

package/dist/instrumentation/query-capture.d.ts

@@ -0,0 +1,39 @@
+import { type NormalizedDbError } from './db-error';
+export interface QueryCaptureInfo {
+    query: string;
+    durationMs: number;
+    /** Driver / ORM that produced the query. */
+    orm?: string;
+    success?: boolean;
+    error?: string;
+    /** Structured ORM / driver failure (name, stack, code, …). */
+    dbError?: NormalizedDbError;
+    /** Original thrown value — used to dedupe ReportError with Nest interceptors. */
+    cause?: unknown;
+    /** Optional HTTP request correlation id. */
+    requestId?: string;
+}
+export type QueryCaptureHandler = (info: QueryCaptureInfo) => void;
+type StopFn = () => void;
+/**
+ * Auto-instrument common Node DB drivers/ORMs so SQL is captured without
+ * manual logQuery() calls. Safe no-ops when a package isn't installed.
+ *
+ * Patches (best-effort):
+ * - `pg` Client + Pool
+ * - `mysql2` / `mysql2/promise`
+ * - `sequelize` Sequelize.prototype.query
+ * - `typeorm` DataSource / EntityManager query (when installed)
+ *
+ * Prisma needs an explicit client wrap — use `instrumentPrisma(prisma)`.
+ *
+ * Failed queries include `dbError` (name, message, stack, code) so the host
+ * can ReportError with a full stack trace.
+ */
+export declare function startQueryCapture(onQuery: QueryCaptureHandler): StopFn;
+/** Wrap a PrismaClient so every query is reported. Returns the same client. */
+export declare function instrumentPrisma<T extends {
+    $extends: Function;
+}>(prisma: T, onQuery: QueryCaptureHandler): T;
+export {};
+//# sourceMappingURL=query-capture.d.ts.map

package/dist/instrumentation/query-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-capture.d.ts","sourceRoot":"","sources":["../../src/instrumentation/query-capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AActE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEnE,KAAK,MAAM,GAAG,MAAM,IAAI,CAAC;AAEzB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAoCtE;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,EAC/D,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,mBAAmB,GAC3B,CAAC,CAgDH"}

package/dist/instrumentation/query-capture.js

@@ -0,0 +1,359 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startQueryCapture = startQueryCapture;
+exports.instrumentPrisma = instrumentPrisma;
+const db_error_1 = require("./db-error");
+/** Debug helper — never throws into the host app. */
+function debug(message) {
+    try {
+        if (process.env.NUGI_DEBUG === '1' || process.env.DEBUG?.includes('nugi')) {
+            // eslint-disable-next-line no-console
+            console.debug(`[nugi-ts-logs-sdk:QueryCapture] ${message}`);
+        }
+    }
+    catch {
+        /* ignore */
+    }
+}
+/**
+ * Auto-instrument common Node DB drivers/ORMs so SQL is captured without
+ * manual logQuery() calls. Safe no-ops when a package isn't installed.
+ *
+ * Patches (best-effort):
+ * - `pg` Client + Pool
+ * - `mysql2` / `mysql2/promise`
+ * - `sequelize` Sequelize.prototype.query
+ * - `typeorm` DataSource / EntityManager query (when installed)
+ *
+ * Prisma needs an explicit client wrap — use `instrumentPrisma(prisma)`.
+ *
+ * Failed queries include `dbError` (name, message, stack, code) so the host
+ * can ReportError with a full stack trace.
+ */
+function startQueryCapture(onQuery) {
+    const stops = [];
+    try {
+        stops.push(patchPg(onQuery));
+    }
+    catch (err) {
+        debug(`pg patch skipped: ${String(err)}`);
+    }
+    try {
+        stops.push(patchMysql2(onQuery));
+    }
+    catch (err) {
+        debug(`mysql2 patch skipped: ${String(err)}`);
+    }
+    try {
+        stops.push(patchSequelize(onQuery));
+    }
+    catch (err) {
+        debug(`sequelize patch skipped: ${String(err)}`);
+    }
+    try {
+        stops.push(patchTypeOrm(onQuery));
+    }
+    catch (err) {
+        debug(`typeorm patch skipped: ${String(err)}`);
+    }
+    return () => {
+        for (const stop of stops) {
+            try {
+                stop();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    };
+}
+/** Wrap a PrismaClient so every query is reported. Returns the same client. */
+function instrumentPrisma(prisma, onQuery) {
+    try {
+        return prisma.$extends({
+            name: 'nugi-logs-query-capture',
+            query: {
+                async $allOperations({ operation, model, args, query, }) {
+                    const start = Date.now();
+                    let success = true;
+                    let error;
+                    let dbError;
+                    let cause;
+                    try {
+                        return await query(args);
+                    }
+                    catch (err) {
+                        success = false;
+                        cause = err;
+                        dbError = (0, db_error_1.normalizeDbError)(err, { orm: 'prisma' });
+                        error = dbError.message;
+                        throw err;
+                    }
+                    finally {
+                        const label = model ? `${model}.${operation}` : operation;
+                        safeEmit(onQuery, {
+                            query: `prisma:${label}`,
+                            durationMs: Date.now() - start,
+                            orm: 'prisma',
+                            success,
+                            error,
+                            dbError,
+                            cause,
+                        });
+                    }
+                },
+            },
+        });
+    }
+    catch (err) {
+        debug(`instrumentPrisma failed: ${String(err)}`);
+        return prisma;
+    }
+}
+function safeEmit(onQuery, info) {
+    try {
+        const query = info.query && info.query.length > 4000
+            ? `${info.query.slice(0, 4000)}…`
+            : info.query;
+        onQuery({ ...info, query });
+    }
+    catch {
+        /* never break the host query */
+    }
+}
+function tryRequire(id) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require(id);
+    }
+    catch {
+        return null;
+    }
+}
+function finishFromErr(err, orm, sql) {
+    if (!err)
+        return { success: true };
+    const dbError = (0, db_error_1.normalizeDbError)(err, { orm, sql });
+    return { success: false, error: dbError.message, dbError };
+}
+function patchPg(onQuery) {
+    const pg = tryRequire('pg');
+    if (!pg?.Client?.prototype?.query)
+        return () => undefined;
+    const Client = pg.Client;
+    const Pool = pg.Pool;
+    const origClient = Client.prototype.query;
+    const origPool = Pool?.prototype?.query;
+    Client.prototype.query = function patchedClientQuery(...args) {
+        return wrapDriverQuery(origClient, this, args, onQuery, 'pg');
+    };
+    if (Pool && origPool) {
+        Pool.prototype.query = function patchedPoolQuery(...args) {
+            return wrapDriverQuery(origPool, this, args, onQuery, 'pg');
+        };
+    }
+    return () => {
+        Client.prototype.query = origClient;
+        if (Pool && origPool)
+            Pool.prototype.query = origPool;
+    };
+}
+/**
+ * mysql2's Query object defines a trap `.then()` that *throws* this exact
+ * error when awaited. Never treat "has .then" as Promise-like for drivers.
+ */
+function isRealPromise(value) {
+    return value instanceof Promise;
+}
+function wrapDriverQuery(orig, ctx, args, onQuery, orm) {
+    const sql = extractSql(args[0]);
+    const start = Date.now();
+    let finished = false;
+    const finish = (success, err) => {
+        if (finished || !sql)
+            return;
+        finished = true;
+        const fail = success ? undefined : finishFromErr(err, orm, sql);
+        safeEmit(onQuery, {
+            query: sql,
+            durationMs: Date.now() - start,
+            orm,
+            success,
+            error: fail?.error,
+            dbError: fail?.dbError,
+            cause: success ? undefined : err,
+        });
+    };
+    const last = args[args.length - 1];
+    if (typeof last === 'function') {
+        const wrapped = args.slice();
+        wrapped[wrapped.length - 1] = function (err, res) {
+            finish(!err, err);
+            return last(err, res);
+        };
+        return orig.apply(ctx, wrapped);
+    }
+    const result = orig.apply(ctx, args);
+    if (isRealPromise(result)) {
+        return result.then((v) => {
+            finish(true);
+            return v;
+        }, (err) => {
+            finish(false, err);
+            throw err;
+        });
+    }
+    if (result && typeof result.on === 'function') {
+        result.on('end', () => finish(true));
+        result.on('error', (err) => {
+            finish(false, err);
+        });
+        return result;
+    }
+    finish(true);
+    return result;
+}
+function extractSql(input) {
+    if (typeof input === 'string')
+        return input;
+    if (input && typeof input === 'object') {
+        const o = input;
+        if (typeof o.text === 'string')
+            return o.text;
+        if (typeof o.sql === 'string')
+            return o.sql;
+    }
+    return undefined;
+}
+function patchMysql2(onQuery) {
+    const mysql = tryRequire('mysql2');
+    if (!mysql)
+        return () => undefined;
+    const stops = [];
+    const patchProto = (proto) => {
+        if (!proto?.query || proto.query.__nugiPatched)
+            return;
+        const orig = proto.query;
+        function patched(...args) {
+            return wrapDriverQuery(orig, this, args, onQuery, 'mysql2');
+        }
+        patched.__nugiPatched = true;
+        proto.query = patched;
+        stops.push(() => {
+            proto.query = orig;
+        });
+    };
+    patchProto(mysql.Connection?.prototype);
+    patchProto(mysql.Pool?.prototype);
+    patchProto(mysql.PoolConnection?.prototype);
+    return () => stops.forEach((s) => s());
+}
+function patchSequelize(onQuery) {
+    const sequelize = tryRequire('sequelize');
+    const Sequelize = sequelize?.Sequelize || sequelize?.default || sequelize;
+    if (!Sequelize?.prototype?.query)
+        return () => undefined;
+    if (Sequelize.prototype.query.__nugiPatched)
+        return () => undefined;
+    const orig = Sequelize.prototype.query;
+    async function patchedSequelizeQuery(sql, options) {
+        const text = typeof sql === 'string'
+            ? sql
+            : sql?.query || sql?.sql || extractSql(sql) || String(sql);
+        const start = Date.now();
+        let success = true;
+        let error;
+        let dbError;
+        let cause;
+        try {
+            return await orig.call(this, sql, options);
+        }
+        catch (err) {
+            success = false;
+            cause = err;
+            dbError = (0, db_error_1.normalizeDbError)(err, { orm: 'sequelize', sql: text });
+            error = dbError.message;
+            throw err;
+        }
+        finally {
+            safeEmit(onQuery, {
+                query: text,
+                durationMs: Date.now() - start,
+                orm: 'sequelize',
+                success,
+                error,
+                dbError,
+                cause,
+            });
+        }
+    }
+    patchedSequelizeQuery.__nugiPatched = true;
+    Sequelize.prototype.query = patchedSequelizeQuery;
+    return () => {
+        Sequelize.prototype.query = orig;
+    };
+}
+/**
+ * Best-effort TypeORM patch: EntityManager.query / DataSource.query.
+ * QueryFailedError carries .query + .stack.
+ */
+function patchTypeOrm(onQuery) {
+    const typeorm = tryRequire('typeorm');
+    if (!typeorm)
+        return () => undefined;
+    const stops = [];
+    const patchQueryMethod = (proto, ormLabel) => {
+        if (!proto?.query || proto.query.__nugiPatched)
+            return;
+        const orig = proto.query;
+        async function patched(query, parameters) {
+            const start = Date.now();
+            let success = true;
+            let error;
+            let dbError;
+            let cause;
+            try {
+                return await orig.call(this, query, parameters);
+            }
+            catch (err) {
+                success = false;
+                cause = err;
+                dbError = (0, db_error_1.normalizeDbError)(err, { orm: 'typeorm', sql: query });
+                error = dbError.message;
+                throw err;
+            }
+            finally {
+                safeEmit(onQuery, {
+                    query: typeof query === 'string' ? query : String(query),
+                    durationMs: Date.now() - start,
+                    orm: ormLabel,
+                    success,
+                    error,
+                    dbError,
+                    cause,
+                });
+            }
+        }
+        patched.__nugiPatched = true;
+        proto.query = patched;
+        stops.push(() => {
+            proto.query = orig;
+        });
+    };
+    try {
+        if (typeorm.DataSource?.prototype)
+            patchQueryMethod(typeorm.DataSource.prototype, 'typeorm');
+    }
+    catch {
+        /* ignore */
+    }
+    try {
+        if (typeorm.EntityManager?.prototype)
+            patchQueryMethod(typeorm.EntityManager.prototype, 'typeorm');
+    }
+    catch {
+        /* ignore */
+    }
+    return () => stops.forEach((s) => s());
+}
+//# sourceMappingURL=query-capture.js.map

package/dist/instrumentation/query-capture.js.map

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

package/dist/internal/breadcrumbs.d.ts

@@ -0,0 +1,32 @@
+import { Attributes, Severity } from '../types';
+/**
+ * A single breadcrumb — a lightweight trail entry (console output, log, HTTP
+ * call, etc.) captured leading up to an error, mirroring Sentry's model.
+ */
+export interface Breadcrumb {
+    /** ISO-8601 timestamp. */
+    timestamp: string;
+    /** Coarse category: 'console' | 'log' | 'http' | 'navigation' | custom. */
+    type: string;
+    /** Severity of the breadcrumb. */
+    level: Severity;
+    /** Human-readable message. */
+    message: string;
+    /** Optional structured data. */
+    data?: Attributes;
+}
+/**
+ * Fixed-capacity ring buffer of breadcrumbs. Oldest entries are dropped once
+ * capacity is reached. A snapshot is attached to error events so the trail that
+ * led to a failure travels with it.
+ */
+export declare class BreadcrumbBuffer {
+    private readonly capacity;
+    private readonly items;
+    constructor(capacity: number);
+    add(crumb: Breadcrumb): void;
+    /** Oldest-first snapshot suitable for attaching to an event. */
+    snapshot(): Breadcrumb[];
+    clear(): void;
+}
+//# sourceMappingURL=breadcrumbs.d.ts.map

package/dist/internal/breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/internal/breadcrumbs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,QAAQ,CAAC;IAChB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAEb,QAAQ,EAAE,MAAM;IAE7C,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQ5B,gEAAgE;IAChE,QAAQ,IAAI,UAAU,EAAE;IAIxB,KAAK,IAAI,IAAI;CAGd"}