Skip to content
All changes

Breaking

The old function names are removed, and one codemod moves your calls

@venizia/ignis-inversion, @venizia/ignis-filter, @venizia/ignis-helpers, @venizia/ignis-boot, @venizia/ignis-kernel, @venizia/ignis-connectors, @venizia/ignis-worker, @venizia/ignis, @venizia/dev-configs

Changelog - 2026-11-01 ​

The old function names are removed, and one codemod moves your calls ​

Breaking Change

In one line. Run devz codemod namespace-functions to rewrite your calls, because 184 public functions (such as isEmpty, uuidV4, resolveValue, jsonResponse, defineAuthController) no longer exist as standalone functions and now live in classes.

What changed ​

  • Update your calls to static methods. Standalone function names are gone, and IGNIS provides no aliases. Call each function as a static method on its new class (for example, call ObjectUtility.isEmpty({ value }) instead of isEmpty({ value }), and call UuidV4Generator.generate() instead of uuidV4()). Pass an options object first: 39 of the old functions took positional arguments, and the list shows each new call. Keep the arguments as they were if the function took none or already accepted one options object.
  • Run one command to rewrite your code. Run devz codemod namespace-functions to update imports and call sites across your project. This command also rewrites ApplicationLogger to LoggerFactory.getLogger([scope]) (see the logger entry). The codemod tracks named, aliased, and namespace imports from @venizia/* packages. It adds the new class to your imports. It removes the old function name once no code uses it. It outputs the file name and line number for any code that it cannot safely rewrite.
  • Migrate unsupported removals by hand. Check "Manual steps" for changes that the codemod does not handle.

Who is affected ​

  • Apps and packages that import old function names. Run the codemod once after you install this IGNIS upgrade.
  • Apps that use only decorators, inject, getError, the middleware DSL (authenticate, authorize), field.*, schema and column builders, mixins, and hooks. Take no action. These APIs remain functions.

Breaking changes ​

WARNING

Code that imports an old function name fails to compile or to load after the upgrade.

Before:

typescript
import { isEmpty, uuidV4 } from '@venizia/ignis-helpers';

if (!isEmpty({ value: payload })) {
  const id = uuidV4();
}

After:

typescript
import { ObjectUtility, UuidV4Generator } from '@venizia/ignis-helpers';

if (!ObjectUtility.isEmpty({ value: payload })) {
  const id = UuidV4Generator.generate();
}

Upgrade steps:

  1. Commit your work, so git can undo the codemod. With --write the codemod refuses a file that has local changes (modified, staged or untracked) and prints refused <file> has local changes; commit or stash it and run again.
  2. Dry run: bunx devz codemod namespace-functions lists every file and call it would change.
  3. Apply: bunx devz codemod namespace-functions --write.
  4. Run your formatter and bun check. Fix what the codemod listed as left (a spread argument, the old name used as a value, a re-export, a name collision, or an import it does not follow, such as a @/... alias).

Manual steps ​

These removals cannot be migrated by the codemod. A removed name that was never exported from a package entry, such as StaticAssetDefinitions (an internal constant of the static-asset controller), needs no step.

  • Switch from MinIO to BunS3Helper. MinIO support is removed from IGNIS. Do not use MinioHelper, IMinioHelperOptions, the @venizia/ignis-helpers/minio sub-path, the minio optional peer dependency, or StaticAssetStorageTypes.MINIO (the storage: 'minio' option of static-asset). Import BunS3Helper from @venizia/ignis-helpers/bun-s3 instead. Connect to your MinIO server through the S3 API by configuring the custom endpoint and path-style addressing.
  • Remove readAffectedRowCount. readAffectedRowCount is removed from @venizia/ignis without a replacement. Read rows.length from a returning statement instead, or read the affected row count directly from the database driver raw result.

Details ​

Calls that take an options object now ​

The codemod rewrites these calls for you. If you migrate by hand, note that the old function took positional arguments and its replacement takes one options object whose keys are the old parameter names. A parameter written with ? is optional; leave its key out when the old call left it out. Every other function in the tables below took no arguments or one options object already, and keeps its call shape.

@venizia/ignis-helpers (20)

Old callNew call
sanitizeFilename(filename)RequestUtility.sanitizeFilename({ filename })
encodeRFC5987(filename)RequestUtility.encodeRfc5987({ filename })
toCamel(input)ParseUtility.toCamel({ input })
keysToCamel(source)ParseUtility.keysToCamel({ source })
isInt(input)ParseUtility.isInt({ input })
isFloat(input)ParseUtility.isFloat({ input })
int(input)ParseUtility.toInt({ input })
float(input, digit?)ParseUtility.toFloat({ input, digit })
toBoolean(input)ParseUtility.toBoolean({ input })
parseArrayToMapWithKey(items, key)ParseUtility.parseArrayToMapWithKey({ items, key })
toDelimitedArray(input, separator?)ParseUtility.toDelimitedArray({ input, separator })
blankToUndefined(input)ParseUtility.blankToUndefined({ input })
toTrimmed(input)ParseUtility.toTrimmed({ input })
getDeepProperty(source, path)ParseUtility.getDeepProperty({ source, path })
sleep(ms)PromiseUtility.sleep({ ms })
toError(error)ErrorUtility.toError({ error })
redactSecrets(value, seen?, depth?)RedactUtility.redactSecrets({ value, seen, depth })
redactUrlCredentials(url)RedactUtility.redactUrlCredentials({ url })
mapFrequency(value?)PinoDestination.mapFrequency({ value })
buildDestination(plan)PinoDestination.build({ plan })

@venizia/ignis-connectors (6)

Old callNew call
enrichDataTypes(baseSchema, opts?)PostgresDataTypeEnricher.enrich({ baseSchema, opts }) or SqliteDataTypeEnricher.enrich({ baseSchema, opts })
enrichId(baseColumns, opts?)PostgresIdEnricher.enrich({ baseColumns, opts }) or SqliteIdEnricher.enrich({ baseColumns, opts })
enrichPrincipal(baseSchema, opts)PostgresPrincipalEnricher.enrich({ baseSchema, opts }) or SqlitePrincipalEnricher.enrich({ baseSchema, opts })
enrichTz(baseSchema, opts?)PostgresTzEnricher.enrich({ baseSchema, opts }) or SqliteTzEnricher.enrich({ baseSchema, opts })
enrichUserAudit(baseSchema, opts?)PostgresUserAuditEnricher.enrich({ baseSchema, opts }) or SqliteUserAuditEnricher.enrich({ baseSchema, opts })
toSearchQueryParams(input)SearchQueryParamsUtility.toSearchQueryParams({ input })

@venizia/ignis-kernel (2)

Old callNew call
asTypedContext(context)ContextUtility.asTypedContext({ context })
snakeToCamel(shape)ModelUtility.snakeToCamel({ shape })

@venizia/ignis (6)

Old callNew call
splitAddressList(value)MailAddressUtility.splitList({ value })
formatAddressHeader(value)MailMimeUtility.formatAddressHeader({ value })
buildRawMimeMessage(message)MailMimeUtility.buildRawMessage({ message })
getExpiryTime(minutes)MailVerificationUtility.getExpiryTime({ minutes })
getExpiryTimeInHours(hours)MailVerificationUtility.getExpiryTimeInHours({ hours })
assertApplicationBoots(application, options?)ApplicationBootAssertion.assert({ application, options })

@venizia/dev-configs (5)

Old callNew call
assertNoWorkspaceExternal(manifest, workspaceScope?)PurityManifest.assertNoWorkspaceExternal({ manifest, workspaceScope })
stripBundlerPathComments(text)PurityProbe.stripBundlerPathComments({ text })
formatLedgerResults(results)TestMutateCheck.formatLedgerResults({ results })
rejectionOf(task)RejectionHelper.rejectionOf({ task })
findRepositoryRoot(start?)RepoTmp.findRoot({ start })

For the five enrich* functions the class depends on the dialect: use the Postgres... class for a Postgres model and the Sqlite... class for a SQLite model.

Message text that changed with the names ​

An error or log message that began with the old function name now begins with the class and method. Code, tests and alerts that match the text stop matching. These are the tags found by comparing the 0.4.6 sources with this release; a message that still carries an old function name was not renamed.

Old tagNew tag
[toEntityId][ModelUtility.toEntityId]
[idParamsSchema][OpenApiSchemas.idParams]
[extraPermissionColumns][AuthModelColumns.buildPermission]
[extraPolicyDefinitionColumns][AuthModelColumns.buildPolicyDefinition]
[releaseAttachmentStreams][MailAttachmentUtility.release]
[createRedisHelper][RedisHelperFactory.create]
[assertApplicationBoots][ApplicationBootAssertion.assert]
[readResultRows][DrizzleResultUtility.readResultRows]
[defineControllerRouteConfigs][RouteConfigResolver.defineControllerRouteConfigs]
[spawnSyncBounded][SpawnHelper.spawnSyncBounded]

The BaseSearchEntity message that said to define a static schema "via defineSearchCollection" now says "via SearchCollectionFactory.define".

@venizia/ignis-inversion (7) ​

Old nameNew form
isEmptyObjectUtility.isEmpty
omitObjectUtility.omit
resolveValueResolverUtility.resolveValue
resolveValueAsyncResolverUtility.resolveValueAsync
resolveInjectTargetResolverUtility.resolveInjectTarget
verifyBindingsBindingVerifier.verify
assertBindingsResolveBindingVerifier.assertResolve

@venizia/ignis-filter (2) ​

Old nameNew form
parseOrderEntrySorts.parseEntry
buildQuerySchemasQuerySchemaFactory.build

@venizia/ignis-helpers (66) ​

Old nameNew form
getPerformanceCheckpointPerformanceUtility.getCheckpoint
getExecutedPerformancePerformanceUtility.getExecuted
executeWithPerformanceMeasurePerformanceUtility.executeWithMeasure
hrTimeHrTimeUtility.getSeconds
parseMultipartBodyRequestUtility.parseMultipartBody
sanitizeFilenameRequestUtility.sanitizeFilename
encodeRFC5987RequestUtility.encodeRfc5987
createContentDispositionHeaderRequestUtility.buildContentDispositionHeader
parseContentDispositionRequestUtility.parseContentDisposition
readFormBodyFormBodyUtility.readFormBody
getUIDParseUtility.getUID
toCamelParseUtility.toCamel
keysToCamelParseUtility.keysToCamel
isIntParseUtility.isInt
isFloatParseUtility.isFloat
intParseUtility.toInt
floatParseUtility.toFloat
toBooleanParseUtility.toBoolean
parseArrayToMapWithKeyParseUtility.parseArrayToMapWithKey
toDelimitedArrayParseUtility.toDelimitedArray
blankToUndefinedParseUtility.blankToUndefined
toTrimmedParseUtility.toTrimmed
getDeepPropertyParseUtility.getDeepProperty
sleepPromiseUtility.sleep
executePromiseWithLimitPromiseUtility.executeWithLimit
voidExecutionPromiseUtility.voidExecution
toErrorErrorUtility.toError
isNotFoundErrorStorageUtility.isNotFoundError
toExpirySecondsStorageUtility.toExpirySeconds
createUuidV4UuidV4Generator.create
uuidV4UuidV4Generator.generate
createUuidV5UuidV5Generator.create
uuidV5UuidV5Generator.generate
createUuidV7UuidV7Generator.create
uuidV7UuidV7Generator.generate
redactSecretsRedactUtility.redactSecrets
toJsonSafeRedactUtility.toJsonSafe
redactUrlCredentialsRedactUtility.redactUrlCredentials
resolveClassClassResolver.resolveClass
createRedisHelperRedisHelperFactory.create
createSecretsHelperSecretsHelperFactory.create
waitForRedisReadyRedisUtility.waitForReady
ensureRedisClientsConnectingRedisUtility.ensureConnecting
isUrlRefusedErrorUrlPolicy.isRefusedError
toQueryStringQueryStringUtility.toQueryString
invokeHookHookUtility.invoke
awaitHookHookUtility.execute
resolveLoggerLevelLoggerConfigUtility.resolveLevel
resolveLoggerColorizeLoggerConfigUtility.resolveColorize
formatLogMessageLogFormatUtility.formatMessage
buildPinoOptionsPinoBackingLogger.buildOptions
getPinoBackingLoggerPinoBackingLogger.get
setPinoBackingLoggerPinoBackingLogger.set
mapFrequencyPinoDestination.mapFrequency
mapMaxFilesToCountPinoDestination.mapMaxFilesToCount
resolveDestinationPlanPinoDestination.resolvePlan
buildDestinationPinoDestination.build
defineCustomLoggerWinstonLoggerFactory.defineCustomLogger
defineJsonLoggerFormatterWinstonFormatFactory.json
defineLogFormatterWinstonFormatFactory.log
definePrettyLoggerFormatterWinstonFormatFactory.pretty
resolveDefaultTransportOptionsWinstonLoggerFactory.resolveDefaultTransportOptions
deepSplatWinstonFormatFactory.deepSplat
platformaticRequirePluginPlatformaticKafkaPlugins.buildRequirePlugin
platformaticWasmPluginPlatformaticKafkaPlugins.buildWasmPlugin
platformaticKafkaPluginsPlatformaticKafkaPlugins.build

@venizia/ignis-boot (2) ​

Old nameNew form
generateArtifactIndexArtifactIndexGenerator.generate
checkArtifactIndexArtifactIndexGenerator.check

@venizia/ignis-kernel (25) ​

Old nameNew form
htmlContentOpenApiResponses.htmlContent
htmlResponseOpenApiResponses.htmlResponse
jsonContentOpenApiResponses.jsonContent
errorResponsesOpenApiResponses.errorResponses
jsonResponseOpenApiResponses.jsonResponse
requiredStringOpenApiSchemas.requiredString
idParamsSchemaOpenApiSchemas.idParams
asTypedContextContextUtility.asTypedContext
registerFactoryRepositoryInjectionControllerFactory.registerRepositoryInjection
toContentRangeDataRangeUtility.toContentRange
buildDataRangeDataRangeUtility.buildDataRange
toEntityIdModelUtility.toEntityId
snakeToCamelModelUtility.snakeToCamel
readDeclarativeRequestDomainResolver.readDeclarative
resolveRequestDomainRequestDomainResolver.resolveRequestDomain
pickRegistrationOptionsInjectableUtility.pickRegistrationOptions
emojiFaviconEmojiFaviconMiddleware.create
throwNotSupportedNotSupportedUtility.throwNotSupported
conditionalCountResponseRouteConfigResolver.conditionalCountResponse
resolveCountConfigRouteConfigResolver.resolveCountConfig
resolveFindConfigRouteConfigResolver.resolveFindConfig
resolveFindByIdConfigRouteConfigResolver.resolveFindByIdConfig
resolveFindOneConfigRouteConfigResolver.resolveFindOneConfig
resolveCreateConfigRouteConfigResolver.resolveCreateConfig
defineControllerRouteConfigsRouteConfigResolver.defineControllerRouteConfigs

@venizia/ignis-connectors (38) ​

Old nameNew form
generateDataTypeColumnDefsPostgresDataTypeEnricher.generateColumnDefs
enrichDataTypesPostgresDataTypeEnricher.enrich
generateIdColumnDefsPostgresIdEnricher.generateColumnDefs
enrichIdPostgresIdEnricher.enrich
generatePrincipalColumnDefsPostgresPrincipalEnricher.generateColumnDefs
enrichPrincipalPostgresPrincipalEnricher.enrich
generateTzColumnDefsPostgresTzEnricher.generateColumnDefs
enrichTzPostgresTzEnricher.enrich
generateUserAuditColumnDefsPostgresUserAuditEnricher.generateColumnDefs
enrichUserAuditPostgresUserAuditEnricher.enrich
generateDataTypeColumnDefsSqliteDataTypeEnricher.generateColumnDefs
enrichDataTypesSqliteDataTypeEnricher.enrich
generateIdColumnDefsSqliteIdEnricher.generateColumnDefs
enrichIdSqliteIdEnricher.enrich
generatePrincipalColumnDefsSqlitePrincipalEnricher.generateColumnDefs
enrichPrincipalSqlitePrincipalEnricher.enrich
generateTzColumnDefsSqliteTzEnricher.generateColumnDefs
enrichTzSqliteTzEnricher.enrich
generateUserAuditColumnDefsSqliteUserAuditEnricher.generateColumnDefs
enrichUserAuditSqliteUserAuditEnricher.enrich
assertScopeFilterSupportedScopeFilterUtility.assertScopeFilterSupported
getIdTypeRelationalEntityUtility.getIdType
resolveAuditUserIdAuditUserResolver.resolveAuditUserId
toRelationConfigsRelationDeclarations.toRelationConfigs
getCachedColumnsTableColumnCache.get
isJsonPathJsonPathUtility.isJsonPath
parseJsonPathJsonPathUtility.parseJsonPath
validateJsonPathComponentsJsonPathUtility.validateJsonPathComponents
validateJsonColumnTypeJsonPathUtility.validateJsonColumnType
createRelationsRelationsFactory.create
buildPostgresJsOptionsSupabasePooler.buildPostgresJsOptions
withAuthContextSupabaseRls.withAuthContext
defineSearchRouteConfigsSearchControllerFactory.defineRouteConfigs
defineSearchCollectionSearchCollectionFactory.define
deriveSearchDocumentSchemaSearchCollectionFactory.deriveDocumentSchema
toSearchQueryParamsSearchQueryParamsUtility.toSearchQueryParams
compileMeilisearchCollectionMeilisearchCollectionCompiler.compile
compileTypesenseCollectionTypesenseCollectionCompiler.compile

@venizia/ignis-worker (1) ​

Old nameNew form
installBffFetchBffFetchBridge.install

@venizia/ignis (20) ​

Old nameNew form
readRuntimeSnapshotBunRuntimeGuard.readSnapshot
assertBunRuntimeBunRuntimeGuard.assert
defineAuthControllerAuthControllerFactory.define
extraUserColumnsAuthModelColumns.buildUser
extraRoleColumnsAuthModelColumns.buildRole
extraPermissionColumnsAuthModelColumns.buildPermission
extraPolicyDefinitionColumnsAuthModelColumns.buildPolicyDefinition
policyDefinitionDomainShapeCheckAuthModelColumns.buildPolicyDefinitionDomainShapeCheck
splitAddressListMailAddressUtility.splitList
formatAddressHeaderMailMimeUtility.formatAddressHeader
buildRawMimeMessageMailMimeUtility.buildRawMessage
getExpiryTimeMailVerificationUtility.getExpiryTime
getExpiryTimeInHoursMailVerificationUtility.getExpiryTimeInHours
buildCommitTokenAssetCommitToken.build
readCommitTokenAssetCommitToken.read
findLabelsInQueryAssetControllerFactory.findLabelsInQuery
buildObjectLinkAssetControllerFactory.buildObjectLink
resolveServedContentTypeAssetControllerFactory.resolveServedContentType
assertApplicationBootsApplicationBootAssertion.assert
readResultRowsDrizzleResultUtility.readResultRows

@venizia/dev-configs (23) ​

Old nameNew form
findCatalogProblemsCatalogCheck.find
runModuleCyclesModuleCyclesCheck.run
assertNoWorkspaceExternalPurityManifest.assertNoWorkspaceExternal
deriveEntriesPurityManifest.deriveEntries
assertBrowserEsmEntryPurityManifest.assertBrowserEsmEntry
buildManifestPurityManifest.build
stripBundlerPathCommentsPurityProbe.stripBundlerPathComments
probeEntryPurityProbe.probeEntry
checkPurityPurityCheck.run
listTestTitlesTestControlsCheck.listTitles
checkControlsTestControlsCheck.run
findDeadTestCodeDeadTestCodeCheck.find
replayLedgerTestMutateCheck.replayLedger
formatLedgerResultsTestMutateCheck.formatLedgerResults
analyseJunitTestWeightCheck.analyseJunit
formatTestWeightTestWeightCheck.formatReport
rejectionOfRejectionHelper.rejectionOf
expectRejectionRejectionHelper.expectRejection
findRepositoryRootRepoTmp.findRoot
useRepoTmpRepoTmp.apply
spawnSyncBoundedSpawnHelper.spawnSyncBounded
readFieldAstNode.readField
nodeTypeAstNode.getType