Fix TypeScript build errors in realtime event implementation

- Fixed type errors in objectql/engine.ts for recordId extraction
- Added type guards in objectql/plugin.ts and metadata/plugin.ts
- Fixed client initialization order with getter for events API
- Suppressed intentionally unused fields in RealtimeAPI
- Fixed unused parameter in useAutoRefresh hook

Agent-Logs-Url: https://github.com/objectstack-ai/framework/sessions/22f63fd8-a2de-4140-be84-0f902aaa8d33

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Claude

packages/client-react/src/realtime-hooks.tsx

@@ -253,7 +253,7 @@ export function useAutoRefresh(
   refetch: () => void,
   options?: { recordId?: string }
 ): void {
-  const handleEvent = useCallback((event: DataEvent) => {
+  const handleEvent = useCallback((_event: DataEvent) => {
     // Refetch on any data change
     refetch();
   }, [refetch]);

packages/client/src/index.ts

@@ -896,7 +896,9 @@ export class ObjectStackClient {
    * Event Subscription API
    * Provides real-time event subscriptions for metadata and data changes
    */
-  events = this.realtimeAPI;
+  get events() {
+    return this.realtimeAPI;
+  }
 
   /**
    * Permissions Services

packages/client/src/realtime-api.ts

@@ -25,10 +25,14 @@ export type RealtimeEventHandler = (event: RealtimeEventPayload) => void;
 
 /**
  * Realtime API for subscribing to server events
+ *
+ * Note: Currently uses in-memory adapter. WebSocket/SSE transport planned for future.
  */
 export class RealtimeAPI {
-  private baseUrl: string;
-  private token?: string;
+  // @ts-expect-error - Reserved for future WebSocket/SSE implementation
+  private _baseUrl: string;
+  // @ts-expect-error - Reserved for future WebSocket/SSE implementation
+  private _token?: string;
   private subscriptions = new Map<string, {
     filter: RealtimeSubscriptionFilter;
     handler: RealtimeEventHandler;
@@ -37,8 +41,8 @@ export class RealtimeAPI {
   private eventBuffer: RealtimeEventPayload[] = [];
 
   constructor(baseUrl: string, token?: string) {
-    this.baseUrl = baseUrl;
-    this.token = token;
+    this._baseUrl = baseUrl;
+    this._token = token;
   }
 
   /**

packages/metadata/src/plugin.ts

@@ -131,9 +131,9 @@ export class MetadataPlugin implements Plugin {
         // This enables MetadataManager to publish metadata change events.
         try {
             const realtimeService = ctx.getService('realtime');
-            if (realtimeService) {
+            if (realtimeService && typeof realtimeService === 'object' && 'publish' in realtimeService) {
                 ctx.logger.info('[MetadataPlugin] Bridging realtime service to MetadataManager for event publishing');
-                this.manager.setRealtimeService(realtimeService);
+                this.manager.setRealtimeService(realtimeService as any);
             }
         } catch (e: any) {
             ctx.logger.debug('[MetadataPlugin] No realtime service found — metadata events will not be published', {

packages/objectql/src/engine.ts

@@ -992,18 +992,20 @@ export class ObjectQL implements IDataEngine {
            // Publish data.record.updated event to realtime service
            if (this.realtimeService) {
              try {
+               const resultId = (typeof result === 'object' && result && 'id' in result) ? (result as any).id : undefined;
+               const recordId = String(hookContext.input.id || resultId || '');
                const event: RealtimeEventPayload = {
                  type: 'data.record.updated',
                  object,
                  payload: {
-                   recordId: hookContext.input.id || result?.id,
+                   recordId,
                    changes: hookContext.input.data,
                    after: result,
                  },
                  timestamp: new Date().toISOString(),
                };
                await this.realtimeService.publish(event);
-               this.logger.debug('Published data.record.updated event', { object, recordId: hookContext.input.id });
+               this.logger.debug('Published data.record.updated event', { object, recordId });
              } catch (error) {
                this.logger.warn('Failed to publish data event', { object, error });
              }
@@ -1066,16 +1068,18 @@ export class ObjectQL implements IDataEngine {
           // Publish data.record.deleted event to realtime service
           if (this.realtimeService) {
             try {
+              const resultId = (typeof result === 'object' && result && 'id' in result) ? (result as any).id : undefined;
+              const recordId = String(hookContext.input.id || resultId || '');
               const event: RealtimeEventPayload = {
                 type: 'data.record.deleted',
                 object,
                 payload: {
-                  recordId: hookContext.input.id || result?.id,
+                  recordId,
                 },
                 timestamp: new Date().toISOString(),
               };
               await this.realtimeService.publish(event);
-              this.logger.debug('Published data.record.deleted event', { object, recordId: hookContext.input.id });
+              this.logger.debug('Published data.record.deleted event', { object, recordId });
             } catch (error) {
               this.logger.warn('Failed to publish data event', { object, error });
             }

packages/objectql/src/plugin.ts

@@ -119,9 +119,9 @@ export class ObjectQLPlugin implements Plugin {
         // This enables ObjectQL to publish data change events.
         try {
             const realtimeService = ctx.getService('realtime');
-            if (realtimeService) {
+            if (realtimeService && typeof realtimeService === 'object' && 'publish' in realtimeService) {
                 ctx.logger.info('[ObjectQLPlugin] Bridging realtime service to ObjectQL for event publishing');
-                this.ql.setRealtimeService(realtimeService);
+                this.ql.setRealtimeService(realtimeService as any);
             }
         } catch (e: any) {
             ctx.logger.debug('[ObjectQLPlugin] No realtime service found — data events will not be published', {