@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/CHANGELOG.md CHANGED
@@ -1,5 +1,29 @@
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
+
23
+ ## @acteo/api 0.4.1 (2026-10-31)
24
+
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ă.
26
+
3
27
  ## @acteo/api 0.4.0 (2026-10-31)
4
28
 
5
29
  - Corectură: `verificaNotificare()` (și `verificaWebhookNotificare()`) citește cheia din headerul `X-Acteo-Key`, cel trimis acum de API. Până acum căuta doar `X-Verificrca-Key`, așa că notificările reale erau respinse cu `CHEIE_INVALIDA`. Headerul vechi e citit în continuare când lipsește cel nou. `HEADER_CHEIE_WEBHOOK` e acum `"x-acteo-key"`, iar `HEADER_EVENIMENT_WEBHOOK` e `"x-acteo-event"`.
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"
@@ -185,7 +185,7 @@ Formatele de număr acceptate: București (`B123ABC`, `B12ABC`), județe (`CJ45X
185
185
 
186
186
  ## Cum decurge o verificare
187
187
 
188
- 1. **Cerere** (`porneste`). Dacă există un rezultat recent pentru mașina respectivă, îl primești imediat. Altfel verificarea intră în coadă și primești `status: "processing"`.
188
+ 1. **Cerere** (`porneste`). Fiecare cerere interoghează sursa oficială: verificarea intră în coadă și primești `status: "processing"`.
189
189
  2. **Interogarea sursei.** Sursa oficială e consultată în fundal. Dacă nu răspunde în 4 minute, verificarea se încheie cu eroare.
190
190
  3. **Rezultatul** ajunge la tine pe una din trei căi:
191
191
  - `verifica()` face tot drumul și întoarce direct rezultatul final;
@@ -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
  |---|---|
@@ -235,7 +245,7 @@ Disponibil pe `auto.rca`, `auto.itp`, `auto.rovinieta` și `auto.arr`. Pornește
235
245
 
236
246
  ### `auto.<document>.porneste(identificator, { callbackUrl? })`
237
247
 
238
- Pornește verificarea fără să aștepte. Întoarce fie rezultatul final (dacă există unul recent), fie un obiect `VerificareInCurs` pe care îl dai mai departe la `rezultat()` sau `asteapta()`.
248
+ Pornește verificarea fără să aștepte. Întoarce un obiect `VerificareInCurs` pe care îl dai mai departe la `rezultat()` sau `asteapta()`.
239
249
 
240
250
  ```ts
241
251
  const r = await acteo.auto.itp.porneste("WVWZZZ1JZXW000001", {
@@ -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 |
@@ -449,7 +478,7 @@ const acteo = new Acteo({
449
478
 
450
479
  ## Cotă și limite
451
480
 
452
- Fiecare verificare consumă o unitate din cota zilnică și lunară a planului, dar numai când sursa oficială a răspuns. Decodarea VIN, numerele disponibile și pozele au fiecare abonamentul și cota lor: decodarea se taxează doar cu marcă și model găsite, numărul doar când DGPCI dă un verdict, iar poza doar când e gata. Decodările fără rezultat și pozele generice au un plafon zilnic separat. Dacă mașina a fost verificată de curând, primești imediat rezultatul existent, iar cererea consumă din cotă. Dacă sursa nu răspunde, nu consumi nimic. Verificările încă în curs ocupă cota până la răspuns, ca să nu treci de limită cu cereri trimise în paralel.
481
+ Fiecare verificare consumă o unitate din cota zilnică și lunară a planului, dar numai când sursa oficială a răspuns. Decodarea VIN, numerele disponibile și pozele au fiecare abonamentul și cota lor: decodarea se taxează doar cu marcă și model găsite, numărul doar când DGPCI dă un verdict, iar poza doar când e gata. Decodările fără rezultat și pozele generice au un plafon zilnic separat. Dacă sursa nu răspunde, nu consumi nimic. Verificările încă în curs ocupă cota până la răspuns, ca să nu treci de limită cu cereri trimise în paralel.
453
482
 
454
483
  Rezultatele (inclusiv decodările, numerele și pozele) au câmpul `limite`, completat din headerele `X-RateLimit-*`:
455
484
 
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,
@@ -159,12 +180,14 @@ var RezultatVerificareSchema = effect.Schema.Struct({
159
180
  numarInmatriculare: effect.Schema.NullOr(effect.Schema.String),
160
181
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
161
182
  serieSasiu: effect.Schema.NullOr(effect.Schema.String),
162
- /** Cand a fost interogata sursa oficiala. */
183
+ /** Momentul verificarii. */
163
184
  checkedAt: effect.Schema.Date,
164
185
  /** Starea documentului. Vezi {@link StatusDocument}. */
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
  });
@@ -240,10 +265,12 @@ var WebhookRezultatSchema = effect.Schema.Struct({
240
265
  status: effect.Schema.Union(StatusDocument, effect.Schema.Literal("error")),
241
266
  /** Rezultatul complet, `null` la `status: "error"`. */
242
267
  result: effect.Schema.NullOr(RezultatVerificareSchema),
243
- /** Cand a fost interogata sursa, `null` la eroare. */
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.0";
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 };
@@ -1184,9 +1211,8 @@ var ClientVerificari = class {
1184
1211
  /**
1185
1212
  * Porneste o verificare si consuma o unitate din cota planului.
1186
1213
  *
1187
- * Daca vehiculul a fost verificat de curand, primesti imediat rezultatul
1188
- * existent. Altfel verificarea intra in
1189
- * coada si primesti `status: "processing"`; rezultatul il afli cu
1214
+ * Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
1215
+ * primesti `status: "processing"`; rezultatul il afli cu
1190
1216
  * {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
1191
1217
  * prin webhook, daca ai trimis `callbackUrl`.
1192
1218
  *
@@ -1200,7 +1226,7 @@ var ClientVerificari = class {
1200
1226
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1201
1227
  * @throws {@link EroareAutentificare} cheie API invalida (401).
1202
1228
  * @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
1203
- * @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"`).
1204
1230
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1205
1231
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1206
1232
  * @throws {@link EroareRetea} fara raspuns sau timeout.
@@ -1259,7 +1285,7 @@ var ClientVerificari = class {
1259
1285
  * @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
1260
1286
  * @returns rezultatul final al verificarii.
1261
1287
  * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1262
- * @throws {@link EroareLimita} cota atinsa (`cod: "COTA_ATINSA"`).
1288
+ * @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
1263
1289
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1264
1290
  * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1265
1291
  * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
@@ -1497,14 +1523,14 @@ var ClientDocument = class {
1497
1523
  }
1498
1524
  /**
1499
1525
  * Verifica documentul si asteapta rezultatul final de la sursa oficiala.
1500
- * Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
1501
1526
  *
1502
1527
  * @param identificator ce cere sursa oficiala pentru acest document.
1503
1528
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
1504
1529
  * @returns rezultatul final.
1505
1530
  * @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
1506
- * @throws {@link EroareLimita} cota zilnica sau lunara atinsa.
1507
- * @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`.
1508
1534
  * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1509
1535
  */
1510
1536
  verifica(identificator, optiuni) {
@@ -1514,14 +1540,15 @@ var ClientDocument = class {
1514
1540
  );
1515
1541
  }
1516
1542
  /**
1517
- * Porneste verificarea fara sa astepte. Primesti rezultatul imediat, daca
1518
- * vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
1543
+ * Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
1519
1544
  * afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
1520
1545
  * sau prin webhook la `callbackUrl`.
1521
1546
  *
1522
1547
  * @param identificator ce cere sursa oficiala pentru acest document.
1523
1548
  * @param optiuni `callbackUrl` si `signal`.
1524
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.
1525
1552
  */
1526
1553
  porneste(identificator, optiuni) {
1527
1554
  const cerere = {
@@ -1601,7 +1628,7 @@ var ClientVin = class {
1601
1628
  * @returns decodarea, completa, partiala sau doar structura.
1602
1629
  * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1603
1630
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1604
- * @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`).
1605
1632
  * @example
1606
1633
  * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1607
1634
  * console.log(d.marca, d.model, d.anFabricatie)
@@ -1625,10 +1652,10 @@ var ClientNumere = class {
1625
1652
  * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1626
1653
  * @param optiuni `signal` pentru anulare.
1627
1654
  * @returns verdictul DGPCI.
1628
- * @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`).
1629
1656
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1630
1657
  * @throws {@link EroareLimita} cota atinsa.
1631
- * @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.
1632
1659
  * @example
1633
1660
  * const r = await acteo.auto.numere.verifica("BV07ABC")
1634
1661
  * if (r.disponibil) console.log("Numarul e liber")
@@ -1654,7 +1681,7 @@ var ClientImagini = class {
1654
1681
  * @returns poza masinii sau poza generica.
1655
1682
  * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1656
1683
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1657
- * @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`).
1658
1685
  * @example
1659
1686
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1660
1687
  * if (p.status === "gata") afiseaza(p.url)
@@ -1751,6 +1778,7 @@ var Acteo = class {
1751
1778
 
1752
1779
  exports.Acteo = Acteo;
1753
1780
  exports.ActeoError = VerificRcaError;
1781
+ exports.CODURI_EROARE = CODURI_EROARE;
1754
1782
  exports.ClientAuto = ClientAuto;
1755
1783
  exports.ClientDocument = ClientDocument;
1756
1784
  exports.ClientImagini = ClientImagini;