Angular
O @unicep/angular traz bindings com signals e RxJS, para Angular 17 ou mais novo e RxJS 7. O pacote não usa decorators, então funciona com o build padrão do Angular.
npm install @unicep/angularpnpm add @unicep/angularyarn add @unicep/angularbun add @unicep/angularO @unicep/core é instalado junto.
Uso com signals
Seção intitulada “Uso com signals”O injectCep precisa ser chamado num contexto de injeção, como num campo ou construtor de componente ou serviço.
import { Component, signal } from '@angular/core';import { injectCep } from '@unicep/angular';
@Component({ selector: 'app-campo-cep', template: ` <input [value]="valor()" (input)="valor.set($any($event.target).value)" placeholder="00000-000" /> @if (cep.isLoading()) { <p>Buscando…</p> } @if (cep.error(); as error) { <p>{{ error.message }}</p> } @if (cep.data(); as endereco) { <p>{{ endereco.street }}, {{ endereco.neighborhood }} - {{ endereco.city }}/{{ endereco.state }}</p> } `,})export class CampoCepComponent { readonly valor = signal(''); readonly cep = injectCep(() => this.valor());}A busca só acontece quando o valor é um CEP válido (com ou sem hífen). Se o CEP mudar, o resultado anterior some e a requisição em andamento é cancelada.
injectCep(cep, options?)
Seção intitulada “injectCep(cep, options?)”injectCep(cep: () => string | null | undefined, options?: { unicep?: Unicep; // padrão: a instância fornecida pelo token UNICEP enabled?: () => boolean; // false pausa as consultas, padrão sempre ligado}): { data: Signal<Address | undefined>; error: Signal<Error | undefined>; isLoading: Signal<boolean>; // true enquanto a consulta do CEP válido atual está em andamento}lookupCep(unicep, cep)
Seção intitulada “lookupCep(unicep, cep)”A versão com Observable, para pipelines RxJS. Cancelar a inscrição cancela a requisição.
import { inject } from '@angular/core';import { lookupCep, UNICEP } from '@unicep/angular';
const unicep = inject(UNICEP);lookupCep(unicep, '01310100').subscribe((endereco) => console.log(endereco));UNICEP e provideUnicep(unicep)
Seção intitulada “UNICEP e provideUnicep(unicep)”O UNICEP é o token de injeção da instância do Unicep. Por padrão, é uma instância compartilhada com todos os providers embutidos. Para mudar providers, timeout, cache ou circuit breaker, forneça a sua:
import { ApplicationConfig } from '@angular/core';import { Unicep, viaCep, brasilApi } from '@unicep/core';import { provideUnicep } from '@unicep/angular';
export const appConfig: ApplicationConfig = { providers: [ provideUnicep(new Unicep({ providers: [viaCep(), brasilApi()], timeoutMs: 3000, cache: {} })), ],};O error é um dos erros da unicep, como CepNotFoundError ou
AllProvidersFailedError. Todas as opções estão em Providers e no
Core.