@smthrs/observability 0.35.0 → 1.0.0-rc.12

package/dist/esm/BrowserOtel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOtel.d.ts","sourceRoot":"","sources":["../../src/BrowserOtel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,IAAI,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE3E;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAA;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,GAAG,SAAS,CAAA;IACzF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC,GAAG,SAAS,CAAA;IACxG,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,GAAG,SAAS,CAAA;IACtF,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACvD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,OAAO,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,4BAA4B,CAUlG,CAAA"}

package/dist/esm/BrowserOtel.js

@@ -0,0 +1,24 @@
+/**
+ * Browser OpenTelemetry setup with explicitly injected providers/readers.
+ *
+ * @since 0.1.0
+ */
+import * as WebSdk from "@effect/opentelemetry/WebSdk";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Resource from "./Resource.js";
+/**
+ * Builds a scoped browser OpenTelemetry layer. The web SDK owns every
+ * processor and reader the factories return and shuts them down on release.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export const layerOtel = (options) => Layer.unwrap(Effect.map(Resource.decode(options.resource), (decoded) => WebSdk.layer(() => ({
+    resource: Resource.toOpenTelemetryConfiguration(decoded),
+    spanProcessor: options.spanProcessor?.(),
+    logRecordProcessor: options.logRecordProcessor?.(),
+    metricReader: options.metricReader?.(),
+    loggerMergeWithExisting: options.loggerMergeWithExisting
+}))));
+//# sourceMappingURL=BrowserOtel.js.map

package/dist/esm/BrowserOtel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOtel.js","sourceRoot":"","sources":["../../src/BrowserOtel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,8BAA8B,CAAA;AAItD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAqBzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAgB,EAA6D,EAAE,CACvG,KAAK,CAAC,MAAM,CACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CACxD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC,4BAA4B,CAAC,OAAO,CAAC;IACxD,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE;IACxC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,EAAE;IAClD,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE;IACtC,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;CACzD,CAAC,CAAC,CAAC,CACP,CAAA"}

package/dist/esm/Endpoint.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Validated collector endpoints for the OTLP exporters.
+ *
+ * The endpoint is the field an operator most often gets wrong, and a wrong one
+ * is invisible: Effect's exporter absorbs export failure by design, so a layer
+ * built against `""` or `"localhost:4318"` looks identical to a working one and
+ * simply never delivers. Every builder therefore decodes its endpoint during
+ * layer acquisition, the same posture `Resource` already takes.
+ *
+ * @since 1.0.0-rc.0
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+/**
+ * Largest collector endpoint accepted by a builder.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumEndpointLength = 2048;
+/**
+ * Runtime schema for an absolute `http:` or `https:` collector endpoint that
+ * carries no credentials, query, fragment, backslashes, spaces, or controls.
+ * A base path is allowed; authentication belongs in exporter headers.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const Endpoint: Schema.String;
+declare const InvalidExporterEndpoint_base: Schema.Class<InvalidExporterEndpoint, Schema.TaggedStruct<"@smthrs/observability/InvalidExporterEndpoint", {
+    readonly code: Schema.Literal<"invalid_exporter_endpoint">;
+    readonly path: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Stable exporter-endpoint refusal shared by every OTLP builder.
+ *
+ * @category errors
+ * @since 1.0.0-rc.0
+ */
+export declare class InvalidExporterEndpoint extends InvalidExporterEndpoint_base {
+}
+/**
+ * Removes the repeated trailing separators that would otherwise produce a
+ * double slash in a signal URL.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export declare const normalize: (endpoint: string) => string;
+/**
+ * Decodes one collector endpoint into its normalized form without retaining
+ * the rejected value.
+ *
+ * `path` names the option the endpoint arrived on, so the refusal points at the
+ * caller's own field rather than at a shared internal name.
+ *
+ * @category decoding
+ * @since 1.0.0-rc.0
+ */
+export declare const decode: (endpoint: unknown, path: string) => Effect.Effect<string, InvalidExporterEndpoint>;
+/**
+ * Builds the OTLP/HTTP URL one signal is posted to below a decoded endpoint.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export declare const signalUrl: (endpoint: string, signal: "traces" | "metrics" | "logs") => string;
+export {};
+//# sourceMappingURL=Endpoint.d.ts.map

package/dist/esm/Endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Endpoint.d.ts","sourceRoot":"","sources":["../../src/Endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,OAAQ,CAAA;AAuC1C;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,eAGpB,CAAA;;;;;;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,4BAO5C;CAAG;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,KAAG,MAAsC,CAAA;AAEnF;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,GACjB,UAAU,OAAO,EACjB,MAAM,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAW7C,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,QAAQ,QAAQ,GAAG,SAAS,GAAG,MAAM,KAAG,MAC7C,CAAA"}

package/dist/esm/Endpoint.js

@@ -0,0 +1,110 @@
+/**
+ * Validated collector endpoints for the OTLP exporters.
+ *
+ * The endpoint is the field an operator most often gets wrong, and a wrong one
+ * is invisible: Effect's exporter absorbs export failure by design, so a layer
+ * built against `""` or `"localhost:4318"` looks identical to a working one and
+ * simply never delivers. Every builder therefore decodes its endpoint during
+ * layer acquisition, the same posture `Resource` already takes.
+ *
+ * @since 1.0.0-rc.0
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+/**
+ * Largest collector endpoint accepted by a builder.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export const maximumEndpointLength = 2_048;
+/** The largest code unit the WHATWG URL parser repairs away: the space. */
+const largestRepairedCodeUnit = 0x20;
+/**
+ * Reports whether the URL parser would repair the value rather than parse it
+ * as written. It strips leading and trailing C0 controls and spaces and
+ * removes tab, newline, and carriage return from anywhere in its input, and
+ * every one of those sits at or below {@link largestRepairedCodeUnit}.
+ */
+const repairedByUrlParser = (value) => {
+    for (let index = 0; index < value.length; index++) {
+        if (value.charCodeAt(index) <= largestRepairedCodeUnit)
+            return true;
+    }
+    return false;
+};
+const isAbsoluteHttpUrl = (value) => {
+    // `new URL` alone is not a validator here. It strips padding and inline
+    // control characters before parsing, so it reports a copy-pasted
+    // `"http://collector:4318\n"` as well formed while the untrimmed original is
+    // what a builder would hand its exporter: either an unusable URL or a
+    // request to a host nobody typed. No legal collector endpoint carries one of
+    // these, so refusing them costs nothing and closes the silent case.
+    if (repairedByUrlParser(value))
+        return false;
+    // Exporters append /v1/<signal> to this base. A query or fragment would
+    // swallow that suffix instead of changing the request path. Also refuse
+    // missing authority separators and backslashes that WHATWG silently repairs.
+    if (!/^https?:\/\/[^/]/i.test(value) || /[?#\\]/.test(value))
+        return false;
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    return url.username === "" && url.password === "";
+};
+/**
+ * Runtime schema for an absolute `http:` or `https:` collector endpoint that
+ * carries no credentials, query, fragment, backslashes, spaces, or controls.
+ * A base path is allowed; authentication belongs in exporter headers.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export const Endpoint = Schema.String.check(Schema.isMaxLength(maximumEndpointLength), Schema.makeFilter((value) => isAbsoluteHttpUrl(value), { title: "absoluteCollectorEndpoint" }));
+/**
+ * Stable exporter-endpoint refusal shared by every OTLP builder.
+ *
+ * @category errors
+ * @since 1.0.0-rc.0
+ */
+export class InvalidExporterEndpoint extends Schema.TaggedError()("@smthrs/observability/InvalidExporterEndpoint", {
+    code: Schema.Literal("invalid_exporter_endpoint"),
+    path: Schema.String,
+    message: Schema.String
+}) {
+}
+/**
+ * Removes the repeated trailing separators that would otherwise produce a
+ * double slash in a signal URL.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export const normalize = (endpoint) => endpoint.replace(/\/+$/, "");
+/**
+ * Decodes one collector endpoint into its normalized form without retaining
+ * the rejected value.
+ *
+ * `path` names the option the endpoint arrived on, so the refusal points at the
+ * caller's own field rather than at a shared internal name.
+ *
+ * @category decoding
+ * @since 1.0.0-rc.0
+ */
+export const decode = (endpoint, path) => Schema.decodeUnknownEffect(Endpoint)(endpoint).pipe(Effect.map(normalize), Effect.mapError(() => new InvalidExporterEndpoint({
+    code: "invalid_exporter_endpoint",
+    path,
+    message: `OTLP collector ${path} must be an absolute http:// or https:// base URL without credentials, query, fragment, backslashes, spaces, or control characters`
+})));
+/**
+ * Builds the OTLP/HTTP URL one signal is posted to below a decoded endpoint.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export const signalUrl = (endpoint, signal) => `${normalize(endpoint)}/v1/${signal}`;
+//# sourceMappingURL=Endpoint.js.map

package/dist/esm/Endpoint.js.map

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

package/dist/esm/JournalLogger.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Non-blocking forwarding of bounded operational logs to the durable journal.
+ *
+ * @since 0.1.0
+ */
+import * as Journal from "@smthrs/journal/Journal";
+import * as JournalEvent from "@smthrs/journal/JournalEvent";
+import * as Cause from "effect/Cause";
+import * as Layer from "effect/Layer";
+import type * as LogLevel from "effect/LogLevel";
+import * as Schema from "effect/Schema";
+/**
+ * Largest queue accepted by the forwarding logger.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumCapacity = 65536;
+/**
+ * Largest detached log payload admitted to the asynchronous queue.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumSnapshotBytes: number;
+/**
+ * Largest number of container members copied into one detached log payload.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumSnapshotMembers = 4096;
+/**
+ * Deepest container path copied into one detached log payload.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumSnapshotDepth = 64;
+/**
+ * What a hostile or unreadable logged value becomes.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const unrenderableMarker = "[Unrenderable]";
+/**
+ * What a value beyond a logger resource ceiling becomes.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const truncatedMarker = "[Truncated]";
+/**
+ * Options for the journal forwarding logger.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export interface Options {
+    /** The run every forwarded record is attributed to. */
+    readonly runId: JournalEvent.RunId;
+    /** Queue depth, 1 through {@link maximumCapacity}. Defaults to 256. */
+    readonly capacity?: number | undefined;
+    /**
+     * Pins `References.MinimumLogLevel` for the whole application. Omitted, the
+     * layer leaves that reference alone and Effect's own `Info` default applies.
+     */
+    readonly minimumLogLevel?: LogLevel.LogLevel | undefined;
+    /**
+     * Keeps the ambient loggers alongside the forwarder. Defaults to `false`,
+     * which replaces the ambient logger set.
+     */
+    readonly mergeWithExisting?: boolean | undefined;
+}
+declare const InvalidJournalLoggerOptions_base: Schema.Class<InvalidJournalLoggerOptions, Schema.TaggedStruct<"@smthrs/observability/InvalidJournalLoggerOptions", {
+    readonly code: Schema.Literal<"invalid_journal_logger_options">;
+    readonly path: Schema.String;
+    readonly message: Schema.String;
+}>, Cause.YieldableError>;
+/**
+ * A stable logger configuration refusal.
+ *
+ * @category errors
+ * @since 1.0.0-rc.0
+ */
+export declare class InvalidJournalLoggerOptions extends InvalidJournalLoggerOptions_base {
+}
+/**
+ * One typed failure retained from an Effect cause.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const TelemetryFail: Schema.Struct<{
+    readonly _tag: Schema.Literal<"Fail">;
+    readonly error: Schema.Unknown;
+}>;
+/**
+ * One unexpected defect retained from an Effect cause.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const TelemetryDie: Schema.Struct<{
+    readonly _tag: Schema.Literal<"Die">;
+    readonly defect: Schema.Unknown;
+}>;
+/**
+ * One interruption retained from an Effect cause.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const TelemetryInterrupt: Schema.Struct<{
+    readonly _tag: Schema.Literal<"Interrupt">;
+    readonly fiberId: Schema.NullOr<Schema.Int>;
+}>;
+/**
+ * One reason in a persisted telemetry cause.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const TelemetryCauseReason: Schema.Union<readonly [Schema.Struct<{
+    readonly _tag: Schema.Literal<"Fail">;
+    readonly error: Schema.Unknown;
+}>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"Die">;
+    readonly defect: Schema.Unknown;
+}>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"Interrupt">;
+    readonly fiberId: Schema.NullOr<Schema.Int>;
+}>]>;
+/**
+ * One reason in a persisted telemetry cause.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type TelemetryCauseReason = typeof TelemetryCauseReason.Type;
+/**
+ * A versioned structural Effect cause.
+ *
+ * Effect 4 stores composed failures as an ordered reason list. The projection
+ * preserves that order and each fail, defect, or interrupt discriminator.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const TelemetryCause: Schema.Struct<{
+    readonly version: Schema.Literal<1>;
+    readonly reasons: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly _tag: Schema.Literal<"Fail">;
+        readonly error: Schema.Unknown;
+    }>, Schema.Struct<{
+        readonly _tag: Schema.Literal<"Die">;
+        readonly defect: Schema.Unknown;
+    }>, Schema.Struct<{
+        readonly _tag: Schema.Literal<"Interrupt">;
+        readonly fiberId: Schema.NullOr<Schema.Int>;
+    }>]>>;
+}>;
+/**
+ * A versioned structural Effect cause.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type TelemetryCause = typeof TelemetryCause.Type;
+/**
+ * Runtime schema for the operational log payload written to the journal.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const TelemetryLog: Schema.Struct<{
+    readonly version: Schema.Literal<1>;
+    readonly level: Schema.Literals<readonly ["All", "Fatal", "Error", "Warn", "Info", "Debug", "Trace", "None"]>;
+    readonly message: Schema.Unknown;
+    readonly annotations: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly cause: Schema.Struct<{
+        readonly version: Schema.Literal<1>;
+        readonly reasons: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly _tag: Schema.Literal<"Fail">;
+            readonly error: Schema.Unknown;
+        }>, Schema.Struct<{
+            readonly _tag: Schema.Literal<"Die">;
+            readonly defect: Schema.Unknown;
+        }>, Schema.Struct<{
+            readonly _tag: Schema.Literal<"Interrupt">;
+            readonly fiberId: Schema.NullOr<Schema.Int>;
+        }>]>>;
+    }>;
+    readonly fiberId: Schema.Int;
+    readonly traceId: Schema.optionalKey<Schema.String>;
+    readonly spanId: Schema.optionalKey<Schema.String>;
+    readonly timestamp: Schema.String;
+}>;
+/**
+ * Versioned operational log payload written to the journal.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type TelemetryLog = typeof TelemetryLog.Type;
+/**
+ * Installs a bounded, drop-on-overflow logger forwarder for one explicit run.
+ *
+ * Configuration is decoded before a worker starts. The callback reads the
+ * queue's remaining room first, snapshots and redacts a bounded DTO
+ * synchronously only when a slot is free, then performs only non-blocking
+ * queue admission. A record a saturated queue cannot take is counted and
+ * discarded without being snapshotted. Queue overflow, journal `Dropped` receipts, delivery failures,
+ * and journal defects each advance `Metric.droppedLogRecords`. The two failure
+ * paths also warn through the ambient loggers with a fixed code and run id,
+ * and the worker keeps draining. `Accepted` and `Duplicate` do not advance the
+ * counter. Admission receipts cannot identify later drop-oldest evictions of
+ * these records or report asynchronous persistence failures or shutdown losses.
+ * Closing the scope interrupts the worker and may drop records still queued
+ * behind an in-flight write without advancing the counter.
+ *
+ * The layer replaces the ambient logger set unless `mergeWithExisting` is
+ * `true`, and provides `MinimumLogLevel` only when `minimumLogLevel` is given,
+ * so an application that set that reference elsewhere keeps it.
+ *
+ * @category layers
+ * @since 1.0.0-rc.0
+ */
+export declare const layerJournalForwarding: (options: Options) => Layer.Layer<never, InvalidJournalLoggerOptions, Journal.Journal>;
+export {};
+//# sourceMappingURL=JournalLogger.d.ts.map

package/dist/esm/JournalLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JournalLogger.d.ts","sourceRoot":"","sources":["../../src/JournalLogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,OAAO,MAAM,yBAAyB,CAAA;AAClD,OAAO,KAAK,YAAY,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAGrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAKhD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,CAAA;AAErC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAc,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,OAAQ,CAAA;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,gBAAgB,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IAClC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAA;IACxD;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACjD;;;;;;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,gCAOhD;CAAG;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;EAGxB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;EAGvB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;EAG7B,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;IAAkE,CAAA;AAEnG;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;EAGzB,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;EAUvB,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AA8UnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,OAAO,KACf,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,2BAA2B,EAAE,OAAO,CAAC,OAAO,CAsE/D,CAAA"}