bazis 0.104.0 → 0.104.1

package/core/infra/connectors/codex/CodexAppServerClient.ts

@@ -232,7 +232,7 @@ export class CodexAppServerClient implements CodexClient {
         if (method === "account/updated") this.modelCache = undefined;
       }, () => { this.clearLogin(); this.modelCache = undefined; });
       const initialized = await client.request("initialize", {
-        clientInfo: { name: "bazis", title: "Bazis", version: "0.104.0" }, capabilities: { experimentalApi: true },
+        clientInfo: { name: "bazis", title: "Bazis", version: "0.104.1" }, capabilities: { experimentalApi: true },
       }, 15_000, signal);
       if (resolve(text(initialized.codexHome, 4096)) !== this.paths.home) throw new CodexError("PROTOCOL_ERROR");
       client.notify("initialized");

package/library/orm/Metadata/ValueConverter.ts

@@ -13,6 +13,12 @@ export interface ValueConverter<TModel = unknown, TProvider = unknown> {
    * the query fails instead of silently matching nothing.
    */
   readonly comparable?: boolean;
+  /**
+   * `true`: the converter also gets `null` (both ways), for example to store
+   * `null` as `""`. By default `null` stays SQL NULL and the converter is
+   * not called, as in EF Core.
+   */
+  readonly convertsNulls?: boolean;
 }
 
 /** Thrown by an encrypted column that cannot be read: another key, or the stored value was changed. */

package/library/orm/Providers/propertyConversion.ts

@@ -2,16 +2,24 @@ import { OrmError } from "../errors";
 import type { PropertyModel } from "../Metadata/types";
 import type { SqlDialect, SqlParam } from "./types";
 
+/**
+ * Whether the converter of the property applies to the value: `null` and
+ * `undefined` stay SQL NULL unless the converter declares `convertsNulls`.
+ */
+export function convertsValue(property: PropertyModel, value: unknown): boolean {
+  return property.converter !== undefined && (property.converter.convertsNulls === true || (value !== null && value !== undefined));
+}
+
 /** Encodes a property value: converter -> dialect. */
 export function encodeProperty(property: PropertyModel, value: unknown, dialect: SqlDialect): SqlParam {
-  const modelValue = property.converter ? property.converter.toProvider(value) : value;
+  const modelValue = convertsValue(property, value) ? property.converter!.toProvider(value) : value;
   return dialect.encode(modelValue, property.type);
 }
 
 /** Decodes a column value: dialect -> converter. A converter failure names the entity and the property. */
 export function decodeProperty(property: PropertyModel, value: unknown, dialect: SqlDialect, owner?: string): unknown {
   const providerValue = dialect.decode(value, property.type);
-  if (!property.converter) return providerValue;
+  if (!property.converter || !convertsValue(property, providerValue)) return providerValue;
   try {
     return property.converter.fromProvider(providerValue);
   } catch (error) {

package/library/orm/Query/ImmediateMutations.ts

@@ -1,6 +1,7 @@
 import { types } from "node:util";
 import { OrmError, OrmTrackedMutationConflictError, OrmUndeclaredConflictTargetError, OrmUnsafeImmediateMutationError } from "../errors";
 import { isDatabaseGenerated, type EntityModel, type PropertyModel } from "../Metadata/types";
+import { convertsValue } from "../Providers/propertyConversion";
 import type { DbContextRuntime } from "../runtime";
 import { hasTrackedEntriesForModel } from "../Tracking/ChangeTracker";
 import { isPostgresJsonScalarParameter } from "../Providers/PostgresDialect";
@@ -136,11 +137,11 @@ function admitInsertValues<T extends object>(model: EntityModel, entity: T): rea
 }
 function unsetKey(value: unknown): boolean { return value === undefined || value === null || value === "" || value === 0; }
 function encodeAssignments(runtime: DbContextRuntime, assignments: readonly AdmittedAssignment[]): readonly { readonly property: PropertyModel; readonly value: SqlParam }[] {
-  return Object.freeze(assignments.map(({ property, value }) => Object.freeze({ property, value: value === null ? null : encode(runtime, property, value) })));
+  return Object.freeze(assignments.map(({ property, value }) => Object.freeze({ property, value: value === null && !convertsValue(property, null) ? null : encode(runtime, property, value) })));
 }
 function encode(runtime: DbContextRuntime, property: PropertyModel, input: unknown, allowNull = false): SqlParam {
   try {
-    const providerValue = property.converter ? property.converter.toProvider(input) : input;
+    const providerValue = convertsValue(property, input) ? property.converter!.toProvider(input) : input;
     const safeProvider = storageValue(providerValue, property.type, allowNull);
     return snapshotEncodedSqlParam(runtime.provider.dialect.encode(safeProvider, property.type));
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bazis",
-  "version": "0.104.0",
+  "version": "0.104.1",
   "description": "Modular backend framework for Bun in TypeScript: DI wired by codegen, HTTP, a PostgreSQL ORM, JWT, WebSocket, agents and a CLI.",
   "license": "MIT",
   "author": "Alexander Alenin",