@iamjulianacosta/mobx-data 1.0.1

package/dist/transforms/date.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Transform that converts between ISO 8601 strings (or numeric timestamps)
+ * and JavaScript `Date` objects.
+ *
+ * Deserialization:
+ * - `null` / `undefined` / `''` → `null`
+ * - `Date` instance → returned as-is (or `null` when invalid)
+ * - `number` (Unix ms) or `string` (ISO 8601) → parsed via `new Date(value)`,
+ *   returns `null` when parsing yields `NaN`
+ * - anything else → `null`
+ *
+ * Serialization:
+ * - `null` / `undefined` → `null`
+ * - `Date` instance → ISO 8601 string via `.toISOString()` (or `null` when invalid)
+ * - anything else → `null`
+ */
+import { BaseTransform } from './Transform.js';
+export declare class DateTransform extends BaseTransform<unknown, Date | null> {
+    deserialize(serialized: unknown): Date | null;
+    serialize(deserialized: Date | null): unknown;
+}
+//# sourceMappingURL=date.d.ts.map

package/dist/transforms/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/transforms/date.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBACa,aAAc,SAAQ,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACpE,WAAW,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAc7C,SAAS,CAAC,YAAY,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO;CAW9C"}

package/dist/transforms/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../date-CRCe-9gf.cjs");exports.BaseTransform=e.BaseTransform;Object.defineProperty(exports,"BooleanTransform",{enumerable:!0,get:()=>e.BooleanTransform});Object.defineProperty(exports,"DateTransform",{enumerable:!0,get:()=>e.DateTransform});Object.defineProperty(exports,"NumberTransform",{enumerable:!0,get:()=>e.NumberTransform});Object.defineProperty(exports,"StringTransform",{enumerable:!0,get:()=>e.StringTransform});
+//# sourceMappingURL=index.cjs.map

package/dist/transforms/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/transforms/index.d.ts

@@ -0,0 +1,6 @@
+export { BaseTransform, type Transform } from './Transform.js';
+export { StringTransform } from './string.js';
+export { NumberTransform } from './number.js';
+export { BooleanTransform } from './boolean.js';
+export { DateTransform } from './date.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transforms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/transforms/index.js

@@ -0,0 +1,9 @@
+import { B as s, a as o, D as m, N as n, S as f } from "../date-Bj4O2W1F.js";
+export {
+  s as BaseTransform,
+  o as BooleanTransform,
+  m as DateTransform,
+  n as NumberTransform,
+  f as StringTransform
+};
+//# sourceMappingURL=index.js.map

package/dist/transforms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/transforms/number.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Transform that converts between arbitrary wire values and numbers.
+ *
+ * Deserialization / serialization coercions (identical in both directions):
+ * - `null` / `undefined` / `''` → `null`
+ * - finite `number` → passed through
+ * - non-finite `number` (NaN, Infinity) → `null`
+ * - `string` → trimmed and parsed; `null` when the result is not finite
+ * - anything else → `null`
+ */
+import { BaseTransform } from './Transform.js';
+export declare class NumberTransform extends BaseTransform<unknown, number | null> {
+    static coerce(value: unknown): number | null;
+    deserialize(serialized: unknown): number | null;
+    serialize(deserialized: number | null): unknown;
+}
+//# sourceMappingURL=number.d.ts.map

package/dist/transforms/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/transforms/number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBACa,eAAgB,SAAQ,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAkB5C,WAAW,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAI/C,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;CAGhD"}

package/dist/transforms/string.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Transform that converts between arbitrary wire values and strings.
+ *
+ * Deserialization:
+ * - `null` / `undefined` → `null`
+ * - `string` → passed through
+ * - anything else → `String(value)`
+ *
+ * Serialization:
+ * - `null` / `undefined` → `null`
+ * - anything else → `String(value)`
+ */
+import { BaseTransform } from './Transform.js';
+export declare class StringTransform extends BaseTransform<unknown, string | null> {
+    deserialize(serialized: unknown): string | null;
+    serialize(deserialized: string | null): unknown;
+}
+//# sourceMappingURL=string.d.ts.map

package/dist/transforms/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/transforms/string.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBACa,eAAgB,SAAQ,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxE,WAAW,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAU/C,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;CAMhD"}

package/dist/types-C9NB2gRj.js

@@ -0,0 +1,7 @@
+const a = Symbol("mobx-data:attributes"), o = Symbol("mobx-data:relationships"), t = Symbol("mobx-data:modelName");
+export {
+  a as A,
+  t as M,
+  o as R
+};
+//# sourceMappingURL=types-C9NB2gRj.js.map

package/dist/types-C9NB2gRj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-C9NB2gRj.js","sources":["../src/schema/types.ts"],"sourcesContent":["/** Shape of a single `@attr` decoration on a model class property. */\nexport interface AttributeDef {\n  /** Property name on the model class. */\n  name: string;\n  /** Registered transform type (e.g. `'string'`, `'number'`), or `null` for pass-through. */\n  type: string | null;\n  /** Extra options passed by the decorator (default value, etc.). */\n  options: AttributeOptions;\n  /** Discriminant – always `true`; used to narrow union types. */\n  isAttribute: true;\n}\n\n/** Options accepted by the `@attr` decorator. */\nexport interface AttributeOptions {\n  /** Static value or factory function called when the attribute has no server value. */\n  defaultValue?: unknown | (() => unknown);\n  /** Arbitrary custom options forwarded to the transform. */\n  [key: string]: unknown;\n}\n\n/** Identifies the direction of a relationship from the owning model's perspective. */\nexport type RelationshipKind = 'belongsTo' | 'hasMany';\n\n/** Shape of a single `@belongsTo` / `@hasMany` decoration on a model class property. */\nexport interface RelationshipDef {\n  /** Property name on the model class. */\n  name: string;\n  /** Direction from the owning model's perspective. */\n  kind: RelationshipKind;\n  /** `modelName` of the related model. */\n  type: string;\n  /** Normalised options (async, inverse, polymorphic, …). */\n  options: RelationshipOptions;\n  /** Discriminant – always `true`; used to narrow union types. */\n  isRelationship: true;\n}\n\n/** Options accepted by `@belongsTo` and `@hasMany` decorators. */\nexport interface RelationshipOptions {\n  /**\n   * When `true` the relationship proxy returns an `AsyncBelongsTo` / `AsyncHasMany`\n   * that must be awaited before the related record(s) are available.\n   */\n  async?: boolean;\n  /**\n   * Name of the inverse property on the related model.\n   * Set to `null` to explicitly opt out of inverse tracking.\n   */\n  inverse?: string | null;\n  /** When `true` the relationship can point to records of multiple model types. */\n  polymorphic?: boolean;\n  /** Arbitrary custom options. */\n  [key: string]: unknown;\n}\n\n/** Attribute definitions keyed by property name. */\nexport type AttributeDefinitionsMap = Map<string, AttributeDef>;\n/** Relationship definitions keyed by property name. */\nexport type RelationshipDefinitionsMap = Map<string, RelationshipDef>;\n\n/** Reflect-metadata key used to store attribute definitions on a prototype. */\nexport const ATTRIBUTES_META_KEY = Symbol('mobx-data:attributes');\n/** Reflect-metadata key used to store relationship definitions on a prototype. */\nexport const RELATIONSHIPS_META_KEY = Symbol('mobx-data:relationships');\n/** Reflect-metadata key used to store the registered model name on a class. */\nexport const MODEL_NAME_META_KEY = Symbol('mobx-data:modelName');\n"],"names":["ATTRIBUTES_META_KEY","RELATIONSHIPS_META_KEY","MODEL_NAME_META_KEY"],"mappings":"AA6DO,MAAMA,IAAsB,OAAO,sBAAsB,GAEnDC,IAAyB,OAAO,yBAAyB,GAEzDC,IAAsB,OAAO,qBAAqB;"}

package/dist/types-uWOXMPWW.cjs

@@ -0,0 +1,2 @@
+"use strict";const E=Symbol("mobx-data:attributes"),T=Symbol("mobx-data:relationships"),_=Symbol("mobx-data:modelName");exports.ATTRIBUTES_META_KEY=E;exports.MODEL_NAME_META_KEY=_;exports.RELATIONSHIPS_META_KEY=T;
+//# sourceMappingURL=types-uWOXMPWW.cjs.map

package/dist/types-uWOXMPWW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-uWOXMPWW.cjs","sources":["../src/schema/types.ts"],"sourcesContent":["/** Shape of a single `@attr` decoration on a model class property. */\nexport interface AttributeDef {\n  /** Property name on the model class. */\n  name: string;\n  /** Registered transform type (e.g. `'string'`, `'number'`), or `null` for pass-through. */\n  type: string | null;\n  /** Extra options passed by the decorator (default value, etc.). */\n  options: AttributeOptions;\n  /** Discriminant – always `true`; used to narrow union types. */\n  isAttribute: true;\n}\n\n/** Options accepted by the `@attr` decorator. */\nexport interface AttributeOptions {\n  /** Static value or factory function called when the attribute has no server value. */\n  defaultValue?: unknown | (() => unknown);\n  /** Arbitrary custom options forwarded to the transform. */\n  [key: string]: unknown;\n}\n\n/** Identifies the direction of a relationship from the owning model's perspective. */\nexport type RelationshipKind = 'belongsTo' | 'hasMany';\n\n/** Shape of a single `@belongsTo` / `@hasMany` decoration on a model class property. */\nexport interface RelationshipDef {\n  /** Property name on the model class. */\n  name: string;\n  /** Direction from the owning model's perspective. */\n  kind: RelationshipKind;\n  /** `modelName` of the related model. */\n  type: string;\n  /** Normalised options (async, inverse, polymorphic, …). */\n  options: RelationshipOptions;\n  /** Discriminant – always `true`; used to narrow union types. */\n  isRelationship: true;\n}\n\n/** Options accepted by `@belongsTo` and `@hasMany` decorators. */\nexport interface RelationshipOptions {\n  /**\n   * When `true` the relationship proxy returns an `AsyncBelongsTo` / `AsyncHasMany`\n   * that must be awaited before the related record(s) are available.\n   */\n  async?: boolean;\n  /**\n   * Name of the inverse property on the related model.\n   * Set to `null` to explicitly opt out of inverse tracking.\n   */\n  inverse?: string | null;\n  /** When `true` the relationship can point to records of multiple model types. */\n  polymorphic?: boolean;\n  /** Arbitrary custom options. */\n  [key: string]: unknown;\n}\n\n/** Attribute definitions keyed by property name. */\nexport type AttributeDefinitionsMap = Map<string, AttributeDef>;\n/** Relationship definitions keyed by property name. */\nexport type RelationshipDefinitionsMap = Map<string, RelationshipDef>;\n\n/** Reflect-metadata key used to store attribute definitions on a prototype. */\nexport const ATTRIBUTES_META_KEY = Symbol('mobx-data:attributes');\n/** Reflect-metadata key used to store relationship definitions on a prototype. */\nexport const RELATIONSHIPS_META_KEY = Symbol('mobx-data:relationships');\n/** Reflect-metadata key used to store the registered model name on a class. */\nexport const MODEL_NAME_META_KEY = Symbol('mobx-data:modelName');\n"],"names":["ATTRIBUTES_META_KEY","RELATIONSHIPS_META_KEY","MODEL_NAME_META_KEY"],"mappings":"aA6DO,MAAMA,EAAsB,OAAO,sBAAsB,EAEnDC,EAAyB,OAAO,yBAAyB,EAEzDC,EAAsB,OAAO,qBAAqB"}

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "@iamjulianacosta/mobx-data",
+  "version": "1.0.1",
+  "description": "Ember Data feature-complete clone for MobX",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./adapter": {
+      "types": "./dist/adapter/index.d.ts",
+      "import": "./dist/adapter/index.js",
+      "require": "./dist/adapter/index.cjs"
+    },
+    "./model": {
+      "types": "./dist/model/index.d.ts",
+      "import": "./dist/model/index.js",
+      "require": "./dist/model/index.cjs"
+    },
+    "./store": {
+      "types": "./dist/store/index.d.ts",
+      "import": "./dist/store/index.js",
+      "require": "./dist/store/index.cjs"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js",
+      "require": "./dist/schema/index.cjs"
+    },
+    "./serializer": {
+      "types": "./dist/serializer/index.d.ts",
+      "import": "./dist/serializer/index.js",
+      "require": "./dist/serializer/index.cjs"
+    },
+    "./transforms": {
+      "types": "./dist/transforms/index.d.ts",
+      "import": "./dist/transforms/index.js",
+      "require": "./dist/transforms/index.cjs"
+    },
+    "./request": {
+      "types": "./dist/request/index.d.ts",
+      "import": "./dist/request/index.js",
+      "require": "./dist/request/index.cjs"
+    },
+    "./json-api": {
+      "types": "./dist/json-api/index.d.ts",
+      "import": "./dist/json-api/index.js",
+      "require": "./dist/json-api/index.cjs"
+    },
+    "./odata": {
+      "types": "./dist/odata/index.d.ts",
+      "import": "./dist/odata/index.js",
+      "require": "./dist/odata/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "test:e2e:coverage": "playwright test && nyc report --temp-dir=coverage/playwright --report-dir=coverage/playwright-report --reporter=text",
+    "test:all": "vitest run --coverage && playwright test",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "build": "vite build --config vite.config.build.ts && tsc -p tsconfig.build.json",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "typedoc && vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mobx",
+    "data",
+    "orm",
+    "ember-data",
+    "identity-map",
+    "adapter",
+    "serializer",
+    "json-api",
+    "odata",
+    "state-management"
+  ],
+  "author": "Julián Acosta <iam@julianacosta.me>",
+  "license": "MIT",
+  "homepage": "https://iamjulianacosta.github.io/mobx-data/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/IAmJulianAcosta/mobx-data.git"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "mobx": "^6.0.0",
+    "reflect-metadata": "^0.2.0"
+  },
+  "dependencies": {
+    "change-case": "^5.4.4",
+    "pluralize": "^8.0.0",
+    "tsyringe": "^4.8.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.60.0",
+    "@types/node": "^22.10.0",
+    "@types/pluralize": "^0.0.33",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^8.57.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-config-airbnb-typescript": "^18.0.0",
+    "eslint-import-resolver-typescript": "^3.7.0",
+    "eslint-plugin-import": "^2.31.0",
+    "mobx": "^6.13.5",
+    "nyc": "^18.0.0",
+    "reflect-metadata": "^0.2.2",
+    "simple-odata-server": "^1.2.2",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.11.0",
+    "typescript": "^5.7.2",
+    "vite": "^6.0.3",
+    "vite-plugin-dts": "^4.3.0",
+    "vite-plugin-istanbul": "^9.0.0",
+    "vitepress": "^1.6.4",
+    "vitest": "^2.1.8"
+  },
+  "packageManager": "pnpm@9.14.4"
+}

package/src/adapter/Adapter.ts

@@ -0,0 +1,320 @@
+/**
+ * Abstract base class for all adapters.
+ *
+ * An adapter translates store operations (findRecord, createRecord, …) into
+ * concrete network requests and returns raw payloads that the serializer layer
+ * then normalises.  Concrete subclasses (`RestAdapter`, `ODataAdapter`, …)
+ * override the abstract CRUD methods and may also override the URL-building
+ * helpers to produce protocol-specific URLs.
+ *
+ * URL construction follows an Ember Data–style pipeline:
+ *   `buildURL` → `urlForFindRecord` / `urlForQuery` / … → `_composeURL`
+ *
+ * Configuration surface:
+ *   - `host`      – base URL prefix (e.g. `https://api.example.com`)
+ *   - `namespace` – path segment appended after the host (e.g. `v2`)
+ *   - `headers`   – headers merged into every request
+ *   - `coalesceFindRequests` – when `true` the store batches separate
+ *     `findRecord` calls into a single `findMany` call
+ */
+
+import pluralize from 'pluralize';
+import { kebabCase } from 'change-case';
+
+/** Union of all operation names the store can issue to an adapter. */
+export type AdapterRequestType =
+  | 'findRecord'
+  | 'findAll'
+  | 'findMany'
+  | 'query'
+  | 'queryRecord'
+  | 'createRecord'
+  | 'updateRecord'
+  | 'deleteRecord';
+
+/**
+ * A frozen view of a model record passed to the adapter.
+ * Adapters read but do not mutate snapshots.
+ */
+export interface AdapterSnapshot {
+  /** The record's server-assigned id, or `null` for new records. */
+  id: string | null;
+  /** The model's registered `modelName`. */
+  modelName: string;
+  /** Returns the current value for an attribute key. */
+  attr(key: string): unknown;
+  /** Returns the `belongsTo` relationship value (or just its id when `{ id: true }`). */
+  belongsTo(key: string, options?: { id: boolean }): unknown;
+  /** Returns the `hasMany` relationship values (or just ids when `{ ids: true }`). */
+  hasMany(key: string, options?: { ids: boolean }): unknown;
+  /** Returns `{ [key]: [oldValue, newValue] }` for attributes that differ from the server state. */
+  changedAttributes(): Record<string, [unknown, unknown]>;
+  /** Reference to the live record instance. */
+  record: unknown;
+}
+
+export abstract class Adapter {
+  /** Base URL prepended to every generated URL.  Empty string = relative URLs. */
+  namespace: string = '';
+  /** Host prefix, e.g. `https://api.example.com`. */
+  host: string = '';
+  /** Extra headers merged into every request via `defaultHeaders()`. */
+  headers: Record<string, string> = {};
+  /**
+   * When `true` the store will coalesce multiple `findRecord` calls for the
+   * same model type into a single `findMany` network request.
+   */
+  coalesceFindRequests: boolean = false;
+
+  /** Fetches a single record by id. */
+  abstract findRecord(
+    store: unknown,
+    modelName: string,
+    id: string,
+    snapshot: AdapterSnapshot,
+    options?: { include?: string },
+  ): Promise<unknown>;
+
+  /** Fetches all records of a given model type. */
+  abstract findAll(
+    store: unknown,
+    modelName: string,
+    sinceToken: string | null,
+    snapshotArray: AdapterSnapshot[],
+    options?: { include?: string },
+  ): Promise<unknown>;
+
+  /** Fetches multiple records by id in a single request. */
+  abstract findMany(
+    store: unknown,
+    modelName: string,
+    ids: string[],
+    snapshots: AdapterSnapshot[],
+  ): Promise<unknown>;
+
+  /** Executes an arbitrary server-side query, returning an array of records. */
+  abstract query(
+    store: unknown,
+    modelName: string,
+    query: Record<string, unknown>,
+  ): Promise<unknown>;
+
+  /** Like `query` but returns at most one record. */
+  abstract queryRecord(
+    store: unknown,
+    modelName: string,
+    query: Record<string, unknown>,
+  ): Promise<unknown>;
+
+  /** Persists a new record to the server (POST). */
+  abstract createRecord(
+    store: unknown,
+    modelName: string,
+    snapshot: AdapterSnapshot,
+  ): Promise<unknown>;
+
+  /** Persists all attributes of an existing record (PUT). */
+  abstract updateRecord(
+    store: unknown,
+    modelName: string,
+    snapshot: AdapterSnapshot,
+  ): Promise<unknown>;
+
+  /**
+   * Persists only the changed attributes of an existing record (PATCH).
+   * Default implementation delegates to `updateRecord`.
+   * Override in subclasses to send a partial payload via HTTP PATCH.
+   */
+  patchRecord(
+    store: unknown,
+    modelName: string,
+    snapshot: AdapterSnapshot,
+  ): Promise<unknown> {
+    return this.updateRecord(store, modelName, snapshot);
+  }
+
+  /** Removes a record from the server (DELETE). */
+  abstract deleteRecord(
+    store: unknown,
+    modelName: string,
+    snapshot: AdapterSnapshot,
+  ): Promise<unknown>;
+
+  /**
+   * Returns the URL path segment for a given model name.
+   * Default: dasherized, pluralized form — e.g. `userPost` → `user-posts`.
+   */
+  pathForType(modelName: string): string {
+    return pluralize.plural(kebabCase(modelName));
+  }
+
+  /**
+   * Assembles a full URL from `host`, `namespace`, and the supplied `path`.
+   * Returns an absolute URL when `host` is set, otherwise a root-relative path.
+   */
+  protected _composeURL(path: string): string {
+    const ns = this.namespace.replace(/^\/+|\/+$/g, '');
+    const hostPrefix = this.host ? this.host.replace(/\/+$/, '') : '';
+    const parts: string[] = [];
+    if (hostPrefix) {
+      parts.push(hostPrefix);
+    }
+    if (ns) {
+      parts.push(ns);
+    }
+    parts.push(path);
+    if (hostPrefix) {
+      return parts.join('/');
+    }
+    return `/${parts.filter(Boolean).join('/')}`;
+  }
+
+  /**
+   * Dispatches to the appropriate `urlFor*` method based on `requestType`.
+   *
+   * @param modelName   - Registered model name.
+   * @param id          - Record id(s), or `null` for collection requests.
+   * @param snapshot    - Snapshot(s) for the request.
+   * @param requestType - Operation being performed.
+   * @param query       - Query parameters (used for `query` / `queryRecord`).
+   */
+  buildURL(
+    modelName: string,
+    id: string | string[] | null,
+    snapshot: AdapterSnapshot | AdapterSnapshot[] | null,
+    requestType: AdapterRequestType,
+    query: Record<string, unknown> = {},
+  ): string {
+    switch (requestType) {
+      case 'findRecord':
+        return this.urlForFindRecord(id as string, modelName, snapshot as AdapterSnapshot);
+      case 'findAll':
+        return this.urlForFindAll(modelName, (snapshot as AdapterSnapshot[]) ?? []);
+      case 'findMany':
+        return this.urlForFindMany(
+          (id as string[]) ?? [],
+          modelName,
+          (snapshot as AdapterSnapshot[]) ?? [],
+        );
+      case 'query':
+        return this.urlForQuery(query, modelName);
+      case 'queryRecord':
+        return this.urlForQueryRecord(query, modelName);
+      case 'createRecord':
+        return this.urlForCreateRecord(modelName, snapshot as AdapterSnapshot);
+      case 'updateRecord':
+        return this.urlForUpdateRecord(
+          id as string,
+          modelName,
+          snapshot as AdapterSnapshot,
+        );
+      case 'deleteRecord':
+        return this.urlForDeleteRecord(
+          id as string,
+          modelName,
+          snapshot as AdapterSnapshot,
+        );
+    }
+  }
+
+  /** URL for a `findRecord` request.  Default: `<collection>/<id>`. */
+  urlForFindRecord(id: string, modelName: string, _snapshot: AdapterSnapshot): string {
+    return this._composeURL(`${this.pathForType(modelName)}/${encodeURIComponent(id)}`);
+  }
+
+  /** URL for a `findAll` request.  Default: `<collection>`. */
+  urlForFindAll(modelName: string, _snapshots: AdapterSnapshot[]): string {
+    return this._composeURL(this.pathForType(modelName));
+  }
+
+  /** URL for a `findMany` request.  Default: `<collection>` (ids appended by the adapter). */
+  urlForFindMany(
+    _ids: string[],
+    modelName: string,
+    _snapshots: AdapterSnapshot[],
+  ): string {
+    return this._composeURL(this.pathForType(modelName));
+  }
+
+  /** URL for a `query` request.  Default: `<collection>`. */
+  urlForQuery(_query: Record<string, unknown>, modelName: string): string {
+    return this._composeURL(this.pathForType(modelName));
+  }
+
+  /** URL for a `queryRecord` request.  Default: `<collection>`. */
+  urlForQueryRecord(_query: Record<string, unknown>, modelName: string): string {
+    return this._composeURL(this.pathForType(modelName));
+  }
+
+  /** URL for a `createRecord` request.  Default: `<collection>`. */
+  urlForCreateRecord(modelName: string, _snapshot: AdapterSnapshot): string {
+    return this._composeURL(this.pathForType(modelName));
+  }
+
+  /** URL for an `updateRecord` request.  Default: `<collection>/<id>`. */
+  urlForUpdateRecord(
+    id: string,
+    modelName: string,
+    _snapshot: AdapterSnapshot,
+  ): string {
+    return this._composeURL(`${this.pathForType(modelName)}/${encodeURIComponent(id)}`);
+  }
+
+  /** URL for a `deleteRecord` request.  Default: `<collection>/<id>`. */
+  urlForDeleteRecord(
+    id: string,
+    modelName: string,
+    _snapshot: AdapterSnapshot,
+  ): string {
+    return this._composeURL(`${this.pathForType(modelName)}/${encodeURIComponent(id)}`);
+  }
+
+  /**
+   * Groups snapshots into batches for `findMany`.
+   * Default implementation puts all snapshots in a single batch.
+   */
+  groupRecordsForFindMany(
+    _store: unknown,
+    snapshots: AdapterSnapshot[],
+  ): AdapterSnapshot[][] {
+    return [snapshots];
+  }
+
+  /**
+   * Returns `true` when the store should bypass the cache and reload this
+   * record immediately.  Default: always `false`.
+   */
+  shouldReloadRecord(_store: unknown, _snapshot: AdapterSnapshot): boolean {
+    return false;
+  }
+
+  /**
+   * Returns `true` when the store should schedule a background reload for
+   * this record after returning the cached version.  Default: always `true`.
+   */
+  shouldBackgroundReloadRecord(
+    _store: unknown,
+    _snapshot: AdapterSnapshot,
+  ): boolean {
+    return true;
+  }
+
+  /**
+   * Returns `true` when the store should reload the full collection on every
+   * `findAll` call.  Default: always `false`.
+   */
+  shouldReloadAll(_store: unknown, _snapshotRecordArray: AdapterSnapshot[]): boolean {
+    return false;
+  }
+
+  /**
+   * Returns `true` when the store should schedule a background reload after
+   * returning a cached collection.  Default: always `true`.
+   */
+  shouldBackgroundReloadAll(
+    _store: unknown,
+    _snapshotRecordArray: AdapterSnapshot[],
+  ): boolean {
+    return true;
+  }
+}