@synap-core/client 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @synap/client - Type-safe Client SDK for Synap
  *
- * Direct tRPC client export with full type safety.
+ * Direct tRPC client export with full type safety + real-time WebSocket support.
  * Auto-syncs with API changes via AppRouter type.
  *
  * @example
@@ -13,13 +13,24 @@
  *   headers: () => ({
  *     Authorization: `Bearer ${token}`,
  *   }),
+ *   realtime: {
+ *     userId: 'user-123',
+ *     userName: 'Alice',
+ *   },
  * });
  *
  * // Fully typed API calls
- * const entities = await client.entities.list.query({ limit: 20 });
- * const tag = await client.tags.create.mutate({ name: 'Important' });
+ * const entities = await client.trpc.entities.list.query({ limit: 20 });
+ * const tag = await client.trpc.tags.create.mutate({ name: 'Important' });
+ *
+ * // Real-time collaboration
+ * client.realtime?.connectPresence('view-id');
+ * const ydoc = client.realtime?.connectYjs('view-id');
  * ```
  */
+import { createTRPCClient } from '@trpc/client';
+import type { AppRouter } from '@synap/api';
+import { type RealtimeClient } from './realtime.js';
 /**
  * Configuration for Synap client
  */
@@ -39,6 +50,23 @@ export interface SynapClientConfig {
      * Useful for React Native or custom fetch behavior
      */
     fetch?: typeof globalThis.fetch;
+    /**
+     * Real-time configuration (optional)
+     * If provided, enables WebSocket-based real-time features
+     */
+    realtime?: {
+        userId: string;
+        userName: string;
+    };
+}
+/**
+ * Synap client return type
+ */
+export interface SynapClient {
+    /** tRPC client for API calls */
+    trpc: ReturnType<typeof createTRPCClient<AppRouter>>;
+    /** Real-time client for WebSocket features (if configured) */
+    realtime: RealtimeClient | null;
 }
 /**
  * Create a type-safe Synap API client
@@ -47,11 +75,11 @@ export interface SynapClientConfig {
  * providing full autocomplete and type safety for all routes.
  *
  * @param config - Client configuration
- * @returns Fully typed tRPC client
+ * @returns Client with tRPC and realtime support
  *
  * @example
  * ```typescript
- * // Basic usage
+ * // Basic usage (REST only)
  * const client = createSynapClient({
  *   url: 'https://api.synap.app',
  * });
@@ -64,1285 +92,21 @@ export interface SynapClientConfig {
  *   },
  * });
  *
- * // With dynamic headers
+ * // With real-time support
  * const client = createSynapClient({
  *   url: 'https://api.synap.app',
  *   headers: async () => ({
  *     Authorization: `Bearer ${await getToken()}`,
  *   }),
+ *   realtime: {
+ *     userId: 'user-123',
+ *     userName: 'Alice',
+ *   },
  * });
  * ```
  */
-export declare function createSynapClient(config: SynapClientConfig): import("@trpc/client").TRPCClient<import("@trpc/server").TRPCBuiltRouter<{
-    ctx: import("@synap/api").Context;
-    meta: object;
-    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-    transformer: false;
-}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-    events: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        log: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                eventType: string;
-                version: number;
-                data: Record<string, unknown>;
-                aggregateId: string;
-                aggregateType: "user" | "entity" | "relation" | "system";
-                source?: "system" | "api" | "automation" | "sync" | "migration" | undefined;
-                metadata?: Record<string, unknown> | undefined;
-                causationId?: string | undefined;
-                correlationId?: string | undefined;
-            };
-            output: import("@synap/database").EventRecord;
-            meta: object;
-        }>;
-        list: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                type?: string | undefined;
-                limit?: number | undefined;
-            };
-            output: import("@synap/database").EventRecord[];
-            meta: object;
-        }>;
-    }>>;
-    capture: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        thought: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                content: string;
-                context?: Record<string, any> | undefined;
-            };
-            output: {
-                success: boolean;
-                message: string;
-                requestId: string;
-                mode: string;
-            } | {
-                success: boolean;
-                message: string;
-                mode: string;
-                requestId?: undefined;
-            };
-            meta: object;
-        }>;
-    }>>;
-    entities: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        create: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                type: "note" | "task" | "project" | "contact" | "meeting" | "idea";
-                title: string;
-                description?: string | undefined;
-                fileUrl?: string | undefined;
-                filePath?: string | undefined;
-                fileSize?: number | undefined;
-                fileType?: string | undefined;
-            };
-            output: {
-                entity: {
-                    userId: string;
-                    version: number;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string | null;
-                    preview: string | null;
-                    documentId: string | null;
-                    fileUrl: string | null;
-                    filePath: string | null;
-                    fileSize: number | null;
-                    fileType: string | null;
-                    checksum: string | null;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                };
-            };
-            meta: object;
-        }>;
-        list: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                type?: "note" | "task" | "project" | "contact" | "meeting" | "idea" | undefined;
-                limit?: number | undefined;
-            };
-            output: {
-                entities: {
-                    userId: string;
-                    version: number;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string | null;
-                    preview: string | null;
-                    documentId: string | null;
-                    fileUrl: string | null;
-                    filePath: string | null;
-                    fileSize: number | null;
-                    fileType: string | null;
-                    checksum: string | null;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                }[];
-            };
-            meta: object;
-        }>;
-        search: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                query: string;
-                type?: "note" | "task" | "project" | "contact" | "meeting" | "idea" | undefined;
-                limit?: number | undefined;
-            };
-            output: {
-                entities: {
-                    userId: string;
-                    version: number;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string | null;
-                    preview: string | null;
-                    documentId: string | null;
-                    fileUrl: string | null;
-                    filePath: string | null;
-                    fileSize: number | null;
-                    fileType: string | null;
-                    checksum: string | null;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                }[];
-            };
-            meta: object;
-        }>;
-        get: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                id: string;
-            };
-            output: {
-                entity: {
-                    userId: string;
-                    version: number;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string | null;
-                    preview: string | null;
-                    documentId: string | null;
-                    fileUrl: string | null;
-                    filePath: string | null;
-                    fileSize: number | null;
-                    fileType: string | null;
-                    checksum: string | null;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                };
-            };
-            meta: object;
-        }>;
-        update: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                id: string;
-                description?: string | undefined;
-                title?: string | undefined;
-            };
-            output: {
-                entity: {
-                    userId: string;
-                    version: number;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string | null;
-                    preview: string | null;
-                    documentId: string | null;
-                    fileUrl: string | null;
-                    filePath: string | null;
-                    fileSize: number | null;
-                    fileType: string | null;
-                    checksum: string | null;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                };
-            };
-            meta: object;
-        }>;
-        delete: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                id: string;
-            };
-            output: {
-                success: boolean;
-            };
-            meta: object;
-        }>;
-    }>>;
-    notes: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        create: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                content: string;
-                tags?: string[] | undefined;
-                title?: string | undefined;
-            };
-            output: {
-                success: boolean;
-                status: "pending";
-                requestId: `${string}-${string}-${string}-${string}-${string}`;
-                entityId: `${string}-${string}-${string}-${string}-${string}`;
-                message: string;
-            };
-            meta: object;
-        }>;
-        list: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                type?: "note" | "task" | "all" | undefined;
-                limit?: number | undefined;
-                offset?: number | undefined;
-            };
-            output: {
-                notes: {
-                    id: any;
-                    title: any;
-                    preview: any;
-                    type: any;
-                    fileUrl: any;
-                    filePath: any;
-                    fileSize: any;
-                    fileType: any;
-                    createdAt: any;
-                    updatedAt: any;
-                }[];
-                total: number;
-                limit: number;
-                offset: number;
-            };
-            meta: object;
-        }>;
-        getById: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                id: string;
-            };
-            output: {
-                id: any;
-                title: any;
-                preview: any;
-                type: any;
-                fileUrl: any;
-                filePath: any;
-                fileSize: any;
-                fileType: any;
-                checksum: any;
-                createdAt: any;
-                updatedAt: any;
-            } | null;
-            meta: object;
-        }>;
-    }>>;
-    chat: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{}>>;
-    suggestions: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{}>>;
-    system: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        getCapabilities: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                eventTypes: ({
-                    type: import("@synap/events").GeneratedEventType;
-                    hasSchema: boolean;
-                    category: "generated";
-                    table: string | undefined;
-                    action: import("@synap/events").TableAction | undefined;
-                } | {
-                    type: "webhooks.deliver.requested";
-                    hasSchema: boolean;
-                    category: "custom";
-                })[];
-                workers: import("@synap/jobs").WorkerMetadata[];
-                tools: {
-                    name: string;
-                    description: string | undefined;
-                    version: string;
-                    source: string;
-                }[];
-                routers: {
-                    name: string;
-                    version: string;
-                    source: string;
-                    description: string | undefined;
-                }[];
-                stats: {
-                    totalEventTypes: number;
-                    totalHandlers: number;
-                    totalTools: number;
-                    totalRouters: number;
-                    connectedSSEClients: number;
-                    toolsBySource: Record<string, number>;
-                    routersBySource: Record<string, number>;
-                };
-            };
-            meta: object;
-        }>;
-        getEventTypeSchema: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                eventType: string;
-            };
-            output: {
-                hasSchema: boolean;
-                fields: null;
-            } | {
-                hasSchema: boolean;
-                fields: {
-                    name: string;
-                    type: string;
-                    required: boolean;
-                    description?: string;
-                    options?: string[];
-                    defaultValue?: unknown;
-                }[];
-            };
-            meta: object;
-        }>;
-        publishEvent: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                userId: string;
-                data: Record<string, unknown>;
-                type: string;
-                source?: "system" | "api" | "automation" | "sync" | "migration" | undefined;
-                aggregateId?: string | undefined;
-                causationId?: string | undefined;
-                correlationId?: string | undefined;
-            };
-            output: {
-                success: boolean;
-                eventId: string;
-                timestamp: string;
-                message: string;
-            };
-            meta: object;
-        }>;
-        getRecentEvents: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                userId?: string | undefined;
-                eventType?: string | undefined;
-                limit?: number | undefined;
-                since?: string | undefined;
-            };
-            output: {
-                events: {
-                    id: string;
-                    type: string;
-                    userId: string;
-                    timestamp: string;
-                    correlationId: string | undefined;
-                    isError: boolean;
-                }[];
-                total: number;
-                timestamp: string;
-            };
-            meta: object;
-        }>;
-        getTrace: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                correlationId: string;
-            };
-            output: {
-                correlationId: string;
-                events: {
-                    id: string;
-                    type: string;
-                    timestamp: string;
-                    userId: string;
-                    aggregateId: string;
-                    data: Record<string, unknown>;
-                    metadata: Record<string, unknown> | undefined;
-                    causationId: string | undefined;
-                }[];
-                totalEvents: number;
-            };
-            meta: object;
-        }>;
-        getEventTrace: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                eventId: string;
-            };
-            output: {
-                event: {
-                    eventId: string;
-                    eventType: string;
-                    timestamp: string;
-                    userId: string;
-                    data: Record<string, unknown>;
-                    metadata: Record<string, unknown> | undefined;
-                    correlationId: string | undefined;
-                };
-                relatedEvents: {
-                    eventId: string;
-                    eventType: string;
-                    timestamp: string;
-                    userId: string;
-                    data: Record<string, unknown>;
-                    correlationId: string | undefined;
-                }[];
-            };
-            meta: object;
-        }>;
-        searchEvents: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                userId?: string | undefined;
-                eventType?: string | undefined;
-                aggregateId?: string | undefined;
-                aggregateType?: string | undefined;
-                correlationId?: string | undefined;
-                limit?: number | undefined;
-                fromDate?: string | undefined;
-                toDate?: string | undefined;
-                offset?: number | undefined;
-            };
-            output: {
-                events: {
-                    id: string;
-                    type: string;
-                    timestamp: string;
-                    userId: string;
-                    aggregateId: string;
-                    aggregateType: string;
-                    data: Record<string, unknown>;
-                    metadata: Record<string, unknown> | undefined;
-                    causationId: string | undefined;
-                    correlationId: string | undefined;
-                    source: string;
-                }[];
-                pagination: {
-                    total: number;
-                    limit: number;
-                    offset: number;
-                    hasMore: boolean;
-                };
-            };
-            meta: object;
-        }>;
-        getToolSchema: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                toolName: string;
-            };
-            output: {
-                name: string;
-                description: string;
-                schema: {
-                    type: string;
-                    properties: any;
-                    required: string[];
-                };
-                metadata: {
-                    version: string;
-                    source: string;
-                    registeredAt: string | undefined;
-                };
-            };
-            meta: object;
-        }>;
-        executeTool: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                userId: string;
-                toolName: string;
-                parameters: Record<string, any>;
-                threadId?: string | undefined;
-            };
-            output: {
-                success: boolean;
-                result: {
-                    result: any;
-                };
-                toolName: string;
-                executedAt: string;
-            };
-            meta: object;
-        }>;
-        getDashboardMetrics: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                timestamp: string;
-                health: {
-                    status: "healthy" | "degraded" | "critical";
-                    errorRate: number;
-                };
-                throughput: {
-                    eventsPerSecond: number;
-                    totalEventsLast5Min: number;
-                };
-                connections: {
-                    activeSSEClients: number;
-                    activeHandlers: number;
-                };
-                tools: {
-                    totalTools: number;
-                    totalExecutions: number;
-                };
-                latestEvents: {
-                    id: string;
-                    type: string;
-                    userId: string;
-                    timestamp: string;
-                    isError: boolean;
-                }[];
-            };
-            meta: object;
-        }>;
-        getDatabaseTables: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: Record<string, unknown>[];
-            meta: object;
-        }>;
-        getDatabaseTableRows: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                tableName: string;
-                limit?: number | undefined;
-                offset?: number | undefined;
-            };
-            output: import("postgres").RowList<Record<string, unknown>[]>;
-            meta: object;
-        }>;
-    }>>;
-    hub: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        generateAccessToken: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                requestId: string;
-                scope: ("entities" | "preferences" | "calendar" | "notes" | "tasks" | "projects" | "conversations" | "relations" | "knowledge_facts")[];
-                expiresIn?: number | undefined;
-            };
-            output: {
-                token: string;
-                expiresAt: number;
-                requestId: string;
-            };
-            meta: object;
-        }>;
-        requestData: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                scope: ("entities" | "preferences" | "calendar" | "notes" | "tasks" | "projects" | "conversations" | "relations" | "knowledge_facts")[];
-                token: string;
-                filters?: {
-                    limit?: number | undefined;
-                    offset?: number | undefined;
-                    dateRange?: {
-                        start: string;
-                        end: string;
-                    } | undefined;
-                    entityTypes?: string[] | undefined;
-                } | undefined;
-            };
-            output: {
-                userId: string;
-                requestId: string;
-                data: Record<string, unknown>;
-                metadata: {
-                    retrievedAt: string;
-                    scope: ("entities" | "preferences" | "calendar" | "notes" | "tasks" | "projects" | "conversations" | "relations" | "knowledge_facts")[];
-                    recordCount: number;
-                };
-            };
-            meta: object;
-        }>;
-        submitInsight: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                token: string;
-                insight?: any;
-            };
-            output: {
-                success: boolean;
-                requestId: string;
-                eventIds: string[];
-                eventsCreated: number;
-                errors: {
-                    actionIndex: number;
-                    error: string;
-                }[] | undefined;
-            };
-            meta: object;
-        }>;
-    }>>;
-    apiKeys: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        create: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                scope: string[];
-                keyName: string;
-                hubId?: string | undefined;
-                expiresInDays?: number | undefined;
-            };
-            output: {
-                success: boolean;
-                key: string;
-                keyId: string;
-                message: string;
-            };
-            meta: object;
-        }>;
-        list: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                id: string;
-                keyName: string;
-                keyPrefix: string;
-                hubId: string | null;
-                scope: string[];
-                isActive: boolean;
-                expiresAt: Date | null;
-                lastUsedAt: Date | null;
-                usageCount: number;
-                rotationScheduledAt: Date | null;
-                createdAt: Date;
-                revokedAt: Date | null;
-                revokedReason: string | null;
-            }[];
-            meta: object;
-        }>;
-        revoke: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                keyId: string;
-                reason?: string | undefined;
-            };
-            output: {
-                success: boolean;
-                message: string;
-            };
-            meta: object;
-        }>;
-        rotate: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                keyId: string;
-            };
-            output: {
-                success: boolean;
-                newKey: string;
-                newKeyId: string;
-                message: string;
-            };
-            meta: object;
-        }>;
-    }>>;
-    health: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        alive: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                status: string;
-                timestamp: string;
-            };
-            meta: object;
-        }>;
-        ready: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                status: string;
-                timestamp: string;
-                checks: {
-                    database: string;
-                    inngest: string;
-                };
-                details: {
-                    database: any;
-                    inngest: any;
-                };
-            };
-            meta: object;
-        }>;
-        migrations: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                total: number;
-                migrations: {
-                    version: string;
-                    appliedAt: string;
-                    description: string;
-                }[];
-                note: string;
-            };
-            meta: object;
-        }>;
-        metrics: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                timestamp: string;
-                uptime: number;
-                memory: {
-                    used: number;
-                    total: number;
-                    rss: number;
-                };
-                events24h: number;
-                totalEntities: number;
-            };
-            meta: object;
-        }>;
-    }>>;
-    webhooks: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        create: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                url: string;
-                name: string;
-                eventTypes: string[];
-                secret?: string | undefined;
-            };
-            output: {
-                subscription: {
-                    userId: string;
-                    url: string;
-                    name: string;
-                    id: string;
-                    eventTypes: string[];
-                    createdAt: Date;
-                    active: boolean;
-                    secret: string;
-                    retryConfig: unknown;
-                    lastTriggeredAt: Date | null;
-                };
-                secret: string;
-            };
-            meta: object;
-        }>;
-        list: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                userId: string;
-                url: string;
-                name: string;
-                id: string;
-                eventTypes: string[];
-                createdAt: Date;
-                active: boolean;
-                retryConfig: unknown;
-                lastTriggeredAt: Date | null;
-            }[];
-            meta: object;
-        }>;
-        update: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                id: string;
-                url?: string | undefined;
-                name?: string | undefined;
-                eventTypes?: string[] | undefined;
-                active?: boolean | undefined;
-            };
-            output: {
-                userId: string;
-                url: string;
-                name: string;
-                id: string;
-                eventTypes: string[];
-                createdAt: Date;
-                active: boolean;
-                retryConfig: unknown;
-                lastTriggeredAt: Date | null;
-            };
-            meta: object;
-        }>;
-        delete: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                id: string;
-            };
-            output: {
-                success: boolean;
-            };
-            meta: object;
-        }>;
-    }>>;
-    documents: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        upload: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                type: "code" | "text" | "markdown" | "pdf" | "docx";
-                content: string;
-                title: string;
-                language?: string | undefined;
-                mimeType?: string | undefined;
-                projectId?: string | undefined;
-            };
-            output: {
-                documentId: string;
-                storageUrl: string;
-                version: number;
-            };
-            meta: object;
-        }>;
-        get: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                documentId: string;
-            };
-            output: {
-                document: {
-                    userId: string;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                    language: string | null;
-                    storageUrl: string;
-                    storageKey: string;
-                    size: number;
-                    mimeType: string | null;
-                    currentVersion: number;
-                    projectId: string | null;
-                };
-                content: string;
-            };
-            meta: object;
-        }>;
-        update: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                version: number;
-                documentId: string;
-                delta: {
-                    content: string;
-                }[];
-                message?: string | undefined;
-            };
-            output: {
-                version: number;
-                success: boolean;
-            };
-            meta: object;
-        }>;
-        startSession: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                documentId: string;
-            };
-            output: {
-                sessionId: string;
-                chatThreadId: `${string}-${string}-${string}-${string}-${string}`;
-            };
-            meta: object;
-        }>;
-        list: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                type?: "code" | "text" | "markdown" | "pdf" | "docx" | undefined;
-                limit?: number | undefined;
-                projectId?: string | undefined;
-            };
-            output: {
-                documents: {
-                    userId: string;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                    language: string | null;
-                    storageUrl: string;
-                    storageKey: string;
-                    size: number;
-                    mimeType: string | null;
-                    currentVersion: number;
-                    projectId: string | null;
-                }[];
-                total: number;
-            };
-            meta: object;
-        }>;
-    }>>;
-    content: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        createFromText: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                content: string;
-                targetType: "note" | "task";
-                metadata?: {
-                    tags?: string[] | undefined;
-                    title?: string | undefined;
-                } | undefined;
-            };
-            output: {
-                success: boolean;
-                status: "pending";
-                requestId: `${string}-${string}-${string}-${string}-${string}`;
-                entityId: `${string}-${string}-${string}-${string}-${string}`;
-            };
-            meta: object;
-        }>;
-        createFromFile: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                targetType: "note" | "document";
-                file: string;
-                filename: string;
-                contentType: string;
-                metadata?: {
-                    description?: string | undefined;
-                    tags?: string[] | undefined;
-                    title?: string | undefined;
-                } | undefined;
-            };
-            output: any;
-            meta: object;
-        }>;
-    }>>;
-    files: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        listBuckets: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                buckets: {
-                    name: string;
-                    createdAt: string | null;
-                }[];
-            };
-            meta: object;
-        }>;
-        listFiles: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                maxKeys?: number | undefined;
-            };
-            output: {
-                items: ({
-                    type: "folder";
-                    name: string;
-                    path: string;
-                } | {
-                    type: "file";
-                    name: string;
-                    path: string;
-                    size: number;
-                    lastModified: string | null;
-                })[];
-                totalItems: number;
-                prefix: string;
-                bucket: string;
-                isTruncated: boolean;
-                error?: undefined;
-            } | {
-                items: never[];
-                totalItems: number;
-                prefix: string;
-                bucket: string;
-                isTruncated: boolean;
-                error: string;
-            };
-            meta: object;
-        }>;
-        getFileMetadata: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                path: string;
-            };
-            output: {
-                success: boolean;
-                path: string;
-                size: number;
-                lastModified: string;
-                contentType: string;
-                error?: undefined;
-            } | {
-                success: boolean;
-                path: string;
-                error: string;
-                size?: undefined;
-                lastModified?: undefined;
-                contentType?: undefined;
-            };
-            meta: object;
-        }>;
-        getDownloadUrl: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                path: string;
-                expiresIn?: number | undefined;
-            };
-            output: {
-                success: boolean;
-                url: string;
-                expiresIn: number;
-                error?: undefined;
-            } | {
-                success: boolean;
-                error: string;
-                url?: undefined;
-                expiresIn?: undefined;
-            };
-            meta: object;
-        }>;
-        exists: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                path: string;
-            };
-            output: {
-                exists: boolean;
-                path: string;
-            };
-            meta: object;
-        }>;
-        deleteFile: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                path: string;
-            };
-            output: {
-                success: boolean;
-                path: string;
-                error?: undefined;
-            } | {
-                success: boolean;
-                path: string;
-                error: string;
-            };
-            meta: object;
-        }>;
-    }>>;
-    tags: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        list: import("@trpc/server").TRPCQueryProcedure<{
-            input: void;
-            output: {
-                tags: {
-                    userId: string;
-                    name: string;
-                    id: string;
-                    createdAt: Date;
-                    color: string | null;
-                }[];
-            };
-            meta: object;
-        }>;
-        create: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                name: string;
-                color?: string | undefined;
-            };
-            output: {
-                tag: {
-                    userId: string;
-                    name: string;
-                    id: string;
-                    createdAt: Date;
-                    color: string | null;
-                };
-            };
-            meta: object;
-        }>;
-        update: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                id: string;
-                name?: string | undefined;
-                color?: string | undefined;
-            };
-            output: {
-                tag: {
-                    userId: string;
-                    name: string;
-                    id: string;
-                    createdAt: Date;
-                    color: string | null;
-                };
-            };
-            meta: object;
-        }>;
-        delete: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                id: string;
-            };
-            output: {
-                success: boolean;
-            };
-            meta: object;
-        }>;
-        attach: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                entityId: string;
-                tagId: string;
-            };
-            output: {
-                success: boolean;
-            };
-            meta: object;
-        }>;
-        detach: import("@trpc/server").TRPCMutationProcedure<{
-            input: {
-                entityId: string;
-                tagId: string;
-            };
-            output: {
-                success: boolean;
-            };
-            meta: object;
-        }>;
-        getForEntity: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                entityId: string;
-            };
-            output: {
-                tags: any[];
-            };
-            meta: object;
-        }>;
-        getEntitiesWithTag: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                tagId: string;
-                limit?: number | undefined;
-            };
-            output: {
-                entities: any[];
-            };
-            meta: object;
-        }>;
-    }>>;
-    search: import("@trpc/server").TRPCBuiltRouter<{
-        ctx: import("@synap/api").Context;
-        meta: object;
-        errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-        transformer: false;
-    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-        entities: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                query: string;
-                type?: "note" | "task" | "project" | "document" | undefined;
-                limit?: number | undefined;
-            };
-            output: {
-                entities: {
-                    userId: string;
-                    version: number;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string | null;
-                    preview: string | null;
-                    documentId: string | null;
-                    fileUrl: string | null;
-                    filePath: string | null;
-                    fileSize: number | null;
-                    fileType: string | null;
-                    checksum: string | null;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                }[];
-            };
-            meta: object;
-        }>;
-        semantic: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                query: string;
-                type?: "note" | "task" | "project" | "document" | undefined;
-                limit?: number | undefined;
-                threshold?: number | undefined;
-            };
-            output: {
-                entities: never[];
-                message: string;
-            };
-            meta: object;
-        }>;
-        related: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                entityId: string;
-                limit?: number | undefined;
-            };
-            output: {
-                entities: {
-                    userId: string;
-                    version: number;
-                    metadata: unknown;
-                    id: string;
-                    type: string;
-                    title: string | null;
-                    preview: string | null;
-                    documentId: string | null;
-                    fileUrl: string | null;
-                    filePath: string | null;
-                    fileSize: number | null;
-                    fileType: string | null;
-                    checksum: string | null;
-                    createdAt: Date;
-                    updatedAt: Date;
-                    deletedAt: Date | null;
-                }[];
-            };
-            meta: object;
-        }>;
-        byTags: import("@trpc/server").TRPCQueryProcedure<{
-            input: {
-                tagIds: string[];
-                limit?: number | undefined;
-            };
-            output: {
-                entities: any[];
-            };
-            meta: object;
-        }>;
-    }>>;
-}>>>;
-/**
- * Type alias for the Synap TRP client
- */
-export type SynapClient = ReturnType<typeof createSynapClient>;
+export declare function createSynapClient(config: SynapClientConfig): SynapClient;
 export type { AppRouter } from '@synap/api';
 export type { TRPCClient } from '@trpc/client';
+export type { RealtimeClient } from './realtime.js';
 export default createSynapClient;