@parsrun/core 0.1.0

package/dist/error-codes.js

@@ -0,0 +1,261 @@
+// src/error-codes.ts
+var ErrorCodes = {
+  // ============================================================================
+  // Authentication Errors (401, 403, 423)
+  // ============================================================================
+  AUTH_ERROR: {
+    code: "AUTH_ERROR",
+    status: 401,
+    category: "auth"
+  },
+  UNAUTHORIZED: {
+    code: "UNAUTHORIZED",
+    status: 401,
+    category: "auth"
+  },
+  FORBIDDEN: {
+    code: "FORBIDDEN",
+    status: 403,
+    category: "auth"
+  },
+  INVALID_CREDENTIALS: {
+    code: "INVALID_CREDENTIALS",
+    status: 401,
+    category: "auth"
+  },
+  SESSION_EXPIRED: {
+    code: "SESSION_EXPIRED",
+    status: 401,
+    category: "auth"
+  },
+  TOKEN_EXPIRED: {
+    code: "TOKEN_EXPIRED",
+    status: 401,
+    category: "auth"
+  },
+  TOKEN_INVALID: {
+    code: "TOKEN_INVALID",
+    status: 401,
+    category: "auth"
+  },
+  TWO_FACTOR_REQUIRED: {
+    code: "TWO_FACTOR_REQUIRED",
+    status: 403,
+    category: "auth"
+  },
+  TWO_FACTOR_INVALID: {
+    code: "TWO_FACTOR_INVALID",
+    status: 401,
+    category: "auth"
+  },
+  ACCOUNT_LOCKED: {
+    code: "ACCOUNT_LOCKED",
+    status: 423,
+    category: "auth"
+  },
+  ACCOUNT_DISABLED: {
+    code: "ACCOUNT_DISABLED",
+    status: 403,
+    category: "auth"
+  },
+  PASSWORD_RESET_REQUIRED: {
+    code: "PASSWORD_RESET_REQUIRED",
+    status: 403,
+    category: "auth"
+  },
+  // ============================================================================
+  // Tenant Errors (400, 403, 404)
+  // ============================================================================
+  TENANT_ERROR: {
+    code: "TENANT_ERROR",
+    status: 400,
+    category: "tenant"
+  },
+  TENANT_NOT_FOUND: {
+    code: "TENANT_NOT_FOUND",
+    status: 404,
+    category: "tenant"
+  },
+  TENANT_SUSPENDED: {
+    code: "TENANT_SUSPENDED",
+    status: 403,
+    category: "tenant"
+  },
+  TENANT_LIMIT_EXCEEDED: {
+    code: "TENANT_LIMIT_EXCEEDED",
+    status: 403,
+    category: "tenant"
+  },
+  MEMBERSHIP_ERROR: {
+    code: "MEMBERSHIP_ERROR",
+    status: 400,
+    category: "tenant"
+  },
+  MEMBERSHIP_NOT_FOUND: {
+    code: "MEMBERSHIP_NOT_FOUND",
+    status: 404,
+    category: "tenant"
+  },
+  MEMBERSHIP_EXPIRED: {
+    code: "MEMBERSHIP_EXPIRED",
+    status: 403,
+    category: "tenant"
+  },
+  // ============================================================================
+  // Validation Errors (400, 422)
+  // ============================================================================
+  VALIDATION_ERROR: {
+    code: "VALIDATION_ERROR",
+    status: 400,
+    category: "validation"
+  },
+  BAD_REQUEST: {
+    code: "BAD_REQUEST",
+    status: 400,
+    category: "validation"
+  },
+  INVALID_INPUT: {
+    code: "INVALID_INPUT",
+    status: 422,
+    category: "validation"
+  },
+  MISSING_REQUIRED_FIELD: {
+    code: "MISSING_REQUIRED_FIELD",
+    status: 400,
+    category: "validation"
+  },
+  INVALID_FORMAT: {
+    code: "INVALID_FORMAT",
+    status: 400,
+    category: "validation"
+  },
+  // ============================================================================
+  // Resource Errors (404, 409, 410)
+  // ============================================================================
+  NOT_FOUND: {
+    code: "NOT_FOUND",
+    status: 404,
+    category: "resource"
+  },
+  CONFLICT: {
+    code: "CONFLICT",
+    status: 409,
+    category: "resource"
+  },
+  DUPLICATE: {
+    code: "DUPLICATE",
+    status: 409,
+    category: "resource"
+  },
+  GONE: {
+    code: "GONE",
+    status: 410,
+    category: "resource"
+  },
+  RESOURCE_LOCKED: {
+    code: "RESOURCE_LOCKED",
+    status: 423,
+    category: "resource"
+  },
+  // ============================================================================
+  // Rate Limiting (429)
+  // ============================================================================
+  RATE_LIMIT_EXCEEDED: {
+    code: "RATE_LIMIT_EXCEEDED",
+    status: 429,
+    category: "rate_limit",
+    retryable: true
+  },
+  QUOTA_EXCEEDED: {
+    code: "QUOTA_EXCEEDED",
+    status: 429,
+    category: "rate_limit"
+  },
+  // ============================================================================
+  // Server Errors (500, 502, 503, 504)
+  // ============================================================================
+  INTERNAL_ERROR: {
+    code: "INTERNAL_ERROR",
+    status: 500,
+    category: "server"
+  },
+  BAD_GATEWAY: {
+    code: "BAD_GATEWAY",
+    status: 502,
+    category: "server",
+    retryable: true
+  },
+  SERVICE_UNAVAILABLE: {
+    code: "SERVICE_UNAVAILABLE",
+    status: 503,
+    category: "server",
+    retryable: true
+  },
+  GATEWAY_TIMEOUT: {
+    code: "GATEWAY_TIMEOUT",
+    status: 504,
+    category: "server",
+    retryable: true
+  },
+  // ============================================================================
+  // Database Errors (500)
+  // ============================================================================
+  DATABASE_ERROR: {
+    code: "DATABASE_ERROR",
+    status: 500,
+    category: "database"
+  },
+  CONNECTION_ERROR: {
+    code: "CONNECTION_ERROR",
+    status: 503,
+    category: "database",
+    retryable: true
+  },
+  TRANSACTION_ERROR: {
+    code: "TRANSACTION_ERROR",
+    status: 500,
+    category: "database"
+  },
+  RLS_ERROR: {
+    code: "RLS_ERROR",
+    status: 500,
+    category: "database"
+  },
+  // ============================================================================
+  // External Service Errors (502, 503)
+  // ============================================================================
+  EXTERNAL_SERVICE_ERROR: {
+    code: "EXTERNAL_SERVICE_ERROR",
+    status: 502,
+    category: "external",
+    retryable: true
+  },
+  EXTERNAL_TIMEOUT: {
+    code: "EXTERNAL_TIMEOUT",
+    status: 504,
+    category: "external",
+    retryable: true
+  }
+};
+function getErrorCode(code) {
+  return ErrorCodes[code];
+}
+function getErrorCodesByCategory(category) {
+  return Object.values(ErrorCodes).filter((e) => e.category === category);
+}
+function isRetryableError(code) {
+  const errorCode = getErrorCode(code);
+  return errorCode?.retryable === true;
+}
+function getStatusForCode(code) {
+  const errorCode = getErrorCode(code);
+  return errorCode?.status ?? 500;
+}
+export {
+  ErrorCodes,
+  getErrorCode,
+  getErrorCodesByCategory,
+  getStatusForCode,
+  isRetryableError
+};
+//# sourceMappingURL=error-codes.js.map

package/dist/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/error-codes.ts"],"sourcesContent":["/**\n * @parsrun/core - Error Code Catalog\n * Centralized error code definitions for the entire framework\n */\n\n/**\n * Error category for grouping and filtering\n */\nexport type ErrorCategory =\n  | \"auth\"\n  | \"tenant\"\n  | \"validation\"\n  | \"resource\"\n  | \"rate_limit\"\n  | \"server\"\n  | \"database\"\n  | \"external\";\n\n/**\n * Error code definition\n */\nexport interface ErrorCodeDefinition {\n  readonly code: string;\n  readonly status: number;\n  readonly category: ErrorCategory;\n  readonly retryable?: boolean;\n}\n\n/**\n * Centralized error code catalog\n * All error codes used throughout the framework are defined here\n */\nexport const ErrorCodes = {\n  // ============================================================================\n  // Authentication Errors (401, 403, 423)\n  // ============================================================================\n  AUTH_ERROR: {\n    code: \"AUTH_ERROR\",\n    status: 401,\n    category: \"auth\",\n  },\n  UNAUTHORIZED: {\n    code: \"UNAUTHORIZED\",\n    status: 401,\n    category: \"auth\",\n  },\n  FORBIDDEN: {\n    code: \"FORBIDDEN\",\n    status: 403,\n    category: \"auth\",\n  },\n  INVALID_CREDENTIALS: {\n    code: \"INVALID_CREDENTIALS\",\n    status: 401,\n    category: \"auth\",\n  },\n  SESSION_EXPIRED: {\n    code: \"SESSION_EXPIRED\",\n    status: 401,\n    category: \"auth\",\n  },\n  TOKEN_EXPIRED: {\n    code: \"TOKEN_EXPIRED\",\n    status: 401,\n    category: \"auth\",\n  },\n  TOKEN_INVALID: {\n    code: \"TOKEN_INVALID\",\n    status: 401,\n    category: \"auth\",\n  },\n  TWO_FACTOR_REQUIRED: {\n    code: \"TWO_FACTOR_REQUIRED\",\n    status: 403,\n    category: \"auth\",\n  },\n  TWO_FACTOR_INVALID: {\n    code: \"TWO_FACTOR_INVALID\",\n    status: 401,\n    category: \"auth\",\n  },\n  ACCOUNT_LOCKED: {\n    code: \"ACCOUNT_LOCKED\",\n    status: 423,\n    category: \"auth\",\n  },\n  ACCOUNT_DISABLED: {\n    code: \"ACCOUNT_DISABLED\",\n    status: 403,\n    category: \"auth\",\n  },\n  PASSWORD_RESET_REQUIRED: {\n    code: \"PASSWORD_RESET_REQUIRED\",\n    status: 403,\n    category: \"auth\",\n  },\n\n  // ============================================================================\n  // Tenant Errors (400, 403, 404)\n  // ============================================================================\n  TENANT_ERROR: {\n    code: \"TENANT_ERROR\",\n    status: 400,\n    category: \"tenant\",\n  },\n  TENANT_NOT_FOUND: {\n    code: \"TENANT_NOT_FOUND\",\n    status: 404,\n    category: \"tenant\",\n  },\n  TENANT_SUSPENDED: {\n    code: \"TENANT_SUSPENDED\",\n    status: 403,\n    category: \"tenant\",\n  },\n  TENANT_LIMIT_EXCEEDED: {\n    code: \"TENANT_LIMIT_EXCEEDED\",\n    status: 403,\n    category: \"tenant\",\n  },\n  MEMBERSHIP_ERROR: {\n    code: \"MEMBERSHIP_ERROR\",\n    status: 400,\n    category: \"tenant\",\n  },\n  MEMBERSHIP_NOT_FOUND: {\n    code: \"MEMBERSHIP_NOT_FOUND\",\n    status: 404,\n    category: \"tenant\",\n  },\n  MEMBERSHIP_EXPIRED: {\n    code: \"MEMBERSHIP_EXPIRED\",\n    status: 403,\n    category: \"tenant\",\n  },\n\n  // ============================================================================\n  // Validation Errors (400, 422)\n  // ============================================================================\n  VALIDATION_ERROR: {\n    code: \"VALIDATION_ERROR\",\n    status: 400,\n    category: \"validation\",\n  },\n  BAD_REQUEST: {\n    code: \"BAD_REQUEST\",\n    status: 400,\n    category: \"validation\",\n  },\n  INVALID_INPUT: {\n    code: \"INVALID_INPUT\",\n    status: 422,\n    category: \"validation\",\n  },\n  MISSING_REQUIRED_FIELD: {\n    code: \"MISSING_REQUIRED_FIELD\",\n    status: 400,\n    category: \"validation\",\n  },\n  INVALID_FORMAT: {\n    code: \"INVALID_FORMAT\",\n    status: 400,\n    category: \"validation\",\n  },\n\n  // ============================================================================\n  // Resource Errors (404, 409, 410)\n  // ============================================================================\n  NOT_FOUND: {\n    code: \"NOT_FOUND\",\n    status: 404,\n    category: \"resource\",\n  },\n  CONFLICT: {\n    code: \"CONFLICT\",\n    status: 409,\n    category: \"resource\",\n  },\n  DUPLICATE: {\n    code: \"DUPLICATE\",\n    status: 409,\n    category: \"resource\",\n  },\n  GONE: {\n    code: \"GONE\",\n    status: 410,\n    category: \"resource\",\n  },\n  RESOURCE_LOCKED: {\n    code: \"RESOURCE_LOCKED\",\n    status: 423,\n    category: \"resource\",\n  },\n\n  // ============================================================================\n  // Rate Limiting (429)\n  // ============================================================================\n  RATE_LIMIT_EXCEEDED: {\n    code: \"RATE_LIMIT_EXCEEDED\",\n    status: 429,\n    category: \"rate_limit\",\n    retryable: true,\n  },\n  QUOTA_EXCEEDED: {\n    code: \"QUOTA_EXCEEDED\",\n    status: 429,\n    category: \"rate_limit\",\n  },\n\n  // ============================================================================\n  // Server Errors (500, 502, 503, 504)\n  // ============================================================================\n  INTERNAL_ERROR: {\n    code: \"INTERNAL_ERROR\",\n    status: 500,\n    category: \"server\",\n  },\n  BAD_GATEWAY: {\n    code: \"BAD_GATEWAY\",\n    status: 502,\n    category: \"server\",\n    retryable: true,\n  },\n  SERVICE_UNAVAILABLE: {\n    code: \"SERVICE_UNAVAILABLE\",\n    status: 503,\n    category: \"server\",\n    retryable: true,\n  },\n  GATEWAY_TIMEOUT: {\n    code: \"GATEWAY_TIMEOUT\",\n    status: 504,\n    category: \"server\",\n    retryable: true,\n  },\n\n  // ============================================================================\n  // Database Errors (500)\n  // ============================================================================\n  DATABASE_ERROR: {\n    code: \"DATABASE_ERROR\",\n    status: 500,\n    category: \"database\",\n  },\n  CONNECTION_ERROR: {\n    code: \"CONNECTION_ERROR\",\n    status: 503,\n    category: \"database\",\n    retryable: true,\n  },\n  TRANSACTION_ERROR: {\n    code: \"TRANSACTION_ERROR\",\n    status: 500,\n    category: \"database\",\n  },\n  RLS_ERROR: {\n    code: \"RLS_ERROR\",\n    status: 500,\n    category: \"database\",\n  },\n\n  // ============================================================================\n  // External Service Errors (502, 503)\n  // ============================================================================\n  EXTERNAL_SERVICE_ERROR: {\n    code: \"EXTERNAL_SERVICE_ERROR\",\n    status: 502,\n    category: \"external\",\n    retryable: true,\n  },\n  EXTERNAL_TIMEOUT: {\n    code: \"EXTERNAL_TIMEOUT\",\n    status: 504,\n    category: \"external\",\n    retryable: true,\n  },\n} as const;\n\n/**\n * Error code type (union of all error code keys)\n */\nexport type ErrorCode = keyof typeof ErrorCodes;\n\n/**\n * Get error code definition by code string\n */\nexport function getErrorCode(code: string): ErrorCodeDefinition | undefined {\n  return (ErrorCodes as Record<string, ErrorCodeDefinition>)[code];\n}\n\n/**\n * Get all error codes by category\n */\nexport function getErrorCodesByCategory(\n  category: ErrorCategory\n): ErrorCodeDefinition[] {\n  return Object.values(ErrorCodes).filter((e) => e.category === category);\n}\n\n/**\n * Check if an error code is retryable\n */\nexport function isRetryableError(code: string): boolean {\n  const errorCode = getErrorCode(code);\n  return errorCode?.retryable === true;\n}\n\n/**\n * Get HTTP status for an error code\n */\nexport function getStatusForCode(code: string): number {\n  const errorCode = getErrorCode(code);\n  return errorCode?.status ?? 500;\n}\n"],"mappings":"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","names":[]}

package/dist/errors.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @parsrun/core - Error Classes
+ */
+declare class ParsError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, statusCode?: number, details?: Record<string, unknown>);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        statusCode: number;
+        details: Record<string, unknown> | undefined;
+    };
+}
+declare class AuthError extends ParsError {
+    constructor(message: string, code?: string, statusCode?: number, details?: Record<string, unknown>);
+}
+declare class UnauthorizedError extends AuthError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class ForbiddenError extends AuthError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class InvalidCredentialsError extends AuthError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class SessionExpiredError extends AuthError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class TwoFactorRequiredError extends AuthError {
+    readonly challengeId: string;
+    constructor(message: string | undefined, challengeId: string, details?: Record<string, unknown>);
+}
+declare class AccountLockedError extends AuthError {
+    readonly lockedUntil?: Date | undefined;
+    constructor(message?: string, lockedUntil?: Date | undefined, details?: Record<string, unknown>);
+}
+declare class TenantError extends ParsError {
+    constructor(message: string, code?: string, statusCode?: number, details?: Record<string, unknown>);
+}
+declare class TenantNotFoundError extends TenantError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class TenantSuspendedError extends TenantError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class MembershipError extends TenantError {
+    constructor(message?: string, code?: string, statusCode?: number, details?: Record<string, unknown>);
+}
+declare class MembershipNotFoundError extends MembershipError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class MembershipExpiredError extends MembershipError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class ValidationError extends ParsError {
+    readonly errors: ValidationErrorDetail[];
+    constructor(message: string | undefined, errors: ValidationErrorDetail[], details?: Record<string, unknown>);
+}
+interface ValidationErrorDetail {
+    field: string;
+    message: string;
+    code?: string;
+}
+declare class RateLimitError extends ParsError {
+    readonly retryAfter?: number | undefined;
+    constructor(message?: string, retryAfter?: number | undefined, details?: Record<string, unknown>);
+}
+declare class NotFoundError extends ParsError {
+    constructor(resource?: string, message?: string, details?: Record<string, unknown>);
+}
+declare class ConflictError extends ParsError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+declare class DuplicateError extends ConflictError {
+    constructor(resource?: string, field?: string, details?: Record<string, unknown>);
+}
+
+export { AccountLockedError, AuthError, ConflictError, DuplicateError, ForbiddenError, InvalidCredentialsError, MembershipError, MembershipExpiredError, MembershipNotFoundError, NotFoundError, ParsError, RateLimitError, SessionExpiredError, TenantError, TenantNotFoundError, TenantSuspendedError, TwoFactorRequiredError, UnauthorizedError, ValidationError, type ValidationErrorDetail };

package/dist/errors.js

@@ -0,0 +1,161 @@
+// src/errors.ts
+var ParsError = class extends Error {
+  code;
+  statusCode;
+  details;
+  constructor(message, code, statusCode = 500, details) {
+    super(message);
+    this.name = "ParsError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.details = details ?? void 0;
+    Error.captureStackTrace?.(this, this.constructor);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      statusCode: this.statusCode,
+      details: this.details
+    };
+  }
+};
+var AuthError = class extends ParsError {
+  constructor(message, code = "AUTH_ERROR", statusCode = 401, details) {
+    super(message, code, statusCode, details);
+    this.name = "AuthError";
+  }
+};
+var UnauthorizedError = class extends AuthError {
+  constructor(message = "Unauthorized", details) {
+    super(message, "UNAUTHORIZED", 401, details);
+    this.name = "UnauthorizedError";
+  }
+};
+var ForbiddenError = class extends AuthError {
+  constructor(message = "Forbidden", details) {
+    super(message, "FORBIDDEN", 403, details);
+    this.name = "ForbiddenError";
+  }
+};
+var InvalidCredentialsError = class extends AuthError {
+  constructor(message = "Invalid credentials", details) {
+    super(message, "INVALID_CREDENTIALS", 401, details);
+    this.name = "InvalidCredentialsError";
+  }
+};
+var SessionExpiredError = class extends AuthError {
+  constructor(message = "Session expired", details) {
+    super(message, "SESSION_EXPIRED", 401, details);
+    this.name = "SessionExpiredError";
+  }
+};
+var TwoFactorRequiredError = class extends AuthError {
+  constructor(message = "Two-factor authentication required", challengeId, details) {
+    super(message, "TWO_FACTOR_REQUIRED", 403, { ...details, challengeId });
+    this.challengeId = challengeId;
+    this.name = "TwoFactorRequiredError";
+  }
+};
+var AccountLockedError = class extends AuthError {
+  constructor(message = "Account locked", lockedUntil, details) {
+    super(message, "ACCOUNT_LOCKED", 423, { ...details, lockedUntil });
+    this.lockedUntil = lockedUntil;
+    this.name = "AccountLockedError";
+  }
+};
+var TenantError = class extends ParsError {
+  constructor(message, code = "TENANT_ERROR", statusCode = 400, details) {
+    super(message, code, statusCode, details);
+    this.name = "TenantError";
+  }
+};
+var TenantNotFoundError = class extends TenantError {
+  constructor(message = "Tenant not found", details) {
+    super(message, "TENANT_NOT_FOUND", 404, details);
+    this.name = "TenantNotFoundError";
+  }
+};
+var TenantSuspendedError = class extends TenantError {
+  constructor(message = "Tenant suspended", details) {
+    super(message, "TENANT_SUSPENDED", 403, details);
+    this.name = "TenantSuspendedError";
+  }
+};
+var MembershipError = class extends TenantError {
+  constructor(message = "Membership error", code = "MEMBERSHIP_ERROR", statusCode = 400, details) {
+    super(message, code, statusCode, details);
+    this.name = "MembershipError";
+  }
+};
+var MembershipNotFoundError = class extends MembershipError {
+  constructor(message = "Membership not found", details) {
+    super(message, "MEMBERSHIP_NOT_FOUND", 404, details);
+    this.name = "MembershipNotFoundError";
+  }
+};
+var MembershipExpiredError = class extends MembershipError {
+  constructor(message = "Membership expired", details) {
+    super(message, "MEMBERSHIP_EXPIRED", 403, details);
+    this.name = "MembershipExpiredError";
+  }
+};
+var ValidationError = class extends ParsError {
+  constructor(message = "Validation failed", errors, details) {
+    super(message, "VALIDATION_ERROR", 400, { ...details, errors });
+    this.errors = errors;
+    this.name = "ValidationError";
+  }
+};
+var RateLimitError = class extends ParsError {
+  constructor(message = "Rate limit exceeded", retryAfter, details) {
+    super(message, "RATE_LIMIT_EXCEEDED", 429, { ...details, retryAfter });
+    this.retryAfter = retryAfter;
+    this.name = "RateLimitError";
+  }
+};
+var NotFoundError = class extends ParsError {
+  constructor(resource = "Resource", message, details) {
+    super(message ?? `${resource} not found`, "NOT_FOUND", 404, { ...details, resource });
+    this.name = "NotFoundError";
+  }
+};
+var ConflictError = class extends ParsError {
+  constructor(message = "Conflict", details) {
+    super(message, "CONFLICT", 409, details);
+    this.name = "ConflictError";
+  }
+};
+var DuplicateError = class extends ConflictError {
+  constructor(resource = "Resource", field, details) {
+    super(`${resource} already exists${field ? ` with this ${field}` : ""}`, {
+      ...details,
+      resource,
+      field
+    });
+    this.name = "DuplicateError";
+  }
+};
+export {
+  AccountLockedError,
+  AuthError,
+  ConflictError,
+  DuplicateError,
+  ForbiddenError,
+  InvalidCredentialsError,
+  MembershipError,
+  MembershipExpiredError,
+  MembershipNotFoundError,
+  NotFoundError,
+  ParsError,
+  RateLimitError,
+  SessionExpiredError,
+  TenantError,
+  TenantNotFoundError,
+  TenantSuspendedError,
+  TwoFactorRequiredError,
+  UnauthorizedError,
+  ValidationError
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["/**\n * @parsrun/core - Error Classes\n */\n\nexport class ParsError extends Error {\n  public readonly code: string;\n  public readonly statusCode: number;\n  public readonly details: Record<string, unknown> | undefined;\n\n  constructor(\n    message: string,\n    code: string,\n    statusCode: number = 500,\n    details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = \"ParsError\";\n    this.code = code;\n    this.statusCode = statusCode;\n    this.details = details ?? undefined;\n    Error.captureStackTrace?.(this, this.constructor);\n  }\n\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      statusCode: this.statusCode,\n      details: this.details,\n    };\n  }\n}\n\n// ============================================\n// AUTH ERRORS\n// ============================================\n\nexport class AuthError extends ParsError {\n  constructor(\n    message: string,\n    code: string = \"AUTH_ERROR\",\n    statusCode: number = 401,\n    details?: Record<string, unknown>\n  ) {\n    super(message, code, statusCode, details);\n    this.name = \"AuthError\";\n  }\n}\n\nexport class UnauthorizedError extends AuthError {\n  constructor(message: string = \"Unauthorized\", details?: Record<string, unknown>) {\n    super(message, \"UNAUTHORIZED\", 401, details);\n    this.name = \"UnauthorizedError\";\n  }\n}\n\nexport class ForbiddenError extends AuthError {\n  constructor(message: string = \"Forbidden\", details?: Record<string, unknown>) {\n    super(message, \"FORBIDDEN\", 403, details);\n    this.name = \"ForbiddenError\";\n  }\n}\n\nexport class InvalidCredentialsError extends AuthError {\n  constructor(message: string = \"Invalid credentials\", details?: Record<string, unknown>) {\n    super(message, \"INVALID_CREDENTIALS\", 401, details);\n    this.name = \"InvalidCredentialsError\";\n  }\n}\n\nexport class SessionExpiredError extends AuthError {\n  constructor(message: string = \"Session expired\", details?: Record<string, unknown>) {\n    super(message, \"SESSION_EXPIRED\", 401, details);\n    this.name = \"SessionExpiredError\";\n  }\n}\n\nexport class TwoFactorRequiredError extends AuthError {\n  constructor(\n    message: string = \"Two-factor authentication required\",\n    public readonly challengeId: string,\n    details?: Record<string, unknown>\n  ) {\n    super(message, \"TWO_FACTOR_REQUIRED\", 403, { ...details, challengeId });\n    this.name = \"TwoFactorRequiredError\";\n  }\n}\n\nexport class AccountLockedError extends AuthError {\n  constructor(\n    message: string = \"Account locked\",\n    public readonly lockedUntil?: Date,\n    details?: Record<string, unknown>\n  ) {\n    super(message, \"ACCOUNT_LOCKED\", 423, { ...details, lockedUntil });\n    this.name = \"AccountLockedError\";\n  }\n}\n\n// ============================================\n// TENANT ERRORS\n// ============================================\n\nexport class TenantError extends ParsError {\n  constructor(\n    message: string,\n    code: string = \"TENANT_ERROR\",\n    statusCode: number = 400,\n    details?: Record<string, unknown>\n  ) {\n    super(message, code, statusCode, details);\n    this.name = \"TenantError\";\n  }\n}\n\nexport class TenantNotFoundError extends TenantError {\n  constructor(message: string = \"Tenant not found\", details?: Record<string, unknown>) {\n    super(message, \"TENANT_NOT_FOUND\", 404, details);\n    this.name = \"TenantNotFoundError\";\n  }\n}\n\nexport class TenantSuspendedError extends TenantError {\n  constructor(message: string = \"Tenant suspended\", details?: Record<string, unknown>) {\n    super(message, \"TENANT_SUSPENDED\", 403, details);\n    this.name = \"TenantSuspendedError\";\n  }\n}\n\nexport class MembershipError extends TenantError {\n  constructor(\n    message: string = \"Membership error\",\n    code: string = \"MEMBERSHIP_ERROR\",\n    statusCode: number = 400,\n    details?: Record<string, unknown>\n  ) {\n    super(message, code, statusCode, details);\n    this.name = \"MembershipError\";\n  }\n}\n\nexport class MembershipNotFoundError extends MembershipError {\n  constructor(message: string = \"Membership not found\", details?: Record<string, unknown>) {\n    super(message, \"MEMBERSHIP_NOT_FOUND\", 404, details);\n    this.name = \"MembershipNotFoundError\";\n  }\n}\n\nexport class MembershipExpiredError extends MembershipError {\n  constructor(message: string = \"Membership expired\", details?: Record<string, unknown>) {\n    super(message, \"MEMBERSHIP_EXPIRED\", 403, details);\n    this.name = \"MembershipExpiredError\";\n  }\n}\n\n// ============================================\n// VALIDATION ERRORS\n// ============================================\n\nexport class ValidationError extends ParsError {\n  constructor(\n    message: string = \"Validation failed\",\n    public readonly errors: ValidationErrorDetail[],\n    details?: Record<string, unknown>\n  ) {\n    super(message, \"VALIDATION_ERROR\", 400, { ...details, errors });\n    this.name = \"ValidationError\";\n  }\n}\n\nexport interface ValidationErrorDetail {\n  field: string;\n  message: string;\n  code?: string;\n}\n\n// ============================================\n// RATE LIMIT ERRORS\n// ============================================\n\nexport class RateLimitError extends ParsError {\n  constructor(\n    message: string = \"Rate limit exceeded\",\n    public readonly retryAfter?: number,\n    details?: Record<string, unknown>\n  ) {\n    super(message, \"RATE_LIMIT_EXCEEDED\", 429, { ...details, retryAfter });\n    this.name = \"RateLimitError\";\n  }\n}\n\n// ============================================\n// NOT FOUND ERRORS\n// ============================================\n\nexport class NotFoundError extends ParsError {\n  constructor(\n    resource: string = \"Resource\",\n    message?: string,\n    details?: Record<string, unknown>\n  ) {\n    super(message ?? `${resource} not found`, \"NOT_FOUND\", 404, { ...details, resource });\n    this.name = \"NotFoundError\";\n  }\n}\n\n// ============================================\n// CONFLICT ERRORS\n// ============================================\n\nexport class ConflictError extends ParsError {\n  constructor(message: string = \"Conflict\", details?: Record<string, unknown>) {\n    super(message, \"CONFLICT\", 409, details);\n    this.name = \"ConflictError\";\n  }\n}\n\nexport class DuplicateError extends ConflictError {\n  constructor(\n    resource: string = \"Resource\",\n    field?: string,\n    details?: Record<string, unknown>\n  ) {\n    super(`${resource} already exists${field ? ` with this ${field}` : \"\"}`, {\n      ...details,\n      resource,\n      field,\n    });\n    this.name = \"DuplicateError\";\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+export { Runtime, detectRuntime, getRuntimeVersion, isBrowser, isBun, isCloudflare, isDeno, isEdge, isNode, isServer, runtime, runtimeInfo } from './runtime.js';
+export { EnvMode, clearEdgeEnv, createEnvConfig, getEnv, getEnvArray, getEnvBoolean, getEnvFloat, getEnvJson, getEnvMode, getEnvNumber, isDevelopment, isProduction, isTest, requireEnv, setEdgeEnv } from './env.js';
+export { o as BaseTransportOptions, p as BatchTransportOptions, B as Breadcrumb, j as CombinedTransport, C as ConsoleTransport, k as ErrorContext, E as ErrorTransport, n as ErrorUser, g as LogEntry, a as LogLevel, e as LogLevelName, f as LogLevelValue, h as LogTransport, L as Logger, i as LoggerConfig, c as createLogger, d as createRequestLogger, b as logError, l as logger, m as measureTime } from './logger-aEibH9Mv.js';
+export { Decimal, DecimalUtils, decimal } from './decimal.js';
+export { AccessLevel, AuthContext, DeepPartial, IpRestrictions, MembershipPermissions, MembershipStatus, PaginatedResult, PaginationParams, Prettify, RequireAtLeastOne, ResourceRestrictions, Result, Session, Tenant, TenantMembership, TenantStatus, TimeRestrictions, User, err, ok } from './types.js';
+export { AccountLockedError, AuthError, ConflictError, DuplicateError, ForbiddenError, InvalidCredentialsError, MembershipError, MembershipExpiredError, MembershipNotFoundError, NotFoundError, ParsError, RateLimitError, SessionExpiredError, TenantError, TenantNotFoundError, TenantSuspendedError, TwoFactorRequiredError, UnauthorizedError, ValidationError, ValidationErrorDetail } from './errors.js';
+export { ErrorCategory, ErrorCode, ErrorCodeDefinition, ErrorCodes, getErrorCode, getErrorCodesByCategory, getStatusForCode, isRetryableError } from './error-codes.js';
+export { AxiomTransport, AxiomTransportOptions, LogtapeLogger, LogtapeTransport, LogtapeTransportOptions, SentryClient, SentryEvent, SentryTransport, SentryTransportOptions, createAxiomTransport, createLogtapeTransport, createSentryTransport } from './transports/index.js';
+
+/**
+ * @parsrun/core
+ * Core utilities and types for Pars framework
+ * Edge-compatible, zero dependencies
+ */
+
+/**
+ * Generate a cryptographically secure random string (hex)
+ */
+declare function generateRandomString(length: number): Promise<string>;
+/**
+ * Generate a UUID v4
+ */
+declare function generateId(): string;
+/**
+ * Hash a string using SHA-256
+ */
+declare function sha256(input: string): Promise<string>;
+/**
+ * Hash a string using SHA-256 and return as ArrayBuffer
+ */
+declare function sha256Bytes(input: string): Promise<ArrayBuffer>;
+/**
+ * Constant-time string comparison (timing-safe)
+ */
+declare function constantTimeEquals(a: string, b: string): boolean;
+/**
+ * Sleep for a given number of milliseconds
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff
+ */
+declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    shouldRetry?: (error: unknown) => boolean;
+    onRetry?: (error: unknown, attempt: number) => void;
+}): Promise<T>;
+/**
+ * Omit keys from an object
+ */
+declare function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/**
+ * Pick keys from an object
+ */
+declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Deep merge two objects
+ */
+declare function deepMerge<T extends object>(target: T, source: Partial<T>): T;
+/**
+ * Deep clone an object
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Check if a value is a plain object
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if value is null or undefined
+ */
+declare function isNil(value: unknown): value is null | undefined;
+/**
+ * Check if value is empty (null, undefined, empty string, empty array, empty object)
+ */
+declare function isEmpty(value: unknown): boolean;
+/**
+ * Normalize email address
+ */
+declare function normalizeEmail(email: string): string;
+/**
+ * Validate email format
+ */
+declare function isValidEmail(email: string): boolean;
+/**
+ * Generate a URL-friendly slug from a string
+ */
+declare function slugify(str: string): string;
+/**
+ * Truncate string to a maximum length
+ */
+declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/**
+ * Debounce a function
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle a function
+ */
+declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Create a deferred promise
+ */
+declare function createDeferred<T>(): {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason?: unknown) => void;
+};
+/**
+ * Run promises with concurrency limit
+ */
+declare function pLimit<T>(tasks: (() => Promise<T>)[], concurrency: number): Promise<T[]>;
+
+export { constantTimeEquals, createDeferred, debounce, deepClone, deepMerge, generateId, generateRandomString, isEmpty, isNil, isPlainObject, isValidEmail, normalizeEmail, omit, pLimit, pick, retry, sha256, sha256Bytes, sleep, slugify, throttle, truncate };