@hatk/hatk 0.0.1-alpha.5 → 0.0.1-alpha.50

package/dist/lexicon-resolve.js

@@ -1,6 +1,8 @@
 // Lexicon resolver — fetches lexicons from the AT Protocol registry via DNS → DID → PDS chain
 // and recursively resolves all $ref dependencies.
 import { isValidDid } from '@bigmoves/lexicon';
+import { join } from 'node:path';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
 // --- Authority ---
 function nsidToDomain(nsid) {
     const parts = nsid.split('.');
@@ -71,118 +73,31 @@ async function resolveDid(did, opts = {}) {
         return null;
     }
 }
-// --- Built-in core schemas (not published via DNS) ---
-const coreSchemas = {
-    'com.atproto.repo.strongRef': {
-        lexicon: 1,
-        id: 'com.atproto.repo.strongRef',
-        description: 'A URI with a content-hash fingerprint.',
-        defs: {
-            main: {
-                type: 'object',
-                required: ['uri', 'cid'],
-                properties: { uri: { type: 'string', format: 'at-uri' }, cid: { type: 'string', format: 'cid' } },
-            },
-        },
-    },
-    'com.atproto.label.defs': {
-        lexicon: 1,
-        id: 'com.atproto.label.defs',
-        defs: {
-            label: {
-                type: 'object',
-                description: 'Metadata tag on an atproto resource (eg, repo or record).',
-                required: ['src', 'uri', 'val', 'cts'],
-                properties: {
-                    ver: { type: 'integer' },
-                    src: { type: 'string', format: 'did' },
-                    uri: { type: 'string', format: 'uri' },
-                    cid: { type: 'string', format: 'cid' },
-                    val: { type: 'string', maxLength: 128 },
-                    neg: { type: 'boolean' },
-                    cts: { type: 'string', format: 'datetime' },
-                    exp: { type: 'string', format: 'datetime' },
-                    sig: { type: 'bytes' },
-                },
-            },
-            selfLabels: {
-                type: 'object',
-                description: 'Metadata tags on an atproto record, published by the author within the record.',
-                required: ['values'],
-                properties: { values: { type: 'array', items: { type: 'ref', ref: '#selfLabel' }, maxLength: 10 } },
-            },
-            selfLabel: { type: 'object', required: ['val'], properties: { val: { type: 'string', maxLength: 128 } } },
-            labelValueDefinition: {
-                type: 'object',
-                description: 'Declares a label value and its expected interpretations and behaviors.',
-                required: ['identifier', 'severity', 'blurs', 'locales'],
-                properties: {
-                    identifier: { type: 'string', maxLength: 100 },
-                    severity: { type: 'string', knownValues: ['inform', 'alert', 'none'] },
-                    blurs: { type: 'string', knownValues: ['content', 'media', 'none'] },
-                    defaultSetting: { type: 'string', knownValues: ['ignore', 'warn', 'hide'] },
-                    adultOnly: { type: 'boolean' },
-                    locales: { type: 'array', items: { type: 'ref', ref: '#labelValueDefinitionStrings' } },
-                },
-            },
-            labelValueDefinitionStrings: {
-                type: 'object',
-                required: ['lang', 'name', 'description'],
-                properties: {
-                    lang: { type: 'string', format: 'language' },
-                    name: { type: 'string', maxLength: 640 },
-                    description: { type: 'string', maxLength: 100000 },
-                },
-            },
-            labelValue: {
-                type: 'string',
-                knownValues: [
-                    '!hide',
-                    '!no-promote',
-                    '!warn',
-                    '!no-unauthenticated',
-                    'dmca-violation',
-                    'doxxing',
-                    'porn',
-                    'sexual',
-                    'nudity',
-                    'nsfl',
-                    'gore',
-                ],
-            },
-        },
-    },
-    'com.atproto.moderation.defs': {
-        lexicon: 1,
-        id: 'com.atproto.moderation.defs',
-        defs: {
-            reasonType: {
-                type: 'string',
-                knownValues: [
-                    'com.atproto.moderation.defs#reasonSpam',
-                    'com.atproto.moderation.defs#reasonViolation',
-                    'com.atproto.moderation.defs#reasonMisleading',
-                    'com.atproto.moderation.defs#reasonSexual',
-                    'com.atproto.moderation.defs#reasonRude',
-                    'com.atproto.moderation.defs#reasonOther',
-                    'com.atproto.moderation.defs#reasonAppeal',
-                ],
-            },
-            reasonSpam: { type: 'token', description: 'Spam: frequent unwanted promotion, replies, mentions.' },
-            reasonViolation: { type: 'token', description: 'Direct violation of server rules, laws, terms of service.' },
-            reasonMisleading: { type: 'token', description: 'Misleading identity, affiliation, or content.' },
-            reasonSexual: { type: 'token', description: 'Unwanted or mislabeled sexual content.' },
-            reasonRude: { type: 'token', description: 'Rude, harassing, explicit, or otherwise unwelcoming behavior.' },
-            reasonOther: { type: 'token', description: 'Reports not falling under another report category.' },
-            reasonAppeal: { type: 'token', description: 'Appeal a previously taken moderation action.' },
-            subjectType: {
-                type: 'string',
-                description: 'Tag describing a type of subject that might be reported.',
-                knownValues: ['account', 'record', 'chat'],
-            },
-        },
-    },
-};
+// --- Built-in core schemas (loaded from src/lexicons/) ---
+function loadCoreSchemas() {
+    const schemas = {};
+    const lexDir = join(import.meta.dirname, 'lexicons');
+    function walk(dir) {
+        for (const entry of readdirSync(dir)) {
+            const full = join(dir, entry);
+            if (statSync(full).isDirectory()) {
+                walk(full);
+            }
+            else if (entry.endsWith('.json')) {
+                const lexicon = JSON.parse(readFileSync(full, 'utf-8'));
+                if (lexicon.id)
+                    schemas[lexicon.id] = lexicon;
+            }
+        }
+    }
+    try {
+        walk(lexDir);
+    }
+    catch { }
+    return schemas;
+}
+const coreSchemas = loadCoreSchemas();
+// --- Resolver ---
 function refToNsid(ref) {
     let nsid = ref.startsWith('lex:') ? ref.slice(4) : ref;
     const hashIndex = nsid.indexOf('#');

package/dist/lexicons/com/atproto/label/defs.json

@@ -0,0 +1,75 @@
+{
+  "lexicon": 1,
+  "id": "com.atproto.label.defs",
+  "defs": {
+    "label": {
+      "type": "object",
+      "description": "Metadata tag on an atproto resource (eg, repo or record).",
+      "required": ["src", "uri", "val", "cts"],
+      "properties": {
+        "ver": { "type": "integer" },
+        "src": { "type": "string", "format": "did" },
+        "uri": { "type": "string", "format": "uri" },
+        "cid": { "type": "string", "format": "cid" },
+        "val": { "type": "string", "maxLength": 128 },
+        "neg": { "type": "boolean" },
+        "cts": { "type": "string", "format": "datetime" },
+        "exp": { "type": "string", "format": "datetime" },
+        "sig": { "type": "bytes" }
+      }
+    },
+    "selfLabels": {
+      "type": "object",
+      "description": "Metadata tags on an atproto record, published by the author within the record.",
+      "required": ["values"],
+      "properties": {
+        "values": { "type": "array", "items": { "type": "ref", "ref": "#selfLabel" }, "maxLength": 10 }
+      }
+    },
+    "selfLabel": {
+      "type": "object",
+      "required": ["val"],
+      "properties": {
+        "val": { "type": "string", "maxLength": 128 }
+      }
+    },
+    "labelValueDefinition": {
+      "type": "object",
+      "description": "Declares a label value and its expected interpretations and behaviors.",
+      "required": ["identifier", "severity", "blurs", "locales"],
+      "properties": {
+        "identifier": { "type": "string", "maxLength": 100 },
+        "severity": { "type": "string", "knownValues": ["inform", "alert", "none"] },
+        "blurs": { "type": "string", "knownValues": ["content", "media", "none"] },
+        "defaultSetting": { "type": "string", "knownValues": ["ignore", "warn", "hide"] },
+        "adultOnly": { "type": "boolean" },
+        "locales": { "type": "array", "items": { "type": "ref", "ref": "#labelValueDefinitionStrings" } }
+      }
+    },
+    "labelValueDefinitionStrings": {
+      "type": "object",
+      "required": ["lang", "name", "description"],
+      "properties": {
+        "lang": { "type": "string", "format": "language" },
+        "name": { "type": "string", "maxLength": 640 },
+        "description": { "type": "string", "maxLength": 100000 }
+      }
+    },
+    "labelValue": {
+      "type": "string",
+      "knownValues": [
+        "!hide",
+        "!no-promote",
+        "!warn",
+        "!no-unauthenticated",
+        "dmca-violation",
+        "doxxing",
+        "porn",
+        "sexual",
+        "nudity",
+        "nsfl",
+        "gore"
+      ]
+    }
+  }
+}

package/dist/lexicons/com/atproto/moderation/defs.json

@@ -0,0 +1,30 @@
+{
+  "lexicon": 1,
+  "id": "com.atproto.moderation.defs",
+  "defs": {
+    "reasonType": {
+      "type": "string",
+      "knownValues": [
+        "com.atproto.moderation.defs#reasonSpam",
+        "com.atproto.moderation.defs#reasonViolation",
+        "com.atproto.moderation.defs#reasonMisleading",
+        "com.atproto.moderation.defs#reasonSexual",
+        "com.atproto.moderation.defs#reasonRude",
+        "com.atproto.moderation.defs#reasonOther",
+        "com.atproto.moderation.defs#reasonAppeal"
+      ]
+    },
+    "reasonSpam": { "type": "token", "description": "Spam: frequent unwanted promotion, replies, mentions." },
+    "reasonViolation": { "type": "token", "description": "Direct violation of server rules, laws, terms of service." },
+    "reasonMisleading": { "type": "token", "description": "Misleading identity, affiliation, or content." },
+    "reasonSexual": { "type": "token", "description": "Unwanted or mislabeled sexual content." },
+    "reasonRude": { "type": "token", "description": "Rude, harassing, explicit, or otherwise unwelcoming behavior." },
+    "reasonOther": { "type": "token", "description": "Reports not falling under another report category." },
+    "reasonAppeal": { "type": "token", "description": "Appeal a previously taken moderation action." },
+    "subjectType": {
+      "type": "string",
+      "description": "Tag describing a type of subject that might be reported.",
+      "knownValues": ["account", "record", "chat"]
+    }
+  }
+}

package/dist/lexicons/com/atproto/repo/strongRef.json

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

package/dist/lexicons/dev/hatk/createRecord.json

@@ -0,0 +1,40 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.createRecord",
+  "defs": {
+    "main": {
+      "type": "procedure",
+      "description": "Create a record via the user's PDS.",
+      "input": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["collection", "repo", "record"],
+          "properties": {
+            "collection": { "type": "string" },
+            "repo": { "type": "string", "format": "did" },
+            "record": { "type": "unknown" }
+          }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "uri": { "type": "string", "format": "at-uri" },
+            "cid": { "type": "string", "format": "cid" },
+            "commit": {
+              "type": "object",
+              "properties": {
+                "cid": { "type": "string", "format": "cid" },
+                "rev": { "type": "string" }
+              }
+            },
+            "validationStatus": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/createReport.json

@@ -0,0 +1,48 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.createReport",
+  "defs": {
+    "main": {
+      "type": "procedure",
+      "description": "Report an account or record for moderation review.",
+      "input": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["subject", "label"],
+          "properties": {
+            "subject": {
+              "type": "union",
+              "description": "The account or record being reported.",
+              "refs": ["#repoRef", "com.atproto.repo.strongRef"]
+            },
+            "label": { "type": "string", "description": "Label identifier for the report reason." },
+            "reason": { "type": "string", "maxLength": 2000, "description": "Optional free-text explanation." }
+          }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["id", "subject", "label", "reportedBy", "createdAt"],
+          "properties": {
+            "id": { "type": "integer" },
+            "subject": { "type": "unknown" },
+            "label": { "type": "string" },
+            "reason": { "type": "string" },
+            "reportedBy": { "type": "string", "format": "did" },
+            "createdAt": { "type": "string", "format": "datetime" }
+          }
+        }
+      }
+    },
+    "repoRef": {
+      "type": "object",
+      "required": ["did"],
+      "properties": {
+        "did": { "type": "string", "format": "did" }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/deleteRecord.json

@@ -0,0 +1,25 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.deleteRecord",
+  "defs": {
+    "main": {
+      "type": "procedure",
+      "description": "Delete a record via the user's PDS.",
+      "input": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["collection", "rkey"],
+          "properties": {
+            "collection": { "type": "string" },
+            "rkey": { "type": "string" }
+          }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": { "type": "object", "properties": {} }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/describeCollections.json

@@ -0,0 +1,41 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.describeCollections",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "List indexed collections and their schemas.",
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "collections": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["collection"],
+                "properties": {
+                  "collection": { "type": "string" },
+                  "columns": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "required": ["name", "originalName", "type", "required"],
+                      "properties": {
+                        "name": { "type": "string" },
+                        "originalName": { "type": "string" },
+                        "type": { "type": "string" },
+                        "required": { "type": "boolean" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/describeFeeds.json

@@ -0,0 +1,29 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.describeFeeds",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "List available feeds.",
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "feeds": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["name", "label"],
+                "properties": {
+                  "name": { "type": "string" },
+                  "label": { "type": "string" }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/describeLabels.json

@@ -0,0 +1,45 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.describeLabels",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "List available label definitions.",
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "definitions": {
+              "type": "array",
+              "items": { "type": "ref", "ref": "#labelDefinition" }
+            }
+          }
+        }
+      }
+    },
+    "labelDefinition": {
+      "type": "object",
+      "required": ["identifier", "severity", "blurs", "defaultSetting"],
+      "properties": {
+        "identifier": { "type": "string" },
+        "severity": { "type": "string" },
+        "blurs": { "type": "string" },
+        "defaultSetting": { "type": "string" },
+        "locales": {
+          "type": "array",
+          "items": { "type": "ref", "ref": "#labelLocale" }
+        }
+      }
+    },
+    "labelLocale": {
+      "type": "object",
+      "required": ["lang", "name", "description"],
+      "properties": {
+        "lang": { "type": "string" },
+        "name": { "type": "string" },
+        "description": { "type": "string" }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/getFeed.json

@@ -0,0 +1,30 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.getFeed",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "Retrieve a named feed of items.",
+      "parameters": {
+        "type": "params",
+        "required": ["feed"],
+        "properties": {
+          "feed": { "type": "string", "description": "Feed name" },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 },
+          "cursor": { "type": "string" }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["items"],
+          "properties": {
+            "items": { "type": "array", "items": { "type": "unknown" } },
+            "cursor": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/getPreferences.json

@@ -0,0 +1,19 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.getPreferences",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "Get all preferences for the authenticated user.",
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "preferences": { "type": "unknown" }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/getRecord.json

@@ -0,0 +1,26 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.getRecord",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "Fetch a single record by AT URI.",
+      "parameters": {
+        "type": "params",
+        "required": ["uri"],
+        "properties": {
+          "uri": { "type": "string", "format": "at-uri" }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "record": { "type": "unknown" }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/getRecords.json

@@ -0,0 +1,32 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.getRecords",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "List records from a collection with optional filters.",
+      "parameters": {
+        "type": "params",
+        "required": ["collection"],
+        "properties": {
+          "collection": { "type": "string" },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 },
+          "cursor": { "type": "string" },
+          "sort": { "type": "string" },
+          "order": { "type": "string" }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["items"],
+          "properties": {
+            "items": { "type": "array", "items": { "type": "unknown" } },
+            "cursor": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/lexicons/dev/hatk/putPreference.json

@@ -0,0 +1,28 @@
+{
+  "lexicon": 1,
+  "id": "dev.hatk.putPreference",
+  "defs": {
+    "main": {
+      "type": "procedure",
+      "description": "Set a single preference by key.",
+      "input": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["key", "value"],
+          "properties": {
+            "key": { "type": "string" },
+            "value": { "type": "unknown" }
+          }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {}
+        }
+      }
+    }
+  }
+}