@lucern/graph-primitives 1.0.28 → 1.0.30

package/dist/{entityValidation-KLZ_Xl2D.d.ts → entityValidation-B1yNEHJx.d.ts}

@@ -9,15 +9,16 @@ import { QueryCtx, MutationCtx } from './convex.js';
  * @module graph-primitives/entityValidation
  */
 
-type FieldSchema = {
-    type: "string" | "number" | "boolean";
+type EntitySchemaConfigFieldType = "string" | "number" | "boolean";
+interface FieldSchema {
     required: boolean;
-};
+    type: EntitySchemaConfigFieldType;
+}
 type EntitySchema = Record<string, FieldSchema>;
-type ValidationResult = {
-    valid: boolean;
+interface ValidationResult {
     errors: string[];
-};
+    valid: boolean;
+}
 /**
  * Fetch the registered metadata schema for an entity type.
  * Returns null if no schema is registered.

package/dist/entityValidation.d.ts

@@ -1,3 +1,5 @@
 import './convex.js';
-export { g as getEntityTypeSchema, i as isRegisteredEntityType, v as validateEntityMetadata } from './entityValidation-KLZ_Xl2D.js';
+export { g as getEntityTypeSchema, i as isRegisteredEntityType, v as validateEntityMetadata } from './entityValidation-B1yNEHJx.js';
+import '@lucern/access-control/convex';
+import '@lucern/contracts/convex/unsafeAnyApi';
 import 'convex/values';

package/dist/entityValidation.js

@@ -1,23 +1,75 @@
 // src/entityValidation.ts
+function isObjectLike(value) {
+  return value !== null && typeof value === "object";
+}
+function isEntitySchemaConfigField(value) {
+  if (!isObjectLike(value)) {
+    return false;
+  }
+  const required = value.required;
+  const type = value.type;
+  return typeof required === "boolean" && (type === "string" || type === "number" || type === "boolean");
+}
+function readEntitySchema(value) {
+  if (!isObjectLike(value)) {
+    return {};
+  }
+  const schema = {};
+  for (const [fieldName, fieldValue] of Object.entries(value)) {
+    if (!isEntitySchemaConfigField(fieldValue)) {
+      continue;
+    }
+    schema[fieldName] = fieldValue;
+  }
+  return schema;
+}
+function readSchemaEnumConfigRow(row) {
+  if (!isObjectLike(row)) {
+    return null;
+  }
+  const value = row.value;
+  if (typeof value !== "string") {
+    return null;
+  }
+  return {
+    value,
+    status: typeof row.status === "string" ? row.status : void 0,
+    metadata: isObjectLike(row.metadata) ? row.metadata : void 0
+  };
+}
+function readEntitySchemaFromConfig(row) {
+  const parsed = readSchemaEnumConfigRow(row);
+  if (parsed?.status !== "active" || !parsed?.metadata) {
+    return null;
+  }
+  const schema = parsed.metadata.schema;
+  if (!schema) {
+    return null;
+  }
+  return readEntitySchema(schema);
+}
 async function getEntityTypeSchema(ctx, nodeType, tenantId) {
   if (tenantId) {
-    const tenantEntry = await ctx.db.query("schemaEnumConfig").withIndex(
+    const tenantEntries = await ctx.db.query("schemaEnumConfig").withIndex(
       "by_tenant_category",
       (q) => q.eq("tenantId", tenantId).eq("category", "entity_type")
     ).collect();
-    const tenantMatch = tenantEntry.find(
-      (e) => e.value === nodeType && e.status === "active"
-    );
-    if (tenantMatch?.metadata?.schema) {
-      return tenantMatch.metadata.schema;
+    const tenantMatch = tenantEntries.find((entry) => {
+      const parsed = readSchemaEnumConfigRow(entry);
+      return parsed !== null && parsed.value === nodeType && parsed.status === "active";
+    });
+    const tenantSchema = readEntitySchemaFromConfig(tenantMatch);
+    if (tenantSchema !== null) {
+      return tenantSchema;
     }
   }
   const platformEntry = await ctx.db.query("schemaEnumConfig").withIndex(
     "by_category_value",
     (q) => q.eq("category", "entity_type").eq("value", nodeType)
   ).first();
-  if (platformEntry?.metadata?.schema && platformEntry.status === "active") {
-    return platformEntry.metadata.schema;
+  const platformSchema = readEntitySchemaFromConfig(platformEntry);
+  if (platformSchema !== null) {
+    return platformSchema;
   }
   return null;
 }

package/dist/entityValidation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/entityValidation.ts"],"names":[],"mappings":";AAmCA,eAAsB,mBAAA,CACpB,GAAA,EACA,QAAA,EACA,QAAA,EAC8B;AAE9B,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,MAAM,cAAc,MAAO,GAAA,CAAI,EAAA,CAC5B,KAAA,CAAM,kBAAkB,CAAA,CACxB,SAAA;AAAA,MAAU,oBAAA;AAAA,MAAsB,CAAC,MAChC,CAAA,CAAE,EAAA,CAAG,YAAY,QAAQ,CAAA,CAAE,EAAA,CAAG,UAAA,EAAY,aAAa;AAAA,MAExD,OAAA,EAAQ;AAEX,IAAA,MAAM,cAAc,WAAA,CAAY,IAAA;AAAA,MAC9B,CAAC,CAAA,KAAW,CAAA,CAAE,KAAA,KAAU,QAAA,IAAY,EAAE,MAAA,KAAW;AAAA,KACnD;AACA,IAAA,IAAI,WAAA,EAAa,UAAU,MAAA,EAAQ;AACjC,MAAA,OAAO,YAAY,QAAA,CAAS,MAAA;AAAA,IAC9B;AAAA,EACF;AAGA,EAAA,MAAM,gBAAgB,MAAO,GAAA,CAAI,EAAA,CAC9B,KAAA,CAAM,kBAAkB,CAAA,CACxB,SAAA;AAAA,IAAU,mBAAA;AAAA,IAAqB,CAAC,MAC/B,CAAA,CAAE,EAAA,CAAG,YAAY,aAAa,CAAA,CAAE,EAAA,CAAG,OAAA,EAAS,QAAQ;AAAA,IAErD,KAAA,EAAM;AAET,EAAA,IAAI,aAAA,EAAe,QAAA,EAAU,MAAA,IAAU,aAAA,CAAc,WAAW,QAAA,EAAU;AACxE,IAAA,OAAO,cAAc,QAAA,CAAS,MAAA;AAAA,EAChC;AAEA,EAAA,OAAO,IAAA;AACT;AAiBA,eAAsB,sBAAA,CACpB,GAAA,EACA,QAAA,EACA,QAAA,EACA,QAAA,EAC2B;AAC3B,EAAA,MAAM,SAAmB,EAAC;AAE1B,EAAA,MAAM,MAAA,GAAS,MAAM,mBAAA,CAAoB,GAAA,EAAK,UAAU,QAAQ,CAAA;AAEhE,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,KAAA;AAAA,MACP,MAAA,EAAQ;AAAA,QACN,yCAAyC,QAAQ,CAAA,kGAAA;AAAA;AACnD,KACF;AAAA,EACF;AAEA,EAAA,MAAM,IAAA,GAAO,YAAY,EAAC;AAG1B,EAAA,KAAA,MAAW,CAAC,SAAA,EAAW,QAAQ,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC1D,IAAA,IAAI,SAAS,QAAA,EAAU;AACrB,MAAA,MAAM,KAAA,GAAQ,KAAK,SAAS,CAAA;AAC5B,MAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,IAAQ,UAAU,EAAA,EAAI;AACzD,QAAA,MAAA,CAAO,IAAA,CAAK,CAAA,gBAAA,EAAmB,SAAS,CAAA,qBAAA,CAAuB,CAAA;AAAA,MACjE;AAAA,IACF;AAAA,EACF;AAGA,EAAA,KAAA,MAAW,CAAC,SAAA,EAAW,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,EAAG;AACrD,IAAA,MAAM,QAAA,GAAW,OAAO,SAAS,CAAA;AACjC,IAAA,IAAI,CAAC,QAAA,EAAU;AAEb,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AAEzC,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,aAAa,OAAO,KAAA;AAC1B,IAAA,IAAI,UAAA,KAAe,SAAS,IAAA,EAAM;AAChC,MAAA,MAAA,CAAO,IAAA;AAAA,QACL,UAAU,SAAS,CAAA,iBAAA,EAAoB,QAAA,CAAS,IAAI,cAAc,UAAU,CAAA,CAAA;AAAA,OAC9E;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,OAAO,MAAA,KAAW,CAAA;AAAA,IACzB;AAAA,GACF;AACF;AAKA,eAAsB,sBAAA,CACpB,GAAA,EACA,QAAA,EACA,QAAA,EACkB;AAClB,EAAA,MAAM,MAAA,GAAS,MAAM,mBAAA,CAAoB,GAAA,EAAK,UAAU,QAAQ,CAAA;AAChE,EAAA,OAAO,MAAA,KAAW,IAAA;AACpB","file":"entityValidation.js","sourcesContent":["/**\n * Entity Metadata Validation\n *\n * Validates entity metadata against registered schemas in schemaEnumConfig.\n * Strict on create (must pass), lenient on read (existing data tolerance).\n *\n * @module graph-primitives/entityValidation\n */\n\nimport type { MutationCtx, QueryCtx } from \"./convex\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\ntype FieldSchema = {\n  type: \"string\" | \"number\" | \"boolean\";\n  required: boolean;\n};\n\ntype EntitySchema = Record<string, FieldSchema>;\n\ntype ValidationResult = {\n  valid: boolean;\n  errors: string[];\n};\n\n// =============================================================================\n// SCHEMA LOOKUP\n// =============================================================================\n\n/**\n * Fetch the registered metadata schema for an entity type.\n * Returns null if no schema is registered.\n */\nexport async function getEntityTypeSchema(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  tenantId?: string\n): Promise<EntitySchema | null> {\n  // Try tenant-specific first, then platform default\n  if (tenantId) {\n    const tenantEntry = await (ctx.db as any)\n      .query(\"schemaEnumConfig\")\n      .withIndex(\"by_tenant_category\", (q: any) =>\n        q.eq(\"tenantId\", tenantId).eq(\"category\", \"entity_type\")\n      )\n      .collect();\n\n    const tenantMatch = tenantEntry.find(\n      (e: any) => e.value === nodeType && e.status === \"active\"\n    );\n    if (tenantMatch?.metadata?.schema) {\n      return tenantMatch.metadata.schema as EntitySchema;\n    }\n  }\n\n  // Fall back to platform default\n  const platformEntry = await (ctx.db as any)\n    .query(\"schemaEnumConfig\")\n    .withIndex(\"by_category_value\", (q: any) =>\n      q.eq(\"category\", \"entity_type\").eq(\"value\", nodeType)\n    )\n    .first();\n\n  if (platformEntry?.metadata?.schema && platformEntry.status === \"active\") {\n    return platformEntry.metadata.schema as EntitySchema;\n  }\n\n  return null;\n}\n\n// =============================================================================\n// VALIDATION\n// =============================================================================\n\n/**\n * Validate entity metadata against the registered schema.\n *\n * Policy: strict on create (unregistered types fail), lenient on read.\n *\n * @param ctx - Convex query/mutation context\n * @param nodeType - The entity nodeType (e.g., \"company\", \"person\")\n * @param metadata - The metadata object to validate\n * @param tenantId - Optional tenant ID for tenant-specific schemas\n * @returns ValidationResult with errors if invalid\n */\nexport async function validateEntityMetadata(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  metadata: Record<string, unknown> | undefined | null,\n  tenantId?: string\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n\n  const schema = await getEntityTypeSchema(ctx, nodeType, tenantId);\n\n  if (!schema) {\n    return {\n      valid: false,\n      errors: [\n        `No registered schema for entity type \"${nodeType}\". Register it in schemaEnumConfig (category=\"entity_type\") before creating entities of this type.`,\n      ],\n    };\n  }\n\n  const meta = metadata || {};\n\n  // Check required fields\n  for (const [fieldName, fieldDef] of Object.entries(schema)) {\n    if (fieldDef.required) {\n      const value = meta[fieldName];\n      if (value === undefined || value === null || value === \"\") {\n        errors.push(`Required field \"${fieldName}\" is missing or empty`);\n      }\n    }\n  }\n\n  // Check field types for provided fields\n  for (const [fieldName, value] of Object.entries(meta)) {\n    const fieldDef = schema[fieldName];\n    if (!fieldDef) {\n      // Extra fields are allowed (loose metadata tolerance)\n      continue;\n    }\n\n    if (value === undefined || value === null) {\n      // null/undefined are allowed for optional fields (already caught above for required)\n      continue;\n    }\n\n    const actualType = typeof value;\n    if (actualType !== fieldDef.type) {\n      errors.push(\n        `Field \"${fieldName}\" expected type \"${fieldDef.type}\" but got \"${actualType}\"`\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Check if a nodeType is a registered entity type (platform or tenant).\n */\nexport async function isRegisteredEntityType(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  tenantId?: string\n): Promise<boolean> {\n  const schema = await getEntityTypeSchema(ctx, nodeType, tenantId);\n  return schema !== null;\n}\n"]}
+{"version":3,"sources":["../src/entityValidation.ts"],"names":[],"mappings":"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","file":"entityValidation.js","sourcesContent":["// biome-ignore-all lint/style/useFilenamingConvention: Public ABI surface; rename requires a cross-package migration update.\n/**\n * Entity Metadata Validation\n *\n * Validates entity metadata against registered schemas in schemaEnumConfig.\n * Strict on create (must pass), lenient on read (existing data tolerance).\n *\n * @module graph-primitives/entityValidation\n */\n\nimport type { MutationCtx, QueryCtx } from \"./convex\";\n\ninterface UnknownRecord {\n  [key: string]: unknown;\n}\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\ntype EntitySchemaConfigFieldType = \"string\" | \"number\" | \"boolean\";\n\ninterface EntitySchemaConfigEntry {\n  required: boolean;\n  type: EntitySchemaConfigFieldType;\n}\n\ninterface FieldSchema {\n  required: boolean;\n  type: EntitySchemaConfigFieldType;\n}\n\ntype EntitySchema = Record<string, FieldSchema>;\n\ninterface SchemaEnumConfigRow {\n  metadata?: UnknownRecord;\n  status?: string;\n  value?: string;\n}\n\nfunction isObjectLike(value: unknown): value is UnknownRecord {\n  return value !== null && typeof value === \"object\";\n}\n\nfunction isEntitySchemaConfigField(\n  value: unknown\n): value is EntitySchemaConfigEntry {\n  if (!isObjectLike(value)) {\n    return false;\n  }\n  const required = value.required;\n  const type = value.type;\n  return (\n    typeof required === \"boolean\" &&\n    (type === \"string\" || type === \"number\" || type === \"boolean\")\n  );\n}\n\nfunction readEntitySchema(value: unknown): EntitySchema {\n  if (!isObjectLike(value)) {\n    return {};\n  }\n  const schema: EntitySchema = {};\n  for (const [fieldName, fieldValue] of Object.entries(value)) {\n    if (!isEntitySchemaConfigField(fieldValue)) {\n      continue;\n    }\n    schema[fieldName] = fieldValue;\n  }\n  return schema;\n}\n\nfunction readSchemaEnumConfigRow(row: unknown): SchemaEnumConfigRow | null {\n  if (!isObjectLike(row)) {\n    return null;\n  }\n\n  const value = row.value;\n  if (typeof value !== \"string\") {\n    return null;\n  }\n\n  return {\n    value,\n    status: typeof row.status === \"string\" ? row.status : undefined,\n    metadata: isObjectLike(row.metadata) ? row.metadata : undefined,\n  };\n}\n\nfunction readEntitySchemaFromConfig(row: unknown): EntitySchema | null {\n  const parsed = readSchemaEnumConfigRow(row);\n  if (parsed?.status !== \"active\" || !parsed?.metadata) {\n    return null;\n  }\n\n  const schema = parsed.metadata.schema;\n  if (!schema) {\n    return null;\n  }\n\n  return readEntitySchema(schema);\n}\n\ninterface ValidationResult {\n  errors: string[];\n  valid: boolean;\n}\n\n// =============================================================================\n// SCHEMA LOOKUP\n// =============================================================================\n\n/**\n * Fetch the registered metadata schema for an entity type.\n * Returns null if no schema is registered.\n */\nexport async function getEntityTypeSchema(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  tenantId?: string\n): Promise<EntitySchema | null> {\n  // Try tenant-specific first, then platform default\n  if (tenantId) {\n    const tenantEntries = await ctx.db\n      .query(\"schemaEnumConfig\")\n      .withIndex(\"by_tenant_category\", (q) =>\n        q.eq(\"tenantId\", tenantId).eq(\"category\", \"entity_type\")\n      )\n      .collect();\n\n    const tenantMatch = tenantEntries.find((entry) => {\n      const parsed = readSchemaEnumConfigRow(entry);\n      return (\n        parsed !== null &&\n        parsed.value === nodeType &&\n        parsed.status === \"active\"\n      );\n    });\n    const tenantSchema = readEntitySchemaFromConfig(tenantMatch);\n    if (tenantSchema !== null) {\n      return tenantSchema;\n    }\n  }\n\n  // Fall back to platform default\n  const platformEntry = await ctx.db\n    .query(\"schemaEnumConfig\")\n    .withIndex(\"by_category_value\", (q) =>\n      q.eq(\"category\", \"entity_type\").eq(\"value\", nodeType)\n    )\n    .first();\n\n  const platformSchema = readEntitySchemaFromConfig(platformEntry);\n  if (platformSchema !== null) {\n    return platformSchema;\n  }\n\n  return null;\n}\n\n// =============================================================================\n// VALIDATION\n// =============================================================================\n\n/**\n * Validate entity metadata against the registered schema.\n *\n * Policy: strict on create (unregistered types fail), lenient on read.\n *\n * @param ctx - Convex query/mutation context\n * @param nodeType - The entity nodeType (e.g., \"company\", \"person\")\n * @param metadata - The metadata object to validate\n * @param tenantId - Optional tenant ID for tenant-specific schemas\n * @returns ValidationResult with errors if invalid\n */\nexport async function validateEntityMetadata(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  metadata: Record<string, unknown> | undefined | null,\n  tenantId?: string\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n\n  const schema = await getEntityTypeSchema(ctx, nodeType, tenantId);\n\n  if (!schema) {\n    return {\n      valid: false,\n      errors: [\n        `No registered schema for entity type \"${nodeType}\". Register it in schemaEnumConfig (category=\"entity_type\") before creating entities of this type.`,\n      ],\n    };\n  }\n\n  const meta = metadata || {};\n\n  // Check required fields\n  for (const [fieldName, fieldDef] of Object.entries(schema)) {\n    if (fieldDef.required) {\n      const value = meta[fieldName];\n      if (value === undefined || value === null || value === \"\") {\n        errors.push(`Required field \"${fieldName}\" is missing or empty`);\n      }\n    }\n  }\n\n  // Check field types for provided fields\n  for (const [fieldName, value] of Object.entries(meta)) {\n    const fieldDef = schema[fieldName];\n    if (!fieldDef) {\n      // Extra fields are allowed (loose metadata tolerance)\n      continue;\n    }\n\n    if (value === undefined || value === null) {\n      // null/undefined are allowed for optional fields (already caught above for required)\n      continue;\n    }\n\n    const actualType = typeof value;\n    if (actualType !== fieldDef.type) {\n      errors.push(\n        `Field \"${fieldName}\" expected type \"${fieldDef.type}\" but got \"${actualType}\"`\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Check if a nodeType is a registered entity type (platform or tenant).\n */\nexport async function isRegisteredEntityType(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  tenantId?: string\n): Promise<boolean> {\n  const schema = await getEntityTypeSchema(ctx, nodeType, tenantId);\n  return schema !== null;\n}\n"]}

package/dist/{epistemicAnswers-C5ib4z6_.d.ts → epistemicAnswers-f47YMu9U.d.ts}

@@ -25,25 +25,25 @@
  * 8. Updates question's answerQuality field
  * 9. Logs to epistemicAudit
  */
-declare const create: any;
+declare const create: unknown;
 /**
  * Internal mutation for creating answer nodes.
  * Called from epistemicQuestions.updateStatus when status === "answered".
  */
-declare const createInternal: any;
+declare const createInternal: unknown;
 /**
  * Get all answers for a question, optionally including superseded.
  */
-declare const getByQuestion: any;
+declare const getByQuestion: unknown;
 /**
  * Get the single active (latest) answer for a question.
  */
-declare const getLatestForQuestion: any;
+declare const getLatestForQuestion: unknown;
 /**
  * Get full version history for answers to a question.
  * Returns answers ordered by version number (newest first).
  */
-declare const getVersionHistory: any;
+declare const getVersionHistory: unknown;
 /**
  * Backfill answer nodes for questions that have answer text in metadata
  * but never had an answer node created (due to the QuestionAnswerEditor bug
@@ -52,7 +52,7 @@ declare const getVersionHistory: any;
  * Run once via Convex dashboard:
  *   internal.epistemicAnswers.backfillAnswerNodes({ projectId, userId })
  */
-declare const backfillAnswerNodes: any;
+declare const backfillAnswerNodes: unknown;
 
 declare const epistemicAnswers_backfillAnswerNodes: typeof backfillAnswerNodes;
 declare const epistemicAnswers_create: typeof create;

package/dist/epistemicAnswers.d.ts

@@ -1 +1 @@
-export { b as backfillAnswerNodes, c as create, a as createInternal, g as getByQuestion, d as getLatestForQuestion, f as getVersionHistory } from './epistemicAnswers-C5ib4z6_.js';
+export { b as backfillAnswerNodes, c as create, a as createInternal, g as getByQuestion, d as getLatestForQuestion, f as getVersionHistory } from './epistemicAnswers-f47YMu9U.js';