@eusilvio/cep-lookup-react 0.3.2 → 0.4.0

package/README.md

@@ -91,4 +91,6 @@ A React hook that performs the CEP lookup with built-in race condition protectio
 
 **Returns**
 
-An object with `address` (typed as `T`), `loading`, and `error`.
+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.

package/dist/index.cjs

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

package/dist/index.mjs

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

package/dist/useCepLookup.d.ts

@@ -3,5 +3,6 @@ export declare const useCepLookup: <T = Address>(cep: string, delay?: number) =>
     address: T | null;
     error: Error | null;
     loading: boolean;
+    warmup: () => Promise<void>;
 };
 //# 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;;;;CAmDjE,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;;;;;CAuDjE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@eusilvio/cep-lookup-react",
-  "version": "0.3.2",
-  "description": "React hook for cep-lookup.",
+  "version": "0.4.0",
+  "description": "React hooks and provider for @eusilvio/cep-lookup",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {