@acteo/api 0.0.0-stage → 0.4.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.
@@ -0,0 +1,1751 @@
1
+ import { Schema, Data, Context, Effect } from 'effect';
2
+
3
+ /** Tipurile de verificare: RCA (AIDA/BAAR), ITP (RAR), rovinieta (CNAIR), ARR (copie conforma). */
4
+ declare const TipVerificare: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
5
+ /** Tipul verificarii: `"rca"`, `"itp"`, `"rovinieta"` sau `"arr"`. */
6
+ type TipVerificare = typeof TipVerificare.Type;
7
+ /**
8
+ * Starea documentului:
9
+ * - `valid`: valabil si departe de expirare;
10
+ * - `warning`: expira curand (RCA 14 zile, ITP 30, rovinieta 7, ARR 14);
11
+ * - `expired`: expirat sau inexistent, confirmat de sursa oficiala;
12
+ * - `not_found`: sursa nu a gasit vehiculul.
13
+ */
14
+ declare const StatusDocument: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
15
+ /** Starea documentului: `"valid"`, `"warning"`, `"expired"` sau `"not_found"`. Vezi {@link StatusDocument}. */
16
+ type StatusDocument = typeof StatusDocument.Type;
17
+ declare const RezultatVerificareSchema: Schema.Struct<{
18
+ /** Tipul verificarii. */
19
+ tip: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
20
+ /** Identificatorul dupa care s-a cautat (la RCA cu VIN, acesta e VIN-ul). */
21
+ query: typeof Schema.String;
22
+ /** Numarul de inmatriculare verificat, `null` cand cautarea s-a facut doar dupa VIN. */
23
+ numarInmatriculare: Schema.NullOr<typeof Schema.String>;
24
+ /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
25
+ serieSasiu: Schema.NullOr<typeof Schema.String>;
26
+ /** Cand a fost interogata sursa oficiala. */
27
+ checkedAt: typeof Schema.Date;
28
+ /** Starea documentului. Vezi {@link StatusDocument}. */
29
+ status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
30
+ /** Data expirarii documentului, `null` daca nu exista document valabil. */
31
+ expiresAt: Schema.NullOr<typeof Schema.Date>;
32
+ /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
33
+ requestId: Schema.optional<typeof Schema.String>;
34
+ /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
35
+ hint: Schema.optional<typeof Schema.String>;
36
+ }>;
37
+ /**
38
+ * Codurile cu care sursa oficiala refuza datele trimise. O reincercare cu
39
+ * aceleasi date nu ajuta; trebuie corectat campul indicat:
40
+ * - `serie_talon_invalida`: numarul certificatului de inmatriculare (talon);
41
+ * - `vin_invalid`: seria de sasiu;
42
+ * - `numar_invalid`: numarul de inmatriculare.
43
+ *
44
+ * Tipul accepta si alte valori, pentru coduri adaugate ulterior de API.
45
+ */
46
+ type CodRefuzSursa = "serie_talon_invalida" | "vin_invalid" | "numar_invalid" | (string & {});
47
+ declare const VehiculSchema: Schema.Struct<{
48
+ /** ID-ul vehiculului in cont, folosit la stergere. */
49
+ id: typeof Schema.String;
50
+ /** Numarul de inmatriculare, `null` daca vehiculul a fost adaugat doar cu VIN. */
51
+ numarInmatriculare: Schema.NullOr<typeof Schema.String>;
52
+ /** Seria de sasiu (VIN), `null` daca vehiculul a fost adaugat doar cu numarul. */
53
+ serieSasiu: Schema.NullOr<typeof Schema.String>;
54
+ /** Numarul certificatului de inmatriculare (talon). Fara el rovinieta nu se verifica. */
55
+ serieTalon: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
56
+ default: () => null;
57
+ }>;
58
+ /** Sursa oficiala a respins numarul talonului; rovinieta nu se mai verifica pana la corectarea lui. */
59
+ serieTalonRespinsa: Schema.optionalWith<typeof Schema.Boolean, {
60
+ default: () => false;
61
+ }>;
62
+ /** Data expirarii RCA, `null` daca nu e cunoscuta inca. */
63
+ rcaExpiraLa: Schema.NullOr<typeof Schema.Date>;
64
+ /** Data expirarii ITP, `null` daca nu e cunoscuta inca (ITP-ul cere VIN). */
65
+ itpExpiraLa: Schema.NullOr<typeof Schema.Date>;
66
+ /** Data expirarii rovinietei, `null` daca nu e cunoscuta inca (rovinieta cere numar, VIN si numarul talonului). */
67
+ rovinietaExpiraLa: Schema.NullOr<typeof Schema.Date>;
68
+ /** Data expirarii copiei conforme ARR. Completata doar cand `arrMonitorizat` e `true`. */
69
+ arrExpiraLa: Schema.NullOr<typeof Schema.Date>;
70
+ /** Vehiculul e monitorizat si pentru copia conforma ARR (cere un plan activ). */
71
+ arrMonitorizat: typeof Schema.Boolean;
72
+ /** Cand a fost adaugat vehiculul in cont. */
73
+ createdAt: typeof Schema.Date;
74
+ /** Vehiculul e verificat automat si primeste notificari de expirare. */
75
+ activ: typeof Schema.Boolean;
76
+ }>;
77
+ /** Un vehicul monitorizat din cont, cu datele de expirare ale documentelor. */
78
+ type Vehicul = typeof VehiculSchema.Type;
79
+ /** Rezultatul livrat la `callbackUrl` dupa o verificare. */
80
+ declare const WebhookRezultatSchema: Schema.Struct<{
81
+ /** ID-ul cererii, acelasi cu `requestId` primit de la `porneste()`. */
82
+ requestId: typeof Schema.String;
83
+ /** Tipul verificarii. */
84
+ tip: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
85
+ /** Identificatorul dupa care s-a cautat. */
86
+ query: typeof Schema.String;
87
+ /** Seria de sasiu trimisa in cerere, daca exista. */
88
+ serieSasiu: Schema.NullOr<typeof Schema.String>;
89
+ /** Starea documentului sau `"error"` cand sursa oficiala nu a raspuns. */
90
+ status: Schema.Union<[Schema.Literal<["valid", "warning", "expired", "not_found"]>, Schema.Literal<["error"]>]>;
91
+ /** Rezultatul complet, `null` la `status: "error"`. */
92
+ result: Schema.NullOr<Schema.Struct<{
93
+ /** Tipul verificarii. */
94
+ tip: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
95
+ /** Identificatorul dupa care s-a cautat (la RCA cu VIN, acesta e VIN-ul). */
96
+ query: typeof Schema.String;
97
+ /** Numarul de inmatriculare verificat, `null` cand cautarea s-a facut doar dupa VIN. */
98
+ numarInmatriculare: Schema.NullOr<typeof Schema.String>;
99
+ /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
100
+ serieSasiu: Schema.NullOr<typeof Schema.String>;
101
+ /** Cand a fost interogata sursa oficiala. */
102
+ checkedAt: typeof Schema.Date;
103
+ /** Starea documentului. Vezi {@link StatusDocument}. */
104
+ status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
105
+ /** Data expirarii documentului, `null` daca nu exista document valabil. */
106
+ expiresAt: Schema.NullOr<typeof Schema.Date>;
107
+ /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
108
+ requestId: Schema.optional<typeof Schema.String>;
109
+ /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
110
+ hint: Schema.optional<typeof Schema.String>;
111
+ }>>;
112
+ /** Cand a fost interogata sursa, `null` la eroare. */
113
+ checkedAt: Schema.NullOr<typeof Schema.Date>;
114
+ /** Mesajul de eroare, doar la `status: "error"`. */
115
+ error: Schema.optional<typeof Schema.String>;
116
+ }>;
117
+ /** Payloadul POST trimis la `callbackUrl` cand o verificare se termina. */
118
+ type WebhookRezultat = typeof WebhookRezultatSchema.Type;
119
+ /** Evenimentul `document.expira`: un document a intrat intr-un prag de expirare. */
120
+ declare const WebhookDocumentExpiraSchema: Schema.Struct<{
121
+ /** Numele evenimentului. */
122
+ event: Schema.Literal<["document.expira"]>;
123
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
124
+ id: typeof Schema.String;
125
+ /** Vehiculul la care expira documentul. */
126
+ vehicul: Schema.Struct<{
127
+ /** ID-ul vehiculului in cont, acelasi ca in `vehicule.lista()`. */
128
+ id: typeof Schema.String;
129
+ /** Numarul de inmatriculare, daca e cunoscut. */
130
+ numarInmatriculare: Schema.NullOr<typeof Schema.String>;
131
+ /** Seria de sasiu (VIN), daca e cunoscuta. */
132
+ serieSasiu: Schema.NullOr<typeof Schema.String>;
133
+ }>;
134
+ /** Documentul care expira. */
135
+ document: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
136
+ /** Data expirarii documentului. */
137
+ expiraLa: typeof Schema.Date;
138
+ /** Zile intregi ramase pana la expirare (minim 0). */
139
+ zileRamase: typeof Schema.Number;
140
+ /** Pragul de notificare atins, in zile (RCA/ITP/rovinieta: 30, 14, 3; ARR: 60, 50, 45). */
141
+ prag: typeof Schema.Number;
142
+ /** Cand a fost trimisa notificarea. */
143
+ trimisLa: typeof Schema.Date;
144
+ }>;
145
+ /** Notificarea trimisa cand un document intra intr-un prag de expirare. */
146
+ type WebhookDocumentExpira = typeof WebhookDocumentExpiraSchema.Type;
147
+ /** Evenimentul `webhook.test`, trimis din butonul de test din dashboard. */
148
+ declare const WebhookTestSchema: Schema.Struct<{
149
+ /** Numele evenimentului. */
150
+ event: Schema.Literal<["webhook.test"]>;
151
+ /** ID unic al testului. */
152
+ id: typeof Schema.String;
153
+ /** Mesajul de confirmare. */
154
+ mesaj: typeof Schema.String;
155
+ /** Cand a fost trimis testul. */
156
+ trimisLa: typeof Schema.Date;
157
+ }>;
158
+ /** Evenimentul trimis de butonul de test din dashboard. */
159
+ type WebhookTest = typeof WebhookTestSchema.Type;
160
+ /** Evenimentul `dosar.eveniment`: noutate intr-un dosar monitorizat. */
161
+ declare const WebhookDosarEvenimentSchema: Schema.Struct<{
162
+ /** Numele evenimentului. */
163
+ event: Schema.Literal<["dosar.eveniment"]>;
164
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
165
+ id: typeof Schema.String;
166
+ /** Cand a fost trimisa notificarea. */
167
+ trimisLa: typeof Schema.Date;
168
+ /** Dosarul monitorizat. */
169
+ dosar: Schema.Struct<{
170
+ /** ID-ul dosarului in cont. */
171
+ id: typeof Schema.String;
172
+ /** Numarul dosarului la instanta, ex: `1234/3/2024`. */
173
+ numar: typeof Schema.String;
174
+ /** Eticheta pusa de tine in cont. */
175
+ eticheta: Schema.NullOr<typeof Schema.String>;
176
+ }>;
177
+ /** Ce s-a intamplat in dosar. */
178
+ eveniment: Schema.Struct<{
179
+ /**
180
+ * `termen_nou` (sedinta noua), `solutie`, `cale_atac` (apel, recurs), `stadiu`,
181
+ * `instanta_noua` sau `incheiat_auto` (180 de zile fara noutati: dosarul nu mai e monitorizat).
182
+ */
183
+ tip: Schema.Literal<["termen_nou", "solutie", "cale_atac", "stadiu", "instanta_noua", "incheiat_auto"]>;
184
+ /** Textul alertei, ca in email. */
185
+ descriere: typeof Schema.String;
186
+ /** Instanta, cand e cunoscuta. */
187
+ institutie: Schema.NullOr<typeof Schema.String>;
188
+ }>;
189
+ }>;
190
+ /** Noutate intr-un dosar monitorizat. */
191
+ type WebhookDosarEveniment = typeof WebhookDosarEvenimentSchema.Type;
192
+ /** Evenimentul `dosar.termen`: se apropie o sedinta intr-un dosar monitorizat. */
193
+ declare const WebhookDosarTermenSchema: Schema.Struct<{
194
+ /** Numele evenimentului. */
195
+ event: Schema.Literal<["dosar.termen"]>;
196
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
197
+ id: typeof Schema.String;
198
+ /** Cand a fost trimisa notificarea. */
199
+ trimisLa: typeof Schema.Date;
200
+ /** Dosarul monitorizat. */
201
+ dosar: Schema.Struct<{
202
+ /** ID-ul dosarului in cont. */
203
+ id: typeof Schema.String;
204
+ /** Numarul dosarului la instanta, ex: `1234/3/2024`. */
205
+ numar: typeof Schema.String;
206
+ /** Eticheta pusa de tine in cont. */
207
+ eticheta: Schema.NullOr<typeof Schema.String>;
208
+ }>;
209
+ /** Sedinta care se apropie. */
210
+ sedinta: Schema.Struct<{
211
+ /** Data sedintei. */
212
+ data: typeof Schema.Date;
213
+ /** Ora sedintei, cand e cunoscuta. */
214
+ ora: Schema.NullOr<typeof Schema.String>;
215
+ /** Instanta. */
216
+ institutie: Schema.NullOr<typeof Schema.String>;
217
+ /** Completul de judecata. */
218
+ complet: Schema.NullOr<typeof Schema.String>;
219
+ }>;
220
+ /** Reminder cu 3 zile si cu o zi inainte de sedinta. */
221
+ zileRamase: Schema.Literal<[1, 3]>;
222
+ }>;
223
+ /** Se apropie o sedinta intr-un dosar monitorizat. */
224
+ type WebhookDosarTermen = typeof WebhookDosarTermenSchema.Type;
225
+ /** Evenimentul `firma.schimbare`: ANAF a schimbat starea unei firme monitorizate. */
226
+ declare const WebhookFirmaSchimbareSchema: Schema.Struct<{
227
+ /** Numele evenimentului. */
228
+ event: Schema.Literal<["firma.schimbare"]>;
229
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
230
+ id: typeof Schema.String;
231
+ /** Cand a fost trimisa notificarea. */
232
+ trimisLa: typeof Schema.Date;
233
+ /** Firma monitorizata. */
234
+ firma: Schema.Struct<{
235
+ /** ID-ul firmei in cont. */
236
+ id: typeof Schema.String;
237
+ /** Denumirea firmei. */
238
+ denumire: typeof Schema.String;
239
+ }>;
240
+ /** Campurile schimbate. */
241
+ schimbari: Schema.Array$<Schema.Struct<{
242
+ /** Campul schimbat. */
243
+ camp: Schema.Literal<["radiata", "inactiv", "platitor_tva", "tva_la_incasare", "split_tva", "e_factura", "denumire", "adresa", "caen"]>;
244
+ /** Valoarea dinainte (`"da"` / `"nu"` sau textul ANAF); `null` cand nu e cunoscuta. */
245
+ valoareVeche: Schema.NullOr<typeof Schema.String>;
246
+ /** Valoarea de acum. */
247
+ valoareNoua: typeof Schema.String;
248
+ /** Data (`yyyy-mm-dd`) de la care se aplica, cand ANAF o da. */
249
+ dataEfect: Schema.NullOr<typeof Schema.String>;
250
+ }>>;
251
+ }>;
252
+ /** ANAF a schimbat starea unei firme monitorizate. */
253
+ type WebhookFirmaSchimbare = typeof WebhookFirmaSchimbareSchema.Type;
254
+ /** Evenimentul `firma.dosar`: dosar nou in instanta pe numele unei firme monitorizate. */
255
+ declare const WebhookFirmaDosarSchema: Schema.Struct<{
256
+ /** Numele evenimentului. */
257
+ event: Schema.Literal<["firma.dosar"]>;
258
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
259
+ id: typeof Schema.String;
260
+ /** Cand a fost trimisa notificarea. */
261
+ trimisLa: typeof Schema.Date;
262
+ /** Firma monitorizata. */
263
+ firma: Schema.Struct<{
264
+ /** ID-ul firmei in cont. */
265
+ id: typeof Schema.String;
266
+ /** Denumirea firmei. */
267
+ denumire: typeof Schema.String;
268
+ }>;
269
+ /** Dosarul nou. */
270
+ dosar: Schema.Struct<{
271
+ /** Numarul dosarului. */
272
+ numar: typeof Schema.String;
273
+ /** Instanta. */
274
+ institutie: typeof Schema.String;
275
+ /** Calitatea firmei in dosar. */
276
+ calitateParte: Schema.NullOr<typeof Schema.String>;
277
+ /** Obiectul dosarului. */
278
+ obiect: Schema.NullOr<typeof Schema.String>;
279
+ /** Categoria de pe portalul instantelor (ex: Faliment). */
280
+ categorie: Schema.NullOr<typeof Schema.String>;
281
+ /**
282
+ * Dosar de insolventa: `debitor` (firma e in procedura), `creditor` (are de
283
+ * recuperat bani in procedura altcuiva), `alta`; `null` pentru alt fel de dosar.
284
+ */
285
+ insolventa: Schema.NullOr<Schema.Literal<["debitor", "creditor", "alta"]>>;
286
+ }>;
287
+ }>;
288
+ /** Dosar nou pe numele unei firme monitorizate. */
289
+ type WebhookFirmaDosar = typeof WebhookFirmaDosarSchema.Type;
290
+ /** Evenimentul `marca.schimbare`: s-a schimbat ceva la o marca urmarita. */
291
+ declare const WebhookMarcaSchimbareSchema: Schema.Struct<{
292
+ /** Numele evenimentului. */
293
+ event: Schema.Literal<["marca.schimbare"]>;
294
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
295
+ id: typeof Schema.String;
296
+ /** Cand a fost trimisa notificarea. */
297
+ trimisLa: typeof Schema.Date;
298
+ /** Marca urmarita. */
299
+ marca: Schema.Struct<{
300
+ /** ID-ul marcii in cont. */
301
+ id: typeof Schema.String;
302
+ /** ID-ul marcii in TMview (oficiul + numarul). */
303
+ st13: typeof Schema.String;
304
+ /** Numele marcii. */
305
+ nume: typeof Schema.String;
306
+ /** `RO` = OSIM, `EM` = EUIPO (marca a Uniunii Europene). */
307
+ oficiu: Schema.Literal<["RO", "EM"]>;
308
+ /** Numarul de depozit. */
309
+ numarDepozit: typeof Schema.String;
310
+ }>;
311
+ /** Ce s-a schimbat; `inregistrata` = cererea in curs a devenit marca inregistrata. */
312
+ schimbare: Schema.Literal<["inregistrata", "reinnoita", "expirata", "anulata", "respinsa", "retrasa", "opozitie"]>;
313
+ /** La `reinnoita`: vechea data de expirare (`yyyy-mm-dd`); la `opozitie`: numarul vechi de opozitii; altfel statusul vechi. */
314
+ valoareVeche: typeof Schema.String;
315
+ /** Ca `valoareVeche`, valoarea de acum. */
316
+ valoareNoua: typeof Schema.String;
317
+ }>;
318
+ /** S-a schimbat ceva la o marca urmarita (OSIM sau EUIPO). */
319
+ type WebhookMarcaSchimbare = typeof WebhookMarcaSchimbareSchema.Type;
320
+ /** Evenimentul `marca.expira`: o marca urmarita intra intr-un prag de expirare. */
321
+ declare const WebhookMarcaExpiraSchema: Schema.Struct<{
322
+ /** Numele evenimentului. */
323
+ event: Schema.Literal<["marca.expira"]>;
324
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
325
+ id: typeof Schema.String;
326
+ /** Cand a fost trimisa notificarea. */
327
+ trimisLa: typeof Schema.Date;
328
+ /** Marca urmarita. */
329
+ marca: Schema.Struct<{
330
+ /** ID-ul marcii in cont. */
331
+ id: typeof Schema.String;
332
+ /** ID-ul marcii in TMview (oficiul + numarul). */
333
+ st13: typeof Schema.String;
334
+ /** Numele marcii. */
335
+ nume: typeof Schema.String;
336
+ /** `RO` = OSIM, `EM` = EUIPO (marca a Uniunii Europene). */
337
+ oficiu: Schema.Literal<["RO", "EM"]>;
338
+ /** Numarul de depozit. */
339
+ numarDepozit: typeof Schema.String;
340
+ }>;
341
+ /** Data expirarii, `yyyy-mm-dd`. */
342
+ expiraLa: typeof Schema.String;
343
+ /** `6l`, `3l`, `1l` (luni), `7z` (zile) inainte; `gratie` = a expirat, se mai poate reinnoi cu taxa. */
344
+ prag: Schema.Literal<["6l", "3l", "1l", "7z", "gratie"]>;
345
+ /** La `gratie`: ultima zi (`yyyy-mm-dd`) in care se mai poate reinnoi; altfel `null`. */
346
+ reinnoirePanaLa: Schema.NullOr<typeof Schema.String>;
347
+ }>;
348
+ /** O marca urmarita intra intr-un prag de expirare. */
349
+ type WebhookMarcaExpira = typeof WebhookMarcaExpiraSchema.Type;
350
+ /** Evenimentul `asigurare.schimbare`: s-a schimbat statutul de asigurat la CNAS. */
351
+ declare const WebhookAsigurareSchimbareSchema: Schema.Struct<{
352
+ /** Numele evenimentului. */
353
+ event: Schema.Literal<["asigurare.schimbare"]>;
354
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
355
+ id: typeof Schema.String;
356
+ /** Cand a fost trimisa notificarea. */
357
+ trimisLa: typeof Schema.Date;
358
+ /** Persoana monitorizata. */
359
+ persoana: Schema.Struct<{
360
+ /** ID-ul persoanei in cont. */
361
+ id: typeof Schema.String;
362
+ /** Numele persoanei. */
363
+ nume: typeof Schema.String;
364
+ }>;
365
+ /** Statutul de acum. */
366
+ statut: Schema.Literal<["asigurat", "neasigurat", "necunoscut"]>;
367
+ /** Cardul de sanatate e emis; `null` cand CNAS nu spune. */
368
+ areCard: Schema.NullOr<typeof Schema.Boolean>;
369
+ /** Cand a fost interogat CNAS. */
370
+ verificatLa: typeof Schema.Date;
371
+ }>;
372
+ /** S-a schimbat statutul de asigurat la CNAS al unei persoane monitorizate. */
373
+ type WebhookAsigurareSchimbare = typeof WebhookAsigurareSchimbareSchema.Type;
374
+ /** Evenimentul `termen.expira`: un termen din cont intra in pragul de 30 sau de 3 zile. */
375
+ declare const WebhookTermenExpiraSchema: Schema.Struct<{
376
+ /** Numele evenimentului. */
377
+ event: Schema.Literal<["termen.expira"]>;
378
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
379
+ id: typeof Schema.String;
380
+ /** Cand a fost trimisa notificarea. */
381
+ trimisLa: typeof Schema.Date;
382
+ /** Termenul din cont. */
383
+ termen: Schema.Struct<{
384
+ /** ID-ul termenului in cont. */
385
+ id: typeof Schema.String;
386
+ /** `auto`, `personale`, `sanatate`, `afaceri` sau `casa`. */
387
+ categorie: typeof Schema.String;
388
+ /** Tipul termenului. */
389
+ tip: typeof Schema.String;
390
+ /** Numele termenului, ex: Pasaport sau numele dat de tine. */
391
+ eticheta: typeof Schema.String;
392
+ /** Al cui e termenul: numarul masinii, firma sau persoana. */
393
+ al: Schema.NullOr<typeof Schema.String>;
394
+ /** Data scadentei, `yyyy-mm-dd`. */
395
+ expiraLa: typeof Schema.String;
396
+ }>;
397
+ /** Zile intregi ramase pana la scadenta. */
398
+ zileRamase: typeof Schema.Number;
399
+ /** Pragul atins, in zile. */
400
+ prag: Schema.Literal<[30, 3]>;
401
+ }>;
402
+ /** Un termen adaugat in cont intra in pragul de 30 sau de 3 zile. */
403
+ type WebhookTermenExpira = typeof WebhookTermenExpiraSchema.Type;
404
+ declare const WebhookNotificareSchema: Schema.Union<[Schema.Struct<{
405
+ /** Numele evenimentului. */
406
+ event: Schema.Literal<["document.expira"]>;
407
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
408
+ id: typeof Schema.String;
409
+ /** Vehiculul la care expira documentul. */
410
+ vehicul: Schema.Struct<{
411
+ /** ID-ul vehiculului in cont, acelasi ca in `vehicule.lista()`. */
412
+ id: typeof Schema.String;
413
+ /** Numarul de inmatriculare, daca e cunoscut. */
414
+ numarInmatriculare: Schema.NullOr<typeof Schema.String>;
415
+ /** Seria de sasiu (VIN), daca e cunoscuta. */
416
+ serieSasiu: Schema.NullOr<typeof Schema.String>;
417
+ }>;
418
+ /** Documentul care expira. */
419
+ document: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
420
+ /** Data expirarii documentului. */
421
+ expiraLa: typeof Schema.Date;
422
+ /** Zile intregi ramase pana la expirare (minim 0). */
423
+ zileRamase: typeof Schema.Number;
424
+ /** Pragul de notificare atins, in zile (RCA/ITP/rovinieta: 30, 14, 3; ARR: 60, 50, 45). */
425
+ prag: typeof Schema.Number;
426
+ /** Cand a fost trimisa notificarea. */
427
+ trimisLa: typeof Schema.Date;
428
+ }>, Schema.Struct<{
429
+ /** Numele evenimentului. */
430
+ event: Schema.Literal<["dosar.eveniment"]>;
431
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
432
+ id: typeof Schema.String;
433
+ /** Cand a fost trimisa notificarea. */
434
+ trimisLa: typeof Schema.Date;
435
+ /** Dosarul monitorizat. */
436
+ dosar: Schema.Struct<{
437
+ /** ID-ul dosarului in cont. */
438
+ id: typeof Schema.String;
439
+ /** Numarul dosarului la instanta, ex: `1234/3/2024`. */
440
+ numar: typeof Schema.String;
441
+ /** Eticheta pusa de tine in cont. */
442
+ eticheta: Schema.NullOr<typeof Schema.String>;
443
+ }>;
444
+ /** Ce s-a intamplat in dosar. */
445
+ eveniment: Schema.Struct<{
446
+ /**
447
+ * `termen_nou` (sedinta noua), `solutie`, `cale_atac` (apel, recurs), `stadiu`,
448
+ * `instanta_noua` sau `incheiat_auto` (180 de zile fara noutati: dosarul nu mai e monitorizat).
449
+ */
450
+ tip: Schema.Literal<["termen_nou", "solutie", "cale_atac", "stadiu", "instanta_noua", "incheiat_auto"]>;
451
+ /** Textul alertei, ca in email. */
452
+ descriere: typeof Schema.String;
453
+ /** Instanta, cand e cunoscuta. */
454
+ institutie: Schema.NullOr<typeof Schema.String>;
455
+ }>;
456
+ }>, Schema.Struct<{
457
+ /** Numele evenimentului. */
458
+ event: Schema.Literal<["dosar.termen"]>;
459
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
460
+ id: typeof Schema.String;
461
+ /** Cand a fost trimisa notificarea. */
462
+ trimisLa: typeof Schema.Date;
463
+ /** Dosarul monitorizat. */
464
+ dosar: Schema.Struct<{
465
+ /** ID-ul dosarului in cont. */
466
+ id: typeof Schema.String;
467
+ /** Numarul dosarului la instanta, ex: `1234/3/2024`. */
468
+ numar: typeof Schema.String;
469
+ /** Eticheta pusa de tine in cont. */
470
+ eticheta: Schema.NullOr<typeof Schema.String>;
471
+ }>;
472
+ /** Sedinta care se apropie. */
473
+ sedinta: Schema.Struct<{
474
+ /** Data sedintei. */
475
+ data: typeof Schema.Date;
476
+ /** Ora sedintei, cand e cunoscuta. */
477
+ ora: Schema.NullOr<typeof Schema.String>;
478
+ /** Instanta. */
479
+ institutie: Schema.NullOr<typeof Schema.String>;
480
+ /** Completul de judecata. */
481
+ complet: Schema.NullOr<typeof Schema.String>;
482
+ }>;
483
+ /** Reminder cu 3 zile si cu o zi inainte de sedinta. */
484
+ zileRamase: Schema.Literal<[1, 3]>;
485
+ }>, Schema.Struct<{
486
+ /** Numele evenimentului. */
487
+ event: Schema.Literal<["firma.schimbare"]>;
488
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
489
+ id: typeof Schema.String;
490
+ /** Cand a fost trimisa notificarea. */
491
+ trimisLa: typeof Schema.Date;
492
+ /** Firma monitorizata. */
493
+ firma: Schema.Struct<{
494
+ /** ID-ul firmei in cont. */
495
+ id: typeof Schema.String;
496
+ /** Denumirea firmei. */
497
+ denumire: typeof Schema.String;
498
+ }>;
499
+ /** Campurile schimbate. */
500
+ schimbari: Schema.Array$<Schema.Struct<{
501
+ /** Campul schimbat. */
502
+ camp: Schema.Literal<["radiata", "inactiv", "platitor_tva", "tva_la_incasare", "split_tva", "e_factura", "denumire", "adresa", "caen"]>;
503
+ /** Valoarea dinainte (`"da"` / `"nu"` sau textul ANAF); `null` cand nu e cunoscuta. */
504
+ valoareVeche: Schema.NullOr<typeof Schema.String>;
505
+ /** Valoarea de acum. */
506
+ valoareNoua: typeof Schema.String;
507
+ /** Data (`yyyy-mm-dd`) de la care se aplica, cand ANAF o da. */
508
+ dataEfect: Schema.NullOr<typeof Schema.String>;
509
+ }>>;
510
+ }>, Schema.Struct<{
511
+ /** Numele evenimentului. */
512
+ event: Schema.Literal<["firma.dosar"]>;
513
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
514
+ id: typeof Schema.String;
515
+ /** Cand a fost trimisa notificarea. */
516
+ trimisLa: typeof Schema.Date;
517
+ /** Firma monitorizata. */
518
+ firma: Schema.Struct<{
519
+ /** ID-ul firmei in cont. */
520
+ id: typeof Schema.String;
521
+ /** Denumirea firmei. */
522
+ denumire: typeof Schema.String;
523
+ }>;
524
+ /** Dosarul nou. */
525
+ dosar: Schema.Struct<{
526
+ /** Numarul dosarului. */
527
+ numar: typeof Schema.String;
528
+ /** Instanta. */
529
+ institutie: typeof Schema.String;
530
+ /** Calitatea firmei in dosar. */
531
+ calitateParte: Schema.NullOr<typeof Schema.String>;
532
+ /** Obiectul dosarului. */
533
+ obiect: Schema.NullOr<typeof Schema.String>;
534
+ /** Categoria de pe portalul instantelor (ex: Faliment). */
535
+ categorie: Schema.NullOr<typeof Schema.String>;
536
+ /**
537
+ * Dosar de insolventa: `debitor` (firma e in procedura), `creditor` (are de
538
+ * recuperat bani in procedura altcuiva), `alta`; `null` pentru alt fel de dosar.
539
+ */
540
+ insolventa: Schema.NullOr<Schema.Literal<["debitor", "creditor", "alta"]>>;
541
+ }>;
542
+ }>, Schema.Struct<{
543
+ /** Numele evenimentului. */
544
+ event: Schema.Literal<["marca.schimbare"]>;
545
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
546
+ id: typeof Schema.String;
547
+ /** Cand a fost trimisa notificarea. */
548
+ trimisLa: typeof Schema.Date;
549
+ /** Marca urmarita. */
550
+ marca: Schema.Struct<{
551
+ /** ID-ul marcii in cont. */
552
+ id: typeof Schema.String;
553
+ /** ID-ul marcii in TMview (oficiul + numarul). */
554
+ st13: typeof Schema.String;
555
+ /** Numele marcii. */
556
+ nume: typeof Schema.String;
557
+ /** `RO` = OSIM, `EM` = EUIPO (marca a Uniunii Europene). */
558
+ oficiu: Schema.Literal<["RO", "EM"]>;
559
+ /** Numarul de depozit. */
560
+ numarDepozit: typeof Schema.String;
561
+ }>;
562
+ /** Ce s-a schimbat; `inregistrata` = cererea in curs a devenit marca inregistrata. */
563
+ schimbare: Schema.Literal<["inregistrata", "reinnoita", "expirata", "anulata", "respinsa", "retrasa", "opozitie"]>;
564
+ /** La `reinnoita`: vechea data de expirare (`yyyy-mm-dd`); la `opozitie`: numarul vechi de opozitii; altfel statusul vechi. */
565
+ valoareVeche: typeof Schema.String;
566
+ /** Ca `valoareVeche`, valoarea de acum. */
567
+ valoareNoua: typeof Schema.String;
568
+ }>, Schema.Struct<{
569
+ /** Numele evenimentului. */
570
+ event: Schema.Literal<["marca.expira"]>;
571
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
572
+ id: typeof Schema.String;
573
+ /** Cand a fost trimisa notificarea. */
574
+ trimisLa: typeof Schema.Date;
575
+ /** Marca urmarita. */
576
+ marca: Schema.Struct<{
577
+ /** ID-ul marcii in cont. */
578
+ id: typeof Schema.String;
579
+ /** ID-ul marcii in TMview (oficiul + numarul). */
580
+ st13: typeof Schema.String;
581
+ /** Numele marcii. */
582
+ nume: typeof Schema.String;
583
+ /** `RO` = OSIM, `EM` = EUIPO (marca a Uniunii Europene). */
584
+ oficiu: Schema.Literal<["RO", "EM"]>;
585
+ /** Numarul de depozit. */
586
+ numarDepozit: typeof Schema.String;
587
+ }>;
588
+ /** Data expirarii, `yyyy-mm-dd`. */
589
+ expiraLa: typeof Schema.String;
590
+ /** `6l`, `3l`, `1l` (luni), `7z` (zile) inainte; `gratie` = a expirat, se mai poate reinnoi cu taxa. */
591
+ prag: Schema.Literal<["6l", "3l", "1l", "7z", "gratie"]>;
592
+ /** La `gratie`: ultima zi (`yyyy-mm-dd`) in care se mai poate reinnoi; altfel `null`. */
593
+ reinnoirePanaLa: Schema.NullOr<typeof Schema.String>;
594
+ }>, Schema.Struct<{
595
+ /** Numele evenimentului. */
596
+ event: Schema.Literal<["asigurare.schimbare"]>;
597
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
598
+ id: typeof Schema.String;
599
+ /** Cand a fost trimisa notificarea. */
600
+ trimisLa: typeof Schema.Date;
601
+ /** Persoana monitorizata. */
602
+ persoana: Schema.Struct<{
603
+ /** ID-ul persoanei in cont. */
604
+ id: typeof Schema.String;
605
+ /** Numele persoanei. */
606
+ nume: typeof Schema.String;
607
+ }>;
608
+ /** Statutul de acum. */
609
+ statut: Schema.Literal<["asigurat", "neasigurat", "necunoscut"]>;
610
+ /** Cardul de sanatate e emis; `null` cand CNAS nu spune. */
611
+ areCard: Schema.NullOr<typeof Schema.Boolean>;
612
+ /** Cand a fost interogat CNAS. */
613
+ verificatLa: typeof Schema.Date;
614
+ }>, Schema.Struct<{
615
+ /** Numele evenimentului. */
616
+ event: Schema.Literal<["termen.expira"]>;
617
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
618
+ id: typeof Schema.String;
619
+ /** Cand a fost trimisa notificarea. */
620
+ trimisLa: typeof Schema.Date;
621
+ /** Termenul din cont. */
622
+ termen: Schema.Struct<{
623
+ /** ID-ul termenului in cont. */
624
+ id: typeof Schema.String;
625
+ /** `auto`, `personale`, `sanatate`, `afaceri` sau `casa`. */
626
+ categorie: typeof Schema.String;
627
+ /** Tipul termenului. */
628
+ tip: typeof Schema.String;
629
+ /** Numele termenului, ex: Pasaport sau numele dat de tine. */
630
+ eticheta: typeof Schema.String;
631
+ /** Al cui e termenul: numarul masinii, firma sau persoana. */
632
+ al: Schema.NullOr<typeof Schema.String>;
633
+ /** Data scadentei, `yyyy-mm-dd`. */
634
+ expiraLa: typeof Schema.String;
635
+ }>;
636
+ /** Zile intregi ramase pana la scadenta. */
637
+ zileRamase: typeof Schema.Number;
638
+ /** Pragul atins, in zile. */
639
+ prag: Schema.Literal<[30, 3]>;
640
+ }>, Schema.Struct<{
641
+ /** Numele evenimentului. */
642
+ event: Schema.Literal<["webhook.test"]>;
643
+ /** ID unic al testului. */
644
+ id: typeof Schema.String;
645
+ /** Mesajul de confirmare. */
646
+ mesaj: typeof Schema.String;
647
+ /** Cand a fost trimis testul. */
648
+ trimisLa: typeof Schema.Date;
649
+ }>]>;
650
+ /** Orice notificare trimisa la URL-ul de webhook al contului. Distinge-le dupa `event`. */
651
+ type WebhookNotificare = typeof WebhookNotificareSchema.Type;
652
+ declare const DecodareVinSchema: Schema.Struct<{
653
+ /** VIN-ul normalizat. */
654
+ vin: typeof Schema.String;
655
+ /** Marca e cunoscuta. */
656
+ gasit: typeof Schema.Boolean;
657
+ /** S-a consumat o cerere din plan: doar cand marca si modelul sunt gasite. */
658
+ taxat: typeof Schema.Boolean;
659
+ /** Marca, cand e gasita. */
660
+ marca: Schema.NullOr<typeof Schema.String>;
661
+ /** Modelul, cand e gasit. */
662
+ model: Schema.NullOr<typeof Schema.String>;
663
+ /** Anul fabricatiei, cand e cunoscut. */
664
+ anFabricatie: Schema.NullOr<typeof Schema.Number>;
665
+ /** De unde vine anul: `pozitia-10` confirmata, startul `generatie` sau `anunturi`. */
666
+ sursaAn: Schema.NullOr<Schema.Literal<["pozitia-10", "generatie", "anunturi"]>>;
667
+ /** Modelele posibile, cand sursele nu cad de acord. Mereu gol cand `taxat` e `false`. */
668
+ modelePosibile: Schema.Array$<typeof Schema.String>;
669
+ /** Structura VIN-ului, calculata doar din cele 17 caractere. */
670
+ structura: Schema.Struct<{
671
+ /** Pozitiile 1-3: producatorul. */
672
+ wmi: typeof Schema.String;
673
+ /** Pozitiile 4-9: descrierea vehiculului. */
674
+ vds: typeof Schema.String;
675
+ /** Pozitiile 10-17: exemplarul. */
676
+ vis: typeof Schema.String;
677
+ /** Regiunea producatorului. */
678
+ regiune: Schema.NullOr<typeof Schema.String>;
679
+ /** Tara producatorului. */
680
+ tara: Schema.NullOr<typeof Schema.String>;
681
+ /** Cifra de control (pozitia 9): `ok`, `gresita` sau `neaplicabila`. */
682
+ cifraControl: Schema.Literal<["ok", "gresita", "neaplicabila"]>;
683
+ /** Cifra de control asteptata, cand se aplica. */
684
+ cifraControlAsteptata: Schema.NullOr<typeof Schema.String>;
685
+ /** Anii de fabricatie posibili dupa pozitia 10. */
686
+ aniPosibili: Schema.Array$<typeof Schema.Number>;
687
+ }>;
688
+ }>;
689
+ declare const NumarDisponibilSchema: Schema.Struct<{
690
+ /** Numarul normalizat. */
691
+ numar: typeof Schema.String;
692
+ /** Numarul e liber la DGPCI si poate fi rezervat. */
693
+ disponibil: typeof Schema.Boolean;
694
+ /** Textul intors de DGPCI, cand exista. */
695
+ mesaj: Schema.NullOr<typeof Schema.String>;
696
+ }>;
697
+ /** Unghiurile pozei. */
698
+ declare const UnghiImagine: Schema.Literal<["trei-sferturi", "fata", "profil", "spate", "trei-sferturi-dreapta", "profil-dreapta"]>;
699
+ /** Unghiul pozei: `"trei-sferturi"` (implicit), `"fata"`, `"profil"`, `"spate"`, `"trei-sferturi-dreapta"`, `"profil-dreapta"`. */
700
+ type UnghiImagine = typeof UnghiImagine.Type;
701
+ /**
702
+ * Starea pozei:
703
+ * - `gata`: poza masinii cerute (se taxeaza);
704
+ * - `in-lucru`: o randam acum; revino dupa `retryAfterMs`;
705
+ * - `necunoscut`: marca sau modelul nu au fost identificate;
706
+ * - `indisponibil`: randarea a esuat; se reincearca la prima cerere dupa 24h.
707
+ *
708
+ * In afara de `gata`, primesti poza generica (masina sub husa), netaxata.
709
+ */
710
+ declare const StatusImagine: Schema.Literal<["gata", "in-lucru", "necunoscut", "indisponibil"]>;
711
+ /** Starea pozei. Vezi {@link StatusImagine}. */
712
+ type StatusImagine = typeof StatusImagine.Type;
713
+ declare const ImagineMasinaSchema: Schema.Struct<{
714
+ /** Poza e a masinii cerute; `false` = poza generica (masina sub husa). */
715
+ gata: typeof Schema.Boolean;
716
+ /** Starea pozei. Vezi {@link StatusImagine}. */
717
+ status: Schema.Literal<["gata", "in-lucru", "necunoscut", "indisponibil"]>;
718
+ /** S-a consumat o cerere din plan: doar cand `status` e `gata`. */
719
+ taxat: typeof Schema.Boolean;
720
+ /** Link semnat spre poza (WebP transparent), valabil pana la `expiraLa`. `null` doar daca nici poza generica nu e disponibila. */
721
+ url: Schema.NullOr<typeof Schema.String>;
722
+ /** Cand expira `url`. `null` cand `url` e `null`. */
723
+ expiraLa: Schema.NullOr<typeof Schema.Date>;
724
+ /** Unghiul pozei. */
725
+ unghi: Schema.Literal<["trei-sferturi", "fata", "profil", "spate", "trei-sferturi-dreapta", "profil-dreapta"]>;
726
+ /** Poza are umbra sub masina. */
727
+ umbra: typeof Schema.Boolean;
728
+ /** Latimea pozei, in pixeli. */
729
+ latime: typeof Schema.Number;
730
+ /** Inaltimea pozei, in pixeli. */
731
+ inaltime: typeof Schema.Number;
732
+ /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. */
733
+ marca: typeof Schema.String;
734
+ /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. */
735
+ model: typeof Schema.String;
736
+ /** Generatia aleasa dupa an; `null` cand nu e aleasa inca. */
737
+ generatie: Schema.NullOr<Schema.Struct<{
738
+ /** Numele generatiei, ex: `Volkswagen Golf VII`. */
739
+ eticheta: typeof Schema.String;
740
+ /** Primul an al generatiei. */
741
+ anDe: typeof Schema.Number;
742
+ /** Ultimul an; `null` = inca in productie. */
743
+ anPana: Schema.NullOr<typeof Schema.Number>;
744
+ /** Caroseria, ex: `5-door hatchback`. */
745
+ caroserie: typeof Schema.String;
746
+ }>>;
747
+ }>;
748
+
749
+ /** Campurile comune tuturor erorilor SDK-ului. */
750
+ interface DateEroare {
751
+ /** Mesajul, in romana, exact cum vine de la API cand exista. */
752
+ readonly message: string;
753
+ /** Statusul HTTP, cand eroarea vine dintr-un raspuns. */
754
+ readonly status?: number;
755
+ /** Codul masinii (`LIMIT_ATINS`, `VEHICUL_EXISTENT`, `NEGASIT` etc.). */
756
+ readonly cod?: string;
757
+ /** Indicatia API-ului despre cum se rezolva problema. */
758
+ readonly hint?: string;
759
+ /** Corpul brut al raspunsului, pentru depanare. */
760
+ readonly raspuns?: unknown;
761
+ /** Eroarea originala (de retea, de parsare), cand exista. */
762
+ readonly cause?: unknown;
763
+ }
764
+ /**
765
+ * Baza tuturor erorilor aruncate de SDK. `instanceof VerificRcaError` prinde
766
+ * orice eroare de la API, iar `_tag` spune exact care e.
767
+ */
768
+ declare class VerificRcaError extends Data.Error<DateEroare> {
769
+ /** Discriminantul erorii. Fiecare subclasa are propria valoare, ex: `"EroareLimita"`. */
770
+ readonly _tag: string;
771
+ /** Numele clasei, afisat in loguri si in stack trace. */
772
+ readonly name: string;
773
+ }
774
+ /** Optiunile clientului sunt invalide (cheie API lipsa, URL gresit etc.). */
775
+ declare class EroareConfigurare extends VerificRcaError {
776
+ /** Discriminantul erorii: `"EroareConfigurare"`. Util in `switch (err._tag)`. */
777
+ readonly _tag = "EroareConfigurare";
778
+ /** Numele clasei, afisat in loguri si in stack trace. */
779
+ readonly name = "EroareConfigurare";
780
+ }
781
+ /**
782
+ * Datele trimise sunt invalide. Apare fie local, inainte de orice cerere (nu se
783
+ * 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).
785
+ */
786
+ declare class EroareValidare extends VerificRcaError {
787
+ /** Discriminantul erorii: `"EroareValidare"`. Util in `switch (err._tag)`. */
788
+ readonly _tag = "EroareValidare";
789
+ /** Numele clasei, afisat in loguri si in stack trace. */
790
+ readonly name = "EroareValidare";
791
+ /** Valorile acceptate, cand API-ul le trimite (ex: tipurile de verificare). */
792
+ readonly acceptate?: readonly string[];
793
+ /** Campul cu problema, cand eroarea e detectata local. */
794
+ readonly camp?: string;
795
+ /**
796
+ * Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
797
+ *
798
+ * @param args mesajul, detaliile comune ({@link DateEroare}) si campurile specifice acestei erori.
799
+ */
800
+ constructor(args: DateEroare & {
801
+ readonly acceptate?: readonly string[];
802
+ readonly camp?: string;
803
+ });
804
+ }
805
+ /** 401: cheia API lipseste, e invalida sau a fost dezactivata. */
806
+ declare class EroareAutentificare extends VerificRcaError {
807
+ /** Discriminantul erorii: `"EroareAutentificare"`. Util in `switch (err._tag)`. */
808
+ readonly _tag = "EroareAutentificare";
809
+ /** Numele clasei, afisat in loguri si in stack trace. */
810
+ readonly name = "EroareAutentificare";
811
+ }
812
+ /** 402: contul nu are un abonament activ pentru operatia ceruta. */
813
+ declare class EroarePlanInactiv extends VerificRcaError {
814
+ /** Discriminantul erorii: `"EroarePlanInactiv"`. Util in `switch (err._tag)`. */
815
+ readonly _tag = "EroarePlanInactiv";
816
+ /** Numele clasei, afisat in loguri si in stack trace. */
817
+ readonly name = "EroarePlanInactiv";
818
+ }
819
+ /** 403: operatia nu e permisa pe planul curent (`LIMIT_ATINS`, `ARR_NECESITA_PLAN`). */
820
+ declare class EroareInterzis extends VerificRcaError {
821
+ /** Discriminantul erorii: `"EroareInterzis"`. Util in `switch (err._tag)`. */
822
+ readonly _tag = "EroareInterzis";
823
+ /** Numele clasei, afisat in loguri si in stack trace. */
824
+ readonly name = "EroareInterzis";
825
+ /** Numarul de masini permis de plan, la `LIMIT_ATINS`. */
826
+ readonly limita?: number;
827
+ /**
828
+ * Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
829
+ *
830
+ * @param args mesajul, detaliile comune ({@link DateEroare}) si campurile specifice acestei erori.
831
+ */
832
+ constructor(args: DateEroare & {
833
+ readonly limita?: number;
834
+ });
835
+ }
836
+ /** 404: resursa nu exista sau nu apartine contului cheii. */
837
+ declare class EroareNegasit extends VerificRcaError {
838
+ /** Discriminantul erorii: `"EroareNegasit"`. Util in `switch (err._tag)`. */
839
+ readonly _tag = "EroareNegasit";
840
+ /** Numele clasei, afisat in loguri si in stack trace. */
841
+ readonly name = "EroareNegasit";
842
+ }
843
+ /** 409: vehiculul exista deja in cont (`VEHICUL_EXISTENT`). */
844
+ declare class EroareConflict extends VerificRcaError {
845
+ /** Discriminantul erorii: `"EroareConflict"`. Util in `switch (err._tag)`. */
846
+ readonly _tag = "EroareConflict";
847
+ /** Numele clasei, afisat in loguri si in stack trace. */
848
+ readonly name = "EroareConflict";
849
+ }
850
+ /**
851
+ * 429: limita a fost atinsa. `cod` spune care:
852
+ * - `COTA_ATINSA`: cota zilnica sau lunara de verificari a planului;
853
+ * - `LIMITA_FLOTA_ATINSA`: plafonul zilnic de adaugari/stergeri de vehicule;
854
+ * - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur).
855
+ */
856
+ declare class EroareLimita extends VerificRcaError {
857
+ /** Discriminantul erorii: `"EroareLimita"`. Util in `switch (err._tag)`. */
858
+ readonly _tag = "EroareLimita";
859
+ /** Numele clasei, afisat in loguri si in stack trace. */
860
+ readonly name = "EroareLimita";
861
+ /** Cat sa astepti inainte de o cerere noua, din headerul `Retry-After`. */
862
+ readonly retryAfterMs?: number;
863
+ /** Consumul zilnic, ex: `"300/300"`. */
864
+ readonly utilizareZi?: string;
865
+ /** Consumul lunar, ex: `"4120/10000"`. */
866
+ readonly utilizareLuna?: string;
867
+ /**
868
+ * Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
869
+ *
870
+ * @param args mesajul, detaliile comune ({@link DateEroare}) si campurile specifice acestei erori.
871
+ */
872
+ constructor(args: DateEroare & {
873
+ readonly retryAfterMs?: number;
874
+ readonly utilizareZi?: string;
875
+ readonly utilizareLuna?: string;
876
+ });
877
+ }
878
+ /**
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.
882
+ */
883
+ declare class EroareServer extends VerificRcaError {
884
+ /** Discriminantul erorii: `"EroareServer"`. Util in `switch (err._tag)`. */
885
+ readonly _tag = "EroareServer";
886
+ /** Numele clasei, afisat in loguri si in stack trace. */
887
+ readonly name = "EroareServer";
888
+ /** Cat sa astepti inainte de o cerere noua, din headerul `Retry-After`. */
889
+ readonly retryAfterMs?: number;
890
+ /**
891
+ * Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
892
+ *
893
+ * @param args mesajul, detaliile comune ({@link DateEroare}) si `retryAfterMs`.
894
+ */
895
+ constructor(args: DateEroare & {
896
+ readonly retryAfterMs?: number;
897
+ });
898
+ }
899
+ /** Orice alt status HTTP neasteptat. */
900
+ declare class EroareHttp extends VerificRcaError {
901
+ /** Discriminantul erorii: `"EroareHttp"`. Util in `switch (err._tag)`. */
902
+ readonly _tag = "EroareHttp";
903
+ /** Numele clasei, afisat in loguri si in stack trace. */
904
+ readonly name = "EroareHttp";
905
+ }
906
+ /** Cererea nu a primit raspuns: retea cazuta, DNS, conexiune refuzata sau timeout. */
907
+ declare class EroareRetea extends VerificRcaError {
908
+ /** Discriminantul erorii: `"EroareRetea"`. Util in `switch (err._tag)`. */
909
+ readonly _tag = "EroareRetea";
910
+ /** Numele clasei, afisat in loguri si in stack trace. */
911
+ readonly name = "EroareRetea";
912
+ /** Adevarat cand cererea a depasit `timeoutMs`. */
913
+ readonly timeout?: boolean;
914
+ /**
915
+ * Adevarat cand e sigur ca cererea nu a ajuns la server (DNS, conexiune
916
+ * refuzata), deci se poate repeta fara risc chiar si pentru un POST.
917
+ */
918
+ readonly neajunsa?: boolean;
919
+ /**
920
+ * Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
921
+ *
922
+ * @param args mesajul, detaliile comune ({@link DateEroare}) si campurile specifice acestei erori.
923
+ */
924
+ constructor(args: DateEroare & {
925
+ readonly timeout?: boolean;
926
+ readonly neajunsa?: boolean;
927
+ });
928
+ }
929
+ /** Raspunsul API-ului nu are forma asteptata (JSON invalid sau campuri lipsa). */
930
+ declare class EroareRaspunsInvalid extends VerificRcaError {
931
+ /** Discriminantul erorii: `"EroareRaspunsInvalid"`. Util in `switch (err._tag)`. */
932
+ readonly _tag = "EroareRaspunsInvalid";
933
+ /** Numele clasei, afisat in loguri si in stack trace. */
934
+ readonly name = "EroareRaspunsInvalid";
935
+ }
936
+ /**
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.
943
+ */
944
+ declare class EroareVerificare extends VerificRcaError {
945
+ /** Discriminantul erorii: `"EroareVerificare"`. Util in `switch (err._tag)`. */
946
+ readonly _tag = "EroareVerificare";
947
+ /** Numele clasei, afisat in loguri si in stack trace. */
948
+ readonly name = "EroareVerificare";
949
+ /**
950
+ * Codul API-ului cand sursa a refuzat datele trimise, ex: `"serie_talon_invalida"`.
951
+ * Lipseste cand sursa doar nu a raspuns. Vezi {@link CodRefuzSursa}.
952
+ */
953
+ readonly codSursa?: CodRefuzSursa;
954
+ /**
955
+ * Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
956
+ *
957
+ * @param args mesajul, detaliile comune ({@link DateEroare}) si `codSursa`.
958
+ */
959
+ constructor(args: DateEroare & {
960
+ readonly codSursa?: CodRefuzSursa;
961
+ });
962
+ }
963
+ /** Asteptarea unei verificari (`verifica`, `asteapta`) sau a unei poze (`imagini.asteapta`) a depasit timpul maxim. */
964
+ declare class EroareTimeoutVerificare extends VerificRcaError {
965
+ /** Discriminantul erorii: `"EroareTimeoutVerificare"`. Util in `switch (err._tag)`. */
966
+ readonly _tag = "EroareTimeoutVerificare";
967
+ /** Numele clasei, afisat in loguri si in stack trace. */
968
+ readonly name = "EroareTimeoutVerificare";
969
+ }
970
+ /** Un webhook primit nu poate fi acceptat: cheie gresita sau payload invalid. */
971
+ declare class EroareWebhook extends VerificRcaError {
972
+ /** Discriminantul erorii: `"EroareWebhook"`. Util in `switch (err._tag)`. */
973
+ readonly _tag = "EroareWebhook";
974
+ /** Numele clasei, afisat in loguri si in stack trace. */
975
+ readonly name = "EroareWebhook";
976
+ }
977
+ /** Erorile pe care le poate produce o cerere HTTP catre API. */
978
+ type EroareCerere = EroareValidare | EroareAutentificare | EroarePlanInactiv | EroareInterzis | EroareNegasit | EroareConflict | EroareLimita | EroareServer | EroareHttp | EroareRetea | EroareRaspunsInvalid;
979
+
980
+ /**
981
+ * Politica de reincercare pentru erorile trecatoare. Pauzele cresc exponential
982
+ * (x2), cu jitter, si nu scad sub `Retry-After` cand serverul il trimite.
983
+ */
984
+ interface SetariRetry {
985
+ /** Numarul maxim de reincercari dupa prima cerere. */
986
+ readonly incercari: number;
987
+ /** Prima pauza; creste exponential (x2) cu jitter. */
988
+ readonly intarziereInitialaMs: number;
989
+ /** Plafonul unei singure pauze. */
990
+ readonly intarziereMaximaMs: number;
991
+ }
992
+ interface SetariClient {
993
+ readonly apiKey: string;
994
+ readonly baseUrl: string;
995
+ readonly timeoutMs: number;
996
+ readonly retry: SetariRetry | null;
997
+ readonly fetch: typeof globalThis.fetch;
998
+ readonly userAgent: string;
999
+ }
1000
+ declare const Setari_base: Context.TagClass<Setari, "@verificrca/sdk/Setari", SetariClient>;
1001
+ declare class Setari extends Setari_base {
1002
+ }
1003
+
1004
+ /** Toate tipurile de verificare acceptate de API, in ordine: `["rca", "itp", "rovinieta", "arr"]`. */
1005
+ declare const TIPURI_VERIFICARE: readonly TipVerificare[];
1006
+ /**
1007
+ * Aduce un numar de inmatriculare sau un VIN la forma canonica: fara spatii,
1008
+ * cratime sau underscore, cu majuscule.
1009
+ *
1010
+ * @param valoare textul introdus de utilizator.
1011
+ * @returns forma normalizata.
1012
+ * @example
1013
+ * normalizeaza(" b-123 abc ") // "B123ABC"
1014
+ */
1015
+ declare function normalizeaza(valoare: string): string;
1016
+ /**
1017
+ * Verifica un numar de inmatriculare romanesc: Bucuresti (`B123ABC`), judete
1018
+ * (`CJ45XYZ`), corp diplomatic (`CD123A`) si numere temporare (`TC1234AB`).
1019
+ * Accepta si forme cu spatii sau cratime.
1020
+ *
1021
+ * @param valoare numarul de verificat.
1022
+ * @returns `true` daca numarul are un format valid.
1023
+ * @example
1024
+ * esteNumarInmatriculareValid("CJ 45 XYZ") // true
1025
+ * esteNumarInmatriculareValid("XX12ABC") // false: XX nu e un judet
1026
+ */
1027
+ declare function esteNumarInmatriculareValid(valoare: string): boolean;
1028
+ /**
1029
+ * Verifica o serie de sasiu (VIN) dupa ISO 3779: exact 17 caractere, cifre si
1030
+ * litere, fara I, O si Q.
1031
+ *
1032
+ * @param valoare VIN-ul de verificat (spatiile si cratimele sunt ignorate).
1033
+ * @returns `true` daca VIN-ul are un format valid.
1034
+ * @example
1035
+ * esteVinValid("WVWZZZ1JZXW000001") // true
1036
+ * esteVinValid("WVWZZZ1JZXW00000I") // false: litera I nu e permisa
1037
+ */
1038
+ declare function esteVinValid(valoare: string): boolean;
1039
+ /**
1040
+ * Aduce numarul certificatului de inmatriculare (talon) la forma canonica:
1041
+ * doar litere si cifre, cu majuscule.
1042
+ *
1043
+ * @param valoare textul introdus de utilizator.
1044
+ * @returns forma normalizata.
1045
+ * @example
1046
+ * normalizeazaSerieTalon(" i 00639603-f ") // "I00639603F"
1047
+ */
1048
+ declare function normalizeazaSerieTalon(valoare: string): string;
1049
+ /**
1050
+ * Verifica forma numarului certificatului de inmatriculare (talon), tiparit jos
1051
+ * pe talon: 6-20 litere si cifre, cel putin o cifra. Corectitudinea lui o
1052
+ * confirma doar sursa oficiala, impreuna cu numarul si VIN-ul.
1053
+ *
1054
+ * @param valoare numarul certificatului (spatiile si cratimele sunt ignorate).
1055
+ * @returns `true` daca are o forma valida.
1056
+ * @example
1057
+ * esteSerieTalonValida("I00639603F") // true
1058
+ * esteSerieTalonValida("ABCDEF") // false: nu contine nicio cifra
1059
+ */
1060
+ declare function esteSerieTalonValida(valoare: string): boolean;
1061
+ /** Datele pentru pornirea unei verificari. */
1062
+ interface CerereVerificare {
1063
+ /** `rca`, `itp`, `rovinieta` sau `arr`. */
1064
+ readonly tip: TipVerificare;
1065
+ /**
1066
+ * Identificatorul principal:
1067
+ * - `rca`: numar de inmatriculare sau VIN;
1068
+ * - `itp`: VIN (RAR nu cauta dupa numar);
1069
+ * - `rovinieta`: numar de inmatriculare (VIN-ul merge in `serieSasiu`);
1070
+ * - `arr`: numar de inmatriculare (ARR nu cauta dupa VIN).
1071
+ */
1072
+ readonly query: string;
1073
+ /** Seria de sasiu (VIN). Obligatorie la rovinieta, recomandata la RCA. */
1074
+ readonly serieSasiu?: string;
1075
+ /**
1076
+ * Numarul certificatului de inmatriculare (talon), tiparit jos pe talon, ex:
1077
+ * `I00639603F`. Obligatoriu la rovinieta: sursa oficiala il valideaza impreuna
1078
+ * cu numarul si VIN-ul. Ignorat la celelalte tipuri.
1079
+ */
1080
+ readonly serieTalon?: string;
1081
+ /** URL http(s) unde API-ul trimite rezultatul prin POST cand e gata. */
1082
+ readonly callbackUrl?: string;
1083
+ }
1084
+ /** Datele unui vehicul adaugat in flota. */
1085
+ interface VehiculNou {
1086
+ /** Numarul de inmatriculare. Spatiile si cratimele sunt eliminate. Maxim 20 de caractere. */
1087
+ readonly numarInmatriculare?: string;
1088
+ /** Seria de sasiu (VIN). Necesara pentru ITP si rovinieta. Maxim 50 de caractere. */
1089
+ readonly serieSasiu?: string;
1090
+ /**
1091
+ * Numarul certificatului de inmatriculare (talon), ex: `I00639603F`. Necesar
1092
+ * pentru monitorizarea automata a rovinietei: fara el, rovinieta nu se verifica.
1093
+ */
1094
+ readonly serieTalon?: string;
1095
+ /** Monitorizeaza si copia conforma ARR. Cere un plan activ. */
1096
+ readonly arrMonitorizat?: boolean;
1097
+ }
1098
+ /** Unghiurile acceptate pentru poza unei masini. */
1099
+ declare const UNGHIURI_IMAGINE: readonly UnghiImagine[];
1100
+ /** Masina pentru care ceri poza. */
1101
+ interface CerereImagine {
1102
+ /** Marca, ca in talon sau RAR, ex: `Volkswagen`. */
1103
+ readonly marca: string;
1104
+ /** Modelul, ex: `Golf`. */
1105
+ readonly model: string;
1106
+ /** Anul fabricatiei (1950 - anul viitor); alege generatia. */
1107
+ readonly an: number;
1108
+ /** Unghiul pozei. Implicit `"trei-sferturi"`. */
1109
+ readonly unghi?: UnghiImagine;
1110
+ /** Umbra sub masina. Implicit `true`. */
1111
+ readonly umbra?: boolean;
1112
+ }
1113
+
1114
+ /** Cat mai ai din cota planului, din headerele `X-RateLimit-*`. */
1115
+ interface Limite {
1116
+ /** Cota zilnica; se reseteaza la miezul noptii. */
1117
+ readonly zi: {
1118
+ /** Verificari permise pe zi de plan. */
1119
+ readonly limita: number;
1120
+ /** Verificari ramase azi, dupa aceasta cerere. */
1121
+ readonly ramase: number;
1122
+ };
1123
+ /** Cota lunara. */
1124
+ readonly luna: {
1125
+ /** Verificari permise pe luna de plan. */
1126
+ readonly limita: number;
1127
+ /** Verificari ramase luna aceasta, dupa aceasta cerere. */
1128
+ readonly ramase: number;
1129
+ };
1130
+ }
1131
+ /** Rezultatul final al unei verificari. */
1132
+ type VerificareFinala = typeof RezultatVerificareSchema.Type & {
1133
+ /** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
1134
+ readonly limite?: Limite;
1135
+ };
1136
+ /**
1137
+ * Verificare pusa in coada: sursa oficiala e interogata acum. Paseaz-o la
1138
+ * `rezultat()` sau `asteapta()` ca sa afli raspunsul.
1139
+ */
1140
+ interface VerificareInCurs {
1141
+ /** Mereu `"processing"`: sursa oficiala e interogata acum. */
1142
+ readonly status: "processing";
1143
+ /** Tipul verificarii. */
1144
+ readonly tip: TipVerificare;
1145
+ /** Identificatorul dupa care se face pollingul. */
1146
+ readonly query: string;
1147
+ /** Seria de sasiu trimisa la polling; completata doar la rovinieta. */
1148
+ readonly serieSasiu: string | null;
1149
+ /** Momentul (ms) de la care un rezultat e considerat nou. */
1150
+ readonly since: number;
1151
+ /** Prezent cand ai trimis `callbackUrl`; apare si in webhook. */
1152
+ readonly requestId?: string;
1153
+ /** Cand a intrat verificarea in coada. */
1154
+ readonly queuedAt?: Date;
1155
+ /** Recomandarea API-ului, ex: sa trimiti si VIN-ul la RCA. */
1156
+ readonly hint?: string;
1157
+ /** Cota ramasa dupa cererea POST. */
1158
+ readonly limite?: Limite;
1159
+ }
1160
+ /**
1161
+ * Raspunsul la `porneste()` sau `rezultat()`: rezultatul final sau verificarea
1162
+ * in curs. Distinge-le dupa `status === "processing"`.
1163
+ */
1164
+ type RaspunsVerificare = VerificareFinala | VerificareInCurs;
1165
+ /** Ce trebuie ca sa interoghezi rezultatul unei verificari. */
1166
+ interface ReferintaVerificare {
1167
+ /** Tipul verificarii. */
1168
+ readonly tip: TipVerificare;
1169
+ /** Identificatorul dupa care se face pollingul (la RCA cu VIN, VIN-ul). */
1170
+ readonly query: string;
1171
+ /** Doar la rovinieta. */
1172
+ readonly serieSasiu?: string | null;
1173
+ /**
1174
+ * Momentul (ms) cererii POST. Fara el, orice rezultat din ultima perioada e
1175
+ * acceptat, chiar daca e mai vechi decat cererea ta.
1176
+ */
1177
+ readonly since?: number;
1178
+ }
1179
+ /** Optiunile pentru `asteapta()` si `verificaSiAsteapta()`. */
1180
+ interface OptiuniAsteptare {
1181
+ /** Pauza intre doua interogari. Implicit 3000 ms, minim 2000 ms (plafonul API-ului). */
1182
+ readonly intervalMs?: number;
1183
+ /** Cat asteptam in total. Implicit 5 minute. */
1184
+ readonly timeoutMs?: number;
1185
+ }
1186
+
1187
+ /** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
1188
+ declare const VERSIUNE_SDK = "0.4.0";
1189
+ /** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
1190
+ declare const URL_IMPLICIT = "https://api.acteo.ro";
1191
+ /** Adresa implicita a clientului legacy {@link VerificRca}. */
1192
+ declare const URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
1193
+ /** Optiunile constructorului {@link Acteo}. Toate sunt optionale. */
1194
+ interface OptiuniClient {
1195
+ /**
1196
+ * Cheia API. Implicit se citeste din variabila de mediu `ACTEO_API_KEY`
1197
+ * (sau `VERIFICRCA_API_KEY`, daca prima lipseste).
1198
+ */
1199
+ readonly apiKey?: string;
1200
+ /** Adresa API-ului. Implicit `https://api.acteo.ro`; schimb-o doar pentru medii de test. */
1201
+ readonly baseUrl?: string;
1202
+ /** Timeout per cerere HTTP. Implicit 30000 ms. */
1203
+ readonly timeoutMs?: number;
1204
+ /**
1205
+ * Reincercari pentru erori trecatoare (retea, 5xx, throttle la polling), cu
1206
+ * backoff exponential si jitter. `false` le dezactiveaza.
1207
+ * Implicit: 3 reincercari, de la 500 ms, maxim 10 s pe pauza.
1208
+ */
1209
+ readonly retry?: Partial<SetariRetry> | false;
1210
+ /** Implementare `fetch` proprie (proxy, teste). Implicit `globalThis.fetch`. */
1211
+ readonly fetch?: typeof globalThis.fetch;
1212
+ /** Adaugat la `User-Agent`, ex: `"flota-mea/2.1"`. */
1213
+ readonly userAgent?: string;
1214
+ }
1215
+ /** Optiuni acceptate de orice metoda a clientului, ca ultim argument. */
1216
+ interface OptiuniCerere {
1217
+ /** Anuleaza cererea (si reincercarile sau asteptarea ei). */
1218
+ readonly signal?: AbortSignal;
1219
+ }
1220
+ /** @internal Ruleaza un efect intern si il transforma in Promise. */
1221
+ type Rulare = <A, E>(efect: Effect.Effect<A, E, Setari>, optiuni?: OptiuniCerere) => Promise<A>;
1222
+ /**
1223
+ * Verificarile la cerere: RCA, ITP, rovinieta si ARR. Il accesezi prin
1224
+ * `vrca.verificari`, nu il construiesti direct.
1225
+ *
1226
+ * Doar `porneste()` si `verificaSiAsteapta()` consuma din cota planului API.
1227
+ * `rezultat()` si `asteapta()` sunt gratuite.
1228
+ */
1229
+ declare class ClientVerificari {
1230
+ #private;
1231
+ /** @internal */
1232
+ constructor(ruleaza: Rulare);
1233
+ /**
1234
+ * Porneste o verificare si consuma o unitate din cota planului.
1235
+ *
1236
+ * Daca vehiculul a fost verificat de curand, primesti imediat rezultatul
1237
+ * existent. Altfel verificarea intra in
1238
+ * coada si primesti `status: "processing"`; rezultatul il afli cu
1239
+ * {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
1240
+ * prin webhook, daca ai trimis `callbackUrl`.
1241
+ *
1242
+ * Datele sunt validate local inainte de cerere: o greseala de tastare nu
1243
+ * pleaca pe retea si nu consuma din cota.
1244
+ *
1245
+ * @param cerere tipul verificarii, identificatorul, VIN-ul (obligatoriu la rovinieta,
1246
+ * impreuna cu `serieTalon`) si, optional, `callbackUrl`.
1247
+ * @param optiuni `signal` pentru anulare.
1248
+ * @returns rezultatul final sau o {@link VerificareInCurs}.
1249
+ * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1250
+ * @throws {@link EroareAutentificare} cheie API invalida (401).
1251
+ * @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
1252
+ * @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "COTA_ATINSA"`).
1253
+ * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1254
+ * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1255
+ * @throws {@link EroareRetea} fara raspuns sau timeout.
1256
+ * @throws {@link EroareServer} eroare 5xx.
1257
+ * @example
1258
+ * const r = await vrca.verificari.porneste({ tip: "itp", query: "WVWZZZ1JZXW000001" })
1259
+ * if (r.status === "processing") {
1260
+ * const final = await vrca.verificari.asteapta(r)
1261
+ * }
1262
+ */
1263
+ porneste(cerere: CerereVerificare, optiuni?: OptiuniCerere): Promise<RaspunsVerificare>;
1264
+ /**
1265
+ * Interogheaza o singura data rezultatul unei verificari. Nu consuma din cota.
1266
+ *
1267
+ * Serverul accepta cel mult o interogare la 2 secunde pentru aceeasi
1268
+ * verificare; la depasire, SDK-ul asteapta cat cere `Retry-After` si reincearca.
1269
+ *
1270
+ * @param referinta obiectul primit de la `porneste()` sau `{ tip, query, serieSasiu?, since? }`.
1271
+ * @param optiuni `signal` pentru anulare.
1272
+ * @returns rezultatul final sau, daca sursa nu a raspuns inca, o {@link VerificareInCurs}.
1273
+ * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata; reia cu `porneste()`.
1274
+ * @throws {@link EroareValidare} referinta invalida (400).
1275
+ * @throws {@link EroareAutentificare} cheie API invalida (401).
1276
+ * @throws {@link EroareRetea} fara raspuns sau timeout, dupa reincercari.
1277
+ * @example
1278
+ * const r = await vrca.verificari.rezultat({ tip: "rca", query: "B123ABC" })
1279
+ * if (r.status !== "processing") console.log(r.status, r.expiresAt)
1280
+ */
1281
+ rezultat(referinta: ReferintaVerificare, optiuni?: OptiuniCerere): Promise<RaspunsVerificare>;
1282
+ /**
1283
+ * Interogheaza periodic pana la rezultatul final. Nu consuma din cota.
1284
+ *
1285
+ * @param referinta obiectul primit de la `porneste()` sau `{ tip, query, serieSasiu?, since? }`.
1286
+ * @param optiuni `intervalMs` (implicit 3000, minim 2000), `timeoutMs` (implicit 5 minute) si `signal`.
1287
+ * @returns rezultatul final al verificarii.
1288
+ * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1289
+ * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata; reia cu `porneste()`.
1290
+ * @throws {@link EroareRetea} fara raspuns, dupa reincercari.
1291
+ * @example
1292
+ * const r = await vrca.verificari.porneste({ tip: "arr", query: "CJ45XYZ" })
1293
+ * const final = r.status === "processing" ? await vrca.verificari.asteapta(r, { intervalMs: 5000 }) : r
1294
+ */
1295
+ asteapta(referinta: ReferintaVerificare, optiuni?: OptiuniAsteptare & OptiuniCerere): Promise<VerificareFinala>;
1296
+ /**
1297
+ * Porneste verificarea si asteapta rezultatul final, intr-un singur apel.
1298
+ * Consuma o unitate din cota (doar pornirea; pollingul e gratuit).
1299
+ *
1300
+ * @param cerere tipul verificarii, identificatorul, VIN-ul (obligatoriu la rovinieta,
1301
+ * impreuna cu `serieTalon`) si, optional, `callbackUrl`.
1302
+ * @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
1303
+ * @returns rezultatul final al verificarii.
1304
+ * @throws {@link EroareValidare} date invalide, local sau HTTP 400.
1305
+ * @throws {@link EroareLimita} cota atinsa (`cod: "COTA_ATINSA"`).
1306
+ * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1307
+ * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
1308
+ * refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
1309
+ * @throws {@link VerificRcaError} orice alta eroare de la API sau de retea.
1310
+ * @example
1311
+ * const rovinieta = await vrca.verificari.verificaSiAsteapta({
1312
+ * tip: "rovinieta",
1313
+ * query: "B123ABC",
1314
+ * serieSasiu: "WVWZZZ1JZXW000001",
1315
+ * serieTalon: "I00639603F",
1316
+ * })
1317
+ * console.log(rovinieta.status, rovinieta.expiresAt)
1318
+ */
1319
+ verificaSiAsteapta(cerere: CerereVerificare, optiuni?: OptiuniAsteptare & OptiuniCerere): Promise<VerificareFinala>;
1320
+ }
1321
+ /**
1322
+ * Vehiculele monitorizate din cont. Il accesezi prin `acteo.auto.flota`, nu il
1323
+ * construiesti direct.
1324
+ *
1325
+ * Operatiile sunt gratuite (nu consuma din cota de verificari), dar cer un plan
1326
+ * activ: abonament API sau plan de cont. Vehiculele din cont sunt verificate
1327
+ * automat si periodic, iar la apropierea expirarilor primesti notificari.
1328
+ */
1329
+ declare class ClientVehicule {
1330
+ #private;
1331
+ /** @internal */
1332
+ constructor(ruleaza: Rulare);
1333
+ /**
1334
+ * Listeaza toate vehiculele din cont, cu datele de expirare RCA, ITP,
1335
+ * rovinieta si ARR.
1336
+ *
1337
+ * @param optiuni `signal` pentru anulare.
1338
+ * @returns vehiculele contului; lista goala daca nu ai niciunul.
1339
+ * @throws {@link EroareAutentificare} cheie API invalida (401).
1340
+ * @throws {@link EroarePlanInactiv} contul nu are un plan activ (402).
1341
+ * @throws {@link EroareRetea} fara raspuns, dupa reincercari.
1342
+ * @example
1343
+ * for (const v of await acteo.auto.flota.lista()) {
1344
+ * console.log(v.numarInmatriculare, v.rcaExpiraLa, v.itpExpiraLa)
1345
+ * }
1346
+ */
1347
+ lista(optiuni?: OptiuniCerere): Promise<readonly Vehicul[]>;
1348
+ /**
1349
+ * Adauga un vehicul in monitorizare. Trimite cel putin numarul de
1350
+ * inmatriculare sau seria de sasiu. ITP-ul cere VIN, iar rovinieta cere
1351
+ * numarul, VIN-ul si `serieTalon` (numarul certificatului de inmatriculare);
1352
+ * fara `serieTalon`, rovinieta nu se verifica.
1353
+ *
1354
+ * @param vehicul numarul, VIN-ul si, optional, `serieTalon` si `arrMonitorizat`.
1355
+ * @param optiuni `signal` pentru anulare.
1356
+ * @returns vehiculul creat, cu `id`-ul folosit la stergere.
1357
+ * @throws {@link EroareValidare} lipseste identificatorul, are caractere nepermise sau `serieTalon` e invalida.
1358
+ * @throws {@link EroareInterzis} `LIMIT_ATINS` (ai atins numarul de masini din plan, vezi `limita`) sau `ARR_NECESITA_PLAN`.
1359
+ * @throws {@link EroareConflict} vehiculul exista deja in cont (`VEHICUL_EXISTENT`).
1360
+ * @throws {@link EroareLimita} plafonul zilnic de adaugari prin API (`LIMITA_FLOTA_ATINSA`).
1361
+ * @throws {@link EroarePlanInactiv} contul nu are un plan activ (402).
1362
+ * @example
1363
+ * const v = await acteo.auto.flota.adauga({
1364
+ * numarInmatriculare: "B123ABC",
1365
+ * serieSasiu: "WVWZZZ1JZXW000001",
1366
+ * serieTalon: "I00639603F",
1367
+ * })
1368
+ * console.log(v.id)
1369
+ */
1370
+ adauga(vehicul: VehiculNou, optiuni?: OptiuniCerere): Promise<Vehicul>;
1371
+ /**
1372
+ * Scoate un vehicul din cont. Monitorizarea si notificarile lui se opresc.
1373
+ *
1374
+ * @param id `id`-ul vehiculului, din {@link ClientVehicule.lista} sau {@link ClientVehicule.adauga}.
1375
+ * @param optiuni `signal` pentru anulare.
1376
+ * @returns se rezolva fara valoare cand vehiculul a fost sters.
1377
+ * @throws {@link EroareNegasit} vehiculul nu exista in contul cheii (404).
1378
+ * @throws {@link EroareLimita} plafonul zilnic de stergeri prin API (`LIMITA_FLOTA_ATINSA`).
1379
+ * @throws {@link EroareValidare} `id` gol.
1380
+ * @example
1381
+ * await acteo.auto.flota.sterge("6f2c1b9e-0000-4000-8000-000000000001")
1382
+ */
1383
+ sterge(id: string, optiuni?: OptiuniCerere): Promise<void>;
1384
+ }
1385
+ /**
1386
+ * Clientul legacy, pastrat pentru codul existent; pentru cod nou foloseste {@link Acteo}.
1387
+ * Verificare RCA, ITP, rovinieta si ARR, plus
1388
+ * gestionarea vehiculelor monitorizate.
1389
+ *
1390
+ * Toate metodele intorc `Promise` si arunca subclase de {@link VerificRcaError}.
1391
+ * Erorile trecatoare (retea, 5xx, throttle la polling) sunt reincercate automat,
1392
+ * fara sa repete vreodata o verificare taxata.
1393
+ *
1394
+ * @example
1395
+ * import { VerificRca } from "@acteo/api"
1396
+ *
1397
+ * const vrca = new VerificRca({ apiKey: process.env.VERIFICRCA_API_KEY })
1398
+ * const rca = await vrca.verificari.verificaSiAsteapta({ tip: "rca", query: "B123ABC" })
1399
+ * console.log(rca.status, rca.expiresAt)
1400
+ */
1401
+ declare class VerificRca {
1402
+ /** Verificari la cerere RCA, ITP, rovinieta si ARR. */
1403
+ readonly verificari: ClientVerificari;
1404
+ /** Vehiculele monitorizate din cont. */
1405
+ readonly vehicule: ClientVehicule;
1406
+ /**
1407
+ * Creeaza un client. Nu face nicio cerere pe retea.
1408
+ *
1409
+ * @param optiuni cheia API si setarile de retea; toate sunt optionale daca
1410
+ * `VERIFICRCA_API_KEY` e setata.
1411
+ * @throws {@link EroareConfigurare} lipseste cheia API sau o optiune e invalida.
1412
+ * @example
1413
+ * const vrca = new VerificRca({
1414
+ * apiKey: process.env.VERIFICRCA_API_KEY,
1415
+ * timeoutMs: 15_000,
1416
+ * retry: { incercari: 5 },
1417
+ * })
1418
+ */
1419
+ constructor(optiuni?: OptiuniClient);
1420
+ }
1421
+
1422
+ /** Decodarea unui VIN, cu cota ramasa. */
1423
+ type DecodareVin = typeof DecodareVinSchema.Type & {
1424
+ /** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
1425
+ readonly limite?: Limite;
1426
+ };
1427
+ /** Verdictul DGPCI pentru un numar, cu cota ramasa. */
1428
+ type NumarDisponibil = typeof NumarDisponibilSchema.Type & {
1429
+ /** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
1430
+ readonly limite?: Limite;
1431
+ };
1432
+ /** Poza unei masini, cu cota ramasa si pauza recomandata. */
1433
+ type ImagineMasina = typeof ImagineMasinaSchema.Type & {
1434
+ /** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
1435
+ readonly limite?: Limite;
1436
+ /** La `status: "in-lucru"`: dupa cat timp sa ceri din nou poza, din `Retry-After`. */
1437
+ readonly retryAfterMs?: number;
1438
+ };
1439
+ /** Optiunile pentru asteptarea unei poze. */
1440
+ interface OptiuniAsteptareImagine {
1441
+ /** Cat asteptam in total o poza `in-lucru`. Implicit 2 minute. */
1442
+ readonly timeoutMs?: number;
1443
+ }
1444
+
1445
+ /** Headerul cu cheia de webhook a contului. */
1446
+ declare const HEADER_CHEIE_WEBHOOK = "x-acteo-key";
1447
+ /** Headerul cu numele evenimentului (`document.expira`, `webhook.test` etc.). */
1448
+ declare const HEADER_EVENIMENT_WEBHOOK = "x-acteo-event";
1449
+ /** Headerele unei cereri, fie `Headers` (fetch, Next.js), fie obiectul din Node/Express. */
1450
+ type HeadereCerere = Headers | Readonly<Record<string, string | readonly string[] | undefined>>;
1451
+ /**
1452
+ * Citeste rezultatul trimis la `callbackUrl` dupa o verificare.
1453
+ *
1454
+ * Foloseste un `callbackUrl` pe HTTPS, greu de ghicit (de exemplu cu un token
1455
+ * secret in cale), si potriveste `requestId` cu cel primit la `porneste()`
1456
+ * inainte sa ai incredere in continut.
1457
+ *
1458
+ * @param corp corpul cererii: string, Buffer/Uint8Array sau obiect deja parsat.
1459
+ * @returns rezultatul tipat, cu datele ca `Date`.
1460
+ * @throws {@link EroareWebhook} corpul nu e JSON (`JSON_INVALID`) sau nu e un rezultat valid (`PAYLOAD_INVALID`).
1461
+ * @example
1462
+ * app.post("/webhooks/acteo/9f3k2", express.raw({ type: "application/json" }), (req, res) => {
1463
+ * const r = parseazaWebhookRezultat(req.body)
1464
+ * if (r.status !== "error") salveaza(r.requestId, r.result?.expiresAt)
1465
+ * res.sendStatus(200)
1466
+ * })
1467
+ */
1468
+ declare function parseazaWebhookRezultat(corp: unknown): WebhookRezultat;
1469
+ /** Optiunile pentru {@link verificaWebhookNotificare}. */
1470
+ interface OptiuniWebhookNotificare {
1471
+ /** Cheia de webhook din dashboard (`whsec_...`). */
1472
+ readonly cheie: string;
1473
+ }
1474
+ /**
1475
+ * Verifica si citeste o notificare trimisa la URL-ul de webhook al contului:
1476
+ * expirarea unui document (`document.expira`), evenimentele celorlalte
1477
+ * servicii (`dosar.*`, `firma.*`, `marca.*`, `asigurare.schimbare`,
1478
+ * `termen.expira`) sau testul din dashboard (`webhook.test`).
1479
+ *
1480
+ * Cheia vine in clar in headerul `X-Acteo-Key` si e comparata in timp
1481
+ * constant cu cea din dashboard. Pastreaza URL-ul pe HTTPS.
1482
+ *
1483
+ * @param corp corpul cererii: string, Buffer/Uint8Array sau obiect deja parsat.
1484
+ * @param headers headerele cererii: `Headers` (fetch, Next.js) sau `req.headers` din Node/Express.
1485
+ * @param optiuni cheia de webhook din dashboard.
1486
+ * @returns evenimentul tipat; distinge-l dupa `event`.
1487
+ * @throws {@link EroareWebhook} cheia lipseste din optiuni (`CHEIE_NECONFIGURATA`), din header sau nu se
1488
+ * potriveste (`CHEIE_INVALIDA`), ori payloadul e invalid (`JSON_INVALID`, `PAYLOAD_INVALID`).
1489
+ * @example
1490
+ * const ev = verificaWebhookNotificare(req.body, req.headers, { cheie: process.env.ACTEO_WEBHOOK_KEY! })
1491
+ * if (ev.event === "document.expira") {
1492
+ * console.log(`${ev.vehicul.numarInmatriculare}: ${ev.document} expira in ${ev.zileRamase} zile`)
1493
+ * }
1494
+ */
1495
+ declare function verificaWebhookNotificare(corp: unknown, headers: HeadereCerere, optiuni: OptiuniWebhookNotificare): WebhookNotificare;
1496
+
1497
+ /** Rezultatul final al unei verificari, ingustat pe documentul ei. */
1498
+ type RezultatDocument<T extends TipVerificare> = VerificareFinala & {
1499
+ /** Documentul verificat. */
1500
+ readonly tip: T;
1501
+ };
1502
+ /** Verificare pusa in coada, ingustata pe documentul ei. */
1503
+ type VerificareInCursDocument<T extends TipVerificare> = VerificareInCurs & {
1504
+ /** Documentul verificat. */
1505
+ readonly tip: T;
1506
+ };
1507
+ /** Raspunsul la `porneste()` sau `rezultat()`: final sau in curs (`status === "processing"`). */
1508
+ type RaspunsDocument<T extends TipVerificare> = RezultatDocument<T> | VerificareInCursDocument<T>;
1509
+ /** Optiunile pentru `porneste()`. */
1510
+ interface OptiuniPornire extends OptiuniCerere {
1511
+ /** URL http(s) unde API-ul trimite rezultatul prin POST cand e gata. */
1512
+ readonly callbackUrl?: string;
1513
+ }
1514
+ /** Optiunile pentru `verifica()` si `asteapta()`. */
1515
+ type OptiuniVerifica = OptiuniAsteptare & OptiuniCerere;
1516
+ /** Identificatorul unei verificari RCA: numar de inmatriculare sau VIN, ori amandoua. */
1517
+ type IdentificatorRca = string | {
1518
+ /** Numarul de inmatriculare. */
1519
+ readonly numar?: string;
1520
+ /** Seria de sasiu (VIN). Cu ea, cautarea in AIDA e mai exacta. */
1521
+ readonly vin?: string;
1522
+ };
1523
+ /** Identificatorii unei verificari de rovinieta, toti obligatorii. */
1524
+ interface IdentificatorRovinieta {
1525
+ /** Numarul de inmatriculare. */
1526
+ readonly numar: string;
1527
+ /** Seria de sasiu (VIN). */
1528
+ readonly vin: string;
1529
+ /** Numarul certificatului de inmatriculare (talon), ex: `I00639603F`. */
1530
+ readonly serieTalon: string;
1531
+ }
1532
+ /** Cum se transforma identificatorul unui document in cererea si referinta API-ului. */
1533
+ interface Mapare<I> {
1534
+ readonly cerere: (id: I) => Omit<CerereVerificare, "callbackUrl">;
1535
+ readonly referinta: (id: I) => ReferintaVerificare;
1536
+ }
1537
+ /**
1538
+ * Verificarile pentru un singur document (RCA, ITP, rovinieta sau ARR). Il
1539
+ * accesezi prin `acteo.auto.rca`, `acteo.auto.itp` etc., nu il construiesti direct.
1540
+ *
1541
+ * `verifica()` si `porneste()` consuma din cota planului; `rezultat()` si
1542
+ * `asteapta()` sunt gratuite.
1543
+ */
1544
+ declare class ClientDocument<T extends TipVerificare, I> {
1545
+ #private;
1546
+ /** @internal */
1547
+ constructor(ruleaza: Rulare, mapare: Mapare<I>);
1548
+ /**
1549
+ * Verifica documentul si asteapta rezultatul final de la sursa oficiala.
1550
+ * Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
1551
+ *
1552
+ * @param identificator ce cere sursa oficiala pentru acest document.
1553
+ * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
1554
+ * @returns rezultatul final.
1555
+ * @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
1556
+ * @throws {@link EroareLimita} cota zilnica sau lunara atinsa.
1557
+ * @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a refuzat datele.
1558
+ * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1559
+ */
1560
+ verifica(identificator: I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
1561
+ /**
1562
+ * Porneste verificarea fara sa astepte. Primesti rezultatul imediat, daca
1563
+ * vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
1564
+ * afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
1565
+ * sau prin webhook la `callbackUrl`.
1566
+ *
1567
+ * @param identificator ce cere sursa oficiala pentru acest document.
1568
+ * @param optiuni `callbackUrl` si `signal`.
1569
+ * @returns rezultatul final sau verificarea in curs.
1570
+ */
1571
+ porneste(identificator: I, optiuni?: OptiuniPornire): Promise<RaspunsDocument<T>>;
1572
+ /**
1573
+ * Interogheaza o singura data rezultatul. Nu consuma din cota.
1574
+ *
1575
+ * @param referinta verificarea in curs primita de la `porneste()` sau identificatorul documentului.
1576
+ * @param optiuni `signal` pentru anulare.
1577
+ * @returns rezultatul final sau verificarea inca in curs.
1578
+ */
1579
+ rezultat(referinta: VerificareInCursDocument<T> | I, optiuni?: OptiuniCerere): Promise<RaspunsDocument<T>>;
1580
+ /**
1581
+ * Interogheaza periodic pana la rezultatul final. Nu consuma din cota.
1582
+ *
1583
+ * @param referinta verificarea in curs primita de la `porneste()` sau identificatorul documentului.
1584
+ * @param optiuni `timeoutMs`, `intervalMs` si `signal`.
1585
+ * @returns rezultatul final.
1586
+ * @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
1587
+ */
1588
+ asteapta(referinta: VerificareInCursDocument<T> | I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
1589
+ }
1590
+ /** Asigurarea RCA, din baza AIDA. Accepta numar de inmatriculare, VIN sau amandoua. */
1591
+ type ClientRca = ClientDocument<"rca", IdentificatorRca>;
1592
+ /** Inspectia tehnica periodica, din RAR. Accepta doar VIN-ul. */
1593
+ type ClientItp = ClientDocument<"itp", string>;
1594
+ /** Rovinieta, din CNAIR. Cere numarul, VIN-ul si numarul talonului. */
1595
+ type ClientRovinieta = ClientDocument<"rovinieta", IdentificatorRovinieta>;
1596
+ /** Copia conforma ARR. Accepta doar numarul de inmatriculare. */
1597
+ type ClientArr = ClientDocument<"arr", string>;
1598
+ /** Decodarea seriei de sasiu (VIN). Cere un abonament de decodare VIN. */
1599
+ declare class ClientVin {
1600
+ #private;
1601
+ /** @internal */
1602
+ constructor(ruleaza: Rulare);
1603
+ /**
1604
+ * Decodeaza un VIN: marca, model, an si structura lui. Consuma din cota doar
1605
+ * cand marca si modelul sunt gasite (`taxat: true`).
1606
+ *
1607
+ * @param vin seria de sasiu, 17 caractere (spatiile si literele mici sunt acceptate).
1608
+ * @param optiuni `signal` pentru anulare.
1609
+ * @returns decodarea, completa, partiala sau doar structura.
1610
+ * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1611
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1612
+ * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1613
+ * @example
1614
+ * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1615
+ * console.log(d.marca, d.model, d.anFabricatie)
1616
+ */
1617
+ decodeaza(vin: string, optiuni?: OptiuniCerere): Promise<DecodareVin>;
1618
+ }
1619
+ /** Numerele de inmatriculare disponibile, direct de la DGPCI. Cere un abonament de numere disponibile. */
1620
+ declare class ClientNumere {
1621
+ #private;
1622
+ /** @internal */
1623
+ constructor(ruleaza: Rulare);
1624
+ /**
1625
+ * Verifica la DGPCI daca un numar de inmatriculare e liber. Raspunsul vine
1626
+ * sincron si poate dura pana la doua minute; cererea are un timeout minim
1627
+ * potrivit, oricat de mic e `timeoutMs` din client. Consuma din cota doar cand
1628
+ * DGPCI da un verdict.
1629
+ *
1630
+ * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1631
+ * @param optiuni `signal` pentru anulare.
1632
+ * @returns verdictul DGPCI.
1633
+ * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`NUMAR_RESPINS`).
1634
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1635
+ * @throws {@link EroareLimita} cota atinsa.
1636
+ * @throws {@link EroareServer} `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
1637
+ * @example
1638
+ * const r = await acteo.auto.numere.verifica("BV07ABC")
1639
+ * if (r.disponibil) console.log("Numarul e liber")
1640
+ */
1641
+ verifica(numar: string, optiuni?: OptiuniCerere): Promise<NumarDisponibil>;
1642
+ }
1643
+ /** Pozele de studio ale masinilor. Cere un abonament de imagini masini. */
1644
+ declare class ClientImagini {
1645
+ #private;
1646
+ /** @internal */
1647
+ constructor(ruleaza: Rulare);
1648
+ /**
1649
+ * Cere poza unei masini si raspunde imediat. Cu `status: "gata"` primesti poza
1650
+ * reala si se taxeaza; altfel primesti poza generica (masina sub husa),
1651
+ * netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
1652
+ * {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
1653
+ *
1654
+ * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
1655
+ * @param optiuni `signal` pentru anulare.
1656
+ * @returns poza masinii sau poza generica.
1657
+ * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1658
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1659
+ * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1660
+ * @example
1661
+ * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1662
+ * if (p.status === "gata") afiseaza(p.url)
1663
+ */
1664
+ obtine(cerere: CerereImagine, optiuni?: OptiuniCerere): Promise<ImagineMasina>;
1665
+ /**
1666
+ * Ca {@link ClientImagini.obtine}, dar cat timp poza e `"in-lucru"` o cere din
1667
+ * nou, cu pauzele din `Retry-After`. Fiecare cerere intermediara e netaxata,
1668
+ * dar intra in plafonul zilnic de poze generice.
1669
+ *
1670
+ * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
1671
+ * @param optiuni `timeoutMs` (implicit 2 minute) si `signal`.
1672
+ * @returns poza cu orice status in afara de `"in-lucru"`.
1673
+ * @throws {@link EroareTimeoutVerificare} poza nu a fost gata in `timeoutMs`.
1674
+ */
1675
+ asteapta(cerere: CerereImagine, optiuni?: OptiuniAsteptareImagine & OptiuniCerere): Promise<ImagineMasina>;
1676
+ }
1677
+ /** Domeniul auto: documentele unei masini, flota monitorizata, VIN, numere si poze. */
1678
+ declare class ClientAuto {
1679
+ /** Asigurarea RCA: `acteo.auto.rca.verifica("B123ABC")`. */
1680
+ readonly rca: ClientRca;
1681
+ /** ITP: `acteo.auto.itp.verifica("WVWZZZ1JZXW000001")`. */
1682
+ readonly itp: ClientItp;
1683
+ /** Rovinieta: `acteo.auto.rovinieta.verifica({ numar, vin, serieTalon })`. */
1684
+ readonly rovinieta: ClientRovinieta;
1685
+ /** Copia conforma ARR: `acteo.auto.arr.verifica("B123ABC")`. */
1686
+ readonly arr: ClientArr;
1687
+ /** Vehiculele monitorizate din cont: `lista()`, `adauga()`, `sterge()`. */
1688
+ readonly flota: ClientVehicule;
1689
+ /** Decodarea VIN: `acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")`. */
1690
+ readonly vin: ClientVin;
1691
+ /** Numere disponibile la DGPCI: `acteo.auto.numere.verifica("BV07ABC")`. */
1692
+ readonly numere: ClientNumere;
1693
+ /** Pozele masinilor: `acteo.auto.imagini.obtine({ marca, model, an })`. */
1694
+ readonly imagini: ClientImagini;
1695
+ /** @internal */
1696
+ constructor(ruleaza: Rulare);
1697
+ }
1698
+ /** Citirea webhook-urilor trimise de API. Nu face cereri pe retea. */
1699
+ declare class ClientWebhooks {
1700
+ /**
1701
+ * Valideaza corpul unui webhook de rezultat (trimis la `callbackUrl`).
1702
+ *
1703
+ * @param corp corpul cererii, ca string sau obiect deja parsat.
1704
+ * @returns rezultatul verificarii.
1705
+ * @throws {@link EroareWebhook} corp invalid.
1706
+ */
1707
+ parseazaRezultat(corp: unknown): WebhookRezultat;
1708
+ /**
1709
+ * Verifica cheia si corpul unui webhook de notificare (`document.expira`,
1710
+ * evenimentele celorlalte servicii sau `webhook.test`).
1711
+ *
1712
+ * @param corp corpul cererii.
1713
+ * @param headers headerele cererii.
1714
+ * @param optiuni `cheie`, cheia de webhook din dashboard.
1715
+ * @returns notificarea validata.
1716
+ * @throws {@link EroareWebhook} cheie lipsa, gresita sau corp invalid.
1717
+ */
1718
+ verificaNotificare(corp: unknown, headers: HeadereCerere, optiuni: OptiuniWebhookNotificare): WebhookNotificare;
1719
+ }
1720
+ /**
1721
+ * Clientul API-ului Acteo, organizat pe domenii: `acteo.auto.rca`,
1722
+ * `acteo.auto.itp`, `acteo.auto.rovinieta`, `acteo.auto.arr`, `acteo.auto.flota`,
1723
+ * `acteo.auto.vin`, `acteo.auto.numere`, `acteo.auto.imagini` si `acteo.webhooks`.
1724
+ *
1725
+ * Toate metodele intorc `Promise` si arunca subclase de {@link VerificRcaError}.
1726
+ * Erorile trecatoare sunt reincercate automat, fara sa repete vreodata o
1727
+ * verificare taxata.
1728
+ *
1729
+ * @example
1730
+ * import { Acteo } from "@acteo/api"
1731
+ *
1732
+ * const acteo = new Acteo({ apiKey: process.env.ACTEO_API_KEY })
1733
+ * const rca = await acteo.auto.rca.verifica("B123ABC")
1734
+ * console.log(rca.status, rca.expiresAt)
1735
+ */
1736
+ declare class Acteo {
1737
+ /** Documentele unei masini (RCA, ITP, rovinieta, ARR), flota, VIN, numere si poze. */
1738
+ readonly auto: ClientAuto;
1739
+ /** Citirea webhook-urilor. */
1740
+ readonly webhooks: ClientWebhooks;
1741
+ /**
1742
+ * Creeaza un client. Nu face nicio cerere pe retea.
1743
+ *
1744
+ * @param optiuni cheia API si setarile de retea; toate sunt optionale daca
1745
+ * `ACTEO_API_KEY` e setata.
1746
+ * @throws {@link EroareConfigurare} lipseste cheia API sau o optiune e invalida.
1747
+ */
1748
+ constructor(optiuni?: OptiuniClient);
1749
+ }
1750
+
1751
+ 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 };