chore: 🤖 createdAt,updatedAt because it was a bad idea to change that…

…. Management side

components/blog/BlogListModelByYear.vue

@@ -20,7 +20,7 @@
               path: content.path,
               meta: {
                 locale: content.locale ? content.locale : 'en-CA',
-                date: content.date,
+                date: content.createdAt,
               },
             }"
             class="font-serif text-xl italic no-underline"

components/global/AppContentDate.vue

@@ -1,5 +1,5 @@
 <template>
-  <time v-if="content.date" :datetime="datetime" :title="textual">
+  <time v-if="content.createdAt" :datetime="datetime" :title="textual">
     {{ yyyymmdd }}
   </time>
 </template>
@@ -35,7 +35,7 @@
     },
     computed: {
       yyyymmdd(): string {
-        const { date } = this.content
+        const date = this.content?.createdAt
         let out = ''
         if (date) {
           const first = date.split('T')[0]
@@ -44,8 +44,8 @@
         return out
       },
       datetime(): string {
-        const { date } = this.content
-        return date
+        const createdAt = this.content?.createdAt
+        return createdAt
       },
       textual(): string {
         return this.formatDate({
@@ -60,7 +60,7 @@
         let out = ''
         try {
           const locale = this.content?.locale ?? 'fr-CA'
-          out = this.content?.date ?? ''
+          out = this.content?.createdAt ?? ''
           const { temporalDate = '' } = getPrettyfiedTemporalDate(
             this.content,
             locale,

lib/model/content/break-into-years.ts

@@ -16,17 +16,17 @@ export const extractYearFromDateString = (dateString: string | ''): number => {
 }
 
 export const extractYearFromRecord = (
-  content: Record<'created' | 'updated', string>,
+  content: Record<'createdAt' | 'updatedAt', string>,
 ): number => {
   let out: number = 0
 
-  const { created = '', updated } = content
+  const { createdAt = '', updatedAt } = content
 
-  if (created !== '') {
-    out = extractYearFromDateString(created)
+  if (createdAt !== '') {
+    out = extractYearFromDateString(createdAt)
   }
-  if (out === 0 && updated) {
-    out = extractYearFromDateString(updated)
+  if (out === 0 && updatedAt) {
+    out = extractYearFromDateString(updatedAt)
   }
 
   return out
@@ -58,5 +58,5 @@ export const breakIntoYears = (
   // Make sure it's sorted by year, chronologically
   return out.filter(([y]) => y !== 0).sort((a, b) => b[0] - a[0])
   //                         ^^^^^^^
-  //                         | We set all with no created date into a bucket aside and don't display them.
+  //                         | We set all with no createdAt date into a bucket aside and don't display them.
 }

lib/model/content/model.ts

@@ -24,23 +24,16 @@ export interface IBaseNuxtContentResult extends IResult {
   /**
    * Nuxt internal file creation date
    *
-   * #ToLearn: Figure Out Unsure if it's filesystem
+   * Hard-coded, per file, desired publication date.
+   * If it's in the file (i.e. hardcoded), otherwise Nuxt will take from the filesystem.
    */
   createdAt: string
   /**
    * Nuxt internal file updated date
    *
-   * #ToLearn: Figure Out Unsure if it's filesystem
+   * If it's in the file (i.e. hardcoded), otherwise Nuxt will take from the filesystem.
    */
   updatedAt: string
-  /**
-   * Hard-coded, per file, desired publication date.
-   */
-  created: string
-  /**
-   * Hard-coded, per file, desired last updated date.
-   */
-  updated: string
   dir: string
   extension: string
   path: string
@@ -102,7 +95,7 @@ export type INuxtContentPrevNext = Pick<
 export interface INuxtContentIndexResult
   extends Pick<
     INuxtContentResult,
-    'created' | 'updated' | 'locale' | 'path' | 'slug' | 'title'
+    'createdAt' | 'updatedAt' | 'locale' | 'path' | 'slug' | 'title'
   > {
   prettyfiedTemporalDate?: IPrettyfiedTemporalDate
 }
@@ -138,6 +131,8 @@ export const isNuxtContentResult = (
 export const queryNuxtContent = async (
   $content: Context['$content'],
   route: Context['route'],
+  year?: string,
+  month?: string,
 ): Promise<INuxtContentResult[]> => {
   let contents: INuxtContentResult[] = []
   const { query = {} as Context['route']['query'] } = route
@@ -157,7 +152,7 @@ export const queryNuxtContent = async (
   let ds = $content('blog', { deep: true })
     .sortBy('created', 'desc')
     .only([
-      'created',
+      'createdAt',
       'excerpt',
       'locale',
       'path',
@@ -166,7 +161,7 @@ export const queryNuxtContent = async (
       'slug',
       'tags',
       'title',
-      'updated',
+      'updatedAt',
     ])
   if (q) {
     ds = ds.search(q)

lib/model/date.ts

@@ -71,7 +71,7 @@ export const formatTemporal = (
 }
 
 export const getPrettyfiedTemporalDate = (
-  content: Record<'created' | 'updated', string>,
+  content: Record<'createdAt' | 'updatedAt', string>,
   locale = 'fr-CA',
   format?: Intl.DateTimeFormatOptions,
 ): IPrettyfiedTemporalDate => {
@@ -83,7 +83,7 @@ export const getPrettyfiedTemporalDate = (
    *
    * @TODO #23 It MUST be a string that has no Z in its notation.
    */
-  let field = content?.date ?? content?.created ?? content?.updated ?? 0
+  let field = content?.date ?? content?.createdAt ?? content?.updatedAt ?? 0
 
   if (/\d\d\d\d-\d\d-\d\dT/.test(field)) {
     field = field.split('T')[0]

lib/runtime/nuxt-feed.ts

@@ -11,13 +11,11 @@ const EXAMPLE_NUXT_CONTENT_RESULT: Partial<INuxtContentResult>[] = [
     title:
       'Things I’ve worked on in the last two years while maintaining WebPlatform.org',
     locale: 'en-CA',
-    created: '2017-02-09T00:00:00.000Z',
-    updated: '2023-11-20T00:00:00.000Z',
+    createdAt: '2017-02-09T00:00:00.000Z',
+    updatedAt: '2023-11-20T00:00:00.000Z',
     dir: '/blog/2017/02',
     path: '/blog/2017/02/things-i-ve-worked-on-while-maintaining-webplatform-org',
     slug: 'things-i-ve-worked-on-while-maintaining-webplatform-org',
-    createdAt: '2024-10-01T17:48:55.423Z',
-    updatedAt: '2024-10-01T17:48:55.424Z',
   },
 ]
 
@@ -36,14 +34,16 @@ const baseUrlNoTrailingSlash = (u: string): string => {
 
 let failedDatesOnce = false
 
-const dateStringToDateObject = (created, tz) => {
+const dateStringToDateObject = (createdAt, tz) => {
   // #TODO Make sure we return with proper time offset for Montreal, not UTC
-  const createdNormalized =
-    !!created && !created.includes('T') ? created + 'T00:00:00.000Z' : created
+  const createdAtNormalized =
+    !!createdAt && !createdAt.includes('T')
+      ? createdAt + 'T00:00:00.000Z'
+      : createdAt
   let published: Date | undefined
   let instant
   try {
-    instant = Temporal.Instant.from(createdNormalized)
+    instant = Temporal.Instant.from(createdAtNormalized)
     instant = instant.toZonedDateTimeISO(tz)
     published = new Date(instant.epochMilliseconds)
   } catch {
@@ -102,10 +102,10 @@ export const createNuxtFeedCreate =
 
     // ------ BEGIN [ /blog ] ------------------------------
     const ds1 = $content('blog', { deep: true })
-      .sortBy('created', 'desc')
+      .sortBy('createdAt', 'desc')
       .only([
         'categories',
-        'created',
+        'createdAt',
         'description',
         'dir',
         'excerpt',
@@ -115,7 +115,7 @@ export const createNuxtFeedCreate =
         'slug',
         'tags',
         'title',
-        'updated',
+        'updatedAt',
       ])
     const p1 = (await ds1.fetch()) as INuxtContentResult[]
     all.push(
@@ -127,9 +127,9 @@ export const createNuxtFeedCreate =
 
     // ------ BEGIN [ /code-review ] ------------------------------
     const ds2 = $content('code-review', { deep: true })
-      .sortBy('created', 'desc')
+      .sortBy('createdAt', 'desc')
       .only([
-        'created',
+        'createdAt',
         'description',
         'excerpt',
         'locale',
@@ -138,17 +138,17 @@ export const createNuxtFeedCreate =
         'slug',
         'tags',
         'title',
-        'updated',
+        'updatedAt',
       ])
     const p2 = (await ds2.fetch()) as INuxtContentResult[]
     all.push(...p2)
     // ------ END   [ /code-review ] ------------------------------
 
     // ------ BEGIN [ /glossary ] ------------------------------
     const ds3 = $content('glossary', { deep: true })
-      .sortBy('created', 'desc')
+      .sortBy('createdAt', 'desc')
       .only([
-        'created',
+        'createdAt',
         'description',
         'excerpt',
         'locale',
@@ -157,7 +157,7 @@ export const createNuxtFeedCreate =
         'slug',
         'tags',
         'title',
-        'updated',
+        'updatedAt',
       ])
     const p3 = (await ds3.fetch()) as INuxtContentResult[]
     all.push(...p3)
@@ -184,25 +184,25 @@ export const createNuxtFeedCreate =
       }
       */
 
-      const published = dateStringToDateObject(article.created, timeZone)
+      const published = dateStringToDateObject(article.createdAt, timeZone)
       if (published) {
         Reflect.set(item, 'published', published)
       } else {
         failedDates.push({
           path: article.path,
-          propertyName: 'article.created',
-          value: article.created,
+          propertyName: 'article.createdAt',
+          value: article.createdAt,
         })
       }
-      const updated = dateStringToDateObject(article.updated, timeZone)
+      const updated = dateStringToDateObject(article.updatedAt, timeZone)
       if (updated) {
         // Because "date" field is for updated
         Reflect.set(item, 'date', updated)
       } else {
         failedDates.push({
           path: article.path,
           propertyName: 'article.updated',
-          value: article.updated,
+          value: article.updatedAt,
         })
       }
 

pages/blog/_year/_month/_slug.vue

@@ -1,11 +1,11 @@
 <template>
   <div class="pages__blog__year__month__slug--item">
-    <div :key="content.slug + '--' + content.created">
+    <div :key="content.slug + '--' + content.createdAt">
       <keep-alive>
         <app-very-old-article
           :preamble="preamble"
           :locale="content.locale || 'en-CA'"
-          :date="content.created"
+          :date="content.createdAt"
           class="my-4"
           alert-type="warn"
           role="alert"
@@ -198,16 +198,16 @@
            * Ideally, should:
            * - Be `status: publish`
            * - Not have a `redirect: #####`
-           * - At the neighbooring published date
+           * - At the neighbooring published (createdAt) date
            *
            * [1]: ~/blog/2015/11/recover-discourse-backup-change-domain-name
            * [2]: ~/blog/2024/03/managing-email-aliases-with-protonmail-and-simplelogin-to-sort-automatically-into-inbox-folders-based-local-part
            * [3]: ~/blog/2024/03/managing-email-aliases-with-protonmail-automatic-sorting
            */
         })
         .only(['title', 'path', 'locale'])
-        .sortBy('created', 'asc')
         .surround(slug)
+        .sortBy('createdAt', 'asc')
 
       const items = await dal.fetch()
       const [prev, next] = items

pages/blog/_year/_month/index.vue

@@ -36,24 +36,15 @@
     components: {
       'blog-list-model-by-year': BlogListModelByYear,
     },
-    async asyncData({ $content, params }) {
-      const { year, month } = params
-
+    async asyncData({ $content, route, params }) {
       let contents: INuxtContentIndexResult[] = []
       try {
-        contents = await $content('blog', year, month, { deep: true })
-          .sortBy('created', 'desc')
-          .only([
-            'created',
-            'excerpt',
-            'locale',
-            'path',
-            'slug',
-            'tags',
-            'title',
-            'updated',
-          ])
-          .fetch()
+        contents = await queryNuxtContent(
+          $content,
+          route,
+          params.year,
+          params.month,
+        )
       } catch (_) {
         // ...
       }

pages/blog/_year/index.vue

@@ -36,25 +36,10 @@
     components: {
       'blog-list-model-by-year': BlogListModelByYear,
     },
-    async asyncData({ $content, params }) {
-      const { year } = params
-
+    async asyncData({ $content, route, params }) {
       let contents: INuxtContentIndexResult[] = []
       try {
-        contents = await $content('blog', year, { deep: true })
-          .sortBy('created', 'desc')
-          .only([
-            'created',
-            'excerpt',
-            'locale',
-            'path',
-            'preamble',
-            'slug',
-            'tags',
-            'title',
-            'updated',
-          ])
-          .fetch()
+        contents = await queryNuxtContent($content, route, params.year)
       } catch (_) {
         // ..
       }