@rasputin-ai/core 0.4.1 → 0.5.0-alpha.10

package/README.md

@@ -1,3 +1,3 @@
-# Rasputin AI SDK — Core
-
-Low-level error capture, stack parsing, source maps, and ingest transport. Most applications should use [`@rasputin-ai/node`](https://www.npmjs.com/package/@rasputin-ai/node) or [`@rasputin-ai/elysia`](https://www.npmjs.com/package/@rasputin-ai/elysia) instead.
+# Rasputin AI SDK — Core
+
+Low-level error capture, stack parsing, source maps, and ingest transport. Most applications should use [`@rasputin-ai/node`](https://www.npmjs.com/package/@rasputin-ai/node) or [`@rasputin-ai/elysia`](https://www.npmjs.com/package/@rasputin-ai/elysia) instead.

package/dist/create-client/is-client-enabled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-client-enabled.d.ts","sourceRoot":"","sources":["../../src/create-client/is-client-enabled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7E,uDAAuD;AACvD,eAAO,MAAM,eAAe,GAAI,SAAS,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,KAAG,OACpD,CAAC;AAEzB,eAAO,MAAM,UAAU,QAAO,cAa5B,CAAC"}
+{"version":3,"file":"is-client-enabled.d.ts","sourceRoot":"","sources":["../../src/create-client/is-client-enabled.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7E,uDAAuD;AACvD,eAAO,MAAM,eAAe,GAAI,SAAS,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,KAAG,OACpD,CAAC;AAEzB,eAAO,MAAM,UAAU,QAAO,cA2B5B,CAAC"}

package/dist/create-ingest-event/runtime-execution-state-types.d.ts

@@ -1,9 +1,8 @@
-import type { RuntimeFunctionDefinition, SourcePosition } from '../source-identity/source-identity';
 /**
- * Wire-facing runtime-state types kept inside the standalone SDK package. They mirror the server
- * contract without importing the application's private `~db` graph, allowing the published SDK to
- * remain independently buildable and usable by external projects.
+ * Keep in sync with `packages/~db/schemas/occurrence-runtime-state-schema.ts`.
+ * ⚠️ DERIVATION LOCKSTEP — the published SDK cannot import Rasputin's private packages.
  */
+import type { RuntimeFunctionDefinition, SourcePosition } from '../source-identity/source-identity';
 export type RuntimeExecutionKind = 'http' | 'serverless' | 'job' | 'scheduled' | 'custom';
 export type RuntimeExecutionRequest = {
     method?: string | null;
@@ -62,22 +61,60 @@ export type RuntimeFunctionCallsSuppressedEvent = {
     totalDurationMs: number;
 };
 export type RuntimeExecutionEvent = RuntimeFunctionEnterEvent | RuntimeFunctionExitEvent | RuntimeFunctionThrowEvent | RuntimeFunctionCallsSuppressedEvent;
+export type RuntimeCapturedRoot = {
+    rootId: number;
+    callId: number;
+    value: unknown;
+    completeness: 'exact' | 'partial';
+};
+export type RuntimeCapturedControlFact = {
+    factId: number;
+    callId: number;
+    value: boolean;
+};
+export type RuntimeDerivationCapture = {
+    manifestHash: string;
+    roots: RuntimeCapturedRoot[];
+    controlFacts: RuntimeCapturedControlFact[];
+};
+export type RuntimeDerivationMetrics = {
+    derivationCandidateFunctions: number;
+    derivationElidedFunctionCalls: number;
+    derivationRootsCaptured: number;
+    derivationControlFactsCaptured: number;
+    derivationValuesAvoided: number;
+    derivationFallbackFunctions: number;
+    derivationFallbackExpressions: number;
+    derivationFallbackReasons: Record<string, number>;
+    derivationRootBytes: number;
+};
 export type RuntimeExecutionRecorderMetrics = {
     /** Cumulative synchronous wall time spent in recorder-owned work for this execution. */
     inlineWallTimeMs: number;
+    derivation?: RuntimeDerivationMetrics;
+};
+export type RuntimeCaptureCoverage = 'full' | 'partial' | 'none';
+/** How this execution was recorded. Completeness of an individual value is separate. */
+export type RuntimeCaptureProfile = {
+    source: 'automatic' | 'manual' | 'scope-only';
+    functionBoundaries: RuntimeCaptureCoverage;
+    functionValues: 'full' | 'selective' | 'none';
+    timings: RuntimeCaptureCoverage;
+    derivation: 'available' | 'none';
 };
 /** Bounded, redacted execution state captured at the moment an error is reported. */
 export type RuntimeExecutionState = {
-    version: 2;
+    version: 4;
+    captureProfile: RuntimeCaptureProfile;
     executionId: string;
     startedAt: string;
     durationMs: number;
-    /** Optional for compatibility with runtime states produced by older SDK versions. */
     recorder?: RuntimeExecutionRecorderMetrics;
     execution: RuntimeExecutionMetadata;
     /** Function metadata is stored once per execution; events keep only compact opaque IDs. */
     functions: RuntimeFunctionDefinition[];
     events: RuntimeExecutionEvent[];
+    derivation?: RuntimeDerivationCapture;
     truncated?: {
         eventsDropped: number;
     };

package/dist/create-ingest-event/runtime-execution-state-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-execution-state-types.d.ts","sourceRoot":"","sources":["../../src/create-ingest-event/runtime-execution-state-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-execution-state-types.d.ts","sourceRoot":"","sources":["../../src/create-ingest-event/runtime-execution-state-types.ts"],"names":[],"mappings":"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"}

package/dist/derivation/canonical-json.d.ts

@@ -0,0 +1,3 @@
+/** Deterministic JSON so manifest hashes do not depend on object insertion order. */
+export declare const canonicalJson: (value: unknown) => string;
+//# sourceMappingURL=canonical-json.d.ts.map

package/dist/derivation/canonical-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.d.ts","sourceRoot":"","sources":["../../src/derivation/canonical-json.ts"],"names":[],"mappings":"AAMA,qFAAqF;AACrF,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,MA2B9C,CAAC"}

package/dist/derivation/captured-value-markers.d.ts

@@ -0,0 +1,5 @@
+/** Serializer markers and tagged holes that make a captured snapshot incomplete. */
+export declare const capturedValueCompleteness: (value: unknown) => "exact" | "partial";
+export declare const isRedactedCapturedValue: (value: unknown) => boolean;
+export declare const isSerializerMarker: (value: unknown) => boolean;
+//# sourceMappingURL=captured-value-markers.d.ts.map

package/dist/derivation/captured-value-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captured-value-markers.d.ts","sourceRoot":"","sources":["../../src/derivation/captured-value-markers.ts"],"names":[],"mappings":"AAWA,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,KAAG,OAAO,GAAG,SA6BpE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,OAKxD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,OAInD,CAAC"}

package/dist/derivation/evaluate-derivation-plan.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Keep in sync with `packages/~core/lib/runtime-derivation/evaluate-derivation-plan.ts`.
+ * ⚠️ DERIVATION LOCKSTEP — investigation must interpret the same IR the SDK emitted.
+ */
+import type { RuntimeExecutionState } from '../create-ingest-event/runtime-execution-state-types';
+import type { InstrumentationManifestContent } from '../instrumentation-manifest/instrumentation-manifest-types';
+export type DerivationValidation = {
+    status: 'verified' | 'mismatch';
+    derivedValue?: unknown;
+    expressionId?: number;
+    dependencies?: number[];
+};
+export type EvaluatedRuntimeValue = {
+    origin: 'captured';
+    completeness: 'exact' | 'partial';
+    value: unknown;
+    derivationValidation?: DerivationValidation;
+} | {
+    origin: 'derived';
+    completeness: 'exact' | 'partial';
+    value: unknown;
+    dependencies: number[];
+    derivationValidation?: DerivationValidation;
+} | {
+    origin: 'unavailable';
+    reason: string;
+};
+export type EvaluatedFunctionState = {
+    functionId: string;
+    callId: number;
+    values: Record<number, EvaluatedRuntimeValue>;
+    variables: Array<{
+        variableId: number;
+        name: string;
+        availableAtLine: number;
+        availableAtColumn: number;
+        result: EvaluatedRuntimeValue;
+    }>;
+    returnValue?: EvaluatedRuntimeValue;
+};
+export type EvaluateDerivationResult = {
+    unavailableReason?: string;
+    functions: EvaluatedFunctionState[];
+};
+export declare const evaluateRuntimeDerivation: (input: {
+    state: RuntimeExecutionState;
+    manifest: InstrumentationManifestContent | null;
+}) => EvaluateDerivationResult;
+export declare const evaluatedValueAtLine: (evaluated: EvaluatedFunctionState | undefined, line: number | null) => Array<{
+    name: string;
+    result: EvaluatedRuntimeValue;
+}>;
+//# sourceMappingURL=evaluate-derivation-plan.d.ts.map

package/dist/derivation/evaluate-derivation-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-derivation-plan.d.ts","sourceRoot":"","sources":["../../src/derivation/evaluate-derivation-plan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAGX,qBAAqB,EACrB,MAAM,sDAAsD,CAAC;AAM9D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4DAA4D,CAAC;AAYjH,MAAM,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC9B;IACA,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC3C,GACD;IACA,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC3C,GACD;IACA,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CACd,CAAC;AAEL,MAAM,MAAM,sBAAsB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC9C,SAAS,EAAE,KAAK,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,qBAAqB,CAAC;KAC9B,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACpC,CAAC;AA01BF,eAAO,MAAM,yBAAyB,GAAI,OAAO;IAChD,KAAK,EAAE,qBAAqB,CAAC;IAC7B,QAAQ,EAAE,8BAA8B,GAAG,IAAI,CAAC;CAChD,KAAG,wBAuEH,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAChC,WAAW,sBAAsB,GAAG,SAAS,EAC7C,MAAM,MAAM,GAAG,IAAI,KACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAKvD,CAAC"}

package/dist/derivation/hash-instrumentation-manifest.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Keep in sync with `packages/~core/lib/runtime-derivation/hash-instrumentation-manifest.ts`.
+ * ⚠️ DERIVATION LOCKSTEP — capture-time and investigation-time hashes must match.
+ */
+import type { InstrumentationManifestContent } from '../instrumentation-manifest/instrumentation-manifest-types';
+export declare const hashInstrumentationManifest: (manifest: InstrumentationManifestContent) => string;
+//# sourceMappingURL=hash-instrumentation-manifest.d.ts.map

package/dist/derivation/hash-instrumentation-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-instrumentation-manifest.d.ts","sourceRoot":"","sources":["../../src/derivation/hash-instrumentation-manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4DAA4D,CAAC;AAcjH,eAAO,MAAM,2BAA2B,GAAI,UAAU,8BAA8B,KAAG,MAUtF,CAAC"}

package/dist/derivation/rasputin-wire-tag.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Unknown and truncated derivation data must not look like ordinary application objects.
+ * A tagged tuple whose first element is a NUL-prefixed brand cannot collide with JSON
+ * that customer code would reasonably produce.
+ * Keep in sync with `packages/~core/lib/runtime-derivation/rasputin-wire-tag.ts`.
+ * ⚠️ DERIVATION LOCKSTEP — tagged holes must decode the same way on the server.
+ */
+export declare const RASPUTIN_WIRE_TAG: "\0rasputin";
+export type RasputinTaggedUnknown = readonly [typeof RASPUTIN_WIRE_TAG, 'unknown'];
+export type RasputinTaggedUnavailable = readonly [typeof RASPUTIN_WIRE_TAG, 'unavailable', string];
+export type RasputinTaggedOmitted = readonly [typeof RASPUTIN_WIRE_TAG, 'omitted'];
+export type RasputinTaggedRedacted = readonly [typeof RASPUTIN_WIRE_TAG, 'redacted'];
+export type RasputinTaggedTruncated = readonly [
+    typeof RASPUTIN_WIRE_TAG,
+    'truncated',
+    {
+        reason: string;
+        originalLength?: number;
+        capturedCount?: number;
+        omittedCount?: number;
+        value?: unknown;
+    }
+];
+export type RasputinTaggedValue = RasputinTaggedUnknown | RasputinTaggedUnavailable | RasputinTaggedOmitted | RasputinTaggedRedacted | RasputinTaggedTruncated;
+export declare const rasputinUnknown: () => RasputinTaggedUnknown;
+export declare const rasputinUnavailable: (reason: string) => RasputinTaggedUnavailable;
+export declare const rasputinOmitted: () => RasputinTaggedOmitted;
+export declare const rasputinRedacted: () => RasputinTaggedRedacted;
+export declare const rasputinTruncated: (payload: RasputinTaggedTruncated[2]) => RasputinTaggedTruncated;
+export declare const isRasputinTaggedValue: (value: unknown) => value is RasputinTaggedValue;
+export declare const rasputinTagKind: (value: unknown) => RasputinTaggedValue[1] | undefined;
+//# sourceMappingURL=rasputin-wire-tag.d.ts.map

package/dist/derivation/rasputin-wire-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasputin-wire-tag.d.ts","sourceRoot":"","sources":["../../src/derivation/rasputin-wire-tag.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAG,YAAyB,CAAC;AAE3D,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,OAAO,iBAAiB,EAAE,SAAS,CAAC,CAAC;AACnF,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAAC,OAAO,iBAAiB,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;AACnG,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,OAAO,iBAAiB,EAAE,SAAS,CAAC,CAAC;AACnF,MAAM,MAAM,sBAAsB,GAAG,SAAS,CAAC,OAAO,iBAAiB,EAAE,UAAU,CAAC,CAAC;AACrF,MAAM,MAAM,uBAAuB,GAAG,SAAS;IAC9C,OAAO,iBAAiB;IACxB,WAAW;IACX;QACC,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,OAAO,CAAC;KAChB;CACD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC5B,qBAAqB,GACrB,yBAAyB,GACzB,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,CAAC;AAE3B,eAAO,MAAM,eAAe,QAAO,qBAAuD,CAAC;AAE3F,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,KAAG,yBAIpD,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,qBAAuD,CAAC;AAE3F,eAAO,MAAM,gBAAgB,QAAO,sBAAyD,CAAC;AAE9F,eAAO,MAAM,iBAAiB,GAAI,SAAS,uBAAuB,CAAC,CAAC,CAAC,KAAG,uBAIvE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,mBAU/D,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,SACtB,CAAC"}

package/dist/derivation/sha256.d.ts

@@ -0,0 +1,3 @@
+/** Portable SHA-256 so capture-time and investigation-time hashes match without Node crypto. */
+export declare const sha256Hex: (input: string) => string;
+//# sourceMappingURL=sha256.d.ts.map

package/dist/derivation/sha256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../../src/derivation/sha256.ts"],"names":[],"mappings":"AAiBA,gGAAgG;AAChG,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAiEzC,CAAC"}

package/dist/derivation/wire-values-equal.d.ts

@@ -0,0 +1,3 @@
+/** Compare already-serialized snapshots. Never invokes getters or application code. */
+export declare const wireValuesEqual: (left: unknown, right: unknown) => boolean;
+//# sourceMappingURL=wire-values-equal.d.ts.map

package/dist/derivation/wire-values-equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-values-equal.d.ts","sourceRoot":"","sources":["../../src/derivation/wire-values-equal.ts"],"names":[],"mappings":"AAkBA,uFAAuF;AACvF,eAAO,MAAM,eAAe,GAAI,MAAM,OAAO,EAAE,OAAO,OAAO,KAAG,OAoB/D,CAAC"}

package/dist/index.d.ts

@@ -5,8 +5,13 @@ export { isClientEnabled } from './create-client/is-client-enabled';
 export { resolveEndpointUrls } from './create-client/resolve-endpoint-urls';
 export { createIngestEvent } from './create-ingest-event/create-ingest-event';
 export type { RequestContext } from './create-ingest-event/create-ingest-event-types';
-export type { RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionRecorderMetrics, RuntimeExecutionRequest, RuntimeExecutionState, RuntimeFunctionCallsSuppressedEvent, RuntimeFunctionEnterEvent, RuntimeFunctionExitEvent, RuntimeFunctionThrowEvent, RuntimeThrowLocation, } from './create-ingest-event/runtime-execution-state-types';
+export type { RuntimeCaptureCoverage, RuntimeCapturedControlFact, RuntimeCapturedRoot, RuntimeCaptureProfile, RuntimeDerivationCapture, RuntimeDerivationMetrics, RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionRecorderMetrics, RuntimeExecutionRequest, RuntimeExecutionState, RuntimeFunctionCallsSuppressedEvent, RuntimeFunctionEnterEvent, RuntimeFunctionExitEvent, RuntimeFunctionThrowEvent, RuntimeThrowLocation, } from './create-ingest-event/runtime-execution-state-types';
+export { capturedValueCompleteness, isRedactedCapturedValue, isSerializerMarker, } from './derivation/captured-value-markers';
+export { type DerivationValidation, type EvaluateDerivationResult, type EvaluatedFunctionState, type EvaluatedRuntimeValue, evaluatedValueAtLine, evaluateRuntimeDerivation, } from './derivation/evaluate-derivation-plan';
+export { hashInstrumentationManifest } from './derivation/hash-instrumentation-manifest';
+export { isRasputinTaggedValue, RASPUTIN_WIRE_TAG, type RasputinTaggedValue, rasputinOmitted, rasputinRedacted, rasputinTagKind, rasputinTruncated, rasputinUnavailable, rasputinUnknown, } from './derivation/rasputin-wire-tag';
 export { detectRelease } from './detect-release/detect-release';
+export type { CaptureBoundary, CaptureReason, ControlFactDefinition, DerivationBinaryOp, DerivationExpression, DerivationFallbackReason, DerivationPlan, DerivationUnaryOp, DerivationVariable, PrimitiveConst, } from './instrumentation-manifest/derivation-plan-types';
 export type { InstrumentationArgIdentifier, InstrumentationManifestCallSite, InstrumentationManifestContent, InstrumentationManifestDestructure, InstrumentationManifestFunction, InstrumentationParamBinding, SourceVerification, SourceVerificationIssue, } from './instrumentation-manifest/instrumentation-manifest-types';
 export { INSTRUMENTATION_MANIFEST_SCHEMA_VERSION } from './instrumentation-manifest/instrumentation-manifest-types';
 export { uploadInstrumentationManifest } from './instrumentation-manifest/upload-instrumentation-manifest';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,YAAY,EACX,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,GACf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACtF,YAAY,EACX,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,EAC/B,uBAAuB,EACvB,qBAAqB,EACrB,mCAAmC,EACnC,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACpB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,YAAY,EACX,4BAA4B,EAC5B,+BAA+B,EAC/B,8BAA8B,EAC9B,kCAAkC,EAClC,+BAA+B,EAC/B,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,2DAA2D,CAAC;AACnE,OAAO,EAAE,uCAAuC,EAAE,MAAM,2DAA2D,CAAC;AACpH,OAAO,EAAE,6BAA6B,EAAE,MAAM,4DAA4D,CAAC;AAC3G,YAAY,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,YAAY,EACX,aAAa,EACb,uBAAuB,GACvB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACX,yBAAyB,EACzB,aAAa,EACb,cAAc,GACd,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GAChB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EACX,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EACX,sBAAsB,EACtB,SAAS,EACT,iBAAiB,EACjB,cAAc,GACd,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}