@anokye-labs/kbexplorer-engine 0.1.0

package/dist/store.d.cts

@@ -0,0 +1,37 @@
+import { E as EngineEnv, R as RepoSource, d as RepoData } from './repo-data-0JvFdLGv.cjs';
+import { GraphStore, GraphStoreCacheKey, GraphStoreEntry, GraphStoreWrite, GraphStoreInvalidation, KBConfig, ContentHash, KBGraph } from '@anokye-labs/kbexplorer-core';
+import { P as ProviderResult, S as SqliteByteStore, a as ProviderRegistry, T as TransformContext, b as GraphTransform } from './sqlite-runtime-CysPjjzX.cjs';
+export { I as IndexedDbSqliteByteStore, M as MemorySqliteByteStore, l as loadSqlJs, o as openPersistedDatabase } from './sqlite-runtime-CysPjjzX.cjs';
+import 'sql.js';
+
+type GraphStoreMode = 'off' | 'sqlite';
+interface GraphStoreOptions {
+    mode: GraphStoreMode;
+}
+declare function resolveGraphStoreOptions(env?: EngineEnv): GraphStoreOptions;
+declare function isGraphStoreEnabled(env?: EngineEnv): boolean;
+
+declare class SQLiteGraphStore<Value = ProviderResult> implements GraphStore<Value> {
+    private readonly db;
+    private readonly persist;
+    private constructor();
+    static create<Value = ProviderResult>(byteStore?: SqliteByteStore, locateFile?: (file: string) => string): Promise<SQLiteGraphStore<Value>>;
+    get(key: GraphStoreCacheKey): Promise<GraphStoreEntry<Value> | undefined>;
+    put(entry: GraphStoreWrite<Value>): Promise<void>;
+    delete(key: GraphStoreCacheKey): Promise<boolean>;
+    invalidate(match: GraphStoreInvalidation): Promise<number>;
+    private migrate;
+    private setMetadata;
+    private selectEntry;
+    private selectEntries;
+    private countEntries;
+}
+
+declare const GRAPH_STORE_DERIVATION_VERSION = "template-graph-derivation-v3";
+declare const GRAPH_STORE_PROVIDER_ID = "provider-pipeline";
+declare function buildProviderResultCacheKey(source: RepoSource, config: KBConfig, data: RepoData, providerId?: string, previousContentHash?: ContentHash): Promise<GraphStoreCacheKey>;
+
+type ProviderCacheKeyBuilder = (providerId: string, previousContentHash: GraphStoreCacheKey['contentHash'] | undefined) => Promise<GraphStoreCacheKey>;
+declare function orchestrateWithProviderResultStore(registry: ProviderRegistry, config: KBConfig, ctx: TransformContext, store: GraphStore<ProviderResult>, buildCacheKey: ProviderCacheKeyBuilder, transforms?: readonly GraphTransform[]): Promise<KBGraph>;
+
+export { GRAPH_STORE_DERIVATION_VERSION, GRAPH_STORE_PROVIDER_ID, type GraphStoreMode, type GraphStoreOptions, type ProviderCacheKeyBuilder, SQLiteGraphStore, SqliteByteStore, buildProviderResultCacheKey, isGraphStoreEnabled, orchestrateWithProviderResultStore, resolveGraphStoreOptions };

package/dist/store.d.ts

@@ -0,0 +1,37 @@
+import { E as EngineEnv, R as RepoSource, d as RepoData } from './repo-data-0JvFdLGv.js';
+import { GraphStore, GraphStoreCacheKey, GraphStoreEntry, GraphStoreWrite, GraphStoreInvalidation, KBConfig, ContentHash, KBGraph } from '@anokye-labs/kbexplorer-core';
+import { P as ProviderResult, S as SqliteByteStore, a as ProviderRegistry, T as TransformContext, b as GraphTransform } from './sqlite-runtime-CysPjjzX.js';
+export { I as IndexedDbSqliteByteStore, M as MemorySqliteByteStore, l as loadSqlJs, o as openPersistedDatabase } from './sqlite-runtime-CysPjjzX.js';
+import 'sql.js';
+
+type GraphStoreMode = 'off' | 'sqlite';
+interface GraphStoreOptions {
+    mode: GraphStoreMode;
+}
+declare function resolveGraphStoreOptions(env?: EngineEnv): GraphStoreOptions;
+declare function isGraphStoreEnabled(env?: EngineEnv): boolean;
+
+declare class SQLiteGraphStore<Value = ProviderResult> implements GraphStore<Value> {
+    private readonly db;
+    private readonly persist;
+    private constructor();
+    static create<Value = ProviderResult>(byteStore?: SqliteByteStore, locateFile?: (file: string) => string): Promise<SQLiteGraphStore<Value>>;
+    get(key: GraphStoreCacheKey): Promise<GraphStoreEntry<Value> | undefined>;
+    put(entry: GraphStoreWrite<Value>): Promise<void>;
+    delete(key: GraphStoreCacheKey): Promise<boolean>;
+    invalidate(match: GraphStoreInvalidation): Promise<number>;
+    private migrate;
+    private setMetadata;
+    private selectEntry;
+    private selectEntries;
+    private countEntries;
+}
+
+declare const GRAPH_STORE_DERIVATION_VERSION = "template-graph-derivation-v3";
+declare const GRAPH_STORE_PROVIDER_ID = "provider-pipeline";
+declare function buildProviderResultCacheKey(source: RepoSource, config: KBConfig, data: RepoData, providerId?: string, previousContentHash?: ContentHash): Promise<GraphStoreCacheKey>;
+
+type ProviderCacheKeyBuilder = (providerId: string, previousContentHash: GraphStoreCacheKey['contentHash'] | undefined) => Promise<GraphStoreCacheKey>;
+declare function orchestrateWithProviderResultStore(registry: ProviderRegistry, config: KBConfig, ctx: TransformContext, store: GraphStore<ProviderResult>, buildCacheKey: ProviderCacheKeyBuilder, transforms?: readonly GraphTransform[]): Promise<KBGraph>;
+
+export { GRAPH_STORE_DERIVATION_VERSION, GRAPH_STORE_PROVIDER_ID, type GraphStoreMode, type GraphStoreOptions, type ProviderCacheKeyBuilder, SQLiteGraphStore, SqliteByteStore, buildProviderResultCacheKey, isGraphStoreEnabled, orchestrateWithProviderResultStore, resolveGraphStoreOptions };

package/dist/store.js

@@ -0,0 +1,7 @@
+export { isGraphStoreEnabled, resolveGraphStoreOptions } from './chunk-BA526FDQ.js';
+export { IndexedDbSqliteByteStore, MemorySqliteByteStore, SQLiteGraphStore, loadSqlJs, openPersistedDatabase } from './chunk-IWEURXYH.js';
+export { orchestrateWithProviderResultStore } from './chunk-YTMIERYM.js';
+import './chunk-DJ2DBEEK.js';
+import './chunk-FJ4GTN4U.js';
+import './chunk-JNQVSNLC.js';
+export { GRAPH_STORE_DERIVATION_VERSION, GRAPH_STORE_PROVIDER_ID, buildProviderResultCacheKey } from './chunk-HXAS3BSD.js';

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@anokye-labs/kbexplorer-engine",
+  "version": "0.1.0",
+  "description": "Scaffolded kbexplorer engine package with runtime-agnostic placeholder entry points for orchestration, sources, and store integration.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anokye-labs/kbexplorer-engine.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./sources": {
+      "types": "./dist/sources.d.ts",
+      "import": "./dist/sources.js",
+      "require": "./dist/sources.cjs"
+    },
+    "./store": {
+      "types": "./dist/store.d.ts",
+      "import": "./dist/store.js",
+      "require": "./dist/store.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepare": "npm run build",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@anokye-labs/kbexplorer-core": "^0.5.1",
+    "@anokye-labs/kbexplorer-provider-rich-markdown": "^0.1.2",
+    "marked": "^18.0.0",
+    "sanitize-html": "^2.17.5",
+    "sql.js": "^1.13.0",
+    "yaml": "^2.6.0"
+  },
+  "devDependencies": {
+    "@anokye-labs/kbexplorer-example-quotes": "file:examples/quotes-provider",
+    "@types/node": "^24.0.0",
+    "@types/sanitize-html": "^2.16.1",
+    "@types/sql.js": "^1.4.11",
+    "jsdom": "^26.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.9"
+  },
+  "overrides": {
+    "esbuild": "^0.28.1"
+  }
+}