@telora/daemon-core 0.2.5

package/dist/stream-json.d.ts.map

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

package/dist/stream-json.js

@@ -0,0 +1,298 @@
+/**
+ * Stream-JSON protocol module -- shared core for Claude Code interactive sessions.
+ *
+ * This is the canonical implementation used by both the Telora daemon and factory
+ * engines. It handles parsing NDJSON output from `--output-format stream-json`
+ * and writing messages for `--input-format stream-json`.
+ *
+ * Wire format: newline-delimited JSON (one JSON object per line).
+ *
+ * All inbound events are validated against Zod schemas before routing.
+ * Malformed events are logged, counted, and skipped -- never crash the parser.
+ */
+import { EventEmitter } from 'node:events';
+import { z } from 'zod';
+// ── Zod Schemas ──────────────────────────────────────────────────────────────
+const TokenUsageSchema = z.object({
+    input_tokens: z.number(),
+    output_tokens: z.number(),
+    cache_creation_input_tokens: z.number().optional(),
+    cache_read_input_tokens: z.number().optional(),
+});
+const TextBlockSchema = z.object({ type: z.literal('text'), text: z.string() });
+const ToolUseBlockSchema = z.object({
+    type: z.literal('tool_use'),
+    id: z.string(),
+    name: z.string(),
+    input: z.record(z.string(), z.unknown()),
+});
+const ThinkingBlockSchema = z.object({
+    type: z.literal('thinking'),
+    thinking: z.string(),
+    signature: z.string(),
+});
+const TextDeltaSchema = z.object({ type: z.literal('text_delta'), text: z.string() });
+const InputJsonDeltaSchema = z.object({ type: z.literal('input_json_delta'), partial_json: z.string() });
+const ContentBlockSchema = z.discriminatedUnion('type', [TextBlockSchema, ToolUseBlockSchema, ThinkingBlockSchema]);
+// ── System Events ────────────────────────────────────────────────────────────
+const SystemInitEventSchema = z.object({
+    type: z.literal('system'),
+    subtype: z.literal('init'),
+    uuid: z.string(),
+    session_id: z.string(),
+    cwd: z.string(),
+    model: z.string(),
+    tools: z.array(z.string()),
+    mcp_servers: z.array(z.object({ name: z.string(), status: z.string() })),
+    permissionMode: z.string(),
+});
+const TeammateEventSchema = z.object({
+    type: z.literal('system'),
+    subtype: z.enum(['teammate_spawned', 'teammate_idle', 'teammate_completed']),
+    uuid: z.string(),
+    session_id: z.string(),
+    agent_id: z.string(),
+    agent_name: z.string(),
+    team_id: z.string(),
+    agent_type: z.string().optional(),
+    result: z.string().optional(),
+    is_error: z.boolean().optional(),
+});
+// ── Generic System Events (compact_boundary, status, etc.) ──────────────────
+//
+// System events beyond init and teammate lifecycle. Uses passthrough to
+// accommodate varying payloads per subtype (compact_metadata, status info, etc.).
+const GenericSystemEventSchema = z.object({
+    type: z.literal('system'),
+    subtype: z.string(),
+    uuid: z.string(),
+    session_id: z.string(),
+}).passthrough();
+// ── User Text Messages (compaction summaries, etc.) ─────────────────────────
+//
+// User messages with text content (not tool_result). These appear during
+// context compaction and other system-generated user messages.
+const UserTextContentSchema = z.object({
+    type: z.literal('text'),
+    text: z.string(),
+});
+const UserTextMessageSchema = z.object({
+    type: z.literal('user'),
+    uuid: z.string(),
+    session_id: z.string(),
+    message: z.object({
+        role: z.literal('user'),
+        content: z.array(UserTextContentSchema),
+    }),
+    parent_tool_use_id: z.string().nullable().optional(),
+});
+// ── Stream Events (loosely validated) ────────────────────────────────────────
+// Raw stream events from the Claude API are high-volume and may add fields
+// across versions. We validate the outer envelope strictly but use passthrough
+// on the inner event to avoid breaking on new API fields.
+const RawStreamEventSchema = z.object({ type: z.string() }).passthrough();
+const StreamEventSchema = z.object({
+    type: z.literal('stream_event'),
+    event: RawStreamEventSchema,
+    parent_tool_use_id: z.string().nullable(),
+    uuid: z.string(),
+    session_id: z.string(),
+});
+// ── Assistant Message ────────────────────────────────────────────────────────
+const AssistantMessageSchema = z.object({
+    type: z.literal('assistant'),
+    uuid: z.string(),
+    session_id: z.string(),
+    message: z.object({
+        id: z.string(),
+        type: z.literal('message'),
+        role: z.literal('assistant'),
+        content: z.array(ContentBlockSchema),
+        model: z.string(),
+        stop_reason: z.string().nullable(),
+        usage: TokenUsageSchema,
+    }),
+    parent_tool_use_id: z.string().nullable(),
+});
+// ── Result Events ────────────────────────────────────────────────────────────
+// Result schema accepts both success and error results. Claude Code emits
+// API errors (500s, rate limits) as subtype:"success" + is_error:true, which
+// doesn't fit a strict success/error split. Use a single permissive schema
+// and let downstream code branch on is_error.
+const ResultSchema = z.object({
+    type: z.literal('result'),
+    subtype: z.string(),
+    is_error: z.boolean(),
+    duration_ms: z.number(),
+    duration_api_ms: z.number(),
+    num_turns: z.number(),
+    total_cost_usd: z.number().optional(),
+    usage: TokenUsageSchema.optional(),
+    result: z.string().optional(),
+    errors: z.array(z.string()).optional(),
+}).passthrough();
+// Keep named aliases for backward compatibility in the union
+const ResultSuccessSchema = ResultSchema;
+const ResultErrorSchema = ResultSchema;
+// ── User Messages (tool_result) ─────────────────────────────────────────────
+const ToolResultContentSchema = z.object({
+    type: z.literal('tool_result'),
+    tool_use_id: z.string(),
+    content: z.union([z.string(), z.array(z.record(z.string(), z.unknown()))]),
+});
+const UserToolResultSchema = z.object({
+    type: z.literal('user'),
+    uuid: z.string(),
+    session_id: z.string(),
+    message: z.object({
+        role: z.literal('user'),
+        content: z.array(ToolResultContentSchema),
+    }),
+    parent_tool_use_id: z.string().nullable().optional(),
+});
+// ── Rate Limit Events ─────────────────────────────────────────────────────────
+const RateLimitInfoSchema = z.object({
+    status: z.string(),
+    resetsAt: z.union([z.string(), z.number()]).optional(),
+    rateLimitType: z.string().optional(),
+    overageStatus: z.string().optional(),
+    overageDisabledReason: z.string().nullable().optional(),
+    isUsingOverage: z.boolean().optional(),
+}).passthrough();
+const RateLimitEventSchema = z.object({
+    type: z.literal('rate_limit_event'),
+    rate_limit_info: RateLimitInfoSchema,
+    uuid: z.string(),
+    session_id: z.string(),
+});
+// ── Top-level discriminated union ────────────────────────────────────────────
+//
+// We cannot use z.discriminatedUnion across both 'type' and 'subtype' in a
+// single call, so we use z.union with the most specific schemas first.
+// System events split on subtype, result events split on subtype.
+const OutputEventSchema = z.union([
+    SystemInitEventSchema,
+    TeammateEventSchema,
+    GenericSystemEventSchema,
+    StreamEventSchema,
+    AssistantMessageSchema,
+    UserToolResultSchema,
+    UserTextMessageSchema,
+    ResultSuccessSchema,
+    ResultErrorSchema,
+    RateLimitEventSchema,
+]);
+// Export the schema for testing
+export { OutputEventSchema };
+/**
+ * Line-buffered NDJSON parser for Claude Code stream-json output.
+ *
+ * Reads from a Readable stream, validates each line against Zod schemas,
+ * and emits typed events. Malformed events are logged, counted, and skipped.
+ */
+export class StreamJsonParser extends EventEmitter {
+    buffer = '';
+    _sessionId = null;
+    _lastEventTime = new Date();
+    _unparsedEventCount = 0;
+    get sessionId() { return this._sessionId; }
+    get lastEventTime() { return this._lastEventTime; }
+    /** Number of events that failed Zod validation and were skipped. */
+    get unparsedEventCount() { return this._unparsedEventCount; }
+    /**
+     * Attach the parser to a readable stream (typically process.stdout).
+     */
+    attach(stream) {
+        stream.on('data', (chunk) => {
+            this.buffer += chunk.toString();
+            this.processBuffer();
+        });
+        stream.on('end', () => {
+            // Process any remaining data in the buffer
+            if (this.buffer.trim()) {
+                this.processBuffer();
+            }
+        });
+    }
+    processBuffer() {
+        const lines = this.buffer.split('\n');
+        // Keep last incomplete line in buffer
+        this.buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            // Step 1: Parse raw JSON
+            let raw;
+            try {
+                raw = JSON.parse(trimmed);
+            }
+            catch (err) {
+                this.emit('error', err instanceof Error ? err : new Error(String(err)), trimmed);
+                continue;
+            }
+            // Step 2: Validate against Zod schema
+            const result = OutputEventSchema.safeParse(raw);
+            if (!result.success) {
+                this._unparsedEventCount++;
+                // Format Zod issues into a concise message
+                const issues = result.error.issues
+                    .map(i => `${i.path.join('.')}: ${i.message}`)
+                    .join('; ');
+                console.warn(`[stream-json] Validation failed (${this._unparsedEventCount} total): ${issues} ` +
+                    `-- raw: ${trimmed.slice(0, 300)}`);
+                continue;
+            }
+            this._lastEventTime = new Date();
+            this.routeEvent(result.data);
+        }
+    }
+    routeEvent(event) {
+        // Emit the generic event for all listeners
+        this.emit('event', event);
+        // Extract session ID from first event that has one
+        if ('session_id' in event && event.session_id && !this._sessionId) {
+            this._sessionId = event.session_id;
+        }
+        switch (event.type) {
+            case 'system':
+                if (event.subtype === 'init') {
+                    this.emit('init', event);
+                }
+                else if (event.subtype === 'teammate_spawned' ||
+                    event.subtype === 'teammate_idle' ||
+                    event.subtype === 'teammate_completed') {
+                    this.emit('teammate', event);
+                }
+                // Other system subtypes (compact_boundary, status, etc.) are emitted
+                // via the generic 'event' handler above -- no dedicated named event.
+                break;
+            case 'assistant':
+                this.emit('assistant', event);
+                break;
+            case 'result':
+                this.emit('result', event);
+                break;
+            // stream_event is emitted via the generic 'event' handler above
+            // but individual stream deltas are too granular for named events
+        }
+    }
+}
+// ── Writer ───────────────────────────────────────────────────────────────────
+/**
+ * Send a user message to Claude Code via stdin (stream-json format).
+ *
+ * Each message is serialized as a single JSON line followed by a newline.
+ */
+export function sendMessage(stdin, content) {
+    const message = {
+        type: 'user',
+        message: {
+            role: 'user',
+            content,
+        },
+    };
+    const line = JSON.stringify(message) + '\n';
+    return stdin.write(line);
+}
+//# sourceMappingURL=stream-json.js.map

package/dist/stream-json.js.map

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

package/dist/token-usage.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared token usage parsing utilities for Telora daemon and factory.
+ *
+ * Provides a Transform stream that passes all data through (for log files)
+ * while sniffing each NDJSON line for `result` events containing token usage
+ * stats. Also provides standalone parsing and aggregation functions for cases
+ * where the output is already captured as a string.
+ *
+ * This is the canonical location for token-usage parsing -- both the daemon
+ * and the factory builder import from here.
+ */
+import { Transform, type TransformCallback } from 'node:stream';
+/** Accumulated token usage from a Claude Code result event. */
+export interface ParsedTokenUsage {
+    /** Total input tokens used. */
+    inputTokens: number;
+    /** Total output tokens used. */
+    outputTokens: number;
+    /** Total cost in USD (null if not reported). */
+    totalCostUsd: number | null;
+}
+/**
+ * Parse token usage from a raw NDJSON output string (e.g. from execFileSync).
+ *
+ * Scans all lines for `"type":"result"` events and extracts the last one's
+ * usage stats. Returns null if no result event is found.
+ */
+export declare function parseTokenUsageFromOutput(output: string): ParsedTokenUsage | null;
+/**
+ * Sum multiple ParsedTokenUsage values into a single aggregate.
+ * Useful for accumulating cost across retries or multiple planning phases.
+ */
+export declare function sumTokenUsage(usages: (ParsedTokenUsage | null)[]): ParsedTokenUsage | null;
+/**
+ * A passthrough Transform stream that sniffs NDJSON lines for result events.
+ *
+ * All data flows through unchanged (so it can be piped to a log file).
+ * Internally, the stream buffers partial lines and inspects each complete
+ * line for `"type":"result"` events. When found, it extracts
+ * `usage.input_tokens`, `usage.output_tokens`, and `total_cost_usd`.
+ *
+ * Usage:
+ * ```
+ * const parser = new TokenSniffingTransform();
+ * proc.stdout.pipe(parser).pipe(logFileStream);
+ * // ... after process exits:
+ * const usage = parser.usage; // { inputTokens, outputTokens, totalCostUsd }
+ * ```
+ */
+export declare class TokenSniffingTransform extends Transform {
+    private lineBuffer;
+    private _usage;
+    /** The last parsed result event's token usage, or null if none seen. */
+    get usage(): ParsedTokenUsage | null;
+    /** Total token count (input + output), or 0 if no result event was parsed. */
+    get totalTokens(): number;
+    _transform(chunk: Buffer, _encoding: BufferEncoding, callback: TransformCallback): void;
+    _flush(callback: TransformCallback): void;
+    /**
+     * Attempt to parse a line as a result event with token usage.
+     *
+     * Uses a fast string check before attempting JSON.parse to avoid
+     * the overhead of parsing every line (most are stream_event or assistant).
+     */
+    private tryParseResultLine;
+}
+//# sourceMappingURL=token-usage.d.ts.map

package/dist/token-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-usage.d.ts","sourceRoot":"","sources":["../src/token-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMhE,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA6BjF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,GAAG,gBAAgB,GAAG,IAAI,CAW1F;AAMD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;IACnD,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,MAAM,CAAiC;IAE/C,wEAAwE;IACxE,IAAI,KAAK,IAAI,gBAAgB,GAAG,IAAI,CAEnC;IAED,8EAA8E;IAC9E,IAAI,WAAW,IAAI,MAAM,CAGxB;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAoBvF,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IASzC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CA4B3B"}

package/dist/token-usage.js

@@ -0,0 +1,150 @@
+/**
+ * Shared token usage parsing utilities for Telora daemon and factory.
+ *
+ * Provides a Transform stream that passes all data through (for log files)
+ * while sniffing each NDJSON line for `result` events containing token usage
+ * stats. Also provides standalone parsing and aggregation functions for cases
+ * where the output is already captured as a string.
+ *
+ * This is the canonical location for token-usage parsing -- both the daemon
+ * and the factory builder import from here.
+ */
+import { Transform } from 'node:stream';
+// ============================================================================
+// Parsing functions
+// ============================================================================
+/**
+ * Parse token usage from a raw NDJSON output string (e.g. from execFileSync).
+ *
+ * Scans all lines for `"type":"result"` events and extracts the last one's
+ * usage stats. Returns null if no result event is found.
+ */
+export function parseTokenUsageFromOutput(output) {
+    let lastUsage = null;
+    const lines = output.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || !trimmed.includes('"result"'))
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed.type !== 'result')
+                continue;
+            const usage = parsed.usage;
+            if (!usage)
+                continue;
+            lastUsage = {
+                inputTokens: typeof usage.input_tokens === 'number' ? usage.input_tokens : 0,
+                outputTokens: typeof usage.output_tokens === 'number' ? usage.output_tokens : 0,
+                totalCostUsd: typeof parsed.total_cost_usd === 'number' ? parsed.total_cost_usd : null,
+            };
+        }
+        catch {
+            // Not valid JSON -- ignore
+        }
+    }
+    return lastUsage;
+}
+/**
+ * Sum multiple ParsedTokenUsage values into a single aggregate.
+ * Useful for accumulating cost across retries or multiple planning phases.
+ */
+export function sumTokenUsage(usages) {
+    const nonNull = usages.filter((u) => u !== null);
+    if (nonNull.length === 0)
+        return null;
+    return {
+        inputTokens: nonNull.reduce((sum, u) => sum + u.inputTokens, 0),
+        outputTokens: nonNull.reduce((sum, u) => sum + u.outputTokens, 0),
+        totalCostUsd: nonNull.some((u) => u.totalCostUsd !== null)
+            ? nonNull.reduce((sum, u) => sum + (u.totalCostUsd ?? 0), 0)
+            : null,
+    };
+}
+// ============================================================================
+// Transform stream
+// ============================================================================
+/**
+ * A passthrough Transform stream that sniffs NDJSON lines for result events.
+ *
+ * All data flows through unchanged (so it can be piped to a log file).
+ * Internally, the stream buffers partial lines and inspects each complete
+ * line for `"type":"result"` events. When found, it extracts
+ * `usage.input_tokens`, `usage.output_tokens`, and `total_cost_usd`.
+ *
+ * Usage:
+ * ```
+ * const parser = new TokenSniffingTransform();
+ * proc.stdout.pipe(parser).pipe(logFileStream);
+ * // ... after process exits:
+ * const usage = parser.usage; // { inputTokens, outputTokens, totalCostUsd }
+ * ```
+ */
+export class TokenSniffingTransform extends Transform {
+    lineBuffer = '';
+    _usage = null;
+    /** The last parsed result event's token usage, or null if none seen. */
+    get usage() {
+        return this._usage;
+    }
+    /** Total token count (input + output), or 0 if no result event was parsed. */
+    get totalTokens() {
+        if (!this._usage)
+            return 0;
+        return this._usage.inputTokens + this._usage.outputTokens;
+    }
+    _transform(chunk, _encoding, callback) {
+        // Pass all data through unchanged
+        this.push(chunk);
+        // Buffer and process lines
+        this.lineBuffer += chunk.toString();
+        const lines = this.lineBuffer.split('\n');
+        // Keep the last (potentially incomplete) line in the buffer
+        this.lineBuffer = lines.pop() ?? '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed) {
+                this.tryParseResultLine(trimmed);
+            }
+        }
+        callback();
+    }
+    _flush(callback) {
+        // Process any remaining data in the buffer
+        const trimmed = this.lineBuffer.trim();
+        if (trimmed) {
+            this.tryParseResultLine(trimmed);
+        }
+        callback();
+    }
+    /**
+     * Attempt to parse a line as a result event with token usage.
+     *
+     * Uses a fast string check before attempting JSON.parse to avoid
+     * the overhead of parsing every line (most are stream_event or assistant).
+     */
+    tryParseResultLine(line) {
+        // Fast check: skip lines that definitely aren't result events
+        if (!line.includes('"result"')) {
+            return;
+        }
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed.type !== 'result')
+                return;
+            const usage = parsed.usage;
+            if (!usage)
+                return;
+            this._usage = {
+                inputTokens: typeof usage.input_tokens === 'number' ? usage.input_tokens : 0,
+                outputTokens: typeof usage.output_tokens === 'number' ? usage.output_tokens : 0,
+                totalCostUsd: typeof parsed.total_cost_usd === 'number' ? parsed.total_cost_usd : null,
+            };
+            this.emit('result', parsed);
+        }
+        catch {
+            // Not valid JSON despite matching the string check -- ignore
+        }
+    }
+}
+//# sourceMappingURL=token-usage.js.map

package/dist/token-usage.js.map

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

package/dist/transforms.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Declarative key mapping utilities for camelCase <-> snake_case transforms.
+ *
+ * These utilities are used by query modules in both the daemon and factory
+ * engines to transform API response objects (snake_case DB columns) into
+ * application types (camelCase TypeScript interfaces).
+ *
+ * Extracted from packages/daemon/src/queries/shared.ts.
+ */
+/**
+ * Mapping specification for each target key.
+ *
+ * Each target key maps to either:
+ * - A source key name (direct copy)
+ * - `{ from: sourceKey, default: fallback }` (copy with default if null/undefined)
+ * - `{ value: literal }` (hardcoded constant)
+ */
+type KeyMapping<TSource, TTarget> = {
+    [K in keyof TTarget]: keyof TSource | {
+        from: keyof TSource;
+        default: TTarget[K];
+    } | {
+        value: TTarget[K];
+    };
+};
+/**
+ * Transform an object's keys using a declarative mapping config.
+ *
+ * Each target key maps to either:
+ * - A source key name (direct copy)
+ * - `{ from: sourceKey, default: fallback }` (copy with default if null/undefined)
+ * - `{ value: literal }` (hardcoded constant)
+ *
+ * @example
+ * ```ts
+ * const toAppType = createTransform<ApiRole, AgentRole>({
+ *   id: 'id',
+ *   organization_id: 'organizationId',
+ *   allowed_tools: { from: 'allowedTools', default: [] as string[] },
+ * });
+ * const role = toAppType(apiRole);
+ * ```
+ */
+export declare function createTransform<TSource, TTarget>(mapping: KeyMapping<TSource, TTarget>): (source: TSource) => TTarget;
+/**
+ * Transform an updates object by mapping keys (e.g. snake_case -> camelCase).
+ * Only includes keys that are present and not undefined in the source.
+ *
+ * This is useful for building partial update payloads where you only want
+ * to include fields that were actually provided.
+ *
+ * @example
+ * ```ts
+ * const fields = mapDefinedKeys(updates, {
+ *   exit_reason: 'exitReason',
+ *   started_at: 'startedAt',
+ * });
+ * // If updates = { exit_reason: 'done', started_at: undefined }
+ * // Result = { exitReason: 'done' }  (started_at omitted because undefined)
+ * ```
+ */
+export declare function mapDefinedKeys(source: Record<string, unknown>, keyMap: Record<string, string>): Record<string, unknown>;
+export {};
+//# sourceMappingURL=transforms.d.ts.map

package/dist/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../src/transforms.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;GAOG;AACH,KAAK,UAAU,CAAC,OAAO,EAAE,OAAO,IAAI;KACjC,CAAC,IAAI,MAAM,OAAO,GAAG,MAAM,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE;CAC3G,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAC9C,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,GACpC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAkB9B;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}