Stormify

Holds the library-wide defaultInstance used when no instance is explicitly attached.

When enabled, throws on field/column mismatches; when disabled, logs warnings.

The logger used by this Stormify instance. Defaults to a logger named "Stormify".

The naming policy used to convert Kotlin property names to database column names. Default is NamingPolicy.LOWER_CASE_WITH_UNDERSCORES (snake_case). Changing this only affects entities resolved after the change.

The SQL dialect used by this Stormify instance. Auto-detected from the data source on first access. Can be set manually for proxy scenarios where auto-detection fails.

Excludes a field name from all entity mappings (e.g. inherited fields that have no database column).

Sets this instance as defaultInstance and returns it.

Runs block with this instance as the default, restoring the previous default when the block exits. Use for scoped overrides such as per-request tenants.

Attaches this Stormify instance to target so the target can use it for database operations without receiving it as an explicit parameter.

Inserts a new entity into the database and returns it with generated values populated.

Inserts multiple entities in a batch and returns them. Generated keys are only populated for single-item batches.

Deletes an entity from the database based on its primary key.

Deletes multiple entities from the database based on their primary keys.

Executes an SQL UPDATE/INSERT/DELETE and returns the number of affected rows.

Finds all entities, optionally filtered by a WHERE clause.

Finds a single entity by its primary key value (single PK only).

Retrieves all detail (child) entities related to a parent entity through a foreign key.

Type-safe variant of getDetails that accepts an annotation-processor-generated reference path (e.g. Paths.AuditEntry_.createdBy) instead of a string. The compiler guarantees the referenced property exists on the child type, so typos and renames surface at build time rather than on first query.

Returns the TableInfo metadata for the given entity class, resolving and caching it if necessary.

Refreshes an entity with fresh data from the database based on its primary key.

Executes a stored procedure with IN / OUT / INOUT parameters.

Executes a SELECT query and returns all results as a list.

Executes a SELECT query and processes results row-by-row via consumer. Returns row count.

Executes a SELECT query and returns exactly one result, or null if none found.

Registers a primary key resolver used when no @Id or @DbField(primaryKey=true) annotation is present. The resolver receives the table name and field name and returns true if the field is a primary key. Lower priority values are evaluated first.

Removes a previously blacklisted field name, allowing it to be mapped again.

Wraps this Stormify instance with a coroutine-aware transaction API backed by a DefaultSuspendConnectionPool configured with config. Safe to call multiple times with different configs; each returned SuspendStormify is independent.

Executes a block within a database transaction with automatic commit/rollback.

Updates an existing entity in the database based on its primary key.

Updates multiple entities in a batch based on their primary keys.