feat: generate lexicons on postinstall & log out marshalling to standard site

Author: jonathanyeong

.gitignore

@@ -36,3 +36,6 @@ test-results/
 
 # Lighthouse
 .lighthouseci
+
+# Generated lexicon types
+shared/types/lexicons/

lexicons.json

@@ -0,0 +1,14 @@
+{
+  "version": 1,
+  "lexicons": ["site.standard.document"],
+  "resolutions": {
+    "com.atproto.repo.strongRef": {
+      "uri": "at://did:plc:6msi3pj7krzih5qxqtryxlzw/com.atproto.lexicon.schema/com.atproto.repo.strongRef",
+      "cid": "bafyreifrkdbnkvfjujntdaeigolnrjj3srrs53tfixjhmacclps72qlov4"
+    },
+    "site.standard.document": {
+      "uri": "at://did:plc:re3ebnp5v7ffagz6rb6xfei4/com.atproto.lexicon.schema/site.standard.document",
+      "cid": "bafyreigdukg62hmel4jbdvghdsoaphslhrdktmahzdyokomuka6yejetwa"
+    }
+  }
+}

lexicons/com/atproto/repo/strongRef.json

@@ -0,0 +1,22 @@
+{
+  "id": "com.atproto.repo.strongRef",
+  "defs": {
+    "main": {
+      "type": "object",
+      "required": ["uri", "cid"],
+      "properties": {
+        "cid": {
+          "type": "string",
+          "format": "cid"
+        },
+        "uri": {
+          "type": "string",
+          "format": "at-uri"
+        }
+      }
+    }
+  },
+  "$type": "com.atproto.lexicon.schema",
+  "lexicon": 1,
+  "description": "A URI with a content-hash fingerprint."
+}

lexicons/site/standard/document.json

@@ -0,0 +1,79 @@
+{
+  "id": "site.standard.document",
+  "defs": {
+    "main": {
+      "key": "tid",
+      "type": "record",
+      "record": {
+        "type": "object",
+        "required": ["site", "title", "publishedAt"],
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Combine with site or publication url to construct a canonical URL to the document. Prepend with a leading slash."
+          },
+          "site": {
+            "type": "string",
+            "format": "uri",
+            "description": "Points to a publication record (at://) or a publication url (https://) for loose documents. Avoid trailing slashes."
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxLength": 1280,
+            "description": "Array of strings used to tag or categorize the document. Avoid prepending tags with hashtags.",
+            "maxGraphemes": 128
+          },
+          "title": {
+            "type": "string",
+            "maxLength": 5000,
+            "description": "Title of the document.",
+            "maxGraphemes": 500
+          },
+          "content": {
+            "refs": [],
+            "type": "union",
+            "closed": false,
+            "description": "Open union used to define the record's content. Each entry must specify a $type and may be extended with other lexicons to support additional content formats."
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "datetime",
+            "description": "Timestamp of the documents last edit."
+          },
+          "coverImage": {
+            "type": "blob",
+            "accept": ["image/*"],
+            "maxSize": 1000000,
+            "description": "Image to used for thumbnail or cover image. Less than 1MB is size."
+          },
+          "bskyPostRef": {
+            "ref": "com.atproto.repo.strongRef",
+            "type": "ref",
+            "description": "Strong reference to a Bluesky post. Useful to keep track of comments off-platform."
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 30000,
+            "description": "A brief description or excerpt from the document.",
+            "maxGraphemes": 3000
+          },
+          "publishedAt": {
+            "type": "string",
+            "format": "datetime",
+            "description": "Timestamp of the documents publish time."
+          },
+          "textContent": {
+            "type": "string",
+            "description": "Plaintext representation of the documents contents. Should not contain markdown or other formatting."
+          }
+        }
+      },
+      "description": "A document record representing a published article, blog post, or other content. Documents can belong to a publication or exist independently."
+    }
+  },
+  "$type": "com.atproto.lexicon.schema",
+  "lexicon": 1
+}

modules/standard-site-sync.ts

@@ -0,0 +1,32 @@
+import { defineNuxtModule, useNuxt } from 'nuxt/kit'
+import * as site from '../shared/types/lexicons/site'
+
+const PUBLICATION_SITE = 'https://npmx.dev'
+
+export default defineNuxtModule({
+  meta: {
+    name: 'standard-site-sync',
+  },
+  setup() {
+    const nuxt = useNuxt()
+    if (nuxt.options._prepare) {
+      return
+    }
+    nuxt.hook('content:file:afterParse', ctx => {
+      const { content } = ctx
+
+      // Marshal content into site.standard.document using generated $build
+      const document = site.standard.document.$build({
+        site: PUBLICATION_SITE,
+        path: content.path as string,
+        title: content.title as string,
+        description: (content.excerpt || content.description) as string | undefined,
+        tags: content.tags as string[] | undefined,
+        publishedAt: new Date(content.date as string).toISOString(),
+      })
+
+      // Mock PDS push
+      console.log('[standard-site-sync] Would push:', JSON.stringify(document, null, 2))
+    })
+  },
+})

package.json

@@ -19,7 +19,8 @@
     "generate": "nuxt generate",
     "npmx-connector": "pnpm --filter npmx-connector dev",
     "preview": "nuxt preview",
-    "postinstall": "nuxt prepare && simple-git-hooks",
+    "generate:lexicons": "lex build --lexicons lexicons --out shared/types/lexicons --clear",
+    "postinstall": "pnpm generate:lexicons && nuxt prepare && simple-git-hooks",
     "test": "vite test",
     "test:browser": "playwright test",
     "test:browser:ui": "playwright test --ui",