@tmlmobilidade/go-types-shared 20261107.2347.22 → 20261112.1211.10

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

@@ -13,16 +13,32 @@ export declare const ApiResponseSuccessSchema: z.ZodObject<{
 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;
+    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";
@@ -45,13 +61,22 @@ export declare const ApiResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     data: z.ZodNull;
     error: z.ZodString;
+    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";

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,5 +1,5 @@
 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 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";
@@ -8,8 +8,12 @@ export declare const HttpStatusSchema: z.ZodEnum<{
     401: "401";
     403: "403";
     404: "404";
+    405: "405";
+    408: "408";
     409: "409";
+    413: "413";
     415: "415";
+    422: "422";
     429: "429";
     500: "500";
     502: "502";

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/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/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.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.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/unix-millis.js

@@ -1,4 +1,5 @@
 /* * */
+import { validationTransform } from '@tmlmobilidade/go-utils-validation';
 import { DateTime } from 'luxon';
 import { z } from 'zod';
 /**
@@ -17,7 +18,7 @@ import { z } from 'zod';
  */
 export const UnixMillisecondsSchema = z
     .union([z.string(), z.number()])
-    .transform(validateUnixMilliseconds);
+    .transform(validationTransform(validateUnixMilliseconds, 'custom.formats.unix_milliseconds', { minimum: 1e10 }));
 /**
  * This function validates if a number is a valid Unix Timestamp, in milliseconds.
  * It is assumed the number will always be greater than 10^10 (1e10) to ensure it is in milliseconds.

package/dist/datetime/unix-seconds.js

@@ -1,4 +1,5 @@
 /* * */
+import { validationTransform } from '@tmlmobilidade/go-utils-validation';
 import { DateTime } from 'luxon';
 import { z } from 'zod';
 /**
@@ -17,7 +18,7 @@ import { z } from 'zod';
  */
 export const UnixSecondsSchema = z
     .union([z.string(), z.number()])
-    .transform(validateUnixSeconds);
+    .transform(validationTransform(validateUnixSeconds, 'custom.formats.unix_seconds', { minimum: 1e9 }));
 /**
  * This function validates if a number is a valid Unix Seconds, in seconds.
  * It is assumed the number will always be greater than 10^10 (1e10) to ensure it is in seconds.

package/dist/documents/comment.js

@@ -1,5 +1,6 @@
 /* * */
 import { BaseDocumentSchema } from './document.js';
+import { validationParams } from '@tmlmobilidade/go-utils-validation';
 import { z } from 'zod';
 /* * */
 const COMMENT_TYPE_OPTIONS = ['field_changed', 'note', 'crud'];
@@ -54,14 +55,14 @@ export const CommentSchema = z
             if (!data.metadata?.changes || data.metadata.changes.length === 0) {
                 ctx.addIssue({
                     code: 'custom',
-                    message: 'multiple_fields requires metadata.changes array',
+                    ...validationParams('custom.documents.changes_required'),
                     path: ['metadata', 'changes'],
                 });
             }
             if (data.curr_value !== null || data.prev_value !== null) {
                 ctx.addIssue({
                     code: 'custom',
-                    message: 'multiple_fields must have null curr_value and prev_value',
+                    ...validationParams('custom.documents.null_values'),
                     path: ['curr_value'],
                 });
             }
@@ -70,7 +71,7 @@ export const CommentSchema = z
             // If field is NOT 'multiple_fields', curr_value and prev_value must differ
             ctx.addIssue({
                 code: 'custom',
-                message: 'curr_value and prev_value must differ',
+                ...validationParams('custom.documents.different_values'),
                 path: ['curr_value'],
             });
         }

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import '@tmlmobilidade/go-utils-validation';
 export * from './api/index.js';
 export * from './conditions/index.js';
 export * from './datetime/index.js';

package/dist/index.js

@@ -1,3 +1,4 @@
+import '@tmlmobilidade/go-utils-validation';
 export * from './api/index.js';
 export * from './conditions/index.js';
 export * from './datetime/index.js';

package/dist/modules/module-id.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 export declare const ModuleIdValues: readonly ["apex", "core", "dates", "exporter", "hub", "infrastructure", "offer", "operation", "performance", "tracker"];
 export declare const ModuleIdSchema: z.ZodEnum<{
+    dates: "dates";
     apex: "apex";
     core: "core";
-    dates: "dates";
     exporter: "exporter";
     hub: "hub";
     infrastructure: "infrastructure";

package/dist/modules/module-scope.d.ts

@@ -3,9 +3,9 @@ export declare const ModuleScopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"platform">;
 }, z.core.$strict>, z.ZodObject<{
     module_ids: z.ZodArray<z.ZodEnum<{
+        dates: "dates";
         apex: "apex";
         core: "core";
-        dates: "dates";
         exporter: "exporter";
         hub: "hub";
         infrastructure: "infrastructure";

package/dist/modules/module-scope.js

@@ -1,10 +1,11 @@
+import { validationParams } from '@tmlmobilidade/go-utils-validation';
 import { z } from 'zod';
 import { ModuleIdSchema } from './module-id.js';
 /* * */
 export const ModuleScopeSchema = z.discriminatedUnion('type', [
     z.object({ type: z.literal('platform') }).strict(),
     z.object({
-        module_ids: z.array(ModuleIdSchema).nonempty().refine(ids => new Set(ids).size === ids.length, 'Module IDs must be unique'),
+        module_ids: z.array(ModuleIdSchema).nonempty().refine(ids => new Set(ids).size === ids.length, validationParams('custom.unique.module_ids')),
         type: z.literal('modules'),
     }).strict(),
 ]);

package/dist/utils/hex-color.js

@@ -1,4 +1,5 @@
 /* * */
+import { validationParams } from '@tmlmobilidade/go-utils-validation';
 import { z } from 'zod';
 /**
  * The schema for a hex color value.
@@ -15,5 +16,5 @@ export const HexColorSchema = z
     .coerce
     .string()
     .transform(value => value.startsWith('#') ? value : `#${value}`)
-    .refine(value => /^#[0-9A-Fa-f]{6}$/.test(value), { message: 'Expected a hex color in the format #RRGGBB' })
+    .refine(value => /^#[0-9A-Fa-f]{6}$/.test(value), validationParams('custom.formats.hex_color', { format: '#RRGGBB' }))
     .transform(value => value.toUpperCase());

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/go-types-shared",
-	"version": "20261107.2347.22",
+	"version": "20261112.1211.10",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"
@@ -36,6 +36,7 @@
 		"watch": "tsc-watch --onSuccess 'resolve-tspaths'"
 	},
 	"dependencies": {
+		"@tmlmobilidade/go-utils-validation": "*",
 		"luxon": "3.7.2",
 		"zod": "4.6.7"
 	},