@leodamours/jsonapi-client 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Léo Damours
+
+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,176 @@
+# @leodamours/jsonapi-client
+
+[![CI](https://github.com/LeoDamours/json-api-client/actions/workflows/ci.yml/badge.svg)](https://github.com/LeoDamours/json-api-client/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@leodamours/jsonapi-client)](https://www.npmjs.com/package/@leodamours/jsonapi-client)
+
+A typed HTTP client for [JSON:API](https://jsonapi.org/) — full CRUD with automatic type inference, powered by Axios.
+
+## Install
+
+```bash
+npm install @leodamours/jsonapi-client @leodamours/jsonapi-dsl axios
+```
+
+## Quick Start
+
+```ts
+import { defineResource, t, hasOne, hasMany } from "@leodamours/jsonapi-dsl";
+import { createClient } from "@leodamours/jsonapi-client";
+
+const User = defineResource(
+  "users",
+  {
+    name: t.string(),
+    email: t.string(),
+    age: t.nullable(t.number()),
+  },
+  {
+    posts: hasMany("posts"),
+    company: hasOne("companies"),
+  }
+);
+
+const api = createClient({ baseURL: "https://api.example.com" });
+
+// CREATE — attributes fully typed, relationships type-checked
+const created = await api.create(User, {
+  attributes: { name: "Leo", email: "leo@example.com", age: null },
+  relationships: { company: { type: "companies", id: "1" } },
+});
+console.log(created.data.attributes.name); // string
+
+// FIND ONE
+const user = await api.findOne(User, "1", { include: "posts" });
+console.log(user.data.attributes.email); // string
+
+// FIND ALL with pagination
+const users = await api.findAll(User, {
+  page: { size: 10, number: 1 },
+  filter: { active: true },
+  sort: ["-createdAt", "name"],
+});
+for (const u of users.data) {
+  console.log(u.attributes.name);
+}
+
+// UPDATE — attributes are Partial
+await api.update(User, "1", {
+  attributes: { name: "Updated" },
+});
+
+// DELETE
+await api.remove(User, "1");
+```
+
+## Client Configuration
+
+```ts
+import { createClient } from "@leodamours/jsonapi-client";
+
+const api = createClient({
+  baseURL: "https://api.example.com",
+  jwtToken: "your-jwt-token",       // sets Authorization: Bearer ...
+  headers: { "X-Custom": "value" }, // extra headers
+  timeout: 5000,                    // request timeout in ms
+});
+
+// Update config at runtime (e.g. after login)
+api.updateConfig({ jwtToken: "new-token" });
+
+// Clear auth
+api.updateConfig({ jwtToken: null as any });
+
+// Access underlying Axios instance
+const axiosInstance = api.getAxiosInstance();
+axiosInstance.interceptors.response.use(/* ... */);
+```
+
+## Per-Verb Attribute Narrowing
+
+When a resource is defined with `create`/`update` options, the client enforces which attributes each verb accepts:
+
+```ts
+const Author = defineResource(
+  "authors",
+  {
+    name: t.string(),
+    email: t.string(),
+    createdAt: t.string(),
+  },
+  { posts: hasMany("posts") },
+  {
+    create: ["name", "email"] as const,
+    update: ["name"] as const,
+  }
+);
+
+// Only name and email accepted (createdAt is rejected at compile time)
+await api.create(Author, {
+  attributes: { name: "Leo", email: "leo@example.com" },
+});
+
+// Only name accepted
+await api.update(Author, "1", {
+  attributes: { name: "Updated" },
+});
+
+// Response still has all attributes
+const doc = await api.findOne(Author, "1");
+doc.data.attributes.createdAt; // string
+```
+
+## Payload Types
+
+Use `CreatePayload` and `UpdatePayload` for standalone typing:
+
+```ts
+import type { CreatePayload, UpdatePayload } from "@leodamours/jsonapi-client";
+
+type CreateUser = CreatePayload<typeof User>;
+// { attributes: { name: string; email: string; age: number | null }; relationships?: ... }
+
+type UpdateUser = UpdatePayload<typeof User>;
+// { attributes?: Partial<{ name: string; email: string; age: number | null }>; relationships?: ... }
+```
+
+## Query Parameters
+
+The client serializes query params following JSON:API conventions:
+
+```ts
+await api.findAll(User, {
+  page: { size: 10, number: 2 },      // → page[size]=10&page[number]=2
+  filter: { active: true },            // → filter[active]=true
+  sort: ["-createdAt", "name"],        // → sort=-createdAt,name
+  include: ["posts", "company"],       // → include=posts,company
+  fields: { users: ["name", "email"] },// → fields[users]=name,email
+});
+```
+
+## Serialization Utilities
+
+Lower-level serialization functions are exported for custom use:
+
+```ts
+import {
+  serializeCreatePayload,
+  serializeUpdatePayload,
+  serializeQueryParams,
+  serializeRelationships,
+} from "@leodamours/jsonapi-client";
+```
+
+## Axios Integration
+
+The client uses Axios under the hood. All CRUD methods accept an optional `AxiosRequestConfig` as the last argument:
+
+```ts
+await api.findOne(User, "1", undefined, {
+  signal: abortController.signal,
+  headers: { "X-Request-Id": "abc" },
+});
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,130 @@
+import { AxiosRequestConfig, AxiosInstance } from 'axios';
+import { ResourceDefinition, InferAttributesSimple, RelationshipsSchema, JsonApiDocument, InferResource, JsonApiCollectionDocument, JsonApiRelationships } from '@leodamours/jsonapi-dsl';
+
+type SimplifiedHasOne<T extends string> = {
+    type: T;
+    id: string;
+} | null;
+type SimplifiedHasMany<T extends string> = Array<{
+    type: T;
+    id: string;
+}>;
+/**
+ * Indexed lookup for simplified relationship shapes — avoids conditional types.
+ */
+interface SimplifiedRelTypeMap<T extends string> {
+    one: SimplifiedHasOne<T>;
+    many: SimplifiedHasMany<T>;
+}
+type SimplifiedRelationships<Schema extends RelationshipsSchema> = {
+    [K in keyof Schema]: SimplifiedRelTypeMap<Schema[K]["type"]>[Schema[K]["_rel"]];
+};
+type RelationshipClause<Rels extends RelationshipsSchema> = {
+    relationships?: Partial<SimplifiedRelationships<Rels>>;
+};
+/**
+ * Payload for creating a resource.
+ * When the definition has `createKeys`, only those attribute keys are accepted.
+ */
+type CreatePayload<Def extends ResourceDefinition> = Def extends {
+    readonly createKeys: readonly (infer CK extends string)[];
+} ? {
+    attributes: Pick<InferAttributesSimple<Def["attributes"]>, CK & keyof Def["attributes"]>;
+    relationships?: Partial<SimplifiedRelationships<Def["relationships"]>>;
+} : {
+    attributes: InferAttributesSimple<Def["attributes"]>;
+    relationships?: Partial<SimplifiedRelationships<Def["relationships"]>>;
+};
+/**
+ * Payload for updating a resource.
+ * When the definition has `updateKeys`, only those attribute keys are accepted.
+ */
+type UpdatePayload<Def extends ResourceDefinition> = Def extends {
+    readonly updateKeys: readonly (infer UK extends string)[];
+} ? {
+    attributes?: Partial<Pick<InferAttributesSimple<Def["attributes"]>, UK & keyof Def["attributes"]>>;
+    relationships?: Partial<SimplifiedRelationships<Def["relationships"]>>;
+} : {
+    attributes?: Partial<InferAttributesSimple<Def["attributes"]>>;
+    relationships?: Partial<SimplifiedRelationships<Def["relationships"]>>;
+};
+interface ClientConfig {
+    baseURL: string;
+    jwtToken?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+interface QueryParams {
+    page?: Record<string, string | number>;
+    filter?: Record<string, string | number | boolean>;
+    sort?: string | string[];
+    include?: string | string[];
+    fields?: Record<string, string | string[]>;
+    [key: string]: unknown;
+}
+
+declare class JsonApiClient {
+    private axios;
+    constructor(config: ClientConfig);
+    /**
+     * POST /{resourceType}
+     */
+    create<Def extends ResourceDefinition>(definition: Def, payload: CreatePayload<Def>, options?: AxiosRequestConfig): Promise<JsonApiDocument<InferResource<Def>>>;
+    /**
+     * GET /{resourceType}/{id}
+     */
+    findOne<Def extends ResourceDefinition>(definition: Def, id: string, params?: QueryParams, options?: AxiosRequestConfig): Promise<JsonApiDocument<InferResource<Def>>>;
+    /**
+     * GET /{resourceType}
+     */
+    findAll<Def extends ResourceDefinition>(definition: Def, params?: QueryParams, options?: AxiosRequestConfig): Promise<JsonApiCollectionDocument<InferResource<Def>>>;
+    /**
+     * PATCH /{resourceType}/{id}
+     */
+    update<Def extends ResourceDefinition>(definition: Def, id: string, payload: UpdatePayload<Def>, options?: AxiosRequestConfig): Promise<JsonApiDocument<InferResource<Def>>>;
+    /**
+     * DELETE /{resourceType}/{id}
+     */
+    remove(definition: ResourceDefinition, id: string, options?: AxiosRequestConfig): Promise<void>;
+    /**
+     * Update client configuration at runtime.
+     */
+    updateConfig(config: Partial<ClientConfig>): void;
+    /**
+     * Access the underlying Axios instance for advanced use.
+     */
+    getAxiosInstance(): AxiosInstance;
+}
+declare function createClient(config: ClientConfig): JsonApiClient;
+
+/**
+ * Wrap simplified relationship values in `{ data: ... }` per JSON:API spec.
+ */
+declare function serializeRelationships(simplified: Record<string, unknown> | undefined, definition: ResourceDefinition): JsonApiRelationships | undefined;
+/**
+ * Build a JSON:API request body for creating a resource.
+ */
+declare function serializeCreatePayload(definition: ResourceDefinition, payload: {
+    attributes: Record<string, unknown>;
+    relationships?: Record<string, unknown>;
+}): {
+    data: Record<string, unknown>;
+};
+/**
+ * Build a JSON:API request body for updating a resource.
+ */
+declare function serializeUpdatePayload(definition: ResourceDefinition, id: string, payload: {
+    attributes?: Record<string, unknown>;
+    relationships?: Record<string, unknown>;
+}): {
+    data: Record<string, unknown>;
+};
+/**
+ * Encode query params using JSON:API bracket conventions.
+ *
+ * `{ page: { size: 10 } }` → `"page[size]=10"`
+ * `{ sort: ["-createdAt", "title"] }` → `"sort=-createdAt,title"`
+ */
+declare function serializeQueryParams(params: Record<string, unknown>): Record<string, string>;
+
+export { type ClientConfig, type CreatePayload, JsonApiClient, type QueryParams, type RelationshipClause, type SimplifiedHasMany, type SimplifiedHasOne, type SimplifiedRelationships, type UpdatePayload, createClient, serializeCreatePayload, serializeQueryParams, serializeRelationships, serializeUpdatePayload };

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+import { AxiosRequestConfig, AxiosInstance } from 'axios';
+import { ResourceDefinition, InferAttributesSimple, RelationshipsSchema, JsonApiDocument, InferResource, JsonApiCollectionDocument, JsonApiRelationships } from '@leodamours/jsonapi-dsl';
+
+type SimplifiedHasOne<T extends string> = {
+    type: T;
+    id: string;
+} | null;
+type SimplifiedHasMany<T extends string> = Array<{
+    type: T;
+    id: string;
+}>;
+/**
+ * Indexed lookup for simplified relationship shapes — avoids conditional types.
+ */
+interface SimplifiedRelTypeMap<T extends string> {
+    one: SimplifiedHasOne<T>;
+    many: SimplifiedHasMany<T>;
+}
+type SimplifiedRelationships<Schema extends RelationshipsSchema> = {
+    [K in keyof Schema]: SimplifiedRelTypeMap<Schema[K]["type"]>[Schema[K]["_rel"]];
+};
+type RelationshipClause<Rels extends RelationshipsSchema> = {
+    relationships?: Partial<SimplifiedRelationships<Rels>>;
+};
+/**
+ * Payload for creating a resource.
+ * When the definition has `createKeys`, only those attribute keys are accepted.
+ */
+type CreatePayload<Def extends ResourceDefinition> = Def extends {
+    readonly createKeys: readonly (infer CK extends string)[];
+} ? {
+    attributes: Pick<InferAttributesSimple<Def["attributes"]>, CK & keyof Def["attributes"]>;
+    relationships?: Partial<SimplifiedRelationships<Def["relationships"]>>;
+} : {
+    attributes: InferAttributesSimple<Def["attributes"]>;
+    relationships?: Partial<SimplifiedRelationships<Def["relationships"]>>;
+};
+/**
+ * Payload for updating a resource.
+ * When the definition has `updateKeys`, only those attribute keys are accepted.
+ */
+type UpdatePayload<Def extends ResourceDefinition> = Def extends {
+    readonly updateKeys: readonly (infer UK extends string)[];
+} ? {
+    attributes?: Partial<Pick<InferAttributesSimple<Def["attributes"]>, UK & keyof Def["attributes"]>>;
+    relationships?: Partial<SimplifiedRelationships<Def["relationships"]>>;
+} : {
+    attributes?: Partial<InferAttributesSimple<Def["attributes"]>>;
+    relationships?: Partial<SimplifiedRelationships<Def["relationships"]>>;
+};
+interface ClientConfig {
+    baseURL: string;
+    jwtToken?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+interface QueryParams {
+    page?: Record<string, string | number>;
+    filter?: Record<string, string | number | boolean>;
+    sort?: string | string[];
+    include?: string | string[];
+    fields?: Record<string, string | string[]>;
+    [key: string]: unknown;
+}
+
+declare class JsonApiClient {
+    private axios;
+    constructor(config: ClientConfig);
+    /**
+     * POST /{resourceType}
+     */
+    create<Def extends ResourceDefinition>(definition: Def, payload: CreatePayload<Def>, options?: AxiosRequestConfig): Promise<JsonApiDocument<InferResource<Def>>>;
+    /**
+     * GET /{resourceType}/{id}
+     */
+    findOne<Def extends ResourceDefinition>(definition: Def, id: string, params?: QueryParams, options?: AxiosRequestConfig): Promise<JsonApiDocument<InferResource<Def>>>;
+    /**
+     * GET /{resourceType}
+     */
+    findAll<Def extends ResourceDefinition>(definition: Def, params?: QueryParams, options?: AxiosRequestConfig): Promise<JsonApiCollectionDocument<InferResource<Def>>>;
+    /**
+     * PATCH /{resourceType}/{id}
+     */
+    update<Def extends ResourceDefinition>(definition: Def, id: string, payload: UpdatePayload<Def>, options?: AxiosRequestConfig): Promise<JsonApiDocument<InferResource<Def>>>;
+    /**
+     * DELETE /{resourceType}/{id}
+     */
+    remove(definition: ResourceDefinition, id: string, options?: AxiosRequestConfig): Promise<void>;
+    /**
+     * Update client configuration at runtime.
+     */
+    updateConfig(config: Partial<ClientConfig>): void;
+    /**
+     * Access the underlying Axios instance for advanced use.
+     */
+    getAxiosInstance(): AxiosInstance;
+}
+declare function createClient(config: ClientConfig): JsonApiClient;
+
+/**
+ * Wrap simplified relationship values in `{ data: ... }` per JSON:API spec.
+ */
+declare function serializeRelationships(simplified: Record<string, unknown> | undefined, definition: ResourceDefinition): JsonApiRelationships | undefined;
+/**
+ * Build a JSON:API request body for creating a resource.
+ */
+declare function serializeCreatePayload(definition: ResourceDefinition, payload: {
+    attributes: Record<string, unknown>;
+    relationships?: Record<string, unknown>;
+}): {
+    data: Record<string, unknown>;
+};
+/**
+ * Build a JSON:API request body for updating a resource.
+ */
+declare function serializeUpdatePayload(definition: ResourceDefinition, id: string, payload: {
+    attributes?: Record<string, unknown>;
+    relationships?: Record<string, unknown>;
+}): {
+    data: Record<string, unknown>;
+};
+/**
+ * Encode query params using JSON:API bracket conventions.
+ *
+ * `{ page: { size: 10 } }` → `"page[size]=10"`
+ * `{ sort: ["-createdAt", "title"] }` → `"sort=-createdAt,title"`
+ */
+declare function serializeQueryParams(params: Record<string, unknown>): Record<string, string>;
+
+export { type ClientConfig, type CreatePayload, JsonApiClient, type QueryParams, type RelationshipClause, type SimplifiedHasMany, type SimplifiedHasOne, type SimplifiedRelationships, type UpdatePayload, createClient, serializeCreatePayload, serializeQueryParams, serializeRelationships, serializeUpdatePayload };

package/dist/index.js

@@ -0,0 +1,161 @@
+'use strict';
+
+var axios = require('axios');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var axios__default = /*#__PURE__*/_interopDefault(axios);
+
+// src/client.ts
+
+// src/serialize.ts
+function serializeRelationships(simplified, definition) {
+  if (!simplified) return void 0;
+  const result = {};
+  let hasKeys = false;
+  for (const key of Object.keys(simplified)) {
+    const value = simplified[key];
+    if (value === void 0) continue;
+    const relDef = definition.relationships[key];
+    if (!relDef) continue;
+    hasKeys = true;
+    if (relDef._rel === "one") {
+      result[key] = { data: value };
+    } else {
+      result[key] = { data: value };
+    }
+  }
+  return hasKeys ? result : void 0;
+}
+function serializeCreatePayload(definition, payload) {
+  const data = {
+    type: definition.resourceType,
+    attributes: payload.attributes
+  };
+  const rels = serializeRelationships(payload.relationships, definition);
+  if (rels) data.relationships = rels;
+  return { data };
+}
+function serializeUpdatePayload(definition, id, payload) {
+  const data = {
+    type: definition.resourceType,
+    id
+  };
+  if (payload.attributes && Object.keys(payload.attributes).length > 0) {
+    data.attributes = payload.attributes;
+  }
+  const rels = serializeRelationships(payload.relationships, definition);
+  if (rels) data.relationships = rels;
+  return { data };
+}
+function serializeQueryParams(params) {
+  const out = {};
+  for (const [key, value] of Object.entries(params)) {
+    if (value == null) continue;
+    if (typeof value === "object" && !Array.isArray(value)) {
+      for (const [nested, nv] of Object.entries(value)) {
+        if (nv != null) out[`${key}[${nested}]`] = String(nv);
+      }
+    } else if (Array.isArray(value)) {
+      out[key] = value.join(",");
+    } else {
+      out[key] = String(value);
+    }
+  }
+  return out;
+}
+
+// src/client.ts
+var JsonApiClient = class {
+  constructor(config) {
+    const headers = {
+      "Content-Type": "application/vnd.api+json",
+      Accept: "application/vnd.api+json",
+      ...config.headers
+    };
+    if (config.jwtToken) {
+      headers.Authorization = `Bearer ${config.jwtToken}`;
+    }
+    this.axios = axios__default.default.create({
+      baseURL: config.baseURL,
+      headers,
+      timeout: config.timeout
+    });
+  }
+  /**
+   * POST /{resourceType}
+   */
+  async create(definition, payload, options) {
+    const body = serializeCreatePayload(definition, payload);
+    const res = await this.axios.post(`/${definition.resourceType}`, body, options);
+    return res.data;
+  }
+  /**
+   * GET /{resourceType}/{id}
+   */
+  async findOne(definition, id, params, options) {
+    const res = await this.axios.get(`/${definition.resourceType}/${id}`, {
+      params: params ? serializeQueryParams(params) : void 0,
+      ...options
+    });
+    return res.data;
+  }
+  /**
+   * GET /{resourceType}
+   */
+  async findAll(definition, params, options) {
+    const res = await this.axios.get(`/${definition.resourceType}`, {
+      params: params ? serializeQueryParams(params) : void 0,
+      ...options
+    });
+    return res.data;
+  }
+  /**
+   * PATCH /{resourceType}/{id}
+   */
+  async update(definition, id, payload, options) {
+    const body = serializeUpdatePayload(definition, id, payload);
+    const res = await this.axios.patch(`/${definition.resourceType}/${id}`, body, options);
+    return res.data;
+  }
+  /**
+   * DELETE /{resourceType}/{id}
+   */
+  async remove(definition, id, options) {
+    await this.axios.delete(`/${definition.resourceType}/${id}`, options);
+  }
+  /**
+   * Update client configuration at runtime.
+   */
+  updateConfig(config) {
+    if (config.baseURL) {
+      this.axios.defaults.baseURL = config.baseURL;
+    }
+    if (config.headers) {
+      Object.assign(this.axios.defaults.headers.common, config.headers);
+    }
+    if (config.jwtToken) {
+      this.axios.defaults.headers.common.Authorization = `Bearer ${config.jwtToken}`;
+    } else if (config.jwtToken === null) {
+      delete this.axios.defaults.headers.common.Authorization;
+    }
+  }
+  /**
+   * Access the underlying Axios instance for advanced use.
+   */
+  getAxiosInstance() {
+    return this.axios;
+  }
+};
+function createClient(config) {
+  return new JsonApiClient(config);
+}
+
+exports.JsonApiClient = JsonApiClient;
+exports.createClient = createClient;
+exports.serializeCreatePayload = serializeCreatePayload;
+exports.serializeQueryParams = serializeQueryParams;
+exports.serializeRelationships = serializeRelationships;
+exports.serializeUpdatePayload = serializeUpdatePayload;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/serialize.ts","../src/client.ts"],"names":["axios"],"mappings":"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","file":"index.js","sourcesContent":["import type { ResourceDefinition, JsonApiRelationships } from \"@leodamours/jsonapi-dsl\";\n\n/**\n * Wrap simplified relationship values in `{ data: ... }` per JSON:API spec.\n */\nexport function serializeRelationships(\n  simplified: Record<string, unknown> | undefined,\n  definition: ResourceDefinition,\n): JsonApiRelationships | undefined {\n  if (!simplified) return undefined;\n\n  const result: JsonApiRelationships = {};\n  let hasKeys = false;\n\n  for (const key of Object.keys(simplified)) {\n    const value = simplified[key];\n    if (value === undefined) continue;\n\n    const relDef = definition.relationships[key];\n    if (!relDef) continue;\n\n    hasKeys = true;\n\n    if (relDef._rel === \"one\") {\n      result[key] = { data: value as { type: string; id: string } | null };\n    } else {\n      result[key] = { data: value as { type: string; id: string }[] };\n    }\n  }\n\n  return hasKeys ? result : undefined;\n}\n\n/**\n * Build a JSON:API request body for creating a resource.\n */\nexport function serializeCreatePayload(\n  definition: ResourceDefinition,\n  payload: { attributes: Record<string, unknown>; relationships?: Record<string, unknown> },\n): { data: Record<string, unknown> } {\n  const data: Record<string, unknown> = {\n    type: definition.resourceType,\n    attributes: payload.attributes,\n  };\n\n  const rels = serializeRelationships(payload.relationships, definition);\n  if (rels) data.relationships = rels;\n\n  return { data };\n}\n\n/**\n * Build a JSON:API request body for updating a resource.\n */\nexport function serializeUpdatePayload(\n  definition: ResourceDefinition,\n  id: string,\n  payload: { attributes?: Record<string, unknown>; relationships?: Record<string, unknown> },\n): { data: Record<string, unknown> } {\n  const data: Record<string, unknown> = {\n    type: definition.resourceType,\n    id,\n  };\n\n  if (payload.attributes && Object.keys(payload.attributes).length > 0) {\n    data.attributes = payload.attributes;\n  }\n\n  const rels = serializeRelationships(payload.relationships, definition);\n  if (rels) data.relationships = rels;\n\n  return { data };\n}\n\n/**\n * Encode query params using JSON:API bracket conventions.\n *\n * `{ page: { size: 10 } }` → `\"page[size]=10\"`\n * `{ sort: [\"-createdAt\", \"title\"] }` → `\"sort=-createdAt,title\"`\n */\nexport function serializeQueryParams(params: Record<string, unknown>): Record<string, string> {\n  const out: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value == null) continue;\n\n    if (typeof value === \"object\" && !Array.isArray(value)) {\n      for (const [nested, nv] of Object.entries(value as Record<string, unknown>)) {\n        if (nv != null) out[`${key}[${nested}]`] = String(nv);\n      }\n    } else if (Array.isArray(value)) {\n      out[key] = value.join(\",\");\n    } else {\n      out[key] = String(value);\n    }\n  }\n\n  return out;\n}\n","import axios, { type AxiosInstance, type AxiosRequestConfig } from \"axios\";\nimport type {\n  ResourceDefinition,\n  InferResource,\n  JsonApiDocument,\n  JsonApiCollectionDocument,\n} from \"@leodamours/jsonapi-dsl\";\nimport type { ClientConfig, QueryParams, CreatePayload, UpdatePayload } from \"./types\";\nimport { serializeCreatePayload, serializeUpdatePayload, serializeQueryParams } from \"./serialize\";\n\nexport class JsonApiClient {\n  private axios: AxiosInstance;\n\n  constructor(config: ClientConfig) {\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/vnd.api+json\",\n      Accept: \"application/vnd.api+json\",\n      ...config.headers,\n    };\n\n    if (config.jwtToken) {\n      headers.Authorization = `Bearer ${config.jwtToken}`;\n    }\n\n    this.axios = axios.create({\n      baseURL: config.baseURL,\n      headers,\n      timeout: config.timeout,\n    });\n  }\n\n  /**\n   * POST /{resourceType}\n   */\n  async create<Def extends ResourceDefinition>(\n    definition: Def,\n    payload: CreatePayload<Def>,\n    options?: AxiosRequestConfig,\n  ): Promise<JsonApiDocument<InferResource<Def>>> {\n    const body = serializeCreatePayload(definition, payload as any);\n    const res = await this.axios.post(`/${definition.resourceType}`, body, options);\n    return res.data;\n  }\n\n  /**\n   * GET /{resourceType}/{id}\n   */\n  async findOne<Def extends ResourceDefinition>(\n    definition: Def,\n    id: string,\n    params?: QueryParams,\n    options?: AxiosRequestConfig,\n  ): Promise<JsonApiDocument<InferResource<Def>>> {\n    const res = await this.axios.get(`/${definition.resourceType}/${id}`, {\n      params: params ? serializeQueryParams(params) : undefined,\n      ...options,\n    });\n    return res.data;\n  }\n\n  /**\n   * GET /{resourceType}\n   */\n  async findAll<Def extends ResourceDefinition>(\n    definition: Def,\n    params?: QueryParams,\n    options?: AxiosRequestConfig,\n  ): Promise<JsonApiCollectionDocument<InferResource<Def>>> {\n    const res = await this.axios.get(`/${definition.resourceType}`, {\n      params: params ? serializeQueryParams(params) : undefined,\n      ...options,\n    });\n    return res.data;\n  }\n\n  /**\n   * PATCH /{resourceType}/{id}\n   */\n  async update<Def extends ResourceDefinition>(\n    definition: Def,\n    id: string,\n    payload: UpdatePayload<Def>,\n    options?: AxiosRequestConfig,\n  ): Promise<JsonApiDocument<InferResource<Def>>> {\n    const body = serializeUpdatePayload(definition, id, payload as any);\n    const res = await this.axios.patch(`/${definition.resourceType}/${id}`, body, options);\n    return res.data;\n  }\n\n  /**\n   * DELETE /{resourceType}/{id}\n   */\n  async remove(\n    definition: ResourceDefinition,\n    id: string,\n    options?: AxiosRequestConfig,\n  ): Promise<void> {\n    await this.axios.delete(`/${definition.resourceType}/${id}`, options);\n  }\n\n  /**\n   * Update client configuration at runtime.\n   */\n  updateConfig(config: Partial<ClientConfig>): void {\n    if (config.baseURL) {\n      this.axios.defaults.baseURL = config.baseURL;\n    }\n    if (config.headers) {\n      Object.assign(this.axios.defaults.headers.common, config.headers);\n    }\n    if (config.jwtToken) {\n      this.axios.defaults.headers.common.Authorization = `Bearer ${config.jwtToken}`;\n    } else if (config.jwtToken === null) {\n      delete this.axios.defaults.headers.common.Authorization;\n    }\n  }\n\n  /**\n   * Access the underlying Axios instance for advanced use.\n   */\n  getAxiosInstance(): AxiosInstance {\n    return this.axios;\n  }\n}\n\nexport function createClient(config: ClientConfig): JsonApiClient {\n  return new JsonApiClient(config);\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,150 @@
+import axios from 'axios';
+
+// src/client.ts
+
+// src/serialize.ts
+function serializeRelationships(simplified, definition) {
+  if (!simplified) return void 0;
+  const result = {};
+  let hasKeys = false;
+  for (const key of Object.keys(simplified)) {
+    const value = simplified[key];
+    if (value === void 0) continue;
+    const relDef = definition.relationships[key];
+    if (!relDef) continue;
+    hasKeys = true;
+    if (relDef._rel === "one") {
+      result[key] = { data: value };
+    } else {
+      result[key] = { data: value };
+    }
+  }
+  return hasKeys ? result : void 0;
+}
+function serializeCreatePayload(definition, payload) {
+  const data = {
+    type: definition.resourceType,
+    attributes: payload.attributes
+  };
+  const rels = serializeRelationships(payload.relationships, definition);
+  if (rels) data.relationships = rels;
+  return { data };
+}
+function serializeUpdatePayload(definition, id, payload) {
+  const data = {
+    type: definition.resourceType,
+    id
+  };
+  if (payload.attributes && Object.keys(payload.attributes).length > 0) {
+    data.attributes = payload.attributes;
+  }
+  const rels = serializeRelationships(payload.relationships, definition);
+  if (rels) data.relationships = rels;
+  return { data };
+}
+function serializeQueryParams(params) {
+  const out = {};
+  for (const [key, value] of Object.entries(params)) {
+    if (value == null) continue;
+    if (typeof value === "object" && !Array.isArray(value)) {
+      for (const [nested, nv] of Object.entries(value)) {
+        if (nv != null) out[`${key}[${nested}]`] = String(nv);
+      }
+    } else if (Array.isArray(value)) {
+      out[key] = value.join(",");
+    } else {
+      out[key] = String(value);
+    }
+  }
+  return out;
+}
+
+// src/client.ts
+var JsonApiClient = class {
+  constructor(config) {
+    const headers = {
+      "Content-Type": "application/vnd.api+json",
+      Accept: "application/vnd.api+json",
+      ...config.headers
+    };
+    if (config.jwtToken) {
+      headers.Authorization = `Bearer ${config.jwtToken}`;
+    }
+    this.axios = axios.create({
+      baseURL: config.baseURL,
+      headers,
+      timeout: config.timeout
+    });
+  }
+  /**
+   * POST /{resourceType}
+   */
+  async create(definition, payload, options) {
+    const body = serializeCreatePayload(definition, payload);
+    const res = await this.axios.post(`/${definition.resourceType}`, body, options);
+    return res.data;
+  }
+  /**
+   * GET /{resourceType}/{id}
+   */
+  async findOne(definition, id, params, options) {
+    const res = await this.axios.get(`/${definition.resourceType}/${id}`, {
+      params: params ? serializeQueryParams(params) : void 0,
+      ...options
+    });
+    return res.data;
+  }
+  /**
+   * GET /{resourceType}
+   */
+  async findAll(definition, params, options) {
+    const res = await this.axios.get(`/${definition.resourceType}`, {
+      params: params ? serializeQueryParams(params) : void 0,
+      ...options
+    });
+    return res.data;
+  }
+  /**
+   * PATCH /{resourceType}/{id}
+   */
+  async update(definition, id, payload, options) {
+    const body = serializeUpdatePayload(definition, id, payload);
+    const res = await this.axios.patch(`/${definition.resourceType}/${id}`, body, options);
+    return res.data;
+  }
+  /**
+   * DELETE /{resourceType}/{id}
+   */
+  async remove(definition, id, options) {
+    await this.axios.delete(`/${definition.resourceType}/${id}`, options);
+  }
+  /**
+   * Update client configuration at runtime.
+   */
+  updateConfig(config) {
+    if (config.baseURL) {
+      this.axios.defaults.baseURL = config.baseURL;
+    }
+    if (config.headers) {
+      Object.assign(this.axios.defaults.headers.common, config.headers);
+    }
+    if (config.jwtToken) {
+      this.axios.defaults.headers.common.Authorization = `Bearer ${config.jwtToken}`;
+    } else if (config.jwtToken === null) {
+      delete this.axios.defaults.headers.common.Authorization;
+    }
+  }
+  /**
+   * Access the underlying Axios instance for advanced use.
+   */
+  getAxiosInstance() {
+    return this.axios;
+  }
+};
+function createClient(config) {
+  return new JsonApiClient(config);
+}
+
+export { JsonApiClient, createClient, serializeCreatePayload, serializeQueryParams, serializeRelationships, serializeUpdatePayload };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/serialize.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { ResourceDefinition, JsonApiRelationships } from \"@leodamours/jsonapi-dsl\";\n\n/**\n * Wrap simplified relationship values in `{ data: ... }` per JSON:API spec.\n */\nexport function serializeRelationships(\n  simplified: Record<string, unknown> | undefined,\n  definition: ResourceDefinition,\n): JsonApiRelationships | undefined {\n  if (!simplified) return undefined;\n\n  const result: JsonApiRelationships = {};\n  let hasKeys = false;\n\n  for (const key of Object.keys(simplified)) {\n    const value = simplified[key];\n    if (value === undefined) continue;\n\n    const relDef = definition.relationships[key];\n    if (!relDef) continue;\n\n    hasKeys = true;\n\n    if (relDef._rel === \"one\") {\n      result[key] = { data: value as { type: string; id: string } | null };\n    } else {\n      result[key] = { data: value as { type: string; id: string }[] };\n    }\n  }\n\n  return hasKeys ? result : undefined;\n}\n\n/**\n * Build a JSON:API request body for creating a resource.\n */\nexport function serializeCreatePayload(\n  definition: ResourceDefinition,\n  payload: { attributes: Record<string, unknown>; relationships?: Record<string, unknown> },\n): { data: Record<string, unknown> } {\n  const data: Record<string, unknown> = {\n    type: definition.resourceType,\n    attributes: payload.attributes,\n  };\n\n  const rels = serializeRelationships(payload.relationships, definition);\n  if (rels) data.relationships = rels;\n\n  return { data };\n}\n\n/**\n * Build a JSON:API request body for updating a resource.\n */\nexport function serializeUpdatePayload(\n  definition: ResourceDefinition,\n  id: string,\n  payload: { attributes?: Record<string, unknown>; relationships?: Record<string, unknown> },\n): { data: Record<string, unknown> } {\n  const data: Record<string, unknown> = {\n    type: definition.resourceType,\n    id,\n  };\n\n  if (payload.attributes && Object.keys(payload.attributes).length > 0) {\n    data.attributes = payload.attributes;\n  }\n\n  const rels = serializeRelationships(payload.relationships, definition);\n  if (rels) data.relationships = rels;\n\n  return { data };\n}\n\n/**\n * Encode query params using JSON:API bracket conventions.\n *\n * `{ page: { size: 10 } }` → `\"page[size]=10\"`\n * `{ sort: [\"-createdAt\", \"title\"] }` → `\"sort=-createdAt,title\"`\n */\nexport function serializeQueryParams(params: Record<string, unknown>): Record<string, string> {\n  const out: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value == null) continue;\n\n    if (typeof value === \"object\" && !Array.isArray(value)) {\n      for (const [nested, nv] of Object.entries(value as Record<string, unknown>)) {\n        if (nv != null) out[`${key}[${nested}]`] = String(nv);\n      }\n    } else if (Array.isArray(value)) {\n      out[key] = value.join(\",\");\n    } else {\n      out[key] = String(value);\n    }\n  }\n\n  return out;\n}\n","import axios, { type AxiosInstance, type AxiosRequestConfig } from \"axios\";\nimport type {\n  ResourceDefinition,\n  InferResource,\n  JsonApiDocument,\n  JsonApiCollectionDocument,\n} from \"@leodamours/jsonapi-dsl\";\nimport type { ClientConfig, QueryParams, CreatePayload, UpdatePayload } from \"./types\";\nimport { serializeCreatePayload, serializeUpdatePayload, serializeQueryParams } from \"./serialize\";\n\nexport class JsonApiClient {\n  private axios: AxiosInstance;\n\n  constructor(config: ClientConfig) {\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/vnd.api+json\",\n      Accept: \"application/vnd.api+json\",\n      ...config.headers,\n    };\n\n    if (config.jwtToken) {\n      headers.Authorization = `Bearer ${config.jwtToken}`;\n    }\n\n    this.axios = axios.create({\n      baseURL: config.baseURL,\n      headers,\n      timeout: config.timeout,\n    });\n  }\n\n  /**\n   * POST /{resourceType}\n   */\n  async create<Def extends ResourceDefinition>(\n    definition: Def,\n    payload: CreatePayload<Def>,\n    options?: AxiosRequestConfig,\n  ): Promise<JsonApiDocument<InferResource<Def>>> {\n    const body = serializeCreatePayload(definition, payload as any);\n    const res = await this.axios.post(`/${definition.resourceType}`, body, options);\n    return res.data;\n  }\n\n  /**\n   * GET /{resourceType}/{id}\n   */\n  async findOne<Def extends ResourceDefinition>(\n    definition: Def,\n    id: string,\n    params?: QueryParams,\n    options?: AxiosRequestConfig,\n  ): Promise<JsonApiDocument<InferResource<Def>>> {\n    const res = await this.axios.get(`/${definition.resourceType}/${id}`, {\n      params: params ? serializeQueryParams(params) : undefined,\n      ...options,\n    });\n    return res.data;\n  }\n\n  /**\n   * GET /{resourceType}\n   */\n  async findAll<Def extends ResourceDefinition>(\n    definition: Def,\n    params?: QueryParams,\n    options?: AxiosRequestConfig,\n  ): Promise<JsonApiCollectionDocument<InferResource<Def>>> {\n    const res = await this.axios.get(`/${definition.resourceType}`, {\n      params: params ? serializeQueryParams(params) : undefined,\n      ...options,\n    });\n    return res.data;\n  }\n\n  /**\n   * PATCH /{resourceType}/{id}\n   */\n  async update<Def extends ResourceDefinition>(\n    definition: Def,\n    id: string,\n    payload: UpdatePayload<Def>,\n    options?: AxiosRequestConfig,\n  ): Promise<JsonApiDocument<InferResource<Def>>> {\n    const body = serializeUpdatePayload(definition, id, payload as any);\n    const res = await this.axios.patch(`/${definition.resourceType}/${id}`, body, options);\n    return res.data;\n  }\n\n  /**\n   * DELETE /{resourceType}/{id}\n   */\n  async remove(\n    definition: ResourceDefinition,\n    id: string,\n    options?: AxiosRequestConfig,\n  ): Promise<void> {\n    await this.axios.delete(`/${definition.resourceType}/${id}`, options);\n  }\n\n  /**\n   * Update client configuration at runtime.\n   */\n  updateConfig(config: Partial<ClientConfig>): void {\n    if (config.baseURL) {\n      this.axios.defaults.baseURL = config.baseURL;\n    }\n    if (config.headers) {\n      Object.assign(this.axios.defaults.headers.common, config.headers);\n    }\n    if (config.jwtToken) {\n      this.axios.defaults.headers.common.Authorization = `Bearer ${config.jwtToken}`;\n    } else if (config.jwtToken === null) {\n      delete this.axios.defaults.headers.common.Authorization;\n    }\n  }\n\n  /**\n   * Access the underlying Axios instance for advanced use.\n   */\n  getAxiosInstance(): AxiosInstance {\n    return this.axios;\n  }\n}\n\nexport function createClient(config: ClientConfig): JsonApiClient {\n  return new JsonApiClient(config);\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@leodamours/jsonapi-client",
+  "version": "1.0.2",
+  "description": "A typed HTTP client for JSON:API — powered by Axios with full type inference",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "jsonapi",
+    "json:api",
+    "typescript",
+    "http-client",
+    "axios",
+    "type-safe"
+  ],
+  "author": "Leo Damours",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LeoDamours/json-api-client.git",
+    "directory": "packages/client"
+  },
+  "homepage": "https://github.com/LeoDamours/json-api-client/tree/main/packages/client",
+  "bugs": "https://github.com/LeoDamours/json-api-client/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@leodamours/jsonapi-dsl": "^1.0.0",
+    "axios": "^1.0.0"
+  },
+  "devDependencies": {
+    "@leodamours/jsonapi-dsl": "^1.0.0",
+    "axios": "^1.7.0",
+    "typescript": "^5.4.0",
+    "tsup": "^8.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "LICENSE"
+  ]
+}