yayson 4.0.0 → 4.2.0

package/build/{types-DbMIe8E2.d.cts → types-KZiF6x7A.d.mts}

@@ -4,6 +4,7 @@ declare class Adapter {
   static get(model: ModelLike): Record<string, unknown>;
   static get(model: ModelLike, key: string): unknown;
   static id(model: ModelLike): string | undefined;
+  static has(model: ModelLike, key: string): boolean;
 }
 //#endregion
 //#region src/yayson/symbols.d.ts
@@ -46,6 +47,17 @@ interface JsonApiRelationship {
   links?: JsonApiLink;
   meta?: Record<string, unknown>;
 }
+/**
+ * Extended relationship descriptor for `relationships()` return values.
+ * `hasMany: true` renders empty/missing as `data: []` (spec-compliant to-many).
+ * `optional: true` omits the relationship when its key is absent on the instance
+ * (or renders `links` only); explicit `null`/`[]` still render normally.
+ */
+interface RelationshipConfig<P> {
+  presenter: P;
+  hasMany?: boolean;
+  optional?: boolean;
+}
 interface JsonApiRelationships {
   [key: string]: JsonApiRelationship;
 }
@@ -87,6 +99,13 @@ interface StoreModel extends Record<string, unknown> {
   [REL_LINKS]?: JsonApiLink;
   [REL_META]?: Record<string, unknown>;
 }
+/** Model type for create payloads where id may be absent */
+interface StoreModelWithOptionalId extends Record<string, unknown> {
+  id?: string | number;
+  [TYPE]?: string;
+  [LINKS]?: JsonApiLink;
+  [META]?: Record<string, unknown>;
+}
 interface StoreModels {
   [type: string]: {
     [id: string]: StoreModel;
@@ -118,5 +137,5 @@ interface LegacyStoreOptions<S extends SchemaRegistry = SchemaRegistry> {
   strict?: boolean;
 }
 //#endregion
-export { TYPE as C, REL_META as S, ModelLike as T, ValidationError as _, JsonApiRelationship as a, META as b, LegacyPresenterOptions as c, SchemaRegistry as d, StoreModel as f, StoreResult as g, StoreRecord as h, JsonApiLinks as i, LegacyStoreOptions as l, StoreOptions as m, JsonApiDocument as n, JsonApiRelationships as o, StoreModels as p, JsonApiLink as r, JsonApiResource as s, InferModelType as t, PresenterOptions as u, ZodLikeSchema as v, Adapter as w, REL_LINKS as x, LINKS as y };
-//# sourceMappingURL=types-DbMIe8E2.d.cts.map
+export { REL_LINKS as C, ModelLike as D, Adapter as E, META as S, TYPE as T, StoreRecord as _, JsonApiRelationship as a, ZodLikeSchema as b, LegacyPresenterOptions as c, RelationshipConfig as d, SchemaRegistry as f, StoreOptions as g, StoreModels as h, JsonApiLinks as i, LegacyStoreOptions as l, StoreModelWithOptionalId as m, JsonApiDocument as n, JsonApiRelationships as o, StoreModel as p, JsonApiLink as r, JsonApiResource as s, InferModelType as t, PresenterOptions as u, StoreResult as v, REL_META as w, LINKS as x, ValidationError as y };
+//# sourceMappingURL=types-KZiF6x7A.d.mts.map

package/build/types-KZiF6x7A.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-KZiF6x7A.d.mts","names":[],"sources":["../../../../../../yayson/adapter.ts","../../../../../../yayson/symbols.ts","../../../../../../yayson/schema.ts","../../../../../../yayson/types.ts"],"mappings":"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"}

package/build/{types-BsfPiPEw.d.mts → types-iC38_iCI.d.cts}

@@ -4,6 +4,7 @@ declare class Adapter {
   static get(model: ModelLike): Record<string, unknown>;
   static get(model: ModelLike, key: string): unknown;
   static id(model: ModelLike): string | undefined;
+  static has(model: ModelLike, key: string): boolean;
 }
 //#endregion
 //#region src/yayson/symbols.d.ts
@@ -46,6 +47,17 @@ interface JsonApiRelationship {
   links?: JsonApiLink;
   meta?: Record<string, unknown>;
 }
+/**
+ * Extended relationship descriptor for `relationships()` return values.
+ * `hasMany: true` renders empty/missing as `data: []` (spec-compliant to-many).
+ * `optional: true` omits the relationship when its key is absent on the instance
+ * (or renders `links` only); explicit `null`/`[]` still render normally.
+ */
+interface RelationshipConfig<P> {
+  presenter: P;
+  hasMany?: boolean;
+  optional?: boolean;
+}
 interface JsonApiRelationships {
   [key: string]: JsonApiRelationship;
 }
@@ -87,6 +99,13 @@ interface StoreModel extends Record<string, unknown> {
   [REL_LINKS]?: JsonApiLink;
   [REL_META]?: Record<string, unknown>;
 }
+/** Model type for create payloads where id may be absent */
+interface StoreModelWithOptionalId extends Record<string, unknown> {
+  id?: string | number;
+  [TYPE]?: string;
+  [LINKS]?: JsonApiLink;
+  [META]?: Record<string, unknown>;
+}
 interface StoreModels {
   [type: string]: {
     [id: string]: StoreModel;
@@ -118,5 +137,5 @@ interface LegacyStoreOptions<S extends SchemaRegistry = SchemaRegistry> {
   strict?: boolean;
 }
 //#endregion
-export { TYPE as C, REL_META as S, ModelLike as T, ValidationError as _, JsonApiRelationship as a, META as b, LegacyPresenterOptions as c, SchemaRegistry as d, StoreModel as f, StoreResult as g, StoreRecord as h, JsonApiLinks as i, LegacyStoreOptions as l, StoreOptions as m, JsonApiDocument as n, JsonApiRelationships as o, StoreModels as p, JsonApiLink as r, JsonApiResource as s, InferModelType as t, PresenterOptions as u, ZodLikeSchema as v, Adapter as w, REL_LINKS as x, LINKS as y };
-//# sourceMappingURL=types-BsfPiPEw.d.mts.map
+export { REL_LINKS as C, ModelLike as D, Adapter as E, META as S, TYPE as T, StoreRecord as _, JsonApiRelationship as a, ZodLikeSchema as b, LegacyPresenterOptions as c, RelationshipConfig as d, SchemaRegistry as f, StoreOptions as g, StoreModels as h, JsonApiLinks as i, LegacyStoreOptions as l, StoreModelWithOptionalId as m, JsonApiDocument as n, JsonApiRelationships as o, StoreModel as p, JsonApiLink as r, JsonApiResource as s, InferModelType as t, PresenterOptions as u, StoreResult as v, REL_META as w, LINKS as x, ValidationError as y };
+//# sourceMappingURL=types-iC38_iCI.d.cts.map

package/build/types-iC38_iCI.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-iC38_iCI.d.cts","names":[],"sources":["../../../../../../yayson/adapter.ts","../../../../../../yayson/symbols.ts","../../../../../../yayson/schema.ts","../../../../../../yayson/types.ts"],"mappings":";KAAY,SAAA;AAAA,cAEN,OAAA;EAAA,OACG,GAAA,CAAI,KAAA,EAAO,SAAA,GAAY,MAAA;EAAA,OACvB,GAAA,CAAI,KAAA,EAAO,SAAA,EAAW,GAAA;EAAA,OAUtB,EAAA,CAAG,KAAA,EAAO,SAAA;EAAA,OAQV,GAAA,CAAI,KAAA,EAAO,SAAA,EAAW,GAAA;AAAA;;;cCtBlB,IAAA;AAAA,cACA,KAAA;AAAA,cACA,IAAA;AAAA,cACA,SAAA;AAAA,cACA,QAAA;;;;ADJb;;;UEIiB,aAAA;EACf,KAAA,GAAQ,IAAA;EACR,SAAA,GAAY,IAAA;IAAoB,OAAA;IAAe,IAAA;EAAA;IAAoB,OAAA;IAAgB,KAAA;EAAA;AAAA;;;UCHpE,WAAA,SAAoB,MAAA;EACnC,IAAA;EACA,OAAA;AAAA;AAAA,UAGe,YAAA;EAAA,CACd,GAAA,WAAc,WAAA;AAAA;AAAA,UAGA,yBAAA;EACf,EAAA;EACA,IAAA;AAAA;AAAA,UAGe,mBAAA;EACf,IAAA,GAAO,yBAAA,GAA4B,yBAAA;EACnC,KAAA,GAAQ,WAAA;EACR,IAAA,GAAO,MAAA;AAAA;;;;;;;UASQ,kBAAA;EACf,SAAA,EAAW,CAAA;EACX,OAAA;EACA,QAAA;AAAA;AAAA,UAGe,oBAAA;EAAA,CACd,GAAA,WAAc,mBAAA;AAAA;AAAA,UAGA,eAAA;EACf,EAAA;EACA,IAAA;EACA,UAAA,GAAa,MAAA;EACb,aAAA,GAAgB,oBAAA;EAChB,KAAA,GAAQ,WAAA;EACR,IAAA,GAAO,MAAA;AAAA;AAAA,UAGQ,eAAA;EACf,IAAA,EAAM,eAAA,GAAkB,eAAA;EACxB,QAAA,GAAW,eAAA;EACX,KAAA,GAAQ,YAAA;EACR,IAAA,GAAO,MAAA;AAAA;AAAA,UAGQ,gBAAA;EACf,IAAA,GAAO,MAAA;EACP,KAAA,GAAQ,YAAA;EACR,OAAA;AAAA;AAAA,UAGe,sBAAA,SAA+B,gBAAA;EAC9C,aAAA;AAAA;AAAA,UAGe,WAAA;EACf,EAAA;EACA,IAAA;EACA,UAAA,GAAa,MAAA;EACb,aAAA,GAAgB,oBAAA;EAChB,KAAA,GAAQ,WAAA;EACR,IAAA,GAAO,MAAA;AAAA;AAAA,UAGQ,UAAA,SAAmB,MAAA;EAClC,EAAA;EAAA,CACC,IAAA;EAAA,CACA,KAAA,IAAS,WAAA;EAAA,CACT,IAAA,IAAQ,MAAA;EAAA,CACR,SAAA,IAAa,WAAA;EAAA,CACb,QAAA,IAAY,MAAA;AAAA;;UAIE,wBAAA,SAAiC,MAAA;EAChD,EAAA;EAAA,CACC,IAAA;EAAA,CACA,KAAA,IAAS,WAAA;EAAA,CACT,IAAA,IAAQ,MAAA;AAAA;AAAA,UAGM,WAAA;EAAA,CACd,IAAA;IAAA,CACE,EAAA,WAAa,UAAA;EAAA;AAAA;AAAA,UAID,cAAA;EAAA,CACd,IAAA,WAAe,aAAA;AAAA;AAAA,KAIN,eAAA,WAA0B,MAAA;EACpC,KAAA,GAAQ,IAAA;EACR,SAAA,GAAY,IAAA;AAAA,IAEV,UAAA;AAAA,KAGQ,cAAA,sCAAoD,QAAA,SAAiB,cAAA,GAC7E,QAAA,eAAuB,QAAA,GACrB,eAAA,CAAgB,QAAA,CAAS,QAAA,KACzB,UAAA,GACF,UAAA;AAAA,UAEa,WAAA,KAAgB,UAAA,UAAoB,KAAA,CAAM,CAAA;EAAA,CACxD,IAAA,IAAQ,MAAA;AAAA;AAAA,UAGM,YAAA,WAAuB,cAAA,GAAiB,cAAA;EACvD,OAAA,GAAU,CAAA;EACV,MAAA;AAAA;AAAA,UAGe,eAAA;EACf,IAAA;EACA,EAAA;EACA,KAAA;AAAA;AAAA,UAGe,kBAAA,WAA6B,cAAA,GAAiB,cAAA;EAC7D,KAAA,GAAQ,MAAA;EACR,OAAA,GAAU,CAAA;EACV,MAAA;AAAA"}

package/build/utils.cjs

@@ -1,4 +1,4 @@
-const require_symbols = require('./symbols-nFs99aEX.cjs');
+const require_symbols = require('./symbols-B--FS78o.cjs');
 
 //#region src/utils.ts
 function getType(model) {

package/build/utils.d.cts

@@ -1,4 +1,4 @@
-import { C as TYPE, S as REL_META, T as ModelLike, b as META, f as StoreModel, r as JsonApiLink, w as Adapter, x as REL_LINKS, y as LINKS } from "./types-DbMIe8E2.cjs";
+import { C as REL_LINKS, D as ModelLike, E as Adapter, S as META, T as TYPE, p as StoreModel, r as JsonApiLink, w as REL_META, x as LINKS } from "./types-iC38_iCI.cjs";
 
 //#region src/utils.d.ts
 declare function getType(model: StoreModel): string | undefined;

package/build/utils.d.mts

@@ -1,4 +1,4 @@
-import { C as TYPE, S as REL_META, T as ModelLike, b as META, f as StoreModel, r as JsonApiLink, w as Adapter, x as REL_LINKS, y as LINKS } from "./types-BsfPiPEw.mjs";
+import { C as REL_LINKS, D as ModelLike, E as Adapter, S as META, T as TYPE, p as StoreModel, r as JsonApiLink, w as REL_META, x as LINKS } from "./types-KZiF6x7A.mjs";
 
 //#region src/utils.d.ts
 declare function getType(model: StoreModel): string | undefined;

package/build/utils.mjs

@@ -1,4 +1,4 @@
-import { a as TYPE, i as REL_META, n as META, o as adapter_default, r as REL_LINKS, t as LINKS } from "./symbols-DSjKJ8vh.mjs";
+import { a as TYPE, i as REL_META, n as META, o as adapter_default, r as REL_LINKS, t as LINKS } from "./symbols-BfU4k1el.mjs";
 
 //#region src/utils.ts
 function getType(model) {

package/build/{yayson-BKEyEcGk.d.cts → yayson-BvwMr4Ad.d.mts}

@@ -1,4 +1,4 @@
-import { T as ModelLike, _ as ValidationError, d as SchemaRegistry, f as StoreModel, g as StoreResult, h as StoreRecord$1, i as JsonApiLinks, m as StoreOptions, n as JsonApiDocument, o as JsonApiRelationships, p as StoreModels, r as JsonApiLink, t as InferModelType, u as PresenterOptions, w as Adapter } from "./types-DbMIe8E2.cjs";
+import { D as ModelLike, E as Adapter, _ as StoreRecord$1, d as RelationshipConfig, f as SchemaRegistry, g as StoreOptions, h as StoreModels, i as JsonApiLinks, m as StoreModelWithOptionalId, n as JsonApiDocument, o as JsonApiRelationships, p as StoreModel, r as JsonApiLink, t as InferModelType, u as PresenterOptions, v as StoreResult, y as ValidationError } from "./types-KZiF6x7A.mjs";
 
 //#region src/yayson/presenter.d.ts
 declare function createPresenter(adapter: typeof Adapter): {
@@ -8,12 +8,15 @@ declare function createPresenter(adapter: typeof Adapter): {
     id(instance: ModelLike): string | undefined;
     selfLinks(_instance: ModelLike): JsonApiLink | string | undefined;
     links(_instance?: ModelLike): JsonApiLinks | undefined;
-    relationships(): Record<string, /*elided*/any>;
+    relationships(): Record<string, /*elided*/any | RelationshipConfig< /*elided*/any>>;
     attributes(instance: ModelLike | null): Record<string, unknown>;
     includeRelationships(scope: JsonApiDocument, instance: ModelLike): unknown[];
-    buildRelationships(instance: ModelLike | null): JsonApiRelationships | null;
+    buildRelationships(instance: ModelLike | null, options?: {
+      payload?: boolean;
+    }): JsonApiRelationships | null;
     buildSelfLink(instance: ModelLike): JsonApiLink | undefined;
     toJSON(instanceOrCollection: ModelLike | ModelLike[] | null | undefined, options?: PresenterOptions): JsonApiDocument;
+    payload(instance: ModelLike, options?: PresenterOptions): JsonApiDocument;
     render(instanceOrCollection: ModelLike | ModelLike[] | null, options?: PresenterOptions): JsonApiDocument;
   };
   adapter: typeof Adapter;
@@ -21,6 +24,7 @@ declare function createPresenter(adapter: typeof Adapter): {
   fields?: string[];
   toJSON(instanceOrCollection: ModelLike | ModelLike[] | null, options?: PresenterOptions): JsonApiDocument;
   render(instanceOrCollection: ModelLike | ModelLike[] | null, options?: PresenterOptions): JsonApiDocument;
+  payload(instance: ModelLike, options?: PresenterOptions): JsonApiDocument;
 };
 type Presenter = ReturnType<typeof createPresenter>;
 //#endregion
@@ -35,6 +39,7 @@ declare class StoreRecord implements StoreRecord$1 {
   constructor(options: StoreRecord$1);
 }
 declare class Store<S extends SchemaRegistry = SchemaRegistry> {
+  #private;
   records: StoreRecord[];
   schemas?: S;
   strict: boolean;
@@ -49,6 +54,15 @@ declare class Store<S extends SchemaRegistry = SchemaRegistry> {
   remove(type: string, id?: string | number): void;
   syncAll(body: JsonApiDocument): StoreResult;
   sync(body: JsonApiDocument): StoreModel | StoreResult;
+  /**
+   * Build a model from a JSON:API document without storing it.
+   * Useful for create payloads where id may be absent.
+   *
+   * Per JSON:API spec: "The id member is not required when the resource object
+   * originates at the client and represents a new resource to be created on the server."
+   */
+  static build(body: JsonApiDocument): StoreModelWithOptionalId;
+  build(body: JsonApiDocument): StoreModelWithOptionalId;
   retrieve<T extends string>(type: T, body: JsonApiDocument): InferModelType<S, T> | null;
   retrieveAll<T extends string>(type: T, body: JsonApiDocument): StoreResult<InferModelType<S, T>>;
 }
@@ -66,4 +80,4 @@ interface YaysonResult {
 declare function yayson(options?: YaysonOptions): YaysonResult;
 //#endregion
 export { Presenter as i, YaysonResult as n, yayson as r, YaysonOptions as t };
-//# sourceMappingURL=yayson-BKEyEcGk.d.cts.map
+//# sourceMappingURL=yayson-BvwMr4Ad.d.mts.map

package/build/yayson-BvwMr4Ad.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yayson-BvwMr4Ad.d.mts","names":[],"sources":["../../../../../../yayson/presenter.ts","../../../../../../yayson/store.ts","../../../../../../yayson.ts"],"mappings":";;;iBA0BwB,eAAA,CAAgB,OAAA,SAAgB,OAAA;EAAA,aAUhC,eAAA;iBAVe;WAQ5B,eAAA;iBAMM,SAAA;yBAIQ,SAAA,GAAY,WAAA;sBAIf,SAAA,GAAY,YAAA;qBAIb,MAAA,SAZJ,gBAYsC,kBAAA,EAZtC;yBAgBQ,SAAA,UAAmB,MAAA;gCAiBZ,eAAA,EAAe,QAAA,EAAY,SAAA;iCAqB1B,SAAA,SAAgB,OAAA;MAAa,OAAA;IAAA,IAA2B,oBAAA;4BAuE7D,SAAA,GAAY,WAAA;iCAKZ,SAAA,GAAY,SAAA,uBAA8B,OAAA,GACtD,gBAAA,GACT,eAAA;sBA8Ee,SAAA,EAAS,OAAA,GAAY,gBAAA,GAAmB,eAAA;iCA0B7B,SAAA,GAAY,SAAA,WAAkB,OAAA,GAAY,gBAAA,GAAmB,eAAA;EAAA;;;;+BAItD,SAAA,GAAY,SAAA,WAAkB,OAAA,GAAY,gBAAA,GAAmB,eAAA;+BAI7D,SAAA,GAAY,SAAA,WAAkB,OAAA,GAAY,gBAAA,GAAmB,eAAA;oBAIxE,SAAA,EAAS,OAAA,GAAY,gBAAA,GAAmB,eAAA;AAAA;AAAA,KAQzD,SAAA,GAAY,UAAA,QAAkB,eAAA;;;cClRpC,WAAA,YAAuB,aAAA;EAC3B,EAAA;EACA,IAAA;EACA,UAAA,GAAa,MAAA;EACb,aAAA,GAAgB,oBAAA;EAChB,KAAA,GAAQ,WAAA;EACR,IAAA,GAAO,MAAA;cAEK,OAAA,EAAS,aAAA;AAAA;AAAA,cAUF,KAAA,WAAgB,cAAA,GAAiB,cAAA;EAAA;EACpD,OAAA,EAAS,WAAA;EACT,OAAA,GAAU,CAAA;EACV,MAAA;EACA,gBAAA,EAAkB,eAAA;cAEN,OAAA,GAAU,YAAA,CAAa,CAAA;EAMnC,KAAA,CAAA;EAmGA,OAAA,CAAQ,GAAA,EAAK,WAAA,EAAa,IAAA,UAAc,MAAA,EAAQ,WAAA,GAAc,UAAA;EA+B9D,UAAA,CAAW,IAAA,UAAc,EAAA,oBAAsB,WAAA;EAK/C,WAAA,CAAY,IAAA,WAAe,WAAA;EAiB3B,IAAA,kBAAA,CAAuB,IAAA,EAAM,CAAA,EAAG,EAAA,mBAAqB,MAAA,GAAS,WAAA,GAAc,cAAA,CAAe,CAAA,EAAG,CAAA;EAM9F,OAAA,kBAAA,CAA0B,IAAA,EAAM,CAAA,EAAG,MAAA,GAAS,WAAA,GAAc,cAAA,CAAe,CAAA,EAAG,CAAA;EAgB5E,MAAA,CAAO,IAAA,UAAc,EAAA;EAkBrB,OAAA,CAAQ,IAAA,EAAM,eAAA,GAAkB,WAAA;EA8DhC,IAAA,CAAK,IAAA,EAAM,eAAA,GAAkB,UAAA,GAAa,WAAA;EDvI5B;;;;;;;EAAA,OC0JP,KAAA,CAAM,IAAA,EAAM,eAAA,GAAkB,wBAAA;EAIrC,KAAA,CAAM,IAAA,EAAM,eAAA,GAAkB,wBAAA;EAQ9B,QAAA,kBAAA,CAA2B,IAAA,EAAM,CAAA,EAAG,IAAA,EAAM,eAAA,GAAkB,cAAA,CAAe,CAAA,EAAG,CAAA;EAW9E,WAAA,kBAAA,CAA8B,IAAA,EAAM,CAAA,EAAG,IAAA,EAAM,eAAA,GAAkB,WAAA,CAAY,cAAA,CAAe,CAAA,EAAG,CAAA;AAAA;;;KCzU1F,aAAA,mBAAgC,OAAA;AAAA,UAE3B,aAAA;EACR,OAAA,GAAU,aAAA;AAAA;AAAA,UAGF,YAAA;EACR,KAAA,SAAc,KAAA;EACd,SAAA,EAAW,SAAA;EACX,OAAA,SAAgB,OAAA;AAAA;AAAA,iBAgBT,MAAA,CAAO,OAAA,GAAU,aAAA,GAAgB,YAAA"}

package/build/{yayson-CUfrxK9d.cjs → yayson-C4P8J4sn.cjs}

@@ -1,4 +1,4 @@
-const require_symbols = require('./symbols-nFs99aEX.cjs');
+const require_symbols = require('./symbols-B--FS78o.cjs');
 
 //#region src/yayson/adapters/sequelize.ts
 function isSequelizeModel(model) {
@@ -8,12 +8,16 @@ var SequelizeAdapter = class extends require_symbols.adapter_default {
 	static get(model, key) {
 		if (isSequelizeModel(model)) return model.get(key);
 	}
+	static has(model, key) {
+		if (isSequelizeModel(model)) return model.get(key) !== void 0;
+		return false;
+	}
 	static id(model) {
 		const pkFields = model.constructor && "primaryKeys" in model.constructor ? Object.keys(model.constructor.primaryKeys) : ["id"];
 		if (pkFields.length > 1) throw new Error("YAYSON does not support Sequelize models with composite primary keys. You can only use one column for your primary key. Currently using: " + pkFields.join(","));
 		else if (pkFields.length < 1) throw new Error("YAYSON can only serialize Sequelize models which have a primary key. This is used for the JSON:API model id.");
 		const id = this.get(model, pkFields[0]);
-		if (id === void 0) return id;
+		if (id == null) return;
 		return `${id}`;
 	}
 };
@@ -69,23 +73,32 @@ function createPresenter(adapter) {
 			const result = [];
 			if (!relationships) return result;
 			for (const key in relationships) {
-				const factory = relationships[key];
-				if (!factory) throw new Error(`Presenter for ${key} in ${this.constructor.type} is not defined`);
-				const presenter = new factory(scope);
+				const entry = relationships[key];
+				if (!entry) throw new Error(`Presenter for ${key} in ${this.constructor.type} is not defined`);
+				const presenter = new (typeof entry === "function" ? entry : entry.presenter)(scope);
 				const data = this.constructor.adapter.get(instance, key);
 				result.push(presenter.toJSON(data, { include: true }));
 			}
 			return result;
 		}
-		buildRelationships(instance) {
+		buildRelationships(instance, options = {}) {
 			if (instance == null) return null;
 			const rels = this.relationships();
 			const links = this.links(instance) || {};
+			const isPayload = options.payload === true;
 			let relationships = null;
 			if (!rels) return null;
 			for (const key in rels) {
+				const entry = rels[key];
+				if (!entry) continue;
+				const isConfig = typeof entry !== "function";
+				const presenter = isConfig ? entry.presenter : entry;
+				const hasMany = isConfig ? entry.hasMany : void 0;
+				const optional = isConfig ? entry.optional ?? false : false;
+				const linkValue = links[key];
+				const hasLinks = linkValue != null;
 				const data = this.constructor.adapter.get(instance, key);
-				const presenter = rels[key];
+				const keyPresent = this.constructor.adapter.has(instance, key);
 				const buildData = (d) => {
 					const id = this.constructor.adapter.id(d);
 					if (!id) throw new Error(`Model of type ${presenter.type} is missing an id (relationship '${key}' of ${this.constructor.type})`);
@@ -94,19 +107,21 @@ function createPresenter(adapter) {
 						type: presenter.type
 					};
 				};
-				const build = (d) => {
-					const rel = {};
-					if (d != null) rel.data = buildData(d);
-					if (links[key] != null) rel.links = buildLinks(links[key]);
-					else if (d == null) rel.data = null;
-					return rel;
-				};
+				if (optional && !keyPresent && !isPayload) {
+					if (hasLinks) {
+						if (!relationships) relationships = {};
+						relationships[key] = { links: buildLinks(linkValue) };
+					}
+					continue;
+				}
 				if (!relationships) relationships = {};
-				if (!relationships[key]) relationships[key] = {};
-				if (Array.isArray(data)) {
-					relationships[key].data = data.map(buildData);
-					if (links[key] != null) relationships[key].links = buildLinks(links[key]);
-				} else relationships[key] = build(data);
+				const rel = {};
+				if (Array.isArray(data)) rel.data = data.map(buildData);
+				else if (data != null) rel.data = buildData(data);
+				else if (hasMany === true) rel.data = [];
+				else if (!hasLinks) rel.data = null;
+				if (hasLinks) rel.links = buildLinks(linkValue);
+				relationships[key] = rel;
 			}
 			return relationships;
 		}
@@ -150,6 +165,23 @@ function createPresenter(adapter) {
 			}
 			return this.scope;
 		}
+		payload(instance, options) {
+			if (Array.isArray(instance)) throw new Error("payload() expects a single resource, not an array");
+			if (instance == null) throw new Error("payload() requires a resource, got null");
+			const model = {
+				type: this.constructor.type,
+				attributes: this.attributes(instance)
+			};
+			const id = this.id(instance);
+			if (id != null) model.id = id;
+			const relationships = this.buildRelationships(instance, { payload: true });
+			if (relationships != null) model.relationships = relationships;
+			const result = { data: model };
+			const opts = options ?? {};
+			if (opts.meta != null) result.meta = opts.meta;
+			if (opts.links != null) result.links = opts.links;
+			return result;
+		}
 		render(instanceOrCollection, options) {
 			return this.toJSON(instanceOrCollection, options);
 		}
@@ -159,6 +191,9 @@ function createPresenter(adapter) {
 		static render(instanceOrCollection, options) {
 			return new this().render(instanceOrCollection, options);
 		}
+		static payload(instance, options) {
+			return new this().payload(instance, options);
+		}
 	}
 	return Presenter;
 }
@@ -190,6 +225,9 @@ function validate(schema, data, strict) {
 
 //#endregion
 //#region src/yayson/store.ts
+function hasId(model) {
+	return model.id != null;
+}
 var StoreRecord = class {
 	id;
 	type;
@@ -206,7 +244,7 @@ var StoreRecord = class {
 		this.meta = options.meta;
 	}
 };
-var Store = class {
+var Store = class Store {
 	records = [];
 	schemas;
 	strict;
@@ -220,37 +258,57 @@ var Store = class {
 		this.records = [];
 		this.validationErrors = [];
 	}
-	toModel(rec, type, models) {
-		const model = {
-			...rec.attributes || {},
-			id: rec.id
-		};
-		model[require_symbols.TYPE] = rec.type;
-		const idStr = String(rec.id);
-		if (!models[type]) models[type] = {};
-		if (!models[type][idStr]) models[type][idStr] = model;
-		if (rec.meta != null) model[require_symbols.META] = rec.meta;
-		if (rec.links != null) model[require_symbols.LINKS] = rec.links;
-		if (rec.relationships != null) for (const key in rec.relationships) {
-			const rel = rec.relationships[key];
-			const { data } = rel;
-			const { links } = rel;
-			const { meta } = rel;
+	#createStub(type, id) {
+		const stub = { id };
+		stub[require_symbols.TYPE] = type;
+		return stub;
+	}
+	#createModel(resource, options) {
+		const models = options?.models ?? {};
+		const model = { ...resource.attributes || {} };
+		if (resource.id != null) model.id = resource.id;
+		const type = resource.type;
+		model[require_symbols.TYPE] = type;
+		if (resource.meta != null) model[require_symbols.META] = resource.meta;
+		if (resource.links != null) model[require_symbols.LINKS] = resource.links;
+		if (hasId(model)) {
+			const idStr = String(model.id);
+			if (!models[type]) models[type] = {};
+			if (!models[type][idStr]) models[type][idStr] = model;
+		}
+		if (resource.relationships != null) {
+			const resolver = (ref) => {
+				return this.#findModel(ref.type, ref.id, models) ?? this.#createStub(ref.type, ref.id);
+			};
+			this.#resolveRelationships(model, resource.relationships, resolver, { includeRelMeta: options?.includeRelMeta });
+		}
+		return model;
+	}
+	#resolveRelationships(model, relationships, resolver, options) {
+		const includeRelMeta = options?.includeRelMeta ?? true;
+		for (const key in relationships) {
+			const { data, links, meta } = relationships[key];
 			model[key] = null;
 			if (data == null && links == null) continue;
-			const resolve = ({ type: type$1, id }) => {
-				return this.find(type$1, id, models);
-			};
-			if (Array.isArray(data)) model[key] = data.map(resolve);
-			else {
-				const relModel = data != null ? resolve(data) : { id: "" };
-				if (relModel) {
-					relModel[require_symbols.REL_LINKS] = links || {};
-					relModel[require_symbols.REL_META] = meta || {};
-					model[key] = relModel;
+			if (Array.isArray(data)) model[key] = data.filter((item) => item.id != null).map(resolver);
+			else if (data != null && data.id != null) {
+				const relModel = resolver(data);
+				if (includeRelMeta) {
+					const modelWithMeta = relModel;
+					modelWithMeta[require_symbols.REL_LINKS] = links || {};
+					modelWithMeta[require_symbols.REL_META] = meta || {};
 				}
+				model[key] = relModel;
+			} else if (data == null && (links != null || meta != null) && includeRelMeta) {
+				const relModel = { id: "" };
+				relModel[require_symbols.REL_LINKS] = links || {};
+				relModel[require_symbols.REL_META] = meta || {};
+				model[key] = relModel;
 			}
 		}
+	}
+	toModel(rec, type, models) {
+		const model = this.#createModel(rec, { models });
 		if (this.schemas && this.schemas[rec.type]) {
 			const schema = this.schemas[rec.type];
 			const result = validate(schema, model, this.strict);
@@ -274,13 +332,16 @@ var Store = class {
 	findRecords(type) {
 		return this.records.filter((r) => r.type === type);
 	}
-	find(type, id, models) {
-		const modelsObj = models ?? {};
+	#findModel(type, id, models) {
 		const idStr = String(id);
-		const rec = this.findRecord(type, idStr);
+		const cached = models[type]?.[idStr];
+		if (cached) return cached;
+		const rec = this.findRecord(type, id);
 		if (rec == null) return null;
-		if (!modelsObj[type]) modelsObj[type] = {};
-		return modelsObj[type][idStr] || this.toModel(rec, type, modelsObj);
+		return this.toModel(rec, type, models);
+	}
+	find(type, id, models) {
+		return this.#findModel(type, id, models ?? {});
 	}
 	findAll(type, models) {
 		const modelsObj = models ?? {};
@@ -354,6 +415,21 @@ var Store = class {
 		}
 		return result;
 	}
+	/**
+	* Build a model from a JSON:API document without storing it.
+	* Useful for create payloads where id may be absent.
+	*
+	* Per JSON:API spec: "The id member is not required when the resource object
+	* originates at the client and represents a new resource to be created on the server."
+	*/
+	static build(body) {
+		return new Store().build(body);
+	}
+	build(body) {
+		const { data } = body;
+		if (data == null || Array.isArray(data)) throw new Error("build() expects a single resource in data, not null or an array");
+		return this.#createModel(data);
+	}
 	retrieve(type, body) {
 		const synced = this.syncAll(body);
 		const model = synced.find((m) => m[require_symbols.TYPE] === type);