@acteo/api 0.4.1 → 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"]>;
@@ -29,6 +58,8 @@ declare const RezultatVerificareSchema: Schema.Struct<{
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. */
@@ -104,6 +135,8 @@ declare const WebhookRezultatSchema: Schema.Struct<{
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. */
@@ -113,6 +146,8 @@ declare const WebhookRezultatSchema: Schema.Struct<{
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.1";
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}. */
@@ -1248,7 +1297,7 @@ declare class ClientVerificari {
1248
1297
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1249
1298
  * @throws {@link EroareAutentificare} cheie API invalida (401).
1250
1299
  * @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
1251
- * @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"`).
1252
1301
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1253
1302
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1254
1303
  * @throws {@link EroareRetea} fara raspuns sau timeout.
@@ -1301,7 +1350,7 @@ declare class ClientVerificari {
1301
1350
  * @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
1302
1351
  * @returns rezultatul final al verificarii.
1303
1352
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1304
- * @throws {@link EroareLimita} cota atinsa (`cod: "COTA_ATINSA"`).
1353
+ * @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1305
1354
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1306
1355
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1307
1356
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
@@ -1551,8 +1600,9 @@ declare class ClientDocument<T extends TipVerificare, I> {
1551
1600
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
1552
1601
  * @returns rezultatul final.
1553
1602
  * @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
1554
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa.
1555
- * @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`.
1556
1606
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1557
1607
  */
1558
1608
  verifica(identificator: I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
@@ -1564,6 +1614,8 @@ declare class ClientDocument<T extends TipVerificare, I> {
1564
1614
  * @param identificator ce cere sursa oficiala pentru acest document.
1565
1615
  * @param optiuni `callbackUrl` si `signal`.
1566
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.
1567
1619
  */
1568
1620
  porneste(identificator: I, optiuni?: OptiuniPornire): Promise<RaspunsDocument<T>>;
1569
1621
  /**
@@ -1606,7 +1658,7 @@ declare class ClientVin {
1606
1658
  * @returns decodarea, completa, partiala sau doar structura.
1607
1659
  * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1608
1660
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1609
- * @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`).
1610
1662
  * @example
1611
1663
  * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1612
1664
  * console.log(d.marca, d.model, d.anFabricatie)
@@ -1627,10 +1679,10 @@ declare class ClientNumere {
1627
1679
  * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1628
1680
  * @param optiuni `signal` pentru anulare.
1629
1681
  * @returns verdictul DGPCI.
1630
- * @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`).
1631
1683
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1632
1684
  * @throws {@link EroareLimita} cota atinsa.
1633
- * @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.
1634
1686
  * @example
1635
1687
  * const r = await acteo.auto.numere.verifica("BV07ABC")
1636
1688
  * if (r.disponibil) console.log("Numarul e liber")
@@ -1653,7 +1705,7 @@ declare class ClientImagini {
1653
1705
  * @returns poza masinii sau poza generica.
1654
1706
  * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1655
1707
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1656
- * @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`).
1657
1709
  * @example
1658
1710
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1659
1711
  * if (p.status === "gata") afiseaza(p.url)
@@ -1745,4 +1797,4 @@ declare class Acteo {
1745
1797
  constructor(optiuni?: OptiuniClient);
1746
1798
  }
1747
1799
 
1748
- 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"]>;
@@ -29,6 +58,8 @@ declare const RezultatVerificareSchema: Schema.Struct<{
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. */
@@ -104,6 +135,8 @@ declare const WebhookRezultatSchema: Schema.Struct<{
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. */
@@ -113,6 +146,8 @@ declare const WebhookRezultatSchema: Schema.Struct<{
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.1";
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}. */
@@ -1248,7 +1297,7 @@ declare class ClientVerificari {
1248
1297
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1249
1298
  * @throws {@link EroareAutentificare} cheie API invalida (401).
1250
1299
  * @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
1251
- * @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"`).
1252
1301
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1253
1302
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1254
1303
  * @throws {@link EroareRetea} fara raspuns sau timeout.
@@ -1301,7 +1350,7 @@ declare class ClientVerificari {
1301
1350
  * @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
1302
1351
  * @returns rezultatul final al verificarii.
1303
1352
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1304
- * @throws {@link EroareLimita} cota atinsa (`cod: "COTA_ATINSA"`).
1353
+ * @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1305
1354
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1306
1355
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1307
1356
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
@@ -1551,8 +1600,9 @@ declare class ClientDocument<T extends TipVerificare, I> {
1551
1600
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
1552
1601
  * @returns rezultatul final.
1553
1602
  * @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
1554
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa.
1555
- * @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`.
1556
1606
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1557
1607
  */
1558
1608
  verifica(identificator: I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
@@ -1564,6 +1614,8 @@ declare class ClientDocument<T extends TipVerificare, I> {
1564
1614
  * @param identificator ce cere sursa oficiala pentru acest document.
1565
1615
  * @param optiuni `callbackUrl` si `signal`.
1566
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.
1567
1619
  */
1568
1620
  porneste(identificator: I, optiuni?: OptiuniPornire): Promise<RaspunsDocument<T>>;
1569
1621
  /**
@@ -1606,7 +1658,7 @@ declare class ClientVin {
1606
1658
  * @returns decodarea, completa, partiala sau doar structura.
1607
1659
  * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1608
1660
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1609
- * @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`).
1610
1662
  * @example
1611
1663
  * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1612
1664
  * console.log(d.marca, d.model, d.anFabricatie)
@@ -1627,10 +1679,10 @@ declare class ClientNumere {
1627
1679
  * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1628
1680
  * @param optiuni `signal` pentru anulare.
1629
1681
  * @returns verdictul DGPCI.
1630
- * @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`).
1631
1683
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1632
1684
  * @throws {@link EroareLimita} cota atinsa.
1633
- * @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.
1634
1686
  * @example
1635
1687
  * const r = await acteo.auto.numere.verifica("BV07ABC")
1636
1688
  * if (r.disponibil) console.log("Numarul e liber")
@@ -1653,7 +1705,7 @@ declare class ClientImagini {
1653
1705
  * @returns poza masinii sau poza generica.
1654
1706
  * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1655
1707
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1656
- * @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`).
1657
1709
  * @example
1658
1710
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1659
1711
  * if (p.status === "gata") afiseaza(p.url)
@@ -1745,4 +1797,4 @@ declare class Acteo {
1745
1797
  constructor(optiuni?: OptiuniClient);
1746
1798
  }
1747
1799
 
1748
- 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.js CHANGED
@@ -148,6 +148,27 @@ var EroareWebhook = class extends VerificRcaError {
148
148
  var TipVerificare = Schema.Literal("rca", "itp", "rovinieta", "arr");
149
149
  var StatusDocument = Schema.Literal("valid", "warning", "expired", "not_found");
150
150
  var DataNullabila = Schema.NullOr(Schema.Date);
151
+ var CODURI_EROARE = [
152
+ "UPSTREAM_UNAVAILABLE",
153
+ "UPSTREAM_TIMEOUT",
154
+ "UPSTREAM_BLOCKED",
155
+ "UPSTREAM_CHANGED",
156
+ "DAILY_LIMIT_REACHED",
157
+ "PLAN_LIMIT_REACHED",
158
+ "NOT_FOUND",
159
+ "INVALID_IDENTIFIER",
160
+ "SOLD_INSUFICIENT",
161
+ "PLAFON_NETAXAT",
162
+ "OCUPAT",
163
+ "INDISPONIBIL",
164
+ "VIN_NEDECODAT",
165
+ "VIN_INVALID",
166
+ "ARR_NECESITA_PLAN",
167
+ "LIMIT_ATINS",
168
+ "VEHICUL_EXISTENT",
169
+ "NEGASIT",
170
+ "LIMITA_FLOTA_ATINSA"
171
+ ];
151
172
  var RezultatVerificareSchema = Schema.Struct({
152
173
  /** Tipul verificarii. */
153
174
  tip: TipVerificare,
@@ -163,6 +184,8 @@ var RezultatVerificareSchema = Schema.Struct({
163
184
  status: StatusDocument,
164
185
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
165
186
  expiresAt: DataNullabila,
187
+ /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
188
+ code: Schema.optional(Schema.String),
166
189
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
167
190
  requestId: Schema.optional(Schema.String),
168
191
  /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
@@ -181,8 +204,10 @@ var EsuataSchema = Schema.Struct({
181
204
  tip: TipVerificare,
182
205
  query: Schema.String,
183
206
  status: Schema.Literal("error"),
207
+ /** Motivul. Vezi {@link CodEsecVerificare}. Lipseste doar la serverele mai vechi. */
208
+ code: Schema.optional(Schema.String),
184
209
  error: Schema.String,
185
- /** Doar cand sursa a refuzat datele trimise. Vezi {@link CodRefuzSursa}. */
210
+ /** Doar la `INVALID_IDENTIFIER`: campul refuzat. Vezi {@link CodRefuzSursa}. */
186
211
  cod: Schema.optional(Schema.String),
187
212
  hint: Schema.optional(Schema.String)
188
213
  });
@@ -241,7 +266,9 @@ var WebhookRezultatSchema = Schema.Struct({
241
266
  /** Momentul verificarii, `null` la eroare. */
242
267
  checkedAt: DataNullabila,
243
268
  /** Mesajul de eroare, doar la `status: "error"`. */
244
- error: Schema.optional(Schema.String)
269
+ error: Schema.optional(Schema.String),
270
+ /** La `status: "error"`, motivul ({@link CodEsecVerificare}); la `status: "not_found"`, `"NOT_FOUND"`. */
271
+ code: Schema.optional(Schema.String)
245
272
  });
246
273
  var WebhookDocumentExpiraSchema = Schema.Struct({
247
274
  /** Numele evenimentului. */
@@ -632,7 +659,7 @@ function eroareDinRaspuns(status, headers, body) {
632
659
  switch (status) {
633
660
  case 400:
634
661
  return new EroareValidare({ ...comun, ...c?.accepted && { acceptate: c.accepted } });
635
- // 422: sursa oficiala refuza valoarea trimisa (ex: NUMAR_RESPINS).
662
+ // 422: sursa oficiala refuza valoarea trimisa (INVALID_IDENTIFIER).
636
663
  case 422:
637
664
  return new EroareValidare(comun);
638
665
  case 401:
@@ -1010,7 +1037,7 @@ var interpreteaza = (raspuns, serieSasiu, sinceImplicit) => decodeaza(RaspunsVer
1010
1037
  return Effect.fail(
1011
1038
  new EroareVerificare({
1012
1039
  message: corp.error,
1013
- cod: "VERIFICARE_ESUATA",
1040
+ cod: corp.code ?? "VERIFICARE_ESUATA",
1014
1041
  raspuns: corp,
1015
1042
  ...corp.cod && { codSursa: corp.cod },
1016
1043
  ...corp.hint && { hint: corp.hint }
@@ -1107,7 +1134,7 @@ var sterge = (id) => id.trim() ? trimite({ metoda: "DELETE", cale: `${CALE2}/${e
1107
1134
  ) : Effect.fail(new EroareValidare({ message: "Lipseste ID-ul vehiculului.", camp: "id", cod: "VALIDARE_LOCALA" }));
1108
1135
 
1109
1136
  // src/client.ts
1110
- var VERSIUNE_SDK = "0.4.1";
1137
+ var VERSIUNE_SDK = "0.5.0";
1111
1138
  var URL_IMPLICIT = "https://api.acteo.ro";
1112
1139
  var URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
1113
1140
  var RETRY_IMPLICIT = { incercari: 3, intarziereInitialaMs: 500, intarziereMaximaMs: 1e4 };
@@ -1197,7 +1224,7 @@ var ClientVerificari = class {
1197
1224
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1198
1225
  * @throws {@link EroareAutentificare} cheie API invalida (401).
1199
1226
  * @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
1200
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "COTA_ATINSA"`).
1227
+ * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1201
1228
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1202
1229
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1203
1230
  * @throws {@link EroareRetea} fara raspuns sau timeout.
@@ -1256,7 +1283,7 @@ var ClientVerificari = class {
1256
1283
  * @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
1257
1284
  * @returns rezultatul final al verificarii.
1258
1285
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1259
- * @throws {@link EroareLimita} cota atinsa (`cod: "COTA_ATINSA"`).
1286
+ * @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1260
1287
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1261
1288
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1262
1289
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
@@ -1499,8 +1526,9 @@ var ClientDocument = class {
1499
1526
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
1500
1527
  * @returns rezultatul final.
1501
1528
  * @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
1502
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa.
1503
- * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a refuzat datele.
1529
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
1530
+ * @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
1531
+ * @throws {@link EroareVerificare} sursa oficiala nu a dat un raspuns sau a refuzat datele; motivul e in `cod`.
1504
1532
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1505
1533
  */
1506
1534
  verifica(identificator, optiuni) {
@@ -1517,6 +1545,8 @@ var ClientDocument = class {
1517
1545
  * @param identificator ce cere sursa oficiala pentru acest document.
1518
1546
  * @param optiuni `callbackUrl` si `signal`.
1519
1547
  * @returns rezultatul final sau verificarea in curs.
1548
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
1549
+ * @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
1520
1550
  */
1521
1551
  porneste(identificator, optiuni) {
1522
1552
  const cerere = {
@@ -1596,7 +1626,7 @@ var ClientVin = class {
1596
1626
  * @returns decodarea, completa, partiala sau doar structura.
1597
1627
  * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1598
1628
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1599
- * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1629
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1600
1630
  * @example
1601
1631
  * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1602
1632
  * console.log(d.marca, d.model, d.anFabricatie)
@@ -1620,10 +1650,10 @@ var ClientNumere = class {
1620
1650
  * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1621
1651
  * @param optiuni `signal` pentru anulare.
1622
1652
  * @returns verdictul DGPCI.
1623
- * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`NUMAR_RESPINS`).
1653
+ * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`INVALID_IDENTIFIER`).
1624
1654
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1625
1655
  * @throws {@link EroareLimita} cota atinsa.
1626
- * @throws {@link EroareServer} `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
1656
+ * @throws {@link EroareServer} `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`; cererea nu s-a taxat.
1627
1657
  * @example
1628
1658
  * const r = await acteo.auto.numere.verifica("BV07ABC")
1629
1659
  * if (r.disponibil) console.log("Numarul e liber")
@@ -1649,7 +1679,7 @@ var ClientImagini = class {
1649
1679
  * @returns poza masinii sau poza generica.
1650
1680
  * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1651
1681
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1652
- * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1682
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1653
1683
  * @example
1654
1684
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1655
1685
  * if (p.status === "gata") afiseaza(p.url)
@@ -1744,6 +1774,6 @@ var Acteo = class {
1744
1774
  }
1745
1775
  };
1746
1776
 
1747
- export { Acteo, VerificRcaError as ActeoError, ClientAuto, ClientDocument, ClientImagini, ClientNumere, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, EroareAutentificare, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, TIPURI_VERIFICARE, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, VERSIUNE_SDK, VerificRca, VerificRcaError, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
1777
+ export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, ClientAuto, ClientDocument, ClientImagini, ClientNumere, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, EroareAutentificare, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, TIPURI_VERIFICARE, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, VERSIUNE_SDK, VerificRca, VerificRcaError, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
1748
1778
  //# sourceMappingURL=index.js.map
1749
1779
  //# sourceMappingURL=index.js.map