@adaptic/utils 0.0.1014 → 0.0.1016

package/dist/types/llm/types.d.ts

@@ -0,0 +1,292 @@
+/**
+ * Public types for the alias-resolving LLM client.
+ *
+ * Application code names a semantic alias and never a vendor model string, so
+ * these types deliberately give a caller no way to express "use this model".
+ * That is the whole point of the layer: a model swap has to be a change to the
+ * route table, and a type that accepted a model id would let a call site opt
+ * out of the routing policy without anyone noticing.
+ *
+ * @module llm/types
+ */
+/**
+ * The semantic aliases application code may name.
+ *
+ * A union rather than a bare string, so a call site that names an alias the
+ * route table does not define fails to compile instead of failing at runtime
+ * against whichever provider the gateway happened to have configured.
+ */
+export type LlmAlias = "llm.reason" | "llm.agentic" | "llm.fast" | "llm.extract" | "llm.judge";
+/** How urgently a caller needs an answer, which fixes the per-leg timeout budget. */
+export type LlmLatencyClass = "hot-path" | "background" | "batch";
+/** What a call is for, which fixes how conservatively a failure is handled. */
+export type LlmCriticality = "trading-adjacent" | "ops" | "internal";
+/** Position of a route in its alias's fallback chain. */
+export type LlmRouteRole = "primary" | "secondary" | "closed_incumbent";
+/** Whether a provider is an open-weight host, a retained closed vendor, or an aggregator. */
+export type LlmProviderTier = "open" | "closed" | "aggregator";
+/** Whether a provider account is usable today. */
+export type LlmAccountStatus = "live" | "pending-onboarding" | "not-in-scope";
+/** Whether a vendor model id was transcribed from a source or is still unknown. */
+export type LlmModelIdStatus = "confirmed" | "pending-provider-confirmation";
+/** Response shape a caller asks for, mirroring the incumbent client's vocabulary. */
+export type LlmResponseFormat = "text" | "json" | {
+    readonly type: "json_schema";
+    readonly schema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required?: readonly string[];
+    };
+};
+/** Capability and sampling declarations for one route. */
+export interface LlmRouteParams {
+    readonly temperature?: number | null;
+    readonly max_output_tokens?: number | null;
+    readonly reasoning_effort?: "low" | "medium" | "high" | null;
+    readonly supports_temperature?: boolean;
+    readonly supports_json_schema?: boolean;
+    readonly supports_tools?: boolean;
+    readonly supports_cache_control?: boolean;
+    readonly supports_vision?: boolean;
+    readonly context_window?: number;
+}
+/** A dated price anchor for one route, used to project spend against a budget. */
+export interface LlmPriceAnchor {
+    readonly input: number;
+    readonly output: number;
+    readonly as_of: string;
+    readonly source?: string;
+}
+/** One leg of an alias's fallback chain. */
+export interface LlmRoute {
+    readonly role: LlmRouteRole;
+    readonly provider: string;
+    readonly model_id: string | null;
+    readonly model_id_status: LlmModelIdStatus;
+    readonly model_id_source?: string | null;
+    readonly model_family: string;
+    readonly lumic_model?: string | null;
+    readonly params?: LlmRouteParams;
+    readonly price_per_mtok?: LlmPriceAnchor;
+    readonly shadow_only?: boolean;
+    readonly notes?: string;
+}
+/** A provider account the chain can reach. */
+export interface LlmProvider {
+    readonly display_name: string;
+    readonly tier: LlmProviderTier;
+    readonly api_style: "openai-compatible" | "anthropic";
+    readonly base_url: string | null;
+    readonly base_url_env: string | null;
+    readonly api_key_env: string;
+    readonly secret_path: string;
+    readonly account_status: LlmAccountStatus;
+    readonly lumic_provider?: string | null;
+    readonly published_rpm?: number | null;
+    readonly published_tpm?: number | null;
+    readonly limits_source?: string | null;
+    readonly docs_url: string;
+    readonly notes?: string;
+}
+/** Spend bound for one alias at the gateway layer. */
+export interface LlmAliasBudget {
+    readonly basis: "provisional-pre-baseline" | "measured";
+    readonly monthly_usd: number;
+    readonly alert_pct: readonly number[];
+}
+/** One alias's complete routing definition. */
+export interface LlmAliasDefinition {
+    readonly workload: string;
+    readonly latency_class: LlmLatencyClass;
+    readonly criticality: LlmCriticality;
+    readonly isolation_capable: boolean;
+    readonly pinned?: boolean;
+    readonly eval_gate: "structured-output" | "free-text-judge" | "tool-call" | "none-pinned-judge";
+    readonly policy_note?: string;
+    readonly budget: LlmAliasBudget;
+    readonly routes: readonly LlmRoute[];
+}
+/** Circuit-breaker tuning shared by every route. */
+export interface LlmBreakerDefaults {
+    readonly failure_threshold: number;
+    readonly cooldown_ms: number;
+    readonly half_open_probes: number;
+}
+/** Defaults every alias inherits. */
+export interface LlmRouteDefaults {
+    readonly request_timeout_ms: Readonly<Record<LlmLatencyClass, number>>;
+    readonly retries_per_leg: number;
+    readonly circuit_breaker: LlmBreakerDefaults;
+}
+/** A routing question the table cannot settle on its own authority. */
+export interface LlmOpenItem {
+    readonly id: string;
+    readonly question: string;
+    readonly blocks: string;
+    readonly owner: string;
+}
+/** The canonical alias route table. */
+export interface LlmRouteTable {
+    readonly schema_version: number;
+    readonly policy_source: string;
+    readonly revised?: string;
+    readonly defaults: LlmRouteDefaults;
+    readonly providers: Readonly<Record<string, LlmProvider>>;
+    readonly aliases: Readonly<Record<string, LlmAliasDefinition>>;
+    readonly open_items?: readonly LlmOpenItem[];
+}
+/** A route resolved for execution, with its provider and effective budget attached. */
+export interface ResolvedRoute {
+    readonly alias: LlmAlias;
+    readonly isolated: boolean;
+    readonly role: LlmRouteRole;
+    readonly providerName: string;
+    readonly provider: LlmProvider;
+    readonly modelId: string;
+    readonly lumicModel: string | null;
+    readonly params: LlmRouteParams;
+    /** Stable identity of this leg, used to key its circuit breaker and its metrics. */
+    readonly routeKey: string;
+    readonly timeoutMs: number;
+    readonly retriesPerLeg: number;
+}
+/** Token accounting for one attempt, mirroring the incumbent client's shape. */
+export interface LlmUsageRecord {
+    readonly prompt_tokens: number;
+    readonly completion_tokens: number;
+    readonly reasoning_tokens?: number;
+    readonly cached_tokens?: number;
+    readonly provider: string;
+    readonly model: string;
+    readonly cost: number;
+}
+/** A tool call the model asked for. */
+export interface LlmToolCall {
+    readonly id: string;
+    readonly type: "function";
+    readonly function: {
+        readonly name: string;
+        readonly arguments: string;
+    };
+}
+/** The envelope a transport returns. */
+export interface LlmTransportResponse<T> {
+    readonly response: T;
+    readonly usage: LlmUsageRecord;
+    readonly tool_calls?: readonly LlmToolCall[];
+}
+/** What the caller receives, with the routing decision attached for attribution. */
+export interface AliasCallResult<T> extends LlmTransportResponse<T> {
+    /** The leg that produced the answer. */
+    readonly servedBy: ResolvedRoute;
+    /** Legs tried and rejected before this one, in order, with the reason each failed. */
+    readonly attempts: readonly AliasAttemptRecord[];
+    /** Whether the answer came from the degraded direct transport rather than the gateway. */
+    readonly degraded: boolean;
+    /** Usage summed across every attempt, so budget accounting counts what was actually spent. */
+    readonly totalUsage: LlmUsageRecord;
+}
+/** One attempt against one leg. */
+export interface AliasAttemptRecord {
+    readonly routeKey: string;
+    readonly role: LlmRouteRole;
+    readonly provider: string;
+    readonly modelId: string;
+    readonly outcome: "ok" | "error" | "timeout" | "breaker-open" | "skipped";
+    readonly durationMs: number;
+    readonly reason?: string;
+    readonly usage?: LlmUsageRecord;
+}
+/**
+ * Outcome of validating a structured payload.
+ *
+ * A discriminated union rather than a boolean plus an out-parameter, so a
+ * validator cannot report success while leaving the value unnarrowed — the type
+ * system carries the rescued payload only on the branch that earned it.
+ */
+export type LlmValidationOutcome<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * Options a caller passes alongside the prompt.
+ *
+ * Generic in the validated payload so a caller's validator and the call's
+ * result type are the same `T` by construction. Without the parameter the
+ * client would need a cast to connect them, and a cast at that seam is exactly
+ * where a validator could silently be applied to the wrong shape.
+ */
+export interface AliasCallOptions<T = unknown> {
+    /** The semantic alias to serve this call. Required; there is no model option by design. */
+    readonly alias: LlmAlias;
+    /**
+     * Route through the alias's research-isolated variant (PD-9).
+     *
+     * Isolation is requested explicitly rather than inferred, because a boundary
+     * that depends on a caller being correctly classified elsewhere is a boundary
+     * that breaks quietly when the classification drifts.
+     */
+    readonly isolated?: boolean;
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number;
+    readonly reasoningEffort?: "low" | "medium" | "high";
+    readonly tools?: readonly unknown[];
+    readonly developerPrompt?: string;
+    readonly context?: readonly unknown[];
+    readonly metadata?: Readonly<Record<string, string>>;
+    /** Overrides the latency class's per-leg budget. Never widens the caller's own deadline. */
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+    /**
+     * Validator for a structured payload. Supplying it enables the single
+     * feedback retry before the chain advances.
+     */
+    readonly validate?: (raw: unknown) => LlmValidationOutcome<T>;
+    /** Correlation id carried into transport metadata for cross-system tracing. */
+    readonly correlationId?: string;
+}
+/** A transport that can execute one resolved route. */
+export interface LlmTransport {
+    readonly name: string;
+    /**
+     * Execute one leg.
+     *
+     * @param request Everything the leg needs, already normalised for its provider.
+     * @returns The provider's answer.
+     */
+    execute<T>(request: LlmTransportRequest): Promise<LlmTransportResponse<T>>;
+}
+/** A single normalised leg execution. */
+export interface LlmTransportRequest {
+    readonly route: ResolvedRoute;
+    readonly content: string | readonly unknown[];
+    readonly responseFormat: LlmResponseFormat;
+    /** Provider-normalised parameters. A transport sends these verbatim. */
+    readonly params: Readonly<Record<string, unknown>>;
+    readonly signal: AbortSignal;
+    readonly correlationId?: string;
+}
+/** Runtime wiring for the client. */
+export interface LlmClientConfig {
+    /** Base URL of the gateway. Absent means the gateway leg is unavailable. */
+    readonly gatewayBaseUrl?: string;
+    /** Env-var NAME holding the gateway key. Never the key itself. */
+    readonly gatewayApiKeyEnv?: string;
+    /** Transport used while the gateway is reachable. */
+    readonly gatewayTransport?: LlmTransport;
+    /**
+     * Transport used when the gateway itself is unreachable.
+     *
+     * Kept injectable so the client has no load-time dependency on a provider
+     * SDK. A gateway that is a single point of failure would trade one outage
+     * mode for a worse one, so this path exists; restricting it to closed-tier
+     * legs is what keeps it a safety net rather than a second routing policy.
+     */
+    readonly directTransport?: LlmTransport;
+    /** Clock, injected so timeout and breaker behaviour is testable without waiting. */
+    readonly now?: () => number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/llm/types.d.ts.map

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

package/dist/types/schemas/alpaca-schemas.d.ts

@@ -578,11 +578,11 @@ export declare const AlpacaNewsArticleSchema: z.ZodObject<{
     id: number;
     source: string;
     symbols: string[];
+    content: string;
     created_at: string;
     updated_at: string;
     url: string;
     author: string;
-    content: string;
     headline: string;
     summary: string;
     images: {
@@ -593,11 +593,11 @@ export declare const AlpacaNewsArticleSchema: z.ZodObject<{
     id: number;
     source: string;
     symbols: string[];
+    content: string;
     created_at: string;
     updated_at: string;
     url: string;
     author: string;
-    content: string;
     headline: string;
     summary: string;
     images: {
@@ -632,11 +632,11 @@ export declare const AlpacaNewsResponseSchema: z.ZodObject<{
         id: number;
         source: string;
         symbols: string[];
+        content: string;
         created_at: string;
         updated_at: string;
         url: string;
         author: string;
-        content: string;
         headline: string;
         summary: string;
         images: {
@@ -647,11 +647,11 @@ export declare const AlpacaNewsResponseSchema: z.ZodObject<{
         id: number;
         source: string;
         symbols: string[];
+        content: string;
         created_at: string;
         updated_at: string;
         url: string;
         author: string;
-        content: string;
         headline: string;
         summary: string;
         images: {
@@ -665,11 +665,11 @@ export declare const AlpacaNewsResponseSchema: z.ZodObject<{
         id: number;
         source: string;
         symbols: string[];
+        content: string;
         created_at: string;
         updated_at: string;
         url: string;
         author: string;
-        content: string;
         headline: string;
         summary: string;
         images: {
@@ -683,11 +683,11 @@ export declare const AlpacaNewsResponseSchema: z.ZodObject<{
         id: number;
         source: string;
         symbols: string[];
+        content: string;
         created_at: string;
         updated_at: string;
         url: string;
         author: string;
-        content: string;
         headline: string;
         summary: string;
         images: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptic/utils",
-  "version": "0.0.1014",
+  "version": "0.0.1016",
   "author": "Adaptic.ai",
   "description": "Utility functions used in Adaptic app and Lambda functions",
   "always-build-npm": true,
@@ -38,7 +38,7 @@
     "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s"
   },
   "dependencies": {
-    "@adaptic/backend-legacy": "0.0.977",
+    "@adaptic/backend-legacy": "0.0.1017",
     "@alpacahq/alpaca-trade-api": "^3.1.3",
     "@apollo/client": "^3.13.8",
     "chalk": "^5.4.1",

package/dist/types/__tests__/alpaca-broker-error-preservation.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=alpaca-broker-error-preservation.test.d.ts.map

package/dist/types/__tests__/alpaca-broker-error-preservation.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alpaca-broker-error-preservation.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/alpaca-broker-error-preservation.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/alpaca-client-order-id.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=alpaca-client-order-id.test.d.ts.map

package/dist/types/__tests__/alpaca-client-order-id.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alpaca-client-order-id.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/alpaca-client-order-id.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/alpaca-functions.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=alpaca-functions.test.d.ts.map

package/dist/types/__tests__/alpaca-functions.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alpaca-functions.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/alpaca-functions.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/alpaca-market-data-retry.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=alpaca-market-data-retry.test.d.ts.map

package/dist/types/__tests__/alpaca-market-data-retry.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alpaca-market-data-retry.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/alpaca-market-data-retry.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/alpaca-order-idempotency.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=alpaca-order-idempotency.test.d.ts.map

package/dist/types/__tests__/alpaca-order-idempotency.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alpaca-order-idempotency.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/alpaca-order-idempotency.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/alpaca-trading-api.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=alpaca-trading-api.test.d.ts.map

package/dist/types/__tests__/alpaca-trading-api.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alpaca-trading-api.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/alpaca-trading-api.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/api-endpoints.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=api-endpoints.test.d.ts.map

package/dist/types/__tests__/api-endpoints.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-endpoints.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/api-endpoints.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/asset-allocation.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=asset-allocation.test.d.ts.map

package/dist/types/__tests__/asset-allocation.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset-allocation.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/asset-allocation.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/atr.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=atr.test.d.ts.map

package/dist/types/__tests__/atr.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"atr.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/atr.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/auth-validator.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=auth-validator.test.d.ts.map

package/dist/types/__tests__/auth-validator.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth-validator.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/auth-validator.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/broker-factory.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=broker-factory.test.d.ts.map

package/dist/types/__tests__/broker-factory.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"broker-factory.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/broker-factory.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/broker-types.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=broker-types.test.d.ts.map

package/dist/types/__tests__/broker-types.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"broker-types.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/broker-types.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/cache.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cache.test.d.ts.map

package/dist/types/__tests__/cache.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/cache.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/errors.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=errors.test.d.ts.map

package/dist/types/__tests__/errors.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/errors.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/financial-regression.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=financial-regression.test.d.ts.map

package/dist/types/__tests__/financial-regression.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"financial-regression.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/financial-regression.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/format-tools.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=format-tools.test.d.ts.map

package/dist/types/__tests__/format-tools.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"format-tools.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/format-tools.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/http-keep-alive.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=http-keep-alive.test.d.ts.map

package/dist/types/__tests__/http-keep-alive.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-keep-alive.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/http-keep-alive.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/http-timeout.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=http-timeout.test.d.ts.map

package/dist/types/__tests__/http-timeout.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-timeout.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/http-timeout.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/dist/types/__tests__/index.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/legacy-auth.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=legacy-auth.test.d.ts.map

package/dist/types/__tests__/legacy-auth.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"legacy-auth.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/legacy-auth.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/logger.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=logger.test.d.ts.map

package/dist/types/__tests__/logger.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/logger.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/logging.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=logging.test.d.ts.map

package/dist/types/__tests__/logging.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logging.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/logging.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/market-time.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=market-time.test.d.ts.map

package/dist/types/__tests__/market-time.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"market-time.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/market-time.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/massive.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=massive.test.d.ts.map

package/dist/types/__tests__/massive.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"massive.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/massive.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/metrics-calcs-direction.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=metrics-calcs-direction.test.d.ts.map

package/dist/types/__tests__/metrics-calcs-direction.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics-calcs-direction.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/metrics-calcs-direction.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/misc-utils.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=misc-utils.test.d.ts.map

package/dist/types/__tests__/misc-utils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"misc-utils.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/misc-utils.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/paginator.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=paginator.test.d.ts.map

package/dist/types/__tests__/paginator.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paginator.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/paginator.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/performance-metrics-fees.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=performance-metrics-fees.test.d.ts.map

package/dist/types/__tests__/performance-metrics-fees.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"performance-metrics-fees.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/performance-metrics-fees.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/performance-metrics.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=performance-metrics.test.d.ts.map

package/dist/types/__tests__/performance-metrics.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"performance-metrics.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/performance-metrics.test.ts"],"names":[],"mappings":""}