salesflare-mcp-server 1.0.0

package/dist/types/deal.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Deal types for Salesflare MCP Server
+ *
+ * TypeScript interfaces and type definitions for Deal CRUD operations.
+ *
+ * @module types/deal
+ */
+import { z } from 'zod';
+import { createDealListSchema, createDealCreateSchema, createDealUpdateSchema } from '../utils/validation.js';
+/**
+ * Core deal entity interface
+ * Represents a deal/opportunity in Salesflare CRM with essential fields (per D-01 to D-06)
+ */
+export interface Deal {
+    /** Unique identifier (UUID) */
+    id: string;
+    /** Deal name (required per D-01) */
+    name: string;
+    /** Deal value in cents (required per D-03) */
+    value: number;
+    /** Currency code (3-letter ISO per D-04, default 'USD') */
+    currency: string;
+    /** Pipeline ID the deal belongs to (required per D-01) */
+    pipeline_id: string;
+    /** Stage ID within the pipeline (optional per D-02) */
+    stage_id?: string;
+    /** Deal status (open, won, or lost per D-07) */
+    status: 'open' | 'won' | 'lost';
+    /** Expected close date (ISO 8601, optional per D-02) */
+    close_date?: string;
+    /** Assigned user information (optional per D-02) */
+    assigned_user?: {
+        /** User UUID */
+        id: string;
+        /** User name */
+        name: string;
+    };
+    /** Associated company (optional per D-06) */
+    company?: {
+        /** Company UUID */
+        id: string;
+        /** Company name */
+        name: string;
+    };
+    /** Associated contacts (optional per D-06) */
+    contacts?: Array<{
+        /** Contact UUID */
+        id: string;
+        /** Contact name */
+        name: string;
+    }>;
+    /** Deal description (optional per D-02) */
+    description?: string;
+    /** Creation timestamp (ISO 8601) */
+    created_at: string;
+    /** Last update timestamp (ISO 8601) */
+    updated_at: string;
+}
+/**
+ * Paginated deal list response
+ * Returned by the list deals endpoint
+ */
+export interface DealListResponse {
+    /** Array of deals for the current page */
+    deals: Deal[];
+    /** Total number of deals matching the filter */
+    total: number;
+    /** Current page number (1-indexed) */
+    page: number;
+    /** Number of items per page */
+    limit: number;
+    /** Whether there are more pages available */
+    has_more: boolean;
+}
+/**
+ * Filter parameters for listing deals
+ * All fields are optional - omit to skip filtering (per D-15 to D-20)
+ */
+export interface DealListFilters {
+    /** Filter by deal status (per D-15) */
+    status?: 'open' | 'won' | 'lost';
+    /** Filter by pipeline ID (per D-16) */
+    pipeline_id?: string;
+    /** Filter by assigned user ID (per D-17) */
+    assigned_user_id?: string;
+    /** Filter by stage ID (per D-18) */
+    stage_id?: string;
+    /** Minimum deal value in cents (per D-19) */
+    min_value?: number;
+    /** Maximum deal value in cents (per D-19) */
+    max_value?: number;
+    /** Free-text search across deal fields (per D-20) */
+    search?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Items per page (default: 20, max: 100) */
+    limit?: number;
+}
+/**
+ * Input data for creating a new deal
+ * Name, value, and pipeline_id are required per D-01
+ */
+export interface DealCreateInput {
+    /** Deal name (required per D-01) */
+    name: string;
+    /** Deal value in dollars (will be converted to cents per D-22) */
+    value: number;
+    /** Currency code (3-letter ISO, default 'USD') */
+    currency?: string;
+    /** Pipeline ID the deal belongs to (required per D-01) */
+    pipeline_id: string;
+    /** Stage ID within the pipeline (optional) */
+    stage_id?: string;
+    /** Expected close date (ISO 8601) */
+    close_date?: string;
+    /** Assigned user ID (UUID) */
+    assigned_user_id?: string;
+    /** Associated company ID (UUID per D-06) */
+    company_id?: string;
+    /** Associated contact IDs (UUID array per D-06) */
+    contact_ids?: string[];
+    /** Deal description */
+    description?: string;
+}
+/**
+ * Input data for updating an existing deal
+ * All fields are optional - only provided fields will be updated (PATCH semantics per D-25)
+ */
+export interface DealUpdateInput {
+    /** Deal name (optional) */
+    name?: string;
+    /** Deal value in dollars (will be converted to cents) */
+    value?: number;
+    /** Currency code (3-letter ISO) */
+    currency?: string;
+    /** Pipeline ID the deal belongs to (optional) */
+    pipeline_id?: string;
+    /** Stage ID within the pipeline (optional) */
+    stage_id?: string;
+    /** Expected close date (ISO 8601) */
+    close_date?: string;
+    /** Assigned user ID (UUID) */
+    assigned_user_id?: string;
+    /** Associated company ID (UUID) */
+    company_id?: string;
+    /** Associated contact IDs (UUID array) */
+    contact_ids?: string[];
+    /** Deal description */
+    description?: string;
+    /** Deal status (open, won, or lost) */
+    status?: 'open' | 'won' | 'lost';
+}
+/**
+ * Input data for moving a deal to a new stage
+ * Both IDs are required per D-26
+ */
+export interface DealMoveStageInput {
+    /** Deal ID to move (required) */
+    deal_id: string;
+    /** Target stage ID (required) */
+    stage_id: string;
+}
+/**
+ * Type inference from schemas for runtime validation
+ * These types are derived from the Zod validation schemas
+ */
+/** Type for deal list parameters (inferred from schema) */
+export type DealListParams = z.infer<ReturnType<typeof createDealListSchema>>;
+/** Type for deal create data (inferred from schema) */
+export type DealCreateData = z.infer<ReturnType<typeof createDealCreateSchema>>;
+/** Type for deal update data (inferred from schema) */
+export type DealUpdateData = z.infer<ReturnType<typeof createDealUpdateSchema>>;
+/**
+ * Standard MCP tool response format for deal operations
+ * Returns both human-readable text and structured JSON data
+ */
+export interface DealToolResponse {
+    /** Response content array */
+    content: [
+        /** Human-readable summary text */
+        {
+            type: 'text';
+            text: string;
+        },
+        /** JSON stringified data */
+        {
+            type: 'text';
+            text: string;
+        }
+    ];
+}
+/**
+ * MCP tool response format for delete operations
+ * Returns only a success confirmation (no deal data for deleted records)
+ */
+export interface DealDeleteResponse {
+    /** Response content array with single text item */
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+}
+//# sourceMappingURL=deal.d.ts.map

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

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

package/dist/types/deal.js

@@ -0,0 +1,8 @@
+/**
+ * Deal types for Salesflare MCP Server
+ *
+ * TypeScript interfaces and type definitions for Deal CRUD operations.
+ *
+ * @module types/deal
+ */
+export {};

package/dist/types/pipeline.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Pipeline types for Salesflare MCP Server
+ *
+ * TypeScript interfaces and type definitions for Pipeline operations.
+ *
+ * @module types/pipeline
+ */
+/**
+ * Pipeline stage entity interface (per D-17)
+ */
+export interface PipelineStage {
+    /** Unique identifier (UUID) */
+    id: string;
+    /** Stage name (e.g., "Prospecting") */
+    name: string;
+    /** Parent pipeline ID (UUID) */
+    pipeline_id: string;
+    /** Position/order in pipeline */
+    position: number;
+    /** Creation timestamp (ISO 8601) */
+    created_at: string;
+}
+/**
+ * Response for listing pipeline stages
+ */
+export interface PipelineStageListResponse {
+    /** Array of pipeline stages */
+    stages: PipelineStage[];
+    /** Pipeline ID if filtered by specific pipeline */
+    pipeline_id?: string;
+    /** Total number of stages */
+    total: number;
+}
+/**
+ * Filter parameters for listing pipeline stages (per D-20 to D-22)
+ */
+export interface PipelineStageListFilters {
+    /** Filter by pipeline ID (optional per D-21) */
+    pipeline_id?: string;
+}
+/**
+ * Statistics for a single pipeline stage (per D-18)
+ */
+export interface PipelineStageStatistics {
+    /** Stage ID (UUID) */
+    stage_id: string;
+    /** Stage name */
+    stage_name: string;
+    /** Position in pipeline */
+    position: number;
+    /** Number of deals in this stage */
+    deal_count: number;
+    /** Total value in cents */
+    total_value_cents: number;
+    /** Formatted value for display (e.g., "$10,000.00") per D-24 */
+    total_value_display: string;
+}
+/**
+ * Pipeline overview statistics (per D-18)
+ */
+export interface PipelineOverview {
+    /** Pipeline ID (UUID) */
+    pipeline_id: string;
+    /** Pipeline name */
+    pipeline_name: string;
+    /** Total number of deals across all stages */
+    total_deals: number;
+    /** Total value in cents */
+    total_value_cents: number;
+    /** Formatted total value for display (e.g., "$10,000.00") per D-24 */
+    total_value_display: string;
+    /** Statistics for each stage */
+    stages: PipelineStageStatistics[];
+    /** Number of open deals */
+    open_deals: number;
+    /** Number of won deals */
+    won_deals: number;
+    /** Number of lost deals */
+    lost_deals: number;
+}
+/**
+ * Filter parameters for pipeline overview (per D-25)
+ */
+export interface PipelineOverviewFilters {
+    /** Filter by pipeline ID (optional) */
+    pipeline_id?: string;
+}
+/**
+ * Response wrapper for pipeline overview
+ */
+export interface PipelineOverviewResponse {
+    /** Array of pipeline overviews */
+    pipelines: PipelineOverview[];
+    /** Total number of pipelines */
+    total_pipelines: number;
+}
+/**
+ * Standard MCP tool response format for pipeline operations
+ * Returns both human-readable text and structured JSON data
+ */
+export interface PipelineToolResponse {
+    /** Response content array */
+    content: [
+        /** Human-readable summary text */
+        {
+            type: 'text';
+            text: string;
+        },
+        /** JSON stringified data */
+        {
+            type: 'text';
+            text: string;
+        }
+    ];
+}
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,+BAA+B;IAC/B,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IAEpB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,sEAAsE;IACtE,mBAAmB,EAAE,MAAM,CAAC;IAE5B,gCAAgC;IAChC,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAElC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAE9B,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,OAAO,EAAE;QACP,kCAAkC;QAClC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE;QAC9B,4BAA4B;QAC5B;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE;KAC/B,CAAC;CACH"}

package/dist/types/pipeline.js

@@ -0,0 +1,8 @@
+/**
+ * Pipeline types for Salesflare MCP Server
+ *
+ * TypeScript interfaces and type definitions for Pipeline operations.
+ *
+ * @module types/pipeline
+ */
+export {};

package/dist/types/task.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Task types for Salesflare MCP Server
+ *
+ * TypeScript interfaces and type definitions for Task CRUD operations.
+ *
+ * @module types/task
+ */
+import { z } from 'zod';
+import { createTaskListSchema, createTaskCreateSchema, createTaskUpdateSchema } from '../utils/validation.js';
+/**
+ * Core task entity interface
+ * Represents a task in Salesflare CRM with essential fields (per D-01 to D-05)
+ */
+export interface Task {
+    /** Unique identifier (UUID) */
+    id: string;
+    /** Task description (required per D-01) */
+    description: string;
+    /** Task status: 'open' or 'completed' (per D-03) */
+    status: 'open' | 'completed';
+    /** Due date (ISO 8601, optional per D-02) */
+    due_date?: string;
+    /** Assigned user information (optional per D-02) */
+    assigned_user?: {
+        /** User UUID */
+        id: string;
+        /** User name */
+        name: string;
+    };
+    /** Related contact information (optional per D-05, mutually exclusive with related_deal) */
+    related_contact?: {
+        /** Contact UUID */
+        id: string;
+        /** Contact name */
+        name: string;
+    };
+    /** Related deal information (optional per D-05, mutually exclusive with related_contact) */
+    related_deal?: {
+        /** Deal UUID */
+        id: string;
+        /** Deal name */
+        name: string;
+    };
+    /** Completion timestamp (ISO 8601, set when status changes to 'completed' per D-02) */
+    completed_at?: string;
+    /** Whether the task is overdue (calculated field per D-04) */
+    is_overdue: boolean;
+    /** Creation timestamp (ISO 8601) */
+    created_at: string;
+    /** Last update timestamp (ISO 8601) */
+    updated_at: string;
+}
+/**
+ * Paginated task list response
+ * Returned by the list tasks endpoint
+ */
+export interface TaskListResponse {
+    /** Array of tasks for the current page */
+    tasks: Task[];
+    /** Total number of tasks matching the filter */
+    total: number;
+    /** Current page number (1-indexed) */
+    page: number;
+    /** Number of items per page */
+    limit: number;
+    /** Whether there are more pages available */
+    has_more: boolean;
+}
+/**
+ * Filter parameters for listing tasks
+ * All fields are optional - omit to skip filtering (per D-06 to D-12)
+ */
+export interface TaskListFilters {
+    /** Filter by task status (per D-06) */
+    status?: 'open' | 'completed';
+    /** Filter by assigned user ID (per D-07) */
+    assigned_user_id?: string;
+    /** Filter by related contact ID (per D-08) */
+    related_contact_id?: string;
+    /** Filter by related deal ID (per D-09) */
+    related_deal_id?: string;
+    /** Filter by overdue status (per D-10) */
+    is_overdue?: boolean;
+    /** Filter tasks due before this date (ISO 8601, per D-11) */
+    due_before?: string;
+    /** Filter tasks due after this date (ISO 8601, per D-11) */
+    due_after?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Items per page (default: 20, max: 100) */
+    limit?: number;
+}
+/**
+ * Input data for creating a new task
+ * Description is required per D-26; other fields are optional
+ */
+export interface TaskCreateInput {
+    /** Task description (required per D-26) */
+    description: string;
+    /** Due date (ISO 8601, optional) */
+    due_date?: string;
+    /** Assigned user ID (UUID, optional) */
+    assigned_user_id?: string;
+    /** Related contact ID (UUID, optional per D-05, mutually exclusive with related_deal_id) */
+    related_contact_id?: string;
+    /** Related deal ID (UUID, optional per D-05, mutually exclusive with related_contact_id) */
+    related_deal_id?: string;
+    /** Task status (defaults to 'open' per D-30) */
+    status?: 'open' | 'completed';
+}
+/**
+ * Input data for updating an existing task
+ * All fields are optional - only provided fields will be updated (PATCH semantics per D-25)
+ */
+export interface TaskUpdateInput {
+    /** Task description (optional) */
+    description?: string;
+    /** Due date (ISO 8601, optional) */
+    due_date?: string;
+    /** Assigned user ID (UUID, optional) */
+    assigned_user_id?: string;
+    /** Task status (optional) */
+    status?: 'open' | 'completed';
+}
+/**
+ * Type inference from schemas for runtime validation
+ * These types are derived from the Zod validation schemas
+ */
+/** Type for task list parameters (inferred from schema) */
+export type TaskListParams = z.infer<ReturnType<typeof createTaskListSchema>>;
+/** Type for task create data (inferred from schema) */
+export type TaskCreateData = z.infer<ReturnType<typeof createTaskCreateSchema>>;
+/** Type for task update data (inferred from schema) */
+export type TaskUpdateData = z.infer<ReturnType<typeof createTaskUpdateSchema>>;
+/**
+ * Standard MCP tool response format for task operations
+ * Returns both human-readable text and structured JSON data
+ */
+export interface TaskToolResponse {
+    /** Response content array */
+    content: [
+        /** Human-readable summary text */
+        {
+            type: 'text';
+            text: string;
+        },
+        /** JSON stringified data */
+        {
+            type: 'text';
+            text: string;
+        }
+    ];
+}
+//# sourceMappingURL=task.d.ts.map

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

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

package/dist/types/task.js

@@ -0,0 +1,8 @@
+/**
+ * Task types for Salesflare MCP Server
+ *
+ * TypeScript interfaces and type definitions for Task CRUD operations.
+ *
+ * @module types/task
+ */
+export {};

package/dist/utils/errors.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Error handling utilities for Salesflare MCP Server
+ *
+ * Provides standardized error types with actionable messages for LLM consumers.
+ *
+ * @module utils/errors
+ */
+/**
+ * Standardized error codes for Salesflare MCP Server
+ *
+ * These codes enable programmatic error handling by LLMs.
+ */
+export declare enum ErrorCode {
+    AUTH_INVALID = "AUTH_INVALID",
+    AUTH_EXPIRED = "AUTH_EXPIRED",
+    AUTH_REQUIRED = "AUTH_REQUIRED",
+    NOT_FOUND = "NOT_FOUND",
+    RATE_LIMIT = "RATE_LIMIT",
+    SERVER_ERROR = "SERVER_ERROR",
+    API_ERROR = "API_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    INVALID_INPUT = "INVALID_INPUT",
+    CONFIG_ERROR = "CONFIG_ERROR",
+    MISSING_ENV_VAR = "MISSING_ENV_VAR"
+}
+/**
+ * Structured error metadata for LLM consumption
+ */
+export interface ErrorMetadata {
+    /** The error code for programmatic handling */
+    code: ErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Suggested fix for the error */
+    fix?: string;
+    /** Whether the operation can be retried */
+    retryable: boolean;
+    /** HTTP status code if from API */
+    statusCode?: number;
+    /** Additional context */
+    details?: Record<string, unknown>;
+}
+/**
+ * Base error class for Salesflare MCP Server
+ *
+ * Provides structured error information with codes, fix suggestions,
+ * and retry guidance for LLM consumers.
+ */
+export declare class SalesflareError extends Error {
+    /** Error code for programmatic handling */
+    readonly code: ErrorCode;
+    /** Suggested fix for the error */
+    readonly fix?: string;
+    /** Whether the operation can be retried */
+    readonly retryable: boolean;
+    /** HTTP status code if applicable */
+    readonly statusCode?: number;
+    /** Additional error details */
+    readonly details?: Record<string, unknown>;
+    /**
+     * Create a new SalesflareError
+     *
+     * @param metadata - Error metadata including code, message, and fix
+     */
+    constructor(metadata: ErrorMetadata);
+    /**
+     * Convert error to JSON-serializable object
+     *
+     * @returns Error metadata as plain object
+     */
+    toJSON(): ErrorMetadata;
+    /**
+     * Format error for MCP tool response
+     *
+     * @returns Formatted error string with fix suggestion
+     */
+    toToolResponse(): string;
+}
+/**
+ * Create an authentication error
+ *
+ * @param message - Error message
+ * @param fix - Suggested fix
+ * @returns SalesflareError with AUTH_INVALID code
+ */
+export declare function createAuthError(message: string, fix?: string): SalesflareError;
+/**
+ * Create a validation error
+ *
+ * @param message - Error message
+ * @param details - Validation details
+ * @returns SalesflareError with VALIDATION_ERROR code
+ */
+export declare function createValidationError(message: string, details?: Record<string, unknown>): SalesflareError;
+/**
+ * Create a configuration error
+ *
+ * @param message - Error message
+ * @param fix - Suggested fix
+ * @returns SalesflareError with CONFIG_ERROR code
+ */
+export declare function createConfigError(message: string, fix?: string): SalesflareError;
+/**
+ * Create a missing environment variable error
+ *
+ * @param varName - Name of the missing environment variable
+ * @returns SalesflareError with MISSING_ENV_VAR code
+ */
+export declare function createMissingEnvVarError(varName: string): SalesflareError;
+/**
+ * Formatted error response with actionable fix suggestion
+ */
+export interface ErrorResponse {
+    code: ErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+    retryable: boolean;
+    fix: string;
+}
+/**
+ * Format any error into a consistent error response with actionable fix suggestion
+ *
+ * @param error - The error to format (SalesflareError, generic Error, or unknown)
+ * @returns Formatted error response with code, message, details, retryable flag, and fix suggestion
+ */
+export declare function formatErrorResponse(error: unknown): ErrorResponse;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,oBAAY,SAAS;IAEnB,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAG/B,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAG/B,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAG/B,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,kCAAkC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C;;;;OAIG;gBACS,QAAQ,EAAE,aAAa;IAanC;;;;OAIG;IACH,MAAM,IAAI,aAAa;IAWvB;;;;OAIG;IACH,cAAc,IAAI,MAAM;CAUzB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAO9E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,eAAe,CAOjB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAOhF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAOzE;AAoBD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CA6BjE"}