@lucern/graph-primitives 1.0.29 → 1.0.30

package/dist/ontologyDefinitions.js

@@ -1,9 +1,13 @@
-import { v } from 'convex/values';
 import { getCurrentUserId } from '@lucern/access-control/auth';
 import { permissiveReturn } from '@lucern/contracts/schema-helpers/validators';
+import { v } from 'convex/values';
+import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
 import { componentsGeneric, queryGeneric, mutationGeneric } from 'convex/server';
 
 // src/ontologyDefinitions.ts
+unsafeConvexAnyApi(
+  "graph-primitives top-level module bundle lacks a committed Convex _generated/api surface"
+);
 componentsGeneric();
 var mutation = mutationGeneric;
 var query = queryGeneric;
@@ -69,6 +73,211 @@ async function requireAuth(ctx) {
   }
   return userId;
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function rowFieldError(context, fieldName) {
+  return new Error(`${context} has invalid or missing ${fieldName}.`);
+}
+function readRequiredString(row, fieldName, context) {
+  const value = row[fieldName];
+  if (typeof value !== "string") {
+    throw rowFieldError(context, fieldName);
+  }
+  return value;
+}
+function readOptionalString(row, fieldName, context) {
+  const value = row[fieldName];
+  if (value === void 0) {
+    return;
+  }
+  if (typeof value !== "string") {
+    throw rowFieldError(context, fieldName);
+  }
+  return value;
+}
+function readRequiredNumber(row, fieldName, context) {
+  const value = row[fieldName];
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw rowFieldError(context, fieldName);
+  }
+  return value;
+}
+function readOptionalNumber(row, fieldName, context) {
+  const value = row[fieldName];
+  if (value === void 0) {
+    return;
+  }
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw rowFieldError(context, fieldName);
+  }
+  return value;
+}
+function readRequiredId(row, fieldName, context) {
+  return readRequiredString(row, fieldName, context);
+}
+function readOptionalId(row, fieldName, context) {
+  const value = readOptionalString(row, fieldName, context);
+  return value;
+}
+function readStringArray(value, context) {
+  if (value === void 0) {
+    return;
+  }
+  if (!(Array.isArray(value) && value.every((item) => typeof item === "string"))) {
+    throw new Error(`${context} must be an array of strings.`);
+  }
+  return value;
+}
+function readEntitySubtype(value, context) {
+  if (!isRecord(value)) {
+    throw new Error(`${context} must be an object.`);
+  }
+  const description = readOptionalString(value, "description", context);
+  return {
+    ...description === void 0 ? {} : { description },
+    label: readRequiredString(value, "label", context),
+    value: readRequiredString(value, "value", context)
+  };
+}
+function readEntityTypeEntry(value, context) {
+  if (!isRecord(value)) {
+    throw new Error(`${context} must be an object.`);
+  }
+  const description = readOptionalString(value, "description", context);
+  const subtypesValue = value.subtypes;
+  let subtypes;
+  if (subtypesValue !== void 0) {
+    if (!Array.isArray(subtypesValue)) {
+      throw rowFieldError(context, "subtypes");
+    }
+    subtypes = subtypesValue.map(
+      (subtype, index) => readEntitySubtype(subtype, `${context}.subtypes[${index}]`)
+    );
+  }
+  return {
+    ...description === void 0 ? {} : { description },
+    ...value.schema === void 0 ? {} : { schema: value.schema },
+    ...subtypes === void 0 ? {} : { subtypes },
+    label: readRequiredString(value, "label", context),
+    value: readRequiredString(value, "value", context)
+  };
+}
+function readEntityTypeEntries(value, context) {
+  if (!Array.isArray(value)) {
+    throw rowFieldError(context, "entityTypes");
+  }
+  return value.map(
+    (entry, index) => readEntityTypeEntry(entry, `${context}.entityTypes[${index}]`)
+  );
+}
+function readEdgeTypeEntry(value, context) {
+  if (!isRecord(value)) {
+    throw new Error(`${context} must be an object.`);
+  }
+  const constraintSeverity = readOptionalString(
+    value,
+    "constraintSeverity",
+    context
+  );
+  if (constraintSeverity !== void 0 && constraintSeverity !== "warn" && constraintSeverity !== "info") {
+    throw rowFieldError(context, "constraintSeverity");
+  }
+  const description = readOptionalString(value, "description", context);
+  const sourceTypes = readStringArray(
+    value.sourceTypes,
+    `${context}.sourceTypes`
+  );
+  const targetTypes = readStringArray(
+    value.targetTypes,
+    `${context}.targetTypes`
+  );
+  return {
+    ...constraintSeverity === void 0 ? {} : { constraintSeverity },
+    ...description === void 0 ? {} : { description },
+    ...sourceTypes === void 0 ? {} : { sourceTypes },
+    ...targetTypes === void 0 ? {} : { targetTypes },
+    label: readRequiredString(value, "label", context),
+    value: readRequiredString(value, "value", context)
+  };
+}
+function readEdgeTypeEntries(value, context) {
+  if (!Array.isArray(value)) {
+    throw rowFieldError(context, "edgeTypes");
+  }
+  return value.map(
+    (entry, index) => readEdgeTypeEntry(entry, `${context}.edgeTypes[${index}]`)
+  );
+}
+function readOntologyDefinitionStatus(value, context) {
+  if (value !== "draft" && value !== "active" && value !== "deprecated" && value !== "archived") {
+    throw rowFieldError(context, "status");
+  }
+  return value;
+}
+function readOntologyDefinitionDoc(value, context = "ontology definition row") {
+  if (value === null) {
+    return null;
+  }
+  if (!isRecord(value)) {
+    throw new Error(`${context} must be an object.`);
+  }
+  return {
+    _id: readRequiredId(value, "_id", context),
+    createdAt: readRequiredNumber(value, "createdAt", context),
+    createdBy: readRequiredString(value, "createdBy", context),
+    description: readOptionalString(value, "description", context),
+    name: readRequiredString(value, "name", context),
+    ontologyKey: readRequiredString(value, "ontologyKey", context),
+    parentOntologyId: readOptionalId(value, "parentOntologyId", context),
+    status: readOntologyDefinitionStatus(value.status, context),
+    tenantId: readOptionalString(value, "tenantId", context),
+    tier: readOntologyTier(value.tier, context),
+    updatedAt: readRequiredNumber(value, "updatedAt", context)
+  };
+}
+function readOntologyTier(value, context) {
+  if (value !== "platform" && value !== "pack" && value !== "tenant") {
+    throw rowFieldError(context, "tier");
+  }
+  return value;
+}
+function readOntologyVersionStatus(value, context) {
+  if (value !== "draft" && value !== "published" && value !== "deprecated") {
+    throw rowFieldError(context, "status");
+  }
+  return value;
+}
+function readOntologyVersionDoc(value, context = "ontology version row") {
+  if (value === null) {
+    return null;
+  }
+  if (!isRecord(value)) {
+    throw new Error(`${context} must be an object.`);
+  }
+  return {
+    _id: readRequiredId(value, "_id", context),
+    createdAt: readRequiredNumber(value, "createdAt", context),
+    edgeTypes: readEdgeTypeEntries(value.edgeTypes, context),
+    entityTypes: readEntityTypeEntries(value.entityTypes, context),
+    ontologyId: readRequiredId(value, "ontologyId", context),
+    ontologyKey: readRequiredString(value, "ontologyKey", context),
+    publishedAt: readOptionalNumber(value, "publishedAt", context),
+    publishedBy: readOptionalString(value, "publishedBy", context),
+    releaseNotes: readOptionalString(value, "releaseNotes", context),
+    status: readOntologyVersionStatus(value.status, context),
+    version: readRequiredString(value, "version", context)
+  };
+}
+function readOntologyVersionDocs(values, context) {
+  return values.map((value, index) => {
+    const doc = readOntologyVersionDoc(value, `${context}[${index}]`);
+    if (!doc) {
+      throw new Error(`${context}[${index}] is unexpectedly null.`);
+    }
+    return doc;
+  });
+}
 async function logAudit(ctx, args) {
   await ctx.db.insert("epistemicAudit", {
     entityType: args.entityType,
@@ -84,9 +293,7 @@ async function logAudit(ctx, args) {
 var getOntologyDefinition = query({
   args: { id: v.id("ontologyDefinitions") },
   returns: permissiveReturn,
-  handler: async (ctx, args) => {
-    return await ctx.db.get(args.id);
-  }
+  handler: async (ctx, args) => await ctx.db.get(args.id)
 });
 var getOntologyDefinitionByKey = query({
   args: {
@@ -151,12 +358,10 @@ var getOntologyVersion = query({
     version: v.string()
   },
   returns: permissiveReturn,
-  handler: async (ctx, args) => {
-    return await ctx.db.query("ontologyVersions").withIndex(
-      "by_ontologyKey_version",
-      (q) => q.eq("ontologyKey", args.ontologyKey).eq("version", args.version)
-    ).first();
-  }
+  handler: async (ctx, args) => await ctx.db.query("ontologyVersions").withIndex(
+    "by_ontologyKey_version",
+    (q) => q.eq("ontologyKey", args.ontologyKey).eq("version", args.version)
+  ).first()
 });
 var listOntologyVersions = query({
   args: {
@@ -171,10 +376,13 @@ var listOntologyVersions = query({
   },
   returns: permissiveReturn,
   handler: async (ctx, args) => {
-    const all = await ctx.db.query("ontologyVersions").withIndex(
-      "by_ontologyId",
-      (q) => q.eq("ontologyId", args.ontologyId)
-    ).collect();
+    const all = readOntologyVersionDocs(
+      await ctx.db.query("ontologyVersions").withIndex(
+        "by_ontologyId",
+        (q) => q.eq("ontologyId", args.ontologyId)
+      ).collect(),
+      "listOntologyVersions.ontologyVersions"
+    );
     if (args.status) {
       return all.filter(
         (versionDoc) => versionDoc.status === args.status
@@ -187,10 +395,13 @@ var getPublishedVersion = query({
   args: { ontologyId: v.id("ontologyDefinitions") },
   returns: permissiveReturn,
   handler: async (ctx, args) => {
-    const published = await ctx.db.query("ontologyVersions").withIndex(
-      "by_ontologyId",
-      (q) => q.eq("ontologyId", args.ontologyId)
-    ).collect();
+    const published = readOntologyVersionDocs(
+      await ctx.db.query("ontologyVersions").withIndex(
+        "by_ontologyId",
+        (q) => q.eq("ontologyId", args.ontologyId)
+      ).collect(),
+      "getPublishedVersion.ontologyVersions"
+    );
     const publishedOnly = published.filter(
       (versionDoc) => versionDoc.status === "published"
     );
@@ -212,23 +423,28 @@ var resolveEffectiveOntology = query({
     let currentId = args.ontologyId;
     for (let depth = 0; depth < MAX_DEPTH && currentId; depth++) {
       const ontologyId = currentId;
-      const def = await ctx.db.get(ontologyId);
+      const def = readOntologyDefinitionDoc(
+        await ctx.db.get(ontologyId),
+        "resolveEffectiveOntology.definition"
+      );
       if (!def) {
         break;
       }
-      const defTyped = def;
-      const versions = await ctx.db.query("ontologyVersions").withIndex(
-        "by_ontologyId",
-        (q) => q.eq("ontologyId", ontologyId)
-      ).collect();
+      const versions = readOntologyVersionDocs(
+        await ctx.db.query("ontologyVersions").withIndex(
+          "by_ontologyId",
+          (q) => q.eq("ontologyId", ontologyId)
+        ).collect(),
+        "resolveEffectiveOntology.ontologyVersions"
+      );
       const published = versions.filter((ver) => ver.status === "published").sort(
         (a, b) => (b.publishedAt ?? 0) - (a.publishedAt ?? 0)
       );
       chain.unshift({
-        def: defTyped,
+        def,
         version: published[0] ?? null
       });
-      currentId = defTyped.parentOntologyId;
+      currentId = def.parentOntologyId;
     }
     if (chain.length === 0) {
       return null;
@@ -332,7 +548,10 @@ var updateOntologyDefinition = mutation({
   returns: permissiveReturn,
   handler: async (ctx, args) => {
     const userId = await requireAuth(ctx);
-    const def = await ctx.db.get(args.id);
+    const def = readOntologyDefinitionDoc(
+      await ctx.db.get(args.id),
+      "updateOntologyDefinition.definition"
+    );
     if (!def) {
       throw new Error("Ontology definition not found.");
     }
@@ -371,7 +590,10 @@ var archiveOntologyDefinition = mutation({
   returns: permissiveReturn,
   handler: async (ctx, args) => {
     const userId = await requireAuth(ctx);
-    const def = await ctx.db.get(args.id);
+    const def = readOntologyDefinitionDoc(
+      await ctx.db.get(args.id),
+      "archiveOntologyDefinition.definition"
+    );
     if (!def) {
       throw new Error("Ontology definition not found.");
     }
@@ -433,8 +655,9 @@ var createOntologyVersion = mutation({
         `Invalid version string "${args.version}". Must be in X.Y.Z format.`
       );
     }
-    const def = await ctx.db.get(
-      args.ontologyId
+    const def = readOntologyDefinitionDoc(
+      await ctx.db.get(args.ontologyId),
+      "createOntologyVersion.definition"
     );
     if (!def) {
       throw new Error("Ontology definition not found.");
@@ -519,7 +742,10 @@ var updateDraftVersion = mutation({
   returns: permissiveReturn,
   handler: async (ctx, args) => {
     const userId = await requireAuth(ctx);
-    const ver = await ctx.db.get(args.id);
+    const ver = readOntologyVersionDoc(
+      await ctx.db.get(args.id),
+      "updateDraftVersion.version"
+    );
     if (!ver) {
       throw new Error("Ontology version not found.");
     }
@@ -558,7 +784,10 @@ var publishOntologyVersion = mutation({
   returns: permissiveReturn,
   handler: async (ctx, args) => {
     const userId = await requireAuth(ctx);
-    const ver = await ctx.db.get(args.id);
+    const ver = readOntologyVersionDoc(
+      await ctx.db.get(args.id),
+      "publishOntologyVersion.version"
+    );
     if (!ver) {
       throw new Error("Ontology version not found.");
     }
@@ -578,7 +807,10 @@ var publishOntologyVersion = mutation({
       publishedBy: userId,
       publishedAt: now
     });
-    const def = await ctx.db.get(ver.ontologyId);
+    const def = readOntologyDefinitionDoc(
+      await ctx.db.get(ver.ontologyId),
+      "publishOntologyVersion.definition"
+    );
     if (def && def.status === "draft") {
       await ctx.db.patch(ver.ontologyId, {
         status: "active",
@@ -604,7 +836,10 @@ var deprecateOntologyVersion = mutation({
   returns: permissiveReturn,
   handler: async (ctx, args) => {
     const userId = await requireAuth(ctx);
-    const ver = await ctx.db.get(args.id);
+    const ver = readOntologyVersionDoc(
+      await ctx.db.get(args.id),
+      "deprecateOntologyVersion.version"
+    );
     if (!ver) {
       throw new Error("Ontology version not found.");
     }