# 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.

```bash
npm install @unicep/angular
```

```bash
pnpm add @unicep/angular
```

```bash
yarn add @unicep/angular
```

```bash
bun add @unicep/angular
```

O `@unicep/core` é instalado junto.

## Uso com signals

O `injectCep` precisa ser chamado num contexto de injeção, como num campo ou construtor de componente ou serviço.

```ts
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.

## API

### `injectCep(cep, options?)`

```ts
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)`

A versão com Observable, para pipelines RxJS. Cancelar a inscrição cancela a requisição.

```ts
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)`

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:

```ts
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](/docs/errors), como `CepNotFoundError` ou
`AllProvidersFailedError`. Todas as opções estão em [Providers](/docs/providers) e no
[Core](/docs/core).