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