@fiado/type-kit 3.195.0 → 3.196.0

package/bin/places/dtos/AddressCandidate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Candidato de dirección normalizado, común a búsqueda por texto y reverse geocoding.
+ * Mapea el `Place` de Amazon Location a un shape estable propio de Fiado.
+ * Response DTO — sin decoradores de validación.
+ */
+export declare class AddressCandidate {
+    /** Etiqueta completa legible (equivalente a Place.Label). */
+    label: string;
+    street?: string;
+    /** Número exterior (Place.AddressNumber). */
+    addressNumber?: string;
+    neighborhood?: string;
+    municipality?: string;
+    /** Estado/provincia (Place.Region). */
+    region?: string;
+    postalCode?: string;
+    /** ISO3 del país (Place.Country). */
+    country?: string;
+    latitude?: number;
+    longitude?: number;
+    /** Relevancia 0..1 (solo búsqueda por texto; ausente en reverse). */
+    relevance?: number;
+}

package/bin/places/dtos/AddressCandidate.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressCandidate = void 0;
+/**
+ * Candidato de dirección normalizado, común a búsqueda por texto y reverse geocoding.
+ * Mapea el `Place` de Amazon Location a un shape estable propio de Fiado.
+ * Response DTO — sin decoradores de validación.
+ */
+class AddressCandidate {
+}
+exports.AddressCandidate = AddressCandidate;

package/bin/places/dtos/ReverseGeocodeRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Entrada del reverse geocoding (coordenadas → candidatos de dirección) vía Amazon Location.
+ * Consumido por el endpoint privado de places-business (api-invoker).
+ */
+export declare class ReverseGeocodeRequest {
+    latitude: number;
+    longitude: number;
+    maxResults?: number;
+}

package/bin/places/dtos/ReverseGeocodeRequest.js

@@ -0,0 +1,39 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReverseGeocodeRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Entrada del reverse geocoding (coordenadas → candidatos de dirección) vía Amazon Location.
+ * Consumido por el endpoint privado de places-business (api-invoker).
+ */
+class ReverseGeocodeRequest {
+}
+exports.ReverseGeocodeRequest = ReverseGeocodeRequest;
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(-90),
+    (0, class_validator_1.Max)(90),
+    __metadata("design:type", Number)
+], ReverseGeocodeRequest.prototype, "latitude", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(-180),
+    (0, class_validator_1.Max)(180),
+    __metadata("design:type", Number)
+], ReverseGeocodeRequest.prototype, "longitude", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(15),
+    __metadata("design:type", Number)
+], ReverseGeocodeRequest.prototype, "maxResults", void 0);

package/bin/places/dtos/ReverseGeocodeResponse.d.ts

@@ -0,0 +1,5 @@
+import { AddressCandidate } from './AddressCandidate';
+/** Respuesta del reverse geocoding — candidatos de dirección normalizados. */
+export declare class ReverseGeocodeResponse {
+    results: AddressCandidate[];
+}

package/bin/places/dtos/ReverseGeocodeResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReverseGeocodeResponse = void 0;
+/** Respuesta del reverse geocoding — candidatos de dirección normalizados. */
+class ReverseGeocodeResponse {
+}
+exports.ReverseGeocodeResponse = ReverseGeocodeResponse;

package/bin/places/dtos/SearchAddressRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Entrada del geocoding por texto (texto libre → candidatos de dirección) vía Amazon Location.
+ * Consumido por el endpoint privado de places-business (api-invoker).
+ */
+export declare class SearchAddressRequest {
+    text: string;
+    /** ISO3 de países a los que acotar la búsqueda (default en el lambda: ['MEX']). */
+    countries?: string[];
+    maxResults?: number;
+}

package/bin/places/dtos/SearchAddressRequest.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchAddressRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Entrada del geocoding por texto (texto libre → candidatos de dirección) vía Amazon Location.
+ * Consumido por el endpoint privado de places-business (api-invoker).
+ */
+class SearchAddressRequest {
+}
+exports.SearchAddressRequest = SearchAddressRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SearchAddressRequest.prototype, "text", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], SearchAddressRequest.prototype, "countries", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(15),
+    __metadata("design:type", Number)
+], SearchAddressRequest.prototype, "maxResults", void 0);

package/bin/places/dtos/SearchAddressResponse.d.ts

@@ -0,0 +1,5 @@
+import { AddressCandidate } from './AddressCandidate';
+/** Respuesta del geocoding por texto — candidatos de dirección normalizados. */
+export declare class SearchAddressResponse {
+    results: AddressCandidate[];
+}

package/bin/places/dtos/SearchAddressResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchAddressResponse = void 0;
+/** Respuesta del geocoding por texto — candidatos de dirección normalizados. */
+class SearchAddressResponse {
+}
+exports.SearchAddressResponse = SearchAddressResponse;

package/bin/places/index.d.ts

@@ -4,6 +4,11 @@ export * from './dtos/GetNearbyPlacesResponse';
 export * from './dtos/ReportPlaceRequest';
 export * from './dtos/ReportedPlaceDto';
 export * from './dtos/ResolveReportedPlaceRequest';
+export * from './dtos/AddressCandidate';
+export * from './dtos/SearchAddressRequest';
+export * from './dtos/SearchAddressResponse';
+export * from './dtos/ReverseGeocodeRequest';
+export * from './dtos/ReverseGeocodeResponse';
 export * from './enums/CashInNetworkEnum';
 export * from './enums/CashInProviderEnum';
 export * from './enums/PlaceTypeEnum';

package/bin/places/index.js

@@ -21,6 +21,11 @@ __exportStar(require("./dtos/GetNearbyPlacesResponse"), exports);
 __exportStar(require("./dtos/ReportPlaceRequest"), exports);
 __exportStar(require("./dtos/ReportedPlaceDto"), exports);
 __exportStar(require("./dtos/ResolveReportedPlaceRequest"), exports);
+__exportStar(require("./dtos/AddressCandidate"), exports);
+__exportStar(require("./dtos/SearchAddressRequest"), exports);
+__exportStar(require("./dtos/SearchAddressResponse"), exports);
+__exportStar(require("./dtos/ReverseGeocodeRequest"), exports);
+__exportStar(require("./dtos/ReverseGeocodeResponse"), exports);
 //enums
 __exportStar(require("./enums/CashInNetworkEnum"), exports);
 __exportStar(require("./enums/CashInProviderEnum"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.195.0",
+  "version": "3.196.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/places/dtos/AddressCandidate.ts

@@ -0,0 +1,23 @@
+/**
+ * Candidato de dirección normalizado, común a búsqueda por texto y reverse geocoding.
+ * Mapea el `Place` de Amazon Location a un shape estable propio de Fiado.
+ * Response DTO — sin decoradores de validación.
+ */
+export class AddressCandidate {
+    /** Etiqueta completa legible (equivalente a Place.Label). */
+    label: string;
+    street?: string;
+    /** Número exterior (Place.AddressNumber). */
+    addressNumber?: string;
+    neighborhood?: string;
+    municipality?: string;
+    /** Estado/provincia (Place.Region). */
+    region?: string;
+    postalCode?: string;
+    /** ISO3 del país (Place.Country). */
+    country?: string;
+    latitude?: number;
+    longitude?: number;
+    /** Relevancia 0..1 (solo búsqueda por texto; ausente en reverse). */
+    relevance?: number;
+}

package/src/places/dtos/ReverseGeocodeRequest.ts

@@ -0,0 +1,23 @@
+import { IsInt, IsNumber, IsOptional, Max, Min } from 'class-validator';
+
+/**
+ * Entrada del reverse geocoding (coordenadas → candidatos de dirección) vía Amazon Location.
+ * Consumido por el endpoint privado de places-business (api-invoker).
+ */
+export class ReverseGeocodeRequest {
+    @IsNumber()
+    @Min(-90)
+    @Max(90)
+    latitude: number;
+
+    @IsNumber()
+    @Min(-180)
+    @Max(180)
+    longitude: number;
+
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    @Max(15)
+    maxResults?: number;
+}

package/src/places/dtos/ReverseGeocodeResponse.ts

@@ -0,0 +1,6 @@
+import { AddressCandidate } from './AddressCandidate';
+
+/** Respuesta del reverse geocoding — candidatos de dirección normalizados. */
+export class ReverseGeocodeResponse {
+    results: AddressCandidate[];
+}

package/src/places/dtos/SearchAddressRequest.ts

@@ -0,0 +1,23 @@
+import { IsArray, IsInt, IsNotEmpty, IsOptional, IsString, Max, Min } from 'class-validator';
+
+/**
+ * Entrada del geocoding por texto (texto libre → candidatos de dirección) vía Amazon Location.
+ * Consumido por el endpoint privado de places-business (api-invoker).
+ */
+export class SearchAddressRequest {
+    @IsString()
+    @IsNotEmpty()
+    text: string;
+
+    /** ISO3 de países a los que acotar la búsqueda (default en el lambda: ['MEX']). */
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    countries?: string[];
+
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    @Max(15)
+    maxResults?: number;
+}

package/src/places/dtos/SearchAddressResponse.ts

@@ -0,0 +1,6 @@
+import { AddressCandidate } from './AddressCandidate';
+
+/** Respuesta del geocoding por texto — candidatos de dirección normalizados. */
+export class SearchAddressResponse {
+    results: AddressCandidate[];
+}

package/src/places/index.ts

@@ -5,6 +5,11 @@ export * from './dtos/GetNearbyPlacesResponse';
 export * from './dtos/ReportPlaceRequest';
 export * from './dtos/ReportedPlaceDto';
 export * from './dtos/ResolveReportedPlaceRequest';
+export * from './dtos/AddressCandidate';
+export * from './dtos/SearchAddressRequest';
+export * from './dtos/SearchAddressResponse';
+export * from './dtos/ReverseGeocodeRequest';
+export * from './dtos/ReverseGeocodeResponse';
 
 //enums
 export * from './enums/CashInNetworkEnum';