@aaep/typescript-producer 1.0.1

package/dist/coalescer.js

@@ -0,0 +1,124 @@
+/**
+ * StreamCoalescer — TypeScript port of the Python StreamCoalescer.
+ *
+ * Buffers streaming tokens and emits agent.output.streaming events at
+ * coalesce boundaries (default: sentence boundaries). The boundary
+ * detection regexes match the Python implementation exactly.
+ *
+ * Usage:
+ *   const coalescer = new StreamCoalescer({
+ *       emitter,
+ *       sessionId: "sess_x",
+ *       outputId: "out_y",
+ *       coalesceAt: "sentence",
+ *   });
+ *   coalescer.addToken("Hello ");
+ *   coalescer.addToken("world. ");      // sentence boundary -> emit
+ *   coalescer.addToken("Goodbye.");
+ *   coalescer.finish();                 // final emit with complete=true
+ */
+export class StreamCoalescer {
+    emitter;
+    sessionId;
+    outputId;
+    coalesceAt;
+    language;
+    buffer = "";
+    position = 0;
+    finished = false;
+    constructor(options) {
+        this.emitter = options.emitter;
+        this.sessionId = options.sessionId;
+        this.outputId = options.outputId;
+        this.coalesceAt = options.coalesceAt ?? "sentence";
+        this.language = options.language;
+    }
+    /**
+     * Add a token to the buffer. May emit one or more events if coalesce
+     * boundaries are crossed by the addition.
+     */
+    addToken(token) {
+        if (this.finished) {
+            throw new Error("Cannot add tokens to a finished coalescer");
+        }
+        this.buffer += token;
+        this.flushAtBoundary();
+    }
+    /**
+     * Flush any remaining buffer and emit the final completion event
+     * (complete=true). Idempotent; safe to call multiple times.
+     */
+    finish() {
+        if (this.finished)
+            return;
+        this.emitChunk(this.buffer, /* complete = */ true);
+        this.buffer = "";
+        this.finished = true;
+    }
+    /** Inspect the current buffered text (for tests). */
+    get bufferedText() {
+        return this.buffer;
+    }
+    /** Whether finish() has been called. */
+    get isFinished() {
+        return this.finished;
+    }
+    // === Internals ===
+    flushAtBoundary() {
+        // 'completion' coalescing means "flush only on finish()"
+        if (this.coalesceAt === "completion")
+            return;
+        if (this.coalesceAt === "none") {
+            // Emit every token as a separate event
+            const text = this.buffer;
+            this.buffer = "";
+            this.emitChunk(text, /* complete = */ false);
+            return;
+        }
+        const boundaries = this.findBoundaries();
+        for (const boundaryEnd of boundaries) {
+            const chunk = this.buffer.slice(0, boundaryEnd);
+            this.buffer = this.buffer.slice(boundaryEnd);
+            this.emitChunk(chunk, /* complete = */ false);
+        }
+    }
+    findBoundaries() {
+        const boundaries = [];
+        let regex;
+        if (this.coalesceAt === "word") {
+            // End of word: non-space followed by whitespace
+            regex = /\S+\s+/g;
+        }
+        else if (this.coalesceAt === "sentence") {
+            // End of sentence: ., !, or ? followed by whitespace or end
+            regex = /[.!?](\s|$)/g;
+        }
+        else if (this.coalesceAt === "paragraph") {
+            // Paragraph break: double newline
+            regex = /\n\n/g;
+        }
+        else {
+            return [];
+        }
+        let match;
+        while ((match = regex.exec(this.buffer)) !== null) {
+            boundaries.push(match.index + match[0].length);
+        }
+        return boundaries;
+    }
+    emitChunk(chunk, complete) {
+        if (!chunk && !complete)
+            return;
+        this.emitter.outputStreaming({
+            sessionId: this.sessionId,
+            outputId: this.outputId,
+            chunk,
+            position: this.position,
+            complete,
+            coalesceHint: complete ? "completion" : this.coalesceAt,
+            ...(this.language && { language: this.language }),
+        });
+        this.position += chunk.length;
+    }
+}
+//# sourceMappingURL=coalescer.js.map

package/dist/coalescer.js.map

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

package/dist/emitter.d.ts

@@ -0,0 +1,111 @@
+/**
+ * AAEPEmitter — TypeScript port of the python-minimal emitter.
+ *
+ * Same architecture as Python: one method per AAEP event type, transport
+ * via a configurable sendEvent callback, Promise-based confirmation flow.
+ * The safety machinery (irreversible+high MUST default reject, secret
+ * redaction, critical urgency on errored events) matches the Python emitter
+ * one-for-one.
+ *
+ * This module has zero runtime dependencies beyond Node.js stdlib. The
+ * `crypto` module is used for ID generation; everything else is built-in
+ * language features.
+ */
+import type { AAEPEvent, Decision, ErrorCategory, Producer, RiskLevel, ToolStatus } from "./types.js";
+export declare function makeId(prefix: string): string;
+export declare function nowIso(): string;
+export declare function classifyErrorCategory(error: unknown): ErrorCategory;
+export declare function classifyRisk(toolName: string): {
+    riskLevel: RiskLevel;
+    irreversible: boolean;
+};
+export declare function safeArgsSummary(args: Record<string, unknown>, maxChars?: number): string;
+export interface AAEPEmitterOptions {
+    sendEvent: (event: AAEPEvent) => void | Promise<void>;
+    agentId?: string;
+    agentVersion?: string;
+    agentName?: string;
+    model?: string;
+}
+export declare class AAEPEmitter {
+    private readonly sendEvent;
+    private readonly producerInfo;
+    private readonly sequenceNumbers;
+    private readonly replyResolvers;
+    constructor(options: AAEPEmitterOptions);
+    /** Read-only view of the producer info (for tests). */
+    get producer(): Readonly<Producer>;
+    startSession(opts: {
+        summaryNormal: string;
+        requestText?: string;
+        requestedBy?: string;
+        expectedDurationMs?: number;
+        toolsAvailable?: string[];
+    }): string;
+    completeSession(opts: {
+        sessionId: string;
+        summaryNormal: string;
+        durationMs?: number;
+        toolInvocationsCount?: number;
+    }): void;
+    errorSession(opts: {
+        sessionId: string;
+        errorCategory: ErrorCategory;
+        summaryNormal: string;
+        errorMessage?: string;
+        recoverable?: boolean;
+        remediationHint?: string;
+    }): void;
+    cancelledSession(opts: {
+        sessionId: string;
+        cancelledBy?: "user" | "system" | "timeout" | "policy";
+        summaryNormal?: string;
+    }): void;
+    stateChanged(opts: {
+        sessionId: string;
+        fromState: string;
+        toState: string;
+        summaryNormal: string;
+    }): void;
+    toolInvoked(opts: {
+        sessionId: string;
+        tool: string;
+        toolCallId: string;
+        argsSummary: string;
+        riskLevel?: RiskLevel;
+        irreversible?: boolean;
+        summaryNormal?: string;
+    }): void;
+    toolCompleted(opts: {
+        sessionId: string;
+        tool: string;
+        toolCallId: string;
+        status: ToolStatus;
+        summaryNormal?: string;
+        errorMessage?: string;
+    }): void;
+    outputStreaming(opts: {
+        sessionId: string;
+        outputId: string;
+        chunk: string;
+        position: number;
+        complete: boolean;
+        coalesceHint?: "none" | "word" | "sentence" | "paragraph" | "completion";
+        language?: string;
+    }): void;
+    awaitConfirmation(opts: {
+        sessionId: string;
+        action: string;
+        consequence: string;
+        timeoutSeconds?: number;
+        defaultDecision?: Decision;
+        riskLevel?: RiskLevel;
+        irreversible?: boolean;
+        summaryNormal?: string;
+    }): string;
+    submitReply(replyToken: string, decision: string): boolean;
+    waitForDecision(replyToken: string): Promise<string>;
+    private nextSeq;
+    private emit;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/emitter.d.ts.map

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

package/dist/emitter.js

@@ -0,0 +1,320 @@
+/**
+ * AAEPEmitter — TypeScript port of the python-minimal emitter.
+ *
+ * Same architecture as Python: one method per AAEP event type, transport
+ * via a configurable sendEvent callback, Promise-based confirmation flow.
+ * The safety machinery (irreversible+high MUST default reject, secret
+ * redaction, critical urgency on errored events) matches the Python emitter
+ * one-for-one.
+ *
+ * This module has zero runtime dependencies beyond Node.js stdlib. The
+ * `crypto` module is used for ID generation; everything else is built-in
+ * language features.
+ */
+import { randomBytes } from "node:crypto";
+import { AAEP_CONTEXT_URL, AAEP_VERSION, } from "./types.js";
+// === ID generation ===
+const ID_PREFIX_PATTERN = /^[a-z]+$/;
+export function makeId(prefix) {
+    if (!ID_PREFIX_PATTERN.test(prefix)) {
+        throw new Error(`ID prefix must be lowercase letters only, got ${JSON.stringify(prefix)}`);
+    }
+    return `${prefix}_${randomBytes(8).toString("hex")}`;
+}
+// === RFC 3339 timestamp ===
+export function nowIso() {
+    const now = new Date();
+    const ms = String(now.getUTCMilliseconds()).padStart(3, "0");
+    return now.toISOString().replace(/\.\d{3}Z$/, `.${ms}Z`);
+}
+// === Error classification ===
+export function classifyErrorCategory(error) {
+    if (!(error instanceof Error)) {
+        return "unknown";
+    }
+    const name = error.name;
+    if (name === "TimeoutError" || name === "AbortError")
+        return "timeout";
+    if (name === "TypeError" || name === "RangeError")
+        return "invalid_input";
+    if (error.message.toLowerCase().includes("network"))
+        return "network";
+    if (error.message.toLowerCase().includes("permission"))
+        return "authorization";
+    return "unknown";
+}
+// === Risk classification ===
+const HIGH_RISK_PATTERNS = [
+    "send_email", "transfer_funds", "delete_record", "delete_file",
+    "publish_post", "make_payment", "execute_trade", "send_sms",
+];
+export function classifyRisk(toolName) {
+    const lower = toolName.toLowerCase();
+    for (const pattern of HIGH_RISK_PATTERNS) {
+        if (lower.includes(pattern)) {
+            return { riskLevel: "high", irreversible: true };
+        }
+    }
+    return { riskLevel: "low", irreversible: false };
+}
+// === Safe args summary (redacts secrets) ===
+const SECRET_FIELD_PATTERNS = [
+    "password", "secret", "token", "key", "auth", "credential",
+];
+export function safeArgsSummary(args, maxChars = 1000) {
+    const parts = [];
+    for (const [k, v] of Object.entries(args)) {
+        const lower = k.toLowerCase();
+        const isSecret = SECRET_FIELD_PATTERNS.some((p) => lower.includes(p));
+        if (isSecret) {
+            parts.push(`${k}=[redacted]`);
+        }
+        else {
+            const vStr = String(v);
+            parts.push(`${k}=${vStr.length > 80 ? vStr.slice(0, 77) + "..." : vStr}`);
+        }
+    }
+    return parts.join(", ").slice(0, maxChars);
+}
+// === The emitter ===
+export class AAEPEmitter {
+    sendEvent;
+    producerInfo;
+    sequenceNumbers = new Map();
+    replyResolvers = new Map();
+    constructor(options) {
+        this.sendEvent = options.sendEvent;
+        this.producerInfo = {
+            agent_id: options.agentId ?? "aaep-typescript-producer",
+            agent_version: options.agentVersion ?? "1.0.0",
+            agent_name: options.agentName ?? "AAEP TypeScript Producer",
+            ...(options.model ? { model: options.model } : {}),
+        };
+    }
+    /** Read-only view of the producer info (for tests). */
+    get producer() {
+        return this.producerInfo;
+    }
+    // === Session lifecycle ===
+    startSession(opts) {
+        const sessionId = makeId("sess");
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            aaep_version: AAEP_VERSION,
+            type: "aaep:agent.session.started",
+            event_id: makeId("evt"),
+            session_id: sessionId,
+            sequence_number: this.nextSeq(sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "normal",
+            summary_normal: opts.summaryNormal,
+            ...(opts.requestText && { request_text: opts.requestText }),
+            ...(opts.requestedBy && { requested_by: opts.requestedBy }),
+            ...(opts.expectedDurationMs && { expected_duration_ms: opts.expectedDurationMs }),
+            ...(opts.toolsAvailable && { tools_available: opts.toolsAvailable }),
+        });
+        return sessionId;
+    }
+    completeSession(opts) {
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            type: "aaep:agent.session.completed",
+            event_id: makeId("evt"),
+            session_id: opts.sessionId,
+            sequence_number: this.nextSeq(opts.sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "normal",
+            summary_normal: opts.summaryNormal,
+            ...(opts.durationMs !== undefined && { duration_ms: opts.durationMs }),
+            ...(opts.toolInvocationsCount !== undefined && {
+                tool_invocations_count: opts.toolInvocationsCount,
+            }),
+        });
+    }
+    errorSession(opts) {
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            type: "aaep:agent.session.errored",
+            event_id: makeId("evt"),
+            session_id: opts.sessionId,
+            sequence_number: this.nextSeq(opts.sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "critical", // MUST per Chapter 4 §4.1.3
+            error_category: opts.errorCategory,
+            summary_normal: opts.summaryNormal,
+            ...(opts.errorMessage && { error_message: opts.errorMessage }),
+            ...(opts.recoverable !== undefined && { recoverable: opts.recoverable }),
+            ...(opts.remediationHint && { remediation_hint: opts.remediationHint }),
+        });
+    }
+    cancelledSession(opts) {
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            type: "aaep:agent.session.cancelled",
+            event_id: makeId("evt"),
+            session_id: opts.sessionId,
+            sequence_number: this.nextSeq(opts.sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "normal",
+            cancelled_by: opts.cancelledBy ?? "system",
+            summary_normal: opts.summaryNormal ?? "Session cancelled.",
+        });
+    }
+    // === State change ===
+    stateChanged(opts) {
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            type: "aaep:agent.state.changed",
+            event_id: makeId("evt"),
+            session_id: opts.sessionId,
+            sequence_number: this.nextSeq(opts.sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "normal",
+            from_state: opts.fromState,
+            to_state: opts.toState,
+            summary_normal: opts.summaryNormal,
+        });
+    }
+    // === Tool invocation ===
+    toolInvoked(opts) {
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            type: "aaep:agent.tool.invoked",
+            event_id: makeId("evt"),
+            session_id: opts.sessionId,
+            sequence_number: this.nextSeq(opts.sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "normal",
+            tool: opts.tool,
+            tool_call_id: opts.toolCallId,
+            args_summary: opts.argsSummary,
+            risk_level: opts.riskLevel ?? "low",
+            irreversible: opts.irreversible ?? false,
+            summary_normal: opts.summaryNormal ?? `Calling ${opts.tool}.`,
+        });
+    }
+    toolCompleted(opts) {
+        if (!["success", "error", "timeout"].includes(opts.status)) {
+            throw new Error(`status must be success/error/timeout, got ${JSON.stringify(opts.status)}`);
+        }
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            type: "aaep:agent.tool.completed",
+            event_id: makeId("evt"),
+            session_id: opts.sessionId,
+            sequence_number: this.nextSeq(opts.sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "normal",
+            tool: opts.tool,
+            tool_call_id: opts.toolCallId,
+            status: opts.status,
+            summary_normal: opts.summaryNormal ?? "",
+            ...(opts.errorMessage && { error_message: opts.errorMessage }),
+        });
+    }
+    // === Streaming output ===
+    outputStreaming(opts) {
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            type: "aaep:agent.output.streaming",
+            event_id: makeId("evt"),
+            session_id: opts.sessionId,
+            sequence_number: this.nextSeq(opts.sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "normal",
+            summary_normal: "",
+            chunk: opts.chunk,
+            position: opts.position,
+            complete: opts.complete,
+            coalesce_hint: opts.coalesceHint ?? "none",
+            output_id: opts.outputId,
+            ...(opts.language && { language: opts.language }),
+        });
+    }
+    // === Confirmation flow ===
+    awaitConfirmation(opts) {
+        const riskLevel = opts.riskLevel ?? "low";
+        const irreversible = opts.irreversible ?? false;
+        const defaultDecision = opts.defaultDecision ?? "reject";
+        // Runtime safety enforcement (mirrors Python emitter)
+        if (irreversible
+            && (riskLevel === "high" || riskLevel === "medium")
+            && defaultDecision !== "reject") {
+            throw new Error(`Irreversible ${riskLevel}-risk confirmations MUST have `
+                + `default_decision='reject' (got '${defaultDecision}'). `
+                + `This is enforced both by the schema and at runtime.`);
+        }
+        const replyToken = makeId("rpl");
+        const promise = new Promise((resolve) => {
+            this.replyResolvers.set(replyToken, resolve);
+        });
+        // Store the promise via the resolver map; expose waitForDecision separately
+        this._pendingReplies = this._pendingReplies ?? new Map();
+        this._pendingReplies.set(replyToken, promise);
+        this.emit({
+            "@context": AAEP_CONTEXT_URL,
+            type: "aaep:agent.awaiting.confirmation",
+            event_id: makeId("evt"),
+            session_id: opts.sessionId,
+            sequence_number: this.nextSeq(opts.sessionId),
+            timestamp: nowIso(),
+            producer: { ...this.producerInfo },
+            urgency: "critical", // MUST per Chapter 4 §4.4.1
+            action: opts.action,
+            consequence: opts.consequence,
+            reply_token: replyToken,
+            timeout_seconds: opts.timeoutSeconds ?? 300,
+            default_decision: defaultDecision,
+            risk_level: riskLevel,
+            irreversible: irreversible,
+            summary_normal: opts.summaryNormal ?? `Confirm: ${opts.action}`,
+        });
+        return replyToken;
+    }
+    submitReply(replyToken, decision) {
+        const resolver = this.replyResolvers.get(replyToken);
+        if (!resolver)
+            return false;
+        resolver(decision);
+        this.replyResolvers.delete(replyToken);
+        return true;
+    }
+    async waitForDecision(replyToken) {
+        const pending = this._pendingReplies;
+        const promise = pending?.get(replyToken);
+        if (!promise) {
+            throw new Error(`Unknown reply_token: ${replyToken}`);
+        }
+        try {
+            return await promise;
+        }
+        finally {
+            pending.delete(replyToken);
+        }
+    }
+    // === Internals ===
+    nextSeq(sessionId) {
+        const seq = this.sequenceNumbers.get(sessionId) ?? 0;
+        this.sequenceNumbers.set(sessionId, seq + 1);
+        return seq;
+    }
+    emit(event) {
+        const result = this.sendEvent(event);
+        if (result instanceof Promise) {
+            // Fire-and-forget async sender; errors are swallowed
+            result.catch((err) => {
+                // In production, route this to your logger
+                console.error("[AAEPEmitter] sendEvent failed:", err);
+            });
+        }
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/emitter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AAEP TypeScript Producer — public API.
+ *
+ * Reference implementation of an AAEP producer in TypeScript / Node.js.
+ * Demonstrates the manual loop pattern with full safety machinery.
+ *
+ * @example
+ * ```typescript
+ * import { AAEPEmitter, AgentLoop, makeId } from 'aaep-typescript-producer';
+ *
+ * const emitter = new AAEPEmitter({
+ *     sendEvent: (event) => console.log(JSON.stringify(event)),
+ *     agentId: 'my-agent',
+ * });
+ *
+ * const agent = new AgentLoop(emitter);
+ * await agent.run('Tell me about retirement planning.');
+ * ```
+ *
+ * See README.md for full usage and design notes.
+ */
+export declare const VERSION = "1.0.0";
+export declare const AAEP_SPEC_VERSION = "1.0.0";
+export { AAEPEmitter, classifyErrorCategory, classifyRisk, makeId, nowIso, safeArgsSummary, type AAEPEmitterOptions, } from "./emitter.js";
+export { StreamCoalescer, type StreamCoalescerOptions } from "./coalescer.js";
+export { AgentLoop, type ToolDescriptor, type AgentLoopOptions } from "./agent.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAGzC,OAAO,EACH,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,MAAM,EACN,MAAM,EACN,eAAe,EACf,KAAK,kBAAkB,GAC1B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnF,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * AAEP TypeScript Producer — public API.
+ *
+ * Reference implementation of an AAEP producer in TypeScript / Node.js.
+ * Demonstrates the manual loop pattern with full safety machinery.
+ *
+ * @example
+ * ```typescript
+ * import { AAEPEmitter, AgentLoop, makeId } from 'aaep-typescript-producer';
+ *
+ * const emitter = new AAEPEmitter({
+ *     sendEvent: (event) => console.log(JSON.stringify(event)),
+ *     agentId: 'my-agent',
+ * });
+ *
+ * const agent = new AgentLoop(emitter);
+ * await agent.run('Tell me about retirement planning.');
+ * ```
+ *
+ * See README.md for full usage and design notes.
+ */
+export const VERSION = "1.0.0";
+export const AAEP_SPEC_VERSION = "1.0.0";
+// Core emitter and helpers
+export { AAEPEmitter, classifyErrorCategory, classifyRisk, makeId, nowIso, safeArgsSummary, } from "./emitter.js";
+// Streaming coalescer
+export { StreamCoalescer } from "./coalescer.js";
+// Agent loop
+export { AgentLoop } from "./agent.js";
+// All type definitions
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAEzC,2BAA2B;AAC3B,OAAO,EACH,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,MAAM,EACN,MAAM,EACN,eAAe,GAElB,MAAM,cAAc,CAAC;AAEtB,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAA+B,MAAM,gBAAgB,CAAC;AAE9E,aAAa;AACb,OAAO,EAAE,SAAS,EAA8C,MAAM,YAAY,CAAC;AAEnF,uBAAuB;AACvB,cAAc,YAAY,CAAC"}