@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 +4 -0
- package/README.md +3 -3
- package/dist/index.cjs +6 -9
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +7 -10
- package/dist/index.d.ts +7 -10
- package/dist/index.js +6 -9
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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`).
|
|
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
|
|
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ă
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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.
|
|
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
|
-
*
|
|
1188
|
-
*
|
|
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
|
|
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
|
*
|