haystack-contracts 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -1,170 +1,1397 @@
 /**
- * Standard success response returned by all Haystack API endpoints.
- * @template T The shape of the `data` payload.
+ * Single source of truth for public API metadata shared by:
+ * - `haystack-contracts` (npm package)
+ * - `apps/api` OpenAPI export (`public-api-docs.config.ts`)
+ *
+ * Update here only — do not duplicate URLs or info text elsewhere.
  */
-interface ApiResponse<T = unknown> {
-    /** Always `true` for success responses */
+declare const PUBLIC_API_META: {
+    readonly openapiVersion: "3.0.3";
+    readonly apiVersion: "v1";
+    readonly apiBasePath: "/api/v1";
+    readonly productionHost: "https://api.haystackrobotics.com";
+    readonly info: {
+        readonly title: "Haystack Robotics API";
+        readonly version: "1.0.0";
+        readonly description: string;
+        readonly contact: {
+            readonly name: "Haystack Robotics";
+            readonly url: "https://docs.haystack-robotics.com";
+            readonly email: "support@haystackrobotics.com";
+        };
+    };
+    /** Relative to the `haystack-contracts` package root (published to npm). */
+    readonly openapiRelativePath: "openapi.json";
+};
+declare const HAYSTACK_API_VERSION: "v1";
+declare const HAYSTACK_API_BASE_PATH: "/api/v1";
+declare const HAYSTACK_PRODUCTION_API_URL: "https://api.haystackrobotics.com/api/v1";
+/** npm package subpath for the public OpenAPI document (docs sites, Swagger UI, Redoc). */
+declare const PUBLIC_OPENAPI_JSON: "./openapi.json";
+
+/** Auto-generated from openapi.json — do not edit. */
+declare const PublicApiPath: {
+    readonly analyticsAgg: {
+        readonly disinfectionCount: "/analytics-agg/disinfection-count";
+        readonly disinfectionOperator: "/analytics-agg/disinfection-operator";
+        readonly disinfectionStatus: "/analytics-agg/disinfection-status";
+        readonly robotsCount: "/analytics-agg/robots-count";
+    };
+    readonly auth: {
+        readonly login: "/auth/login";
+    };
+    readonly disinfection: {
+        readonly jobs: "/disinfection/jobs";
+        readonly ongoingJobs: "/disinfection/ongoing-jobs";
+        readonly robots: "/disinfection/robots";
+    };
+    readonly metrics: {
+        readonly robotValues: {
+            readonly byRobotId: (robotId: string) => string;
+        };
+        readonly types: "/metrics/types";
+    };
+    readonly robots: {
+        readonly list: "/robots";
+        readonly byId: (id: string) => string;
+    };
+};
+
+/** Auto-generated from openapi.json — do not edit. */
+declare const Role: {
+    readonly TENANT_ADMIN: "TENANT_ADMIN";
+    readonly WORKSPACE_ADMIN: "WORKSPACE_ADMIN";
+    readonly FACILITY_ADMIN: "FACILITY_ADMIN";
+    readonly FLEET_OPERATOR: "FLEET_OPERATOR";
+    readonly FLEET_VIEWER: "FLEET_VIEWER";
+};
+type Role = (typeof Role)[keyof typeof Role];
+declare const ScopeType: {
+    readonly TENANT: "tenant";
+    readonly WORKSPACE: "workspace";
+    readonly FACILITY: "facility";
+    readonly FLEET: "fleet";
+};
+type ScopeType = (typeof ScopeType)[keyof typeof ScopeType];
+declare const MetricDataType: {
+    readonly NUMERIC: "numeric";
+    readonly STRING: "string";
+};
+type MetricDataType = (typeof MetricDataType)[keyof typeof MetricDataType];
+declare const MetricSourceType: {
+    readonly NON_STREAM: "non_stream";
+    readonly STREAM: "stream";
+};
+type MetricSourceType = (typeof MetricSourceType)[keyof typeof MetricSourceType];
+declare const AnalyticsAggregateStatus: {
+    readonly SUCCESS: "success";
+    readonly ERROR: "error";
+};
+type AnalyticsAggregateStatus = (typeof AnalyticsAggregateStatus)[keyof typeof AnalyticsAggregateStatus];
+
+interface paths {
+    "/auth/login": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Login with email and password
+         * @description Authenticates a user using a globally unique email address and password. This endpoint is public and does not require a bearer token.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["LoginDto"];
+                };
+            };
+            responses: {
+                /** @description Authenticated successfully and returned access/refresh tokens. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["AuthResponseDto"];
+                        };
+                    };
+                };
+                /** @description Validation failed. Check that all required fields are present and correctly typed. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 400,
+                         *       "error": "Bad Request",
+                         *       "message": "email must be an email"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/robots": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all robots
+         * @description Returns all robots registered in the configured tenant, ordered by online status and name. Each record includes the robot name, tenant, fleet assignment, online status, subscription status, and last-seen timestamp. Any authenticated user can access this endpoint.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of robots in the current tenant. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["RobotListItemDto"][];
+                        };
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/robots/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a robot by ID
+         * @description Returns the full record for a single robot, including its fleet assignment, online state, and timestamps.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description UUID of the robot. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Robot record. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["RobotListItemDto"];
+                        };
+                    };
+                };
+                /** @description Validation failed. Check that all required fields are present and correctly typed. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 400,
+                         *       "error": "Bad Request",
+                         *       "message": "email must be an email"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Robot not found in the current tenant. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 404,
+                         *       "error": "Not Found",
+                         *       "message": "Robot not found"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/metrics/types": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all metric types
+         * @description Returns the full registry of metric types from the analytics store. Each entry includes an integer id, a human-readable name, and a description. Any authenticated user can access this endpoint.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of all registered metric types. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["MetricTypeResponseDto"][];
+                        };
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/metrics/robot-values/{robotId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List latest metric values for a robot
+         * @description Returns the most recent reading for every metric type collected for the specified robot from the analytics (OLAP) store. Pass `metricType` as a query param to restrict results to a single type.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Integer id of a specific metric type to filter by. */
+                    metricType?: number;
+                };
+                header?: never;
+                path: {
+                    /** @description UUID of the robot. */
+                    robotId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Latest OLAP metric readings for the robot. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["RobotMetricLiveDto"][];
+                        };
+                    };
+                };
+                /** @description Validation failed. Check that all required fields are present and correctly typed. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 400,
+                         *       "error": "Bad Request",
+                         *       "message": "email must be an email"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/disinfection/robots": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get per-robot disinfection stats
+         * @description Returns aggregated disinfection statistics for every robot in the current tenant. Includes bot name, facility name, room count, total duration, and success/partial/failed job counts.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Per-robot disinfection statistics for the current tenant. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["RobotDisinfectionStatsDto"][];
+                        };
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/disinfection/ongoing-jobs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List ongoing disinfection jobs
+         * @description Returns currently active disinfection jobs from OLTP. TODO: not yet implemented — returns an empty list until the OLTP query is defined.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of ongoing disinfection jobs (currently empty). */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["DisinfectionJobDto"][];
+                        };
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/disinfection/jobs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List disinfection jobs
+         * @description Returns completed disinfection jobs from OLAP. Optionally filter by status (passed, partial, failed); omit status or use "all" for no status filter. Haystack tenant users see jobs across all tenants; other tenants are scoped to their own tenant. Optionally filter by robotId.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Job outcome filter. Defaults to "all" (no status filtering) when omitted. */
+                    status?: "passed" | "partial" | "failed" | "all";
+                    /** @description UUID of a specific robot to filter by. */
+                    robotId?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of disinfection jobs matching the filters. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["DisinfectionJobDto"][];
+                        };
+                    };
+                };
+                /** @description Validation failed. Check that all required fields are present and correctly typed. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 400,
+                         *       "error": "Bad Request",
+                         *       "message": "email must be an email"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/analytics-agg/robots-count": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get robot count statistics
+         * @description Returns total, online, offline, AI-enabled, and SW-update-pending robot counts. Haystack tenant users see aggregates across all tenants; other tenants are scoped to their own tenant.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Robot count statistics wrapped in AnalyticsResponse with timestamp and status. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["RobotsCountAnalyticsDataDto"];
+                        };
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/analytics-agg/disinfection-count": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get disinfection job aggregate statistics
+         * @description Returns top performing bot by total disinfection duration and aggregated job stats (total runtime, total successful, total partial jobs). Haystack tenant users see aggregates across all tenants; other tenants are scoped to their own tenant.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Disinfection count statistics wrapped in AnalyticsResponse with timestamp and status. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["DisinfectionCountAnalyticsDataDto"];
+                        };
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/analytics-agg/disinfection-operator": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get operator rankings by disinfection jobs
+         * @description Returns operators ranked by number of successful/partial disinfection jobs. Haystack tenant users see data across all tenants; other tenants are scoped to their own tenant.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of operators ranked by total jobs wrapped in AnalyticsResponse with timestamp and status. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["DisinfectionOperatorsAnalyticsDataDto"];
+                        };
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/analytics-agg/disinfection-status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get disinfection job status distribution
+         * @description Returns status-wise counts of disinfection jobs. Haystack tenant users see aggregates across all tenants; other tenants are scoped to their own tenant.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Status-wise job counts wrapped in AnalyticsResponse with timestamp and status. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success: boolean;
+                            /** @example 200 */
+                            statusCode: number;
+                            /**
+                             * Format: date-time
+                             * @example 2026-05-29T12:00:00.000Z
+                             */
+                            timestamp: string;
+                            data: components["schemas"]["DisinfectionStatusAnalyticsDataDto"];
+                        };
+                    };
+                };
+                /** @description Authentication required. Provide a valid bearer token. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "success": false,
+                         *       "statusCode": 401,
+                         *       "error": "Unauthorized",
+                         *       "message": "Unauthorized"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        AuthResponseDto: {
+            /**
+             * @description Short-lived JWT access token (15 min).
+             * @example eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.access-token-example.signature
+             */
+            accessToken: string;
+            /**
+             * @description Long-lived refresh token (7 days).
+             * @example eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.refresh-token-example.signature
+             */
+            refreshToken: string;
+            /**
+             * @description Access token lifetime in seconds.
+             * @example 900
+             */
+            expiresIn: number;
+            /** @description Sanitized authenticated user snapshot returned with the token response. */
+            user: components["schemas"]["PublicUserDto"];
+        };
+        DisinfectionCountAnalyticsDataDto: {
+            data: components["schemas"]["DisinfectionCountResponseDto"];
+            /** @example 2026-05-29T12:00:00.000Z */
+            timestamp: string;
+            /**
+             * @example success
+             * @enum {string}
+             */
+            status: "success" | "error";
+        };
+        DisinfectionCountResponseDto: {
+            /** @example Warehouse Bot Alpha */
+            topBotName: string;
+            /** @example a1b2c3d4-e5f6-7890-abcd-ef1234567890 */
+            topBotId: string;
+            /** @example 125000 */
+            totalRuntime: number;
+            /** @example 320 */
+            totalSuccessful: number;
+            /** @example 45 */
+            totalPartial: number;
+        };
+        DisinfectionJobDto: {
+            /** @example Warehouse Bot Alpha */
+            robotName: string;
+            /** @example 2026-05-28T14:00:00.000Z */
+            startTime: string;
+            /** @example 2026-05-28T14:45:00.000Z */
+            endTime: string | null;
+            /** @example 2700 */
+            durationSeconds: number | null;
+            /** @example Alice Smith */
+            operatorName: string;
+            /** @example OR-3 */
+            roomName: string;
+            /** @example AUTO */
+            disinfectMode: string;
+            /** @example HIGH */
+            level: string;
+            /** @example COVERAGE_DONE */
+            status: string;
+        };
+        DisinfectionOperatorResponseDto: {
+            /** @example Alice Smith */
+            operatorName: string;
+            /** @example 128 */
+            totalJobs: number;
+        };
+        DisinfectionOperatorsAnalyticsDataDto: {
+            data: components["schemas"]["DisinfectionOperatorResponseDto"][];
+            /** @example 2026-05-29T12:00:00.000Z */
+            timestamp: string;
+            /**
+             * @example success
+             * @enum {string}
+             */
+            status: "success" | "error";
+        };
+        DisinfectionStatusAnalyticsDataDto: {
+            data: components["schemas"]["DisinfectionStatusResponseDto"][];
+            /** @example 2026-05-29T12:00:00.000Z */
+            timestamp: string;
+            /**
+             * @example success
+             * @enum {string}
+             */
+            status: "success" | "error";
+        };
+        DisinfectionStatusResponseDto: {
+            /** @example COVERAGE_DONE */
+            status: string;
+            /** @example 500 */
+            count: number;
+        };
+        LoginDto: {
+            /**
+             * @description Registered email address.
+             * @example superadmin@haystackrobotics.com
+             */
+            email: string;
+            /**
+             * @description Account password (minimum 8 characters).
+             * @example SuperAdmin123!
+             */
+            password: string;
+        };
+        MetricTypeResponseDto: {
+            /**
+             * @description Integer id of the metric type.
+             * @example 1
+             */
+            metricType: number;
+            /**
+             * @description Human-readable metric name.
+             * @example Cpu
+             */
+            metricName: string;
+            /**
+             * @description What the metric measures.
+             * @example CPU utilisation percentage
+             */
+            description: string;
+            /**
+             * @example numeric
+             * @enum {string}
+             */
+            dataType: "numeric" | "string";
+            /**
+             * @example stream
+             * @enum {string}
+             */
+            sourceType?: "non_stream" | "stream";
+        };
+        PublicUserDto: {
+            /** @example c3d4e5f6-a1b2-3456-abcd-789012345678 */
+            id: string;
+            /** @example admin@haystackrobotics.com */
+            email: string;
+            /** @example Haystack */
+            firstName: string;
+            /** @example Admin */
+            lastName: string;
+            /** @example true */
+            isActive: boolean;
+            /** @example 11111111-1111-4111-8111-111111111111 */
+            tenantId: string;
+            workspaceId?: string | null;
+            facilityId?: string | null;
+            fleetId?: string | null;
+            /** @enum {string|null} */
+            role?: "TENANT_ADMIN" | "WORKSPACE_ADMIN" | "FACILITY_ADMIN" | "FLEET_OPERATOR" | "FLEET_VIEWER" | null;
+            /** @enum {string|null} */
+            scopeType?: "tenant" | "workspace" | "facility" | "fleet" | null;
+            scopeId?: string | null;
+            /**
+             * Format: date-time
+             * @example 2026-01-15T08:00:00.000Z
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @example 2026-05-20T10:00:00.000Z
+             */
+            updatedAt: string;
+        };
+        RobotDisinfectionStatsDto: {
+            /** @example a1b2c3d4-e5f6-7890-abcd-ef1234567890 */
+            robotId: string;
+            /** @example 12 */
+            roomCount: number;
+            /** @example 86400 */
+            totalDurationSeconds: number;
+            /** @example 45 */
+            successJobs: number;
+            /** @example 8 */
+            partialSuccessJobs: number;
+            /** @example 3 */
+            failedJobs: number;
+            /** @example Warehouse Bot Alpha */
+            botName: string | null;
+            /** @example Warehouse Operations */
+            facilityName: string | null;
+        };
+        RobotListItemDto: {
+            /**
+             * @description Unique identifier of the robot (UUID).
+             * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
+             */
+            id: string;
+            /**
+             * @description UUID of the tenant that owns the robot.
+             * @example 11111111-1111-4111-8111-111111111111
+             */
+            tenantId: string;
+            /**
+             * @description Name of the tenant that owns the robot.
+             * @example Haystack Robotics
+             */
+            tenantName?: string;
+            /**
+             * @description Human-readable display name for the robot.
+             * @example Warehouse Bot Alpha
+             */
+            name: string;
+            /**
+             * @description UUID of the fleet this robot is assigned to.
+             * @example f1000000-0000-4000-8000-000000000001
+             */
+            fleetId?: string | null;
+            /**
+             * @description Name of the fleet this robot is assigned to.
+             * @example Warehouse Fleet A
+             */
+            fleetName?: string;
+            /**
+             * @description Whether the robot is currently connected and transmitting data.
+             * @example true
+             */
+            isOnline?: boolean;
+            /**
+             * @description Whether the robot is subscribed for telemetry processing.
+             * @example true
+             */
+            isSubscribed: boolean;
+            /**
+             * @description ISO-8601 timestamp of the last confirmed contact with the robot.
+             * @example 2026-03-07T18:30:00.000Z
+             */
+            lastTimeSeen?: string;
+            /**
+             * @description When the robot record was created (ISO-8601).
+             * @example 2026-03-01T10:00:00.000Z
+             */
+            createdAt?: string;
+            /**
+             * @description When the robot record was last updated (ISO-8601).
+             * @example 2026-03-07T18:30:00.000Z
+             */
+            updatedAt?: string;
+            /**
+             * @description Latest CPU usage reading (percent string), or null.
+             * @example 87.733
+             */
+            cpu?: string | null;
+            /**
+             * @description Latest RAM usage reading (percent string), or null.
+             * @example 77.33
+             */
+            ram?: string | null;
+            /**
+             * @description Latest Disk usage reading (percent string), or null.
+             * @example 93
+             */
+            disk?: string | null;
+            /**
+             * @description Battery charge level (0–100), or null if not yet streamed.
+             * @example 90
+             */
+            batteryPercent?: number | null;
+            /**
+             * @description Current robot operating mode, or null if not yet streamed.
+             * @example DISINFECT
+             */
+            mode?: string | null;
+            /**
+             * @description Whether the emergency button is active, or null if not yet streamed.
+             * @example false
+             */
+            emergency?: boolean | null;
+            /**
+             * @description Remaining lamp life in hours, or null if not yet streamed.
+             * @example 9000
+             */
+            lampLifeHours?: number | null;
+            /**
+             * @description Whether a disinfection job is currently running, or null if not yet streamed.
+             * @example true
+             */
+            disinfectionRunning?: boolean | null;
+            /**
+             * @description ISO-8601 timestamp of the last received status stream update, or null.
+             * @example 2026-05-20T10:00:00.000Z
+             */
+            lastStreamed?: string | null;
+        };
+        RobotMetricLiveDto: {
+            /**
+             * @description Integer id of the metric type.
+             * @example 1
+             */
+            metricId: number;
+            /**
+             * @description Human-readable metric name.
+             * @example Cpu
+             */
+            metricName: string;
+            /**
+             * @description Latest recorded value.
+             * @example 42.5
+             */
+            metricValue: number;
+            /**
+             * @description ISO-8601 timestamp of the most recent reading.
+             * @example 2026-05-29T11:58:00.000Z
+             */
+            lastSyncTime: Record<string, never>;
+        };
+        RobotsCountAnalyticsDataDto: {
+            data: components["schemas"]["RobotsCountResponseDto"];
+            /** @example 2026-05-29T12:00:00.000Z */
+            timestamp: string;
+            /**
+             * @example success
+             * @enum {string}
+             */
+            status: "success" | "error";
+        };
+        RobotsCountResponseDto: {
+            /** @example 24 */
+            total: number;
+            /** @example 20 */
+            online: number;
+            /** @example 4 */
+            offline: number;
+            /** @example 6 */
+            aiEnabled: number;
+            /** @example 2 */
+            swUpdatePending: number;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+type operations = Record<string, never>;
+
+/**
+ * Friendly aliases over OpenAPI component schemas.
+ * Generated from openapi.json — do not edit.
+ */
+
+type Schemas = components['schemas'];
+type LoginPayload = Schemas['LoginDto'];
+type AuthResponse = Schemas['AuthResponseDto'];
+type PublicUser = Schemas['PublicUserDto'];
+type RobotListItem = Schemas['RobotListItemDto'];
+type MetricType = Schemas['MetricTypeResponseDto'];
+type RobotMetricLive = Schemas['RobotMetricLiveDto'];
+type RobotDisinfectionStats = Schemas['RobotDisinfectionStatsDto'];
+type DisinfectionJob = Schemas['DisinfectionJobDto'];
+type RobotsCountAggregate = Schemas['RobotsCountResponseDto'];
+type DisinfectionCountAggregate = Schemas['DisinfectionCountResponseDto'];
+type DisinfectionOperatorAggregate = Schemas['DisinfectionOperatorResponseDto'];
+type DisinfectionStatusAggregate = Schemas['DisinfectionStatusResponseDto'];
+type RobotsCountAnalyticsData = Schemas['RobotsCountAnalyticsDataDto'];
+type DisinfectionCountAnalyticsData = Schemas['DisinfectionCountAnalyticsDataDto'];
+type DisinfectionOperatorsAnalyticsData = Schemas['DisinfectionOperatorsAnalyticsDataDto'];
+type DisinfectionStatusAnalyticsData = Schemas['DisinfectionStatusAnalyticsDataDto'];
+
+/**
+ * Haystack public API response envelopes.
+ * Keep aligned with `packages/core/src/types/api.types.ts` (private monorepo twin).
+ */
+interface ApiSuccessResponse<T> {
     success: true;
-    /** HTTP status code (e.g. 200, 201) */
     statusCode: number;
-    /** The response payload */
     data: T;
-    /** ISO 8601 timestamp of the response */
     timestamp: string;
 }
-/**
- * Standard error response returned when a request fails.
- */
 interface ApiErrorResponse {
-    /** Always `false` for error responses */
     success: false;
-    /** HTTP status code (e.g. 400, 404, 500) */
     statusCode: number;
-    /** Always null on errors */
     data: null;
-    /** Error details object */
     error: {
-        /** Human-readable error message */
-        message: string | string[];
-        /** Additional error fields, e.g. validation errors */
+        message?: string | string[];
+        error?: string;
         [key: string]: unknown;
     };
-    /** ISO 8601 timestamp of the response */
     timestamp: string;
-    /** The request path that triggered the error */
     path: string;
 }
+type ApiResult<T> = ApiSuccessResponse<T> | ApiErrorResponse;
+type ApiData<T> = T extends ApiSuccessResponse<infer D> ? D : never;
 interface PaginationMeta {
     page: number;
     limit: number;
     total: number;
     totalPages: number;
 }
-interface PaginatedResponse<T = unknown> extends ApiResponse<T[]> {
+interface PaginatedSuccessResponse<T> extends ApiSuccessResponse<T[]> {
     meta: PaginationMeta;
 }
 
-/**
- * A robot entry from Nimbus Cloud.
- */
-interface Robot {
-    robotId: string;
-    name?: string;
-    status?: string;
-    lastOnline?: string;
-    [key: string]: unknown;
-}
-/**
- * A metric type available for robots.
- */
-interface Metric {
-    metricId: number;
-    name?: string;
-    value?: unknown;
-    timestamp?: string;
-    [key: string]: unknown;
-}
-/**
- * The nested BasicData block inside a Cognimbus webhook payload.
- */
-interface WebhookBasicData {
-    /** Robot ID (PascalCase — Cognimbus default) */
-    Id?: string;
-    /** Robot ID (camelCase — alternative) */
-    robotId?: string;
-    /** Robot name (PascalCase) */
-    Name?: string;
-    /** Robot name (camelCase) */
-    robotName?: string;
-    /** Online flag (PascalCase) */
-    IsOnline?: boolean;
-    /** Online flag (camelCase) */
-    isOnline?: boolean;
-}
-/**
- * Full Cognimbus webhook payload.
- * Supports both nested (`BasicData.*`) and flat (`robotId`, `isOnline`) formats.
- */
-interface WebhookPayload extends WebhookBasicData {
-    BasicData?: WebhookBasicData;
-    LastTimeSeen?: string;
-    lastTimeSeen?: string;
-    AgentVersion?: string;
-    agentVersion?: string;
-    /** Tenant this robot belongs to */
-    tenantId?: string;
-}
-type TenantStatus = 'ACTIVE' | 'SUSPENDED' | 'INACTIVE';
-interface CreateTenantPayload {
-    name: string;
-    slug: string;
-    industry?: string;
-    status?: TenantStatus;
-    contactEmail?: string;
-}
-interface UpdateTenantPayload extends Partial<CreateTenantPayload> {
-}
-interface TenantResponse {
-    id: string;
-    name: string;
-    slug: string;
-    industry: string | null;
-    status: TenantStatus;
-    contactEmail: string | null;
-    logoUrl: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-type UserRole = 'SUPER_ADMIN' | 'ADMIN' | 'OPERATOR' | 'VIEWER';
-interface CreateUserPayload {
-    email: string;
-    password: string;
-    firstName: string;
-    lastName: string;
-    role?: UserRole;
-    tenantId?: string;
-}
-interface UpdateUserPayload extends Partial<CreateUserPayload> {
-}
-interface UserResponse {
-    id: string;
-    email: string;
-    firstName: string;
-    lastName: string;
-    role: UserRole;
-    isActive: boolean;
-    tenantId: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-interface BotSummaryResponse {
-    robotId: string;
-    robotName: string;
-    isOnline: boolean;
-    lastTimeSeen: string | null;
-    lastOnlineTime: string | null;
-    agentVersion: string | null;
-    tenantId: string | null;
-    lastUpdated: string;
-}
-interface BotHistoryResponse {
-    id: number;
-    robotId: string;
-    robotName: string;
-    isOnline: boolean;
-    lastTimeSeen: string | null;
-    agentVersion: string | null;
-    tenantId: string | null;
-    timestamp: string;
-}
-interface BotStateChangeResponse {
-    id: number;
-    robotId: string;
-    robotName: string;
-    previousState: boolean;
-    newState: boolean;
-    tenantId: string | null;
-    timestamp: string;
-}
-
-export type { ApiErrorResponse, ApiResponse, BotHistoryResponse, BotStateChangeResponse, BotSummaryResponse, CreateTenantPayload, CreateUserPayload, Metric, PaginatedResponse, PaginationMeta, Robot, TenantResponse, TenantStatus, UpdateTenantPayload, UpdateUserPayload, UserResponse, UserRole, WebhookBasicData, WebhookPayload };
+export { AnalyticsAggregateStatus, type ApiData, type ApiErrorResponse, type ApiResult, type ApiSuccessResponse, type AuthResponse, type DisinfectionCountAggregate, type DisinfectionCountAnalyticsData, type DisinfectionJob, type DisinfectionOperatorAggregate, type DisinfectionOperatorsAnalyticsData, type DisinfectionStatusAggregate, type DisinfectionStatusAnalyticsData, HAYSTACK_API_BASE_PATH, HAYSTACK_API_VERSION, HAYSTACK_PRODUCTION_API_URL, type LoginPayload, MetricDataType, MetricSourceType, type MetricType, PUBLIC_API_META, PUBLIC_OPENAPI_JSON, type PaginatedSuccessResponse, type PaginationMeta, PublicApiPath, type PublicUser, type RobotDisinfectionStats, type RobotListItem, type RobotMetricLive, type RobotsCountAggregate, type RobotsCountAnalyticsData, Role, ScopeType, type components, type operations, type paths };