errors

var (
	ApplicationNotSet                = New("application instance is not initialized")
	AppInvalidDisabledRunnersPattern = New("invalid app.disabled_runners pattern %q: %v")
	CacheFacadeNotSet                = New("cache facade is not initialized")
	ConfigFacadeNotSet               = New("config facade is not initialized")
	ConsoleFacadeNotSet              = New("console facade is not initialized, skipping artisan command execution")
	DBFacadeNotSet                   = New("db facade is not initialized")
	HashFacadeNotSet                 = New("hash facade is not initialized")
	HttpFacadeNotSet                 = New("http facade is not initialized")
	JSONParserNotSet                 = New("JSON parser is not initialized")
	LogFacadeNotSet                  = New("log facade is not initialized")
	MailFacadeNotSet                 = New("mail facade is not initialized")

	OrmFacadeNotSet         = New("orm facade is not initialized")
	ProcessFacadeNotSet     = New("process facade is not initialized")
	QueueFacadeNotSet       = New("queue facade is not initialized")
	RateLimiterFacadeNotSet = New("rate limiter facade is not initialized")
	ScheduleFacadeNotSet    = New("schedule facade is not initialized")
	StorageFacadeNotSet     = New("storage facade is not initialized")
	InvalidHttpContext      = New("invalid http context")
	RouteFacadeNotSet       = New("route facade is not initialized")
	SessionFacadeNotSet     = New("session facade is not initialized")
	ServiceProviderCycle    = New("circular dependency detected between providers: %s")
	TelemetryFacadeNotSet   = New("telemetry facade is not initialized")

	AuthEmptySecret             = New("authentication secret is missing or required")
	AuthGuardMismatch           = New("authentication token guard mismatch: expected %s, got %s")
	AuthInvalidClaims           = New("authentication token contains invalid claims")
	AuthInvalidKey              = New("authentication key is invalid")
	AuthInvalidToken            = New("authentication token is invalid")
	AuthNoPrimaryKeyField       = New("no primary key field found in the model, ensure primary key is set, e.g., orm.Model")
	AuthParseTokenFirst         = New("authentication token must be parsed first")
	AuthRefreshTimeExceeded     = New("authentication refresh time limit exceeded")
	AuthTokenDisabled           = New("authentication token has been disabled")
	AuthTokenExpired            = New("authentication token has expired")
	AuthGuardDriverNotFound     = New("driver %s for guard %s was not found")
	AuthProviderDriverNotFound  = New("driver %s for user provider %s was not found")
	AuthUnsupportedDriverMethod = New("The method was not supported for the driver %s")

	AIProviderNotSupported                = New("ai provider not found: %s")
	AIProviderContractNotFulfilled        = New("%s.via must be contracts/ai.Provider or func() (contracts/ai.Provider, error)")
	AIFacadeNotSet                        = New("ai facade is not initialized")
	AIAttachmentUrlResponseNotOK          = New("ai: attachment url request failed with status %d")
	AIFailoverInsufficientCredits         = New("ai: provider %s has insufficient credits")
	AIFailoverPatternInvalid              = New("ai: provider %s failover reason %s has invalid regex %s: %v")
	AIFailoverProviderOverloaded          = New("ai: provider %s is overloaded")
	AIFailoverRateLimited                 = New("ai: provider %s was rate limited")
	AIFailoverReason                      = New("ai: provider %s failed over because %s")
	AIProviderDoesNotSupportAudio         = New("ai: provider %s does not support audio")
	AIProviderDoesNotSupportFiles         = New("ai: provider %s does not support files")
	AIProviderDoesNotSupportImages        = New("ai: provider %s does not support images")
	AIAudioNameRequired                   = New("ai: audio name is required")
	AIAudioPromptRequired                 = New("ai: audio prompt is required")
	AIAudioResponseIsEmpty                = New("ai: audio response is empty")
	AIAudioStorePathInvalid               = New("ai: audio store path is invalid")
	AIAudioStorePathRequired              = New("ai: audio store path is required")
	AIAudioStoreTooManyPaths              = New("ai: audio store accepts at most one disk")
	AIImageAttachmentRequired             = New("ai: image attachments must all be image kind")
	AIImageNameRequired                   = New("ai: image name is required")
	AIImagePromptRequired                 = New("ai: image prompt is required")
	AIImageResponseIsEmpty                = New("ai: image response is empty")
	AIImageStorePathInvalid               = New("ai: image store path is invalid")
	AIImageStoreTooManyPaths              = New("ai: image store accepts at most one disk")
	AIImageStorePathRequired              = New("ai: image store path is required")
	AIProviderDoesNotSupportTranscription = New("ai: provider %s does not support transcription")
	AIStoredFileIDEmpty                   = New("ai: stored file id cannot be empty")
	AIResponseIsNil                       = New("ai: response is nil")
	AIStreamRunnerRequired                = New("ai stream runner is required")
	AITranscriptionFileRequired           = New("ai: transcription file is required")
	AITranscriptionResponseIsEmpty        = New("ai: transcription response is empty")
	AIUnsupportedAttachmentKind           = New("ai: unsupported attachment kind %s")
	AIToolCallLoopExceeded                = New("ai: tool call loop exceeded %d iterations")
	AIToolExecutionFailed                 = New("ai: tool %q execution failed: %v")
	AIToolNotFound                        = New("ai: tool %q not found")

	CacheDriverNotSupported           = New("invalid driver: %s, only support memory, custom")
	CacheForeverFailed                = New("cache forever is failed")
	CacheMemoryDriverNotSupportDocker = New("memory driver doesn't support docker")
	CacheMemoryInvalidIntValueType    = New("value type of %s is not *atomic.Int64 or *int64 or *atomic.Int32 or *int32")
	CacheStoreContractNotFulfilled    = New("%s doesn't implement contracts/cache/store")

	CommandEmptyPackageName = New("the package name cannot be empty")

	ConsoleProvidersNotArray = New("the app.providers configuration is not of type []foundation.ServiceProvider, skipping registering service providers")

	ConsoleCommandPanicInHandle              = New("panic in Handle: %v")
	ConsoleCommandRegisterFailed             = New("failed to register command '%s': %v")
	ConsoleCommandRequiredArgumentWrongOrder = New("required argument '%s' should be placed before any not-required arguments")
	ConsoleCommandArgumentUnknownType        = New("unknown type of console command argument %T, with value %+v")
	ConsoleDropAllTablesFailed               = New("drop all tables failed: %v")
	ConsoleDropAllTypesFailed                = New("drop all types failed: %v")
	ConsoleDropAllViewsFailed                = New("drop all views failed: %v")
	ConsoleEmptyDatabaseConfig               = New("please fill database config first")
	ConsoleEmptyFieldValue                   = New("the %s name cannot be empty")
	ConsoleFileAlreadyExists                 = New("the %s already exists. Use the --force or -f flag to overwrite")
	ConsoleFailedToConfirm                   = New("failed to confirm the action: %v")
	ConsolePruneFailed                       = New("prune failed: %v")
	ConsoleRunInProduction                   = New("please use the --force option if you want to run the command in production")

	CryptAppKeyNotSet        = New("APP_KEY is required in artisan environment")
	CryptInvalidAppKeyLength = New("invalid APP_KEY length: %d bytes")
	CryptMissingIVKey        = New("decrypt payload error: missing iv key")
	CryptMissingValueKey     = New("decrypt payload error: missing value key")

	DatabaseConfigNotFound              = New("not found database configuration")
	DatabaseDialectRequired             = New("database driver %q must provide a dialect")
	DatabaseDialectComponentsMissing    = New("database driver must provide a query grammar and processor")
	DatabaseIsolationLevelInvalid       = New("unsupported transaction isolation level %q: expected default, read uncommitted, read committed, repeatable read or serializable")
	DatabaseMultipleColumnsSelected     = New("Multiple columns were selected.")
	DatabaseEscapeNonFinite             = New("Cannot escape non-finite numbers.")
	DatabaseEscapeInvalidUTF8           = New("Strings with invalid UTF-8 byte sequences cannot be escaped.")
	DatabaseEscapeNullByte              = New("Strings with null bytes cannot be escaped. Use the binary escape option.")
	DatabaseEscapeBinaryNotSupported    = New("The database connection does not support escaping binary values.")
	DatabaseCountDistinctWithoutColumns = New("cannot use Count with Distinct without specifying columns")
	DatabaseTableIsRequired             = New("table is required")
	DatabaseForceIsRequiredInProduction = New("application in production use --force to run this command")
	DatabaseSeederNotFound              = New("not found %s seeder")
	DatabaseSeederRegisterFailed        = New("seeder register failed: %v")
	DatabaseFailToRunSeeder             = New("fail to run seeder: %v")
	DatabaseUnsupportedType             = New("unsupported type: %s, expected %s")
	OrmSerializerRequiresInterfaces     = New("serializer %s on field %s requires driver.Valuer and sql.Scanner")
	QueryJsonContainsValueNotSupported  = New("this database engine does not support JSON contains value %T")
	DatabaseFieldNotSettable            = New("cannot scan column %s into an unsettable field of %s")
	DatabaseInvalidArgumentNumber       = New("invalid argument number: %s, expected %s")
	DatabaseInvalidPaginationLimit      = New("invalid pagination limit: %d, must be greater than 0")
	DatabaseTransactionNotStarted       = New("transaction not started")
	DatabaseTransactionOrder            = New("transaction handles must be committed in nesting order")
	DatabaseTransactionPanic            = New("panic: %v")
	DatabaseDeadlock                    = New("deadlock detected: %v")
	DatabaseTransactionCallbackFailed   = New("transaction callback failed: %v")
	DatabaseFailedToGetSql              = New("failed to get sql: %v")
	DatabaseDataIsEmpty                 = New("data can't be empty")
	DatabaseConnectionIsNil             = New("database connection is not initialized")
	DatabaseChunkStopped                = New("chunk iteration stopped by the callback")
	DatabaseChunkByIdColumnNotPresent   = New("the chunk by id operation was aborted because the %s column is not present in the query result")
	OrmFieldTypeMismatch                = New("cannot assign %s to %s.%s")
	OrmRowScanValueNotRepresentable     = New("cannot scan value %v of type %s into %s")

	DockerUnknownContainerType           = New("unknown container type")
	DockerInsufficientDatabaseContainers = New("the number of database container is not enough, expect: %d, got: %d")
	DockerDatabaseContainerCountZero     = New("the number of database container must be greater than 0")
	DockerMissingContainerId             = New("no container id return when creating %s docker")

	EventHandlePanic             = New("event %s panicked while preparing its payload: %v")
	EventInvalidEvent            = New("invalid event: %v")
	EventInvalidListener         = New("invalid listener %s, expect event.Listener, func(event any, args ...any) error or func(event *SomeEvent) error")
	EventListenerEmptySignature  = New("listener %s must have a non-empty signature")
	EventListenerEventMismatch   = New("listener of event %s can not be registered on event %s")
	EventListenerNotBind         = New("event %v doesn't bind listeners")
	EventListenerNotPointer      = New("listener %s must be a non-nil pointer, a value listener can not be told apart from another of the same type")
	EventListenerPanic           = New("listener of event %s panicked: %v")
	EventListenerTypeMismatch    = New("listener of event %s expects %s, got %T")
	EventQueueDuplicateSignature = New("signature %s is already registered by another listener")
	EventQueueMissingEvent       = New("queued listener %s received no event")
	EventTooManyPayloads         = New("event %s received %d payloads, at most one is accepted")

	FilesystemDefaultDiskNotSet   = New("please set default disk")
	FilesystemDeleteDirectory     = New("can't delete directory, please use DeleteDirectory")
	FilesystemDriverNotSupported  = New("invalid driver: %s, only support local, custom")
	FilesystemFileNotExist        = New("file doesn't exist")
	FilesystemInvalidCustomDriver = New("init %s disk fail: via must be implement filesystem.Driver or func() (filesystem.Driver, error)")

	FileAlreadyExists = New("file %s already exists")
	FileNotExist      = New("file %s does not exist")

	GrpcEmptyClientHost         = New("client's host can't be empty")
	GrpcEmptyClientPort         = New("client's port can't be empty")
	GrpcEmptyServerHost         = New("host can't be empty")
	GrpcEmptyServerPort         = New("port can't be empty")
	GrpcInvalidInterceptorsType = New("the type of clients.%s.interceptors must be []string")

	HttpClientConnectionNotFound      = New("connection [%s] is not configured").SetModule(ModuleHttp)
	HttpClientDefaultNotSet           = New("default client is not configured").SetModule(ModuleHttp)
	HttpClientResponseAlreadyStreamed = New("response body has already been streamed").SetModule(ModuleHttp)
	HttpClientResponseIsNil           = New("response is nil").SetModule(ModuleHttp)
	HttpClientConfigNotSet            = New("http client config is nil").SetModule(ModuleHttp)

	HttpRateLimitFailedToTakeToken     = New("failed to take token")
	HttpRateLimitFailedToCheckThrottle = New("failed to check throttle: %s")
	HttpClientHandlerReturnedNil       = New("mock handler returned a nil response").SetModule(ModuleHttp)
	HttpClientStrayRequest             = New("stray request: no mock defined for [%s] %s").SetModule(ModuleHttp)

	LangFileNotExist      = New("translation file does not exist")
	LangNoLoaderAvailable = New("no translation loader available")

	LogChannelNotFound         = New("log channel %s not found")
	LogChannelUnimplemented    = New("log channel %s doesn't implement contracts/log/logger").SetModule(ModuleLog)
	LogDriverCircularReference = New("%s driver can't include self channel").SetModule(ModuleLog)
	LogDriverNotSupported      = New("invalid driver: %s, only support stack, single, daily, custom").SetModule(ModuleLog)
	LogEmptyLogFilePath        = New("empty log file path").SetModule(ModuleLog)
	LogFormatterNotSupported   = New("invalid formatter: %s, only support text, json").SetModule(ModuleLog)

	BroadcastAuthMissingParams          = New("broadcasting: socket_id and channel_name are required").SetModule(ModuleBroadcast)
	BroadcastAuthUnauthenticated        = New("unauthenticated").SetModule(ModuleBroadcast)
	BroadcastChannelUnauthorized        = New("channel authorization denied for channel %s").SetModule(ModuleBroadcast)
	BroadcastChannelDataMarshalFailed   = New("broadcasting: failed to marshal channel_data").SetModule(ModuleBroadcast)
	BroadcastConnectionNotFound         = New("broadcast connection %q not found").SetModule(ModuleBroadcast)
	BroadcastDriverNotSupported         = New("unknown broadcast driver: %s, only support pusher, log, null").SetModule(ModuleBroadcast)
	BroadcastInvalidQueuePayload        = New("broadcasting: invalid or missing queue payload").SetModule(ModuleBroadcast)
	BroadcastPusherHTTPError            = New("pusher: HTTP %d: request to %s failed").SetModule(ModuleBroadcast)
	BroadcastPusherHostRequired         = New("pusher: host is required, either configure PUSHER_HOST or PUSHER_APP_CLUSTER").SetModule(ModuleBroadcast)
	BroadcastPusherMarshalBodyFailed    = New("pusher: failed to marshal body: %v").SetModule(ModuleBroadcast)
	BroadcastPusherMarshalPayloadFailed = New("pusher: failed to marshal payload: %v").SetModule(ModuleBroadcast)
	BroadcastPusherRequestFailed        = New("pusher: request failed: %v").SetModule(ModuleBroadcast)
	BroadcastPusherAppIDRequired        = New("pusher: app_id is required").SetModule(ModuleBroadcast)
	BroadcastPusherKeyRequired          = New("pusher: key is required").SetModule(ModuleBroadcast)
	BroadcastPusherSecretRequired       = New("pusher: secret is required").SetModule(ModuleBroadcast)
	BroadcastAuthConfigMissing          = New("broadcasting: auth endpoint requires key and secret in the default broadcast connection").SetModule(ModuleBroadcast)

	MailTemplateParseFailed         = New("failed to parse template %s: %w").SetModule(ModuleMail)
	MailTemplateExecutionFailed     = New("failed to execute template %s: %w").SetModule(ModuleMail)
	MailTemplateEngineNotSupported  = New("template engine driver not supported: %s").SetModule(ModuleMail)
	MailTemplateEngineViaRequired   = New("custom template engine '%s' must specify 'via' factory function").SetModule(ModuleMail)
	MailTemplateEngineViaInvalid    = New("invalid via type for template engine '%s'").SetModule(ModuleMail)
	MailTemplateEngineFactoryFailed = New("factory for template engine '%s' failed: %w").SetModule(ModuleMail)

	MiddlewareRegisterFailed      = New("failed to register middleware '%s': %v")
	MaintenanceCacheDeleteFailed  = New("failed to delete maintenance mode from cache")
	MaintenanceCachePutFailed     = New("failed to put application into maintenance mode using cache")
	MaintenanceCacheStoreNotFound = New("maintenance cache store %s is not initialized")
	MaintenanceDriverNotSupported = New("invalid maintenance driver: %s, only support file, cache")

	MigrationCreateFailed    = New("create migration failed: %v")
	MigrationFreshFailed     = New("migration fresh failed: %v")
	MigrationGetStatusFailed = New("get migration status failed: %v")
	MigrationMigrateFailed   = New("migrate failed: %v")
	MigrationNameIsRequired  = New("migration name cannot be empty")
	MigrationRefreshFailed   = New("migration refresh failed: %v")
	MigrationRegisterFailed  = New("migration register failed: %v")
	MigrationResetFailed     = New("migration reset failed: %v")
	MigrationRollbackFailed  = New("migration rollback failed: %v")

	NotificationChannelNotFound               = New("notification channel not found: %s").SetModule(ModuleNotification)
	NotificationChannelNotQueueable           = New("notification channel %q does not support queued dispatch (does not implement ResolvableChannel)").SetModule(ModuleNotification)
	NotificationInvalidQueuePayload           = New("notification queue payload is missing or malformed").SetModule(ModuleNotification)
	NotificationMailEmptyRoute                = New("mail channel: %T returned an empty address").SetModule(ModuleNotification)
	NotificationMailMarshalPayloadFailed      = New("mail channel: failed to marshal payload for %T: %w").SetModule(ModuleNotification)
	NotificationMailUnmarshalPayloadFailed    = New("mail channel: failed to unmarshal payload: %w").SetModule(ModuleNotification)
	NotificationMailSendFailed                = New("mail channel: failed to send: %w").SetModule(ModuleNotification)
	NotificationDatabaseEmptyRoute            = New("database channel: %T returned an empty ID").SetModule(ModuleNotification)
	NotificationDatabaseMarshalDataFailed     = New("database channel: failed to marshal payload for %T: %w").SetModule(ModuleNotification)
	NotificationDatabaseMarshalRecordFailed   = New("database channel: failed to marshal record: %w").SetModule(ModuleNotification)
	NotificationDatabaseUnmarshalRecordFailed = New("database channel: failed to unmarshal record: %w").SetModule(ModuleNotification)
	NotificationDatabaseInsertFailed          = New("database channel: failed to insert notification record: %w").SetModule(ModuleNotification)
	NotificationTableRequiresBootstrapSetup   = New("notifications:table auto-registration requires the bootstrap setup (see env.IsBootstrapSetup); register the migration manually").SetModule(ModuleNotification)
	NotificationQueuePayloadDecodeFailed      = New("notification queue payload could not be decoded: %v").SetModule(ModuleNotification)

	OrmDriverNotSupported           = New("invalid driver: %s, only support mysql, postgres, sqlite and sqlserver")
	OrmFailedToGenerateDNS          = New("failed to generate DSN, please check the database configuration")
	OrmFactoryMissingAttributes     = New("failed to get raw attributes")
	OrmFactoryMissingMethod         = New("%s does not find factory method")
	OrmInitConnection               = New("init %s connection error: %v")
	OrmMissingWhereClause           = New("WHERE conditions required")
	OrmNoDialectorsFound            = New("no dialectors found")
	OrmQueryConditionRequired       = New("query condition is required")
	OrmQueryEmptyId                 = New("id can't be empty")
	OrmQueryEmptyRelation           = New("relation can't be empty")
	OrmQueryInvalidModel            = New("invalid model %s")
	OrmQueryInvalidParameter        = New("parameter error, please check the document")
	OrmQueryModelNotPointer         = New("model must be pointer")
	OrmQuerySelectAndOmitsConflict  = New("cannot set Select and Omits at the same time")
	OrmQueryTableNotSet             = New("%v: Table not set, please add a TableName() method returning the table name")
	OrmRecordNotFound               = New("record not found")
	OrmMultipleRecordsFound         = New("%d records were found")
	OrmQueryIncrementNonNumeric     = New("non-numeric value %v passed to %s method")
	OrmQueryTimestampColumnNotFound = New("model %s declares no %s column")
	OrmQueryTransactionNotStarted   = New("no transaction has been started on this query")
	OrmQueryPrimaryKeyNotFound      = New("model %s declares no primary key")
	OrmWhereBelongsToEmpty          = New("WhereBelongsTo requires at least one related model")
	OrmWhereBelongsToNotBelongsTo   = New("relation %q on model %s is not a BelongsTo relation")
	OrmDeletedAtColumnNotFound      = New("deleted at column not found")
	OrmJsonContainsInvalidBinding   = New("invalid value for JSON contains: %v")
	OrmJsonColumnUpdateInvalid      = New("invalid value for JSON column update: %v")
	OrmRelationNotFound             = New("relation %q not found on model %s")
	OrmRelationUnsupported          = New("relation %q on model %s has unsupported kind %q")
	OrmRelationInvalidArgument      = New("invalid argument %T for relation query, expected callback, operator or count")
	OrmRelationInvalidAggregate     = New("invalid aggregate function %q, expected one of count, max, min, sum, avg, exists")
	OrmRelationMorphTypesEmpty      = New("hasMorph requires at least one morph type")
	OrmRelationThroughNotConfigured = New("through relation %q must be declared via the Relations() method on model %s")
	OrmMorphRelationNotConfigured   = New("polymorphic relation %q must be declared via the Relations() method on model %s")
	OrmMorphRelationKindUnknown     = New("relation %q on model %s has unknown kind %q")
	OrmMorphRelationMissingField    = New("relation %q on model %s is missing required field %q")
	OrmMorphTypeUnknown             = New("polymorphic type %q is not registered in the morph map; call orm.MorphMap or implement MorphClass() on the target model")
	OrmPolymorphicTagForbidden      = New("polymorphic GORM tag on field %q of model %s is forbidden; declare the relation via the Relations() method instead")
	OrmRelationTagForbidden         = New("GORM relation tag on field %q of model %s is forbidden; declare the relation via the Relations() method instead, and tag the field with `gorm:\"-\"`")
	OrmRelationParentNotPointer     = New("Related: parent must be a non-nil pointer to a struct, got %T")
	OrmRelationKindNotSupported     = New("operation %q is not supported on relation %q (kind %q)")
	OrmEagerLoadInvalidArgument     = New("invalid argument %T passed to With; expected string, []string, []any, map[string]orm.RelationCallback, or string + callback")
	OrmEagerLoadCannotAssign        = New("cannot assign eager-loaded rows to field %q on model %s; field must be *Model, []*Model or []Model")
	OrmEagerLoadEmptyRelation       = New("With received an empty relation name")
	OrmRelationPivotFieldNotStruct  = New("eager-load: related model %s has %s field of kind %s; pivot hydration target must be a struct")

	PackageConfigKeyExists       = New("config key '%s' already exists,using ReplaceConfig instead if you want to update it")
	PackageFacadeNotFound        = New("facade %s not found")
	PackageMatchGoNodeFail       = New("%d out of %d matchers did not match")
	PackageModifyGoFileFail      = New("modify go file '%s' failed: %v")
	PackageModuleNameEmpty       = New("package module name is empty, please run command with module name")
	PackageRegistrationDuplicate = New("'%s' had been registered")
	PackageRegistrationNotFound  = New("'%s' not found, cannot insert before it")
	PackageCommandsFileExists    = New("commands.go already exists but WithCommands is not registered in foundation.Setup(). The commands.go file should only be created when adding WithCommands to Setup()")
	PackageFiltersFileExists     = New("filters.go already exists but WithFilters is not registered in foundation.Setup(). The filters.go file should only be created when adding WithFilters to Setup()")
	PackageGoModDownloadFailed   = New("failed to download go.mod dependencies: %s")
	PackageJobsFileExists        = New("jobs.go already exists but WithJobs is not registered in foundation.Setup(). The jobs.go file should only be created when adding WithJobs to Setup()")
	PackageMigrationsFileExists  = New("migrations.go already exists but WithMigrations is not registered in foundation.Setup(). The migrations.go file should only be created when adding WithMigrations to Setup()")
	PackageProvidersFileExists   = New("providers.go already exists but WithProviders is not registered in foundation.Setup(). The providers.go file should only be created when adding WithProviders to Setup()")
	PackageRulesFileExists       = New("rules.go already exists but WithRules is not registered in foundation.Setup(). The rules.go file should only be created when adding WithRules to Setup()")
	PackageSeedersFileExists     = New("seeders.go already exists but WithSeeders is not registered in foundation.Setup(). The seeders.go file should only be created when adding WithSeeders to Setup()")

	PluralizerLanguageNotFound     = New("language %s not found").SetModule(ModulePluralizer)
	PluralizerEmptyLanguageName    = New("language name cannot be empty").SetModule(ModulePluralizer)
	PluralizerNoSubstitutionsGiven = New("no substitutions provided").SetModule(ModulePluralizer)
	PluralizerNoWordsGiven         = New("no words provided").SetModule(ModulePluralizer)

	ProcessNotStarted            = New("process not started").SetModule(ModuleProcess)
	ProcessUnsupportedSignalType = New("unsupported signal type").SetModule(ModuleProcess)
	ProcessPipelineEmpty         = New("pipeline must have at least one command").SetModule(ModuleProcess)
	ProcessPipelineStartFailed   = New("failed to start pipeline: %v").SetModule(ModuleProcess)
	ProcessPipeNilConfigurer     = New("pipe configurer cannot be nil").SetModule(ModuleProcess)
	ProcessPoolNilConfigurer     = New("pool configurer cannot be nil").SetModule(ModuleProcess)
	ProcessExitedWithCode        = New("process exited with code %d").SetModule(ModuleProcess)

	ProviderRegisterFailed = New("failed to register provider '%s': %v")

	QueueDriverFailedToPop           = New("failed to pop job from %s queue: %v")
	QueueDriverFailedToReceive       = New("failed to receive jobs from %s queue: %v")
	QueueDriverInvalid               = New("%s doesn't implement contracts/queue/driver")
	QueueDriverNoJobFound            = New("no job found in %s queue")
	QueueDriverNotSupported          = New("unknown queue driver: %s")
	QueueDriverSyncNotNeedToRun      = New("the driver of queue %s is sync, not need to run")
	QueueDuplicateJobSignature       = New("duplicate job signature: %s")
	QueueEmptyJobSignature           = New("job signature can't be empty")
	QueueFailedJobNotFound           = New("Unable to find failed job with ID [%s]")
	QueueFailedToCallJob             = New("failed to call job")
	QueueFailedToConvertTaskToJson   = New("failed to convert task to json: %v, task: %+v")
	QueueFailedToDeleteFailedJob     = New("failed to delete failed job: %+v, err: %v")
	QueueFailedToDeleteReservedJob   = New("failed to delete reserved job: %+v, err: %v")
	QueueFailedToGetFailedJob        = New("failed to get failed job: %+v, err: %v")
	QueueFailedToReleaseReservedJob  = New("failed to release reserved job: %+v, err: %v")
	QueueFailedToInsertJobToDatabase = New("failed to insert job to database: %+v, err: %v")
	QueueFailedToReserveJob          = New("failed to reserve job: %+v, err: %v")
	QueuePopIsLocked                 = New("queue %s is locked, please remove the cache lock key manually: %s")
	QueueFailedToRetryJob            = New("failed to retry job: %+v, err: %v")
	QueueFailedToSaveFailedJob       = New("failed to save failed job: %v")
	QueueInvalidDatabaseConnection   = New("invalid database connection: %s")
	QueueNoRetryableJobsFound        = New("no retryable jobs found")
	QueueJobNotFound                 = New("job not found: %s")
	QueueJobRegisterFailed           = New("job register failed: %v")
	QueueJobFailed                   = New("job failed: %v")
	QueueProcessingJobs              = New("Processing jobs from [%s] connection and [%s] queue")
	QueuePushingFailedJob            = New("Pushing failed queue jobs back onto the queue")
	QueueNoFailedJobsFound           = New("no failed jobs found")

	RouteDefaultDriverNotSet = New("please set default driver")
	RouteInvalidDriver       = New("init %s route driver fail: route must be implement route.Route or func() (route.Route, error)")

	SchemaConnectionNotFound               = New("connection %s not found")
	SchemaDriverNotSupported               = New("driver %s is not supported")
	SchemaBindingsRequireExecution         = New("schema statements with bindings require execution through the schema builder")
	SchemaForeignKeysInTransaction         = New("foreign key constraints cannot be changed inside an active transaction")
	SchemaInvalidLength                    = New("default string length must be greater than zero")
	SchemaInvalidPrecision                 = New("default time precision must not be negative")
	SchemaFeatureNotSupported              = New("database driver %s does not support %s")
	SchemaGeneratedColumnChange            = New("This database driver does not support modifying generated columns.")
	SchemaComputedRequiresType             = New("This database driver requires a type, see the virtualAs / storedAs modifiers.")
	SchemaComputedNotNullRequiresPersisted = New("An explicitly non-null computed column must be persisted and cannot change nullability in place.")
	SchemaEnumCatalogRequired              = New("Changing enum column %s requires a schema catalog.")
	SchemaEnumConstraintAmbiguous          = New("Cannot safely identify the enum check constraint for column %s on table %s.")
	SchemaEnumValuesNotAllowed             = New("Existing values in enum column %s on table %s do not satisfy the new definition.")
	SchemaEnumValuesRequired               = New("Enum column %s must declare at least one allowed value.")
	SchemaSessionStateUnknown              = New("cannot determine the original schema session setting")
	SchemaSessionDiscardNotSupported       = New("schema session settings require a discardable writer connection")
	SchemaSQLiteRebuildRequired            = New("this SQLite schema change requires rebuilding the table")
	SchemaSQLiteDefinitionInvalid          = New("cannot rebuild the SQLite table definition")
	SchemaSQLiteNoWritableColumns          = New("cannot rebuild a SQLite table without a writable source column")
	SchemaSQLiteTriggerDependencyInvalid   = New("trigger %s cannot survive the rebuild of table %s: it references a dropped column")
	SchemaMetadataNotSupported             = New("retrieving %s is not supported by database driver %s")
	SchemaCurrentNamespaceUnavailable      = New("cannot resolve the current database namespace from the active connection")
	SchemaObjectOutsideScope               = New("schema object %s.%s is outside the current database namespace")
	SchemaObjectNameAmbiguous              = New("schema object %s.%s contains a period in its name and cannot be targeted safely")
	SchemaColumnNotFound                   = New("There is no column with name '%s' on table '%s'.")
	SchemaDropForeignByNameNotSupported    = New("This database driver does not support dropping foreign keys by name.")
	SchemaEmptyReferenceString             = New("reference string can't be empty")
	SchemaErrorReferenceFormat             = New("invalid format: too many dots in reference")
	SchemaFailedToCreateTable              = New("failed to create %s table: %v")
	SchemaFailedToChangeTable              = New("failed to change %s table: %v")
	SchemaFailedToDropTable                = New("failed to drop %s table: %v")
	SchemaFailedToDropColumns              = New("failed to drop %s table columns: %v")
	SchemaFailedToGetTables                = New("failed to get %s tables: %v")
	SchemaFailedToRenameTable              = New("failed to rename %s table: %v")
	SchemaInvalidModel                     = New("model must be a struct or pointer to struct")
	SchemaModelNotFound                    = New("model %s not found in registered models")
	SchemaTableNotFound                    = New("table %s not found")

	SessionDriverAlreadyExists        = New("session driver [%s] already exists")
	SessionDriverExtensionFailed      = New("session failed to extend session [%s] driver [%v]")
	SessionDriverIsNotSet             = New("session driver is not set")
	SessionDriverNotSupported         = New("session driver [%s] not supported")
	SessionDriverRegisterFailed       = New("failed to register session drivers: %v")
	SessionDriverContractNotFulfilled = New("%s doesn't implement contracts/session/driver")

	TemplateFailedToExecute      = New("failed to execute template: %v")
	TemplateFailedToFormatGoCode = New("failed to format go code: %v")
	TemplateFailedToParse        = New("failed to parse template: %v")

	TelemetryPropagatorRequired             = New("telemetry propagator is required").SetModule(ModuleTelemetry)
	TelemetryExporterNotFound               = New("telemetry exporter not found").SetModule(ModuleTelemetry)
	TelemetryUnsupportedDriver              = New("unsupported telemetry exporter driver: %s").SetModule(ModuleTelemetry)
	TelemetryUnsupportedPropagator          = New("unsupported telemetry propagator: %s").SetModule(ModuleTelemetry)
	TelemetryZipkinEndpointRequired         = New("telemetry zipkin endpoint is required").SetModule(ModuleTelemetry)
	TelemetryServiceNameRequired            = New("telemetry service name is required").SetModule(ModuleTelemetry)
	TelemetryViaRequired                    = New("custom driver requires a factory function to be provided in the 'via' field").SetModule(ModuleTelemetry)
	TelemetryMetricViaTypeMismatch          = New("custom metrics driver requires func(context.Context) (sdkmetric.Reader, error), received %s").SetModule(ModuleTelemetry)
	TelemetryTraceViaTypeMismatch           = New("custom traces driver requires func(context.Context) (sdktrace.SpanExporter, error), received %s").SetModule(ModuleTelemetry)
	TelemetryLogViaTypeMismatch             = New("custom logger driver requires func(context.Context) (sdklog.Exporter, error), received %s").SetModule(ModuleTelemetry)
	TelemetryGrpcServerStatsHandlerDisabled = New("Facade not initialized. gRPC server stats instrumentation is disabled.").SetModule(ModuleTelemetry)
	TelemetryGrpcClientStatsHandlerDisabled = New("Facade not initialized. gRPC client stats instrumentation is disabled.").SetModule(ModuleTelemetry)
	TelemetryUnsupportedProtocol            = New("unsupported telemetry exporter protocol: %s").SetModule(ModuleTelemetry)
	TelemetryTLSConflictsWithInsecure       = New("telemetry exporter tls config conflicts with insecure").SetModule(ModuleTelemetry)
	TelemetryTLSClientCertIncomplete        = New("telemetry exporter tls client cert and key must both be set").SetModule(ModuleTelemetry)
	TelemetryTLSInvalidCA                   = New("telemetry exporter tls ca file contains no valid certificates").SetModule(ModuleTelemetry)
	TelemetryUnsupportedCompression         = New("unsupported telemetry exporter compression: %s").SetModule(ModuleTelemetry)
	TelemetryUnsupportedProcessor           = New("unsupported telemetry processor type: %s").SetModule(ModuleTelemetry)

	TestingImageBuildFailed   = New("init %s docker error: %v")
	TestingImageNoContainerId = New("no container id return when creating %s docker")
	TestingImageStopFailed    = New("stop %s docker error: %v")
	TestingImageReadyTimeout  = New("image %s is not ready after %s")

	UnknownFileExtension = New("unknown file extension")

	ValidationDataInvalidType      = New("data must be map[string]any or map[string][]string or struct")
	ValidationDuplicateFilter      = New("duplicate filter name: %s")
	ValidationDuplicateRule        = New("duplicate rule name: %s")
	ValidationEmptyData            = New("data can't be empty")
	ValidationEmptyRules           = New("rules can't be empty")
	ValidationFilterRegisterFailed = New("filter register failed: %v")
	ValidationInvalidFilterType    = New("invalid filter type for field %s, must be string or []string")
	ValidationInvalidRuleType      = New("invalid rule type for field %s, must be string or []string")
	ValidationRuleRegisterFailed   = New("rule register failed: %v")
	ValidationUnknownRule          = New("unknown validation rule: %s")

	ViewFSRequired         = New("view filesystem is required")
	ViewFSRootNotDirectory = New("view filesystem root %q is not a directory")
	ViewInvalidFSRoot      = New("invalid view filesystem root %q: %v")
	ViewTemplateNotExist   = New("view template %s does not exist")
)

var (
	QueryInvalidBindingType          = New("invalid binding type: %s")
	QueryDecrementAmountNonNumeric   = New("Non-numeric value passed as decrement amount for column: '%s'.")
	QueryDecrementEachNonAssociative = New("Non-associative array passed to decrementEach method.")
	QueryUpdateFromNotSupported      = New("This database engine does not support the updateFrom method.")
	QueryPaginationOverflow          = New("pagination offset or page size exceeds the supported integer range")
	QueryMultipleRecordsFound        = New("%d records were found.")
	QueryRecordsNotFound             = New("No records found.")
	QueryInvalidChunkSize            = New("The chunk size should be at least 1")
	QueryIllegalOperatorAndValue     = New("Illegal operator and value combination.")
	QueryIncrementAmountNonNumeric   = New("Non-numeric value passed as increment amount for column: '%s'.")
	QueryIncrementEachNonAssociative = New("Non-associative array passed to incrementEach method.")
	QueryNestedArraysNotAllowed      = New("nested arrays may not be passed to whereIn method")
	QueryNilValueListNotAllowed      = New("a nil value list may not be passed to whereIn method")
	QueryOrderDirectionInvalid       = New("order direction must be asc or desc")
	QueryOrderRequired               = New("You must specify an orderBy clause when using this function.")
	QueryRowValuesCountMismatch      = New("The number of columns must match the number of values")
	QuerySubqueryTypeInvalid         = New("a subquery must be a query builder instance, a func, or a string")
	QueryGrammarNotSet               = New("query grammar is not set")
)

var (
	// QueryCursorParameterMissing is returned when the cursor carries no value for an ORDER BY
	// column the query asks about. Laravel throws an UnexpectedValueException here.
	QueryCursorParameterMissing = New("unable to find parameter [%s] in pagination item")
	// QueryCursorInvalid is the catch-all for an encoded cursor that cannot be decoded.
	QueryCursorInvalid = New("invalid cursor: %v")
	// QueryCursorPayloadTooLarge rejects encoded cursors and decoded JSON above the size cap.
	QueryCursorPayloadTooLarge = New("cursor payload exceeds the %d byte limit")
	// QueryCursorNotObject rejects JSON whose top level is not an object.
	QueryCursorNotObject = New("cursor payload must be a JSON object, got %s")
	// QueryCursorPointsToNextItemsMissing rejects a payload without the direction bit.
	QueryCursorPointsToNextItemsMissing = New("cursor payload is missing the _pointsToNextItems key")
	// QueryCursorPointsToNextItemsInvalid rejects a direction bit that is not a boolean.
	QueryCursorPointsToNextItemsInvalid = New("cursor payload _pointsToNextItems must be a boolean, got %s")
	// QueryCursorNonScalarValue rejects array and object parameter values.
	QueryCursorNonScalarValue = New("cursor parameter [%s] must be a scalar value, got %s")
	// QueryCursorDuplicateParameter rejects a column that appears twice in one payload.
	QueryCursorDuplicateParameter = New("cursor parameter [%s] is declared more than once")
	// QueryCursorInvalidValue rejects a value that cannot be serialised to JSON.
	QueryCursorInvalidValue = New("cursor parameter [%s] cannot be encoded as a JSON scalar: %v")
	// QueryCursorReservedParameter rejects the direction bit's own key as a parameter name.
	QueryCursorReservedParameter = New("cursor parameter name [%s] is reserved for the cursor direction bit")
	// QueryCursorColumnNotFound is returned when a row carries no value for a column a cursor
	// must be minted from. Laravel reads a dynamic property and would bind null; this fails loudly.
	QueryCursorColumnNotFound = New("unable to find cursor column [%s] in the pagination item")
)

var (
	QueryJsonContainsNotSupported    = New("this database engine does not support JSON contains operations")
	QueryJsonContainsKeyNotSupported = New("this database engine does not support JSON contains key operations")
	QueryJsonLengthNotSupported      = New("this database engine does not support JSON length operations")
	QueryJsonOverlapsNotSupported    = New("this database engine does not support JSON overlaps operations")
	QueryJsonSelectorNotSupported    = New("this database engine does not support JSON operations")
	QueryFullTextNotSupported        = New("this database engine does not support fulltext search operations")
	QueryUpsertNotSupported          = New("this database engine does not support upserts")
	QueryInsertIgnoreNotSupported    = New("this database engine does not support inserting while ignoring errors")
	QueryLateralJoinNotSupported     = New("this database engine does not support lateral joins")
)

var (
	DatabaseFixtureInvalidDriver = New("unsupported test database driver: %s")
	DatabaseFixtureInvalidName   = New("invalid test database identifier: %q")
	DatabaseFixtureUnowned       = New("database fixture does not own database %q")
	DatabaseFixtureEmptyPool     = New("test database driver has no writer")
	DatabaseFixtureInvalidPort   = New("invalid test database port: %d")
)

var (
	ModuleAuth         = "auth"
	ModuleBroadcast    = "broadcast"
	ModuleCache        = "cache"
	ModuleConsole      = "console"
	ModuleCrypt        = "crypt"
	ModuleDB           = "db"
	ModuleEvent        = "event"
	ModuleFacade       = "facade"
	ModuleFilesystem   = "filesystem"
	ModuleGrpc         = "grpc"
	ModuleHash         = "hash"
	ModuleHttp         = "http"
	ModuleLang         = "lang"
	ModuleLog          = "log"
	ModuleMail         = "mail"
	ModuleMigration    = "migration"
	ModuleNotification = "notification"
	ModuleOrm          = "orm"
	ModulePackages     = "packages"
	ModulePluralizer   = "pluralizer"
	ModuleProcess      = "process"
	ModuleQueue        = "queue"
	ModuleRoute        = "route"
	ModuleSchema       = "schema"
	ModuleSchedule     = "schedule"
	ModuleSession      = "session"
	ModuleTelemetry    = "telemetry"
	ModuleTesting      = "testing"
)

var (
	QueryCaseSensitiveLikeNotSupported = New("this database engine does not support case sensitive like operations")
)

var (
	QueryGrammarDriverNotRecognised = New("driver %s is not recognised, only mysql, postgres, sqlite and sqlserver have a dedicated grammar; the base grammar will be used")
)