@messenger-box/platform-server 10.0.3-alpha.196 → 10.0.3-alpha.201

package/lib/channels/typing.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Typing indicator system - inspired by openclaw's typing callbacks,
+ * adapted to messenger-box's Props architecture with event-driven patterns.
+ *
+ * Provides typed callbacks and state management for typing indicators
+ * across channels, threads, and direct messages.
+ */
+export interface ITypingProps {
+    /** Whether to show typing indicators from other users */
+    showTypingIndicators: boolean;
+    /** Whether to broadcast own typing status */
+    broadcastTyping: boolean;
+    /** Debounce interval in milliseconds for typing events */
+    typingDebounceMs: number;
+    /** How long a typing indicator stays visible after last event (ms) */
+    typingTimeoutMs: number;
+}
+export declare const DEFAULT_TYPING_PROPS: ITypingProps;
+export interface ITypingUser {
+    userId: string;
+    username?: string;
+    displayName?: string;
+    channelId: string;
+    threadId?: string;
+    startedAt: Date;
+}
+export interface ITypingState {
+    /** Users currently typing in a channel */
+    typingUsers: ITypingUser[];
+    /** Last typing event timestamp */
+    lastEvent?: Date;
+}
+export interface ITypingCallbacks {
+    /** Called when a reply starts (user begins typing) */
+    onReplyStart: () => Promise<void>;
+    /** Called when the user goes idle (stops typing) */
+    onIdle?: () => void;
+    /** Called when the typing controller is cleaned up */
+    onCleanup?: () => void;
+}
+/**
+ * Creates typing callbacks with error handling (mirrors openclaw's createTypingCallbacks)
+ */
+export declare function createTypingCallbacks(params: {
+    start: () => Promise<void>;
+    stop?: () => Promise<void>;
+    onStartError: (err: unknown) => void;
+    onStopError?: (err: unknown) => void;
+}): ITypingCallbacks;
+export interface ITypingEvent {
+    /** User who is typing */
+    userId: string;
+    /** Channel where typing occurs */
+    channelId: string;
+    /** Thread ID if typing in a thread */
+    threadId?: string;
+    /** Whether user started or stopped typing */
+    action: 'start' | 'stop';
+    /** Event timestamp */
+    timestamp: Date;
+}
+export declare const TYPING_SUBSCRIPTION_TOPIC = "TYPING_INDICATOR";

package/lib/channels/typing.js

@@ -0,0 +1,37 @@
+/**
+ * Typing indicator system - inspired by openclaw's typing callbacks,
+ * adapted to messenger-box's Props architecture with event-driven patterns.
+ *
+ * Provides typed callbacks and state management for typing indicators
+ * across channels, threads, and direct messages.
+ */
+const DEFAULT_TYPING_PROPS = {
+  showTypingIndicators: true,
+  broadcastTyping: true,
+  typingDebounceMs: 300,
+  typingTimeoutMs: 5000
+};
+/**
+ * Creates typing callbacks with error handling (mirrors openclaw's createTypingCallbacks)
+ */
+function createTypingCallbacks(params) {
+  const {
+    stop
+  } = params;
+  const onReplyStart = async () => {
+    try {
+      await params.start();
+    } catch (err) {
+      params.onStartError(err);
+    }
+  };
+  const fireStop = stop ? () => {
+    void stop().catch(err => (params.onStopError ?? params.onStartError)(err));
+  } : undefined;
+  return {
+    onReplyStart,
+    onIdle: fireStop,
+    onCleanup: fireStop
+  };
+}
+const TYPING_SUBSCRIPTION_TOPIC = 'TYPING_INDICATOR';export{DEFAULT_TYPING_PROPS,TYPING_SUBSCRIPTION_TOPIC,createTypingCallbacks};//# sourceMappingURL=typing.js.map

package/lib/channels/typing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.js","sources":["../../src/channels/typing.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;AAMG;AAiBI,MAAM,oBAAoB,GAAiB;AAC9C,EAAA,oBAAA,EAAoB,IAAE;AACtB,EAAA,eAAA,EAAe,IAAE;AACjB,EAAA,gBAAA,EAAgB,GAAE;AAClB,EAAA,eAAA,EAAe;;AAoCnB;;AAEG;AACG,SAAU,qBAAqB,CAAC,MAKrC,EAAA;AACG,EAAA,MAAA;AAEA,IAAA;AACI,GAAA,GAAA,MAAI;AACA,EAAA,MAAA,YAAM,GAAA,YAAe;QACzB;YAAE,MAAU,MAAG,EAAA;AACX,IAAA,CAAA,CAAA,OAAA,GAAA,EAAM;YACT,CAAA,YAAA,CAAA,GAAA,CAAA;AACL,IAAA;;QAGI,QAAO,GAAA,IAAA,GAAA,MAAA;aACD,EAAA,CAAA,KAAS,IAAG,IAAK,CAAC,MAAM,CAAA,WAAW,IAAA,MAAW,CAAA,YAAW,EAAA,GAAA,CAAA,CAAA;eAC5D;SACF;IAEL,YAAS;AACb,IAAC,MAAA,EAAA,QAAA;AAmBD,IAAA,SAAa,EAAA;;;"}

package/lib/channels/typing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/constants/default-channel-props.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Combined default settings for all channel features.
+ * Applied to Channel.settings on creation.
+ */
+export declare const DEFAULT_CHANNEL_SETTINGS: Record<string, unknown>;
+export type DefaultChannelSettings = typeof DEFAULT_CHANNEL_SETTINGS;
+/**
+ * Backward-compatible alias.
+ * @deprecated Use DEFAULT_CHANNEL_SETTINGS instead.
+ */
+export declare const DEFAULT_CHANNEL_PROPS: Record<string, unknown>;

package/lib/constants/default-channel-props.js

@@ -0,0 +1,32 @@
+import'../preferences/settings/post-settings.js';import {ChannelSettings}from'../preferences/settings/channel-settings.js';import'../preferences/settings/messenger-channels-contribution.js';import'../preferences/settings/chat-settings.js';import'../preferences/permissions/inbox-permission-contribution.js';import'../preferences/permissions/inbox-roles-permission-overwrite.js';/**
+ * Default Settings for channel features.
+ *
+ * Derives default values from the ChannelSettings preference schemas.
+ * These are used to populate Channel.settings on creation.
+ * Follows the same pattern as DEFAULT_NOTIFY_PROPS but covers all
+ * openclaw-inspired feature settings.
+ */
+/**
+ * Builds a settings object from the ChannelSettings schema defaults,
+ * using short keys (e.g. "capabilities", "typing") rather than the
+ * full dotted preference path.
+ */
+function buildDefaultSettings() {
+  const settings = {};
+  for (const [fullKey, schema] of Object.entries(ChannelSettings)) {
+    // Extract the short key after the last dot
+    const shortKey = fullKey.split('.').pop();
+    settings[shortKey] = schema.default;
+  }
+  return settings;
+}
+/**
+ * Combined default settings for all channel features.
+ * Applied to Channel.settings on creation.
+ */
+const DEFAULT_CHANNEL_SETTINGS = buildDefaultSettings();
+/**
+ * Backward-compatible alias.
+ * @deprecated Use DEFAULT_CHANNEL_SETTINGS instead.
+ */
+const DEFAULT_CHANNEL_PROPS = DEFAULT_CHANNEL_SETTINGS;export{DEFAULT_CHANNEL_PROPS,DEFAULT_CHANNEL_SETTINGS};//# sourceMappingURL=default-channel-props.js.map

package/lib/constants/default-channel-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-channel-props.js","sources":["../../src/constants/default-channel-props.ts"],"sourcesContent":[null],"names":[],"mappings":"0XAAA;;;;;;;AAOG;AAGH;;;;AAIG;AACH,SAAS,oBAAoB,GAAA;QACzB,QAAM,GAAQ,EAA4B;AAC1C,EAAA,KAAA,MAAK,CAAA,OAAO,EAAO,WAAS,MAAI,CAAA,OAAO,CAAA,eAAQ,CAAA,EAAgB;;UAE3D,QAAM,GAAA,OAAW,CAAA,KAAQ,CAAA,GAAK,CAAC,CAAA,GAAI,EAAC;AACpC,IAAA,QAAA,CAAA,QAAS,CAAA,GAAQ,MAAI,CAAA;;AAEzB,EAAA,OAAA;AACJ;AAEA;;;AAGG;AACI,MAAM,wBAAwB,GAAG,oBAAoB;AAI5D;;;AAGG;AACI,MAAM,qBAAqB,GAAG"}

package/lib/constants/index.d.ts

@@ -1,2 +1,3 @@
 export * from './query.constants';
 export * from './default-notify-props';
+export * from './default-channel-props';

package/lib/containers/containers.js

@@ -1,4 +1,4 @@
-import {ContainerModule}from'inversify';import {ChannelService}from'../services/channel-service.js';import {PostService}from'../services/post-service.js';import {PostThreadService}from'../services/post-thread-service.js';import {ReactionService}from'../services/reaction-service.js';import {MessengerNotificationService}from'../services/messenger-notification-service.js';import {ExtendedTokenAccountService}from'../services/extended-token-account-service.js';import {SERVER_TYPES}from'common/server';import {ChannelRepository}from'../store/repositories/channel-repository.js';import {PostRepository}from'../store/repositories/post-repository.js';import {PostThreadRepository}from'../store/repositories/post-thread-repository.js';import {ReactionRepository}from'../store/repositories/reaction-repository.js';import {MessageNotificationTemplateMigration}from'../migrations/message-notification-template-migration.js';import'../migrations/mail-template-migration.js';import {AddPostsConfigurationsMigration}from'../migrations/dbMigrations/AddPostsConfigurationsMigration.js';import {ChannelProxyService}from'../services/proxy-services/ChannelProxyService.js';import {ExtendedTokenAccountProxyService}from'../services/proxy-services/ExtendedTokenAccountProxyService.js';import {PostProxyService}from'../services/proxy-services/PostProxyService.js';import {PostThreadProxyService}from'../services/proxy-services/PostThreadProxyService.js';import {ReactionProxyService}from'../services/proxy-services/ReactionProxyService.js';import {MessengerNotificationProxyService}from'../services/proxy-services/MessengerNotificationProxyService.js';/**
+import {ContainerModule}from'inversify';import {ChannelService}from'../services/channel-service.js';import {PostService}from'../services/post-service.js';import {PostThreadService}from'../services/post-thread-service.js';import {ReactionService}from'../services/reaction-service.js';import {MessengerNotificationService}from'../services/messenger-notification-service.js';import {ExtendedTokenAccountService}from'../services/extended-token-account-service.js';import {SERVER_TYPES}from'common/server';import {MessengerStreamService}from'../streaming/stream-service.js';import {ChannelRepository}from'../store/repositories/channel-repository.js';import {PostRepository}from'../store/repositories/post-repository.js';import {PostThreadRepository}from'../store/repositories/post-thread-repository.js';import {ReactionRepository}from'../store/repositories/reaction-repository.js';import {MessageNotificationTemplateMigration}from'../migrations/message-notification-template-migration.js';import'../migrations/mail-template-migration.js';import {AddPostsConfigurationsMigration}from'../migrations/dbMigrations/AddPostsConfigurationsMigration.js';import {AddChannelConfigurationsMigration}from'../migrations/dbMigrations/AddChannelConfigurationsMigration.js';import {AddChatConfigurationsMigration}from'../migrations/dbMigrations/AddChatConfigurationsMigration.js';import {ChannelProxyService}from'../services/proxy-services/ChannelProxyService.js';import {ExtendedTokenAccountProxyService}from'../services/proxy-services/ExtendedTokenAccountProxyService.js';import {PostProxyService}from'../services/proxy-services/PostProxyService.js';import {PostThreadProxyService}from'../services/proxy-services/PostThreadProxyService.js';import {ReactionProxyService}from'../services/proxy-services/ReactionProxyService.js';import {MessengerNotificationProxyService}from'../services/proxy-services/MessengerNotificationProxyService.js';/**
  * Local services and exposed microservices to serve remote connections.
  * Operates within in the Gateway.
  *
@@ -8,12 +8,15 @@ const proxyServiceContainerModule = settings => new ContainerModule(bind => {
   bind('MongodbMigration').to(MessageNotificationTemplateMigration).whenTargetNamed(MessageNotificationTemplateMigration.name);
   // add Db migrations
   bind('MongodbMigration').to(AddPostsConfigurationsMigration).whenTargetNamed(AddPostsConfigurationsMigration.name);
+  bind('MongodbMigration').to(AddChannelConfigurationsMigration).whenTargetNamed(AddChannelConfigurationsMigration.name);
+  bind('MongodbMigration').to(AddChatConfigurationsMigration).whenTargetNamed(AddChatConfigurationsMigration.name);
   bind(SERVER_TYPES.ExtendedTokenAccountService).to(ExtendedTokenAccountProxyService).inSingletonScope().whenTargetIsDefault();
   bind(SERVER_TYPES.ChannelService).to(ChannelProxyService).inSingletonScope().whenTargetIsDefault();
   bind(SERVER_TYPES.PostService).to(PostProxyService).inSingletonScope().whenTargetIsDefault();
   bind(SERVER_TYPES.PostThreadService).to(PostThreadProxyService).inSingletonScope().whenTargetIsDefault();
   bind(SERVER_TYPES.ReactionService).to(ReactionProxyService).inSingletonScope().whenTargetIsDefault();
   bind(SERVER_TYPES.MessengerNotificationService).to(MessengerNotificationProxyService).inSingletonScope();
+  bind(SERVER_TYPES.MessengerStreamService).to(MessengerStreamService).inSingletonScope().whenTargetIsDefault();
 });
 /**
  * Operates external to the Gateway. Usually a broker listen to calls and invoke this service
@@ -32,4 +35,5 @@ const serviceContainerModule = settings => new ContainerModule(bind => {
   bind(SERVER_TYPES.PostThreadService).to(PostThreadService).inSingletonScope().whenTargetIsDefault();
   bind(SERVER_TYPES.ReactionService).to(ReactionService).inSingletonScope().whenTargetIsDefault();
   bind(SERVER_TYPES.MessengerNotificationService).to(MessengerNotificationService).inSingletonScope().whenTargetIsDefault();
+  bind(SERVER_TYPES.MessengerStreamService).to(MessengerStreamService).inSingletonScope().whenTargetIsDefault();
 });export{proxyServiceContainerModule,serviceContainerModule};//# sourceMappingURL=containers.js.map

package/lib/containers/containers.js.map

@@ -1 +1 @@
-{"version":3,"file":"containers.js","sources":["../../src/containers/containers.ts"],"sourcesContent":[null],"names":[],"mappings":"imDAgCA;;;;;AAKG;AACI,MAAM,2BAA2B,GAA6C,QAAC,IAAU,mBACxF,CAAA,IAAiB;MACjB,CAAA,oBAAuB,EAAC,CAAA,oCAAA,CAAA,CAAA,eAAA,CAAA,oCAAA,CAAA,IAAA,CAAA;;AAEnB,EAAA,IAAA,CAAA,kBAAgB,CAAA,CAAA,EAAA,CAAA,+BAAoC,CAAC,CAAA,eAAM,CAAA,+BAAA,CAAA,IAAA,CAAA;MAChE,CAAA,YAAA,CAAA,2BAAoB,CAAA,CAAA,EAAA,CAAA,gCAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;MACpB,CAAA,2BAAwB,CAAA,CAAA,EAAA,CAAA,mBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;oDACgB,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AACnC,EAAA,IAAA,CAAA,YAAA,CAAA,iBAAgB,CAAA,CAAA,EAAA,CAAA,sBAAsC,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAC3D,EAAA,IAAA,CAAA,YAAK,CAAA,eAAa,CAAA,CAAA,EAAA,CAAA,oBAA4B,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;gDACL,CAAA,CAAA,EAAA,CAAA,iCAAA,CAAA,CAAA,gBAAA,EAAA;AACpC,CAAA;AACA;AAEL;;AAEK;AACA;AAEL;AACQ,4BAAwB,GAAA,QAAA,IAAA,IAAA,eAAA,CAAA,IAAA,IAAA;AAC3B,EAAA,IAAA,CAAA,YAAA,CAAA,2BAAkB,CAAA,CAAA,EAAA,CAAA,2BAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAClB,EAAA,IAAA,CAAA,YAAA,CAAA,iBAAsB,CAAA,CAAA,EAAA,CAAA,iBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAE3B,EAAA,IAAA,CAAA,YAAyB,CAAA,cAAa,CAAA,CAAA,EAAA,CAAiB,cAAC,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;wCAClB,CAAA,CAAA,EAAA,CAAA,oBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AACjC,EAAA,IAAA,CAAA,YAAA,CAAA,kBAAkB,CAAA,CAAA,EAAA,CAAA,kBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAClB,EAAA,IAAA,CAAA,YAAA,CAAA,cAAsB,CAAA,CAAA,EAAA,CAAA,cAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAE3B,EAAA,IAAA,CAAA,YAAuB,CAAA,WAAa,CAAA,CAAA,EAAA,CAAA,WAAgB,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;qCAChB,CAAA,CAAA,EAAA,CAAA,iBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAC/B,EAAA,IAAA,CAAA,YAAA,CAAA,eAAkB,CAAA,CAAA,EAAA,CAAA,eAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAClB,EAAA,IAAA,CAAA,YAAA,CAAA,4BAAsB,CAAA,CAAA,EAAA,CAAA,4BAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAE3B,CAAA"}
+{"version":3,"file":"containers.js","sources":["../../src/containers/containers.ts"],"sourcesContent":[null],"names":[],"mappings":"+3DAuCA;;;;;AAKG;AACI,MAAM,2BAA2B,GAA6C,QAAC,IAAU,mBACxF,CAAA,IAAiB;MACjB,CAAA,oBAAuB,EAAC,CAAA,oCAAA,CAAA,CAAA,eAAA,CAAA,oCAAA,CAAA,IAAA,CAAA;;AAEnB,EAAA,IAAA,CAAA,kBAAgB,CAAA,CAAA,EAAA,CAAA,+BAAoC,CAAC,CAAA,eAAM,CAAA,+BAAA,CAAA,IAAA,CAAA;MAChE,CAAA,kBAAoB,CAAA,CAAA,EAAA,CAAA,iCAAA,CAAA,CAAA,eAAA,CAAA,iCAAA,CAAA,IAAA,CAAA;MACpB,CAAA,oBAAuB,EAAC,CAAA,8BAAA,CAAA,CAAA,eAAA,CAAA,8BAAA,CAAA,IAAA,CAAA;+CACgB,CAAA,CAAA,EAAA,CAAA,gCAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AACnC,EAAA,IAAA,CAAA,YAAA,CAAA,cAAgB,CAAA,CAAA,EAAA,CAAA,mBAAgC,CAAA,CAAA,gBAAM,EAAA,CAAA,mBAAA,EAAA;MAC3D,CAAA,wBAAwB,CAAA,CAAA,EAAA,CAAA,gBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;gEACkB,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AACrC,EAAA,IAAA,CAAA,YAAA,CAAA,eAAgB,CAAA,CAAA,EAAA,CAAA,oBAAkC,CAAA,CAAA,gBAAM,EAAA,CAAA,mBAAA,EAAA;MAC7D,CAAA,yCAAwB,CAAA,CAAA,EAAA,CAAA,iCAAA,CAAA,CAAA,gBAAA,EAAA;0CACc,CAAC,CAAA,EAAA,CAAA,sBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAClC,CAAA;AACL;;AAEK;AACA;AAEL;;AAEK,MAAA,sBAAkB,GAAA,QAAA,IAAA,IAAA,eAAA,CAAA,IAAA,IAAA;AAClB,EAAA,IAAA,CAAA,YAAA,CAAA,2BAAsB,CAAA,CAAA,EAAA,CAAA,2BAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAE3B,EAAA,IAAA,CAAA,YAAmB,CAAA,iBAAyB,CAAA,CAAA,EAAA,CAAA,iBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;kCACZ,CAAA,CAAA,EAAA,CAAA,cAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAC3B,EAAA,IAAA,CAAA,YAAA,CAAA,oBAAkB,CAAA,CAAA,EAAA,CAAA,oBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAClB,EAAA,IAAA,CAAA,YAAA,CAAA,kBAAsB,CAAA,CAAA,EAAA,CAAA,kBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAE3B,EAAA,IAAA,CAAA,YAAyB,CAAA,cAAa,CAAA,CAAA,EAAA,CAAiB,cAAC,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;mCAClB,CAAA,WAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AACjC,EAAA,IAAA,CAAA,YAAA,CAAA,iBAAkB,CAAA,CAAA,EAAA,CAAA,iBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAClB,EAAA,IAAA,CAAA,YAAA,CAAA,eAAsB,CAAA,CAAA,EAAA,CAAA,eAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAE3B,EAAA,IAAA,CAAA,YAAuB,CAAA,4BAA6B,CAAA,CAAA,EAAA,CAAA,4BAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;0CAChB,CAAA,CAAA,EAAA,CAAA,sBAAA,CAAA,CAAA,gBAAA,EAAA,CAAA,mBAAA,EAAA;AAC/B,CAAA"}

package/lib/containers/context-services-from-container.js

@@ -1,12 +1,12 @@
-import {SERVER_TYPES}from'common/server';// import { ExtendedTokenAccountService } from '../services';
-const contextServicesFromContainer = container => {
+import {SERVER_TYPES}from'common/server';const contextServicesFromContainer = container => {
   const services = {
     extendedTokenAccountService: container.get(SERVER_TYPES.ExtendedTokenAccountService),
     channelService: container.get(SERVER_TYPES.ChannelService),
     postService: container.get(SERVER_TYPES.PostService),
     postThreadService: container.get(SERVER_TYPES.PostThreadService),
     reactionService: container.get(SERVER_TYPES.ReactionService),
-    messengerNotificationService: container.get(SERVER_TYPES.MessengerNotificationService)
+    messengerNotificationService: container.get(SERVER_TYPES.MessengerNotificationService),
+    messengerStreamService: container.get(SERVER_TYPES.MessengerStreamService)
   };
   return services;
 };export{contextServicesFromContainer};//# sourceMappingURL=context-services-from-container.js.map

package/lib/containers/context-services-from-container.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-services-from-container.js","sources":["../../src/containers/context-services-from-container.ts"],"sourcesContent":[null],"names":[],"mappings":"yCAaA;AAEO,MAAM,4BAA4B,GAAG,SAAC,IAAyD;AAClG,EAAA,MAAA,WAAc;+BACV,EAAA,aAAsC,CAAC,YACnC,CAAA;kBAEJ,EAAA,aAAyB,CAAC,YAAqB,CAAA;eAC/C,EAAA,aAAsB,CAAC,YAAkB,CAAA;qBACzC,EAAA,aAA4B,CAAC,YAAwB,CAAA;mBACrD,EAAA,aAA0B,CAAC,YAAsB,CAAA;gCACjD,EAAA,aAAuC,CAAC,YACpC,CAAA;;AAGR,EAAA,OAAA;AACJ"}
+{"version":3,"file":"context-services-from-container.js","sources":["../../src/containers/context-services-from-container.ts"],"sourcesContent":[null],"names":[],"mappings":"yCAcO,MAAM,4BAA4B,GAAG,SAAC,IAAyD;AAClG,EAAA,MAAA,WAAc;+BACV,EAAA,aAAsC,CAAC,YACnC,CAAA;kBAEJ,EAAA,aAAyB,CAAC,YAAqB,CAAA;eAC/C,EAAA,aAAsB,CAAC,YAAkB,CAAA;qBACzC,EAAA,aAA4B,CAAC,YAAwB,CAAA;mBACrD,EAAA,aAA0B,CAAC,YAAsB,CAAA;gCACjD,EAAA,aAAuC,CAAC,YACpC,CAAA;0BAEJ,EAAA,aAAiC,CAAC,YAA6B,CAAA;;AAEnE,EAAA,OAAA;AACJ"}

package/lib/gateway/channel-registry.d.ts

@@ -0,0 +1,10 @@
+import type { IExternalChannelProvider, IExternalChannelRegistry, IChannelProviderConfig } from './types';
+export declare class ExternalChannelRegistry implements IExternalChannelRegistry {
+    private providers;
+    register(provider: IExternalChannelProvider): void;
+    unregister(providerType: string): void;
+    get(providerType: string): IExternalChannelProvider | undefined;
+    listTypes(): string[];
+    listProviders(): IChannelProviderConfig[];
+    has(providerType: string): boolean;
+}

package/lib/gateway/gateway-service.d.ts

@@ -0,0 +1,23 @@
+import type { CdmLogger } from '@cdm-logger/core';
+import type { IGatewayService, IExternalChannelRegistry, IMessageRouterService, IInboundMessage, IOutboundMessage, ISendResult, IGatewayChannelStatus } from './types';
+type InboundHandler = (message: IInboundMessage) => void;
+export declare class GatewayService implements IGatewayService {
+    private logger;
+    private registry;
+    private router;
+    private inboundHandlers;
+    private initialized;
+    constructor(registry: IExternalChannelRegistry, router: IMessageRouterService, logger?: CdmLogger.ILogger);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    getRegistry(): IExternalChannelRegistry;
+    connectChannel(channelType: string, accountId: string, options: Record<string, unknown>): Promise<void>;
+    disconnectChannel(channelType: string, accountId: string): Promise<void>;
+    sendMessage(message: IOutboundMessage): Promise<ISendResult>;
+    getStatus(): IGatewayChannelStatus[];
+    getChannelStatus(channelType: string): IGatewayChannelStatus[];
+    onInboundMessage(handler: InboundHandler): void;
+    /** Forward inbound message to all registered handlers and the router */
+    private handleInbound;
+}
+export {};

package/lib/gateway/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export { ExternalChannelRegistry } from './channel-registry';
+export { MessageRouterService } from './message-router';
+export { GatewayService } from './gateway-service';

package/lib/gateway/message-router.d.ts

@@ -0,0 +1,20 @@
+import type { CdmLogger } from '@cdm-logger/core';
+import type { IInboundMessage, IOutboundMessage, ISendResult, IMessageRouterService, IExternalChannelRegistry } from './types';
+export declare class MessageRouterService implements IMessageRouterService {
+    private logger;
+    private registry;
+    constructor(registry: IExternalChannelRegistry, logger?: CdmLogger.ILogger);
+    /**
+     * Route an inbound message from an external channel provider to the platform.
+     *
+     * This is where external messages get translated into platform Posts.
+     * In Go: similar to picoclaw's `pkg/channels/handler.go` HandleInbound.
+     */
+    routeInbound(message: IInboundMessage): Promise<void>;
+    /**
+     * Route an outbound message from the platform to the correct external channel provider.
+     *
+     * Looks up the provider by channelType in the registry and delegates the send.
+     */
+    routeOutbound(message: IOutboundMessage): Promise<ISendResult>;
+}

package/lib/gateway/types.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Gateway Types — External messaging channel provider interfaces.
+ *
+ * Designed Go-portable: no Inversify decorators, no Mongoose, no Moleculer.
+ * Every interface maps 1:1 to a Go interface. Uses plain constructors,
+ * explicit error returns, and typed queues (via EventEmitter or NATS topics).
+ *
+ * Architecture mapping:
+ *   openclaw  → ChannelProvider / ChannelAccountManager → this file
+ *   picoclaw  → pkg/channels/channel.go                → this file
+ *   clockbook → BOT_TYPES.IChannelRegistry              → this file
+ *
+ * Channel extensions register providers via `contributes.channels` in their
+ * package.json and call `channels.registerProvider()` during activation.
+ */
+import type { IChannelCapabilities, IChannelDock, IChannelAccountSnapshot, IChannelStatusIssue } from '../channels/types';
+/** Provider lifecycle state */
+export type ProviderState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error';
+/** Direction of a message relative to the gateway */
+export type MessageDirection = 'inbound' | 'outbound';
+/** Media attachment type */
+export type MediaType = 'image' | 'audio' | 'video' | 'document' | 'sticker' | 'location' | 'contact';
+export interface IMediaAttachment {
+    type: MediaType;
+    url?: string;
+    /** Raw bytes (base64 in JSON, []byte in Go) */
+    data?: string;
+    mimeType?: string;
+    filename?: string;
+    caption?: string;
+    /** Duration in seconds (audio/video) */
+    durationSec?: number;
+    /** Thumbnail URL or base64 */
+    thumbnail?: string;
+}
+/** An inbound message from an external channel into the gateway */
+export interface IInboundMessage {
+    /** Unique message ID from the external platform */
+    externalId: string;
+    /** Channel provider identifier (e.g. 'whatsapp', 'telegram') */
+    channelType: string;
+    /** Account ID within the channel provider */
+    accountId: string;
+    /** Sender identifier on the external platform */
+    senderId: string;
+    /** Sender display name */
+    senderName?: string;
+    /** Chat/conversation identifier on the external platform */
+    chatId: string;
+    /** Chat type */
+    chatType?: 'direct' | 'group' | 'channel';
+    /** Text content */
+    text?: string;
+    /** Media attachments */
+    media?: IMediaAttachment[];
+    /** Whether this is a reply to another message */
+    replyToExternalId?: string;
+    /** Unix timestamp in ms */
+    timestamp: number;
+    /** Raw payload from the external platform (for debugging/passthrough) */
+    raw?: Record<string, unknown>;
+}
+/** An outbound message from the gateway to an external channel */
+export interface IOutboundMessage {
+    /** Channel provider identifier */
+    channelType: string;
+    /** Account ID within the channel provider */
+    accountId: string;
+    /** Target chat/conversation identifier */
+    chatId: string;
+    /** Text content */
+    text?: string;
+    /** Media attachments */
+    media?: IMediaAttachment[];
+    /** Reply to a specific external message ID */
+    replyToExternalId?: string;
+    /** Arbitrary metadata */
+    metadata?: Record<string, unknown>;
+}
+/** Result of sending an outbound message */
+export interface ISendResult {
+    success: boolean;
+    /** External message ID assigned by the platform */
+    externalId?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Timestamp of delivery (Unix ms) */
+    timestamp?: number;
+}
+/** Configuration schema for a channel provider (declared in contributes.channels) */
+export interface IChannelProviderConfig {
+    /** Unique provider type identifier (e.g. 'whatsapp', 'telegram') */
+    type: string;
+    /** Human-readable label */
+    label: string;
+    /** Provider description */
+    description?: string;
+    /** Icon name or URL */
+    icon?: string;
+    /** Provider capabilities */
+    capabilities: IChannelCapabilities;
+    /** Dock (outbound constraints, streaming, threading config) */
+    dock?: Partial<IChannelDock>;
+    /** JSON Schema for provider-specific configuration (API keys, tokens, etc.) */
+    configSchema?: Record<string, unknown>;
+}
+/**
+ * IExternalChannelProvider — the interface that channel extensions implement.
+ *
+ * Each extension contributes one provider. The gateway discovers providers
+ * via `contributes.channels` in the extension manifest and calls
+ * `channels.registerProvider(provider)` during extension activation.
+ *
+ * Go mapping:
+ *   type ChannelProvider interface {
+ *       Type() string
+ *       Connect(ctx context.Context, accountId string, config map[string]any) error
+ *       Disconnect(ctx context.Context, accountId string) error
+ *       Send(ctx context.Context, msg OutboundMessage) (SendResult, error)
+ *       State(accountId string) ProviderState
+ *       OnMessage(handler func(InboundMessage))
+ *   }
+ */
+export interface IExternalChannelProvider {
+    /** Provider type identifier (e.g. 'whatsapp') */
+    readonly type: string;
+    /** Provider configuration */
+    readonly config: IChannelProviderConfig;
+    /**
+     * Connect an account to the external platform.
+     * @param accountId - Unique account identifier
+     * @param options - Provider-specific connection options (API keys, session data, etc.)
+     * @param signal - AbortSignal for cancellation (Go: context.Context)
+     */
+    connect(accountId: string, options: Record<string, unknown>, signal?: AbortSignal): Promise<void>;
+    /**
+     * Disconnect an account from the external platform.
+     * @param accountId - Account to disconnect
+     */
+    disconnect(accountId: string): Promise<void>;
+    /**
+     * Send a message to the external platform.
+     * @param message - Outbound message to send
+     * @returns Send result with external ID on success
+     */
+    send(message: IOutboundMessage): Promise<ISendResult>;
+    /**
+     * Get the current connection state for an account.
+     * @param accountId - Account identifier
+     */
+    getState(accountId: string): ProviderState;
+    /**
+     * Get a snapshot of account status (connection info, last message times, etc.)
+     * @param accountId - Account identifier
+     */
+    getAccountSnapshot(accountId: string): IChannelAccountSnapshot | undefined;
+    /**
+     * Get any status issues (config problems, auth failures, etc.)
+     * @param accountId - Account identifier
+     */
+    getStatusIssues(accountId: string): IChannelStatusIssue[];
+    /**
+     * Register a handler for inbound messages.
+     * The gateway calls this once during provider registration.
+     * @param handler - Callback invoked for each inbound message
+     */
+    onMessage(handler: (message: IInboundMessage) => void): void;
+    /**
+     * Register a handler for provider state changes.
+     * @param handler - Callback invoked when connection state changes
+     */
+    onStateChange?(handler: (accountId: string, state: ProviderState) => void): void;
+    /**
+     * Dispose all resources. Called when the extension is deactivated.
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * IExternalChannelRegistry — tracks all registered external channel providers.
+ *
+ * Providers register themselves via extension activation; the gateway looks
+ * them up by type when routing messages.
+ *
+ * Go mapping:
+ *   type ChannelRegistry struct { providers map[string]ChannelProvider }
+ */
+export interface IExternalChannelRegistry {
+    /** Register a channel provider (called during extension activation) */
+    register(provider: IExternalChannelProvider): void;
+    /** Unregister a channel provider (called during extension deactivation) */
+    unregister(providerType: string): void;
+    /** Get a provider by type */
+    get(providerType: string): IExternalChannelProvider | undefined;
+    /** List all registered provider types */
+    listTypes(): string[];
+    /** List all providers with their configs */
+    listProviders(): IChannelProviderConfig[];
+    /** Check if a provider type is registered */
+    has(providerType: string): boolean;
+}
+/** Gateway status for a single provider/account pair */
+export interface IGatewayChannelStatus {
+    channelType: string;
+    accountId: string;
+    state: ProviderState;
+    label: string;
+    snapshot?: IChannelAccountSnapshot;
+    issues: IChannelStatusIssue[];
+}
+/**
+ * IGatewayService — the top-level gateway orchestrator.
+ *
+ * Owns the channel registry, routes inbound messages to the platform,
+ * and dispatches outbound messages to the correct provider.
+ *
+ * Go mapping:
+ *   type GatewayService struct {
+ *       registry  *ChannelRegistry
+ *       router    *MessageRouter
+ *       eventBus  *nats.Conn
+ *   }
+ */
+export interface IGatewayService {
+    /** Initialize the gateway (called once at startup) */
+    initialize(): Promise<void>;
+    /** Shut down the gateway gracefully */
+    shutdown(): Promise<void>;
+    /** Get the channel registry */
+    getRegistry(): IExternalChannelRegistry;
+    /** Connect an account on a specific channel */
+    connectChannel(channelType: string, accountId: string, options: Record<string, unknown>): Promise<void>;
+    /** Disconnect an account on a specific channel */
+    disconnectChannel(channelType: string, accountId: string): Promise<void>;
+    /** Send an outbound message via the appropriate provider */
+    sendMessage(message: IOutboundMessage): Promise<ISendResult>;
+    /** Get status for all connected channels/accounts */
+    getStatus(): IGatewayChannelStatus[];
+    /** Get status for a specific channel type */
+    getChannelStatus(channelType: string): IGatewayChannelStatus[];
+    /**
+     * Register a handler for inbound messages (gateway → platform).
+     * The resolver/microservice uses this to feed messages into the platform.
+     */
+    onInboundMessage(handler: (message: IInboundMessage) => void): void;
+}
+/**
+ * IMessageRouterService — routes inbound messages to the messenger platform.
+ *
+ * Sits between external channel providers and the platform's channel/post
+ * services. Translates IInboundMessage into platform Post creation.
+ *
+ * Go mapping:
+ *   type MessageRouter struct { channelSvc ChannelService; postSvc PostService }
+ */
+export interface IMessageRouterService {
+    /** Route an inbound message to the platform */
+    routeInbound(message: IInboundMessage): Promise<void>;
+    /** Route an outbound message from the platform to the external channel */
+    routeOutbound(message: IOutboundMessage): Promise<ISendResult>;
+}
+/** Topic for gateway inbound messages */
+export declare const GATEWAY_INBOUND_TOPIC = "GATEWAY_INBOUND";
+/** Topic for gateway outbound messages */
+export declare const GATEWAY_OUTBOUND_TOPIC = "GATEWAY_OUTBOUND";
+/** Topic for gateway channel status changes */
+export declare const GATEWAY_STATUS_TOPIC = "GATEWAY_STATUS";
+/** Build a scoped topic for a specific channel type */
+export declare function gatewayInboundTopic(channelType: string): string;
+export declare function gatewayOutboundTopic(channelType: string): string;
+export declare function gatewayStatusTopic(channelType: string): string;

package/lib/graphql/resolvers/channel-capabilities.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Channel Capabilities Resolver
+ *
+ * Handles GraphQL queries, mutations, and subscriptions for
+ * the openclaw-inspired channel capabilities system.
+ *
+ * All channel feature configuration lives in Channel.settings
+ * (schema driven by ChannelSettings preferences). The resolver
+ * reads/writes through that single field.
+ */
+import { IResolverOptions } from '@common-stack/server-core';
+import { IResolvers } from 'common/server';
+export declare const channelCapabilitiesResolvers: (options: IResolverOptions) => IResolvers;