@iamjulianacosta/mobx-data 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Julián Acosta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,366 @@
+# mobx-data
+
+[![build](https://img.shields.io/endpoint?url=https://iamjulianacosta.github.io/mobx-data/build-badge.json)](https://github.com/IAmJulianAcosta/mobx-data)
+[![coverage](https://img.shields.io/endpoint?url=https://iamjulianacosta.github.io/mobx-data/coverage-badge.json)](https://github.com/IAmJulianAcosta/mobx-data)
+[![version](https://img.shields.io/endpoint?url=https://iamjulianacosta.github.io/mobx-data/version-badge.json)](https://github.com/IAmJulianAcosta/mobx-data/releases)
+[![license](https://img.shields.io/endpoint?url=https://iamjulianacosta.github.io/mobx-data/license-badge.json)](./LICENSE)
+
+A feature-complete port of Ember Data to MobX — framework-agnostic, TypeScript-first, fully observable.
+
+---
+
+## Overview
+
+`mobx-data` brings the battle-tested Ember Data mental model (Identity Map, pluggable adapters/serializers, record state machines, async relationships) to any MobX application.  All state is observable; no manual invalidation or subscriptions are needed.
+
+### Design principles
+
+- **Framework-agnostic** — works with React, Vue, Solid, or plain JS
+- **MobX-native** — every piece of state is a MobX `observable`; computed props react automatically
+- **TypeScript-first** — full generic types throughout
+- **Ember Data parity** — near 1-to-1 API mapping so Ember Data users feel at home
+
+---
+
+## Features
+
+| Feature | Status |
+|---------|--------|
+| `Store` with Identity Map | ✅ |
+| `Model` base class + lifecycle hooks | ✅ |
+| `@attr`, `@belongsTo`, `@hasMany` decorators | ✅ |
+| Record state machine (`isNew`, `isDirty`, `isSaving`, …) | ✅ |
+| Dirty tracking & `rollbackAttributes` | ✅ |
+| `RecordArray` / `AdapterPopulatedRecordArray` | ✅ |
+| `RestAdapter` | ✅ |
+| `JsonApiAdapter` | ✅ |
+| `ODataAdapter` (v4) | ✅ |
+| `JsonSerializer` / `RestSerializer` / `JsonApiSerializer` | ✅ |
+| `EmbeddedRecordsMixin` | ✅ |
+| Async & sync `belongsTo` / `hasMany` | ✅ |
+| Inverse relationship tracking | ✅ |
+| `Snapshot` | ✅ |
+| `RequestManager` + handler chain | ✅ |
+| `FetchHandler` / `CacheHandler` | ✅ |
+| Built-in transforms (`string`, `number`, `boolean`, `date`) | ✅ |
+| `SchemaService` | ✅ |
+| `Errors` (field-level validation) | ✅ |
+
+---
+
+## Installation
+
+```bash
+pnpm add mobx-data mobx reflect-metadata tsyringe
+```
+
+Enable decorator metadata in your `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+Import `reflect-metadata` once at your application entry point:
+
+```ts
+import 'reflect-metadata';
+```
+
+---
+
+## Quick start
+
+### 1. Define models
+
+```ts
+import { Model, attr, belongsTo, hasMany } from 'mobx-data/model';
+
+class User extends Model {
+  static modelName = 'user';
+
+  @attr('string') name!: string;
+  @attr('string') email!: string;
+
+  @hasMany('post', { async: false, inverse: 'author' })
+  posts!: ManyArray<Post>;
+}
+
+class Post extends Model {
+  static modelName = 'post';
+
+  @attr('string') title!: string;
+  @attr('date')   publishedAt!: Date | null;
+
+  @belongsTo('user', { async: false, inverse: 'posts' })
+  author!: User | null;
+}
+```
+
+### 2. Create a store
+
+```ts
+import 'reflect-metadata';
+import { container } from 'tsyringe';
+import { Store } from 'mobx-data/store';
+import { SchemaService } from 'mobx-data/schema';
+import { RestAdapter } from 'mobx-data/adapter';
+import { JsonSerializer } from 'mobx-data/serializer';
+
+const schema = container.resolve(SchemaService);
+schema.registerModel('user', User);
+schema.registerModel('post', Post);
+
+const store = container.resolve(Store);
+
+const adapter = new RestAdapter();
+adapter.host = 'https://api.example.com';
+
+store.registerAdapter('application', adapter);
+store.registerSerializer('application', new JsonSerializer());
+```
+
+### 3. Use the store
+
+```ts
+// Find a single record
+const user = await store.findRecord('user', '1');
+console.log(user.name); // 'Alice'
+
+// Find all
+const users = await store.findAll('user');
+
+// Query
+const posts = await store.query('post', { filter: { published: true } });
+
+// Create
+const post = store.createRecord('post', { title: 'Hello World' });
+await post.save();
+
+// Update
+user.name = 'Bob';
+await user.save();
+
+// Delete
+await post.destroyRecord();
+
+// Push raw data
+store.push({
+  data: { type: 'user', id: '2', attributes: { name: 'Carol' } }
+});
+```
+
+---
+
+## Adapters
+
+### RestAdapter
+
+Standard REST conventions (`GET /users/1`, `POST /users`, `PUT /users/1`, `DELETE /users/1`).
+
+```ts
+const adapter = new RestAdapter();
+adapter.host = 'https://api.example.com';
+adapter.namespace = 'api/v2';
+adapter.headers = { Authorization: 'Bearer …' };
+```
+
+### JsonApiAdapter
+
+Implements the [JSON:API](https://jsonapi.org) specification, including `application/vnd.api+json` MIME type and PATCH for updates.
+
+```ts
+const adapter = new JsonApiAdapter();
+adapter.host = 'https://api.example.com';
+```
+
+### ODataAdapter
+
+Implements OData v4 conventions (PascalCase entity sets, key-in-parentheses URLs, `$filter` / `$expand` / `$select` / `$top` / `$skip` / `$orderby` / `$count`).
+
+```ts
+import { ODataAdapter } from 'mobx-data/odata';
+
+const adapter = new ODataAdapter();
+adapter.host = 'https://api.example.com/odata';
+
+// $expand navigation properties
+const posts = await adapter.query(store, 'post', {
+  $expand: 'author,comments',
+  $filter: "publishedAt gt '2026-01-01'",
+  $orderby: 'title asc',
+});
+```
+
+---
+
+## Serializers
+
+| Class | Format |
+|-------|--------|
+| `JsonSerializer` | Flat JSON objects / arrays |
+| `RestSerializer` | Root-key format with optional sideloading |
+| `JsonApiSerializer` | [JSON:API](https://jsonapi.org) compound documents |
+
+### EmbeddedRecordsMixin
+
+```ts
+import { RestSerializer, EmbeddedRecordsMixin } from 'mobx-data/serializer';
+
+class PostSerializer extends EmbeddedRecordsMixin(RestSerializer) {
+  attrs = {
+    comments: { embedded: 'always' },
+  };
+}
+```
+
+---
+
+## Relationships
+
+```ts
+// Sync (records must already be in the store)
+@belongsTo('user', { async: false }) author!: User | null;
+@hasMany('tag',  { async: false })   tags!: ManyArray<Tag>;
+
+// Async (loaded on demand)
+@belongsTo('user',    { async: true }) author!: AsyncBelongsTo<User>;
+@hasMany('comment',   { async: true }) comments!: AsyncHasMany<Comment>;
+```
+
+Async wrappers are `PromiseLike` — they can be `await`ed or used in MobX reactions:
+
+```ts
+const author = await post.author; // AsyncBelongsTo<User>
+console.log(post.author.isLoaded); // true
+```
+
+Inverse tracking is automatic when `inverse` is specified:
+
+```ts
+@belongsTo('user', { async: false, inverse: 'posts' }) author!: User | null;
+// Setting post.author automatically adds post to user.posts
+```
+
+---
+
+## Transforms
+
+```ts
+@attr('string')  name!: string;
+@attr('number')  age!: number;
+@attr('boolean') active!: boolean;
+@attr('date')    createdAt!: Date | null;
+@attr()          raw!: unknown;  // pass-through
+```
+
+---
+
+## Request pipeline
+
+The `RequestManager` provides a middleware-style handler chain:
+
+```ts
+import { RequestManager, FetchHandler, CacheHandler } from 'mobx-data/request';
+
+const manager = new RequestManager()
+  .useCache(new CacheHandler())
+  .use(new FetchHandler());
+```
+
+Implement custom handlers for authentication, logging, retry logic, etc.:
+
+```ts
+class AuthHandler {
+  async request(context, next) {
+    context.request.headers = {
+      ...context.request.headers,
+      Authorization: `Bearer ${getToken()}`,
+    };
+    return next(context.request);
+  }
+}
+```
+
+---
+
+## Record state
+
+Every record exposes observable boolean flags derived from its internal state machine:
+
+| Property | Description |
+|----------|-------------|
+| `isNew` | Created locally, never saved |
+| `isDirty` | Has unsaved local changes |
+| `isSaving` | Adapter request in flight |
+| `isLoading` | Being fetched from server |
+| `isLoaded` | Loaded and available |
+| `isDeleted` | Marked for deletion |
+| `isError` | Last operation failed |
+| `isValid` | No validation errors |
+
+```ts
+const post = store.createRecord('post', { title: 'Draft' });
+post.isNew;   // true
+post.isDirty; // true
+
+await post.save();
+post.isNew;   // false
+post.isDirty; // false
+```
+
+---
+
+## Testing
+
+The project includes a full end-to-end test suite against an in-process OData server built with [`simple-odata-server`](https://github.com/pofider/simple-odata-server).
+
+```bash
+pnpm test          # run all tests once
+pnpm test:watch    # watch mode
+pnpm typecheck     # TypeScript type check
+```
+
+To run the test OData server manually:
+
+```bash
+bun tests/e2e/fixtures/run-bun.ts
+```
+
+---
+
+## Project structure
+
+```
+src/
+  adapter/          — Adapter, RestAdapter
+  json-api/         — JsonApiAdapter, JsonApiSerializer
+  model/            — Model, StateMachine, Errors, Snapshot, relationships
+  odata/            — ODataAdapter
+  request/          — RequestManager, FetchHandler, CacheHandler, types
+  schema/           — SchemaService, decorators (@attr, @belongsTo, @hasMany), types
+  serializer/       — Serializer, JsonSerializer, RestSerializer, EmbeddedRecordsMixin
+  store/            — Store, IdentityMap, RecordArray
+  transforms/       — Transform, BooleanTransform, DateTransform, NumberTransform, StringTransform
+tests/
+  e2e/              — end-to-end tests against a live OData server
+    fixtures/       — in-process OData server, seed data, filter engine
+  adapter/          — adapter unit tests
+  model/            — model unit tests
+  (…)
+```
+
+---
+
+## License
+
+MIT
+
+---
+
+> **Note:** This project is developed internally and published as open source.
+> Bug reports and issues are welcome.

package/dist/CacheHandler-BTU_rYkv.js

@@ -0,0 +1,208 @@
+import { injectable as u } from "tsyringe";
+var p = Object.getOwnPropertyDescriptor, f = (e, r, t, s) => {
+  for (var n = s > 1 ? void 0 : s ? p(r, t) : r, a = e.length - 1, c; a >= 0; a--)
+    (c = e[a]) && (n = c(n) || n);
+  return n;
+};
+let d = class {
+  constructor() {
+    this._handlers = [], this._cache = null;
+  }
+  /**
+   * Appends one or more handlers to the pipeline.
+   * Returns `this` for chaining.
+   */
+  use(e) {
+    return Array.isArray(e) ? this._handlers.push(...e) : this._handlers.push(e), this;
+  }
+  /**
+   * Registers the cache handler.  It is always inserted at the front of
+   * the chain so it can intercept requests before any other handler sees them.
+   * Returns `this` for chaining.
+   */
+  useCache(e) {
+    return this._cache = e, this;
+  }
+  /** All non-cache handlers in registration order. */
+  get handlers() {
+    return this._handlers;
+  }
+  /** The registered cache handler, or `null`. */
+  get cacheHandler() {
+    return this._cache;
+  }
+  /**
+   * Executes `request` through the full handler chain and returns the final
+   * `StoreResponse`.
+   *
+   * @throws when no handlers have been registered.
+   * @throws when the chain ends without any handler returning a response
+   *         (i.e. no terminal handler such as `FetchHandler`).
+   */
+  async request(e) {
+    const r = this._cache ? [this._cache, ...this._handlers] : [...this._handlers];
+    if (r.length === 0)
+      throw new Error(
+        "RequestManager has no handlers registered — cannot complete request"
+      );
+    let t = 0;
+    const s = async (n) => {
+      const a = r[t];
+      if (!a)
+        throw new Error(
+          "Handler chain ended without producing a response (no terminal handler)"
+        );
+      t++;
+      const c = {
+        request: n,
+        response: void 0,
+        setResponse(l) {
+          this.response = l;
+        }
+      }, i = (l) => s(l);
+      return a.request(c, i);
+    };
+    return s(e);
+  }
+};
+d = f([
+  u()
+], d);
+var y = Object.getOwnPropertyDescriptor, _ = (e, r, t, s) => {
+  for (var n = s > 1 ? void 0 : s ? y(r, t) : r, a = e.length - 1, c; a >= 0; a--)
+    (c = e[a]) && (n = c(n) || n);
+  return n;
+};
+class v extends Error {
+  constructor(r, t, s, n) {
+    super(n ?? `Request failed with status ${r}`), this.status = r, this.content = t, this.headers = s;
+  }
+}
+let h = class {
+  static headersToObject(e) {
+    const r = {};
+    return e.forEach((t, s) => {
+      r[s] = t;
+    }), r;
+  }
+  static async parseBody(e) {
+    const r = e.headers.get("Content-Type") ?? "";
+    if (e.status === 204 || e.headers.get("Content-Length") === "0")
+      return null;
+    if (r.includes("application/json") || r.includes("application/vnd.api+json")) {
+      const s = await e.text();
+      if (!s)
+        return null;
+      try {
+        return JSON.parse(s);
+      } catch {
+        return s;
+      }
+    }
+    return e.text();
+  }
+  /**
+   * Issues the HTTP request and returns a `StoreResponse`.
+   * This is a terminal handler — it never calls `next`.
+   *
+   * @throws `FetchError` on non-2xx responses.
+   */
+  async request(e, r) {
+    const t = e.request, s = {
+      method: t.method,
+      headers: t.headers
+    };
+    t.body !== void 0 && t.body !== null && (s.body = t.body), t.signal && (s.signal = t.signal);
+    const n = await fetch(t.url, s), a = await h.parseBody(n), c = h.headersToObject(n.headers);
+    if (!n.ok)
+      throw new v(n.status, a, c);
+    return {
+      content: a,
+      status: n.status,
+      headers: c,
+      request: t
+    };
+  }
+};
+h = _([
+  u()
+], h);
+var w = Object.getOwnPropertyDescriptor, g = (e, r, t, s) => {
+  for (var n = s > 1 ? void 0 : s ? w(r, t) : r, a = e.length - 1, c; a >= 0; a--)
+    (c = e[a]) && (n = c(n) || n);
+  return n;
+};
+let o = class {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map(), this.maxSize = 256, this.ttl = 3e5;
+  }
+  isExpired(e) {
+    return Date.now() - e.cachedAt > this.ttl;
+  }
+  evictLRU() {
+    for (; this.cache.size > this.maxSize; ) {
+      const e = this.cache.keys().next().value;
+      if (e !== void 0)
+        this.cache.delete(e);
+      else
+        break;
+    }
+  }
+  static keyFor(e) {
+    var r;
+    return ((r = e.cacheOptions) == null ? void 0 : r.key) ?? `${e.method} ${e.url}`;
+  }
+  static isCacheable(e) {
+    return e.method === "GET";
+  }
+  /**
+   * Handles a request by checking the in-memory cache before forwarding to
+   * the next handler.
+   *
+   * - Non-GET requests skip the cache entirely.
+   * - `cacheOptions.reload: true` forces a network request and refreshes the entry.
+   * - Cached entries expire after `ttl` milliseconds (default 5 minutes).
+   * - The cache uses LRU eviction when it exceeds `maxSize` entries (default 256).
+   */
+  async request(e, r) {
+    var c;
+    const t = e.request;
+    if (!o.isCacheable(t))
+      return r(t);
+    const s = o.keyFor(t);
+    if (!(((c = t.cacheOptions) == null ? void 0 : c.reload) === !0)) {
+      const i = this.cache.get(s);
+      if (i)
+        if (this.isExpired(i))
+          this.cache.delete(s);
+        else
+          return this.cache.delete(s), this.cache.set(s, i), i.response;
+    }
+    const a = await r(t);
+    return this.cache.set(s, { response: a, cachedAt: Date.now() }), this.evictLRU(), a;
+  }
+  /** Returns the number of entries currently in the cache. */
+  get size() {
+    return this.cache.size;
+  }
+  /** Removes all entries from the cache. */
+  clear() {
+    this.cache.clear();
+  }
+  /**
+   * Removes a single entry by key.
+   * @returns `true` when the entry existed and was deleted.
+   */
+  delete(e) {
+    return this.cache.delete(e);
+  }
+};
+o = g([
+  u()
+], o);
+export {
+  o as C,
+  h as F,
+  d as R
+};
+//# sourceMappingURL=CacheHandler-BTU_rYkv.js.map

package/dist/CacheHandler-BTU_rYkv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheHandler-BTU_rYkv.js","sources":["../src/request/RequestManager.ts","../src/request/FetchHandler.ts","../src/request/CacheHandler.ts"],"sourcesContent":["/**\n * Middleware-style manager that runs a `StoreRequest` through an ordered chain\n * of `Handler` instances.\n *\n * Handlers are invoked in registration order.  Each handler receives a\n * `RequestContext` and a `next` function; it may:\n * - Call `next(request)` to pass control to the next handler.\n * - Return a `StoreResponse` directly to short-circuit the chain.\n * - Wrap `next` to inspect or transform the response (e.g. logging).\n *\n * An optional *cache handler* registered via `useCache()` is always prepended\n * to the chain so it runs before every other handler.\n *\n * Usage:\n * ```ts\n * const manager = new RequestManager()\n *   .useCache(new CacheHandler())\n *   .use([new AuthHandler(), new FetchHandler()]);\n *\n * const response = await manager.request({ method: 'GET', url: '/posts' });\n * ```\n */\n\nimport { injectable } from 'tsyringe';\nimport type {\n  Handler,\n  NextFn,\n  RequestContext,\n  StoreRequest,\n  StoreResponse,\n} from './types.js';\n\n@injectable()\nexport class RequestManager {\n  private _handlers: Handler[] = [];\n  private _cache: Handler | null = null;\n\n  /**\n   * Appends one or more handlers to the pipeline.\n   * Returns `this` for chaining.\n   */\n  use(handlers: Handler[] | Handler): this {\n    if (Array.isArray(handlers)) {\n      this._handlers.push(...handlers);\n    } else {\n      this._handlers.push(handlers);\n    }\n    return this;\n  }\n\n  /**\n   * Registers the cache handler.  It is always inserted at the front of\n   * the chain so it can intercept requests before any other handler sees them.\n   * Returns `this` for chaining.\n   */\n  useCache(handler: Handler): this {\n    this._cache = handler;\n    return this;\n  }\n\n  /** All non-cache handlers in registration order. */\n  get handlers(): readonly Handler[] {\n    return this._handlers;\n  }\n\n  /** The registered cache handler, or `null`. */\n  get cacheHandler(): Handler | null {\n    return this._cache;\n  }\n\n  /**\n   * Executes `request` through the full handler chain and returns the final\n   * `StoreResponse`.\n   *\n   * @throws when no handlers have been registered.\n   * @throws when the chain ends without any handler returning a response\n   *         (i.e. no terminal handler such as `FetchHandler`).\n   */\n  async request<T = unknown>(request: StoreRequest): Promise<StoreResponse<T>> {\n    const chain: Handler[] = this._cache\n      ? [this._cache, ...this._handlers]\n      : [...this._handlers];\n\n    if (chain.length === 0) {\n      throw new Error(\n        'RequestManager has no handlers registered — cannot complete request',\n      );\n    }\n\n    let index = 0;\n    const invoke = async (req: StoreRequest): Promise<StoreResponse<T>> => {\n      const handler = chain[index];\n      if (!handler) {\n        throw new Error(\n          'Handler chain ended without producing a response (no terminal handler)',\n        );\n      }\n      index++;\n      const context: RequestContext<T> = {\n        request: req,\n        response: undefined,\n        setResponse(r) {\n          this.response = r;\n        },\n      };\n      const next: NextFn<T> = (nextRequest) => invoke(nextRequest);\n      return handler.request(context, next) as Promise<StoreResponse<T>>;\n    };\n\n    return invoke(request);\n  }\n}\n","/**\n * Terminal request handler that executes HTTP calls via the browser / Node\n * `fetch` API.\n *\n * `FetchHandler` is designed to sit at the end of the `RequestManager` chain.\n * It does not call `next` — it issues the network request and returns the\n * parsed response directly.\n *\n * Response body parsing:\n * - `204 No Content` or `Content-Length: 0` → `null`\n * - `application/json` or `application/vnd.api+json` → parsed JSON (falls\n *   back to raw text if parsing fails)\n * - Everything else → raw text string\n *\n * Error handling:\n * - Non-2xx responses throw a `FetchError` that includes `status`, `content`,\n *   and `headers` for downstream error handling.\n */\n\nimport { injectable } from 'tsyringe';\nimport type {\n  Handler,\n  NextFn,\n  RequestContext,\n  StoreResponse,\n} from './types.js';\n\n/**\n * Error thrown by `FetchHandler` for non-2xx HTTP responses.\n * Carries the status code, parsed body content, and response headers.\n */\nexport class FetchError extends Error {\n  readonly status: number;\n  readonly content: unknown;\n  readonly headers: Record<string, string>;\n  constructor(\n    status: number,\n    content: unknown,\n    headers: Record<string, string>,\n    message?: string,\n  ) {\n    super(message ?? `Request failed with status ${status}`);\n    this.status = status;\n    this.content = content;\n    this.headers = headers;\n  }\n}\n\n@injectable()\nexport class FetchHandler implements Handler {\n  static headersToObject(headers: Headers): Record<string, string> {\n    const out: Record<string, string> = {};\n    headers.forEach((value, key) => {\n      out[key] = value;\n    });\n    return out;\n  }\n\n  static async parseBody(response: Response): Promise<unknown> {\n    const contentType = response.headers.get('Content-Type') ?? '';\n    if (\n      response.status === 204\n      || response.headers.get('Content-Length') === '0'\n    ) {\n      return null;\n    }\n    const isJson = contentType.includes('application/json')\n      || contentType.includes('application/vnd.api+json');\n    if (isJson) {\n      const text = await response.text();\n      if (!text) {\n        return null;\n      }\n      try {\n        return JSON.parse(text);\n      } catch {\n        return text;\n      }\n    }\n    return response.text();\n  }\n\n  /**\n   * Issues the HTTP request and returns a `StoreResponse`.\n   * This is a terminal handler — it never calls `next`.\n   *\n   * @throws `FetchError` on non-2xx responses.\n   */\n  async request<T = unknown>(\n    context: RequestContext<T>,\n    _next: NextFn<T>,\n  ): Promise<StoreResponse<T>> {\n    const req = context.request;\n    const init: RequestInit = {\n      method: req.method,\n      headers: req.headers,\n    };\n    if (req.body !== undefined && req.body !== null) {\n      init.body = req.body;\n    }\n    if (req.signal) {\n      init.signal = req.signal;\n    }\n\n    const response = await fetch(req.url, init);\n    const content = await FetchHandler.parseBody(response);\n    const headers = FetchHandler.headersToObject(response.headers);\n\n    if (!response.ok) {\n      throw new FetchError(response.status, content, headers);\n    }\n    return {\n      content: content as T,\n      status: response.status,\n      headers,\n      request: req,\n    };\n  }\n}\n","/**\n * In-memory caching handler for the request pipeline.\n *\n * `CacheHandler` is registered via `RequestManager.useCache()` so it always\n * runs first in the chain.  It caches `GET` responses and replays them on\n * subsequent requests with the same key — unless `cacheOptions.reload: true`\n * is set, in which case it bypasses the cache and stores the fresh response.\n *\n * Cache key: `cacheOptions.key` when provided, otherwise `\"<METHOD> <URL>\"`.\n *\n * Only `GET` requests are cached; mutations (POST, PUT, PATCH, DELETE) are\n * always forwarded to `next` without touching the cache.\n *\n * Usage:\n * ```ts\n * const manager = new RequestManager()\n *   .useCache(new CacheHandler())\n *   .use(new FetchHandler());\n * ```\n */\n\nimport { injectable } from 'tsyringe';\nimport type {\n  Handler,\n  NextFn,\n  RequestContext,\n  StoreRequest,\n  StoreResponse,\n} from './types.js';\n\ninterface CacheEntry {\n  response: StoreResponse;\n  cachedAt: number;\n}\n\n@injectable()\nexport class CacheHandler implements Handler {\n  private cache = new Map<string, CacheEntry>();\n\n  maxSize: number = 256;\n\n  ttl: number = 300_000;\n\n  private isExpired(entry: CacheEntry): boolean {\n    return Date.now() - entry.cachedAt > this.ttl;\n  }\n\n  private evictLRU(): void {\n    while (this.cache.size > this.maxSize) {\n      const firstKey = this.cache.keys().next().value;\n      if (firstKey !== undefined) {\n        this.cache.delete(firstKey);\n      } else {\n        break;\n      }\n    }\n  }\n\n  static keyFor(req: StoreRequest): string {\n    return req.cacheOptions?.key ?? `${req.method} ${req.url}`;\n  }\n\n  static isCacheable(req: StoreRequest): boolean {\n    return req.method === 'GET';\n  }\n\n  /**\n   * Handles a request by checking the in-memory cache before forwarding to\n   * the next handler.\n   *\n   * - Non-GET requests skip the cache entirely.\n   * - `cacheOptions.reload: true` forces a network request and refreshes the entry.\n   * - Cached entries expire after `ttl` milliseconds (default 5 minutes).\n   * - The cache uses LRU eviction when it exceeds `maxSize` entries (default 256).\n   */\n  async request<T = unknown>(\n    context: RequestContext<T>,\n    next: NextFn<T>,\n  ): Promise<StoreResponse<T>> {\n    const req = context.request;\n    if (!CacheHandler.isCacheable(req)) {\n      return next(req);\n    }\n\n    const key = CacheHandler.keyFor(req);\n    const reload = req.cacheOptions?.reload === true;\n\n    if (!reload) {\n      const hit = this.cache.get(key);\n      if (hit) {\n        if (this.isExpired(hit)) {\n          this.cache.delete(key);\n        } else {\n          // LRU promotion: delete and re-set to move to end\n          this.cache.delete(key);\n          this.cache.set(key, hit);\n          return hit.response as StoreResponse<T>;\n        }\n      }\n    }\n\n    const response = await next(req);\n    this.cache.set(key, { response: response as StoreResponse, cachedAt: Date.now() });\n    this.evictLRU();\n    return response;\n  }\n\n  /** Returns the number of entries currently in the cache. */\n  get size(): number {\n    return this.cache.size;\n  }\n\n  /** Removes all entries from the cache. */\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Removes a single entry by key.\n   * @returns `true` when the entry existed and was deleted.\n   */\n  delete(key: string): boolean {\n    return this.cache.delete(key);\n  }\n}\n"],"names":["RequestManager","handlers","handler","request","chain","index","invoke","req","context","r","next","nextRequest","__decorateClass","injectable","FetchError","status","content","headers","message","FetchHandler","out","value","key","response","contentType","text","_next","init","CacheHandler","entry","firstKey","_a","hit"],"mappings":"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"}

package/dist/CacheHandler-CXgY9IJo.cjs

@@ -0,0 +1,2 @@
+"use strict";const l=require("tsyringe");var u=Object.getOwnPropertyDescriptor,d=(c,e,r,s)=>{for(var t=s>1?void 0:s?u(e,r):e,a=c.length-1,n;a>=0;a--)(n=c[a])&&(t=n(t)||t);return t};exports.RequestManager=class{constructor(){this._handlers=[],this._cache=null}use(e){return Array.isArray(e)?this._handlers.push(...e):this._handlers.push(e),this}useCache(e){return this._cache=e,this}get handlers(){return this._handlers}get cacheHandler(){return this._cache}async request(e){const r=this._cache?[this._cache,...this._handlers]:[...this._handlers];if(r.length===0)throw new Error("RequestManager has no handlers registered — cannot complete request");let s=0;const t=async a=>{const n=r[s];if(!n)throw new Error("Handler chain ended without producing a response (no terminal handler)");s++;const h={request:a,response:void 0,setResponse(o){this.response=o}},i=o=>t(o);return n.request(h,i)};return t(e)}};exports.RequestManager=d([l.injectable()],exports.RequestManager);var p=Object.getOwnPropertyDescriptor,y=(c,e,r,s)=>{for(var t=s>1?void 0:s?p(e,r):e,a=c.length-1,n;a>=0;a--)(n=c[a])&&(t=n(t)||t);return t};class g extends Error{constructor(e,r,s,t){super(t??`Request failed with status ${e}`),this.status=e,this.content=r,this.headers=s}}exports.FetchHandler=class{static headersToObject(e){const r={};return e.forEach((s,t)=>{r[t]=s}),r}static async parseBody(e){const r=e.headers.get("Content-Type")??"";if(e.status===204||e.headers.get("Content-Length")==="0")return null;if(r.includes("application/json")||r.includes("application/vnd.api+json")){const t=await e.text();if(!t)return null;try{return JSON.parse(t)}catch{return t}}return e.text()}async request(e,r){const s=e.request,t={method:s.method,headers:s.headers};s.body!==void 0&&s.body!==null&&(t.body=s.body),s.signal&&(t.signal=s.signal);const a=await fetch(s.url,t),n=await exports.FetchHandler.parseBody(a),h=exports.FetchHandler.headersToObject(a.headers);if(!a.ok)throw new g(a.status,n,h);return{content:n,status:a.status,headers:h,request:s}}};exports.FetchHandler=y([l.injectable()],exports.FetchHandler);var f=Object.getOwnPropertyDescriptor,_=(c,e,r,s)=>{for(var t=s>1?void 0:s?f(e,r):e,a=c.length-1,n;a>=0;a--)(n=c[a])&&(t=n(t)||t);return t};exports.CacheHandler=class{constructor(){this.cache=new Map,this.maxSize=256,this.ttl=3e5}isExpired(e){return Date.now()-e.cachedAt>this.ttl}evictLRU(){for(;this.cache.size>this.maxSize;){const e=this.cache.keys().next().value;if(e!==void 0)this.cache.delete(e);else break}}static keyFor(e){var r;return((r=e.cacheOptions)==null?void 0:r.key)??`${e.method} ${e.url}`}static isCacheable(e){return e.method==="GET"}async request(e,r){var h;const s=e.request;if(!exports.CacheHandler.isCacheable(s))return r(s);const t=exports.CacheHandler.keyFor(s);if(!(((h=s.cacheOptions)==null?void 0:h.reload)===!0)){const i=this.cache.get(t);if(i)if(this.isExpired(i))this.cache.delete(t);else return this.cache.delete(t),this.cache.set(t,i),i.response}const n=await r(s);return this.cache.set(t,{response:n,cachedAt:Date.now()}),this.evictLRU(),n}get size(){return this.cache.size}clear(){this.cache.clear()}delete(e){return this.cache.delete(e)}};exports.CacheHandler=_([l.injectable()],exports.CacheHandler);
+//# sourceMappingURL=CacheHandler-CXgY9IJo.cjs.map

package/dist/CacheHandler-CXgY9IJo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheHandler-CXgY9IJo.cjs","sources":["../src/request/RequestManager.ts","../src/request/FetchHandler.ts","../src/request/CacheHandler.ts"],"sourcesContent":["/**\n * Middleware-style manager that runs a `StoreRequest` through an ordered chain\n * of `Handler` instances.\n *\n * Handlers are invoked in registration order.  Each handler receives a\n * `RequestContext` and a `next` function; it may:\n * - Call `next(request)` to pass control to the next handler.\n * - Return a `StoreResponse` directly to short-circuit the chain.\n * - Wrap `next` to inspect or transform the response (e.g. logging).\n *\n * An optional *cache handler* registered via `useCache()` is always prepended\n * to the chain so it runs before every other handler.\n *\n * Usage:\n * ```ts\n * const manager = new RequestManager()\n *   .useCache(new CacheHandler())\n *   .use([new AuthHandler(), new FetchHandler()]);\n *\n * const response = await manager.request({ method: 'GET', url: '/posts' });\n * ```\n */\n\nimport { injectable } from 'tsyringe';\nimport type {\n  Handler,\n  NextFn,\n  RequestContext,\n  StoreRequest,\n  StoreResponse,\n} from './types.js';\n\n@injectable()\nexport class RequestManager {\n  private _handlers: Handler[] = [];\n  private _cache: Handler | null = null;\n\n  /**\n   * Appends one or more handlers to the pipeline.\n   * Returns `this` for chaining.\n   */\n  use(handlers: Handler[] | Handler): this {\n    if (Array.isArray(handlers)) {\n      this._handlers.push(...handlers);\n    } else {\n      this._handlers.push(handlers);\n    }\n    return this;\n  }\n\n  /**\n   * Registers the cache handler.  It is always inserted at the front of\n   * the chain so it can intercept requests before any other handler sees them.\n   * Returns `this` for chaining.\n   */\n  useCache(handler: Handler): this {\n    this._cache = handler;\n    return this;\n  }\n\n  /** All non-cache handlers in registration order. */\n  get handlers(): readonly Handler[] {\n    return this._handlers;\n  }\n\n  /** The registered cache handler, or `null`. */\n  get cacheHandler(): Handler | null {\n    return this._cache;\n  }\n\n  /**\n   * Executes `request` through the full handler chain and returns the final\n   * `StoreResponse`.\n   *\n   * @throws when no handlers have been registered.\n   * @throws when the chain ends without any handler returning a response\n   *         (i.e. no terminal handler such as `FetchHandler`).\n   */\n  async request<T = unknown>(request: StoreRequest): Promise<StoreResponse<T>> {\n    const chain: Handler[] = this._cache\n      ? [this._cache, ...this._handlers]\n      : [...this._handlers];\n\n    if (chain.length === 0) {\n      throw new Error(\n        'RequestManager has no handlers registered — cannot complete request',\n      );\n    }\n\n    let index = 0;\n    const invoke = async (req: StoreRequest): Promise<StoreResponse<T>> => {\n      const handler = chain[index];\n      if (!handler) {\n        throw new Error(\n          'Handler chain ended without producing a response (no terminal handler)',\n        );\n      }\n      index++;\n      const context: RequestContext<T> = {\n        request: req,\n        response: undefined,\n        setResponse(r) {\n          this.response = r;\n        },\n      };\n      const next: NextFn<T> = (nextRequest) => invoke(nextRequest);\n      return handler.request(context, next) as Promise<StoreResponse<T>>;\n    };\n\n    return invoke(request);\n  }\n}\n","/**\n * Terminal request handler that executes HTTP calls via the browser / Node\n * `fetch` API.\n *\n * `FetchHandler` is designed to sit at the end of the `RequestManager` chain.\n * It does not call `next` — it issues the network request and returns the\n * parsed response directly.\n *\n * Response body parsing:\n * - `204 No Content` or `Content-Length: 0` → `null`\n * - `application/json` or `application/vnd.api+json` → parsed JSON (falls\n *   back to raw text if parsing fails)\n * - Everything else → raw text string\n *\n * Error handling:\n * - Non-2xx responses throw a `FetchError` that includes `status`, `content`,\n *   and `headers` for downstream error handling.\n */\n\nimport { injectable } from 'tsyringe';\nimport type {\n  Handler,\n  NextFn,\n  RequestContext,\n  StoreResponse,\n} from './types.js';\n\n/**\n * Error thrown by `FetchHandler` for non-2xx HTTP responses.\n * Carries the status code, parsed body content, and response headers.\n */\nexport class FetchError extends Error {\n  readonly status: number;\n  readonly content: unknown;\n  readonly headers: Record<string, string>;\n  constructor(\n    status: number,\n    content: unknown,\n    headers: Record<string, string>,\n    message?: string,\n  ) {\n    super(message ?? `Request failed with status ${status}`);\n    this.status = status;\n    this.content = content;\n    this.headers = headers;\n  }\n}\n\n@injectable()\nexport class FetchHandler implements Handler {\n  static headersToObject(headers: Headers): Record<string, string> {\n    const out: Record<string, string> = {};\n    headers.forEach((value, key) => {\n      out[key] = value;\n    });\n    return out;\n  }\n\n  static async parseBody(response: Response): Promise<unknown> {\n    const contentType = response.headers.get('Content-Type') ?? '';\n    if (\n      response.status === 204\n      || response.headers.get('Content-Length') === '0'\n    ) {\n      return null;\n    }\n    const isJson = contentType.includes('application/json')\n      || contentType.includes('application/vnd.api+json');\n    if (isJson) {\n      const text = await response.text();\n      if (!text) {\n        return null;\n      }\n      try {\n        return JSON.parse(text);\n      } catch {\n        return text;\n      }\n    }\n    return response.text();\n  }\n\n  /**\n   * Issues the HTTP request and returns a `StoreResponse`.\n   * This is a terminal handler — it never calls `next`.\n   *\n   * @throws `FetchError` on non-2xx responses.\n   */\n  async request<T = unknown>(\n    context: RequestContext<T>,\n    _next: NextFn<T>,\n  ): Promise<StoreResponse<T>> {\n    const req = context.request;\n    const init: RequestInit = {\n      method: req.method,\n      headers: req.headers,\n    };\n    if (req.body !== undefined && req.body !== null) {\n      init.body = req.body;\n    }\n    if (req.signal) {\n      init.signal = req.signal;\n    }\n\n    const response = await fetch(req.url, init);\n    const content = await FetchHandler.parseBody(response);\n    const headers = FetchHandler.headersToObject(response.headers);\n\n    if (!response.ok) {\n      throw new FetchError(response.status, content, headers);\n    }\n    return {\n      content: content as T,\n      status: response.status,\n      headers,\n      request: req,\n    };\n  }\n}\n","/**\n * In-memory caching handler for the request pipeline.\n *\n * `CacheHandler` is registered via `RequestManager.useCache()` so it always\n * runs first in the chain.  It caches `GET` responses and replays them on\n * subsequent requests with the same key — unless `cacheOptions.reload: true`\n * is set, in which case it bypasses the cache and stores the fresh response.\n *\n * Cache key: `cacheOptions.key` when provided, otherwise `\"<METHOD> <URL>\"`.\n *\n * Only `GET` requests are cached; mutations (POST, PUT, PATCH, DELETE) are\n * always forwarded to `next` without touching the cache.\n *\n * Usage:\n * ```ts\n * const manager = new RequestManager()\n *   .useCache(new CacheHandler())\n *   .use(new FetchHandler());\n * ```\n */\n\nimport { injectable } from 'tsyringe';\nimport type {\n  Handler,\n  NextFn,\n  RequestContext,\n  StoreRequest,\n  StoreResponse,\n} from './types.js';\n\ninterface CacheEntry {\n  response: StoreResponse;\n  cachedAt: number;\n}\n\n@injectable()\nexport class CacheHandler implements Handler {\n  private cache = new Map<string, CacheEntry>();\n\n  maxSize: number = 256;\n\n  ttl: number = 300_000;\n\n  private isExpired(entry: CacheEntry): boolean {\n    return Date.now() - entry.cachedAt > this.ttl;\n  }\n\n  private evictLRU(): void {\n    while (this.cache.size > this.maxSize) {\n      const firstKey = this.cache.keys().next().value;\n      if (firstKey !== undefined) {\n        this.cache.delete(firstKey);\n      } else {\n        break;\n      }\n    }\n  }\n\n  static keyFor(req: StoreRequest): string {\n    return req.cacheOptions?.key ?? `${req.method} ${req.url}`;\n  }\n\n  static isCacheable(req: StoreRequest): boolean {\n    return req.method === 'GET';\n  }\n\n  /**\n   * Handles a request by checking the in-memory cache before forwarding to\n   * the next handler.\n   *\n   * - Non-GET requests skip the cache entirely.\n   * - `cacheOptions.reload: true` forces a network request and refreshes the entry.\n   * - Cached entries expire after `ttl` milliseconds (default 5 minutes).\n   * - The cache uses LRU eviction when it exceeds `maxSize` entries (default 256).\n   */\n  async request<T = unknown>(\n    context: RequestContext<T>,\n    next: NextFn<T>,\n  ): Promise<StoreResponse<T>> {\n    const req = context.request;\n    if (!CacheHandler.isCacheable(req)) {\n      return next(req);\n    }\n\n    const key = CacheHandler.keyFor(req);\n    const reload = req.cacheOptions?.reload === true;\n\n    if (!reload) {\n      const hit = this.cache.get(key);\n      if (hit) {\n        if (this.isExpired(hit)) {\n          this.cache.delete(key);\n        } else {\n          // LRU promotion: delete and re-set to move to end\n          this.cache.delete(key);\n          this.cache.set(key, hit);\n          return hit.response as StoreResponse<T>;\n        }\n      }\n    }\n\n    const response = await next(req);\n    this.cache.set(key, { response: response as StoreResponse, cachedAt: Date.now() });\n    this.evictLRU();\n    return response;\n  }\n\n  /** Returns the number of entries currently in the cache. */\n  get size(): number {\n    return this.cache.size;\n  }\n\n  /** Removes all entries from the cache. */\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Removes a single entry by key.\n   * @returns `true` when the entry existed and was deleted.\n   */\n  delete(key: string): boolean {\n    return this.cache.delete(key);\n  }\n}\n"],"names":["RequestManager","handlers","handler","request","chain","index","invoke","req","context","r","next","nextRequest","__decorateClass","injectable","FetchError","status","content","headers","message","FetchHandler","out","value","key","response","contentType","text","_next","init","CacheHandler","entry","firstKey","_a","hit"],"mappings":"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"}

package/dist/EmbeddedRecordsMixin-CBvqNdgC.cjs

@@ -0,0 +1,2 @@
+"use strict";const A=require("tsyringe"),R=require("pluralize"),g=require("./Serializer-95gi5edy.cjs");var _=Object.getOwnPropertyDescriptor,v=(u,t,s,r)=>{for(var n=r>1?void 0:r?_(t,s):t,e=u.length-1,i;e>=0;e--)(i=u[e])&&(n=i(n)||n);return n};exports.JsonSerializer=class extends g.Serializer{static dispatchMethodName(t){switch(t){case"findRecord":return"normalizeFindRecordResponse";case"findAll":return"normalizeFindAllResponse";case"query":return"normalizeQueryResponse";case"queryRecord":return"normalizeQueryRecordResponse";case"createRecord":return"normalizeCreateRecordResponse";case"updateRecord":return"normalizeUpdateRecordResponse";case"deleteRecord":return"normalizeDeleteRecordResponse";default:return null}}normalize(t,s,r,n){if(r==null||typeof r!="object")return null;const e=r,i=this.extractId(s,e),o=this.extractAttributes(s,e),a=this.extractRelationships(s,e),d={type:s.modelName,id:i,attributes:o};return a&&Object.keys(a).length>0&&(d.relationships=a),d}normalizeResponse(t,s,r,n,e){const i=exports.JsonSerializer.dispatchMethodName(e);if(i){const o=this[i],a=g.Serializer.prototype[i];if(typeof o=="function"&&o!==a)return o.call(this,t,s,r,n,e)}return this._buildDocument(t,s,r,n,e)}_buildDocument(t,s,r,n,e){return r==null?{data:null}:Array.isArray(r)?{data:r.map(a=>this.normalize(t,s,a)).filter(a=>a!==null)}:{data:this.normalize(t,s,r)}}serialize(t,s){const r={};return s!=null&&s.includeId&&t.id!==null&&(r[this.primaryKey]=t.id),t.eachAttribute((n,e)=>{this.serializeAttribute(t,r,n,e)}),t.eachRelationship((n,e)=>{e.kind==="belongsTo"?this.serializeBelongsTo(t,r,e):this.serializeHasMany(t,r,e)}),r}};exports.JsonSerializer=v([A.injectable()],exports.JsonSerializer);var M=Object.getOwnPropertyDescriptor,w=(u,t,s,r)=>{for(var n=r>1?void 0:r?M(t,s):t,e=u.length-1,i;e>=0;e--)(i=u[e])&&(n=i(n)||n);return n};exports.RestSerializer=class extends exports.JsonSerializer{payloadKeyFromModelName(t){return R.plural(t)}modelNameFromPayloadKey(t){return R.singular(t)}_buildDocument(t,s,r,n,e){if(r==null||typeof r!="object")return{data:null};const i=r,o=s.modelName,a=this.payloadKeyFromModelName(o);let d=null;const f=new Set;if(o in i){f.add(o);const c=i[o];Array.isArray(c)?d=c.map(l=>this.normalize(t,s,l)).filter(l=>l!==null):d=this.normalize(t,s,c)}else if(a in i){f.add(a);const c=i[a];Array.isArray(c)?d=c.map(l=>this.normalize(t,s,l)).filter(l=>l!==null):d=this.normalize(t,s,c)}const m=[];for(const[c,l]of Object.entries(i)){if(f.has(c)||c==="meta"||c==="links")continue;const z={modelName:this.modelNameFromPayloadKey(c),attributes:new Map,relationships:new Map};if(Array.isArray(l))for(const p of l){const b=this.normalize(t,z,p);b&&m.push(b)}else if(l&&typeof l=="object"){const p=this.normalize(t,z,l);p&&m.push(p)}}const h={data:d};return m.length>0&&(h.included=m),i.meta&&typeof i.meta=="object"&&(h.meta=i.meta),i.links&&typeof i.links=="object"&&(h.links=i.links),h}};exports.RestSerializer=w([A.injectable()],exports.RestSerializer);function S(u){class t extends u{constructor(){super(...arguments),this.pendingIncluded=[]}normalize(r,n,e,i){if(!e||typeof e!="object"||Array.isArray(e))return super.normalize(r,n,e,i);const o=e,a=this.attrs??{},d={...o};for(const[f,m]of n.relationships){const h=a[f];if(!h||h.embedded!=="always")continue;const c=d[f];if(c!=null){if(m.kind==="hasMany"&&Array.isArray(c)){const l=[];for(const y of c){const z=this.extractEmbeddedResource(r,m,y);z&&z.id!==null&&(l.push(z.id),this.pendingIncluded.push(z))}d[f]=l}else if(m.kind==="belongsTo"&&typeof c=="object"&&!Array.isArray(c)){const l=this.extractEmbeddedResource(r,m,c);l&&l.id!==null&&(this.pendingIncluded.push(l),d[f]=l.id)}}}return super.normalize(r,n,d,i)}normalizeResponse(r,n,e,i,o){this.pendingIncluded=[];const a=super.normalizeResponse(r,n,e,i,o);if(this.pendingIncluded.length>0){const d=a.included?[...a.included]:[];d.push(...this.pendingIncluded),a.included=d,this.pendingIncluded=[]}return a}serializeHasMany(r,n,e){var o;const i=(o=this.attrs)==null?void 0:o[e.name];if((i==null?void 0:i.serialize)==="records"){const a=r.hasMany(e.name);n[this.keyForRelationship(e.name)]=a??[];return}super.serializeHasMany(r,n,e)}serializeBelongsTo(r,n,e){var o;const i=(o=this.attrs)==null?void 0:o[e.name];if((i==null?void 0:i.serialize)==="records"){const a=r.belongsTo(e.name);n[this.keyForRelationship(e.name)]=a??null;return}super.serializeBelongsTo(r,n,e)}extractEmbeddedResource(r,n,e){if(!e||typeof e!="object"||Array.isArray(e))return null;const i={modelName:n.type,attributes:new Map,relationships:new Map};return this.normalize(r,i,e)}}return t}exports.EmbeddedRecordsMixin=S;
+//# sourceMappingURL=EmbeddedRecordsMixin-CBvqNdgC.cjs.map