@panproto/core 0.10.0 → 0.11.0

package/dist/index.cjs

@@ -45,6 +45,8 @@ async function loadWasm(input) {
     const exports$1 = {
       define_protocol: glue.define_protocol,
       build_schema: glue.build_schema,
+      parse_atproto_lexicon: glue.parse_atproto_lexicon,
+      schema_metadata: glue.schema_metadata,
       check_existence: glue.check_existence,
       compile_migration: glue.compile_migration,
       lift_record: glue.lift_record,
@@ -2119,6 +2121,61 @@ class Panproto {
     this.#protocols.set(spec.name, proto);
     return proto;
   }
+  /**
+   * Parse an ATProto lexicon JSON document into a schema.
+   *
+   * This is the universal entry point for any ATProto-compatible lexicon —
+   * works for Bluesky, RelationalText, Layers, and any custom lexicon.
+   * The resulting schema can be used with `lens()`, `convert()`, `diff()`,
+   * and all other schema operations.
+   *
+   * @param lexiconJson - The lexicon JSON (object or string)
+   * @returns A built schema that can be used for migration, lens generation, etc.
+   * @throws {@link PanprotoError} if the lexicon is not valid ATProto Lexicon JSON
+   *
+   * @example
+   * ```typescript
+   * const rtSchema = panproto.parseLexicon(rtDocumentLexicon);
+   * const layersSchema = panproto.parseLexicon(layersAnnotationLexicon);
+   * const lens = panproto.lens(rtSchema, layersSchema);
+   * ```
+   */
+  parseLexicon(lexiconJson) {
+    const jsonStr = typeof lexiconJson === "string" ? lexiconJson : JSON.stringify(lexiconJson);
+    const jsonBytes = new TextEncoder().encode(jsonStr);
+    let rawHandle;
+    try {
+      rawHandle = this.#wasm.exports.parse_atproto_lexicon(jsonBytes);
+    } catch (error) {
+      throw new PanprotoError(
+        `Failed to parse lexicon: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    const metaBytes = this.#wasm.exports.schema_metadata(rawHandle);
+    const meta = unpackFromWasm(metaBytes);
+    const data = {
+      protocol: meta.protocol,
+      vertices: Object.fromEntries(
+        meta.vertices.map((v) => [v.id, { id: v.id, kind: v.kind, nsid: v.nsid }])
+      ),
+      edges: meta.edges.map((e) => ({
+        src: e.src,
+        tgt: e.tgt,
+        kind: e.kind,
+        name: e.name
+      })),
+      hyperEdges: {},
+      constraints: {},
+      required: {},
+      variants: {},
+      orderings: {},
+      recursionPoints: {},
+      usageModes: {},
+      spans: {},
+      nominal: {}
+    };
+    return BuiltSchema._fromHandle(rawHandle, data, meta.protocol, this.#wasm);
+  }
   /**
    * Start building a migration between two schemas.
    *