joist-core 2.3.0 → 2.4.0-next.2

package/build/json.cjs

@@ -0,0 +1,79 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_relations_AbstractRelationImpl = require("./relations/AbstractRelationImpl.cjs");
+const require_normalizeHints = require("./normalizeHints.cjs");
+const require_relations_ReactiveGetter = require("./relations/ReactiveGetter.cjs");
+const require_reactivity_reactiveHints = require("./reactivity/reactiveHints.cjs");
+const require_relations_hasProperty = require("./relations/hasProperty.cjs");
+const require_relations_ReactiveField = require("./relations/ReactiveField.cjs");
+const require_relations_AsyncReactiveField = require("./relations/AsyncReactiveField.cjs");
+require("./relations/index.cjs");
+const require_EntityMetadata = require("./EntityMetadata.cjs");
+require("./EntityManager.cjs");
+const require_Entity = require("./Entity.cjs");
+//#region src/json.ts
+async function toJSON(entityOrList, hint) {
+	if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];
+	const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;
+	const loadHint = require_reactivity_reactiveHints.convertToLoadHint(require_EntityMetadata.getMetadata(entity), hint, true);
+	await entity.em.populate(entityOrList, loadHint);
+	const normHint = require_normalizeHints.normalizeHint(hint);
+	if (Array.isArray(entityOrList)) {
+		const list = [];
+		await Promise.all(entityOrList.map((entity) => {
+			const json = {};
+			list.push(json);
+			return copyToPayload(json, entity, normHint);
+		}));
+		return list;
+	} else {
+		const json = {};
+		await copyToPayload(json, entity, normHint);
+		return json;
+	}
+}
+/** Recursively copies the fields of `hint` from `entity` into the `payload`. */
+async function copyToPayload(payload, entity, hint) {
+	for (const [payloadKey, nestedHint] of Object.entries(hint)) {
+		const nextHint = require_normalizeHints.normalizeHint(nestedHint);
+		let entityKey = payloadKey;
+		if (!(entityKey in entity)) {
+			const field = Object.values(require_EntityMetadata.getMetadata(entity).allFields).find((f) => f.fieldIdName === payloadKey);
+			if (field) entityKey = field.fieldName;
+		}
+		if (!(entityKey in entity)) {
+			if (typeof nestedHint !== "function") throw new Error(`Entity does not have a property ${payloadKey}`);
+			payload[payloadKey] = await nestedHint(entity);
+		} else {
+			const value = entity[entityKey];
+			if (isPrimitive(value)) payload[payloadKey] = value;
+			else if (value instanceof require_relations_AbstractRelationImpl.AbstractRelationImpl || value instanceof require_relations_ReactiveField.ReactiveFieldImpl || value instanceof require_relations_ReactiveGetter.ReactiveGetterImpl || value instanceof require_relations_AsyncReactiveField.AsyncReactiveFieldImpl || value instanceof require_relations_hasProperty.PropertyImpl) await copyToPayloadValue(payload, payloadKey, value.get, nextHint);
+			else throw new Error(`Unable to encode value ${value} to JSON`);
+		}
+	}
+}
+function copyToPayloadValue(payload, key, value, nextHint) {
+	if (value === void 0 || value === null || isPrimitive(value)) payload[key] = value;
+	else if (require_Entity.isEntity(value)) {
+		if (nextHint && Object.keys(nextHint).length > 0) {
+			payload[key] = {};
+			return copyToPayload(payload[key], value, nextHint);
+		} else payload[key] = value.id;
+	} else if (Array.isArray(value)) {
+		const list = [];
+		payload[key] = list;
+		if (nextHint && Object.keys(nextHint).length > 0) return Promise.all(value.map(async (item, i) => {
+			if (require_Entity.isEntity(item)) {
+				list[i] = {};
+				return copyToPayload(list[i], item, nextHint);
+			} else list[i] = item;
+		}));
+		else for (const item of value) list.push(item.id);
+	} else payload[key] = value;
+}
+function isPrimitive(value) {
+	return value === null || typeof value !== "object";
+}
+//#endregion
+exports.toJSON = toJSON;
+
+//# sourceMappingURL=json.cjs.map

package/build/json.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.cjs","names":["convertToLoadHint","getMetadata","normalizeHint","AbstractRelationImpl","ReactiveFieldImpl","ReactiveGetterImpl","AsyncReactiveFieldImpl","PropertyImpl","isEntity"],"sources":["../src/json.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf } from \"src/EntityManager.ts\";\nimport { getMetadata } from \"src/EntityMetadata.ts\";\nimport { normalizeHint } from \"src/normalizeHints.ts\";\nimport { convertToLoadHint } from \"src/reactivity/reactiveHints.ts\";\nimport { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\nimport { AsyncReactiveFieldImpl } from \"src/relations/AsyncReactiveField.ts\";\nimport { PropertyImpl } from \"src/relations/hasProperty.ts\";\nimport {\n  type AsyncMethod,\n  type Collection,\n  type Property,\n  type ReactiveGetter,\n  type Reference,\n} from \"src/relations/index.ts\";\nimport { ReactiveFieldImpl } from \"src/relations/ReactiveField.ts\";\nimport { ReactiveGetterImpl } from \"src/relations/ReactiveGetter.ts\";\n\n/**\n * A JSON hint of a single key, multiple keys, or nested keys and sub-hints.\n *\n * JSON hints are much like load hints/reactive hints:\n *\n * - Similar to load hints, they specify which relations should be loaded from the database\n * - Similar to reactive hints, they include specific fields to output\n * - Unlike either, they can include completely custom keys that are lambdas to generate custom values\n */\nexport type JsonHint<T extends Entity> =\n  | (keyof Jsonable<T> & string)\n  | ReadonlyArray<keyof Jsonable<T> & string>\n  | NestedJsonHint<T>;\n\n/** For object literal/nested hints, we allow mapping both entity keys 1:1 & custom keys via a lambdas. */\nexport type NestedJsonHint<T extends Entity> = EntityKeyJsonHint<T> | CustomJsonKeyHint<T>;\n\n/** Foreach `Jsonable` key, we can provide a sub-hint, or just a boolean to include/exclude. */\nexport type EntityKeyJsonHint<T extends Entity> = {\n  // The `as K` makes `bookIds` as a hint work...\n  [K in keyof Jsonable<T> as `${K}`]?: (Jsonable<T>[K] extends infer U extends Entity ? JsonHint<U> : {}) | boolean;\n};\n\nexport type CustomJsonKeyHint<T> = {\n  [key: string]: (entity: T) => any;\n};\n\n/**\n * Describes the JSON payload for `Entity.toJSON` to produce.\n *\n * - `[\"firstName\", \"lastName\"]` will produce a JSON payload with just those fields\n * - `{ author: { books: \"title\" } }` will produce a JSON payload with the author's books' titles\n *\n * We only accept object literals & arrays to `toJSON` to avoid a `JSON.stringify` oddity.\n */\nexport type ToJsonHint<T extends Entity> = NestedJsonHint<T> | ReadonlyArray<keyof Jsonable<T> & string>;\n\n/** The keys in `T` that we can put into a JSON payload. */\nexport type Jsonable<T extends Entity> = {\n  -readonly [K in keyof T as JsonableValue<T[K]> extends never ? never : K]: JsonableValue<T[K]>;\n};\n\n// this should probably be `keyof T` as long as they aren't methods/AsyncMethods.\n// so primitives, enums, references, collections, async properties, but also random getters.\nexport type JsonableValue<V> =\n  V extends Reference<any, infer U, any>\n    ? U\n    : V extends Collection<any, infer U>\n      ? U\n      : V extends AsyncMethod<any, any, any>\n        ? never\n        : V extends Property<any, infer P>\n          ? DropUndefined<P>\n          : V extends ReactiveGetter<any, infer P>\n            ? P\n            : V;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entity: T,\n  hint: H,\n): Promise<JsonPayload<T, H>>;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entities: readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H>[]>;\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entityOrList: T | readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H> | JsonPayload<T, H>[]> {\n  // If called with a list, and nothing there, just early return\n  if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];\n\n  // Otherwise probe to get our first entity\n  const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;\n  const loadHint = convertToLoadHint(getMetadata(entity), hint as any, true);\n  await entity.em.populate(entityOrList, loadHint);\n  const normHint = normalizeHint(hint as any);\n\n  if (Array.isArray(entityOrList)) {\n    const list = [] as any;\n    await Promise.all(\n      entityOrList.map((entity) => {\n        const json = {};\n        list.push(json);\n        return copyToPayload(json, entity, normHint);\n      }),\n    );\n    return list;\n  } else {\n    const json = {};\n    await copyToPayload(json, entity, normHint);\n    return json as any;\n  }\n}\n\n/**\n * Statically types the return value of `toJSON` based on the given `hint`.\n */\nexport type JsonPayload<T, H> = {\n  [HK in keyof NormalizeHint<H> & string]: HK extends keyof T\n    ? JsonPayloadKey<T, H, HK, HK>\n    : HK extends `${infer TK extends string & keyof T}Id`\n      ? JsonPayloadKey<T, H, TK, HK>\n      : HK extends `${infer SK extends string}Ids` // bookIds -> books\n        ? // Very naive singularization to see if the guessed bookIds -> books actually exists on T to map 1:1\n          `${SK}s` extends keyof T\n          ? JsonPayloadKey<T, H, `${SK}s`, HK>\n          : JsonPayloadCustom<NormalizeHint<H>[HK]>\n        : JsonPayloadCustom<NormalizeHint<H>[HK]>;\n};\n\ntype JsonPayloadKey<T, H, TK extends keyof T, HK extends keyof NormalizeHint<H>> =\n  T[TK] extends Reference<any, infer U, any>\n    ? JsonPayloadReference<U, NormalizeHint<H>[HK]>\n    : T[TK] extends Collection<any, infer U>\n      ? JsonPayloadCollection<U, NormalizeHint<H>[HK]>\n      : T[TK] extends Property<any, infer U>\n        ? JsonPayloadProperty<U, NormalizeHint<H>[HK]>\n        : T[TK] extends ReactiveGetter<any, infer V>\n          ? V\n          : T[TK];\n\n// If the hint is empty, we just output the id as a string.\ntype JsonPayloadReference<U, H> = IsEmpty<H> extends true ? string : JsonPayload<U, H>;\n\ntype JsonPayloadCollection<U extends Entity, H> =\n  // If this is `books: true`, use the id\n  H extends true\n    ? IdOf<U>[]\n    : // If this is `{}`, use the id\n      IsEmpty<H> extends true\n      ? IdOf<U>[]\n      : // Otherwise it's a nested hint\n        JsonPayload<U, H>[];\n\ntype JsonPayloadProperty<P, H> =\n  // If an async property returns an entity, treat it like a reference\n  P extends Entity | undefined\n    ? JsonPayloadReference<P, H>\n    : // If an async property returns an entity[], treat it like a collection\n      P extends (infer U extends Entity)[] | undefined\n      ? JsonPayloadCollection<U, H>\n      : // Otherwise leave it as-is\n        P;\n\ntype JsonPayloadCustom<H> = H extends (...args: any) => infer V ? UnwrapPromise<V> : H;\n\ntype UnwrapPromise<T> = T extends Promise<infer U> ? U : T;\n\n/** Recursively copies the fields of `hint` from `entity` into the `payload`. */\nasync function copyToPayload(payload: Record<string, {}>, entity: any, hint: object): Promise<void> {\n  // Look at each key in the hint and determine\n  for (const [payloadKey, nestedHint] of Object.entries(hint)) {\n    const nextHint = normalizeHint(nestedHint);\n    // Watch for `companyId`\n    let entityKey = payloadKey;\n    if (!(entityKey in entity)) {\n      const field = Object.values(getMetadata(entity).allFields).find((f) => f.fieldIdName === payloadKey);\n      if (field) {\n        entityKey = field.fieldName;\n      }\n    }\n    // Look for custom props\n    if (!(entityKey in entity)) {\n      if (typeof nestedHint !== \"function\") {\n        throw new Error(`Entity does not have a property ${payloadKey}`);\n      }\n      payload[payloadKey] = await nestedHint(entity);\n    } else {\n      const value = entity[entityKey];\n      if (isPrimitive(value)) {\n        payload[payloadKey] = value;\n      } else if (\n        value instanceof AbstractRelationImpl ||\n        value instanceof ReactiveFieldImpl ||\n        value instanceof ReactiveGetterImpl ||\n        value instanceof AsyncReactiveFieldImpl ||\n        value instanceof PropertyImpl\n      ) {\n        await copyToPayloadValue(payload, payloadKey, value.get, nextHint);\n      } else {\n        throw new Error(`Unable to encode value ${value} to JSON`);\n      }\n    }\n  }\n}\n\nfunction copyToPayloadValue(payload: any, key: any, value: any, nextHint: any): Promise<unknown> | undefined {\n  if (value === undefined || value === null || isPrimitive(value)) {\n    payload[key] = value;\n  } else if (isEntity(value)) {\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      payload[key] = {};\n      return copyToPayload(payload[key], value, nextHint);\n    } else {\n      payload[key] = value.id;\n    }\n  } else if (Array.isArray(value)) {\n    const list = [] as any[];\n    payload[key] = list;\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      return Promise.all(\n        value.map(async (item, i) => {\n          if (isEntity(item)) {\n            list[i] = {};\n            return copyToPayload(list[i], item, nextHint);\n          } else {\n            // This is probably undefined\n            list[i] = item;\n          }\n        }),\n      );\n    } else {\n      // This is assuming an array of entities...\n      for (const item of value) list.push(item.id);\n    }\n  } else {\n    payload[key] = value;\n  }\n}\n\nfunction isPrimitive(value: any): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\ntype DropUndefined<T> = T extends infer U extends Entity | undefined ? U : T;\n\n// A copy/paste of NormalizeHint w/o the `DropSuffix` stuff\ntype NormalizeHint<H> = H extends string\n  ? Record<H, {}>\n  : H extends ReadonlyArray<any>\n    ? Record<H[number], {}>\n    : { [K in keyof H]: H[K] };\n\ntype IsEmpty<T> = keyof T extends never ? true : false;\n"],"mappings":";;;;;;;;;;;;;AAwGA,eAAsB,OACpB,cACA,MACkD;CAElD,IAAI,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAAG,OAAO,CAAC;CAGtE,MAAM,SAAS,MAAM,QAAQ,YAAY,IAAI,aAAa,KAAK;CAC/D,MAAM,WAAWA,iCAAAA,kBAAkBC,uBAAAA,YAAY,MAAM,GAAG,MAAa,IAAI;CACzE,MAAM,OAAO,GAAG,SAAS,cAAc,QAAQ;CAC/C,MAAM,WAAWC,uBAAAA,cAAc,IAAW;CAE1C,IAAI,MAAM,QAAQ,YAAY,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,MAAM,QAAQ,IACZ,aAAa,KAAK,WAAW;GAC3B,MAAM,OAAO,CAAC;GACd,KAAK,KAAK,IAAI;GACd,OAAO,cAAc,MAAM,QAAQ,QAAQ;EAC7C,CAAC,CACH;EACA,OAAO;CACT,OAAO;EACL,MAAM,OAAO,CAAC;EACd,MAAM,cAAc,MAAM,QAAQ,QAAQ;EAC1C,OAAO;CACT;AACF;;AAyDA,eAAe,cAAc,SAA6B,QAAa,MAA6B;CAElG,KAAK,MAAM,CAAC,YAAY,eAAe,OAAO,QAAQ,IAAI,GAAG;EAC3D,MAAM,WAAWA,uBAAAA,cAAc,UAAU;EAEzC,IAAI,YAAY;EAChB,IAAI,EAAE,aAAa,SAAS;GAC1B,MAAM,QAAQ,OAAO,OAAOD,uBAAAA,YAAY,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,MAAM,EAAE,gBAAgB,UAAU;GACnG,IAAI,OACF,YAAY,MAAM;EAEtB;EAEA,IAAI,EAAE,aAAa,SAAS;GAC1B,IAAI,OAAO,eAAe,YACxB,MAAM,IAAI,MAAM,mCAAmC,YAAY;GAEjE,QAAQ,cAAc,MAAM,WAAW,MAAM;EAC/C,OAAO;GACL,MAAM,QAAQ,OAAO;GACrB,IAAI,YAAY,KAAK,GACnB,QAAQ,cAAc;QACjB,IACL,iBAAiBE,uCAAAA,wBACjB,iBAAiBC,gCAAAA,qBACjB,iBAAiBC,iCAAAA,sBACjB,iBAAiBC,qCAAAA,0BACjB,iBAAiBC,8BAAAA,cAEjB,MAAM,mBAAmB,SAAS,YAAY,MAAM,KAAK,QAAQ;QAEjE,MAAM,IAAI,MAAM,0BAA0B,MAAM,SAAS;EAE7D;CACF;AACF;AAEA,SAAS,mBAAmB,SAAc,KAAU,OAAY,UAA6C;CAC3G,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,YAAY,KAAK,GAC5D,QAAQ,OAAO;MACV,IAAIC,eAAAA,SAAS,KAAK,GAAG;EAC1B,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAAG;GAChD,QAAQ,OAAO,CAAC;GAChB,OAAO,cAAc,QAAQ,MAAM,OAAO,QAAQ;EACpD,OACE,QAAQ,OAAO,MAAM;CAEzB,OAAO,IAAI,MAAM,QAAQ,KAAK,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,QAAQ,OAAO;EACf,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAC7C,OAAO,QAAQ,IACb,MAAM,IAAI,OAAO,MAAM,MAAM;GAC3B,IAAIA,eAAAA,SAAS,IAAI,GAAG;IAClB,KAAK,KAAK,CAAC;IACX,OAAO,cAAc,KAAK,IAAI,MAAM,QAAQ;GAC9C,OAEE,KAAK,KAAK;EAEd,CAAC,CACH;OAGA,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,KAAK,EAAE;CAE/C,OACE,QAAQ,OAAO;AAEnB;AAEA,SAAS,YAAY,OAAqB;CACxC,OAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C"}

package/build/json.d.cts

@@ -0,0 +1,76 @@
+import { Collection } from "./relations/Collection.cjs";
+import { AsyncMethod } from "./relations/hasAsyncMethod.cjs";
+import { Property } from "./relations/hasProperty.cjs";
+import { Reference } from "./relations/Reference.cjs";
+import { ReactiveGetter } from "./relations/ReactiveGetter.cjs";
+import "./relations/index.cjs";
+import { IdOf } from "./EntityManager.cjs";
+import { Entity } from "./Entity.cjs";
+//#region src/json.d.ts
+/**
+ * A JSON hint of a single key, multiple keys, or nested keys and sub-hints.
+ *
+ * JSON hints are much like load hints/reactive hints:
+ *
+ * - Similar to load hints, they specify which relations should be loaded from the database
+ * - Similar to reactive hints, they include specific fields to output
+ * - Unlike either, they can include completely custom keys that are lambdas to generate custom values
+ */
+type JsonHint<T extends Entity> = (keyof Jsonable<T> & string) | ReadonlyArray<keyof Jsonable<T> & string> | NestedJsonHint<T>;
+/** For object literal/nested hints, we allow mapping both entity keys 1:1 & custom keys via a lambdas. */
+type NestedJsonHint<T extends Entity> = EntityKeyJsonHint<T> | CustomJsonKeyHint<T>;
+/** Foreach `Jsonable` key, we can provide a sub-hint, or just a boolean to include/exclude. */
+type EntityKeyJsonHint<T extends Entity> = { [K in keyof Jsonable<T> as `${K}`]?: (Jsonable<T>[K] extends (infer U extends Entity) ? JsonHint<U> : {}) | boolean; };
+type CustomJsonKeyHint<T> = {
+  [key: string]: (entity: T) => any;
+};
+/**
+ * Describes the JSON payload for `Entity.toJSON` to produce.
+ *
+ * - `["firstName", "lastName"]` will produce a JSON payload with just those fields
+ * - `{ author: { books: "title" } }` will produce a JSON payload with the author's books' titles
+ *
+ * We only accept object literals & arrays to `toJSON` to avoid a `JSON.stringify` oddity.
+ */
+type ToJsonHint<T extends Entity> = NestedJsonHint<T> | ReadonlyArray<keyof Jsonable<T> & string>;
+/** The keys in `T` that we can put into a JSON payload. */
+type Jsonable<T extends Entity> = { -readonly [K in keyof T as JsonableValue<T[K]> extends never ? never : K]: JsonableValue<T[K]>; };
+type JsonableValue<V> = V extends Reference<any, infer U, any> ? U : V extends Collection<any, infer U> ? U : V extends AsyncMethod<any, any, any> ? never : V extends Property<any, infer P> ? DropUndefined<P> : V extends ReactiveGetter<any, infer P> ? P : V;
+/**
+ * Provides an API to put an entity, or list of entities, into a JSON payload.
+ *
+ * The `hint` parameter is a JSON hint that describes what to include in the payload,
+ *
+ * - fields like `id`, `name`, etc.
+ * - relations like m2o, o2m, m2m, and o2o
+ *   - relations are allowed to provide nested hints, just like nested load hints
+ * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`
+ */
+declare function toJSON<T extends Entity, const H extends JsonHint<T>>(entity: T, hint: H): Promise<JsonPayload<T, H>>;
+/**
+ * Provides an API to put an entity, or list of entities, into a JSON payload.
+ *
+ * The `hint` parameter is a JSON hint that describes what to include in the payload,
+ *
+ * - fields like `id`, `name`, etc.
+ * - relations like m2o, o2m, m2m, and o2o
+ *   - relations are allowed to provide nested hints, just like nested load hints
+ * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`
+ */
+declare function toJSON<T extends Entity, const H extends JsonHint<T>>(entities: readonly T[], hint: H): Promise<JsonPayload<T, H>[]>;
+/**
+ * Statically types the return value of `toJSON` based on the given `hint`.
+ */
+type JsonPayload<T, H> = { [HK in keyof NormalizeHint<H> & string]: HK extends keyof T ? JsonPayloadKey<T, H, HK, HK> : HK extends `${infer TK extends string & keyof T}Id` ? JsonPayloadKey<T, H, TK, HK> : HK extends `${infer SK extends string}Ids` ? `${SK}s` extends keyof T ? JsonPayloadKey<T, H, `${SK}s`, HK> : JsonPayloadCustom<NormalizeHint<H>[HK]> : JsonPayloadCustom<NormalizeHint<H>[HK]>; };
+type JsonPayloadKey<T, H, TK extends keyof T, HK extends keyof NormalizeHint<H>> = T[TK] extends Reference<any, infer U, any> ? JsonPayloadReference<U, NormalizeHint<H>[HK]> : T[TK] extends Collection<any, infer U> ? JsonPayloadCollection<U, NormalizeHint<H>[HK]> : T[TK] extends Property<any, infer U> ? JsonPayloadProperty<U, NormalizeHint<H>[HK]> : T[TK] extends ReactiveGetter<any, infer V> ? V : T[TK];
+type JsonPayloadReference<U, H> = IsEmpty<H> extends true ? string : JsonPayload<U, H>;
+type JsonPayloadCollection<U extends Entity, H> = H extends true ? IdOf<U>[] : IsEmpty<H> extends true ? IdOf<U>[] : JsonPayload<U, H>[];
+type JsonPayloadProperty<P, H> = P extends Entity | undefined ? JsonPayloadReference<P, H> : P extends (infer U extends Entity)[] | undefined ? JsonPayloadCollection<U, H> : P;
+type JsonPayloadCustom<H> = H extends ((...args: any) => infer V) ? UnwrapPromise<V> : H;
+type UnwrapPromise<T> = T extends Promise<infer U> ? U : T;
+type DropUndefined<T> = T extends (infer U extends Entity | undefined) ? U : T;
+type NormalizeHint<H> = H extends string ? Record<H, {}> : H extends ReadonlyArray<any> ? Record<H[number], {}> : { [K in keyof H]: H[K]; };
+type IsEmpty<T> = keyof T extends never ? true : false;
+//#endregion
+export { CustomJsonKeyHint, EntityKeyJsonHint, JsonHint, JsonPayload, Jsonable, JsonableValue, NestedJsonHint, ToJsonHint, toJSON };
+//# sourceMappingURL=json.d.cts.map

package/build/json.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.cts","names":[],"sources":["../src/json.ts"],"mappings":";;;;;;;;;;;;;;;;;;KA2BY,SAAS,UAAU,iBACpB,SAAS,eAChB,oBAAoB,SAAS,eAC7B,eAAe;;KAGP,eAAe,UAAU,UAAU,kBAAkB,KAAK,kBAAkB;;KAG5E,kBAAkB,UAAU,aAErC,WAAW,SAAS,SAAS,QAAQ,SAAS,GAAG,kBAAiB,UAAU,UAAS,SAAS;KAGrF,kBAAkB;GAC3B,eAAe,QAAQ;;;;;;;;;;KAWd,WAAW,UAAU,UAAU,eAAe,KAAK,oBAAoB,SAAS;;KAGhF,SAAS,UAAU,uBAClB,WAAW,KAAK,cAAc,EAAE,4BAA4B,IAAI,cAAc,EAAE;KAKjF,cAAc,KACxB,UAAU,qBAAqB,UAC3B,IACA,UAAU,sBAAsB,KAC9B,IACA,UAAU,qCAER,UAAU,oBAAoB,KAC5B,cAAc,KACd,UAAU,0BAA0B,KAClC,IACA;;;;;;;;;;;iBAYQ,OAAO,UAAU,cAAc,UAAU,SAAS,IACtE,QAAQ,GACR,MAAM,IACL,QAAQ,YAAY,GAAG;;;;;;;;;;;iBAYJ,OAAO,UAAU,cAAc,UAAU,SAAS,IACtE,mBAAmB,KACnB,MAAM,IACL,QAAQ,YAAY,GAAG;;;;KAkCd,YAAY,GAAG,QACxB,YAAY,cAAc,cAAc,iBAAiB,IACtD,eAAe,GAAG,GAAG,IAAI,MACzB,oBAAoB,0BAA0B,QAC5C,eAAe,GAAG,GAAG,IAAI,MACzB,oBAAoB,4BAEf,oBAAoB,IACrB,eAAe,GAAG,MAAM,OAAO,MAC/B,kBAAkB,cAAc,GAAG,OACrC,kBAAkB,cAAc,GAAG;KAGxC,eAAe,GAAG,GAAG,iBAAiB,GAAG,iBAAiB,cAAc,MAC3E,EAAE,YAAY,qBAAqB,UAC/B,qBAAqB,GAAG,cAAc,GAAG,OACzC,EAAE,YAAY,sBAAsB,KAClC,sBAAsB,GAAG,cAAc,GAAG,OAC1C,EAAE,YAAY,oBAAoB,KAChC,oBAAoB,GAAG,cAAc,GAAG,OACxC,EAAE,YAAY,0BAA0B,KACtC,IACA,EAAE;KAGT,qBAAqB,GAAG,KAAK,QAAQ,2BAA2B,YAAY,GAAG;KAE/E,sBAAsB,UAAU,QAAQ,KAE3C,iBACI,KAAK,OAEL,QAAQ,kBACN,KAAK,OAEL,YAAY,GAAG;KAElB,oBAAoB,GAAG,KAE1B,UAAU,qBACN,qBAAqB,GAAG,KAExB,iBAAiB,UAAU,wBACzB,sBAAsB,GAAG,KAEzB;KAEH,kBAAkB,KAAK,eAAc,oBAAoB,KAAI,cAAc,KAAK;KAEhF,cAAc,KAAK,UAAU,cAAc,KAAK,IAAI;KA8EpD,cAAc,KAAK,iBAAgB,UAAU,sBAAqB,IAAI;KAGtE,cAAc,KAAK,mBACpB,OAAO,SACP,UAAU,qBACR,OAAO,oBACJ,WAAW,IAAI,EAAE;KAErB,QAAQ,WAAW"}

package/build/json.d.mts

@@ -0,0 +1,76 @@
+import { Collection } from "./relations/Collection.mjs";
+import { AsyncMethod } from "./relations/hasAsyncMethod.mjs";
+import { Property } from "./relations/hasProperty.mjs";
+import { Reference } from "./relations/Reference.mjs";
+import { ReactiveGetter } from "./relations/ReactiveGetter.mjs";
+import "./relations/index.mjs";
+import { IdOf } from "./EntityManager.mjs";
+import { Entity } from "./Entity.mjs";
+//#region src/json.d.ts
+/**
+ * A JSON hint of a single key, multiple keys, or nested keys and sub-hints.
+ *
+ * JSON hints are much like load hints/reactive hints:
+ *
+ * - Similar to load hints, they specify which relations should be loaded from the database
+ * - Similar to reactive hints, they include specific fields to output
+ * - Unlike either, they can include completely custom keys that are lambdas to generate custom values
+ */
+type JsonHint<T extends Entity> = (keyof Jsonable<T> & string) | ReadonlyArray<keyof Jsonable<T> & string> | NestedJsonHint<T>;
+/** For object literal/nested hints, we allow mapping both entity keys 1:1 & custom keys via a lambdas. */
+type NestedJsonHint<T extends Entity> = EntityKeyJsonHint<T> | CustomJsonKeyHint<T>;
+/** Foreach `Jsonable` key, we can provide a sub-hint, or just a boolean to include/exclude. */
+type EntityKeyJsonHint<T extends Entity> = { [K in keyof Jsonable<T> as `${K}`]?: (Jsonable<T>[K] extends (infer U extends Entity) ? JsonHint<U> : {}) | boolean; };
+type CustomJsonKeyHint<T> = {
+  [key: string]: (entity: T) => any;
+};
+/**
+ * Describes the JSON payload for `Entity.toJSON` to produce.
+ *
+ * - `["firstName", "lastName"]` will produce a JSON payload with just those fields
+ * - `{ author: { books: "title" } }` will produce a JSON payload with the author's books' titles
+ *
+ * We only accept object literals & arrays to `toJSON` to avoid a `JSON.stringify` oddity.
+ */
+type ToJsonHint<T extends Entity> = NestedJsonHint<T> | ReadonlyArray<keyof Jsonable<T> & string>;
+/** The keys in `T` that we can put into a JSON payload. */
+type Jsonable<T extends Entity> = { -readonly [K in keyof T as JsonableValue<T[K]> extends never ? never : K]: JsonableValue<T[K]>; };
+type JsonableValue<V> = V extends Reference<any, infer U, any> ? U : V extends Collection<any, infer U> ? U : V extends AsyncMethod<any, any, any> ? never : V extends Property<any, infer P> ? DropUndefined<P> : V extends ReactiveGetter<any, infer P> ? P : V;
+/**
+ * Provides an API to put an entity, or list of entities, into a JSON payload.
+ *
+ * The `hint` parameter is a JSON hint that describes what to include in the payload,
+ *
+ * - fields like `id`, `name`, etc.
+ * - relations like m2o, o2m, m2m, and o2o
+ *   - relations are allowed to provide nested hints, just like nested load hints
+ * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`
+ */
+declare function toJSON<T extends Entity, const H extends JsonHint<T>>(entity: T, hint: H): Promise<JsonPayload<T, H>>;
+/**
+ * Provides an API to put an entity, or list of entities, into a JSON payload.
+ *
+ * The `hint` parameter is a JSON hint that describes what to include in the payload,
+ *
+ * - fields like `id`, `name`, etc.
+ * - relations like m2o, o2m, m2m, and o2o
+ *   - relations are allowed to provide nested hints, just like nested load hints
+ * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`
+ */
+declare function toJSON<T extends Entity, const H extends JsonHint<T>>(entities: readonly T[], hint: H): Promise<JsonPayload<T, H>[]>;
+/**
+ * Statically types the return value of `toJSON` based on the given `hint`.
+ */
+type JsonPayload<T, H> = { [HK in keyof NormalizeHint<H> & string]: HK extends keyof T ? JsonPayloadKey<T, H, HK, HK> : HK extends `${infer TK extends string & keyof T}Id` ? JsonPayloadKey<T, H, TK, HK> : HK extends `${infer SK extends string}Ids` ? `${SK}s` extends keyof T ? JsonPayloadKey<T, H, `${SK}s`, HK> : JsonPayloadCustom<NormalizeHint<H>[HK]> : JsonPayloadCustom<NormalizeHint<H>[HK]>; };
+type JsonPayloadKey<T, H, TK extends keyof T, HK extends keyof NormalizeHint<H>> = T[TK] extends Reference<any, infer U, any> ? JsonPayloadReference<U, NormalizeHint<H>[HK]> : T[TK] extends Collection<any, infer U> ? JsonPayloadCollection<U, NormalizeHint<H>[HK]> : T[TK] extends Property<any, infer U> ? JsonPayloadProperty<U, NormalizeHint<H>[HK]> : T[TK] extends ReactiveGetter<any, infer V> ? V : T[TK];
+type JsonPayloadReference<U, H> = IsEmpty<H> extends true ? string : JsonPayload<U, H>;
+type JsonPayloadCollection<U extends Entity, H> = H extends true ? IdOf<U>[] : IsEmpty<H> extends true ? IdOf<U>[] : JsonPayload<U, H>[];
+type JsonPayloadProperty<P, H> = P extends Entity | undefined ? JsonPayloadReference<P, H> : P extends (infer U extends Entity)[] | undefined ? JsonPayloadCollection<U, H> : P;
+type JsonPayloadCustom<H> = H extends ((...args: any) => infer V) ? UnwrapPromise<V> : H;
+type UnwrapPromise<T> = T extends Promise<infer U> ? U : T;
+type DropUndefined<T> = T extends (infer U extends Entity | undefined) ? U : T;
+type NormalizeHint<H> = H extends string ? Record<H, {}> : H extends ReadonlyArray<any> ? Record<H[number], {}> : { [K in keyof H]: H[K]; };
+type IsEmpty<T> = keyof T extends never ? true : false;
+//#endregion
+export { CustomJsonKeyHint, EntityKeyJsonHint, JsonHint, JsonPayload, Jsonable, JsonableValue, NestedJsonHint, ToJsonHint, toJSON };
+//# sourceMappingURL=json.d.mts.map

package/build/json.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.mts","names":[],"sources":["../src/json.ts"],"mappings":";;;;;;;;;;;;;;;;;;KA2BY,SAAS,UAAU,iBACpB,SAAS,eAChB,oBAAoB,SAAS,eAC7B,eAAe;;KAGP,eAAe,UAAU,UAAU,kBAAkB,KAAK,kBAAkB;;KAG5E,kBAAkB,UAAU,aAErC,WAAW,SAAS,SAAS,QAAQ,SAAS,GAAG,kBAAiB,UAAU,UAAS,SAAS;KAGrF,kBAAkB;GAC3B,eAAe,QAAQ;;;;;;;;;;KAWd,WAAW,UAAU,UAAU,eAAe,KAAK,oBAAoB,SAAS;;KAGhF,SAAS,UAAU,uBAClB,WAAW,KAAK,cAAc,EAAE,4BAA4B,IAAI,cAAc,EAAE;KAKjF,cAAc,KACxB,UAAU,qBAAqB,UAC3B,IACA,UAAU,sBAAsB,KAC9B,IACA,UAAU,qCAER,UAAU,oBAAoB,KAC5B,cAAc,KACd,UAAU,0BAA0B,KAClC,IACA;;;;;;;;;;;iBAYQ,OAAO,UAAU,cAAc,UAAU,SAAS,IACtE,QAAQ,GACR,MAAM,IACL,QAAQ,YAAY,GAAG;;;;;;;;;;;iBAYJ,OAAO,UAAU,cAAc,UAAU,SAAS,IACtE,mBAAmB,KACnB,MAAM,IACL,QAAQ,YAAY,GAAG;;;;KAkCd,YAAY,GAAG,QACxB,YAAY,cAAc,cAAc,iBAAiB,IACtD,eAAe,GAAG,GAAG,IAAI,MACzB,oBAAoB,0BAA0B,QAC5C,eAAe,GAAG,GAAG,IAAI,MACzB,oBAAoB,4BAEf,oBAAoB,IACrB,eAAe,GAAG,MAAM,OAAO,MAC/B,kBAAkB,cAAc,GAAG,OACrC,kBAAkB,cAAc,GAAG;KAGxC,eAAe,GAAG,GAAG,iBAAiB,GAAG,iBAAiB,cAAc,MAC3E,EAAE,YAAY,qBAAqB,UAC/B,qBAAqB,GAAG,cAAc,GAAG,OACzC,EAAE,YAAY,sBAAsB,KAClC,sBAAsB,GAAG,cAAc,GAAG,OAC1C,EAAE,YAAY,oBAAoB,KAChC,oBAAoB,GAAG,cAAc,GAAG,OACxC,EAAE,YAAY,0BAA0B,KACtC,IACA,EAAE;KAGT,qBAAqB,GAAG,KAAK,QAAQ,2BAA2B,YAAY,GAAG;KAE/E,sBAAsB,UAAU,QAAQ,KAE3C,iBACI,KAAK,OAEL,QAAQ,kBACN,KAAK,OAEL,YAAY,GAAG;KAElB,oBAAoB,GAAG,KAE1B,UAAU,qBACN,qBAAqB,GAAG,KAExB,iBAAiB,UAAU,wBACzB,sBAAsB,GAAG,KAEzB;KAEH,kBAAkB,KAAK,eAAc,oBAAoB,KAAI,cAAc,KAAK;KAEhF,cAAc,KAAK,UAAU,cAAc,KAAK,IAAI;KA8EpD,cAAc,KAAK,iBAAgB,UAAU,sBAAqB,IAAI;KAGtE,cAAc,KAAK,mBACpB,OAAO,SACP,UAAU,qBACR,OAAO,oBACJ,WAAW,IAAI,EAAE;KAErB,QAAQ,WAAW"}

package/build/json.js

@@ -1,116 +1,78 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toJSON = toJSON;
-const Entity_1 = require("./Entity");
-const EntityMetadata_1 = require("./EntityMetadata");
-const normalizeHints_1 = require("./normalizeHints");
-const reactiveHints_1 = require("./reactiveHints");
-const AbstractRelationImpl_1 = require("./relations/AbstractRelationImpl");
-const ReactiveField_1 = require("./relations/ReactiveField");
-const ReactiveGetter_1 = require("./relations/ReactiveGetter");
-const AsyncReactiveField_1 = require("./relations/AsyncReactiveField");
-const hasProperty_1 = require("./relations/hasProperty");
+import { AbstractRelationImpl } from "./relations/AbstractRelationImpl.js";
+import { normalizeHint } from "./normalizeHints.js";
+import { ReactiveGetterImpl } from "./relations/ReactiveGetter.js";
+import { convertToLoadHint } from "./reactivity/reactiveHints.js";
+import { PropertyImpl } from "./relations/hasProperty.js";
+import { ReactiveFieldImpl } from "./relations/ReactiveField.js";
+import { AsyncReactiveFieldImpl } from "./relations/AsyncReactiveField.js";
+import "./relations/index.js";
+import { getMetadata } from "./EntityMetadata.js";
+import "./EntityManager.js";
+import { isEntity } from "./Entity.js";
+//#region src/json.ts
 async function toJSON(entityOrList, hint) {
-    // If called with a list, and nothing there, just early return
-    if (Array.isArray(entityOrList) && entityOrList.length === 0)
-        return [];
-    // Otherwise probe to get our first entity
-    const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;
-    const loadHint = (0, reactiveHints_1.convertToLoadHint)((0, EntityMetadata_1.getMetadata)(entity), hint, true);
-    await entity.em.populate(entityOrList, loadHint);
-    const normHint = (0, normalizeHints_1.normalizeHint)(hint);
-    if (Array.isArray(entityOrList)) {
-        const list = [];
-        await Promise.all(entityOrList.map((entity) => {
-            const json = {};
-            list.push(json);
-            return copyToPayload(json, entity, normHint);
-        }));
-        return list;
-    }
-    else {
-        const json = {};
-        await copyToPayload(json, entity, normHint);
-        return json;
-    }
+	if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];
+	const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;
+	const loadHint = convertToLoadHint(getMetadata(entity), hint, true);
+	await entity.em.populate(entityOrList, loadHint);
+	const normHint = normalizeHint(hint);
+	if (Array.isArray(entityOrList)) {
+		const list = [];
+		await Promise.all(entityOrList.map((entity) => {
+			const json = {};
+			list.push(json);
+			return copyToPayload(json, entity, normHint);
+		}));
+		return list;
+	} else {
+		const json = {};
+		await copyToPayload(json, entity, normHint);
+		return json;
+	}
 }
 /** Recursively copies the fields of `hint` from `entity` into the `payload`. */
 async function copyToPayload(payload, entity, hint) {
-    // Look at each key in the hint and determine
-    for (const [payloadKey, nestedHint] of Object.entries(hint)) {
-        const nextHint = (0, normalizeHints_1.normalizeHint)(nestedHint);
-        // Watch for `companyId`
-        let entityKey = payloadKey;
-        if (!(entityKey in entity)) {
-            const field = Object.values((0, EntityMetadata_1.getMetadata)(entity).allFields).find((f) => f.fieldIdName === payloadKey);
-            if (field) {
-                entityKey = field.fieldName;
-            }
-        }
-        // Look for custom props
-        if (!(entityKey in entity)) {
-            if (typeof nestedHint !== "function") {
-                throw new Error(`Entity does not have a property ${payloadKey}`);
-            }
-            payload[payloadKey] = await nestedHint(entity);
-        }
-        else {
-            const value = entity[entityKey];
-            if (isPrimitive(value)) {
-                payload[payloadKey] = value;
-            }
-            else if (value instanceof AbstractRelationImpl_1.AbstractRelationImpl ||
-                value instanceof ReactiveField_1.ReactiveFieldImpl ||
-                value instanceof ReactiveGetter_1.ReactiveGetterImpl ||
-                value instanceof AsyncReactiveField_1.AsyncReactiveFieldImpl ||
-                value instanceof hasProperty_1.PropertyImpl) {
-                await copyToPayloadValue(payload, payloadKey, value.get, nextHint);
-            }
-            else {
-                throw new Error(`Unable to encode value ${value} to JSON`);
-            }
-        }
-    }
+	for (const [payloadKey, nestedHint] of Object.entries(hint)) {
+		const nextHint = normalizeHint(nestedHint);
+		let entityKey = payloadKey;
+		if (!(entityKey in entity)) {
+			const field = Object.values(getMetadata(entity).allFields).find((f) => f.fieldIdName === payloadKey);
+			if (field) entityKey = field.fieldName;
+		}
+		if (!(entityKey in entity)) {
+			if (typeof nestedHint !== "function") throw new Error(`Entity does not have a property ${payloadKey}`);
+			payload[payloadKey] = await nestedHint(entity);
+		} else {
+			const value = entity[entityKey];
+			if (isPrimitive(value)) payload[payloadKey] = value;
+			else if (value instanceof AbstractRelationImpl || value instanceof ReactiveFieldImpl || value instanceof ReactiveGetterImpl || value instanceof AsyncReactiveFieldImpl || value instanceof PropertyImpl) await copyToPayloadValue(payload, payloadKey, value.get, nextHint);
+			else throw new Error(`Unable to encode value ${value} to JSON`);
+		}
+	}
 }
 function copyToPayloadValue(payload, key, value, nextHint) {
-    if (value === undefined || value === null || isPrimitive(value)) {
-        payload[key] = value;
-    }
-    else if ((0, Entity_1.isEntity)(value)) {
-        if (nextHint && Object.keys(nextHint).length > 0) {
-            payload[key] = {};
-            return copyToPayload(payload[key], value, nextHint);
-        }
-        else {
-            payload[key] = value.id;
-        }
-    }
-    else if (Array.isArray(value)) {
-        const list = [];
-        payload[key] = list;
-        if (nextHint && Object.keys(nextHint).length > 0) {
-            return Promise.all(value.map(async (item, i) => {
-                if ((0, Entity_1.isEntity)(item)) {
-                    list[i] = {};
-                    return copyToPayload(list[i], item, nextHint);
-                }
-                else {
-                    // This is probably undefined
-                    list[i] = item;
-                }
-            }));
-        }
-        else {
-            // This is assuming an array of entities...
-            for (const item of value)
-                list.push(item.id);
-        }
-    }
-    else {
-        payload[key] = value;
-    }
+	if (value === void 0 || value === null || isPrimitive(value)) payload[key] = value;
+	else if (isEntity(value)) {
+		if (nextHint && Object.keys(nextHint).length > 0) {
+			payload[key] = {};
+			return copyToPayload(payload[key], value, nextHint);
+		} else payload[key] = value.id;
+	} else if (Array.isArray(value)) {
+		const list = [];
+		payload[key] = list;
+		if (nextHint && Object.keys(nextHint).length > 0) return Promise.all(value.map(async (item, i) => {
+			if (isEntity(item)) {
+				list[i] = {};
+				return copyToPayload(list[i], item, nextHint);
+			} else list[i] = item;
+		}));
+		else for (const item of value) list.push(item.id);
+	} else payload[key] = value;
 }
 function isPrimitive(value) {
-    return value === null || typeof value !== "object";
+	return value === null || typeof value !== "object";
 }
+//#endregion
+export { toJSON };
+
 //# sourceMappingURL=json.js.map

package/build/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"json.js","names":[],"sources":["../src/json.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf } from \"src/EntityManager.ts\";\nimport { getMetadata } from \"src/EntityMetadata.ts\";\nimport { normalizeHint } from \"src/normalizeHints.ts\";\nimport { convertToLoadHint } from \"src/reactivity/reactiveHints.ts\";\nimport { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\nimport { AsyncReactiveFieldImpl } from \"src/relations/AsyncReactiveField.ts\";\nimport { PropertyImpl } from \"src/relations/hasProperty.ts\";\nimport {\n  type AsyncMethod,\n  type Collection,\n  type Property,\n  type ReactiveGetter,\n  type Reference,\n} from \"src/relations/index.ts\";\nimport { ReactiveFieldImpl } from \"src/relations/ReactiveField.ts\";\nimport { ReactiveGetterImpl } from \"src/relations/ReactiveGetter.ts\";\n\n/**\n * A JSON hint of a single key, multiple keys, or nested keys and sub-hints.\n *\n * JSON hints are much like load hints/reactive hints:\n *\n * - Similar to load hints, they specify which relations should be loaded from the database\n * - Similar to reactive hints, they include specific fields to output\n * - Unlike either, they can include completely custom keys that are lambdas to generate custom values\n */\nexport type JsonHint<T extends Entity> =\n  | (keyof Jsonable<T> & string)\n  | ReadonlyArray<keyof Jsonable<T> & string>\n  | NestedJsonHint<T>;\n\n/** For object literal/nested hints, we allow mapping both entity keys 1:1 & custom keys via a lambdas. */\nexport type NestedJsonHint<T extends Entity> = EntityKeyJsonHint<T> | CustomJsonKeyHint<T>;\n\n/** Foreach `Jsonable` key, we can provide a sub-hint, or just a boolean to include/exclude. */\nexport type EntityKeyJsonHint<T extends Entity> = {\n  // The `as K` makes `bookIds` as a hint work...\n  [K in keyof Jsonable<T> as `${K}`]?: (Jsonable<T>[K] extends infer U extends Entity ? JsonHint<U> : {}) | boolean;\n};\n\nexport type CustomJsonKeyHint<T> = {\n  [key: string]: (entity: T) => any;\n};\n\n/**\n * Describes the JSON payload for `Entity.toJSON` to produce.\n *\n * - `[\"firstName\", \"lastName\"]` will produce a JSON payload with just those fields\n * - `{ author: { books: \"title\" } }` will produce a JSON payload with the author's books' titles\n *\n * We only accept object literals & arrays to `toJSON` to avoid a `JSON.stringify` oddity.\n */\nexport type ToJsonHint<T extends Entity> = NestedJsonHint<T> | ReadonlyArray<keyof Jsonable<T> & string>;\n\n/** The keys in `T` that we can put into a JSON payload. */\nexport type Jsonable<T extends Entity> = {\n  -readonly [K in keyof T as JsonableValue<T[K]> extends never ? never : K]: JsonableValue<T[K]>;\n};\n\n// this should probably be `keyof T` as long as they aren't methods/AsyncMethods.\n// so primitives, enums, references, collections, async properties, but also random getters.\nexport type JsonableValue<V> =\n  V extends Reference<any, infer U, any>\n    ? U\n    : V extends Collection<any, infer U>\n      ? U\n      : V extends AsyncMethod<any, any, any>\n        ? never\n        : V extends Property<any, infer P>\n          ? DropUndefined<P>\n          : V extends ReactiveGetter<any, infer P>\n            ? P\n            : V;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entity: T,\n  hint: H,\n): Promise<JsonPayload<T, H>>;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entities: readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H>[]>;\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entityOrList: T | readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H> | JsonPayload<T, H>[]> {\n  // If called with a list, and nothing there, just early return\n  if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];\n\n  // Otherwise probe to get our first entity\n  const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;\n  const loadHint = convertToLoadHint(getMetadata(entity), hint as any, true);\n  await entity.em.populate(entityOrList, loadHint);\n  const normHint = normalizeHint(hint as any);\n\n  if (Array.isArray(entityOrList)) {\n    const list = [] as any;\n    await Promise.all(\n      entityOrList.map((entity) => {\n        const json = {};\n        list.push(json);\n        return copyToPayload(json, entity, normHint);\n      }),\n    );\n    return list;\n  } else {\n    const json = {};\n    await copyToPayload(json, entity, normHint);\n    return json as any;\n  }\n}\n\n/**\n * Statically types the return value of `toJSON` based on the given `hint`.\n */\nexport type JsonPayload<T, H> = {\n  [HK in keyof NormalizeHint<H> & string]: HK extends keyof T\n    ? JsonPayloadKey<T, H, HK, HK>\n    : HK extends `${infer TK extends string & keyof T}Id`\n      ? JsonPayloadKey<T, H, TK, HK>\n      : HK extends `${infer SK extends string}Ids` // bookIds -> books\n        ? // Very naive singularization to see if the guessed bookIds -> books actually exists on T to map 1:1\n          `${SK}s` extends keyof T\n          ? JsonPayloadKey<T, H, `${SK}s`, HK>\n          : JsonPayloadCustom<NormalizeHint<H>[HK]>\n        : JsonPayloadCustom<NormalizeHint<H>[HK]>;\n};\n\ntype JsonPayloadKey<T, H, TK extends keyof T, HK extends keyof NormalizeHint<H>> =\n  T[TK] extends Reference<any, infer U, any>\n    ? JsonPayloadReference<U, NormalizeHint<H>[HK]>\n    : T[TK] extends Collection<any, infer U>\n      ? JsonPayloadCollection<U, NormalizeHint<H>[HK]>\n      : T[TK] extends Property<any, infer U>\n        ? JsonPayloadProperty<U, NormalizeHint<H>[HK]>\n        : T[TK] extends ReactiveGetter<any, infer V>\n          ? V\n          : T[TK];\n\n// If the hint is empty, we just output the id as a string.\ntype JsonPayloadReference<U, H> = IsEmpty<H> extends true ? string : JsonPayload<U, H>;\n\ntype JsonPayloadCollection<U extends Entity, H> =\n  // If this is `books: true`, use the id\n  H extends true\n    ? IdOf<U>[]\n    : // If this is `{}`, use the id\n      IsEmpty<H> extends true\n      ? IdOf<U>[]\n      : // Otherwise it's a nested hint\n        JsonPayload<U, H>[];\n\ntype JsonPayloadProperty<P, H> =\n  // If an async property returns an entity, treat it like a reference\n  P extends Entity | undefined\n    ? JsonPayloadReference<P, H>\n    : // If an async property returns an entity[], treat it like a collection\n      P extends (infer U extends Entity)[] | undefined\n      ? JsonPayloadCollection<U, H>\n      : // Otherwise leave it as-is\n        P;\n\ntype JsonPayloadCustom<H> = H extends (...args: any) => infer V ? UnwrapPromise<V> : H;\n\ntype UnwrapPromise<T> = T extends Promise<infer U> ? U : T;\n\n/** Recursively copies the fields of `hint` from `entity` into the `payload`. */\nasync function copyToPayload(payload: Record<string, {}>, entity: any, hint: object): Promise<void> {\n  // Look at each key in the hint and determine\n  for (const [payloadKey, nestedHint] of Object.entries(hint)) {\n    const nextHint = normalizeHint(nestedHint);\n    // Watch for `companyId`\n    let entityKey = payloadKey;\n    if (!(entityKey in entity)) {\n      const field = Object.values(getMetadata(entity).allFields).find((f) => f.fieldIdName === payloadKey);\n      if (field) {\n        entityKey = field.fieldName;\n      }\n    }\n    // Look for custom props\n    if (!(entityKey in entity)) {\n      if (typeof nestedHint !== \"function\") {\n        throw new Error(`Entity does not have a property ${payloadKey}`);\n      }\n      payload[payloadKey] = await nestedHint(entity);\n    } else {\n      const value = entity[entityKey];\n      if (isPrimitive(value)) {\n        payload[payloadKey] = value;\n      } else if (\n        value instanceof AbstractRelationImpl ||\n        value instanceof ReactiveFieldImpl ||\n        value instanceof ReactiveGetterImpl ||\n        value instanceof AsyncReactiveFieldImpl ||\n        value instanceof PropertyImpl\n      ) {\n        await copyToPayloadValue(payload, payloadKey, value.get, nextHint);\n      } else {\n        throw new Error(`Unable to encode value ${value} to JSON`);\n      }\n    }\n  }\n}\n\nfunction copyToPayloadValue(payload: any, key: any, value: any, nextHint: any): Promise<unknown> | undefined {\n  if (value === undefined || value === null || isPrimitive(value)) {\n    payload[key] = value;\n  } else if (isEntity(value)) {\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      payload[key] = {};\n      return copyToPayload(payload[key], value, nextHint);\n    } else {\n      payload[key] = value.id;\n    }\n  } else if (Array.isArray(value)) {\n    const list = [] as any[];\n    payload[key] = list;\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      return Promise.all(\n        value.map(async (item, i) => {\n          if (isEntity(item)) {\n            list[i] = {};\n            return copyToPayload(list[i], item, nextHint);\n          } else {\n            // This is probably undefined\n            list[i] = item;\n          }\n        }),\n      );\n    } else {\n      // This is assuming an array of entities...\n      for (const item of value) list.push(item.id);\n    }\n  } else {\n    payload[key] = value;\n  }\n}\n\nfunction isPrimitive(value: any): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\ntype DropUndefined<T> = T extends infer U extends Entity | undefined ? U : T;\n\n// A copy/paste of NormalizeHint w/o the `DropSuffix` stuff\ntype NormalizeHint<H> = H extends string\n  ? Record<H, {}>\n  : H extends ReadonlyArray<any>\n    ? Record<H[number], {}>\n    : { [K in keyof H]: H[K] };\n\ntype IsEmpty<T> = keyof T extends never ? true : false;\n"],"mappings":";;;;;;;;;;;;AAwGA,eAAsB,OACpB,cACA,MACkD;CAElD,IAAI,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAAG,OAAO,CAAC;CAGtE,MAAM,SAAS,MAAM,QAAQ,YAAY,IAAI,aAAa,KAAK;CAC/D,MAAM,WAAW,kBAAkB,YAAY,MAAM,GAAG,MAAa,IAAI;CACzE,MAAM,OAAO,GAAG,SAAS,cAAc,QAAQ;CAC/C,MAAM,WAAW,cAAc,IAAW;CAE1C,IAAI,MAAM,QAAQ,YAAY,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,MAAM,QAAQ,IACZ,aAAa,KAAK,WAAW;GAC3B,MAAM,OAAO,CAAC;GACd,KAAK,KAAK,IAAI;GACd,OAAO,cAAc,MAAM,QAAQ,QAAQ;EAC7C,CAAC,CACH;EACA,OAAO;CACT,OAAO;EACL,MAAM,OAAO,CAAC;EACd,MAAM,cAAc,MAAM,QAAQ,QAAQ;EAC1C,OAAO;CACT;AACF;;AAyDA,eAAe,cAAc,SAA6B,QAAa,MAA6B;CAElG,KAAK,MAAM,CAAC,YAAY,eAAe,OAAO,QAAQ,IAAI,GAAG;EAC3D,MAAM,WAAW,cAAc,UAAU;EAEzC,IAAI,YAAY;EAChB,IAAI,EAAE,aAAa,SAAS;GAC1B,MAAM,QAAQ,OAAO,OAAO,YAAY,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,MAAM,EAAE,gBAAgB,UAAU;GACnG,IAAI,OACF,YAAY,MAAM;EAEtB;EAEA,IAAI,EAAE,aAAa,SAAS;GAC1B,IAAI,OAAO,eAAe,YACxB,MAAM,IAAI,MAAM,mCAAmC,YAAY;GAEjE,QAAQ,cAAc,MAAM,WAAW,MAAM;EAC/C,OAAO;GACL,MAAM,QAAQ,OAAO;GACrB,IAAI,YAAY,KAAK,GACnB,QAAQ,cAAc;QACjB,IACL,iBAAiB,wBACjB,iBAAiB,qBACjB,iBAAiB,sBACjB,iBAAiB,0BACjB,iBAAiB,cAEjB,MAAM,mBAAmB,SAAS,YAAY,MAAM,KAAK,QAAQ;QAEjE,MAAM,IAAI,MAAM,0BAA0B,MAAM,SAAS;EAE7D;CACF;AACF;AAEA,SAAS,mBAAmB,SAAc,KAAU,OAAY,UAA6C;CAC3G,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,YAAY,KAAK,GAC5D,QAAQ,OAAO;MACV,IAAI,SAAS,KAAK,GAAG;EAC1B,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAAG;GAChD,QAAQ,OAAO,CAAC;GAChB,OAAO,cAAc,QAAQ,MAAM,OAAO,QAAQ;EACpD,OACE,QAAQ,OAAO,MAAM;CAEzB,OAAO,IAAI,MAAM,QAAQ,KAAK,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,QAAQ,OAAO;EACf,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAC7C,OAAO,QAAQ,IACb,MAAM,IAAI,OAAO,MAAM,MAAM;GAC3B,IAAI,SAAS,IAAI,GAAG;IAClB,KAAK,KAAK,CAAC;IACX,OAAO,cAAc,KAAK,IAAI,MAAM,QAAQ;GAC9C,OAEE,KAAK,KAAK;EAEd,CAAC,CACH;OAGA,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,KAAK,EAAE;CAE/C,OACE,QAAQ,OAAO;AAEnB;AAEA,SAAS,YAAY,OAAqB;CACxC,OAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C"}

package/build/k.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/k.ts
+function k(strings) {
+	return strings.split(" ");
+}
+k(`foo bar zaz`);
+//#endregion
+
+//# sourceMappingURL=k.cjs.map

package/build/k.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"k.cjs","names":[],"sources":["../src/k.ts"],"sourcesContent":["type ToKeys<S extends string> = S extends `${infer H} ${infer T}` ? H | `${ToKeys<T>}` : S;\n\nfunction k<S extends string>(strings: S): ToKeys<S>[] {\n  return strings.split(\" \") as ToKeys<S>[];\n}\n\nfunction foo(k: \"foo\" | \"bar\") {}\n\nconst keys = k(`foo bar zaz`);\n// keys.forEach(foo);\n"],"mappings":";;AAEA,SAAS,EAAoB,SAAyB;CACpD,OAAO,QAAQ,MAAM,GAAG;AAC1B;AAIa,EAAE,aAAa"}

package/build/k.d.cts

@@ -0,0 +1 @@
+export {}

package/build/k.d.mts

@@ -0,0 +1 @@
+export {}

package/build/k.js

@@ -1,9 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+//#region src/k.ts
 function k(strings) {
-    return strings.split(" ");
+	return strings.split(" ");
 }
-function foo(k) { }
-const keys = k(`foo bar zaz`);
-// keys.forEach(foo);
+k(`foo bar zaz`);
+//#endregion
+export {};
+
 //# sourceMappingURL=k.js.map

package/build/k.js.map

@@ -1 +1 @@
-{"version":3,"file":"k.js","sourceRoot":"","sources":["../src/k.ts"],"names":[],"mappings":";;AAEA,SAAS,CAAC,CAAmB,OAAU;IACrC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;AAC3C,CAAC;AAED,SAAS,GAAG,CAAC,CAAgB,IAAG,CAAC;AAEjC,MAAM,IAAI,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC9B,qBAAqB"}
+{"version":3,"file":"k.js","names":[],"sources":["../src/k.ts"],"sourcesContent":["type ToKeys<S extends string> = S extends `${infer H} ${infer T}` ? H | `${ToKeys<T>}` : S;\n\nfunction k<S extends string>(strings: S): ToKeys<S>[] {\n  return strings.split(\" \") as ToKeys<S>[];\n}\n\nfunction foo(k: \"foo\" | \"bar\") {}\n\nconst keys = k(`foo bar zaz`);\n// keys.forEach(foo);\n"],"mappings":";AAEA,SAAS,EAAoB,SAAyB;CACpD,OAAO,QAAQ,MAAM,GAAG;AAC1B;AAIa,EAAE,aAAa"}