@raisindb/client 0.1.5 → 0.1.17

package/dist/svelte.d.mts

@@ -0,0 +1,288 @@
+import { f as ConversationStoreOptions, c as ConversationStore, a as ConversationStoreSnapshot, b as ChatMessage, g as ConversationListStoreOptions, e as ConversationListStore, h as ConversationListSnapshot, d as ConversationListItem, R as RaisinClient, I as IdentityUser, C as ConnectionState, D as Database, S as SubscriptionFilters, E as EventMessage, A as AuthManager, F as FlowClientOptions, i as FlowsApi, j as FlowExecutionEvent } from './conversation-list-store-CNcVagmw.mjs';
+export { b as SqlAdapter, S as SqlAdapterOptions, a as SqlSnapshot, c as createSqlAdapter } from './svelte-sql-CgT-Ij-P.mjs';
+import 'events';
+import 'fs/promises';
+
+/**
+ * Create a conversation store adapter for Svelte 5.
+ *
+ * Returns an object with the store, a snapshot getter, actions, and a
+ * destroy function. In a `.svelte.ts` file, bind `snapshot` to `$state`
+ * to get fine-grained reactivity.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createConversationAdapter({ database: db, conversationPath: path });
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ * // ...later
+ * adapter.destroy();
+ * ```
+ */
+declare function createConversationAdapter(options: ConversationStoreOptions): {
+    /** The underlying ConversationStore instance */
+    store: ConversationStore;
+    /** Get the current snapshot */
+    getSnapshot: () => ConversationStoreSnapshot;
+    /** Subscribe to snapshot changes. Returns unsubscribe function. */
+    subscribe: (cb: (s: ConversationStoreSnapshot) => void) => () => void;
+    /** Send a user message */
+    sendMessage: (content: string) => Promise<void>;
+    /** Load persisted messages */
+    loadMessages: () => Promise<ChatMessage[]>;
+    /** Approve a pending plan */
+    approvePlan: (planPath: string) => Promise<void>;
+    /** Reject a pending plan */
+    rejectPlan: (planPath: string, feedback?: string) => Promise<void>;
+    /** Mark a message as read */
+    markMessageAsRead: (messagePath: string) => Promise<void>;
+    /** Stop streaming */
+    stop: () => void;
+    /** Get the conversation path */
+    getConversationPath: () => string | null;
+    /** Destroy the store and release resources */
+    destroy: () => void;
+};
+/**
+ * Create a conversation list store adapter for Svelte 5.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createConversationListAdapter({ database: db, realtime: true });
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ * await adapter.load();
+ * ```
+ */
+declare function createConversationListAdapter(options: ConversationListStoreOptions): {
+    /** The underlying ConversationListStore instance */
+    store: ConversationListStore;
+    /** Get the current snapshot */
+    getSnapshot: () => ConversationListSnapshot;
+    /** Subscribe to snapshot changes. Returns unsubscribe function. */
+    subscribe: (cb: (s: ConversationListSnapshot) => void) => () => void;
+    /** Load conversations from the server */
+    load: () => Promise<void>;
+    /** Create a new conversation */
+    createConversation: (opts: {
+        participant: string;
+        subject?: string;
+        input?: Record<string, unknown>;
+    }) => Promise<ConversationListItem>;
+    /** Delete a conversation */
+    deleteConversation: (path: string) => Promise<void>;
+    /** Mark a conversation as read */
+    markAsRead: (path: string) => Promise<void>;
+    /** Get or create a ConversationStore for a specific path */
+    getConversationStore: (path: string) => ConversationStore;
+    /** Destroy the store and release resources */
+    destroy: () => void;
+};
+
+interface AuthSnapshot {
+    user: IdentityUser | null;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+}
+interface AuthAdapter {
+    subscribe: (cb: (snapshot: AuthSnapshot) => void) => () => void;
+    getSnapshot: () => AuthSnapshot;
+    login: (email: string, password: string, repository: string) => Promise<IdentityUser>;
+    register: (email: string, password: string, repository: string, displayName?: string) => Promise<IdentityUser>;
+    logout: (options?: {
+        disconnect?: boolean;
+        reconnect?: boolean;
+    }) => Promise<void>;
+    initSession: (repository: string) => Promise<IdentityUser | null>;
+    destroy: () => void;
+}
+/**
+ * Create an auth adapter for Svelte 5.
+ *
+ * Returns a plain object with `subscribe`, `getSnapshot`, auth actions, and `destroy`.
+ * Bind `getSnapshot()` to `$state` in a `.svelte.ts` file for reactivity.
+ *
+ * @example
+ * ```typescript
+ * // lib/auth.svelte.ts
+ * import { createAuthAdapter } from '@raisindb/client/svelte';
+ * import { client } from '$lib/raisin';
+ *
+ * const adapter = createAuthAdapter(client);
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ *
+ * export const auth = {
+ *   get user() { return snapshot.user; },
+ *   get isAuthenticated() { return snapshot.isAuthenticated; },
+ *   get isLoading() { return snapshot.isLoading; },
+ *   login: adapter.login,
+ *   register: adapter.register,
+ *   logout: adapter.logout,
+ *   initSession: adapter.initSession,
+ * };
+ * ```
+ */
+declare function createAuthAdapter(client: RaisinClient): AuthAdapter;
+
+interface ConnectionSnapshot {
+    state: ConnectionState;
+    isConnected: boolean;
+    isReady: boolean;
+}
+interface ConnectionAdapter {
+    subscribe: (cb: (snapshot: ConnectionSnapshot) => void) => () => void;
+    getSnapshot: () => ConnectionSnapshot;
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    destroy: () => void;
+}
+/**
+ * Create a connection adapter for Svelte 5.
+ *
+ * Tracks WebSocket connection state and ready state. Bind to `$state` in
+ * a `.svelte.ts` file for reactivity.
+ *
+ * @example
+ * ```typescript
+ * // lib/connection.svelte.ts
+ * import { createConnectionAdapter } from '@raisindb/client/svelte';
+ * import { client } from '$lib/raisin';
+ *
+ * const adapter = createConnectionAdapter(client);
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ *
+ * export const connection = {
+ *   get state() { return snapshot.state; },
+ *   get isConnected() { return snapshot.isConnected; },
+ *   get isReady() { return snapshot.isReady; },
+ *   connect: adapter.connect,
+ *   disconnect: adapter.disconnect,
+ * };
+ * ```
+ */
+declare function createConnectionAdapter(client: RaisinClient): ConnectionAdapter;
+
+interface SubscriptionAdapter {
+    destroy: () => void;
+}
+/**
+ * Create an event subscription adapter for Svelte 5.
+ *
+ * Pure side-effect adapter — subscribes to database events and invokes the
+ * callback on each matching event. Call `destroy()` to unsubscribe.
+ *
+ * @example
+ * ```typescript
+ * // In a .svelte component's script block or .svelte.ts file
+ * import { createSubscriptionAdapter } from '@raisindb/client/svelte';
+ * import { db } from '$lib/raisin';
+ *
+ * const sub = createSubscriptionAdapter(
+ *   db,
+ *   { workspace: 'content', node_type: 'Post' },
+ *   (event) => { console.log('Post changed:', event); },
+ * );
+ *
+ * // In onDestroy or $effect cleanup:
+ * sub.destroy();
+ * ```
+ */
+declare function createSubscriptionAdapter(database: Database, filters: SubscriptionFilters, callback: (event: EventMessage) => void): SubscriptionAdapter;
+
+type FlowStatus = 'idle' | 'running' | 'waiting' | 'completed' | 'failed';
+interface FlowSnapshot {
+    events: FlowExecutionEvent[];
+    status: FlowStatus;
+    isRunning: boolean;
+    error: string | null;
+    output: unknown | null;
+    instanceId: string | null;
+}
+interface FlowAdapterOptions {
+    database?: Database;
+    baseUrl?: string;
+    repository?: string;
+    authManager?: AuthManager;
+    clientOptions?: FlowClientOptions;
+    flowsApi?: FlowsApi;
+}
+interface FlowAdapter {
+    subscribe: (cb: (snapshot: FlowSnapshot) => void) => () => void;
+    getSnapshot: () => FlowSnapshot;
+    run: (flowPath: string, input?: Record<string, unknown>) => Promise<void>;
+    resume: (data: unknown) => Promise<void>;
+    reset: () => void;
+    destroy: () => void;
+}
+/**
+ * Create a flow execution adapter for Svelte 5.
+ *
+ * Manages the full flow lifecycle: starting, streaming events, resuming
+ * waiting flows, and tracking completion. Bind snapshot to `$state` for reactivity.
+ *
+ * @example
+ * ```typescript
+ * // lib/flow.svelte.ts
+ * import { createFlowAdapter } from '@raisindb/client/svelte';
+ * import { db } from '$lib/raisin';
+ *
+ * const adapter = createFlowAdapter({ database: db });
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ *
+ * export const flow = {
+ *   get events() { return snapshot.events; },
+ *   get status() { return snapshot.status; },
+ *   get isRunning() { return snapshot.isRunning; },
+ *   get error() { return snapshot.error; },
+ *   get output() { return snapshot.output; },
+ *   run: adapter.run,
+ *   resume: adapter.resume,
+ *   reset: adapter.reset,
+ * };
+ * ```
+ */
+declare function createFlowAdapter(options: FlowAdapterOptions): FlowAdapter;
+
+/**
+ * Context value for the RaisinDB Svelte integration.
+ *
+ * Use with Svelte's `setContext`/`getContext` in `.svelte` files.
+ *
+ * @example Setup in `+layout.svelte`:
+ * ```svelte
+ * <script>
+ *   import { setContext } from 'svelte';
+ *   import { RAISIN_CONTEXT_KEY, type RaisinContext } from '@raisindb/client/svelte';
+ *   import { client } from '$lib/raisin';
+ *
+ *   setContext<RaisinContext>(RAISIN_CONTEXT_KEY, { client, repository: 'myrepo' });
+ * </script>
+ *
+ * {@render children()}
+ * ```
+ *
+ * @example Usage in a child component:
+ * ```svelte
+ * <script>
+ *   import { getContext } from 'svelte';
+ *   import { RAISIN_CONTEXT_KEY, type RaisinContext } from '@raisindb/client/svelte';
+ *
+ *   const { client, repository } = getContext<RaisinContext>(RAISIN_CONTEXT_KEY);
+ *   const db = client.database(repository!);
+ * </script>
+ * ```
+ */
+interface RaisinContext {
+    client: RaisinClient;
+    repository?: string;
+}
+/**
+ * Shared context key for RaisinDB. Use this with `setContext` and `getContext`
+ * to ensure consistent key usage across your application.
+ */
+declare const RAISIN_CONTEXT_KEY: unique symbol;
+
+export { type AuthAdapter, type AuthSnapshot, type ConnectionAdapter, type ConnectionSnapshot, type FlowAdapter, type FlowAdapterOptions, type FlowSnapshot, type FlowStatus, RAISIN_CONTEXT_KEY, type RaisinContext, type SubscriptionAdapter, createAuthAdapter, createConnectionAdapter, createConversationAdapter, createConversationListAdapter, createFlowAdapter, createSubscriptionAdapter };

package/dist/svelte.d.ts

@@ -0,0 +1,288 @@
+import { f as ConversationStoreOptions, c as ConversationStore, a as ConversationStoreSnapshot, b as ChatMessage, g as ConversationListStoreOptions, e as ConversationListStore, h as ConversationListSnapshot, d as ConversationListItem, R as RaisinClient, I as IdentityUser, C as ConnectionState, D as Database, S as SubscriptionFilters, E as EventMessage, A as AuthManager, F as FlowClientOptions, i as FlowsApi, j as FlowExecutionEvent } from './conversation-list-store-CNcVagmw.js';
+export { b as SqlAdapter, S as SqlAdapterOptions, a as SqlSnapshot, c as createSqlAdapter } from './svelte-sql-62EaYoeM.js';
+import 'events';
+import 'fs/promises';
+
+/**
+ * Create a conversation store adapter for Svelte 5.
+ *
+ * Returns an object with the store, a snapshot getter, actions, and a
+ * destroy function. In a `.svelte.ts` file, bind `snapshot` to `$state`
+ * to get fine-grained reactivity.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createConversationAdapter({ database: db, conversationPath: path });
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ * // ...later
+ * adapter.destroy();
+ * ```
+ */
+declare function createConversationAdapter(options: ConversationStoreOptions): {
+    /** The underlying ConversationStore instance */
+    store: ConversationStore;
+    /** Get the current snapshot */
+    getSnapshot: () => ConversationStoreSnapshot;
+    /** Subscribe to snapshot changes. Returns unsubscribe function. */
+    subscribe: (cb: (s: ConversationStoreSnapshot) => void) => () => void;
+    /** Send a user message */
+    sendMessage: (content: string) => Promise<void>;
+    /** Load persisted messages */
+    loadMessages: () => Promise<ChatMessage[]>;
+    /** Approve a pending plan */
+    approvePlan: (planPath: string) => Promise<void>;
+    /** Reject a pending plan */
+    rejectPlan: (planPath: string, feedback?: string) => Promise<void>;
+    /** Mark a message as read */
+    markMessageAsRead: (messagePath: string) => Promise<void>;
+    /** Stop streaming */
+    stop: () => void;
+    /** Get the conversation path */
+    getConversationPath: () => string | null;
+    /** Destroy the store and release resources */
+    destroy: () => void;
+};
+/**
+ * Create a conversation list store adapter for Svelte 5.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createConversationListAdapter({ database: db, realtime: true });
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ * await adapter.load();
+ * ```
+ */
+declare function createConversationListAdapter(options: ConversationListStoreOptions): {
+    /** The underlying ConversationListStore instance */
+    store: ConversationListStore;
+    /** Get the current snapshot */
+    getSnapshot: () => ConversationListSnapshot;
+    /** Subscribe to snapshot changes. Returns unsubscribe function. */
+    subscribe: (cb: (s: ConversationListSnapshot) => void) => () => void;
+    /** Load conversations from the server */
+    load: () => Promise<void>;
+    /** Create a new conversation */
+    createConversation: (opts: {
+        participant: string;
+        subject?: string;
+        input?: Record<string, unknown>;
+    }) => Promise<ConversationListItem>;
+    /** Delete a conversation */
+    deleteConversation: (path: string) => Promise<void>;
+    /** Mark a conversation as read */
+    markAsRead: (path: string) => Promise<void>;
+    /** Get or create a ConversationStore for a specific path */
+    getConversationStore: (path: string) => ConversationStore;
+    /** Destroy the store and release resources */
+    destroy: () => void;
+};
+
+interface AuthSnapshot {
+    user: IdentityUser | null;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+}
+interface AuthAdapter {
+    subscribe: (cb: (snapshot: AuthSnapshot) => void) => () => void;
+    getSnapshot: () => AuthSnapshot;
+    login: (email: string, password: string, repository: string) => Promise<IdentityUser>;
+    register: (email: string, password: string, repository: string, displayName?: string) => Promise<IdentityUser>;
+    logout: (options?: {
+        disconnect?: boolean;
+        reconnect?: boolean;
+    }) => Promise<void>;
+    initSession: (repository: string) => Promise<IdentityUser | null>;
+    destroy: () => void;
+}
+/**
+ * Create an auth adapter for Svelte 5.
+ *
+ * Returns a plain object with `subscribe`, `getSnapshot`, auth actions, and `destroy`.
+ * Bind `getSnapshot()` to `$state` in a `.svelte.ts` file for reactivity.
+ *
+ * @example
+ * ```typescript
+ * // lib/auth.svelte.ts
+ * import { createAuthAdapter } from '@raisindb/client/svelte';
+ * import { client } from '$lib/raisin';
+ *
+ * const adapter = createAuthAdapter(client);
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ *
+ * export const auth = {
+ *   get user() { return snapshot.user; },
+ *   get isAuthenticated() { return snapshot.isAuthenticated; },
+ *   get isLoading() { return snapshot.isLoading; },
+ *   login: adapter.login,
+ *   register: adapter.register,
+ *   logout: adapter.logout,
+ *   initSession: adapter.initSession,
+ * };
+ * ```
+ */
+declare function createAuthAdapter(client: RaisinClient): AuthAdapter;
+
+interface ConnectionSnapshot {
+    state: ConnectionState;
+    isConnected: boolean;
+    isReady: boolean;
+}
+interface ConnectionAdapter {
+    subscribe: (cb: (snapshot: ConnectionSnapshot) => void) => () => void;
+    getSnapshot: () => ConnectionSnapshot;
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    destroy: () => void;
+}
+/**
+ * Create a connection adapter for Svelte 5.
+ *
+ * Tracks WebSocket connection state and ready state. Bind to `$state` in
+ * a `.svelte.ts` file for reactivity.
+ *
+ * @example
+ * ```typescript
+ * // lib/connection.svelte.ts
+ * import { createConnectionAdapter } from '@raisindb/client/svelte';
+ * import { client } from '$lib/raisin';
+ *
+ * const adapter = createConnectionAdapter(client);
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ *
+ * export const connection = {
+ *   get state() { return snapshot.state; },
+ *   get isConnected() { return snapshot.isConnected; },
+ *   get isReady() { return snapshot.isReady; },
+ *   connect: adapter.connect,
+ *   disconnect: adapter.disconnect,
+ * };
+ * ```
+ */
+declare function createConnectionAdapter(client: RaisinClient): ConnectionAdapter;
+
+interface SubscriptionAdapter {
+    destroy: () => void;
+}
+/**
+ * Create an event subscription adapter for Svelte 5.
+ *
+ * Pure side-effect adapter — subscribes to database events and invokes the
+ * callback on each matching event. Call `destroy()` to unsubscribe.
+ *
+ * @example
+ * ```typescript
+ * // In a .svelte component's script block or .svelte.ts file
+ * import { createSubscriptionAdapter } from '@raisindb/client/svelte';
+ * import { db } from '$lib/raisin';
+ *
+ * const sub = createSubscriptionAdapter(
+ *   db,
+ *   { workspace: 'content', node_type: 'Post' },
+ *   (event) => { console.log('Post changed:', event); },
+ * );
+ *
+ * // In onDestroy or $effect cleanup:
+ * sub.destroy();
+ * ```
+ */
+declare function createSubscriptionAdapter(database: Database, filters: SubscriptionFilters, callback: (event: EventMessage) => void): SubscriptionAdapter;
+
+type FlowStatus = 'idle' | 'running' | 'waiting' | 'completed' | 'failed';
+interface FlowSnapshot {
+    events: FlowExecutionEvent[];
+    status: FlowStatus;
+    isRunning: boolean;
+    error: string | null;
+    output: unknown | null;
+    instanceId: string | null;
+}
+interface FlowAdapterOptions {
+    database?: Database;
+    baseUrl?: string;
+    repository?: string;
+    authManager?: AuthManager;
+    clientOptions?: FlowClientOptions;
+    flowsApi?: FlowsApi;
+}
+interface FlowAdapter {
+    subscribe: (cb: (snapshot: FlowSnapshot) => void) => () => void;
+    getSnapshot: () => FlowSnapshot;
+    run: (flowPath: string, input?: Record<string, unknown>) => Promise<void>;
+    resume: (data: unknown) => Promise<void>;
+    reset: () => void;
+    destroy: () => void;
+}
+/**
+ * Create a flow execution adapter for Svelte 5.
+ *
+ * Manages the full flow lifecycle: starting, streaming events, resuming
+ * waiting flows, and tracking completion. Bind snapshot to `$state` for reactivity.
+ *
+ * @example
+ * ```typescript
+ * // lib/flow.svelte.ts
+ * import { createFlowAdapter } from '@raisindb/client/svelte';
+ * import { db } from '$lib/raisin';
+ *
+ * const adapter = createFlowAdapter({ database: db });
+ * let snapshot = $state(adapter.getSnapshot());
+ * adapter.subscribe(s => { snapshot = s; });
+ *
+ * export const flow = {
+ *   get events() { return snapshot.events; },
+ *   get status() { return snapshot.status; },
+ *   get isRunning() { return snapshot.isRunning; },
+ *   get error() { return snapshot.error; },
+ *   get output() { return snapshot.output; },
+ *   run: adapter.run,
+ *   resume: adapter.resume,
+ *   reset: adapter.reset,
+ * };
+ * ```
+ */
+declare function createFlowAdapter(options: FlowAdapterOptions): FlowAdapter;
+
+/**
+ * Context value for the RaisinDB Svelte integration.
+ *
+ * Use with Svelte's `setContext`/`getContext` in `.svelte` files.
+ *
+ * @example Setup in `+layout.svelte`:
+ * ```svelte
+ * <script>
+ *   import { setContext } from 'svelte';
+ *   import { RAISIN_CONTEXT_KEY, type RaisinContext } from '@raisindb/client/svelte';
+ *   import { client } from '$lib/raisin';
+ *
+ *   setContext<RaisinContext>(RAISIN_CONTEXT_KEY, { client, repository: 'myrepo' });
+ * </script>
+ *
+ * {@render children()}
+ * ```
+ *
+ * @example Usage in a child component:
+ * ```svelte
+ * <script>
+ *   import { getContext } from 'svelte';
+ *   import { RAISIN_CONTEXT_KEY, type RaisinContext } from '@raisindb/client/svelte';
+ *
+ *   const { client, repository } = getContext<RaisinContext>(RAISIN_CONTEXT_KEY);
+ *   const db = client.database(repository!);
+ * </script>
+ * ```
+ */
+interface RaisinContext {
+    client: RaisinClient;
+    repository?: string;
+}
+/**
+ * Shared context key for RaisinDB. Use this with `setContext` and `getContext`
+ * to ensure consistent key usage across your application.
+ */
+declare const RAISIN_CONTEXT_KEY: unique symbol;
+
+export { type AuthAdapter, type AuthSnapshot, type ConnectionAdapter, type ConnectionSnapshot, type FlowAdapter, type FlowAdapterOptions, type FlowSnapshot, type FlowStatus, RAISIN_CONTEXT_KEY, type RaisinContext, type SubscriptionAdapter, createAuthAdapter, createConnectionAdapter, createConversationAdapter, createConversationListAdapter, createFlowAdapter, createSubscriptionAdapter };