@dxos/log 0.8.4-main.fbb7a13 → 0.8.4-main.fcc0d83b33

package/dist/types/src/dbg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbg.d.ts","sourceRoot":"","sources":["../../../src/dbg.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,GAAG,EAAE;IAChB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC;CASxC,CAAC"}

package/dist/types/src/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/decorators.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAI3C,eAAO,MAAM,wBAAwB,GAClC,KAAK,UAAU,MACf,OAAO,KAAK,EAAE,OAAO,KAAK,EAAE,OAAO,YAAY,KAAG,eAwClD,CAAC;AAEJ,eAAO,MAAM,0BAA0B,GACpC,KAAK,UAAU,MACf,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChC,MAAM,MAAM,EACZ,IAAI,CAAC,EACL,OAAM;IAAE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;CAAO,KAC7E,CA6CF,CAAC"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/decorators.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAI3C,eAAO,MAAM,wBAAwB,QAC7B,UAAU,aACR,KAAK,SAAS,KAAK,SAAS,YAAY,KAAG,eAwClD,CAAC;AAEJ,eAAO,MAAM,0BAA0B,QAC/B,UAAU,MACf,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,QAC1B,MAAM,MACR,CAAC,SACC;IAAE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;CAAE,KACxE,CA6CF,CAAC"}

package/dist/types/src/environment.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Options for {@link inferEnvironmentName}.
+ * Tests pass a custom `scope` to simulate worker / window globals.
+ */
+export type InferEnvironmentNameOptions = {
+    scope?: unknown;
+};
+/**
+ * Infer a writer/environment identifier from the current execution context.
+ *
+ * Safe to invoke in any JS runtime — never throws. Falls back to `unknown::<suffix>`
+ * when the runtime can't be classified.
+ *
+ * Format is always three colon-separated segments: `<scope>:<name>:<suffix>`.
+ * - `scope` — `tab | dedicated-worker | shared-worker | service-worker | cf-worker | node | unknown`.
+ * - `name` — `location.origin` for tabs, `self.name` for browser workers, `process.pid`
+ *   for node, empty for cf-workers / service workers / anonymous workers.
+ *   Note that `name` may itself contain `:` (e.g. `http://localhost:5173`); when parsing,
+ *   take the first segment as scope and the last as suffix, and treat everything in
+ *   between as the name.
+ * - `suffix` — 6-char random; stable per-tab via `sessionStorage`, fresh per worker / process instance.
+ */
+export declare const inferEnvironmentName: (options?: InferEnvironmentNameOptions) => string;
+//# sourceMappingURL=environment.d.ts.map

package/dist/types/src/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/environment.ts"],"names":[],"mappings":"AAqEA;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,aAAa,2BAA2B,KAAQ,MAoChF,CAAC"}

package/dist/types/src/environment.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=environment.test.d.ts.map

package/dist/types/src/environment.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.test.d.ts","sourceRoot":"","sources":["../../../src/environment.test.ts"],"names":[],"mappings":""}

package/dist/types/src/experimental/ownership.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../../src/experimental/ownership.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AAEH,qBAAa,cAAc;IAIhB,MAAM,EAAE,GAAG;IACX,MAAM,CAAC,EAAE,cAAc;IAJzB,QAAQ,EAAE,GAAG,CAAC;gBAGZ,MAAM,EAAE,GAAG,EACX,MAAM,CAAC,EAAE,cAAc,YAAA;IAGhC,OAAO;IAYP,CAAC,OAAO,CAAC,MAAM,CAAC;;;;;CAOjB;AAuBD,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC;kBAQvD,GAAG,EAAE;MAS7B;AAED,eAAO,MAAM,SAAS,GAAI,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,SAGzF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,SAAS,GAAG,QAAY,CAAC"}
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../../src/experimental/ownership.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AAEH,qBAAa,cAAc;IAIhB,MAAM,EAAE,GAAG;IACX,MAAM,CAAC,EAAE,cAAc;IAJzB,QAAQ,EAAE,GAAG,CAAC;IAErB,YACS,MAAM,EAAE,GAAG,EACX,MAAM,CAAC,EAAE,cAAc,YAAA,EAC5B;IAEJ,OAAO,QAUN;IAED,CAAC,OAAO,CAAC,MAAM,CAAC;QAEZ,SAAS;QACT,IAAI;QACJ,MAAM;MAET;CACF;AAuBD,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC;kBAQvD,GAAG,EAAE;MAS7B;AAED,eAAO,MAAM,SAAS,WAAY,GAAG,eAAe,MAAM,cAAc,kBAAkB,SAGzF,CAAC;AAEF,eAAO,MAAM,wBAAwB,YAAa,GAAG,QAAY,CAAC"}

package/dist/types/src/index.d.ts

@@ -1,12 +1,16 @@
-import omit from 'lodash.omit';
-import { pick } from '@dxos/util';
+import { omit, pick } from '@dxos/util';
 export { omit, pick };
 export * from './config';
 export * from './context';
+export * from './environment';
+export * from './jsonl';
 export * from './log';
 export { parseFilter } from './options';
 export * from './processors';
 export * from './scope';
-export type * from './meta';
+export type { CallMetadata } from './meta';
+export { LOG_META_MARKER, isLogMeta } from './meta';
+export { dbg } from './dbg';
+export * from './log-buffer';
 export { getCurrentOwnershipScope } from './experimental/ownership';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,IAAI,MAAM,aAAa,CAAC;AAE/B,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAEtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,mBAAmB,QAAQ,CAAC;AAE5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAEtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types/src/jsonl.d.ts

@@ -0,0 +1,53 @@
+import { type LogEntry } from './context';
+/**
+ * Compact JSONL log record with short property names for small serialized size.
+ *
+ * Field names are intentionally one character to keep on-disk / on-wire size minimal —
+ * a single record can be emitted thousands of times per session.
+ */
+export type LogRecord = {
+    /** ISO timestamp. */
+    t: string;
+    /** Level letter (D, V, I, W, E). */
+    l: string;
+    /** Message. */
+    m: string;
+    /** File path. */
+    f?: string;
+    /** Line number. */
+    n?: number;
+    /** Object/scope from which the log was emitted. */
+    o?: string;
+    /** Error stack. */
+    e?: string;
+    /** Context JSON (already a string of pre-stringified flat key/values). */
+    c?: string;
+    /** Environment identifier (see {@link inferEnvironmentName}). */
+    i?: string;
+};
+/**
+ * Options for {@link serializeToJsonl}.
+ */
+export type SerializeToJsonlOptions = {
+    /**
+     * Environment identifier embedded in the record's `i` field.
+     * Use {@link inferEnvironmentName} for a default that disambiguates tabs and workers.
+     */
+    env?: string;
+};
+/**
+ * Serialize a {@link LogEntry} to a single compact JSON line (no trailing newline).
+ *
+ * Returns `undefined` for entries at TRACE level — callers can use this to skip them.
+ *
+ * The output is compatible with newline-delimited JSON (NDJSON / JSONL): join multiple
+ * results with `\n` for a stream / file representation.
+ *
+ * Context is taken from {@link LogEntry.computedContext}, which has already flattened
+ * nested objects to strings (see `stringifyOneLevel` in `context.ts`), so the resulting
+ * `c` field is a JSON string of a flat `Record<string, primitive>` map. The function
+ * does **not** truncate context — callers that care about line size should set their own
+ * cap before calling, or trim post-hoc.
+ */
+export declare const serializeToJsonl: (entry: LogEntry, opts?: SerializeToJsonlOptions) => string | undefined;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/types/src/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/jsonl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,oCAAoC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,iBAAiB;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,UAAW,QAAQ,SAAQ,uBAAuB,KAAQ,MAAM,GAAG,SA4C/F,CAAC"}

package/dist/types/src/jsonl.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jsonl.test.d.ts.map

package/dist/types/src/jsonl.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.test.d.ts","sourceRoot":"","sources":["../../../src/jsonl.test.ts"],"names":[],"mappings":""}

package/dist/types/src/log-buffer.d.ts

@@ -0,0 +1,20 @@
+import { type LogProcessor } from './context';
+/**
+ * Captures recent log entries in a circular buffer for debug log dump.
+ */
+export declare class LogBuffer {
+    private readonly _buffer;
+    constructor(size?: number);
+    /**
+     * Log processor that can be registered with `log.runtimeConfig.processors`.
+     * Captures every level except TRACE (does not apply `shouldLog` / filter; use for full debug dumps).
+     */
+    readonly logProcessor: LogProcessor;
+    /** Number of entries currently in the buffer. */
+    get size(): number;
+    /** Discard all buffered entries. */
+    clear(): void;
+    /** Serialize buffer contents as NDJSON (newline-delimited JSON). */
+    serialize(): string;
+}
+//# sourceMappingURL=log-buffer.d.ts.map

package/dist/types/src/log-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-buffer.d.ts","sourceRoot":"","sources":["../../../src/log-buffer.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAM7D;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,YAAY,IAAI,SAAsB,EAErC;IAED;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAyCjC;IAEF,iDAAiD;IACjD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oCAAoC;IACpC,KAAK,IAAI,IAAI,CAEZ;IAED,oEAAoE;IACpE,SAAS,IAAI,MAAM,CAMlB;CACF"}

package/dist/types/src/log-buffer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-buffer.test.d.ts.map

package/dist/types/src/log-buffer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-buffer.test.d.ts","sourceRoot":"","sources":["../../../src/log-buffer.test.ts"],"names":[],"mappings":""}

package/dist/types/src/log.d.ts

@@ -3,6 +3,8 @@ import { type LogContext, type LogProcessor } from './context';
 import { type CallMetadata } from './meta';
 /**
  * Accessible from browser console.
+ * Example: `DX_LOG.config({ filter: 'ERROR' })`
+ * NOTE: File level filtering isn't supported in storybooks.
  */
 declare global {
     const DX_LOG: Log;
@@ -15,20 +17,61 @@ type LogFunction = (message: string, context?: LogContext, meta?: CallMetadata)
  * Logging methods.
  */
 export interface LogMethods {
-    config: (options: LogOptions) => Log;
+    config: (options?: LogOptions) => Log;
     addProcessor: (processor: LogProcessor, addDefault?: boolean) => () => void;
+    /**
+     * Log at `trace` level.
+     *
+     * Generally not surfaced to the developer and not captured in a log file.
+     */
     trace: LogFunction;
+    /**
+     * Log at `debug` level.
+     * Generally not surfaced to the developer and captured in a log file.
+     */
     debug: LogFunction;
+    /**
+     * Log at `verbose` level.
+     * Generally not surfaced to the developer and not captured in a log file.
+     */
     verbose: LogFunction;
+    /**
+     * Log at `info` level.
+     * Generally surfaced to the developer and captured in a log file.
+     */
     info: LogFunction;
+    /**
+     * Log at `warn` level.
+     * Generally surfaced to the developer and captured in a log file.
+     */
     warn: LogFunction;
+    /**
+     * Log at `error` level.
+     * Generally surfaced to the developer and captured in a log file.
+     */
     error: LogFunction;
+    /**
+     * Log an error and its stack trace at an `error` level.
+     * Generally surfaced to the developer and captured in a log file.
+     */
     catch: (error: Error | any, context?: LogContext, meta?: CallMetadata) => void;
+    /**
+     * Decorator to log method parameters and return value at the `info` level.
+     */
     method: (arg0?: never, arg1?: never, meta?: CallMetadata) => MethodDecorator;
+    /**
+     * Wrapper to log function parameters and return value at the `info` level.
+     */
     function: <F extends (...args: any[]) => any>(name: string, fn: F, opts?: {
         transformOutput?: (result: ReturnType<F>) => Promise<any> | any;
     }) => F;
+    /**
+     * Log a horizontal rule at the `info` level.
+     */
     break: () => void;
+    /**
+     * Log a stack trace at the `info` level.
+     */
     stack: (message?: string, context?: never, meta?: CallMetadata) => void;
 }
 /**

package/dist/types/src/log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/log.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAG3C;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,MAAM,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,GAAG,CAAC;IACrC,YAAY,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IAE5E,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/E,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,eAAe,CAAC;IAC7E,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,EACL,IAAI,CAAC,EAAE;QACL,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;KACjE,KACE,CAAC,CAAC;IAEP,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CACzE;AA+GD;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,GAAkD,CAAC;AAKrE;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,GAAG,EAAE,OAAO,GAAG,SAU5C,CAAC"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/log.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,KAAK,UAAU,EAAY,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAG3C;;;;GAIG;AACH,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,MAAM,MAAM,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,KAAK,GAAG,CAAC;IACtC,YAAY,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IAE5E;;;;OAIG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;;OAGG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/E;;OAEG;IACH,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,eAAe,CAAC;IAE7E;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,EACL,IAAI,CAAC,EAAE;QACL,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;KACjE,KACE,CAAC,CAAC;IAEP;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CACzE;AAwGD;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,GAAkD,CAAC;AAKrE;;GAEG;AACH,eAAO,MAAM,KAAK,WAAY,GAAG,SAAS,GAAG,SAU5C,CAAC"}

package/dist/types/src/meta.d.ts

@@ -1,9 +1,23 @@
 /**
- * Metadata injected b y the log transform plugin.
+ * Marker key + value injected on every {@link CallMetadata} object by the log transform plugin.
+ * Used by {@link isLogMeta} to detect a log-meta argument at runtime (e.g. for variadic
+ * `param_index: 'last'` callees that don't have a fixed meta slot).
+ */
+export declare const LOG_META_MARKER = "~LogMeta";
+/**
+ * Metadata injected by the log transform plugin.
  *
  * Field names are intentionally short to reduce the size of the generated code.
  */
 export interface CallMetadata {
+    /**
+     * Marker tag — when present, equal to {@link LOG_META_MARKER} ({@link `'~LogMeta'`}).
+     * Injected by the log transform plugin on every emitted meta object so that {@link isLogMeta}
+     * can distinguish a meta argument from a regular user-supplied value at runtime.
+     * Optional because hand-written `CallMetadata` literals (decorators, RPC mappers, tests)
+     * don't need the marker — they are recognized by position in the call signature.
+     */
+    '~LogMeta'?: typeof LOG_META_MARKER;
     /**
      * File name.
      */
@@ -27,4 +41,9 @@ export interface CallMetadata {
      */
     A?: string[];
 }
+/**
+ * Type guard: `true` when `value` is a {@link CallMetadata} object emitted by the log transform plugin.
+ * Detection is based on the presence of the {@link LOG_META_MARKER} marker key/value.
+ */
+export declare const isLogMeta: (value: unknown) => value is CallMetadata;
 //# sourceMappingURL=meta.d.ts.map

package/dist/types/src/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IAEV;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IAEV;;;OAGG;IACH,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC;IAEnB;;;OAGG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAExC;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;CACd"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,eAAe,CAAC;IAEpC;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IAEV;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IAEV;;;OAGG;IACH,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC;IAEnB;;;OAGG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAExC;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,KAAK,IAAI,YAMnD,CAAC"}

package/dist/types/src/platform/browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/platform/browser/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,eAAO,MAAM,WAAW,GAAI,WAAW,MAAM,KAAG,UAAU,GAAG,SAoB5D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/platform/browser/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,eAAO,MAAM,WAAW,cAAe,MAAM,KAAG,UAAU,GAAG,SAoB5D,CAAC"}

package/dist/types/src/platform/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/platform/node/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,WAAW,MAAM,KAAG,UAAU,GAAG,SAY5D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/platform/node/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,WAAW,cAAe,MAAM,KAAG,UAAU,GAAG,SAY5D,CAAC"}

package/dist/types/src/processors/browser-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/browser-processor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AA8I/E,eAAO,MAAM,iBAAiB,EAAE,YAAuF,CAAC"}
+{"version":3,"file":"browser-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/browser-processor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AAmI/E,eAAO,MAAM,iBAAiB,EAAE,YAAuF,CAAC"}

package/dist/types/src/processors/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/processors/common.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,WAUnD,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/processors/common.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,aAAc,MAAM,WAUnD,CAAC"}

package/dist/types/src/processors/console-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/console-processor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAkB,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AAa/E,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,EAAE,eAAU,EAAE,eAAa,WAGhE,CAAC;AAIF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;AAE1F,eAAO,MAAM,iBAAiB,EAAE,SAkC/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SAM7B,CAAC;AAKF,eAAO,MAAM,iBAAiB,EAAE,YAkC/B,CAAC"}
+{"version":3,"file":"console-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/console-processor.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAkB,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AAW/E,eAAO,MAAM,QAAQ,UAAW,MAAM,6CAGrC,CAAC;AAIF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;AAE1F,eAAO,MAAM,iBAAiB,EAAE,SAkC/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SAM7B,CAAC;AAKF,eAAO,MAAM,iBAAiB,EAAE,YA6B/B,CAAC"}

package/dist/types/src/processors/file-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/file-processor.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AAO/E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,gCAIjC;IACD,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB,KAAG,YAoDH,CAAC;AAWF,eAAO,MAAM,cAAc,EAAE,YAG3B,CAAC"}
+{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/file-processor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,YAAY,CAAC;AAK1D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,mCAI7B;IACD,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB,KAAG,YAsDH,CAAC;AAWF,eAAO,MAAM,cAAc,EAAE,YAG3B,CAAC"}

package/dist/types/src/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/scope.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,aAAa,kBAAkB,SAGxF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,GAAG,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAkBrE,CAAC"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/scope.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,WAAY,GAAG,eAAe,MAAM,eAAe,kBAAkB,SAGxF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,UAAW,GAAG,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAkBrE,CAAC"}