meridianjs 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,152 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.2] - 2025-01-XX
+
+### Changed
+- **Public API lockdown**: Package now exports from `src/public.ts` as the single public entry point. This restricts consumer access to only documented, stable APIs.
+- **Error contract enhancement**: `MeridianError` now exposes a `code` getter as an alias for `category`. This provides forward compatibility with documented error contracts while maintaining backward compatibility.
+
+### Internal
+- Fixed incomplete code from prior refactoring in error message formatting
+- Corrected timeout error construction to use proper `MeridianError` class instantiation
+- Improved code consistency across error handling paths
+
+## [2.0.1] - 2025-01-14
+
+### Fixed
+- Fix incorrect internal package version. SDK_VERSION now correctly reads from package.json as single source of truth, eliminating version mismatches.
+
+## [2.0.0] - 2025-01-09
+
+**This release establishes the long-term safety contract of the SDK.** All breaking changes are intentional and enforce safety by default.
+
+**⚠️ BREAKING: This is a major version release with breaking changes. See migration guide below.**
+
+### Breaking Changes
+
+- **Constructor removed**: `new Meridian(config)` no longer works. Use `await Meridian.create(config)` instead. This enforces async initialization and prevents use before initialization.
+
+- **Mandatory initialization**: All SDK methods throw if called before `Meridian.create()` completes. This prevents undefined behavior from uninitialized state.
+
+- **StateStorage enforcement**: 
+  - `mode: "distributed"` **requires** a `StateStorage` implementation. Startup fails without it.
+  - Configurations without `stateStorage` require explicit `localUnsafe: true` to acknowledge the limitation.
+  - This prevents accidental use of in-memory state in production deployments.
+
+- **Node.js version requirement**: SDK now explicitly requires Node.js ≥18.0.0 (was implicit before). This is enforced via `engines` field in `package.json`.
+
+- **Typed request options**: `ProviderClient` methods now use strict `RequestOptions` types instead of `any`. Invalid options are caught at compile time.
+
+### Added
+
+- **Safety guarantees**:
+  - Fail-fast initialization enforcement
+  - Fail-closed state management
+  - Guaranteed secret redaction in all observability paths
+  - No silent degradation - all failures are explicit
+
+- **Pagination safety**: Cycle detection and max page limit (1000 pages) prevent infinite loops from malformed adapters.
+
+- **Adapter validation safety**: Validation uses fake test tokens to prevent side effects during adapter checks.
+
+- **Instance-scoped adapter cache**: Prevents config sharing across Meridian instances.
+
+### Changed
+
+- All examples and documentation updated to use `Meridian.create()` pattern.
+- Enhanced header sanitization to handle variations (e.g., "X-API-Key" matches "apikey").
+- Improved error messages for state management failures.
+
+### Fixed
+
+- Secrets no longer leak through observability (logs, errors, metrics).
+- Adapter cache properly scoped per instance.
+- Pagination cannot infinite-loop.
+
+### Migration from 1.x
+
+**Required changes:**
+
+1. **Replace constructor with factory method:**
+   ```typescript
+   // ❌ OLD (1.x)
+   const meridian = new Meridian({ ... });
+   
+   // ✅ NEW (2.0.0)
+   const meridian = await Meridian.create({ ... });
+   ```
+
+2. **Add state management configuration:**
+   ```typescript
+   // For local development
+   const meridian = await Meridian.create({
+     ...config,
+     localUnsafe: true, // Required for local dev
+   });
+   
+   // For production/distributed
+   const meridian = await Meridian.create({
+     ...config,
+     mode: "distributed",
+     stateStorage: new YourStateStorage(), // Required
+   });
+   ```
+
+3. **Ensure Node.js ≥18.0.0** (now enforced via `engines` field)
+
+4. **Update TypeScript types:** `ProviderClient` methods now use strict `RequestOptions` instead of `any`
+
+## [Unreleased]
+
+### Added
+- Auto-registration of built-in provider adapters
+- Configuration validation for rate limit, retry, circuit breaker, and timeout settings
+- Fallback error handling when adapter `parseError()` throws unexpectedly
+
+### Fixed
+- Removed circular self-dependency in package.json that caused installation failures
+- Fetch timeout now properly cancels requests using `AbortController` (prevents resource leaks)
+- GitHub 403 errors now correctly distinguished between rate limit and permission denied
+- Adapter validation now runs in production (logs warning instead of throwing)
+
+### Changed
+- Improved type safety: `authToken` parameter now uses `AuthToken` type instead of `any`
+
+## [1.0.2] - 2024-01-XX
+
+### Fixed
+- Constructor now supports both nested and flat provider config structures
+- GitHub adapter auto-registers when provider is configured
+
+## [1.0.1] - 2024-01-XX
+
+### Fixed
+- TypeScript strict mode compatibility issues
+- Optional property handling in exactOptionalPropertyTypes mode
+
+## [1.0.0] - 2024-01-XX
+
+### Added
+- Core request pipeline with unified response normalization
+- Circuit breaker implementation with state machine
+- Rate limiting with token bucket and adaptive backoff
+- Retry strategy with exponential backoff and idempotency awareness
+- Idempotency resolver with SAFE/IDEMPOTENT/CONDITIONAL/UNSAFE levels
+- Schema validation with pluggable storage and drift detection
+- Observability adapter pattern with console and no-op implementations
+- GitHub provider adapter with OAuth support
+- Pagination normalization for cursor and offset-based strategies
+- Error normalization with unified error contract
+- TypeScript strict mode with full type safety
+
+[Unreleased]: https://github.com/Raghaverma/Meridian/compare/v1.0.2...HEAD
+[1.0.2]: https://github.com/Raghaverma/Meridian/compare/v1.0.1...v1.0.2
+[1.0.1]: https://github.com/Raghaverma/Meridian/compare/v1.0.0...v1.0.1
+[1.0.0]: https://github.com/Raghaverma/Meridian/releases/tag/v1.0.0
+
+

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Meridian SDK Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,126 @@
+# Meridian
+
+> **⚠️ v2.0.0 establishes the safe-by-default contract. Previous versions (<2.0.0) are deprecated and contain unsafe defaults. Upgrade to >=2.0.0.**
+
+A TypeScript SDK that normalizes third-party API interactions through a unified request pipeline, enforcing consistent error handling, rate limiting, and response shapes across providers.
+
+## Problem Statement
+
+Applications integrating multiple third-party APIs face inconsistent response formats, error structures, rate limit behaviors, and pagination strategies. This fragmentation requires provider-specific error handling, retry logic, and data transformation code that is difficult to maintain and test.
+
+Meridian provides a single abstraction layer that normalizes these differences, allowing applications to interact with any provider through a consistent interface while maintaining type safety and resilience patterns.
+
+## Non-Goals
+
+- UI components or dashboards
+- API mocking or stubbing frameworks
+- Request recording or replay functionality
+- GraphQL support (v1)
+- Webhook handling (v1)
+- Multi-region routing
+- Built-in caching (applications can layer caching on top)
+
+## Installation
+
+```bash
+npm install meridian-sdk
+```
+
+## Requirements
+
+- **Node.js ≥18.0.0** (required for `fetch`, `Headers`, `AbortController`, `crypto.randomUUID`)
+
+## Usage
+
+**IMPORTANT**: Meridian requires async initialization. Always use `Meridian.create()`:
+
+```typescript
+import { Meridian } from "meridian-sdk";
+
+// ✅ CORRECT: Async initialization
+const meridian = await Meridian.create({
+  github: {
+    auth: { token: process.env.GITHUB_TOKEN },
+  },
+  localUnsafe: true, // Required for local development without StateStorage
+});
+
+const { data, meta } = await meridian.github.get("/users/octocat");
+console.log(meta.rateLimit.remaining);
+```
+
+**❌ NEVER use `new Meridian()`** - the constructor is private and will fail.
+
+### Production Deployment
+
+For distributed deployments (serverless, multiple instances), you **must** provide a `StateStorage` implementation:
+
+```typescript
+import { Meridian } from "meridian-sdk";
+import { RedisStateStorage } from "./your-redis-storage.js";
+
+const meridian = await Meridian.create({
+  mode: "distributed",
+  stateStorage: new RedisStateStorage(redisClient), // Required in distributed mode
+  github: {
+    auth: { token: process.env.GITHUB_TOKEN },
+  },
+});
+```
+
+**Without `stateStorage` in distributed mode, startup will fail.** This is intentional - in-memory state cannot be shared across instances.
+
+### Local Development
+
+For local development, explicitly opt-in to unsafe in-memory state:
+
+```typescript
+const meridian = await Meridian.create({
+  mode: "local", // or omit mode
+  localUnsafe: true, // Explicitly acknowledge unsafe state
+  github: {
+    auth: { token: process.env.GITHUB_TOKEN },
+  },
+});
+```
+
+**Warning**: `localUnsafe: true` means circuit breaker and rate limiter state will be lost on process restart. This is acceptable for development but **must not be used in production**.
+
+## Safety Guarantees
+
+Meridian enforces safety by default:
+
+1. **Fail-Fast Initialization**: SDK cannot be used before initialization completes. All methods throw if called before `Meridian.create()` resolves.
+
+2. **Fail-Closed State Management**: Distributed mode requires `StateStorage`. In-memory state is opt-in only via `localUnsafe: true`.
+
+3. **Guaranteed Secret Redaction**: All observability paths (logs, errors, metrics) automatically redact sensitive fields: `authorization`, `cookie`, `token`, `apiKey`, `api_key`, `body`.
+
+4. **No Silent Degradation**: Runtime failures are explicit. Invalid configurations fail at startup. Adapter validation failures stop initialization.
+
+## Public API
+
+### Meridian Class
+
+- `static create(config: MeridianConfig, adapters?: Map<string, ProviderAdapter>): Promise<Meridian>` - **Use this to create instances**
+- `getCircuitStatus(provider: string): CircuitBreakerStatus | null`
+- `registerProvider(name: string, adapter: ProviderAdapter, config: ProviderConfig): Promise<void>`
+
+### Provider Client
+
+Each configured provider exposes a client with:
+
+- `get<T>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>`
+- `post<T>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>`
+- `put<T>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>`
+- `patch<T>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>`
+- `delete<T>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>`
+- `paginate<T>(endpoint: string, options?: RequestOptions): AsyncGenerator<NormalizedResponse<T>>`
+
+## Project Status
+
+**v2.0.0** - Production-ready safety contract established. Core functionality is stable. Provider coverage is expanding. API stability guaranteed for 2.x releases.
+
+## License
+
+MIT. See [LICENSE.md](LICENSE.md) for details.

package/dist/core/adapter-validator.d.ts

@@ -0,0 +1,10 @@
+import { type ProviderAdapter } from "./types.js";
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare function validateAdapter(adapter: ProviderAdapter, providerName: string): Promise<ValidationResult>;
+export declare function assertValidAdapter(adapter: ProviderAdapter, providerName: string): Promise<void>;
+export declare function isProviderAdapter(obj: unknown): obj is ProviderAdapter;
+//# sourceMappingURL=adapter-validator.d.ts.map

package/dist/core/adapter-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-validator.d.ts","sourceRoot":"","sources":["../../src/core/adapter-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EAKrB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAGD,wBAAsB,eAAe,CACnC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA+R3B;AAGD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAaf;AAGD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAkBtE"}

package/dist/core/adapter-validator.js

@@ -0,0 +1,270 @@
+import { MeridianError, } from "./types.js";
+export async function validateAdapter(adapter, providerName) {
+    const errors = [];
+    const warnings = [];
+    const requiredMethods = [
+        "buildRequest",
+        "parseResponse",
+        "parseError",
+        "authStrategy",
+        "rateLimitPolicy",
+        "paginationStrategy",
+        "getIdempotencyConfig",
+    ];
+    for (const method of requiredMethods) {
+        if (typeof adapter[method] !== "function") {
+            errors.push(`Adapter missing required method: ${String(method)}`);
+        }
+    }
+    if (typeof adapter.buildRequest === "function") {
+        try {
+            const input = {
+                endpoint: "/test",
+                options: { method: "GET" },
+                authToken: { token: "test" },
+            };
+            const built = adapter.buildRequest(input);
+            if (!built || typeof built !== "object") {
+                errors.push("buildRequest must return BuiltRequest object");
+            }
+            else {
+                if (typeof built.url !== "string") {
+                    errors.push("buildRequest must return url as string");
+                }
+                if (typeof built.method !== "string") {
+                    errors.push("buildRequest must return method as string");
+                }
+                if (!built.headers || typeof built.headers !== "object") {
+                    errors.push("buildRequest must return headers as object");
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`buildRequest threw error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (typeof adapter.parseResponse === "function") {
+        try {
+            const raw = {
+                status: 200,
+                headers: new Headers({
+                    "X-RateLimit-Limit": "5000",
+                    "X-RateLimit-Remaining": "4999",
+                    "X-RateLimit-Reset": String(Math.floor(Date.now() / 1000) + 3600),
+                }),
+                body: { test: "data" },
+            };
+            const normalized = adapter.parseResponse(raw);
+            if (!normalized || typeof normalized !== "object") {
+                errors.push("parseResponse must return NormalizedResponse object");
+            }
+            else {
+                if (!("data" in normalized)) {
+                    errors.push("parseResponse must return object with 'data' property");
+                }
+                if (!("meta" in normalized)) {
+                    errors.push("parseResponse must return object with 'meta' property");
+                }
+                else {
+                    const meta = normalized.meta;
+                    if (meta.provider !== providerName) {
+                        errors.push(`parseResponse meta.provider must be '${providerName}', got '${meta.provider}'`);
+                    }
+                    if (!meta.rateLimit) {
+                        errors.push("parseResponse meta must include rateLimit");
+                    }
+                    else {
+                        if (typeof meta.rateLimit.limit !== "number") {
+                            errors.push("rateLimit.limit must be number");
+                        }
+                        if (typeof meta.rateLimit.remaining !== "number") {
+                            errors.push("rateLimit.remaining must be number");
+                        }
+                        if (!(meta.rateLimit.reset instanceof Date)) {
+                            errors.push("rateLimit.reset must be Date");
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`parseResponse threw error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (typeof adapter.parseError === "function") {
+        const testErrors = [
+            { status: 401, headers: new Headers(), body: { message: "Unauthorized" } },
+            { status: 404, headers: new Headers(), body: { message: "Not Found" } },
+            { status: 429, headers: new Headers(), body: { message: "Rate Limited" } },
+            { status: 500, headers: new Headers(), body: { message: "Server Error" } },
+            new Error("Network error"),
+        ];
+        for (const testError of testErrors) {
+            try {
+                const error = adapter.parseError(testError);
+                if (!(error instanceof MeridianError)) {
+                    if (error instanceof Error) {
+                        errors.push("parseError must return MeridianError instance (extends Error), got Error-like object without proper inheritance");
+                    }
+                    else {
+                        errors.push("parseError must return MeridianError instance");
+                    }
+                    continue;
+                }
+                const validCategories = ["auth", "rate_limit", "network", "provider", "validation"];
+                if (!validCategories.includes(error.category)) {
+                    errors.push(`parseError returned invalid category: ${error.category}. Must be one of: ${validCategories.join()}`);
+                }
+                if (typeof error.retryable !== "boolean") {
+                    errors.push("parseError returned MeridianError with non-boolean 'retryable' property");
+                }
+                if (error.provider !== providerName) {
+                    errors.push(`parseError returned provider '${error.provider}', expected '${providerName}'`);
+                }
+                if (typeof error.requestId !== "string") {
+                    errors.push("parseError must return MeridianError with requestId as string");
+                }
+                const providerSpecificFields = ["documentation_url", "github_message", "stripe_error"];
+                for (const field of providerSpecificFields) {
+                    if (field in error && !(field in Error.prototype)) {
+                        warnings.push(`parseError may be leaking provider-specific field: ${field}. Consider moving to metadata.`);
+                    }
+                }
+            }
+            catch (error) {
+                errors.push(`parseError threw error for test case: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    if (typeof adapter.authStrategy === "function") {
+        try {
+            const config = { token: "MERIDIAN_TEST_TOKEN_DO_NOT_VALIDATE" };
+            const tokenPromise = adapter.authStrategy(config);
+            if (!(tokenPromise instanceof Promise)) {
+                errors.push("authStrategy must return Promise<AuthToken>");
+            }
+            else {
+                try {
+                    const token = await tokenPromise;
+                    if (!token || typeof token !== "object") {
+                        errors.push("authStrategy must return AuthToken object");
+                    }
+                    else if (typeof token.token !== "string") {
+                        errors.push("authStrategy must return token as string");
+                    }
+                }
+                catch (error) {
+                    if (error instanceof Error && "category" in error) {
+                        const meridianError = error;
+                        if (meridianError.category !== "auth") {
+                            warnings.push("authStrategy should throw MeridianError with category 'auth' on failure");
+                        }
+                    }
+                    else {
+                        warnings.push("authStrategy should throw MeridianError, not raw Error");
+                    }
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`authStrategy threw synchronous error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (typeof adapter.rateLimitPolicy === "function") {
+        try {
+            const headers = new Headers({
+                "X-RateLimit-Limit": "5000",
+                "X-RateLimit-Remaining": "4999",
+                "X-RateLimit-Reset": String(Math.floor(Date.now() / 1000) + 3600),
+            });
+            const rateLimit = adapter.rateLimitPolicy(headers);
+            if (!rateLimit || typeof rateLimit !== "object") {
+                errors.push("rateLimitPolicy must return RateLimitInfo object");
+            }
+            else {
+                if (typeof rateLimit.limit !== "number") {
+                    errors.push("rateLimitPolicy must return limit as number");
+                }
+                if (typeof rateLimit.remaining !== "number") {
+                    errors.push("rateLimitPolicy must return remaining as number");
+                }
+                if (!(rateLimit.reset instanceof Date)) {
+                    errors.push("rateLimitPolicy must return reset as Date");
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`rateLimitPolicy threw error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (typeof adapter.paginationStrategy === "function") {
+        try {
+            const strategy = adapter.paginationStrategy();
+            if (!strategy || typeof strategy !== "object") {
+                errors.push("paginationStrategy must return PaginationStrategy object");
+            }
+            else {
+                const requiredMethods = ["extractCursor", "extractTotal", "hasNext", "buildNextRequest"];
+                for (const method of requiredMethods) {
+                    if (typeof strategy[method] !== "function") {
+                        errors.push(`paginationStrategy must implement ${method} method`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`paginationStrategy threw error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (typeof adapter.getIdempotencyConfig === "function") {
+        try {
+            const config = adapter.getIdempotencyConfig();
+            if (!config || typeof config !== "object") {
+                errors.push("getIdempotencyConfig must return IdempotencyConfig object");
+            }
+            else {
+                if (!(config.defaultSafeOperations instanceof Set)) {
+                    errors.push("getIdempotencyConfig must return defaultSafeOperations as Set");
+                }
+                if (!(config.operationOverrides instanceof Map)) {
+                    errors.push("getIdempotencyConfig must return operationOverrides as Map");
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`getIdempotencyConfig threw error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+export async function assertValidAdapter(adapter, providerName) {
+    const result = await validateAdapter(adapter, providerName);
+    if (!result.valid || result.warnings.length > 0) {
+        const errorMessage = [
+            `Adapter validation failed for '${providerName}':`,
+            ...result.errors.map((e) => `  - ERROR: ${e}`),
+            ...result.warnings.map((w) => `  - WARNING (treated as error): ${w}`),
+        ].join("\n");
+        throw new Error(errorMessage);
+    }
+}
+export function isProviderAdapter(obj) {
+    if (!obj || typeof obj !== "object") {
+        return false;
+    }
+    const requiredMethods = [
+        "buildRequest",
+        "parseResponse",
+        "parseError",
+        "authStrategy",
+        "rateLimitPolicy",
+        "paginationStrategy",
+        "getIdempotencyConfig",
+    ];
+    return requiredMethods.every((method) => typeof obj[method] === "function");
+}
+//# sourceMappingURL=adapter-validator.js.map

package/dist/core/adapter-validator.js.map

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

package/dist/core/error-sanitizer.d.ts

@@ -0,0 +1,3 @@
+import { MeridianError } from "./types.js";
+export declare function sanitizeMeridianError(error: unknown, expectedProvider: string, requestId?: string): MeridianError;
+//# sourceMappingURL=error-sanitizer.d.ts.map

package/dist/core/error-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-sanitizer.d.ts","sourceRoot":"","sources":["../../src/core/error-sanitizer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAA8B,MAAM,YAAY,CAAC;AAsHvE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,MAAM,EACxB,SAAS,GAAE,MAAW,GACrB,aAAa,CA0Ef"}