@ai-matrx/associations 0.8.9 → 0.9.0

package/dist/core/index.d.cts

@@ -679,42 +679,6 @@ interface AssociationsStore {
  */
 declare function createAssociationsStore(config: AssociationsConfig): AssociationsStore;
 
-/** The name the self-test probes; MUST NOT exist in any schema. */
-declare const SELF_TEST_MISSING_RPC = "assoc_probe_self_test_missing_fn";
-interface DemandedSchemaReport {
-    ok: boolean;
-    /** Demanded functions the database cannot answer (PGRST202). */
-    missing: string[];
-    /** Functions the probe could not reach (transport/unknown failure). */
-    unreachable: {
-        fn: string;
-        error: unknown;
-    }[];
-    /** Functions that answered (success or any non-PGRST202 refusal). */
-    answered: string[];
-}
-interface AssertDemandedSchemaOptions {
-    /**
-     * Also probe a fabricated function name and REQUIRE it to come back
-     * missing — proves the probe can fail (the falsifiability rule).
-     */
-    selfTest?: boolean;
-    /** Max in-flight probe calls (default 6). */
-    concurrency?: number;
-    /**
-     * Return the report instead of throwing on violation (for surfaces that
-     * render the report). The self-test failure ALWAYS throws.
-     */
-    throwOnViolation?: boolean;
-}
-/**
- * Probe every demanded RPC against `dataSource`. Throws an `Error` naming
- * every missing function when the database violates the demanded schema
- * (unless `throwOnViolation: false`), and ALWAYS throws when the probe
- * itself cannot be trusted (unreachable database, failed self-test).
- */
-declare function assertDemandedSchema(dataSource: AssociationsDataSource, options?: AssertDemandedSchemaOptions): Promise<DemandedSchemaReport>;
-
 /** Source tokens that are structure, never container content. */
 declare const NON_CONTENT_SOURCE_TYPES: ReadonlySet<string>;
 /** True when edge metadata marks a container-membership edge. */
@@ -751,4 +715,4 @@ declare function buildCategoryHierarchy(categories: PlatformCategory[]): Categor
  */
 declare function createDefaultErrorSink(): ErrorSink;
 
-export { type AddAssociationArgs, type AddCommentArgs, type AssertDemandedSchemaOptions, type AssociationGuards, type AssociationHelpersApi, type AssociationWriteResult, type AssociationsServiceApi, type AssociationsStore, type CandidateRecord, type CandidatesResult, type CandidatesServiceApi, type CategoriesServiceApi, type CategoryHierarchy, type CategoryHierarchyItem, type CategoryMutationResult, type CommentMutationResult, type CommentsServiceApi, type ContainerRef, type ContentRole, type ConversationFileLink, type CoreDeps, type CreateEntityRowArgs, DEFAULT_ORG_COLUMN, DEFAULT_OWNER_COLUMN, type DemandedSchemaReport, type EdgeAttrs, type EdgeSpec, type EntityInfo, type EntityRef, type EntityRegistry, type EntityRowResult, type EntityRowsServiceApi, type FavoritesServiceApi, type ListCandidatesArgs, NON_CONTENT_SOURCE_TYPES, type PgErrorMapper, type RpcResultHelpers, SELF_TEST_MISSING_RPC, type SearchAcrossTokensArgs, type TitlesServiceApi, type UniversalCandidate, assertDemandedSchema, associationsKey, buildCategoryHierarchy, createAssociationGuards, createAssociationHelpers, createAssociationsService, createAssociationsStore, createCandidatesService, createCategoriesService, createCommentsService, createDefaultErrorSink, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, ok, resolveEntityToken };
+export { type AddAssociationArgs, type AddCommentArgs, type AssociationGuards, type AssociationHelpersApi, type AssociationWriteResult, type AssociationsServiceApi, type AssociationsStore, type CandidateRecord, type CandidatesResult, type CandidatesServiceApi, type CategoriesServiceApi, type CategoryHierarchy, type CategoryHierarchyItem, type CategoryMutationResult, type CommentMutationResult, type CommentsServiceApi, type ContainerRef, type ContentRole, type ConversationFileLink, type CoreDeps, type CreateEntityRowArgs, DEFAULT_ORG_COLUMN, DEFAULT_OWNER_COLUMN, type EdgeAttrs, type EdgeSpec, type EntityInfo, type EntityRef, type EntityRegistry, type EntityRowResult, type EntityRowsServiceApi, type FavoritesServiceApi, type ListCandidatesArgs, NON_CONTENT_SOURCE_TYPES, type PgErrorMapper, type RpcResultHelpers, type SearchAcrossTokensArgs, type TitlesServiceApi, type UniversalCandidate, associationsKey, buildCategoryHierarchy, createAssociationGuards, createAssociationHelpers, createAssociationsService, createAssociationsStore, createCandidatesService, createCategoriesService, createCommentsService, createDefaultErrorSink, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, ok, resolveEntityToken };

package/dist/core/index.d.ts

@@ -679,42 +679,6 @@ interface AssociationsStore {
  */
 declare function createAssociationsStore(config: AssociationsConfig): AssociationsStore;
 
-/** The name the self-test probes; MUST NOT exist in any schema. */
-declare const SELF_TEST_MISSING_RPC = "assoc_probe_self_test_missing_fn";
-interface DemandedSchemaReport {
-    ok: boolean;
-    /** Demanded functions the database cannot answer (PGRST202). */
-    missing: string[];
-    /** Functions the probe could not reach (transport/unknown failure). */
-    unreachable: {
-        fn: string;
-        error: unknown;
-    }[];
-    /** Functions that answered (success or any non-PGRST202 refusal). */
-    answered: string[];
-}
-interface AssertDemandedSchemaOptions {
-    /**
-     * Also probe a fabricated function name and REQUIRE it to come back
-     * missing — proves the probe can fail (the falsifiability rule).
-     */
-    selfTest?: boolean;
-    /** Max in-flight probe calls (default 6). */
-    concurrency?: number;
-    /**
-     * Return the report instead of throwing on violation (for surfaces that
-     * render the report). The self-test failure ALWAYS throws.
-     */
-    throwOnViolation?: boolean;
-}
-/**
- * Probe every demanded RPC against `dataSource`. Throws an `Error` naming
- * every missing function when the database violates the demanded schema
- * (unless `throwOnViolation: false`), and ALWAYS throws when the probe
- * itself cannot be trusted (unreachable database, failed self-test).
- */
-declare function assertDemandedSchema(dataSource: AssociationsDataSource, options?: AssertDemandedSchemaOptions): Promise<DemandedSchemaReport>;
-
 /** Source tokens that are structure, never container content. */
 declare const NON_CONTENT_SOURCE_TYPES: ReadonlySet<string>;
 /** True when edge metadata marks a container-membership edge. */
@@ -751,4 +715,4 @@ declare function buildCategoryHierarchy(categories: PlatformCategory[]): Categor
  */
 declare function createDefaultErrorSink(): ErrorSink;
 
-export { type AddAssociationArgs, type AddCommentArgs, type AssertDemandedSchemaOptions, type AssociationGuards, type AssociationHelpersApi, type AssociationWriteResult, type AssociationsServiceApi, type AssociationsStore, type CandidateRecord, type CandidatesResult, type CandidatesServiceApi, type CategoriesServiceApi, type CategoryHierarchy, type CategoryHierarchyItem, type CategoryMutationResult, type CommentMutationResult, type CommentsServiceApi, type ContainerRef, type ContentRole, type ConversationFileLink, type CoreDeps, type CreateEntityRowArgs, DEFAULT_ORG_COLUMN, DEFAULT_OWNER_COLUMN, type DemandedSchemaReport, type EdgeAttrs, type EdgeSpec, type EntityInfo, type EntityRef, type EntityRegistry, type EntityRowResult, type EntityRowsServiceApi, type FavoritesServiceApi, type ListCandidatesArgs, NON_CONTENT_SOURCE_TYPES, type PgErrorMapper, type RpcResultHelpers, SELF_TEST_MISSING_RPC, type SearchAcrossTokensArgs, type TitlesServiceApi, type UniversalCandidate, assertDemandedSchema, associationsKey, buildCategoryHierarchy, createAssociationGuards, createAssociationHelpers, createAssociationsService, createAssociationsStore, createCandidatesService, createCategoriesService, createCommentsService, createDefaultErrorSink, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, ok, resolveEntityToken };
+export { type AddAssociationArgs, type AddCommentArgs, type AssociationGuards, type AssociationHelpersApi, type AssociationWriteResult, type AssociationsServiceApi, type AssociationsStore, type CandidateRecord, type CandidatesResult, type CandidatesServiceApi, type CategoriesServiceApi, type CategoryHierarchy, type CategoryHierarchyItem, type CategoryMutationResult, type CommentMutationResult, type CommentsServiceApi, type ContainerRef, type ContentRole, type ConversationFileLink, type CoreDeps, type CreateEntityRowArgs, DEFAULT_ORG_COLUMN, DEFAULT_OWNER_COLUMN, type EdgeAttrs, type EdgeSpec, type EntityInfo, type EntityRef, type EntityRegistry, type EntityRowResult, type EntityRowsServiceApi, type FavoritesServiceApi, type ListCandidatesArgs, NON_CONTENT_SOURCE_TYPES, type PgErrorMapper, type RpcResultHelpers, type SearchAcrossTokensArgs, type TitlesServiceApi, type UniversalCandidate, associationsKey, buildCategoryHierarchy, createAssociationGuards, createAssociationHelpers, createAssociationsService, createAssociationsStore, createCandidatesService, createCategoriesService, createCommentsService, createDefaultErrorSink, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, ok, resolveEntityToken };

package/dist/core/index.js

@@ -164,7 +164,9 @@ var ENTITY_TYPE_METADATA = {
   "context_item_value": { token: "context_item_value", schema: "context", table: "context_item_values", label: "Record Value", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "conversation": { token: "conversation", schema: "chat", table: "conversation", label: "Conversation", baseTier: 1, isComponent: false, isModule: true, isListed: false, scopeable: true, category: "Outputs", referencePickable: true, titleColumn: "title", contentRole: "destination", referenceCategory: null },
   "conversation_value": { token: "conversation_value", schema: "chat", table: "conversation_value", label: "Conversation Value", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: false, category: null, referencePickable: false, titleColumn: "key", contentRole: null, referenceCategory: null },
+  "credential_attachment": { token: "credential_attachment", schema: "users", table: "credential_attachments", label: "Credential attachment", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "credential_item": { token: "credential_item", schema: "users", table: "credential_items", label: "Credential item", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
+  "credential_mutation_receipt": { token: "credential_mutation_receipt", schema: "users", table: "credential_mutation_receipts", label: "Credential Mutation Receipt", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
   "crm_address": { token: "crm_address", schema: "crm", table: "address", label: "Address", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: "label", contentRole: null, referenceCategory: null },
   "crm_affiliation": { token: "crm_affiliation", schema: "crm", table: "affiliation", label: "Affiliation", baseTier: 1, isComponent: true, isModule: false, isListed: false, scopeable: true, category: null, referencePickable: false, titleColumn: "title", contentRole: null, referenceCategory: null },
   "crm_blocklist_entry": { token: "crm_blocklist_entry", schema: "crm", table: "blocklist_entry", label: "Blocklist Entry", baseTier: 1, isComponent: false, isModule: false, isListed: true, scopeable: true, category: null, referencePickable: false, titleColumn: null, contentRole: null, referenceCategory: null },
@@ -840,7 +842,9 @@ var ENTITY_TYPE_TOKENS = [
   "context_item_value",
   "conversation",
   "conversation_value",
+  "credential_attachment",
   "credential_item",
+  "credential_mutation_receipt",
   "crm_address",
   "crm_affiliation",
   "crm_blocklist_entry",
@@ -3258,169 +3262,6 @@ function createAssociationsStore(config) {
   };
 }
 
-// src/demanded-rpcs.generated.ts
-var DEMANDED_RPC_NAMES = [
-  "assoc_add",
-  "assoc_remove",
-  "assoc_set_targets",
-  "assoc_remove_for_entity",
-  "assoc_for_entity",
-  "assoc_for_targets",
-  "assoc_for_sources",
-  "assoc_members_visible",
-  "conversation_file_add",
-  "conversation_file_remove",
-  "conversation_files",
-  "agent_resource_add",
-  "agent_resource_remove",
-  "cat_list",
-  "cat_create",
-  "cat_update",
-  "cat_reparent",
-  "cat_delete",
-  "ues_set",
-  "ues_list",
-  "ues_get_bulk",
-  "ues_touch",
-  "reference_search_candidates",
-  "cmt_list",
-  "cmt_add",
-  "cmt_edit",
-  "cmt_delete"
-];
-
-// src/core/assertDemandedSchema.ts
-var BAD_UUID = "__not_a_uuid__";
-var SELF_TEST_MISSING_RPC = "assoc_probe_self_test_missing_fn";
-var PROBE_ARGS = {
-  // edges — writes
-  assoc_add: {
-    p_source_type: "note",
-    p_source_id: BAD_UUID,
-    p_target_type: "task",
-    p_target_id: BAD_UUID
-  },
-  assoc_remove: {
-    p_source_type: "note",
-    p_source_id: BAD_UUID,
-    p_target_type: "task",
-    p_target_id: BAD_UUID
-  },
-  assoc_set_targets: {
-    p_source_type: "note",
-    p_source_id: BAD_UUID,
-    p_target_type: "task",
-    p_target_ids: [BAD_UUID]
-  },
-  assoc_remove_for_entity: { p_type: "note", p_id: BAD_UUID },
-  // edges — reads
-  assoc_for_entity: { p_type: "note", p_id: BAD_UUID },
-  assoc_for_targets: { p_target_type: "task", p_target_ids: [BAD_UUID] },
-  assoc_for_sources: { p_source_type: "note", p_source_ids: [BAD_UUID] },
-  assoc_members_visible: { p_target_type: "task", p_target_ids: [BAD_UUID] },
-  // conversation files
-  conversation_file_add: {
-    p_conversation_id: BAD_UUID,
-    p_file_id: BAD_UUID
-  },
-  conversation_file_remove: {
-    p_conversation_id: BAD_UUID,
-    p_file_id: BAD_UUID
-  },
-  conversation_files: { p_conversation_id: BAD_UUID },
-  // agent resources
-  agent_resource_add: {
-    p_agent_id: BAD_UUID,
-    p_source_type: "note",
-    p_source_id: BAD_UUID
-  },
-  agent_resource_remove: {
-    p_agent_id: BAD_UUID,
-    p_source_type: "note",
-    p_source_id: BAD_UUID
-  },
-  // categories
-  cat_list: {},
-  cat_create: { p_dimension: "", p_name: "", p_org_id: BAD_UUID },
-  cat_update: { p_category_id: BAD_UUID, p_name: "__probe__" },
-  cat_reparent: { p_category_id: BAD_UUID },
-  cat_delete: { p_category_id: BAD_UUID },
-  // favorites / recents
-  ues_set: { p_entity_type: "__probe__", p_entity_id: BAD_UUID },
-  ues_list: {},
-  ues_get_bulk: { p_entity_type: "__probe__", p_entity_ids: [BAD_UUID] },
-  ues_touch: { p_entity_type: "__probe__", p_entity_id: BAD_UUID },
-  // candidates
-  reference_search_candidates: { p_token: "__probe__", p_limit: 1 },
-  // comments (W6) — every fn takes a uuid arg, so the unparseable sentinel
-  // guarantees 22P02 before any SECURITY DEFINER body runs (no write occurs).
-  cmt_list: { p_entity_type: "__probe__", p_entity_id: BAD_UUID },
-  cmt_add: {
-    p_entity_type: "__probe__",
-    p_entity_id: BAD_UUID,
-    p_body: "__probe__"
-  },
-  cmt_edit: { p_id: BAD_UUID, p_body: "__probe__" },
-  cmt_delete: { p_id: BAD_UUID }
-};
-function isMissingFunctionError(error) {
-  if (!error || typeof error !== "object") return false;
-  return error.code === "PGRST202";
-}
-async function assertDemandedSchema(dataSource, options = {}) {
-  const { selfTest = false, concurrency = 6, throwOnViolation = true } = options;
-  const names = [...DEMANDED_RPC_NAMES];
-  if (selfTest) names.push(SELF_TEST_MISSING_RPC);
-  const missing = [];
-  const unreachable = [];
-  const answered = [];
-  let cursor = 0;
-  async function worker() {
-    while (cursor < names.length) {
-      const fn = names[cursor];
-      cursor += 1;
-      if (!fn) continue;
-      const args = fn === SELF_TEST_MISSING_RPC ? {} : PROBE_ARGS[fn];
-      try {
-        const { error } = await dataSource.rpc(fn, args);
-        if (error == null) answered.push(fn);
-        else if (isMissingFunctionError(error)) missing.push(fn);
-        else answered.push(fn);
-      } catch (e) {
-        unreachable.push({ fn, error: e });
-      }
-    }
-  }
-  await Promise.all(
-    Array.from({ length: Math.min(concurrency, names.length) }, worker)
-  );
-  if (selfTest) {
-    const selfTestMissing = missing.includes(SELF_TEST_MISSING_RPC);
-    const idx = missing.indexOf(SELF_TEST_MISSING_RPC);
-    if (idx >= 0) missing.splice(idx, 1);
-    const answeredIdx = answered.indexOf(SELF_TEST_MISSING_RPC);
-    if (answeredIdx >= 0) answered.splice(answeredIdx, 1);
-    if (!selfTestMissing) {
-      throw new Error(
-        `assertDemandedSchema self-test FAILED: the fabricated function "${SELF_TEST_MISSING_RPC}" did not come back as missing (PGRST202). This probe cannot currently fail, so its green result proves nothing \u2014 the dataSource is swallowing or faking errors.`
-      );
-    }
-  }
-  if (unreachable.length > 0) {
-    throw new Error(
-      `assertDemandedSchema could not complete: ${unreachable.length} probe call(s) failed to reach the database (${unreachable.map((u) => u.fn).join(", ")}). This is NOT a schema verdict \u2014 fix connectivity and re-run.`
-    );
-  }
-  const ok2 = missing.length === 0;
-  const report = { ok: ok2, missing, unreachable, answered };
-  if (!ok2 && throwOnViolation) {
-    throw new Error(
-      `DEMANDED SCHEMA VIOLATION: the database this dataSource points at cannot answer ${missing.length} demanded @ai-matrx/associations function(s): ${missing.join(", ")}. This package demands the AI Matrx platform schema (README \xA7 The demanded schema); a database without it is not this package's database.`
-    );
-  }
-  return report;
-}
-
 // src/core/edgeClassifier.ts
 var NON_CONTENT_SOURCE_TYPES = /* @__PURE__ */ new Set([
   "thread",
@@ -3505,8 +3346,6 @@ export {
   DEFAULT_ORG_COLUMN,
   DEFAULT_OWNER_COLUMN,
   NON_CONTENT_SOURCE_TYPES,
-  SELF_TEST_MISSING_RPC,
-  assertDemandedSchema,
   associationsKey,
   buildCategoryHierarchy,
   createAssociationGuards,