@objectstack/service-realtime 4.0.1 → 4.0.3

package/.turbo/turbo-build.log

@@ -1,22 +1,22 @@
 
-> @objectstack/service-realtime@4.0.1 build /home/runner/work/spec/spec/packages/services/service-realtime
+> @objectstack/service-realtime@4.0.3 build /home/runner/work/framework/framework/packages/services/service-realtime
 > tsup --config ../../../tsup.config.ts
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/spec/spec/tsup.config.ts
+CLI Using tsup config: /home/runner/work/framework/framework/tsup.config.ts
 CLI Target: es2020
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs     6.61 KB
-CJS dist/index.cjs.map 13.86 KB
-CJS ⚡️ Build success in 99ms
-ESM dist/index.js     5.36 KB
-ESM dist/index.js.map 13.34 KB
-ESM ⚡️ Build success in 105ms
+CJS dist/index.cjs     6.64 KB
+CJS dist/index.cjs.map 13.93 KB
+CJS ⚡️ Build success in 71ms
+ESM dist/index.js     5.40 KB
+ESM dist/index.js.map 13.42 KB
+ESM ⚡️ Build success in 75ms
 DTS Build start
-DTS ⚡️ Build success in 20324ms
-DTS dist/index.d.ts  100.40 KB
-DTS dist/index.d.cts 100.40 KB
+DTS ⚡️ Build success in 16178ms
+DTS dist/index.d.ts  99.42 KB
+DTS dist/index.d.cts 99.42 KB

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @objectstack/service-realtime
 
+## 4.0.3
+
+### Patch Changes
+
+- @objectstack/spec@4.0.3
+- @objectstack/core@4.0.3
+
+## 4.0.2
+
+### Patch Changes
+
+- Updated dependencies [5f659e9]
+  - @objectstack/spec@4.0.2
+  - @objectstack/core@4.0.2
+
 ## 4.0.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -201,12 +201,13 @@ var RealtimeServicePlugin = class {
     this.name = "com.objectstack.service.realtime";
     this.version = "1.0.0";
     this.type = "standard";
+    this.dependencies = ["com.objectstack.engine.objectql"];
     this.options = { adapter: "memory", ...options };
   }
   async init(ctx) {
     const realtime = new InMemoryRealtimeAdapter(this.options.memory);
     ctx.registerService("realtime", realtime);
-    ctx.registerService("app.com.objectstack.service.realtime", {
+    ctx.getService("manifest").register({
       id: "com.objectstack.service.realtime",
       name: "Realtime Service",
       version: "1.0.0",

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/in-memory-realtime-adapter.ts","../src/objects/sys-presence.object.ts","../src/realtime-service-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { RealtimeServicePlugin } from './realtime-service-plugin.js';\nexport type { RealtimeServicePluginOptions } from './realtime-service-plugin.js';\nexport { InMemoryRealtimeAdapter } from './in-memory-realtime-adapter.js';\nexport type { InMemoryRealtimeAdapterOptions } from './in-memory-realtime-adapter.js';\nexport { SysPresence } from './objects/index.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n  IRealtimeService,\n  RealtimeEventPayload,\n  RealtimeEventHandler,\n  RealtimeSubscriptionOptions,\n} from '@objectstack/spec/contracts';\n\n/**\n * Internal subscription entry.\n */\ninterface Subscription {\n  id: string;\n  channel: string;\n  handler: RealtimeEventHandler;\n  options?: RealtimeSubscriptionOptions;\n}\n\n/**\n * Configuration options for InMemoryRealtimeAdapter.\n */\nexport interface InMemoryRealtimeAdapterOptions {\n  /** Maximum number of subscriptions allowed (0 = unlimited) */\n  maxSubscriptions?: number;\n}\n\n/**\n * In-memory pub/sub adapter implementing IRealtimeService.\n *\n * Uses a Map-backed subscription store with channel-based routing.\n * Supports event type and object filtering via subscription options.\n *\n * Suitable for single-process environments, development, and testing.\n * For production multi-instance deployments, use a Redis-backed adapter.\n *\n * @example\n * ```ts\n * const realtime = new InMemoryRealtimeAdapter();\n *\n * const subId = await realtime.subscribe('records', (event) => {\n *   console.log('Received:', event.type, event.payload);\n * }, { object: 'account', eventTypes: ['record.created'] });\n *\n * await realtime.publish({\n *   type: 'record.created',\n *   object: 'account',\n *   payload: { id: 'acc-1', name: 'Acme' },\n *   timestamp: new Date().toISOString(),\n * });\n *\n * await realtime.unsubscribe(subId);\n * ```\n */\nexport class InMemoryRealtimeAdapter implements IRealtimeService {\n  private readonly subscriptions = new Map<string, Subscription>();\n  private readonly channelIndex = new Map<string, Set<string>>();\n  private counter = 0;\n  private readonly maxSubscriptions: number;\n\n  constructor(options: InMemoryRealtimeAdapterOptions = {}) {\n    this.maxSubscriptions = options.maxSubscriptions ?? 0;\n  }\n\n  async publish(event: RealtimeEventPayload): Promise<void> {\n    // Deliver to all channel subscriptions that match filters\n    for (const sub of this.subscriptions.values()) {\n      if (this.matchesSubscription(event, sub)) {\n        try {\n          await sub.handler(event);\n        } catch {\n          // Swallow handler errors to avoid breaking the publish loop\n        }\n      }\n    }\n  }\n\n  async subscribe(\n    channel: string,\n    handler: RealtimeEventHandler,\n    options?: RealtimeSubscriptionOptions,\n  ): Promise<string> {\n    if (this.maxSubscriptions > 0 && this.subscriptions.size >= this.maxSubscriptions) {\n      throw new Error(\n        `Maximum subscription limit reached (${this.maxSubscriptions}). ` +\n        'Unsubscribe from existing channels before adding new subscriptions.',\n      );\n    }\n\n    const id = `sub-${++this.counter}`;\n    const sub: Subscription = { id, channel, handler, options };\n    this.subscriptions.set(id, sub);\n\n    // Maintain channel index for efficient lookups\n    if (!this.channelIndex.has(channel)) {\n      this.channelIndex.set(channel, new Set());\n    }\n    this.channelIndex.get(channel)!.add(id);\n\n    return id;\n  }\n\n  async unsubscribe(subscriptionId: string): Promise<void> {\n    const sub = this.subscriptions.get(subscriptionId);\n    if (!sub) return;\n\n    this.subscriptions.delete(subscriptionId);\n\n    // Clean up channel index\n    const channelSubs = this.channelIndex.get(sub.channel);\n    if (channelSubs) {\n      channelSubs.delete(subscriptionId);\n      if (channelSubs.size === 0) {\n        this.channelIndex.delete(sub.channel);\n      }\n    }\n  }\n\n  /**\n   * Get the number of active subscriptions.\n   */\n  getSubscriptionCount(): number {\n    return this.subscriptions.size;\n  }\n\n  /**\n   * Get all active channel names.\n   */\n  getChannels(): string[] {\n    return Array.from(this.channelIndex.keys());\n  }\n\n  /**\n   * Check if an event matches a subscription's filters.\n   */\n  private matchesSubscription(event: RealtimeEventPayload, sub: Subscription): boolean {\n    const opts = sub.options;\n    if (!opts) return true;\n\n    // Filter by object name\n    if (opts.object && event.object !== opts.object) {\n      return false;\n    }\n\n    // Filter by event types\n    if (opts.eventTypes && opts.eventTypes.length > 0) {\n      if (!opts.eventTypes.includes(event.type)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { ObjectSchema, Field } from '@objectstack/spec/data';\n\n/**\n * sys_presence — System Presence Object\n *\n * Tracks real-time user presence and activity across the platform.\n * Fields align with the PresenceStateSchema protocol definition\n * from `@objectstack/spec/api` (websocket.zod.ts).\n *\n * Owned by `service-realtime` as the canonical Presence domain object.\n *\n * @namespace sys\n * @see PresenceStateSchema in packages/spec/src/api/websocket.zod.ts\n */\nexport const SysPresence = ObjectSchema.create({\n  namespace: 'sys',\n  name: 'presence',\n  label: 'Presence',\n  pluralLabel: 'Presences',\n  icon: 'wifi',\n  isSystem: true,\n  description: 'Real-time user presence and activity tracking',\n  titleFormat: '{user_id} ({status})',\n  compactLayout: ['user_id', 'status', 'last_seen'],\n\n  fields: {\n    id: Field.text({\n      label: 'Presence ID',\n      required: true,\n      readonly: true,\n    }),\n\n    created_at: Field.datetime({\n      label: 'Created At',\n      defaultValue: 'NOW()',\n      readonly: true,\n    }),\n\n    updated_at: Field.datetime({\n      label: 'Updated At',\n      defaultValue: 'NOW()',\n      readonly: true,\n    }),\n\n    user_id: Field.text({\n      label: 'User ID',\n      required: true,\n      searchable: true,\n    }),\n\n    session_id: Field.text({\n      label: 'Session ID',\n      required: true,\n    }),\n\n    status: Field.select({\n      label: 'Status',\n      required: true,\n      defaultValue: 'online',\n      options: [\n        { value: 'online', label: 'Online' },\n        { value: 'away', label: 'Away' },\n        { value: 'busy', label: 'Busy' },\n        { value: 'offline', label: 'Offline' },\n      ],\n    }),\n\n    last_seen: Field.datetime({\n      label: 'Last Seen',\n      required: true,\n      defaultValue: 'NOW()',\n    }),\n\n    current_location: Field.text({\n      label: 'Current Location',\n      required: false,\n      maxLength: 500,\n    }),\n\n    device: Field.select({\n      label: 'Device',\n      required: false,\n      options: [\n        { value: 'desktop', label: 'Desktop' },\n        { value: 'mobile', label: 'Mobile' },\n        { value: 'tablet', label: 'Tablet' },\n        { value: 'other', label: 'Other' },\n      ],\n    }),\n\n    custom_status: Field.text({\n      label: 'Custom Status',\n      required: false,\n      maxLength: 255,\n    }),\n\n    metadata: Field.json({\n      label: 'Metadata',\n      required: false,\n      description: 'Arbitrary JSON metadata associated with the presence state (matches PresenceStateSchema.metadata).',\n    }),\n  },\n\n  indexes: [\n    { fields: ['user_id'], unique: false },\n    { fields: ['session_id'], unique: true },\n    { fields: ['status'], unique: false },\n  ],\n\n  enable: {\n    trackHistory: false,\n    searchable: false,\n    apiEnabled: true,\n    apiMethods: ['get', 'list', 'create', 'update', 'delete'],\n    trash: false,\n    mru: false,\n  },\n});\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { InMemoryRealtimeAdapter } from './in-memory-realtime-adapter.js';\nimport type { InMemoryRealtimeAdapterOptions } from './in-memory-realtime-adapter.js';\nimport { SysPresence } from './objects/index.js';\n\n/**\n * Configuration options for the RealtimeServicePlugin.\n */\nexport interface RealtimeServicePluginOptions {\n  /** Realtime adapter type (default: 'memory') */\n  adapter?: 'memory';\n  /** Options for the in-memory adapter */\n  memory?: InMemoryRealtimeAdapterOptions;\n}\n\n/**\n * RealtimeServicePlugin — Production IRealtimeService implementation.\n *\n * Registers a realtime pub/sub service with the kernel during the init phase.\n * Currently supports in-memory pub/sub for single-process environments.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { RealtimeServicePlugin } from '@objectstack/service-realtime';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new RealtimeServicePlugin());\n * await kernel.bootstrap();\n *\n * const realtime = kernel.getService('realtime');\n * await realtime.subscribe('records', (event) => {\n *   console.log(event.type, event.payload);\n * });\n * ```\n */\nexport class RealtimeServicePlugin implements Plugin {\n  name = 'com.objectstack.service.realtime';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: RealtimeServicePluginOptions;\n\n  constructor(options: RealtimeServicePluginOptions = {}) {\n    this.options = { adapter: 'memory', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const realtime = new InMemoryRealtimeAdapter(this.options.memory);\n    ctx.registerService('realtime', realtime);\n\n    // Register realtime system objects so ObjectQLPlugin auto-discovers them\n    ctx.registerService('app.com.objectstack.service.realtime', {\n      id: 'com.objectstack.service.realtime',\n      name: 'Realtime Service',\n      version: '1.0.0',\n      type: 'plugin',\n      namespace: 'sys',\n      objects: [SysPresence],\n    });\n\n    ctx.logger.info('RealtimeServicePlugin: registered in-memory realtime adapter');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/in-memory-realtime-adapter.ts","../src/objects/sys-presence.object.ts","../src/realtime-service-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { RealtimeServicePlugin } from './realtime-service-plugin.js';\nexport type { RealtimeServicePluginOptions } from './realtime-service-plugin.js';\nexport { InMemoryRealtimeAdapter } from './in-memory-realtime-adapter.js';\nexport type { InMemoryRealtimeAdapterOptions } from './in-memory-realtime-adapter.js';\nexport { SysPresence } from './objects/index.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n  IRealtimeService,\n  RealtimeEventPayload,\n  RealtimeEventHandler,\n  RealtimeSubscriptionOptions,\n} from '@objectstack/spec/contracts';\n\n/**\n * Internal subscription entry.\n */\ninterface Subscription {\n  id: string;\n  channel: string;\n  handler: RealtimeEventHandler;\n  options?: RealtimeSubscriptionOptions;\n}\n\n/**\n * Configuration options for InMemoryRealtimeAdapter.\n */\nexport interface InMemoryRealtimeAdapterOptions {\n  /** Maximum number of subscriptions allowed (0 = unlimited) */\n  maxSubscriptions?: number;\n}\n\n/**\n * In-memory pub/sub adapter implementing IRealtimeService.\n *\n * Uses a Map-backed subscription store with channel-based routing.\n * Supports event type and object filtering via subscription options.\n *\n * Suitable for single-process environments, development, and testing.\n * For production multi-instance deployments, use a Redis-backed adapter.\n *\n * @example\n * ```ts\n * const realtime = new InMemoryRealtimeAdapter();\n *\n * const subId = await realtime.subscribe('records', (event) => {\n *   console.log('Received:', event.type, event.payload);\n * }, { object: 'account', eventTypes: ['record.created'] });\n *\n * await realtime.publish({\n *   type: 'record.created',\n *   object: 'account',\n *   payload: { id: 'acc-1', name: 'Acme' },\n *   timestamp: new Date().toISOString(),\n * });\n *\n * await realtime.unsubscribe(subId);\n * ```\n */\nexport class InMemoryRealtimeAdapter implements IRealtimeService {\n  private readonly subscriptions = new Map<string, Subscription>();\n  private readonly channelIndex = new Map<string, Set<string>>();\n  private counter = 0;\n  private readonly maxSubscriptions: number;\n\n  constructor(options: InMemoryRealtimeAdapterOptions = {}) {\n    this.maxSubscriptions = options.maxSubscriptions ?? 0;\n  }\n\n  async publish(event: RealtimeEventPayload): Promise<void> {\n    // Deliver to all channel subscriptions that match filters\n    for (const sub of this.subscriptions.values()) {\n      if (this.matchesSubscription(event, sub)) {\n        try {\n          await sub.handler(event);\n        } catch {\n          // Swallow handler errors to avoid breaking the publish loop\n        }\n      }\n    }\n  }\n\n  async subscribe(\n    channel: string,\n    handler: RealtimeEventHandler,\n    options?: RealtimeSubscriptionOptions,\n  ): Promise<string> {\n    if (this.maxSubscriptions > 0 && this.subscriptions.size >= this.maxSubscriptions) {\n      throw new Error(\n        `Maximum subscription limit reached (${this.maxSubscriptions}). ` +\n        'Unsubscribe from existing channels before adding new subscriptions.',\n      );\n    }\n\n    const id = `sub-${++this.counter}`;\n    const sub: Subscription = { id, channel, handler, options };\n    this.subscriptions.set(id, sub);\n\n    // Maintain channel index for efficient lookups\n    if (!this.channelIndex.has(channel)) {\n      this.channelIndex.set(channel, new Set());\n    }\n    this.channelIndex.get(channel)!.add(id);\n\n    return id;\n  }\n\n  async unsubscribe(subscriptionId: string): Promise<void> {\n    const sub = this.subscriptions.get(subscriptionId);\n    if (!sub) return;\n\n    this.subscriptions.delete(subscriptionId);\n\n    // Clean up channel index\n    const channelSubs = this.channelIndex.get(sub.channel);\n    if (channelSubs) {\n      channelSubs.delete(subscriptionId);\n      if (channelSubs.size === 0) {\n        this.channelIndex.delete(sub.channel);\n      }\n    }\n  }\n\n  /**\n   * Get the number of active subscriptions.\n   */\n  getSubscriptionCount(): number {\n    return this.subscriptions.size;\n  }\n\n  /**\n   * Get all active channel names.\n   */\n  getChannels(): string[] {\n    return Array.from(this.channelIndex.keys());\n  }\n\n  /**\n   * Check if an event matches a subscription's filters.\n   */\n  private matchesSubscription(event: RealtimeEventPayload, sub: Subscription): boolean {\n    const opts = sub.options;\n    if (!opts) return true;\n\n    // Filter by object name\n    if (opts.object && event.object !== opts.object) {\n      return false;\n    }\n\n    // Filter by event types\n    if (opts.eventTypes && opts.eventTypes.length > 0) {\n      if (!opts.eventTypes.includes(event.type)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { ObjectSchema, Field } from '@objectstack/spec/data';\n\n/**\n * sys_presence — System Presence Object\n *\n * Tracks real-time user presence and activity across the platform.\n * Fields align with the PresenceStateSchema protocol definition\n * from `@objectstack/spec/api` (websocket.zod.ts).\n *\n * Owned by `service-realtime` as the canonical Presence domain object.\n *\n * @namespace sys\n * @see PresenceStateSchema in packages/spec/src/api/websocket.zod.ts\n */\nexport const SysPresence = ObjectSchema.create({\n  namespace: 'sys',\n  name: 'presence',\n  label: 'Presence',\n  pluralLabel: 'Presences',\n  icon: 'wifi',\n  isSystem: true,\n  description: 'Real-time user presence and activity tracking',\n  titleFormat: '{user_id} ({status})',\n  compactLayout: ['user_id', 'status', 'last_seen'],\n\n  fields: {\n    id: Field.text({\n      label: 'Presence ID',\n      required: true,\n      readonly: true,\n    }),\n\n    created_at: Field.datetime({\n      label: 'Created At',\n      defaultValue: 'NOW()',\n      readonly: true,\n    }),\n\n    updated_at: Field.datetime({\n      label: 'Updated At',\n      defaultValue: 'NOW()',\n      readonly: true,\n    }),\n\n    user_id: Field.text({\n      label: 'User ID',\n      required: true,\n      searchable: true,\n    }),\n\n    session_id: Field.text({\n      label: 'Session ID',\n      required: true,\n    }),\n\n    status: Field.select({\n      label: 'Status',\n      required: true,\n      defaultValue: 'online',\n      options: [\n        { value: 'online', label: 'Online' },\n        { value: 'away', label: 'Away' },\n        { value: 'busy', label: 'Busy' },\n        { value: 'offline', label: 'Offline' },\n      ],\n    }),\n\n    last_seen: Field.datetime({\n      label: 'Last Seen',\n      required: true,\n      defaultValue: 'NOW()',\n    }),\n\n    current_location: Field.text({\n      label: 'Current Location',\n      required: false,\n      maxLength: 500,\n    }),\n\n    device: Field.select({\n      label: 'Device',\n      required: false,\n      options: [\n        { value: 'desktop', label: 'Desktop' },\n        { value: 'mobile', label: 'Mobile' },\n        { value: 'tablet', label: 'Tablet' },\n        { value: 'other', label: 'Other' },\n      ],\n    }),\n\n    custom_status: Field.text({\n      label: 'Custom Status',\n      required: false,\n      maxLength: 255,\n    }),\n\n    metadata: Field.json({\n      label: 'Metadata',\n      required: false,\n      description: 'Arbitrary JSON metadata associated with the presence state (matches PresenceStateSchema.metadata).',\n    }),\n  },\n\n  indexes: [\n    { fields: ['user_id'], unique: false },\n    { fields: ['session_id'], unique: true },\n    { fields: ['status'], unique: false },\n  ],\n\n  enable: {\n    trackHistory: false,\n    searchable: false,\n    apiEnabled: true,\n    apiMethods: ['get', 'list', 'create', 'update', 'delete'],\n    trash: false,\n    mru: false,\n  },\n});\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { InMemoryRealtimeAdapter } from './in-memory-realtime-adapter.js';\nimport type { InMemoryRealtimeAdapterOptions } from './in-memory-realtime-adapter.js';\nimport { SysPresence } from './objects/index.js';\n\n/**\n * Configuration options for the RealtimeServicePlugin.\n */\nexport interface RealtimeServicePluginOptions {\n  /** Realtime adapter type (default: 'memory') */\n  adapter?: 'memory';\n  /** Options for the in-memory adapter */\n  memory?: InMemoryRealtimeAdapterOptions;\n}\n\n/**\n * RealtimeServicePlugin — Production IRealtimeService implementation.\n *\n * Registers a realtime pub/sub service with the kernel during the init phase.\n * Currently supports in-memory pub/sub for single-process environments.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { RealtimeServicePlugin } from '@objectstack/service-realtime';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new RealtimeServicePlugin());\n * await kernel.bootstrap();\n *\n * const realtime = kernel.getService('realtime');\n * await realtime.subscribe('records', (event) => {\n *   console.log(event.type, event.payload);\n * });\n * ```\n */\nexport class RealtimeServicePlugin implements Plugin {\n  name = 'com.objectstack.service.realtime';\n  version = '1.0.0';\n  type = 'standard';\n  dependencies = ['com.objectstack.engine.objectql'];\n\n  private readonly options: RealtimeServicePluginOptions;\n\n  constructor(options: RealtimeServicePluginOptions = {}) {\n    this.options = { adapter: 'memory', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const realtime = new InMemoryRealtimeAdapter(this.options.memory);\n    ctx.registerService('realtime', realtime);\n\n    // Register realtime system objects via the manifest service.\n    ctx.getService<{ register(m: any): void }>('manifest').register({\n      id: 'com.objectstack.service.realtime',\n      name: 'Realtime Service',\n      version: '1.0.0',\n      type: 'plugin',\n      namespace: 'sys',\n      objects: [SysPresence],\n    });\n\n    ctx.logger.info('RealtimeServicePlugin: registered in-memory realtime adapter');\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -94,6 +94,7 @@ declare class RealtimeServicePlugin implements Plugin {
     name: string;
     version: string;
     type: string;
+    dependencies: string[];
     private readonly options;
     constructor(options?: RealtimeServicePluginOptions);
     init(ctx: PluginContext): Promise<void>;
@@ -425,12 +426,8 @@ declare const SysPresence: Omit<{
     keyPrefix?: string | undefined;
     actions?: {
         name: string;
-        label: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        };
-        type: "url" | "script" | "modal" | "flow" | "api";
+        label: string;
+        type: "url" | "flow" | "api" | "script" | "modal";
         refreshAfter: boolean;
         objectName?: string | undefined;
         icon?: string | undefined;
@@ -440,44 +437,24 @@ declare const SysPresence: Omit<{
         execute?: string | undefined;
         params?: {
             name: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
+            label: string;
             type: "number" | "boolean" | "date" | "lookup" | "file" | "url" | "json" | "text" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
             required: boolean;
             options?: {
-                label: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                };
+                label: string;
                 value: string;
             }[] | undefined;
         }[] | undefined;
         variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
-        confirmText?: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        } | undefined;
-        successMessage?: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        } | undefined;
+        confirmText?: string | undefined;
+        successMessage?: string | undefined;
         visible?: string | undefined;
         disabled?: string | boolean | undefined;
         shortcut?: string | undefined;
         bulkEnabled?: boolean | undefined;
         timeout?: number | undefined;
         aria?: {
-            ariaLabel?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            ariaLabel?: string | undefined;
             ariaDescribedBy?: string | undefined;
             role?: string | undefined;
         } | undefined;

package/dist/index.d.ts

@@ -94,6 +94,7 @@ declare class RealtimeServicePlugin implements Plugin {
     name: string;
     version: string;
     type: string;
+    dependencies: string[];
     private readonly options;
     constructor(options?: RealtimeServicePluginOptions);
     init(ctx: PluginContext): Promise<void>;
@@ -425,12 +426,8 @@ declare const SysPresence: Omit<{
     keyPrefix?: string | undefined;
     actions?: {
         name: string;
-        label: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        };
-        type: "url" | "script" | "modal" | "flow" | "api";
+        label: string;
+        type: "url" | "flow" | "api" | "script" | "modal";
         refreshAfter: boolean;
         objectName?: string | undefined;
         icon?: string | undefined;
@@ -440,44 +437,24 @@ declare const SysPresence: Omit<{
         execute?: string | undefined;
         params?: {
             name: string;
-            label: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            };
+            label: string;
             type: "number" | "boolean" | "date" | "lookup" | "file" | "url" | "json" | "text" | "textarea" | "email" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
             required: boolean;
             options?: {
-                label: string | {
-                    key: string;
-                    defaultValue?: string | undefined;
-                    params?: Record<string, string | number | boolean> | undefined;
-                };
+                label: string;
                 value: string;
             }[] | undefined;
         }[] | undefined;
         variant?: "link" | "primary" | "secondary" | "danger" | "ghost" | undefined;
-        confirmText?: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        } | undefined;
-        successMessage?: string | {
-            key: string;
-            defaultValue?: string | undefined;
-            params?: Record<string, string | number | boolean> | undefined;
-        } | undefined;
+        confirmText?: string | undefined;
+        successMessage?: string | undefined;
         visible?: string | undefined;
         disabled?: string | boolean | undefined;
         shortcut?: string | undefined;
         bulkEnabled?: boolean | undefined;
         timeout?: number | undefined;
         aria?: {
-            ariaLabel?: string | {
-                key: string;
-                defaultValue?: string | undefined;
-                params?: Record<string, string | number | boolean> | undefined;
-            } | undefined;
+            ariaLabel?: string | undefined;
             ariaDescribedBy?: string | undefined;
             role?: string | undefined;
         } | undefined;

package/dist/index.js

@@ -173,12 +173,13 @@ var RealtimeServicePlugin = class {
     this.name = "com.objectstack.service.realtime";
     this.version = "1.0.0";
     this.type = "standard";
+    this.dependencies = ["com.objectstack.engine.objectql"];
     this.options = { adapter: "memory", ...options };
   }
   async init(ctx) {
     const realtime = new InMemoryRealtimeAdapter(this.options.memory);
     ctx.registerService("realtime", realtime);
-    ctx.registerService("app.com.objectstack.service.realtime", {
+    ctx.getService("manifest").register({
       id: "com.objectstack.service.realtime",
       name: "Realtime Service",
       version: "1.0.0",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/in-memory-realtime-adapter.ts","../src/objects/sys-presence.object.ts","../src/realtime-service-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n  IRealtimeService,\n  RealtimeEventPayload,\n  RealtimeEventHandler,\n  RealtimeSubscriptionOptions,\n} from '@objectstack/spec/contracts';\n\n/**\n * Internal subscription entry.\n */\ninterface Subscription {\n  id: string;\n  channel: string;\n  handler: RealtimeEventHandler;\n  options?: RealtimeSubscriptionOptions;\n}\n\n/**\n * Configuration options for InMemoryRealtimeAdapter.\n */\nexport interface InMemoryRealtimeAdapterOptions {\n  /** Maximum number of subscriptions allowed (0 = unlimited) */\n  maxSubscriptions?: number;\n}\n\n/**\n * In-memory pub/sub adapter implementing IRealtimeService.\n *\n * Uses a Map-backed subscription store with channel-based routing.\n * Supports event type and object filtering via subscription options.\n *\n * Suitable for single-process environments, development, and testing.\n * For production multi-instance deployments, use a Redis-backed adapter.\n *\n * @example\n * ```ts\n * const realtime = new InMemoryRealtimeAdapter();\n *\n * const subId = await realtime.subscribe('records', (event) => {\n *   console.log('Received:', event.type, event.payload);\n * }, { object: 'account', eventTypes: ['record.created'] });\n *\n * await realtime.publish({\n *   type: 'record.created',\n *   object: 'account',\n *   payload: { id: 'acc-1', name: 'Acme' },\n *   timestamp: new Date().toISOString(),\n * });\n *\n * await realtime.unsubscribe(subId);\n * ```\n */\nexport class InMemoryRealtimeAdapter implements IRealtimeService {\n  private readonly subscriptions = new Map<string, Subscription>();\n  private readonly channelIndex = new Map<string, Set<string>>();\n  private counter = 0;\n  private readonly maxSubscriptions: number;\n\n  constructor(options: InMemoryRealtimeAdapterOptions = {}) {\n    this.maxSubscriptions = options.maxSubscriptions ?? 0;\n  }\n\n  async publish(event: RealtimeEventPayload): Promise<void> {\n    // Deliver to all channel subscriptions that match filters\n    for (const sub of this.subscriptions.values()) {\n      if (this.matchesSubscription(event, sub)) {\n        try {\n          await sub.handler(event);\n        } catch {\n          // Swallow handler errors to avoid breaking the publish loop\n        }\n      }\n    }\n  }\n\n  async subscribe(\n    channel: string,\n    handler: RealtimeEventHandler,\n    options?: RealtimeSubscriptionOptions,\n  ): Promise<string> {\n    if (this.maxSubscriptions > 0 && this.subscriptions.size >= this.maxSubscriptions) {\n      throw new Error(\n        `Maximum subscription limit reached (${this.maxSubscriptions}). ` +\n        'Unsubscribe from existing channels before adding new subscriptions.',\n      );\n    }\n\n    const id = `sub-${++this.counter}`;\n    const sub: Subscription = { id, channel, handler, options };\n    this.subscriptions.set(id, sub);\n\n    // Maintain channel index for efficient lookups\n    if (!this.channelIndex.has(channel)) {\n      this.channelIndex.set(channel, new Set());\n    }\n    this.channelIndex.get(channel)!.add(id);\n\n    return id;\n  }\n\n  async unsubscribe(subscriptionId: string): Promise<void> {\n    const sub = this.subscriptions.get(subscriptionId);\n    if (!sub) return;\n\n    this.subscriptions.delete(subscriptionId);\n\n    // Clean up channel index\n    const channelSubs = this.channelIndex.get(sub.channel);\n    if (channelSubs) {\n      channelSubs.delete(subscriptionId);\n      if (channelSubs.size === 0) {\n        this.channelIndex.delete(sub.channel);\n      }\n    }\n  }\n\n  /**\n   * Get the number of active subscriptions.\n   */\n  getSubscriptionCount(): number {\n    return this.subscriptions.size;\n  }\n\n  /**\n   * Get all active channel names.\n   */\n  getChannels(): string[] {\n    return Array.from(this.channelIndex.keys());\n  }\n\n  /**\n   * Check if an event matches a subscription's filters.\n   */\n  private matchesSubscription(event: RealtimeEventPayload, sub: Subscription): boolean {\n    const opts = sub.options;\n    if (!opts) return true;\n\n    // Filter by object name\n    if (opts.object && event.object !== opts.object) {\n      return false;\n    }\n\n    // Filter by event types\n    if (opts.eventTypes && opts.eventTypes.length > 0) {\n      if (!opts.eventTypes.includes(event.type)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { ObjectSchema, Field } from '@objectstack/spec/data';\n\n/**\n * sys_presence — System Presence Object\n *\n * Tracks real-time user presence and activity across the platform.\n * Fields align with the PresenceStateSchema protocol definition\n * from `@objectstack/spec/api` (websocket.zod.ts).\n *\n * Owned by `service-realtime` as the canonical Presence domain object.\n *\n * @namespace sys\n * @see PresenceStateSchema in packages/spec/src/api/websocket.zod.ts\n */\nexport const SysPresence = ObjectSchema.create({\n  namespace: 'sys',\n  name: 'presence',\n  label: 'Presence',\n  pluralLabel: 'Presences',\n  icon: 'wifi',\n  isSystem: true,\n  description: 'Real-time user presence and activity tracking',\n  titleFormat: '{user_id} ({status})',\n  compactLayout: ['user_id', 'status', 'last_seen'],\n\n  fields: {\n    id: Field.text({\n      label: 'Presence ID',\n      required: true,\n      readonly: true,\n    }),\n\n    created_at: Field.datetime({\n      label: 'Created At',\n      defaultValue: 'NOW()',\n      readonly: true,\n    }),\n\n    updated_at: Field.datetime({\n      label: 'Updated At',\n      defaultValue: 'NOW()',\n      readonly: true,\n    }),\n\n    user_id: Field.text({\n      label: 'User ID',\n      required: true,\n      searchable: true,\n    }),\n\n    session_id: Field.text({\n      label: 'Session ID',\n      required: true,\n    }),\n\n    status: Field.select({\n      label: 'Status',\n      required: true,\n      defaultValue: 'online',\n      options: [\n        { value: 'online', label: 'Online' },\n        { value: 'away', label: 'Away' },\n        { value: 'busy', label: 'Busy' },\n        { value: 'offline', label: 'Offline' },\n      ],\n    }),\n\n    last_seen: Field.datetime({\n      label: 'Last Seen',\n      required: true,\n      defaultValue: 'NOW()',\n    }),\n\n    current_location: Field.text({\n      label: 'Current Location',\n      required: false,\n      maxLength: 500,\n    }),\n\n    device: Field.select({\n      label: 'Device',\n      required: false,\n      options: [\n        { value: 'desktop', label: 'Desktop' },\n        { value: 'mobile', label: 'Mobile' },\n        { value: 'tablet', label: 'Tablet' },\n        { value: 'other', label: 'Other' },\n      ],\n    }),\n\n    custom_status: Field.text({\n      label: 'Custom Status',\n      required: false,\n      maxLength: 255,\n    }),\n\n    metadata: Field.json({\n      label: 'Metadata',\n      required: false,\n      description: 'Arbitrary JSON metadata associated with the presence state (matches PresenceStateSchema.metadata).',\n    }),\n  },\n\n  indexes: [\n    { fields: ['user_id'], unique: false },\n    { fields: ['session_id'], unique: true },\n    { fields: ['status'], unique: false },\n  ],\n\n  enable: {\n    trackHistory: false,\n    searchable: false,\n    apiEnabled: true,\n    apiMethods: ['get', 'list', 'create', 'update', 'delete'],\n    trash: false,\n    mru: false,\n  },\n});\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { InMemoryRealtimeAdapter } from './in-memory-realtime-adapter.js';\nimport type { InMemoryRealtimeAdapterOptions } from './in-memory-realtime-adapter.js';\nimport { SysPresence } from './objects/index.js';\n\n/**\n * Configuration options for the RealtimeServicePlugin.\n */\nexport interface RealtimeServicePluginOptions {\n  /** Realtime adapter type (default: 'memory') */\n  adapter?: 'memory';\n  /** Options for the in-memory adapter */\n  memory?: InMemoryRealtimeAdapterOptions;\n}\n\n/**\n * RealtimeServicePlugin — Production IRealtimeService implementation.\n *\n * Registers a realtime pub/sub service with the kernel during the init phase.\n * Currently supports in-memory pub/sub for single-process environments.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { RealtimeServicePlugin } from '@objectstack/service-realtime';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new RealtimeServicePlugin());\n * await kernel.bootstrap();\n *\n * const realtime = kernel.getService('realtime');\n * await realtime.subscribe('records', (event) => {\n *   console.log(event.type, event.payload);\n * });\n * ```\n */\nexport class RealtimeServicePlugin implements Plugin {\n  name = 'com.objectstack.service.realtime';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: RealtimeServicePluginOptions;\n\n  constructor(options: RealtimeServicePluginOptions = {}) {\n    this.options = { adapter: 'memory', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const realtime = new InMemoryRealtimeAdapter(this.options.memory);\n    ctx.registerService('realtime', realtime);\n\n    // Register realtime system objects so ObjectQLPlugin auto-discovers them\n    ctx.registerService('app.com.objectstack.service.realtime', {\n      id: 'com.objectstack.service.realtime',\n      name: 'Realtime Service',\n      version: '1.0.0',\n      type: 'plugin',\n      namespace: 'sys',\n      objects: [SysPresence],\n    });\n\n    ctx.logger.info('RealtimeServicePlugin: registered in-memory realtime adapter');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/in-memory-realtime-adapter.ts","../src/objects/sys-presence.object.ts","../src/realtime-service-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n  IRealtimeService,\n  RealtimeEventPayload,\n  RealtimeEventHandler,\n  RealtimeSubscriptionOptions,\n} from '@objectstack/spec/contracts';\n\n/**\n * Internal subscription entry.\n */\ninterface Subscription {\n  id: string;\n  channel: string;\n  handler: RealtimeEventHandler;\n  options?: RealtimeSubscriptionOptions;\n}\n\n/**\n * Configuration options for InMemoryRealtimeAdapter.\n */\nexport interface InMemoryRealtimeAdapterOptions {\n  /** Maximum number of subscriptions allowed (0 = unlimited) */\n  maxSubscriptions?: number;\n}\n\n/**\n * In-memory pub/sub adapter implementing IRealtimeService.\n *\n * Uses a Map-backed subscription store with channel-based routing.\n * Supports event type and object filtering via subscription options.\n *\n * Suitable for single-process environments, development, and testing.\n * For production multi-instance deployments, use a Redis-backed adapter.\n *\n * @example\n * ```ts\n * const realtime = new InMemoryRealtimeAdapter();\n *\n * const subId = await realtime.subscribe('records', (event) => {\n *   console.log('Received:', event.type, event.payload);\n * }, { object: 'account', eventTypes: ['record.created'] });\n *\n * await realtime.publish({\n *   type: 'record.created',\n *   object: 'account',\n *   payload: { id: 'acc-1', name: 'Acme' },\n *   timestamp: new Date().toISOString(),\n * });\n *\n * await realtime.unsubscribe(subId);\n * ```\n */\nexport class InMemoryRealtimeAdapter implements IRealtimeService {\n  private readonly subscriptions = new Map<string, Subscription>();\n  private readonly channelIndex = new Map<string, Set<string>>();\n  private counter = 0;\n  private readonly maxSubscriptions: number;\n\n  constructor(options: InMemoryRealtimeAdapterOptions = {}) {\n    this.maxSubscriptions = options.maxSubscriptions ?? 0;\n  }\n\n  async publish(event: RealtimeEventPayload): Promise<void> {\n    // Deliver to all channel subscriptions that match filters\n    for (const sub of this.subscriptions.values()) {\n      if (this.matchesSubscription(event, sub)) {\n        try {\n          await sub.handler(event);\n        } catch {\n          // Swallow handler errors to avoid breaking the publish loop\n        }\n      }\n    }\n  }\n\n  async subscribe(\n    channel: string,\n    handler: RealtimeEventHandler,\n    options?: RealtimeSubscriptionOptions,\n  ): Promise<string> {\n    if (this.maxSubscriptions > 0 && this.subscriptions.size >= this.maxSubscriptions) {\n      throw new Error(\n        `Maximum subscription limit reached (${this.maxSubscriptions}). ` +\n        'Unsubscribe from existing channels before adding new subscriptions.',\n      );\n    }\n\n    const id = `sub-${++this.counter}`;\n    const sub: Subscription = { id, channel, handler, options };\n    this.subscriptions.set(id, sub);\n\n    // Maintain channel index for efficient lookups\n    if (!this.channelIndex.has(channel)) {\n      this.channelIndex.set(channel, new Set());\n    }\n    this.channelIndex.get(channel)!.add(id);\n\n    return id;\n  }\n\n  async unsubscribe(subscriptionId: string): Promise<void> {\n    const sub = this.subscriptions.get(subscriptionId);\n    if (!sub) return;\n\n    this.subscriptions.delete(subscriptionId);\n\n    // Clean up channel index\n    const channelSubs = this.channelIndex.get(sub.channel);\n    if (channelSubs) {\n      channelSubs.delete(subscriptionId);\n      if (channelSubs.size === 0) {\n        this.channelIndex.delete(sub.channel);\n      }\n    }\n  }\n\n  /**\n   * Get the number of active subscriptions.\n   */\n  getSubscriptionCount(): number {\n    return this.subscriptions.size;\n  }\n\n  /**\n   * Get all active channel names.\n   */\n  getChannels(): string[] {\n    return Array.from(this.channelIndex.keys());\n  }\n\n  /**\n   * Check if an event matches a subscription's filters.\n   */\n  private matchesSubscription(event: RealtimeEventPayload, sub: Subscription): boolean {\n    const opts = sub.options;\n    if (!opts) return true;\n\n    // Filter by object name\n    if (opts.object && event.object !== opts.object) {\n      return false;\n    }\n\n    // Filter by event types\n    if (opts.eventTypes && opts.eventTypes.length > 0) {\n      if (!opts.eventTypes.includes(event.type)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { ObjectSchema, Field } from '@objectstack/spec/data';\n\n/**\n * sys_presence — System Presence Object\n *\n * Tracks real-time user presence and activity across the platform.\n * Fields align with the PresenceStateSchema protocol definition\n * from `@objectstack/spec/api` (websocket.zod.ts).\n *\n * Owned by `service-realtime` as the canonical Presence domain object.\n *\n * @namespace sys\n * @see PresenceStateSchema in packages/spec/src/api/websocket.zod.ts\n */\nexport const SysPresence = ObjectSchema.create({\n  namespace: 'sys',\n  name: 'presence',\n  label: 'Presence',\n  pluralLabel: 'Presences',\n  icon: 'wifi',\n  isSystem: true,\n  description: 'Real-time user presence and activity tracking',\n  titleFormat: '{user_id} ({status})',\n  compactLayout: ['user_id', 'status', 'last_seen'],\n\n  fields: {\n    id: Field.text({\n      label: 'Presence ID',\n      required: true,\n      readonly: true,\n    }),\n\n    created_at: Field.datetime({\n      label: 'Created At',\n      defaultValue: 'NOW()',\n      readonly: true,\n    }),\n\n    updated_at: Field.datetime({\n      label: 'Updated At',\n      defaultValue: 'NOW()',\n      readonly: true,\n    }),\n\n    user_id: Field.text({\n      label: 'User ID',\n      required: true,\n      searchable: true,\n    }),\n\n    session_id: Field.text({\n      label: 'Session ID',\n      required: true,\n    }),\n\n    status: Field.select({\n      label: 'Status',\n      required: true,\n      defaultValue: 'online',\n      options: [\n        { value: 'online', label: 'Online' },\n        { value: 'away', label: 'Away' },\n        { value: 'busy', label: 'Busy' },\n        { value: 'offline', label: 'Offline' },\n      ],\n    }),\n\n    last_seen: Field.datetime({\n      label: 'Last Seen',\n      required: true,\n      defaultValue: 'NOW()',\n    }),\n\n    current_location: Field.text({\n      label: 'Current Location',\n      required: false,\n      maxLength: 500,\n    }),\n\n    device: Field.select({\n      label: 'Device',\n      required: false,\n      options: [\n        { value: 'desktop', label: 'Desktop' },\n        { value: 'mobile', label: 'Mobile' },\n        { value: 'tablet', label: 'Tablet' },\n        { value: 'other', label: 'Other' },\n      ],\n    }),\n\n    custom_status: Field.text({\n      label: 'Custom Status',\n      required: false,\n      maxLength: 255,\n    }),\n\n    metadata: Field.json({\n      label: 'Metadata',\n      required: false,\n      description: 'Arbitrary JSON metadata associated with the presence state (matches PresenceStateSchema.metadata).',\n    }),\n  },\n\n  indexes: [\n    { fields: ['user_id'], unique: false },\n    { fields: ['session_id'], unique: true },\n    { fields: ['status'], unique: false },\n  ],\n\n  enable: {\n    trackHistory: false,\n    searchable: false,\n    apiEnabled: true,\n    apiMethods: ['get', 'list', 'create', 'update', 'delete'],\n    trash: false,\n    mru: false,\n  },\n});\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { InMemoryRealtimeAdapter } from './in-memory-realtime-adapter.js';\nimport type { InMemoryRealtimeAdapterOptions } from './in-memory-realtime-adapter.js';\nimport { SysPresence } from './objects/index.js';\n\n/**\n * Configuration options for the RealtimeServicePlugin.\n */\nexport interface RealtimeServicePluginOptions {\n  /** Realtime adapter type (default: 'memory') */\n  adapter?: 'memory';\n  /** Options for the in-memory adapter */\n  memory?: InMemoryRealtimeAdapterOptions;\n}\n\n/**\n * RealtimeServicePlugin — Production IRealtimeService implementation.\n *\n * Registers a realtime pub/sub service with the kernel during the init phase.\n * Currently supports in-memory pub/sub for single-process environments.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { RealtimeServicePlugin } from '@objectstack/service-realtime';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new RealtimeServicePlugin());\n * await kernel.bootstrap();\n *\n * const realtime = kernel.getService('realtime');\n * await realtime.subscribe('records', (event) => {\n *   console.log(event.type, event.payload);\n * });\n * ```\n */\nexport class RealtimeServicePlugin implements Plugin {\n  name = 'com.objectstack.service.realtime';\n  version = '1.0.0';\n  type = 'standard';\n  dependencies = ['com.objectstack.engine.objectql'];\n\n  private readonly options: RealtimeServicePluginOptions;\n\n  constructor(options: RealtimeServicePluginOptions = {}) {\n    this.options = { adapter: 'memory', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const realtime = new InMemoryRealtimeAdapter(this.options.memory);\n    ctx.registerService('realtime', realtime);\n\n    // Register realtime system objects via the manifest service.\n    ctx.getService<{ register(m: any): void }>('manifest').register({\n      id: 'com.objectstack.service.realtime',\n      name: 'Realtime Service',\n      version: '1.0.0',\n      type: 'plugin',\n      namespace: 'sys',\n      objects: [SysPresence],\n    });\n\n    ctx.logger.info('RealtimeServicePlugin: registered in-memory realtime adapter');\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/service-realtime",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "license": "Apache-2.0",
   "description": "Realtime Service for ObjectStack — implements IRealtimeService with WebSocket and in-memory pub/sub",
   "type": "module",
@@ -14,13 +14,13 @@
     }
   },
   "dependencies": {
-    "@objectstack/core": "4.0.1",
-    "@objectstack/spec": "4.0.1"
+    "@objectstack/core": "4.0.3",
+    "@objectstack/spec": "4.0.3"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.6.0",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.4"
   },
   "scripts": {
     "build": "tsup --config ../../../tsup.config.ts",

package/src/realtime-service-plugin.ts

@@ -40,6 +40,7 @@ export class RealtimeServicePlugin implements Plugin {
   name = 'com.objectstack.service.realtime';
   version = '1.0.0';
   type = 'standard';
+  dependencies = ['com.objectstack.engine.objectql'];
 
   private readonly options: RealtimeServicePluginOptions;
 
@@ -51,8 +52,8 @@ export class RealtimeServicePlugin implements Plugin {
     const realtime = new InMemoryRealtimeAdapter(this.options.memory);
     ctx.registerService('realtime', realtime);
 
-    // Register realtime system objects so ObjectQLPlugin auto-discovers them
-    ctx.registerService('app.com.objectstack.service.realtime', {
+    // Register realtime system objects via the manifest service.
+    ctx.getService<{ register(m: any): void }>('manifest').register({
       id: 'com.objectstack.service.realtime',
       name: 'Realtime Service',
       version: '1.0.0',