@cleocode/contracts 2026.3.38 → 2026.3.40

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CLEO 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,491 @@
+# @cleocode/contracts
+
+Domain types, interfaces, and contracts for the CLEO ecosystem.
+
+## Overview
+
+This package contains all type definitions, interfaces, and contracts used throughout the CLEO monorepo. It is the **leaf package** in the dependency graph with **zero runtime dependencies**, serving as the foundation for type safety across all other packages.
+
+All domain types (Task, Session, DataAccessor, etc.) are defined here. Implementation packages (`@cleocode/core`, `@cleocode/cleo`) import from here.
+
+## Installation
+
+```bash
+npm install @cleocode/contracts
+```
+
+```bash
+pnpm add @cleocode/contracts
+```
+
+```bash
+yarn add @cleocode/contracts
+```
+
+## API Overview
+
+### Core Types
+
+#### Task Types
+
+```typescript
+import type { 
+  Task, 
+  TaskCreate, 
+  TaskPriority, 
+  TaskStatus,
+  TaskType,
+  TaskSize,
+  EpicLifecycle,
+  Phase,
+  PhaseStatus,
+  PhaseTransition,
+  VerificationGate,
+  TaskVerification,
+  TaskWorkState
+} from '@cleocode/contracts';
+```
+
+#### Session Types
+
+```typescript
+import type { 
+  Session, 
+  SessionScope, 
+  SessionStartResult,
+  SessionStats,
+  SessionTaskWork,
+  SessionView
+} from '@cleocode/contracts';
+```
+
+#### Memory Types
+
+```typescript
+import type { 
+  BrainEntryRef,
+  BrainEntrySummary,
+  ContradictionDetail,
+  SupersededEntry,
+  MemoryBridgeConfig,
+  MemoryBridgeContent,
+  BridgeDecision,
+  BridgeLearning,
+  BridgeObservation,
+  BridgePattern,
+  SessionSummary
+} from '@cleocode/contracts';
+```
+
+#### Data Accessor Interface
+
+```typescript
+import type { 
+  DataAccessor,
+  TransactionAccessor,
+  TaskQueryFilters,
+  QueryTasksResult,
+  TaskFieldUpdates,
+  ArchiveFields,
+  ArchiveFile
+} from '@cleocode/contracts';
+```
+
+### Status Registry
+
+Centralized status definitions with validation and display helpers:
+
+```typescript
+import { 
+  TASK_STATUSES,
+  SESSION_STATUSES,
+  LIFECYCLE_STAGE_STATUSES,
+  LIFECYCLE_PIPELINE_STATUSES,
+  GATE_STATUSES,
+  ADR_STATUSES,
+  MANIFEST_STATUSES,
+  isValidStatus,
+  STATUS_REGISTRY,
+  TASK_STATUS_SYMBOLS_ASCII,
+  TASK_STATUS_SYMBOLS_UNICODE,
+  PIPELINE_STATUS_ICONS,
+  STAGE_STATUS_ICONS,
+  TERMINAL_TASK_STATUSES,
+  TERMINAL_STAGE_STATUSES,
+  TERMINAL_PIPELINE_STATUSES
+} from '@cleocode/contracts';
+
+// Validate a status
+const isValid = isValidStatus('task', 'in_progress');
+
+// Get status icon
+const icon = TASK_STATUS_SYMBOLS_UNICODE['completed'];
+```
+
+### Exit Codes
+
+Standardized exit codes for CLEO operations:
+
+```typescript
+import { 
+  ExitCode,
+  getExitCodeName,
+  isSuccessCode,
+  isErrorCode,
+  isRecoverableCode,
+  isNoChangeCode
+} from '@cleocode/contracts';
+
+// Check exit code meaning
+if (isSuccessCode(exitCode)) {
+  console.log('Operation succeeded');
+}
+```
+
+### Configuration Types
+
+```typescript
+import type { 
+  CleoConfig,
+  ConfigSource,
+  LogLevel,
+  LoggingConfig,
+  SessionConfig,
+  LifecycleConfig,
+  LifecycleEnforcementMode,
+  EnforcementProfile,
+  SharingConfig,
+  SharingMode,
+  SignalDockConfig,
+  SignalDockMode,
+  OutputConfig,
+  OutputFormat,
+  DateFormat,
+  BackupConfig,
+  HierarchyConfig,
+  ResolvedValue
+} from '@cleocode/contracts';
+```
+
+### LAFS (Language-Agnostic Feedback Schema)
+
+Standardized envelope format for API responses:
+
+```typescript
+import type { 
+  LafsEnvelope,
+  LafsSuccess,
+  LafsError,
+  LafsErrorDetail,
+  LAFSPage,
+  LAFSPageOffset,
+  LAFSPageNone,
+  LAFSMeta,
+  MVILevel,
+  Warning,
+  LafsAlternative,
+  CleoResponse,
+  GatewayEnvelope,
+  GatewaySuccess,
+  GatewayError,
+  GatewayMeta,
+  ConformanceReport,
+  FlagInput,
+  LAFSError,
+  LAFSErrorCategory,
+  LAFSTransport
+} from '@cleocode/contracts';
+
+import { 
+  isLafsSuccess, 
+  isLafsError,
+  isGatewayEnvelope 
+} from '@cleocode/contracts';
+```
+
+### Provider Adapter Contracts
+
+```typescript
+import type { 
+  CLEOProviderAdapter,
+  AdapterHealthStatus,
+  AdapterCapabilities,
+  AdapterContextMonitorProvider,
+  AdapterHookProvider,
+  AdapterInstallProvider,
+  InstallOptions,
+  InstallResult,
+  AdapterSpawnProvider,
+  SpawnContext,
+  SpawnResult,
+  AdapterTransportProvider,
+  AdapterPathProvider,
+  AdapterTaskSyncProvider,
+  ExternalTask,
+  ExternalTaskStatus,
+  ReconcileAction,
+  ReconcileActionType,
+  ReconcileOptions,
+  ReconcileResult,
+  SyncSessionState,
+  ConflictPolicy
+} from '@cleocode/contracts';
+```
+
+### Task Sync Types
+
+Provider-agnostic reconciliation types:
+
+```typescript
+import type { 
+  ExternalTask,
+  ExternalTaskStatus,
+  ReconcileAction,
+  ReconcileActionType,
+  ReconcileOptions,
+  ReconcileResult,
+  SyncSessionState,
+  ConflictPolicy
+} from '@cleocode/contracts';
+```
+
+### Archive Types
+
+```typescript
+import type { 
+  ArchivedTask,
+  ArchiveMetadata,
+  ArchiveSummaryReport,
+  ArchiveTrendsReport,
+  ArchiveCycleTimesReport,
+  ArchiveStatsEnvelope,
+  ArchiveReportType,
+  ArchiveDailyTrend,
+  ArchiveMonthlyTrend,
+  ArchiveLabelEntry,
+  ArchivePhaseEntry,
+  ArchivePriorityEntry,
+  CycleTimeDistribution,
+  CycleTimePercentiles
+} from '@cleocode/contracts';
+```
+
+### Results Types
+
+Dashboard and statistics results:
+
+```typescript
+import type { 
+  DashboardResult,
+  StatsResult,
+  StatsActivityMetrics,
+  StatsAllTime,
+  StatsCompletionMetrics,
+  StatsCurrentState,
+  StatsCycleTimes,
+  ContextResult,
+  LogQueryResult,
+  SequenceResult,
+  TaskDepsResult,
+  TaskAnalysisResult,
+  TaskRef,
+  TaskRefPriority,
+  TaskSummary,
+  LabelCount,
+  CompleteTaskUnblocked,
+  BottleneckTask,
+  LeveragedTask
+} from '@cleocode/contracts';
+```
+
+### Task Record Types
+
+String-widened types for dispatch and LAFS:
+
+```typescript
+import type { 
+  TaskRecord,
+  MinimalTaskRecord,
+  TaskRecordRelation,
+  ValidationHistoryEntry
+} from '@cleocode/contracts';
+```
+
+### Spawn Types
+
+CLEO spawn system types:
+
+```typescript
+import type { 
+  CLEOSpawnAdapter,
+  CLEOSpawnContext,
+  CLEOSpawnResult,
+  CAAMPSpawnOptions,
+  CAAMPSpawnResult,
+  Provider,
+  SpawnStatus,
+  TokenResolution
+} from '@cleocode/contracts';
+```
+
+### Tessera Types
+
+Template instantiation types:
+
+```typescript
+import type { 
+  TesseraTemplate,
+  TesseraVariable,
+  TesseraInstantiationInput
+} from '@cleocode/contracts';
+```
+
+### WarpChain Types
+
+Protocol execution chain types:
+
+```typescript
+import type { 
+  WarpChain,
+  WarpChainInstance,
+  WarpChainExecution,
+  WarpStage,
+  WarpLink,
+  GateContract,
+  GateName,
+  GateCheck,
+  GateResult,
+  ChainValidation,
+  ChainShape,
+  ProtocolType
+} from '@cleocode/contracts';
+```
+
+### Operations Types (Namespace)
+
+All operation types are namespaced under `ops` to avoid collisions:
+
+```typescript
+import { ops } from '@cleocode/contracts';
+
+// Access operation types
+const taskParams: ops.TaskQueryParams = { ... };
+const createParams: ops.TaskCreateParams = { ... };
+```
+
+Available operation namespaces:
+- `ops.TaskQueryParams`
+- `ops.TaskCreateParams`
+- `ops.TaskUpdateParams`
+- `ops.TaskCompleteParams`
+- `ops.SessionStartParams`
+- `ops.SessionEndParams`
+- `ops.MemoryObserveParams`
+- `ops.MemorySearchParams`
+- `ops.BrainQueryParams`
+- `ops.ValidateParams`
+- `ops.ReleaseParams`
+- `ops.OrchestrateParams`
+- `ops.ResearchParams`
+- `ops.SkillsParams`
+- `ops.SystemParams`
+- `ops.IssuesParams`
+- And more...
+
+### Discovery Types
+
+Provider manifest discovery:
+
+```typescript
+import type { 
+  AdapterManifest,
+  DetectionPattern
+} from '@cleocode/contracts';
+```
+
+### Context Monitor Types
+
+```typescript
+import type { 
+  AdapterContextMonitorProvider
+} from '@cleocode/contracts';
+```
+
+### Hooks Types
+
+```typescript
+import type { 
+  AdapterHookProvider
+} from '@cleocode/contracts';
+```
+
+## Usage Examples
+
+### Creating a Task Type
+
+```typescript
+import type { TaskCreate, TaskPriority, TaskType } from '@cleocode/contracts';
+
+const newTask: TaskCreate = {
+  title: 'Implement authentication',
+  description: 'Add JWT-based auth to the API',
+  priority: 'high' as TaskPriority,
+  type: 'feature' as TaskType,
+  size: 'medium',
+  labels: ['backend', 'security']
+};
+```
+
+### Using the Data Accessor Interface
+
+```typescript
+import type { DataAccessor, TaskQueryFilters } from '@cleocode/contracts';
+
+async function fetchHighPriorityTasks(accessor: DataAccessor) {
+  const filters: TaskQueryFilters = {
+    priority: ['high', 'urgent'],
+    status: ['pending', 'in_progress'],
+    limit: 10
+  };
+  
+  return await accessor.queryTasks(filters);
+}
+```
+
+### Working with LAFS Envelopes
+
+```typescript
+import { isLafsSuccess, isLafsError, type LafsEnvelope } from '@cleocode/contracts';
+
+function handleResponse(response: LafsEnvelope<unknown>) {
+  if (isLafsSuccess(response)) {
+    console.log('Success:', response.data);
+  } else if (isLafsError(response)) {
+    console.error('Error:', response.error.message);
+  }
+}
+```
+
+### Status Validation
+
+```typescript
+import { isValidStatus, TASK_STATUSES } from '@cleocode/contracts';
+
+// Check if a status is valid
+if (isValidStatus('task', 'in_progress')) {
+  console.log('Valid task status');
+}
+
+// Iterate over all valid statuses
+for (const status of TASK_STATUSES) {
+  console.log(`Valid status: ${status}`);
+}
+```
+
+## Dependencies
+
+This package has **no runtime dependencies**. It contains only TypeScript type definitions and interfaces.
+
+## License
+
+MIT License - see [LICENSE](../LICENSE) for details.

package/dist/adapter.d.ts

@@ -10,7 +10,7 @@ import type { AdapterHookProvider } from './hooks.js';
 import type { AdapterInstallProvider } from './install.js';
 import type { AdapterPathProvider } from './provider-paths.js';
 import type { AdapterSpawnProvider } from './spawn.js';
-import type { AdapterTaskSyncProvider } from './task-sync.js';
+import type { ExternalTaskProvider } from './task-sync.js';
 import type { AdapterTransportProvider } from './transport.js';
 export interface CLEOProviderAdapter {
     readonly id: string;
@@ -23,7 +23,7 @@ export interface CLEOProviderAdapter {
     paths?: AdapterPathProvider;
     contextMonitor?: AdapterContextMonitorProvider;
     transport?: AdapterTransportProvider;
-    taskSync?: AdapterTaskSyncProvider;
+    taskSync?: ExternalTaskProvider;
     initialize(projectDir: string): Promise<void>;
     dispose(): Promise<void>;
     healthCheck(): Promise<AdapterHealthStatus>;

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,mBAAmB,CAAC;IAClC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,mBAAmB,CAAC;IAClC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/data-accessor.d.ts.map

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

package/dist/data-accessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-accessor.js","sourceRoot":"","sources":["../src/data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;AAgOH,8EAA8E;AAC9E,qCAAqC"}
+{"version":3,"file":"data-accessor.js","sourceRoot":"","sources":["../src/data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;AA0NH,8EAA8E;AAC9E,qCAAqC"}

package/dist/errors.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Central error utilities for CLEO.
+ *
+ * Provides consistent error handling patterns across the codebase.
+ * DRY error formatting, normalization, and transformation utilities.
+ *
+ * @task T5702
+ */
+/**
+ * Normalize any thrown value into a standardized error object.
+ *
+ * Handles:
+ * - Error instances (preserves stack trace info)
+ * - Strings (wraps in Error)
+ * - Objects with message property
+ * - null/undefined (provides fallback)
+ *
+ * @param error - The thrown value to normalize
+ * @param fallbackMessage - Message to use if error provides none
+ * @returns Normalized error with consistent shape
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await riskyOperation();
+ * } catch (err) {
+ *   const error = normalizeError(err, 'Operation failed');
+ *   console.error(error.message);
+ * }
+ * ```
+ */
+export declare function normalizeError(error: unknown, fallbackMessage?: string): Error;
+/**
+ * Extract a human-readable message from any error value.
+ *
+ * Safe to use on unknown thrown values without type guards.
+ *
+ * @param error - The error value
+ * @param fallback - Fallback message if extraction fails
+ * @returns The error message string
+ *
+ * @example
+ * ```typescript
+ * const message = getErrorMessage(err, 'Unknown error');
+ * ```
+ */
+export declare function getErrorMessage(error: unknown, fallback?: string): string;
+/**
+ * Format error details for logging or display.
+ *
+ * Includes stack trace for Error instances when includeStack is true.
+ *
+ * @param error - The error to format
+ * @param context - Optional context to prepend
+ * @param includeStack - Whether to include stack traces (default: false)
+ * @returns Formatted error string
+ *
+ * @example
+ * ```typescript
+ * console.error(formatError(err, 'Database connection'));
+ * // Output: [Database connection] Connection refused
+ * ```
+ */
+export declare function formatError(error: unknown, context?: string, includeStack?: boolean): string;
+/**
+ * Check if an error represents a specific error type by code or name.
+ *
+ * Useful for conditional error handling based on error types.
+ *
+ * @param error - The error to check
+ * @param codeOrName - The error code or name to match
+ * @returns True if the error matches
+ *
+ * @example
+ * ```typescript
+ * if (isErrorType(err, 'E_NOT_FOUND')) {
+ *   // Handle not found specifically
+ * }
+ * ```
+ */
+export declare function isErrorType(error: unknown, codeOrName: string): boolean;
+/**
+ * Create a standardized error result object.
+ *
+ * Common pattern for operations that return { success: boolean, error?: string }
+ *
+ * @param error - The error value
+ * @returns Error result object
+ *
+ * @example
+ * ```typescript
+ * return createErrorResult(err);
+ * // Returns: { success: false, error: "Something went wrong" }
+ * ```
+ */
+export declare function createErrorResult(error: unknown): {
+    success: false;
+    error: string;
+};
+/**
+ * Create a standardized success result object.
+ *
+ * @returns Success result object
+ *
+ * @example
+ * ```typescript
+ * return createSuccessResult();
+ * // Returns: { success: true }
+ * ```
+ */
+export declare function createSuccessResult(): {
+    success: true;
+};
+/**
+ * Type guard for error results.
+ *
+ * @param result - The result to check
+ * @returns True if the result is an error result
+ *
+ * @example
+ * ```typescript
+ * const result = await someOperation();
+ * if (isErrorResult(result)) {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+export declare function isErrorResult(result: {
+    success: boolean;
+    error?: string;
+}): result is {
+    success: false;
+    error: string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,eAAe,SAAiC,GAC/C,KAAK,CAmBP;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAkB,GAAG,MAAM,CAmBlF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,MAAM,CAU1F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAWvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAKnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAEvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE9C"}