@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.cjs CHANGED
@@ -86,6 +86,14 @@ var EroareServer = class extends VerificRcaError {
86
86
  _tag = "EroareServer";
87
87
  /** Numele clasei, afisat in loguri si in stack trace. */
88
88
  name = "EroareServer";
89
+ /**
90
+ * Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
91
+ *
92
+ * @param args mesajul, detaliile comune ({@link DateEroare}) si `retryAfterMs`.
93
+ */
94
+ constructor(args) {
95
+ super(args);
96
+ }
89
97
  };
90
98
  var EroareHttp = class extends VerificRcaError {
91
99
  /** Discriminantul erorii: `"EroareHttp"`. Util in `switch (err._tag)`. */
@@ -151,7 +159,7 @@ var RezultatVerificareSchema = effect.Schema.Struct({
151
159
  numarInmatriculare: effect.Schema.NullOr(effect.Schema.String),
152
160
  /** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
153
161
  serieSasiu: effect.Schema.NullOr(effect.Schema.String),
154
- /** Cand a fost interogata sursa oficiala. */
162
+ /** Momentul verificarii. */
155
163
  checkedAt: effect.Schema.Date,
156
164
  /** Starea documentului. Vezi {@link StatusDocument}. */
157
165
  status: StatusDocument,
@@ -232,7 +240,7 @@ var WebhookRezultatSchema = effect.Schema.Struct({
232
240
  status: effect.Schema.Union(StatusDocument, effect.Schema.Literal("error")),
233
241
  /** Rezultatul complet, `null` la `status: "error"`. */
234
242
  result: effect.Schema.NullOr(RezultatVerificareSchema),
235
- /** Cand a fost interogata sursa, `null` la eroare. */
243
+ /** Momentul verificarii, `null` la eroare. */
236
244
  checkedAt: DataNullabila,
237
245
  /** Mesajul de eroare, doar la `status: "error"`. */
238
246
  error: effect.Schema.optional(effect.Schema.String)
@@ -272,7 +280,321 @@ var WebhookTestSchema = effect.Schema.Struct({
272
280
  /** Cand a fost trimis testul. */
273
281
  trimisLa: effect.Schema.Date
274
282
  });
275
- var WebhookNotificareSchema = effect.Schema.Union(WebhookDocumentExpiraSchema, WebhookTestSchema);
283
+ var DosarWebhook = effect.Schema.Struct({
284
+ /** ID-ul dosarului in cont. */
285
+ id: effect.Schema.String,
286
+ /** Numarul dosarului la instanta, ex: `1234/3/2024`. */
287
+ numar: effect.Schema.String,
288
+ /** Eticheta pusa de tine in cont. */
289
+ eticheta: effect.Schema.NullOr(effect.Schema.String)
290
+ });
291
+ var WebhookDosarEvenimentSchema = effect.Schema.Struct({
292
+ /** Numele evenimentului. */
293
+ event: effect.Schema.Literal("dosar.eveniment"),
294
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
295
+ id: effect.Schema.String,
296
+ /** Cand a fost trimisa notificarea. */
297
+ trimisLa: effect.Schema.Date,
298
+ /** Dosarul monitorizat. */
299
+ dosar: DosarWebhook,
300
+ /** Ce s-a intamplat in dosar. */
301
+ eveniment: effect.Schema.Struct({
302
+ /**
303
+ * `termen_nou` (sedinta noua), `solutie`, `cale_atac` (apel, recurs), `stadiu`,
304
+ * `instanta_noua` sau `incheiat_auto` (180 de zile fara noutati: dosarul nu mai e monitorizat).
305
+ */
306
+ tip: effect.Schema.Literal("termen_nou", "solutie", "cale_atac", "stadiu", "instanta_noua", "incheiat_auto"),
307
+ /** Textul alertei, ca in email. */
308
+ descriere: effect.Schema.String,
309
+ /** Instanta, cand e cunoscuta. */
310
+ institutie: effect.Schema.NullOr(effect.Schema.String)
311
+ })
312
+ });
313
+ var WebhookDosarTermenSchema = effect.Schema.Struct({
314
+ /** Numele evenimentului. */
315
+ event: effect.Schema.Literal("dosar.termen"),
316
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
317
+ id: effect.Schema.String,
318
+ /** Cand a fost trimisa notificarea. */
319
+ trimisLa: effect.Schema.Date,
320
+ /** Dosarul monitorizat. */
321
+ dosar: DosarWebhook,
322
+ /** Sedinta care se apropie. */
323
+ sedinta: effect.Schema.Struct({
324
+ /** Data sedintei. */
325
+ data: effect.Schema.Date,
326
+ /** Ora sedintei, cand e cunoscuta. */
327
+ ora: effect.Schema.NullOr(effect.Schema.String),
328
+ /** Instanta. */
329
+ institutie: effect.Schema.NullOr(effect.Schema.String),
330
+ /** Completul de judecata. */
331
+ complet: effect.Schema.NullOr(effect.Schema.String)
332
+ }),
333
+ /** Reminder cu 3 zile si cu o zi inainte de sedinta. */
334
+ zileRamase: effect.Schema.Literal(1, 3)
335
+ });
336
+ var FirmaWebhook = effect.Schema.Struct({
337
+ /** ID-ul firmei in cont. */
338
+ id: effect.Schema.String,
339
+ /** Denumirea firmei. */
340
+ denumire: effect.Schema.String
341
+ });
342
+ var WebhookFirmaSchimbareSchema = effect.Schema.Struct({
343
+ /** Numele evenimentului. */
344
+ event: effect.Schema.Literal("firma.schimbare"),
345
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
346
+ id: effect.Schema.String,
347
+ /** Cand a fost trimisa notificarea. */
348
+ trimisLa: effect.Schema.Date,
349
+ /** Firma monitorizata. */
350
+ firma: FirmaWebhook,
351
+ /** Campurile schimbate. */
352
+ schimbari: effect.Schema.Array(
353
+ effect.Schema.Struct({
354
+ /** Campul schimbat. */
355
+ camp: effect.Schema.Literal(
356
+ "radiata",
357
+ "inactiv",
358
+ "platitor_tva",
359
+ "tva_la_incasare",
360
+ "split_tva",
361
+ "e_factura",
362
+ "denumire",
363
+ "adresa",
364
+ "caen"
365
+ ),
366
+ /** Valoarea dinainte (`"da"` / `"nu"` sau textul ANAF); `null` cand nu e cunoscuta. */
367
+ valoareVeche: effect.Schema.NullOr(effect.Schema.String),
368
+ /** Valoarea de acum. */
369
+ valoareNoua: effect.Schema.String,
370
+ /** Data (`yyyy-mm-dd`) de la care se aplica, cand ANAF o da. */
371
+ dataEfect: effect.Schema.NullOr(effect.Schema.String)
372
+ })
373
+ )
374
+ });
375
+ var WebhookFirmaDosarSchema = effect.Schema.Struct({
376
+ /** Numele evenimentului. */
377
+ event: effect.Schema.Literal("firma.dosar"),
378
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
379
+ id: effect.Schema.String,
380
+ /** Cand a fost trimisa notificarea. */
381
+ trimisLa: effect.Schema.Date,
382
+ /** Firma monitorizata. */
383
+ firma: FirmaWebhook,
384
+ /** Dosarul nou. */
385
+ dosar: effect.Schema.Struct({
386
+ /** Numarul dosarului. */
387
+ numar: effect.Schema.String,
388
+ /** Instanta. */
389
+ institutie: effect.Schema.String,
390
+ /** Calitatea firmei in dosar. */
391
+ calitateParte: effect.Schema.NullOr(effect.Schema.String),
392
+ /** Obiectul dosarului. */
393
+ obiect: effect.Schema.NullOr(effect.Schema.String),
394
+ /** Categoria de pe portalul instantelor (ex: Faliment). */
395
+ categorie: effect.Schema.NullOr(effect.Schema.String),
396
+ /**
397
+ * Dosar de insolventa: `debitor` (firma e in procedura), `creditor` (are de
398
+ * recuperat bani in procedura altcuiva), `alta`; `null` pentru alt fel de dosar.
399
+ */
400
+ insolventa: effect.Schema.NullOr(effect.Schema.Literal("debitor", "creditor", "alta"))
401
+ })
402
+ });
403
+ var MarcaWebhook = effect.Schema.Struct({
404
+ /** ID-ul marcii in cont. */
405
+ id: effect.Schema.String,
406
+ /** ID-ul marcii in TMview (oficiul + numarul). */
407
+ st13: effect.Schema.String,
408
+ /** Numele marcii. */
409
+ nume: effect.Schema.String,
410
+ /** `RO` = OSIM, `EM` = EUIPO (marca a Uniunii Europene). */
411
+ oficiu: effect.Schema.Literal("RO", "EM"),
412
+ /** Numarul de depozit. */
413
+ numarDepozit: effect.Schema.String
414
+ });
415
+ var WebhookMarcaSchimbareSchema = effect.Schema.Struct({
416
+ /** Numele evenimentului. */
417
+ event: effect.Schema.Literal("marca.schimbare"),
418
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
419
+ id: effect.Schema.String,
420
+ /** Cand a fost trimisa notificarea. */
421
+ trimisLa: effect.Schema.Date,
422
+ /** Marca urmarita. */
423
+ marca: MarcaWebhook,
424
+ /** Ce s-a schimbat; `inregistrata` = cererea in curs a devenit marca inregistrata. */
425
+ schimbare: effect.Schema.Literal("inregistrata", "reinnoita", "expirata", "anulata", "respinsa", "retrasa", "opozitie"),
426
+ /** La `reinnoita`: vechea data de expirare (`yyyy-mm-dd`); la `opozitie`: numarul vechi de opozitii; altfel statusul vechi. */
427
+ valoareVeche: effect.Schema.String,
428
+ /** Ca `valoareVeche`, valoarea de acum. */
429
+ valoareNoua: effect.Schema.String
430
+ });
431
+ var WebhookMarcaExpiraSchema = effect.Schema.Struct({
432
+ /** Numele evenimentului. */
433
+ event: effect.Schema.Literal("marca.expira"),
434
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
435
+ id: effect.Schema.String,
436
+ /** Cand a fost trimisa notificarea. */
437
+ trimisLa: effect.Schema.Date,
438
+ /** Marca urmarita. */
439
+ marca: MarcaWebhook,
440
+ /** Data expirarii, `yyyy-mm-dd`. */
441
+ expiraLa: effect.Schema.String,
442
+ /** `6l`, `3l`, `1l` (luni), `7z` (zile) inainte; `gratie` = a expirat, se mai poate reinnoi cu taxa. */
443
+ prag: effect.Schema.Literal("6l", "3l", "1l", "7z", "gratie"),
444
+ /** La `gratie`: ultima zi (`yyyy-mm-dd`) in care se mai poate reinnoi; altfel `null`. */
445
+ reinnoirePanaLa: effect.Schema.NullOr(effect.Schema.String)
446
+ });
447
+ var WebhookAsigurareSchimbareSchema = effect.Schema.Struct({
448
+ /** Numele evenimentului. */
449
+ event: effect.Schema.Literal("asigurare.schimbare"),
450
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
451
+ id: effect.Schema.String,
452
+ /** Cand a fost trimisa notificarea. */
453
+ trimisLa: effect.Schema.Date,
454
+ /** Persoana monitorizata. */
455
+ persoana: effect.Schema.Struct({
456
+ /** ID-ul persoanei in cont. */
457
+ id: effect.Schema.String,
458
+ /** Numele persoanei. */
459
+ nume: effect.Schema.String
460
+ }),
461
+ /** Statutul de acum. */
462
+ statut: effect.Schema.Literal("asigurat", "neasigurat", "necunoscut"),
463
+ /** Cardul de sanatate e emis; `null` cand CNAS nu spune. */
464
+ areCard: effect.Schema.NullOr(effect.Schema.Boolean),
465
+ /** Cand a fost interogat CNAS. */
466
+ verificatLa: effect.Schema.Date
467
+ });
468
+ var WebhookTermenExpiraSchema = effect.Schema.Struct({
469
+ /** Numele evenimentului. */
470
+ event: effect.Schema.Literal("termen.expira"),
471
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
472
+ id: effect.Schema.String,
473
+ /** Cand a fost trimisa notificarea. */
474
+ trimisLa: effect.Schema.Date,
475
+ /** Termenul din cont. */
476
+ termen: effect.Schema.Struct({
477
+ /** ID-ul termenului in cont. */
478
+ id: effect.Schema.String,
479
+ /** `auto`, `personale`, `sanatate`, `afaceri` sau `casa`. */
480
+ categorie: effect.Schema.String,
481
+ /** Tipul termenului. */
482
+ tip: effect.Schema.String,
483
+ /** Numele termenului, ex: Pasaport sau numele dat de tine. */
484
+ eticheta: effect.Schema.String,
485
+ /** Al cui e termenul: numarul masinii, firma sau persoana. */
486
+ al: effect.Schema.NullOr(effect.Schema.String),
487
+ /** Data scadentei, `yyyy-mm-dd`. */
488
+ expiraLa: effect.Schema.String
489
+ }),
490
+ /** Zile intregi ramase pana la scadenta. */
491
+ zileRamase: effect.Schema.Number,
492
+ /** Pragul atins, in zile. */
493
+ prag: effect.Schema.Literal(30, 3)
494
+ });
495
+ var WebhookNotificareSchema = effect.Schema.Union(
496
+ WebhookDocumentExpiraSchema,
497
+ WebhookDosarEvenimentSchema,
498
+ WebhookDosarTermenSchema,
499
+ WebhookFirmaSchimbareSchema,
500
+ WebhookFirmaDosarSchema,
501
+ WebhookMarcaSchimbareSchema,
502
+ WebhookMarcaExpiraSchema,
503
+ WebhookAsigurareSchimbareSchema,
504
+ WebhookTermenExpiraSchema,
505
+ WebhookTestSchema
506
+ );
507
+ var DecodareVinSchema = effect.Schema.Struct({
508
+ /** VIN-ul normalizat. */
509
+ vin: effect.Schema.String,
510
+ /** Marca e cunoscuta. */
511
+ gasit: effect.Schema.Boolean,
512
+ /** S-a consumat o cerere din plan: doar cand marca si modelul sunt gasite. */
513
+ taxat: effect.Schema.Boolean,
514
+ /** Marca, cand e gasita. */
515
+ marca: effect.Schema.NullOr(effect.Schema.String),
516
+ /** Modelul, cand e gasit. */
517
+ model: effect.Schema.NullOr(effect.Schema.String),
518
+ /** Anul fabricatiei, cand e cunoscut. */
519
+ anFabricatie: effect.Schema.NullOr(effect.Schema.Number),
520
+ /** De unde vine anul: `pozitia-10` confirmata, startul `generatie` sau `anunturi`. */
521
+ sursaAn: effect.Schema.NullOr(effect.Schema.Literal("pozitia-10", "generatie", "anunturi")),
522
+ /** Modelele posibile, cand sursele nu cad de acord. Mereu gol cand `taxat` e `false`. */
523
+ modelePosibile: effect.Schema.Array(effect.Schema.String),
524
+ /** Structura VIN-ului, calculata doar din cele 17 caractere. */
525
+ structura: effect.Schema.Struct({
526
+ /** Pozitiile 1-3: producatorul. */
527
+ wmi: effect.Schema.String,
528
+ /** Pozitiile 4-9: descrierea vehiculului. */
529
+ vds: effect.Schema.String,
530
+ /** Pozitiile 10-17: exemplarul. */
531
+ vis: effect.Schema.String,
532
+ /** Regiunea producatorului. */
533
+ regiune: effect.Schema.NullOr(effect.Schema.String),
534
+ /** Tara producatorului. */
535
+ tara: effect.Schema.NullOr(effect.Schema.String),
536
+ /** Cifra de control (pozitia 9): `ok`, `gresita` sau `neaplicabila`. */
537
+ cifraControl: effect.Schema.Literal("ok", "gresita", "neaplicabila"),
538
+ /** Cifra de control asteptata, cand se aplica. */
539
+ cifraControlAsteptata: effect.Schema.NullOr(effect.Schema.String),
540
+ /** Anii de fabricatie posibili dupa pozitia 10. */
541
+ aniPosibili: effect.Schema.Array(effect.Schema.Number)
542
+ })
543
+ });
544
+ var NumarDisponibilSchema = effect.Schema.Struct({
545
+ /** Numarul normalizat. */
546
+ numar: effect.Schema.String,
547
+ /** Numarul e liber la DGPCI si poate fi rezervat. */
548
+ disponibil: effect.Schema.Boolean,
549
+ /** Textul intors de DGPCI, cand exista. */
550
+ mesaj: effect.Schema.NullOr(effect.Schema.String)
551
+ });
552
+ var UnghiImagine = effect.Schema.Literal(
553
+ "trei-sferturi",
554
+ "fata",
555
+ "profil",
556
+ "spate",
557
+ "trei-sferturi-dreapta",
558
+ "profil-dreapta"
559
+ );
560
+ var StatusImagine = effect.Schema.Literal("gata", "in-lucru", "necunoscut", "indisponibil");
561
+ var ImagineMasinaSchema = effect.Schema.Struct({
562
+ /** Poza e a masinii cerute; `false` = poza generica (masina sub husa). */
563
+ gata: effect.Schema.Boolean,
564
+ /** Starea pozei. Vezi {@link StatusImagine}. */
565
+ status: StatusImagine,
566
+ /** S-a consumat o cerere din plan: doar cand `status` e `gata`. */
567
+ taxat: effect.Schema.Boolean,
568
+ /** Link semnat spre poza (WebP transparent), valabil pana la `expiraLa`. `null` doar daca nici poza generica nu e disponibila. */
569
+ url: effect.Schema.NullOr(effect.Schema.String),
570
+ /** Cand expira `url`. `null` cand `url` e `null`. */
571
+ expiraLa: DataNullabila,
572
+ /** Unghiul pozei. */
573
+ unghi: UnghiImagine,
574
+ /** Poza are umbra sub masina. */
575
+ umbra: effect.Schema.Boolean,
576
+ /** Latimea pozei, in pixeli. */
577
+ latime: effect.Schema.Number,
578
+ /** Inaltimea pozei, in pixeli. */
579
+ inaltime: effect.Schema.Number,
580
+ /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. */
581
+ marca: effect.Schema.String,
582
+ /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. */
583
+ model: effect.Schema.String,
584
+ /** Generatia aleasa dupa an; `null` cand nu e aleasa inca. */
585
+ generatie: effect.Schema.NullOr(
586
+ effect.Schema.Struct({
587
+ /** Numele generatiei, ex: `Volkswagen Golf VII`. */
588
+ eticheta: effect.Schema.String,
589
+ /** Primul an al generatiei. */
590
+ anDe: effect.Schema.Number,
591
+ /** Ultimul an; `null` = inca in productie. */
592
+ anPana: effect.Schema.NullOr(effect.Schema.Number),
593
+ /** Caroseria, ex: `5-door hatchback`. */
594
+ caroserie: effect.Schema.String
595
+ })
596
+ )
597
+ });
276
598
 
277
599
  // src/internal/http.ts
278
600
  var Setari = class extends effect.Context.Tag("@verificrca/sdk/Setari")() {
@@ -312,6 +634,9 @@ function eroareDinRaspuns(status, headers, body) {
312
634
  switch (status) {
313
635
  case 400:
314
636
  return new EroareValidare({ ...comun, ...c?.accepted && { acceptate: c.accepted } });
637
+ // 422: sursa oficiala refuza valoarea trimisa (ex: NUMAR_RESPINS).
638
+ case 422:
639
+ return new EroareValidare(comun);
315
640
  case 401:
316
641
  return new EroareAutentificare(comun);
317
642
  case 402:
@@ -333,8 +658,11 @@ function eroareDinRaspuns(status, headers, body) {
333
658
  ...c?.monthlyUsage !== void 0 && { utilizareLuna: c.monthlyUsage }
334
659
  });
335
660
  }
336
- default:
337
- return status >= 500 ? new EroareServer(comun) : new EroareHttp(comun);
661
+ default: {
662
+ if (status < 500) return new EroareHttp(comun);
663
+ const retryAfterMs = citesteRetryAfter(headers);
664
+ return new EroareServer({ ...comun, ...retryAfterMs !== void 0 && { retryAfterMs } });
665
+ }
338
666
  }
339
667
  }
340
668
  function construiesteUrl(baseUrl, cerere) {
@@ -347,6 +675,7 @@ function construiesteUrl(baseUrl, cerere) {
347
675
  var trimiteOData = (cerere) => effect.Effect.gen(function* () {
348
676
  const s = yield* Setari;
349
677
  const url = construiesteUrl(s.baseUrl, cerere);
678
+ const timeoutMs = Math.max(s.timeoutMs, cerere.timeoutMinimMs ?? 0);
350
679
  const headers = {
351
680
  Authorization: `Bearer ${s.apiKey}`,
352
681
  Accept: "application/json",
@@ -367,9 +696,9 @@ var trimiteOData = (cerere) => effect.Effect.gen(function* () {
367
696
  })
368
697
  }).pipe(
369
698
  effect.Effect.timeoutFail({
370
- duration: effect.Duration.millis(s.timeoutMs),
699
+ duration: effect.Duration.millis(timeoutMs),
371
700
  onTimeout: () => new EroareRetea({
372
- message: `Cererea ${cerere.metoda} ${cerere.cale} a depasit ${s.timeoutMs} ms.`,
701
+ message: `Cererea ${cerere.metoda} ${cerere.cale} a depasit ${timeoutMs} ms.`,
373
702
  timeout: true
374
703
  })
375
704
  })
@@ -399,7 +728,11 @@ function sePoateReincerca(cerere, eroare2, retry) {
399
728
  case "EroareRetea":
400
729
  return cerere.idempotenta || eroare2.neajunsa === true;
401
730
  case "EroareServer":
402
- return cerere.idempotenta || eroare2.status === 502 || eroare2.status === 503 || eroare2.status === 504;
731
+ if (cerere.idempotenta) return true;
732
+ if (eroare2.cod !== void 0) {
733
+ return eroare2.cod === "OCUPAT" && (eroare2.retryAfterMs ?? 0) <= retry.intarziereMaximaMs;
734
+ }
735
+ return eroare2.status === 502 || eroare2.status === 503 || eroare2.status === 504;
403
736
  case "EroareLimita":
404
737
  return cerere.idempotenta && eroare2.cod === "PREA_MULTE_CERERI" && (eroare2.retryAfterMs ?? 0) <= retry.intarziereMaximaMs;
405
738
  default:
@@ -414,7 +747,7 @@ function politicaRetry(retry) {
414
747
  );
415
748
  return effect.Schedule.intersect(effect.Schedule.identity(), backoff).pipe(
416
749
  effect.Schedule.modifyDelay(
417
- ([eroare2], d) => eroare2._tag === "EroareLimita" && eroare2.retryAfterMs !== void 0 ? effect.Duration.max(d, effect.Duration.millis(eroare2.retryAfterMs)) : d
750
+ ([eroare2], d) => (eroare2._tag === "EroareLimita" || eroare2._tag === "EroareServer") && eroare2.retryAfterMs !== void 0 ? effect.Duration.max(d, effect.Duration.millis(eroare2.retryAfterMs)) : d
418
751
  )
419
752
  );
420
753
  }
@@ -441,6 +774,7 @@ var NUMAR_REGEX = new RegExp(
441
774
  `^(B\\d{2,3}[A-Z]{2,3}|(${JUDETE})\\d{2}[A-Z]{2,3}|CD\\d{3}[A-Z]{1,3}|TC\\d{4}[A-Z]{2})$`,
442
775
  "i"
443
776
  );
777
+ var NUMAR_DGPCI_REGEX = new RegExp(`^(B\\d{2,3}|(${JUDETE})\\d{2})[A-Z]{3}$`, "i");
444
778
  var VIN_REGEX = /^[A-HJ-NPR-Z0-9]{17}$/i;
445
779
  var LUNGIME_VIN = 17;
446
780
  var SERIE_TALON_REGEX = /^(?=.*\d)[A-Z0-9]{6,20}$/;
@@ -587,6 +921,59 @@ function valideazaVehiculNou(vehicul) {
587
921
  ...vehicul.arrMonitorizat !== void 0 && { arrMonitorizat: vehicul.arrMonitorizat }
588
922
  });
589
923
  }
924
+ function valideazaVinDecodare(vin) {
925
+ const n = normalizeaza(typeof vin === "string" ? vin : "");
926
+ return VIN_REGEX.test(n) ? effect.Effect.succeed(n) : effect.Effect.fail(eroare(explicaVin(n), "vin"));
927
+ }
928
+ function valideazaNumarDisponibil(numar) {
929
+ const brut = typeof numar === "string" ? numar : "";
930
+ if (/[?*]/.test(brut)) return effect.Effect.fail(eroare("API-ul verifica un singur numar complet, fara `?` sau `*`.", "numar"));
931
+ const n = normalizeaza(brut);
932
+ if (!n) return effect.Effect.fail(eroare("Lipseste numarul de inmatriculare.", "numar"));
933
+ return NUMAR_DGPCI_REGEX.test(n) ? effect.Effect.succeed(n) : effect.Effect.fail(eroare(`Numarul ${n} nu e complet: trimite indicativul judetului, cifrele si trei litere (ex: BV07ABC).`, "numar"));
934
+ }
935
+ var UNGHIURI_IMAGINE = [
936
+ "trei-sferturi",
937
+ "fata",
938
+ "profil",
939
+ "spate",
940
+ "trei-sferturi-dreapta",
941
+ "profil-dreapta"
942
+ ];
943
+ var TEXT_MASINA_REGEX = /^[\p{L}\p{N} ./+&'()-]+$/u;
944
+ function valideazaTextMasina(valoare, camp) {
945
+ if (typeof valoare !== "string") return eroare(`Trimite \`${camp}\` ca text.`, camp);
946
+ const t = valoare.trim();
947
+ if (!t) return eroare(`\`${camp}\` nu poate fi gol.`, camp);
948
+ if (t.length > 66) return eroare(`\`${camp}\` are cel mult 66 de caractere.`, camp);
949
+ if (!TEXT_MASINA_REGEX.test(t)) {
950
+ return eroare(`\`${camp}\` poate contine doar litere, cifre, spatii si . / + & ' ( ) -`, camp);
951
+ }
952
+ return t;
953
+ }
954
+ function valideazaCerereImagine(cerere) {
955
+ const marca = valideazaTextMasina(cerere?.marca, "marca");
956
+ if (marca instanceof EroareValidare) return effect.Effect.fail(marca);
957
+ const model = valideazaTextMasina(cerere.model, "model");
958
+ if (model instanceof EroareValidare) return effect.Effect.fail(model);
959
+ const anMaxim = (/* @__PURE__ */ new Date()).getFullYear() + 1;
960
+ if (!Number.isInteger(cerere.an) || cerere.an < 1950 || cerere.an > anMaxim) {
961
+ return effect.Effect.fail(eroare(`\`an\` trebuie sa fie un numar intreg intre 1950 si ${anMaxim}.`, "an"));
962
+ }
963
+ if (cerere.unghi !== void 0 && !UNGHIURI_IMAGINE.includes(cerere.unghi)) {
964
+ return effect.Effect.fail(eroare(`\`unghi\` poate fi: ${UNGHIURI_IMAGINE.join(", ")}.`, "unghi", UNGHIURI_IMAGINE));
965
+ }
966
+ if (cerere.umbra !== void 0 && typeof cerere.umbra !== "boolean") {
967
+ return effect.Effect.fail(eroare("Trimite `umbra` ca true sau false.", "umbra"));
968
+ }
969
+ return effect.Effect.succeed({
970
+ marca,
971
+ model,
972
+ an: cerere.an,
973
+ ...cerere.unghi !== void 0 && { unghi: cerere.unghi },
974
+ ...cerere.umbra !== void 0 && { umbra: cerere.umbra }
975
+ });
976
+ }
590
977
 
591
978
  // src/internal/verificari.ts
592
979
  var CALE = "/api/public/v1/verificare";
@@ -722,7 +1109,7 @@ var sterge = (id) => id.trim() ? trimite({ metoda: "DELETE", cale: `${CALE2}/${e
722
1109
  ) : effect.Effect.fail(new EroareValidare({ message: "Lipseste ID-ul vehiculului.", camp: "id", cod: "VALIDARE_LOCALA" }));
723
1110
 
724
1111
  // src/client.ts
725
- var VERSIUNE_SDK = "0.3.0";
1112
+ var VERSIUNE_SDK = "0.4.1";
726
1113
  var URL_IMPLICIT = "https://api.acteo.ro";
727
1114
  var URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
728
1115
  var RETRY_IMPLICIT = { incercari: 3, intarziereInitialaMs: 500, intarziereMaximaMs: 1e4 };
@@ -797,9 +1184,8 @@ var ClientVerificari = class {
797
1184
  /**
798
1185
  * Porneste o verificare si consuma o unitate din cota planului.
799
1186
  *
800
- * Daca vehiculul a fost verificat de curand, primesti imediat rezultatul
801
- * existent. Altfel verificarea intra in
802
- * coada si primesti `status: "processing"`; rezultatul il afli cu
1187
+ * Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
1188
+ * primesti `status: "processing"`; rezultatul il afli cu
803
1189
  * {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
804
1190
  * prin webhook, daca ai trimis `callbackUrl`.
805
1191
  *
@@ -978,8 +1364,62 @@ var VerificRca = class {
978
1364
  this.vehicule = new ClientVehicule(ruleaza2);
979
1365
  }
980
1366
  };
981
- var HEADER_CHEIE_WEBHOOK = "x-verificrca-key";
982
- var HEADER_EVENIMENT_WEBHOOK = "x-verificrca-event";
1367
+ var TIMEOUT_NUMAR_MS = 15e4;
1368
+ var decodeazaVin = (vin) => valideazaVinDecodare(vin).pipe(
1369
+ effect.Effect.flatMap(
1370
+ (v) => trimite({ metoda: "POST", cale: "/api/public/v1/decodare-vin", idempotenta: false, body: { vin: v } })
1371
+ ),
1372
+ effect.Effect.flatMap((r) => decodeaza(DecodareVinSchema)(r).pipe(effect.Effect.map((d) => cuLimite(d, limiteDin(r)))))
1373
+ );
1374
+ var verificaNumar = (numar) => valideazaNumarDisponibil(numar).pipe(
1375
+ effect.Effect.flatMap(
1376
+ (n) => trimite({
1377
+ metoda: "POST",
1378
+ cale: "/api/public/v1/numere-disponibile",
1379
+ idempotenta: false,
1380
+ body: { numar: n },
1381
+ timeoutMinimMs: TIMEOUT_NUMAR_MS
1382
+ })
1383
+ ),
1384
+ effect.Effect.flatMap((r) => decodeaza(NumarDisponibilSchema)(r).pipe(effect.Effect.map((d) => cuLimite(d, limiteDin(r)))))
1385
+ );
1386
+ var imagine = (cerere) => valideazaCerereImagine(cerere).pipe(
1387
+ effect.Effect.flatMap((body) => trimite({ metoda: "POST", cale: "/api/public/v1/imagini-masini", idempotenta: false, body })),
1388
+ effect.Effect.flatMap(
1389
+ (r) => decodeaza(ImagineMasinaSchema)(r).pipe(
1390
+ effect.Effect.map((d) => {
1391
+ const retryAfterMs = d.status === "in-lucru" ? citesteRetryAfter(r.headers) : void 0;
1392
+ return { ...cuLimite(d, limiteDin(r)), ...retryAfterMs !== void 0 && { retryAfterMs } };
1393
+ })
1394
+ )
1395
+ )
1396
+ );
1397
+ var TIMEOUT_IMAGINE_MS = 2 * 6e4;
1398
+ var PAUZA_IMAGINE_MS = 1e4;
1399
+ var imagineAsteptata = (cerere, optiuni = {}) => effect.Effect.gen(function* () {
1400
+ const timeoutMs = optiuni.timeoutMs ?? TIMEOUT_IMAGINE_MS;
1401
+ const termen = Date.now() + timeoutMs;
1402
+ for (; ; ) {
1403
+ const raspuns = yield* imagine(cerere);
1404
+ if (raspuns.status !== "in-lucru") return raspuns;
1405
+ const pauza = Math.max(PAUZA_IMAGINE_MS, raspuns.retryAfterMs ?? 0);
1406
+ if (Date.now() + pauza > termen) {
1407
+ return yield* effect.Effect.fail(
1408
+ new EroareTimeoutVerificare({
1409
+ message: `Poza nu a fost gata in ${timeoutMs} ms. Cere-o din nou mai tarziu.`,
1410
+ cod: "TIMEOUT_IMAGINE"
1411
+ })
1412
+ );
1413
+ }
1414
+ yield* effect.Effect.sleep(effect.Duration.millis(pauza));
1415
+ }
1416
+ });
1417
+ function cuLimite(date, limite) {
1418
+ return limite ? { ...date, limite } : date;
1419
+ }
1420
+ var HEADER_CHEIE_WEBHOOK = "x-acteo-key";
1421
+ var HEADER_EVENIMENT_WEBHOOK = "x-acteo-event";
1422
+ var HEADER_CHEIE_WEBHOOK_VECHI = "x-verificrca-key";
983
1423
  function citesteHeader(headers, nume) {
984
1424
  if (typeof headers.get === "function") return headers.get(nume) ?? void 0;
985
1425
  const obiect = headers;
@@ -1029,10 +1469,10 @@ function verificaWebhookNotificare(corp, headers, optiuni) {
1029
1469
  if (!optiuni.cheie) {
1030
1470
  return yield* effect.Effect.fail(new EroareWebhook({ message: "Lipseste cheia de webhook din optiuni.", cod: "CHEIE_NECONFIGURATA" }));
1031
1471
  }
1032
- const primita = citesteHeader(headers, HEADER_CHEIE_WEBHOOK);
1472
+ const primita = citesteHeader(headers, HEADER_CHEIE_WEBHOOK) ?? citesteHeader(headers, HEADER_CHEIE_WEBHOOK_VECHI);
1033
1473
  if (!primita || !egaleConstant(primita, optiuni.cheie)) {
1034
1474
  return yield* effect.Effect.fail(
1035
- new EroareWebhook({ message: "Cheia din headerul X-Verificrca-Key lipseste sau nu se potriveste.", cod: "CHEIE_INVALIDA" })
1475
+ new EroareWebhook({ message: "Cheia din headerul X-Acteo-Key lipseste sau nu se potriveste.", cod: "CHEIE_INVALIDA" })
1036
1476
  );
1037
1477
  }
1038
1478
  const json = yield* parseazaCorp(corp);
@@ -1056,7 +1496,6 @@ var ClientDocument = class {
1056
1496
  }
1057
1497
  /**
1058
1498
  * Verifica documentul si asteapta rezultatul final de la sursa oficiala.
1059
- * Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
1060
1499
  *
1061
1500
  * @param identificator ce cere sursa oficiala pentru acest document.
1062
1501
  * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
@@ -1073,8 +1512,7 @@ var ClientDocument = class {
1073
1512
  );
1074
1513
  }
1075
1514
  /**
1076
- * Porneste verificarea fara sa astepte. Primesti rezultatul imediat, daca
1077
- * vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
1515
+ * Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
1078
1516
  * afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
1079
1517
  * sau prin webhook la `callbackUrl`.
1080
1518
  *
@@ -1145,6 +1583,96 @@ var MAPARE_ROVINIETA = {
1145
1583
  cerere: (id) => ({ tip: "rovinieta", query: id.numar, serieSasiu: id.vin, serieTalon: id.serieTalon }),
1146
1584
  referinta: (id) => ({ tip: "rovinieta", query: normalizeaza(id.numar), serieSasiu: normalizeaza(id.vin) })
1147
1585
  };
1586
+ var ClientVin = class {
1587
+ #ruleaza;
1588
+ /** @internal */
1589
+ constructor(ruleaza2) {
1590
+ this.#ruleaza = ruleaza2;
1591
+ }
1592
+ /**
1593
+ * Decodeaza un VIN: marca, model, an si structura lui. Consuma din cota doar
1594
+ * cand marca si modelul sunt gasite (`taxat: true`).
1595
+ *
1596
+ * @param vin seria de sasiu, 17 caractere (spatiile si literele mici sunt acceptate).
1597
+ * @param optiuni `signal` pentru anulare.
1598
+ * @returns decodarea, completa, partiala sau doar structura.
1599
+ * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1600
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1601
+ * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1602
+ * @example
1603
+ * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1604
+ * console.log(d.marca, d.model, d.anFabricatie)
1605
+ */
1606
+ decodeaza(vin, optiuni) {
1607
+ return this.#ruleaza(decodeazaVin(vin), optiuni);
1608
+ }
1609
+ };
1610
+ var ClientNumere = class {
1611
+ #ruleaza;
1612
+ /** @internal */
1613
+ constructor(ruleaza2) {
1614
+ this.#ruleaza = ruleaza2;
1615
+ }
1616
+ /**
1617
+ * Verifica la DGPCI daca un numar de inmatriculare e liber. Raspunsul vine
1618
+ * sincron si poate dura pana la doua minute; cererea are un timeout minim
1619
+ * potrivit, oricat de mic e `timeoutMs` din client. Consuma din cota doar cand
1620
+ * DGPCI da un verdict.
1621
+ *
1622
+ * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1623
+ * @param optiuni `signal` pentru anulare.
1624
+ * @returns verdictul DGPCI.
1625
+ * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`NUMAR_RESPINS`).
1626
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1627
+ * @throws {@link EroareLimita} cota atinsa.
1628
+ * @throws {@link EroareServer} `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
1629
+ * @example
1630
+ * const r = await acteo.auto.numere.verifica("BV07ABC")
1631
+ * if (r.disponibil) console.log("Numarul e liber")
1632
+ */
1633
+ verifica(numar, optiuni) {
1634
+ return this.#ruleaza(verificaNumar(numar), optiuni);
1635
+ }
1636
+ };
1637
+ var ClientImagini = class {
1638
+ #ruleaza;
1639
+ /** @internal */
1640
+ constructor(ruleaza2) {
1641
+ this.#ruleaza = ruleaza2;
1642
+ }
1643
+ /**
1644
+ * Cere poza unei masini si raspunde imediat. Cu `status: "gata"` primesti poza
1645
+ * reala si se taxeaza; altfel primesti poza generica (masina sub husa),
1646
+ * netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
1647
+ * {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
1648
+ *
1649
+ * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
1650
+ * @param optiuni `signal` pentru anulare.
1651
+ * @returns poza masinii sau poza generica.
1652
+ * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1653
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1654
+ * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1655
+ * @example
1656
+ * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1657
+ * if (p.status === "gata") afiseaza(p.url)
1658
+ */
1659
+ obtine(cerere, optiuni) {
1660
+ return this.#ruleaza(imagine(cerere), optiuni);
1661
+ }
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, optiuni) {
1673
+ return this.#ruleaza(imagineAsteptata(cerere, optiuni), optiuni);
1674
+ }
1675
+ };
1148
1676
  var ClientAuto = class {
1149
1677
  /** Asigurarea RCA: `acteo.auto.rca.verifica("B123ABC")`. */
1150
1678
  rca;
@@ -1156,6 +1684,12 @@ var ClientAuto = class {
1156
1684
  arr;
1157
1685
  /** Vehiculele monitorizate din cont: `lista()`, `adauga()`, `sterge()`. */
1158
1686
  flota;
1687
+ /** Decodarea VIN: `acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")`. */
1688
+ vin;
1689
+ /** Numere disponibile la DGPCI: `acteo.auto.numere.verifica("BV07ABC")`. */
1690
+ numere;
1691
+ /** Pozele masinilor: `acteo.auto.imagini.obtine({ marca, model, an })`. */
1692
+ imagini;
1159
1693
  /** @internal */
1160
1694
  constructor(ruleaza2) {
1161
1695
  this.rca = new ClientDocument(ruleaza2, MAPARE_RCA);
@@ -1163,6 +1697,9 @@ var ClientAuto = class {
1163
1697
  this.rovinieta = new ClientDocument(ruleaza2, MAPARE_ROVINIETA);
1164
1698
  this.arr = new ClientDocument(ruleaza2, MAPARE_ARR);
1165
1699
  this.flota = new ClientVehicule(ruleaza2);
1700
+ this.vin = new ClientVin(ruleaza2);
1701
+ this.numere = new ClientNumere(ruleaza2);
1702
+ this.imagini = new ClientImagini(ruleaza2);
1166
1703
  }
1167
1704
  };
1168
1705
  var ClientWebhooks = class {
@@ -1177,7 +1714,8 @@ var ClientWebhooks = class {
1177
1714
  return parseazaWebhookRezultat(corp);
1178
1715
  }
1179
1716
  /**
1180
- * Verifica cheia si corpul unui webhook de notificare (ex: `document.expira`).
1717
+ * Verifica cheia si corpul unui webhook de notificare (`document.expira`,
1718
+ * evenimentele celorlalte servicii sau `webhook.test`).
1181
1719
  *
1182
1720
  * @param corp corpul cererii.
1183
1721
  * @param headers headerele cererii.
@@ -1190,7 +1728,7 @@ var ClientWebhooks = class {
1190
1728
  }
1191
1729
  };
1192
1730
  var Acteo = class {
1193
- /** Documentele unei masini (RCA, ITP, rovinieta, ARR) si flota. */
1731
+ /** Documentele unei masini (RCA, ITP, rovinieta, ARR), flota, VIN, numere si poze. */
1194
1732
  auto;
1195
1733
  /** Citirea webhook-urilor. */
1196
1734
  webhooks;
@@ -1212,8 +1750,11 @@ exports.Acteo = Acteo;
1212
1750
  exports.ActeoError = VerificRcaError;
1213
1751
  exports.ClientAuto = ClientAuto;
1214
1752
  exports.ClientDocument = ClientDocument;
1753
+ exports.ClientImagini = ClientImagini;
1754
+ exports.ClientNumere = ClientNumere;
1215
1755
  exports.ClientVehicule = ClientVehicule;
1216
1756
  exports.ClientVerificari = ClientVerificari;
1757
+ exports.ClientVin = ClientVin;
1217
1758
  exports.ClientWebhooks = ClientWebhooks;
1218
1759
  exports.EroareAutentificare = EroareAutentificare;
1219
1760
  exports.EroareConfigurare = EroareConfigurare;
@@ -1233,6 +1774,7 @@ exports.EroareWebhook = EroareWebhook;
1233
1774
  exports.HEADER_CHEIE_WEBHOOK = HEADER_CHEIE_WEBHOOK;
1234
1775
  exports.HEADER_EVENIMENT_WEBHOOK = HEADER_EVENIMENT_WEBHOOK;
1235
1776
  exports.TIPURI_VERIFICARE = TIPURI_VERIFICARE;
1777
+ exports.UNGHIURI_IMAGINE = UNGHIURI_IMAGINE;
1236
1778
  exports.URL_IMPLICIT = URL_IMPLICIT;
1237
1779
  exports.URL_IMPLICIT_LEGACY = URL_IMPLICIT_LEGACY;
1238
1780
  exports.VERSIUNE_SDK = VERSIUNE_SDK;