@infinitetoken/lumber-kit 0.7.0 → 0.8.0

package/dist/index.d.mts

@@ -49,48 +49,6 @@ declare const logLevelNameToLevel: Record<LogLevelName, LogLevel>;
 /** All valid log levels, ordered from least to most severe. */
 declare const logLevels: readonly LogLevel[];
 
-/** A push threshold one past Fatal, which no log reaches: log pushes are off (the account's, or one app's). */
-declare const PUSH_OFF = 5;
-/** The lowest log level that pushes, or PUSH_OFF. Stored as a notification preference's `minimumLevel`. */
-type PushThreshold = LogLevel | typeof PUSH_OFF;
-/** The threshold a user gets when none is set. */
-declare const DEFAULT_PUSH_THRESHOLD: PushThreshold;
-
-/** User subscription level. Mirrors User.subscriptionLevel in Lumber-API. */
-declare const enum SubscriptionLevel {
-    Hobby = 0,
-    Dev = 1,
-    Pro = 2,
-    Enterprise = 3
-}
-/** String name for each subscription level, suitable for display and Redux state. */
-type SubscriptionLevelName = 'hobby' | 'dev' | 'pro' | 'enterprise';
-/** Maps numeric subscription level to its string level name. */
-declare const subscriptionLevelToName: Record<SubscriptionLevel, SubscriptionLevelName>;
-/** All valid subscription levels, ordered from least to most severe. */
-declare const subscriptionLevels: readonly SubscriptionLevel[];
-type SubscriptionLimits = {
-    apps: number;
-    seats: number;
-    apiKeys: number;
-    logRetentionDays: number;
-    monthlyLogs: number;
-    /** Whether real-time WebSocket log streaming is available. */
-    realtimeLogs: boolean;
-    /** Minimum log level that triggers a push notification. Infinity means push is disabled. */
-    minPushLevel: number;
-};
-/** Per-level resource limits. Use Infinity to mean unlimited or disabled. */
-declare const subscriptionLimits: Record<SubscriptionLevel, SubscriptionLimits>;
-type SubscriptionPlan = {
-    /** Display name, as every surface shows it. */
-    name: string;
-    /** Monthly price in US dollars: 0 for free, null when priced per customer. */
-    monthlyPrice: number | null;
-};
-/** Each level's name and price. Stripe holds the prices themselves; these must match what it charges. */
-declare const subscriptionPlans: Record<SubscriptionLevel, SubscriptionPlan>;
-
 /**
  * An organization that owns apps and pays for member usage.
  * Team subscriptionLevel takes precedence over individual member levels.
@@ -667,6 +625,18 @@ interface LogTimeseriesQuery {
 }
 
 type Appearance = 'system' | 'dark' | 'light';
+/** A 24-hour clock (`19:15:44`) or a 12-hour one (`7:15:44 PM`). */
+type TimeClock = '24h' | '12h';
+/** The device's own time zone, or UTC. */
+type TimeZoneChoice = 'local' | 'utc';
+/**
+ * How a user reads times, on every device: the clock, and the zone that times, days and hours are in (the log list, the
+ * heatmap, pushes).
+ */
+interface TimeFormat {
+    clock: TimeClock;
+    zone: TimeZoneChoice;
+}
 interface PushToken {
     token: string;
     deviceId?: string;
@@ -701,6 +671,8 @@ interface UserRecord {
     appearance?: Appearance;
     color?: string;
     imageUrl?: string;
+    /** Null until the user picks one (DEFAULT_TIME_FORMAT). Missing from an API before it was kept. */
+    timeFormat?: TimeFormat | null;
     agreedToTermsVersion?: string;
     notificationPreferences: NotificationPreferences;
     pushTokens: PushToken[];
@@ -710,6 +682,50 @@ interface UserRecord {
     notesReadAt?: Record<string, string>;
 }
 
+/** A push threshold one past Fatal, which no log reaches: log pushes are off (the account's, or one app's). */
+declare const PUSH_OFF = 5;
+/** The lowest log level that pushes, or PUSH_OFF. Stored as a notification preference's `minimumLevel`. */
+type PushThreshold = LogLevel | typeof PUSH_OFF;
+/** The threshold a user gets when none is set. */
+declare const DEFAULT_PUSH_THRESHOLD: PushThreshold;
+/** The time format a user gets until they pick one: 24-hour, in the device's own time zone. */
+declare const DEFAULT_TIME_FORMAT: TimeFormat;
+
+/** User subscription level. Mirrors User.subscriptionLevel in Lumber-API. */
+declare const enum SubscriptionLevel {
+    Hobby = 0,
+    Dev = 1,
+    Pro = 2,
+    Enterprise = 3
+}
+/** String name for each subscription level, suitable for display and Redux state. */
+type SubscriptionLevelName = 'hobby' | 'dev' | 'pro' | 'enterprise';
+/** Maps numeric subscription level to its string level name. */
+declare const subscriptionLevelToName: Record<SubscriptionLevel, SubscriptionLevelName>;
+/** All valid subscription levels, ordered from least to most severe. */
+declare const subscriptionLevels: readonly SubscriptionLevel[];
+type SubscriptionLimits = {
+    apps: number;
+    seats: number;
+    apiKeys: number;
+    logRetentionDays: number;
+    monthlyLogs: number;
+    /** Whether real-time WebSocket log streaming is available. */
+    realtimeLogs: boolean;
+    /** Minimum log level that triggers a push notification. Infinity means push is disabled. */
+    minPushLevel: number;
+};
+/** Per-level resource limits. Use Infinity to mean unlimited or disabled. */
+declare const subscriptionLimits: Record<SubscriptionLevel, SubscriptionLimits>;
+type SubscriptionPlan = {
+    /** Display name, as every surface shows it. */
+    name: string;
+    /** Monthly price in US dollars: 0 for free, null when priced per customer. */
+    monthlyPrice: number | null;
+};
+/** Each level's name and price. Stripe holds the prices themselves; these must match what it charges. */
+declare const subscriptionPlans: Record<SubscriptionLevel, SubscriptionPlan>;
+
 /**
  * The plaintext a plugin encrypts for one log call: its level and message, requestId and traceId when given, the
  * plugin's automatic context (pid, hostname and the like) with the call's context over it, and the call's other keys
@@ -727,6 +743,10 @@ declare const logDeliveryOutcome: (status: number | null) => LogDeliveryOutcome;
 declare const logRetryDelayMs: (failedAttempts: number) => number;
 
 declare const isValidAppearance: (value: unknown) => value is Appearance;
+/** A time format as sent or stored: an object with a known clock and zone, and nothing else. */
+declare const isValidTimeFormat: (value: unknown) => value is TimeFormat;
+/** A stored or sent time format, each part the default (DEFAULT_TIME_FORMAT) when it's missing or unknown. */
+declare const normalizeTimeFormat: (value: unknown) => TimeFormat;
 /** Accepts 3- and 6-digit hex color strings (#rgb, #rrggbb). */
 declare const isValidColor: (value: string) => boolean;
 /**
@@ -766,4 +786,4 @@ declare const apiErrorCodeOf: (body: unknown) => ApiErrorCode | null;
 /** A push notification's data as PushData, or null for data no Lumber push sends. */
 declare const parsePushData: (data: unknown) => PushData | null;
 
-export { APP_COLORS, type ApiErrorBody, type ApiErrorCode, type ApiKeyRecord, type ApiResponse, type AppCreatedRecord, type AppEncryptedKey, type AppKeyUpsertBody, type AppPermission, type AppPersonRecord, type AppRecord, type AppTeamAccess, type Appearance, type AppsQuery, type ClaimantKeyCheck, type ClientToServerEvents, DEFAULT_ACCENT, DEFAULT_API_ENDPOINT, DEFAULT_PUSH_THRESHOLD, type DeviceLinkApproveBody, type DeviceLinkCreateBody, type DeviceLinkCreatedRecord, type DeviceLinkPlatform, type DeviceLinkRecord, type DeviceLinkStatus, type FlagRecord, type FlagsQuery, type GuestRecord, type HolderKeyCheck, type InvitationRecord, type KeyCheckResult, type KeyHolder, type KeyPin, LOG_KEY_VERSION, type LogContext, type LogData, type LogDeliveryOutcome, type LogEncrypted, type LogIngestBody, LogLevel, type LogLevelName, type LogPayload, type LogRecord, type LogTimeseriesQuery, type LogsQuery, type NoteEncrypted, type NoteRecord, type NotesQuery, type NotificationPreference, type NotificationPreferences, PUSH_OFF, type PendingAppKey, type PendingDeviceLink, type PushData, type PushThreshold, type PushToken, type PushType, type ResponseMetadata, type ServerToClientEvents, type SocketAppPayload, SubscriptionLevel, type SubscriptionLevelName, type SubscriptionLimits, type SubscriptionPlan, type SubscriptionPlanRecord, type TeamMemberRecord, type TeamRecord, type TeamsQuery, type TimeseriesBucket, type TimeseriesResponse, type UserRecord, apiErrorCodeOf, apiErrorCodes, buildLogPayload, isApiErrorCode, isValidAppearance, isValidColor, isValidDeviceLinkStatus, isValidImageUrl, isValidLogLevel, isValidSubscriptionLevel, isValidTeamMemberRole, joinApiKey, logDelivery, logDeliveryOutcome, logLevelColors, logLevelNameToLevel, logLevelToName, logLevels, logRetryDelayMs, nameColor, normalizePushThreshold, parsePushData, personColor, resolveAppColor, splitApiKey, subscriptionLevelToName, subscriptionLevels, subscriptionLimits, subscriptionPlans };
+export { APP_COLORS, type ApiErrorBody, type ApiErrorCode, type ApiKeyRecord, type ApiResponse, type AppCreatedRecord, type AppEncryptedKey, type AppKeyUpsertBody, type AppPermission, type AppPersonRecord, type AppRecord, type AppTeamAccess, type Appearance, type AppsQuery, type ClaimantKeyCheck, type ClientToServerEvents, DEFAULT_ACCENT, DEFAULT_API_ENDPOINT, DEFAULT_PUSH_THRESHOLD, DEFAULT_TIME_FORMAT, type DeviceLinkApproveBody, type DeviceLinkCreateBody, type DeviceLinkCreatedRecord, type DeviceLinkPlatform, type DeviceLinkRecord, type DeviceLinkStatus, type FlagRecord, type FlagsQuery, type GuestRecord, type HolderKeyCheck, type InvitationRecord, type KeyCheckResult, type KeyHolder, type KeyPin, LOG_KEY_VERSION, type LogContext, type LogData, type LogDeliveryOutcome, type LogEncrypted, type LogIngestBody, LogLevel, type LogLevelName, type LogPayload, type LogRecord, type LogTimeseriesQuery, type LogsQuery, type NoteEncrypted, type NoteRecord, type NotesQuery, type NotificationPreference, type NotificationPreferences, PUSH_OFF, type PendingAppKey, type PendingDeviceLink, type PushData, type PushThreshold, type PushToken, type PushType, type ResponseMetadata, type ServerToClientEvents, type SocketAppPayload, SubscriptionLevel, type SubscriptionLevelName, type SubscriptionLimits, type SubscriptionPlan, type SubscriptionPlanRecord, type TeamMemberRecord, type TeamRecord, type TeamsQuery, type TimeClock, type TimeFormat, type TimeZoneChoice, type TimeseriesBucket, type TimeseriesResponse, type UserRecord, apiErrorCodeOf, apiErrorCodes, buildLogPayload, isApiErrorCode, isValidAppearance, isValidColor, isValidDeviceLinkStatus, isValidImageUrl, isValidLogLevel, isValidSubscriptionLevel, isValidTeamMemberRole, isValidTimeFormat, joinApiKey, logDelivery, logDeliveryOutcome, logLevelColors, logLevelNameToLevel, logLevelToName, logLevels, logRetryDelayMs, nameColor, normalizePushThreshold, normalizeTimeFormat, parsePushData, personColor, resolveAppColor, splitApiKey, subscriptionLevelToName, subscriptionLevels, subscriptionLimits, subscriptionPlans };

package/dist/index.d.ts

@@ -49,48 +49,6 @@ declare const logLevelNameToLevel: Record<LogLevelName, LogLevel>;
 /** All valid log levels, ordered from least to most severe. */
 declare const logLevels: readonly LogLevel[];
 
-/** A push threshold one past Fatal, which no log reaches: log pushes are off (the account's, or one app's). */
-declare const PUSH_OFF = 5;
-/** The lowest log level that pushes, or PUSH_OFF. Stored as a notification preference's `minimumLevel`. */
-type PushThreshold = LogLevel | typeof PUSH_OFF;
-/** The threshold a user gets when none is set. */
-declare const DEFAULT_PUSH_THRESHOLD: PushThreshold;
-
-/** User subscription level. Mirrors User.subscriptionLevel in Lumber-API. */
-declare const enum SubscriptionLevel {
-    Hobby = 0,
-    Dev = 1,
-    Pro = 2,
-    Enterprise = 3
-}
-/** String name for each subscription level, suitable for display and Redux state. */
-type SubscriptionLevelName = 'hobby' | 'dev' | 'pro' | 'enterprise';
-/** Maps numeric subscription level to its string level name. */
-declare const subscriptionLevelToName: Record<SubscriptionLevel, SubscriptionLevelName>;
-/** All valid subscription levels, ordered from least to most severe. */
-declare const subscriptionLevels: readonly SubscriptionLevel[];
-type SubscriptionLimits = {
-    apps: number;
-    seats: number;
-    apiKeys: number;
-    logRetentionDays: number;
-    monthlyLogs: number;
-    /** Whether real-time WebSocket log streaming is available. */
-    realtimeLogs: boolean;
-    /** Minimum log level that triggers a push notification. Infinity means push is disabled. */
-    minPushLevel: number;
-};
-/** Per-level resource limits. Use Infinity to mean unlimited or disabled. */
-declare const subscriptionLimits: Record<SubscriptionLevel, SubscriptionLimits>;
-type SubscriptionPlan = {
-    /** Display name, as every surface shows it. */
-    name: string;
-    /** Monthly price in US dollars: 0 for free, null when priced per customer. */
-    monthlyPrice: number | null;
-};
-/** Each level's name and price. Stripe holds the prices themselves; these must match what it charges. */
-declare const subscriptionPlans: Record<SubscriptionLevel, SubscriptionPlan>;
-
 /**
  * An organization that owns apps and pays for member usage.
  * Team subscriptionLevel takes precedence over individual member levels.
@@ -667,6 +625,18 @@ interface LogTimeseriesQuery {
 }
 
 type Appearance = 'system' | 'dark' | 'light';
+/** A 24-hour clock (`19:15:44`) or a 12-hour one (`7:15:44 PM`). */
+type TimeClock = '24h' | '12h';
+/** The device's own time zone, or UTC. */
+type TimeZoneChoice = 'local' | 'utc';
+/**
+ * How a user reads times, on every device: the clock, and the zone that times, days and hours are in (the log list, the
+ * heatmap, pushes).
+ */
+interface TimeFormat {
+    clock: TimeClock;
+    zone: TimeZoneChoice;
+}
 interface PushToken {
     token: string;
     deviceId?: string;
@@ -701,6 +671,8 @@ interface UserRecord {
     appearance?: Appearance;
     color?: string;
     imageUrl?: string;
+    /** Null until the user picks one (DEFAULT_TIME_FORMAT). Missing from an API before it was kept. */
+    timeFormat?: TimeFormat | null;
     agreedToTermsVersion?: string;
     notificationPreferences: NotificationPreferences;
     pushTokens: PushToken[];
@@ -710,6 +682,50 @@ interface UserRecord {
     notesReadAt?: Record<string, string>;
 }
 
+/** A push threshold one past Fatal, which no log reaches: log pushes are off (the account's, or one app's). */
+declare const PUSH_OFF = 5;
+/** The lowest log level that pushes, or PUSH_OFF. Stored as a notification preference's `minimumLevel`. */
+type PushThreshold = LogLevel | typeof PUSH_OFF;
+/** The threshold a user gets when none is set. */
+declare const DEFAULT_PUSH_THRESHOLD: PushThreshold;
+/** The time format a user gets until they pick one: 24-hour, in the device's own time zone. */
+declare const DEFAULT_TIME_FORMAT: TimeFormat;
+
+/** User subscription level. Mirrors User.subscriptionLevel in Lumber-API. */
+declare const enum SubscriptionLevel {
+    Hobby = 0,
+    Dev = 1,
+    Pro = 2,
+    Enterprise = 3
+}
+/** String name for each subscription level, suitable for display and Redux state. */
+type SubscriptionLevelName = 'hobby' | 'dev' | 'pro' | 'enterprise';
+/** Maps numeric subscription level to its string level name. */
+declare const subscriptionLevelToName: Record<SubscriptionLevel, SubscriptionLevelName>;
+/** All valid subscription levels, ordered from least to most severe. */
+declare const subscriptionLevels: readonly SubscriptionLevel[];
+type SubscriptionLimits = {
+    apps: number;
+    seats: number;
+    apiKeys: number;
+    logRetentionDays: number;
+    monthlyLogs: number;
+    /** Whether real-time WebSocket log streaming is available. */
+    realtimeLogs: boolean;
+    /** Minimum log level that triggers a push notification. Infinity means push is disabled. */
+    minPushLevel: number;
+};
+/** Per-level resource limits. Use Infinity to mean unlimited or disabled. */
+declare const subscriptionLimits: Record<SubscriptionLevel, SubscriptionLimits>;
+type SubscriptionPlan = {
+    /** Display name, as every surface shows it. */
+    name: string;
+    /** Monthly price in US dollars: 0 for free, null when priced per customer. */
+    monthlyPrice: number | null;
+};
+/** Each level's name and price. Stripe holds the prices themselves; these must match what it charges. */
+declare const subscriptionPlans: Record<SubscriptionLevel, SubscriptionPlan>;
+
 /**
  * The plaintext a plugin encrypts for one log call: its level and message, requestId and traceId when given, the
  * plugin's automatic context (pid, hostname and the like) with the call's context over it, and the call's other keys
@@ -727,6 +743,10 @@ declare const logDeliveryOutcome: (status: number | null) => LogDeliveryOutcome;
 declare const logRetryDelayMs: (failedAttempts: number) => number;
 
 declare const isValidAppearance: (value: unknown) => value is Appearance;
+/** A time format as sent or stored: an object with a known clock and zone, and nothing else. */
+declare const isValidTimeFormat: (value: unknown) => value is TimeFormat;
+/** A stored or sent time format, each part the default (DEFAULT_TIME_FORMAT) when it's missing or unknown. */
+declare const normalizeTimeFormat: (value: unknown) => TimeFormat;
 /** Accepts 3- and 6-digit hex color strings (#rgb, #rrggbb). */
 declare const isValidColor: (value: string) => boolean;
 /**
@@ -766,4 +786,4 @@ declare const apiErrorCodeOf: (body: unknown) => ApiErrorCode | null;
 /** A push notification's data as PushData, or null for data no Lumber push sends. */
 declare const parsePushData: (data: unknown) => PushData | null;
 
-export { APP_COLORS, type ApiErrorBody, type ApiErrorCode, type ApiKeyRecord, type ApiResponse, type AppCreatedRecord, type AppEncryptedKey, type AppKeyUpsertBody, type AppPermission, type AppPersonRecord, type AppRecord, type AppTeamAccess, type Appearance, type AppsQuery, type ClaimantKeyCheck, type ClientToServerEvents, DEFAULT_ACCENT, DEFAULT_API_ENDPOINT, DEFAULT_PUSH_THRESHOLD, type DeviceLinkApproveBody, type DeviceLinkCreateBody, type DeviceLinkCreatedRecord, type DeviceLinkPlatform, type DeviceLinkRecord, type DeviceLinkStatus, type FlagRecord, type FlagsQuery, type GuestRecord, type HolderKeyCheck, type InvitationRecord, type KeyCheckResult, type KeyHolder, type KeyPin, LOG_KEY_VERSION, type LogContext, type LogData, type LogDeliveryOutcome, type LogEncrypted, type LogIngestBody, LogLevel, type LogLevelName, type LogPayload, type LogRecord, type LogTimeseriesQuery, type LogsQuery, type NoteEncrypted, type NoteRecord, type NotesQuery, type NotificationPreference, type NotificationPreferences, PUSH_OFF, type PendingAppKey, type PendingDeviceLink, type PushData, type PushThreshold, type PushToken, type PushType, type ResponseMetadata, type ServerToClientEvents, type SocketAppPayload, SubscriptionLevel, type SubscriptionLevelName, type SubscriptionLimits, type SubscriptionPlan, type SubscriptionPlanRecord, type TeamMemberRecord, type TeamRecord, type TeamsQuery, type TimeseriesBucket, type TimeseriesResponse, type UserRecord, apiErrorCodeOf, apiErrorCodes, buildLogPayload, isApiErrorCode, isValidAppearance, isValidColor, isValidDeviceLinkStatus, isValidImageUrl, isValidLogLevel, isValidSubscriptionLevel, isValidTeamMemberRole, joinApiKey, logDelivery, logDeliveryOutcome, logLevelColors, logLevelNameToLevel, logLevelToName, logLevels, logRetryDelayMs, nameColor, normalizePushThreshold, parsePushData, personColor, resolveAppColor, splitApiKey, subscriptionLevelToName, subscriptionLevels, subscriptionLimits, subscriptionPlans };
+export { APP_COLORS, type ApiErrorBody, type ApiErrorCode, type ApiKeyRecord, type ApiResponse, type AppCreatedRecord, type AppEncryptedKey, type AppKeyUpsertBody, type AppPermission, type AppPersonRecord, type AppRecord, type AppTeamAccess, type Appearance, type AppsQuery, type ClaimantKeyCheck, type ClientToServerEvents, DEFAULT_ACCENT, DEFAULT_API_ENDPOINT, DEFAULT_PUSH_THRESHOLD, DEFAULT_TIME_FORMAT, type DeviceLinkApproveBody, type DeviceLinkCreateBody, type DeviceLinkCreatedRecord, type DeviceLinkPlatform, type DeviceLinkRecord, type DeviceLinkStatus, type FlagRecord, type FlagsQuery, type GuestRecord, type HolderKeyCheck, type InvitationRecord, type KeyCheckResult, type KeyHolder, type KeyPin, LOG_KEY_VERSION, type LogContext, type LogData, type LogDeliveryOutcome, type LogEncrypted, type LogIngestBody, LogLevel, type LogLevelName, type LogPayload, type LogRecord, type LogTimeseriesQuery, type LogsQuery, type NoteEncrypted, type NoteRecord, type NotesQuery, type NotificationPreference, type NotificationPreferences, PUSH_OFF, type PendingAppKey, type PendingDeviceLink, type PushData, type PushThreshold, type PushToken, type PushType, type ResponseMetadata, type ServerToClientEvents, type SocketAppPayload, SubscriptionLevel, type SubscriptionLevelName, type SubscriptionLimits, type SubscriptionPlan, type SubscriptionPlanRecord, type TeamMemberRecord, type TeamRecord, type TeamsQuery, type TimeClock, type TimeFormat, type TimeZoneChoice, type TimeseriesBucket, type TimeseriesResponse, type UserRecord, apiErrorCodeOf, apiErrorCodes, buildLogPayload, isApiErrorCode, isValidAppearance, isValidColor, isValidDeviceLinkStatus, isValidImageUrl, isValidLogLevel, isValidSubscriptionLevel, isValidTeamMemberRole, isValidTimeFormat, joinApiKey, logDelivery, logDeliveryOutcome, logLevelColors, logLevelNameToLevel, logLevelToName, logLevels, logRetryDelayMs, nameColor, normalizePushThreshold, normalizeTimeFormat, parsePushData, personColor, resolveAppColor, splitApiKey, subscriptionLevelToName, subscriptionLevels, subscriptionLimits, subscriptionPlans };

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   DEFAULT_ACCENT: () => DEFAULT_ACCENT,
   DEFAULT_API_ENDPOINT: () => DEFAULT_API_ENDPOINT,
   DEFAULT_PUSH_THRESHOLD: () => DEFAULT_PUSH_THRESHOLD,
+  DEFAULT_TIME_FORMAT: () => DEFAULT_TIME_FORMAT,
   LOG_KEY_VERSION: () => LOG_KEY_VERSION,
   LogLevel: () => LogLevel,
   PUSH_OFF: () => PUSH_OFF,
@@ -39,6 +40,7 @@ __export(index_exports, {
   isValidLogLevel: () => isValidLogLevel,
   isValidSubscriptionLevel: () => isValidSubscriptionLevel,
   isValidTeamMemberRole: () => isValidTeamMemberRole,
+  isValidTimeFormat: () => isValidTimeFormat,
   joinApiKey: () => joinApiKey,
   logDelivery: () => logDelivery,
   logDeliveryOutcome: () => logDeliveryOutcome,
@@ -49,6 +51,7 @@ __export(index_exports, {
   logRetryDelayMs: () => logRetryDelayMs,
   nameColor: () => nameColor,
   normalizePushThreshold: () => normalizePushThreshold,
+  normalizeTimeFormat: () => normalizeTimeFormat,
   parsePushData: () => parsePushData,
   personColor: () => personColor,
   resolveAppColor: () => resolveAppColor,
@@ -127,6 +130,7 @@ var logDelivery = {
 // src/constants/notifications.ts
 var PUSH_OFF = 5;
 var DEFAULT_PUSH_THRESHOLD = 2 /* Warn */;
+var DEFAULT_TIME_FORMAT = { clock: "24h", zone: "local" };
 
 // src/constants/subscription.ts
 var SubscriptionLevel = /* @__PURE__ */ ((SubscriptionLevel3) => {
@@ -185,6 +189,17 @@ var logRetryDelayMs = (failedAttempts) => Math.min(logDelivery.baseDelayMs * 2 *
 // src/utils/index.ts
 var appearanceValues = ["system", "dark", "light"];
 var isValidAppearance = (value) => appearanceValues.includes(value);
+var timeClocks = ["24h", "12h"];
+var timeZoneChoices = ["local", "utc"];
+var isValidTimeFormat = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const { clock, zone, ...rest } = value;
+  return timeClocks.includes(clock) && timeZoneChoices.includes(zone) && Object.keys(rest).length === 0;
+};
+var normalizeTimeFormat = (value) => {
+  const { clock, zone } = value && typeof value === "object" ? value : {};
+  return { clock: timeClocks.includes(clock) ? clock : DEFAULT_TIME_FORMAT.clock, zone: timeZoneChoices.includes(zone) ? zone : DEFAULT_TIME_FORMAT.zone };
+};
 var isValidColor = (value) => /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(value);
 var hashName = (name) => {
   let hash = 2166136261;
@@ -259,6 +274,7 @@ var parsePushData = (data) => {
   DEFAULT_ACCENT,
   DEFAULT_API_ENDPOINT,
   DEFAULT_PUSH_THRESHOLD,
+  DEFAULT_TIME_FORMAT,
   LOG_KEY_VERSION,
   LogLevel,
   PUSH_OFF,
@@ -274,6 +290,7 @@ var parsePushData = (data) => {
   isValidLogLevel,
   isValidSubscriptionLevel,
   isValidTeamMemberRole,
+  isValidTimeFormat,
   joinApiKey,
   logDelivery,
   logDeliveryOutcome,
@@ -284,6 +301,7 @@ var parsePushData = (data) => {
   logRetryDelayMs,
   nameColor,
   normalizePushThreshold,
+  normalizeTimeFormat,
   parsePushData,
   personColor,
   resolveAppColor,

package/dist/index.mjs

@@ -65,6 +65,7 @@ var logDelivery = {
 // src/constants/notifications.ts
 var PUSH_OFF = 5;
 var DEFAULT_PUSH_THRESHOLD = 2 /* Warn */;
+var DEFAULT_TIME_FORMAT = { clock: "24h", zone: "local" };
 
 // src/constants/subscription.ts
 var SubscriptionLevel = /* @__PURE__ */ ((SubscriptionLevel3) => {
@@ -123,6 +124,17 @@ var logRetryDelayMs = (failedAttempts) => Math.min(logDelivery.baseDelayMs * 2 *
 // src/utils/index.ts
 var appearanceValues = ["system", "dark", "light"];
 var isValidAppearance = (value) => appearanceValues.includes(value);
+var timeClocks = ["24h", "12h"];
+var timeZoneChoices = ["local", "utc"];
+var isValidTimeFormat = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const { clock, zone, ...rest } = value;
+  return timeClocks.includes(clock) && timeZoneChoices.includes(zone) && Object.keys(rest).length === 0;
+};
+var normalizeTimeFormat = (value) => {
+  const { clock, zone } = value && typeof value === "object" ? value : {};
+  return { clock: timeClocks.includes(clock) ? clock : DEFAULT_TIME_FORMAT.clock, zone: timeZoneChoices.includes(zone) ? zone : DEFAULT_TIME_FORMAT.zone };
+};
 var isValidColor = (value) => /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(value);
 var hashName = (name) => {
   let hash = 2166136261;
@@ -196,6 +208,7 @@ export {
   DEFAULT_ACCENT,
   DEFAULT_API_ENDPOINT,
   DEFAULT_PUSH_THRESHOLD,
+  DEFAULT_TIME_FORMAT,
   LOG_KEY_VERSION,
   LogLevel,
   PUSH_OFF,
@@ -211,6 +224,7 @@ export {
   isValidLogLevel,
   isValidSubscriptionLevel,
   isValidTeamMemberRole,
+  isValidTimeFormat,
   joinApiKey,
   logDelivery,
   logDeliveryOutcome,
@@ -221,6 +235,7 @@ export {
   logRetryDelayMs,
   nameColor,
   normalizePushThreshold,
+  normalizeTimeFormat,
   parsePushData,
   personColor,
   resolveAppColor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infinitetoken/lumber-kit",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Shared TypeScript types and wire format contracts for the Lumber cloud logging suite",
   "keywords": [
     "lumber",