@buenojs/bueno 0.8.6 → 0.8.8

package/dist/storage/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Storage Layer
+ *
+ * Unified interface over Bun.s3 for S3-compatible storage with local filesystem fallback.
+ * Uses Bun 1.3+ native S3 client for cloud storage.
+ */
+export interface StorageConfig {
+    driver?: "s3" | "local";
+    bucket?: string;
+    region?: string;
+    endpoint?: string;
+    localPath?: string;
+}
+export interface UploadOptions {
+    key: string;
+    body: string | Buffer | ArrayBuffer | Blob | File;
+    contentType?: string;
+}
+export interface DownloadOptions {
+    key: string;
+}
+export interface PresignedURLOptions {
+    key: string;
+    expiresIn?: number;
+    method?: "GET" | "PUT";
+}
+export interface FileInfo {
+    key: string;
+    size: number;
+    lastModified?: Date;
+}
+export interface ListOptions {
+    prefix?: string;
+}
+export interface ListResult {
+    files: FileInfo[];
+    directories: string[];
+}
+export declare class Storage {
+    private driver;
+    private s3Storage;
+    private localStorage;
+    private _isConnected;
+    constructor(config?: StorageConfig);
+    connect(): Promise<void>;
+    get isConnected(): boolean;
+    getDriver(): "s3" | "local";
+    upload(options: UploadOptions): Promise<{
+        key: string;
+    }>;
+    download(options: DownloadOptions): Promise<Blob>;
+    downloadText(key: string): Promise<string>;
+    downloadBuffer(key: string): Promise<ArrayBuffer>;
+    stream(key: string): Promise<ReadableStream<Uint8Array>>;
+    delete(key: string): Promise<void>;
+    deleteMany(keys: string[]): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    info(key: string): Promise<FileInfo | null>;
+    copy(sourceKey: string, destKey: string): Promise<void>;
+    move(sourceKey: string, destKey: string): Promise<void>;
+    list(options?: ListOptions): Promise<ListResult>;
+    getPresignedUrl(options: PresignedURLOptions): string;
+    getPublicUrl(key: string): string;
+    uploadFile(localPath: string, key: string): Promise<{
+        key: string;
+    }>;
+}
+export interface SecretOptions {
+    service: string;
+    name: string;
+}
+export interface SetSecretOptions extends SecretOptions {
+    value: string;
+    allowUnrestrictedAccess?: boolean;
+}
+export declare const Secrets: {
+    /**
+     * Get a secret from OS credential storage
+     */
+    get(options: SecretOptions): Promise<string | null>;
+    /**
+     * Store a secret in OS credential storage
+     */
+    set(options: SetSecretOptions): Promise<void>;
+    /**
+     * Delete a secret from OS credential storage
+     */
+    delete(options: SecretOptions): Promise<void>;
+    /**
+     * Get a secret or throw if not found
+     */
+    getOrThrow(options: SecretOptions): Promise<string>;
+    /**
+     * Get a secret or use a default value
+     */
+    getOrDefault(options: SecretOptions, defaultValue: string): Promise<string>;
+};
+export declare function createStorage(config?: StorageConfig): Storage;
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

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

package/dist/telemetry/index.d.ts

@@ -0,0 +1,376 @@
+/**
+ * OpenTelemetry OTLP Trace Exporter
+ *
+ * Provides distributed tracing with OpenTelemetry Protocol (OTLP) export.
+ * Part of Layer 7 (Testing & Observability) implementation.
+ */
+/**
+ * Span kind enumeration
+ */
+export type SpanKind = "server" | "client" | "producer" | "consumer" | "internal";
+/**
+ * Span status code
+ */
+export type StatusCode = "ok" | "error" | "unset";
+/**
+ * Event attached to a span
+ */
+export interface SpanEvent {
+    /** Event name */
+    name: string;
+    /** Event timestamp in nanoseconds */
+    timestamp: number;
+    /** Event attributes */
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Span status
+ */
+export interface SpanStatus {
+    /** Status code */
+    code: StatusCode;
+    /** Optional status message */
+    message?: string;
+}
+/**
+ * Span represents a unit of work in distributed tracing
+ */
+export interface Span {
+    /** Unique trace identifier (32 hex characters) */
+    traceId: string;
+    /** Unique span identifier (16 hex characters) */
+    spanId: string;
+    /** Parent span identifier if this is a child span */
+    parentSpanId?: string;
+    /** Span name (operation name) */
+    name: string;
+    /** Span kind */
+    kind: SpanKind;
+    /** Start time in nanoseconds */
+    startTime: number;
+    /** End time in nanoseconds */
+    endTime?: number;
+    /** Duration in nanoseconds */
+    duration?: number;
+    /** Span attributes */
+    attributes: Record<string, string | number | boolean>;
+    /** Events recorded during the span */
+    events: SpanEvent[];
+    /** Span status */
+    status: SpanStatus;
+    /** Whether the span has ended */
+    ended: boolean;
+}
+/**
+ * Options for starting a new span
+ */
+export interface SpanOptions {
+    /** Span kind */
+    kind?: SpanKind;
+    /** Parent span (if any) */
+    parent?: Span;
+    /** Initial attributes */
+    attributes?: Record<string, string | number | boolean>;
+    /** Links to other spans */
+    links?: Array<{
+        traceId: string;
+        spanId: string;
+        attributes?: Record<string, string | number | boolean>;
+    }>;
+    /** Start time in nanoseconds (defaults to current time) */
+    startTime?: number;
+}
+/**
+ * OTLP Exporter options
+ */
+export interface OTLPExporterOptions {
+    /** OTLP endpoint URL (e.g., http://localhost:4318/v1/traces) */
+    endpoint: string;
+    /** Additional headers to send with requests */
+    headers?: Record<string, string>;
+    /** Export interval in milliseconds (default: 5000) */
+    exportInterval?: number;
+    /** Maximum batch size before forcing export (default: 100) */
+    maxBatchSize?: number;
+    /** Maximum retry attempts on failure (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in milliseconds (default: 1000) */
+    retryDelay?: number;
+    /** Timeout for export requests in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Sampler type
+ */
+export type SamplerType = "always" | "never" | "probabilistic";
+/**
+ * Tracer options
+ */
+export interface TracerOptions {
+    /** OTLP exporter instance */
+    exporter?: OTLPExporter;
+    /** Sampling strategy (default: "always") */
+    sampler?: SamplerType;
+    /** Probability for probabilistic sampling (0.0 to 1.0) */
+    probability?: number;
+    /** Service name for resource attributes */
+    serviceName?: string;
+    /** Additional resource attributes */
+    resourceAttributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Trace context for propagation
+ */
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    traceFlags: number;
+    traceState?: string;
+}
+/**
+ * Generate a random trace ID (32 hex characters / 16 bytes)
+ */
+export declare function generateTraceId(): string;
+/**
+ * Generate a random span ID (16 hex characters / 8 bytes)
+ */
+export declare function generateSpanId(): string;
+/**
+ * Get current time in nanoseconds using Bun.nanoseconds()
+ */
+export declare function nowNanoseconds(): number;
+/**
+ * OTLP HTTP Trace Exporter
+ *
+ * Exports traces to an OTLP-compatible endpoint using HTTP/JSON.
+ */
+export declare class OTLPExporter {
+    private endpoint;
+    private headers;
+    private exportInterval;
+    private maxBatchSize;
+    private maxRetries;
+    private retryDelay;
+    private timeout;
+    private pendingSpans;
+    private exportTimer;
+    private isShuttingDown;
+    private serviceName;
+    private resourceAttributes;
+    constructor(options: OTLPExporterOptions);
+    /**
+     * Set service name for resource attributes
+     */
+    setServiceName(name: string): void;
+    /**
+     * Set resource attributes
+     */
+    setResourceAttributes(attributes: Record<string, string | number | boolean>): void;
+    /**
+     * Start periodic export
+     */
+    start(): void;
+    /**
+     * Stop periodic export
+     */
+    stop(): void;
+    /**
+     * Add a span to the pending batch
+     */
+    addSpan(span: Span): void;
+    /**
+     * Export spans to OTLP endpoint
+     */
+    export(spans: Span[]): Promise<boolean>;
+    /**
+     * Flush all pending spans
+     */
+    flush(): Promise<void>;
+    /**
+     * Close the exporter and flush remaining spans
+     */
+    close(): Promise<void>;
+    /**
+     * Build OTLP export request from spans
+     */
+    private buildExportRequest;
+    /**
+     * Delay helper
+     */
+    private delay;
+}
+/**
+ * Tracer creates and manages spans for distributed tracing
+ */
+export declare class Tracer {
+    private serviceName;
+    private exporter?;
+    private sampler;
+    private probability;
+    private resourceAttributes;
+    private currentSpan;
+    private spanStack;
+    constructor(options?: TracerOptions);
+    /**
+     * Check if a span should be sampled
+     */
+    private shouldSample;
+    /**
+     * Start a new span
+     */
+    startSpan(name: string, options?: SpanOptions): Span;
+    /**
+     * End a span
+     */
+    endSpan(span: Span, endTime?: number): void;
+    /**
+     * Get the current active span
+     */
+    getCurrentSpan(): Span | null;
+    /**
+     * Run a function within span context
+     */
+    withSpan<T>(name: string, fn: (span: Span) => T | Promise<T>, options?: SpanOptions): Promise<T>;
+    /**
+     * Add an event to a span
+     */
+    addEvent(span: Span, name: string, attributes?: Record<string, string | number | boolean>): void;
+    /**
+     * Set an attribute on a span
+     */
+    setAttribute(span: Span, key: string, value: string | number | boolean): void;
+    /**
+     * Set multiple attributes on a span
+     */
+    setAttributes(span: Span, attributes: Record<string, string | number | boolean>): void;
+    /**
+     * Set span status
+     */
+    setStatus(span: Span, code: StatusCode, message?: string): void;
+    /**
+     * Record an error on a span
+     */
+    setError(span: Span, error: Error): void;
+    /**
+     * Update span name
+     */
+    updateName(span: Span, name: string): void;
+    /**
+     * Inject trace context into a carrier (for W3C TraceContext propagation)
+     */
+    injectContext(carrier: Record<string, string>, span?: Span): void;
+    /**
+     * Extract trace context from a carrier (for W3C TraceContext propagation)
+     */
+    extractContext(carrier: Record<string, string>): TraceContext | null;
+    /**
+     * Create a child span from extracted context
+     */
+    startSpanFromContext(name: string, context: TraceContext, options?: SpanOptions): Span;
+    /**
+     * Flush pending spans
+     */
+    flush(): Promise<void>;
+    /**
+     * Close the tracer
+     */
+    close(): Promise<void>;
+    /**
+     * Create a no-op span (not sampled)
+     */
+    private createNoopSpan;
+}
+/**
+ * Create a configured tracer
+ */
+export declare function createTracer(serviceName: string, options?: Omit<TracerOptions, "serviceName">): Tracer;
+/**
+ * Request context for middleware
+ */
+interface RequestContext {
+    method: string;
+    path: string;
+    url: URL;
+    headers: Record<string, string>;
+    getHeader: (name: string) => string | undefined;
+    setHeader: (name: string, value: string) => void;
+    status?: number;
+}
+/**
+ * Response context for middleware
+ */
+interface ResponseContext {
+    status: number;
+    headers?: Record<string, string>;
+}
+/**
+ * Create middleware for automatic HTTP tracing
+ */
+export declare function traceMiddleware(tracer: Tracer): (ctx: RequestContext, next: () => Promise<ResponseContext>) => Promise<ResponseContext>;
+/**
+ * Database interface for tracing
+ */
+interface TracedDatabase {
+    query?: (sql: string, params?: unknown[]) => Promise<unknown>;
+    execute?: (sql: string, params?: unknown[]) => Promise<unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Wrap database with tracing
+ */
+export declare function traceDatabase(tracer: Tracer, db: TracedDatabase, system?: string): TracedDatabase;
+/**
+ * Options for traced fetch
+ */
+interface TracedFetchOptions extends RequestInit {
+    /** Span to use as parent */
+    parentSpan?: Span;
+    /** Additional attributes to add to span */
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Create a traced fetch function
+ */
+export declare function createTracedFetch(tracer: Tracer): (url: string | URL, options?: TracedFetchOptions) => Promise<Response>;
+/**
+ * Span builder for fluent API
+ */
+export declare class SpanBuilder {
+    private span;
+    private tracer;
+    constructor(tracer: Tracer, name: string, options?: SpanOptions);
+    /**
+     * Set an attribute
+     */
+    setAttribute(key: string, value: string | number | boolean): this;
+    /**
+     * Set multiple attributes
+     */
+    setAttributes(attributes: Record<string, string | number | boolean>): this;
+    /**
+     * Add an event
+     */
+    addEvent(name: string, attributes?: Record<string, string | number | boolean>): this;
+    /**
+     * Set status
+     */
+    setStatus(code: StatusCode, message?: string): this;
+    /**
+     * Record error
+     */
+    setError(error: Error): this;
+    /**
+     * End the span
+     */
+    end(): Span;
+    /**
+     * Get the underlying span
+     */
+    getSpan(): Span;
+}
+/**
+ * Create a span builder
+ */
+export declare function span(tracer: Tracer, name: string, options?: SpanOptions): SpanBuilder;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

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

package/dist/template/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Template System - Subpath Export
+ *
+ * Usage: import { TemplateEngine } from "@buenojs/bueno/template"
+ */
+export * from "../templates/index";
+//# sourceMappingURL=index.d.ts.map

package/dist/template/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/template/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC"}

package/dist/templates/engine.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Template Engine
+ *
+ * Main orchestration class for:
+ * - Loading templates (with caching)
+ * - Rendering with variable interpolation
+ * - Converting Markdown to HTML/text
+ * - Channel-specific variant selection
+ */
+import type { RenderOptions, TemplateData, TemplateEngineConfig, TemplateEngineMetrics } from "./types";
+/**
+ * Template engine
+ */
+export declare class TemplateEngine {
+    private config;
+    private loader;
+    private simpleRenderer;
+    private metrics;
+    private renderTimes;
+    private channelVariantMap;
+    constructor(config: TemplateEngineConfig);
+    /**
+     * Render a template with data
+     */
+    render(templateId: string, data: TemplateData, options?: RenderOptions): Promise<string>;
+    /**
+     * Render template to HTML (convenience method)
+     */
+    renderToHtml(templateId: string, data: TemplateData, variant?: string): Promise<string>;
+    /**
+     * Render template to plain text (convenience method)
+     */
+    renderToText(templateId: string, data: TemplateData, variant?: string): Promise<string>;
+    /**
+     * Get variant for rendering
+     */
+    private _getVariant;
+    /**
+     * Get variant for a specific channel
+     * Useful for NotificationService to auto-detect correct variant
+     */
+    getVariantForChannel(channel: string): string;
+    /**
+     * Register custom filter
+     */
+    registerFilter(name: string, fn: (value: unknown, ...args: unknown[]) => unknown): void;
+    /**
+     * Update metrics
+     */
+    private _updateMetrics;
+    /**
+     * Get engine metrics
+     */
+    getMetrics(): TemplateEngineMetrics;
+    /**
+     * Clear caches
+     */
+    clear(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/templates/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/templates/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACX,aAAa,EAEb,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,SAAS,CAAC;AAcjB;;GAEG;AACH,qBAAa,cAAc;IAad,OAAO,CAAC,MAAM;IAZ1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,OAAO,CAMb;IACF,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,iBAAiB,CAAyB;gBAE9B,MAAM,EAAE,oBAAoB;IAchD;;OAEG;IACG,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC;IAmDlB;;OAEG;IACG,YAAY,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAOlB;;OAEG;IACG,YAAY,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAOlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;OAGG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACH,cAAc,CACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACjD,IAAI;IAIP;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,UAAU,IAAI,qBAAqB;IAInC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGb"}

package/dist/templates/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Template System Public API
+ */
+export * from "./types";
+export { TemplateEngine } from "./engine";
+export { TemplateLoader } from "./loader";
+export { SimpleRenderer } from "./renderers/simple";
+export { MarkdownRenderer } from "./renderers/markdown";
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/templates/loader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Template Loader
+ *
+ * Loads templates from the filesystem with support for:
+ * - YAML front matter (metadata)
+ * - Template variants (channel-specific sections)
+ * - In-memory caching with TTL
+ * - Hot reload in development mode
+ */
+import type { Template, TemplateLoaderOptions } from "./types";
+/**
+ * Template loader with caching and hot reload
+ */
+export declare class TemplateLoader {
+    private options;
+    private cache;
+    private watchers;
+    private metrics;
+    constructor(options: TemplateLoaderOptions);
+    /**
+     * Load a template by ID (path like "emails/welcome")
+     */
+    load(templateId: string): Template;
+    /**
+     * Load template from disk with variant parsing
+     */
+    private _loadFromDisk;
+    /**
+     * Watch template file for changes (development mode)
+     */
+    private _watchTemplate;
+    /**
+     * Clear all caches and watchers
+     */
+    clear(): void;
+    /**
+     * Get loader metrics
+     */
+    getMetrics(): {
+        loads: number;
+        cacheHits: number;
+        cacheMisses: number;
+    };
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/templates/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/templates/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACX,QAAQ,EACR,qBAAqB,EAErB,MAAM,SAAS,CAAC;AAuJjB;;GAEG;AACH,qBAAa,cAAc;IAUd,OAAO,CAAC,OAAO;IAT3B,OAAO,CAAC,KAAK,CACF;IACX,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,OAAO,CAIb;gBAEkB,OAAO,EAAE,qBAAqB;IAQlD;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ;IA+ClC;;OAEG;IACH,OAAO,CAAC,aAAa;IAiDrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,UAAU;;;;;CAGV"}

package/dist/templates/renderers/markdown.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Markdown Renderer
+ *
+ * Converts Markdown to HTML or plain text.
+ * Lightweight implementation supporting:
+ * - Headings (# ## ###)
+ * - Bold/italic (*text*, **text**)
+ * - Lists (- item, 1. item)
+ * - Links [text](url)
+ * - Code (`inline`)
+ * - Blockquotes (> quote)
+ * - Paragraphs (blank line separated)
+ *
+ * NOT supported (kept lightweight):
+ * - Tables
+ * - Code blocks with syntax highlighting
+ * - Complex nesting
+ * - Strikethrough
+ * - Footnotes
+ */
+/**
+ * Markdown to HTML renderer
+ */
+export declare class MarkdownRenderer {
+    /**
+     * Convert Markdown string to HTML
+     */
+    static toHtml(markdown: string): string;
+    /**
+     * Convert Markdown string to plain text
+     */
+    static toText(markdown: string): string;
+    /**
+     * Process ordered lists (1. 2. 3.)
+     */
+    private static _processOrderedLists;
+    /**
+     * Process unordered lists (- * +)
+     */
+    private static _processUnorderedLists;
+    /**
+     * Process paragraphs (blank line separated)
+     */
+    private static _processParagraphs;
+}
+//# sourceMappingURL=markdown.d.ts.map

package/dist/templates/renderers/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/templates/renderers/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;GAEG;AACH,qBAAa,gBAAgB;IAC5B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAiDvC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAiCvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmCnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAmCrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAmBjC"}