joist-core 2.3.0 → 2.4.0-next.2

package/build/serde/serde.d.cts

@@ -0,0 +1,248 @@
+import { Temporal } from "./temporal.cjs";
+import { TypeInfo } from "./TypeInfo.cjs";
+//#region src/serde/serde.d.ts
+/** Scalar conversion only: no field names, entity hydration, or FK fixups. */
+interface ScalarCodec {
+  dbType: string;
+  isArray: boolean;
+  /** Compatibility evidence for scalar conversion, absent for unknown codecs. */
+  readonly outputType?: TypeInfo;
+  /** Encodes a domain value for a filter, i.e. an em.find WHERE parameter. */
+  mapToDb(value: any): any;
+  /**
+   * Encodes a domain value for an INSERT or UPDATE binding.
+   *
+   * Callers must handle omission, SQL NULL, and SQL expressions before encoding. JSON null and
+   * codec defaults can differ from SQL NULL. Direct mutations must validate reference targets
+   * and reject new or unflushed entities before encoding.
+   */
+  mapToDbValue?(value: unknown): unknown;
+  /** Converts a driver value to its domain value, including the codec's null/default handling. */
+  mapFromDb(value: unknown): unknown;
+  /**
+   * Converts a json_agg cell to a driver-row value, not a domain value.
+   *
+   * Lazy field hydration subsequently calls mapFromDb. I.e. Date codecs reconstruct a Date
+   * from the JSON string, while Temporal codecs retain the driver's string representation.
+   */
+  mapFromJsonAgg(value: any): any;
+  /** Reconstructs a driver value from a domain value, not a SQL binding. */
+  mapToRow(value: any): any;
+}
+/** Converts the ORM clock to the timestamp's domain representation. */
+interface TimestampCodec<T> extends ScalarCodec {
+  mapFromNow(now: Date): T;
+}
+/**
+ * Provides a simplified, public API for mapping between db/domain values.
+ *
+ * Joist's internal `FieldSerde` API is admittedly a little crufty, and so this
+ * API is intended to be a simpler, more user-friendly way to define custom types.
+ */
+interface CustomSerde<DomainType, DbType> {
+  toDb(value: DomainType): DbType;
+  fromDb(value: DbType): DomainType;
+}
+declare class CustomSerdeAdapter implements ScalarCodec {
+  dbType: string;
+  private mapper;
+  isArray: boolean;
+  constructor(dbType: string, mapper: CustomSerde<any, any>, isArray?: boolean);
+  /** Only known adapters share their mapper's identity and elementwise array conversion. */
+  get outputType(): TypeInfo | undefined;
+  /** Encodes each physical array element once. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts a driver value with the custom mapper, including array elements. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+/**
+ * Supports `string`, `int`, etc., as well as `string[]`, `int[]`, etc.
+ *
+ * This is not generally meant for subclassing, because it assumes things like
+ * `string[]`s can be mapped 1:1. See `CustomSerdeAdapter` a good base class
+ * that will handle converting individual elements.
+ */
+declare class PrimitiveSerde implements ScalarCodec {
+  dbType: string;
+  isArray: boolean;
+  constructor(dbType: string, isArray?: boolean);
+  /** Exact-class checks prevent an unknown subclass's overridden converters from sharing this codec. */
+  get outputType(): TypeInfo | undefined;
+  /** Primitive writes share their scalar/filter conversion, including subclass overrides. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Keeps driver values as-is, with SQL NULL represented as an unset entity field. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+declare class DateSerde extends PrimitiveSerde implements TimestampCodec<Date> {
+  /** Date bindings use ISO strings; mapToDb does not support physical Date arrays. */
+  get outputType(): TypeInfo | undefined;
+  /** Accept the caller's date as-is. */
+  mapFromNow(now: Date): Date;
+  mapFromJsonAgg(value: any): any;
+  /**
+   * Returns the `Date` a driver hands back on a read, and not `mapToDb`'s ISO string.
+   *
+   * Otherwise callers that round-trip a row through `rowValue` and back through `fromRow` (i.e.
+   * `RunPlugin` mirroring writes into the test em) turn every date into a string, because our
+   * `mapFromDb` returns the row value as-is.
+   */
+  mapToRow(value: any): any;
+  mapToDb(value: Date): string;
+}
+/** Converts `DATE`s `Temporal.PlainDate`s. */
+declare class PlainDateSerde extends CustomSerdeAdapter {
+  constructor(dbType: string, isArray?: boolean);
+}
+/** Converts `TIME`s to `Temporal.PlainTime`s. */
+declare class PlainTimeSerde extends CustomSerdeAdapter {
+  constructor(dbType: string, isArray?: boolean);
+}
+/** Converts `TIMESTAMP`s to `Temporal.PlainDateTime`s. */
+declare class PlainDateTimeSerde extends CustomSerdeAdapter implements TimestampCodec<Temporal.PlainDateTime> {
+  constructor(dbType: string, isArray?: boolean);
+  mapFromNow(now: Date): Temporal.PlainDateTime;
+}
+/** Converts `TIMESTAMP WITH TIME ZONE`s to `Temporal.ZonedDateTime`s. */
+declare class ZonedDateTimeSerde extends CustomSerdeAdapter implements TimestampCodec<Temporal.ZonedDateTime> {
+  constructor(dbType: string, isArray?: boolean);
+  mapFromNow(now: Date): Temporal.ZonedDateTime;
+}
+declare class BigIntSerde implements ScalarCodec {
+  isArray: boolean;
+  dbType: string;
+  constructor(isArray?: boolean);
+  /** BigInt conversion is distinct from both the driver's int8 value and Number aggregates. */
+  get outputType(): TypeInfo | undefined;
+  /** Drivers accept native bigint values without conversion. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts the driver's bigint representation to the entity value. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+/**
+ * Maps `decimal(...)` database types to the JS `number`.
+ *
+ * Note that we assume the db values are within the range of the JS `number`;
+ * we should eventually sanity check that.
+ *
+ * Also note that knex/pg accept `number`s as input, so we only need
+ * to handle from-database -> to JS translation.
+ */
+declare class DecimalToNumberSerde implements ScalarCodec {
+  isArray: boolean;
+  dbType: string;
+  constructor(isArray?: boolean);
+  /** Numeric aggregates use the same Number conversion and identity binding encoder. */
+  get outputType(): TypeInfo | undefined;
+  /** Drivers accept decimal numbers without conversion. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts a driver decimal value to a JavaScript number. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+/** Maps physical integer keys to logical string IDs "because GraphQL". */
+declare class KeySerde implements ScalarCodec {
+  dbType: "bigint" | "int" | "uuid" | "text";
+  isArray: boolean;
+  private meta;
+  constructor(tagName: string, dbType: "bigint" | "int" | "uuid" | "text");
+  /** PKs and FKs share a tag and SQL representation; the alias supplies the exact target idMeta. */
+  get outputType(): TypeInfo | undefined;
+  /** Resolves references and tagged, untagged, or numeric ids using the column's tag and storage type. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts a physical primary or foreign key to a tagged id. */
+  mapFromDb(value: unknown): string | undefined;
+  mapFromJsonAgg(value: any): any;
+}
+declare class EnumFieldSerde implements ScalarCodec {
+  dbType: "int" | "uuid";
+  private enumObject;
+  isArray: boolean;
+  constructor(dbType: "int" | "uuid", enumObject: any);
+  /** Separate fields of the same generated enum share its code/id mapping. */
+  get outputType(): TypeInfo | undefined;
+  /** Resolves the enum code to its stored id, leaving an unknown code unset. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts a stored enum id to its enum code. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+declare class EnumArrayFieldSerde implements ScalarCodec {
+  dbType: "int[]" | "uuid[]";
+  private enumObject;
+  isArray: boolean;
+  constructor(dbType: "int[]" | "uuid[]", enumObject: any);
+  /** Physical enum arrays reject null elements, unlike scalar enum arrayAgg; leave them unknown. */
+  get outputType(): undefined;
+  /** Resolves each enum code to its stored id, retaining the entity's empty-array default. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts stored enum ids to codes, defaulting an unset entity field to an empty array. */
+  mapFromDb(value: unknown): unknown[];
+  mapFromJsonAgg(value: any): any;
+}
+/** Similar to SimpleSerde, but applies the superstruct `assert` function when reading values from the db. */
+declare class SuperstructSerde implements ScalarCodec {
+  private superstruct;
+  dbType: string;
+  isArray: boolean;
+  private assert;
+  constructor(superstruct: any);
+  /** JSON schemas describe a jsonb value, even when that value is a JSON array. */
+  get outputType(): TypeInfo | undefined;
+  /** Serializes the domain JSON value without running the read-time schema validation. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): string;
+  /** Validates a driver JSON value with the field's Superstruct schema. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+declare class JsonSerde implements ScalarCodec {
+  dbType: string;
+  isArray: boolean;
+  constructor();
+  /** Unvalidated JSON uses its own encoder, not a primitive or schema-specific codec. */
+  get outputType(): TypeInfo | undefined;
+  /** Serializes the whole JSON value, including JSON arrays and custom toJSON methods. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): string;
+  /** Keeps the driver's parsed JSON value, normalizing SQL NULL for entity fields. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+/** Similar to SimpleSerde, but applies the zod's `parse` function when reading values from the db. */
+declare class ZodSerde implements ScalarCodec {
+  private zodSchema;
+  dbType: string;
+  isArray: boolean;
+  constructor(zodSchema: any);
+  /** Parsing and transformations are compatible only for the same schema object. */
+  get outputType(): TypeInfo | undefined;
+  /** Serializes the domain JSON value without running the read-time Zod parser or transforms. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): string;
+  /** Parses a driver JSON value with the field's Zod schema. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+//#endregion
+export { BigIntSerde, CustomSerde, CustomSerdeAdapter, DateSerde, DecimalToNumberSerde, EnumArrayFieldSerde, EnumFieldSerde, JsonSerde, KeySerde, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, PrimitiveSerde, ScalarCodec, SuperstructSerde, TimestampCodec, ZodSerde, ZonedDateTimeSerde };
+//# sourceMappingURL=serde.d.cts.map

package/build/serde/serde.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serde.d.cts","names":[],"sources":["../../src/serde/serde.ts"],"mappings":";;;;UAiBiB;EACf;EACA;;WAES,aAAa;;EAEtB,QAAQ;;;;;;;;EAQR,cAAc;;EAEd,UAAU;;;;;;;EAOV,eAAe;;EAEf,SAAS;;;UAIM,eAAe,WAAW;EACzC,WAAW,KAAK,OAAO;;;;;;;;UASR,YAAY,YAAY;EACvC,KAAK,OAAO,aAAa;EACzB,OAAO,OAAO,SAAS;;cAGZ,8BAA8B;EAIhC;UACC;EAJV;EAEA,YACS,gBACC,QAAQ,uBAChB;;MAME,cAAc;;EAuBlB,aAAa;EAQb,SAAS;EAIT,QAAQ;;EASR,UAAU;EASV,eAAe;;;;;;;;;cAkBJ,0BAA0B;EAE5B;EACA;EAFT,YACS,gBACA;;MAIL,cAAc;;EAclB,aAAa;EAIb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAIV,eAAe;;cAKJ,kBAAkB,0BAA0B,eAAe;;MAElE,cAAc;;EAOlB,WAAW,KAAK,OAAO;EAIvB,eAAe;;;;;;;;EAYf,SAAS;EAIT,QAAQ,OAAO;;;cAOJ,uBAAuB;EAClC,YAAY,gBAAgB;;;cAMjB,uBAAuB;EAClC,YAAY,gBAAgB;;;cAMjB,2BAA2B,8BAA8B,eAAe,SAAS;EAC5F,YAAY,gBAAgB;EAI5B,WAAW,KAAK,OAAO,SAAS;;;cAOrB,2BAA2B,8BAA8B,eAAe,SAAS;EAC5F,YAAY,gBAAgB;EAI5B,WAAW,KAAK,OAAO,SAAS;;cAMrB,uBAAuB;EAGf;EAFnB;EAEA,YAAmB;;MAKf,cAAc;;EAOlB,aAAa;EAKb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EASV,eAAe;;;;;;;;;;;cAcJ,gCAAgC;EAGxB;EAFnB;EAEA,YAAmB;;MAKf,cAAc;;EAOlB,aAAa;EAKb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EASV,eAAe;;;cAMJ,oBAAoB;EAUtB;EATT;UAEQ;EAKR,YACE,iBACO;;MASL,cAAc;;EAOlB,aAAa;EASb,SAAS;EAKT,QAAQ;;EAQR,UAAU;EAIV,eAAe;;cAKJ,0BAA0B;EAI5B;UACC;EAJV;EAEA,YACS,wBACC;;MAIN,cAAc;;EAOlB,aAAa;EAIb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAIV,eAAe;;cAKJ,+BAA+B;EAIjC;UACC;EAJV;EAEA,YACS,4BACC;;MAIN;;EAKJ,aAAa;EAIb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAIV,eAAe;;;cAMJ,4BAA4B;UAQnB;EAPpB;EACA;UAIQ;EAER,YAAoB;;MAGhB,cAAc;;EAOlB,aAAa;EAOb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAMV,eAAe;;cAKJ,qBAAqB;EAChC;EACA;EAEA;;MAGI,cAAc;;EAOlB,aAAa;EAOb,SAAS;EAKT,QAAQ;;EAKR,UAAU;EAIV,eAAe;;;cAMJ,oBAAoB;UAIX;EAHpB;EACA;EAEA,YAAoB;;MAGhB,cAAc;;EAOlB,aAAa;EAOb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAKV,eAAe"}

package/build/serde/serde.d.mts

@@ -0,0 +1,248 @@
+import { Temporal } from "./temporal.mjs";
+import { TypeInfo } from "./TypeInfo.mjs";
+//#region src/serde/serde.d.ts
+/** Scalar conversion only: no field names, entity hydration, or FK fixups. */
+interface ScalarCodec {
+  dbType: string;
+  isArray: boolean;
+  /** Compatibility evidence for scalar conversion, absent for unknown codecs. */
+  readonly outputType?: TypeInfo;
+  /** Encodes a domain value for a filter, i.e. an em.find WHERE parameter. */
+  mapToDb(value: any): any;
+  /**
+   * Encodes a domain value for an INSERT or UPDATE binding.
+   *
+   * Callers must handle omission, SQL NULL, and SQL expressions before encoding. JSON null and
+   * codec defaults can differ from SQL NULL. Direct mutations must validate reference targets
+   * and reject new or unflushed entities before encoding.
+   */
+  mapToDbValue?(value: unknown): unknown;
+  /** Converts a driver value to its domain value, including the codec's null/default handling. */
+  mapFromDb(value: unknown): unknown;
+  /**
+   * Converts a json_agg cell to a driver-row value, not a domain value.
+   *
+   * Lazy field hydration subsequently calls mapFromDb. I.e. Date codecs reconstruct a Date
+   * from the JSON string, while Temporal codecs retain the driver's string representation.
+   */
+  mapFromJsonAgg(value: any): any;
+  /** Reconstructs a driver value from a domain value, not a SQL binding. */
+  mapToRow(value: any): any;
+}
+/** Converts the ORM clock to the timestamp's domain representation. */
+interface TimestampCodec<T> extends ScalarCodec {
+  mapFromNow(now: Date): T;
+}
+/**
+ * Provides a simplified, public API for mapping between db/domain values.
+ *
+ * Joist's internal `FieldSerde` API is admittedly a little crufty, and so this
+ * API is intended to be a simpler, more user-friendly way to define custom types.
+ */
+interface CustomSerde<DomainType, DbType> {
+  toDb(value: DomainType): DbType;
+  fromDb(value: DbType): DomainType;
+}
+declare class CustomSerdeAdapter implements ScalarCodec {
+  dbType: string;
+  private mapper;
+  isArray: boolean;
+  constructor(dbType: string, mapper: CustomSerde<any, any>, isArray?: boolean);
+  /** Only known adapters share their mapper's identity and elementwise array conversion. */
+  get outputType(): TypeInfo | undefined;
+  /** Encodes each physical array element once. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts a driver value with the custom mapper, including array elements. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+/**
+ * Supports `string`, `int`, etc., as well as `string[]`, `int[]`, etc.
+ *
+ * This is not generally meant for subclassing, because it assumes things like
+ * `string[]`s can be mapped 1:1. See `CustomSerdeAdapter` a good base class
+ * that will handle converting individual elements.
+ */
+declare class PrimitiveSerde implements ScalarCodec {
+  dbType: string;
+  isArray: boolean;
+  constructor(dbType: string, isArray?: boolean);
+  /** Exact-class checks prevent an unknown subclass's overridden converters from sharing this codec. */
+  get outputType(): TypeInfo | undefined;
+  /** Primitive writes share their scalar/filter conversion, including subclass overrides. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Keeps driver values as-is, with SQL NULL represented as an unset entity field. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+declare class DateSerde extends PrimitiveSerde implements TimestampCodec<Date> {
+  /** Date bindings use ISO strings; mapToDb does not support physical Date arrays. */
+  get outputType(): TypeInfo | undefined;
+  /** Accept the caller's date as-is. */
+  mapFromNow(now: Date): Date;
+  mapFromJsonAgg(value: any): any;
+  /**
+   * Returns the `Date` a driver hands back on a read, and not `mapToDb`'s ISO string.
+   *
+   * Otherwise callers that round-trip a row through `rowValue` and back through `fromRow` (i.e.
+   * `RunPlugin` mirroring writes into the test em) turn every date into a string, because our
+   * `mapFromDb` returns the row value as-is.
+   */
+  mapToRow(value: any): any;
+  mapToDb(value: Date): string;
+}
+/** Converts `DATE`s `Temporal.PlainDate`s. */
+declare class PlainDateSerde extends CustomSerdeAdapter {
+  constructor(dbType: string, isArray?: boolean);
+}
+/** Converts `TIME`s to `Temporal.PlainTime`s. */
+declare class PlainTimeSerde extends CustomSerdeAdapter {
+  constructor(dbType: string, isArray?: boolean);
+}
+/** Converts `TIMESTAMP`s to `Temporal.PlainDateTime`s. */
+declare class PlainDateTimeSerde extends CustomSerdeAdapter implements TimestampCodec<Temporal.PlainDateTime> {
+  constructor(dbType: string, isArray?: boolean);
+  mapFromNow(now: Date): Temporal.PlainDateTime;
+}
+/** Converts `TIMESTAMP WITH TIME ZONE`s to `Temporal.ZonedDateTime`s. */
+declare class ZonedDateTimeSerde extends CustomSerdeAdapter implements TimestampCodec<Temporal.ZonedDateTime> {
+  constructor(dbType: string, isArray?: boolean);
+  mapFromNow(now: Date): Temporal.ZonedDateTime;
+}
+declare class BigIntSerde implements ScalarCodec {
+  isArray: boolean;
+  dbType: string;
+  constructor(isArray?: boolean);
+  /** BigInt conversion is distinct from both the driver's int8 value and Number aggregates. */
+  get outputType(): TypeInfo | undefined;
+  /** Drivers accept native bigint values without conversion. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts the driver's bigint representation to the entity value. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+/**
+ * Maps `decimal(...)` database types to the JS `number`.
+ *
+ * Note that we assume the db values are within the range of the JS `number`;
+ * we should eventually sanity check that.
+ *
+ * Also note that knex/pg accept `number`s as input, so we only need
+ * to handle from-database -> to JS translation.
+ */
+declare class DecimalToNumberSerde implements ScalarCodec {
+  isArray: boolean;
+  dbType: string;
+  constructor(isArray?: boolean);
+  /** Numeric aggregates use the same Number conversion and identity binding encoder. */
+  get outputType(): TypeInfo | undefined;
+  /** Drivers accept decimal numbers without conversion. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts a driver decimal value to a JavaScript number. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+/** Maps physical integer keys to logical string IDs "because GraphQL". */
+declare class KeySerde implements ScalarCodec {
+  dbType: "bigint" | "int" | "uuid" | "text";
+  isArray: boolean;
+  private meta;
+  constructor(tagName: string, dbType: "bigint" | "int" | "uuid" | "text");
+  /** PKs and FKs share a tag and SQL representation; the alias supplies the exact target idMeta. */
+  get outputType(): TypeInfo | undefined;
+  /** Resolves references and tagged, untagged, or numeric ids using the column's tag and storage type. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts a physical primary or foreign key to a tagged id. */
+  mapFromDb(value: unknown): string | undefined;
+  mapFromJsonAgg(value: any): any;
+}
+declare class EnumFieldSerde implements ScalarCodec {
+  dbType: "int" | "uuid";
+  private enumObject;
+  isArray: boolean;
+  constructor(dbType: "int" | "uuid", enumObject: any);
+  /** Separate fields of the same generated enum share its code/id mapping. */
+  get outputType(): TypeInfo | undefined;
+  /** Resolves the enum code to its stored id, leaving an unknown code unset. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts a stored enum id to its enum code. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+declare class EnumArrayFieldSerde implements ScalarCodec {
+  dbType: "int[]" | "uuid[]";
+  private enumObject;
+  isArray: boolean;
+  constructor(dbType: "int[]" | "uuid[]", enumObject: any);
+  /** Physical enum arrays reject null elements, unlike scalar enum arrayAgg; leave them unknown. */
+  get outputType(): undefined;
+  /** Resolves each enum code to its stored id, retaining the entity's empty-array default. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): any;
+  /** Converts stored enum ids to codes, defaulting an unset entity field to an empty array. */
+  mapFromDb(value: unknown): unknown[];
+  mapFromJsonAgg(value: any): any;
+}
+/** Similar to SimpleSerde, but applies the superstruct `assert` function when reading values from the db. */
+declare class SuperstructSerde implements ScalarCodec {
+  private superstruct;
+  dbType: string;
+  isArray: boolean;
+  private assert;
+  constructor(superstruct: any);
+  /** JSON schemas describe a jsonb value, even when that value is a JSON array. */
+  get outputType(): TypeInfo | undefined;
+  /** Serializes the domain JSON value without running the read-time schema validation. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): string;
+  /** Validates a driver JSON value with the field's Superstruct schema. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+declare class JsonSerde implements ScalarCodec {
+  dbType: string;
+  isArray: boolean;
+  constructor();
+  /** Unvalidated JSON uses its own encoder, not a primitive or schema-specific codec. */
+  get outputType(): TypeInfo | undefined;
+  /** Serializes the whole JSON value, including JSON arrays and custom toJSON methods. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): string;
+  /** Keeps the driver's parsed JSON value, normalizing SQL NULL for entity fields. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+/** Similar to SimpleSerde, but applies the zod's `parse` function when reading values from the db. */
+declare class ZodSerde implements ScalarCodec {
+  private zodSchema;
+  dbType: string;
+  isArray: boolean;
+  constructor(zodSchema: any);
+  /** Parsing and transformations are compatible only for the same schema object. */
+  get outputType(): TypeInfo | undefined;
+  /** Serializes the domain JSON value without running the read-time Zod parser or transforms. */
+  mapToDbValue(value: unknown): unknown;
+  mapToRow(value: any): any;
+  mapToDb(value: any): string;
+  /** Parses a driver JSON value with the field's Zod schema. */
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+}
+//#endregion
+export { BigIntSerde, CustomSerde, CustomSerdeAdapter, DateSerde, DecimalToNumberSerde, EnumArrayFieldSerde, EnumFieldSerde, JsonSerde, KeySerde, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, PrimitiveSerde, ScalarCodec, SuperstructSerde, TimestampCodec, ZodSerde, ZonedDateTimeSerde };
+//# sourceMappingURL=serde.d.mts.map

package/build/serde/serde.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serde.d.mts","names":[],"sources":["../../src/serde/serde.ts"],"mappings":";;;;UAiBiB;EACf;EACA;;WAES,aAAa;;EAEtB,QAAQ;;;;;;;;EAQR,cAAc;;EAEd,UAAU;;;;;;;EAOV,eAAe;;EAEf,SAAS;;;UAIM,eAAe,WAAW;EACzC,WAAW,KAAK,OAAO;;;;;;;;UASR,YAAY,YAAY;EACvC,KAAK,OAAO,aAAa;EACzB,OAAO,OAAO,SAAS;;cAGZ,8BAA8B;EAIhC;UACC;EAJV;EAEA,YACS,gBACC,QAAQ,uBAChB;;MAME,cAAc;;EAuBlB,aAAa;EAQb,SAAS;EAIT,QAAQ;;EASR,UAAU;EASV,eAAe;;;;;;;;;cAkBJ,0BAA0B;EAE5B;EACA;EAFT,YACS,gBACA;;MAIL,cAAc;;EAclB,aAAa;EAIb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAIV,eAAe;;cAKJ,kBAAkB,0BAA0B,eAAe;;MAElE,cAAc;;EAOlB,WAAW,KAAK,OAAO;EAIvB,eAAe;;;;;;;;EAYf,SAAS;EAIT,QAAQ,OAAO;;;cAOJ,uBAAuB;EAClC,YAAY,gBAAgB;;;cAMjB,uBAAuB;EAClC,YAAY,gBAAgB;;;cAMjB,2BAA2B,8BAA8B,eAAe,SAAS;EAC5F,YAAY,gBAAgB;EAI5B,WAAW,KAAK,OAAO,SAAS;;;cAOrB,2BAA2B,8BAA8B,eAAe,SAAS;EAC5F,YAAY,gBAAgB;EAI5B,WAAW,KAAK,OAAO,SAAS;;cAMrB,uBAAuB;EAGf;EAFnB;EAEA,YAAmB;;MAKf,cAAc;;EAOlB,aAAa;EAKb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EASV,eAAe;;;;;;;;;;;cAcJ,gCAAgC;EAGxB;EAFnB;EAEA,YAAmB;;MAKf,cAAc;;EAOlB,aAAa;EAKb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EASV,eAAe;;;cAMJ,oBAAoB;EAUtB;EATT;UAEQ;EAKR,YACE,iBACO;;MASL,cAAc;;EAOlB,aAAa;EASb,SAAS;EAKT,QAAQ;;EAQR,UAAU;EAIV,eAAe;;cAKJ,0BAA0B;EAI5B;UACC;EAJV;EAEA,YACS,wBACC;;MAIN,cAAc;;EAOlB,aAAa;EAIb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAIV,eAAe;;cAKJ,+BAA+B;EAIjC;UACC;EAJV;EAEA,YACS,4BACC;;MAIN;;EAKJ,aAAa;EAIb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAIV,eAAe;;;cAMJ,4BAA4B;UAQnB;EAPpB;EACA;UAIQ;EAER,YAAoB;;MAGhB,cAAc;;EAOlB,aAAa;EAOb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAMV,eAAe;;cAKJ,qBAAqB;EAChC;EACA;EAEA;;MAGI,cAAc;;EAOlB,aAAa;EAOb,SAAS;EAKT,QAAQ;;EAKR,UAAU;EAIV,eAAe;;;cAMJ,oBAAoB;UAIX;EAHpB;EACA;EAEA,YAAoB;;MAGhB,cAAc;;EAOlB,aAAa;EAOb,SAAS;EAIT,QAAQ;;EAKR,UAAU;EAKV,eAAe"}