@ai-matrx/associations 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -88,6 +88,43 @@ interface CategoriesEntry {
     error: string | null;
 }
 
+/** The author of a comment, denormalized by `cmt_list` from the auth user. */
+interface CommentAuthor {
+    email: string | null;
+    displayName: string | null;
+    avatarUrl: string | null;
+}
+/**
+ * One `platform.comments` row, camelCased (mirrors `cmt_list`'s return).
+ * Threading is by `parentId`: a top-level comment has `parentId === null`;
+ * a reply points at its parent. `cmt_list` returns rows oldest→newest so
+ * callers can build the thread in one pass.
+ */
+interface PlatformComment {
+    id: string;
+    orgId: string | null;
+    entityType: string;
+    entityId: string;
+    parentId: string | null;
+    body: string;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string | null;
+    author: CommentAuthor;
+}
+/**
+ * One cached comment thread (per `${entityType}:${entityId}` endpoint) — the
+ * same lifecycle shape as `AssociationsEntry`/`CategoriesEntry`: pending
+ * keeps previous comments AND the visible error; `fetchedAt` is the last
+ * successful load.
+ */
+interface CommentsEntry {
+    status: "idle" | "loading" | "ready" | "error";
+    comments: readonly PlatformComment[];
+    fetchedAt: number | null;
+    error: string | null;
+}
+
 /** Per-RPC Args/Returns for every demanded function, straight from the live DB. */
 interface DemandedRpcSignatures {
     assoc_add: {
@@ -363,6 +400,49 @@ interface DemandedRpcSignatures {
             title: string;
         }[];
     };
+    cmt_list: {
+        Args: {
+            p_entity_id: string;
+            p_entity_type: string;
+        };
+        Returns: {
+            author_avatar_url: string;
+            author_display_name: string;
+            author_email: string;
+            body: string;
+            created_at: string;
+            created_by: string;
+            entity_id: string;
+            entity_type: string;
+            id: string;
+            organization_id: string;
+            parent_id: string;
+            updated_at: string;
+        }[];
+    };
+    cmt_add: {
+        Args: {
+            p_body: string;
+            p_entity_id: string;
+            p_entity_type: string;
+            p_org_id?: string;
+            p_parent_id?: string;
+        };
+        Returns: string;
+    };
+    cmt_edit: {
+        Args: {
+            p_body: string;
+            p_id: string;
+        };
+        Returns: undefined;
+    };
+    cmt_delete: {
+        Args: {
+            p_id: string;
+        };
+        Returns: undefined;
+    };
 }
 /** The name of any demanded RPC — the only strings the dataSource port accepts. */
 type DemandedRpcName = keyof DemandedRpcSignatures;
@@ -11179,6 +11259,30 @@ interface EntityDoorProps {
     name?: string | null;
     className?: string;
 }
+/** What the authorDisplay port receives — one comment's denormalized author. */
+interface AuthorDisplayInput {
+    /** The auth user id (`created_by`), or null on an authorless legacy row. */
+    userId: string | null;
+    email: string | null;
+    displayName: string | null;
+    avatarUrl: string | null;
+}
+/**
+ * The author-display seam (W6 comments UI). The package cannot resolve user
+ * profiles itself — `cmt_list` denormalizes email/displayName/avatarUrl per
+ * row, and a host with a richer profile store (presence, current names,
+ * signed avatar URLs) overrides them here. Return `null` (or omit a field)
+ * to keep the denormalized value.
+ *
+ * DEGRADATION (absent port): the RPC's denormalized fields render as-is;
+ * a row with neither displayName nor email shows the package's
+ * "Unknown user" label with the default initial avatar. Never blank, never
+ * a crash.
+ */
+type AuthorDisplayPort = (author: AuthorDisplayInput) => {
+    displayName?: string | null;
+    avatarUrl?: string | null;
+} | null;
 /**
  * The entity-doors seam (today: `EntityRef` / `EntityDoorControls` /
  * access-gate `UnresolvedEntityRef`). Absent → title text plus the overlay's
@@ -11208,6 +11312,7 @@ interface AssociationsConfig {
     capture?: CapturePort;
     pickerOverrides?: PickerOverrideMap;
     entityDoors?: EntityDoorsPort;
+    authorDisplay?: AuthorDisplayPort;
 }
 
-export { ASSOCIATION_TARGET_TYPES, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationsRpcErr, isEntityTypeToken };
+export { ASSOCIATION_TARGET_TYPES, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationsRpcErr, isEntityTypeToken };

package/dist/index.d.ts

@@ -88,6 +88,43 @@ interface CategoriesEntry {
     error: string | null;
 }
 
+/** The author of a comment, denormalized by `cmt_list` from the auth user. */
+interface CommentAuthor {
+    email: string | null;
+    displayName: string | null;
+    avatarUrl: string | null;
+}
+/**
+ * One `platform.comments` row, camelCased (mirrors `cmt_list`'s return).
+ * Threading is by `parentId`: a top-level comment has `parentId === null`;
+ * a reply points at its parent. `cmt_list` returns rows oldest→newest so
+ * callers can build the thread in one pass.
+ */
+interface PlatformComment {
+    id: string;
+    orgId: string | null;
+    entityType: string;
+    entityId: string;
+    parentId: string | null;
+    body: string;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string | null;
+    author: CommentAuthor;
+}
+/**
+ * One cached comment thread (per `${entityType}:${entityId}` endpoint) — the
+ * same lifecycle shape as `AssociationsEntry`/`CategoriesEntry`: pending
+ * keeps previous comments AND the visible error; `fetchedAt` is the last
+ * successful load.
+ */
+interface CommentsEntry {
+    status: "idle" | "loading" | "ready" | "error";
+    comments: readonly PlatformComment[];
+    fetchedAt: number | null;
+    error: string | null;
+}
+
 /** Per-RPC Args/Returns for every demanded function, straight from the live DB. */
 interface DemandedRpcSignatures {
     assoc_add: {
@@ -363,6 +400,49 @@ interface DemandedRpcSignatures {
             title: string;
         }[];
     };
+    cmt_list: {
+        Args: {
+            p_entity_id: string;
+            p_entity_type: string;
+        };
+        Returns: {
+            author_avatar_url: string;
+            author_display_name: string;
+            author_email: string;
+            body: string;
+            created_at: string;
+            created_by: string;
+            entity_id: string;
+            entity_type: string;
+            id: string;
+            organization_id: string;
+            parent_id: string;
+            updated_at: string;
+        }[];
+    };
+    cmt_add: {
+        Args: {
+            p_body: string;
+            p_entity_id: string;
+            p_entity_type: string;
+            p_org_id?: string;
+            p_parent_id?: string;
+        };
+        Returns: string;
+    };
+    cmt_edit: {
+        Args: {
+            p_body: string;
+            p_id: string;
+        };
+        Returns: undefined;
+    };
+    cmt_delete: {
+        Args: {
+            p_id: string;
+        };
+        Returns: undefined;
+    };
 }
 /** The name of any demanded RPC — the only strings the dataSource port accepts. */
 type DemandedRpcName = keyof DemandedRpcSignatures;
@@ -11179,6 +11259,30 @@ interface EntityDoorProps {
     name?: string | null;
     className?: string;
 }
+/** What the authorDisplay port receives — one comment's denormalized author. */
+interface AuthorDisplayInput {
+    /** The auth user id (`created_by`), or null on an authorless legacy row. */
+    userId: string | null;
+    email: string | null;
+    displayName: string | null;
+    avatarUrl: string | null;
+}
+/**
+ * The author-display seam (W6 comments UI). The package cannot resolve user
+ * profiles itself — `cmt_list` denormalizes email/displayName/avatarUrl per
+ * row, and a host with a richer profile store (presence, current names,
+ * signed avatar URLs) overrides them here. Return `null` (or omit a field)
+ * to keep the denormalized value.
+ *
+ * DEGRADATION (absent port): the RPC's denormalized fields render as-is;
+ * a row with neither displayName nor email shows the package's
+ * "Unknown user" label with the default initial avatar. Never blank, never
+ * a crash.
+ */
+type AuthorDisplayPort = (author: AuthorDisplayInput) => {
+    displayName?: string | null;
+    avatarUrl?: string | null;
+} | null;
 /**
  * The entity-doors seam (today: `EntityRef` / `EntityDoorControls` /
  * access-gate `UnresolvedEntityRef`). Absent → title text plus the overlay's
@@ -11208,6 +11312,7 @@ interface AssociationsConfig {
     capture?: CapturePort;
     pickerOverrides?: PickerOverrideMap;
     entityDoors?: EntityDoorsPort;
+    authorDisplay?: AuthorDisplayPort;
 }
 
-export { ASSOCIATION_TARGET_TYPES, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationsRpcErr, isEntityTypeToken };
+export { ASSOCIATION_TARGET_TYPES, type AssociationEdge, type AssociationPickerProps, type AssociationSourceEdge, type AssociationTargetEdge, type AssociationTargetType, type AssociationsConfig, type AssociationsDataSource, type AssociationsEntry, type AssociationsIdentity, type AssociationsNotifier, type AssociationsRpcError, type AssociationsRpcErrorCode, type AssociationsRpcResult, type AuthorDisplayInput, type AuthorDisplayPort, type CapturePickOpts, type CapturePort, type CaptureUploadOpts, type CaptureUploadResult, type CategoriesEntry, type CategoryDimension, type CommentAuthor, type CommentsEntry, type ComponentEntityToken, DEMANDED_RPC_NAMES, type DemandedRpcArgs, type DemandedRpcName, type DemandedRpcReturns, type DemandedRpcSignatures, ENTITY_TYPE_METADATA, ENTITY_TYPE_TOKENS, type EntityDoorProps, type EntityDoorsPort, type EntityOverlayEntry, type EntityOverlayMap, type EntityRefProps, type EntityTypeMeta, type EntityTypeToken, type ErrorSink, type ListedEntityToken, type ModuleEntityToken, type PgError, type PickerOverrideMap, type PlatformCategory, type PlatformComment, REFERENCE_CATEGORY_DISPLAY, type ReferencePickableEntityToken, SCHEMA_DISPLAY, type ScopeableEntityToken, type UserEntityState, type UserStateKind, type WindowShellPort, isAssociationsRpcErr, isEntityTypeToken };

package/dist/index.js

@@ -1447,7 +1447,11 @@ var DEMANDED_RPC_NAMES = [
   "ues_list",
   "ues_get_bulk",
   "ues_touch",
-  "reference_search_candidates"
+  "reference_search_candidates",
+  "cmt_list",
+  "cmt_add",
+  "cmt_edit",
+  "cmt_delete"
 ];
 export {
   ASSOCIATION_TARGET_TYPES,