@vasperacapital/vaspera-shared 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,34 @@
+
+> @vaspera/shared@0.1.0 build /Users/ryancolkitt/Documents/GitHub/VasperaPM/packages/shared
+> tsup
+
+CLI Building entry: src/index.ts, src/errors/index.ts, src/types/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/ryancolkitt/Documents/GitHub/VasperaPM/packages/shared/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+CJS Build start
+ESM Build start
+ESM dist/types/index.mjs      403.00 B
+ESM dist/index.mjs            11.17 KB
+ESM dist/errors/index.mjs     8.10 KB
+ESM dist/errors/index.mjs.map 14.80 KB
+ESM dist/index.mjs.map        24.98 KB
+ESM dist/types/index.mjs.map  4.13 KB
+ESM ⚡️ Build success in 13ms
+CJS dist/types/index.js      1.42 KB
+CJS dist/index.js            12.81 KB
+CJS dist/errors/index.js     9.26 KB
+CJS dist/types/index.js.map  4.18 KB
+CJS dist/errors/index.js.map 15.17 KB
+CJS dist/index.js.map        25.20 KB
+CJS ⚡️ Build success in 14ms
+DTS Build start
+DTS ⚡️ Build success in 888ms
+DTS dist/types/index.d.ts   3.60 KB
+DTS dist/index.d.ts         2.17 KB
+DTS dist/errors/index.d.ts  9.85 KB
+DTS dist/types/index.d.mts  3.60 KB
+DTS dist/index.d.mts        2.17 KB
+DTS dist/errors/index.d.mts 9.85 KB

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @vaspera/shared@0.1.0 typecheck /Users/ryancolkitt/Documents/GitHub/VasperaPM/packages/shared
+> tsc --noEmit
+

package/dist/errors/index.d.mts

@@ -0,0 +1,288 @@
+interface ErrorDefinition {
+    code: string;
+    message: string;
+    httpStatus: number;
+}
+declare const ErrorCodes: {
+    readonly AUTH: {
+        readonly REQUIRED: {
+            readonly code: "VPM-AUTH-001";
+            readonly message: "Authentication required";
+            readonly httpStatus: 401;
+        };
+        readonly INVALID_TOKEN: {
+            readonly code: "VPM-AUTH-002";
+            readonly message: "Invalid or expired authentication token";
+            readonly httpStatus: 401;
+        };
+        readonly INSUFFICIENT_PERMISSIONS: {
+            readonly code: "VPM-AUTH-003";
+            readonly message: "Insufficient permissions for this action";
+            readonly httpStatus: 403;
+        };
+        readonly SESSION_EXPIRED: {
+            readonly code: "VPM-AUTH-004";
+            readonly message: "Session has expired, please login again";
+            readonly httpStatus: 401;
+        };
+        readonly MFA_REQUIRED: {
+            readonly code: "VPM-AUTH-005";
+            readonly message: "Multi-factor authentication required";
+            readonly httpStatus: 403;
+        };
+    };
+    readonly API_KEY: {
+        readonly REQUIRED: {
+            readonly code: "VPM-API-KEY-001";
+            readonly message: "API key is required";
+            readonly httpStatus: 401;
+        };
+        readonly INVALID: {
+            readonly code: "VPM-API-KEY-002";
+            readonly message: "Invalid API key";
+            readonly httpStatus: 401;
+        };
+        readonly REVOKED: {
+            readonly code: "VPM-API-KEY-003";
+            readonly message: "API key has been revoked";
+            readonly httpStatus: 401;
+        };
+        readonly EXPIRED: {
+            readonly code: "VPM-API-KEY-004";
+            readonly message: "API key has expired";
+            readonly httpStatus: 401;
+        };
+        readonly RATE_LIMITED: {
+            readonly code: "VPM-API-KEY-005";
+            readonly message: "API key rate limit exceeded";
+            readonly httpStatus: 429;
+        };
+        readonly QUOTA_EXCEEDED: {
+            readonly code: "VPM-API-KEY-006";
+            readonly message: "Monthly usage quota exceeded";
+            readonly httpStatus: 429;
+        };
+    };
+    readonly MCP: {
+        readonly TOOL_NOT_FOUND: {
+            readonly code: "VPM-MCP-001";
+            readonly message: "Requested tool not found";
+            readonly httpStatus: 404;
+        };
+        readonly INVALID_ARGUMENTS: {
+            readonly code: "VPM-MCP-002";
+            readonly message: "Invalid tool arguments provided";
+            readonly httpStatus: 400;
+        };
+        readonly EXECUTION_FAILED: {
+            readonly code: "VPM-MCP-003";
+            readonly message: "Tool execution failed";
+            readonly httpStatus: 500;
+        };
+        readonly TIMEOUT: {
+            readonly code: "VPM-MCP-004";
+            readonly message: "Tool execution timed out";
+            readonly httpStatus: 504;
+        };
+        readonly LLM_ERROR: {
+            readonly code: "VPM-MCP-005";
+            readonly message: "AI model returned an error";
+            readonly httpStatus: 502;
+        };
+        readonly CONTEXT_TOO_LARGE: {
+            readonly code: "VPM-MCP-006";
+            readonly message: "Input context exceeds maximum size";
+            readonly httpStatus: 413;
+        };
+    };
+    readonly BILLING: {
+        readonly NO_SUBSCRIPTION: {
+            readonly code: "VPM-BILLING-001";
+            readonly message: "No active subscription found";
+            readonly httpStatus: 402;
+        };
+        readonly SUBSCRIPTION_EXPIRED: {
+            readonly code: "VPM-BILLING-002";
+            readonly message: "Subscription has expired";
+            readonly httpStatus: 402;
+        };
+        readonly PAYMENT_FAILED: {
+            readonly code: "VPM-BILLING-003";
+            readonly message: "Payment processing failed";
+            readonly httpStatus: 402;
+        };
+        readonly FEATURE_NOT_INCLUDED: {
+            readonly code: "VPM-BILLING-004";
+            readonly message: "Feature not included in current plan";
+            readonly httpStatus: 403;
+        };
+        readonly UPGRADE_REQUIRED: {
+            readonly code: "VPM-BILLING-005";
+            readonly message: "Plan upgrade required for this action";
+            readonly httpStatus: 403;
+        };
+    };
+    readonly INTEGRATION: {
+        readonly NOT_CONNECTED: {
+            readonly code: "VPM-INT-001";
+            readonly message: "Integration not connected";
+            readonly httpStatus: 400;
+        };
+        readonly TOKEN_EXPIRED: {
+            readonly code: "VPM-INT-002";
+            readonly message: "Integration token expired, reconnection required";
+            readonly httpStatus: 401;
+        };
+        readonly REFRESH_FAILED: {
+            readonly code: "VPM-INT-003";
+            readonly message: "Failed to refresh integration token";
+            readonly httpStatus: 502;
+        };
+        readonly API_ERROR: {
+            readonly code: "VPM-INT-004";
+            readonly message: "External integration API error";
+            readonly httpStatus: 502;
+        };
+        readonly RATE_LIMITED: {
+            readonly code: "VPM-INT-005";
+            readonly message: "Integration rate limit exceeded";
+            readonly httpStatus: 429;
+        };
+    };
+    readonly VALIDATION: {
+        readonly REQUIRED_FIELD: {
+            readonly code: "VPM-VAL-001";
+            readonly message: "Required field missing";
+            readonly httpStatus: 400;
+        };
+        readonly INVALID_FORMAT: {
+            readonly code: "VPM-VAL-002";
+            readonly message: "Invalid field format";
+            readonly httpStatus: 400;
+        };
+        readonly OUT_OF_RANGE: {
+            readonly code: "VPM-VAL-003";
+            readonly message: "Value out of allowed range";
+            readonly httpStatus: 400;
+        };
+        readonly INVALID_JSON: {
+            readonly code: "VPM-VAL-004";
+            readonly message: "Invalid JSON in request body";
+            readonly httpStatus: 400;
+        };
+    };
+    readonly SYSTEM: {
+        readonly INTERNAL_ERROR: {
+            readonly code: "VPM-SYS-001";
+            readonly message: "Internal server error";
+            readonly httpStatus: 500;
+        };
+        readonly DATABASE_ERROR: {
+            readonly code: "VPM-SYS-002";
+            readonly message: "Database operation failed";
+            readonly httpStatus: 500;
+        };
+        readonly SERVICE_UNAVAILABLE: {
+            readonly code: "VPM-SYS-003";
+            readonly message: "Service temporarily unavailable";
+            readonly httpStatus: 503;
+        };
+        readonly MAINTENANCE_MODE: {
+            readonly code: "VPM-SYS-004";
+            readonly message: "System is under maintenance";
+            readonly httpStatus: 503;
+        };
+    };
+};
+type ErrorCodeType = (typeof ErrorCodes)[keyof typeof ErrorCodes][keyof (typeof ErrorCodes)[keyof typeof ErrorCodes]];
+
+interface VasperaError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+    timestamp: string;
+    requestId: string;
+    docUrl?: string;
+}
+interface ErrorResponse {
+    success: false;
+    error: VasperaError;
+}
+declare function createError(errorDef: ErrorDefinition, details?: Record<string, unknown>, requestId?: string): VasperaError;
+declare function createErrorResponse(errorDef: ErrorDefinition, details?: Record<string, unknown>, requestId?: string): {
+    response: ErrorResponse;
+    status: number;
+};
+declare const Errors: {
+    authRequired: (requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    invalidApiKey: (requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    apiKeyRevoked: (requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    apiKeyExpired: (requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    rateLimited: (retryAfter: number, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    quotaExceeded: (currentUsage: number, limit: number, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    toolNotFound: (toolName: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    toolExecutionFailed: (toolName: string, reason: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    toolTimeout: (toolName: string, timeoutMs: number, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    validationFailed: (field: string, reason: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    invalidFormat: (field: string, expected: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    internalError: (message?: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    databaseError: (operation: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    integrationNotConnected: (provider: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    subscriptionRequired: (feature: string, requiredTier: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+};
+declare class VasperaApiError extends Error {
+    readonly errorDef: ErrorDefinition;
+    readonly details?: Record<string, unknown>;
+    constructor(errorDef: ErrorDefinition, details?: Record<string, unknown>);
+    toResponse(requestId?: string): {
+        response: ErrorResponse;
+        status: number;
+    };
+}
+
+export { type ErrorCodeType, ErrorCodes, type ErrorDefinition, type ErrorResponse, Errors, VasperaApiError, type VasperaError, createError, createErrorResponse };

package/dist/errors/index.d.ts

@@ -0,0 +1,288 @@
+interface ErrorDefinition {
+    code: string;
+    message: string;
+    httpStatus: number;
+}
+declare const ErrorCodes: {
+    readonly AUTH: {
+        readonly REQUIRED: {
+            readonly code: "VPM-AUTH-001";
+            readonly message: "Authentication required";
+            readonly httpStatus: 401;
+        };
+        readonly INVALID_TOKEN: {
+            readonly code: "VPM-AUTH-002";
+            readonly message: "Invalid or expired authentication token";
+            readonly httpStatus: 401;
+        };
+        readonly INSUFFICIENT_PERMISSIONS: {
+            readonly code: "VPM-AUTH-003";
+            readonly message: "Insufficient permissions for this action";
+            readonly httpStatus: 403;
+        };
+        readonly SESSION_EXPIRED: {
+            readonly code: "VPM-AUTH-004";
+            readonly message: "Session has expired, please login again";
+            readonly httpStatus: 401;
+        };
+        readonly MFA_REQUIRED: {
+            readonly code: "VPM-AUTH-005";
+            readonly message: "Multi-factor authentication required";
+            readonly httpStatus: 403;
+        };
+    };
+    readonly API_KEY: {
+        readonly REQUIRED: {
+            readonly code: "VPM-API-KEY-001";
+            readonly message: "API key is required";
+            readonly httpStatus: 401;
+        };
+        readonly INVALID: {
+            readonly code: "VPM-API-KEY-002";
+            readonly message: "Invalid API key";
+            readonly httpStatus: 401;
+        };
+        readonly REVOKED: {
+            readonly code: "VPM-API-KEY-003";
+            readonly message: "API key has been revoked";
+            readonly httpStatus: 401;
+        };
+        readonly EXPIRED: {
+            readonly code: "VPM-API-KEY-004";
+            readonly message: "API key has expired";
+            readonly httpStatus: 401;
+        };
+        readonly RATE_LIMITED: {
+            readonly code: "VPM-API-KEY-005";
+            readonly message: "API key rate limit exceeded";
+            readonly httpStatus: 429;
+        };
+        readonly QUOTA_EXCEEDED: {
+            readonly code: "VPM-API-KEY-006";
+            readonly message: "Monthly usage quota exceeded";
+            readonly httpStatus: 429;
+        };
+    };
+    readonly MCP: {
+        readonly TOOL_NOT_FOUND: {
+            readonly code: "VPM-MCP-001";
+            readonly message: "Requested tool not found";
+            readonly httpStatus: 404;
+        };
+        readonly INVALID_ARGUMENTS: {
+            readonly code: "VPM-MCP-002";
+            readonly message: "Invalid tool arguments provided";
+            readonly httpStatus: 400;
+        };
+        readonly EXECUTION_FAILED: {
+            readonly code: "VPM-MCP-003";
+            readonly message: "Tool execution failed";
+            readonly httpStatus: 500;
+        };
+        readonly TIMEOUT: {
+            readonly code: "VPM-MCP-004";
+            readonly message: "Tool execution timed out";
+            readonly httpStatus: 504;
+        };
+        readonly LLM_ERROR: {
+            readonly code: "VPM-MCP-005";
+            readonly message: "AI model returned an error";
+            readonly httpStatus: 502;
+        };
+        readonly CONTEXT_TOO_LARGE: {
+            readonly code: "VPM-MCP-006";
+            readonly message: "Input context exceeds maximum size";
+            readonly httpStatus: 413;
+        };
+    };
+    readonly BILLING: {
+        readonly NO_SUBSCRIPTION: {
+            readonly code: "VPM-BILLING-001";
+            readonly message: "No active subscription found";
+            readonly httpStatus: 402;
+        };
+        readonly SUBSCRIPTION_EXPIRED: {
+            readonly code: "VPM-BILLING-002";
+            readonly message: "Subscription has expired";
+            readonly httpStatus: 402;
+        };
+        readonly PAYMENT_FAILED: {
+            readonly code: "VPM-BILLING-003";
+            readonly message: "Payment processing failed";
+            readonly httpStatus: 402;
+        };
+        readonly FEATURE_NOT_INCLUDED: {
+            readonly code: "VPM-BILLING-004";
+            readonly message: "Feature not included in current plan";
+            readonly httpStatus: 403;
+        };
+        readonly UPGRADE_REQUIRED: {
+            readonly code: "VPM-BILLING-005";
+            readonly message: "Plan upgrade required for this action";
+            readonly httpStatus: 403;
+        };
+    };
+    readonly INTEGRATION: {
+        readonly NOT_CONNECTED: {
+            readonly code: "VPM-INT-001";
+            readonly message: "Integration not connected";
+            readonly httpStatus: 400;
+        };
+        readonly TOKEN_EXPIRED: {
+            readonly code: "VPM-INT-002";
+            readonly message: "Integration token expired, reconnection required";
+            readonly httpStatus: 401;
+        };
+        readonly REFRESH_FAILED: {
+            readonly code: "VPM-INT-003";
+            readonly message: "Failed to refresh integration token";
+            readonly httpStatus: 502;
+        };
+        readonly API_ERROR: {
+            readonly code: "VPM-INT-004";
+            readonly message: "External integration API error";
+            readonly httpStatus: 502;
+        };
+        readonly RATE_LIMITED: {
+            readonly code: "VPM-INT-005";
+            readonly message: "Integration rate limit exceeded";
+            readonly httpStatus: 429;
+        };
+    };
+    readonly VALIDATION: {
+        readonly REQUIRED_FIELD: {
+            readonly code: "VPM-VAL-001";
+            readonly message: "Required field missing";
+            readonly httpStatus: 400;
+        };
+        readonly INVALID_FORMAT: {
+            readonly code: "VPM-VAL-002";
+            readonly message: "Invalid field format";
+            readonly httpStatus: 400;
+        };
+        readonly OUT_OF_RANGE: {
+            readonly code: "VPM-VAL-003";
+            readonly message: "Value out of allowed range";
+            readonly httpStatus: 400;
+        };
+        readonly INVALID_JSON: {
+            readonly code: "VPM-VAL-004";
+            readonly message: "Invalid JSON in request body";
+            readonly httpStatus: 400;
+        };
+    };
+    readonly SYSTEM: {
+        readonly INTERNAL_ERROR: {
+            readonly code: "VPM-SYS-001";
+            readonly message: "Internal server error";
+            readonly httpStatus: 500;
+        };
+        readonly DATABASE_ERROR: {
+            readonly code: "VPM-SYS-002";
+            readonly message: "Database operation failed";
+            readonly httpStatus: 500;
+        };
+        readonly SERVICE_UNAVAILABLE: {
+            readonly code: "VPM-SYS-003";
+            readonly message: "Service temporarily unavailable";
+            readonly httpStatus: 503;
+        };
+        readonly MAINTENANCE_MODE: {
+            readonly code: "VPM-SYS-004";
+            readonly message: "System is under maintenance";
+            readonly httpStatus: 503;
+        };
+    };
+};
+type ErrorCodeType = (typeof ErrorCodes)[keyof typeof ErrorCodes][keyof (typeof ErrorCodes)[keyof typeof ErrorCodes]];
+
+interface VasperaError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+    timestamp: string;
+    requestId: string;
+    docUrl?: string;
+}
+interface ErrorResponse {
+    success: false;
+    error: VasperaError;
+}
+declare function createError(errorDef: ErrorDefinition, details?: Record<string, unknown>, requestId?: string): VasperaError;
+declare function createErrorResponse(errorDef: ErrorDefinition, details?: Record<string, unknown>, requestId?: string): {
+    response: ErrorResponse;
+    status: number;
+};
+declare const Errors: {
+    authRequired: (requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    invalidApiKey: (requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    apiKeyRevoked: (requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    apiKeyExpired: (requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    rateLimited: (retryAfter: number, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    quotaExceeded: (currentUsage: number, limit: number, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    toolNotFound: (toolName: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    toolExecutionFailed: (toolName: string, reason: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    toolTimeout: (toolName: string, timeoutMs: number, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    validationFailed: (field: string, reason: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    invalidFormat: (field: string, expected: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    internalError: (message?: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    databaseError: (operation: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    integrationNotConnected: (provider: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+    subscriptionRequired: (feature: string, requiredTier: string, requestId?: string) => {
+        response: ErrorResponse;
+        status: number;
+    };
+};
+declare class VasperaApiError extends Error {
+    readonly errorDef: ErrorDefinition;
+    readonly details?: Record<string, unknown>;
+    constructor(errorDef: ErrorDefinition, details?: Record<string, unknown>);
+    toResponse(requestId?: string): {
+        response: ErrorResponse;
+        status: number;
+    };
+}
+
+export { type ErrorCodeType, ErrorCodes, type ErrorDefinition, type ErrorResponse, Errors, VasperaApiError, type VasperaError, createError, createErrorResponse };