typedapi-client-helpers 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,167 @@
+# typedapi-client-helpers
+
+Reusable TypeScript helpers for generated typed OpenAPI clients.
+
+## What this package includes
+
+* `typedapi-generate` CLI command
+* OpenAPI TypeScript client generation
+* Typed API wrapper methods
+* Typed query and pagination helpers
+* `ApiResult<T>` response wrapper
+* Toast helpers using `react-toastify`
+* `TypedApiToastProvider`
+* `buildQuery` helper for filters, paging, and sorting
+* `toFormData` helper for file uploads
+* Unauthorized handling for `401` responses
+* Sort direction conversion helpers
+
+## Installation
+
+```bash
+npm install typedapi-client-helpers
+```
+
+This package expects React to already be installed:
+
+```bash
+npm install react react-dom react-toastify
+```
+
+## Generate API files
+
+Add a script to your project:
+
+```json
+{
+  "scripts": {
+    "generate:api": "typedapi-generate"
+  }
+}
+```
+
+Run:
+
+```bash
+npm run generate:api
+```
+
+By default, the generator reads Swagger from:
+
+```text
+https://localhost:7000/swagger/v1/swagger.json
+```
+
+and writes generated files to:
+
+```text
+src/api
+```
+
+## Configuration
+
+Configure the generator in your `package.json`:
+
+```json
+{
+  "config": {
+    "swaggerUrl": "https://localhost:7000/swagger/v1/swagger.json",
+    "swaggerFile": "./swagger.json",
+    "apiOutput": "src/api",
+    "typedApiUseTypeOnlyImports": true,
+    "typedApiUseFilterFormValues": false
+  }
+}
+```
+
+### Available Settings
+
+| Setting                       | Description                                                      | Default                                          |
+| ----------------------------- | ---------------------------------------------------------------- | ------------------------------------------------ |
+| `swaggerUrl`                  | URL to the Swagger/OpenAPI document                              | `https://localhost:7000/swagger/v1/swagger.json` |
+| `swaggerFile`                 | Local Swagger/OpenAPI file. Overrides `swaggerUrl` when provided | Not set                                          |
+| `apiOutput`                   | Output directory for generated files                             | `src/api`                                        |
+| `typedApiUseTypeOnlyImports`  | Uses `import type` statements when possible                      | `false`                                          |
+| `typedApiUseFilterFormValues` | Generates pagination methods using `FilterFormValues[]`          | `false`                                          |
+
+### Environment Variables
+
+```bash
+SWAGGER_URL=https://localhost:7000/swagger/v1/swagger.json npm run generate:api
+SWAGGER_FILE=./swagger.json npm run generate:api
+API_OUTPUT=src/api npm run generate:api
+TYPED_API_USE_TYPE_ONLY_IMPORTS=true npm run generate:api
+TYPED_API_USE_FILTER_FORM_VALUES=true npm run generate:api
+```
+
+## Usage
+
+Import generated API functions:
+
+```ts
+import { getProducts } from "./api";
+
+const result = await getProducts();
+
+if (result.ok) {
+    console.log(result.response);
+}
+```
+
+### Toast Notifications
+
+```ts
+await createProduct(product, {
+    toastSuccess: {
+        title: "Saved",
+        message: "Product created successfully."
+    },
+    toastError: {
+        title: "Error",
+        message: "Unable to create product."
+    }
+});
+```
+
+Add the provider once in your application:
+
+```tsx
+import { TypedApiToastProvider } from "typedapi-client-helpers";
+
+function App() {
+    return (
+        <>
+            <TypedApiToastProvider />
+            {/* application */}
+        </>
+    );
+}
+```
+
+### File Uploads
+
+```ts
+import { toFormData } from "typedapi-client-helpers";
+
+const formData = toFormData({
+    file,
+    description: "Import file"
+});
+```
+
+## Recommended Project Setup
+
+```text
+src/
+├── api/
+│   ├── clients/
+│   ├── models/
+│   └── index.ts
+├── pages/
+├── components/
+└── services/
+```
+
+## Notes
+
+Generated files should not be manually modified. Regenerate them whenever the backend OpenAPI specification changes.

package/dist/index.d.cts

@@ -40,10 +40,7 @@ type ExtractDataIfPaginated<T> = T extends {
     data?: (infer U)[] | null;
 } ? U : T;
 type SortableKeys<T> = keyof UnwrapArray<ExtractDataIfPaginated<T>>;
-type WithoutRequestParams<T extends any[]> = T extends [
-    infer First,
-    ...infer Rest
-] ? First extends RequestParams ? Rest : [First, ...WithoutRequestParams<Rest>] : [];
+type WithoutRequestParams<T extends any[]> = T extends [infer First, ...infer Rest] ? First extends RequestParams ? Rest : [First, ...WithoutRequestParams<Rest>] : [];
 
 /**
  * Standard result wrapper for API calls.

package/dist/index.d.ts

@@ -40,10 +40,7 @@ type ExtractDataIfPaginated<T> = T extends {
     data?: (infer U)[] | null;
 } ? U : T;
 type SortableKeys<T> = keyof UnwrapArray<ExtractDataIfPaginated<T>>;
-type WithoutRequestParams<T extends any[]> = T extends [
-    infer First,
-    ...infer Rest
-] ? First extends RequestParams ? Rest : [First, ...WithoutRequestParams<Rest>] : [];
+type WithoutRequestParams<T extends any[]> = T extends [infer First, ...infer Rest] ? First extends RequestParams ? Rest : [First, ...WithoutRequestParams<Rest>] : [];
 
 /**
  * Standard result wrapper for API calls.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typedapi-client-helpers",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Reusable typed OpenAPI client helpers.",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,6 +12,7 @@
     "README.md"
   ],
   "config": {
+    "swaggerFile": "swagger/TestSwagger.json",
     "apiOutput": "src/api"
   },
   "bin": {
@@ -19,11 +20,9 @@
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",
-    "generate:api": "node ./scripts/generate-api-minimal.mjs",
-    "pack:local": "npm pack"
+    "generate:api": "node ./scripts/generate-api-minimal.mjs"
   },
   "dependencies": {
-    "prettier": "^3.8.3",
     "react-toastify": "^11.0.5",
     "swagger-typescript-api": "^13.2.16"
   },

package/scripts/generate-api-minimal.mjs

@@ -1,7 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import prettier from "prettier";
 import { generateApi } from "swagger-typescript-api";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -85,11 +84,7 @@ function cleanDirectory(directory) {
 }
 
 async function writeFormattedFile(filePath, content) {
-  const formatted = await prettier.format(content, {
-    parser: "typescript",
-  });
-
-  fs.writeFileSync(filePath, formatted);
+  fs.writeFileSync(filePath, content);
 }
 
 async function generateOpenApiClient() {