@rasputin-ai/core 0.5.0-alpha.6 → 0.5.0-alpha.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,9 +1,8 @@
1
- import type { RuntimeFunctionDefinition, SourcePosition } from '../source-identity/source-identity';
2
1
  /**
3
- * Wire-facing runtime-state types kept inside the standalone SDK package. They mirror the server
4
- * contract without importing the application's private `~db` graph, allowing the published SDK to
5
- * remain independently buildable and usable by external projects.
2
+ * Keep in sync with `packages/~db/schemas/occurrence-runtime-state-schema.ts`.
3
+ * ⚠️ DERIVATION LOCKSTEP — the published SDK cannot import Rasputin's private packages.
6
4
  */
5
+ import type { RuntimeFunctionDefinition, SourcePosition } from '../source-identity/source-identity';
7
6
  export type RuntimeExecutionKind = 'http' | 'serverless' | 'job' | 'scheduled' | 'custom';
8
7
  export type RuntimeExecutionRequest = {
9
8
  method?: string | null;
@@ -62,22 +61,52 @@ export type RuntimeFunctionCallsSuppressedEvent = {
62
61
  totalDurationMs: number;
63
62
  };
64
63
  export type RuntimeExecutionEvent = RuntimeFunctionEnterEvent | RuntimeFunctionExitEvent | RuntimeFunctionThrowEvent | RuntimeFunctionCallsSuppressedEvent;
64
+ export type RuntimeCapturedRoot = {
65
+ rootId: number;
66
+ callId: number;
67
+ value: unknown;
68
+ completeness: 'exact' | 'partial';
69
+ };
70
+ export type RuntimeCapturedControlFact = {
71
+ factId: number;
72
+ callId: number;
73
+ value: boolean;
74
+ };
75
+ export type RuntimeDerivationCapture = {
76
+ manifestHash: string;
77
+ roots: RuntimeCapturedRoot[];
78
+ controlFacts: RuntimeCapturedControlFact[];
79
+ };
80
+ export type RuntimeDerivationMetrics = {
81
+ derivationCandidateFunctions: number;
82
+ derivationElidedFunctionCalls: number;
83
+ derivationRootsCaptured: number;
84
+ derivationControlFactsCaptured: number;
85
+ derivationValuesAvoided: number;
86
+ derivationFallbackFunctions: number;
87
+ derivationFallbackExpressions: number;
88
+ derivationFallbackReasons: Record<string, number>;
89
+ derivationRootBytes: number;
90
+ };
65
91
  export type RuntimeExecutionRecorderMetrics = {
66
92
  /** Cumulative synchronous wall time spent in recorder-owned work for this execution. */
67
93
  inlineWallTimeMs: number;
94
+ derivation?: RuntimeDerivationMetrics;
68
95
  };
96
+ export type RuntimeCaptureMode = 'derivation' | 'automatic-full' | 'manual' | 'scope-only';
69
97
  /** Bounded, redacted execution state captured at the moment an error is reported. */
70
98
  export type RuntimeExecutionState = {
71
- version: 2;
99
+ version: 3;
100
+ captureMode: RuntimeCaptureMode;
72
101
  executionId: string;
73
102
  startedAt: string;
74
103
  durationMs: number;
75
- /** Optional for compatibility with runtime states produced by older SDK versions. */
76
104
  recorder?: RuntimeExecutionRecorderMetrics;
77
105
  execution: RuntimeExecutionMetadata;
78
106
  /** Function metadata is stored once per execution; events keep only compact opaque IDs. */
79
107
  functions: RuntimeFunctionDefinition[];
80
108
  events: RuntimeExecutionEvent[];
109
+ derivation?: RuntimeDerivationCapture;
81
110
  truncated?: {
82
111
  eventsDropped: number;
83
112
  };
@@ -1 +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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"}
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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"}
@@ -0,0 +1,3 @@
1
+ /** Deterministic JSON so manifest hashes do not depend on object insertion order. */
2
+ export declare const canonicalJson: (value: unknown) => string;
3
+ //# sourceMappingURL=canonical-json.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,5 @@
1
+ /** Serializer markers and tagged holes that make a captured snapshot incomplete. */
2
+ export declare const capturedValueCompleteness: (value: unknown) => "exact" | "partial";
3
+ export declare const isRedactedCapturedValue: (value: unknown) => boolean;
4
+ export declare const isSerializerMarker: (value: unknown) => boolean;
5
+ //# sourceMappingURL=captured-value-markers.d.ts.map
@@ -0,0 +1 @@
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,SA2BpE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,OAKxD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,OAInD,CAAC"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Keep in sync with `packages/~core/lib/runtime-derivation/evaluate-derivation-plan.ts`.
3
+ * ⚠️ DERIVATION LOCKSTEP — investigation must interpret the same IR the SDK emitted.
4
+ */
5
+ import type { RuntimeExecutionState } from '../create-ingest-event/runtime-execution-state-types';
6
+ import type { InstrumentationManifestContent } from '../instrumentation-manifest/instrumentation-manifest-types';
7
+ export type EvaluatedRuntimeValue = {
8
+ origin: 'captured';
9
+ completeness: 'exact' | 'partial';
10
+ value: unknown;
11
+ } | {
12
+ origin: 'derived';
13
+ completeness: 'exact' | 'partial';
14
+ value: unknown;
15
+ dependencies: number[];
16
+ } | {
17
+ origin: 'unavailable';
18
+ reason: string;
19
+ };
20
+ export type EvaluatedFunctionState = {
21
+ functionId: string;
22
+ callId: number;
23
+ values: Record<number, EvaluatedRuntimeValue>;
24
+ variables: Array<{
25
+ variableId: number;
26
+ name: string;
27
+ availableAtLine: number;
28
+ availableAtColumn: number;
29
+ result: EvaluatedRuntimeValue;
30
+ }>;
31
+ returnValue?: EvaluatedRuntimeValue;
32
+ };
33
+ export type EvaluateDerivationResult = {
34
+ unavailableReason?: string;
35
+ functions: EvaluatedFunctionState[];
36
+ };
37
+ export declare const evaluateRuntimeDerivation: (input: {
38
+ state: RuntimeExecutionState;
39
+ manifest: InstrumentationManifestContent | null;
40
+ }) => EvaluateDerivationResult;
41
+ export declare const evaluatedValueAtLine: (evaluated: EvaluatedFunctionState | undefined, line: number | null) => Array<{
42
+ name: string;
43
+ result: EvaluatedRuntimeValue;
44
+ }>;
45
+ //# sourceMappingURL=evaluate-derivation-plan.d.ts.map
@@ -0,0 +1 @@
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;AAWjH,MAAM,MAAM,qBAAqB,GAC9B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACzE;IACA,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACtB,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;AAivBF,eAAO,MAAM,yBAAyB,GAAI,OAAO;IAChD,KAAK,EAAE,qBAAqB,CAAC;IAC7B,QAAQ,EAAE,8BAA8B,GAAG,IAAI,CAAC;CAChD,KAAG,wBAkDH,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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Keep in sync with `packages/~core/lib/runtime-derivation/hash-instrumentation-manifest.ts`.
3
+ * ⚠️ DERIVATION LOCKSTEP — capture-time and investigation-time hashes must match.
4
+ */
5
+ import type { InstrumentationManifestContent } from '../instrumentation-manifest/instrumentation-manifest-types';
6
+ export declare const hashInstrumentationManifest: (manifest: InstrumentationManifestContent) => string;
7
+ //# sourceMappingURL=hash-instrumentation-manifest.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Unknown and truncated derivation data must not look like ordinary application objects.
3
+ * A tagged tuple whose first element is a NUL-prefixed brand cannot collide with JSON
4
+ * that customer code would reasonably produce.
5
+ * Keep in sync with `packages/~core/lib/runtime-derivation/rasputin-wire-tag.ts`.
6
+ * ⚠️ DERIVATION LOCKSTEP — tagged holes must decode the same way on the server.
7
+ */
8
+ export declare const RASPUTIN_WIRE_TAG: "\0rasputin";
9
+ export type RasputinTaggedUnknown = readonly [typeof RASPUTIN_WIRE_TAG, 'unknown'];
10
+ export type RasputinTaggedUnavailable = readonly [typeof RASPUTIN_WIRE_TAG, 'unavailable', string];
11
+ export type RasputinTaggedOmitted = readonly [typeof RASPUTIN_WIRE_TAG, 'omitted'];
12
+ export type RasputinTaggedRedacted = readonly [typeof RASPUTIN_WIRE_TAG, 'redacted'];
13
+ export type RasputinTaggedTruncated = readonly [
14
+ typeof RASPUTIN_WIRE_TAG,
15
+ 'truncated',
16
+ {
17
+ reason: string;
18
+ originalLength?: number;
19
+ capturedCount?: number;
20
+ omittedCount?: number;
21
+ value?: unknown;
22
+ }
23
+ ];
24
+ export type RasputinTaggedValue = RasputinTaggedUnknown | RasputinTaggedUnavailable | RasputinTaggedOmitted | RasputinTaggedRedacted | RasputinTaggedTruncated;
25
+ export declare const rasputinUnknown: () => RasputinTaggedUnknown;
26
+ export declare const rasputinUnavailable: (reason: string) => RasputinTaggedUnavailable;
27
+ export declare const rasputinOmitted: () => RasputinTaggedOmitted;
28
+ export declare const rasputinRedacted: () => RasputinTaggedRedacted;
29
+ export declare const rasputinTruncated: (payload: RasputinTaggedTruncated[2]) => RasputinTaggedTruncated;
30
+ export declare const isRasputinTaggedValue: (value: unknown) => value is RasputinTaggedValue;
31
+ export declare const rasputinTagKind: (value: unknown) => RasputinTaggedValue[1] | undefined;
32
+ //# sourceMappingURL=rasputin-wire-tag.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,3 @@
1
+ /** Portable SHA-256 so capture-time and investigation-time hashes match without Node crypto. */
2
+ export declare const sha256Hex: (input: string) => string;
3
+ //# sourceMappingURL=sha256.d.ts.map
@@ -0,0 +1 @@
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/index.d.ts CHANGED
@@ -5,8 +5,13 @@ export { isClientEnabled } from './create-client/is-client-enabled';
5
5
  export { resolveEndpointUrls } from './create-client/resolve-endpoint-urls';
6
6
  export { createIngestEvent } from './create-ingest-event/create-ingest-event';
7
7
  export type { RequestContext } from './create-ingest-event/create-ingest-event-types';
8
- export type { RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionRecorderMetrics, RuntimeExecutionRequest, RuntimeExecutionState, RuntimeFunctionCallsSuppressedEvent, RuntimeFunctionEnterEvent, RuntimeFunctionExitEvent, RuntimeFunctionThrowEvent, RuntimeThrowLocation, } from './create-ingest-event/runtime-execution-state-types';
8
+ export type { RuntimeCapturedControlFact, RuntimeCapturedRoot, RuntimeCaptureMode, RuntimeDerivationCapture, RuntimeDerivationMetrics, RuntimeExecutionEvent, RuntimeExecutionKind, RuntimeExecutionMetadata, RuntimeExecutionRecorderMetrics, RuntimeExecutionRequest, RuntimeExecutionState, RuntimeFunctionCallsSuppressedEvent, RuntimeFunctionEnterEvent, RuntimeFunctionExitEvent, RuntimeFunctionThrowEvent, RuntimeThrowLocation, } from './create-ingest-event/runtime-execution-state-types';
9
+ export { capturedValueCompleteness, isRedactedCapturedValue, isSerializerMarker, } from './derivation/captured-value-markers';
10
+ export { type EvaluateDerivationResult, type EvaluatedFunctionState, type EvaluatedRuntimeValue, evaluatedValueAtLine, evaluateRuntimeDerivation, } from './derivation/evaluate-derivation-plan';
11
+ export { hashInstrumentationManifest } from './derivation/hash-instrumentation-manifest';
12
+ export { isRasputinTaggedValue, RASPUTIN_WIRE_TAG, type RasputinTaggedValue, rasputinOmitted, rasputinRedacted, rasputinTagKind, rasputinTruncated, rasputinUnavailable, rasputinUnknown, } from './derivation/rasputin-wire-tag';
9
13
  export { detectRelease } from './detect-release/detect-release';
14
+ export type { CaptureBoundary, CaptureReason, ControlFactDefinition, DerivationBinaryOp, DerivationExpression, DerivationFallbackReason, DerivationPlan, DerivationUnaryOp, DerivationVariable, PrimitiveConst, } from './instrumentation-manifest/derivation-plan-types';
10
15
  export type { InstrumentationArgIdentifier, InstrumentationManifestCallSite, InstrumentationManifestContent, InstrumentationManifestDestructure, InstrumentationManifestFunction, InstrumentationParamBinding, SourceVerification, SourceVerificationIssue, } from './instrumentation-manifest/instrumentation-manifest-types';
11
16
  export { INSTRUMENTATION_MANIFEST_SCHEMA_VERSION } from './instrumentation-manifest/instrumentation-manifest-types';
12
17
  export { uploadInstrumentationManifest } from './instrumentation-manifest/upload-instrumentation-manifest';
@@ -1 +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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}