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

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

@@ -11,7 +11,7 @@ declare const pageSchema: z.ZodObject<{
     titulos: z.ZodArray<z.ZodObject<{
         id: z.ZodNumber;
         status: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        valor: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        valor: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
         dataVencimento: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         clienteNome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         clienteCpfcnpj: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -21,10 +21,10 @@ declare const pageSchema: z.ZodObject<{
         nossoNumero: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         link: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         link_cobranca: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-        valorDesconto: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-        valorCorrigido: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-        valorPago: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
-        valorPagoParcial: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        valorDesconto: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+        valorCorrigido: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+        valorPago: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+        valorPagoParcial: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
         codigoBarras: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         linhaDigitavel: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         codigoPix: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -48,6 +48,12 @@ declare const pageSchema: z.ZodObject<{
  * - `parcial`: how many invoices this page holds (observed equal to `titulos.length`);
  * - `total`: how many invoices match the filters in all, across every page.
  *
+ * Money is normalized: `valor`, `valorDesconto`, `valorCorrigido`, `valorPago` and
+ * `valorPagoParcial` are a `number` (reais) or `null`. SGP sends `valor` as a number or as `""` for an
+ * absent amount (`null`, never `0`); numeric text with `.` is read as a number; formatted text such
+ * as `"1.234,56"` is never guessed: the field leaves `data` with a warning and stays in
+ * `response.body`. Changed versus 2.0.0-beta.1 (where `""` dropped the field).
+ *
  * `total` is SGP's and never computed by the SDK: a page without a numeric `total` is
  * `INVALID_RESPONSE`. Nothing here fetches the next page: ask for it with `offset`.
  */

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

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+declare const maintenancesSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    descricao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    data_inicial: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    data_final: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    observacoes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    mensagem_central: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    mensagem_ura: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    enviar_sms: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    ativa: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    severidade: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    status: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    pops: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    nas: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    aps: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    sources: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    switches: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    olts: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    oltpons: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    ctos: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    vlans: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+}, z.core.$loose>>;
+/**
+ * The response of `GET /api/ura/manutencao/list/`, in SGP's own shape: a bare array with one entry
+ * per maintenance notice (SGP "manutenção"), INACTIVE ONES INCLUDED (the one capture held three
+ * past notices, all with `ativa: false`). The route takes no filter, is not paginated and has no
+ * envelope or total: filter by `ativa` and by the period (`data_inicial`, `data_final`) yourself.
+ * An empty array means no notice.
+ */
+export type MaintenanceListData = z.output<typeof maintenancesSchema>;
+/** INTERNAL definition of `maintenance.list`. */
+export declare const maintenanceList: OperationDefinition<MaintenanceListData, "maintenance.list">;
+export {};

package/dist/operations/occurrences-create.d.ts

@@ -4,6 +4,10 @@ import type { OperationDefinition } from "../operation.js";
  * Input of `occurrences.create`, named as SGP names the fields. An occurrence (SGP "chamado" or
  * "ocorrência") is the support ticket; SGP opens a work order (OS) with it unless told not to
  * (`desativa_os`). Only `contrato` is required.
+ *
+ * Observed live: an occurrence WITHOUT `motivoos` is accepted and SGP still creates a work order;
+ * `status_encerrado: 1` closes both the occurrence and the work order; closing an installation work
+ * order (`motivoos` 10) did not change the contract status (it stayed inactive; observed once).
  */
 export interface OccurrenceCreateInput {
     /** ID of the contract. Required. */
@@ -51,7 +55,12 @@ export interface OccurrenceCreateInput {
     responsavel?: string;
     /** Usernames of the auxiliary technicians. Staff usernames: personal data. */
     tecnicos?: string[];
-    /** Schedules the occurrence and the work order: `AAAA-MM-DD HH:MM`. */
+    /**
+     * Schedules the occurrence and the work order. Send `AAAA-MM-DD HH:MM` (the format SGP's refusal names): SGP
+     * refused seconds (`2026-11-13 09:00:00`), observed once live with HTTP 200 and `status` 0 (`REJECTED`, reason
+     * `INVALID_SCHEDULE`, effect `none`). SGP decides what is a valid date, so the SDK does not check
+     * the format before sending.
+     */
     data_hora_agendamento?: string;
     /** `1` warns the responsible technician; needs `data_hora_agendamento` and a messaging gateway in SGP. */
     sms_tecnico?: 0 | 1;

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

@@ -0,0 +1,127 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+declare const pageSchema: z.ZodObject<{
+    paginacao: z.ZodObject<{
+        offset: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        limit: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        parcial: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        total: z.ZodNumber;
+    }, z.core.$loose>;
+    ocorrencias: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        cliente: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contrato: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        contrato_status: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contrato_status_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        pop: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        numero: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        status: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        status_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        data_cadastro: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        data_agendamento: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        data_finalizacao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        tipo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        metodo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        conteudo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        responsavel: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        usuario: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        usuario_finalizacao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        protocolos_externos: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+        servico: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+        comentarios: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+        ordens_servicos: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            status: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            status_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            data_cadastro: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            data_agendamento: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            data_finalizacao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            tipo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            tipo_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            motivo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            pop: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            conteudo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            responsavel: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            tecnicos_auxiliares: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+            usuario: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            usuario_finalizacao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$loose>>>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/**
+ * One page of `POST /api/ura/ocorrencia/list/`, with SGP's own `paginacao`, returned as received:
+ *
+ * - `offset`: index of the first occurrence of the page (SGP starts at 0);
+ * - `limit`: page size SGP applied, which may differ from the one requested;
+ * - `parcial`: how many occurrences this page holds (observed equal to `ocorrencias.length`);
+ * - `total`: how many occurrences match the filters in all, across every page.
+ *
+ * `total` is SGP's and never computed by the SDK: a page without a numeric `total` is
+ * `INVALID_RESPONSE`. Nothing here fetches the next page: ask for it with `offset`. Each
+ * occurrence carries its work orders in `ordens_servicos`; their `id` is the work order id.
+ */
+export type OccurrencesListData = z.output<typeof pageSchema>;
+/**
+ * Filters and paging of `occurrences.list`, named as SGP names them (the vendor's collection
+ * documents them). All optional: the vendor marks none as required.
+ *
+ * At least one filter is required: without one SGP lists the occurrences of EVERY customer (the
+ * vendor documents up to 1000 per call), with names and free text, so the SDK refuses the call
+ * locally (`INVALID_INPUT`, `attempts` 0, nothing sent). `offset` and `limit` are paging, not
+ * filters, and do not count. Filter by `contrato` whenever you can. The vendor also documents the array filters
+ * `pop` and `tipo` and the hour filters (`hora_*`); they are not offered here, and no key other
+ * than those below is accepted.
+ */
+export interface OccurrencesListInput {
+    /** Documented, never sent. Index of the first occurrence of the page; SGP starts at 0. */
+    offset?: number;
+    /** Exercised (with `contrato`). Occurrences per page. Non-negative integer; the vendor caps it at 1000. */
+    limit?: number;
+    /**
+     * Documented, never sent. Only the occurrence with this number (`numero` of the result; the vendor
+     * calls it "Número da Ocorrência"). Text, as SGP keeps it.
+     */
+    ocorrencia?: string;
+    /**
+     * Documented, never sent. Status id of the occurrence (`status_id` of the result). The vendor
+     * lists 0 Aberta, 1 Encerrada, 2 Em execução, 3 Pendente.
+     */
+    status?: number;
+    /** Exercised. Only the occurrences of this contract (the `contrato` of the result). */
+    contrato?: number;
+    /**
+     * Documented, never sent. Status id of the contract (`contrato_status_id` of the result), the
+     * values of `CONTRACT_STATUS`.
+     */
+    contrato_status?: number;
+    /** Documented, never sent. Registration date from, `AAAA-MM-DD`; use with `data_cadastro_fim`. */
+    data_cadastro_inicio?: string;
+    /** Documented, never sent. Registration date until, `AAAA-MM-DD`; use with the initial one. */
+    data_cadastro_fim?: string;
+    /** Documented, never sent. Scheduling date from, `AAAA-MM-DD`; use with `data_agendamento_fim`. */
+    data_agendamento_inicio?: string;
+    /** Documented, never sent. Scheduling date until, `AAAA-MM-DD`; use with the initial one. */
+    data_agendamento_fim?: string;
+    /** Documented, never sent. Closing date from, `AAAA-MM-DD`; use with `data_finalizacao_fim`. */
+    data_finalizacao_inicio?: string;
+    /** Documented, never sent. Closing date until, `AAAA-MM-DD`; use with the initial one. */
+    data_finalizacao_fim?: string;
+}
+/** INTERNAL. Validation of the input, exported so a test can check its keys are classified. */
+export declare const occurrencesListInputSchema: z.ZodObject<{
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    ocorrencia: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodNumber>;
+    contrato: z.ZodOptional<z.ZodNumber>;
+    contrato_status: z.ZodOptional<z.ZodNumber>;
+    data_cadastro_inicio: z.ZodOptional<z.ZodString>;
+    data_cadastro_fim: z.ZodOptional<z.ZodString>;
+    data_agendamento_inicio: z.ZodOptional<z.ZodString>;
+    data_agendamento_fim: z.ZodOptional<z.ZodString>;
+    data_finalizacao_inicio: z.ZodOptional<z.ZodString>;
+    data_finalizacao_fim: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** INTERNAL definition of `occurrences.list`. */
+export declare const occurrencesList: OperationDefinition<OccurrencesListData, "occurrences.list">;
+export {};

package/dist/operations/pre-registrations-create.d.ts

@@ -23,7 +23,18 @@ interface PreRegistrationAddress extends SgpAddress {
 interface PreRegistrationCreateCommon extends PreRegistrationAddress {
     /** Exercised. Customer name; for a company, its corporate name. Required by SGP. */
     nome: string;
-    /** Exercised. CPF (`F`) or CNPJ (`J`), in the format SGP stores it. */
+    /**
+     * Exercised. A CPF on `personType: "F"`, a CNPJ on `"J"`. SGP stores it exactly as sent, so the
+     * SDK sends it in the canonical mask the rest of the base holds (a digits-only one escaped the
+     * CRM duplicate check). 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, an empty text included, 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`). Omit the key to send no
+     * document. Format only: the check digits are not verified.
+     */
     cpfcnpj?: string;
     /** Exercised. Contact e-mail. */
     email?: string;
@@ -144,7 +155,7 @@ export declare const preRegistrationsCreateInputSchema: z.ZodDiscriminatedUnion<
     map_ll: z.ZodOptional<z.ZodString>;
     condominio: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     nome: z.ZodString;
-    cpfcnpj: z.ZodOptional<z.ZodString>;
+    cpfcnpj: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
     logradouro: z.ZodString;
     email: z.ZodOptional<z.ZodString>;
     celular: z.ZodOptional<z.ZodString>;
@@ -204,7 +215,7 @@ export declare const preRegistrationsCreateInputSchema: z.ZodDiscriminatedUnion<
     map_ll: z.ZodOptional<z.ZodString>;
     condominio: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     nome: z.ZodString;
-    cpfcnpj: z.ZodOptional<z.ZodString>;
+    cpfcnpj: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
     logradouro: z.ZodString;
     email: z.ZodOptional<z.ZodString>;
     celular: z.ZodOptional<z.ZodString>;
@@ -240,13 +251,25 @@ export declare const preRegistrationsCreateInputSchema: z.ZodDiscriminatedUnion<
     respcpf: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>], "personType">;
 /**
- * Success body of `POST /api/precadastro/{F|J}`: SGP's `message`. It carries no ID of the customer,
- * the contract or the pré-cadastro. Other keys SGP may add are kept.
+ * Success body of `POST /api/precadastro/{F|J}`: SGP's `message` and, when it sends them, the
+ * IDs it created: `precadastro_id`, `new_cliente_id` (the `CustomerId` that `customers.list` shows)
+ * and `new_contrato_id` (a contract is created only with a sufficient plan and billing data). The
+ * three are optional, not invariants: older records list only `message` (the 1.x decoder dropped
+ * unknown keys, so whether the IDs were sent before is unknown), and a missing ID is never
+ * fabricated. Numbers are normalized (a numeric text becomes a number, `""` becomes `null`).
+ * Other keys SGP may add are kept.
  */
 declare const createdSchema: z.ZodObject<{
     message: z.ZodString;
+    precadastro_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    new_cliente_id: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>, z.ZodNullable<z.core.$ZodBranded<z.ZodNumber, "CustomerId", "out">>>>;
+    new_contrato_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
 }, z.core.$loose>;
-/** Response of `preRegistrations.create`. */
+/**
+ * Response of `preRegistrations.create`. When SGP answers with the IDs it created, take them from
+ * here (`new_cliente_id`, `new_contrato_id`, `precadastro_id`); when they are absent, read the
+ * customer back with `customers.list({ cpfcnpj })`, as before. The SDK never fabricates them.
+ */
 export type PreRegistrationCreateData = z.output<typeof createdSchema>;
 /** INTERNAL definition of `preRegistrations.create`. */
 export declare const preRegistrationsCreate: OperationDefinition<PreRegistrationCreateData, "preRegistrations.create">;

package/dist/operations/pre-registrations-list-plans.d.ts

@@ -7,8 +7,8 @@ declare const preRegistrationPlansSchema: z.ZodArray<z.ZodObject<{
     descricao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     observacao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     gateway: z.ZodNullable<z.ZodOptional<z.ZodObject<{
-        gateway_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
-        id: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        gateway_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+        id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
         descricao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, z.core.$loose>>>;
 }, z.core.$loose>>;

package/dist/operations/services-add-generic.d.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+import type { PlanId } from "./plans-list.js";
+/** Input of `services.addGeneric`, named as SGP names the fields. */
+export interface ServiceAddGenericInput {
+    /**
+     * Exercised only in the refused call. ID of the contract; SGP's TV route refuses a contract
+     * that is not active, and this route is not known to differ.
+     */
+    clientecontrato_id: number;
+    /**
+     * Exercised only with a plan of another type, which SGP refused (400). ID of a plan of the
+     * generic type: a `PlanId` from the URA plan list (`plans.list`), where the provider has created
+     * one in the panel (Administração > Planos > Cadastrar > Serviços). SGP refuses any other plan
+     * type. Whether the URA list shows generic plans is not confirmed.
+     */
+    planobase_id: PlanId;
+    /**
+     * Sent in the refused call (which was refused for its plan), so its effect on a service is
+     * unobserved. Free-text description of the service. Personal data: never log it.
+     */
+    descricao?: string;
+    /** Documented, never sent. The panel's "Gateway ID". Treated as a network identifier. */
+    identificador_gateway?: string;
+    /** Documented, never sent. The panel's "Gateway Extra". Treated as a network identifier. */
+    identificador_gateway_extra?: string;
+    /** Documented, never sent. Login of the service. Secret: never log it. */
+    login?: string;
+    /** Documented, never sent. Password of the service. Secret: never log it. */
+    senha?: string;
+}
+/** INTERNAL. Validation of the input, exported so a test can check it against the public type. */
+export declare const servicesAddGenericInputSchema: z.ZodObject<{
+    clientecontrato_id: z.ZodNumber;
+    planobase_id: z.core.$ZodBranded<z.ZodNumber, "PlanId", "out">;
+    descricao: z.ZodOptional<z.ZodString>;
+    identificador_gateway: z.ZodOptional<z.ZodString>;
+    identificador_gateway_extra: z.ZodOptional<z.ZodString>;
+    login: z.ZodOptional<z.ZodString>;
+    senha: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Success body of `POST /api/servico/generico`: documented, never observed (the provider has no
+ * generic plan, and plans are not created for tests). Nothing is assumed beyond a JSON object;
+ * whatever SGP sends is kept as received.
+ */
+declare const genericAddedSchema: z.ZodObject<{}, z.core.$loose>;
+/** Response of `services.addGeneric`: the JSON object SGP sent, unread. */
+export type ServiceAddGenericData = z.output<typeof genericAddedSchema>;
+/** INTERNAL definition of `services.addGeneric`. */
+export declare const servicesAddGeneric: OperationDefinition<ServiceAddGenericData, "services.addGeneric">;
+export {};

package/dist/operations/services-add-tv.d.ts

@@ -32,12 +32,12 @@ export declare const servicesAddTvInputSchema: z.ZodObject<{
 }, z.core.$strict>;
 /**
  * Success body of `POST /api/servico/tv` (HTTP 201): SGP's `msg`, the new `servico_id` (a number)
- * and `clientecontrato_id`, which SGP sends as a string (`"<n>"`) and is kept as such. Other keys
- * SGP may add are kept.
+ * and `clientecontrato_id`, which SGP sends as text (`"<n>"`) and `data` carries as a number
+ * (changed versus 2.0.0-beta.1). Other keys SGP may add are kept.
  */
 declare const tvAddedSchema: z.ZodObject<{
     msg: z.ZodString;
-    clientecontrato_id: z.ZodOptional<z.ZodString>;
+    clientecontrato_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
     servico_id: z.ZodNumber;
 }, z.core.$loose>;
 /** Response of `services.addTv`. */

package/dist/operations/services-remove-generic.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+/** Input of `services.removeGeneric`, named as SGP names the fields. */
+export interface ServiceRemoveGenericInput {
+    /**
+     * Documented, never sent. ID of the generic serviço to remove (the id of the service that
+     * `services.addGeneric` created; read it from the contract with `customers.list`).
+     */
+    servico_id: number;
+    /** Documented, never sent. ID of the contract the serviço belongs to. */
+    clientecontrato_id: number;
+}
+/** INTERNAL. Validation of the input, exported so a test can check it against the public type. */
+export declare const servicesRemoveGenericInputSchema: z.ZodObject<{
+    servico_id: z.ZodNumber;
+    clientecontrato_id: z.ZodNumber;
+}, z.core.$strict>;
+/**
+ * Success body of `DELETE /api/servico/generico/{servico_id}`: documented, never observed (no
+ * generic service was ever created, so none could be removed). Nothing is assumed beyond a JSON
+ * object; whatever SGP sends is kept as received.
+ */
+declare const genericRemovedSchema: z.ZodObject<{}, z.core.$loose>;
+/** Response of `services.removeGeneric`: the JSON object SGP sent, unread. */
+export type ServiceRemoveGenericData = z.output<typeof genericRemovedSchema>;
+/** INTERNAL definition of `services.removeGeneric`. */
+export declare const servicesRemoveGeneric: OperationDefinition<ServiceRemoveGenericData, "services.removeGeneric">;
+export {};

package/dist/operations/services-remove-tv.d.ts

@@ -14,12 +14,12 @@ export declare const servicesRemoveTvInputSchema: z.ZodObject<{
 }, z.core.$strict>;
 /**
  * Success body of `DELETE /api/servico/tv/{servico_id}`: SGP's `msg`, the removed `servico_id` (a
- * number) and `clientecontrato_id`, which SGP sends as a string and is kept as such. Other keys SGP
- * may add are kept.
+ * number) and `clientecontrato_id`, which SGP sends as text and `data` carries as a number (changed
+ * versus 2.0.0-beta.1). Other keys SGP may add are kept.
  */
 declare const tvRemovedSchema: z.ZodObject<{
     msg: z.ZodString;
-    clientecontrato_id: z.ZodOptional<z.ZodString>;
+    clientecontrato_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
     servico_id: z.ZodNumber;
 }, z.core.$loose>;
 /** Response of `services.removeTv`. */

package/dist/operations/work-orders-get.d.ts

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+declare const workOrderDetailSchema: z.ZodObject<{
+    os_id: z.ZodNumber;
+    os_protocolo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_status: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    os_status_txt: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_prioridade: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    os_motivo_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    os_motivo_descricao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_data_cadastro: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_data_agendamento: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_data_finalizacao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_conteudo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_observacao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_anotacao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_servicoprestado: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_setor_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    os_setor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_tecnico_responsavel: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_tecnicos_auxiliares: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    os_agendamento_confirmado: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    os_agendamento_confirmacao_data: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_agendamento_confirmacao_status: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    os_agendamento_confirmacao_status_txt: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    os_close_edit: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    os_encerrada_impedir_estorno: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    os_encerrada_impedir_lancamento_avulso: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    os_finalizada_permite_add_imagem: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    os_lancamento_comodato: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    os_djson: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    comentarios: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+    cliente_id: z.ZodNullable<z.ZodOptional<z.core.$ZodBranded<z.ZodNumber, "CustomerId", "out">>>;
+    cliente: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    cliente_email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    cliente_contato: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contrato_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    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_pop_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    contrato_pop: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contrato_endereco_ll: 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>>;
+    servico_id: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<number | null, unknown>>>;
+    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_online: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+    servico_mac: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servico_ip: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servico_online_mac: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servico_online_ip: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    servico_online_ipv6_pd: z.ZodOptional<z.ZodUnknown>;
+    nas_ip: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    wifi_ssid: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    wifi_password: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    wifi_channel: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    wifi_ssid_5: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    wifi_password_5: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    wifi_channel_5: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    wan_user: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    wan_password: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$loose>;
+/**
+ * The response of `POST /api/os/list/id/{id}`, in SGP's own shape: ONE flat object with the work
+ * order, its customer, contract, address, plan and service together (72 fields observed). The
+ * vendor's collection shows a one-element array; SGP sent the bare object. Most fields are as
+ * received; normalized (changed versus 2.0.0-beta.1): `servico_id`, `contrato_status_id` and
+ * `os_setor_id` are numbers (`""` becomes `null`) and `contrato_status` is trimmed.
+ *
+ * It holds PLAINTEXT CREDENTIALS (`servico_password`, `wan_password`, `wifi_password`,
+ * `wifi_password_5`) and the customer's data: see `getSensitivity("workOrders.get")`.
+ */
+export type WorkOrdersGetData = z.output<typeof workOrderDetailSchema>;
+/** Input of `workOrders.get`, named as SGP names the path parameter. */
+export interface WorkOrdersGetInput {
+    /** Exercised. The id of the work order (the `id` of `workOrders.list`; `os_id` in the result). */
+    id: number;
+}
+/** INTERNAL. Validation of the input, exported so a test can check it against the public type. */
+export declare const workOrdersGetInputSchema: z.ZodObject<{
+    id: z.ZodNumber;
+}, z.core.$strict>;
+/** INTERNAL definition of `workOrders.get`. */
+export declare const workOrdersGet: OperationDefinition<WorkOrdersGetData, "workOrders.get">;
+export {};

package/dist/operations/work-orders-list-comments.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { OperationDefinition } from "../operation.js";
+declare const commentsSchema: z.ZodArray<z.ZodObject<{
+    comentario_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    comentario: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    usuario: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    data_cadastro: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    checklist_id: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    checklist_descricao: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    usuario_setores: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
+}, z.core.$loose>>;
+/**
+ * The response of `GET /api/os/{id}/comentario/list/`, in SGP's own shape: a bare array with one
+ * entry per comment of the work order. The route is not paginated, so there is no envelope and no
+ * total. An empty array means no comment.
+ *
+ * DOCUMENTED ONLY: the one live read returned `[]`. The item fields (`comentario_id`,
+ * `comentario`, `usuario`, `data_cadastro`, `checklist_id`, `checklist_descricao`,
+ * `usuario_setores`) come from the vendor's collection and were never seen; an element that is not
+ * an object fails the response (`INVALID_RESPONSE`), as everywhere in the client.
+ */
+export type WorkOrdersListCommentsData = z.output<typeof commentsSchema>;
+/** Input of `workOrders.listComments`, named as SGP names the path parameter. */
+export interface WorkOrdersListCommentsInput {
+    /** Exercised. The id of the work order (the `id` of `workOrders.list`). */
+    id: number;
+}
+/** INTERNAL. Validation of the input, exported so a test can check it against the public type. */
+export declare const workOrdersListCommentsInputSchema: z.ZodObject<{
+    id: z.ZodNumber;
+}, z.core.$strict>;
+/** INTERNAL definition of `workOrders.listComments`. */
+export declare const workOrdersListComments: OperationDefinition<WorkOrdersListCommentsData, "workOrders.listComments">;
+export {};

package/dist/result.d.ts

@@ -64,7 +64,11 @@ export interface SgpError {
     effect?: Effect;
     /** Projection of the SGP error fields found in the response body. */
     sgp?: SgpErrorFields;
-    /** On `INVALID_RESPONSE`: the paths that broke the contract, never values. */
+    /**
+     * On `INVALID_RESPONSE`: the paths that broke the contract, never values. On `INVALID_INPUT`:
+     * only when the SDK names the broken field (a `cpfcnpj` in a format no storing write accepts:
+     * `"cpfcnpj: expected ..."`); most local refusals carry none.
+     */
     issues?: readonly string[];
 }
 /** A hook that threw. Only its name and the attempt it ran on are kept, never the thrown value. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sgp-sdk",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.2",
   "description": "Unofficial TypeScript client for the SGP (TSMX) ISP ERP HTTP API, with normalized errors and explicit write outcomes. Not affiliated with TSMX.",
   "license": "MIT",
   "type": "module",