@tmlmobilidade/go-types-shared 20260611.1527.25

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './dates/index.js';
+export * from './documents/comment.js';
+export * from './documents/document.js';
+export * from './environment.js';
+export * from './fastify.js';
+export * from './i18n-code.js';
+export * from './position.js';
+export * from './status/index.js';
+export * from './utility.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './dates/index.js';
+export * from './documents/comment.js';
+export * from './documents/document.js';
+export * from './environment.js';
+export * from './fastify.js';
+export * from './i18n-code.js';
+export * from './position.js';
+export * from './status/index.js';
+export * from './utility.js';

package/dist/position.d.ts

@@ -0,0 +1,160 @@
+import z from 'zod';
+export declare const PositionSchema: z.ZodObject<{
+    geohash: z.ZodString;
+    h3: z.ZodString;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    geohash: string;
+    h3: string;
+    latitude: number;
+    longitude: number;
+}, {
+    geohash: string;
+    h3: string;
+    latitude: number;
+    longitude: number;
+}>;
+export declare const ExtendedPositionSchema: z.ZodObject<{
+    geohash: z.ZodObject<{
+        geohash_2: z.ZodString;
+        geohash_3: z.ZodString;
+        geohash_4: z.ZodString;
+        geohash_5: z.ZodString;
+        geohash_6: z.ZodString;
+        geohash_7: z.ZodString;
+        geohash_8: z.ZodString;
+        geohash_9: z.ZodString;
+        geohash_10: z.ZodString;
+        geohash_11: z.ZodString;
+        geohash_12: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        geohash_2: string;
+        geohash_3: string;
+        geohash_4: string;
+        geohash_5: string;
+        geohash_6: string;
+        geohash_7: string;
+        geohash_8: string;
+        geohash_9: string;
+        geohash_10: string;
+        geohash_11: string;
+        geohash_12: string;
+    }, {
+        geohash_2: string;
+        geohash_3: string;
+        geohash_4: string;
+        geohash_5: string;
+        geohash_6: string;
+        geohash_7: string;
+        geohash_8: string;
+        geohash_9: string;
+        geohash_10: string;
+        geohash_11: string;
+        geohash_12: string;
+    }>;
+    h3: z.ZodObject<{
+        h3_1: z.ZodString;
+        h3_2: z.ZodString;
+        h3_3: z.ZodString;
+        h3_4: z.ZodString;
+        h3_5: z.ZodString;
+        h3_6: z.ZodString;
+        h3_7: z.ZodString;
+        h3_8: z.ZodString;
+        h3_9: z.ZodString;
+        h3_10: z.ZodString;
+        h3_11: z.ZodString;
+        h3_12: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        h3_1: string;
+        h3_2: string;
+        h3_3: string;
+        h3_4: string;
+        h3_5: string;
+        h3_6: string;
+        h3_7: string;
+        h3_8: string;
+        h3_9: string;
+        h3_10: string;
+        h3_11: string;
+        h3_12: string;
+    }, {
+        h3_1: string;
+        h3_2: string;
+        h3_3: string;
+        h3_4: string;
+        h3_5: string;
+        h3_6: string;
+        h3_7: string;
+        h3_8: string;
+        h3_9: string;
+        h3_10: string;
+        h3_11: string;
+        h3_12: string;
+    }>;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    geohash: {
+        geohash_2: string;
+        geohash_3: string;
+        geohash_4: string;
+        geohash_5: string;
+        geohash_6: string;
+        geohash_7: string;
+        geohash_8: string;
+        geohash_9: string;
+        geohash_10: string;
+        geohash_11: string;
+        geohash_12: string;
+    };
+    h3: {
+        h3_1: string;
+        h3_2: string;
+        h3_3: string;
+        h3_4: string;
+        h3_5: string;
+        h3_6: string;
+        h3_7: string;
+        h3_8: string;
+        h3_9: string;
+        h3_10: string;
+        h3_11: string;
+        h3_12: string;
+    };
+    latitude: number;
+    longitude: number;
+}, {
+    geohash: {
+        geohash_2: string;
+        geohash_3: string;
+        geohash_4: string;
+        geohash_5: string;
+        geohash_6: string;
+        geohash_7: string;
+        geohash_8: string;
+        geohash_9: string;
+        geohash_10: string;
+        geohash_11: string;
+        geohash_12: string;
+    };
+    h3: {
+        h3_1: string;
+        h3_2: string;
+        h3_3: string;
+        h3_4: string;
+        h3_5: string;
+        h3_6: string;
+        h3_7: string;
+        h3_8: string;
+        h3_9: string;
+        h3_10: string;
+        h3_11: string;
+        h3_12: string;
+    };
+    latitude: number;
+    longitude: number;
+}>;
+export type Position = z.infer<typeof PositionSchema>;
+export type ExtendedPosition = z.infer<typeof ExtendedPositionSchema>;

package/dist/position.js

@@ -0,0 +1,41 @@
+import z from 'zod';
+/* * */
+export const PositionSchema = z.object({
+    geohash: z.string(),
+    h3: z.string(),
+    latitude: z.number(),
+    longitude: z.number(),
+});
+export const ExtendedPositionSchema = z.object({
+    geohash: z.object({
+        geohash_2: z.string(),
+        geohash_3: z.string(),
+        geohash_4: z.string(),
+        geohash_5: z.string(),
+        geohash_6: z.string(),
+        geohash_7: z.string(),
+        geohash_8: z.string(),
+        geohash_9: z.string(),
+        //
+        geohash_10: z.string(),
+        geohash_11: z.string(),
+        geohash_12: z.string(),
+    }),
+    h3: z.object({
+        h3_1: z.string(),
+        h3_2: z.string(),
+        h3_3: z.string(),
+        h3_4: z.string(),
+        h3_5: z.string(),
+        h3_6: z.string(),
+        h3_7: z.string(),
+        h3_8: z.string(),
+        h3_9: z.string(),
+        //
+        h3_10: z.string(),
+        h3_11: z.string(),
+        h3_12: z.string(),
+    }),
+    latitude: z.number(),
+    longitude: z.number(),
+});

package/dist/status/approval.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const ApprovalStatusValues: readonly ["pending", "approved", "rejected", "none"];
+export declare const ApprovalStatusSchema: z.ZodEnum<["pending", "approved", "rejected", "none"]>;
+export type ApprovalStatus = z.infer<typeof ApprovalStatusSchema>;

package/dist/status/approval.js

@@ -0,0 +1,10 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const ApprovalStatusValues = [
+    'pending',
+    'approved',
+    'rejected',
+    'none',
+];
+export const ApprovalStatusSchema = z.enum(ApprovalStatusValues);

package/dist/status/availability.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const AvailabilityStatusValues: readonly ["available", "unavailable", "unknown"];
+export declare const AvailabilityStatusSchema: z.ZodEnum<["available", "unavailable", "unknown"]>;
+export type AvailabilityStatus = z.infer<typeof AvailabilityStatusSchema>;

package/dist/status/availability.js

@@ -0,0 +1,9 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const AvailabilityStatusValues = [
+    'available',
+    'unavailable',
+    'unknown',
+];
+export const AvailabilityStatusSchema = z.enum(AvailabilityStatusValues);

package/dist/status/condition.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const ConditionStatusValues: readonly ["not_applicable", "unknown", "missing", "damaged", "ok"];
+export declare const ConditionStatusSchema: z.ZodEnum<["not_applicable", "unknown", "missing", "damaged", "ok"]>;
+export type ConditionStatus = z.infer<typeof ConditionStatusSchema>;

package/dist/status/condition.js

@@ -0,0 +1,11 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const ConditionStatusValues = [
+    'not_applicable',
+    'unknown',
+    'missing',
+    'damaged',
+    'ok',
+];
+export const ConditionStatusSchema = z.enum(ConditionStatusValues);

package/dist/status/delay.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const DelayStatusValues: readonly ["ontime", "delayed", "early", "none"];
+export declare const DelayStatusSchema: z.ZodEnum<["ontime", "delayed", "early", "none"]>;
+export type DelayStatus = z.infer<typeof DelayStatusSchema>;

package/dist/status/delay.js

@@ -0,0 +1,10 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const DelayStatusValues = [
+    'ontime',
+    'delayed',
+    'early',
+    'none',
+];
+export const DelayStatusSchema = z.enum(DelayStatusValues);

package/dist/status/index.d.ts

@@ -0,0 +1,12 @@
+export * from './approval.js';
+export * from './availability.js';
+export * from './condition.js';
+export * from './delay.js';
+export * from './lifecycle.js';
+export * from './operational.js';
+export * from './processing.js';
+export * from './publish.js';
+export * from './seen.js';
+export * from './system.js';
+export * from './ticketing.js';
+export * from './validity.js';

package/dist/status/index.js

@@ -0,0 +1,12 @@
+export * from './approval.js';
+export * from './availability.js';
+export * from './condition.js';
+export * from './delay.js';
+export * from './lifecycle.js';
+export * from './operational.js';
+export * from './processing.js';
+export * from './publish.js';
+export * from './seen.js';
+export * from './system.js';
+export * from './ticketing.js';
+export * from './validity.js';

package/dist/status/lifecycle.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const LifecycleStatusValues: readonly ["draft", "active", "inactive", "provisional", "seasonal", "voided"];
+export declare const LifecycleStatusSchema: z.ZodEnum<["draft", "active", "inactive", "provisional", "seasonal", "voided"]>;
+export type LifecycleStatus = z.infer<typeof LifecycleStatusSchema>;

package/dist/status/lifecycle.js

@@ -0,0 +1,12 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const LifecycleStatusValues = [
+    'draft',
+    'active',
+    'inactive',
+    'provisional',
+    'seasonal',
+    'voided',
+];
+export const LifecycleStatusSchema = z.enum(LifecycleStatusValues);

package/dist/status/operational.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const OperationalStatusValues: readonly ["ended", "missed", "running", "scheduled"];
+export declare const OperationalStatusSchema: z.ZodEnum<["ended", "missed", "running", "scheduled"]>;
+export type OperationalStatus = z.infer<typeof OperationalStatusSchema>;

package/dist/status/operational.js

@@ -0,0 +1,10 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const OperationalStatusValues = [
+    'ended',
+    'missed',
+    'running',
+    'scheduled',
+];
+export const OperationalStatusSchema = z.enum(OperationalStatusValues);

package/dist/status/processing.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const ProcessingStatusValues: readonly ["waiting", "processing", "complete", "error", "skipped"];
+export declare const ProcessingStatusSchema: z.ZodEnum<["waiting", "processing", "complete", "error", "skipped"]>;
+export type ProcessingStatus = z.infer<typeof ProcessingStatusSchema>;

package/dist/status/processing.js

@@ -0,0 +1,11 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const ProcessingStatusValues = [
+    'waiting',
+    'processing',
+    'complete',
+    'error',
+    'skipped',
+];
+export const ProcessingStatusSchema = z.enum(ProcessingStatusValues);

package/dist/status/publish.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const PublishStatusValues: readonly ["published", "archived", "draft"];
+export declare const PublishStatusSchema: z.ZodEnum<["published", "archived", "draft"]>;
+export type PublishStatus = z.infer<typeof PublishStatusSchema>;

package/dist/status/publish.js

@@ -0,0 +1,9 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const PublishStatusValues = [
+    'published',
+    'archived',
+    'draft',
+];
+export const PublishStatusSchema = z.enum(PublishStatusValues);

package/dist/status/seen.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const SeenStatusValues: readonly ["unseen", "seen", "gone"];
+export declare const SeenStatusSchema: z.ZodEnum<["unseen", "seen", "gone"]>;
+export type SeenStatus = z.infer<typeof SeenStatusSchema>;

package/dist/status/seen.js

@@ -0,0 +1,9 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const SeenStatusValues = [
+    'unseen',
+    'seen',
+    'gone',
+];
+export const SeenStatusSchema = z.enum(SeenStatusValues);

package/dist/status/system.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const SystemStatusValues: readonly ["waiting", "incomplete", "complete", "error"];
+export declare const SystemStatusSchema: z.ZodEnum<["waiting", "incomplete", "complete", "error"]>;
+export type SystemStatus = z.infer<typeof SystemStatusSchema>;

package/dist/status/system.js

@@ -0,0 +1,10 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const SystemStatusValues = [
+    'waiting',
+    'incomplete',
+    'complete',
+    'error',
+];
+export const SystemStatusSchema = z.enum(SystemStatusValues);

package/dist/status/ticketing.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const TicketingStatusValues: readonly ["has_ticketing", "no_ticketing"];
+export declare const TicketingStatusSchema: z.ZodEnum<["has_ticketing", "no_ticketing"]>;
+export type TicketingStatus = z.infer<typeof TicketingStatusSchema>;

package/dist/status/ticketing.js

@@ -0,0 +1,8 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const TicketingStatusValues = [
+    'has_ticketing',
+    'no_ticketing',
+];
+export const TicketingStatusSchema = z.enum(TicketingStatusValues);

package/dist/status/validity.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const ValidityStatusValues: readonly ["valid", "invalid", "unknown"];
+export declare const ValidityStatusSchema: z.ZodEnum<["valid", "invalid", "unknown"]>;
+export type ValidityStatus = z.infer<typeof ValidityStatusSchema>;

package/dist/status/validity.js

@@ -0,0 +1,9 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const ValidityStatusValues = [
+    'valid',
+    'invalid',
+    'unknown',
+];
+export const ValidityStatusSchema = z.enum(ValidityStatusValues);

package/dist/utility.d.ts

@@ -0,0 +1,83 @@
+/**
+ * A type that represents either a single instance of type T or an array of type T.
+ *
+ * @template T - The type of the element(s).
+ *
+ * @example
+ * ```ts
+ * function processItems<T>(items: OneOrMore<T>) {
+ *   const arr = Array.isArray(items) ? items : [items];
+ *   console.log(arr);
+ * }
+ *
+ * processItems("apple");      // ["apple"]
+ * processItems(["a", "b"]);   // ["a", "b"]
+ * ```
+ */
+export type OneOrMore<T> = T | T[];
+/**
+ * A type that represents either A or B, but not both.
+ *
+ * @template A - The first type.
+ * @template B - The second type.
+ *
+ * @example
+ * ```ts
+ * type Credentials = OneOrTheOther<{ email: string }, { username: string }>;
+ *
+ * const a: Credentials = { email: "a@b.com" };    // ✅
+ * const b: Credentials = { username: "user1" };   // ✅
+ * const c: Credentials = { email: "a@b.com", username: "user1" }; // ❌
+ * ```
+ */
+export type OneOrTheOther<A, B> = (A & {
+    [K in keyof B]?: never;
+}) | (B & {
+    [K in keyof A]?: never;
+});
+/**
+ * A type that represents exactly one key-value pair in the object T.
+ *
+ * @template T - The type of the object.
+ *
+ * @example
+ * ```ts
+type Action = ExactlyOne<{
+  create: { name: string };
+  update: { id: string; name?: string };
+  delete: { id: string };
+}>;
+
+const x: Action = { create: { name: "New" } }; // ✅
+const y: Action = { update: { id: "123" } };   // ✅
+const z: Action = { create: { name: "X" }, delete: { id: "1" } }; // ❌
+ * ```
+ */
+export type ExactlyOne<T> = {
+    [K in keyof T]: Partial<Record<Exclude<keyof T, K>, never>> & {
+        [P in K]: T[P];
+    };
+}[keyof T];
+/**
+ * A type that represents either none or exactly one key-value pair in the object T.
+ *
+ * @template T - The type of the object.
+ *
+ * @example
+ * ```ts
+ * type Filters = { name: string; age: number; email: string };
+ * type FilterChoice = NoneOrExactlyOne<Filters>;
+ *
+ * const a: FilterChoice = {}; // ✅ none
+ * const b: FilterChoice = { name: "Alice" }; // ✅ exactly one
+ * const c: FilterChoice = { age: 30 }; // ✅ exactly one
+ * const d: FilterChoice = { name: "Alice", age: 30 }; // ❌ error
+ * ```
+ */
+export type NoneOrExactlyOne<T> = {
+    [K in keyof T]: Partial<Record<Exclude<keyof T, K>, never>> & {
+        [P in K]: T[P];
+    };
+}[keyof T] | {
+    [K in keyof T]?: never;
+};

package/dist/utility.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@tmlmobilidade/go-types-shared",
+	"version": "20260611.1527.25",
+	"author": {
+		"email": "iso@tmlmobilidade.pt",
+		"name": "TML-ISO"
+	},
+	"license": "AGPL-3.0-or-later",
+	"homepage": "https://go.tmlmobilidade.pt",
+	"bugs": {
+		"url": "https://github.com/tmlmobilidade/go/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/tmlmobilidade/go.git"
+	},
+	"keywords": [
+		"public transit",
+		"tml",
+		"transportes metropolitanos de lisboa",
+		"go"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"type": "module",
+	"files": [
+		"dist"
+	],
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"build": "tsc && resolve-tspaths",
+		"lint": "eslint ./src/ && tsc --noEmit",
+		"lint:fix": "eslint ./src/ --fix",
+		"watch": "tsc-watch --onSuccess 'resolve-tspaths'"
+	},
+	"dependencies": {
+		"luxon": "3.7.2",
+		"zod": "3.25.76"
+	},
+	"devDependencies": {
+		"@tmlmobilidade/tsconfig": "*",
+		"@types/luxon": "3.7.1",
+		"@types/node": "25.9.3",
+		"resolve-tspaths": "0.8.23",
+		"tsc-watch": "7.2.0",
+		"typescript": "6.0.3"
+	}
+}