Stratal API Reference
    Preparing search index...

    Variable ERROR_CODESConst

    ERROR_CODES: {
        AUTH: {
            ACCOUNT_ALREADY_EXISTS: 3010;
            ACCOUNT_LOCKED: 3002;
            CANNOT_UNLINK_LAST_ACCOUNT: 3015;
            CONTEXT_NOT_INITIALIZED: 3004;
            EMAIL_NOT_VERIFIED: 3007;
            FAILED_TO_CREATE_SESSION: 3012;
            FAILED_TO_CREATE_USER: 3011;
            FAILED_TO_UPDATE_USER: 3013;
            INVALID_CREDENTIALS: 3000;
            INVALID_TOKEN: 3003;
            PASSWORD_TOO_LONG: 3009;
            PASSWORD_TOO_SHORT: 3008;
            SESSION_EXPIRED: 3001;
            SOCIAL_ACCOUNT_LINKED: 3014;
            USER_NOT_AUTHENTICATED: 3005;
        };
        AUTHZ: {
            ACCESS_DENIED: 3101;
            FORBIDDEN: 3100;
            INSUFFICIENT_PERMISSIONS: 3102;
        };
        DATABASE: {
            CONNECTION_FAILED: 2004;
            FOREIGN_KEY_CONSTRAINT: 2003;
            GENERIC: 2000;
            NULL_CONSTRAINT: 2006;
            RECORD_NOT_FOUND: 2001;
            TIMEOUT: 2005;
            TOO_MANY_CONNECTIONS: 2007;
            TRANSACTION_CONFLICT: 2008;
            UNIQUE_CONSTRAINT: 2002;
        };
        I18N: { LOCALE_NOT_SUPPORTED: 9301; TRANSLATION_MISSING: 9300 };
        RESOURCE: {
            ALREADY_EXISTS: 4101;
            CONFLICT: 4100;
            NOT_FOUND: 4000;
            ROUTE_NOT_FOUND: 4004;
        };
        ROUTER: {
            CONTROLLER_METHOD_NOT_FOUND: 9006;
            CONTROLLER_REGISTRATION_ERROR: 9005;
            OPENAPI_ROUTE_REGISTRATION: 9008;
        };
        SYSTEM: {
            CONFIG_NOT_INITIALIZED: 9101;
            CONFIGURATION_ERROR: 9100;
            CRON_EXECUTION_FAILED: 9204;
            EXECUTION_CONTEXT_NOT_INITIALIZED: 9201;
            INFRASTRUCTURE_ERROR: 9200;
            INTERNAL_ERROR: 9000;
            INVALID_ERROR_CODE_RANGE: 9105;
            INVALID_MODULE_PROVIDER: 9106;
            MODULE_ALREADY_REGISTERED: 9102;
            MODULE_CIRCULAR_DEPENDENCY: 9103;
            MODULE_DEPENDENCY_NOT_FOUND: 9104;
            QUEUE_BINDING_NOT_FOUND: 9203;
            QUEUE_PROVIDER_NOT_SUPPORTED: 9205;
            REQUEST_CONTAINER_NOT_INITIALIZED: 9202;
        };
        VALIDATION: {
            GENERIC: 1000;
            INVALID_FORMAT: 1002;
            REQUEST_VALIDATION: 1004;
            REQUIRED_FIELD: 1001;
            SCHEMA_VALIDATION: 1003;
        };
    } = ...

    Centralized Error Code Registry

    Error codes are organized by category with specific ranges:

    • 1000-1999: Validation errors
    • 2000-2999: Database errors (generic)
    • 3000-3999: Authentication & Authorization
    • 4000-4999: Resource errors
    • 5000-5999: Domain-specific business logic (per module)
    • 9000-9999: System/Internal errors
      • 9000-9099: Router errors
      • 9100-9199: Configuration errors
      • 9200-9299: Infrastructure errors
      • 9300-9399: I18n errors

    Type Declaration

    • ReadonlyAUTH: {
          ACCOUNT_ALREADY_EXISTS: 3010;
          ACCOUNT_LOCKED: 3002;
          CANNOT_UNLINK_LAST_ACCOUNT: 3015;
          CONTEXT_NOT_INITIALIZED: 3004;
          EMAIL_NOT_VERIFIED: 3007;
          FAILED_TO_CREATE_SESSION: 3012;
          FAILED_TO_CREATE_USER: 3011;
          FAILED_TO_UPDATE_USER: 3013;
          INVALID_CREDENTIALS: 3000;
          INVALID_TOKEN: 3003;
          PASSWORD_TOO_LONG: 3009;
          PASSWORD_TOO_SHORT: 3008;
          SESSION_EXPIRED: 3001;
          SOCIAL_ACCOUNT_LINKED: 3014;
          USER_NOT_AUTHENTICATED: 3005;
      }

      Authentication Errors (3000-3099) Authentication-related failures

      • ReadonlyACCOUNT_ALREADY_EXISTS: 3010

        Account with email already exists

      • ReadonlyACCOUNT_LOCKED: 3002

        Account locked or disabled

      • ReadonlyCANNOT_UNLINK_LAST_ACCOUNT: 3015

        Last account cannot be unlinked

      • ReadonlyCONTEXT_NOT_INITIALIZED: 3004

        Context not initialized

      • ReadonlyEMAIL_NOT_VERIFIED: 3007

        Email verification required before login

      • ReadonlyFAILED_TO_CREATE_SESSION: 3012

        Session creation failed

      • ReadonlyFAILED_TO_CREATE_USER: 3011

        User creation failed

      • ReadonlyFAILED_TO_UPDATE_USER: 3013

        User update failed

      • ReadonlyINVALID_CREDENTIALS: 3000

        Invalid credentials provided

      • ReadonlyINVALID_TOKEN: 3003

        Invalid or expired token

      • ReadonlyPASSWORD_TOO_LONG: 3009

        Password exceeds maximum length

      • ReadonlyPASSWORD_TOO_SHORT: 3008

        Password doesn't meet minimum length

      • ReadonlySESSION_EXPIRED: 3001

        Session expired or invalid

      • ReadonlySOCIAL_ACCOUNT_LINKED: 3014

        Social account already linked

      • ReadonlyUSER_NOT_AUTHENTICATED: 3005

        User not authenticated

    • ReadonlyAUTHZ: { ACCESS_DENIED: 3101; FORBIDDEN: 3100; INSUFFICIENT_PERMISSIONS: 3102 }

      Authorization Errors (3100-3199) Permission and access control failures

      • ReadonlyACCESS_DENIED: 3101

        Resource access denied

      • ReadonlyFORBIDDEN: 3100

        Insufficient permissions

      • ReadonlyINSUFFICIENT_PERMISSIONS: 3102

        User lacks required role

    • ReadonlyDATABASE: {
          CONNECTION_FAILED: 2004;
          FOREIGN_KEY_CONSTRAINT: 2003;
          GENERIC: 2000;
          NULL_CONSTRAINT: 2006;
          RECORD_NOT_FOUND: 2001;
          TIMEOUT: 2005;
          TOO_MANY_CONNECTIONS: 2007;
          TRANSACTION_CONFLICT: 2008;
          UNIQUE_CONSTRAINT: 2002;
      }

      Database Errors (2000-2999) Generic database errors thrown by Prisma client extensions

      • ReadonlyCONNECTION_FAILED: 2004

        Database connection failed

      • ReadonlyFOREIGN_KEY_CONSTRAINT: 2003

        Foreign key constraint violation

      • ReadonlyGENERIC: 2000

        Generic database error

      • ReadonlyNULL_CONSTRAINT: 2006

        Null constraint violation

      • ReadonlyRECORD_NOT_FOUND: 2001

        Record not found in database

      • ReadonlyTIMEOUT: 2005

        Database timeout

      • ReadonlyTOO_MANY_CONNECTIONS: 2007

        Too many database connections

      • ReadonlyTRANSACTION_CONFLICT: 2008

        Transaction conflict or deadlock

      • ReadonlyUNIQUE_CONSTRAINT: 2002

        Unique constraint violation

    • ReadonlyI18N: { LOCALE_NOT_SUPPORTED: 9301; TRANSLATION_MISSING: 9300 }

      I18n Errors (9300-9399) Internationalization and localization errors

      • ReadonlyLOCALE_NOT_SUPPORTED: 9301

        Requested locale not supported

      • ReadonlyTRANSLATION_MISSING: 9300

        Translation key missing from all locales

    • ReadonlyRESOURCE: { ALREADY_EXISTS: 4101; CONFLICT: 4100; NOT_FOUND: 4000; ROUTE_NOT_FOUND: 4004 }

      Resource Errors (4000-4999) Generic resource-related errors

      • ReadonlyALREADY_EXISTS: 4101

        Resource already exists

      • ReadonlyCONFLICT: 4100

        Resource conflict or duplicate

      • ReadonlyNOT_FOUND: 4000

        Generic resource not found

      • ReadonlyROUTE_NOT_FOUND: 4004

        Route/endpoint not found

    • ReadonlyROUTER: {
          CONTROLLER_METHOD_NOT_FOUND: 9006;
          CONTROLLER_REGISTRATION_ERROR: 9005;
          OPENAPI_ROUTE_REGISTRATION: 9008;
      }

      Router Errors (9000-9099) Router and controller-related INTERNAL errors

      • ReadonlyCONTROLLER_METHOD_NOT_FOUND: 9006

        Controller method not found

      • ReadonlyCONTROLLER_REGISTRATION_ERROR: 9005

        Controller registration error

      • ReadonlyOPENAPI_ROUTE_REGISTRATION: 9008

        OpenAPI route registration failed

    • ReadonlySYSTEM: {
          CONFIG_NOT_INITIALIZED: 9101;
          CONFIGURATION_ERROR: 9100;
          CRON_EXECUTION_FAILED: 9204;
          EXECUTION_CONTEXT_NOT_INITIALIZED: 9201;
          INFRASTRUCTURE_ERROR: 9200;
          INTERNAL_ERROR: 9000;
          INVALID_ERROR_CODE_RANGE: 9105;
          INVALID_MODULE_PROVIDER: 9106;
          MODULE_ALREADY_REGISTERED: 9102;
          MODULE_CIRCULAR_DEPENDENCY: 9103;
          MODULE_DEPENDENCY_NOT_FOUND: 9104;
          QUEUE_BINDING_NOT_FOUND: 9203;
          QUEUE_PROVIDER_NOT_SUPPORTED: 9205;
          REQUEST_CONTAINER_NOT_INITIALIZED: 9202;
      }

      System Errors (9000-9999) Internal system errors and unexpected failures

      • ReadonlyCONFIG_NOT_INITIALIZED: 9101

        ConfigService not initialized

      • ReadonlyCONFIGURATION_ERROR: 9100

        Generic configuration error

      • ReadonlyCRON_EXECUTION_FAILED: 9204

        Cron job execution failed

      • ReadonlyEXECUTION_CONTEXT_NOT_INITIALIZED: 9201

        Execution context not initialized

      • ReadonlyINFRASTRUCTURE_ERROR: 9200

        Generic infrastructure error

      • ReadonlyINTERNAL_ERROR: 9000

        Internal server error

      • ReadonlyINVALID_ERROR_CODE_RANGE: 9105

        Invalid error code range

      • ReadonlyINVALID_MODULE_PROVIDER: 9106

        Invalid module provider configuration

      • ReadonlyMODULE_ALREADY_REGISTERED: 9102

        Module already registered

      • ReadonlyMODULE_CIRCULAR_DEPENDENCY: 9103

        Circular module dependency detected

      • ReadonlyMODULE_DEPENDENCY_NOT_FOUND: 9104

        Module dependency not found

      • ReadonlyQUEUE_BINDING_NOT_FOUND: 9203

        Queue binding not found

      • ReadonlyQUEUE_PROVIDER_NOT_SUPPORTED: 9205

        Queue provider not supported

      • ReadonlyREQUEST_CONTAINER_NOT_INITIALIZED: 9202

        Request container not initialized

    • ReadonlyVALIDATION: {
          GENERIC: 1000;
          INVALID_FORMAT: 1002;
          REQUEST_VALIDATION: 1004;
          REQUIRED_FIELD: 1001;
          SCHEMA_VALIDATION: 1003;
      }

      Validation Errors (1000-1999) Input validation failures

      • ReadonlyGENERIC: 1000

        Generic validation error

      • ReadonlyINVALID_FORMAT: 1002

        Invalid format

      • ReadonlyREQUEST_VALIDATION: 1004

        Request validation failed (OpenAPI, etc.)

      • ReadonlyREQUIRED_FIELD: 1001

        Required field missing

      • ReadonlySCHEMA_VALIDATION: 1003

        Schema validation failed