@acteo/api 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -14,6 +14,35 @@ type TipVerificare = typeof TipVerificare.Type;
14
14
  declare const StatusDocument: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
15
15
  /** Starea documentului: `"valid"`, `"warning"`, `"expired"` sau `"not_found"`. Vezi {@link StatusDocument}. */
16
16
  type StatusDocument = typeof StatusDocument.Type;
17
+ /**
18
+ * Codurile stabile pe care API-ul le pune in `code`, in ordinea din documentatie.
19
+ * Primele opt sunt cele din contract:
20
+ * - `UPSTREAM_UNAVAILABLE`: sursa oficiala nu raspunde sau raspunde cu eroare;
21
+ * - `UPSTREAM_TIMEOUT`: sursa oficiala nu a raspuns in intervalul maxim;
22
+ * - `UPSTREAM_BLOCKED`: accesul la sursa oficiala e restrictionat temporar;
23
+ * - `UPSTREAM_CHANGED`: structura sursei s-a modificat, serviciul e in adaptare;
24
+ * - `DAILY_LIMIT_REACHED`: limita zilnica a planului, se reseteaza la miezul noptii (ora Romaniei);
25
+ * - `PLAN_LIMIT_REACHED`: limita lunara, sau plafonul consumului peste plan;
26
+ * - `NOT_FOUND`: identificatorul nu exista la sursa oficiala;
27
+ * - `INVALID_IDENTIFIER`: sursa oficiala a respins identificatorul ca invalid.
28
+ *
29
+ * Restul tin de un produs anume: `SOLD_INSUFICIENT`, `PLAFON_NETAXAT`, `OCUPAT`,
30
+ * `INDISPONIBIL`, `VIN_NEDECODAT`, `VIN_INVALID`, `ARR_NECESITA_PLAN`, `LIMIT_ATINS`
31
+ * (numarul de masini din plan), `VEHICUL_EXISTENT`, `NEGASIT`, `LIMITA_FLOTA_ATINSA`.
32
+ */
33
+ declare const CODURI_EROARE: readonly ["UPSTREAM_UNAVAILABLE", "UPSTREAM_TIMEOUT", "UPSTREAM_BLOCKED", "UPSTREAM_CHANGED", "DAILY_LIMIT_REACHED", "PLAN_LIMIT_REACHED", "NOT_FOUND", "INVALID_IDENTIFIER", "SOLD_INSUFICIENT", "PLAFON_NETAXAT", "OCUPAT", "INDISPONIBIL", "VIN_NEDECODAT", "VIN_INVALID", "ARR_NECESITA_PLAN", "LIMIT_ATINS", "VEHICUL_EXISTENT", "NEGASIT", "LIMITA_FLOTA_ATINSA"];
34
+ /**
35
+ * Un cod din {@link CODURI_EROARE}. Tipul accepta si alte valori, ca un cod adaugat
36
+ * ulterior de API sa nu strice compilarea.
37
+ */
38
+ type CodEroare = (typeof CODURI_EROARE)[number] | (string & {});
39
+ /**
40
+ * De ce s-a incheiat o verificare cu `status: "error"`:
41
+ * - `INVALID_IDENTIFIER`: sursa a refuzat datele trimise; campul e in `cod` ({@link CodRefuzSursa});
42
+ * - `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`: sursa
43
+ * oficiala nu a dat un raspuns; reia mai tarziu cu o cerere noua.
44
+ */
45
+ type CodEsecVerificare = "INVALID_IDENTIFIER" | "UPSTREAM_UNAVAILABLE" | "UPSTREAM_TIMEOUT" | "UPSTREAM_BLOCKED" | "UPSTREAM_CHANGED" | (string & {});
17
46
  declare const RezultatVerificareSchema: Schema.Struct<{
18
47
  /** Tipul verificarii. */
19
48
  tip: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
@@ -23,12 +52,14 @@ declare const RezultatVerificareSchema: Schema.Struct<{
23
52
  numarInmatriculare: Schema.NullOr<typeof Schema.String>;
24
53
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
25
54
  serieSasiu: Schema.NullOr<typeof Schema.String>;
26
- /** Cand a fost interogata sursa oficiala. */
55
+ /** Momentul verificarii. */
27
56
  checkedAt: typeof Schema.Date;
28
57
  /** Starea documentului. Vezi {@link StatusDocument}. */
29
58
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
30
59
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
31
60
  expiresAt: Schema.NullOr<typeof Schema.Date>;
61
+ /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
62
+ code: Schema.optional<typeof Schema.String>;
32
63
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
33
64
  requestId: Schema.optional<typeof Schema.String>;
34
65
  /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
@@ -98,21 +129,25 @@ declare const WebhookRezultatSchema: Schema.Struct<{
98
129
  numarInmatriculare: Schema.NullOr<typeof Schema.String>;
99
130
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
100
131
  serieSasiu: Schema.NullOr<typeof Schema.String>;
101
- /** Cand a fost interogata sursa oficiala. */
132
+ /** Momentul verificarii. */
102
133
  checkedAt: typeof Schema.Date;
103
134
  /** Starea documentului. Vezi {@link StatusDocument}. */
104
135
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
105
136
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
106
137
  expiresAt: Schema.NullOr<typeof Schema.Date>;
138
+ /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
139
+ code: Schema.optional<typeof Schema.String>;
107
140
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
108
141
  requestId: Schema.optional<typeof Schema.String>;
109
142
  /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
110
143
  hint: Schema.optional<typeof Schema.String>;
111
144
  }>>;
112
- /** Cand a fost interogata sursa, `null` la eroare. */
145
+ /** Momentul verificarii, `null` la eroare. */
113
146
  checkedAt: Schema.NullOr<typeof Schema.Date>;
114
147
  /** Mesajul de eroare, doar la `status: "error"`. */
115
148
  error: Schema.optional<typeof Schema.String>;
149
+ /** La `status: "error"`, motivul ({@link CodEsecVerificare}); la `status: "not_found"`, `"NOT_FOUND"`. */
150
+ code: Schema.optional<typeof Schema.String>;
116
151
  }>;
117
152
  /** Payloadul POST trimis la `callbackUrl` cand o verificare se termina. */
118
153
  type WebhookRezultat = typeof WebhookRezultatSchema.Type;
@@ -752,8 +787,12 @@ interface DateEroare {
752
787
  readonly message: string;
753
788
  /** Statusul HTTP, cand eroarea vine dintr-un raspuns. */
754
789
  readonly status?: number;
755
- /** Codul masinii (`LIMIT_ATINS`, `VEHICUL_EXISTENT`, `NEGASIT` etc.). */
756
- readonly cod?: string;
790
+ /**
791
+ * Codul masinii. De la API vine unul din {@link CodEroare} (`DAILY_LIMIT_REACHED`,
792
+ * `UPSTREAM_TIMEOUT`, `VEHICUL_EXISTENT` etc.); SDK-ul pune singur cateva coduri
793
+ * locale (`VALIDARE_LOCALA`, `TIMEOUT_VERIFICARE`, `PREA_MULTE_CERERI`).
794
+ */
795
+ readonly cod?: CodEroare;
757
796
  /** Indicatia API-ului despre cum se rezolva problema. */
758
797
  readonly hint?: string;
759
798
  /** Corpul brut al raspunsului, pentru depanare. */
@@ -781,7 +820,7 @@ declare class EroareConfigurare extends VerificRcaError {
781
820
  /**
782
821
  * Datele trimise sunt invalide. Apare fie local, inainte de orice cerere (nu se
783
822
  * consuma nimic din cota), fie ca raspuns 400 de la API, fie ca 422 cand sursa
784
- * oficiala refuza valoarea (ex: `NUMAR_RESPINS` la numerele disponibile).
823
+ * oficiala refuza valoarea (`INVALID_IDENTIFIER` la numerele disponibile).
785
824
  */
786
825
  declare class EroareValidare extends VerificRcaError {
787
826
  /** Discriminantul erorii: `"EroareValidare"`. Util in `switch (err._tag)`. */
@@ -849,9 +888,14 @@ declare class EroareConflict extends VerificRcaError {
849
888
  }
850
889
  /**
851
890
  * 429: limita a fost atinsa. `cod` spune care:
852
- * - `COTA_ATINSA`: cota zilnica sau lunara de verificari a planului;
891
+ * - `DAILY_LIMIT_REACHED`: limita zilnica a planului; se reseteaza la miezul noptii,
892
+ * ora Romaniei, iar `retryAfterMs` spune cat mai e;
893
+ * - `PLAN_LIMIT_REACHED`: limita lunara, sau plafonul consumului peste plan;
894
+ * - `SOLD_INSUFICIENT`: soldul preplatit nu acopera cererile peste plan;
895
+ * - `PLAFON_NETAXAT`: prea multe raspunsuri netaxate azi (decodari, poze generice);
853
896
  * - `LIMITA_FLOTA_ATINSA`: plafonul zilnic de adaugari/stergeri de vehicule;
854
- * - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur).
897
+ * - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur);
898
+ * - `COTA_ATINSA`: cota atinsa, de la un server mai vechi care nu trimite cod.
855
899
  */
856
900
  declare class EroareLimita extends VerificRcaError {
857
901
  /** Discriminantul erorii: `"EroareLimita"`. Util in `switch (err._tag)`. */
@@ -876,9 +920,11 @@ declare class EroareLimita extends VerificRcaError {
876
920
  });
877
921
  }
878
922
  /**
879
- * 5xx: eroare pe serverul API-ului. Cererile sigure se reincearca automat. La
880
- * numerele disponibile, `cod` spune de ce: `OCUPAT`, `INDISPONIBIL`,
881
- * `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
923
+ * 5xx: eroare pe serverul API-ului sau la sursa oficiala. Cererile sigure se
924
+ * reincearca automat. Cand `cod` exista, cererea nu s-a taxat:
925
+ * - `UPSTREAM_UNAVAILABLE` (502), `UPSTREAM_TIMEOUT` (504): sursa oficiala nu a raspuns;
926
+ * - `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED` (503): sursa e oprita temporar, reia dupa `retryAfterMs`;
927
+ * - `OCUPAT`, `INDISPONIBIL` (503): verificarea nu poate porni acum.
882
928
  */
883
929
  declare class EroareServer extends VerificRcaError {
884
930
  /** Discriminantul erorii: `"EroareServer"`. Util in `switch (err._tag)`. */
@@ -934,12 +980,15 @@ declare class EroareRaspunsInvalid extends VerificRcaError {
934
980
  readonly name = "EroareRaspunsInvalid";
935
981
  }
936
982
  /**
937
- * Verificarea s-a incheiat cu statusul `error`. Doua situatii:
938
- * - sursa oficiala nu a raspuns la timp: `codSursa` lipseste si verificarea
939
- * poate fi reluata cu o cerere noua;
940
- * - sursa a refuzat datele trimise: `codSursa` spune ce camp e gresit
941
- * (`serie_talon_invalida`, `vin_invalid`, `numar_invalid`). O reincercare cu
942
- * aceleasi date nu ajuta; corecteaza campul intai.
983
+ * Verificarea s-a incheiat cu statusul `error`. `cod` spune de ce (vezi
984
+ * {@link CodEsecVerificare}):
985
+ * - `INVALID_IDENTIFIER`: sursa a refuzat datele trimise, iar `codSursa` spune ce
986
+ * camp e gresit (`serie_talon_invalida`, `vin_invalid`, `numar_invalid`). O
987
+ * reincercare cu aceleasi date nu ajuta; corecteaza campul intai;
988
+ * - `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`:
989
+ * sursa oficiala nu a dat un raspuns; reia mai tarziu cu o cerere noua.
990
+ *
991
+ * Un server mai vechi, fara cod, da `cod: "VERIFICARE_ESUATA"`.
943
992
  */
944
993
  declare class EroareVerificare extends VerificRcaError {
945
994
  /** Discriminantul erorii: `"EroareVerificare"`. Util in `switch (err._tag)`. */
@@ -1185,7 +1234,7 @@ interface OptiuniAsteptare {
1185
1234
  }
1186
1235
 
1187
1236
  /** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
1188
- declare const VERSIUNE_SDK = "0.4.0";
1237
+ declare const VERSIUNE_SDK = "0.5.0";
1189
1238
  /** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
1190
1239
  declare const URL_IMPLICIT = "https://api.acteo.ro";
1191
1240
  /** Adresa implicita a clientului legacy {@link VerificRca}. */
@@ -1233,9 +1282,8 @@ declare class ClientVerificari {
1233
1282
  /**
1234
1283
  * Porneste o verificare si consuma o unitate din cota planului.
1235
1284
  *
1236
- * Daca vehiculul a fost verificat de curand, primesti imediat rezultatul
1237
- * existent. Altfel verificarea intra in
1238
- * coada si primesti `status: "processing"`; rezultatul il afli cu
1285
+ * Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
1286
+ * primesti `status: "processing"`; rezultatul il afli cu
1239
1287
  * {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
1240
1288
  * prin webhook, daca ai trimis `callbackUrl`.
1241
1289
  *
@@ -1249,7 +1297,7 @@ declare class ClientVerificari {
1249
1297
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1250
1298
  * @throws {@link EroareAutentificare} cheie API invalida (401).
1251
1299
  * @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
1252
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "COTA_ATINSA"`).
1300
+ * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1253
1301
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1254
1302
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1255
1303
  * @throws {@link EroareRetea} fara raspuns sau timeout.
@@ -1302,7 +1350,7 @@ declare class ClientVerificari {
1302
1350
  * @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
1303
1351
  * @returns rezultatul final al verificarii.
1304
1352
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1305
- * @throws {@link EroareLimita} cota atinsa (`cod: "COTA_ATINSA"`).
1353
+ * @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1306
1354
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1307
1355
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1308
1356
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
@@ -1547,26 +1595,27 @@ declare class ClientDocument<T extends TipVerificare, I> {
1547
1595
  constructor(ruleaza: Rulare, mapare: Mapare<I>);
1548
1596
  /**
1549
1597
  * Verifica documentul si asteapta rezultatul final de la sursa oficiala.
1550
- * Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
1551
1598
  *
1552
1599
  * @param identificator ce cere sursa oficiala pentru acest document.
1553
1600
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
1554
1601
  * @returns rezultatul final.
1555
1602
  * @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
1556
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa.
1557
- * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a refuzat datele.
1603
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
1604
+ * @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
1605
+ * @throws {@link EroareVerificare} sursa oficiala nu a dat un raspuns sau a refuzat datele; motivul e in `cod`.
1558
1606
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1559
1607
  */
1560
1608
  verifica(identificator: I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
1561
1609
  /**
1562
- * Porneste verificarea fara sa astepte. Primesti rezultatul imediat, daca
1563
- * vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
1610
+ * Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
1564
1611
  * afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
1565
1612
  * sau prin webhook la `callbackUrl`.
1566
1613
  *
1567
1614
  * @param identificator ce cere sursa oficiala pentru acest document.
1568
1615
  * @param optiuni `callbackUrl` si `signal`.
1569
1616
  * @returns rezultatul final sau verificarea in curs.
1617
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
1618
+ * @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
1570
1619
  */
1571
1620
  porneste(identificator: I, optiuni?: OptiuniPornire): Promise<RaspunsDocument<T>>;
1572
1621
  /**
@@ -1609,7 +1658,7 @@ declare class ClientVin {
1609
1658
  * @returns decodarea, completa, partiala sau doar structura.
1610
1659
  * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1611
1660
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1612
- * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1661
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1613
1662
  * @example
1614
1663
  * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1615
1664
  * console.log(d.marca, d.model, d.anFabricatie)
@@ -1630,10 +1679,10 @@ declare class ClientNumere {
1630
1679
  * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1631
1680
  * @param optiuni `signal` pentru anulare.
1632
1681
  * @returns verdictul DGPCI.
1633
- * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`NUMAR_RESPINS`).
1682
+ * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`INVALID_IDENTIFIER`).
1634
1683
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1635
1684
  * @throws {@link EroareLimita} cota atinsa.
1636
- * @throws {@link EroareServer} `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
1685
+ * @throws {@link EroareServer} `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`; cererea nu s-a taxat.
1637
1686
  * @example
1638
1687
  * const r = await acteo.auto.numere.verifica("BV07ABC")
1639
1688
  * if (r.disponibil) console.log("Numarul e liber")
@@ -1656,7 +1705,7 @@ declare class ClientImagini {
1656
1705
  * @returns poza masinii sau poza generica.
1657
1706
  * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1658
1707
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1659
- * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1708
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1660
1709
  * @example
1661
1710
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1662
1711
  * if (p.status === "gata") afiseaza(p.url)
@@ -1748,4 +1797,4 @@ declare class Acteo {
1748
1797
  constructor(optiuni?: OptiuniClient);
1749
1798
  }
1750
1799
 
1751
- export { Acteo, VerificRcaError as ActeoError, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
1800
+ export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
package/dist/index.d.ts CHANGED
@@ -14,6 +14,35 @@ type TipVerificare = typeof TipVerificare.Type;
14
14
  declare const StatusDocument: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
15
15
  /** Starea documentului: `"valid"`, `"warning"`, `"expired"` sau `"not_found"`. Vezi {@link StatusDocument}. */
16
16
  type StatusDocument = typeof StatusDocument.Type;
17
+ /**
18
+ * Codurile stabile pe care API-ul le pune in `code`, in ordinea din documentatie.
19
+ * Primele opt sunt cele din contract:
20
+ * - `UPSTREAM_UNAVAILABLE`: sursa oficiala nu raspunde sau raspunde cu eroare;
21
+ * - `UPSTREAM_TIMEOUT`: sursa oficiala nu a raspuns in intervalul maxim;
22
+ * - `UPSTREAM_BLOCKED`: accesul la sursa oficiala e restrictionat temporar;
23
+ * - `UPSTREAM_CHANGED`: structura sursei s-a modificat, serviciul e in adaptare;
24
+ * - `DAILY_LIMIT_REACHED`: limita zilnica a planului, se reseteaza la miezul noptii (ora Romaniei);
25
+ * - `PLAN_LIMIT_REACHED`: limita lunara, sau plafonul consumului peste plan;
26
+ * - `NOT_FOUND`: identificatorul nu exista la sursa oficiala;
27
+ * - `INVALID_IDENTIFIER`: sursa oficiala a respins identificatorul ca invalid.
28
+ *
29
+ * Restul tin de un produs anume: `SOLD_INSUFICIENT`, `PLAFON_NETAXAT`, `OCUPAT`,
30
+ * `INDISPONIBIL`, `VIN_NEDECODAT`, `VIN_INVALID`, `ARR_NECESITA_PLAN`, `LIMIT_ATINS`
31
+ * (numarul de masini din plan), `VEHICUL_EXISTENT`, `NEGASIT`, `LIMITA_FLOTA_ATINSA`.
32
+ */
33
+ declare const CODURI_EROARE: readonly ["UPSTREAM_UNAVAILABLE", "UPSTREAM_TIMEOUT", "UPSTREAM_BLOCKED", "UPSTREAM_CHANGED", "DAILY_LIMIT_REACHED", "PLAN_LIMIT_REACHED", "NOT_FOUND", "INVALID_IDENTIFIER", "SOLD_INSUFICIENT", "PLAFON_NETAXAT", "OCUPAT", "INDISPONIBIL", "VIN_NEDECODAT", "VIN_INVALID", "ARR_NECESITA_PLAN", "LIMIT_ATINS", "VEHICUL_EXISTENT", "NEGASIT", "LIMITA_FLOTA_ATINSA"];
34
+ /**
35
+ * Un cod din {@link CODURI_EROARE}. Tipul accepta si alte valori, ca un cod adaugat
36
+ * ulterior de API sa nu strice compilarea.
37
+ */
38
+ type CodEroare = (typeof CODURI_EROARE)[number] | (string & {});
39
+ /**
40
+ * De ce s-a incheiat o verificare cu `status: "error"`:
41
+ * - `INVALID_IDENTIFIER`: sursa a refuzat datele trimise; campul e in `cod` ({@link CodRefuzSursa});
42
+ * - `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`: sursa
43
+ * oficiala nu a dat un raspuns; reia mai tarziu cu o cerere noua.
44
+ */
45
+ type CodEsecVerificare = "INVALID_IDENTIFIER" | "UPSTREAM_UNAVAILABLE" | "UPSTREAM_TIMEOUT" | "UPSTREAM_BLOCKED" | "UPSTREAM_CHANGED" | (string & {});
17
46
  declare const RezultatVerificareSchema: Schema.Struct<{
18
47
  /** Tipul verificarii. */
19
48
  tip: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
@@ -23,12 +52,14 @@ declare const RezultatVerificareSchema: Schema.Struct<{
23
52
  numarInmatriculare: Schema.NullOr<typeof Schema.String>;
24
53
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
25
54
  serieSasiu: Schema.NullOr<typeof Schema.String>;
26
- /** Cand a fost interogata sursa oficiala. */
55
+ /** Momentul verificarii. */
27
56
  checkedAt: typeof Schema.Date;
28
57
  /** Starea documentului. Vezi {@link StatusDocument}. */
29
58
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
30
59
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
31
60
  expiresAt: Schema.NullOr<typeof Schema.Date>;
61
+ /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
62
+ code: Schema.optional<typeof Schema.String>;
32
63
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
33
64
  requestId: Schema.optional<typeof Schema.String>;
34
65
  /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
@@ -98,21 +129,25 @@ declare const WebhookRezultatSchema: Schema.Struct<{
98
129
  numarInmatriculare: Schema.NullOr<typeof Schema.String>;
99
130
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
100
131
  serieSasiu: Schema.NullOr<typeof Schema.String>;
101
- /** Cand a fost interogata sursa oficiala. */
132
+ /** Momentul verificarii. */
102
133
  checkedAt: typeof Schema.Date;
103
134
  /** Starea documentului. Vezi {@link StatusDocument}. */
104
135
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
105
136
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
106
137
  expiresAt: Schema.NullOr<typeof Schema.Date>;
138
+ /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
139
+ code: Schema.optional<typeof Schema.String>;
107
140
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
108
141
  requestId: Schema.optional<typeof Schema.String>;
109
142
  /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
110
143
  hint: Schema.optional<typeof Schema.String>;
111
144
  }>>;
112
- /** Cand a fost interogata sursa, `null` la eroare. */
145
+ /** Momentul verificarii, `null` la eroare. */
113
146
  checkedAt: Schema.NullOr<typeof Schema.Date>;
114
147
  /** Mesajul de eroare, doar la `status: "error"`. */
115
148
  error: Schema.optional<typeof Schema.String>;
149
+ /** La `status: "error"`, motivul ({@link CodEsecVerificare}); la `status: "not_found"`, `"NOT_FOUND"`. */
150
+ code: Schema.optional<typeof Schema.String>;
116
151
  }>;
117
152
  /** Payloadul POST trimis la `callbackUrl` cand o verificare se termina. */
118
153
  type WebhookRezultat = typeof WebhookRezultatSchema.Type;
@@ -752,8 +787,12 @@ interface DateEroare {
752
787
  readonly message: string;
753
788
  /** Statusul HTTP, cand eroarea vine dintr-un raspuns. */
754
789
  readonly status?: number;
755
- /** Codul masinii (`LIMIT_ATINS`, `VEHICUL_EXISTENT`, `NEGASIT` etc.). */
756
- readonly cod?: string;
790
+ /**
791
+ * Codul masinii. De la API vine unul din {@link CodEroare} (`DAILY_LIMIT_REACHED`,
792
+ * `UPSTREAM_TIMEOUT`, `VEHICUL_EXISTENT` etc.); SDK-ul pune singur cateva coduri
793
+ * locale (`VALIDARE_LOCALA`, `TIMEOUT_VERIFICARE`, `PREA_MULTE_CERERI`).
794
+ */
795
+ readonly cod?: CodEroare;
757
796
  /** Indicatia API-ului despre cum se rezolva problema. */
758
797
  readonly hint?: string;
759
798
  /** Corpul brut al raspunsului, pentru depanare. */
@@ -781,7 +820,7 @@ declare class EroareConfigurare extends VerificRcaError {
781
820
  /**
782
821
  * Datele trimise sunt invalide. Apare fie local, inainte de orice cerere (nu se
783
822
  * consuma nimic din cota), fie ca raspuns 400 de la API, fie ca 422 cand sursa
784
- * oficiala refuza valoarea (ex: `NUMAR_RESPINS` la numerele disponibile).
823
+ * oficiala refuza valoarea (`INVALID_IDENTIFIER` la numerele disponibile).
785
824
  */
786
825
  declare class EroareValidare extends VerificRcaError {
787
826
  /** Discriminantul erorii: `"EroareValidare"`. Util in `switch (err._tag)`. */
@@ -849,9 +888,14 @@ declare class EroareConflict extends VerificRcaError {
849
888
  }
850
889
  /**
851
890
  * 429: limita a fost atinsa. `cod` spune care:
852
- * - `COTA_ATINSA`: cota zilnica sau lunara de verificari a planului;
891
+ * - `DAILY_LIMIT_REACHED`: limita zilnica a planului; se reseteaza la miezul noptii,
892
+ * ora Romaniei, iar `retryAfterMs` spune cat mai e;
893
+ * - `PLAN_LIMIT_REACHED`: limita lunara, sau plafonul consumului peste plan;
894
+ * - `SOLD_INSUFICIENT`: soldul preplatit nu acopera cererile peste plan;
895
+ * - `PLAFON_NETAXAT`: prea multe raspunsuri netaxate azi (decodari, poze generice);
853
896
  * - `LIMITA_FLOTA_ATINSA`: plafonul zilnic de adaugari/stergeri de vehicule;
854
- * - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur).
897
+ * - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur);
898
+ * - `COTA_ATINSA`: cota atinsa, de la un server mai vechi care nu trimite cod.
855
899
  */
856
900
  declare class EroareLimita extends VerificRcaError {
857
901
  /** Discriminantul erorii: `"EroareLimita"`. Util in `switch (err._tag)`. */
@@ -876,9 +920,11 @@ declare class EroareLimita extends VerificRcaError {
876
920
  });
877
921
  }
878
922
  /**
879
- * 5xx: eroare pe serverul API-ului. Cererile sigure se reincearca automat. La
880
- * numerele disponibile, `cod` spune de ce: `OCUPAT`, `INDISPONIBIL`,
881
- * `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
923
+ * 5xx: eroare pe serverul API-ului sau la sursa oficiala. Cererile sigure se
924
+ * reincearca automat. Cand `cod` exista, cererea nu s-a taxat:
925
+ * - `UPSTREAM_UNAVAILABLE` (502), `UPSTREAM_TIMEOUT` (504): sursa oficiala nu a raspuns;
926
+ * - `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED` (503): sursa e oprita temporar, reia dupa `retryAfterMs`;
927
+ * - `OCUPAT`, `INDISPONIBIL` (503): verificarea nu poate porni acum.
882
928
  */
883
929
  declare class EroareServer extends VerificRcaError {
884
930
  /** Discriminantul erorii: `"EroareServer"`. Util in `switch (err._tag)`. */
@@ -934,12 +980,15 @@ declare class EroareRaspunsInvalid extends VerificRcaError {
934
980
  readonly name = "EroareRaspunsInvalid";
935
981
  }
936
982
  /**
937
- * Verificarea s-a incheiat cu statusul `error`. Doua situatii:
938
- * - sursa oficiala nu a raspuns la timp: `codSursa` lipseste si verificarea
939
- * poate fi reluata cu o cerere noua;
940
- * - sursa a refuzat datele trimise: `codSursa` spune ce camp e gresit
941
- * (`serie_talon_invalida`, `vin_invalid`, `numar_invalid`). O reincercare cu
942
- * aceleasi date nu ajuta; corecteaza campul intai.
983
+ * Verificarea s-a incheiat cu statusul `error`. `cod` spune de ce (vezi
984
+ * {@link CodEsecVerificare}):
985
+ * - `INVALID_IDENTIFIER`: sursa a refuzat datele trimise, iar `codSursa` spune ce
986
+ * camp e gresit (`serie_talon_invalida`, `vin_invalid`, `numar_invalid`). O
987
+ * reincercare cu aceleasi date nu ajuta; corecteaza campul intai;
988
+ * - `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`:
989
+ * sursa oficiala nu a dat un raspuns; reia mai tarziu cu o cerere noua.
990
+ *
991
+ * Un server mai vechi, fara cod, da `cod: "VERIFICARE_ESUATA"`.
943
992
  */
944
993
  declare class EroareVerificare extends VerificRcaError {
945
994
  /** Discriminantul erorii: `"EroareVerificare"`. Util in `switch (err._tag)`. */
@@ -1185,7 +1234,7 @@ interface OptiuniAsteptare {
1185
1234
  }
1186
1235
 
1187
1236
  /** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
1188
- declare const VERSIUNE_SDK = "0.4.0";
1237
+ declare const VERSIUNE_SDK = "0.5.0";
1189
1238
  /** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
1190
1239
  declare const URL_IMPLICIT = "https://api.acteo.ro";
1191
1240
  /** Adresa implicita a clientului legacy {@link VerificRca}. */
@@ -1233,9 +1282,8 @@ declare class ClientVerificari {
1233
1282
  /**
1234
1283
  * Porneste o verificare si consuma o unitate din cota planului.
1235
1284
  *
1236
- * Daca vehiculul a fost verificat de curand, primesti imediat rezultatul
1237
- * existent. Altfel verificarea intra in
1238
- * coada si primesti `status: "processing"`; rezultatul il afli cu
1285
+ * Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
1286
+ * primesti `status: "processing"`; rezultatul il afli cu
1239
1287
  * {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
1240
1288
  * prin webhook, daca ai trimis `callbackUrl`.
1241
1289
  *
@@ -1249,7 +1297,7 @@ declare class ClientVerificari {
1249
1297
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1250
1298
  * @throws {@link EroareAutentificare} cheie API invalida (401).
1251
1299
  * @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
1252
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "COTA_ATINSA"`).
1300
+ * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1253
1301
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1254
1302
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1255
1303
  * @throws {@link EroareRetea} fara raspuns sau timeout.
@@ -1302,7 +1350,7 @@ declare class ClientVerificari {
1302
1350
  * @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
1303
1351
  * @returns rezultatul final al verificarii.
1304
1352
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1305
- * @throws {@link EroareLimita} cota atinsa (`cod: "COTA_ATINSA"`).
1353
+ * @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1306
1354
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1307
1355
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1308
1356
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
@@ -1547,26 +1595,27 @@ declare class ClientDocument<T extends TipVerificare, I> {
1547
1595
  constructor(ruleaza: Rulare, mapare: Mapare<I>);
1548
1596
  /**
1549
1597
  * Verifica documentul si asteapta rezultatul final de la sursa oficiala.
1550
- * Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
1551
1598
  *
1552
1599
  * @param identificator ce cere sursa oficiala pentru acest document.
1553
1600
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
1554
1601
  * @returns rezultatul final.
1555
1602
  * @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
1556
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa.
1557
- * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a refuzat datele.
1603
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
1604
+ * @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
1605
+ * @throws {@link EroareVerificare} sursa oficiala nu a dat un raspuns sau a refuzat datele; motivul e in `cod`.
1558
1606
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1559
1607
  */
1560
1608
  verifica(identificator: I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
1561
1609
  /**
1562
- * Porneste verificarea fara sa astepte. Primesti rezultatul imediat, daca
1563
- * vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
1610
+ * Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
1564
1611
  * afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
1565
1612
  * sau prin webhook la `callbackUrl`.
1566
1613
  *
1567
1614
  * @param identificator ce cere sursa oficiala pentru acest document.
1568
1615
  * @param optiuni `callbackUrl` si `signal`.
1569
1616
  * @returns rezultatul final sau verificarea in curs.
1617
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
1618
+ * @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
1570
1619
  */
1571
1620
  porneste(identificator: I, optiuni?: OptiuniPornire): Promise<RaspunsDocument<T>>;
1572
1621
  /**
@@ -1609,7 +1658,7 @@ declare class ClientVin {
1609
1658
  * @returns decodarea, completa, partiala sau doar structura.
1610
1659
  * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1611
1660
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1612
- * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1661
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1613
1662
  * @example
1614
1663
  * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1615
1664
  * console.log(d.marca, d.model, d.anFabricatie)
@@ -1630,10 +1679,10 @@ declare class ClientNumere {
1630
1679
  * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1631
1680
  * @param optiuni `signal` pentru anulare.
1632
1681
  * @returns verdictul DGPCI.
1633
- * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`NUMAR_RESPINS`).
1682
+ * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`INVALID_IDENTIFIER`).
1634
1683
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1635
1684
  * @throws {@link EroareLimita} cota atinsa.
1636
- * @throws {@link EroareServer} `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
1685
+ * @throws {@link EroareServer} `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`; cererea nu s-a taxat.
1637
1686
  * @example
1638
1687
  * const r = await acteo.auto.numere.verifica("BV07ABC")
1639
1688
  * if (r.disponibil) console.log("Numarul e liber")
@@ -1656,7 +1705,7 @@ declare class ClientImagini {
1656
1705
  * @returns poza masinii sau poza generica.
1657
1706
  * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1658
1707
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1659
- * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1708
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1660
1709
  * @example
1661
1710
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1662
1711
  * if (p.status === "gata") afiseaza(p.url)
@@ -1748,4 +1797,4 @@ declare class Acteo {
1748
1797
  constructor(optiuni?: OptiuniClient);
1749
1798
  }
1750
1799
 
1751
- export { Acteo, VerificRcaError as ActeoError, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
1800
+ export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };