@bjornharrtell/json-api 0.1.0

package/dist/lib.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Convert str from kebab-case to camelCase
+ */
+export declare function camel(str: string): string;
+
+export declare function createJsonApiStore(name: string, config: JsonApiStoreConfig, fetcher?: JsonApiFetcher): {
+    modelRegistry: Map<typeof Model, string>;
+    relsRegistry: Map<typeof Model, Record<string, Relationship>>;
+    findAll: <T extends typeof Model>(ctor: T, options?: FetchOptions, params?: FetchParams) => Promise<{
+        doc: JsonApiDocument;
+        records: InstanceType<T>[];
+    }>;
+    findRecord: <T extends typeof Model>(ctor: T, id: string, options?: FetchOptions, params?: FetchParams) => Promise<InstanceType<T>>;
+    findRelated: (record: Model, name: string, options?: FetchOptions, params?: FetchParams) => Promise<JsonApiDocument>;
+    saveRecord: (record: Model) => Promise<void>;
+};
+
+export declare interface FetchOptions {
+    fields?: Record<string, string[]>;
+    page?: PageOption;
+    include?: string[];
+    filter?: string;
+}
+
+export declare interface FetchParams {
+    [key: string]: string;
+}
+
+export declare interface JsonApiDocument {
+    links?: JsonApiLinks;
+    data?: JsonApiResource | JsonApiResource[];
+    errors?: JsonApiError[];
+    included?: JsonApiResource[];
+    meta?: JsonApiMeta;
+}
+
+export declare interface JsonApiError {
+    id: string;
+    status: string;
+    code?: string;
+    title: string;
+    detail?: string;
+    meta?: JsonApiMeta;
+}
+
+export declare interface JsonApiFetcher {
+    fetchDocument(type: string, id?: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiDocument>;
+    fetchOne(type: string, id: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiResource>;
+    fetchAll(type: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiResource[]>;
+    fetchHasMany(type: string, id: string, name: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiDocument>;
+    fetchBelongsTo(type: string, id: string, name: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiDocument>;
+    post(data: JsonApiResource): Promise<JsonApiDocument>;
+}
+
+export declare type JsonApiLink = null | string | JsonApiLinkObject;
+
+export declare interface JsonApiLinkObject {
+    href: string;
+    rel?: string;
+    describedby?: JsonApiLink;
+    title?: string;
+    type?: string;
+    hreflang?: string | string[];
+    meta?: JsonApiMeta;
+}
+
+export declare interface JsonApiLinks {
+    self?: JsonApiLink;
+    related?: JsonApiLink;
+    describedby?: JsonApiLink;
+    first?: JsonApiLink;
+    last?: JsonApiLink;
+    prev?: JsonApiLink;
+    next?: JsonApiLink;
+}
+
+export declare interface JsonApiMeta {
+    totalPages?: number;
+    totalItems?: number;
+    currentPage?: number;
+    itemsPerPage?: number;
+    timestamp?: string | number;
+    version?: string;
+    copyright?: string;
+    [key: string]: unknown;
+}
+
+export declare interface JsonApiRelationship {
+    data: null | [] | JsonApiResourceIdentifier | JsonApiResourceIdentifier[];
+}
+
+export declare interface JsonApiResource {
+    id: string;
+    type: string;
+    attributes: Record<string, unknown>;
+    relationships?: Record<string, JsonApiRelationship>;
+}
+
+export declare interface JsonApiResourceIdentifier {
+    id: string;
+    type: string;
+}
+
+export declare interface JsonApiStore {
+    /**
+     * Models registered with this store
+     */
+    modelRegistry: Map<typeof Model, string>;
+    /**
+     * Relationships registered with this store
+     */
+    relRegistry: Map<typeof Model, Record<string, Relationship>>;
+    /* Excluded from this release type: createRecord */
+    /**
+     * Find all records of a given type
+     * @returns the JSON API document that was fetched and the records that were found
+     */
+    findAll<T extends typeof Model>(ctor: T, options?: FetchOptions, params?: FetchParams): Promise<{
+        doc: JsonApiDocument;
+        records: InstanceType<T>[];
+    }>;
+    /**
+     * Find a single record by id
+     * @returns the record that was found
+     */
+    findRecord<T extends typeof Model>(ctor: T, id: string, options?: FetchOptions, params?: FetchParams): Promise<InstanceType<T>>;
+    /**
+     * Find related records for a given record and relationship name
+     * @returns the JSON API document that was fetched
+     */
+    findRelated(record: Model, name: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiDocument>;
+}
+
+export declare interface JsonApiStoreConfig {
+    /**
+     * The URL for the JSON:API endpoint
+     */
+    endpoint: string;
+    /**
+     * Model definitions for the store
+     */
+    modelDefinitions: ModelDefinition[];
+    /**
+     * Whether to convert kebab-case names from JSON:API (older convention) to camelCase
+     */
+    kebabCase?: boolean;
+}
+
+export declare type JsonApiStoreUseFunction = () => JsonApiStore;
+
+/**
+ * Base class for models
+ */
+export declare class Model {
+    id: string;
+    constructor(id: string);
+    [key: string]: unknown;
+}
+
+export declare interface ModelDefinition {
+    /**
+     * The JSON:API type for the model
+     */
+    type: string;
+    /**
+     * The model constructor
+     */
+    ctor: typeof Model;
+    /**
+     * Relationships for the model
+     */
+    rels?: Record<string, Relationship>;
+}
+
+export declare interface PageOption {
+    size?: number;
+    number?: number;
+}
+
+/**
+ * Relationship definition
+ */
+export declare interface Relationship {
+    ctor: typeof Model;
+    type: RelationshipType;
+}
+
+export declare enum RelationshipType {
+    HasMany = 0,
+    BelongsTo = 1
+}
+
+export { }

package/dist/lib.js

@@ -0,0 +1,155 @@
+import b from "ky";
+function O(...u) {
+  return new URL(u.join("/")).href;
+}
+class q {
+  constructor(e) {
+    this.endpoint = e;
+  }
+  createOptions(e = {}, a = {}, r = !1) {
+    const s = new URLSearchParams(), c = new Headers();
+    c.append("Accept", "application/vnd.api+json"), r && c.append("Content-Type", "application/vnd.api+json");
+    const p = { searchParams: s, headers: c };
+    if (e.fields)
+      for (const [w, m] of Object.entries(e.fields)) s.append(`fields[${w}]`, m.join(","));
+    e.page?.size && s.append("page[size]", e.page.size.toString()), e.page?.number && s.append("page[number]", e.page.number.toString()), e.include && s.append("include", e.include.join(",")), e.filter && s.append("filter", e.filter);
+    for (const [w, m] of Object.entries(a)) s.append(w, m);
+    return p;
+  }
+  async fetchDocument(e, a, r, s) {
+    const c = [this.endpoint, e];
+    a && c.push(a);
+    const p = O(...c);
+    return await b.get(p, this.createOptions(r, s)).json();
+  }
+  async fetchAll(e, a, r) {
+    const s = O(this.endpoint, e);
+    return (await b.get(s, this.createOptions(a, r)).json()).data;
+  }
+  async fetchOne(e, a, r, s) {
+    const c = O(this.endpoint, e, a);
+    return (await b.get(c, this.createOptions(r, s)).json()).data;
+  }
+  async fetchHasMany(e, a, r, s, c) {
+    const p = O(this.endpoint, e, a, r);
+    return await b.get(p, this.createOptions(s, c)).json();
+  }
+  async fetchBelongsTo(e, a, r, s, c) {
+    const p = O(this.endpoint, e, a, r);
+    return await b.get(p, this.createOptions(s, c)).json();
+  }
+  async post(e) {
+    const a = O(this.endpoint, e.type), r = this.createOptions({}, {}, !0), s = {
+      data: e
+    };
+    return r.json = s, await b.post(a, r).json();
+  }
+}
+function x(u) {
+  return u.replace(/[-][a-z\u00E0-\u00F6\u00F8-\u00FE]/g, (e) => e.slice(1).toUpperCase());
+}
+class L {
+  constructor(e) {
+    this.id = e, this.id = e;
+  }
+}
+var I = /* @__PURE__ */ ((u) => (u[u.HasMany = 0] = "HasMany", u[u.BelongsTo = 1] = "BelongsTo", u))(I || {});
+function N(u, e, a) {
+  const r = a ?? new q(e.endpoint), s = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map();
+  for (const t of e.modelDefinitions) {
+    const n = t.ctor;
+    s.set(n, t.type), c.set(t.type, n), t.rels && p.set(n, t.rels);
+  }
+  function w(t) {
+    return e.kebabCase ? x(t) : t;
+  }
+  function m(t, n, i) {
+    j(t);
+    const l = new t(n);
+    if (i)
+      for (const [d, f] of Object.entries(i)) f !== void 0 && (l[w(d)] = f);
+    return l;
+  }
+  function j(t) {
+    const n = s.get(t);
+    if (!n) throw new Error(`Model ${t.name} not defined`);
+    return n;
+  }
+  function k(t) {
+    const n = c.get(t);
+    if (!n) throw new Error(`Model with name ${t} not defined`);
+    return n;
+  }
+  function A(t, n, i) {
+    function l(o) {
+      return m(
+        k(o.type),
+        o.id,
+        o.attributes
+      );
+    }
+    const d = /* @__PURE__ */ new Map();
+    if (i) for (const o of i) d.set(o.id, l(o));
+    const f = n.map((o) => m(t, o.id, o.attributes)), h = /* @__PURE__ */ new Map();
+    for (const o of f) h.set(o.id, o);
+    function g(o) {
+      const z = h.get(o.id) ?? d.get(o.id);
+      if (!z) throw new Error("Unexpected not found record");
+      const v = k(o.type);
+      if (o.relationships)
+        for (const [M, R] of Object.entries(o.relationships)) {
+          const E = p.get(v);
+          if (!E) continue;
+          const H = w(M), $ = E[H];
+          if (!$) throw new Error(`Relationship ${H} not defined`);
+          const B = j($.ctor), C = $.type === 0 ? R.data : [R.data], P = C.filter((y) => y && d.has(y.id) && y.type === B).map((y) => d.get(y.id)), T = C.filter((y) => y && h.has(y.id) && y.type === B).map((y) => h.get(y.id));
+          T.push(...P), z[H] = $.type === 0 ? T : T[0];
+        }
+    }
+    return i && (n.map(g), i.map(g)), f;
+  }
+  async function D(t, n, i) {
+    const l = j(t), d = await r.fetchDocument(l, void 0, n, i), f = d.data, h = A(t, f, d.included);
+    return { doc: d, records: h };
+  }
+  async function F(t, n, i, l) {
+    const d = j(t), f = await r.fetchDocument(d, n, i, l), h = f.data, o = A(t, [h], f.included)[0];
+    if (!o) throw new Error(`Record with id ${n} not found`);
+    return o;
+  }
+  async function S(t, n, i, l) {
+    const d = t.constructor, f = j(d), h = p.get(d);
+    if (!h) throw new Error(`Model ${d.name} has no relationships`);
+    const g = h[n];
+    if (!g) throw new Error(`Has many relationship ${n} not defined`);
+    if (g.type === 1) {
+      const M = await r.fetchBelongsTo(f, t.id, n, i, l), R = M.data, E = m(g.ctor, R.id, R.attributes);
+      return t[n] = E, M;
+    }
+    const o = await r.fetchHasMany(f, t.id, n, i, l), v = (g.type === 0 ? o.data : [o.data]).map((M) => m(g.ctor, M.id, M.attributes));
+    return t[n] = g.type === 0 ? v : v[0], o;
+  }
+  async function U(t) {
+    const n = j(t.constructor), i = {
+      id: t.id,
+      type: n,
+      attributes: t
+    };
+    await r.post(i);
+  }
+  return {
+    modelRegistry: s,
+    relsRegistry: p,
+    findAll: D,
+    findRecord: F,
+    findRelated: S,
+    saveRecord: U
+  };
+}
+export {
+  L as Model,
+  I as RelationshipType,
+  x as camel,
+  N as createJsonApiStore
+};
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sources":["../src/json-api-fetcher.ts","../src/util.ts","../src/json-api-store.ts"],"sourcesContent":["import ky, { type Options } from 'ky'\nimport type { JsonApiDocument, JsonApiResource } from './json-api'\n\nfunction resolvePath(...segments: string[]): string {\n  return new URL(segments.join('/')).href\n}\n\nexport interface PageOption {\n  size?: number\n  number?: number\n}\n\nexport interface FetchOptions {\n  fields?: Record<string, string[]>\n  page?: PageOption\n  include?: string[]\n  filter?: string\n}\n\nexport interface FetchParams {\n  [key: string]: string\n}\n\nexport interface JsonApiFetcher {\n  fetchDocument(type: string, id?: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiDocument>\n  fetchOne(type: string, id: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiResource>\n  fetchAll(type: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiResource[]>\n  fetchHasMany(\n    type: string,\n    id: string,\n    name: string,\n    options?: FetchOptions,\n    params?: FetchParams\n  ): Promise<JsonApiDocument>\n  fetchBelongsTo(\n    type: string,\n    id: string,\n    name: string,\n    options?: FetchOptions,\n    params?: FetchParams\n  ): Promise<JsonApiDocument>\n  post(data: JsonApiResource): Promise<JsonApiDocument>\n}\n\nexport class JsonApiFetcherImpl implements JsonApiFetcher {\n  constructor(private endpoint: string) {}\n  createOptions(options: FetchOptions = {}, params: FetchParams = {}, post = false): Options {\n    const searchParams = new URLSearchParams()\n    const headers = new Headers()\n    headers.append('Accept', 'application/vnd.api+json')\n    if (post) headers.append('Content-Type', 'application/vnd.api+json')\n    //if (this.state) headers.append('Authorization', `Bearer ${this.state.value.token}`)\n    const requestOptions = { searchParams, headers }\n    if (options.fields)\n      for (const [key, value] of Object.entries(options.fields)) searchParams.append(`fields[${key}]`, value.join(','))\n    if (options.page?.size) searchParams.append('page[size]', options.page.size.toString())\n    if (options.page?.number) searchParams.append('page[number]', options.page.number.toString())\n    if (options.include) searchParams.append('include', options.include.join(','))\n    if (options.filter) searchParams.append('filter', options.filter)\n    for (const [key, value] of Object.entries(params)) searchParams.append(key, value)\n    return requestOptions\n  }\n  async fetchDocument(type: string, id?: string, options?: FetchOptions, params?: FetchParams) {\n    const segments = [this.endpoint, type]\n    if (id) segments.push(id)\n    const url = resolvePath(...segments)\n    const doc = await ky.get(url, this.createOptions(options, params)).json<JsonApiDocument>()\n    return doc\n  }\n  async fetchAll(type: string, options?: FetchOptions, params?: FetchParams) {\n    const url = resolvePath(this.endpoint, type)\n    const doc = await ky.get(url, this.createOptions(options, params)).json<JsonApiDocument>()\n    const resources = doc.data as JsonApiResource[]\n    return resources\n  }\n  async fetchOne(type: string, id: string, options?: FetchOptions, params?: FetchParams) {\n    const url = resolvePath(this.endpoint, type, id)\n    const doc = await ky.get(url, this.createOptions(options, params)).json<JsonApiDocument>()\n    const resource = doc.data as JsonApiResource\n    return resource\n  }\n  async fetchHasMany(type: string, id: string, name: string, options?: FetchOptions, params?: FetchParams) {\n    const url = resolvePath(this.endpoint, type, id, name)\n    const doc = await ky.get(url, this.createOptions(options, params)).json<JsonApiDocument>()\n    return doc\n  }\n  async fetchBelongsTo(type: string, id: string, name: string, options?: FetchOptions, params?: FetchParams) {\n    const url = resolvePath(this.endpoint, type, id, name)\n    const doc = await ky.get(url, this.createOptions(options, params)).json<JsonApiDocument>()\n    return doc\n  }\n  async post(resource: JsonApiResource) {\n    const url = resolvePath(this.endpoint, resource.type)\n    const requestOptions = this.createOptions({}, {}, true)\n    const body: JsonApiDocument = {\n      data: resource,\n    }\n    requestOptions.json = body\n    const doc = await ky.post(url, requestOptions).json<JsonApiDocument>()\n    return doc\n  }\n}\n","/**\n * Convert str from kebab-case to camelCase\n */\nexport function camel(str: string) {\n  return str.replace(/[-][a-z\\u00E0-\\u00F6\\u00F8-\\u00FE]/g, (match) => match.slice(1).toUpperCase())\n}\n","import type { JsonApiDocument, JsonApiResource, JsonApiResourceIdentifier } from './json-api'\nimport { type FetchOptions, type FetchParams, type JsonApiFetcher, JsonApiFetcherImpl } from './json-api-fetcher'\nimport { camel } from './util'\n\n/**\n * Base class for models\n */\nexport class Model {\n  constructor(public id: string) {\n    this.id = id\n  }\n  [key: string]: unknown\n}\n\nexport interface ModelDefinition {\n  /**\n   * The JSON:API type for the model\n   */\n  type: string\n  /**\n   * The model constructor\n   */\n  ctor: typeof Model\n  /**\n   * Relationships for the model\n   */\n  rels?: Record<string, Relationship>\n}\n\nexport interface JsonApiStoreConfig {\n  /**\n   * The URL for the JSON:API endpoint\n   */\n  endpoint: string\n  /**\n   * Model definitions for the store\n   */\n  modelDefinitions: ModelDefinition[]\n  /**\n   * Whether to convert kebab-case names from JSON:API (older convention) to camelCase\n   */\n  kebabCase?: boolean\n}\n\nexport enum RelationshipType {\n  HasMany = 0,\n  BelongsTo = 1,\n}\n\n/**\n * Relationship definition\n */\nexport interface Relationship {\n  ctor: typeof Model\n  type: RelationshipType\n}\n\nexport interface JsonApiStore {\n  /**\n   * Models registered with this store\n   */\n  modelRegistry: Map<typeof Model, string>\n  /**\n   * Relationships registered with this store\n   */\n  relRegistry: Map<typeof Model, Record<string, Relationship>>\n  /**\n   * @internal\n   */\n  createRecord<T extends typeof Model>(ctor: T, properties: Partial<InstanceType<T>> & { id?: string }): InstanceType<T>\n  /**\n   * Find all records of a given type\n   * @returns the JSON API document that was fetched and the records that were found\n   */\n  findAll<T extends typeof Model>(\n    ctor: T,\n    options?: FetchOptions,\n    params?: FetchParams\n  ): Promise<{ doc: JsonApiDocument; records: InstanceType<T>[] }>\n  /**\n   * Find a single record by id\n   * @returns the record that was found\n   */\n  findRecord<T extends typeof Model>(\n    ctor: T,\n    id: string,\n    options?: FetchOptions,\n    params?: FetchParams\n  ): Promise<InstanceType<T>>\n  /**\n   * Find related records for a given record and relationship name\n   * @returns the JSON API document that was fetched\n   */\n  findRelated(record: Model, name: string, options?: FetchOptions, params?: FetchParams): Promise<JsonApiDocument>\n}\n\nexport type JsonApiStoreUseFunction = () => JsonApiStore\n\nexport function createJsonApiStore(name: string, config: JsonApiStoreConfig, fetcher?: JsonApiFetcher) {\n  const _fetcher = fetcher ?? new JsonApiFetcherImpl(config.endpoint)\n\n  const modelRegistry = new Map<typeof Model, string>()\n  const modelsByType = new Map<string, typeof Model>()\n  const relsRegistry = new Map<typeof Model, Record<string, Relationship>>()\n\n  for (const modelDef of config.modelDefinitions) {\n    const ctor = modelDef.ctor\n    modelRegistry.set(ctor, modelDef.type)\n    modelsByType.set(modelDef.type, ctor)\n    if (modelDef.rels) relsRegistry.set(ctor, modelDef.rels)\n  }\n\n  function normalize(str: string) {\n    return config.kebabCase ? camel(str) : str\n  }\n\n  function internalCreateRecord<T extends typeof Model>(ctor: T, id: string, properties?: Partial<InstanceType<T>>) {\n    const type = getModelType(ctor)\n    const record = new ctor(id)\n    if (properties)\n      for (const [key, value] of Object.entries(properties)) if (value !== undefined) record[normalize(key)] = value\n    return record as InstanceType<T>\n  }\n\n  function getModelType(ctor: typeof Model) {\n    const type = modelRegistry.get(ctor)\n    if (!type) throw new Error(`Model ${ctor.name} not defined`)\n    return type\n  }\n\n  function getModel(type: string) {\n    const ctor = modelsByType.get(type)\n    if (!ctor) throw new Error(`Model with name ${type} not defined`)\n    return ctor\n  }\n\n  function resourcesToRecords<T extends typeof Model>(\n    ctor: T,\n    resources: JsonApiResource[],\n    included?: JsonApiResource[]\n  ) {\n    function createRecord<T extends typeof Model>(resource: JsonApiResource) {\n      return internalCreateRecord<T>(\n        getModel(resource.type) as T,\n        resource.id,\n        resource.attributes as Partial<InstanceType<T>>\n      )\n    }\n    // create records for included resources\n    const includedMap = new Map<string, InstanceType<typeof Model>>()\n    if (included) for (const resource of included) includedMap.set(resource.id, createRecord(resource))\n    // create records for main resources\n    const records = resources.map((r) => internalCreateRecord<T>(ctor, r.id, r.attributes as Partial<InstanceType<T>>))\n    const recordsMap = new Map<string, InstanceType<typeof Model>>()\n    for (const r of records) recordsMap.set(r.id, r)\n    // populate relationships\n    function populateRelationships(resource: JsonApiResource) {\n      const record = recordsMap.get(resource.id) ?? includedMap.get(resource.id)\n      if (!record) throw new Error('Unexpected not found record')\n      const recordCtor = getModel(resource.type)\n      if (!resource.relationships) return\n      for (const [name, reldoc] of Object.entries(resource.relationships)) {\n        const rels = relsRegistry.get(recordCtor)\n        // NOTE: if relationship is not defined but exists in data, it is ignored\n        if (!rels) continue\n        const normalizedName = normalize(name)\n        const rel = rels[normalizedName]\n        if (!rel) throw new Error(`Relationship ${normalizedName} not defined`)\n        const relType = getModelType(rel.ctor)\n        const rids =\n          rel.type === RelationshipType.HasMany\n            ? (reldoc.data as JsonApiResourceIdentifier[])\n            : [reldoc.data as JsonApiResourceIdentifier]\n        const relIncludedRecords = rids\n          .filter((d) => d && includedMap.has(d.id) && d.type === relType)\n          .map((d) => includedMap.get(d.id))\n        const relRecords = rids\n          .filter((d) => d && recordsMap.has(d.id) && d.type === relType)\n          .map((d) => recordsMap.get(d.id))\n        relRecords.push(...relIncludedRecords)\n        record[normalizedName] = rel.type === RelationshipType.HasMany ? relRecords : relRecords[0]\n      }\n    }\n    if (included) {\n      resources.map(populateRelationships)\n      included.map(populateRelationships)\n    }\n    return records as InstanceType<T>[]\n  }\n\n  async function findAll<T extends typeof Model>(ctor: T, options?: FetchOptions, params?: FetchParams) {\n    const type = getModelType(ctor)\n    const doc = await _fetcher.fetchDocument(type, undefined, options, params)\n    const resources = doc.data as JsonApiResource[]\n    const records = resourcesToRecords(ctor, resources, doc.included)\n    return { doc, records }\n  }\n\n  async function findRecord<T extends typeof Model>(ctor: T, id: string, options?: FetchOptions, params?: FetchParams) {\n    const type = getModelType(ctor)\n    const doc = await _fetcher.fetchDocument(type, id, options, params)\n    const resource = doc.data as JsonApiResource\n    const records = resourcesToRecords(ctor, [resource], doc.included)\n    const record = records[0]\n    if (!record) throw new Error(`Record with id ${id} not found`)\n    return record as InstanceType<T>\n  }\n\n  async function findRelated(record: Model, name: string, options?: FetchOptions, params?: FetchParams) {\n    const ctor = record.constructor as typeof Model\n    const type = getModelType(ctor)\n    const rels = relsRegistry.get(ctor)\n    if (!rels) throw new Error(`Model ${ctor.name} has no relationships`)\n    const rel = rels[name]\n    if (!rel) throw new Error(`Has many relationship ${name} not defined`)\n    if (rel.type === RelationshipType.BelongsTo) {\n      const doc = await _fetcher.fetchBelongsTo(type, record.id, name, options, params)\n      const related = doc.data as JsonApiResource\n      const relatedRecord = internalCreateRecord(rel.ctor, related.id, related.attributes)\n      record[name] = relatedRecord\n      return doc\n    }\n    const doc = await _fetcher.fetchHasMany(type, record.id, name, options, params)\n    const related =\n      rel.type === RelationshipType.HasMany ? (doc.data as JsonApiResource[]) : [doc.data as JsonApiResource]\n    const relatedRecords = related.map((r) => internalCreateRecord(rel.ctor, r.id, r.attributes))\n    record[name] = rel.type === RelationshipType.HasMany ? relatedRecords : relatedRecords[0]\n    return doc\n  }\n\n  async function saveRecord(record: Model) {\n    const type = getModelType(record.constructor as typeof Model)\n    const resource: JsonApiResource = {\n      id: record.id,\n      type,\n      attributes: record,\n    }\n    await _fetcher.post(resource)\n  }\n\n  return {\n    modelRegistry,\n    relsRegistry,\n    findAll,\n    findRecord,\n    findRelated,\n    saveRecord,\n  }\n}\n"],"names":["resolvePath","segments","JsonApiFetcherImpl","endpoint","options","params","post","searchParams","headers","requestOptions","key","value","type","id","url","ky","name","resource","body","camel","str","match","Model","RelationshipType","createJsonApiStore","config","fetcher","_fetcher","modelRegistry","modelsByType","relsRegistry","modelDef","ctor","normalize","internalCreateRecord","properties","getModelType","record","getModel","resourcesToRecords","resources","included","createRecord","includedMap","records","r","recordsMap","populateRelationships","recordCtor","reldoc","rels","normalizedName","rel","relType","rids","relIncludedRecords","d","relRecords","findAll","doc","findRecord","findRelated","related","relatedRecord","relatedRecords","saveRecord"],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@bjornharrtell/json-api",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/lib.js",
+  "module": "./dist/lib.js",
+  "types": "./dist/lib.d.ts",
+  "exports": {
+    ".": "./dist/lib.js",
+    "./*": "./src/*"
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bjornharrtell/json-api.git"
+  },
+  "scripts": {
+    "dev": "vite",
+    "test": "vitest",
+    "build": "vite build",
+    "preview": "vite preview",
+    "type-check": "vue-tsc --build",
+    "typedoc": "typedoc"
+  },
+  "dependencies": {
+    "ky": "^1.7.5"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "1.9.4",
+    "@tsconfig/node22": "^22.0.1",
+    "@types/jsdom": "^21.1.7",
+    "@types/node": "^22.13.13",
+    "@vue/test-utils": "^2.4.6",
+    "@vue/tsconfig": "^0.7.0",
+    "typedoc": "^0.28.1",
+    "typescript": "~5.8.2",
+    "vite": "^6.2.3",
+    "vite-plugin-dts": "^4.5.3",
+    "vitest": "^3.0.9"
+  }
+}