@acteo/api 0.3.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/dist/index.d.cts CHANGED
@@ -23,7 +23,7 @@ declare const RezultatVerificareSchema: Schema.Struct<{
23
23
  numarInmatriculare: Schema.NullOr<typeof Schema.String>;
24
24
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
25
25
  serieSasiu: Schema.NullOr<typeof Schema.String>;
26
- /** Cand a fost interogata sursa oficiala. */
26
+ /** Momentul verificarii. */
27
27
  checkedAt: typeof Schema.Date;
28
28
  /** Starea documentului. Vezi {@link StatusDocument}. */
29
29
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
@@ -98,7 +98,7 @@ declare const WebhookRezultatSchema: Schema.Struct<{
98
98
  numarInmatriculare: Schema.NullOr<typeof Schema.String>;
99
99
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
100
100
  serieSasiu: Schema.NullOr<typeof Schema.String>;
101
- /** Cand a fost interogata sursa oficiala. */
101
+ /** Momentul verificarii. */
102
102
  checkedAt: typeof Schema.Date;
103
103
  /** Starea documentului. Vezi {@link StatusDocument}. */
104
104
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
@@ -109,7 +109,7 @@ declare const WebhookRezultatSchema: Schema.Struct<{
109
109
  /** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
110
110
  hint: Schema.optional<typeof Schema.String>;
111
111
  }>>;
112
- /** Cand a fost interogata sursa, `null` la eroare. */
112
+ /** Momentul verificarii, `null` la eroare. */
113
113
  checkedAt: Schema.NullOr<typeof Schema.Date>;
114
114
  /** Mesajul de eroare, doar la `status: "error"`. */
115
115
  error: Schema.optional<typeof Schema.String>;
@@ -157,6 +157,250 @@ declare const WebhookTestSchema: Schema.Struct<{
157
157
  }>;
158
158
  /** Evenimentul trimis de butonul de test din dashboard. */
159
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;
160
404
  declare const WebhookNotificareSchema: Schema.Union<[Schema.Struct<{
161
405
  /** Numele evenimentului. */
162
406
  event: Schema.Literal<["document.expira"]>;
@@ -181,6 +425,218 @@ declare const WebhookNotificareSchema: Schema.Union<[Schema.Struct<{
181
425
  prag: typeof Schema.Number;
182
426
  /** Cand a fost trimisa notificarea. */
183
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]>;
184
640
  }>, Schema.Struct<{
185
641
  /** Numele evenimentului. */
186
642
  event: Schema.Literal<["webhook.test"]>;
@@ -193,6 +649,102 @@ declare const WebhookNotificareSchema: Schema.Union<[Schema.Struct<{
193
649
  }>]>;
194
650
  /** Orice notificare trimisa la URL-ul de webhook al contului. Distinge-le dupa `event`. */
195
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
+ }>;
196
748
 
197
749
  /** Campurile comune tuturor erorilor SDK-ului. */
198
750
  interface DateEroare {
@@ -228,7 +780,8 @@ declare class EroareConfigurare extends VerificRcaError {
228
780
  }
229
781
  /**
230
782
  * Datele trimise sunt invalide. Apare fie local, inainte de orice cerere (nu se
231
- * consuma nimic din cota), fie ca raspuns 400 de la API.
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).
232
785
  */
233
786
  declare class EroareValidare extends VerificRcaError {
234
787
  /** Discriminantul erorii: `"EroareValidare"`. Util in `switch (err._tag)`. */
@@ -322,12 +875,26 @@ declare class EroareLimita extends VerificRcaError {
322
875
  readonly utilizareLuna?: string;
323
876
  });
324
877
  }
325
- /** 5xx: eroare pe serverul API-ului. Cererile sigure se reincearca automat. */
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
+ */
326
883
  declare class EroareServer extends VerificRcaError {
327
884
  /** Discriminantul erorii: `"EroareServer"`. Util in `switch (err._tag)`. */
328
885
  readonly _tag = "EroareServer";
329
886
  /** Numele clasei, afisat in loguri si in stack trace. */
330
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
+ });
331
898
  }
332
899
  /** Orice alt status HTTP neasteptat. */
333
900
  declare class EroareHttp extends VerificRcaError {
@@ -393,7 +960,7 @@ declare class EroareVerificare extends VerificRcaError {
393
960
  readonly codSursa?: CodRefuzSursa;
394
961
  });
395
962
  }
396
- /** `verificaSiAsteapta` a depasit timpul maxim de asteptare. */
963
+ /** Asteptarea unei verificari (`verifica`, `asteapta`) sau a unei poze (`imagini.asteapta`) a depasit timpul maxim. */
397
964
  declare class EroareTimeoutVerificare extends VerificRcaError {
398
965
  /** Discriminantul erorii: `"EroareTimeoutVerificare"`. Util in `switch (err._tag)`. */
399
966
  readonly _tag = "EroareTimeoutVerificare";
@@ -528,6 +1095,21 @@ interface VehiculNou {
528
1095
  /** Monitorizeaza si copia conforma ARR. Cere un plan activ. */
529
1096
  readonly arrMonitorizat?: boolean;
530
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
+ }
531
1113
 
532
1114
  /** Cat mai ai din cota planului, din headerele `X-RateLimit-*`. */
533
1115
  interface Limite {
@@ -603,7 +1185,7 @@ interface OptiuniAsteptare {
603
1185
  }
604
1186
 
605
1187
  /** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
606
- declare const VERSIUNE_SDK = "0.3.0";
1188
+ declare const VERSIUNE_SDK = "0.4.1";
607
1189
  /** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
608
1190
  declare const URL_IMPLICIT = "https://api.acteo.ro";
609
1191
  /** Adresa implicita a clientului legacy {@link VerificRca}. */
@@ -651,9 +1233,8 @@ declare class ClientVerificari {
651
1233
  /**
652
1234
  * Porneste o verificare si consuma o unitate din cota planului.
653
1235
  *
654
- * Daca vehiculul a fost verificat de curand, primesti imediat rezultatul
655
- * existent. Altfel verificarea intra in
656
- * coada si primesti `status: "processing"`; rezultatul il afli cu
1236
+ * Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
1237
+ * primesti `status: "processing"`; rezultatul il afli cu
657
1238
  * {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
658
1239
  * prin webhook, daca ai trimis `callbackUrl`.
659
1240
  *
@@ -837,10 +1418,33 @@ declare class VerificRca {
837
1418
  constructor(optiuni?: OptiuniClient);
838
1419
  }
839
1420
 
840
- /** Headerul cu cheia de webhook a contului (`whsec_...`). */
841
- declare const HEADER_CHEIE_WEBHOOK = "x-verificrca-key";
842
- /** Headerul cu numele evenimentului (`document.expira`, `webhook.test`). */
843
- declare const HEADER_EVENIMENT_WEBHOOK = "x-verificrca-event";
1421
+ /** Decodarea unui VIN, cu cota ramasa. */
1422
+ type DecodareVin = typeof DecodareVinSchema.Type & {
1423
+ /** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
1424
+ readonly limite?: Limite;
1425
+ };
1426
+ /** Verdictul DGPCI pentru un numar, cu cota ramasa. */
1427
+ type NumarDisponibil = typeof NumarDisponibilSchema.Type & {
1428
+ /** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
1429
+ readonly limite?: Limite;
1430
+ };
1431
+ /** Poza unei masini, cu cota ramasa si pauza recomandata. */
1432
+ type ImagineMasina = typeof ImagineMasinaSchema.Type & {
1433
+ /** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
1434
+ readonly limite?: Limite;
1435
+ /** La `status: "in-lucru"`: dupa cat timp sa ceri din nou poza, din `Retry-After`. */
1436
+ readonly retryAfterMs?: number;
1437
+ };
1438
+ /** Optiunile pentru asteptarea unei poze. */
1439
+ interface OptiuniAsteptareImagine {
1440
+ /** Cat asteptam in total o poza `in-lucru`. Implicit 2 minute. */
1441
+ readonly timeoutMs?: number;
1442
+ }
1443
+
1444
+ /** Headerul cu cheia de webhook a contului. */
1445
+ declare const HEADER_CHEIE_WEBHOOK = "x-acteo-key";
1446
+ /** Headerul cu numele evenimentului (`document.expira`, `webhook.test` etc.). */
1447
+ declare const HEADER_EVENIMENT_WEBHOOK = "x-acteo-event";
844
1448
  /** Headerele unei cereri, fie `Headers` (fetch, Next.js), fie obiectul din Node/Express. */
845
1449
  type HeadereCerere = Headers | Readonly<Record<string, string | readonly string[] | undefined>>;
846
1450
  /**
@@ -867,10 +1471,12 @@ interface OptiuniWebhookNotificare {
867
1471
  readonly cheie: string;
868
1472
  }
869
1473
  /**
870
- * Verifica si citeste o notificare de expirare (`document.expira`) sau un test
871
- * (`webhook.test`) trimise la URL-ul de webhook al contului.
1474
+ * Verifica si citeste o notificare trimisa la URL-ul de webhook al contului:
1475
+ * expirarea unui document (`document.expira`), evenimentele celorlalte
1476
+ * servicii (`dosar.*`, `firma.*`, `marca.*`, `asigurare.schimbare`,
1477
+ * `termen.expira`) sau testul din dashboard (`webhook.test`).
872
1478
  *
873
- * Cheia vine in clar in headerul `X-Verificrca-Key` si e comparata in timp
1479
+ * Cheia vine in clar in headerul `X-Acteo-Key` si e comparata in timp
874
1480
  * constant cu cea din dashboard. Pastreaza URL-ul pe HTTPS.
875
1481
  *
876
1482
  * @param corp corpul cererii: string, Buffer/Uint8Array sau obiect deja parsat.
@@ -880,7 +1486,7 @@ interface OptiuniWebhookNotificare {
880
1486
  * @throws {@link EroareWebhook} cheia lipseste din optiuni (`CHEIE_NECONFIGURATA`), din header sau nu se
881
1487
  * potriveste (`CHEIE_INVALIDA`), ori payloadul e invalid (`JSON_INVALID`, `PAYLOAD_INVALID`).
882
1488
  * @example
883
- * const ev = verificaWebhookNotificare(req.body, req.headers, { cheie: process.env.VERIFICRCA_WEBHOOK_KEY! })
1489
+ * const ev = verificaWebhookNotificare(req.body, req.headers, { cheie: process.env.ACTEO_WEBHOOK_KEY! })
884
1490
  * if (ev.event === "document.expira") {
885
1491
  * console.log(`${ev.vehicul.numarInmatriculare}: ${ev.document} expira in ${ev.zileRamase} zile`)
886
1492
  * }
@@ -940,7 +1546,6 @@ declare class ClientDocument<T extends TipVerificare, I> {
940
1546
  constructor(ruleaza: Rulare, mapare: Mapare<I>);
941
1547
  /**
942
1548
  * Verifica documentul si asteapta rezultatul final de la sursa oficiala.
943
- * Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
944
1549
  *
945
1550
  * @param identificator ce cere sursa oficiala pentru acest document.
946
1551
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
@@ -952,8 +1557,7 @@ declare class ClientDocument<T extends TipVerificare, I> {
952
1557
  */
953
1558
  verifica(identificator: I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
954
1559
  /**
955
- * Porneste verificarea fara sa astepte. Primesti rezultatul imediat, daca
956
- * vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
1560
+ * Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
957
1561
  * afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
958
1562
  * sau prin webhook la `callbackUrl`.
959
1563
  *
@@ -988,7 +1592,86 @@ type ClientItp = ClientDocument<"itp", string>;
988
1592
  type ClientRovinieta = ClientDocument<"rovinieta", IdentificatorRovinieta>;
989
1593
  /** Copia conforma ARR. Accepta doar numarul de inmatriculare. */
990
1594
  type ClientArr = ClientDocument<"arr", string>;
991
- /** Domeniul auto: documentele unei masini si flota monitorizata. */
1595
+ /** Decodarea seriei de sasiu (VIN). Cere un abonament de decodare VIN. */
1596
+ declare class ClientVin {
1597
+ #private;
1598
+ /** @internal */
1599
+ constructor(ruleaza: Rulare);
1600
+ /**
1601
+ * Decodeaza un VIN: marca, model, an si structura lui. Consuma din cota doar
1602
+ * cand marca si modelul sunt gasite (`taxat: true`).
1603
+ *
1604
+ * @param vin seria de sasiu, 17 caractere (spatiile si literele mici sunt acceptate).
1605
+ * @param optiuni `signal` pentru anulare.
1606
+ * @returns decodarea, completa, partiala sau doar structura.
1607
+ * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1608
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1609
+ * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1610
+ * @example
1611
+ * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1612
+ * console.log(d.marca, d.model, d.anFabricatie)
1613
+ */
1614
+ decodeaza(vin: string, optiuni?: OptiuniCerere): Promise<DecodareVin>;
1615
+ }
1616
+ /** Numerele de inmatriculare disponibile, direct de la DGPCI. Cere un abonament de numere disponibile. */
1617
+ declare class ClientNumere {
1618
+ #private;
1619
+ /** @internal */
1620
+ constructor(ruleaza: Rulare);
1621
+ /**
1622
+ * Verifica la DGPCI daca un numar de inmatriculare e liber. Raspunsul vine
1623
+ * sincron si poate dura pana la doua minute; cererea are un timeout minim
1624
+ * potrivit, oricat de mic e `timeoutMs` din client. Consuma din cota doar cand
1625
+ * DGPCI da un verdict.
1626
+ *
1627
+ * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1628
+ * @param optiuni `signal` pentru anulare.
1629
+ * @returns verdictul DGPCI.
1630
+ * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`NUMAR_RESPINS`).
1631
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1632
+ * @throws {@link EroareLimita} cota atinsa.
1633
+ * @throws {@link EroareServer} `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
1634
+ * @example
1635
+ * const r = await acteo.auto.numere.verifica("BV07ABC")
1636
+ * if (r.disponibil) console.log("Numarul e liber")
1637
+ */
1638
+ verifica(numar: string, optiuni?: OptiuniCerere): Promise<NumarDisponibil>;
1639
+ }
1640
+ /** Pozele de studio ale masinilor. Cere un abonament de imagini masini. */
1641
+ declare class ClientImagini {
1642
+ #private;
1643
+ /** @internal */
1644
+ constructor(ruleaza: Rulare);
1645
+ /**
1646
+ * Cere poza unei masini si raspunde imediat. Cu `status: "gata"` primesti poza
1647
+ * reala si se taxeaza; altfel primesti poza generica (masina sub husa),
1648
+ * netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
1649
+ * {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
1650
+ *
1651
+ * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
1652
+ * @param optiuni `signal` pentru anulare.
1653
+ * @returns poza masinii sau poza generica.
1654
+ * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1655
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1656
+ * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1657
+ * @example
1658
+ * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1659
+ * if (p.status === "gata") afiseaza(p.url)
1660
+ */
1661
+ obtine(cerere: CerereImagine, optiuni?: OptiuniCerere): Promise<ImagineMasina>;
1662
+ /**
1663
+ * Ca {@link ClientImagini.obtine}, dar cat timp poza e `"in-lucru"` o cere din
1664
+ * nou, cu pauzele din `Retry-After`. Fiecare cerere intermediara e netaxata,
1665
+ * dar intra in plafonul zilnic de poze generice.
1666
+ *
1667
+ * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
1668
+ * @param optiuni `timeoutMs` (implicit 2 minute) si `signal`.
1669
+ * @returns poza cu orice status in afara de `"in-lucru"`.
1670
+ * @throws {@link EroareTimeoutVerificare} poza nu a fost gata in `timeoutMs`.
1671
+ */
1672
+ asteapta(cerere: CerereImagine, optiuni?: OptiuniAsteptareImagine & OptiuniCerere): Promise<ImagineMasina>;
1673
+ }
1674
+ /** Domeniul auto: documentele unei masini, flota monitorizata, VIN, numere si poze. */
992
1675
  declare class ClientAuto {
993
1676
  /** Asigurarea RCA: `acteo.auto.rca.verifica("B123ABC")`. */
994
1677
  readonly rca: ClientRca;
@@ -1000,6 +1683,12 @@ declare class ClientAuto {
1000
1683
  readonly arr: ClientArr;
1001
1684
  /** Vehiculele monitorizate din cont: `lista()`, `adauga()`, `sterge()`. */
1002
1685
  readonly flota: ClientVehicule;
1686
+ /** Decodarea VIN: `acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")`. */
1687
+ readonly vin: ClientVin;
1688
+ /** Numere disponibile la DGPCI: `acteo.auto.numere.verifica("BV07ABC")`. */
1689
+ readonly numere: ClientNumere;
1690
+ /** Pozele masinilor: `acteo.auto.imagini.obtine({ marca, model, an })`. */
1691
+ readonly imagini: ClientImagini;
1003
1692
  /** @internal */
1004
1693
  constructor(ruleaza: Rulare);
1005
1694
  }
@@ -1014,7 +1703,8 @@ declare class ClientWebhooks {
1014
1703
  */
1015
1704
  parseazaRezultat(corp: unknown): WebhookRezultat;
1016
1705
  /**
1017
- * Verifica cheia si corpul unui webhook de notificare (ex: `document.expira`).
1706
+ * Verifica cheia si corpul unui webhook de notificare (`document.expira`,
1707
+ * evenimentele celorlalte servicii sau `webhook.test`).
1018
1708
  *
1019
1709
  * @param corp corpul cererii.
1020
1710
  * @param headers headerele cererii.
@@ -1026,8 +1716,8 @@ declare class ClientWebhooks {
1026
1716
  }
1027
1717
  /**
1028
1718
  * Clientul API-ului Acteo, organizat pe domenii: `acteo.auto.rca`,
1029
- * `acteo.auto.itp`, `acteo.auto.rovinieta`, `acteo.auto.arr`, `acteo.auto.flota`
1030
- * si `acteo.webhooks`.
1719
+ * `acteo.auto.itp`, `acteo.auto.rovinieta`, `acteo.auto.arr`, `acteo.auto.flota`,
1720
+ * `acteo.auto.vin`, `acteo.auto.numere`, `acteo.auto.imagini` si `acteo.webhooks`.
1031
1721
  *
1032
1722
  * Toate metodele intorc `Promise` si arunca subclase de {@link VerificRcaError}.
1033
1723
  * Erorile trecatoare sunt reincercate automat, fara sa repete vreodata o
@@ -1041,7 +1731,7 @@ declare class ClientWebhooks {
1041
1731
  * console.log(rca.status, rca.expiresAt)
1042
1732
  */
1043
1733
  declare class Acteo {
1044
- /** Documentele unei masini (RCA, ITP, rovinieta, ARR) si flota. */
1734
+ /** Documentele unei masini (RCA, ITP, rovinieta, ARR), flota, VIN, numere si poze. */
1045
1735
  readonly auto: ClientAuto;
1046
1736
  /** Citirea webhook-urilor. */
1047
1737
  readonly webhooks: ClientWebhooks;
@@ -1055,4 +1745,4 @@ declare class Acteo {
1055
1745
  constructor(optiuni?: OptiuniClient);
1056
1746
  }
1057
1747
 
1058
- export { Acteo, VerificRcaError as ActeoError, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, type ClientItp, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientWebhooks, type CodRefuzSursa, type DateEroare, 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 Limite, type OptiuniAsteptare, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, TIPURI_VERIFICARE, TipVerificare, URL_IMPLICIT, URL_IMPLICIT_LEGACY, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookDocumentExpira, type WebhookNotificare, type WebhookRezultat, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
1748
+ 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 };