@acteo/api 0.4.0 → 0.4.1

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,9 @@
1
1
  # Changelog
2
2
 
3
+ ## @acteo/api 0.4.1 (2026-10-31)
4
+
5
+ - 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ă.
6
+
3
7
  ## @acteo/api 0.4.0 (2026-10-31)
4
8
 
5
9
  - 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
@@ -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;
@@ -235,7 +235,7 @@ Disponibil pe `auto.rca`, `auto.itp`, `auto.rovinieta` și `auto.arr`. Pornește
235
235
 
236
236
  ### `auto.<document>.porneste(identificator, { callbackUrl? })`
237
237
 
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()`.
238
+ Pornește verificarea fără să aștepte. Întoarce un obiect `VerificareInCurs` pe care îl dai mai departe la `rezultat()` sau `asteapta()`.
239
239
 
240
240
  ```ts
241
241
  const r = await acteo.auto.itp.porneste("WVWZZZ1JZXW000001", {
@@ -449,7 +449,7 @@ const acteo = new Acteo({
449
449
 
450
450
  ## Cotă și limite
451
451
 
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.
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ă 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
453
 
454
454
  Rezultatele (inclusiv decodările, numerele și pozele) au câmpul `limite`, completat din headerele `X-RateLimit-*`:
455
455
 
package/dist/index.cjs CHANGED
@@ -159,7 +159,7 @@ var RezultatVerificareSchema = effect.Schema.Struct({
159
159
  numarInmatriculare: effect.Schema.NullOr(effect.Schema.String),
160
160
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
161
161
  serieSasiu: effect.Schema.NullOr(effect.Schema.String),
162
- /** Cand a fost interogata sursa oficiala. */
162
+ /** Momentul verificarii. */
163
163
  checkedAt: effect.Schema.Date,
164
164
  /** Starea documentului. Vezi {@link StatusDocument}. */
165
165
  status: StatusDocument,
@@ -240,7 +240,7 @@ var WebhookRezultatSchema = effect.Schema.Struct({
240
240
  status: effect.Schema.Union(StatusDocument, effect.Schema.Literal("error")),
241
241
  /** Rezultatul complet, `null` la `status: "error"`. */
242
242
  result: effect.Schema.NullOr(RezultatVerificareSchema),
243
- /** Cand a fost interogata sursa, `null` la eroare. */
243
+ /** Momentul verificarii, `null` la eroare. */
244
244
  checkedAt: DataNullabila,
245
245
  /** Mesajul de eroare, doar la `status: "error"`. */
246
246
  error: effect.Schema.optional(effect.Schema.String)
@@ -1109,7 +1109,7 @@ var sterge = (id) => id.trim() ? trimite({ metoda: "DELETE", cale: `${CALE2}/${e
1109
1109
  ) : effect.Effect.fail(new EroareValidare({ message: "Lipseste ID-ul vehiculului.", camp: "id", cod: "VALIDARE_LOCALA" }));
1110
1110
 
1111
1111
  // src/client.ts
1112
- var VERSIUNE_SDK = "0.4.0";
1112
+ var VERSIUNE_SDK = "0.4.1";
1113
1113
  var URL_IMPLICIT = "https://api.acteo.ro";
1114
1114
  var URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
1115
1115
  var RETRY_IMPLICIT = { incercari: 3, intarziereInitialaMs: 500, intarziereMaximaMs: 1e4 };
@@ -1184,9 +1184,8 @@ var ClientVerificari = class {
1184
1184
  /**
1185
1185
  * Porneste o verificare si consuma o unitate din cota planului.
1186
1186
  *
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
1187
+ * Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
1188
+ * primesti `status: "processing"`; rezultatul il afli cu
1190
1189
  * {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
1191
1190
  * prin webhook, daca ai trimis `callbackUrl`.
1192
1191
  *
@@ -1497,7 +1496,6 @@ var ClientDocument = class {
1497
1496
  }
1498
1497
  /**
1499
1498
  * Verifica documentul si asteapta rezultatul final de la sursa oficiala.
1500
- * Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
1501
1499
  *
1502
1500
  * @param identificator ce cere sursa oficiala pentru acest document.
1503
1501
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
@@ -1514,8 +1512,7 @@ var ClientDocument = class {
1514
1512
  );
1515
1513
  }
1516
1514
  /**
1517
- * Porneste verificarea fara sa astepte. Primesti rezultatul imediat, daca
1518
- * vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
1515
+ * Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
1519
1516
  * afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
1520
1517
  * sau prin webhook la `callbackUrl`.
1521
1518
  *