@simplix-react/contract 0.0.1 → 0.0.3

package/dist/index.js

@@ -2,7 +2,7 @@
 function buildPath(template, params = {}) {
   let result = template;
   for (const [key, value] of Object.entries(params)) {
-    result = result.replace(`:${key}`, encodeURIComponent(value));
+    result = result.replaceAll(`:${key}`, encodeURIComponent(value));
   }
   return result;
 }
@@ -17,12 +17,15 @@ var ApiError = class extends Error {
   }
 };
 async function defaultFetch(path, options) {
+  const method = options?.method?.toUpperCase();
+  const hasBody = method === "POST" || method === "PUT" || method === "PATCH";
+  const headers = {
+    ...hasBody ? { "Content-Type": "application/json" } : {},
+    ...options?.headers
+  };
   const res = await fetch(path, {
     ...options,
-    headers: {
-      "Content-Type": "application/json",
-      ...options?.headers
-    }
+    headers
   });
   if (!res.ok) {
     throw new ApiError(res.status, await res.text());
@@ -36,10 +39,10 @@ async function defaultFetch(path, options) {
 
 // src/derive/client.ts
 function deriveClient(config, fetchFn = defaultFetch) {
-  const { basePath, entities, operations } = config;
+  const { basePath, entities, operations, queryBuilder } = config;
   const result = {};
   for (const [name, entity] of Object.entries(entities)) {
-    result[name] = createEntityClient(basePath, entity, fetchFn);
+    result[name] = createEntityClient(basePath, entity, fetchFn, queryBuilder);
   }
   if (operations) {
     for (const [name, operation] of Object.entries(operations)) {
@@ -48,11 +51,24 @@ function deriveClient(config, fetchFn = defaultFetch) {
   }
   return result;
 }
-function createEntityClient(basePath, entity, fetchFn) {
+function createEntityClient(basePath, entity, fetchFn, queryBuilder) {
   const { path, parent } = entity;
   return {
-    list(parentId) {
-      const url = parent && parentId ? `${basePath}${parent.path}/${parentId}${path}` : `${basePath}${path}`;
+    list(parentIdOrParams, params) {
+      let parentId;
+      let listParams;
+      if (typeof parentIdOrParams === "string") {
+        parentId = parentIdOrParams;
+        listParams = params;
+      } else {
+        listParams = parentIdOrParams;
+      }
+      let url = parent && parentId ? `${basePath}${parent.path}/${parentId}${path}` : `${basePath}${path}`;
+      if (listParams && queryBuilder) {
+        const sp = queryBuilder.buildSearchParams(listParams);
+        const qs = sp.toString();
+        if (qs) url += `?${qs}`;
+      }
       return fetchFn(url);
     },
     get(id) {
@@ -101,6 +117,12 @@ function createOperationClient(basePath, operation, fetchFn) {
       inputData = args[argIndex];
     }
     const url = `${basePath}${buildPath(operation.path, pathParams)}`;
+    if (operation.contentType === "multipart" && inputData !== void 0) {
+      return multipartFetch(url, operation.method, toFormData(inputData), operation.responseType);
+    }
+    if (operation.responseType === "blob") {
+      return blobFetch(url, operation.method, inputData);
+    }
     const options = { method: operation.method };
     if (inputData !== void 0 && operation.method !== "GET") {
       options.body = JSON.stringify(inputData);
@@ -108,6 +130,42 @@ function createOperationClient(basePath, operation, fetchFn) {
     return fetchFn(url, options);
   };
 }
+function toFormData(data) {
+  const formData = new FormData();
+  if (data && typeof data === "object") {
+    for (const [key, value] of Object.entries(data)) {
+      if (value instanceof File || value instanceof Blob) {
+        formData.append(key, value);
+      } else if (value !== void 0 && value !== null) {
+        formData.append(key, String(value));
+      }
+    }
+  }
+  return formData;
+}
+async function multipartFetch(url, method, formData, responseType) {
+  const res = await fetch(url, { method, body: formData });
+  if (!res.ok) {
+    throw new ApiError(res.status, await res.text());
+  }
+  if (responseType === "blob") {
+    return res.blob();
+  }
+  const json = await res.json();
+  return json.data !== void 0 ? json.data : json;
+}
+async function blobFetch(url, method, inputData) {
+  const options = { method };
+  if (inputData !== void 0 && method !== "GET") {
+    options.body = JSON.stringify(inputData);
+    options.headers = { "Content-Type": "application/json" };
+  }
+  const res = await fetch(url, options);
+  if (!res.ok) {
+    throw new ApiError(res.status, await res.text());
+  }
+  return res.blob();
+}
 
 // src/derive/query-keys.ts
 function deriveQueryKeys(config) {
@@ -142,7 +200,36 @@ function camelToKebab(str) {
   return str.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
 }
 function camelToSnake(str) {
-  return str.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase();
+  return str.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[-\s]+/g, "_").toLowerCase();
 }
 
-export { ApiError, buildPath, camelToKebab, camelToSnake, defaultFetch, defineApi, deriveClient, deriveQueryKeys };
+// src/helpers/query-builders.ts
+var simpleQueryBuilder = {
+  buildSearchParams(params) {
+    const sp = new URLSearchParams();
+    if (params.filters) {
+      for (const [k, v] of Object.entries(params.filters)) {
+        if (v !== void 0 && v !== null) sp.set(k, String(v));
+      }
+    }
+    if (params.sort) {
+      const sorts = Array.isArray(params.sort) ? params.sort : [params.sort];
+      sp.set(
+        "sort",
+        sorts.map((s) => `${s.field}:${s.direction}`).join(",")
+      );
+    }
+    if (params.pagination) {
+      if (params.pagination.type === "offset") {
+        sp.set("page", String(params.pagination.page));
+        sp.set("limit", String(params.pagination.limit));
+      } else {
+        sp.set("cursor", params.pagination.cursor);
+        sp.set("limit", String(params.pagination.limit));
+      }
+    }
+    return sp;
+  }
+};
+
+export { ApiError, buildPath, camelToKebab, camelToSnake, defaultFetch, defineApi, deriveClient, deriveQueryKeys, simpleQueryBuilder };

package/package.json

@@ -1,40 +1,39 @@
 {
   "name": "@simplix-react/contract",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Define type-safe API contracts with Zod schemas",
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    },
-    "./openapi": {
-      "types": "./dist/openapi.d.ts",
-      "import": "./dist/openapi.js"
-    },
-    "./mcp": {
-      "types": "./dist/mcp-tools.d.ts",
-      "import": "./dist/mcp-tools.js"
     }
   },
-  "files": ["dist"],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src",
-    "test": "vitest run --passWithNoTests",
-    "clean": "rm -rf dist .turbo"
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
   },
   "peerDependencies": {
     "zod": ">=4.0.0"
   },
   "devDependencies": {
-    "@simplix-react/config-typescript": "workspace:*",
     "eslint": "^9.39.2",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^3.0.0",
-    "zod": "^4.0.0"
+    "zod": "^4.0.0",
+    "@simplix-react/config-eslint": "0.0.1",
+    "@simplix-react/config-typescript": "0.0.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist .turbo"
   }
-}
+}

package/dist/mcp-tools.d.ts

@@ -1,14 +0,0 @@
-import { E as EntityDefinition, O as OperationDefinition, A as ApiContractConfig } from './types-tFXBXgJP.js';
-import 'zod';
-
-interface MCPToolDefinition {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-}
-/**
- * Derive MCP tool definitions from contract config.
- */
-declare function deriveMCPTools<TEntities extends Record<string, EntityDefinition<any, any, any>>, TOperations extends Record<string, OperationDefinition<any, any>>>(config: ApiContractConfig<TEntities, TOperations>): MCPToolDefinition[];
-
-export { type MCPToolDefinition, deriveMCPTools };

package/dist/mcp-tools.js

@@ -1,62 +0,0 @@
-// src/derive/mcp-tools.ts
-function deriveMCPTools(config) {
-  const tools = [];
-  for (const [name, entity] of Object.entries(config.entities)) {
-    const capitalName = name.charAt(0).toUpperCase() + name.slice(1);
-    tools.push(
-      {
-        name: `list${capitalName}s`,
-        description: `List all ${name} entities`,
-        inputSchema: entity.parent ? {
-          type: "object",
-          properties: { [entity.parent.param]: { type: "string" } },
-          required: [entity.parent.param]
-        } : { type: "object", properties: {} }
-      },
-      {
-        name: `get${capitalName}`,
-        description: `Get a single ${name} by ID`,
-        inputSchema: {
-          type: "object",
-          properties: { id: { type: "string" } },
-          required: ["id"]
-        }
-      },
-      {
-        name: `create${capitalName}`,
-        description: `Create a new ${name}`,
-        inputSchema: { type: "object", properties: {} }
-      },
-      {
-        name: `update${capitalName}`,
-        description: `Update an existing ${name}`,
-        inputSchema: {
-          type: "object",
-          properties: { id: { type: "string" } },
-          required: ["id"]
-        }
-      },
-      {
-        name: `delete${capitalName}`,
-        description: `Delete a ${name}`,
-        inputSchema: {
-          type: "object",
-          properties: { id: { type: "string" } },
-          required: ["id"]
-        }
-      }
-    );
-  }
-  if (config.operations) {
-    for (const [name, op] of Object.entries(config.operations)) {
-      tools.push({
-        name,
-        description: `${op.method} ${op.path}`,
-        inputSchema: { type: "object", properties: {} }
-      });
-    }
-  }
-  return tools;
-}
-
-export { deriveMCPTools };

package/dist/openapi.d.ts

@@ -1,21 +0,0 @@
-import { E as EntityDefinition, O as OperationDefinition, A as ApiContractConfig } from './types-tFXBXgJP.js';
-import 'zod';
-
-interface OpenAPISpec {
-    openapi: "3.1.0";
-    info: {
-        title: string;
-        version: string;
-    };
-    paths: Record<string, unknown>;
-}
-/**
- * Derive OpenAPI 3.1 specification from contract config.
- * Full implementation requires zod-to-json-schema.
- */
-declare function deriveOpenAPI<TEntities extends Record<string, EntityDefinition<any, any, any>>, TOperations extends Record<string, OperationDefinition<any, any>>>(config: ApiContractConfig<TEntities, TOperations>, options?: {
-    title?: string;
-    version?: string;
-}): OpenAPISpec;
-
-export { type OpenAPISpec, deriveOpenAPI };

package/dist/openapi.js

@@ -1,54 +0,0 @@
-// src/derive/openapi.ts
-function deriveOpenAPI(config, options) {
-  const title = options?.title ?? config.domain;
-  const version = options?.version ?? "0.1.0";
-  const paths = {};
-  for (const [name, entity] of Object.entries(config.entities)) {
-    const entityPath = entity.parent ? `${config.basePath}${entity.parent.path}/{${entity.parent.param}}${entity.path}` : `${config.basePath}${entity.path}`;
-    const capitalName = name.charAt(0).toUpperCase() + name.slice(1);
-    paths[entityPath] = {
-      get: {
-        summary: `List ${name}`,
-        operationId: `list${capitalName}`,
-        responses: { "200": { description: "Success" } }
-      },
-      post: {
-        summary: `Create ${name}`,
-        operationId: `create${capitalName}`,
-        responses: { "201": { description: "Created" } }
-      }
-    };
-    paths[`${config.basePath}${entity.path}/{id}`] = {
-      get: {
-        summary: `Get ${name}`,
-        operationId: `get${capitalName}`,
-        responses: { "200": { description: "Success" } }
-      },
-      patch: {
-        summary: `Update ${name}`,
-        operationId: `update${capitalName}`,
-        responses: { "200": { description: "Success" } }
-      },
-      delete: {
-        summary: `Delete ${name}`,
-        operationId: `delete${capitalName}`,
-        responses: { "204": { description: "Deleted" } }
-      }
-    };
-  }
-  if (config.operations) {
-    for (const [name, op] of Object.entries(config.operations)) {
-      const opPath = `${config.basePath}${op.path}`;
-      paths[opPath] = {
-        [op.method.toLowerCase()]: {
-          summary: name,
-          operationId: name,
-          responses: { "200": { description: "Success" } }
-        }
-      };
-    }
-  }
-  return { openapi: "3.1.0", info: { title, version }, paths };
-}
-
-export { deriveOpenAPI };

package/dist/types-tFXBXgJP.d.ts

@@ -1,41 +0,0 @@
-import { z } from 'zod';
-
-interface EntityParent {
-    param: string;
-    path: string;
-}
-interface EntityQuery {
-    parent: string;
-    param: string;
-}
-interface EntityDefinition<TSchema extends z.ZodType = z.ZodType, TCreate extends z.ZodType = z.ZodType, TUpdate extends z.ZodType = z.ZodType> {
-    path: string;
-    schema: TSchema;
-    createSchema: TCreate;
-    updateSchema: TUpdate;
-    parent?: EntityParent;
-    queries?: Record<string, EntityQuery>;
-}
-type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-interface OperationDefinition<TInput extends z.ZodType = z.ZodType, TOutput extends z.ZodType = z.ZodType> {
-    method: HttpMethod;
-    path: string;
-    input: TInput;
-    output: TOutput;
-    invalidates?: (queryKeys: Record<string, QueryKeyFactory>, params: Record<string, string>) => readonly unknown[][];
-}
-interface ApiContractConfig<TEntities extends Record<string, EntityDefinition<any, any, any>> = Record<string, EntityDefinition>, TOperations extends Record<string, OperationDefinition<any, any>> = Record<string, OperationDefinition>> {
-    domain: string;
-    basePath: string;
-    entities: TEntities;
-    operations?: TOperations;
-}
-interface QueryKeyFactory {
-    all: readonly unknown[];
-    lists: () => readonly unknown[];
-    list: (params: Record<string, unknown>) => readonly unknown[];
-    details: () => readonly unknown[];
-    detail: (id: string) => readonly unknown[];
-}
-
-export type { ApiContractConfig as A, EntityDefinition as E, OperationDefinition as O };