@equationalapplications/expo-llm-wiki 0.0.0-development → 2.1.0

package/dist/react/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { a as WikiMemory, M as MemoryBundle, e as WikiEvent } from '../WikiMemory-BI2Aizwv.mjs';
+import { a as WikiMemory, d as MemoryBundle, h as WikiEvent, M as MemoryDump } from '../WikiMemory-BDVn-TJf.mjs';
 import 'expo-sqlite';
 
 declare function WikiProvider({ wiki, children }: {
@@ -69,4 +69,11 @@ declare function useWikiForget(): {
     error: Error | null;
 };
 
-export { WikiProvider, useMemoryRead, useWiki, useWikiForget, useWikiIngest, useWikiMaintenance, useWikiWrite };
+declare function useWikiExport(): {
+    execute: (entityIds?: string[]) => Promise<MemoryDump>;
+    lastResult: MemoryDump | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+export { WikiProvider, useMemoryRead, useWiki, useWikiExport, useWikiForget, useWikiIngest, useWikiMaintenance, useWikiWrite };

package/dist/react/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { a as WikiMemory, M as MemoryBundle, e as WikiEvent } from '../WikiMemory-BI2Aizwv.js';
+import { a as WikiMemory, d as MemoryBundle, h as WikiEvent, M as MemoryDump } from '../WikiMemory-BDVn-TJf.js';
 import 'expo-sqlite';
 
 declare function WikiProvider({ wiki, children }: {
@@ -69,4 +69,11 @@ declare function useWikiForget(): {
     error: Error | null;
 };
 
-export { WikiProvider, useMemoryRead, useWiki, useWikiForget, useWikiIngest, useWikiMaintenance, useWikiWrite };
+declare function useWikiExport(): {
+    execute: (entityIds?: string[]) => Promise<MemoryDump>;
+    lastResult: MemoryDump | null;
+    isPending: boolean;
+    error: Error | null;
+};
+
+export { WikiProvider, useMemoryRead, useWiki, useWikiExport, useWikiForget, useWikiIngest, useWikiMaintenance, useWikiWrite };

package/dist/react/index.js

@@ -23,6 +23,7 @@ __export(react_exports, {
   WikiProvider: () => WikiProvider,
   useMemoryRead: () => useMemoryRead,
   useWiki: () => useWiki,
+  useWikiExport: () => useWikiExport,
   useWikiForget: () => useWikiForget,
   useWikiIngest: () => useWikiIngest,
   useWikiMaintenance: () => useWikiMaintenance,
@@ -218,11 +219,40 @@ function useWikiForget() {
   }, []);
   return { execute, lastResult, isPending, error };
 }
+
+// src/react/useWikiExport.ts
+var import_react7 = require("react");
+function useWikiExport() {
+  const wiki = useWiki();
+  const wikiRef = (0, import_react7.useRef)(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = (0, import_react7.useState)(false);
+  const [error, setError] = (0, import_react7.useState)(null);
+  const [lastResult, setLastResult] = (0, import_react7.useState)(null);
+  const execute = (0, import_react7.useCallback)(async (entityIds) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      const result = await wikiRef.current.exportDump(entityIds);
+      setLastResult(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   WikiProvider,
   useMemoryRead,
   useWiki,
+  useWikiExport,
   useWikiForget,
   useWikiIngest,
   useWikiMaintenance,

package/dist/react/index.mjs

@@ -186,10 +186,39 @@ function useWikiForget() {
   }, []);
   return { execute, lastResult, isPending, error };
 }
+
+// src/react/useWikiExport.ts
+import { useState as useState6, useCallback as useCallback6, useRef as useRef6 } from "react";
+function useWikiExport() {
+  const wiki = useWiki();
+  const wikiRef = useRef6(wiki);
+  wikiRef.current = wiki;
+  const [isPending, setIsPending] = useState6(false);
+  const [error, setError] = useState6(null);
+  const [lastResult, setLastResult] = useState6(null);
+  const execute = useCallback6(async (entityIds) => {
+    setError(null);
+    setIsPending(true);
+    setLastResult(null);
+    try {
+      const result = await wikiRef.current.exportDump(entityIds);
+      setLastResult(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      setError(err);
+      throw err;
+    } finally {
+      setIsPending(false);
+    }
+  }, []);
+  return { execute, lastResult, isPending, error };
+}
 export {
   WikiProvider,
   useMemoryRead,
   useWiki,
+  useWikiExport,
   useWikiForget,
   useWikiIngest,
   useWikiMaintenance,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equationalapplications/expo-llm-wiki",
-  "version": "0.0.0-development",
+  "version": "2.1.0",
   "description": "A standalone, general-purpose React Native/Expo package for LLM Wiki Memory.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -20,7 +20,9 @@
   "scripts": {
     "build": "tsup src/index.ts src/react/index.ts --format cjs,esm --dts --external react",
     "dev": "tsup src/index.ts src/react/index.ts --format cjs,esm --dts --external react --watch",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "files": [
     "dist",
@@ -38,10 +40,11 @@
   "author": "",
   "license": "MIT",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "peerDependencies": {
-    "expo-sqlite": "^14.0.0 || ^15.0.0",
+    "expo-sqlite": "^14.0.0 || ^15.0.0 || ^55.0.0",
     "react": ">=17"
   },
   "peerDependenciesMeta": {
@@ -49,16 +52,23 @@
       "optional": true
     }
   },
+  "engines": {
+    "node": ">=20"
+  },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.0",
     "@semantic-release/git": "^10.0.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.0.0",
     "@types/react": "^19.0.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "better-sqlite3": "^12.9.0",
     "expo-sqlite": "^55.0.15",
     "react": "19.2.0",
     "semantic-release": "^24.0.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.5"
   },
   "dependencies": {
     "expo": "^55.0.18",

package/dist/WikiMemory-B-yFw9Dc.d.mts

@@ -1,118 +0,0 @@
-import * as SQLite from 'expo-sqlite';
-
-interface WikiConfig {
-    tablePrefix?: string;
-    maxFtsResults?: number;
-    pruneEventsAfter?: number;
-    autoLibrarianThreshold?: number;
-    autoHealThreshold?: number;
-    orphanAfterDays?: number | null;
-    staleInferredAfterDays?: number | null;
-    maxChunkBytes?: number;
-}
-interface WikiFact {
-    id: string;
-    entity_id: string;
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-    source_type: 'user_stated' | 'agent_inferred' | 'user_confirmed' | 'user_document';
-    source_hash: string | null;
-    source_ref: string | null;
-    created_at: number;
-    updated_at: number;
-    last_accessed_at: number | null;
-    access_count: number;
-    deleted_at: number | null;
-}
-interface WikiTask {
-    id: string;
-    entity_id: string;
-    description: string;
-    status: 'pending' | 'in_progress' | 'done' | 'abandoned';
-    priority: number;
-    created_at: number;
-    updated_at: number;
-    resolved_at: number | null;
-    deleted_at: number | null;
-}
-interface WikiEvent {
-    id: string;
-    entity_id: string;
-    event_type: 'observation' | 'decision' | 'action' | 'outcome';
-    summary: string;
-    related_entry_id?: string | null;
-    created_at: number;
-}
-interface WikiCheckpoint {
-    entity_id: string;
-    heal_checkpoint: number;
-    memory_checkpoint: number;
-}
-interface ExtractedFact {
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-}
-interface ExtractedTask {
-    description: string;
-    priority: number;
-}
-interface LLMProvider {
-    /**
-     * Generates text using the developer's LLM of choice.
-     * Expected to return the raw text response (typically a JSON string).
-     */
-    generateText: (params: {
-        systemPrompt: string;
-        userPrompt: string;
-    }) => Promise<string>;
-}
-interface WikiOptions {
-    config?: WikiConfig;
-    llmProvider: LLMProvider;
-}
-interface MemoryBundle {
-    facts: WikiFact[];
-    tasks: WikiTask[];
-    events: WikiEvent[];
-}
-
-declare class WikiMemory {
-    private db;
-    private prefix;
-    private options;
-    constructor(db: SQLite.SQLiteDatabase, options: WikiOptions);
-    setup(): Promise<void>;
-    private formatSearchQuery;
-    read(entityId: string, query: string): Promise<MemoryBundle>;
-    write(entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
-    private runLibrarianThenMaybeHeal;
-    runLibrarian(entityId: string): Promise<void>;
-    runHeal(entityId: string): Promise<void>;
-    forget(entityId: string, params: {
-        entryId?: string;
-        taskId?: string;
-        sourceRef?: string;
-        sourceHash?: string;
-        clearAll?: boolean;
-    }): Promise<{
-        deleted: {
-            entries: number;
-            tasks: number;
-        };
-    }>;
-    ingestDocument(entityId: string, params: {
-        sourceRef: string;
-        sourceHash: string;
-        documentChunk: string;
-        maxChunkBytes?: number;
-    }): Promise<{
-        truncated: boolean;
-        chunks: number;
-    }>;
-}
-
-export { type ExtractedFact as E, type LLMProvider as L, type MemoryBundle as M, type WikiOptions as W, WikiMemory as a, type ExtractedTask as b, type WikiCheckpoint as c, type WikiConfig as d, type WikiEvent as e, type WikiFact as f, type WikiTask as g };

package/dist/WikiMemory-B-yFw9Dc.d.ts

@@ -1,118 +0,0 @@
-import * as SQLite from 'expo-sqlite';
-
-interface WikiConfig {
-    tablePrefix?: string;
-    maxFtsResults?: number;
-    pruneEventsAfter?: number;
-    autoLibrarianThreshold?: number;
-    autoHealThreshold?: number;
-    orphanAfterDays?: number | null;
-    staleInferredAfterDays?: number | null;
-    maxChunkBytes?: number;
-}
-interface WikiFact {
-    id: string;
-    entity_id: string;
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-    source_type: 'user_stated' | 'agent_inferred' | 'user_confirmed' | 'user_document';
-    source_hash: string | null;
-    source_ref: string | null;
-    created_at: number;
-    updated_at: number;
-    last_accessed_at: number | null;
-    access_count: number;
-    deleted_at: number | null;
-}
-interface WikiTask {
-    id: string;
-    entity_id: string;
-    description: string;
-    status: 'pending' | 'in_progress' | 'done' | 'abandoned';
-    priority: number;
-    created_at: number;
-    updated_at: number;
-    resolved_at: number | null;
-    deleted_at: number | null;
-}
-interface WikiEvent {
-    id: string;
-    entity_id: string;
-    event_type: 'observation' | 'decision' | 'action' | 'outcome';
-    summary: string;
-    related_entry_id?: string | null;
-    created_at: number;
-}
-interface WikiCheckpoint {
-    entity_id: string;
-    heal_checkpoint: number;
-    memory_checkpoint: number;
-}
-interface ExtractedFact {
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-}
-interface ExtractedTask {
-    description: string;
-    priority: number;
-}
-interface LLMProvider {
-    /**
-     * Generates text using the developer's LLM of choice.
-     * Expected to return the raw text response (typically a JSON string).
-     */
-    generateText: (params: {
-        systemPrompt: string;
-        userPrompt: string;
-    }) => Promise<string>;
-}
-interface WikiOptions {
-    config?: WikiConfig;
-    llmProvider: LLMProvider;
-}
-interface MemoryBundle {
-    facts: WikiFact[];
-    tasks: WikiTask[];
-    events: WikiEvent[];
-}
-
-declare class WikiMemory {
-    private db;
-    private prefix;
-    private options;
-    constructor(db: SQLite.SQLiteDatabase, options: WikiOptions);
-    setup(): Promise<void>;
-    private formatSearchQuery;
-    read(entityId: string, query: string): Promise<MemoryBundle>;
-    write(entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
-    private runLibrarianThenMaybeHeal;
-    runLibrarian(entityId: string): Promise<void>;
-    runHeal(entityId: string): Promise<void>;
-    forget(entityId: string, params: {
-        entryId?: string;
-        taskId?: string;
-        sourceRef?: string;
-        sourceHash?: string;
-        clearAll?: boolean;
-    }): Promise<{
-        deleted: {
-            entries: number;
-            tasks: number;
-        };
-    }>;
-    ingestDocument(entityId: string, params: {
-        sourceRef: string;
-        sourceHash: string;
-        documentChunk: string;
-        maxChunkBytes?: number;
-    }): Promise<{
-        truncated: boolean;
-        chunks: number;
-    }>;
-}
-
-export { type ExtractedFact as E, type LLMProvider as L, type MemoryBundle as M, type WikiOptions as W, WikiMemory as a, type ExtractedTask as b, type WikiCheckpoint as c, type WikiConfig as d, type WikiEvent as e, type WikiFact as f, type WikiTask as g };

package/dist/WikiMemory-BWTt1Ynm.d.mts

@@ -1,103 +0,0 @@
-import * as SQLite from 'expo-sqlite';
-
-interface WikiConfig {
-    tablePrefix?: string;
-    maxFtsResults?: number;
-    pruneEventsAfter?: number;
-    autoLibrarianThreshold?: number;
-}
-interface WikiFact {
-    id: string;
-    entity_id: string;
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-    source_type: 'user_stated' | 'agent_inferred' | 'user_confirmed' | 'user_document';
-    source_hash: string | null;
-    source_ref: string | null;
-    created_at: number;
-    updated_at: number;
-    last_accessed_at: number | null;
-    access_count: number;
-    deleted_at: number | null;
-}
-interface WikiTask {
-    id: string;
-    entity_id: string;
-    description: string;
-    status: 'pending' | 'in_progress' | 'done' | 'abandoned';
-    priority: number;
-    created_at: number;
-    updated_at: number;
-    resolved_at: number | null;
-    deleted_at: number | null;
-}
-interface WikiEvent {
-    id: string;
-    entity_id: string;
-    event_type: 'observation' | 'decision' | 'action' | 'outcome';
-    summary: string;
-    related_entry_id?: string | null;
-    created_at: number;
-}
-interface WikiCheckpoint {
-    entity_id: string;
-    heal_checkpoint: number;
-    memory_checkpoint: number;
-}
-interface ExtractedFact {
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-}
-interface ExtractedTask {
-    description: string;
-    priority: number;
-}
-interface LLMProvider {
-    /**
-     * Generates text using the developer's LLM of choice.
-     * Expected to return the raw text response (typically a JSON string).
-     */
-    generateText: (params: {
-        systemPrompt: string;
-        userPrompt: string;
-    }) => Promise<string>;
-}
-interface WikiOptions {
-    config?: WikiConfig;
-    llmProvider: LLMProvider;
-}
-interface MemoryBundle {
-    facts: WikiFact[];
-    tasks: WikiTask[];
-    events: WikiEvent[];
-}
-
-declare class WikiMemory {
-    private db;
-    private prefix;
-    private options;
-    constructor(db: SQLite.SQLiteDatabase, options: WikiOptions);
-    setup(): Promise<void>;
-    private formatSearchQuery;
-    read(entityId: string, query: string): Promise<MemoryBundle>;
-    write(entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
-    runLibrarian(entityId: string): Promise<void>;
-    runHeal(entityId: string): Promise<void>;
-    forget(entityId: string, params: {
-        entryId?: string;
-        taskId?: string;
-        sourceRef?: string;
-        clearAll?: boolean;
-    }): Promise<void>;
-    ingestDocument(entityId: string, params: {
-        sourceRef: string;
-        sourceHash: string;
-        documentChunk: string;
-    }): Promise<void>;
-}
-
-export { type ExtractedFact as E, type LLMProvider as L, type MemoryBundle as M, type WikiOptions as W, WikiMemory as a, type ExtractedTask as b, type WikiCheckpoint as c, type WikiConfig as d, type WikiEvent as e, type WikiFact as f, type WikiTask as g };

package/dist/WikiMemory-BWTt1Ynm.d.ts

@@ -1,103 +0,0 @@
-import * as SQLite from 'expo-sqlite';
-
-interface WikiConfig {
-    tablePrefix?: string;
-    maxFtsResults?: number;
-    pruneEventsAfter?: number;
-    autoLibrarianThreshold?: number;
-}
-interface WikiFact {
-    id: string;
-    entity_id: string;
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-    source_type: 'user_stated' | 'agent_inferred' | 'user_confirmed' | 'user_document';
-    source_hash: string | null;
-    source_ref: string | null;
-    created_at: number;
-    updated_at: number;
-    last_accessed_at: number | null;
-    access_count: number;
-    deleted_at: number | null;
-}
-interface WikiTask {
-    id: string;
-    entity_id: string;
-    description: string;
-    status: 'pending' | 'in_progress' | 'done' | 'abandoned';
-    priority: number;
-    created_at: number;
-    updated_at: number;
-    resolved_at: number | null;
-    deleted_at: number | null;
-}
-interface WikiEvent {
-    id: string;
-    entity_id: string;
-    event_type: 'observation' | 'decision' | 'action' | 'outcome';
-    summary: string;
-    related_entry_id?: string | null;
-    created_at: number;
-}
-interface WikiCheckpoint {
-    entity_id: string;
-    heal_checkpoint: number;
-    memory_checkpoint: number;
-}
-interface ExtractedFact {
-    title: string;
-    body: string;
-    tags: string[];
-    confidence: 'certain' | 'inferred' | 'tentative';
-}
-interface ExtractedTask {
-    description: string;
-    priority: number;
-}
-interface LLMProvider {
-    /**
-     * Generates text using the developer's LLM of choice.
-     * Expected to return the raw text response (typically a JSON string).
-     */
-    generateText: (params: {
-        systemPrompt: string;
-        userPrompt: string;
-    }) => Promise<string>;
-}
-interface WikiOptions {
-    config?: WikiConfig;
-    llmProvider: LLMProvider;
-}
-interface MemoryBundle {
-    facts: WikiFact[];
-    tasks: WikiTask[];
-    events: WikiEvent[];
-}
-
-declare class WikiMemory {
-    private db;
-    private prefix;
-    private options;
-    constructor(db: SQLite.SQLiteDatabase, options: WikiOptions);
-    setup(): Promise<void>;
-    private formatSearchQuery;
-    read(entityId: string, query: string): Promise<MemoryBundle>;
-    write(entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
-    runLibrarian(entityId: string): Promise<void>;
-    runHeal(entityId: string): Promise<void>;
-    forget(entityId: string, params: {
-        entryId?: string;
-        taskId?: string;
-        sourceRef?: string;
-        clearAll?: boolean;
-    }): Promise<void>;
-    ingestDocument(entityId: string, params: {
-        sourceRef: string;
-        sourceHash: string;
-        documentChunk: string;
-    }): Promise<void>;
-}
-
-export { type ExtractedFact as E, type LLMProvider as L, type MemoryBundle as M, type WikiOptions as W, WikiMemory as a, type ExtractedTask as b, type WikiCheckpoint as c, type WikiConfig as d, type WikiEvent as e, type WikiFact as f, type WikiTask as g };