@acteo/api 0.3.0 → 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.
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)`. */
@@ -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.0";
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 };
@@ -978,8 +1365,62 @@ var VerificRca = class {
978
1365
  this.vehicule = new ClientVehicule(ruleaza2);
979
1366
  }
980
1367
  };
981
- var HEADER_CHEIE_WEBHOOK = "x-verificrca-key";
982
- var HEADER_EVENIMENT_WEBHOOK = "x-verificrca-event";
1368
+ var TIMEOUT_NUMAR_MS = 15e4;
1369
+ var decodeazaVin = (vin) => valideazaVinDecodare(vin).pipe(
1370
+ effect.Effect.flatMap(
1371
+ (v) => trimite({ metoda: "POST", cale: "/api/public/v1/decodare-vin", idempotenta: false, body: { vin: v } })
1372
+ ),
1373
+ effect.Effect.flatMap((r) => decodeaza(DecodareVinSchema)(r).pipe(effect.Effect.map((d) => cuLimite(d, limiteDin(r)))))
1374
+ );
1375
+ var verificaNumar = (numar) => valideazaNumarDisponibil(numar).pipe(
1376
+ effect.Effect.flatMap(
1377
+ (n) => trimite({
1378
+ metoda: "POST",
1379
+ cale: "/api/public/v1/numere-disponibile",
1380
+ idempotenta: false,
1381
+ body: { numar: n },
1382
+ timeoutMinimMs: TIMEOUT_NUMAR_MS
1383
+ })
1384
+ ),
1385
+ effect.Effect.flatMap((r) => decodeaza(NumarDisponibilSchema)(r).pipe(effect.Effect.map((d) => cuLimite(d, limiteDin(r)))))
1386
+ );
1387
+ var imagine = (cerere) => valideazaCerereImagine(cerere).pipe(
1388
+ effect.Effect.flatMap((body) => trimite({ metoda: "POST", cale: "/api/public/v1/imagini-masini", idempotenta: false, body })),
1389
+ effect.Effect.flatMap(
1390
+ (r) => decodeaza(ImagineMasinaSchema)(r).pipe(
1391
+ effect.Effect.map((d) => {
1392
+ const retryAfterMs = d.status === "in-lucru" ? citesteRetryAfter(r.headers) : void 0;
1393
+ return { ...cuLimite(d, limiteDin(r)), ...retryAfterMs !== void 0 && { retryAfterMs } };
1394
+ })
1395
+ )
1396
+ )
1397
+ );
1398
+ var TIMEOUT_IMAGINE_MS = 2 * 6e4;
1399
+ var PAUZA_IMAGINE_MS = 1e4;
1400
+ var imagineAsteptata = (cerere, optiuni = {}) => effect.Effect.gen(function* () {
1401
+ const timeoutMs = optiuni.timeoutMs ?? TIMEOUT_IMAGINE_MS;
1402
+ const termen = Date.now() + timeoutMs;
1403
+ for (; ; ) {
1404
+ const raspuns = yield* imagine(cerere);
1405
+ if (raspuns.status !== "in-lucru") return raspuns;
1406
+ const pauza = Math.max(PAUZA_IMAGINE_MS, raspuns.retryAfterMs ?? 0);
1407
+ if (Date.now() + pauza > termen) {
1408
+ return yield* effect.Effect.fail(
1409
+ new EroareTimeoutVerificare({
1410
+ message: `Poza nu a fost gata in ${timeoutMs} ms. Cere-o din nou mai tarziu.`,
1411
+ cod: "TIMEOUT_IMAGINE"
1412
+ })
1413
+ );
1414
+ }
1415
+ yield* effect.Effect.sleep(effect.Duration.millis(pauza));
1416
+ }
1417
+ });
1418
+ function cuLimite(date, limite) {
1419
+ return limite ? { ...date, limite } : date;
1420
+ }
1421
+ var HEADER_CHEIE_WEBHOOK = "x-acteo-key";
1422
+ var HEADER_EVENIMENT_WEBHOOK = "x-acteo-event";
1423
+ var HEADER_CHEIE_WEBHOOK_VECHI = "x-verificrca-key";
983
1424
  function citesteHeader(headers, nume) {
984
1425
  if (typeof headers.get === "function") return headers.get(nume) ?? void 0;
985
1426
  const obiect = headers;
@@ -1029,10 +1470,10 @@ function verificaWebhookNotificare(corp, headers, optiuni) {
1029
1470
  if (!optiuni.cheie) {
1030
1471
  return yield* effect.Effect.fail(new EroareWebhook({ message: "Lipseste cheia de webhook din optiuni.", cod: "CHEIE_NECONFIGURATA" }));
1031
1472
  }
1032
- const primita = citesteHeader(headers, HEADER_CHEIE_WEBHOOK);
1473
+ const primita = citesteHeader(headers, HEADER_CHEIE_WEBHOOK) ?? citesteHeader(headers, HEADER_CHEIE_WEBHOOK_VECHI);
1033
1474
  if (!primita || !egaleConstant(primita, optiuni.cheie)) {
1034
1475
  return yield* effect.Effect.fail(
1035
- new EroareWebhook({ message: "Cheia din headerul X-Verificrca-Key lipseste sau nu se potriveste.", cod: "CHEIE_INVALIDA" })
1476
+ new EroareWebhook({ message: "Cheia din headerul X-Acteo-Key lipseste sau nu se potriveste.", cod: "CHEIE_INVALIDA" })
1036
1477
  );
1037
1478
  }
1038
1479
  const json = yield* parseazaCorp(corp);
@@ -1145,6 +1586,96 @@ var MAPARE_ROVINIETA = {
1145
1586
  cerere: (id) => ({ tip: "rovinieta", query: id.numar, serieSasiu: id.vin, serieTalon: id.serieTalon }),
1146
1587
  referinta: (id) => ({ tip: "rovinieta", query: normalizeaza(id.numar), serieSasiu: normalizeaza(id.vin) })
1147
1588
  };
1589
+ var ClientVin = class {
1590
+ #ruleaza;
1591
+ /** @internal */
1592
+ constructor(ruleaza2) {
1593
+ this.#ruleaza = ruleaza2;
1594
+ }
1595
+ /**
1596
+ * Decodeaza un VIN: marca, model, an si structura lui. Consuma din cota doar
1597
+ * cand marca si modelul sunt gasite (`taxat: true`).
1598
+ *
1599
+ * @param vin seria de sasiu, 17 caractere (spatiile si literele mici sunt acceptate).
1600
+ * @param optiuni `signal` pentru anulare.
1601
+ * @returns decodarea, completa, partiala sau doar structura.
1602
+ * @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
1603
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
1604
+ * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
1605
+ * @example
1606
+ * const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
1607
+ * console.log(d.marca, d.model, d.anFabricatie)
1608
+ */
1609
+ decodeaza(vin, optiuni) {
1610
+ return this.#ruleaza(decodeazaVin(vin), optiuni);
1611
+ }
1612
+ };
1613
+ var ClientNumere = class {
1614
+ #ruleaza;
1615
+ /** @internal */
1616
+ constructor(ruleaza2) {
1617
+ this.#ruleaza = ruleaza2;
1618
+ }
1619
+ /**
1620
+ * Verifica la DGPCI daca un numar de inmatriculare e liber. Raspunsul vine
1621
+ * sincron si poate dura pana la doua minute; cererea are un timeout minim
1622
+ * potrivit, oricat de mic e `timeoutMs` din client. Consuma din cota doar cand
1623
+ * DGPCI da un verdict.
1624
+ *
1625
+ * @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
1626
+ * @param optiuni `signal` pentru anulare.
1627
+ * @returns verdictul DGPCI.
1628
+ * @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`NUMAR_RESPINS`).
1629
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
1630
+ * @throws {@link EroareLimita} cota atinsa.
1631
+ * @throws {@link EroareServer} `OCUPAT`, `INDISPONIBIL`, `EROARE_DGPCI` sau `TIMEOUT`; cererea nu s-a taxat.
1632
+ * @example
1633
+ * const r = await acteo.auto.numere.verifica("BV07ABC")
1634
+ * if (r.disponibil) console.log("Numarul e liber")
1635
+ */
1636
+ verifica(numar, optiuni) {
1637
+ return this.#ruleaza(verificaNumar(numar), optiuni);
1638
+ }
1639
+ };
1640
+ var ClientImagini = class {
1641
+ #ruleaza;
1642
+ /** @internal */
1643
+ constructor(ruleaza2) {
1644
+ this.#ruleaza = ruleaza2;
1645
+ }
1646
+ /**
1647
+ * Cere poza unei masini si raspunde imediat. Cu `status: "gata"` primesti poza
1648
+ * reala si se taxeaza; altfel primesti poza generica (masina sub husa),
1649
+ * netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
1650
+ * {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
1651
+ *
1652
+ * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
1653
+ * @param optiuni `signal` pentru anulare.
1654
+ * @returns poza masinii sau poza generica.
1655
+ * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
1656
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
1657
+ * @throws {@link EroareLimita} cota atinsa (`LIMIT_ATINS`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
1658
+ * @example
1659
+ * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
1660
+ * if (p.status === "gata") afiseaza(p.url)
1661
+ */
1662
+ obtine(cerere, optiuni) {
1663
+ return this.#ruleaza(imagine(cerere), optiuni);
1664
+ }
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, optiuni) {
1676
+ return this.#ruleaza(imagineAsteptata(cerere, optiuni), optiuni);
1677
+ }
1678
+ };
1148
1679
  var ClientAuto = class {
1149
1680
  /** Asigurarea RCA: `acteo.auto.rca.verifica("B123ABC")`. */
1150
1681
  rca;
@@ -1156,6 +1687,12 @@ var ClientAuto = class {
1156
1687
  arr;
1157
1688
  /** Vehiculele monitorizate din cont: `lista()`, `adauga()`, `sterge()`. */
1158
1689
  flota;
1690
+ /** Decodarea VIN: `acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")`. */
1691
+ vin;
1692
+ /** Numere disponibile la DGPCI: `acteo.auto.numere.verifica("BV07ABC")`. */
1693
+ numere;
1694
+ /** Pozele masinilor: `acteo.auto.imagini.obtine({ marca, model, an })`. */
1695
+ imagini;
1159
1696
  /** @internal */
1160
1697
  constructor(ruleaza2) {
1161
1698
  this.rca = new ClientDocument(ruleaza2, MAPARE_RCA);
@@ -1163,6 +1700,9 @@ var ClientAuto = class {
1163
1700
  this.rovinieta = new ClientDocument(ruleaza2, MAPARE_ROVINIETA);
1164
1701
  this.arr = new ClientDocument(ruleaza2, MAPARE_ARR);
1165
1702
  this.flota = new ClientVehicule(ruleaza2);
1703
+ this.vin = new ClientVin(ruleaza2);
1704
+ this.numere = new ClientNumere(ruleaza2);
1705
+ this.imagini = new ClientImagini(ruleaza2);
1166
1706
  }
1167
1707
  };
1168
1708
  var ClientWebhooks = class {
@@ -1177,7 +1717,8 @@ var ClientWebhooks = class {
1177
1717
  return parseazaWebhookRezultat(corp);
1178
1718
  }
1179
1719
  /**
1180
- * Verifica cheia si corpul unui webhook de notificare (ex: `document.expira`).
1720
+ * Verifica cheia si corpul unui webhook de notificare (`document.expira`,
1721
+ * evenimentele celorlalte servicii sau `webhook.test`).
1181
1722
  *
1182
1723
  * @param corp corpul cererii.
1183
1724
  * @param headers headerele cererii.
@@ -1190,7 +1731,7 @@ var ClientWebhooks = class {
1190
1731
  }
1191
1732
  };
1192
1733
  var Acteo = class {
1193
- /** Documentele unei masini (RCA, ITP, rovinieta, ARR) si flota. */
1734
+ /** Documentele unei masini (RCA, ITP, rovinieta, ARR), flota, VIN, numere si poze. */
1194
1735
  auto;
1195
1736
  /** Citirea webhook-urilor. */
1196
1737
  webhooks;
@@ -1212,8 +1753,11 @@ exports.Acteo = Acteo;
1212
1753
  exports.ActeoError = VerificRcaError;
1213
1754
  exports.ClientAuto = ClientAuto;
1214
1755
  exports.ClientDocument = ClientDocument;
1756
+ exports.ClientImagini = ClientImagini;
1757
+ exports.ClientNumere = ClientNumere;
1215
1758
  exports.ClientVehicule = ClientVehicule;
1216
1759
  exports.ClientVerificari = ClientVerificari;
1760
+ exports.ClientVin = ClientVin;
1217
1761
  exports.ClientWebhooks = ClientWebhooks;
1218
1762
  exports.EroareAutentificare = EroareAutentificare;
1219
1763
  exports.EroareConfigurare = EroareConfigurare;
@@ -1233,6 +1777,7 @@ exports.EroareWebhook = EroareWebhook;
1233
1777
  exports.HEADER_CHEIE_WEBHOOK = HEADER_CHEIE_WEBHOOK;
1234
1778
  exports.HEADER_EVENIMENT_WEBHOOK = HEADER_EVENIMENT_WEBHOOK;
1235
1779
  exports.TIPURI_VERIFICARE = TIPURI_VERIFICARE;
1780
+ exports.UNGHIURI_IMAGINE = UNGHIURI_IMAGINE;
1236
1781
  exports.URL_IMPLICIT = URL_IMPLICIT;
1237
1782
  exports.URL_IMPLICIT_LEGACY = URL_IMPLICIT_LEGACY;
1238
1783
  exports.VERSIUNE_SDK = VERSIUNE_SDK;