@tmlmobilidade/go-types-shared 20261106.1422.59 → 20261109.1101.19

package/dist/api/api-response.d.ts

@@ -2,82 +2,87 @@ import { z } from 'zod';
 export declare const ApiResponseSuccessSchema: z.ZodObject<{
     data: z.ZodUnknown;
     error: z.ZodNull;
-    generated_at: z.ZodDefault<z.ZodNullable<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>>>;
-    status_code: z.ZodEnum<["200", "201", "204"]>;
-    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>;
-}, "strip", z.ZodTypeAny, {
-    error: null;
-    generated_at: import("../datetime/unix-millis.js").UnixMilliseconds | null;
-    status_code: "200" | "201" | "204";
-    timestamp: number & {
-        __brand: "UnixMilliseconds";
-    };
-    data?: unknown;
-}, {
-    error: null;
-    status_code: "200" | "201" | "204";
-    timestamp: string | number;
-    data?: unknown;
-    generated_at?: string | number | null | undefined;
-}>;
+    generated_at: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<import("../datetime/unix-millis.js").UnixMilliseconds, string | number>>>>;
+    status_code: z.ZodEnum<{
+        200: "200";
+        201: "201";
+        204: "204";
+    }>;
+    timestamp: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<import("../datetime/unix-millis.js").UnixMilliseconds, string | number>>;
+}, z.core.$strip>;
 export type ApiResponseSuccess<T> = Omit<z.infer<typeof ApiResponseSuccessSchema>, 'data'> & {
     data: T;
 };
+/** Safe validation details; never contains submitted values or Zod internals. */
+export declare const ApiValidationIssueSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>;
+export type ApiValidationIssue = z.infer<typeof ApiValidationIssueSchema>;
 export declare const ApiResponseErrorSchema: z.ZodObject<{
     data: z.ZodNull;
     error: z.ZodString;
-    status_code: z.ZodEnum<["400", "401", "403", "404", "409", "415", "429", "500", "502", "503", "504"]>;
-    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>;
-}, "strip", z.ZodTypeAny, {
-    data: null;
-    error: string;
-    status_code: "400" | "401" | "403" | "404" | "409" | "415" | "429" | "500" | "502" | "503" | "504";
-    timestamp: number & {
-        __brand: "UnixMilliseconds";
-    };
-}, {
-    data: null;
-    error: string;
-    status_code: "400" | "401" | "403" | "404" | "409" | "415" | "429" | "500" | "502" | "503" | "504";
-    timestamp: string | number;
-}>;
+    issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>;
+    status_code: z.ZodEnum<{
+        400: "400";
+        401: "401";
+        403: "403";
+        404: "404";
+        405: "405";
+        408: "408";
+        409: "409";
+        413: "413";
+        415: "415";
+        422: "422";
+        429: "429";
+        500: "500";
+        502: "502";
+        503: "503";
+        504: "504";
+    }>;
+    timestamp: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<import("../datetime/unix-millis.js").UnixMilliseconds, string | number>>;
+}, z.core.$strip>;
 export type ApiResponseError = z.infer<typeof ApiResponseErrorSchema>;
-export declare const ApiResponseSchema: z.ZodDiscriminatedUnion<"status_code", [z.ZodObject<{
+export declare const ApiResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     data: z.ZodUnknown;
     error: z.ZodNull;
-    generated_at: z.ZodDefault<z.ZodNullable<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>>>;
-    status_code: z.ZodEnum<["200", "201", "204"]>;
-    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>;
-}, "strip", z.ZodTypeAny, {
-    error: null;
-    generated_at: import("../datetime/unix-millis.js").UnixMilliseconds | null;
-    status_code: "200" | "201" | "204";
-    timestamp: number & {
-        __brand: "UnixMilliseconds";
-    };
-    data?: unknown;
-}, {
-    error: null;
-    status_code: "200" | "201" | "204";
-    timestamp: string | number;
-    data?: unknown;
-    generated_at?: string | number | null | undefined;
-}>, z.ZodObject<{
+    generated_at: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<import("../datetime/unix-millis.js").UnixMilliseconds, string | number>>>>;
+    status_code: z.ZodEnum<{
+        200: "200";
+        201: "201";
+        204: "204";
+    }>;
+    timestamp: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<import("../datetime/unix-millis.js").UnixMilliseconds, string | number>>;
+}, z.core.$strip>, z.ZodObject<{
     data: z.ZodNull;
     error: z.ZodString;
-    status_code: z.ZodEnum<["400", "401", "403", "404", "409", "415", "429", "500", "502", "503", "504"]>;
-    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>;
-}, "strip", z.ZodTypeAny, {
-    data: null;
-    error: string;
-    status_code: "400" | "401" | "403" | "404" | "409" | "415" | "429" | "500" | "502" | "503" | "504";
-    timestamp: number & {
-        __brand: "UnixMilliseconds";
-    };
-}, {
-    data: null;
-    error: string;
-    status_code: "400" | "401" | "403" | "404" | "409" | "415" | "429" | "500" | "502" | "503" | "504";
-    timestamp: string | number;
-}>]>;
+    issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>;
+    status_code: z.ZodEnum<{
+        400: "400";
+        401: "401";
+        403: "403";
+        404: "404";
+        405: "405";
+        408: "408";
+        409: "409";
+        413: "413";
+        415: "415";
+        422: "422";
+        429: "429";
+        500: "500";
+        502: "502";
+        503: "503";
+        504: "504";
+    }>;
+    timestamp: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<import("../datetime/unix-millis.js").UnixMilliseconds, string | number>>;
+}, z.core.$strip>], "status_code">;
 export type ApiResponse<T> = ApiResponseError | ApiResponseSuccess<T>;

package/dist/api/api-response.js

@@ -15,16 +15,27 @@ export const ApiResponseSuccessSchema = z.object({
     timestamp: UnixMillisecondsSchema,
 });
 /* * */
+/** Safe validation details; never contains submitted values or Zod internals. */
+export const ApiValidationIssueSchema = z.object({
+    code: z.string(),
+    message: z.string(),
+    path: z.array(z.union([z.string(), z.number()])),
+});
 export const ApiResponseErrorSchema = z.object({
     data: z.null(),
     error: z.string(),
+    issues: z.array(ApiValidationIssueSchema).optional(),
     status_code: HttpStatusSchema.extract([
         '400', // Bad Request
         '401', // Unauthorized
         '403', // Forbidden
         '404', // Not Found
+        '405', // Method Not Allowed
+        '408', // Request Timeout
         '409', // Conflict
+        '413', // Payload Too Large
         '415', // Unsupported Media Type
+        '422', // Unprocessable Content
         '429', // Too Many Requests
         '500', // Internal Server Error
         '502', // Bad Gateway

package/dist/api/http-status.d.ts

@@ -1,4 +1,23 @@
 import { z } from 'zod';
-export declare const HttpStatusValues: readonly ["200", "201", "204", "400", "401", "403", "404", "409", "415", "429", "500", "502", "503", "504"];
-export declare const HttpStatusSchema: z.ZodEnum<["200", "201", "204", "400", "401", "403", "404", "409", "415", "429", "500", "502", "503", "504"]>;
+export declare const HttpStatusValues: readonly ["200", "201", "204", "400", "401", "403", "404", "405", "408", "409", "413", "415", "422", "429", "500", "502", "503", "504"];
+export declare const HttpStatusSchema: z.ZodEnum<{
+    200: "200";
+    201: "201";
+    204: "204";
+    400: "400";
+    401: "401";
+    403: "403";
+    404: "404";
+    405: "405";
+    408: "408";
+    409: "409";
+    413: "413";
+    415: "415";
+    422: "422";
+    429: "429";
+    500: "500";
+    502: "502";
+    503: "503";
+    504: "504";
+}>;
 export type HttpStatus = z.infer<typeof HttpStatusSchema>;

package/dist/api/http-status.js

@@ -9,8 +9,12 @@ export const HttpStatusValues = [
     '401', // Unauthorized
     '403', // Forbidden
     '404', // Not Found
+    '405', // Method Not Allowed
+    '408', // Request Timeout
     '409', // Conflict
+    '413', // Payload Too Large
     '415', // Unsupported Media Type
+    '422', // Unprocessable Content
     '429', // Too Many Requests
     '500', // Internal Server Error
     '502', // Bad Gateway

package/dist/api/pagination.d.ts

@@ -1,11 +1,5 @@
 import { z } from 'zod';
 export declare const PaginationSchema: z.ZodObject<{
-    limit: z.ZodDefault<z.ZodNumber>;
-    page: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    limit: number;
-    page: number;
-}, {
-    limit?: number | undefined;
-    page?: number | undefined;
-}>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;

package/dist/datetime/calendar-date.d.ts

@@ -3,7 +3,7 @@ export declare const CALENDAR_DATE_FORMAT = "yyyy-MM-dd";
 export type CalendarDate = string & {
     __brand: 'CalendarDate';
 };
-export declare const CalendarDateSchema: z.ZodEffects<z.ZodString, CalendarDate, string>;
+export declare const CalendarDateSchema: z.ZodPipe<z.ZodString, z.ZodTransform<CalendarDate, string>>;
 /**
  * This function validates if a string is a valid calendar date
  * in the format `yyyy-MM-dd`.

package/dist/datetime/calendar-date.js

@@ -1,11 +1,12 @@
 /* * */
+import { validationTransform } from '@tmlmobilidade/go-utils-validation';
 import { DateTime } from 'luxon';
 import { z } from 'zod';
 /* * */
 export const CALENDAR_DATE_FORMAT = 'yyyy-MM-dd';
 export const CalendarDateSchema = z
     .string()
-    .transform(validateCalendarDate);
+    .transform(validationTransform(validateCalendarDate, 'custom.formats.date', { format: CALENDAR_DATE_FORMAT }));
 /**
  * This function validates if a string is a valid calendar date
  * in the format `yyyy-MM-dd`.

package/dist/datetime/date-format.d.ts

@@ -1,6 +1,13 @@
 import { z } from 'zod';
 export declare const DateFormatValues: readonly ["full", "short", "only_time", "only_time_with_seconds", "only_date", "iso"];
-export declare const DateFormatSchema: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEnum<["full", "short", "only_time", "only_time_with_seconds", "only_date", "iso"]>>;
+export declare const DateFormatSchema: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEnum<{
+    full: "full";
+    short: "short";
+    only_time: "only_time";
+    only_time_with_seconds: "only_time_with_seconds";
+    only_date: "only_date";
+    iso: "iso";
+}>>;
 /**
  * A date format.
  */

package/dist/datetime/interval.d.ts

@@ -1,18 +1,8 @@
 import { z } from 'zod';
 export declare const TimeIntervalSchema: z.ZodObject<{
-    end: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("./unix-millis.js").UnixMilliseconds, string | number>;
-    start: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("./unix-millis.js").UnixMilliseconds, string | number>;
-}, "strip", z.ZodTypeAny, {
-    end: number & {
-        __brand: "UnixMilliseconds";
-    };
-    start: number & {
-        __brand: "UnixMilliseconds";
-    };
-}, {
-    end: string | number;
-    start: string | number;
-}>;
+    end: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<import("./unix-millis.js").UnixMilliseconds, string | number>>;
+    start: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<import("./unix-millis.js").UnixMilliseconds, string | number>>;
+}, z.core.$strip>;
 /**
  * A time interval.
  */

package/dist/datetime/operational-date-int.d.ts

@@ -21,4 +21,4 @@ export type OperationalDateInt = number & {
  * // => 20260620 as OperationalDateInt
  * ```
  */
-export declare const OperationalDateIntSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, string, string | number>, string, string | number>, OperationalDateInt, string | number>;
+export declare const OperationalDateIntSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>, z.ZodTransform<OperationalDateInt, string>>;

package/dist/datetime/operational-date-int.js

@@ -1,4 +1,5 @@
 /* * */
+import { validationParams } from '@tmlmobilidade/go-utils-validation';
 import { DateTime } from 'luxon';
 import { z } from 'zod';
 import { CALENDAR_DATE_FORMAT } from './calendar-date.js';
@@ -20,5 +21,5 @@ export const OPERATIONAL_DATE_FORMAT = 'yyyyMMdd';
 export const OperationalDateIntSchema = z
     .union([z.string(), z.number()])
     .transform(value => String(value).replaceAll('-', ''))
-    .refine(value => DateTime.fromFormat(value, OPERATIONAL_DATE_FORMAT).isValid, { message: `Expected a date in the format ${OPERATIONAL_DATE_FORMAT} or ${CALENDAR_DATE_FORMAT}` })
+    .refine(value => DateTime.fromFormat(value, OPERATIONAL_DATE_FORMAT).isValid, validationParams('custom.formats.operational_date', { alternative: CALENDAR_DATE_FORMAT, format: OPERATIONAL_DATE_FORMAT }))
     .transform(value => Number(value));

package/dist/datetime/operational-date.d.ts

@@ -10,7 +10,7 @@ export type OperationalDate = string & {
  * Represents an operational date as a string in the format 'yyyyMMdd'.
  * @deprecated Use the OperationalDateIntSchema and validateOperationalDateInt function instead, for better performance.
  */
-export declare const OperationalDateSchema: z.ZodEffects<z.ZodString, OperationalDate, string>;
+export declare const OperationalDateSchema: z.ZodPipe<z.ZodString, z.ZodTransform<OperationalDate, string>>;
 /**
  * This function validates if a string is a valid
  * operational date in the format 'yyyyMMdd'.

package/dist/datetime/operational-date.js

@@ -1,5 +1,6 @@
 /* * */
 import { OPERATIONAL_DATE_FORMAT } from './operational-date-int.js';
+import { validationTransform } from '@tmlmobilidade/go-utils-validation';
 import { DateTime } from 'luxon';
 import { z } from 'zod';
 /**
@@ -8,7 +9,7 @@ import { z } from 'zod';
  */
 export const OperationalDateSchema = z
     .string()
-    .transform(validateOperationalDate);
+    .transform(validationTransform(validateOperationalDate, 'custom.formats.date', { format: OPERATIONAL_DATE_FORMAT }));
 /**
  * This function validates if a string is a valid
  * operational date in the format 'yyyyMMdd'.

package/dist/datetime/operational-time.d.ts

@@ -13,7 +13,7 @@ export type OperationalTime = string & {
 /**
  * Represents a Operational time as a string in the format 'HH:mm:ss'.
  */
-export declare const OperationalTimeSchema: z.ZodEffects<z.ZodString, OperationalTime, string>;
+export declare const OperationalTimeSchema: z.ZodPipe<z.ZodString, z.ZodTransform<OperationalTime, string>>;
 /**
  * This function validates if a string is a valid
  * Operational time in the format 'HH:mm:ss'.

package/dist/datetime/operational-time.js

@@ -1,4 +1,5 @@
 /* * */
+import { validationTransform } from '@tmlmobilidade/go-utils-validation';
 import { z } from 'zod';
 /* * */
 export const OPERATIONAL_TIME_FORMAT = 'HH:mm:ss';
@@ -7,7 +8,7 @@ export const OPERATIONAL_TIME_FORMAT = 'HH:mm:ss';
  */
 export const OperationalTimeSchema = z
     .string()
-    .transform(validateOperationalTime);
+    .transform(validationTransform(validateOperationalTime, 'custom.formats.operational_time', { format: OPERATIONAL_TIME_FORMAT }));
 /**
  * This function validates if a string is a valid
  * Operational time in the format 'HH:mm:ss'.

package/dist/datetime/time-slot.d.ts

@@ -1,6 +1,22 @@
 import { z } from 'zod';
 export declare const TimeSlotValues: readonly ["1s", "5s", "10s", "30s", "1m", "5m", "10m", "15m", "30m", "1h", "2h", "3h", "6h", "12h", "24h"];
-export declare const TimeSlotSchema: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEnum<["1s", "5s", "10s", "30s", "1m", "5m", "10m", "15m", "30m", "1h", "2h", "3h", "6h", "12h", "24h"]>>;
+export declare const TimeSlotSchema: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEnum<{
+    "1s": "1s";
+    "5s": "5s";
+    "10s": "10s";
+    "30s": "30s";
+    "1m": "1m";
+    "5m": "5m";
+    "10m": "10m";
+    "15m": "15m";
+    "30m": "30m";
+    "1h": "1h";
+    "2h": "2h";
+    "3h": "3h";
+    "6h": "6h";
+    "12h": "12h";
+    "24h": "24h";
+}>>;
 /**
  * A time slot in human readable format.
  */