@acteo/api 0.6.0 → 0.8.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/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## @acteo/api 0.8.0 (2026-11-20)
4
+
5
+ - Verificarea RCA întoarce și asigurătorul: `asigurator` e societatea care a emis polița, așa cum apare la sursa oficială. E `null` la celelalte documente, când nu există poliță valabilă și când numele nu e cunoscut. Apare și în `result` din webhook-ul trimis la `callbackUrl`.
6
+ - `Vehicul` are în plus `rcaAsigurator`, asigurătorul poliței RCA a vehiculului din cont; `null` dacă nu e cunoscut.
7
+ - Un răspuns care nu conține câmpurile se citește cu `null`.
8
+
9
+ ## @acteo/api 0.7.0 (2026-11-19)
10
+
11
+ - `acteo.auto.imagini.obtine()` și `asteapta()` primesc și seria de șasiu: `obtine({ vin: "WVWZZZ1KZBW000000" })`, în loc de `marca`, `model` și `an`. VIN-ul e validat local (17 caractere, fără I, O, Q). Dacă din VIN nu se poate afla mașina primești `EroareValidare` cu `cod: "VIN_NEDECODAT"`, netaxat.
12
+ - Poze în culoarea aleasă: câmpurile `culoare` (slug din paletă, de exemplu `"rosu"`) și `finisaj` (`"matte"`, `"satin"`, `"gloss"`, `"metallic"`). O culoare din afara paletei dă `EroareValidare` cu `cod: "CULOARE_NECUNOSCUTA"`.
13
+ - `acteo.auto.imagini.culori()` întoarce paleta (`slug`, `nume`, `hex`) și finisajele. Nu consumă din cotă.
14
+ - `ImagineMasina` are în plus `culoare` și `finisaj`; sunt `null` când nu le-ai cerut și când răspunsul nu le conține.
15
+ - Tipuri noi: `CerereImagineMasina`, `CerereImagineVin`, `OptiuniImagine`, `FinisajImagine`, `CuloriImagini`. Constantă nouă: `FINISAJE_IMAGINE`. `CerereImagine` e acum una dintre cele două forme; codul care trimite `{ marca, model, an }` merge neschimbat.
16
+
3
17
  ## @acteo/api 0.6.0 (2026-11-19)
4
18
 
5
19
  - `acteo.casa.pad`: verificarea poliței PAD a unei locuințe, după CNP-ul proprietarului și localitate, cu răspunsul de la PADROM. Metodele sunt cele de la documentele auto: `verifica()`, `porneste()` (cu `callbackUrl` opțional), `rezultat()` și `asteapta()`. Cere abonamentul API Verificare poliță PAD și acordul proprietarului (`acord: true`).
package/README.md CHANGED
@@ -48,7 +48,7 @@ Apelurile sunt grupate pe domeniu și pe document, deci citești din cod ce veri
48
48
  | Gestionare flotă | `acteo.auto.flota` | Adaugi, listezi și ștergi vehiculele monitorizate automat |
49
49
  | Decodare VIN | `acteo.auto.vin.decodeaza()` | Marca, modelul, anul de fabricație și structura seriei de șasiu |
50
50
  | Număr de înmatriculare disponibil | `acteo.auto.numere.verifica()` | Dacă numărul e liber la DGPCI și poate fi rezervat |
51
- | Poza unei mașini | `acteo.auto.imagini.obtine()` | Link spre o poză de studio (WebP transparent) după marcă, model și an |
51
+ | Poza unei mașini | `acteo.auto.imagini.obtine()` | Link spre o poză de studio (WebP transparent) după marcă, model și an sau după VIN, în culoarea aleasă |
52
52
  | Verificare poliță PAD | `acteo.casa.pad.verifica()` | Dacă o locuință are poliță PAD valabilă la o dată, după CNP-ul proprietarului și localitate, de la PADROM |
53
53
  | Programări cu remindere | `acteo.programari` | Trimiți programarea unui client, iar el primește remindere pe email cu 7 zile, cu o zi și cu 3 ore înainte; o listezi, o muți sau o anulezi |
54
54
  | Webhook-uri | `acteo.webhooks` | Rezultatul verificării la URL-ul tău, alerte `document.expira` la 30, 14 și 3 zile, plus evenimentele celorlalte servicii din cont |
@@ -92,6 +92,8 @@ if (rca.status === "expired") {
92
92
  }
93
93
  ```
94
94
 
95
+ La RCA primești și asigurătorul: `rca.asigurator` e societatea care a emis polița, așa cum apare la sursa oficială, sau `null` când nu există poliță valabilă ori numele nu e cunoscut.
96
+
95
97
  Un text de 17 caractere fără literele I, O și Q e tratat ca VIN, orice altceva ca număr de înmatriculare. Pentru RCA îți recomandăm să trimiți ambele. Baza AIDA găsește polița mai sigur după seria de șasiu, iar uneori o poliță emisă pe VIN nu apare la căutarea după număr:
96
98
 
97
99
  ```ts
@@ -166,6 +168,12 @@ if (p.status === "gata") afiseaza(p.url) // link valabil până la p.expiraLa
166
168
 
167
169
  // sau așteaptă cât timp poza e încă în lucru:
168
170
  const gata = await acteo.auto.imagini.asteapta({ marca: "Volkswagen", model: "Golf", an: 2015 })
171
+
172
+ // după seria de șasiu, în culoarea și finisajul alese:
173
+ const rosie = await acteo.auto.imagini.obtine({ vin: "WVWZZZ1KZBW000000", culoare: "rosu", finisaj: "metallic" })
174
+
175
+ // culorile din care poți alege:
176
+ const { culori, finisaje } = await acteo.auto.imagini.culori()
169
177
  ```
170
178
 
171
179
  Cu `status: "gata"` primești poza mașinii cerute și cererea se taxează. Altfel primești poza generică (mașina sub husă), netaxată: `in-lucru` înseamnă că poza se generează acum, `necunoscut` că marca sau modelul nu au fost identificate, iar `indisponibil` că generarea a eșuat.
@@ -300,7 +308,7 @@ Face polling până la rezultatul final, cu aceleași opțiuni ca `verifica()`.
300
308
 
301
309
  ### `auto.flota.lista()`
302
310
 
303
- Toate vehiculele din cont, cu datele de expirare `rcaExpiraLa`, `itpExpiraLa`, `rovinietaExpiraLa` și `arrExpiraLa` (ca `Date` sau `null`). Câmpul `activ` e `true` cât timp vehiculul e verificat automat și primește notificări de expirare. `serieTalon` e numărul certificatului de înmatriculare (sau `null`), iar `serieTalonRespinsa` devine `true` când sursa oficială l-a respins; rovinieta nu se mai verifică până nu e corectat. Vehiculele din cont sunt verificate automat și periodic, deci lista îți dă o imagine la zi a flotei fără să consume din cota de verificări.
311
+ Toate vehiculele din cont, cu datele de expirare `rcaExpiraLa`, `itpExpiraLa`, `rovinietaExpiraLa` și `arrExpiraLa` (ca `Date` sau `null`). `rcaAsigurator` e societatea care a emis polița RCA, sau `null` dacă nu e cunoscută. Câmpul `activ` e `true` cât timp vehiculul e verificat automat și primește notificări de expirare. `serieTalon` e numărul certificatului de înmatriculare (sau `null`), iar `serieTalonRespinsa` devine `true` când sursa oficială l-a respins; rovinieta nu se mai verifică până nu e corectat. Vehiculele din cont sunt verificate automat și periodic, deci lista îți dă o imagine la zi a flotei fără să consume din cota de verificări.
304
312
 
305
313
  ### `auto.flota.adauga({ numarInmatriculare?, serieSasiu?, serieTalon?, arrMonitorizat? })`
306
314
 
@@ -330,13 +338,21 @@ Decodează o serie de șasiu. Întoarce `marca`, `model`, `anFabricatie`, `sursa
330
338
 
331
339
  Verifică la DGPCI un singur număr complet: indicativul județului, cifrele și trei litere (`BV07ABC`, `B123ABC`). Numerele incomplete sau cu `?` și `*` sunt respinse local. Întoarce `numar` (normalizat), `disponibil` și `mesaj` (textul DGPCI, sau `null`). Dacă DGPCI nu acceptă numărul primești `EroareValidare` cu `cod: "INVALID_IDENTIFIER"`. Când verificarea nu poate rula primești `EroareServer` cu `cod` `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`. Niciuna nu se taxează, iar `OCUPAT` se reîncearcă singur după `Retry-After`. Cere un abonament de numere disponibile.
332
340
 
333
- ### `auto.imagini.obtine({ marca, model, an, unghi?, umbra? })`
341
+ ### `auto.imagini.obtine({ marca, model, an, unghi?, umbra?, culoare?, finisaj? })`
342
+
343
+ Răspunde imediat cu poza mașinii sau cu poza generică. `unghi` poate fi `"trei-sferturi"` (implicit), `"fata"`, `"profil"`, `"spate"`, `"trei-sferturi-dreapta"` sau `"profil-dreapta"`, iar `umbra` e implicit `true`. Câmpuri: `gata`, `status`, `taxat`, `url`, `expiraLa` (`Date`), `latime`, `inaltime`, `marca` și `model` (forma canonică), `culoare`, `finisaj` și `generatie` (`eticheta`, `anDe`, `anPana`, `caroserie`, sau `null`).
344
+
345
+ În loc de `marca`, `model` și `an` poți trimite `vin` (seria de șasiu, 17 caractere): `obtine({ vin: "WVWZZZ1KZBW000000" })`. Mașina se află din VIN. Trimiți una dintre cele două forme, nu amândouă. Dacă din VIN nu se pot afla marca, modelul și anul, primești `EroareValidare` cu `cod: "VIN_NEDECODAT"`, netaxat, și ceri poza cu `marca`, `model` și `an`. La cererile cu `vin`, `marca`, `model` și `generatie` vin completate doar când poza e gata.
346
+
347
+ `culoare` e un slug din paletă (`"rosu"`, de exemplu), iar `finisaj` poate fi `"matte"`, `"satin"`, `"gloss"` (implicit) sau `"metallic"`. Fără ele primești mașina în griul implicit, iar `culoare` și `finisaj` din răspuns sunt `null`. O culoare din afara paletei dă `EroareValidare` cu `cod: "CULOARE_NECUNOSCUTA"`. Fiecare culoare, finisaj și unghi e o poză separată. La `in-lucru`, `retryAfterMs` spune când să ceri din nou. Linkul expiră după 24 de ore. Fiecare cerere a unei poze gata se taxează, deci păstrează linkul până la `expiraLa`. Cere un abonament de imagini mașini.
348
+
349
+ ### `auto.imagini.asteapta({ marca, model, an, unghi?, umbra?, culoare?, finisaj? }, { timeoutMs? })`
334
350
 
335
- Răspunde imediat cu poza mașinii sau cu poza generică. `unghi` poate fi `"trei-sferturi"` (implicit), `"fata"`, `"profil"`, `"spate"`, `"trei-sferturi-dreapta"` sau `"profil-dreapta"`, iar `umbra` e implicit `true`. Câmpuri: `gata`, `status`, `taxat`, `url`, `expiraLa` (`Date`), `latime`, `inaltime`, `marca` și `model` (forma canonică) și `generatie` (`eticheta`, `anDe`, `anPana`, `caroserie`, sau `null`). La `in-lucru`, `retryAfterMs` spune când să ceri din nou. Linkul expiră după 24 de ore. Fiecare cerere a unei poze gata se taxează, deci păstrează linkul până la `expiraLa`. Cere un abonament de imagini mașini.
351
+ Ca `obtine()`, cu aceleași câmpuri (inclusiv `vin`), dar cât timp poza e `in-lucru` o cere din nou, cu pauzele din `Retry-After` (cel puțin 10 secunde). Întoarce primul răspuns care nu mai e `in-lucru`. După `timeoutMs` (implicit 2 minute) aruncă `EroareTimeoutVerificare`. Cererile intermediare nu se taxează, dar intră în plafonul zilnic de poze generice.
336
352
 
337
- ### `auto.imagini.asteapta({ marca, model, an, unghi?, umbra? }, { timeoutMs? })`
353
+ ### `auto.imagini.culori()`
338
354
 
339
- Ca `obtine()`, dar cât timp poza e `in-lucru` o cere din nou, cu pauzele din `Retry-After` (cel puțin 10 secunde). Întoarce primul răspuns care nu mai e `in-lucru`. După `timeoutMs` (implicit 2 minute) aruncă `EroareTimeoutVerificare`. Cererile intermediare nu se taxează, dar intră în plafonul zilnic de poze generice.
355
+ Întoarce paleta: `culori` (fiecare cu `slug`, `nume` și `hex`) și `finisaje`. `slug` e valoarea pe care o trimiți în `culoare`, iar `hex` te ajută să desenezi un selector de culori. Nu consumă din cotă. Paleta se schimbă rar, deci o poți păstra o oră. Cere un abonament de imagini mașini.
340
356
 
341
357
  ### `casa.pad.verifica(cerere, optiuni?)`
342
358
 
@@ -479,6 +495,7 @@ Le poți folosi pentru formularele tale, ca să validezi datele înainte să aju
479
495
  |---|---|
480
496
  | `TIPURI_VERIFICARE` | `["rca", "itp", "rovinieta", "arr"]`, util pentru dropdown-uri și validare |
481
497
  | `UNGHIURI_IMAGINE` | unghiurile acceptate de `auto.imagini` |
498
+ | `FINISAJE_IMAGINE` | `["matte", "satin", "gloss", "metallic"]`, finisajele acceptate de `auto.imagini` |
482
499
  | `HEADER_CHEIE_WEBHOOK` | `"x-acteo-key"`, headerul cu cheia de webhook |
483
500
  | `HEADER_EVENIMENT_WEBHOOK` | `"x-acteo-event"`, headerul cu numele evenimentului |
484
501
  | `URL_IMPLICIT` | `"https://api.acteo.ro"` |
package/dist/index.cjs CHANGED
@@ -191,6 +191,11 @@ var RezultatVerificareSchema = effect.Schema.Struct({
191
191
  status: StatusDocument,
192
192
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
193
193
  expiresAt: DataNullabila,
194
+ /**
195
+ * Doar la RCA: societatea care a emis polita, cum apare la sursa oficiala. `null` la celelalte
196
+ * documente, cand nu exista polita valabila si cand numele nu e cunoscut.
197
+ */
198
+ asigurator: effect.Schema.optionalWith(effect.Schema.NullOr(effect.Schema.String), { default: () => null }),
194
199
  /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
195
200
  code: effect.Schema.optional(effect.Schema.String),
196
201
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
@@ -241,6 +246,8 @@ var VehiculSchema = effect.Schema.Struct({
241
246
  serieTalonRespinsa: effect.Schema.optionalWith(effect.Schema.Boolean, { default: () => false }),
242
247
  /** Data expirarii RCA, `null` daca nu e cunoscuta inca. */
243
248
  rcaExpiraLa: DataNullabila,
249
+ /** Societatea care a emis polita RCA, cum apare la sursa oficiala. `null` daca nu e cunoscuta. */
250
+ rcaAsigurator: effect.Schema.optionalWith(effect.Schema.NullOr(effect.Schema.String), { default: () => null }),
244
251
  /** Data expirarii ITP, `null` daca nu e cunoscuta inca (ITP-ul cere VIN). */
245
252
  itpExpiraLa: DataNullabila,
246
253
  /** Data expirarii rovinietei, `null` daca nu e cunoscuta inca (rovinieta cere numar, VIN si numarul talonului). */
@@ -646,6 +653,7 @@ var UnghiImagine = effect.Schema.Literal(
646
653
  "trei-sferturi-dreapta",
647
654
  "profil-dreapta"
648
655
  );
656
+ var FinisajImagine = effect.Schema.Literal("matte", "satin", "gloss", "metallic");
649
657
  var StatusImagine = effect.Schema.Literal("gata", "in-lucru", "necunoscut", "indisponibil");
650
658
  var ImagineMasinaSchema = effect.Schema.Struct({
651
659
  /** Poza e a masinii cerute; `false` = poza generica (masina sub husa). */
@@ -666,11 +674,15 @@ var ImagineMasinaSchema = effect.Schema.Struct({
666
674
  latime: effect.Schema.Number,
667
675
  /** Inaltimea pozei, in pixeli. */
668
676
  inaltime: effect.Schema.Number,
669
- /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. */
677
+ /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. Goala la cererile cu `vin` cat timp poza nu e gata. */
670
678
  marca: effect.Schema.String,
671
- /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. */
679
+ /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. Gol la cererile cu `vin` cat timp poza nu e gata. */
672
680
  model: effect.Schema.String,
673
- /** Generatia aleasa dupa an; `null` cand nu e aleasa inca. */
681
+ /** Culoarea pozei (slug din paleta); `null` cand nu ai cerut nici culoare, nici finisaj. */
682
+ culoare: effect.Schema.optionalWith(effect.Schema.NullOr(effect.Schema.String), { default: () => null }),
683
+ /** Finisajul pozei; `null` cand nu ai cerut nici culoare, nici finisaj. */
684
+ finisaj: effect.Schema.optionalWith(effect.Schema.NullOr(FinisajImagine), { default: () => null }),
685
+ /** Generatia aleasa dupa an; `null` cand nu e aleasa inca si la cererile cu `vin` cat timp poza nu e gata. */
674
686
  generatie: effect.Schema.NullOr(
675
687
  effect.Schema.Struct({
676
688
  /** Numele generatiei, ex: `Volkswagen Golf VII`. */
@@ -684,6 +696,21 @@ var ImagineMasinaSchema = effect.Schema.Struct({
684
696
  })
685
697
  )
686
698
  });
699
+ var CuloriImaginiSchema = effect.Schema.Struct({
700
+ /** Culorile din paleta, in ordinea ei. */
701
+ culori: effect.Schema.Array(
702
+ effect.Schema.Struct({
703
+ /** Valoarea pe care o trimiti in `culoare`, ex: `rosu`. */
704
+ slug: effect.Schema.String,
705
+ /** Numele culorii, de afisat. */
706
+ nume: effect.Schema.String,
707
+ /** Culoarea ca hex, ex: `#c1121f`, pentru un selector de culori. */
708
+ hex: effect.Schema.String
709
+ })
710
+ ),
711
+ /** Finisajele acceptate in `finisaj`. Text simplu, ca un finisaj nou sa nu strice citirea paletei. */
712
+ finisaje: effect.Schema.Array(effect.Schema.String)
713
+ });
687
714
  var CampuriPolitaPad = {
688
715
  /** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
689
716
  requestId: effect.Schema.String,
@@ -1145,6 +1172,7 @@ var UNGHIURI_IMAGINE = [
1145
1172
  "trei-sferturi-dreapta",
1146
1173
  "profil-dreapta"
1147
1174
  ];
1175
+ var FINISAJE_IMAGINE = ["matte", "satin", "gloss", "metallic"];
1148
1176
  var TEXT_MASINA_REGEX = /^[\p{L}\p{N} ./+&'()-]+$/u;
1149
1177
  function valideazaTextMasina(valoare, camp) {
1150
1178
  if (typeof valoare !== "string") return eroare(`Trimite \`${camp}\` ca text.`, camp);
@@ -1156,27 +1184,47 @@ function valideazaTextMasina(valoare, camp) {
1156
1184
  }
1157
1185
  return t;
1158
1186
  }
1159
- function valideazaCerereImagine(cerere) {
1187
+ var CULOARE_REGEX = /^[a-z0-9-]{2,40}$/;
1188
+ function valideazaMasinaImagine(cerere) {
1189
+ if (cerere?.vin !== void 0) {
1190
+ if (cerere.marca !== void 0 || cerere.model !== void 0 || cerere.an !== void 0) {
1191
+ return eroare("Trimite fie `vin`, fie `marca`, `model` si `an`, nu amandoua.", "vin");
1192
+ }
1193
+ const vin = normalizeaza(typeof cerere.vin === "string" ? cerere.vin : "");
1194
+ return VIN_REGEX.test(vin) ? { vin } : eroare(explicaVin(vin), "vin");
1195
+ }
1160
1196
  const marca = valideazaTextMasina(cerere?.marca, "marca");
1161
- if (marca instanceof EroareValidare) return effect.Effect.fail(marca);
1197
+ if (marca instanceof EroareValidare) return marca;
1162
1198
  const model = valideazaTextMasina(cerere.model, "model");
1163
- if (model instanceof EroareValidare) return effect.Effect.fail(model);
1199
+ if (model instanceof EroareValidare) return model;
1164
1200
  const anMaxim = (/* @__PURE__ */ new Date()).getFullYear() + 1;
1165
- if (!Number.isInteger(cerere.an) || cerere.an < 1950 || cerere.an > anMaxim) {
1166
- return effect.Effect.fail(eroare(`\`an\` trebuie sa fie un numar intreg intre 1950 si ${anMaxim}.`, "an"));
1201
+ const an = cerere.an;
1202
+ if (typeof an !== "number" || !Number.isInteger(an) || an < 1950 || an > anMaxim) {
1203
+ return eroare(`\`an\` trebuie sa fie un numar intreg intre 1950 si ${anMaxim}.`, "an");
1167
1204
  }
1205
+ return { marca, model, an };
1206
+ }
1207
+ function valideazaCerereImagine(cerere) {
1208
+ const masina = valideazaMasinaImagine(cerere);
1209
+ if (masina instanceof EroareValidare) return effect.Effect.fail(masina);
1168
1210
  if (cerere.unghi !== void 0 && !UNGHIURI_IMAGINE.includes(cerere.unghi)) {
1169
1211
  return effect.Effect.fail(eroare(`\`unghi\` poate fi: ${UNGHIURI_IMAGINE.join(", ")}.`, "unghi", UNGHIURI_IMAGINE));
1170
1212
  }
1171
1213
  if (cerere.umbra !== void 0 && typeof cerere.umbra !== "boolean") {
1172
1214
  return effect.Effect.fail(eroare("Trimite `umbra` ca true sau false.", "umbra"));
1173
1215
  }
1216
+ if (cerere.culoare !== void 0 && (typeof cerere.culoare !== "string" || !CULOARE_REGEX.test(cerere.culoare))) {
1217
+ return effect.Effect.fail(eroare("`culoare` e un slug din paleta, ex: `rosu`. Lista o da `auto.imagini.culori()`.", "culoare"));
1218
+ }
1219
+ if (cerere.finisaj !== void 0 && !FINISAJE_IMAGINE.includes(cerere.finisaj)) {
1220
+ return effect.Effect.fail(eroare(`\`finisaj\` poate fi: ${FINISAJE_IMAGINE.join(", ")}.`, "finisaj", FINISAJE_IMAGINE));
1221
+ }
1174
1222
  return effect.Effect.succeed({
1175
- marca,
1176
- model,
1177
- an: cerere.an,
1223
+ ...masina,
1178
1224
  ...cerere.unghi !== void 0 && { unghi: cerere.unghi },
1179
- ...cerere.umbra !== void 0 && { umbra: cerere.umbra }
1225
+ ...cerere.umbra !== void 0 && { umbra: cerere.umbra },
1226
+ ...cerere.culoare !== void 0 && { culoare: cerere.culoare },
1227
+ ...cerere.finisaj !== void 0 && { finisaj: cerere.finisaj }
1180
1228
  });
1181
1229
  }
1182
1230
  var PONDERI_CNP = [2, 7, 9, 1, 4, 6, 3, 5, 8, 2, 7, 9];
@@ -1368,7 +1416,7 @@ var sterge = (id) => id.trim() ? trimite({ metoda: "DELETE", cale: `${CALE2}/${e
1368
1416
  ) : effect.Effect.fail(new EroareValidare({ message: "Lipseste ID-ul vehiculului.", camp: "id", cod: "VALIDARE_LOCALA" }));
1369
1417
 
1370
1418
  // src/client.ts
1371
- var VERSIUNE_SDK = "0.6.0";
1419
+ var VERSIUNE_SDK = "0.8.0";
1372
1420
  var URL_IMPLICIT = "https://api.acteo.ro";
1373
1421
  var URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
1374
1422
  var RETRY_IMPLICIT = { incercari: 3, intarziereInitialaMs: 500, intarziereMaximaMs: 1e4 };
@@ -1705,6 +1753,11 @@ var imagine = (cerere) => valideazaCerereImagine(cerere).pipe(
1705
1753
  )
1706
1754
  )
1707
1755
  );
1756
+ var culoriImagini = trimite({
1757
+ metoda: "GET",
1758
+ cale: "/api/public/v1/imagini-masini/culori",
1759
+ idempotenta: true
1760
+ }).pipe(effect.Effect.flatMap(decodeaza(CuloriImaginiSchema)));
1708
1761
  var TIMEOUT_IMAGINE_MS = 2 * 6e4;
1709
1762
  var PAUZA_IMAGINE_MS = 1e4;
1710
1763
  var imagineAsteptata = (cerere, optiuni = {}) => effect.Effect.gen(function* () {
@@ -2023,15 +2076,17 @@ var ClientImagini = class {
2023
2076
  * netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
2024
2077
  * {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
2025
2078
  *
2026
- * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
2079
+ * @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
2027
2080
  * @param optiuni `signal` pentru anulare.
2028
2081
  * @returns poza masinii sau poza generica.
2029
- * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
2082
+ * @throws {@link EroareValidare} un camp invalid, culoare din afara paletei (`CULOARE_NECUNOSCUTA`) sau VIN din care nu se afla masina (`VIN_NEDECODAT`, netaxat).
2030
2083
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
2031
2084
  * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
2032
2085
  * @example
2033
2086
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
2034
2087
  * if (p.status === "gata") afiseaza(p.url)
2088
+ * @example
2089
+ * const rosie = await acteo.auto.imagini.obtine({ vin: "WVWZZZ1KZBW000000", culoare: "rosu", finisaj: "metallic" })
2035
2090
  */
2036
2091
  obtine(cerere, optiuni) {
2037
2092
  return this.#ruleaza(imagine(cerere), optiuni);
@@ -2041,7 +2096,7 @@ var ClientImagini = class {
2041
2096
  * nou, cu pauzele din `Retry-After`. Fiecare cerere intermediara e netaxata,
2042
2097
  * dar intra in plafonul zilnic de poze generice.
2043
2098
  *
2044
- * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
2099
+ * @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
2045
2100
  * @param optiuni `timeoutMs` (implicit 2 minute) si `signal`.
2046
2101
  * @returns poza cu orice status in afara de `"in-lucru"`.
2047
2102
  * @throws {@link EroareTimeoutVerificare} poza nu a fost gata in `timeoutMs`.
@@ -2049,6 +2104,20 @@ var ClientImagini = class {
2049
2104
  asteapta(cerere, optiuni) {
2050
2105
  return this.#ruleaza(imagineAsteptata(cerere, optiuni), optiuni);
2051
2106
  }
2107
+ /**
2108
+ * Paleta de culori si finisajele pe care le poti cere in `culoare` si
2109
+ * `finisaj`. Nu consuma din cota. Lista se schimba rar: o poti pastra o ora.
2110
+ *
2111
+ * @param optiuni `signal` pentru anulare.
2112
+ * @returns `culori` (`slug`, `nume`, `hex`) si `finisaje`.
2113
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
2114
+ * @example
2115
+ * const { culori } = await acteo.auto.imagini.culori()
2116
+ * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015, culoare: culori[0].slug })
2117
+ */
2118
+ culori(optiuni) {
2119
+ return this.#ruleaza(culoriImagini, optiuni);
2120
+ }
2052
2121
  };
2053
2122
  var ClientAuto = class {
2054
2123
  /** Asigurarea RCA: `acteo.auto.rca.verifica("B123ABC")`. */
@@ -2347,6 +2416,7 @@ exports.EroareTimeoutVerificare = EroareTimeoutVerificare;
2347
2416
  exports.EroareValidare = EroareValidare;
2348
2417
  exports.EroareVerificare = EroareVerificare;
2349
2418
  exports.EroareWebhook = EroareWebhook;
2419
+ exports.FINISAJE_IMAGINE = FINISAJE_IMAGINE;
2350
2420
  exports.HEADER_CHEIE_WEBHOOK = HEADER_CHEIE_WEBHOOK;
2351
2421
  exports.HEADER_EVENIMENT_WEBHOOK = HEADER_EVENIMENT_WEBHOOK;
2352
2422
  exports.TIPURI_VERIFICARE = TIPURI_VERIFICARE;