@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/CHANGELOG.md CHANGED
@@ -1,5 +1,25 @@
1
1
  # Changelog
2
2
 
3
+ ## @acteo/api 0.5.0 (2026-11-03)
4
+
5
+ API-ul trimite acum codurile de eroare din contract. Dacă ai cod care compară `err.cod` cu valorile vechi, schimbă-l după tabelul de mai jos. Clasele de eroare și statusurile HTTP rămân aceleași.
6
+
7
+ | Situație | Cod vechi | Cod nou |
8
+ |---|---|---|
9
+ | Limita zilnică a planului atinsă (429) | `COTA_ATINSA` la verificări, `LIMIT_ATINS` la VIN, numere și poze | `DAILY_LIMIT_REACHED` |
10
+ | Limita lunară sau plafonul consumului peste plan atins (429) | `COTA_ATINSA` la verificări, `LIMIT_ATINS` la VIN, numere și poze | `PLAN_LIMIT_REACHED` |
11
+ | DGPCI refuză numărul (422) | `NUMAR_RESPINS` | `INVALID_IDENTIFIER` |
12
+ | DGPCI nu răspunde la timp (504) | `TIMEOUT` | `UPSTREAM_TIMEOUT` |
13
+ | Verificarea la DGPCI eșuează (502) | `EROARE_DGPCI` | `UPSTREAM_UNAVAILABLE` |
14
+ | Verificare încheiată cu `status: "error"` | `VERIFICARE_ESUATA` | `INVALID_IDENTIFIER`, `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED` sau `UPSTREAM_CHANGED` |
15
+
16
+ - `CODURI_EROARE` și tipul `CodEroare`: toate codurile pe care le trimite API-ul. `CodEsecVerificare` are motivele unei verificări eșuate.
17
+ - `EroareVerificare.cod` spune de ce a eșuat verificarea. `codSursa` rămâne și arată câmpul refuzat la `INVALID_IDENTIFIER`.
18
+ - Rezultatul `not_found` are `code: "NOT_FOUND"`, iar webhook-ul de rezultat are `code` la eroare și la `not_found`.
19
+ - Pornirea unei verificări sau a unei verificări de număr poate primi `EroareServer` 503 cu `UPSTREAM_BLOCKED` sau `UPSTREAM_CHANGED` când sursa oficială e oprită temporar. Cererea nu se taxează și nu se repetă singură; `retryAfterMs` spune când să revii.
20
+ - `DAILY_LIMIT_REACHED` vine cu `retryAfterMs` până la miezul nopții, ora României. `PLAN_LIMIT_REACHED` nu are `retryAfterMs`, pentru că nu se deblochează la miezul nopții.
21
+ - Un server mai vechi, fără coduri, dă în continuare `COTA_ATINSA` și `VERIFICARE_ESUATA`.
22
+
3
23
  ## @acteo/api 0.4.1 (2026-10-31)
4
24
 
5
25
  - Documentație: fiecare verificare interoghează sursa oficială. `porneste()` întoarce o verificare în curs, iar rezultatul vine prin `asteapta()`, `rezultat()` sau webhook. `checkedAt` e descris ca momentul verificării. Codul nu se schimbă.
package/README.md CHANGED
@@ -116,7 +116,7 @@ const rovinieta = await acteo.auto.rovinieta.verifica({
116
116
  console.log(rovinieta.status, rovinieta.expiresAt)
117
117
  ```
118
118
 
119
- Dacă sursa respinge datele (de exemplu, numărul talonului nu corespunde mașinii), primești `EroareVerificare` cu `codSursa: "serie_talon_invalida"`. O reîncercare cu aceleași date nu ajută; corectează întâi câmpul indicat:
119
+ Dacă sursa respinge datele (de exemplu, numărul talonului nu corespunde mașinii), primești `EroareVerificare` cu `cod: "INVALID_IDENTIFIER"` și `codSursa: "serie_talon_invalida"`. O reîncercare cu aceleași date nu ajută; corectează întâi câmpul indicat:
120
120
 
121
121
  ```ts
122
122
  import { EroareVerificare } from "@acteo/api"
@@ -201,10 +201,20 @@ O verificare consumă din cota planului doar când sursa oficială a răspuns, i
201
201
  | `valid` | Document valabil | data expirării |
202
202
  | `warning` | Expiră curând: RCA în 14 zile, ITP în 30, rovinietă în 7, ARR în 14 | data expirării |
203
203
  | `expired` | Expirat sau inexistent, confirmat de sursă | data expirării sau `null` |
204
- | `not_found` | Sursa nu a găsit vehiculul | `null` |
204
+ | `not_found` | Sursa nu a găsit vehiculul (`code: "NOT_FOUND"`) | `null` |
205
205
  | `processing` | Verificarea e încă în curs | nu există |
206
206
 
207
- Când verificarea se încheie cu eroare, SDK-ul aruncă `EroareVerificare`. Dacă sursa oficială doar nu a răspuns, `codSursa` lipsește și poți relua cererea. Dacă sursa a refuzat datele trimise, `codSursa` spune ce e greșit și reîncercarea nu ajută până nu corectezi câmpul:
207
+ Când verificarea se încheie cu eroare, SDK-ul aruncă `EroareVerificare`, iar `cod` spune de ce:
208
+
209
+ | `cod` | Ce s-a întâmplat | Ce faci |
210
+ |---|---|---|
211
+ | `INVALID_IDENTIFIER` | Sursa a refuzat datele trimise; câmpul e în `codSursa` | corectezi câmpul, reîncercarea nu ajută |
212
+ | `UPSTREAM_UNAVAILABLE` | Sursa oficială nu răspunde sau a răspuns cu eroare | reiei mai târziu |
213
+ | `UPSTREAM_TIMEOUT` | Sursa oficială nu a răspuns în timpul maxim | reiei mai târziu |
214
+ | `UPSTREAM_BLOCKED` | Accesul la sursa oficială e restricționat temporar | reiei mai târziu |
215
+ | `UPSTREAM_CHANGED` | Sursa și-a schimbat structura, adaptăm serviciul | reiei mai târziu |
216
+
217
+ Doar `INVALID_IDENTIFIER` se taxează, pentru că sursa a răspuns. Valorile lui `codSursa`:
208
218
 
209
219
  | `codSursa` | Câmpul de corectat |
210
220
  |---|---|
@@ -286,7 +296,7 @@ Decodează o serie de șasiu. Întoarce `marca`, `model`, `anFabricatie`, `sursa
286
296
 
287
297
  ### `auto.numere.verifica(numar)`
288
298
 
289
- Verifică la DGPCI un singur număr complet: indicativul județului, cifrele și trei litere (`BV07ABC`, `B123ABC`). Numerele incomplete sau cu `?` și `*` sunt respinse local. Întoarce `numar` (normalizat), `disponibil` și `mesaj` (textul DGPCI, sau `null`). Dacă DGPCI nu acceptă numărul primești `EroareValidare` cu `cod: "NUMAR_RESPINS"`. Când verificarea nu poate rula primești `EroareServer` cu `cod` `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`. Niciuna nu se taxează, iar `OCUPAT` se reîncearcă singur după `Retry-After`. Cere un abonament de numere disponibile.
299
+ Verifică la DGPCI un singur număr complet: indicativul județului, cifrele și trei litere (`BV07ABC`, `B123ABC`). Numerele incomplete sau cu `?` și `*` sunt respinse local. Întoarce `numar` (normalizat), `disponibil` și `mesaj` (textul DGPCI, sau `null`). Dacă DGPCI nu acceptă numărul primești `EroareValidare` cu `cod: "INVALID_IDENTIFIER"`. Când verificarea nu poate rula primești `EroareServer` cu `cod` `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`. Niciuna nu se taxează, iar `OCUPAT` se reîncearcă singur după `Retry-After`. Cere un abonament de numere disponibile.
290
300
 
291
301
  ### `auto.imagini.obtine({ marca, model, an, unghi?, umbra? })`
292
302
 
@@ -392,20 +402,39 @@ Datele cu oră (`trimisLa`, `sedinta.data`, `verificatLa`) devin `Date`. Datele
392
402
 
393
403
  Toate erorile moștenesc `ActeoError`, care la rândul ei moștenește `Error`. Fiecare are `_tag`, `message` (în română), plus `status`, `cod`, `hint` și `raspuns` când vin de la API.
394
404
 
405
+ ### Coduri de eroare
406
+
407
+ `cod` are o valoare stabilă, bună de tratat în program. Lista completă e exportată ca `CODURI_EROARE`, iar tipul e `CodEroare`. Primele opt sunt cele din contract:
408
+
409
+ | `cod` | Unde apare | Înseamnă |
410
+ |---|---|---|
411
+ | `UPSTREAM_UNAVAILABLE` | `EroareVerificare`, `EroareServer` 502 | Sursa oficială nu răspunde sau răspunde cu eroare |
412
+ | `UPSTREAM_TIMEOUT` | `EroareVerificare`, `EroareServer` 504 | Sursa oficială nu a răspuns în intervalul maxim |
413
+ | `UPSTREAM_BLOCKED` | `EroareVerificare`, `EroareServer` 503 | Accesul la sursa oficială e restricționat temporar |
414
+ | `UPSTREAM_CHANGED` | `EroareVerificare`, `EroareServer` 503 | Structura sursei s-a modificat, serviciul e în adaptare |
415
+ | `DAILY_LIMIT_REACHED` | `EroareLimita` 429 | Limita zilnică a planului, se resetează la miezul nopții (ora României) |
416
+ | `PLAN_LIMIT_REACHED` | `EroareLimita` 429 | Limita lunară, sau plafonul consumului peste plan |
417
+ | `NOT_FOUND` | `code` pe rezultatul `not_found` | Identificatorul nu există la sursa oficială |
418
+ | `INVALID_IDENTIFIER` | `EroareVerificare`, `EroareValidare` 422 | Sursa oficială a respins identificatorul |
419
+
420
+ Restul țin de un produs: `SOLD_INSUFICIENT`, `PLAFON_NETAXAT`, `OCUPAT`, `INDISPONIBIL`, `VIN_NEDECODAT`, `VIN_INVALID`, `ARR_NECESITA_PLAN`, `LIMIT_ATINS` (numărul de mașini din plan), `VEHICUL_EXISTENT`, `NEGASIT`, `LIMITA_FLOTA_ATINSA`.
421
+
422
+ ### Clasele de eroare
423
+
395
424
  | Clasă | Când apare | Câmpuri utile |
396
425
  |---|---|---|
397
426
  | `EroareConfigurare` | Cheie lipsă sau opțiuni invalide | |
398
- | `EroareValidare` | Date greșite, local sau HTTP 400; 422 când DGPCI refuză numărul (`NUMAR_RESPINS`) | `camp`, `acceptate`, `cod` |
427
+ | `EroareValidare` | Date greșite, local sau HTTP 400; 422 când DGPCI refuză numărul (`INVALID_IDENTIFIER`) | `camp`, `acceptate`, `cod` |
399
428
  | `EroareAutentificare` | 401: cheie invalidă sau dezactivată | `hint` |
400
429
  | `EroarePlanInactiv` | 402: fără abonament activ | `hint` |
401
430
  | `EroareInterzis` | 403: `LIMIT_ATINS`, `ARR_NECESITA_PLAN` | `cod`, `limita` |
402
431
  | `EroareNegasit` | 404: vehicul inexistent în cont | |
403
432
  | `EroareConflict` | 409: `VEHICUL_EXISTENT` | |
404
- | `EroareLimita` | 429: cotă, plafon de flotă sau polling prea des | `cod`, `retryAfterMs`, `utilizareZi`, `utilizareLuna` |
405
- | `EroareServer` | 5xx; la numere disponibile `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI`, `TIMEOUT` | `status`, `cod`, `retryAfterMs` |
433
+ | `EroareLimita` | 429: cotă (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`), plafon de flotă sau polling prea des | `cod`, `retryAfterMs`, `utilizareZi`, `utilizareLuna` |
434
+ | `EroareServer` | 5xx; sursa oficială (`UPSTREAM_*`), sau `OCUPAT`, `INDISPONIBIL` la numere disponibile | `status`, `cod`, `retryAfterMs` |
406
435
  | `EroareRetea` | Fără răspuns sau timeout | `timeout`, `neajunsa` |
407
436
  | `EroareRaspunsInvalid` | Răspuns cu formă neașteptată | `raspuns` |
408
- | `EroareVerificare` | Sursa oficială nu a putut fi interogată sau a refuzat datele | `codSursa` |
437
+ | `EroareVerificare` | Sursa oficială nu a dat un răspuns sau a refuzat datele | `cod`, `codSursa` |
409
438
  | `EroareTimeoutVerificare` | `asteapta()` sau `imagini.asteapta()` a depășit `timeoutMs` | |
410
439
  | `EroareWebhook` | Cheie greșită sau payload invalid | `cod` |
411
440
 
@@ -416,7 +445,7 @@ try {
416
445
  await acteo.auto.rca.porneste(numar)
417
446
  } catch (err) {
418
447
  if (err instanceof EroareValidare) return arataUtilizatorului(err.message)
419
- if (err instanceof EroareLimita && err.cod === "COTA_ATINSA") return amanaPanaMaine()
448
+ if (err instanceof EroareLimita && err.cod === "DAILY_LIMIT_REACHED") return amanaPanaMaine()
420
449
  if (err instanceof ActeoError) logger.error(err._tag, err.message, err.hint)
421
450
  throw err
422
451
  }
@@ -432,9 +461,9 @@ SDK-ul nu trimite niciodată de două ori o verificare taxată.
432
461
  |---|---|---|
433
462
  | Rețea căzută, timeout | se reîncearcă | nu (cererea poate să fi ajuns) |
434
463
  | DNS, conexiune refuzată | se reîncearcă | se reîncearcă (sigur nu a ajuns) |
435
- | 502, 503, 504 fără `cod` | se reîncearcă | se reîncearcă (proxy, nu aplicația) |
464
+ | 502, 503, 504 fără `cod` | se reîncearcă | se reîncearcă (cererea nu a ajuns la API) |
436
465
  | 503 `OCUPAT` la numere disponibile | | se reîncearcă după `Retry-After` (netaxat) |
437
- | 502, 503, 504 cu alt `cod` | | nu (netaxat, dar repetarea nu ajută imediat) |
466
+ | 502, 503, 504 cu alt `cod` (`UPSTREAM_*`, `INDISPONIBIL`) | | nu (netaxat, dar repetarea nu ajută imediat) |
438
467
  | 500 | se reîncearcă | nu |
439
468
  | 429 la polling | se reîncearcă după `Retry-After` | |
440
469
  | 429 cotă sau plafon flotă | nu | nu |
package/dist/index.cjs CHANGED
@@ -150,6 +150,27 @@ var EroareWebhook = class extends VerificRcaError {
150
150
  var TipVerificare = effect.Schema.Literal("rca", "itp", "rovinieta", "arr");
151
151
  var StatusDocument = effect.Schema.Literal("valid", "warning", "expired", "not_found");
152
152
  var DataNullabila = effect.Schema.NullOr(effect.Schema.Date);
153
+ var CODURI_EROARE = [
154
+ "UPSTREAM_UNAVAILABLE",
155
+ "UPSTREAM_TIMEOUT",
156
+ "UPSTREAM_BLOCKED",
157
+ "UPSTREAM_CHANGED",
158
+ "DAILY_LIMIT_REACHED",
159
+ "PLAN_LIMIT_REACHED",
160
+ "NOT_FOUND",
161
+ "INVALID_IDENTIFIER",
162
+ "SOLD_INSUFICIENT",
163
+ "PLAFON_NETAXAT",
164
+ "OCUPAT",
165
+ "INDISPONIBIL",
166
+ "VIN_NEDECODAT",
167
+ "VIN_INVALID",
168
+ "ARR_NECESITA_PLAN",
169
+ "LIMIT_ATINS",
170
+ "VEHICUL_EXISTENT",
171
+ "NEGASIT",
172
+ "LIMITA_FLOTA_ATINSA"
173
+ ];
153
174
  var RezultatVerificareSchema = effect.Schema.Struct({
154
175
  /** Tipul verificarii. */
155
176
  tip: TipVerificare,
@@ -165,6 +186,8 @@ var RezultatVerificareSchema = effect.Schema.Struct({
165
186
  status: StatusDocument,
166
187
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
167
188
  expiresAt: DataNullabila,
189
+ /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
190
+ code: effect.Schema.optional(effect.Schema.String),
168
191
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
169
192
  requestId: effect.Schema.optional(effect.Schema.String),
170
193
  /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
@@ -183,8 +206,10 @@ var EsuataSchema = effect.Schema.Struct({
183
206
  tip: TipVerificare,
184
207
  query: effect.Schema.String,
185
208
  status: effect.Schema.Literal("error"),
209
+ /** Motivul. Vezi {@link CodEsecVerificare}. Lipseste doar la serverele mai vechi. */
210
+ code: effect.Schema.optional(effect.Schema.String),
186
211
  error: effect.Schema.String,
187
- /** Doar cand sursa a refuzat datele trimise. Vezi {@link CodRefuzSursa}. */
212
+ /** Doar la `INVALID_IDENTIFIER`: campul refuzat. Vezi {@link CodRefuzSursa}. */
188
213
  cod: effect.Schema.optional(effect.Schema.String),
189
214
  hint: effect.Schema.optional(effect.Schema.String)
190
215
  });
@@ -243,7 +268,9 @@ var WebhookRezultatSchema = effect.Schema.Struct({
243
268
  /** Momentul verificarii, `null` la eroare. */
244
269
  checkedAt: DataNullabila,
245
270
  /** Mesajul de eroare, doar la `status: "error"`. */
246
- error: effect.Schema.optional(effect.Schema.String)
271
+ error: effect.Schema.optional(effect.Schema.String),
272
+ /** La `status: "error"`, motivul ({@link CodEsecVerificare}); la `status: "not_found"`, `"NOT_FOUND"`. */
273
+ code: effect.Schema.optional(effect.Schema.String)
247
274
  });
248
275
  var WebhookDocumentExpiraSchema = effect.Schema.Struct({
249
276
  /** Numele evenimentului. */
@@ -634,7 +661,7 @@ function eroareDinRaspuns(status, headers, body) {
634
661
  switch (status) {
635
662
  case 400:
636
663
  return new EroareValidare({ ...comun, ...c?.accepted && { acceptate: c.accepted } });
637
- // 422: sursa oficiala refuza valoarea trimisa (ex: NUMAR_RESPINS).
664
+ // 422: sursa oficiala refuza valoarea trimisa (INVALID_IDENTIFIER).
638
665
  case 422:
639
666
  return new EroareValidare(comun);
640
667
  case 401:
@@ -1012,7 +1039,7 @@ var interpreteaza = (raspuns, serieSasiu, sinceImplicit) => decodeaza(RaspunsVer
1012
1039
  return effect.Effect.fail(
1013
1040
  new EroareVerificare({
1014
1041
  message: corp.error,
1015
- cod: "VERIFICARE_ESUATA",
1042
+ cod: corp.code ?? "VERIFICARE_ESUATA",
1016
1043
  raspuns: corp,
1017
1044
  ...corp.cod && { codSursa: corp.cod },
1018
1045
  ...corp.hint && { hint: corp.hint }
@@ -1109,7 +1136,7 @@ var sterge = (id) => id.trim() ? trimite({ metoda: "DELETE", cale: `${CALE2}/${e
1109
1136
  ) : effect.Effect.fail(new EroareValidare({ message: "Lipseste ID-ul vehiculului.", camp: "id", cod: "VALIDARE_LOCALA" }));
1110
1137
 
1111
1138
  // src/client.ts
1112
- var VERSIUNE_SDK = "0.4.1";
1139
+ var VERSIUNE_SDK = "0.5.0";
1113
1140
  var URL_IMPLICIT = "https://api.acteo.ro";
1114
1141
  var URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
1115
1142
  var RETRY_IMPLICIT = { incercari: 3, intarziereInitialaMs: 500, intarziereMaximaMs: 1e4 };
@@ -1199,7 +1226,7 @@ var ClientVerificari = class {
1199
1226
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1200
1227
  * @throws {@link EroareAutentificare} cheie API invalida (401).
1201
1228
  * @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
1202
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "COTA_ATINSA"`).
1229
+ * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1203
1230
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1204
1231
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1205
1232
  * @throws {@link EroareRetea} fara raspuns sau timeout.
@@ -1258,7 +1285,7 @@ var ClientVerificari = class {
1258
1285
  * @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
1259
1286
  * @returns rezultatul final al verificarii.
1260
1287
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1261
- * @throws {@link EroareLimita} cota atinsa (`cod: "COTA_ATINSA"`).
1288
+ * @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1262
1289
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1263
1290
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1264
1291
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
@@ -1501,8 +1528,9 @@ var ClientDocument = class {
1501
1528
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
1502
1529
  * @returns rezultatul final.
1503
1530
  * @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
1504
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa.
1505
- * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a refuzat datele.
1531
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
1532
+ * @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
1533
+ * @throws {@link EroareVerificare} sursa oficiala nu a dat un raspuns sau a refuzat datele; motivul e in `cod`.
1506
1534
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1507
1535
  */
1508
1536
  verifica(identificator, optiuni) {
@@ -1519,6 +1547,8 @@ var ClientDocument = class {
1519
1547
  * @param identificator ce cere sursa oficiala pentru acest document.
1520
1548
  * @param optiuni `callbackUrl` si `signal`.
1521
1549
  * @returns rezultatul final sau verificarea in curs.
1550
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
1551
+ * @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
1522
1552
  */
1523
1553
  porneste(identificator, optiuni) {
1524
1554
  const cerere = {
@@ -1598,7 +1628,7 @@ var ClientVin = class {
1598
1628
  * @returns decodarea, completa, partiala sau doar structura.
1599
1629
  * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1600
1630
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1601
- * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1631
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1602
1632
  * @example
1603
1633
  * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1604
1634
  * console.log(d.marca, d.model, d.anFabricatie)
@@ -1622,10 +1652,10 @@ var ClientNumere = class {
1622
1652
  * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1623
1653
  * @param optiuni `signal` pentru anulare.
1624
1654
  * @returns verdictul DGPCI.
1625
- * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`NUMAR_RESPINS`).
1655
+ * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`INVALID_IDENTIFIER`).
1626
1656
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1627
1657
  * @throws {@link EroareLimita} cota atinsa.
1628
- * @throws {@link EroareServer} `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
1658
+ * @throws {@link EroareServer} `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`; cererea nu s-a taxat.
1629
1659
  * @example
1630
1660
  * const r = await acteo.auto.numere.verifica("BV07ABC")
1631
1661
  * if (r.disponibil) console.log("Numarul e liber")
@@ -1651,7 +1681,7 @@ var ClientImagini = class {
1651
1681
  * @returns poza masinii sau poza generica.
1652
1682
  * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1653
1683
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1654
- * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1684
+ * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1655
1685
  * @example
1656
1686
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1657
1687
  * if (p.status === "gata") afiseaza(p.url)
@@ -1748,6 +1778,7 @@ var Acteo = class {
1748
1778
 
1749
1779
  exports.Acteo = Acteo;
1750
1780
  exports.ActeoError = VerificRcaError;
1781
+ exports.CODURI_EROARE = CODURI_EROARE;
1751
1782
  exports.ClientAuto = ClientAuto;
1752
1783
  exports.ClientDocument = ClientDocument;
1753
1784
  exports.ClientImagini = ClientImagini;