@ssddo/ecf-react 0.1.4 → 0.2.0

package/README.md

@@ -205,6 +205,32 @@ Crea un cliente tipado de React Query para la API de ECF DGII.
 - `$api` - El cliente openapi-react-query con `useQuery`, `useMutation`, `useSuspenseQuery`, etc.
 - `fetchClient` - El cliente openapi-fetch subyacente para uso fuera de React.
 
+### `createEcfFrontendReactClient(config)`
+
+Crea un cliente de solo lectura restringido a endpoints GET. No expone `useMutation`. Diseñado para el frontend donde solo se consultan ECFs con un token de solo lectura.
+
+**Opciones de configuración:** mismas que `createEcfReactClient`.
+
+**Retorna:** `{ $api, fetchClient }`
+
+- `$api` - Cliente con solo `useQuery`, `useSuspenseQuery`, y `queryOptions` (sin `useMutation`)
+- `fetchClient` - El cliente openapi-fetch subyacente (restringido a paths GET)
+
+```tsx
+import { createEcfFrontendReactClient } from '@ssddo/ecf-react';
+
+const { $api } = createEcfFrontendReactClient({
+  apiKey: token,
+  environment: 'prod',
+});
+
+// ✅ Funciona — endpoint GET
+$api.useQuery('get', '/ecf/{rnc}/{encf}', { params: { path: { rnc, encf } } });
+
+// ❌ Error de tipo — useMutation no está disponible
+// $api.useMutation('post', '/ecf/31');
+```
+
 ## Arquitectura Backend / Frontend
 
 El SDK de React está diseñado para el lado del **frontend** de la arquitectura recomendada:
@@ -219,7 +245,7 @@ El SDK de React está diseñado para el lado del **frontend** de la arquitectura
 // y lo renueva automáticamente cuando expira o recibe un 401
 const ecfToken = useEcfToken();
 
-const { $api } = createEcfReactClient({
+const { $api } = createEcfFrontendReactClient({
   apiKey: ecfToken,  // solo lectura, con alcance al tenant/RNC
   environment: 'prod',
 });

package/dist/index.d.mts

@@ -6852,5 +6852,26 @@ declare function createEcfReactClient(config: EcfReactClientConfig): {
     $api: openapi_react_query.OpenapiQueryClient<paths, `${string}/${string}`>;
     fetchClient: openapi_fetch.Client<paths, `${string}/${string}`>;
 };
+type PathsWithGet = {
+    [K in keyof paths as paths[K] extends {
+        get: unknown;
+    } ? K : never]: paths[K];
+};
+type ReadOnlyPaths = {
+    [K in keyof PathsWithGet]: Pick<PathsWithGet[K], 'get' | 'parameters'> & {
+        put?: never;
+        post?: never;
+        delete?: never;
+        patch?: never;
+    };
+};
+declare function createEcfFrontendReactClient(config: EcfReactClientConfig): {
+    $api: {
+        useQuery: openapi_react_query.UseQueryMethod<ReadOnlyPaths, `${string}/${string}`>;
+        useSuspenseQuery: openapi_react_query.UseSuspenseQueryMethod<ReadOnlyPaths, `${string}/${string}`>;
+        queryOptions: openapi_react_query.QueryOptionsFunction<ReadOnlyPaths, `${string}/${string}`>;
+    };
+    fetchClient: openapi_fetch.Client<ReadOnlyPaths, `${string}/${string}`>;
+};
 
-export { type EcfReactClientConfig, type Environment, type components, createEcfReactClient, type operations, type paths };
+export { type EcfReactClientConfig, type Environment, type components, createEcfFrontendReactClient, createEcfReactClient, type operations, type paths };

package/dist/index.d.ts

@@ -6852,5 +6852,26 @@ declare function createEcfReactClient(config: EcfReactClientConfig): {
     $api: openapi_react_query.OpenapiQueryClient<paths, `${string}/${string}`>;
     fetchClient: openapi_fetch.Client<paths, `${string}/${string}`>;
 };
+type PathsWithGet = {
+    [K in keyof paths as paths[K] extends {
+        get: unknown;
+    } ? K : never]: paths[K];
+};
+type ReadOnlyPaths = {
+    [K in keyof PathsWithGet]: Pick<PathsWithGet[K], 'get' | 'parameters'> & {
+        put?: never;
+        post?: never;
+        delete?: never;
+        patch?: never;
+    };
+};
+declare function createEcfFrontendReactClient(config: EcfReactClientConfig): {
+    $api: {
+        useQuery: openapi_react_query.UseQueryMethod<ReadOnlyPaths, `${string}/${string}`>;
+        useSuspenseQuery: openapi_react_query.UseSuspenseQueryMethod<ReadOnlyPaths, `${string}/${string}`>;
+        queryOptions: openapi_react_query.QueryOptionsFunction<ReadOnlyPaths, `${string}/${string}`>;
+    };
+    fetchClient: openapi_fetch.Client<ReadOnlyPaths, `${string}/${string}`>;
+};
 
-export { type EcfReactClientConfig, type Environment, type components, createEcfReactClient, type operations, type paths };
+export { type EcfReactClientConfig, type Environment, type components, createEcfFrontendReactClient, createEcfReactClient, type operations, type paths };

package/dist/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  createEcfFrontendReactClient: () => createEcfFrontendReactClient,
   createEcfReactClient: () => createEcfReactClient
 });
 module.exports = __toCommonJS(index_exports);
@@ -56,7 +57,27 @@ function createEcfReactClient(config) {
   const $api = (0, import_openapi_react_query.default)(fetchClient);
   return { $api, fetchClient };
 }
+function createEcfFrontendReactClient(config) {
+  const baseUrl = config.baseUrl ?? ENVIRONMENT_URLS[config.environment ?? "test"];
+  const fetchClient = (0, import_openapi_fetch.default)({
+    baseUrl
+  });
+  fetchClient.use({
+    async onRequest({ request }) {
+      request.headers.set("Authorization", `Bearer ${config.apiKey}`);
+      return request;
+    }
+  });
+  const fullApi = (0, import_openapi_react_query.default)(fetchClient);
+  const $api = {
+    useQuery: fullApi.useQuery,
+    useSuspenseQuery: fullApi.useSuspenseQuery,
+    queryOptions: fullApi.queryOptions
+  };
+  return { $api, fetchClient };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createEcfFrontendReactClient,
   createEcfReactClient
 });

package/dist/index.mjs

@@ -20,6 +20,26 @@ function createEcfReactClient(config) {
   const $api = createClient(fetchClient);
   return { $api, fetchClient };
 }
+function createEcfFrontendReactClient(config) {
+  const baseUrl = config.baseUrl ?? ENVIRONMENT_URLS[config.environment ?? "test"];
+  const fetchClient = createFetchClient({
+    baseUrl
+  });
+  fetchClient.use({
+    async onRequest({ request }) {
+      request.headers.set("Authorization", `Bearer ${config.apiKey}`);
+      return request;
+    }
+  });
+  const fullApi = createClient(fetchClient);
+  const $api = {
+    useQuery: fullApi.useQuery,
+    useSuspenseQuery: fullApi.useSuspenseQuery,
+    queryOptions: fullApi.queryOptions
+  };
+  return { $api, fetchClient };
+}
 export {
+  createEcfFrontendReactClient,
   createEcfReactClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssddo/ecf-react",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Hooks de React Query para la API de ECF DGII (comprobantes fiscales electrónicos de República Dominicana)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -46,10 +46,30 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0"
   },
+  "author": {
+    "name": "SSD Smart Software Development SRL",
+    "email": "contacto@ssd.com.do",
+    "url": "https://ssd.com.do"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/SSD-Smart-Software-Development-SRL/ecf_dgii",
     "directory": "react"
   },
+  "homepage": "https://github.com/SSD-Smart-Software-Development-SRL/ecf_dgii/tree/main/react#readme",
+  "bugs": {
+    "url": "https://github.com/SSD-Smart-Software-Development-SRL/ecf_dgii/issues"
+  },
+  "keywords": [
+    "ecf",
+    "dgii",
+    "factura-electronica",
+    "comprobante-fiscal",
+    "republica-dominicana",
+    "react",
+    "react-query",
+    "openapi",
+    "ssd"
+  ],
   "license": "MIT"
 }