joist-core 2.3.0 → 2.4.0-next.2

package/build/serde/serde.js

@@ -0,0 +1,485 @@
+import { requireTemporal } from "./temporal.js";
+import { keyToNumber, keyToTaggedId, maybeResolveReferenceToId } from "../keys.js";
+import { arrayOutputType, canonicalDbType } from "./TypeInfo.js";
+import { getRuntimeConfig } from "../runtimeConfig.js";
+import { plainDateMapper, plainDateTimeMapper, plainTimeMapper, zonedDateTimeMapper } from "./temporalMappers.js";
+import { isDefined } from "../EntityManager.js";
+import { createRequire } from "node:module";
+//#region src/serde/serde.ts
+const runtimeRequire = createRequire(import.meta.url);
+var CustomSerdeAdapter = class CustomSerdeAdapter {
+	dbType;
+	mapper;
+	isArray = false;
+	constructor(dbType, mapper, isArray) {
+		this.dbType = dbType;
+		this.mapper = mapper;
+		if (isArray !== void 0) this.isArray = isArray;
+	}
+	/** Only known adapters share their mapper's identity and elementwise array conversion. */
+	get outputType() {
+		if (this.isArray !== this.dbType.endsWith("[]") || this.constructor !== CustomSerdeAdapter && this.constructor !== PlainDateSerde && this.constructor !== PlainTimeSerde && this.constructor !== PlainDateTimeSerde && this.constructor !== ZonedDateTimeSerde) return;
+		const dbType = canonicalDbType(this.dbType);
+		const elementType = this.isArray ? dbType.slice(0, -2) : dbType;
+		const outputType = {
+			dbType: elementType,
+			domain: this.mapper,
+			arrayElementSafe: elementType !== "numeric"
+		};
+		if (!this.isArray) return outputType;
+		return arrayOutputType(outputType) || [
+			"date",
+			"time",
+			"timestamp",
+			"timestamptz"
+		].includes(elementType) ? {
+			dbType,
+			domain: this.mapper
+		} : void 0;
+	}
+	/** Encodes each physical array element once. */
+	mapToDbValue(value) {
+		return value !== void 0 ? this.isArray ? value.map((element) => this.mapper.toDb(element)) : this.mapper.toDb(value) : void 0;
+	}
+	mapToRow(value) {
+		return this.mapToDbValue(value);
+	}
+	mapToDb(value) {
+		return value === null ? value : this.isArray ? value.map((element) => this.mapper.toDb(element)) : this.mapper.toDb(value);
+	}
+	/** Converts a driver value with the custom mapper, including array elements. */
+	mapFromDb(value) {
+		const dbValue = maybeNullToUndefined(value);
+		return dbValue !== void 0 ? this.isArray ? dbValue.map((value) => this.mapper.fromDb(value)) : this.mapper.fromDb(dbValue) : void 0;
+	}
+	mapFromJsonAgg(value) {
+		return value;
+	}
+};
+/**
+* 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.
+*/
+var PrimitiveSerde = class PrimitiveSerde {
+	dbType;
+	isArray;
+	constructor(dbType, isArray = false) {
+		this.dbType = dbType;
+		this.isArray = isArray;
+	}
+	/** Exact-class checks prevent an unknown subclass's overridden converters from sharing this codec. */
+	get outputType() {
+		if (this.constructor !== PrimitiveSerde) return void 0;
+		const dbType = canonicalDbType(this.dbType);
+		const elementType = dbType.endsWith("[]") ? dbType.slice(0, -2) : dbType;
+		if (this.isArray !== dbType.endsWith("[]")) return void 0;
+		const outputType = {
+			dbType: elementType,
+			domain: primitiveOutputDomain(elementType),
+			arrayElementSafe: elementType !== "numeric"
+		};
+		return this.isArray ? arrayOutputType(outputType) : outputType;
+	}
+	/** Primitive writes share their scalar/filter conversion, including subclass overrides. */
+	mapToDbValue(value) {
+		return this.mapToDb(value);
+	}
+	mapToRow(value) {
+		return this.mapToDbValue(value);
+	}
+	mapToDb(value) {
+		return value;
+	}
+	/** Keeps driver values as-is, with SQL NULL represented as an unset entity field. */
+	mapFromDb(value) {
+		return maybeNullToUndefined(value);
+	}
+	mapFromJsonAgg(value) {
+		return value;
+	}
+};
+var DateSerde = class DateSerde extends PrimitiveSerde {
+	/** Date bindings use ISO strings; mapToDb does not support physical Date arrays. */
+	get outputType() {
+		return this.constructor === DateSerde && !this.isArray && !this.dbType.endsWith("[]") ? {
+			dbType: canonicalDbType(this.dbType),
+			domain: DateSerde
+		} : void 0;
+	}
+	/** Accept the caller's date as-is. */
+	mapFromNow(now) {
+		return now;
+	}
+	mapFromJsonAgg(value) {
+		if (value === null) return value;
+		return new Date(value);
+	}
+	/**
+	* 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) {
+		return value;
+	}
+	mapToDb(value) {
+		return value?.toISOString();
+	}
+};
+/** Converts `DATE`s `Temporal.PlainDate`s. */
+var PlainDateSerde = class extends CustomSerdeAdapter {
+	constructor(dbType, isArray = false) {
+		super(dbType, plainDateMapper, isArray);
+	}
+};
+/** Converts `TIME`s to `Temporal.PlainTime`s. */
+var PlainTimeSerde = class extends CustomSerdeAdapter {
+	constructor(dbType, isArray = false) {
+		super(dbType, plainTimeMapper, isArray);
+	}
+};
+/** Converts `TIMESTAMP`s to `Temporal.PlainDateTime`s. */
+var PlainDateTimeSerde = class extends CustomSerdeAdapter {
+	constructor(dbType, isArray = false) {
+		super(dbType, plainDateTimeMapper, isArray);
+	}
+	mapFromNow(now) {
+		const { timeZone } = getRuntimeConfig().temporal;
+		return requireTemporal().toTemporalInstant.call(now).toZonedDateTimeISO(timeZone).toPlainDateTime();
+	}
+};
+/** Converts `TIMESTAMP WITH TIME ZONE`s to `Temporal.ZonedDateTime`s. */
+var ZonedDateTimeSerde = class extends CustomSerdeAdapter {
+	constructor(dbType, isArray = false) {
+		super(dbType, zonedDateTimeMapper, isArray);
+	}
+	mapFromNow(now) {
+		const { timeZone } = getRuntimeConfig().temporal;
+		return requireTemporal().toTemporalInstant.call(now).toZonedDateTimeISO(timeZone);
+	}
+};
+var BigIntSerde = class BigIntSerde {
+	isArray;
+	dbType;
+	constructor(isArray = false) {
+		this.isArray = isArray;
+		this.dbType = isArray ? "bigint[]" : "bigint";
+	}
+	/** BigInt conversion is distinct from both the driver's int8 value and Number aggregates. */
+	get outputType() {
+		if (this.constructor !== BigIntSerde) return void 0;
+		const elementType = {
+			dbType: "int8",
+			domain: BigIntSerde,
+			arrayElementSafe: true
+		};
+		return this.isArray ? arrayOutputType(elementType) : elementType;
+	}
+	/** Drivers accept native bigint values without conversion. */
+	mapToDbValue(value) {
+		if (this.isArray) assertFlatNumericArray(value);
+		return value;
+	}
+	mapToRow(value) {
+		return this.mapToDbValue(value);
+	}
+	mapToDb(value) {
+		return value;
+	}
+	/** Converts the driver's bigint representation to the entity value. */
+	mapFromDb(value) {
+		const dbValue = maybeNullToUndefined(value);
+		if (this.isArray && dbValue !== void 0) {
+			assertFlatNumericArray(dbValue);
+			return dbValue.map((element) => element === null ? null : BigInt(element));
+		}
+		return dbValue ? BigInt(dbValue) : dbValue;
+	}
+	mapFromJsonAgg(value) {
+		return value === null ? value : this.isArray ? this.mapFromDb(value) : BigInt(value);
+	}
+};
+/**
+* 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.
+*/
+var DecimalToNumberSerde = class DecimalToNumberSerde {
+	isArray;
+	dbType;
+	constructor(isArray = false) {
+		this.isArray = isArray;
+		this.dbType = isArray ? "numeric[]" : "decimal";
+	}
+	/** Numeric aggregates use the same Number conversion and identity binding encoder. */
+	get outputType() {
+		if (this.constructor !== DecimalToNumberSerde) return void 0;
+		const elementType = {
+			dbType: "numeric",
+			domain: Number,
+			arrayElementSafe: true
+		};
+		return this.isArray ? arrayOutputType(elementType) : elementType;
+	}
+	/** Drivers accept decimal numbers without conversion. */
+	mapToDbValue(value) {
+		if (this.isArray) assertFlatNumericArray(value);
+		return value;
+	}
+	mapToRow(value) {
+		return this.mapToDbValue(value);
+	}
+	mapToDb(value) {
+		return value;
+	}
+	/** Converts a driver decimal value to a JavaScript number. */
+	mapFromDb(value) {
+		const dbValue = maybeNullToUndefined(value);
+		if (this.isArray && dbValue !== void 0) {
+			assertFlatNumericArray(dbValue);
+			return dbValue.map((element) => element === null ? null : Number(element));
+		}
+		return dbValue !== void 0 ? Number(dbValue) : dbValue;
+	}
+	mapFromJsonAgg(value) {
+		return value === null ? value : this.isArray ? this.mapFromDb(value) : Number(value);
+	}
+};
+/** Maps physical integer keys to logical string IDs "because GraphQL". */
+var KeySerde = class KeySerde {
+	dbType;
+	isArray = false;
+	meta;
+	constructor(tagName, dbType) {
+		this.dbType = dbType;
+		this.meta = {
+			tagName,
+			idDbType: dbType
+		};
+	}
+	/** PKs and FKs share a tag and SQL representation; the alias supplies the exact target idMeta. */
+	get outputType() {
+		return this.constructor === KeySerde && !this.isArray ? {
+			dbType: canonicalDbType(this.dbType),
+			domain: `key:${this.meta.tagName}`,
+			arrayElementSafe: true
+		} : void 0;
+	}
+	/** Resolves references and tagged, untagged, or numeric ids using the column's tag and storage type. */
+	mapToDbValue(value) {
+		return keyToNumber(this.meta, typeof value === "number" ? value : maybeResolveReferenceToId(value));
+	}
+	mapToRow(value) {
+		return this.mapToDbValue(value);
+	}
+	mapToDb(value) {
+		if (value === null || typeof value === "number") return value;
+		return keyToNumber(this.meta, maybeResolveReferenceToId(value));
+	}
+	/** Converts a physical primary or foreign key to a tagged id. */
+	mapFromDb(value) {
+		return keyToTaggedId(this.meta, value);
+	}
+	mapFromJsonAgg(value) {
+		return value === null ? value : value;
+	}
+};
+var EnumFieldSerde = class EnumFieldSerde {
+	dbType;
+	enumObject;
+	isArray = false;
+	constructor(dbType, enumObject) {
+		this.dbType = dbType;
+		this.enumObject = enumObject;
+	}
+	/** Separate fields of the same generated enum share its code/id mapping. */
+	get outputType() {
+		return this.constructor === EnumFieldSerde && !this.isArray ? {
+			dbType: canonicalDbType(this.dbType),
+			domain: this.enumObject,
+			arrayElementSafe: true
+		} : void 0;
+	}
+	/** Resolves the enum code to its stored id, leaving an unknown code unset. */
+	mapToDbValue(value) {
+		return this.enumObject.findByCode(value)?.id;
+	}
+	mapToRow(value) {
+		return this.mapToDbValue(value);
+	}
+	mapToDb(value) {
+		return this.enumObject.findByCode(value)?.id;
+	}
+	/** Converts a stored enum id to its enum code. */
+	mapFromDb(value) {
+		return this.enumObject.findById(value)?.code;
+	}
+	mapFromJsonAgg(value) {
+		return value === null ? value : value;
+	}
+};
+var EnumArrayFieldSerde = class {
+	dbType;
+	enumObject;
+	isArray = true;
+	constructor(dbType, enumObject) {
+		this.dbType = dbType;
+		this.enumObject = enumObject;
+	}
+	/** Physical enum arrays reject null elements, unlike scalar enum arrayAgg; leave them unknown. */
+	get outputType() {}
+	/** Resolves each enum code to its stored id, retaining the entity's empty-array default. */
+	mapToDbValue(value) {
+		return value?.map((code) => this.enumObject.getByCode(code).id) || [];
+	}
+	mapToRow(value) {
+		return this.mapToDbValue(value);
+	}
+	mapToDb(value) {
+		return !value ? [] : value.map((code) => this.enumObject.getByCode(code).id);
+	}
+	/** Converts stored enum ids to codes, defaulting an unset entity field to an empty array. */
+	mapFromDb(value) {
+		return value?.map((id) => this.enumObject.findById(id).code) || [];
+	}
+	mapFromJsonAgg(value) {
+		return value === null ? value : value;
+	}
+};
+/** Similar to SimpleSerde, but applies the superstruct `assert` function when reading values from the db. */
+var SuperstructSerde = class SuperstructSerde {
+	superstruct;
+	dbType = "jsonb";
+	isArray = false;
+	assert = runtimeRequire("superstruct").assert;
+	constructor(superstruct) {
+		this.superstruct = superstruct;
+	}
+	/** JSON schemas describe a jsonb value, even when that value is a JSON array. */
+	get outputType() {
+		return this.constructor === SuperstructSerde && !this.isArray ? {
+			dbType: canonicalDbType(this.dbType),
+			domain: this.superstruct,
+			arrayElementSafe: true
+		} : void 0;
+	}
+	/** Serializes the domain JSON value without running the read-time schema validation. */
+	mapToDbValue(value) {
+		return JSON.stringify(value);
+	}
+	mapToRow(value) {
+		return value;
+	}
+	mapToDb(value) {
+		return JSON.stringify(value);
+	}
+	/** Validates a driver JSON value with the field's Superstruct schema. */
+	mapFromDb(value) {
+		const dbValue = maybeNullToUndefined(value);
+		if (dbValue) this.assert(dbValue, this.superstruct);
+		return dbValue;
+	}
+	mapFromJsonAgg(value) {
+		return value === null ? value : value;
+	}
+};
+var JsonSerde = class JsonSerde {
+	dbType = "jsonb";
+	isArray = false;
+	constructor() {}
+	/** Unvalidated JSON uses its own encoder, not a primitive or schema-specific codec. */
+	get outputType() {
+		return this.constructor === JsonSerde && !this.isArray ? {
+			dbType: canonicalDbType(this.dbType),
+			domain: JsonSerde,
+			arrayElementSafe: true
+		} : void 0;
+	}
+	/** Serializes the whole JSON value, including JSON arrays and custom toJSON methods. */
+	mapToDbValue(value) {
+		return JSON.stringify(value);
+	}
+	mapToRow(value) {
+		const json = JSON.stringify(value);
+		return isDefined(json) ? JSON.parse(json) : void 0;
+	}
+	mapToDb(value) {
+		return JSON.stringify(value);
+	}
+	/** Keeps the driver's parsed JSON value, normalizing SQL NULL for entity fields. */
+	mapFromDb(value) {
+		return maybeNullToUndefined(value);
+	}
+	mapFromJsonAgg(value) {
+		return value === null ? value : value;
+	}
+};
+/** Similar to SimpleSerde, but applies the zod's `parse` function when reading values from the db. */
+var ZodSerde = class ZodSerde {
+	zodSchema;
+	dbType = "jsonb";
+	isArray = false;
+	constructor(zodSchema) {
+		this.zodSchema = zodSchema;
+	}
+	/** Parsing and transformations are compatible only for the same schema object. */
+	get outputType() {
+		return this.constructor === ZodSerde && !this.isArray ? {
+			dbType: canonicalDbType(this.dbType),
+			domain: this.zodSchema,
+			arrayElementSafe: true
+		} : void 0;
+	}
+	/** Serializes the domain JSON value without running the read-time Zod parser or transforms. */
+	mapToDbValue(value) {
+		return JSON.stringify(value);
+	}
+	mapToRow(value) {
+		return value;
+	}
+	mapToDb(value) {
+		return JSON.stringify(value);
+	}
+	/** Parses a driver JSON value with the field's Zod schema. */
+	mapFromDb(value) {
+		const dbValue = maybeNullToUndefined(value);
+		return dbValue ? this.zodSchema.parse(dbValue) : dbValue;
+	}
+	mapFromJsonAgg(value) {
+		return value === null ? value : value;
+	}
+};
+/** PostgreSQL does not enforce declared array dimensions; reject nested values rather than coercing subarrays. */
+function assertFlatNumericArray(value) {
+	if (Array.isArray(value) && value.some(Array.isArray)) throw new Error("Native numeric arrays must be one-dimensional");
+}
+/** Only driver-native numbers agree with Number aggregates; int8/numeric identity values do not. */
+function primitiveOutputDomain(dbType) {
+	switch (dbType) {
+		case "int2":
+		case "int4":
+		case "float4":
+		case "float8": return Number;
+		case "text":
+		case "varchar":
+		case "bpchar": return String;
+		default: return PrimitiveSerde;
+	}
+}
+/** Normalizes SQL NULL to an unset entity field. */
+function maybeNullToUndefined(value) {
+	return value === null ? void 0 : value;
+}
+//#endregion
+export { BigIntSerde, CustomSerdeAdapter, DateSerde, DecimalToNumberSerde, EnumArrayFieldSerde, EnumFieldSerde, JsonSerde, KeySerde, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, PrimitiveSerde, SuperstructSerde, ZodSerde, ZonedDateTimeSerde };
+
+//# sourceMappingURL=serde.js.map

package/build/serde/serde.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serde.js","names":[],"sources":["../../src/serde/serde.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\n\nimport { isDefined } from \"src/EntityManager.ts\";\nimport { keyToNumber, keyToTaggedId, maybeResolveReferenceToId } from \"src/keys.ts\";\nimport { getRuntimeConfig } from \"src/runtimeConfig.ts\";\nimport { type Temporal, requireTemporal } from \"src/serde/temporal.ts\";\nimport {\n  plainDateMapper,\n  plainDateTimeMapper,\n  plainTimeMapper,\n  zonedDateTimeMapper,\n} from \"src/serde/temporalMappers.ts\";\nimport { type TypeInfo, arrayOutputType, canonicalDbType } from \"src/serde/TypeInfo.ts\";\n\nconst runtimeRequire = createRequire(import.meta.url);\n\n/** Scalar conversion only: no field names, entity hydration, or FK fixups. */\nexport interface ScalarCodec {\n  dbType: string;\n  isArray: boolean;\n  /** Compatibility evidence for scalar conversion, absent for unknown codecs. */\n  readonly outputType?: TypeInfo;\n  /** Encodes a domain value for a filter, i.e. an em.find WHERE parameter. */\n  mapToDb(value: any): any;\n  /**\n   * Encodes a domain value for an INSERT or UPDATE binding.\n   *\n   * Callers must handle omission, SQL NULL, and SQL expressions before encoding. JSON null and\n   * codec defaults can differ from SQL NULL. Direct mutations must validate reference targets\n   * and reject new or unflushed entities before encoding.\n   */\n  mapToDbValue?(value: unknown): unknown;\n  /** Converts a driver value to its domain value, including the codec's null/default handling. */\n  mapFromDb(value: unknown): unknown;\n  /**\n   * Converts a json_agg cell to a driver-row value, not a domain value.\n   *\n   * Lazy field hydration subsequently calls mapFromDb. I.e. Date codecs reconstruct a Date\n   * from the JSON string, while Temporal codecs retain the driver's string representation.\n   */\n  mapFromJsonAgg(value: any): any;\n  /** Reconstructs a driver value from a domain value, not a SQL binding. */\n  mapToRow(value: any): any;\n}\n\n/** Converts the ORM clock to the timestamp's domain representation. */\nexport interface TimestampCodec<T> extends ScalarCodec {\n  mapFromNow(now: Date): T;\n}\n\n/**\n * Provides a simplified, public API for mapping between db/domain values.\n *\n * Joist's internal `FieldSerde` API is admittedly a little crufty, and so this\n * API is intended to be a simpler, more user-friendly way to define custom types.\n */\nexport interface CustomSerde<DomainType, DbType> {\n  toDb(value: DomainType): DbType;\n  fromDb(value: DbType): DomainType;\n}\n\nexport class CustomSerdeAdapter implements ScalarCodec {\n  isArray: boolean = false;\n\n  constructor(\n    public dbType: string,\n    private mapper: CustomSerde<any, any>,\n    isArray?: boolean,\n  ) {\n    if (isArray !== undefined) this.isArray = isArray;\n  }\n\n  /** Only known adapters share their mapper's identity and elementwise array conversion. */\n  get outputType(): TypeInfo | undefined {\n    if (\n      this.isArray !== this.dbType.endsWith(\"[]\") ||\n      (this.constructor !== CustomSerdeAdapter &&\n        this.constructor !== PlainDateSerde &&\n        this.constructor !== PlainTimeSerde &&\n        this.constructor !== PlainDateTimeSerde &&\n        this.constructor !== ZonedDateTimeSerde)\n    ) {\n      return undefined;\n    }\n    const dbType = canonicalDbType(this.dbType);\n    // A numeric mapper may require scalar text; classic pg decodes numeric[] elements as numbers.\n    const elementType = this.isArray ? dbType.slice(0, -2) : dbType;\n    const outputType = { dbType: elementType, domain: this.mapper, arrayElementSafe: elementType !== \"numeric\" };\n    if (!this.isArray) return outputType;\n    // Physical arrays pass null elements to the mapper, unlike scalar arrayAgg; keep their domains distinct.\n    return arrayOutputType(outputType) || [\"date\", \"time\", \"timestamp\", \"timestamptz\"].includes(elementType)\n      ? { dbType, domain: this.mapper }\n      : undefined;\n  }\n\n  /** Encodes each physical array element once. */\n  mapToDbValue(value: unknown): unknown {\n    return value !== undefined\n      ? this.isArray\n        ? (value as readonly unknown[]).map((element) => this.mapper.toDb(element))\n        : this.mapper.toDb(value)\n      : undefined;\n  }\n\n  mapToRow(value: any): any {\n    return this.mapToDbValue(value);\n  }\n\n  mapToDb(value: any): any {\n    return value === null\n      ? value\n      : this.isArray\n        ? value.map((element: unknown) => this.mapper.toDb(element))\n        : this.mapper.toDb(value);\n  }\n\n  /** Converts a driver value with the custom mapper, including array elements. */\n  mapFromDb(value: unknown): unknown {\n    const dbValue = maybeNullToUndefined(value);\n    return dbValue !== undefined\n      ? this.isArray\n        ? dbValue.map((value: unknown) => this.mapper.fromDb(value))\n        : this.mapper.fromDb(dbValue)\n      : undefined;\n  }\n\n  mapFromJsonAgg(value: any): any {\n    // Assume the database JSON value matches the ResultSet value\n    return value;\n    // return value === null\n    //   ? value\n    //   : this.isArray\n    //     ? value.map((value: any) => this.mapper.fromDb(value))\n    //     : this.mapper.fromDb(value);\n  }\n}\n\n/**\n * Supports `string`, `int`, etc., as well as `string[]`, `int[]`, etc.\n *\n * This is not generally meant for subclassing, because it assumes things like\n * `string[]`s can be mapped 1:1. See `CustomSerdeAdapter` a good base class\n * that will handle converting individual elements.\n */\nexport class PrimitiveSerde implements ScalarCodec {\n  constructor(\n    public dbType: string,\n    public isArray = false,\n  ) {}\n\n  /** Exact-class checks prevent an unknown subclass's overridden converters from sharing this codec. */\n  get outputType(): TypeInfo | undefined {\n    if (this.constructor !== PrimitiveSerde) return undefined;\n    const dbType = canonicalDbType(this.dbType);\n    const elementType = dbType.endsWith(\"[]\") ? dbType.slice(0, -2) : dbType;\n    if (this.isArray !== dbType.endsWith(\"[]\")) return undefined;\n    const outputType = {\n      dbType: elementType,\n      domain: primitiveOutputDomain(elementType),\n      arrayElementSafe: elementType !== \"numeric\",\n    };\n    return this.isArray ? arrayOutputType(outputType) : outputType;\n  }\n\n  /** Primitive writes share their scalar/filter conversion, including subclass overrides. */\n  mapToDbValue(value: unknown): unknown {\n    return this.mapToDb(value);\n  }\n\n  mapToRow(value: any): any {\n    return this.mapToDbValue(value);\n  }\n\n  mapToDb(value: any) {\n    return value;\n  }\n\n  /** Keeps driver values as-is, with SQL NULL represented as an unset entity field. */\n  mapFromDb(value: unknown): unknown {\n    return maybeNullToUndefined(value);\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value;\n  }\n}\n\nexport class DateSerde extends PrimitiveSerde implements TimestampCodec<Date> {\n  /** Date bindings use ISO strings; mapToDb does not support physical Date arrays. */\n  get outputType(): TypeInfo | undefined {\n    return this.constructor === DateSerde && !this.isArray && !this.dbType.endsWith(\"[]\")\n      ? { dbType: canonicalDbType(this.dbType), domain: DateSerde }\n      : undefined;\n  }\n\n  /** Accept the caller's date as-is. */\n  mapFromNow(now: Date): Date {\n    return now;\n  }\n\n  mapFromJsonAgg(value: any): any {\n    if (value === null) return value;\n    return new Date(value);\n  }\n\n  /**\n   * Returns the `Date` a driver hands back on a read, and not `mapToDb`'s ISO string.\n   *\n   * Otherwise callers that round-trip a row through `rowValue` and back through `fromRow` (i.e.\n   * `RunPlugin` mirroring writes into the test em) turn every date into a string, because our\n   * `mapFromDb` returns the row value as-is.\n   */\n  mapToRow(value: any): any {\n    return value;\n  }\n\n  mapToDb(value: Date) {\n    // bun.sql needs this, node-pg does it out of the box\n    return value?.toISOString();\n  }\n}\n\n/** Converts `DATE`s `Temporal.PlainDate`s. */\nexport class PlainDateSerde extends CustomSerdeAdapter {\n  constructor(dbType: string, isArray = false) {\n    super(dbType, plainDateMapper, isArray);\n  }\n}\n\n/** Converts `TIME`s to `Temporal.PlainTime`s. */\nexport class PlainTimeSerde extends CustomSerdeAdapter {\n  constructor(dbType: string, isArray = false) {\n    super(dbType, plainTimeMapper, isArray);\n  }\n}\n\n/** Converts `TIMESTAMP`s to `Temporal.PlainDateTime`s. */\nexport class PlainDateTimeSerde extends CustomSerdeAdapter implements TimestampCodec<Temporal.PlainDateTime> {\n  constructor(dbType: string, isArray = false) {\n    super(dbType, plainDateTimeMapper, isArray);\n  }\n\n  mapFromNow(now: Date): Temporal.PlainDateTime {\n    const { timeZone } = getRuntimeConfig().temporal as any;\n    return requireTemporal().toTemporalInstant.call(now).toZonedDateTimeISO(timeZone).toPlainDateTime();\n  }\n}\n\n/** Converts `TIMESTAMP WITH TIME ZONE`s to `Temporal.ZonedDateTime`s. */\nexport class ZonedDateTimeSerde extends CustomSerdeAdapter implements TimestampCodec<Temporal.ZonedDateTime> {\n  constructor(dbType: string, isArray = false) {\n    super(dbType, zonedDateTimeMapper, isArray);\n  }\n\n  mapFromNow(now: Date): Temporal.ZonedDateTime {\n    const { timeZone } = getRuntimeConfig().temporal as any;\n    return requireTemporal().toTemporalInstant.call(now).toZonedDateTimeISO(timeZone);\n  }\n}\n\nexport class BigIntSerde implements ScalarCodec {\n  dbType: string;\n\n  constructor(public isArray = false) {\n    this.dbType = isArray ? \"bigint[]\" : \"bigint\";\n  }\n\n  /** BigInt conversion is distinct from both the driver's int8 value and Number aggregates. */\n  get outputType(): TypeInfo | undefined {\n    if (this.constructor !== BigIntSerde) return undefined;\n    const elementType = { dbType: \"int8\", domain: BigIntSerde, arrayElementSafe: true };\n    return this.isArray ? arrayOutputType(elementType) : elementType;\n  }\n\n  /** Drivers accept native bigint values without conversion. */\n  mapToDbValue(value: unknown): unknown {\n    if (this.isArray) assertFlatNumericArray(value);\n    return value;\n  }\n\n  mapToRow(value: any): any {\n    return this.mapToDbValue(value);\n  }\n\n  mapToDb(value: any) {\n    return value;\n  }\n\n  /** Converts the driver's bigint representation to the entity value. */\n  mapFromDb(value: unknown): unknown {\n    const dbValue = maybeNullToUndefined(value);\n    if (this.isArray && dbValue !== undefined) {\n      assertFlatNumericArray(dbValue);\n      return dbValue.map((element: string | bigint | number | null) => (element === null ? null : BigInt(element)));\n    }\n    return dbValue ? BigInt(dbValue) : dbValue;\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value === null ? value : this.isArray ? this.mapFromDb(value) : BigInt(value);\n  }\n}\n\n/**\n * Maps `decimal(...)` database types to the JS `number`.\n *\n * Note that we assume the db values are within the range of the JS `number`;\n * we should eventually sanity check that.\n *\n * Also note that knex/pg accept `number`s as input, so we only need\n * to handle from-database -> to JS translation.\n */\nexport class DecimalToNumberSerde implements ScalarCodec {\n  dbType: string;\n\n  constructor(public isArray = false) {\n    this.dbType = isArray ? \"numeric[]\" : \"decimal\";\n  }\n\n  /** Numeric aggregates use the same Number conversion and identity binding encoder. */\n  get outputType(): TypeInfo | undefined {\n    if (this.constructor !== DecimalToNumberSerde) return undefined;\n    const elementType = { dbType: \"numeric\", domain: Number, arrayElementSafe: true };\n    return this.isArray ? arrayOutputType(elementType) : elementType;\n  }\n\n  /** Drivers accept decimal numbers without conversion. */\n  mapToDbValue(value: unknown): unknown {\n    if (this.isArray) assertFlatNumericArray(value);\n    return value;\n  }\n\n  mapToRow(value: any): any {\n    return this.mapToDbValue(value);\n  }\n\n  mapToDb(value: any) {\n    return value;\n  }\n\n  /** Converts a driver decimal value to a JavaScript number. */\n  mapFromDb(value: unknown): unknown {\n    const dbValue = maybeNullToUndefined(value);\n    if (this.isArray && dbValue !== undefined) {\n      assertFlatNumericArray(dbValue);\n      return dbValue.map((element: string | number | null) => (element === null ? null : Number(element)));\n    }\n    return dbValue !== undefined ? Number(dbValue) : dbValue;\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value === null ? value : this.isArray ? this.mapFromDb(value) : Number(value);\n  }\n}\n\n/** Maps physical integer keys to logical string IDs \"because GraphQL\". */\nexport class KeySerde implements ScalarCodec {\n  isArray = false;\n\n  private meta: {\n    tagName: string;\n    idDbType: \"bigint\" | \"int\" | \"uuid\" | \"text\";\n  };\n\n  constructor(\n    tagName: string,\n    public dbType: \"bigint\" | \"int\" | \"uuid\" | \"text\",\n  ) {\n    this.meta = {\n      tagName,\n      idDbType: dbType,\n    };\n  }\n\n  /** PKs and FKs share a tag and SQL representation; the alias supplies the exact target idMeta. */\n  get outputType(): TypeInfo | undefined {\n    return this.constructor === KeySerde && !this.isArray\n      ? { dbType: canonicalDbType(this.dbType), domain: `key:${this.meta.tagName}`, arrayElementSafe: true }\n      : undefined;\n  }\n\n  /** Resolves references and tagged, untagged, or numeric ids using the column's tag and storage type. */\n  mapToDbValue(value: unknown): unknown {\n    return keyToNumber(\n      this.meta,\n      typeof value === \"number\"\n        ? value\n        : maybeResolveReferenceToId(value as Parameters<typeof maybeResolveReferenceToId>[0]),\n    );\n  }\n\n  mapToRow(value: any): any {\n    // we don't have any fixups since we are trying to recreate what comes out of the db, so this is safe\n    return this.mapToDbValue(value);\n  }\n\n  mapToDb(value: any) {\n    // Numeric IDs are already database values; tagged string IDs still need to be resolved and untagged.\n    if (value === null || typeof value === \"number\") return value;\n    // We go through `maybeResolveReferenceToId` because filters like `in: [a1, a2]` pass entities directly.\n    return keyToNumber(this.meta, maybeResolveReferenceToId(value));\n  }\n\n  /** Converts a physical primary or foreign key to a tagged id. */\n  mapFromDb(value: unknown): string | undefined {\n    return keyToTaggedId(this.meta, value as string | number);\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value === null ? value : value;\n  }\n}\n\nexport class EnumFieldSerde implements ScalarCodec {\n  isArray = false;\n\n  constructor(\n    public dbType: \"int\" | \"uuid\",\n    private enumObject: any,\n  ) {}\n\n  /** Separate fields of the same generated enum share its code/id mapping. */\n  get outputType(): TypeInfo | undefined {\n    return this.constructor === EnumFieldSerde && !this.isArray\n      ? { dbType: canonicalDbType(this.dbType), domain: this.enumObject, arrayElementSafe: true }\n      : undefined;\n  }\n\n  /** Resolves the enum code to its stored id, leaving an unknown code unset. */\n  mapToDbValue(value: unknown): unknown {\n    return this.enumObject.findByCode(value)?.id;\n  }\n\n  mapToRow(value: any): any {\n    return this.mapToDbValue(value);\n  }\n\n  mapToDb(value: any) {\n    return this.enumObject.findByCode(value)?.id;\n  }\n\n  /** Converts a stored enum id to its enum code. */\n  mapFromDb(value: unknown): unknown {\n    return this.enumObject.findById(value)?.code;\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value === null ? value : value;\n  }\n}\n\nexport class EnumArrayFieldSerde implements ScalarCodec {\n  isArray = true;\n\n  constructor(\n    public dbType: \"int[]\" | \"uuid[]\",\n    private enumObject: any,\n  ) {}\n\n  /** Physical enum arrays reject null elements, unlike scalar enum arrayAgg; leave them unknown. */\n  get outputType(): undefined {\n    return undefined;\n  }\n\n  /** Resolves each enum code to its stored id, retaining the entity's empty-array default. */\n  mapToDbValue(value: unknown): unknown {\n    return (value as readonly unknown[] | null | undefined)?.map((code) => this.enumObject.getByCode(code).id) || [];\n  }\n\n  mapToRow(value: any): any {\n    return this.mapToDbValue(value);\n  }\n\n  mapToDb(value: any) {\n    return !value ? [] : value.map((code: any) => this.enumObject.getByCode(code).id);\n  }\n\n  /** Converts stored enum ids to codes, defaulting an unset entity field to an empty array. */\n  mapFromDb(value: unknown): unknown[] {\n    return (value as readonly unknown[] | null | undefined)?.map((id) => this.enumObject.findById(id).code) || [];\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value === null ? value : value;\n  }\n}\n\n/** Similar to SimpleSerde, but applies the superstruct `assert` function when reading values from the db. */\nexport class SuperstructSerde implements ScalarCodec {\n  dbType = \"jsonb\";\n  isArray = false;\n\n  // Use a dynamic require so that downstream projects don't have to depend on superstruct\n  // until they want to, i.e. we don't have superstruct in the joist-orm package.json.\n  private assert = runtimeRequire(\"superstruct\").assert;\n\n  constructor(private superstruct: any) {}\n\n  /** JSON schemas describe a jsonb value, even when that value is a JSON array. */\n  get outputType(): TypeInfo | undefined {\n    return this.constructor === SuperstructSerde && !this.isArray\n      ? { dbType: canonicalDbType(this.dbType), domain: this.superstruct, arrayElementSafe: true }\n      : undefined;\n  }\n\n  /** Serializes the domain JSON value without running the read-time schema validation. */\n  mapToDbValue(value: unknown): unknown {\n    return JSON.stringify(value);\n  }\n\n  // JSON is returned by postgres already parsed, so we should just be able to return our data directly. Unlike with\n  // JsonSerde, we can assume that superstruct would have parsed any complex types in the json correctly so we don't\n  // need to do a round trip through JSON.stringify.\n  mapToRow(value: any): any {\n    return value;\n  }\n\n  mapToDb(value: any) {\n    return JSON.stringify(value);\n  }\n\n  /** Validates a driver JSON value with the field's Superstruct schema. */\n  mapFromDb(value: unknown): unknown {\n    const dbValue = maybeNullToUndefined(value);\n    if (dbValue) this.assert(dbValue, this.superstruct);\n    return dbValue;\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value === null ? value : value;\n  }\n}\n\nexport class JsonSerde implements ScalarCodec {\n  dbType = \"jsonb\";\n  isArray = false;\n\n  constructor() {}\n\n  /** Unvalidated JSON uses its own encoder, not a primitive or schema-specific codec. */\n  get outputType(): TypeInfo | undefined {\n    return this.constructor === JsonSerde && !this.isArray\n      ? { dbType: canonicalDbType(this.dbType), domain: JsonSerde, arrayElementSafe: true }\n      : undefined;\n  }\n\n  /** Serializes the whole JSON value, including JSON arrays and custom toJSON methods. */\n  mapToDbValue(value: unknown): unknown {\n    return JSON.stringify(value);\n  }\n\n  // JSON is returned by postgres already parsed, so if we are trying to recreate then we need to stringify, then parse.\n  // It's necessary to do this instead of just returning the object directly because any complex types in the json need\n  // to be stringified to correctly reflect the db value.\n  mapToRow(value: any): any {\n    const json = JSON.stringify(value);\n    return isDefined(json) ? JSON.parse(json) : undefined;\n  }\n\n  mapToDb(value: any) {\n    return JSON.stringify(value);\n  }\n\n  /** Keeps the driver's parsed JSON value, normalizing SQL NULL for entity fields. */\n  mapFromDb(value: unknown): unknown {\n    return maybeNullToUndefined(value);\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value === null ? value : value;\n  }\n}\n\n/** Similar to SimpleSerde, but applies the zod's `parse` function when reading values from the db. */\nexport class ZodSerde implements ScalarCodec {\n  dbType = \"jsonb\";\n  isArray = false;\n\n  constructor(private zodSchema: any) {}\n\n  /** Parsing and transformations are compatible only for the same schema object. */\n  get outputType(): TypeInfo | undefined {\n    return this.constructor === ZodSerde && !this.isArray\n      ? { dbType: canonicalDbType(this.dbType), domain: this.zodSchema, arrayElementSafe: true }\n      : undefined;\n  }\n\n  /** Serializes the domain JSON value without running the read-time Zod parser or transforms. */\n  mapToDbValue(value: unknown): unknown {\n    return JSON.stringify(value);\n  }\n\n  // JSON is returned by postgres already parsed, so we should just be able to return our data directly. Unlike with\n  // JsonSerde, we can assume that zod would have parsed any complex types in the json correctly so we don't need to\n  // do a round trip through JSON.stringify.\n  mapToRow(value: any): any {\n    return value;\n  }\n\n  mapToDb(value: any) {\n    return JSON.stringify(value);\n  }\n\n  /** Parses a driver JSON value with the field's Zod schema. */\n  mapFromDb(value: unknown): unknown {\n    const dbValue = maybeNullToUndefined(value);\n    return dbValue ? this.zodSchema.parse(dbValue) : dbValue;\n  }\n\n  mapFromJsonAgg(value: any): any {\n    return value === null ? value : value;\n  }\n}\n\n/** PostgreSQL does not enforce declared array dimensions; reject nested values rather than coercing subarrays. */\nfunction assertFlatNumericArray(value: unknown): void {\n  if (Array.isArray(value) && value.some(Array.isArray)) {\n    throw new Error(\"Native numeric arrays must be one-dimensional\");\n  }\n}\n\n/** Only driver-native numbers agree with Number aggregates; int8/numeric identity values do not. */\nfunction primitiveOutputDomain(dbType: string): unknown {\n  switch (dbType) {\n    case \"int2\":\n    case \"int4\":\n    case \"float4\":\n    case \"float8\":\n      return Number;\n    case \"text\":\n    case \"varchar\":\n    case \"bpchar\":\n      return String;\n    default:\n      return PrimitiveSerde;\n  }\n}\n\n/** Normalizes SQL NULL to an unset entity field. */\nfunction maybeNullToUndefined(value: any): any {\n  return value === null ? undefined : value;\n}\n"],"mappings":"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"}

package/build/serde/temporal.cjs

@@ -0,0 +1,57 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/serde/temporal.ts
+const runtimeRequire = (0, require("node:module").createRequire)(require("url").pathToFileURL(__filename).href);
+let temporal;
+/**
+* Lazily exposes Joist's native-first / polyfill-fallback Temporal detection.
+*
+* This is useful while the joist-orm repo itself has both pre-Node 26, and post-Node 26
+* test coverage, b/c our CI test suite needs the same a) codegen output and b) test suites
+* to "just work" with either Node 24/25 or Node 26, which means they can't have an explicit
+* import to either `temporal-polyfill` or the `Temporal` global.
+*
+* This is exactly what Joist's internal temporal resolution was already working around, so
+* this just exposes an `import { Temporal } from joist-orm` that lets the codegen & tests
+* reuse the same abstraction.
+*/
+const Temporal = new Proxy({}, { get(_target, property, receiver) {
+	return Reflect.get(requireTemporal().Temporal, property, receiver);
+} });
+/**
+* Conditionally/dynamically requires `temporal-polyfill`.
+*
+* We want to avoid directly importing/requiring `temporal-polyfill` because
+* it will introduce the dependency to all users of Joist.
+*/
+function maybeRequireTemporal() {
+	if (temporal === false) return void 0;
+	if (temporal) return temporal;
+	if ("Temporal" in global && "Intl" in global) {
+		temporal = {
+			Temporal: global.Temporal,
+			toTemporalInstant: Date.prototype.toTemporalInstant,
+			Intl: global.Intl
+		};
+		return temporal;
+	}
+	try {
+		temporal = runtimeRequire("temporal-polyfill");
+		return temporal;
+	} catch (e) {}
+	try {
+		temporal = runtimeRequire("@js-temporal/polyfill");
+		return temporal;
+	} catch (e) {}
+	temporal = false;
+}
+function requireTemporal() {
+	const temporal = maybeRequireTemporal();
+	if (!temporal) throw new Error("Unable to find a Temporal implementation");
+	return temporal;
+}
+//#endregion
+exports.Temporal = Temporal;
+exports.maybeRequireTemporal = maybeRequireTemporal;
+exports.requireTemporal = requireTemporal;
+
+//# sourceMappingURL=temporal.cjs.map

package/build/serde/temporal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.cjs","names":["createRequire"],"sources":["../../src/serde/temporal.ts"],"sourcesContent":["/// <reference types=\"temporal-spec/global\" preserve=\"true\" />\n\nimport { createRequire } from \"node:module\";\n\nconst runtimeRequire = createRequire(import.meta.url);\n\n// Native Temporal and both supported polyfills expose this shape; use the shared spec types instead of duplicating it.\ntype TemporalModule = typeof import(\"temporal-spec\");\nlet temporal: TemporalModule | undefined | false;\n\n/**\n * Lazily exposes Joist's native-first / polyfill-fallback Temporal detection.\n *\n * This is useful while the joist-orm repo itself has both pre-Node 26, and post-Node 26\n * test coverage, b/c our CI test suite needs the same a) codegen output and b) test suites\n * to \"just work\" with either Node 24/25 or Node 26, which means they can't have an explicit\n * import to either `temporal-polyfill` or the `Temporal` global.\n *\n * This is exactly what Joist's internal temporal resolution was already working around, so\n * this just exposes an `import { Temporal } from joist-orm` that lets the codegen & tests\n * reuse the same abstraction.\n */\nexport const Temporal = new Proxy(\n  {},\n  {\n    get(_target, property, receiver) {\n      return Reflect.get(requireTemporal().Temporal, property, receiver);\n    },\n  },\n) as typeof globalThis.Temporal;\n\n/**\n * A type-only `Temporal` namespace that merges with the `const Temporal` above.\n *\n * The `const` is only a value, so using `Temporal.PlainDate` / `Temporal.ZonedDateTime` as a\n * type needs a namespace to resolve against. Node 26 has that as a global, but older Node\n * versions don't, so `temporal-spec/global` supplies the same global namespace as a fallback.\n */\nexport declare namespace Temporal {\n  export type Instant = globalThis.Temporal.Instant;\n  export type ZonedDateTime = globalThis.Temporal.ZonedDateTime;\n  export type PlainDate = globalThis.Temporal.PlainDate;\n  export type PlainTime = globalThis.Temporal.PlainTime;\n  export type PlainDateTime = globalThis.Temporal.PlainDateTime;\n  export type PlainYearMonth = globalThis.Temporal.PlainYearMonth;\n  export type PlainMonthDay = globalThis.Temporal.PlainMonthDay;\n  export type Duration = globalThis.Temporal.Duration;\n}\n\n/**\n * Conditionally/dynamically requires `temporal-polyfill`.\n *\n * We want to avoid directly importing/requiring `temporal-polyfill` because\n * it will introduce the dependency to all users of Joist.\n */\nexport function maybeRequireTemporal(): TemporalModule | undefined {\n  // if we've already failed to find a temporal implementation before, early exit\n  if (temporal === false) return undefined;\n  // if we already required temporal, just return that\n  if (temporal) return temporal;\n  // use built in temporal if present\n  if (\"Temporal\" in global && \"Intl\" in global) {\n    temporal = {\n      Temporal: global.Temporal as typeof globalThis.Temporal,\n      toTemporalInstant: Date.prototype.toTemporalInstant,\n      Intl: global.Intl,\n    };\n    return temporal;\n  }\n  // preferentially try to use temporal-polyfill\n  try {\n    temporal = runtimeRequire(\"temporal-polyfill\");\n    return temporal as TemporalModule;\n  } catch (e) {}\n  // last resort, try to use @js-temporal/polyfill\n  try {\n    temporal = runtimeRequire(\"@js-temporal/polyfill\");\n    return temporal as TemporalModule;\n  } catch (e) {}\n  // don't try to load temporal again\n  temporal = false;\n  return undefined;\n}\n\nexport function requireTemporal(): TemporalModule {\n  const temporal = maybeRequireTemporal();\n  if (!temporal) throw new Error(\"Unable to find a Temporal implementation\");\n  return temporal;\n}\n"],"mappings":";;AAIA,MAAM,kBAAA,wBAAiBA,CAAAA,CAAAA,cAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,IAA6B;AAIpD,IAAI;;;;;;;;;;;;;AAcJ,MAAa,WAAW,IAAI,MAC1B,CAAC,GACD,EACE,IAAI,SAAS,UAAU,UAAU;CAC/B,OAAO,QAAQ,IAAI,gBAAgB,CAAC,CAAC,UAAU,UAAU,QAAQ;AACnE,EACF,CACF;;;;;;;AA0BA,SAAgB,uBAAmD;CAEjE,IAAI,aAAa,OAAO,OAAO,KAAA;CAE/B,IAAI,UAAU,OAAO;CAErB,IAAI,cAAc,UAAU,UAAU,QAAQ;EAC5C,WAAW;GACT,UAAU,OAAO;GACjB,mBAAmB,KAAK,UAAU;GAClC,MAAM,OAAO;EACf;EACA,OAAO;CACT;CAEA,IAAI;EACF,WAAW,eAAe,mBAAmB;EAC7C,OAAO;CACT,SAAS,GAAG,CAAC;CAEb,IAAI;EACF,WAAW,eAAe,uBAAuB;EACjD,OAAO;CACT,SAAS,GAAG,CAAC;CAEb,WAAW;AAEb;AAEA,SAAgB,kBAAkC;CAChD,MAAM,WAAW,qBAAqB;CACtC,IAAI,CAAC,UAAU,MAAM,IAAI,MAAM,0CAA0C;CACzE,OAAO;AACT"}

package/build/serde/temporal.d.cts

@@ -0,0 +1,44 @@
+/// <reference types="temporal-spec/global" preserve="true" />
+//#region src/serde/temporal.d.ts
+type TemporalModule = typeof import("temporal-spec");
+/**
+ * Lazily exposes Joist's native-first / polyfill-fallback Temporal detection.
+ *
+ * This is useful while the joist-orm repo itself has both pre-Node 26, and post-Node 26
+ * test coverage, b/c our CI test suite needs the same a) codegen output and b) test suites
+ * to "just work" with either Node 24/25 or Node 26, which means they can't have an explicit
+ * import to either `temporal-polyfill` or the `Temporal` global.
+ *
+ * This is exactly what Joist's internal temporal resolution was already working around, so
+ * this just exposes an `import { Temporal } from joist-orm` that lets the codegen & tests
+ * reuse the same abstraction.
+ */
+declare const Temporal: typeof globalThis.Temporal;
+/**
+ * A type-only `Temporal` namespace that merges with the `const Temporal` above.
+ *
+ * The `const` is only a value, so using `Temporal.PlainDate` / `Temporal.ZonedDateTime` as a
+ * type needs a namespace to resolve against. Node 26 has that as a global, but older Node
+ * versions don't, so `temporal-spec/global` supplies the same global namespace as a fallback.
+ */
+declare namespace Temporal {
+  type Instant = globalThis.Temporal.Instant;
+  type ZonedDateTime = globalThis.Temporal.ZonedDateTime;
+  type PlainDate = globalThis.Temporal.PlainDate;
+  type PlainTime = globalThis.Temporal.PlainTime;
+  type PlainDateTime = globalThis.Temporal.PlainDateTime;
+  type PlainYearMonth = globalThis.Temporal.PlainYearMonth;
+  type PlainMonthDay = globalThis.Temporal.PlainMonthDay;
+  type Duration = globalThis.Temporal.Duration;
+}
+/**
+ * Conditionally/dynamically requires `temporal-polyfill`.
+ *
+ * We want to avoid directly importing/requiring `temporal-polyfill` because
+ * it will introduce the dependency to all users of Joist.
+ */
+declare function maybeRequireTemporal(): TemporalModule | undefined;
+declare function requireTemporal(): TemporalModule;
+//#endregion
+export { Temporal, maybeRequireTemporal, requireTemporal };
+//# sourceMappingURL=temporal.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.cts","names":[],"sources":["../../src/serde/temporal.ts"],"mappings":";;KAOK;;;;;;;;;;;;;cAeQ,iBAOD,WAAW;;;;;;;;kBASE;OACX,UAAU,WAAW,SAAS;OAC9B,gBAAgB,WAAW,SAAS;OACpC,YAAY,WAAW,SAAS;OAChC,YAAY,WAAW,SAAS;OAChC,gBAAgB,WAAW,SAAS;OACpC,iBAAiB,WAAW,SAAS;OACrC,gBAAgB,WAAW,SAAS;OACpC,WAAW,WAAW,SAAS;;;;;;;;iBAS7B,wBAAwB;iBA6BxB,mBAAmB"}