api-core-lib 16.2.0 → 16.12.133

package/dist/server.cjs

@@ -0,0 +1,56 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkJAMEOM7Tcjs = require('./chunk-JAMEOM7T.cjs');
+
+// src/server.ts
+function createServerApi(apiClient, moduleConfig) {
+  return {
+    /**
+     * Prefetches data for a specific action on the server and populates the cache.
+     */
+    prefetch: async (actionName, input, options = {}) => {
+      const actionConfig = moduleConfig.actions[actionName];
+      if (!actionConfig) {
+        throw new Error(`Action "${actionName}" not found in module.`);
+      }
+      const result = await _chunkJAMEOM7Tcjs.callDynamicApi.call(void 0, apiClient, moduleConfig.baseEndpoint, actionConfig, {
+        pathParams: options.pathParams,
+        body: input
+      });
+      const cacheKey = _chunkJAMEOM7Tcjs.generateCacheKey.call(void 0, moduleConfig.baseEndpoint, actionName, input, { pathParams: options.pathParams });
+      if (result.success) {
+        _chunkJAMEOM7Tcjs.globalStateManager.setState(cacheKey, () => ({
+          data: result.data,
+          error: null,
+          loading: false,
+          success: true,
+          called: true,
+          isStale: false,
+          rawResponse: result.rawResponse
+        }));
+      } else {
+        _chunkJAMEOM7Tcjs.globalStateManager.setState(cacheKey, () => ({
+          data: null,
+          error: result.error,
+          loading: false,
+          success: false,
+          called: true,
+          isStale: true,
+          rawResponse: result.rawResponse
+        }));
+      }
+      return result.data;
+    },
+    /**
+     * Dehydrates the current state in the global manager into a JSON string.
+     */
+    dehydrate: () => {
+      return _chunkJAMEOM7Tcjs.globalStateManager.dehydrate();
+    }
+  };
+}
+
+
+exports.createServerApi = createServerApi;

package/dist/server.d.cts

@@ -0,0 +1,25 @@
+import { AxiosInstance } from 'axios';
+import { f as ActionConfigModule, A as ApiModuleConfig, I as InputOf } from './apiModule.types-DEskFzOY.cjs';
+import 'react';
+
+/**
+ * Creates a server-safe interface for pre-fetching data and dehydrating state.
+ * Use this in your React Server Components to prepare data for the client.
+ * @param apiClient A configured Axios instance.
+ * @param moduleConfig The configuration for the module you want to use.
+ * @returns An object with `prefetch` and `dehydrate` methods.
+ */
+declare function createServerApi<TActions extends Record<string, ActionConfigModule<any, any>>>(apiClient: AxiosInstance, moduleConfig: ApiModuleConfig<TActions>): {
+    /**
+     * Prefetches data for a specific action on the server and populates the cache.
+     */
+    prefetch: <TActionName extends keyof TActions>(actionName: TActionName, input?: InputOf<TActions[TActionName]>, options?: {
+        pathParams?: Record<string, any>;
+    }) => Promise<any>;
+    /**
+     * Dehydrates the current state in the global manager into a JSON string.
+     */
+    dehydrate: () => string;
+};
+
+export { createServerApi };

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+import { AxiosInstance } from 'axios';
+import { f as ActionConfigModule, A as ApiModuleConfig, I as InputOf } from './apiModule.types-DEskFzOY.js';
+import 'react';
+
+/**
+ * Creates a server-safe interface for pre-fetching data and dehydrating state.
+ * Use this in your React Server Components to prepare data for the client.
+ * @param apiClient A configured Axios instance.
+ * @param moduleConfig The configuration for the module you want to use.
+ * @returns An object with `prefetch` and `dehydrate` methods.
+ */
+declare function createServerApi<TActions extends Record<string, ActionConfigModule<any, any>>>(apiClient: AxiosInstance, moduleConfig: ApiModuleConfig<TActions>): {
+    /**
+     * Prefetches data for a specific action on the server and populates the cache.
+     */
+    prefetch: <TActionName extends keyof TActions>(actionName: TActionName, input?: InputOf<TActions[TActionName]>, options?: {
+        pathParams?: Record<string, any>;
+    }) => Promise<any>;
+    /**
+     * Dehydrates the current state in the global manager into a JSON string.
+     */
+    dehydrate: () => string;
+};
+
+export { createServerApi };

package/dist/server.js

@@ -0,0 +1,56 @@
+import {
+  callDynamicApi,
+  generateCacheKey,
+  globalStateManager
+} from "./chunk-N7HFSKII.js";
+
+// src/server.ts
+function createServerApi(apiClient, moduleConfig) {
+  return {
+    /**
+     * Prefetches data for a specific action on the server and populates the cache.
+     */
+    prefetch: async (actionName, input, options = {}) => {
+      const actionConfig = moduleConfig.actions[actionName];
+      if (!actionConfig) {
+        throw new Error(`Action "${actionName}" not found in module.`);
+      }
+      const result = await callDynamicApi(apiClient, moduleConfig.baseEndpoint, actionConfig, {
+        pathParams: options.pathParams,
+        body: input
+      });
+      const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: options.pathParams });
+      if (result.success) {
+        globalStateManager.setState(cacheKey, () => ({
+          data: result.data,
+          error: null,
+          loading: false,
+          success: true,
+          called: true,
+          isStale: false,
+          rawResponse: result.rawResponse
+        }));
+      } else {
+        globalStateManager.setState(cacheKey, () => ({
+          data: null,
+          error: result.error,
+          loading: false,
+          success: false,
+          called: true,
+          isStale: true,
+          rawResponse: result.rawResponse
+        }));
+      }
+      return result.data;
+    },
+    /**
+     * Dehydrates the current state in the global manager into a JSON string.
+     */
+    dehydrate: () => {
+      return globalStateManager.dehydrate();
+    }
+  };
+}
+export {
+  createServerApi
+};

package/dist/useApiRecord.types-C31nzgeP.d.ts

@@ -0,0 +1,90 @@
+import { Dispatch, SetStateAction } from 'react';
+import { R as RequestConfig, j as ApiError, S as StandardResponse, g as ActionOptions } from './apiModule.types-DEskFzOY.js';
+
+/**
+ * Represents the internal state of the `useApiRecord` hook.
+ * It mirrors the `StandardResponse` structure, which is the unified response format
+ * used across the library.
+ * @template T The data type of the record.
+ */
+type UseApiRecordState<T> = StandardResponse<T>;
+/**
+ * Defines the action methods provided by the `useApiRecord` hook to interact with
+ * a single API resource.
+ * @template T The data type of the record.
+ */
+interface UseApiRecordActions<T> {
+    /**
+     * Manually fetches or refetches the record from the API.
+     */
+    fetch: () => Promise<void>;
+    /**
+     * Partially updates the record using an HTTP PATCH request.
+     * @param updatedItem An object containing the fields to update.
+     * @param options Additional request options, allowing overrides for this specific action.
+     * @returns A promise that resolves to the standard response object for the updated record.
+     */
+    update: (updatedItem: Partial<T>, options?: ActionOptions) => Promise<StandardResponse<T>>;
+    /**
+     * Replaces the entire record with a new one using an HTTP PUT request.
+     * @param item The complete new record object.
+     * @param options Additional request options.
+     * @returns A promise that resolves to the standard response object for the replaced record.
+     */
+    put: (item: T, options?: ActionOptions) => Promise<StandardResponse<T>>;
+    /**
+     * Deletes the record using an HTTP DELETE request.
+     * @param options Additional request options.
+     * @returns A promise that resolves to a standard response object with a null data payload.
+     */
+    remove: (options?: ActionOptions) => Promise<StandardResponse<null>>;
+    /**
+     * Resets the hook's state to its initial value.
+     */
+    resetState: () => void;
+}
+/**
+ * Defines the configuration options for the `useApiRecord` hook.
+ * @template T The data type of the record.
+ */
+interface UseApiRecordConfig<T> {
+    /**
+     * The base API endpoint template for the resource.
+     * Can contain placeholders like `{endpointName}`.
+     * @example 'v1/dynamic/{endpointName}'
+     */
+    endpoint: string;
+    /**
+     * An object containing key-value pairs to replace placeholders in the endpoint template.
+     * @example { endpointName: 'products' }
+     */
+    pathParams?: Record<string, string | number>;
+    /** The unique identifier of the record to fetch or modify. */
+    recordId?: string | number | null;
+    /** Optional initial data to populate the state before the first fetch is complete. */
+    initialData?: T | null;
+    /** If `false`, the hook will not automatically fetch data on mount. Defaults to `true`. */
+    enabled?: boolean;
+    /** If `true`, the record will be refetched after a successful `update`, `put`, or `remove` action. Defaults to `true`. */
+    refetchAfterChange?: boolean;
+    /** Default `RequestConfig` to apply to the initial GET request made by the hook. */
+    requestConfig?: RequestConfig;
+    /** A callback function executed on a successful API action. */
+    onSuccess?: (message: string, data?: any) => void;
+    /** A callback function executed on a failed API action. */
+    onError?: (message: string, error?: ApiError) => void;
+}
+/**
+ * The return value of the `useApiRecord` hook.
+ * @template T The data type of the record.
+ */
+interface UseApiRecordReturn<T> {
+    /** The current state of the API request, including data, loading, and error status. */
+    state: UseApiRecordState<T>;
+    /** Action methods to manipulate the record. */
+    actions: UseApiRecordActions<T>;
+    /** A React dispatch function to manually set the hook's state. Use with caution. */
+    setState: Dispatch<SetStateAction<UseApiRecordState<T>>>;
+}
+
+export type { UseApiRecordConfig as U, UseApiRecordReturn as a, UseApiRecordState as b, UseApiRecordActions as c };

package/dist/useApiRecord.types-mpeiDoxm.d.cts

@@ -0,0 +1,90 @@
+import { Dispatch, SetStateAction } from 'react';
+import { R as RequestConfig, j as ApiError, S as StandardResponse, g as ActionOptions } from './apiModule.types-DEskFzOY.cjs';
+
+/**
+ * Represents the internal state of the `useApiRecord` hook.
+ * It mirrors the `StandardResponse` structure, which is the unified response format
+ * used across the library.
+ * @template T The data type of the record.
+ */
+type UseApiRecordState<T> = StandardResponse<T>;
+/**
+ * Defines the action methods provided by the `useApiRecord` hook to interact with
+ * a single API resource.
+ * @template T The data type of the record.
+ */
+interface UseApiRecordActions<T> {
+    /**
+     * Manually fetches or refetches the record from the API.
+     */
+    fetch: () => Promise<void>;
+    /**
+     * Partially updates the record using an HTTP PATCH request.
+     * @param updatedItem An object containing the fields to update.
+     * @param options Additional request options, allowing overrides for this specific action.
+     * @returns A promise that resolves to the standard response object for the updated record.
+     */
+    update: (updatedItem: Partial<T>, options?: ActionOptions) => Promise<StandardResponse<T>>;
+    /**
+     * Replaces the entire record with a new one using an HTTP PUT request.
+     * @param item The complete new record object.
+     * @param options Additional request options.
+     * @returns A promise that resolves to the standard response object for the replaced record.
+     */
+    put: (item: T, options?: ActionOptions) => Promise<StandardResponse<T>>;
+    /**
+     * Deletes the record using an HTTP DELETE request.
+     * @param options Additional request options.
+     * @returns A promise that resolves to a standard response object with a null data payload.
+     */
+    remove: (options?: ActionOptions) => Promise<StandardResponse<null>>;
+    /**
+     * Resets the hook's state to its initial value.
+     */
+    resetState: () => void;
+}
+/**
+ * Defines the configuration options for the `useApiRecord` hook.
+ * @template T The data type of the record.
+ */
+interface UseApiRecordConfig<T> {
+    /**
+     * The base API endpoint template for the resource.
+     * Can contain placeholders like `{endpointName}`.
+     * @example 'v1/dynamic/{endpointName}'
+     */
+    endpoint: string;
+    /**
+     * An object containing key-value pairs to replace placeholders in the endpoint template.
+     * @example { endpointName: 'products' }
+     */
+    pathParams?: Record<string, string | number>;
+    /** The unique identifier of the record to fetch or modify. */
+    recordId?: string | number | null;
+    /** Optional initial data to populate the state before the first fetch is complete. */
+    initialData?: T | null;
+    /** If `false`, the hook will not automatically fetch data on mount. Defaults to `true`. */
+    enabled?: boolean;
+    /** If `true`, the record will be refetched after a successful `update`, `put`, or `remove` action. Defaults to `true`. */
+    refetchAfterChange?: boolean;
+    /** Default `RequestConfig` to apply to the initial GET request made by the hook. */
+    requestConfig?: RequestConfig;
+    /** A callback function executed on a successful API action. */
+    onSuccess?: (message: string, data?: any) => void;
+    /** A callback function executed on a failed API action. */
+    onError?: (message: string, error?: ApiError) => void;
+}
+/**
+ * The return value of the `useApiRecord` hook.
+ * @template T The data type of the record.
+ */
+interface UseApiRecordReturn<T> {
+    /** The current state of the API request, including data, loading, and error status. */
+    state: UseApiRecordState<T>;
+    /** Action methods to manipulate the record. */
+    actions: UseApiRecordActions<T>;
+    /** A React dispatch function to manually set the hook's state. Use with caution. */
+    setState: Dispatch<SetStateAction<UseApiRecordState<T>>>;
+}
+
+export type { UseApiRecordConfig as U, UseApiRecordReturn as a, UseApiRecordState as b, UseApiRecordActions as c };

package/package.json

@@ -1,47 +1,78 @@
 {
   "name": "api-core-lib",
-  "version": "16.2.0",
+  "version": "16.12.133",
   "description": "A flexible and powerful API client library for modern web applications.",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "api-core-generate": "./bin/cli-launcher.cjs"
+  },
   "scripts": {
-    "build": "tsup && node scripts/obfuscate.js",
+    "build": "tsup",
     "dev": "tsup --watch"
   },
-  "keywords": [
-    "axios",
-    "api",
-    "react",
-    "nextjs",
-    "typescript",
-    "state-management"
-  ],
-  "author": "Your Name",
-  "license": "MIT",
   "peerDependencies": {
-    "react": ">=17.0.0"
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
   },
   "dependencies": {
+    "@apidevtools/json-schema-ref-parser": "^14.2.0",
+    "@apidevtools/swagger-parser": "^12.0.0",
     "axios": "^1.6.8",
     "axios-retry": "^4.1.0",
+    "chalk": "^4.1.2",
     "colorette": "^2.0.20",
+    "commander": "^9.4.1",
+    "dotenv": "^16.6.1",
+    "fast-deep-equal": "^3.1.3",
+    "fs-extra": "^11.3.1",
+    "inquirer": "^12.9.4",
+    "json-schema-to-typescript": "^15.0.4",
+    "openapi-typescript": "^6.2.4",
+    "openapi-typescript-codegen": "^0.29.0",
     "path": "^0.12.7",
-    "uuid": "^9.0.1"
+    "swagger-parser": "^10.0.3",
+    "uuid": "^9.0.1",
+    "zod": "^4.1.5"
   },
   "devDependencies": {
+    "@openapitools/openapi-generator-cli": "^2.23.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.2.1",
+    "@types/node": "^24.3.0",
     "@types/react": "^18.3.2",
     "@types/uuid": "^9.0.8",
     "javascript-obfuscator": "^4.1.1",
     "jest": "^30.0.5",
-    "react": "^18.3.1",
+    "openapi-types": "^12.1.3",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
     "ts-jest": "^29.4.1",
     "tsup": "^8.0.2",
     "typescript": "^5.4.5"
   },
   "files": [
-    "dist"
+    "dist",
+    "bin"
   ]
 }