@smoothbricks/lmao 0.2.2 → 0.2.3

package/dist/lib/codegen/fixedPositionWriterGenerator.d.ts

@@ -1,44 +1,30 @@
 /**
- * Runtime code generation for TagWriter and ResultWriter classes
+ * Fixed-position TagWriter and ResultWriter classes.
+ *
+ * TagWriter uses source-authored constructors and schema-driven prototype methods so
+ * Hermes can compile the implementation ahead of time. ResultWriter selects between a
+ * compiled renderer (new Function, string-codegen runtimes) and a closure-composed
+ * materializer (workerd-safe, no eval) via activeMaterializerMode().
  *
  * These classes provide fluent setter methods that write to a fixed position in a SpanBuffer:
  * - TagWriter: writes to position 0 (span-start row) via ctx.tag.userId("123")
  * - ResultWriter: writes to position 1 (result row) via ctx.ok(data).userId("123")
  *
- * Both share the same codegen since they only differ in:
- * 1. The fixed position (0 vs 1)
- * 2. ResultWriter has additional _result/_error properties
- *
  * WHY Fixed Positions:
  * - Row 0: span-start entry (written at span creation, attributes set via ctx.tag)
  * - Row 1: span-end entry (written at ctx.ok()/ctx.err(), attributes set via fluent API)
  *
- * Pattern:
- * - Each setter calls this._buffer.columnName(this._pos, value) and returns this
- * - Fluent chaining: ctx.tag.userId("123").requestId("abc")
- * - Zero allocation: returns same object reference
+ * Each wrapper stores only the SpanContext state identity. Setters write through
+ * `state._spanBuffer` to their embedded row and return the same wrapper for fluent chaining.
  */
+import { type SchemaEnumLookupDescriptor } from '../enumMetadata.js';
+import type { MessageLayoutFamily, MessagePhysicalLayout } from '../runtimeHint.js';
 import type { InferSchema, LogSchema } from '../schema/types.js';
+import type { TimestampAppendPrimitive } from '../traceRoot.js';
 import type { AnySpanBuffer } from '../types.js';
-/**
- * Extension options for injecting custom code into generated writer classes.
- */
+/** Extension methods injected into a generated fixed-position writer class. */
 export interface FixedPositionWriterExtension {
-    /**
-     * Additional code to add to the constructor (after buffer assignment).
-     * Has access to `this` and constructorParams.
-     */
-    constructorCode?: string;
-    /**
-     * Additional methods to add to the class body.
-     */
     methods?: string;
-    /**
-     * Constructor parameters beyond buffer.
-     * Added AFTER buffer in the constructor signature.
-     * @example "result, isError"
-     */
-    constructorParams?: string;
 }
 /**
  * TagWriter interface - fluent setter API for span-start attributes (row 0)
@@ -55,43 +41,35 @@ export type TagWriter<T extends LogSchema> = {
 } & {
     [K in keyof InferSchema<T>]: (value: InferSchema<T>[K]) => TagWriter<T>;
 };
-/**
- * ResultWriter interface - fluent setter API for result attributes (row 1)
- *
- * Includes _result and _error properties for accessing the return value or error.
- */
+/** SpanContext-owned hot writer state shared by logger, tag, and result writers. */
+export interface WriterState {
+    /** Immutable span root used by fixed row 0/1 writers. */
+    readonly _spanBuffer: AnySpanBuffer;
+    /** Mutable active buffer used by append writers and updated on overflow. */
+    _buffer: AnySpanBuffer;
+    /** Plan-bound timestamp append operand retained by the SpanContext. */
+    readonly _appendLogEntry: TimestampAppendPrimitive;
+    readonly _physicalLayoutPlan: {
+        readonly ResultWriterClass: ResultWriterConstructor;
+        readonly enumLookup: SchemaEnumLookupDescriptor;
+    };
+    /** Append one dynamic row, centralizing overflow and active-buffer updates. */
+    _appendWriterEntry(entryType: number): number;
+}
+/** Result-row writer with schema-specific fluent setters. */
 export type ResultWriter<T extends LogSchema, R = unknown, E = unknown> = {
-    /**
-     * The successful result value (set by ctx.ok(data))
-     */
-    readonly _result: R | undefined;
-    /**
-     * The error value (set by ctx.err(error))
-     */
-    readonly _error: E | undefined;
-    /**
-     * Whether this is an error result
-     */
-    readonly _isError: boolean;
-    /**
-     * Bulk set multiple attributes at once.
-     */
+    /** Phantom parameters preserve the public generic contract without duplicating result values. */
+    readonly _resultType?: R;
+    readonly _errorType?: E;
     with(attributes: Partial<InferSchema<T>>): ResultWriter<T, R, E>;
-    /**
-     * Set the result-row message (row 1).
-     */
     message(text: string): ResultWriter<T, R, E>;
-    /**
-     * Set the result-row source line (row 1).
-     */
     line(lineNumber: number): ResultWriter<T, R, E>;
-    /**
-     * Set the reserved `uint64_value` column for this result row.
-     */
     uint64_value(value: bigint): ResultWriter<T, R, E>;
 } & {
     [K in keyof InferSchema<T>]: (value: InferSchema<T>[K]) => ResultWriter<T, R, E>;
 };
+export type TagWriterConstructor<T extends LogSchema> = new (state: WriterState) => TagWriter<T>;
+export type ResultWriterConstructor = new <T extends LogSchema = LogSchema, R = unknown, E = unknown>(state: WriterState) => ResultWriter<T, R, E>;
 /**
  * Generate the complete fixed-position writer class code.
  *
@@ -101,47 +79,31 @@ export type ResultWriter<T extends LogSchema, R = unknown, E = unknown> = {
  * @param extension - Optional extension for constructor code, methods, params
  * @returns JavaScript code string for the class
  */
-export declare function generateFixedPositionWriterClass(schema: LogSchema, position: number, className: string, extension?: FixedPositionWriterExtension): string;
-/**
- * Generate TagWriter class code for a schema.
- * TagWriter writes to position 0 (span-start row).
- */
-export declare function generateTagWriterClass(schema: LogSchema): string;
+export declare function generateFixedPositionWriterClass(schema: LogSchema, position: number, className: string, extension?: FixedPositionWriterExtension, eagerColumns?: readonly string[], enumLookup?: SchemaEnumLookupDescriptor): string;
 /**
  * Get or create a cached TagWriter class for a schema.
  *
  * @param schema - Tag attribute schema
  * @returns TagWriter class constructor
  */
-export declare function getTagWriterClass<T extends LogSchema>(schema: T): new (buffer: AnySpanBuffer) => TagWriter<T>;
-/**
- * Create a TagWriter instance for a buffer.
- *
- * @param schema - Tag attribute schema
- * @param buffer - SpanBuffer to write to
- * @returns TagWriter instance bound to position 0
- */
-export declare function createTagWriter<T extends LogSchema>(schema: T, buffer: AnySpanBuffer): TagWriter<T>;
+export declare function getTagWriterClass<T extends LogSchema>(schema: T, eagerColumns?: readonly string[], enumLookup?: SchemaEnumLookupDescriptor): TagWriterConstructor<T>;
+/** Create a TagWriter bound to an existing SpanContext writer state. */
+export declare function createTagWriter<T extends LogSchema>(schema: T, state: WriterState): TagWriter<T>;
 /**
  * Generate ResultWriter class code for a schema.
  * ResultWriter writes to position 1 (result row).
  */
-export declare function generateResultWriterClass(schema: LogSchema): string;
+export declare function generateResultWriterClass(schema: LogSchema, messageLayoutFamily?: MessageLayoutFamily, _messagePhysicalLayout?: MessagePhysicalLayout, eagerColumns?: readonly string[], enumLookup?: SchemaEnumLookupDescriptor): string;
 /**
  * Get or create a cached ResultWriter class for a schema.
  *
- * @param schema - Tag attribute schema
- * @returns ResultWriter class constructor
- */
-export declare function getResultWriterClass<T extends LogSchema>(schema: T): new <R = unknown, E = unknown>(buffer: AnySpanBuffer, resultOrError: unknown, isError: boolean) => ResultWriter<T, R, E>;
-/**
- * Create a ResultWriter instance for a buffer.
+ * Selects the compiled or closure-composed materializer via activeMaterializerMode();
+ * cache keys are mode-prefixed so an override flip never returns the wrong kind.
  *
  * @param schema - Tag attribute schema
- * @param buffer - SpanBuffer to write to
- * @param resultOrError - The result value or error
- * @param isError - Whether this is an error result
- * @returns ResultWriter instance bound to position 1
+ * @returns ResultWriter class constructor
  */
-export declare function createResultWriter<T extends LogSchema, R = unknown, E = unknown>(schema: T, buffer: AnySpanBuffer, resultOrError: R | E, isError: boolean): ResultWriter<T, R, E>;
+export declare function getResultWriterClass<T extends LogSchema>(schema: T, messageLayoutFamily?: MessageLayoutFamily, messagePhysicalLayout?: MessagePhysicalLayout, eagerColumns?: readonly string[], enumLookup?: SchemaEnumLookupDescriptor): ResultWriterConstructor;
+/** Create a ResultWriter bound to an existing SpanContext writer state. */
+export declare function createResultWriter<T extends LogSchema, R = unknown, E = unknown>(schema: T, state: WriterState): ResultWriter<T, R, E>;
 //# sourceMappingURL=fixedPositionWriterGenerator.d.ts.map

package/dist/lib/codegen/fixedPositionWriterGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixedPositionWriterGenerator.d.ts","sourceRoot":"","sources":["../../../src/lib/codegen/fixedPositionWriterGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,SAAS,IAAI;IAC3C;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACxD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;CAC3C,GAAG;KAID,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;CACxE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACxE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjE;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7C;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;CACpD,GAAG;KAID,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CACjF,CAAC;AAkFF;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,4BAA4B,GACvC,MAAM,CA6ER;AAiCD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,MAAM,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,CAsB7G;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,CAGnG;AA0CD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,SAAS,EACtD,MAAM,EAAE,CAAC,GACR,KAAK,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC9B,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE,OAAO,KACb,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAsBzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC9E,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,CAAC,GAAG,CAAC,EACpB,OAAO,EAAE,OAAO,GACf,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAGvB"}
+{"version":3,"file":"fixedPositionWriterGenerator.d.ts","sourceRoot":"","sources":["../../../src/lib/codegen/fixedPositionWriterGenerator.ts"],"names":[],"mappings":"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"}