sgp-sdk 2.0.0-beta.1 → 2.0.0-beta.2

package/dist/normalize.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+/**
+ * A field SGP sends as a JSON number or as numeric text: `data` carries a `number`. `""` and `null`
+ * mean "no value" and become `null`, never `0`. Formatted text (`"1.234,56"`) is never guessed: it
+ * fails and the tolerant reader drops the field with a warning (`expected: number`).
+ */
+export declare const normalizedNumber: z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>;
+/** An enum-like text SGP pads with spaces (`" Ativo "`): `data` carries it trimmed. */
+export declare const trimmedText: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;

package/dist/operation-sensitivity.d.ts

@@ -166,6 +166,9 @@ export declare const shippedOperations: readonly [import("./operation.js").Opera
 }, "customers.search">, import("./operation.js").OperationDefinition<{
     [x: string]: unknown;
     message: string;
+    precadastro_id?: number | null | undefined;
+    new_cliente_id?: (number & import("zod").$brand<"CustomerId">) | null | undefined;
+    new_contrato_id?: number | null | undefined;
 }, "preRegistrations.create">, import("./operation.js").OperationDefinition<{
     [x: string]: unknown;
     resposta: {
@@ -196,6 +199,68 @@ export declare const shippedOperations: readonly [import("./operation.js").Opera
     data_cadastro?: string | null | undefined;
     motivo_status?: string | null | undefined;
 }[], "contracts.list">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+    servico_id: number;
+    servico_tipo?: number | null | undefined;
+    servico_login?: string | null | undefined;
+    servico_password?: string | null | undefined;
+    servico_mac?: string | null | undefined;
+    servico_online?: boolean | null | undefined;
+    nas_ip?: string | null | undefined;
+    servicos?: unknown[] | null | undefined;
+    contrato_id?: number | null | undefined;
+    contrato_status?: string | null | undefined;
+    contrato_status_id?: number | null | undefined;
+    contrato_status_data?: string | null | undefined;
+    contrato_cadastro?: string | null | undefined;
+    contrato_pop_id?: number | null | undefined;
+    contrato_pop_nome?: string | null | undefined;
+    contrato_endereco_ll?: string | null | undefined;
+    cliente_id?: (number & import("zod").$brand<"CustomerId">) | null | undefined;
+    cliente_nome?: string | null | undefined;
+    cliente_email?: string | null | undefined;
+    cliente_contato?: string | null | undefined;
+    endereco_id?: number | null | undefined;
+    endereco_logradouro?: string | null | undefined;
+    endereco_numero?: string | number | null | undefined;
+    endereco_complemento?: string | null | undefined;
+    endereco_bairro?: string | null | undefined;
+    endereco_cidade?: string | null | undefined;
+    endereco_uf?: string | null | undefined;
+    endereco_pontoreferencia?: string | null | undefined;
+    endereco_ll?: string | null | undefined;
+    plano_id?: number | null | undefined;
+    plano?: string | null | undefined;
+    plano_download?: string | null | undefined;
+    plano_upload?: string | null | undefined;
+    os_servicoprestado?: string | null | undefined;
+    rad_username?: string | null | undefined;
+    rad_ip?: string | null | undefined;
+    rad_mac?: string | null | undefined;
+    rad_nasipaddress?: string | null | undefined;
+    rad_nasportid?: string | null | undefined;
+    rad_nasporttype?: string | null | undefined;
+    rad_calledstationid?: string | null | undefined;
+    rad_acctsessionid?: string | null | undefined;
+    rad_radacctid?: number | null | undefined;
+    rad_dataconexao?: string | null | undefined;
+    rad_tempo?: string | null | undefined;
+    rad_tempo_ordem?: number | null | undefined;
+    rad_acctinputoctets?: number | null | undefined;
+    rad_acctoutputoctets?: number | null | undefined;
+    rad_framedprotocol?: string | null | undefined;
+    rad_framedipv6prefix?: string | null | undefined;
+    rad_delegatedipv6prefix?: string | null | undefined;
+}[], "contracts.listServices">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+    status: number;
+    msg?: string | null | undefined;
+    servico_id?: number | null | undefined;
+    contratoId?: number | null | undefined;
+    login?: string | null | undefined;
+    razaoSocial?: string | null | undefined;
+    cpfCnpj?: string | null | undefined;
+}[], "contracts.checkConnection">, import("./operation.js").OperationDefinition<{
     [x: string]: unknown;
     paginacao: {
         [x: string]: unknown;
@@ -336,14 +401,18 @@ export declare const shippedOperations: readonly [import("./operation.js").Opera
 }, "services.changePlan">, import("./operation.js").OperationDefinition<{
     [x: string]: unknown;
     msg: string;
-    clientecontrato_id?: string | undefined;
+    clientecontrato_id?: number | null | undefined;
     servico_id: number;
 }, "services.addTv">, import("./operation.js").OperationDefinition<{
     [x: string]: unknown;
+}, "services.addGeneric">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
     msg: string;
-    clientecontrato_id?: string | undefined;
+    clientecontrato_id?: number | null | undefined;
     servico_id: number;
-}, "services.removeTv">, import("./operation.js").OperationDefinition<import("./operations/experimental-annotations-list.js").ExperimentalAnnotationsListData, "experimental.annotations.list">, import("./operation.js").OperationDefinition<{
+}, "services.removeTv">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+}, "services.removeGeneric">, import("./operation.js").OperationDefinition<import("./operations/experimental-annotations-list.js").ExperimentalAnnotationsListData, "experimental.annotations.list">, import("./operation.js").OperationDefinition<{
     [x: string]: unknown;
     id: number;
     pop?: string | null | undefined;
@@ -399,8 +468,8 @@ export declare const shippedOperations: readonly [import("./operation.js").Opera
     observacao?: string | null | undefined;
     gateway?: {
         [x: string]: unknown;
-        gateway_id?: string | number | null | undefined;
-        id?: string | number | null | undefined;
+        gateway_id?: number | null | undefined;
+        id?: number | null | undefined;
         descricao?: string | null | undefined;
     } | null | undefined;
 }[], "preRegistrations.listPlans">, import("./operation.js").OperationDefinition<{
@@ -425,6 +494,11 @@ export declare const shippedOperations: readonly [import("./operation.js").Opera
     descricao?: string | null | undefined;
     usuario?: string | null | undefined;
 }[], "documents.list">, import("./operation.js").OperationDefinition<import("./operations/coverage-check.js").CoverageCheckData, "coverage.check">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+    id: number;
+    descricao: string;
+    gateway?: string | null | undefined;
+}[], "coverage.listGateways">, import("./operation.js").OperationDefinition<{
     [x: string]: unknown;
     cliente_id: number & import("zod").$brand<"CustomerId">;
     message?: string | null | undefined;
@@ -482,7 +556,166 @@ export declare const shippedOperations: readonly [import("./operation.js").Opera
     razaoSocial?: string | null | undefined;
     cpfCnpj?: string | null | undefined;
     msg?: string | null | undefined;
-}, "occurrences.create">, import("./operation.js").OperationDefinition<null, "documents.add">];
+}, "occurrences.create">, import("./operation.js").OperationDefinition<null, "documents.add">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+    paginacao: {
+        [x: string]: unknown;
+        offset?: number | null | undefined;
+        limit?: number | null | undefined;
+        parcial?: number | null | undefined;
+        total: number;
+    };
+    ocorrencias: {
+        [x: string]: unknown;
+        id: number;
+        cliente?: string | null | undefined;
+        contrato?: number | null | undefined;
+        contrato_status?: string | null | undefined;
+        contrato_status_id?: number | null | undefined;
+        pop?: string | null | undefined;
+        numero?: string | null | undefined;
+        status?: string | null | undefined;
+        status_id?: number | null | undefined;
+        data_cadastro?: string | null | undefined;
+        data_agendamento?: string | null | undefined;
+        data_finalizacao?: string | null | undefined;
+        tipo?: string | null | undefined;
+        metodo?: string | null | undefined;
+        conteudo?: string | null | undefined;
+        responsavel?: string | null | undefined;
+        usuario?: string | null | undefined;
+        usuario_finalizacao?: string | null | undefined;
+        protocolos_externos?: unknown[] | null | undefined;
+        servico?: unknown[] | null | undefined;
+        comentarios?: unknown[] | null | undefined;
+        ordens_servicos?: {
+            [x: string]: unknown;
+            id: number;
+            status?: string | null | undefined;
+            status_id?: number | null | undefined;
+            data_cadastro?: string | null | undefined;
+            data_agendamento?: string | null | undefined;
+            data_finalizacao?: string | null | undefined;
+            tipo?: string | null | undefined;
+            tipo_id?: number | null | undefined;
+            motivo?: string | null | undefined;
+            pop?: string | null | undefined;
+            conteudo?: string | null | undefined;
+            responsavel?: string | null | undefined;
+            tecnicos_auxiliares?: unknown[] | null | undefined;
+            usuario?: string | null | undefined;
+            usuario_finalizacao?: string | null | undefined;
+        }[] | null | undefined;
+    }[];
+}, "occurrences.list">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+    os_id: number;
+    os_protocolo?: string | null | undefined;
+    os_status?: number | null | undefined;
+    os_status_txt?: string | null | undefined;
+    os_prioridade?: number | null | undefined;
+    os_motivo_id?: number | null | undefined;
+    os_motivo_descricao?: string | null | undefined;
+    os_data_cadastro?: string | null | undefined;
+    os_data_agendamento?: string | null | undefined;
+    os_data_finalizacao?: string | null | undefined;
+    os_conteudo?: string | null | undefined;
+    os_observacao?: string | null | undefined;
+    os_anotacao?: string | null | undefined;
+    os_servicoprestado?: string | null | undefined;
+    os_setor_id?: number | null | undefined;
+    os_setor?: string | null | undefined;
+    os_tecnico_responsavel?: string | null | undefined;
+    os_tecnicos_auxiliares?: unknown[] | null | undefined;
+    os_agendamento_confirmado?: boolean | null | undefined;
+    os_agendamento_confirmacao_data?: string | null | undefined;
+    os_agendamento_confirmacao_status?: number | null | undefined;
+    os_agendamento_confirmacao_status_txt?: string | null | undefined;
+    os_close_edit?: boolean | null | undefined;
+    os_encerrada_impedir_estorno?: boolean | null | undefined;
+    os_encerrada_impedir_lancamento_avulso?: boolean | null | undefined;
+    os_finalizada_permite_add_imagem?: boolean | null | undefined;
+    os_lancamento_comodato?: boolean | null | undefined;
+    os_djson?: Record<string, unknown> | null | undefined;
+    comentarios?: unknown[] | null | undefined;
+    cliente_id?: (number & import("zod").$brand<"CustomerId">) | null | undefined;
+    cliente?: string | null | undefined;
+    cliente_email?: string | null | undefined;
+    cliente_contato?: string | null | undefined;
+    contrato_id?: number | null | undefined;
+    contrato_status?: string | null | undefined;
+    contrato_status_id?: number | null | undefined;
+    contrato_status_data?: string | null | undefined;
+    contrato_pop_id?: number | null | undefined;
+    contrato_pop?: string | null | undefined;
+    contrato_endereco_ll?: string | null | undefined;
+    endereco_id?: number | null | undefined;
+    endereco_logradouro?: string | null | undefined;
+    endereco_numero?: string | number | null | undefined;
+    endereco_complemento?: string | null | undefined;
+    endereco_bairro?: string | null | undefined;
+    endereco_cidade?: string | null | undefined;
+    endereco_uf?: string | null | undefined;
+    endereco_pontoreferencia?: string | null | undefined;
+    endereco_ll?: string | null | undefined;
+    plano_id?: number | null | undefined;
+    plano?: string | null | undefined;
+    plano_download?: string | null | undefined;
+    plano_upload?: string | null | undefined;
+    servico_id?: number | null | undefined;
+    servico_tipo?: number | null | undefined;
+    servico_login?: string | null | undefined;
+    servico_password?: string | null | undefined;
+    servico_online?: boolean | null | undefined;
+    servico_mac?: string | null | undefined;
+    servico_ip?: string | null | undefined;
+    servico_online_mac?: string | null | undefined;
+    servico_online_ip?: string | null | undefined;
+    servico_online_ipv6_pd?: unknown;
+    nas_ip?: string | null | undefined;
+    wifi_ssid?: string | null | undefined;
+    wifi_password?: string | null | undefined;
+    wifi_channel?: string | null | undefined;
+    wifi_ssid_5?: string | null | undefined;
+    wifi_password_5?: string | null | undefined;
+    wifi_channel_5?: string | null | undefined;
+    wan_user?: string | null | undefined;
+    wan_password?: string | null | undefined;
+}, "workOrders.get">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+    comentario_id?: number | null | undefined;
+    comentario?: string | null | undefined;
+    usuario?: string | null | undefined;
+    data_cadastro?: string | null | undefined;
+    checklist_id?: number | null | undefined;
+    checklist_descricao?: string | null | undefined;
+    usuario_setores?: unknown[] | null | undefined;
+}[], "workOrders.listComments">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+    id: number;
+    descricao?: string | null | undefined;
+    data_inicial?: string | null | undefined;
+    data_final?: string | null | undefined;
+    observacoes?: string | null | undefined;
+    mensagem_central?: string | null | undefined;
+    mensagem_ura?: string | null | undefined;
+    enviar_sms?: boolean | null | undefined;
+    ativa?: boolean | null | undefined;
+    severidade?: string | null | undefined;
+    status?: string | null | undefined;
+    pops?: unknown[] | null | undefined;
+    nas?: unknown[] | null | undefined;
+    aps?: unknown[] | null | undefined;
+    sources?: unknown[] | null | undefined;
+    switches?: unknown[] | null | undefined;
+    olts?: unknown[] | null | undefined;
+    oltpons?: unknown[] | null | undefined;
+    ctos?: unknown[] | null | undefined;
+    vlans?: unknown[] | null | undefined;
+}[], "maintenance.list">, import("./operation.js").OperationDefinition<{
+    [x: string]: unknown;
+    viabilidade?: boolean | null | undefined;
+}, "coverage.checkAddress">];
 /**
  * Name of every typed operation of the client, as in `SgpError.operation`. `request()` is not one:
  * its `error.operation` is `"request"`, and it declares no sensitivity (see `getSensitivity`).

package/dist/operation.d.ts

@@ -119,10 +119,16 @@ export type RequestBuild = {
 } | {
     ok: false;
     problem: string;
+    /** Value-free issues (field path, then what was expected) that become `error.issues`. */
+    issues?: readonly string[];
 };
-/** A recognized refusal inside a 2xx response. */
+/**
+ * A recognized refusal inside a 2xx response. `effect: "none"` only with a read-back that showed
+ * nothing was created; absent, the effect of a write stays `unknown`.
+ */
 export interface Refusal {
     reason?: string;
+    effect?: "none";
 }
 /**
  * Result of checking a 2xx body. `warnings` lists the non-essential fields the decoder had to drop

package/dist/operations/contracts-check-connection.d.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+declare const connectionsSchema: z.ZodArray<z.ZodObject<{
+    status: z.ZodNumber;
+    msg: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servico_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    contratoId: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    login: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    razaoSocial: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    cpfCnpj: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$loose>>;
+/**
+ * The verdict of SGP on a contract's connection: ALWAYS an array, one item per internet service
+ * (`status`, `msg`, and the service, contract and holder it speaks of). SGP's answer varies: an
+ * array, `[]` when the contract is outside its default filter (observed on a suspended contract
+ * without `status_all`), or ONE bare object (observed on an active contract without `status_all`).
+ * The SDK wraps the bare object, so a consumer reads one shape; `response.body` keeps what SGP sent,
+ * and the paths of `warnings` and `issues` refer to the array form (`[0].login`). `[]` is not
+ * "offline": it means SGP gave no verdict (try `status_all: 1`).
+ */
+export type ContractsCheckConnectionData = z.output<typeof connectionsSchema>;
+/**
+ * Input of `contracts.checkConnection`, named as SGP names the fields. At least one of `contrato`
+ * and `telefone`. `protocolo_ura` is NOT offered: it explicitly asks SGP to open an occurrence (use
+ * `occurrences.create`).
+ */
+export interface ContractsCheckConnectionInput {
+    /** Exercised. The contract to check. */
+    contrato?: number;
+    /** Documented, never sent. The phone of the customer, instead of the contract. */
+    telefone?: string;
+    /**
+     * Exercised. Also checks the contracts the default filter leaves out (suspended ones): without it a
+     * suspended contract answered `[]`. Sent as `1`.
+     */
+    status_all?: 1;
+    /** Documented, never sent. SGP's status filter; its accepted values are not documented. */
+    status_filter?: string;
+    /** Documented, never sent. SGP's URA contact; its meaning and format are not documented. */
+    uracontato?: string;
+}
+/** INTERNAL. Validation of the input, exported so a test can check its keys are classified. */
+export declare const contractsCheckConnectionInputSchema: z.ZodObject<{
+    contrato: z.ZodOptional<z.ZodNumber>;
+    telefone: z.ZodOptional<z.ZodString>;
+    status_all: z.ZodOptional<z.ZodLiteral<1>>;
+    status_filter: z.ZodOptional<z.ZodString>;
+    uracontato: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * INTERNAL definition of `contracts.checkConnection`. A WRITE, though it looks like a read: the
+ * vendor documents that, under an active maintenance, SGP opens an occurrence by default, even
+ * without `protocolo_ura` (never tested). So it is never retried and its failures carry an effect.
+ */
+export declare const contractsCheckConnection: OperationDefinition<ContractsCheckConnectionData, "contracts.checkConnection">;
+export {};

package/dist/operations/contracts-list-services.d.ts

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { type CustomerId } from "../ids.js";
+import type { OperationDefinition } from "../operation.js";
+declare const rowsSchema: z.ZodArray<z.ZodObject<{
+    servico_id: z.ZodPipe<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>, z.ZodNumber>;
+    servico_tipo: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    servico_login: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servico_password: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servico_mac: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servico_online: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    nas_ip: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servicos: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    contrato_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    contrato_status: z.ZodNullable<z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+    contrato_status_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    contrato_status_data: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contrato_cadastro: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contrato_pop_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    contrato_pop_nome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contrato_endereco_ll: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    cliente_id: z.ZodNullable<z.ZodOptional<z.core.$ZodBranded<z.ZodNumber, "CustomerId", "out">>>;
+    cliente_nome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    cliente_email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    cliente_contato: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    endereco_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    endereco_logradouro: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    endereco_numero: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    endereco_complemento: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    endereco_bairro: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    endereco_cidade: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    endereco_uf: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    endereco_pontoreferencia: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    endereco_ll: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    plano_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    plano: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    plano_download: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    plano_upload: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_servicoprestado: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_username: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_ip: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_mac: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_nasipaddress: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_nasportid: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_nasporttype: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_calledstationid: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_acctsessionid: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_radacctid: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    rad_dataconexao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_tempo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_tempo_ordem: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    rad_acctinputoctets: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    rad_acctoutputoctets: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    rad_framedprotocol: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_framedipv6prefix: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    rad_delegatedipv6prefix: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$loose>>;
+/**
+ * The response of `POST /api/suporte/contrato/list/`, in SGP's own shape: a bare array with ONE ROW
+ * PER SERVICE (internet and TV) of the matching contracts, each repeating the customer, contract,
+ * address and plan. `[]` when nothing matches. A row of an ONLINE internet service also carries the
+ * RADIUS session (`rad_*`: user, IP, MAC, NAS, session ids, connection time, octet counters).
+ *
+ * Normalized: `servico_id`, `contrato_id`, `contrato_status_id`, `contrato_pop_id`,
+ * `rad_radacctid`, `rad_tempo_ordem`, `rad_acctinputoctets` and `rad_acctoutputoctets` are numbers
+ * (SGP sends the first four as text); `contrato_status` is trimmed (SGP pads it with spaces). The
+ * row's `servico_id` is an invariant: a row without a numeric one is `INVALID_RESPONSE`.
+ *
+ * It holds PLAINTEXT CREDENTIALS and network identifiers (`servico_password`, `servico_login`,
+ * MACs, IPs, NAS, session ids): see `getSensitivity("contracts.listServices")` and project with
+ * `pick` before logging or handing it on.
+ */
+export type ContractsListServicesData = z.output<typeof rowsSchema>;
+/**
+ * Filters of `contracts.listServices`, named as SGP names them (the vendor's collection documents
+ * all five). All optional, as the vendor marks none as required.
+ *
+ * At least one filter is required: without one SGP lists the services of EVERY customer, with
+ * plaintext service passwords, so the SDK refuses the call locally (`INVALID_INPUT`, `attempts` 0,
+ * nothing sent). There is no paging input. Filter by `contrato_id` whenever you can. Text filters are sent as given; SGP decides how it matches them.
+ */
+export interface ContractsListServicesInput {
+    /** Exercised. Only the services of this contract (the `contrato_id` of a row, a number). */
+    contrato_id?: number;
+    /** Exercised. Only the services of the customer with this id (a `CustomerId`, never a contract id). */
+    cliente_id?: CustomerId;
+    /** Documented, never sent. Only the customer with this name. */
+    cliente_nome?: string;
+    /** Documented, never sent. Only the customer with this CPF/CNPJ. */
+    cliente_cpfcnpj?: string;
+    /** Documented, never sent. Only the service with this login. */
+    servico_login?: string;
+}
+/** INTERNAL. Validation of the input, exported so a test can check its keys are classified. */
+export declare const contractsListServicesInputSchema: z.ZodObject<{
+    contrato_id: z.ZodOptional<z.ZodNumber>;
+    cliente_id: z.ZodOptional<z.core.$ZodBranded<z.ZodNumber, "CustomerId", "out">>;
+    cliente_nome: z.ZodOptional<z.ZodString>;
+    cliente_cpfcnpj: z.ZodOptional<z.ZodString>;
+    servico_login: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** INTERNAL definition of `contracts.listServices`. */
+export declare const contractsListServices: OperationDefinition<ContractsListServicesData, "contracts.listServices">;
+export {};

package/dist/operations/coverage-check-address.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+/**
+ * Input of `coverage.checkAddress`, named as SGP names the fields. The vendor's collection says
+ * "use one of the filters", so at least one is required, or the call is refused locally
+ * (`INVALID_INPUT`, nothing sent). How filters combine is SGP's decision: only `cep` alone and
+ * `cidade` alone were exercised.
+ */
+export interface CoverageCheckAddressInput {
+    /** Exercised. Postal code, as SGP keeps it (digits only in the capture). */
+    cep?: string;
+    /** Exercised. City name, as SGP spells it (upper case in the capture). */
+    cidade?: string;
+    /** Documented, never sent. Street. */
+    logradouro?: string;
+    /** Documented, never sent. Neighborhood. */
+    bairro?: string;
+    /** Documented, never sent. Lowest street number to include (the vendor: "from a street number"). */
+    numero_inicial?: number | string;
+    /** Documented, never sent. Highest street number to include (the vendor: "up to a street number"). */
+    numero_final?: number | string;
+}
+/** INTERNAL. Validation of the input, exported so a test can check its keys are classified. */
+export declare const coverageCheckAddressInputSchema: z.ZodObject<{
+    cep: z.ZodOptional<z.ZodString>;
+    cidade: z.ZodOptional<z.ZodString>;
+    logradouro: z.ZodOptional<z.ZodString>;
+    bairro: z.ZodOptional<z.ZodString>;
+    numero_inicial: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    numero_final: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+}, z.core.$strict>;
+declare const answerSchema: z.ZodObject<{
+    viabilidade: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$loose>;
+/**
+ * The response of `POST /api/ura/viabilidade/`, in SGP's own shape, kept as received. Observed:
+ * `{ "viabilidade": true }` (a postal code) and `{}` (a city alone).
+ *
+ * A MISSING `viabilidade` MEANS UNKNOWN, NEVER "NO COVERAGE": SGP answered `{}` for a city it
+ * could not decide on. Do not read `data.viabilidade ?? false`. The "no coverage" answer was NEVER
+ * OBSERVED: whether SGP sends `false` is not known, so a `false` is passed through as it comes.
+ */
+export type CoverageCheckAddressData = z.output<typeof answerSchema>;
+/** INTERNAL definition of `coverage.checkAddress`. */
+export declare const coverageCheckAddress: OperationDefinition<CoverageCheckAddressData, "coverage.checkAddress">;
+export {};

package/dist/operations/coverage-check.d.ts

@@ -3,8 +3,8 @@ import type { OperationDefinition } from "../operation.js";
 /** Input of `coverage.check`, named as SGP names the fields. All three are required. */
 export interface CoverageCheckInput {
     /**
-     * Exercised. ID of the map gateway SGP checks against. SGP lists them at
-     * `/api/ura/listgatewaymapa`, which has no method here yet (use `request()`).
+     * Exercised. ID of the map gateway SGP checks against. Read the provider's own list with
+     * `coverage.listGateways`, never assume a value.
      */
     gateway: number;
     /** Exercised. Search radius in meters. */
@@ -22,10 +22,10 @@ export declare const coverageCheckInputSchema: z.ZodObject<{
     coordenada: z.ZodString;
 }, z.core.$strict>;
 declare const ctoSchema: z.ZodObject<{
-    lat: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
-    lng: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
-    distancia: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
-    id: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    lat: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    lng: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    distancia: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
     nome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
 }, z.core.$loose>;
 /** One CTO (the nearest network box) within the radius, as the gateway reports it. */
@@ -34,7 +34,8 @@ export type CoverageCto = z.output<typeof ctoSchema>;
  * The response of `GET /api/ura/viabilidadeinstalacao`, in SGP's own shape: an array whose
  * element is an object keyed by the gateway's own name (`"SGPMaps"`, `"Geogrid"`: data-defined),
  * holding either the CTOs within the radius or a message (`"Localização inviável"`) when there
- * are none. Nothing is converted: Geogrid's numeric strings stay strings.
+ * are none. A CTO's `lat`, `lng`, `distancia` and `id` are numbers (`null` for `""`/`null`): Geogrid's
+ * numeric strings are converted, SGPMaps' numbers pass through (changed versus 2.0.0-beta.1).
  */
 export type CoverageCheckData = Array<Record<string, string | CoverageCto[]>>;
 /** INTERNAL definition of `coverage.check`. */

package/dist/operations/coverage-list-gateways.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+declare const gatewaysSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    descricao: z.ZodString;
+    gateway: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$loose>>;
+/**
+ * The response of `GET /api/ura/listgatewaymapa`, in SGP's own shape: a bare array with one entry
+ * per map gateway (SGP "Mapa FTTH"). The `id` is the `gateway` that `coverage.check` takes. The
+ * route is not paginated, so there is no envelope and no total.
+ */
+export type CoverageListGatewaysData = z.output<typeof gatewaysSchema>;
+/** INTERNAL definition of `coverage.listGateways`. */
+export declare const coverageListGateways: OperationDefinition<CoverageListGatewaysData, "coverage.listGateways">;
+export {};

package/dist/operations/crm-customers-create.d.ts

@@ -16,7 +16,17 @@ interface CrmCustomerAddress extends SgpAddress {
 interface CrmCustomerCreateCommon {
     /** Exercised. Customer name; for a company, its corporate name. Required. SGP refuses digits in it (400). */
     nome: string;
-    /** Exercised. CPF (`F`) or CNPJ (`J`), in the format SGP stores it. Required. */
+    /**
+     * Exercised. Required. A CPF on `personType: "F"`, a CNPJ on `"J"`. The SDK sends it in the
+     * canonical mask the base holds (the CRM already stores it that way). After removing `.`, `-`,
+     * `/` and spaces: exactly 11 digits go as `999.999.999-99` (`F`); exactly 14 alphanumerics, the
+     * last 2 digits, go as `AA.AAA.AAA/AAAA-99`, letters uppercased as the Receita writes them
+     * (`J`). An input already in the mask goes unchanged. Anything else is refused locally:
+     * `INVALID_INPUT`, `error.issues` is `["cpfcnpj: expected ..."]`, `attempts` 0, nothing sent,
+     * `effect` `"none"`. That covers a wrong length, other characters, letters in a CPF or in the
+     * last 2 positions of a CNPJ, and the wrong kind for the route (a CNPJ on `F`, a CPF on `J`).
+     * Format only: the check digits are not verified.
+     */
     cpfcnpj: string;
     /** Exercised. Required. Sent nested (`endereco`) and also as loose fields beside it, the two formats the route reads. */
     endereco: CrmCustomerAddress;
@@ -77,7 +87,7 @@ export type CrmCustomerCreateInput = CrmCustomerCreateIndividualInput | CrmCusto
 /** INTERNAL. Validation of the input, exported so a test can check it against the public types. */
 export declare const crmCustomersCreateInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     nome: z.ZodString;
-    cpfcnpj: z.ZodString;
+    cpfcnpj: z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
     endereco: z.ZodObject<{
         numero: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
         complemento: z.ZodOptional<z.ZodString>;
@@ -115,7 +125,7 @@ export declare const crmCustomersCreateInputSchema: z.ZodDiscriminatedUnion<[z.Z
     naturalidade: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     nome: z.ZodString;
-    cpfcnpj: z.ZodString;
+    cpfcnpj: z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
     endereco: z.ZodObject<{
         numero: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
         complemento: z.ZodOptional<z.ZodString>;

package/dist/operations/customers-list.d.ts

@@ -84,6 +84,11 @@ export interface CustomersListInput {
     cpfcnpj?: string;
     /** Customers whose name matches, as SGP matches it. */
     cliente_nome?: string;
+    /**
+     * Only the customer whose service has exactly this PPPoE login (exact match, observed live: a
+     * different or partial login lists nothing). Secret: never log it.
+     */
+    login?: string;
 }
 /** INTERNAL. Validation of the input, exported so a test can check its keys are classified. */
 export declare const customersListInputSchema: z.ZodObject<{
@@ -92,6 +97,7 @@ export declare const customersListInputSchema: z.ZodObject<{
     cliente_id: z.ZodOptional<z.core.$ZodBranded<z.ZodNumber, "CustomerId", "out">>;
     cpfcnpj: z.ZodOptional<z.ZodString>;
     cliente_nome: z.ZodOptional<z.ZodString>;
+    login: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 /** INTERNAL definition of `customers.list`. */
 export declare const customersList: OperationDefinition<CustomersListData, "customers.list">;