@eusilvio/cep-lookup-react 0.4.0 → 0.4.1

package/README.md

@@ -12,6 +12,12 @@ npm install @eusilvio/cep-lookup @eusilvio/cep-lookup-react react
 yarn add @eusilvio/cep-lookup @eusilvio/cep-lookup-react react
 ```
 
+## Compatibility
+
+- React: `>= 16.8`
+- Node.js (for tooling/tests): `20.x`, `22.x`, `24.x`
+- Support policy: [SUPPORT.md](../../SUPPORT.md)
+
 ## Basic Usage
 
 Wrap your application or component tree with the `CepProvider` and use the `useCepLookup` hook anywhere inside it.
@@ -94,3 +100,8 @@ A React hook that performs the CEP lookup with built-in race condition protectio
 An object with `address` (typed as `T`), `loading`, `error`, and `warmup`.
 
 - `warmup`: `() => Promise<void>` - Function to trigger provider ranking optimization. Best used on `onFocus` events.
+
+## Community
+
+- Contributing guide: [CONTRIBUTING.md](../../CONTRIBUTING.md)
+- Code of conduct: [CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md)

package/dist/CepProvider.d.ts

@@ -12,7 +12,7 @@ interface CepProviderProps<T = Address> extends Partial<CepLookupOptions> {
     onFailure?: (event: EventMap['failure']) => void;
     onCacheHit?: (event: EventMap['cache:hit']) => void;
 }
-export declare const CepProvider: <T>({ children, mapper, onSuccess, onFailure, onCacheHit, ...options }: CepProviderProps<T>) => import("react/jsx-runtime").JSX.Element;
+export declare const CepProvider: <T>({ children, mapper, onSuccess, onFailure, onCacheHit, providers, cache, rateLimit, staggerDelay, fetcher, }: CepProviderProps<T>) => import("react/jsx-runtime").JSX.Element;
 export declare const useCepLookupInstance: () => CepContextValue<any>;
 export {};
 //# sourceMappingURL=CepProvider.d.ts.map

package/dist/CepProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CepProvider.d.ts","sourceRoot":"","sources":["../src/CepProvider.tsx"],"names":[],"mappings":"AAKA,OAAc,EAEZ,SAAS,EAIV,MAAM,OAAO,CAAC;AACf,OAAO,EACL,OAAO,EACP,SAAS,EACT,gBAAgB,EAEhB,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAU9B,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,CAAC;IACjC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAQD,UAAU,gBAAgB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IACvE,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,CAAC;IAEjC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CACrD;AAED,eAAO,MAAM,WAAW,GAAI,CAAC,EAAG,oEAO7B,gBAAgB,CAAC,CAAC,CAAC,4CAkDrB,CAAC;AAEF,eAAO,MAAM,oBAAoB,4BAOhC,CAAC"}
+{"version":3,"file":"CepProvider.d.ts","sourceRoot":"","sources":["../src/CepProvider.tsx"],"names":[],"mappings":"AAMA,OAAc,EAEZ,SAAS,EAKV,MAAM,OAAO,CAAC;AACf,OAAO,EACL,OAAO,EACP,SAAS,EACT,gBAAgB,EAEhB,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAU9B,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,CAAC;IACjC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAQD,UAAU,gBAAgB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IACvE,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,CAAC;IAEjC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CACrD;AAED,eAAO,MAAM,WAAW,GAAI,CAAC,EAAG,6GAW7B,gBAAgB,CAAC,CAAC,CAAC,4CAmDrB,CAAC;AAEF,eAAO,MAAM,oBAAoB,4BAOhC,CAAC"}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var T=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var B=(e,r)=>{for(var n in r)T(e,n,{get:r[n],enumerable:!0})},O=(e,r,n,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of I(r))!M.call(e,o)&&o!==n&&T(e,o,{get:()=>r[o],enumerable:!(t=b(r,o))||t.enumerable});return e};var N=e=>O(T({},"__esModule",{value:!0}),e);var K={};B(K,{CepProvider:()=>V,useBulkCepLookup:()=>D,useCepLookup:()=>j,useCepLookupInstance:()=>L});module.exports=N(K);var i=require("react");var v=require("@eusilvio/cep-lookup/providers"),p=require("react"),h=require("@eusilvio/cep-lookup"),R=require("react/jsx-runtime"),E=[v.viaCepProvider,v.brasilApiProvider,v.apicepProvider],w=new h.InMemoryCache,g=new h.CepLookup({providers:E,cache:w}),P=(0,p.createContext)({instance:g,options:{providers:E,cache:w}}),V=({children:e,mapper:r,onSuccess:n,onFailure:t,onCacheHit:o,...s})=>{let u=(0,p.useMemo)(()=>Object.keys(s).length?new h.CepLookup({providers:E,cache:w,...s}):g,[s]);(0,p.useEffect)(()=>(n&&u.on("success",n),t&&u.on("failure",t),o&&u.on("cache:hit",o),()=>{n&&u.off("success",n),t&&u.off("failure",t),o&&u.off("cache:hit",o)}),[u,n,t,o]);let c=(0,p.useMemo)(()=>({instance:u,mapper:r,options:{providers:E,cache:w,...s}}),[u,r,s]);return(0,R.jsx)(P.Provider,{value:c,children:e})},L=()=>{let e=(0,p.useContext)(P);if(!e)throw new Error("useCepLookupInstance must be used within a CepProvider");return e};var j=(e,r=500)=>{let[n,t]=(0,i.useState)(null),[o,s]=(0,i.useState)(null),[u,c]=(0,i.useState)(!1),{instance:m,mapper:f}=L(),l=(0,i.useRef)(null);return(0,i.useEffect)(()=>{let C=e.replace(/\D/g,"");return l.current&&clearTimeout(l.current),C.length===8?(c(!0),s(null),l.current=setTimeout(async()=>{try{let d=await m.lookup(C);t(f?f(d):d),s(null)}catch(d){s(d instanceof Error?d:new Error(String(d))),t(null)}finally{c(!1)}},r)):(t(null),s(null),c(!1)),()=>{l.current&&clearTimeout(l.current)}},[e,r,m,f]),{address:n,error:o,loading:u,warmup:()=>m.warmup()}};var a=require("react");var D=(e,r)=>{let[n,t]=(0,a.useState)([]),[o,s]=(0,a.useState)(!1),[u,c]=(0,a.useState)(null),{instance:m,mapper:f}=L(),l=(0,a.useRef)([]),x=(0,a.useCallback)(async()=>{if(!e||e.length===0){t([]),s(!1),c(null);return}let C=e.map(k=>k.replace(/\D/g,""));if(C.join(",")!==l.current.join(",")){l.current=C,s(!0),c(null);try{let A=(await m.lookupCeps(C,r?.concurrency)).map(y=>({...y,data:y.data&&f?f(y.data):y.data}));t(A)}catch(k){c(k instanceof Error?k:new Error(String(k))),t([])}finally{s(!1)}}},[e,r?.concurrency,m,f]);return(0,a.useEffect)(()=>{x()},[x]),{results:n,loading:o,error:u,refresh:x}};
+"use strict";var A=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var N=(e,r)=>{for(var c in r)A(e,c,{get:r[c],enumerable:!0})},O=(e,r,c,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of b(r))!g.call(e,s)&&s!==c&&A(e,s,{get:()=>r[s],enumerable:!(t=M(r,s))||t.enumerable});return e};var V=e=>O(A({},"__esModule",{value:!0}),e);var q={};N(q,{CepProvider:()=>K,useBulkCepLookup:()=>j,useCepLookup:()=>S,useCepLookupInstance:()=>x});module.exports=V(q);var k=require("react");var R=require("@eusilvio/cep-lookup/providers"),C=require("react"),w=require("@eusilvio/cep-lookup"),B=require("react/jsx-runtime"),P=[R.viaCepProvider,R.brasilApiProvider,R.apicepProvider,R.openCepProvider],L=new w.InMemoryCache,h=new w.CepLookup({providers:P,cache:L}),y=(0,C.createContext)({instance:h,options:{providers:P,cache:L}}),K=({children:e,mapper:r,onSuccess:c,onFailure:t,onCacheHit:s,providers:p,cache:m,rateLimit:u,staggerDelay:a,fetcher:n})=>{let d=(0,C.useRef)(null);d.current||(d.current=new w.InMemoryCache);let o=(0,C.useMemo)(()=>{if(!p&&!m&&!u&&a===void 0&&!n)return h;let l=m??d.current;return new w.CepLookup({providers:p||P,cache:l,...u&&{rateLimit:u},...a!==void 0&&{staggerDelay:a},...n&&{fetcher:n}})},[p,m,u,a,n]);(0,C.useEffect)(()=>(c&&o.on("success",c),t&&o.on("failure",t),s&&o.on("cache:hit",s),()=>{c&&o.off("success",c),t&&o.off("failure",t),s&&o.off("cache:hit",s)}),[o,c,t,s]);let T=(0,C.useMemo)(()=>({instance:o,mapper:r,options:{providers:p||P,cache:m??d.current,...u&&{rateLimit:u},...a!==void 0&&{staggerDelay:a},...n&&{fetcher:n}}}),[o,r,p,m,u,a,n]);return(0,B.jsx)(y.Provider,{value:T,children:e})},x=()=>{let e=(0,C.useContext)(y);if(!e)throw new Error("useCepLookupInstance must be used within a CepProvider");return e};var S=(e,r=500)=>{let[c,t]=(0,k.useState)(null),[s,p]=(0,k.useState)(null),[m,u]=(0,k.useState)(!1),{instance:a,mapper:n}=x(),d=(0,k.useRef)(null),o=(0,k.useRef)("");return(0,k.useEffect)(()=>{let l=e.replace(/\D/g,"");return o.current=l,d.current&&clearTimeout(d.current),l.length===8?(u(!0),p(null),d.current=setTimeout(async()=>{try{let i=await a.lookup(l);if(l!==o.current)return;t(n?n(i):i),p(null)}catch(i){if(l!==o.current)return;p(i instanceof Error?i:new Error(String(i))),t(null)}finally{l===o.current&&u(!1)}},r)):(t(null),p(null),u(!1)),()=>{d.current&&clearTimeout(d.current)}},[e,r,a,n]),{address:c,error:s,loading:m,warmup:()=>a.warmup()}};var f=require("react");var j=(e,r)=>{let[c,t]=(0,f.useState)([]),[s,p]=(0,f.useState)(!1),[m,u]=(0,f.useState)(null),{instance:a,mapper:n}=x(),d=(0,f.useRef)([]),o=(0,f.useRef)([]),T=(0,f.useCallback)(async()=>{if(!e||e.length===0){t([]),p(!1),u(null);return}let l=e.map(v=>v.replace(/\D/g,""));if(l.join(",")!==d.current.join(",")){d.current=l,p(!0),u(null);try{let v=await a.lookupCeps(l,r?.concurrency);o.current=v;let I=v.map(E=>({...E,data:E.data&&n?n(E.data):E.data}));t(I)}catch(v){u(v instanceof Error?v:new Error(String(v))),t([])}finally{p(!1)}}},[e,r?.concurrency,a,n]);return(0,f.useEffect)(()=>{T()},[T]),(0,f.useEffect)(()=>{if(o.current.length===0)return;let l=o.current.map(i=>({...i,data:i.data&&n?n(i.data):i.data}));t(l)},[n]),{results:c,loading:s,error:m,refresh:T}};

package/dist/index.mjs

@@ -1 +1 @@
-import{useEffect as N,useState as L,useRef as V}from"react";import{apicepProvider as P,brasilApiProvider as R,viaCepProvider as A}from"@eusilvio/cep-lookup/providers";import{createContext as b,useContext as I,useEffect as M,useMemo as y}from"react";import{CepLookup as E,InMemoryCache as B}from"@eusilvio/cep-lookup";import{jsx as O}from"react/jsx-runtime";var k=[A,R,P],v=new B,w=new E({providers:k,cache:v}),T=b({instance:w,options:{providers:k,cache:v}}),X=({children:o,mapper:a,onSuccess:n,onFailure:r,onCacheHit:s,...e})=>{let t=y(()=>Object.keys(e).length?new E({providers:k,cache:v,...e}):w,[e]);M(()=>(n&&t.on("success",n),r&&t.on("failure",r),s&&t.on("cache:hit",s),()=>{n&&t.off("success",n),r&&t.off("failure",r),s&&t.off("cache:hit",s)}),[t,n,r,s]);let u=y(()=>({instance:t,mapper:a,options:{providers:k,cache:v,...e}}),[t,a,e]);return O(T.Provider,{value:u,children:o})},h=()=>{let o=I(T);if(!o)throw new Error("useCepLookupInstance must be used within a CepProvider");return o};var F=(o,a=500)=>{let[n,r]=L(null),[s,e]=L(null),[t,u]=L(!1),{instance:i,mapper:p}=h(),c=V(null);return N(()=>{let f=o.replace(/\D/g,"");return c.current&&clearTimeout(c.current),f.length===8?(u(!0),e(null),c.current=setTimeout(async()=>{try{let l=await i.lookup(f);r(p?p(l):l),e(null)}catch(l){e(l instanceof Error?l:new Error(String(l))),r(null)}finally{u(!1)}},a)):(r(null),e(null),u(!1)),()=>{c.current&&clearTimeout(c.current)}},[o,a,i,p]),{address:n,error:s,loading:t,warmup:()=>i.warmup()}};import{useState as x,useEffect as j,useCallback as D,useRef as K}from"react";var te=(o,a)=>{let[n,r]=x([]),[s,e]=x(!1),[t,u]=x(null),{instance:i,mapper:p}=h(),c=K([]),m=D(async()=>{if(!o||o.length===0){r([]),e(!1),u(null);return}let f=o.map(d=>d.replace(/\D/g,""));if(f.join(",")!==c.current.join(",")){c.current=f,e(!0),u(null);try{let g=(await i.lookupCeps(f,a?.concurrency)).map(C=>({...C,data:C.data&&p?p(C.data):C.data}));r(g)}catch(d){u(d instanceof Error?d:new Error(String(d))),r([])}finally{e(!1)}}},[o,a?.concurrency,i,p]);return j(()=>{m()},[m]),{results:n,loading:s,error:t,refresh:m}};export{X as CepProvider,te as useBulkCepLookup,F as useCepLookup,h as useCepLookupInstance};
+import{useEffect as J,useState as T,useRef as y}from"react";import{apicepProvider as b,brasilApiProvider as g,viaCepProvider as N,openCepProvider as O}from"@eusilvio/cep-lookup/providers";import{createContext as V,useContext as K,useEffect as S,useMemo as x,useRef as j}from"react";import{CepLookup as E,InMemoryCache as P}from"@eusilvio/cep-lookup";import{jsx as q}from"react/jsx-runtime";var v=[N,g,b,O],A=new P,L=new E({providers:v,cache:A}),h=V({instance:L,options:{providers:v,cache:A}}),$=({children:p,mapper:f,onSuccess:l,onFailure:o,onCacheHit:d,providers:t,cache:i,rateLimit:n,staggerDelay:s,fetcher:e})=>{let c=j(null);c.current||(c.current=new P);let r=x(()=>{if(!t&&!i&&!n&&s===void 0&&!e)return L;let u=i??c.current;return new E({providers:t||v,cache:u,...n&&{rateLimit:n},...s!==void 0&&{staggerDelay:s},...e&&{fetcher:e}})},[t,i,n,s,e]);S(()=>(l&&r.on("success",l),o&&r.on("failure",o),d&&r.on("cache:hit",d),()=>{l&&r.off("success",l),o&&r.off("failure",o),d&&r.off("cache:hit",d)}),[r,l,o,d]);let m=x(()=>({instance:r,mapper:f,options:{providers:t||v,cache:i??c.current,...n&&{rateLimit:n},...s!==void 0&&{staggerDelay:s},...e&&{fetcher:e}}}),[r,f,t,i,n,s,e]);return q(h.Provider,{value:m,children:p})},R=()=>{let p=K(h);if(!p)throw new Error("useCepLookupInstance must be used within a CepProvider");return p};var re=(p,f=500)=>{let[l,o]=T(null),[d,t]=T(null),[i,n]=T(!1),{instance:s,mapper:e}=R(),c=y(null),r=y("");return J(()=>{let u=p.replace(/\D/g,"");return r.current=u,c.current&&clearTimeout(c.current),u.length===8?(n(!0),t(null),c.current=setTimeout(async()=>{try{let a=await s.lookup(u);if(u!==r.current)return;o(e?e(a):a),t(null)}catch(a){if(u!==r.current)return;t(a instanceof Error?a:new Error(String(a))),o(null)}finally{u===r.current&&n(!1)}},f)):(o(null),t(null),n(!1)),()=>{c.current&&clearTimeout(c.current)}},[p,f,s,e]),{address:l,error:d,loading:i,warmup:()=>s.warmup()}};import{useState as w,useEffect as B,useCallback as z,useRef as I}from"react";var se=(p,f)=>{let[l,o]=w([]),[d,t]=w(!1),[i,n]=w(null),{instance:s,mapper:e}=R(),c=I([]),r=I([]),m=z(async()=>{if(!p||p.length===0){o([]),t(!1),n(null);return}let u=p.map(C=>C.replace(/\D/g,""));if(u.join(",")!==c.current.join(",")){c.current=u,t(!0),n(null);try{let C=await s.lookupCeps(u,f?.concurrency);r.current=C;let M=C.map(k=>({...k,data:k.data&&e?e(k.data):k.data}));o(M)}catch(C){n(C instanceof Error?C:new Error(String(C))),o([])}finally{t(!1)}}},[p,f?.concurrency,s,e]);return B(()=>{m()},[m]),B(()=>{if(r.current.length===0)return;let u=r.current.map(a=>({...a,data:a.data&&e?e(a.data):a.data}));o(u)},[e]),{results:l,loading:d,error:i,refresh:m}};export{$ as CepProvider,se as useBulkCepLookup,re as useCepLookup,R as useCepLookupInstance};

package/dist/useBulkCepLookup.d.ts

@@ -1,8 +1,8 @@
-import { BulkCepResult } from '@eusilvio/cep-lookup';
-export declare const useBulkCepLookup: <T = any>(ceps: string[], options?: {
+import { Address, BulkCepResult } from '@eusilvio/cep-lookup';
+export declare const useBulkCepLookup: <T = Address>(ceps: string[], options?: {
     concurrency?: number;
 }) => {
-    results: BulkCepResult[];
+    results: BulkCepResult<T>[];
     loading: boolean;
     error: Error | null;
     refresh: () => Promise<void>;

package/dist/useBulkCepLookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBulkCepLookup.d.ts","sourceRoot":"","sources":["../src/useBulkCepLookup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,GAAG,EACtC,MAAM,MAAM,EAAE,EACd,UAAU;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;CAgDnC,CAAC"}
+{"version":3,"file":"useBulkCepLookup.d.ts","sourceRoot":"","sources":["../src/useBulkCepLookup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG9D,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,OAAO,EAC1C,MAAM,MAAM,EAAE,EACd,UAAU;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;CA2DnC,CAAC"}

package/dist/useCepLookup.d.ts

@@ -3,6 +3,6 @@ export declare const useCepLookup: <T = Address>(cep: string, delay?: number) =>
     address: T | null;
     error: Error | null;
     loading: boolean;
-    warmup: () => Promise<void>;
+    warmup: () => Promise<import("@eusilvio/cep-lookup").Provider[]>;
 };
 //# sourceMappingURL=useCepLookup.d.ts.map

package/dist/useCepLookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCepLookup.d.ts","sourceRoot":"","sources":["../src/useCepLookup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,eAAO,MAAM,YAAY,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,EAAE,cAAW;;;;;CAuDjE,CAAC"}
+{"version":3,"file":"useCepLookup.d.ts","sourceRoot":"","sources":["../src/useCepLookup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,eAAO,MAAM,YAAY,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,EAAE,cAAW;;;;;CAsDjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eusilvio/cep-lookup-react",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "React hooks and provider for @eusilvio/cep-lookup",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,7 +12,7 @@
     }
   },
   "peerDependencies": {
-    "@eusilvio/cep-lookup": "^2.3.2",
+    "@eusilvio/cep-lookup": "^2.5.1",
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0"
   },