@actschurch/ccms-sdk 0.0.1

package/dist/realtime/shared/BaseSignalRClient.js

@@ -0,0 +1,228 @@
+/**
+ * BaseSignalRClient
+ * Abstract base class for all SignalR hub connections
+ * Provides common functionality for connection management, event handling, and reconnection
+ */
+import * as signalR from '@microsoft/signalr';
+import { ConnectionState, DEFAULT_SIGNALR_OPTIONS, HubInvocationError, ConnectionError, } from './types';
+/**
+ * Abstract base class for SignalR hub clients
+ */
+export class BaseSignalRClient {
+    constructor(hubUrl, getToken, options = {}) {
+        this.hubUrl = hubUrl;
+        this.getToken = getToken;
+        this.connection = null;
+        this.connectionState = ConnectionState.Disconnected;
+        this.eventHandlers = new Map();
+        this.stateChangeListeners = new Set();
+        this.reconnectAttempts = 0;
+        this.connectionPromise = null;
+        this.options = { ...DEFAULT_SIGNALR_OPTIONS, ...options };
+    }
+    /**
+     * Get current connection state
+     */
+    getState() {
+        return this.connectionState;
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.connectionState === ConnectionState.Connected;
+    }
+    /**
+     * Subscribe to connection state changes
+     */
+    onStateChange(listener) {
+        this.stateChangeListeners.add(listener);
+        return () => this.stateChangeListeners.delete(listener);
+    }
+    /**
+     * Connect to the SignalR hub
+     */
+    async connect() {
+        if (this.connectionState === ConnectionState.Connected) {
+            return;
+        }
+        if (this.connectionState === ConnectionState.Connecting && this.connectionPromise) {
+            return this.connectionPromise;
+        }
+        this.connectionPromise = this.doConnect();
+        return this.connectionPromise;
+    }
+    /**
+     * Disconnect from the SignalR hub
+     */
+    async disconnect() {
+        if (!this.connection) {
+            return;
+        }
+        try {
+            await this.connection.stop();
+        }
+        catch (error) {
+            console.warn('[BaseSignalRClient] Error during disconnect:', error);
+        }
+        finally {
+            this.connection = null;
+            this.setConnectionState(ConnectionState.Disconnected);
+            this.connectionPromise = null;
+        }
+    }
+    /**
+     * Subscribe to a server event
+     */
+    on(event, handler) {
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, new Set());
+        }
+        this.eventHandlers.get(event).add(handler);
+        return () => this.off(event, handler);
+    }
+    /**
+     * Unsubscribe from a server event
+     */
+    off(event, handler) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+            if (handlers.size === 0) {
+                this.eventHandlers.delete(event);
+            }
+        }
+    }
+    /**
+     * Subscribe to an event once
+     */
+    once(event, handler) {
+        const wrappedHandler = (data) => {
+            this.off(event, wrappedHandler);
+            handler(data);
+        };
+        return this.on(event, wrappedHandler);
+    }
+    /**
+     * Invoke a hub method
+     */
+    async invoke(methodName, ...args) {
+        if (!this.connection || this.connectionState !== ConnectionState.Connected) {
+            throw new Error(`Cannot invoke ${methodName}: not connected to hub`);
+        }
+        try {
+            return await this.connection.invoke(methodName, ...args);
+        }
+        catch (error) {
+            throw new HubInvocationError(`Failed to invoke hub method: ${methodName}`, methodName, error);
+        }
+    }
+    /**
+     * Send a hub method without waiting for response
+     */
+    async send(methodName, ...args) {
+        if (!this.connection || this.connectionState !== ConnectionState.Connected) {
+            throw new Error(`Cannot send ${methodName}: not connected to hub`);
+        }
+        try {
+            await this.connection.send(methodName, ...args);
+        }
+        catch (error) {
+            throw new HubInvocationError(`Failed to send to hub method: ${methodName}`, methodName, error);
+        }
+    }
+    /**
+     * Emit event to local event handlers
+     */
+    emit(event, data) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.forEach((handler) => handler(data));
+        }
+    }
+    /**
+     * Perform the actual connection
+     */
+    async doConnect() {
+        this.setConnectionState(ConnectionState.Connecting);
+        try {
+            const token = await this.getToken();
+            this.connection = new signalR.HubConnectionBuilder()
+                .withUrl(this.hubUrl, {
+                accessTokenFactory: () => Promise.resolve(token || ''),
+                transport: signalR.HttpTransportType.WebSockets,
+                timeout: this.options.connectionTimeout,
+                withCredentials: false,
+            })
+                .withAutomaticReconnect(this.createReconnectPolicy())
+                .configureLogging(this.options.logLevel)
+                .build();
+            this.setupConnectionHandlers();
+            this.setupServerMethods();
+            await this.connection.start();
+            this.reconnectAttempts = 0;
+            this.setConnectionState(ConnectionState.Connected);
+        }
+        catch (error) {
+            this.setConnectionState(ConnectionState.Disconnected, error);
+            throw new ConnectionError(`Failed to connect to hub: ${this.hubUrl}`, this.hubUrl, error);
+        }
+        finally {
+            this.connectionPromise = null;
+        }
+    }
+    /**
+     * Setup connection event handlers
+     */
+    setupConnectionHandlers() {
+        if (!this.connection)
+            return;
+        this.connection.onclose((error) => {
+            this.setConnectionState(ConnectionState.Disconnected, error);
+        });
+        this.connection.onreconnecting((error) => {
+            this.setConnectionState(ConnectionState.Reconnecting, error);
+            this.reconnectAttempts++;
+        });
+        this.connection.onreconnected(() => {
+            this.reconnectAttempts = 0;
+            this.setConnectionState(ConnectionState.Connected);
+        });
+    }
+    /**
+     * Create reconnection policy with exponential backoff
+     */
+    createReconnectPolicy() {
+        const delays = this.options.reconnectDelays;
+        return {
+            nextRetryDelayInMilliseconds: (retryContext) => {
+                if (this.options.maxReconnectAttempts !== Infinity &&
+                    retryContext.previousRetryCount >= this.options.maxReconnectAttempts) {
+                    return null; // Stop reconnecting
+                }
+                // Use predefined delays or calculate exponential backoff
+                if (retryContext.previousRetryCount < delays.length) {
+                    return delays[retryContext.previousRetryCount];
+                }
+                // Max delay reached, use last delay value
+                return delays[delays.length - 1];
+            },
+        };
+    }
+    /**
+     * Set connection state and notify listeners
+     */
+    setConnectionState(state, error) {
+        this.connectionState = state;
+        this.stateChangeListeners.forEach((listener) => listener(state, error));
+    }
+    /**
+     * Cleanup resources
+     */
+    async destroy() {
+        await this.disconnect();
+        this.eventHandlers.clear();
+        this.stateChangeListeners.clear();
+    }
+}
+//# sourceMappingURL=BaseSignalRClient.js.map

package/dist/realtime/shared/BaseSignalRClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSignalRClient.js","sourceRoot":"","sources":["../../../src/realtime/shared/BaseSignalRClient.ts"],"names":[],"mappings":"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"}

package/dist/realtime/shared/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared SignalR Module
+ * Common base classes and types for all SignalR hub clients
+ */
+export * from './types';
+export * from './BaseSignalRClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/realtime/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/realtime/shared/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC"}

package/dist/realtime/shared/index.js

@@ -0,0 +1,7 @@
+/**
+ * Shared SignalR Module
+ * Common base classes and types for all SignalR hub clients
+ */
+export * from './types';
+export * from './BaseSignalRClient';
+//# sourceMappingURL=index.js.map

package/dist/realtime/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/realtime/shared/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC"}

package/dist/realtime/shared/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Shared SignalR Types
+ * Common types and interfaces for all SignalR hub clients
+ */
+import * as signalR from '@microsoft/signalr';
+/**
+ * Connection state enum
+ */
+export declare enum ConnectionState {
+    Disconnected = "Disconnected",
+    Connecting = "Connecting",
+    Connected = "Connected",
+    Reconnecting = "Reconnecting"
+}
+/**
+ * Event handler type for SignalR events
+ */
+export type EventHandler<T = unknown> = (data: T) => void;
+/**
+ * Hub method handler type
+ */
+export type HubMethodHandler<T = unknown> = (...args: unknown[]) => void | Promise<void>;
+/**
+ * Subscription handle for unsubscribing from events
+ */
+export type SubscriptionHandle = () => void;
+/**
+ * SignalR client configuration options
+ */
+export interface SignalRClientOptions {
+    /** SignalR log level (default: Warning) */
+    logLevel?: signalR.LogLevel;
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Maximum reconnection attempts (default: Infinity) */
+    maxReconnectAttempts?: number;
+    /** Custom reconnection delays in milliseconds */
+    reconnectDelays?: number[];
+    /** Connection timeout in milliseconds (default: 30000) */
+    connectionTimeout?: number;
+    /** Enable keep-alive ping (default: true) */
+    enableKeepAlive?: boolean;
+    /** Keep-alive interval in milliseconds (default: 15000) */
+    keepAliveInterval?: number;
+}
+/**
+ * Connection state change callback
+ */
+export type ConnectionStateChangeHandler = (state: ConnectionState, error?: Error) => void;
+/**
+ * Reconnection configuration with exponential backoff
+ */
+export interface ReconnectionConfig {
+    /** Initial delay in milliseconds */
+    initialDelay: number;
+    /** Maximum delay in milliseconds */
+    maxDelay: number;
+    /** Backoff multiplier */
+    multiplier: number;
+}
+/**
+ * Default reconnection configuration
+ */
+export declare const DEFAULT_RECONNECTION_CONFIG: ReconnectionConfig;
+/**
+ * Default SignalR client options
+ */
+export declare const DEFAULT_SIGNALR_OPTIONS: Required<SignalRClientOptions>;
+/**
+ * Hub invocation error
+ */
+export declare class HubInvocationError extends Error {
+    readonly methodName: string;
+    readonly originalError?: unknown;
+    constructor(message: string, methodName: string, originalError?: unknown);
+}
+/**
+ * Connection error
+ */
+export declare class ConnectionError extends Error {
+    readonly hubUrl: string;
+    readonly originalError?: unknown;
+    constructor(message: string, hubUrl: string, originalError?: unknown);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/realtime/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/realtime/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C;;GAEG;AACH,oBAAY,eAAe;IACzB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC;IAC5B,mDAAmD;IACnD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,kBAIzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,oBAAoB,CAQlE,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,UAAU,EAAE,MAAM;aAClB,aAAa,CAAC,EAAE,OAAO;gBAFvC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,OAAO;CAK1C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,MAAM,EAAE,MAAM;aACd,aAAa,CAAC,EAAE,OAAO;gBAFvC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,OAAO;CAK1C"}

package/dist/realtime/shared/types.js

@@ -0,0 +1,58 @@
+/**
+ * Shared SignalR Types
+ * Common types and interfaces for all SignalR hub clients
+ */
+import * as signalR from '@microsoft/signalr';
+/**
+ * Connection state enum
+ */
+export var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState["Disconnected"] = "Disconnected";
+    ConnectionState["Connecting"] = "Connecting";
+    ConnectionState["Connected"] = "Connected";
+    ConnectionState["Reconnecting"] = "Reconnecting";
+})(ConnectionState || (ConnectionState = {}));
+/**
+ * Default reconnection configuration
+ */
+export const DEFAULT_RECONNECTION_CONFIG = {
+    initialDelay: 2000, // 2 seconds
+    maxDelay: 30000, // 30 seconds
+    multiplier: 2, // Double each time
+};
+/**
+ * Default SignalR client options
+ */
+export const DEFAULT_SIGNALR_OPTIONS = {
+    logLevel: signalR.LogLevel.Warning,
+    autoReconnect: true,
+    maxReconnectAttempts: Infinity,
+    reconnectDelays: [2000, 4000, 8000, 16000, 30000], // Exponential backoff
+    connectionTimeout: 30000,
+    enableKeepAlive: true,
+    keepAliveInterval: 15000,
+};
+/**
+ * Hub invocation error
+ */
+export class HubInvocationError extends Error {
+    constructor(message, methodName, originalError) {
+        super(message);
+        this.methodName = methodName;
+        this.originalError = originalError;
+        this.name = 'HubInvocationError';
+    }
+}
+/**
+ * Connection error
+ */
+export class ConnectionError extends Error {
+    constructor(message, hubUrl, originalError) {
+        super(message);
+        this.hubUrl = hubUrl;
+        this.originalError = originalError;
+        this.name = 'ConnectionError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/realtime/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/realtime/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,gDAA6B,CAAA;IAC7B,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,gDAA6B,CAAA;AAC/B,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAsDD;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAuB;IAC7D,YAAY,EAAE,IAAI,EAAE,YAAY;IAChC,QAAQ,EAAE,KAAK,EAAK,aAAa;IACjC,UAAU,EAAE,CAAC,EAAO,mBAAmB;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmC;IACrE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAClC,aAAa,EAAE,IAAI;IACnB,oBAAoB,EAAE,QAAQ;IAC9B,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,sBAAsB;IACzE,iBAAiB,EAAE,KAAK;IACxB,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YACE,OAAe,EACC,UAAkB,EAClB,aAAuB;QAEvC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAClB,kBAAa,GAAb,aAAa,CAAU;QAGvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YACE,OAAe,EACC,MAAc,EACd,aAAuB;QAEvC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,kBAAa,GAAb,aAAa,CAAU;QAGvC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/realtime/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * WebSocket message types
+ */
+export declare enum WebSocketMessageType {
+    Notification = "Notification",
+    DataUpdate = "DataUpdate",
+    UserAction = "UserAction",
+    SystemEvent = "SystemEvent",
+    Chat = "Chat",
+    Presence = "Presence"
+}
+/**
+ * WebSocket message structure
+ */
+export interface WebSocketMessage<T = unknown> {
+    messageId: string;
+    type: WebSocketMessageType;
+    event: string;
+    data?: T;
+    timestamp: string;
+    senderId?: string;
+    targetId?: string;
+}
+/**
+ * Real-time event names
+ */
+export declare const RealTimeEvents: {
+    readonly SystemNotification: "system:notification";
+    readonly SystemMaintenance: "system:maintenance";
+    readonly DataCreated: "data:created";
+    readonly DataUpdated: "data:updated";
+    readonly DataDeleted: "data:deleted";
+    readonly UserLoggedIn: "user:logged_in";
+    readonly UserLoggedOut: "user:logged_out";
+    readonly UserStatusChanged: "user:status_changed";
+    readonly PurchaseRequestCreated: "procurement:request_created";
+    readonly PurchaseRequestApproved: "procurement:request_approved";
+    readonly PurchaseRequestRejected: "procurement:request_rejected";
+    readonly TaskAssigned: "task:assigned";
+    readonly TaskCompleted: "task:completed";
+    readonly TaskUpdated: "task:updated";
+    readonly MessageReceived: "chat:message_received";
+    readonly TypingStarted: "chat:typing_started";
+    readonly TypingStopped: "chat:typing_stopped";
+    readonly PresenceUpdated: "presence:updated";
+    readonly UserOnline: "presence:user_online";
+    readonly UserOffline: "presence:user_offline";
+};
+export type RealTimeEventName = typeof RealTimeEvents[keyof typeof RealTimeEvents];
+/**
+ * Connection state
+ */
+export declare enum ConnectionState {
+    Disconnected = "Disconnected",
+    Connecting = "Connecting",
+    Connected = "Connected",
+    Reconnecting = "Reconnecting"
+}
+/**
+ * Event handler type
+ */
+export type EventHandler<T = unknown> = (data: T, message: WebSocketMessage<T>) => void;
+/**
+ * Realtime client options
+ */
+export interface RealtimeClientOptions {
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Reconnect delay in ms (default: 3000) */
+    reconnectDelay?: number;
+    /** Max reconnect attempts (default: 10) */
+    maxReconnectAttempts?: number;
+    /** Ping interval in ms (default: 30000) */
+    pingInterval?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/realtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAkCjB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEnF;;GAEG;AACH,oBAAY,eAAe;IACzB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/realtime/types.js

@@ -0,0 +1,55 @@
+/**
+ * WebSocket message types
+ */
+export var WebSocketMessageType;
+(function (WebSocketMessageType) {
+    WebSocketMessageType["Notification"] = "Notification";
+    WebSocketMessageType["DataUpdate"] = "DataUpdate";
+    WebSocketMessageType["UserAction"] = "UserAction";
+    WebSocketMessageType["SystemEvent"] = "SystemEvent";
+    WebSocketMessageType["Chat"] = "Chat";
+    WebSocketMessageType["Presence"] = "Presence";
+})(WebSocketMessageType || (WebSocketMessageType = {}));
+/**
+ * Real-time event names
+ */
+export const RealTimeEvents = {
+    // System events
+    SystemNotification: 'system:notification',
+    SystemMaintenance: 'system:maintenance',
+    // Data events
+    DataCreated: 'data:created',
+    DataUpdated: 'data:updated',
+    DataDeleted: 'data:deleted',
+    // User events
+    UserLoggedIn: 'user:logged_in',
+    UserLoggedOut: 'user:logged_out',
+    UserStatusChanged: 'user:status_changed',
+    // Procurement events
+    PurchaseRequestCreated: 'procurement:request_created',
+    PurchaseRequestApproved: 'procurement:request_approved',
+    PurchaseRequestRejected: 'procurement:request_rejected',
+    // Task events
+    TaskAssigned: 'task:assigned',
+    TaskCompleted: 'task:completed',
+    TaskUpdated: 'task:updated',
+    // Chat/Messaging events
+    MessageReceived: 'chat:message_received',
+    TypingStarted: 'chat:typing_started',
+    TypingStopped: 'chat:typing_stopped',
+    // Presence events
+    PresenceUpdated: 'presence:updated',
+    UserOnline: 'presence:user_online',
+    UserOffline: 'presence:user_offline',
+};
+/**
+ * Connection state
+ */
+export var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState["Disconnected"] = "Disconnected";
+    ConnectionState["Connecting"] = "Connecting";
+    ConnectionState["Connected"] = "Connected";
+    ConnectionState["Reconnecting"] = "Reconnecting";
+})(ConnectionState || (ConnectionState = {}));
+//# sourceMappingURL=types.js.map

package/dist/realtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,qDAA6B,CAAA;IAC7B,iDAAyB,CAAA;IACzB,iDAAyB,CAAA;IACzB,mDAA2B,CAAA;IAC3B,qCAAa,CAAA;IACb,6CAAqB,CAAA;AACvB,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AAeD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,gBAAgB;IAChB,kBAAkB,EAAE,qBAAqB;IACzC,iBAAiB,EAAE,oBAAoB;IAEvC,cAAc;IACd,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,cAAc;IAE3B,cAAc;IACd,YAAY,EAAE,gBAAgB;IAC9B,aAAa,EAAE,iBAAiB;IAChC,iBAAiB,EAAE,qBAAqB;IAExC,qBAAqB;IACrB,sBAAsB,EAAE,6BAA6B;IACrD,uBAAuB,EAAE,8BAA8B;IACvD,uBAAuB,EAAE,8BAA8B;IAEvD,cAAc;IACd,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;IAC/B,WAAW,EAAE,cAAc;IAE3B,wBAAwB;IACxB,eAAe,EAAE,uBAAuB;IACxC,aAAa,EAAE,qBAAqB;IACpC,aAAa,EAAE,qBAAqB;IAEpC,kBAAkB;IAClB,eAAe,EAAE,kBAAkB;IACnC,UAAU,EAAE,sBAAsB;IAClC,WAAW,EAAE,uBAAuB;CAC5B,CAAC;AAIX;;GAEG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,gDAA6B,CAAA;IAC7B,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,gDAA6B,CAAA;AAC/B,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B"}

package/dist/services/base/BaseService.d.ts

@@ -0,0 +1,44 @@
+/**
+ * BaseService
+ * Abstract base class for all SDK services
+ * Handles URL construction, service path configuration, and endpoint overrides
+ */
+import { HttpClient } from '../../core/HttpClient';
+import { InternalServiceConfig } from '../types';
+/**
+ * Abstract base service class
+ * Provides URL construction and endpoint management for microservice routing
+ */
+export declare abstract class BaseService {
+    protected readonly http: HttpClient;
+    protected readonly servicePath: string;
+    protected readonly basePath: string;
+    protected readonly endpointOverrides: Record<string, string>;
+    constructor(http: HttpClient, config: InternalServiceConfig);
+    /**
+     * Get the endpoint path, checking for overrides
+     * @param key - The endpoint key (used for override lookup)
+     * @param defaultPath - The default endpoint path
+     * @returns The resolved endpoint path
+     */
+    protected getEndpoint(key: string, defaultPath: string): string;
+    /**
+     * Build the full URL path for an endpoint
+     * Combines service path and base path with the endpoint
+     *
+     * URL Pattern: /{servicePath}/{basePath}/{endpoint}
+     * Example: /task/api/task/list-view
+     *
+     * @param endpoint - The endpoint path (can be empty for base path)
+     * @returns The full URL path
+     */
+    protected buildUrl(endpoint?: string): string;
+    /**
+     * Build URL with query parameters
+     * @param endpoint - The endpoint path
+     * @param params - Query parameters object
+     * @returns The full URL path with query string
+     */
+    protected buildUrlWithParams(endpoint: string | undefined, params?: Record<string, string | number | boolean | undefined | null>): string;
+}
+//# sourceMappingURL=BaseService.d.ts.map

package/dist/services/base/BaseService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseService.d.ts","sourceRoot":"","sources":["../../../src/services/base/BaseService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,8BAAsB,WAAW;IAC/B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAEjD,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB;IAO3D;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAI/D;;;;;;;;;OASG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAoB7C;;;;;OAKG;IACH,SAAS,CAAC,kBAAkB,CAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,GACpE,MAAM;CAiBV"}