Clarify types

web/app/components/document/sidebar.hbs

@@ -285,7 +285,7 @@
 
       <div class="flex flex-col items-start space-y-2">
         <Document::Sidebar::SectionHeader @title="Created" />
-        <p>{{or @document.created "Unknown"}}</p>
+        <p>{{or (parse-date @document.created) "Unknown"}}</p>
       </div>
 
       <div class="flex flex-col items-start space-y-2">

web/app/components/row-results.hbs

@@ -31,7 +31,7 @@
             {{#each @docs as |doc|}}
               <Doc::Row
                 @avatar="{{get doc.ownerPhotos 0}}"
-                @createdDate={{doc.created}}
+                @createdDate="{{parse-date doc.created}}"
                 @docID="{{doc.objectID}}"
                 @docNumber="{{doc.docNumber}}"
                 @docType="{{doc.docType}}"

web/app/helpers/parse-date.ts

@@ -4,17 +4,14 @@ export interface ParseDateHelperSignature {
   Args: {
     Positional: [
       time: string | number | Date | undefined,
-      monthFormat: undefined | "short" | "long"
+      monthFormat?: "short" | "long"
     ];
     Return: Date | undefined;
   };
 }
 
 const parseDateHelper = helper<ParseDateHelperSignature>(
-  ([time, monthFormat = "short"]: [
-    string | number | Date | undefined,
-    undefined | "short" | "long"
-  ]) => {
+  ([time, monthFormat = "short"]) => {
     return parseDate(time, monthFormat);
   }
 );

web/app/types/document.d.ts

@@ -5,9 +5,26 @@ export interface HermesDocument {
 
   status: string;
   product?: string;
-  created: string; // E.g., "Aug 16, 2023"
+
+  /**
+   * A human-readable date string, e.g., "Aug 16, 2028".
+   * Mutated in the layout by the `parse-date` helper to place
+   * the date before the month.
+   */
+  created: string;
+
+  /**
+   * A timestamp in seconds. Used for sorting.
+   */
   createdTime: number;
-  modifiedTime?: number; // Not available on drafts fetched as Hits from backend
+
+  /**
+   * A timestamp in seconds. Used Translated by the `time-ago` helper
+   * into a human-readable string, e.g., "2 days ago."
+   * Not available on drafts fetched as Hits from backend.
+   */
+  modifiedTime?: number;
+
   docNumber: string;
   docType: string;
   title: string;