@ai-matrx/associations 0.5.2 → 0.6.0

package/dist/core/index.d.cts

@@ -658,7 +658,13 @@ interface AssociationsStore {
      * recoveries here (the originals' console.error sites) without a second
      * sink binding. Same function the host passed at construction.
      */
-    errorSink: AssociationsConfig["errorSink"];
+    errorSink: ErrorSink;
+    /**
+     * The bound data seam (0.6.0, additive): the provider's demanded-schema
+     * boot probe reads it so hosts stop re-exporting their dataSource just to
+     * run a check the package owns.
+     */
+    dataSource: AssociationsDataSource;
     /**
      * The bound identity port (W3, additive): /react hooks that FILTER by the
      * current user (candidate owner scoping) read it leniently; write paths
@@ -668,9 +674,10 @@ interface AssociationsStore {
     identity: AssociationsConfig["identity"];
 }
 /**
- * Build the one store a host binds. REQUIRED ports (dataSource / identity /
- * errorSink) throw at construction when absent — never degraded. Every
- * optional port degrades per its documented contract.
+ * Build the one store a host binds. The REQUIRED ports (dataSource /
+ * identity — true app identity, C23) throw at construction when absent.
+ * Every other port has a SHIPPED DEFAULT (errorSink since 0.6.0) or a
+ * documented degradation; nothing is ever silently missing.
  */
 declare function createAssociationsStore(config: AssociationsConfig): AssociationsStore;
 
@@ -740,4 +747,10 @@ interface CategoryHierarchy {
  */
 declare function buildCategoryHierarchy(categories: PlatformCategory[]): CategoryHierarchy;
 
-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, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, isUuid, ok, resolveEntityToken };
+/**
+ * Build the default sink. `announce` is called once, on the first event, so
+ * the absence of a bound sink is itself loud (never a silent substitution).
+ */
+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, isUuid, ok, resolveEntityToken };

package/dist/core/index.d.ts

@@ -658,7 +658,13 @@ interface AssociationsStore {
      * recoveries here (the originals' console.error sites) without a second
      * sink binding. Same function the host passed at construction.
      */
-    errorSink: AssociationsConfig["errorSink"];
+    errorSink: ErrorSink;
+    /**
+     * The bound data seam (0.6.0, additive): the provider's demanded-schema
+     * boot probe reads it so hosts stop re-exporting their dataSource just to
+     * run a check the package owns.
+     */
+    dataSource: AssociationsDataSource;
     /**
      * The bound identity port (W3, additive): /react hooks that FILTER by the
      * current user (candidate owner scoping) read it leniently; write paths
@@ -668,9 +674,10 @@ interface AssociationsStore {
     identity: AssociationsConfig["identity"];
 }
 /**
- * Build the one store a host binds. REQUIRED ports (dataSource / identity /
- * errorSink) throw at construction when absent — never degraded. Every
- * optional port degrades per its documented contract.
+ * Build the one store a host binds. The REQUIRED ports (dataSource /
+ * identity — true app identity, C23) throw at construction when absent.
+ * Every other port has a SHIPPED DEFAULT (errorSink since 0.6.0) or a
+ * documented degradation; nothing is ever silently missing.
  */
 declare function createAssociationsStore(config: AssociationsConfig): AssociationsStore;
 
@@ -740,4 +747,10 @@ interface CategoryHierarchy {
  */
 declare function buildCategoryHierarchy(categories: PlatformCategory[]): CategoryHierarchy;
 
-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, createEntityRegistry, createEntityRowsService, createFavoritesService, createRpcResultHelpers, createTitlesService, entityTitleCacheKey, err, firstError, isContentRole, isContentSourceEdge, isMembershipMetadata, isTransportFailure, isUuid, ok, resolveEntityToken };
+/**
+ * Build the default sink. `announce` is called once, on the first event, so
+ * the absence of a bound sink is itself loud (never a silent substitution).
+ */
+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, isUuid, ok, resolveEntityToken };

package/dist/core/index.js

@@ -3,6 +3,24 @@ function isAssociationsRpcErr(r) {
   return r.ok === false;
 }
 
+// src/core/defaultErrorSink.ts
+var REMEDY = "Bind the `errorSink` port on createAssociationsStore({ errorSink }) to route these into your diagnostics surface; until then they only reach the console.";
+function createDefaultErrorSink() {
+  let announced = false;
+  return (event) => {
+    if (!announced) {
+      announced = true;
+      console.error(
+        "[associations] no errorSink port bound \u2014 using the package default. " + REMEDY
+      );
+    }
+    console.error(
+      `[associations] ${event.code}: ${event.message}`,
+      event.context ?? {}
+    );
+  };
+}
+
 // src/entity-types.generated.ts
 var ENTITY_TYPE_METADATA = {
   "access_request": { token: "access_request", schema: "iam", table: "access_requests", label: "Access Request", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: "System", referencePickable: false, titleColumn: null, contentRole: "utility", referenceCategory: null },
@@ -2812,12 +2830,7 @@ function createAssociationsStore(config) {
       "@ai-matrx/associations: the REQUIRED identity port is missing (need requireUserId(): string that THROWS when unauthenticated). Identity never comes from a store import."
     );
   }
-  if (typeof config.errorSink !== "function") {
-    throw new Error(
-      "@ai-matrx/associations: the REQUIRED errorSink port is missing. Recovery layers must scream somewhere \u2014 bind a sink."
-    );
-  }
-  const errorSink = config.errorSink;
+  const errorSink = typeof config.errorSink === "function" ? config.errorSink : createDefaultErrorSink();
   const registry = createEntityRegistry(errorSink, config.entityOverlay);
   const deps = {
     dataSource: config.dataSource,
@@ -3203,6 +3216,7 @@ function createAssociationsStore(config) {
     services: { associations, categories, comments },
     registerEntityOverlay: registry.registerEntityOverlay,
     errorSink,
+    dataSource: config.dataSource,
     identity: config.identity
   };
 }
@@ -3465,6 +3479,7 @@ export {
   createCandidatesService,
   createCategoriesService,
   createCommentsService,
+  createDefaultErrorSink,
   createEntityRegistry,
   createEntityRowsService,
   createFavoritesService,