@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/dist/index.d.cts CHANGED
@@ -63,6 +63,13 @@ declare const RezultatVerificareSchema: Schema.Struct<{
63
63
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
64
64
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
65
65
  expiresAt: Schema.NullOr<typeof Schema.Date>;
66
+ /**
67
+ * Doar la RCA: societatea care a emis polita, cum apare la sursa oficiala. `null` la celelalte
68
+ * documente, cand nu exista polita valabila si cand numele nu e cunoscut.
69
+ */
70
+ asigurator: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
71
+ default: () => null;
72
+ }>;
66
73
  /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
67
74
  code: Schema.optional<typeof Schema.String>;
68
75
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
@@ -97,6 +104,10 @@ declare const VehiculSchema: Schema.Struct<{
97
104
  }>;
98
105
  /** Data expirarii RCA, `null` daca nu e cunoscuta inca. */
99
106
  rcaExpiraLa: Schema.NullOr<typeof Schema.Date>;
107
+ /** Societatea care a emis polita RCA, cum apare la sursa oficiala. `null` daca nu e cunoscuta. */
108
+ rcaAsigurator: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
109
+ default: () => null;
110
+ }>;
100
111
  /** Data expirarii ITP, `null` daca nu e cunoscuta inca (ITP-ul cere VIN). */
101
112
  itpExpiraLa: Schema.NullOr<typeof Schema.Date>;
102
113
  /** Data expirarii rovinietei, `null` daca nu e cunoscuta inca (rovinieta cere numar, VIN si numarul talonului). */
@@ -140,6 +151,13 @@ declare const WebhookRezultatSchema: Schema.Struct<{
140
151
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
141
152
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
142
153
  expiresAt: Schema.NullOr<typeof Schema.Date>;
154
+ /**
155
+ * Doar la RCA: societatea care a emis polita, cum apare la sursa oficiala. `null` la celelalte
156
+ * documente, cand nu exista polita valabila si cand numele nu e cunoscut.
157
+ */
158
+ asigurator: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
159
+ default: () => null;
160
+ }>;
143
161
  /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
144
162
  code: Schema.optional<typeof Schema.String>;
145
163
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
@@ -862,6 +880,10 @@ declare const NumarDisponibilSchema: Schema.Struct<{
862
880
  declare const UnghiImagine: Schema.Literal<["trei-sferturi", "fata", "profil", "spate", "trei-sferturi-dreapta", "profil-dreapta"]>;
863
881
  /** Unghiul pozei: `"trei-sferturi"` (implicit), `"fata"`, `"profil"`, `"spate"`, `"trei-sferturi-dreapta"`, `"profil-dreapta"`. */
864
882
  type UnghiImagine = typeof UnghiImagine.Type;
883
+ /** Finisajele vopselei. */
884
+ declare const FinisajImagine: Schema.Literal<["matte", "satin", "gloss", "metallic"]>;
885
+ /** Finisajul vopselei: `"matte"`, `"satin"`, `"gloss"` (implicit) sau `"metallic"`. */
886
+ type FinisajImagine = typeof FinisajImagine.Type;
865
887
  /**
866
888
  * Starea pozei:
867
889
  * - `gata`: poza masinii cerute (se taxeaza);
@@ -893,11 +915,19 @@ declare const ImagineMasinaSchema: Schema.Struct<{
893
915
  latime: typeof Schema.Number;
894
916
  /** Inaltimea pozei, in pixeli. */
895
917
  inaltime: typeof Schema.Number;
896
- /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. */
918
+ /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. Goala la cererile cu `vin` cat timp poza nu e gata. */
897
919
  marca: typeof Schema.String;
898
- /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. */
920
+ /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. Gol la cererile cu `vin` cat timp poza nu e gata. */
899
921
  model: typeof Schema.String;
900
- /** Generatia aleasa dupa an; `null` cand nu e aleasa inca. */
922
+ /** Culoarea pozei (slug din paleta); `null` cand nu ai cerut nici culoare, nici finisaj. */
923
+ culoare: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
924
+ default: () => null;
925
+ }>;
926
+ /** Finisajul pozei; `null` cand nu ai cerut nici culoare, nici finisaj. */
927
+ finisaj: Schema.optionalWith<Schema.NullOr<Schema.Literal<["matte", "satin", "gloss", "metallic"]>>, {
928
+ default: () => null;
929
+ }>;
930
+ /** Generatia aleasa dupa an; `null` cand nu e aleasa inca si la cererile cu `vin` cat timp poza nu e gata. */
901
931
  generatie: Schema.NullOr<Schema.Struct<{
902
932
  /** Numele generatiei, ex: `Volkswagen Golf VII`. */
903
933
  eticheta: typeof Schema.String;
@@ -909,6 +939,21 @@ declare const ImagineMasinaSchema: Schema.Struct<{
909
939
  caroserie: typeof Schema.String;
910
940
  }>>;
911
941
  }>;
942
+ declare const CuloriImaginiSchema: Schema.Struct<{
943
+ /** Culorile din paleta, in ordinea ei. */
944
+ culori: Schema.Array$<Schema.Struct<{
945
+ /** Valoarea pe care o trimiti in `culoare`, ex: `rosu`. */
946
+ slug: typeof Schema.String;
947
+ /** Numele culorii, de afisat. */
948
+ nume: typeof Schema.String;
949
+ /** Culoarea ca hex, ex: `#c1121f`, pentru un selector de culori. */
950
+ hex: typeof Schema.String;
951
+ }>>;
952
+ /** Finisajele acceptate in `finisaj`. Text simplu, ca un finisaj nou sa nu strice citirea paletei. */
953
+ finisaje: Schema.Array$<typeof Schema.String>;
954
+ }>;
955
+ /** Paleta de culori si finisajele pozelor. */
956
+ type CuloriImagini = typeof CuloriImaginiSchema.Type;
912
957
  declare const PolitaPadPornitaSchema: Schema.Struct<{
913
958
  /** Mereu `"processing"`: PADROM e interogat acum. */
914
959
  status: Schema.Literal<["processing"]>;
@@ -1539,19 +1584,43 @@ interface VehiculNou {
1539
1584
  }
1540
1585
  /** Unghiurile acceptate pentru poza unei masini. */
1541
1586
  declare const UNGHIURI_IMAGINE: readonly UnghiImagine[];
1542
- /** Masina pentru care ceri poza. */
1543
- interface CerereImagine {
1587
+ /** Finisajele acceptate pentru vopseaua din poza. */
1588
+ declare const FINISAJE_IMAGINE: readonly FinisajImagine[];
1589
+ /** Cum arata poza: aceleasi optiuni, oricum ai numi masina. */
1590
+ interface OptiuniImagine {
1591
+ /** Unghiul pozei. Implicit `"trei-sferturi"`. */
1592
+ readonly unghi?: UnghiImagine;
1593
+ /** Umbra sub masina. Implicit `true`. */
1594
+ readonly umbra?: boolean;
1595
+ /** Culoarea vopselei, slug din paleta (`acteo.auto.imagini.culori()`), ex: `"rosu"`. Fara ea, griul implicit. */
1596
+ readonly culoare?: string;
1597
+ /** Finisajul vopselei. Implicit `"gloss"`. */
1598
+ readonly finisaj?: FinisajImagine;
1599
+ }
1600
+ /** Masina numita prin marca, model si an. */
1601
+ interface CerereImagineMasina extends OptiuniImagine {
1544
1602
  /** Marca, ca in talon sau RAR, ex: `Volkswagen`. */
1545
1603
  readonly marca: string;
1546
1604
  /** Modelul, ex: `Golf`. */
1547
1605
  readonly model: string;
1548
1606
  /** Anul fabricatiei (1950 - anul viitor); alege generatia. */
1549
1607
  readonly an: number;
1550
- /** Unghiul pozei. Implicit `"trei-sferturi"`. */
1551
- readonly unghi?: UnghiImagine;
1552
- /** Umbra sub masina. Implicit `true`. */
1553
- readonly umbra?: boolean;
1608
+ /** Nu se trimite impreuna cu `marca`, `model` si `an`. */
1609
+ readonly vin?: undefined;
1554
1610
  }
1611
+ /** Masina numita prin seria de sasiu: marca, modelul si anul se afla din VIN. */
1612
+ interface CerereImagineVin extends OptiuniImagine {
1613
+ /** Seria de sasiu (VIN), 17 caractere. Spatiile si literele mici sunt acceptate. */
1614
+ readonly vin: string;
1615
+ /** Nu se trimite impreuna cu `vin`. */
1616
+ readonly marca?: undefined;
1617
+ /** Nu se trimite impreuna cu `vin`. */
1618
+ readonly model?: undefined;
1619
+ /** Nu se trimite impreuna cu `vin`. */
1620
+ readonly an?: undefined;
1621
+ }
1622
+ /** Masina pentru care ceri poza: `{ marca, model, an }` sau `{ vin }`. */
1623
+ type CerereImagine = CerereImagineMasina | CerereImagineVin;
1555
1624
  /**
1556
1625
  * Verifica un CNP romanesc: 13 cifre, o data de nastere reala si cifra de
1557
1626
  * control. Spatiile si liniutele sunt ignorate. Nu spune daca CNP-ul exista.
@@ -1661,7 +1730,7 @@ interface OptiuniAsteptare {
1661
1730
  }
1662
1731
 
1663
1732
  /** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
1664
- declare const VERSIUNE_SDK = "0.6.0";
1733
+ declare const VERSIUNE_SDK = "0.8.0";
1665
1734
  /** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
1666
1735
  declare const URL_IMPLICIT = "https://api.acteo.ro";
1667
1736
  /** Adresa implicita a clientului legacy {@link VerificRca}. */
@@ -2243,15 +2312,17 @@ declare class ClientImagini {
2243
2312
  * netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
2244
2313
  * {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
2245
2314
  *
2246
- * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
2315
+ * @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
2247
2316
  * @param optiuni `signal` pentru anulare.
2248
2317
  * @returns poza masinii sau poza generica.
2249
- * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
2318
+ * @throws {@link EroareValidare} un camp invalid, culoare din afara paletei (`CULOARE_NECUNOSCUTA`) sau VIN din care nu se afla masina (`VIN_NEDECODAT`, netaxat).
2250
2319
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
2251
2320
  * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
2252
2321
  * @example
2253
2322
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
2254
2323
  * if (p.status === "gata") afiseaza(p.url)
2324
+ * @example
2325
+ * const rosie = await acteo.auto.imagini.obtine({ vin: "WVWZZZ1KZBW000000", culoare: "rosu", finisaj: "metallic" })
2255
2326
  */
2256
2327
  obtine(cerere: CerereImagine, optiuni?: OptiuniCerere): Promise<ImagineMasina>;
2257
2328
  /**
@@ -2259,12 +2330,24 @@ declare class ClientImagini {
2259
2330
  * nou, cu pauzele din `Retry-After`. Fiecare cerere intermediara e netaxata,
2260
2331
  * dar intra in plafonul zilnic de poze generice.
2261
2332
  *
2262
- * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
2333
+ * @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
2263
2334
  * @param optiuni `timeoutMs` (implicit 2 minute) si `signal`.
2264
2335
  * @returns poza cu orice status in afara de `"in-lucru"`.
2265
2336
  * @throws {@link EroareTimeoutVerificare} poza nu a fost gata in `timeoutMs`.
2266
2337
  */
2267
2338
  asteapta(cerere: CerereImagine, optiuni?: OptiuniAsteptareImagine & OptiuniCerere): Promise<ImagineMasina>;
2339
+ /**
2340
+ * Paleta de culori si finisajele pe care le poti cere in `culoare` si
2341
+ * `finisaj`. Nu consuma din cota. Lista se schimba rar: o poti pastra o ora.
2342
+ *
2343
+ * @param optiuni `signal` pentru anulare.
2344
+ * @returns `culori` (`slug`, `nume`, `hex`) si `finisaje`.
2345
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
2346
+ * @example
2347
+ * const { culori } = await acteo.auto.imagini.culori()
2348
+ * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015, culoare: culori[0].slug })
2349
+ */
2350
+ culori(optiuni?: OptiuniCerere): Promise<CuloriImagini>;
2268
2351
  }
2269
2352
  /** Domeniul auto: documentele unei masini, flota monitorizata, VIN, numere si poze. */
2270
2353
  declare class ClientAuto {
@@ -2528,4 +2611,4 @@ declare class Acteo {
2528
2611
  constructor(optiuni?: OptiuniClient);
2529
2612
  }
2530
2613
 
2531
- export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CererePolitaPad, type CerereProgramare, type CerereVerificare, type ClientArr, ClientAuto, ClientCasa, ClientDocument, ClientImagini, type ClientItp, ClientNumere, ClientPad, ClientProgramari, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type DataProgramare, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type ListaProgramari, type ModificareProgramare, MomentReminder, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniListaProgramari, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type PolitaPadGata, type PolitaPadInCurs, type PolitaPadPornita, type Programare, type ProgramareTrimisa, type RaspunsDocument, type RaspunsVerificare, type ReferintaPolitaPad, type ReferintaVerificare, type RezultatDocument, type RezultatPolitaPad, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookProgramareClientDezabonat, type WebhookProgramareConfirmareExpirata, type WebhookProgramareConfirmata, type WebhookRezultat, type WebhookRezultatPad, type WebhookTermenExpira, type WebhookTest, esteCnpValid, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, parseazaWebhookRezultatPad, verificaWebhookNotificare };
2614
+ export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CerereImagineMasina, type CerereImagineVin, type CererePolitaPad, type CerereProgramare, type CerereVerificare, type ClientArr, ClientAuto, ClientCasa, ClientDocument, ClientImagini, type ClientItp, ClientNumere, ClientPad, ClientProgramari, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type CuloriImagini, type DataProgramare, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, FINISAJE_IMAGINE, FinisajImagine, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type ListaProgramari, type ModificareProgramare, MomentReminder, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniImagine, type OptiuniListaProgramari, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type PolitaPadGata, type PolitaPadInCurs, type PolitaPadPornita, type Programare, type ProgramareTrimisa, type RaspunsDocument, type RaspunsVerificare, type ReferintaPolitaPad, type ReferintaVerificare, type RezultatDocument, type RezultatPolitaPad, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookProgramareClientDezabonat, type WebhookProgramareConfirmareExpirata, type WebhookProgramareConfirmata, type WebhookRezultat, type WebhookRezultatPad, type WebhookTermenExpira, type WebhookTest, esteCnpValid, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, parseazaWebhookRezultatPad, verificaWebhookNotificare };
package/dist/index.d.ts CHANGED
@@ -63,6 +63,13 @@ declare const RezultatVerificareSchema: Schema.Struct<{
63
63
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
64
64
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
65
65
  expiresAt: Schema.NullOr<typeof Schema.Date>;
66
+ /**
67
+ * Doar la RCA: societatea care a emis polita, cum apare la sursa oficiala. `null` la celelalte
68
+ * documente, cand nu exista polita valabila si cand numele nu e cunoscut.
69
+ */
70
+ asigurator: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
71
+ default: () => null;
72
+ }>;
66
73
  /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
67
74
  code: Schema.optional<typeof Schema.String>;
68
75
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
@@ -97,6 +104,10 @@ declare const VehiculSchema: Schema.Struct<{
97
104
  }>;
98
105
  /** Data expirarii RCA, `null` daca nu e cunoscuta inca. */
99
106
  rcaExpiraLa: Schema.NullOr<typeof Schema.Date>;
107
+ /** Societatea care a emis polita RCA, cum apare la sursa oficiala. `null` daca nu e cunoscuta. */
108
+ rcaAsigurator: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
109
+ default: () => null;
110
+ }>;
100
111
  /** Data expirarii ITP, `null` daca nu e cunoscuta inca (ITP-ul cere VIN). */
101
112
  itpExpiraLa: Schema.NullOr<typeof Schema.Date>;
102
113
  /** Data expirarii rovinietei, `null` daca nu e cunoscuta inca (rovinieta cere numar, VIN si numarul talonului). */
@@ -140,6 +151,13 @@ declare const WebhookRezultatSchema: Schema.Struct<{
140
151
  status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
141
152
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
142
153
  expiresAt: Schema.NullOr<typeof Schema.Date>;
154
+ /**
155
+ * Doar la RCA: societatea care a emis polita, cum apare la sursa oficiala. `null` la celelalte
156
+ * documente, cand nu exista polita valabila si cand numele nu e cunoscut.
157
+ */
158
+ asigurator: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
159
+ default: () => null;
160
+ }>;
143
161
  /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
144
162
  code: Schema.optional<typeof Schema.String>;
145
163
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
@@ -862,6 +880,10 @@ declare const NumarDisponibilSchema: Schema.Struct<{
862
880
  declare const UnghiImagine: Schema.Literal<["trei-sferturi", "fata", "profil", "spate", "trei-sferturi-dreapta", "profil-dreapta"]>;
863
881
  /** Unghiul pozei: `"trei-sferturi"` (implicit), `"fata"`, `"profil"`, `"spate"`, `"trei-sferturi-dreapta"`, `"profil-dreapta"`. */
864
882
  type UnghiImagine = typeof UnghiImagine.Type;
883
+ /** Finisajele vopselei. */
884
+ declare const FinisajImagine: Schema.Literal<["matte", "satin", "gloss", "metallic"]>;
885
+ /** Finisajul vopselei: `"matte"`, `"satin"`, `"gloss"` (implicit) sau `"metallic"`. */
886
+ type FinisajImagine = typeof FinisajImagine.Type;
865
887
  /**
866
888
  * Starea pozei:
867
889
  * - `gata`: poza masinii cerute (se taxeaza);
@@ -893,11 +915,19 @@ declare const ImagineMasinaSchema: Schema.Struct<{
893
915
  latime: typeof Schema.Number;
894
916
  /** Inaltimea pozei, in pixeli. */
895
917
  inaltime: typeof Schema.Number;
896
- /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. */
918
+ /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. Goala la cererile cu `vin` cat timp poza nu e gata. */
897
919
  marca: typeof Schema.String;
898
- /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. */
920
+ /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. Gol la cererile cu `vin` cat timp poza nu e gata. */
899
921
  model: typeof Schema.String;
900
- /** Generatia aleasa dupa an; `null` cand nu e aleasa inca. */
922
+ /** Culoarea pozei (slug din paleta); `null` cand nu ai cerut nici culoare, nici finisaj. */
923
+ culoare: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
924
+ default: () => null;
925
+ }>;
926
+ /** Finisajul pozei; `null` cand nu ai cerut nici culoare, nici finisaj. */
927
+ finisaj: Schema.optionalWith<Schema.NullOr<Schema.Literal<["matte", "satin", "gloss", "metallic"]>>, {
928
+ default: () => null;
929
+ }>;
930
+ /** Generatia aleasa dupa an; `null` cand nu e aleasa inca si la cererile cu `vin` cat timp poza nu e gata. */
901
931
  generatie: Schema.NullOr<Schema.Struct<{
902
932
  /** Numele generatiei, ex: `Volkswagen Golf VII`. */
903
933
  eticheta: typeof Schema.String;
@@ -909,6 +939,21 @@ declare const ImagineMasinaSchema: Schema.Struct<{
909
939
  caroserie: typeof Schema.String;
910
940
  }>>;
911
941
  }>;
942
+ declare const CuloriImaginiSchema: Schema.Struct<{
943
+ /** Culorile din paleta, in ordinea ei. */
944
+ culori: Schema.Array$<Schema.Struct<{
945
+ /** Valoarea pe care o trimiti in `culoare`, ex: `rosu`. */
946
+ slug: typeof Schema.String;
947
+ /** Numele culorii, de afisat. */
948
+ nume: typeof Schema.String;
949
+ /** Culoarea ca hex, ex: `#c1121f`, pentru un selector de culori. */
950
+ hex: typeof Schema.String;
951
+ }>>;
952
+ /** Finisajele acceptate in `finisaj`. Text simplu, ca un finisaj nou sa nu strice citirea paletei. */
953
+ finisaje: Schema.Array$<typeof Schema.String>;
954
+ }>;
955
+ /** Paleta de culori si finisajele pozelor. */
956
+ type CuloriImagini = typeof CuloriImaginiSchema.Type;
912
957
  declare const PolitaPadPornitaSchema: Schema.Struct<{
913
958
  /** Mereu `"processing"`: PADROM e interogat acum. */
914
959
  status: Schema.Literal<["processing"]>;
@@ -1539,19 +1584,43 @@ interface VehiculNou {
1539
1584
  }
1540
1585
  /** Unghiurile acceptate pentru poza unei masini. */
1541
1586
  declare const UNGHIURI_IMAGINE: readonly UnghiImagine[];
1542
- /** Masina pentru care ceri poza. */
1543
- interface CerereImagine {
1587
+ /** Finisajele acceptate pentru vopseaua din poza. */
1588
+ declare const FINISAJE_IMAGINE: readonly FinisajImagine[];
1589
+ /** Cum arata poza: aceleasi optiuni, oricum ai numi masina. */
1590
+ interface OptiuniImagine {
1591
+ /** Unghiul pozei. Implicit `"trei-sferturi"`. */
1592
+ readonly unghi?: UnghiImagine;
1593
+ /** Umbra sub masina. Implicit `true`. */
1594
+ readonly umbra?: boolean;
1595
+ /** Culoarea vopselei, slug din paleta (`acteo.auto.imagini.culori()`), ex: `"rosu"`. Fara ea, griul implicit. */
1596
+ readonly culoare?: string;
1597
+ /** Finisajul vopselei. Implicit `"gloss"`. */
1598
+ readonly finisaj?: FinisajImagine;
1599
+ }
1600
+ /** Masina numita prin marca, model si an. */
1601
+ interface CerereImagineMasina extends OptiuniImagine {
1544
1602
  /** Marca, ca in talon sau RAR, ex: `Volkswagen`. */
1545
1603
  readonly marca: string;
1546
1604
  /** Modelul, ex: `Golf`. */
1547
1605
  readonly model: string;
1548
1606
  /** Anul fabricatiei (1950 - anul viitor); alege generatia. */
1549
1607
  readonly an: number;
1550
- /** Unghiul pozei. Implicit `"trei-sferturi"`. */
1551
- readonly unghi?: UnghiImagine;
1552
- /** Umbra sub masina. Implicit `true`. */
1553
- readonly umbra?: boolean;
1608
+ /** Nu se trimite impreuna cu `marca`, `model` si `an`. */
1609
+ readonly vin?: undefined;
1554
1610
  }
1611
+ /** Masina numita prin seria de sasiu: marca, modelul si anul se afla din VIN. */
1612
+ interface CerereImagineVin extends OptiuniImagine {
1613
+ /** Seria de sasiu (VIN), 17 caractere. Spatiile si literele mici sunt acceptate. */
1614
+ readonly vin: string;
1615
+ /** Nu se trimite impreuna cu `vin`. */
1616
+ readonly marca?: undefined;
1617
+ /** Nu se trimite impreuna cu `vin`. */
1618
+ readonly model?: undefined;
1619
+ /** Nu se trimite impreuna cu `vin`. */
1620
+ readonly an?: undefined;
1621
+ }
1622
+ /** Masina pentru care ceri poza: `{ marca, model, an }` sau `{ vin }`. */
1623
+ type CerereImagine = CerereImagineMasina | CerereImagineVin;
1555
1624
  /**
1556
1625
  * Verifica un CNP romanesc: 13 cifre, o data de nastere reala si cifra de
1557
1626
  * control. Spatiile si liniutele sunt ignorate. Nu spune daca CNP-ul exista.
@@ -1661,7 +1730,7 @@ interface OptiuniAsteptare {
1661
1730
  }
1662
1731
 
1663
1732
  /** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
1664
- declare const VERSIUNE_SDK = "0.6.0";
1733
+ declare const VERSIUNE_SDK = "0.8.0";
1665
1734
  /** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
1666
1735
  declare const URL_IMPLICIT = "https://api.acteo.ro";
1667
1736
  /** Adresa implicita a clientului legacy {@link VerificRca}. */
@@ -2243,15 +2312,17 @@ declare class ClientImagini {
2243
2312
  * netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
2244
2313
  * {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
2245
2314
  *
2246
- * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
2315
+ * @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
2247
2316
  * @param optiuni `signal` pentru anulare.
2248
2317
  * @returns poza masinii sau poza generica.
2249
- * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
2318
+ * @throws {@link EroareValidare} un camp invalid, culoare din afara paletei (`CULOARE_NECUNOSCUTA`) sau VIN din care nu se afla masina (`VIN_NEDECODAT`, netaxat).
2250
2319
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
2251
2320
  * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
2252
2321
  * @example
2253
2322
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
2254
2323
  * if (p.status === "gata") afiseaza(p.url)
2324
+ * @example
2325
+ * const rosie = await acteo.auto.imagini.obtine({ vin: "WVWZZZ1KZBW000000", culoare: "rosu", finisaj: "metallic" })
2255
2326
  */
2256
2327
  obtine(cerere: CerereImagine, optiuni?: OptiuniCerere): Promise<ImagineMasina>;
2257
2328
  /**
@@ -2259,12 +2330,24 @@ declare class ClientImagini {
2259
2330
  * nou, cu pauzele din `Retry-After`. Fiecare cerere intermediara e netaxata,
2260
2331
  * dar intra in plafonul zilnic de poze generice.
2261
2332
  *
2262
- * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
2333
+ * @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
2263
2334
  * @param optiuni `timeoutMs` (implicit 2 minute) si `signal`.
2264
2335
  * @returns poza cu orice status in afara de `"in-lucru"`.
2265
2336
  * @throws {@link EroareTimeoutVerificare} poza nu a fost gata in `timeoutMs`.
2266
2337
  */
2267
2338
  asteapta(cerere: CerereImagine, optiuni?: OptiuniAsteptareImagine & OptiuniCerere): Promise<ImagineMasina>;
2339
+ /**
2340
+ * Paleta de culori si finisajele pe care le poti cere in `culoare` si
2341
+ * `finisaj`. Nu consuma din cota. Lista se schimba rar: o poti pastra o ora.
2342
+ *
2343
+ * @param optiuni `signal` pentru anulare.
2344
+ * @returns `culori` (`slug`, `nume`, `hex`) si `finisaje`.
2345
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
2346
+ * @example
2347
+ * const { culori } = await acteo.auto.imagini.culori()
2348
+ * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015, culoare: culori[0].slug })
2349
+ */
2350
+ culori(optiuni?: OptiuniCerere): Promise<CuloriImagini>;
2268
2351
  }
2269
2352
  /** Domeniul auto: documentele unei masini, flota monitorizata, VIN, numere si poze. */
2270
2353
  declare class ClientAuto {
@@ -2528,4 +2611,4 @@ declare class Acteo {
2528
2611
  constructor(optiuni?: OptiuniClient);
2529
2612
  }
2530
2613
 
2531
- export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CererePolitaPad, type CerereProgramare, type CerereVerificare, type ClientArr, ClientAuto, ClientCasa, ClientDocument, ClientImagini, type ClientItp, ClientNumere, ClientPad, ClientProgramari, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type DataProgramare, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type ListaProgramari, type ModificareProgramare, MomentReminder, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniListaProgramari, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type PolitaPadGata, type PolitaPadInCurs, type PolitaPadPornita, type Programare, type ProgramareTrimisa, type RaspunsDocument, type RaspunsVerificare, type ReferintaPolitaPad, type ReferintaVerificare, type RezultatDocument, type RezultatPolitaPad, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookProgramareClientDezabonat, type WebhookProgramareConfirmareExpirata, type WebhookProgramareConfirmata, type WebhookRezultat, type WebhookRezultatPad, type WebhookTermenExpira, type WebhookTest, esteCnpValid, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, parseazaWebhookRezultatPad, verificaWebhookNotificare };
2614
+ export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CerereImagineMasina, type CerereImagineVin, type CererePolitaPad, type CerereProgramare, type CerereVerificare, type ClientArr, ClientAuto, ClientCasa, ClientDocument, ClientImagini, type ClientItp, ClientNumere, ClientPad, ClientProgramari, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type CuloriImagini, type DataProgramare, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, FINISAJE_IMAGINE, FinisajImagine, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type ListaProgramari, type ModificareProgramare, MomentReminder, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniImagine, type OptiuniListaProgramari, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type PolitaPadGata, type PolitaPadInCurs, type PolitaPadPornita, type Programare, type ProgramareTrimisa, type RaspunsDocument, type RaspunsVerificare, type ReferintaPolitaPad, type ReferintaVerificare, type RezultatDocument, type RezultatPolitaPad, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookProgramareClientDezabonat, type WebhookProgramareConfirmareExpirata, type WebhookProgramareConfirmata, type WebhookRezultat, type WebhookRezultatPad, type WebhookTermenExpira, type WebhookTest, esteCnpValid, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, parseazaWebhookRezultatPad, verificaWebhookNotificare };
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- import { Data, Schema, Context, Effect, Duration, Schedule, Exit, Cause, Either, ParseResult } from 'effect';
1
+ import { Data, Schema, Context, Effect, ParseResult, Duration, Schedule, Exit, Cause, Either } from 'effect';
2
2
 
3
3
  // src/client.ts
4
4
  var VerificRcaError = class extends Data.Error {
@@ -189,6 +189,11 @@ var RezultatVerificareSchema = Schema.Struct({
189
189
  status: StatusDocument,
190
190
  /** Data expirarii documentului, `null` daca nu exista document valabil. */
191
191
  expiresAt: DataNullabila,
192
+ /**
193
+ * Doar la RCA: societatea care a emis polita, cum apare la sursa oficiala. `null` la celelalte
194
+ * documente, cand nu exista polita valabila si cand numele nu e cunoscut.
195
+ */
196
+ asigurator: Schema.optionalWith(Schema.NullOr(Schema.String), { default: () => null }),
192
197
  /** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
193
198
  code: Schema.optional(Schema.String),
194
199
  /** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
@@ -239,6 +244,8 @@ var VehiculSchema = Schema.Struct({
239
244
  serieTalonRespinsa: Schema.optionalWith(Schema.Boolean, { default: () => false }),
240
245
  /** Data expirarii RCA, `null` daca nu e cunoscuta inca. */
241
246
  rcaExpiraLa: DataNullabila,
247
+ /** Societatea care a emis polita RCA, cum apare la sursa oficiala. `null` daca nu e cunoscuta. */
248
+ rcaAsigurator: Schema.optionalWith(Schema.NullOr(Schema.String), { default: () => null }),
242
249
  /** Data expirarii ITP, `null` daca nu e cunoscuta inca (ITP-ul cere VIN). */
243
250
  itpExpiraLa: DataNullabila,
244
251
  /** Data expirarii rovinietei, `null` daca nu e cunoscuta inca (rovinieta cere numar, VIN si numarul talonului). */
@@ -644,6 +651,7 @@ var UnghiImagine = Schema.Literal(
644
651
  "trei-sferturi-dreapta",
645
652
  "profil-dreapta"
646
653
  );
654
+ var FinisajImagine = Schema.Literal("matte", "satin", "gloss", "metallic");
647
655
  var StatusImagine = Schema.Literal("gata", "in-lucru", "necunoscut", "indisponibil");
648
656
  var ImagineMasinaSchema = Schema.Struct({
649
657
  /** Poza e a masinii cerute; `false` = poza generica (masina sub husa). */
@@ -664,11 +672,15 @@ var ImagineMasinaSchema = Schema.Struct({
664
672
  latime: Schema.Number,
665
673
  /** Inaltimea pozei, in pixeli. */
666
674
  inaltime: Schema.Number,
667
- /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. */
675
+ /** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. Goala la cererile cu `vin` cat timp poza nu e gata. */
668
676
  marca: Schema.String,
669
- /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. */
677
+ /** Modelul canonic, sau cel trimis daca inca nu e cunoscut. Gol la cererile cu `vin` cat timp poza nu e gata. */
670
678
  model: Schema.String,
671
- /** Generatia aleasa dupa an; `null` cand nu e aleasa inca. */
679
+ /** Culoarea pozei (slug din paleta); `null` cand nu ai cerut nici culoare, nici finisaj. */
680
+ culoare: Schema.optionalWith(Schema.NullOr(Schema.String), { default: () => null }),
681
+ /** Finisajul pozei; `null` cand nu ai cerut nici culoare, nici finisaj. */
682
+ finisaj: Schema.optionalWith(Schema.NullOr(FinisajImagine), { default: () => null }),
683
+ /** Generatia aleasa dupa an; `null` cand nu e aleasa inca si la cererile cu `vin` cat timp poza nu e gata. */
672
684
  generatie: Schema.NullOr(
673
685
  Schema.Struct({
674
686
  /** Numele generatiei, ex: `Volkswagen Golf VII`. */
@@ -682,6 +694,21 @@ var ImagineMasinaSchema = Schema.Struct({
682
694
  })
683
695
  )
684
696
  });
697
+ var CuloriImaginiSchema = Schema.Struct({
698
+ /** Culorile din paleta, in ordinea ei. */
699
+ culori: Schema.Array(
700
+ Schema.Struct({
701
+ /** Valoarea pe care o trimiti in `culoare`, ex: `rosu`. */
702
+ slug: Schema.String,
703
+ /** Numele culorii, de afisat. */
704
+ nume: Schema.String,
705
+ /** Culoarea ca hex, ex: `#c1121f`, pentru un selector de culori. */
706
+ hex: Schema.String
707
+ })
708
+ ),
709
+ /** Finisajele acceptate in `finisaj`. Text simplu, ca un finisaj nou sa nu strice citirea paletei. */
710
+ finisaje: Schema.Array(Schema.String)
711
+ });
685
712
  var CampuriPolitaPad = {
686
713
  /** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
687
714
  requestId: Schema.String,
@@ -1143,6 +1170,7 @@ var UNGHIURI_IMAGINE = [
1143
1170
  "trei-sferturi-dreapta",
1144
1171
  "profil-dreapta"
1145
1172
  ];
1173
+ var FINISAJE_IMAGINE = ["matte", "satin", "gloss", "metallic"];
1146
1174
  var TEXT_MASINA_REGEX = /^[\p{L}\p{N} ./+&'()-]+$/u;
1147
1175
  function valideazaTextMasina(valoare, camp) {
1148
1176
  if (typeof valoare !== "string") return eroare(`Trimite \`${camp}\` ca text.`, camp);
@@ -1154,27 +1182,47 @@ function valideazaTextMasina(valoare, camp) {
1154
1182
  }
1155
1183
  return t;
1156
1184
  }
1157
- function valideazaCerereImagine(cerere) {
1185
+ var CULOARE_REGEX = /^[a-z0-9-]{2,40}$/;
1186
+ function valideazaMasinaImagine(cerere) {
1187
+ if (cerere?.vin !== void 0) {
1188
+ if (cerere.marca !== void 0 || cerere.model !== void 0 || cerere.an !== void 0) {
1189
+ return eroare("Trimite fie `vin`, fie `marca`, `model` si `an`, nu amandoua.", "vin");
1190
+ }
1191
+ const vin = normalizeaza(typeof cerere.vin === "string" ? cerere.vin : "");
1192
+ return VIN_REGEX.test(vin) ? { vin } : eroare(explicaVin(vin), "vin");
1193
+ }
1158
1194
  const marca = valideazaTextMasina(cerere?.marca, "marca");
1159
- if (marca instanceof EroareValidare) return Effect.fail(marca);
1195
+ if (marca instanceof EroareValidare) return marca;
1160
1196
  const model = valideazaTextMasina(cerere.model, "model");
1161
- if (model instanceof EroareValidare) return Effect.fail(model);
1197
+ if (model instanceof EroareValidare) return model;
1162
1198
  const anMaxim = (/* @__PURE__ */ new Date()).getFullYear() + 1;
1163
- if (!Number.isInteger(cerere.an) || cerere.an < 1950 || cerere.an > anMaxim) {
1164
- return Effect.fail(eroare(`\`an\` trebuie sa fie un numar intreg intre 1950 si ${anMaxim}.`, "an"));
1199
+ const an = cerere.an;
1200
+ if (typeof an !== "number" || !Number.isInteger(an) || an < 1950 || an > anMaxim) {
1201
+ return eroare(`\`an\` trebuie sa fie un numar intreg intre 1950 si ${anMaxim}.`, "an");
1165
1202
  }
1203
+ return { marca, model, an };
1204
+ }
1205
+ function valideazaCerereImagine(cerere) {
1206
+ const masina = valideazaMasinaImagine(cerere);
1207
+ if (masina instanceof EroareValidare) return Effect.fail(masina);
1166
1208
  if (cerere.unghi !== void 0 && !UNGHIURI_IMAGINE.includes(cerere.unghi)) {
1167
1209
  return Effect.fail(eroare(`\`unghi\` poate fi: ${UNGHIURI_IMAGINE.join(", ")}.`, "unghi", UNGHIURI_IMAGINE));
1168
1210
  }
1169
1211
  if (cerere.umbra !== void 0 && typeof cerere.umbra !== "boolean") {
1170
1212
  return Effect.fail(eroare("Trimite `umbra` ca true sau false.", "umbra"));
1171
1213
  }
1214
+ if (cerere.culoare !== void 0 && (typeof cerere.culoare !== "string" || !CULOARE_REGEX.test(cerere.culoare))) {
1215
+ return Effect.fail(eroare("`culoare` e un slug din paleta, ex: `rosu`. Lista o da `auto.imagini.culori()`.", "culoare"));
1216
+ }
1217
+ if (cerere.finisaj !== void 0 && !FINISAJE_IMAGINE.includes(cerere.finisaj)) {
1218
+ return Effect.fail(eroare(`\`finisaj\` poate fi: ${FINISAJE_IMAGINE.join(", ")}.`, "finisaj", FINISAJE_IMAGINE));
1219
+ }
1172
1220
  return Effect.succeed({
1173
- marca,
1174
- model,
1175
- an: cerere.an,
1221
+ ...masina,
1176
1222
  ...cerere.unghi !== void 0 && { unghi: cerere.unghi },
1177
- ...cerere.umbra !== void 0 && { umbra: cerere.umbra }
1223
+ ...cerere.umbra !== void 0 && { umbra: cerere.umbra },
1224
+ ...cerere.culoare !== void 0 && { culoare: cerere.culoare },
1225
+ ...cerere.finisaj !== void 0 && { finisaj: cerere.finisaj }
1178
1226
  });
1179
1227
  }
1180
1228
  var PONDERI_CNP = [2, 7, 9, 1, 4, 6, 3, 5, 8, 2, 7, 9];
@@ -1366,7 +1414,7 @@ var sterge = (id) => id.trim() ? trimite({ metoda: "DELETE", cale: `${CALE2}/${e
1366
1414
  ) : Effect.fail(new EroareValidare({ message: "Lipseste ID-ul vehiculului.", camp: "id", cod: "VALIDARE_LOCALA" }));
1367
1415
 
1368
1416
  // src/client.ts
1369
- var VERSIUNE_SDK = "0.6.0";
1417
+ var VERSIUNE_SDK = "0.8.0";
1370
1418
  var URL_IMPLICIT = "https://api.acteo.ro";
1371
1419
  var URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
1372
1420
  var RETRY_IMPLICIT = { incercari: 3, intarziereInitialaMs: 500, intarziereMaximaMs: 1e4 };
@@ -1703,6 +1751,11 @@ var imagine = (cerere) => valideazaCerereImagine(cerere).pipe(
1703
1751
  )
1704
1752
  )
1705
1753
  );
1754
+ var culoriImagini = trimite({
1755
+ metoda: "GET",
1756
+ cale: "/api/public/v1/imagini-masini/culori",
1757
+ idempotenta: true
1758
+ }).pipe(Effect.flatMap(decodeaza(CuloriImaginiSchema)));
1706
1759
  var TIMEOUT_IMAGINE_MS = 2 * 6e4;
1707
1760
  var PAUZA_IMAGINE_MS = 1e4;
1708
1761
  var imagineAsteptata = (cerere, optiuni = {}) => Effect.gen(function* () {
@@ -2021,15 +2074,17 @@ var ClientImagini = class {
2021
2074
  * netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
2022
2075
  * {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
2023
2076
  *
2024
- * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
2077
+ * @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
2025
2078
  * @param optiuni `signal` pentru anulare.
2026
2079
  * @returns poza masinii sau poza generica.
2027
- * @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
2080
+ * @throws {@link EroareValidare} un camp invalid, culoare din afara paletei (`CULOARE_NECUNOSCUTA`) sau VIN din care nu se afla masina (`VIN_NEDECODAT`, netaxat).
2028
2081
  * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
2029
2082
  * @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
2030
2083
  * @example
2031
2084
  * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
2032
2085
  * if (p.status === "gata") afiseaza(p.url)
2086
+ * @example
2087
+ * const rosie = await acteo.auto.imagini.obtine({ vin: "WVWZZZ1KZBW000000", culoare: "rosu", finisaj: "metallic" })
2033
2088
  */
2034
2089
  obtine(cerere, optiuni) {
2035
2090
  return this.#ruleaza(imagine(cerere), optiuni);
@@ -2039,7 +2094,7 @@ var ClientImagini = class {
2039
2094
  * nou, cu pauzele din `Retry-After`. Fiecare cerere intermediara e netaxata,
2040
2095
  * dar intra in plafonul zilnic de poze generice.
2041
2096
  *
2042
- * @param cerere `marca`, `model`, `an` si optional `unghi`, `umbra`.
2097
+ * @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
2043
2098
  * @param optiuni `timeoutMs` (implicit 2 minute) si `signal`.
2044
2099
  * @returns poza cu orice status in afara de `"in-lucru"`.
2045
2100
  * @throws {@link EroareTimeoutVerificare} poza nu a fost gata in `timeoutMs`.
@@ -2047,6 +2102,20 @@ var ClientImagini = class {
2047
2102
  asteapta(cerere, optiuni) {
2048
2103
  return this.#ruleaza(imagineAsteptata(cerere, optiuni), optiuni);
2049
2104
  }
2105
+ /**
2106
+ * Paleta de culori si finisajele pe care le poti cere in `culoare` si
2107
+ * `finisaj`. Nu consuma din cota. Lista se schimba rar: o poti pastra o ora.
2108
+ *
2109
+ * @param optiuni `signal` pentru anulare.
2110
+ * @returns `culori` (`slug`, `nume`, `hex`) si `finisaje`.
2111
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
2112
+ * @example
2113
+ * const { culori } = await acteo.auto.imagini.culori()
2114
+ * const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015, culoare: culori[0].slug })
2115
+ */
2116
+ culori(optiuni) {
2117
+ return this.#ruleaza(culoriImagini, optiuni);
2118
+ }
2050
2119
  };
2051
2120
  var ClientAuto = class {
2052
2121
  /** Asigurarea RCA: `acteo.auto.rca.verifica("B123ABC")`. */
@@ -2316,6 +2385,6 @@ var Acteo = class {
2316
2385
  }
2317
2386
  };
2318
2387
 
2319
- export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, ClientAuto, ClientCasa, ClientDocument, ClientImagini, ClientNumere, ClientPad, ClientProgramari, 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, esteCnpValid, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, parseazaWebhookRezultatPad, verificaWebhookNotificare };
2388
+ export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, ClientAuto, ClientCasa, ClientDocument, ClientImagini, ClientNumere, ClientPad, ClientProgramari, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, EroareAutentificare, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, FINISAJE_IMAGINE, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, TIPURI_VERIFICARE, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, VERSIUNE_SDK, VerificRca, VerificRcaError, esteCnpValid, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, parseazaWebhookRezultatPad, verificaWebhookNotificare };
2320
2389
  //# sourceMappingURL=index.js.map
2321
2390
  //# sourceMappingURL=index.js.map