@ai-matrx/messaging 0.7.0 → 0.9.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { MatrxTransport } from '@ai-matrx/agents/matrx';
-import { RealtimeManager } from '@ai-matrx/realtime';
+import { RealtimeClientLike, RealtimeManager } from '@ai-matrx/realtime';
 
 /**
  * THE MESSAGING DOMAIN TYPES.
@@ -609,6 +609,38 @@ interface SchemaLike {
 interface SupabaseLike extends SchemaLike {
     schema(name: string): SchemaLike;
 }
+/**
+ * 🚨 THE PUBLIC PROP TYPE IS DELIBERATELY SHALLOW.
+ *
+ * `<MessagingProvider client={supabase}>` must accept the client the host
+ * ALREADY HAS — a `SupabaseClient<Database>` built from generated types. It did
+ * not: checking a fully-typed client against the rich `SupabaseLike` above
+ * makes tsc chase PostgREST's schema machinery until it bails with **TS2589,
+ * "Type instantiation is excessively deep"**, followed by a page of "not
+ * assignable". The first real consumer hit both on the one line the README
+ * tells every consumer to write, and the only escape was the cast this
+ * package's own header forbids.
+ *
+ * So the boundary is shallow — method names and arity, results as `unknown` —
+ * which a typed client satisfies without the compiler unrolling anything. The
+ * RICH shape (`SupabaseLike`) is still the internal contract, and the provider
+ * narrows to it ONCE, inside the package. That is the data 0.2.1 lesson applied
+ * to a client instead of a JSON column: type a public boundary over `unknown`,
+ * never over a strict recursive type the host's generator also produces.
+ *
+ * `supabase-shape.test.ts` proves BOTH legs at compile time: every call this
+ * package makes works on a real client, AND a fully-typed real client is
+ * assignable to this type.
+ */
+interface MessagingSupabaseClient {
+    schema(name: string): unknown;
+    from(table: string): unknown;
+    rpc(fn: string, args?: Record<string, unknown>): unknown;
+    channel(topic: string, params?: unknown): unknown;
+    removeChannel(channel: never): unknown;
+}
+/** The internal client contract — what the repository and the manager see. */
+type MessagingSupabaseInternal = SupabaseLike & RealtimeClientLike;
 
 /**
  * THE DATA CONTRACT — the ONE place a messaging table or RPC name exists.
@@ -677,7 +709,15 @@ declare const RPCS: {
  */
 type SessionResolver = () => Promise<unknown>;
 interface RepositoryOptions {
-    client: SupabaseLike;
+    /**
+     * The host's Supabase client. Typed over the SHALLOW public shape for the
+     * same reason the provider's prop is (see `supabase-shape.ts`): a fully-typed
+     * `SupabaseClient<Database>` checked against the rich contract makes tsc bail
+     * with TS2589. A service module builds this repository directly — the
+     * framework-free path in the README — so it hits the boundary exactly like
+     * the provider does.
+     */
+    client: MessagingSupabaseClient;
     identity: MessagingIdentity;
     /** Called once before a retry when a read fails with a missing session. */
     resolveSession?: SessionResolver | undefined;
@@ -1037,4 +1077,4 @@ declare function summarizeText(content: string, maxLength?: number): string;
 /** Serialize picked references into a fence the platform's other readers accept. */
 declare function composeFence(references: readonly MatrxReference[]): string;
 
-export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationCursor, type ConversationId, type ConversationSummary, type ConversationThread, type ConversationType, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createWebOutboxStorage, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, splitText, summarizeText };
+export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationCursor, type ConversationId, type ConversationSummary, type ConversationThread, type ConversationType, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createWebOutboxStorage, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, splitText, summarizeText };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { MatrxTransport } from '@ai-matrx/agents/matrx';
-import { RealtimeManager } from '@ai-matrx/realtime';
+import { RealtimeClientLike, RealtimeManager } from '@ai-matrx/realtime';
 
 /**
  * THE MESSAGING DOMAIN TYPES.
@@ -609,6 +609,38 @@ interface SchemaLike {
 interface SupabaseLike extends SchemaLike {
     schema(name: string): SchemaLike;
 }
+/**
+ * 🚨 THE PUBLIC PROP TYPE IS DELIBERATELY SHALLOW.
+ *
+ * `<MessagingProvider client={supabase}>` must accept the client the host
+ * ALREADY HAS — a `SupabaseClient<Database>` built from generated types. It did
+ * not: checking a fully-typed client against the rich `SupabaseLike` above
+ * makes tsc chase PostgREST's schema machinery until it bails with **TS2589,
+ * "Type instantiation is excessively deep"**, followed by a page of "not
+ * assignable". The first real consumer hit both on the one line the README
+ * tells every consumer to write, and the only escape was the cast this
+ * package's own header forbids.
+ *
+ * So the boundary is shallow — method names and arity, results as `unknown` —
+ * which a typed client satisfies without the compiler unrolling anything. The
+ * RICH shape (`SupabaseLike`) is still the internal contract, and the provider
+ * narrows to it ONCE, inside the package. That is the data 0.2.1 lesson applied
+ * to a client instead of a JSON column: type a public boundary over `unknown`,
+ * never over a strict recursive type the host's generator also produces.
+ *
+ * `supabase-shape.test.ts` proves BOTH legs at compile time: every call this
+ * package makes works on a real client, AND a fully-typed real client is
+ * assignable to this type.
+ */
+interface MessagingSupabaseClient {
+    schema(name: string): unknown;
+    from(table: string): unknown;
+    rpc(fn: string, args?: Record<string, unknown>): unknown;
+    channel(topic: string, params?: unknown): unknown;
+    removeChannel(channel: never): unknown;
+}
+/** The internal client contract — what the repository and the manager see. */
+type MessagingSupabaseInternal = SupabaseLike & RealtimeClientLike;
 
 /**
  * THE DATA CONTRACT — the ONE place a messaging table or RPC name exists.
@@ -677,7 +709,15 @@ declare const RPCS: {
  */
 type SessionResolver = () => Promise<unknown>;
 interface RepositoryOptions {
-    client: SupabaseLike;
+    /**
+     * The host's Supabase client. Typed over the SHALLOW public shape for the
+     * same reason the provider's prop is (see `supabase-shape.ts`): a fully-typed
+     * `SupabaseClient<Database>` checked against the rich contract makes tsc bail
+     * with TS2589. A service module builds this repository directly — the
+     * framework-free path in the README — so it hits the boundary exactly like
+     * the provider does.
+     */
+    client: MessagingSupabaseClient;
     identity: MessagingIdentity;
     /** Called once before a retry when a read fails with a missing session. */
     resolveSession?: SessionResolver | undefined;
@@ -1037,4 +1077,4 @@ declare function summarizeText(content: string, maxLength?: number): string;
 /** Serialize picked references into a fence the platform's other readers accept. */
 declare function composeFence(references: readonly MatrxReference[]): string;
 
-export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationCursor, type ConversationId, type ConversationSummary, type ConversationThread, type ConversationType, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createWebOutboxStorage, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, splitText, summarizeText };
+export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationCursor, type ConversationId, type ConversationSummary, type ConversationThread, type ConversationType, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createWebOutboxStorage, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, splitText, summarizeText };

package/dist/index.js

@@ -734,11 +734,13 @@ function projectParticipants(value, operation) {
   for (const entry of value) {
     if (typeof entry !== "object" || entry === null) continue;
     const record = entry;
-    const id = str(record, "user_id") ?? str(record, "id");
+    const nested = typeof record["user"] === "object" && record["user"] !== null ? record["user"] : {};
+    const id = str(record, "user_id") ?? str(nested, "user_id") ?? str(record, "id");
     if (id === null) continue;
     summaries.push(
       projectUserSummary({
         ...record,
+        ...nested,
         user_id: id
       })
     );
@@ -1505,12 +1507,13 @@ function requireOrg(organizationId, operation) {
   return organizationId;
 }
 function createMessagingRepository(options) {
-  const { client, identity } = options;
+  const { identity } = options;
   const org = requireOrg(identity.organizationId, "createMessagingRepository");
   const userCache = createReadCache({
     ttlMs: options.userTtlMs ?? 5 * 6e4,
     ...options.now !== void 0 ? { now: options.now } : {}
   });
+  const client = options.client;
   const db = () => client.schema(MESSAGING_SCHEMA);
   const rpcDb = () => client.schema(MESSAGING_RPC_SCHEMA);
   async function withSessionRetry(operation, run) {