@vertz/errors 0.2.11 → 0.2.13

package/dist/index.d.ts

@@ -170,9 +170,164 @@ declare function isAuthValidationError(error: {
 	readonly code: string;
 }): error is AuthValidationError;
 /**
+* Session not found error.
+*
+* Returned when a session ID doesn't exist or doesn't belong to the user.
+*/
+interface SessionNotFoundError {
+	readonly code: "SESSION_NOT_FOUND";
+	readonly message: string;
+}
+/**
+* Creates a SessionNotFoundError.
+*/
+declare function createSessionNotFoundError(message?: string): SessionNotFoundError;
+/**
+* Type guard for SessionNotFoundError.
+*/
+declare function isSessionNotFoundError(error: {
+	readonly code: string;
+}): error is SessionNotFoundError;
+/**
+* OAuth error.
+*
+* Returned when an OAuth operation fails (provider not configured, invalid state, etc.).
+*/
+interface OAuthError {
+	readonly code: "OAUTH_ERROR";
+	readonly message: string;
+	readonly provider?: string;
+	readonly reason?: "provider_not_configured" | "invalid_state" | "token_exchange_failed" | "user_info_failed" | "account_already_linked" | "cannot_unlink_last_method";
+}
+/**
+* Creates an OAuthError.
+*/
+declare function createOAuthError(message: string, provider?: string, reason?: OAuthError["reason"]): OAuthError;
+/**
+* Type guard for OAuthError.
+*/
+declare function isOAuthError(error: {
+	readonly code: string;
+}): error is OAuthError;
+/**
+* MFA required error.
+*
+* Returned when sign-in succeeds but MFA verification is needed.
+*/
+interface MfaRequiredError {
+	readonly code: "MFA_REQUIRED";
+	readonly message: string;
+}
+/**
+* Creates an MfaRequiredError.
+*/
+declare function createMfaRequiredError(message?: string): MfaRequiredError;
+/**
+* Type guard for MfaRequiredError.
+*/
+declare function isMfaRequiredError(error: {
+	readonly code: string;
+}): error is MfaRequiredError;
+/**
+* MFA invalid code error.
+*
+* Returned when an MFA code (TOTP or backup) is incorrect.
+*/
+interface MfaInvalidCodeError {
+	readonly code: "MFA_INVALID_CODE";
+	readonly message: string;
+	readonly attemptsRemaining?: number;
+}
+/**
+* Creates an MfaInvalidCodeError.
+*/
+declare function createMfaInvalidCodeError(message?: string, attemptsRemaining?: number): MfaInvalidCodeError;
+/**
+* Type guard for MfaInvalidCodeError.
+*/
+declare function isMfaInvalidCodeError(error: {
+	readonly code: string;
+}): error is MfaInvalidCodeError;
+/**
+* MFA already enabled error.
+*
+* Returned when trying to enable MFA on an account that already has it.
+*/
+interface MfaAlreadyEnabledError {
+	readonly code: "MFA_ALREADY_ENABLED";
+	readonly message: string;
+}
+/**
+* Creates an MfaAlreadyEnabledError.
+*/
+declare function createMfaAlreadyEnabledError(message?: string): MfaAlreadyEnabledError;
+/**
+* Type guard for MfaAlreadyEnabledError.
+*/
+declare function isMfaAlreadyEnabledError(error: {
+	readonly code: string;
+}): error is MfaAlreadyEnabledError;
+/**
+* MFA not enabled error.
+*
+* Returned when trying to disable MFA or regenerate backup codes when MFA is not enabled.
+*/
+interface MfaNotEnabledError {
+	readonly code: "MFA_NOT_ENABLED";
+	readonly message: string;
+}
+/**
+* Creates an MfaNotEnabledError.
+*/
+declare function createMfaNotEnabledError(message?: string): MfaNotEnabledError;
+/**
+* Type guard for MfaNotEnabledError.
+*/
+declare function isMfaNotEnabledError(error: {
+	readonly code: string;
+}): error is MfaNotEnabledError;
+/**
+* Token expired error.
+*
+* Returned when a verification or reset token has expired.
+*/
+interface TokenExpiredError {
+	readonly code: "TOKEN_EXPIRED";
+	readonly message: string;
+}
+/**
+* Creates a TokenExpiredError.
+*/
+declare function createTokenExpiredError(message?: string): TokenExpiredError;
+/**
+* Type guard for TokenExpiredError.
+*/
+declare function isTokenExpiredError(error: {
+	readonly code: string;
+}): error is TokenExpiredError;
+/**
+* Token invalid error.
+*
+* Returned when a verification or reset token is invalid or not found.
+*/
+interface TokenInvalidError {
+	readonly code: "TOKEN_INVALID";
+	readonly message: string;
+}
+/**
+* Creates a TokenInvalidError.
+*/
+declare function createTokenInvalidError(message?: string): TokenInvalidError;
+/**
+* Type guard for TokenInvalidError.
+*/
+declare function isTokenInvalidError(error: {
+	readonly code: string;
+}): error is TokenInvalidError;
+/**
 * Union type for all auth errors.
 */
-type AuthError = InvalidCredentialsError | UserExistsError | SessionExpiredError | PermissionDeniedError | RateLimitedError | AuthValidationError;
+type AuthError = InvalidCredentialsError | UserExistsError | SessionExpiredError | SessionNotFoundError | PermissionDeniedError | RateLimitedError | AuthValidationError | OAuthError | MfaRequiredError | MfaInvalidCodeError | MfaAlreadyEnabledError | MfaNotEnabledError | TokenExpiredError | TokenInvalidError;
 /**
 * Client domain errors.
 *
@@ -1511,4 +1666,4 @@ type EntityErrorHandlers<R> = {
 */
 declare function matchError<R>(error: FetchErrorType, handlers: FetchErrorHandlers<R>): R;
 declare function matchError<R>(error: EntityErrorType, handlers: EntityErrorHandlers<R>): R;
-export { unwrapOr, unwrap, uniqueViolationToHttpStatus, ok, notNullViolationToHttpStatus, notFoundErrorToHttpStatus, matchError, matchErr, match, map, isUserExistsError, isUnknownError, isUniqueViolation, isUnauthorizedError, isSessionExpiredError, isServiceUnavailableError, isValidationError2 as isSchemaValidationError, isPermissionDeniedError, isParseError, isOk, isNotNullViolation, isMigrationQueryError, isMigrationHistoryNotFound, isMigrationChecksumMismatch, isMethodNotAllowedError, isInvalidCredentialsError, isInternalError, isHttpError, isForbiddenError, isFetchValidationError, isFetchUnprocessableEntityError, isFetchUnauthorizedError, isFetchTimeoutError, isFetchServiceUnavailableError, isFetchRateLimitError, isFetchNotFoundError, isFetchNetworkError, isFetchInternalServerError, isFetchGoneError, isFetchForbiddenError, isFetchConflictError, isFetchBadRequestError, isFKViolation, isErr, isEntityValidationError, isEntityUnauthorizedError, isEntityNotFoundError, isEntityForbiddenError, isEntityConflictError, isNotFoundError2 as isDBNotFoundError, isConflictError, isValidationError as isClientValidationError, isRateLimitedError2 as isClientRateLimitedError, isNotFoundError as isClientNotFoundError, isCheckViolation, isBadRequestError, isAuthValidationError, isRateLimitedError as isAuthRateLimitedError, httpToClientError, flatMap, fkViolationToHttpStatus, err, dbErrorToHttpStatus, createUserExistsError, createUniqueViolation, createUnauthorizedError, createSessionExpiredError, createValidationError2 as createSchemaValidationError, createPermissionDeniedError, createNotNullViolation, createMigrationQueryError, createMigrationHistoryNotFound, createMigrationChecksumMismatch, createInvalidCredentialsError, createHttpError, createForbiddenError, createFKViolation, createNotFoundError2 as createDBNotFoundError, createConflictError, createValidationError as createClientValidationError, createRateLimitedError2 as createClientRateLimitedError, createNotFoundError as createClientNotFoundError, createCheckViolation, createAuthValidationError, createRateLimitedError as createAuthRateLimitedError, checkViolationToHttpStatus, WriteError, ValidationIssue, UserExistsError, UnknownError, UniqueViolation, UnauthorizedError, TimeoutError2 as TimeoutError, SessionExpiredError, ServiceUnavailableError, SerializationError, ValidationError3 as SchemaValidationError, Result, ReadError, QueryError, PoolExhaustedError, PermissionDeniedError, ParseError2 as ParseError, Ok, NotNullViolation, NetworkError2 as NetworkError, MigrationQueryError, MigrationHistoryNotFound, MigrationError, MigrationChecksumMismatch, MethodNotAllowedError, InvalidCredentialsError, InternalError2 as InternalError, InfraErrors, InfraError, HttpError2 as HttpError, ForbiddenError, FetchValidationError, FetchUnprocessableEntityError, FetchUnauthorizedError, FetchTimeoutError, FetchServiceUnavailableError, FetchRateLimitError, FetchNotFoundError, FetchNetworkError, FetchInternalServerError, FetchGoneError, FetchForbiddenError, FetchErrorType, FetchError, FetchConflictError, FetchBadRequestError, FKViolation, Err, EntityValidationError, EntityUnauthorizedError, EntityNotFoundError, EntityForbiddenError, EntityErrorType, EntityError, EntityConflictError, NotFoundError2 as DBNotFoundError, ConnectionError, ConflictError, ValidationError2 as ClientValidationError, RateLimitedError2 as ClientRateLimitedError, NotFoundError as ClientNotFoundError, CheckViolation, BadRequestError, AuthValidationError, RateLimitedError as AuthRateLimitedError, AuthError, AppError, ApiError };
+export { unwrapOr, unwrap, uniqueViolationToHttpStatus, ok, notNullViolationToHttpStatus, notFoundErrorToHttpStatus, matchError, matchErr, match, map, isUserExistsError, isUnknownError, isUniqueViolation, isUnauthorizedError, isTokenInvalidError, isTokenExpiredError, isSessionNotFoundError, isSessionExpiredError, isServiceUnavailableError, isValidationError2 as isSchemaValidationError, isPermissionDeniedError, isParseError, isOk, isOAuthError, isNotNullViolation, isMigrationQueryError, isMigrationHistoryNotFound, isMigrationChecksumMismatch, isMfaRequiredError, isMfaNotEnabledError, isMfaInvalidCodeError, isMfaAlreadyEnabledError, isMethodNotAllowedError, isInvalidCredentialsError, isInternalError, isHttpError, isForbiddenError, isFetchValidationError, isFetchUnprocessableEntityError, isFetchUnauthorizedError, isFetchTimeoutError, isFetchServiceUnavailableError, isFetchRateLimitError, isFetchNotFoundError, isFetchNetworkError, isFetchInternalServerError, isFetchGoneError, isFetchForbiddenError, isFetchConflictError, isFetchBadRequestError, isFKViolation, isErr, isEntityValidationError, isEntityUnauthorizedError, isEntityNotFoundError, isEntityForbiddenError, isEntityConflictError, isNotFoundError2 as isDBNotFoundError, isConflictError, isValidationError as isClientValidationError, isRateLimitedError2 as isClientRateLimitedError, isNotFoundError as isClientNotFoundError, isCheckViolation, isBadRequestError, isAuthValidationError, isRateLimitedError as isAuthRateLimitedError, httpToClientError, flatMap, fkViolationToHttpStatus, err, dbErrorToHttpStatus, createUserExistsError, createUniqueViolation, createUnauthorizedError, createTokenInvalidError, createTokenExpiredError, createSessionNotFoundError, createSessionExpiredError, createValidationError2 as createSchemaValidationError, createPermissionDeniedError, createOAuthError, createNotNullViolation, createMigrationQueryError, createMigrationHistoryNotFound, createMigrationChecksumMismatch, createMfaRequiredError, createMfaNotEnabledError, createMfaInvalidCodeError, createMfaAlreadyEnabledError, createInvalidCredentialsError, createHttpError, createForbiddenError, createFKViolation, createNotFoundError2 as createDBNotFoundError, createConflictError, createValidationError as createClientValidationError, createRateLimitedError2 as createClientRateLimitedError, createNotFoundError as createClientNotFoundError, createCheckViolation, createAuthValidationError, createRateLimitedError as createAuthRateLimitedError, checkViolationToHttpStatus, WriteError, ValidationIssue, UserExistsError, UnknownError, UniqueViolation, UnauthorizedError, TokenInvalidError, TokenExpiredError, TimeoutError2 as TimeoutError, SessionNotFoundError, SessionExpiredError, ServiceUnavailableError, SerializationError, ValidationError3 as SchemaValidationError, Result, ReadError, QueryError, PoolExhaustedError, PermissionDeniedError, ParseError2 as ParseError, Ok, OAuthError, NotNullViolation, NetworkError2 as NetworkError, MigrationQueryError, MigrationHistoryNotFound, MigrationError, MigrationChecksumMismatch, MfaRequiredError, MfaNotEnabledError, MfaInvalidCodeError, MfaAlreadyEnabledError, MethodNotAllowedError, InvalidCredentialsError, InternalError2 as InternalError, InfraErrors, InfraError, HttpError2 as HttpError, ForbiddenError, FetchValidationError, FetchUnprocessableEntityError, FetchUnauthorizedError, FetchTimeoutError, FetchServiceUnavailableError, FetchRateLimitError, FetchNotFoundError, FetchNetworkError, FetchInternalServerError, FetchGoneError, FetchForbiddenError, FetchErrorType, FetchError, FetchConflictError, FetchBadRequestError, FKViolation, Err, EntityValidationError, EntityUnauthorizedError, EntityNotFoundError, EntityForbiddenError, EntityErrorType, EntityError, EntityConflictError, NotFoundError2 as DBNotFoundError, ConnectionError, ConflictError, ValidationError2 as ClientValidationError, RateLimitedError2 as ClientRateLimitedError, NotFoundError as ClientNotFoundError, CheckViolation, BadRequestError, AuthValidationError, RateLimitedError as AuthRateLimitedError, AuthError, AppError, ApiError };

package/dist/index.js

@@ -73,6 +73,81 @@ function createAuthValidationError(message, field, constraint) {
 function isAuthValidationError(error) {
   return error.code === "AUTH_VALIDATION_ERROR";
 }
+function createSessionNotFoundError(message = "Session not found") {
+  return {
+    code: "SESSION_NOT_FOUND",
+    message
+  };
+}
+function isSessionNotFoundError(error) {
+  return error.code === "SESSION_NOT_FOUND";
+}
+function createOAuthError(message, provider, reason) {
+  return {
+    code: "OAUTH_ERROR",
+    message,
+    provider,
+    reason
+  };
+}
+function isOAuthError(error) {
+  return error.code === "OAUTH_ERROR";
+}
+function createMfaRequiredError(message = "MFA verification required") {
+  return {
+    code: "MFA_REQUIRED",
+    message
+  };
+}
+function isMfaRequiredError(error) {
+  return error.code === "MFA_REQUIRED";
+}
+function createMfaInvalidCodeError(message = "Invalid MFA code", attemptsRemaining) {
+  return {
+    code: "MFA_INVALID_CODE",
+    message,
+    attemptsRemaining
+  };
+}
+function isMfaInvalidCodeError(error) {
+  return error.code === "MFA_INVALID_CODE";
+}
+function createMfaAlreadyEnabledError(message = "MFA is already enabled") {
+  return {
+    code: "MFA_ALREADY_ENABLED",
+    message
+  };
+}
+function isMfaAlreadyEnabledError(error) {
+  return error.code === "MFA_ALREADY_ENABLED";
+}
+function createMfaNotEnabledError(message = "MFA is not enabled") {
+  return {
+    code: "MFA_NOT_ENABLED",
+    message
+  };
+}
+function isMfaNotEnabledError(error) {
+  return error.code === "MFA_NOT_ENABLED";
+}
+function createTokenExpiredError(message = "Token has expired") {
+  return {
+    code: "TOKEN_EXPIRED",
+    message
+  };
+}
+function isTokenExpiredError(error) {
+  return error.code === "TOKEN_EXPIRED";
+}
+function createTokenInvalidError(message = "Invalid token") {
+  return {
+    code: "TOKEN_INVALID",
+    message
+  };
+}
+function isTokenInvalidError(error) {
+  return error.code === "TOKEN_INVALID";
+}
 // src/domain/client.ts
 function createValidationError(message, issues) {
   return {
@@ -819,16 +894,24 @@ export {
   isUnknownError,
   isUniqueViolation,
   isUnauthorizedError,
+  isTokenInvalidError,
+  isTokenExpiredError,
+  isSessionNotFoundError,
   isSessionExpiredError,
   isServiceUnavailableError,
   isValidationError2 as isSchemaValidationError,
   isPermissionDeniedError,
   isParseError,
   isOk,
+  isOAuthError,
   isNotNullViolation,
   isMigrationQueryError,
   isMigrationHistoryNotFound,
   isMigrationChecksumMismatch,
+  isMfaRequiredError,
+  isMfaNotEnabledError,
+  isMfaInvalidCodeError,
+  isMfaAlreadyEnabledError,
   isMethodNotAllowedError,
   isInvalidCredentialsError,
   isInternalError,
@@ -871,13 +954,21 @@ export {
   createUserExistsError,
   createUniqueViolation,
   createUnauthorizedError,
+  createTokenInvalidError,
+  createTokenExpiredError,
+  createSessionNotFoundError,
   createSessionExpiredError,
   createValidationError2 as createSchemaValidationError,
   createPermissionDeniedError,
+  createOAuthError,
   createNotNullViolation,
   createMigrationQueryError,
   createMigrationHistoryNotFound,
   createMigrationChecksumMismatch,
+  createMfaRequiredError,
+  createMfaNotEnabledError,
+  createMfaInvalidCodeError,
+  createMfaAlreadyEnabledError,
   createInvalidCredentialsError,
   createHttpError,
   createForbiddenError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/errors",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "type": "module",
   "license": "MIT",
   "description": "Unified error taxonomy for Vertz - Result types, domain errors, and mapping utilities",