@trackunit/react-date-and-time-hooks 2.1.4 → 2.1.5

package/index.cjs.js

@@ -1,14 +1,13 @@
 'use strict';
 
-var react = require('react');
 var dateAndTimeUtils = require('@trackunit/date-and-time-utils');
 var sharedUtils = require('@trackunit/shared-utils');
+var react = require('react');
 var irisAppRuntimeCoreApi = require('@trackunit/iris-app-runtime-core-api');
+var reactComponents = require('@trackunit/react-components');
 var reactCoreHooks = require('@trackunit/react-core-hooks');
-
-const AssetTimezoneContext = react.createContext({ assetTimeZone: null });
-/** Returns the resolved asset timezone from the nearest AssetTimezoneProvider in the component tree. */
-const useAssetTimezoneContext = () => react.useContext(AssetTimezoneContext);
+var reactGraphqlHooks = require('@trackunit/react-graphql-hooks');
+var zod = require('zod');
 
 /**
  * Try to convert to ISO standard. ex. en becomes en-GB if its in United Kingdom.
@@ -40,28 +39,78 @@ const useLocale = () => {
     return userLocale || BrowserLocale;
 };
 
-const CUSTOM_TIMEZONE_KEY = "customTimeZone";
-const readTimezoneFromStorage = () => {
-    try {
-        const raw = localStorage.getItem(CUSTOM_TIMEZONE_KEY);
-        if (raw === null)
-            return null;
-        const parsed = JSON.parse(raw);
-        return typeof parsed === "string" ? parsed : null;
-    }
-    catch {
-        return null;
-    }
+const GetAssetTimezoneDocument = {
+    kind: "Document",
+    definitions: [
+        {
+            kind: "OperationDefinition",
+            operation: "query",
+            name: { kind: "Name", value: "GetAssetTimezone" },
+            variableDefinitions: [
+                {
+                    kind: "VariableDefinition",
+                    variable: { kind: "Variable", name: { kind: "Name", value: "assetId" } },
+                    type: { kind: "NonNullType", type: { kind: "NamedType", name: { kind: "Name", value: "ID" } } },
+                },
+            ],
+            selectionSet: {
+                kind: "SelectionSet",
+                selections: [
+                    {
+                        kind: "Field",
+                        name: { kind: "Name", value: "asset" },
+                        arguments: [
+                            {
+                                kind: "Argument",
+                                name: { kind: "Name", value: "id" },
+                                value: { kind: "Variable", name: { kind: "Name", value: "assetId" } },
+                            },
+                        ],
+                        selectionSet: {
+                            kind: "SelectionSet",
+                            selections: [
+                                {
+                                    kind: "Field",
+                                    name: { kind: "Name", value: "locations" },
+                                    selectionSet: {
+                                        kind: "SelectionSet",
+                                        selections: [
+                                            {
+                                                kind: "Field",
+                                                name: { kind: "Name", value: "latest" },
+                                                selectionSet: {
+                                                    kind: "SelectionSet",
+                                                    selections: [
+                                                        {
+                                                            kind: "Field",
+                                                            name: { kind: "Name", value: "properties" },
+                                                            selectionSet: {
+                                                                kind: "SelectionSet",
+                                                                selections: [{ kind: "Field", name: { kind: "Name", value: "timeZone" } }],
+                                                            },
+                                                        },
+                                                    ],
+                                                },
+                                            },
+                                        ],
+                                    },
+                                },
+                            ],
+                        },
+                    },
+                ],
+            },
+        },
+    ],
 };
+
+const customTimeZoneSchema = zod.z.string().nullable();
 /**
  * Resolves the active timezone based on user preference, custom override, and optional asset location.
  *
  * Returns `current` (browser or custom override), `preferred` (resolved per user settings
  * and optional asset), and `assetTimeZone` (fetched from the asset's GPS location).
  *
- * The asset timezone is resolved by the nearest `AssetTimezoneProvider` in the component tree.
- * Use `AssetTimezoneProvider` on asset-detail pages to enable machine-timezone resolution.
- *
  * **When to use:**
  * - Use `useTimezone` whenever you need to display or calculate dates in the correct
  *   timezone — especially on asset-detail pages where the machine's timezone may differ
@@ -70,23 +119,28 @@ const readTimezoneFromStorage = () => {
  * - Do **not** rely on `Intl.DateTimeFormat().resolvedOptions().timeZone` directly —
  *   this hook respects the user's preference setting (browser, machine, or custom).
  */
-const useTimezone = () => {
-    const { assetTimeZone } = useAssetTimezoneContext();
-    const { timeZonePreference, customTimezone: contextCustomTimezone } = reactCoreHooks.useCurrentUserTimeZonePreference();
-    const [localStorageCustomTimezone, setLocalStorageCustomTimezone] = react.useState(readTimezoneFromStorage);
-    const setCustomTimezone = react.useCallback((timezone) => {
-        setLocalStorageCustomTimezone(timezone);
-        if (timezone === null) {
-            localStorage.removeItem(CUSTOM_TIMEZONE_KEY);
-        }
-        else {
-            localStorage.setItem(CUSTOM_TIMEZONE_KEY, JSON.stringify(timezone));
+const useTimezone = ({ assetId } = {}) => {
+    const { timeZonePreference } = reactCoreHooks.useCurrentUserTimeZonePreference();
+    const localStorageProps = react.useMemo(() => ({
+        key: "customTimeZone",
+        defaultState: null,
+        schema: customTimeZoneSchema,
+    }), []);
+    const [customTimezone, setCustomTimezone] = reactComponents.useLocalStorage(localStorageProps);
+    const { data: timeZoneData } = reactGraphqlHooks.useQuery(GetAssetTimezoneDocument, {
+        variables: {
+            assetId: assetId ?? "",
+        },
+        skip: !assetId,
+        fetchPolicy: "cache-first",
+    });
+    const assetTimeZone = react.useMemo(() => {
+        const timezone = timeZoneData?.asset?.locations?.latest?.properties?.timeZone;
+        if (!timezone) {
+            return null;
         }
-    }, []);
-    // undefined → host did not send this field (old host without Penpal support); fall back to localStorage.
-    // null → host explicitly has no custom timezone; do NOT fall back to potentially stale iframe localStorage.
-    // string → host-provided value; use it directly.
-    const customTimezone = contextCustomTimezone !== undefined ? contextCustomTimezone : localStorageCustomTimezone;
+        return dateAndTimeUtils.getTimeZone(timezone);
+    }, [timeZoneData?.asset?.locations?.latest?.properties?.timeZone]);
     const current = react.useMemo(() => {
         const id = dateAndTimeUtils.Temporal.Now.timeZoneId();
         if (timeZonePreference === irisAppRuntimeCoreApi.TimeZonePreference.CustomTimeZone && customTimezone) {
@@ -100,7 +154,7 @@ const useTimezone = () => {
         }
         return current;
     }, [timeZonePreference, current, assetTimeZone]);
-    return react.useMemo(() => ({ current, assetTimeZone, preferred, setCustomTimezone, customTimezone }), [current, assetTimeZone, preferred, setCustomTimezone, customTimezone]);
+    return react.useMemo(() => ({ current, assetTimeZone, preferred, setCustomTimezone }), [current, assetTimeZone, preferred, setCustomTimezone]);
 };
 
 /**
@@ -499,9 +553,7 @@ const useDateAndTime = () => {
     ]);
 };
 
-exports.AssetTimezoneContext = AssetTimezoneContext;
 exports.convertToLocale = convertToLocale;
-exports.useAssetTimezoneContext = useAssetTimezoneContext;
 exports.useDateAndTime = useDateAndTime;
 exports.useLocale = useLocale;
 exports.useTimezone = useTimezone;

package/index.esm.js

@@ -1,12 +1,11 @@
-import { createContext, useContext, useState, useCallback, useMemo } from 'react';
-import { Temporal, getTimeZone, toDateUtil, toZonedDateTimeUtil, formatDateUtil, formatRangeUtil, subtractYearsUtil, subtractMonthsUtil, subtractWeeksUtil, subtractDaysUtil, subtractHoursUtil, subtractMinutesUtil, addYearsUtil, addMonthsUtil, addWeeksUtil, addDaysUtil, addHoursUtil, addMinutesUtil, startOfMonthUtil, startOfWeekUtil, startOfDayUtil, startOfHourUtil, startOfMinuteUtil, endOfMonthUtil, endOfWeekUtil, endOfDayUtil, endOfHourUtil, endOfMinuteUtil, differenceInYearsUtil, differenceInMonthsUtil, differenceInWeeksUtil, differenceInDaysUtil, differenceInHoursUtil, differenceInMinutesUtil, differenceInSecondsUtil, isBetweenUtil, isTodayUtil, isFutureUtil, isPastUtil, isSameYearUtil, isSameMonthUtil, isSameWeekUtil, isSameDayUtil, timeSinceInYears, timeSinceInMonths, timeSinceInDays, timeSinceInHours, timeSinceInMinutes, timeSinceInSeconds, timeSinceAuto, toDuration, getDurationFormat, convertMillisecondsUtil, convertSecondsUtil, convertMinutesUtil, convertHoursUtil, dayNameUtil, daysUtil, monthNameUtil, monthsUtil, getUTCFromTimeZonedUtil, isEqualUtil } from '@trackunit/date-and-time-utils';
+import { getTimeZone, Temporal, toDateUtil, toZonedDateTimeUtil, formatDateUtil, formatRangeUtil, subtractYearsUtil, subtractMonthsUtil, subtractWeeksUtil, subtractDaysUtil, subtractHoursUtil, subtractMinutesUtil, addYearsUtil, addMonthsUtil, addWeeksUtil, addDaysUtil, addHoursUtil, addMinutesUtil, startOfMonthUtil, startOfWeekUtil, startOfDayUtil, startOfHourUtil, startOfMinuteUtil, endOfMonthUtil, endOfWeekUtil, endOfDayUtil, endOfHourUtil, endOfMinuteUtil, differenceInYearsUtil, differenceInMonthsUtil, differenceInWeeksUtil, differenceInDaysUtil, differenceInHoursUtil, differenceInMinutesUtil, differenceInSecondsUtil, isBetweenUtil, isTodayUtil, isFutureUtil, isPastUtil, isSameYearUtil, isSameMonthUtil, isSameWeekUtil, isSameDayUtil, timeSinceInYears, timeSinceInMonths, timeSinceInDays, timeSinceInHours, timeSinceInMinutes, timeSinceInSeconds, timeSinceAuto, toDuration, getDurationFormat, convertMillisecondsUtil, convertSecondsUtil, convertMinutesUtil, convertHoursUtil, dayNameUtil, daysUtil, monthNameUtil, monthsUtil, getUTCFromTimeZonedUtil, isEqualUtil } from '@trackunit/date-and-time-utils';
 import { exhaustiveCheck } from '@trackunit/shared-utils';
+import { useMemo, useCallback } from 'react';
 import { TimeZonePreference } from '@trackunit/iris-app-runtime-core-api';
+import { useLocalStorage } from '@trackunit/react-components';
 import { useCurrentUserTimeZonePreference } from '@trackunit/react-core-hooks';
-
-const AssetTimezoneContext = createContext({ assetTimeZone: null });
-/** Returns the resolved asset timezone from the nearest AssetTimezoneProvider in the component tree. */
-const useAssetTimezoneContext = () => useContext(AssetTimezoneContext);
+import { useQuery } from '@trackunit/react-graphql-hooks';
+import { z } from 'zod';
 
 /**
  * Try to convert to ISO standard. ex. en becomes en-GB if its in United Kingdom.
@@ -38,28 +37,78 @@ const useLocale = () => {
     return userLocale || BrowserLocale;
 };
 
-const CUSTOM_TIMEZONE_KEY = "customTimeZone";
-const readTimezoneFromStorage = () => {
-    try {
-        const raw = localStorage.getItem(CUSTOM_TIMEZONE_KEY);
-        if (raw === null)
-            return null;
-        const parsed = JSON.parse(raw);
-        return typeof parsed === "string" ? parsed : null;
-    }
-    catch {
-        return null;
-    }
+const GetAssetTimezoneDocument = {
+    kind: "Document",
+    definitions: [
+        {
+            kind: "OperationDefinition",
+            operation: "query",
+            name: { kind: "Name", value: "GetAssetTimezone" },
+            variableDefinitions: [
+                {
+                    kind: "VariableDefinition",
+                    variable: { kind: "Variable", name: { kind: "Name", value: "assetId" } },
+                    type: { kind: "NonNullType", type: { kind: "NamedType", name: { kind: "Name", value: "ID" } } },
+                },
+            ],
+            selectionSet: {
+                kind: "SelectionSet",
+                selections: [
+                    {
+                        kind: "Field",
+                        name: { kind: "Name", value: "asset" },
+                        arguments: [
+                            {
+                                kind: "Argument",
+                                name: { kind: "Name", value: "id" },
+                                value: { kind: "Variable", name: { kind: "Name", value: "assetId" } },
+                            },
+                        ],
+                        selectionSet: {
+                            kind: "SelectionSet",
+                            selections: [
+                                {
+                                    kind: "Field",
+                                    name: { kind: "Name", value: "locations" },
+                                    selectionSet: {
+                                        kind: "SelectionSet",
+                                        selections: [
+                                            {
+                                                kind: "Field",
+                                                name: { kind: "Name", value: "latest" },
+                                                selectionSet: {
+                                                    kind: "SelectionSet",
+                                                    selections: [
+                                                        {
+                                                            kind: "Field",
+                                                            name: { kind: "Name", value: "properties" },
+                                                            selectionSet: {
+                                                                kind: "SelectionSet",
+                                                                selections: [{ kind: "Field", name: { kind: "Name", value: "timeZone" } }],
+                                                            },
+                                                        },
+                                                    ],
+                                                },
+                                            },
+                                        ],
+                                    },
+                                },
+                            ],
+                        },
+                    },
+                ],
+            },
+        },
+    ],
 };
+
+const customTimeZoneSchema = z.string().nullable();
 /**
  * Resolves the active timezone based on user preference, custom override, and optional asset location.
  *
  * Returns `current` (browser or custom override), `preferred` (resolved per user settings
  * and optional asset), and `assetTimeZone` (fetched from the asset's GPS location).
  *
- * The asset timezone is resolved by the nearest `AssetTimezoneProvider` in the component tree.
- * Use `AssetTimezoneProvider` on asset-detail pages to enable machine-timezone resolution.
- *
  * **When to use:**
  * - Use `useTimezone` whenever you need to display or calculate dates in the correct
  *   timezone — especially on asset-detail pages where the machine's timezone may differ
@@ -68,23 +117,28 @@ const readTimezoneFromStorage = () => {
  * - Do **not** rely on `Intl.DateTimeFormat().resolvedOptions().timeZone` directly —
  *   this hook respects the user's preference setting (browser, machine, or custom).
  */
-const useTimezone = () => {
-    const { assetTimeZone } = useAssetTimezoneContext();
-    const { timeZonePreference, customTimezone: contextCustomTimezone } = useCurrentUserTimeZonePreference();
-    const [localStorageCustomTimezone, setLocalStorageCustomTimezone] = useState(readTimezoneFromStorage);
-    const setCustomTimezone = useCallback((timezone) => {
-        setLocalStorageCustomTimezone(timezone);
-        if (timezone === null) {
-            localStorage.removeItem(CUSTOM_TIMEZONE_KEY);
-        }
-        else {
-            localStorage.setItem(CUSTOM_TIMEZONE_KEY, JSON.stringify(timezone));
+const useTimezone = ({ assetId } = {}) => {
+    const { timeZonePreference } = useCurrentUserTimeZonePreference();
+    const localStorageProps = useMemo(() => ({
+        key: "customTimeZone",
+        defaultState: null,
+        schema: customTimeZoneSchema,
+    }), []);
+    const [customTimezone, setCustomTimezone] = useLocalStorage(localStorageProps);
+    const { data: timeZoneData } = useQuery(GetAssetTimezoneDocument, {
+        variables: {
+            assetId: assetId ?? "",
+        },
+        skip: !assetId,
+        fetchPolicy: "cache-first",
+    });
+    const assetTimeZone = useMemo(() => {
+        const timezone = timeZoneData?.asset?.locations?.latest?.properties?.timeZone;
+        if (!timezone) {
+            return null;
         }
-    }, []);
-    // undefined → host did not send this field (old host without Penpal support); fall back to localStorage.
-    // null → host explicitly has no custom timezone; do NOT fall back to potentially stale iframe localStorage.
-    // string → host-provided value; use it directly.
-    const customTimezone = contextCustomTimezone !== undefined ? contextCustomTimezone : localStorageCustomTimezone;
+        return getTimeZone(timezone);
+    }, [timeZoneData?.asset?.locations?.latest?.properties?.timeZone]);
     const current = useMemo(() => {
         const id = Temporal.Now.timeZoneId();
         if (timeZonePreference === TimeZonePreference.CustomTimeZone && customTimezone) {
@@ -98,7 +152,7 @@ const useTimezone = () => {
         }
         return current;
     }, [timeZonePreference, current, assetTimeZone]);
-    return useMemo(() => ({ current, assetTimeZone, preferred, setCustomTimezone, customTimezone }), [current, assetTimeZone, preferred, setCustomTimezone, customTimezone]);
+    return useMemo(() => ({ current, assetTimeZone, preferred, setCustomTimezone }), [current, assetTimeZone, preferred, setCustomTimezone]);
 };
 
 /**
@@ -497,4 +551,4 @@ const useDateAndTime = () => {
     ]);
 };
 
-export { AssetTimezoneContext, convertToLocale, useAssetTimezoneContext, useDateAndTime, useLocale, useTimezone };
+export { convertToLocale, useDateAndTime, useLocale, useTimezone };

package/package.json

@@ -1,21 +1,28 @@
 {
   "name": "@trackunit/react-date-and-time-hooks",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/date-and-time-utils": "1.13.14",
-    "@trackunit/iris-app-runtime-core-api": "1.16.13",
-    "@trackunit/shared-utils": "1.15.13",
-    "@trackunit/react-core-hooks": "1.17.17"
-  },
-  "devDependencies": {
-    "@trackunit/react-core-contexts-test": "1.17.13"
+    "@graphql-codegen/cli": "^5.0.3",
+    "@graphql-typed-document-node/core": "^3.2.0",
+    "zod": "^3.25.76",
+    "@trackunit/iris-app-api": "2.0.6",
+    "@trackunit/react-core-contexts-test": "1.17.14",
+    "@trackunit/date-and-time-utils": "1.13.15",
+    "@trackunit/shared-utils": "1.15.14",
+    "@trackunit/react-core-hooks": "1.17.18",
+    "@trackunit/react-components": "2.1.4",
+    "@trackunit/react-graphql-hooks": "2.1.4",
+    "@trackunit/iris-app-runtime-core-api": "1.16.14"
   },
   "peerDependencies": {
+    "@apollo/client": "^3.13.8",
+    "@tanstack/react-router": "^1.114.29",
+    "graphql": "^16.10.0",
     "react": "^19.0.0"
   },
   "module": "./index.esm.js",

package/src/generated/graphql-api/fragment-masking.d.ts

@@ -0,0 +1,19 @@
+import { ResultOf, DocumentTypeDecoration, TypedDocumentNode } from '@graphql-typed-document-node/core';
+import { Incremental } from './graphql';
+export type FragmentType<TDocumentType extends DocumentTypeDecoration<any, any>> = TDocumentType extends DocumentTypeDecoration<infer TType, any> ? [TType] extends [{
+    ' $fragmentName'?: infer TKey;
+}] ? TKey extends string ? {
+    ' $fragmentRefs'?: {
+        [key in TKey]: TType;
+    };
+} : never : never : never;
+export declare function getFragmentData<TType>(_documentNode: DocumentTypeDecoration<TType, any>, fragmentType: FragmentType<DocumentTypeDecoration<TType, any>>): TType;
+export declare function getFragmentData<TType>(_documentNode: DocumentTypeDecoration<TType, any>, fragmentType: FragmentType<DocumentTypeDecoration<TType, any>> | undefined): TType | undefined;
+export declare function getFragmentData<TType>(_documentNode: DocumentTypeDecoration<TType, any>, fragmentType: FragmentType<DocumentTypeDecoration<TType, any>> | null): TType | null;
+export declare function getFragmentData<TType>(_documentNode: DocumentTypeDecoration<TType, any>, fragmentType: FragmentType<DocumentTypeDecoration<TType, any>> | null | undefined): TType | null | undefined;
+export declare function getFragmentData<TType>(_documentNode: DocumentTypeDecoration<TType, any>, fragmentType: Array<FragmentType<DocumentTypeDecoration<TType, any>>>): Array<TType>;
+export declare function getFragmentData<TType>(_documentNode: DocumentTypeDecoration<TType, any>, fragmentType: Array<FragmentType<DocumentTypeDecoration<TType, any>>> | null | undefined): Array<TType> | null | undefined;
+export declare function getFragmentData<TType>(_documentNode: DocumentTypeDecoration<TType, any>, fragmentType: ReadonlyArray<FragmentType<DocumentTypeDecoration<TType, any>>>): ReadonlyArray<TType>;
+export declare function getFragmentData<TType>(_documentNode: DocumentTypeDecoration<TType, any>, fragmentType: ReadonlyArray<FragmentType<DocumentTypeDecoration<TType, any>>> | null | undefined): ReadonlyArray<TType> | null | undefined;
+export declare function makeFragmentData<F extends DocumentTypeDecoration<any, any>, FT extends ResultOf<F>>(data: FT, _fragment: F): FragmentType<F>;
+export declare function isFragmentReady<TQuery, TFrag>(queryNode: DocumentTypeDecoration<TQuery, any>, fragmentNode: TypedDocumentNode<TFrag>, data: FragmentType<TypedDocumentNode<Incremental<TFrag>, any>> | null | undefined): data is FragmentType<typeof fragmentNode>;

package/src/generated/graphql-api/gql.d.ts

@@ -0,0 +1,37 @@
+import * as types from './graphql';
+import { TypedDocumentNode as DocumentNode } from '@graphql-typed-document-node/core';
+/**
+ * Map of all GraphQL operations in the project.
+ *
+ * This map has several performance disadvantages:
+ * 1. It is not tree-shakeable, so it will include all operations in the project.
+ * 2. It is not minifiable, so the string of a GraphQL query will be multiple times inside the bundle.
+ * 3. It does not support dead code elimination, so it will add unused operations.
+ *
+ * Therefore it is highly recommended to use the babel or swc plugin for production.
+ * Learn more about it here: https://the-guild.dev/graphql/codegen/plugins/presets/preset-client#reducing-bundle-size
+ */
+declare const documents: {
+    "query GetAssetTimezone($assetId: ID!) {\n  asset(id: $assetId) {\n    locations {\n      latest {\n        properties {\n          timeZone\n        }\n      }\n    }\n  }\n}": DocumentNode<types.GetAssetTimezoneQuery, types.Exact<{
+        assetId: types.Scalars["ID"]["input"];
+    }>>;
+};
+/**
+ * The graphql function is used to parse GraphQL queries into a document that can be used by GraphQL clients.
+ *
+ *
+ * @example
+ * ```ts
+ * const query = graphql(`query GetUser($id: ID!) { user(id: $id) { name } }`);
+ * ```
+ *
+ * The query argument is unknown!
+ * Please regenerate the types.
+ */
+export declare function graphql(source: string): unknown;
+/**
+ * The graphql function is used to parse GraphQL queries into a document that can be used by GraphQL clients.
+ */
+export declare function graphql(source: "query GetAssetTimezone($assetId: ID!) {\n  asset(id: $assetId) {\n    locations {\n      latest {\n        properties {\n          timeZone\n        }\n      }\n    }\n  }\n}"): (typeof documents)["query GetAssetTimezone($assetId: ID!) {\n  asset(id: $assetId) {\n    locations {\n      latest {\n        properties {\n          timeZone\n        }\n      }\n    }\n  }\n}"];
+export type DocumentType<TDocumentNode extends DocumentNode<any, any>> = TDocumentNode extends DocumentNode<infer TType, any> ? TType : never;
+export {};

package/src/generated/graphql-api/graphql.d.ts

@@ -0,0 +1,142 @@
+import { TypedDocumentNode as DocumentNode } from "@graphql-typed-document-node/core";
+import type { PublicIrisAppManifest } from "@trackunit/iris-app-api";
+export type Maybe<T> = T | null;
+export type InputMaybe<T> = Maybe<T> | undefined;
+export type Exact<T extends {
+    [key: string]: unknown;
+}> = {
+    [K in keyof T]: T[K];
+};
+export type MakeOptional<T, K extends keyof T> = Omit<T, K> & {
+    [SubKey in K]?: Maybe<T[SubKey]>;
+};
+export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & {
+    [SubKey in K]: Maybe<T[SubKey]>;
+};
+export type MakeEmpty<T extends {
+    [key: string]: unknown;
+}, K extends keyof T> = {
+    [_ in K]?: never;
+};
+export type Incremental<T> = T | {
+    [P in keyof T]?: P extends " $fragmentName" | "__typename" ? T[P] : never;
+};
+export type DateTimeISOString = string;
+/** All built-in and custom scalars, mapped to their actual values */
+export type Scalars = {
+    ID: {
+        input: string;
+        output: string;
+    };
+    String: {
+        input: string;
+        output: string;
+    };
+    Boolean: {
+        input: boolean;
+        output: boolean;
+    };
+    Int: {
+        input: number;
+        output: number;
+    };
+    Float: {
+        input: number;
+        output: number;
+    };
+    /** The ISO 4217 currency code of the monetary field definition. */
+    Currency: {
+        input: string;
+        output: string;
+    };
+    /** Cursor scalar. */
+    Cursor: {
+        input: string;
+        output: string;
+    };
+    /** Date without time, Eg. 2019-01-01 */
+    Date: {
+        input: DateTimeISOString;
+        output: DateTimeISOString;
+    };
+    /** DateTime represents a “date-time” as specified in section 5.6 of RFC 3339 */
+    DateTime: {
+        input: DateTimeISOString;
+        output: DateTimeISOString;
+    };
+    /** Duration represents an ISO 8601 duration */
+    Duration: {
+        input: any;
+        output: any;
+    };
+    /** Valid email address according to https://owasp.org/www-community/OWASP_Validation_Regex_Repository */
+    EmailAddress: {
+        input: string;
+        output: string;
+    };
+    /** A (possiblely multidimensional) set of coordinates following x, y, z order. */
+    GeoJSONCoordinates: {
+        input: [number, number] | [number, number][] | [number, number][][];
+        output: [number, number] | [number, number][] | [number, number][][];
+    };
+    /** Raw JSON object structure, not serialized to string */
+    JSON: {
+        input: any;
+        output: any;
+    };
+    /** The `JSONObject` scalar type represents JSON values as a string */
+    JSONObject: {
+        input: any;
+        output: any;
+    };
+    /** 24-hour clock time string in the format hh:mm:ss.sss or hh:mm:ss if partial seconds is zero */
+    LocalTime: {
+        input: any;
+        output: any;
+    };
+    /** Javascript `Long`. Type represents a 64 bit integer. */
+    Long: {
+        input: any;
+        output: any;
+    };
+    /** Phone number in E.164 format */
+    PhoneNumber: {
+        input: string;
+        output: string;
+    };
+    /** The `PublicIrisAppManifest` scalar type represents an Iris App Manifest as JSON */
+    PublicIrisAppManifest: {
+        input: PublicIrisAppManifest;
+        output: PublicIrisAppManifest;
+    };
+    /** Uniform resource locator */
+    Url: {
+        input: string;
+        output: string;
+    };
+    /** YearMonth scalar */
+    YearMonth: {
+        input: any;
+        output: any;
+    };
+};
+export type GetAssetTimezoneQueryVariables = Exact<{
+    assetId: Scalars["ID"]["input"];
+}>;
+export type GetAssetTimezoneQuery = {
+    __typename?: "Query";
+    asset: {
+        __typename?: "Asset";
+        locations: {
+            __typename?: "Locations";
+            latest: {
+                __typename?: "GeoJSONFeatureForAsset";
+                properties: {
+                    __typename?: "GeoJSONPropertiesForAsset";
+                    timeZone: string | null;
+                } | null;
+            } | null;
+        } | null;
+    } | null;
+};
+export declare const GetAssetTimezoneDocument: DocumentNode<GetAssetTimezoneQuery, GetAssetTimezoneQueryVariables>;

package/src/generated/graphql-api/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./fragment-masking";
+export * from "./gql";

package/src/index.d.ts

@@ -1,4 +1,3 @@
-export * from "./AssetTimezoneContext";
 export * from "./localeUtils";
 export * from "./useDateAndTime";
 export * from "./useLocale";

package/src/test/index.d.ts

@@ -0,0 +1 @@
+export { mockAssetTimezone } from "./mocks/mockAssetTimezone";

package/src/test/mocks/mockAssetTimezone.d.ts

@@ -0,0 +1,17 @@
+import { MockedResponse } from "@apollo/client/testing";
+import { GetAssetTimezoneQuery } from "../../generated/graphql-api/graphql";
+type AssetTimezoneMockProps = {
+    assetId: string;
+    timeZone: string;
+};
+/**
+ * Mocks the asset timezone query.
+ *
+ * @param { AssetTimezoneMockProps} props - The properties for the asset timezone query.
+ * @param {string} [props.assetId] - The asset id
+ * @param {string} [props.timeZone] - The timezone to mock
+ */
+export declare const mockAssetTimezone: ({ assetId, timeZone, }: AssetTimezoneMockProps) => MockedResponse<GetAssetTimezoneQuery> & {
+    data: NonNullable<GetAssetTimezoneQuery>;
+};
+export {};

package/src/useTimezone.d.ts

@@ -1,11 +1,30 @@
-import { type TimeZone } from "./AssetTimezoneContext";
+export interface TimeZone {
+    /**
+     * The unique id of the timezone
+     *
+     * @example "America/Denver"
+     */
+    id: string;
+    /**
+     * The human-readable name of the timezone. Combines id and offset.
+     *
+     * @example "America/Denver (-06:00 MDT)"
+     */
+    name: string;
+    /**
+     * @example "-06:00 MDT"
+     */
+    offset: string;
+}
 interface UseTimezoneReturn {
     current: TimeZone;
     assetTimeZone: TimeZone | null;
     preferred: TimeZone;
     setCustomTimezone: (timezone: string | null) => void;
-    /** The resolved custom timezone value (e.g. "America/Denver"). Exposed so host apps can pass it to Iris App iframes via Penpal. */
-    customTimezone: string | null;
+}
+interface TimezoneProps {
+    /** supply assetId to fetch the timezone for the given machine */
+    assetId?: string;
 }
 /**
  * Resolves the active timezone based on user preference, custom override, and optional asset location.
@@ -13,9 +32,6 @@ interface UseTimezoneReturn {
  * Returns `current` (browser or custom override), `preferred` (resolved per user settings
  * and optional asset), and `assetTimeZone` (fetched from the asset's GPS location).
  *
- * The asset timezone is resolved by the nearest `AssetTimezoneProvider` in the component tree.
- * Use `AssetTimezoneProvider` on asset-detail pages to enable machine-timezone resolution.
- *
  * **When to use:**
  * - Use `useTimezone` whenever you need to display or calculate dates in the correct
  *   timezone — especially on asset-detail pages where the machine's timezone may differ
@@ -24,5 +40,5 @@ interface UseTimezoneReturn {
  * - Do **not** rely on `Intl.DateTimeFormat().resolvedOptions().timeZone` directly —
  *   this hook respects the user's preference setting (browser, machine, or custom).
  */
-export declare const useTimezone: () => UseTimezoneReturn;
+export declare const useTimezone: ({ assetId }?: TimezoneProps) => UseTimezoneReturn;
 export {};

package/src/AssetTimezoneContext.d.ts

@@ -1,24 +0,0 @@
-export interface TimeZone {
-    /**
-     * The unique id of the timezone
-     *
-     * @example "America/Denver"
-     */
-    id: string;
-    /**
-     * The human-readable name of the timezone. Combines id and offset.
-     *
-     * @example "America/Denver (-06:00 MDT)"
-     */
-    name: string;
-    /**
-     * @example "-06:00 MDT"
-     */
-    offset: string;
-}
-export interface AssetTimezoneContextValue {
-    assetTimeZone: TimeZone | null;
-}
-export declare const AssetTimezoneContext: import("react").Context<AssetTimezoneContextValue>;
-/** Returns the resolved asset timezone from the nearest AssetTimezoneProvider in the component tree. */
-export declare const useAssetTimezoneContext: () => AssetTimezoneContextValue;