@tmlmobilidade/go-types-shared 20260828.1727.14 → 20260829.23.20

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

@@ -3,12 +3,12 @@ export declare const ApiResponseSuccessSchema: z.ZodObject<{
     data: z.ZodUnknown;
     error: z.ZodNull;
     status_code: z.ZodEnum<["200", "201", "204"]>;
-    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-timestamp.js").UnixTimestamp, string | number>;
+    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>;
 }, "strip", z.ZodTypeAny, {
     error: null;
     status_code: "200" | "201" | "204";
     timestamp: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     data?: unknown;
 }, {
@@ -24,13 +24,13 @@ export declare const ApiResponseErrorSchema: z.ZodObject<{
     data: z.ZodNull;
     error: z.ZodString;
     status_code: z.ZodEnum<["400", "401", "403", "404", "500"]>;
-    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-timestamp.js").UnixTimestamp, string | number>;
+    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" | "500";
     timestamp: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
 }, {
     data: null;
@@ -43,12 +43,12 @@ export declare const ApiResponseSchema: z.ZodDiscriminatedUnion<"status_code", [
     data: z.ZodUnknown;
     error: z.ZodNull;
     status_code: z.ZodEnum<["200", "201", "204"]>;
-    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-timestamp.js").UnixTimestamp, string | number>;
+    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>;
 }, "strip", z.ZodTypeAny, {
     error: null;
     status_code: "200" | "201" | "204";
     timestamp: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     data?: unknown;
 }, {
@@ -60,13 +60,13 @@ export declare const ApiResponseSchema: z.ZodDiscriminatedUnion<"status_code", [
     data: z.ZodNull;
     error: z.ZodString;
     status_code: z.ZodEnum<["400", "401", "403", "404", "500"]>;
-    timestamp: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-timestamp.js").UnixTimestamp, string | number>;
+    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" | "500";
     timestamp: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
 }, {
     data: null;

package/dist/api/api-response.js

@@ -1,6 +1,6 @@
 /* * */
 import { z } from 'zod';
-import { UnixTimestampSchema } from '../datetime/unix-timestamp.js';
+import { UnixMillisecondsSchema } from '../datetime/unix-millis.js';
 import { HttpStatusSchema } from './http-status.js';
 /* * */
 export const ApiResponseSuccessSchema = z.object({
@@ -11,7 +11,7 @@ export const ApiResponseSuccessSchema = z.object({
         '201', // Created
         '204', // No Content
     ]),
-    timestamp: UnixTimestampSchema,
+    timestamp: UnixMillisecondsSchema,
 });
 /* * */
 export const ApiResponseErrorSchema = z.object({
@@ -24,7 +24,7 @@ export const ApiResponseErrorSchema = z.object({
         '404', // Not Found
         '500', // Internal Server Error
     ]),
-    timestamp: UnixTimestampSchema,
+    timestamp: UnixMillisecondsSchema,
 });
 /* * */
 export const ApiResponseSchema = z.discriminatedUnion('status_code', [ApiResponseSuccessSchema, ApiResponseErrorSchema]);

package/dist/datetime/index.d.ts

@@ -3,6 +3,8 @@ export * from './date-format.js';
 export * from './interval.js';
 export * from './operational-date-int.js';
 export * from './operational-date.js';
+export * from './operational-time.js';
 export * from './time-slot.js';
 export * from './timezone-identified.js';
-export * from './unix-timestamp.js';
+export * from './unix-millis.js';
+export * from './unix-seconds.js';

package/dist/datetime/index.js

@@ -3,6 +3,8 @@ export * from './date-format.js';
 export * from './interval.js';
 export * from './operational-date-int.js';
 export * from './operational-date.js';
+export * from './operational-time.js';
 export * from './time-slot.js';
 export * from './timezone-identified.js';
-export * from './unix-timestamp.js';
+export * from './unix-millis.js';
+export * from './unix-seconds.js';

package/dist/datetime/interval.d.ts

@@ -1,13 +1,13 @@
 import { z } from 'zod';
 export declare const TimeIntervalSchema: z.ZodObject<{
-    end: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("./unix-timestamp.js").UnixTimestamp, string | number>;
-    start: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("./unix-timestamp.js").UnixTimestamp, string | number>;
+    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: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     start: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
 }, {
     end: string | number;

package/dist/datetime/interval.js

@@ -1,8 +1,8 @@
 /* * */
 import { z } from 'zod';
-import { UnixTimestampSchema } from './unix-timestamp.js';
+import { UnixMillisecondsSchema } from './unix-millis.js';
 /* * */
 export const TimeIntervalSchema = z.object({
-    end: UnixTimestampSchema,
-    start: UnixTimestampSchema,
+    end: UnixMillisecondsSchema,
+    start: UnixMillisecondsSchema,
 });

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.ZodString, string, string>, string, string>, OperationalDateInt, string>;
+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>;

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

@@ -1,6 +1,7 @@
 /* * */
 import { DateTime } from 'luxon';
 import { z } from 'zod';
+import { CALENDAR_DATE_FORMAT } from './calendar-date.js';
 /**
  * The format for an operational date.
  */
@@ -17,8 +18,7 @@ export const OPERATIONAL_DATE_FORMAT = 'yyyyMMdd';
  * ```
  */
 export const OperationalDateIntSchema = z
-    .coerce
-    .string()
-    .transform(value => value.replaceAll('-', ''))
-    .refine(value => DateTime.fromFormat(value, OPERATIONAL_DATE_FORMAT).isValid, { message: `Expected a date in the format ${OPERATIONAL_DATE_FORMAT} (or yyyy-MM-dd)` })
+    .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}` })
     .transform(value => Number(value));

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

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const OPERATIONAL_TIME_FORMAT = "HH:mm:ss";
+/**
+ * Represents a Operational time in the format 'HH:mm:ss'.
+ * Times in this format represent the time of the day
+ * in which the given entity (trip, alerts, etc.) is valid.
+ * For example, a trip starting at 3:00 AM, with a a GTFS date of `20260619`,
+ * would have a start time of `27:00:00`, longer than 24 hours.
+ */
+export type OperationalTime = string & {
+    __brand: 'OperationalTime';
+};
+/**
+ * Represents a Operational time as a string in the format 'HH:mm:ss'.
+ */
+export declare const OperationalTimeSchema: z.ZodEffects<z.ZodString, OperationalTime, string>;
+/**
+ * This function validates if a string is a valid
+ * Operational time in the format 'HH:mm:ss'.
+ * Throws an error if the time is invalid.
+ * @param time The time to be validated.
+ * @returns The given string as a Operational time.
+ */
+export declare function validateOperationalTime(value: string): OperationalTime;

package/dist/datetime/operational-time.js

@@ -0,0 +1,35 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const OPERATIONAL_TIME_FORMAT = 'HH:mm:ss';
+/**
+ * Represents a Operational time as a string in the format 'HH:mm:ss'.
+ */
+export const OperationalTimeSchema = z
+    .string()
+    .transform(validateOperationalTime);
+/**
+ * This function validates if a string is a valid
+ * Operational time in the format 'HH:mm:ss'.
+ * Throws an error if the time is invalid.
+ * @param time The time to be validated.
+ * @returns The given string as a Operational time.
+ */
+export function validateOperationalTime(value) {
+    // Check the structure of the time string
+    if (!value.match(/^\d{2}:\d{2}:\d{2}$/))
+        throw new Error(`Invalid time format '${value}', expected format: ${OPERATIONAL_TIME_FORMAT}`);
+    // Parse the time string into hours, minutes, and seconds
+    const [hours, minutes, seconds] = value.split(':').map(Number);
+    // Check if hours are valid (hours can exceed 24)
+    if (hours < 0)
+        throw new Error(`Invalid hours in time value '${value}', expected format: ${OPERATIONAL_TIME_FORMAT}. Hours must be greater than or equal to 0.`);
+    // Check if minutes are valid
+    if (minutes < 0 || minutes > 59)
+        throw new Error(`Invalid minutes in time value '${value}', expected format: ${OPERATIONAL_TIME_FORMAT}. Minutes must be between 0 and 59.`);
+    // Check if seconds are valid
+    if (seconds < 0 || seconds > 59)
+        throw new Error(`Invalid seconds in time value '${value}', expected format: ${OPERATIONAL_TIME_FORMAT}. Seconds must be between 0 and 59.`);
+    // Return the time as a GTFS time
+    return value;
+}

package/dist/datetime/unix-millis.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * UnixMilliseconds, in this context, is a number that represents
+ * the number of milliseconds since the Unix epoch (1970-01-01T00:00:00Z).
+ */
+export type UnixMilliseconds = number & {
+    __brand: 'UnixMilliseconds';
+};
+/**
+ * The schema for a Unix timestamp value in milliseconds.
+ * @example
+ * ```ts
+ * const unixMilliseconds = UnixMillisecondsSchema.parse(1715025600000);
+ * // => 1715025600000 as UnixMilliseconds
+ *
+ * const unixMilliseconds = UnixMillisecondsSchema.parse('1715025600000');
+ * // => 1715025600000 as UnixMilliseconds
+ *
+ * const unixMilliseconds = UnixMillisecondsSchema.parse('not a number');
+ * // => Throws an error: 'Invalid value 'not a number', expected a number or string in milliseconds, but received a NaN'
+ * ```
+ */
+export declare const UnixMillisecondsSchema: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixMilliseconds, string | number>;
+/**
+ * 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.
+ * Throws an error if the date is invalid.
+ * @param value The number to be validated.
+ * @returns The given number as a UnixMilliseconds.
+ * @throws An error if the value is invalid.
+ * @example
+ * ```ts
+ * const unixMilliseconds = validateUnixMilliseconds(1715025600000);
+ * // => 1715025600000 as UnixMilliseconds
+ *
+ * const unixMilliseconds = validateUnixMilliseconds('1715025600000');
+ * // => 1715025600000 as UnixMilliseconds
+ *
+ * const unixMilliseconds = validateUnixMilliseconds('not a number');
+ * // => Throws an error: 'Invalid value 'not a number', expected a number in milliseconds but received a NaN'
+ * ```
+ */
+export declare function validateUnixMilliseconds(value: number | string): UnixMilliseconds;

package/dist/datetime/{unix-timestamp.js → unix-millis.js}

@@ -2,49 +2,51 @@
 import { DateTime } from 'luxon';
 import { z } from 'zod';
 /**
- * The schema for a Unix timestamp value.
+ * The schema for a Unix timestamp value in milliseconds.
  * @example
  * ```ts
- * const unixTimestamp = UnixTimestampSchema.parse(1715025600000);
- * // => 1715025600000 as UnixTimestamp
+ * const unixMilliseconds = UnixMillisecondsSchema.parse(1715025600000);
+ * // => 1715025600000 as UnixMilliseconds
  *
- * const unixTimestamp = UnixTimestampSchema.parse('1715025600000');
- * // => 1715025600000 as UnixTimestamp
+ * const unixMilliseconds = UnixMillisecondsSchema.parse('1715025600000');
+ * // => 1715025600000 as UnixMilliseconds
  *
- * const unixTimestamp = UnixTimestampSchema.parse('not a number');
+ * const unixMilliseconds = UnixMillisecondsSchema.parse('not a number');
  * // => Throws an error: 'Invalid value 'not a number', expected a number or string in milliseconds, but received a NaN'
  * ```
  */
-export const UnixTimestampSchema = z
+export const UnixMillisecondsSchema = z
     .union([z.string(), z.number()])
-    .transform(validateUnixTimestamp);
+    .transform(validateUnixMilliseconds);
 /**
  * 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.
  * Throws an error if the date is invalid.
  * @param value The number to be validated.
- * @returns The given number as a UnixTimestamp.
+ * @returns The given number as a UnixMilliseconds.
  * @throws An error if the value is invalid.
  * @example
  * ```ts
- * const unixTimestamp = validateUnixTimestamp(1715025600000);
- * // => 1715025600000 as UnixTimestamp
+ * const unixMilliseconds = validateUnixMilliseconds(1715025600000);
+ * // => 1715025600000 as UnixMilliseconds
  *
- * const unixTimestamp = validateUnixTimestamp('1715025600000');
- * // => 1715025600000 as UnixTimestamp
+ * const unixMilliseconds = validateUnixMilliseconds('1715025600000');
+ * // => 1715025600000 as UnixMilliseconds
  *
- * const unixTimestamp = validateUnixTimestamp('not a number');
+ * const unixMilliseconds = validateUnixMilliseconds('not a number');
  * // => Throws an error: 'Invalid value 'not a number', expected a number in milliseconds but received a NaN'
  * ```
  */
-export function validateUnixTimestamp(value) {
+export function validateUnixMilliseconds(value) {
     const valueAsNumber = Number(value);
     if (Number.isNaN(valueAsNumber))
         throw new Error(`Invalid value '${value}', expected a number in milliseconds but received a NaN`);
+    if (valueAsNumber <= 0)
+        throw new Error(`Invalid value '${value}', expected a number in milliseconds but received a number less than or equal to 0`);
     if (valueAsNumber < 1e10)
         throw new Error(`Invalid value '${value}', expected a number in milliseconds but received a number smaller than 1e10`);
     const parsedDate = DateTime.fromMillis(valueAsNumber);
     if (!parsedDate.isValid)
-        throw new Error(`Invalid UnixTimestamp value '${value}', explanation: ${parsedDate.invalidExplanation}`);
-    return parsedDate.toMillis();
+        throw new Error(`Invalid UnixMilliseconds value '${value}', explanation: ${parsedDate.invalidExplanation}`);
+    return valueAsNumber;
 }

package/dist/datetime/unix-seconds.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * UnixSeconds, in this context, is a number that represents
+ * the number of seconds since the Unix epoch (1970-01-01T00:00:00Z).
+ */
+export type UnixSeconds = number & {
+    __brand: 'UnixSeconds';
+};
+/**
+ * The schema for a Unix timestamp value in seconds.
+ * @example
+ * ```ts
+ * const unixSeconds = UnixSecondsSchema.parse(1715025600);
+ * // => 1715025600 as UnixSeconds
+ *
+ * const unixSeconds = UnixSecondsSchema.parse('1715025600');
+ * // => 1715025600 as UnixSeconds
+ *
+ * const unixSeconds = UnixSecondsSchema.parse('not a number');
+ * // => Throws an error: 'Invalid value 'not a number', expected a number or string in seconds, but received a NaN'
+ * ```
+ */
+export declare const UnixSecondsSchema: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixSeconds, string | number>;
+/**
+ * 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.
+ * Throws an error if the date is invalid.
+ * @param value The number to be validated.
+ * @returns The given number as a UnixSeconds.
+ * @throws An error if the value is invalid.
+ * @example
+ * ```ts
+ * const unixSeconds = validateUnixSeconds(1715025600);
+ * // => 1715025600 as UnixSeconds
+ *
+ * const unixSeconds = validateUnixSeconds('1715025600');
+ * // => 1715025600 as UnixSeconds
+ *
+ * const unixSeconds = validateUnixSeconds('not a number');
+ * // => Throws an error: 'Invalid value 'not a number', expected a number in seconds but received a NaN'
+ * ```
+ */
+export declare function validateUnixSeconds(value: number | string): UnixSeconds;

package/dist/datetime/unix-seconds.js

@@ -0,0 +1,52 @@
+/* * */
+import { DateTime } from 'luxon';
+import { z } from 'zod';
+/**
+ * The schema for a Unix timestamp value in seconds.
+ * @example
+ * ```ts
+ * const unixSeconds = UnixSecondsSchema.parse(1715025600);
+ * // => 1715025600 as UnixSeconds
+ *
+ * const unixSeconds = UnixSecondsSchema.parse('1715025600');
+ * // => 1715025600 as UnixSeconds
+ *
+ * const unixSeconds = UnixSecondsSchema.parse('not a number');
+ * // => Throws an error: 'Invalid value 'not a number', expected a number or string in seconds, but received a NaN'
+ * ```
+ */
+export const UnixSecondsSchema = z
+    .union([z.string(), z.number()])
+    .transform(validateUnixSeconds);
+/**
+ * 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.
+ * Throws an error if the date is invalid.
+ * @param value The number to be validated.
+ * @returns The given number as a UnixSeconds.
+ * @throws An error if the value is invalid.
+ * @example
+ * ```ts
+ * const unixSeconds = validateUnixSeconds(1715025600);
+ * // => 1715025600 as UnixSeconds
+ *
+ * const unixSeconds = validateUnixSeconds('1715025600');
+ * // => 1715025600 as UnixSeconds
+ *
+ * const unixSeconds = validateUnixSeconds('not a number');
+ * // => Throws an error: 'Invalid value 'not a number', expected a number in seconds but received a NaN'
+ * ```
+ */
+export function validateUnixSeconds(value) {
+    const valueAsNumber = Number(value);
+    if (Number.isNaN(valueAsNumber))
+        throw new Error(`Invalid value '${value}', expected a number in seconds but received a NaN`);
+    if (valueAsNumber <= 0)
+        throw new Error(`Invalid value '${value}', expected a number in seconds but received a number less than or equal to 0`);
+    if (valueAsNumber < 1e9)
+        throw new Error(`Invalid value '${value}', expected a number in seconds but received a number smaller than 1e9`);
+    const parsedDate = DateTime.fromSeconds(valueAsNumber);
+    if (!parsedDate.isValid)
+        throw new Error(`Invalid UnixSeconds value '${value}', explanation: ${parsedDate.invalidExplanation}`);
+    return valueAsNumber;
+}

package/dist/documents/comment.d.ts

@@ -20,19 +20,19 @@ export declare const NoteCommentSchema: z.ZodObject<{
     message: z.ZodString;
     type: z.ZodLiteral<"note">;
     _id: z.ZodOptional<z.ZodString>;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     message: string;
     type: "note";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     _id?: string | undefined;
     updated_by?: string | undefined;
@@ -48,9 +48,9 @@ export declare const NoteCommentSchema: z.ZodObject<{
 export declare const FieldChangedCommentSchema: z.ZodObject<{
     type: z.ZodLiteral<"field_changed">;
     _id: z.ZodOptional<z.ZodString>;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
     curr_value: z.ZodAny;
     field: z.ZodString;
@@ -85,11 +85,11 @@ export declare const FieldChangedCommentSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "field_changed";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     field: string;
     _id?: string | undefined;
@@ -124,19 +124,19 @@ export declare const FieldChangedCommentSchema: z.ZodObject<{
 export declare const CrudCommentSchema: z.ZodObject<{
     type: z.ZodLiteral<"crud">;
     _id: z.ZodOptional<z.ZodString>;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
     action: z.ZodEnum<["create", "update", "delete", "archive", "restore"]>;
 }, "strip", z.ZodTypeAny, {
     type: "crud";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     action: "create" | "update" | "delete" | "archive" | "restore";
     _id?: string | undefined;
@@ -154,19 +154,19 @@ export declare const CommentSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type",
     message: z.ZodString;
     type: z.ZodLiteral<"note">;
     _id: z.ZodOptional<z.ZodString>;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     message: string;
     type: "note";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     _id?: string | undefined;
     updated_by?: string | undefined;
@@ -181,9 +181,9 @@ export declare const CommentSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type",
 }>, z.ZodObject<{
     type: z.ZodLiteral<"field_changed">;
     _id: z.ZodOptional<z.ZodString>;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
     curr_value: z.ZodAny;
     field: z.ZodString;
@@ -218,11 +218,11 @@ export declare const CommentSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type",
 }, "strip", z.ZodTypeAny, {
     type: "field_changed";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     field: string;
     _id?: string | undefined;
@@ -256,19 +256,19 @@ export declare const CommentSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type",
 }>, z.ZodObject<{
     type: z.ZodLiteral<"crud">;
     _id: z.ZodOptional<z.ZodString>;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../index.js").UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
     action: z.ZodEnum<["create", "update", "delete", "archive", "restore"]>;
 }, "strip", z.ZodTypeAny, {
     type: "crud";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     action: "create" | "update" | "delete" | "archive" | "restore";
     _id?: string | undefined;
@@ -285,22 +285,22 @@ export declare const CommentSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type",
     message: string;
     type: "note";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     _id?: string | undefined;
     updated_by?: string | undefined;
 } | {
     type: "field_changed";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     field: string;
     _id?: string | undefined;
@@ -317,11 +317,11 @@ export declare const CommentSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type",
 } | {
     type: "crud";
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     action: "create" | "update" | "delete" | "archive" | "restore";
     _id?: string | undefined;

package/dist/documents/document.d.ts

@@ -1,20 +1,20 @@
 import { z } from 'zod';
 export declare const BaseDocumentSchema: z.ZodObject<{
     _id: z.ZodString;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-timestamp.js").UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     is_locked: z.ZodDefault<z.ZodBoolean>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-timestamp.js").UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, import("../datetime/unix-millis.js").UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     _id: string;
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     is_locked: boolean;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     updated_by?: string | undefined;
 }, {

package/dist/documents/document.js

@@ -1,12 +1,12 @@
 /* * */
-import { UnixTimestampSchema } from '../datetime/unix-timestamp.js';
+import { UnixMillisecondsSchema } from '../datetime/unix-millis.js';
 import { z } from 'zod';
 /* * */
 export const BaseDocumentSchema = z.object({
     _id: z.string(),
-    created_at: UnixTimestampSchema,
+    created_at: UnixMillisecondsSchema,
     created_by: z.string().nullable().default(null),
     is_locked: z.boolean().default(false),
-    updated_at: UnixTimestampSchema,
+    updated_at: UnixMillisecondsSchema,
     updated_by: z.string().optional(),
 });

package/dist/documents/proposed-change.d.ts

@@ -1,14 +1,14 @@
-import { type UnixTimestamp } from '../datetime/unix-timestamp.js';
+import { type UnixMilliseconds } from '../datetime/unix-millis.js';
 import { type ApprovalStatus } from '../status/approval.js';
 import { z } from 'zod';
 export declare const ScopeSchema: z.ZodEnum<["stop", "lines"]>;
 export type Scope = z.infer<typeof ScopeSchema>;
 export declare const ProposedChangeSchema: z.ZodObject<{
     _id: z.ZodString;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     is_locked: z.ZodDefault<z.ZodBoolean>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
 } & {
     curr_value: z.ZodAny;
@@ -20,12 +20,12 @@ export declare const ProposedChangeSchema: z.ZodObject<{
     status: "pending" | "approved" | "rejected" | "none";
     _id: string;
     created_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     created_by: string | null;
     is_locked: boolean;
     updated_at: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     field: string;
     related_id: string;
@@ -48,23 +48,23 @@ export declare const ProposedChangeSchema: z.ZodObject<{
 export type ProposedChange<T> = {
     [P in keyof T]: {
         _id: string;
-        created_at: UnixTimestamp;
+        created_at: UnixMilliseconds;
         created_by: string;
         curr_value: T[P];
         field: P;
         related_id: string;
         scope: Scope;
         status: ApprovalStatus;
-        updated_at: UnixTimestamp;
+        updated_at: UnixMilliseconds;
         updated_by: string;
     };
 }[keyof T];
 export declare const CreateProposedChangeSchema: z.ZodObject<Omit<{
     _id: z.ZodString;
-    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixTimestamp, string | number>;
+    created_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixMilliseconds, string | number>;
     created_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     is_locked: z.ZodDefault<z.ZodBoolean>;
-    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixTimestamp, string | number>;
+    updated_at: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixMilliseconds, string | number>;
     updated_by: z.ZodOptional<z.ZodString>;
 } & {
     curr_value: z.ZodAny;

package/dist/numbers/float.d.ts

@@ -12,4 +12,4 @@ import { z } from 'zod';
  * // => 1
  * ```
  */
-export declare const FloatSchema: z.ZodNumber;
+export declare const FloatSchema: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;

package/dist/numbers/float.js

@@ -14,5 +14,5 @@ import { z } from 'zod';
  * ```
  */
 export const FloatSchema = z
-    .coerce
-    .number();
+    .union([z.string(), z.number()])
+    .transform(value => Number(value));

package/dist/numbers/integer.d.ts

@@ -12,4 +12,4 @@ import { z } from 'zod';
  * // => 1
  * ```
  */
-export declare const IntegerSchema: z.ZodNumber;
+export declare const IntegerSchema: z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>, z.ZodNumber>;

package/dist/numbers/integer.js

@@ -14,6 +14,6 @@ import { z } from 'zod';
  * ```
  */
 export const IntegerSchema = z
-    .coerce
-    .number()
-    .int();
+    .union([z.string(), z.number()])
+    .transform(value => Number(value))
+    .pipe(z.number().int());

package/dist/numbers/non-negative-float.d.ts

@@ -14,4 +14,4 @@ import { z } from 'zod';
  * // => 0
  * ```
  */
-export declare const NonNegativeFloatSchema: z.ZodNumber;
+export declare const NonNegativeFloatSchema: z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>, z.ZodNumber>;

package/dist/numbers/non-negative-float.js

@@ -16,6 +16,6 @@ import { z } from 'zod';
  * ```
  */
 export const NonNegativeFloatSchema = z
-    .coerce
-    .number()
-    .nonnegative();
+    .union([z.string(), z.number()])
+    .transform(value => Number(value))
+    .pipe(z.number().nonnegative());

package/dist/numbers/non-negative-integer.d.ts

@@ -14,4 +14,4 @@ import { z } from 'zod';
  * // => 0
  * ```
  */
-export declare const NonNegativeIntegerSchema: z.ZodNumber;
+export declare const NonNegativeIntegerSchema: z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>, z.ZodNumber>;

package/dist/numbers/non-negative-integer.js

@@ -16,7 +16,6 @@ import { z } from 'zod';
  * ```
  */
 export const NonNegativeIntegerSchema = z
-    .coerce
-    .number()
-    .int()
-    .nonnegative();
+    .union([z.string(), z.number()])
+    .transform(value => Number(value))
+    .pipe(z.number().int().nonnegative());

package/dist/numbers/percent.d.ts

@@ -16,4 +16,4 @@ import { z } from 'zod';
  * // => throws an error
  * ```
  */
-export declare const PercentSchema: z.ZodNumber;
+export declare const PercentSchema: z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>, z.ZodNumber>;

package/dist/numbers/percent.js

@@ -18,8 +18,6 @@ import { z } from 'zod';
  * ```
  */
 export const PercentSchema = z
-    .coerce
-    .number()
-    .int()
-    .min(0)
-    .max(100);
+    .union([z.string(), z.number()])
+    .transform(value => Number(value))
+    .pipe(z.number().int().min(0).max(100));

package/dist/utils/index.d.ts

@@ -1,3 +1,3 @@
 export * from './environment.js';
 export * from './hex-color.js';
-export * from './i18n-code.js';
+export * from './language-tag.js';

package/dist/utils/index.js

@@ -1,3 +1,3 @@
 export * from './environment.js';
 export * from './hex-color.js';
-export * from './i18n-code.js';
+export * from './language-tag.js';

package/dist/utils/language-tag.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const LanguageTagValues: readonly ["pt", "es", "en"];
+export declare const LanguageTagSchema: z.ZodEnum<["pt", "es", "en"]>;
+/**
+ * A language tag as defined by the IANA language subtag registry.
+ * @see https://www.w3.org/International/articles/language-tags
+ */
+export type LanguageTag = z.infer<typeof LanguageTagSchema>;

package/dist/utils/language-tag.js

@@ -0,0 +1,9 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const LanguageTagValues = [
+    'pt',
+    'es',
+    'en',
+];
+export const LanguageTagSchema = z.enum(LanguageTagValues);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/go-types-shared",
-	"version": "20260828.1727.14",
+	"version": "20260829.23.20",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"

package/dist/datetime/unix-timestamp.d.ts

@@ -1,43 +0,0 @@
-import { z } from 'zod';
-/**
- * UnixTimestamp, in this context, is a number that represents
- * the number of milliseconds since the Unix epoch (1970-01-01T00:00:00Z).
- */
-export type UnixTimestamp = number & {
-    __brand: 'UnixTimestamp';
-};
-/**
- * The schema for a Unix timestamp value.
- * @example
- * ```ts
- * const unixTimestamp = UnixTimestampSchema.parse(1715025600000);
- * // => 1715025600000 as UnixTimestamp
- *
- * const unixTimestamp = UnixTimestampSchema.parse('1715025600000');
- * // => 1715025600000 as UnixTimestamp
- *
- * const unixTimestamp = UnixTimestampSchema.parse('not a number');
- * // => Throws an error: 'Invalid value 'not a number', expected a number or string in milliseconds, but received a NaN'
- * ```
- */
-export declare const UnixTimestampSchema: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, UnixTimestamp, string | number>;
-/**
- * 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.
- * Throws an error if the date is invalid.
- * @param value The number to be validated.
- * @returns The given number as a UnixTimestamp.
- * @throws An error if the value is invalid.
- * @example
- * ```ts
- * const unixTimestamp = validateUnixTimestamp(1715025600000);
- * // => 1715025600000 as UnixTimestamp
- *
- * const unixTimestamp = validateUnixTimestamp('1715025600000');
- * // => 1715025600000 as UnixTimestamp
- *
- * const unixTimestamp = validateUnixTimestamp('not a number');
- * // => Throws an error: 'Invalid value 'not a number', expected a number in milliseconds but received a NaN'
- * ```
- */
-export declare function validateUnixTimestamp(value: number | string): UnixTimestamp;

package/dist/utils/i18n-code.d.ts

@@ -1,4 +0,0 @@
-import { z } from 'zod';
-export declare const I18nCodeValues: readonly ["en", "pt"];
-export declare const I18nCodeSchema: z.ZodEnum<["en", "pt"]>;
-export type I18nCode = z.infer<typeof I18nCodeSchema>;

package/dist/utils/i18n-code.js

@@ -1,9 +0,0 @@
-/* * */
-import { z } from 'zod';
-/* * */
-export const I18nCodeValues = [
-    'en',
-    // 'es',
-    'pt',
-];
-export const I18nCodeSchema = z.enum(I18nCodeValues);