feat: Add $atime intrinsic to Files

This field will track the last access time of the file in the stored
metadata.

It's added as a part of the `File` interface definition, and implemented for
`MarkdownPage`, `Canvas`, and `GenericFile`, as well as their JSON representations.

Author: dljsjr

src/index/types/canvas.ts

@@ -34,6 +34,7 @@ export class Canvas implements Linkable, File, Linkbearing, Taggable, Indexable,
     $types: string[] = Canvas.TYPES;
     $typename: string = "Canvas";
 
+    $atime?: DateTime;
     $ctime: DateTime;
     $mtime: DateTime;
 
@@ -75,6 +76,7 @@ export class Canvas implements Linkable, File, Linkbearing, Taggable, Indexable,
             $cards: this.$cards.map((x) => x.json()) as JsonCanvasCard[],
             $ctime: this.$ctime.toMillis(),
             $mtime: this.$mtime.toMillis(),
+            $atime: this.$atime?.toMillis(),
             $size: this.$size,
             $links: this.$links,
             $path: this.$path,
@@ -101,6 +103,7 @@ export class Canvas implements Linkable, File, Linkbearing, Taggable, Indexable,
             $cards: cards,
             $ctime: DateTime.fromMillis(raw.$ctime),
             $mtime: DateTime.fromMillis(raw.$mtime),
+            $atime: raw.$atime ? DateTime.fromMillis(raw.$atime) : undefined,
             $size: raw.$size,
             $extension: "canvas",
             $path: raw.$path,

src/index/types/files.ts

@@ -19,15 +19,18 @@ export class GenericFile implements File, Indexable, Fieldbearing, Linkable {
     $ctime: DateTime;
     /** Obsidian-provided date this page was modified. */
     $mtime: DateTime;
+    /** Timestamp of last file access, as determined by inspecting `file-open` workspace events */
+    $atime?: DateTime;
     /** Obsidian-provided size of this page in bytes. */
     $size: number;
     /** The extension of the file. */
     $extension: string;
 
-    public constructor(path: string, ctime: DateTime, mtime: DateTime, size: number) {
+    public constructor(path: string, ctime: DateTime, mtime: DateTime, size: number, atime?: DateTime) {
         this.$path = path;
         this.$ctime = ctime;
         this.$mtime = mtime;
+        this.$atime = atime;
         this.$size = size;
 
         const lastDot = path.lastIndexOf(".");

src/index/types/indexable.ts

@@ -44,6 +44,8 @@ export interface File extends Linkable {
     $ctime: DateTime;
     /** Obsidian-provided date this page was modified. */
     $mtime: DateTime;
+    /** Timestamp of last file access, as determined by inspecting `file-open` workspace events */
+    $atime?: DateTime;
     /** Obsidian-provided size of this page in bytes. */
     $size: number;
     /** The extension of the file. */

src/index/types/json/canvas.ts

@@ -36,6 +36,8 @@ export interface JsonCanvas {
     $ctime: number;
     /** Last modified time as a UNIX epoch time in milliseconds. */
     $mtime: number;
+    /** Last access time as a UNIX epoch time in milliseconds. */
+    $atime?: number;
     /** All tags in the canvas. */
     $tags: string[];
     /** All links in the canvas. */

src/index/types/json/markdown.ts

@@ -33,6 +33,8 @@ export interface JsonMarkdownPage {
     $ctime: number;
     /** Obsidian-provided date this page was modified. */
     $mtime: number;
+    /** Timestamp of last file access, as determined by inspecting `file-open` workspace events */
+    $atime?: number;
     /** The extension; for markdown files, almost always '.md'. */
     $extension: string;
     /** Obsidian-provided size of this page in bytes. */

src/index/types/markdown.ts

@@ -61,6 +61,8 @@ export class MarkdownPage implements File, Linkbearing, Taggable, Indexable, Fie
     $ctime: DateTime;
     /** Obsidian-provided date this page was modified. */
     $mtime: DateTime;
+    /** Timestamp of last file access, as determined by inspecting `file-open` workspace events */
+    $atime?: DateTime;
     /** The extension; for markdown files, almost always '.md'. */
     $extension: string;
     /** Obsidian-provided size of this page in bytes. */
@@ -89,6 +91,7 @@ export class MarkdownPage implements File, Linkbearing, Taggable, Indexable, Fie
             $infields: mapObjectValues(raw.$infields, (field) => normalizeLinks(valueInlineField(field), normalizer)),
             $ctime: DateTime.fromMillis(raw.$ctime),
             $mtime: DateTime.fromMillis(raw.$mtime),
+            $atime: raw.$atime ? DateTime.fromMillis(raw.$atime) : undefined,
             $extension: raw.$extension,
             $size: raw.$size,
             $position: raw.$position,
@@ -140,6 +143,7 @@ export class MarkdownPage implements File, Linkbearing, Taggable, Indexable, Fie
             $infields: mapObjectValues(this.$infields, jsonInlineField),
             $ctime: this.$ctime.toMillis(),
             $mtime: this.$mtime.toMillis(),
+            $atime: this.$atime?.toMillis(),
             $extension: this.$extension,
             $size: this.$size,
             $position: this.$position,