@equationalapplications/core-llm-wiki 4.17.0 → 4.17.1

package/README.md

@@ -731,6 +731,26 @@ const finalPrompt = hydrateLibrarianPrompt(template, {
 });
 ```
 
+## Platform Random Source
+
+Wiki record IDs must be cryptographically random. The core engine resolves a random source in this order:
+
+1. `crypto.randomUUID()` (Web / Node 19+)
+2. `crypto.getRandomValues()` (Web / Node / polyfilled global)
+3. A source injected via `configureRandomSource()` (e.g. `expo-crypto` on Hermes/React Native)
+
+Web and Node are unchanged — global `crypto` wins when present. React Native / Hermes typically has no `crypto` global; use a platform package or inject your own implementation:
+
+```typescript
+import { configureRandomSource } from '@equationalapplications/core-llm-wiki';
+import { getRandomValues } from 'expo-crypto';
+
+// Call once at module load, before any wiki writes
+configureRandomSource(getRandomValues);
+```
+
+`@equationalapplications/expo-llm-wiki` does this automatically on import (main entry and `/factory` subpath). If you use `@equationalapplications/core-llm-wiki` directly on React Native without the expo package, you must call `configureRandomSource()` yourself or polyfill `globalThis.crypto.getRandomValues`.
+
 ## Adapter Interface
 
 Implement `SQLiteAdapter` to use your platform's SQLite driver:

package/dist/{chunk-M74FCWLB.mjs → chunk-AV2ZNKEA.mjs}

@@ -8,6 +8,30 @@ var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read fr
 var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
 
+// src/utils/ids.ts
+var _injectedGetRandomValues = null;
+function configureRandomSource(fn) {
+  _injectedGetRandomValues = fn;
+}
+function generateId(prefix = "") {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return prefix + crypto.randomUUID().replace(/-/g, "").substring(0, 24);
+  }
+  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    return prefix + Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("").substring(0, 24);
+  }
+  if (_injectedGetRandomValues) {
+    const bytes = new Uint8Array(16);
+    _injectedGetRandomValues(bytes);
+    return prefix + Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("").substring(0, 24);
+  }
+  throw new Error(
+    "generateId: no cryptographically secure random source available (crypto.randomUUID and crypto.getRandomValues are both missing, and no configureRandomSource() injection was provided)."
+  );
+}
+
 // src/utils/embedding.ts
 function parseEmbedding(blob, text) {
   if (blob && blob.byteLength > 0) {
@@ -984,21 +1008,6 @@ function validateInlineEdges(sourceType, _targetType, edges, manifest) {
   return valid;
 }
 
-// src/utils/ids.ts
-function generateId(prefix = "") {
-  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-    return prefix + crypto.randomUUID().replace(/-/g, "").substring(0, 24);
-  }
-  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
-    const bytes = new Uint8Array(16);
-    crypto.getRandomValues(bytes);
-    return prefix + Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("").substring(0, 24);
-  }
-  throw new Error(
-    "generateId: no cryptographically secure random source available (crypto.randomUUID and crypto.getRandomValues are both missing)."
-  );
-}
-
 // src/services/IngestionService.ts
 var IngestionService = class {
   constructor(db, prefix, options, entryRepo, searchService, jobManager, embeddingService, promptService, ontologyService) {
@@ -2806,6 +2815,6 @@ var WriteService = class {
   }
 };
 
-export { EmbeddingService, HOOK_TIMEOUT_MARKER, ImportExportService, IngestionService, JobManager, MaintenanceService, PromptService, PrunePartialFailureError, RetrievalService, SearchService, WikiBusyError, WriteService, __privateAdd, __privateGet, __privateSet, emptyManifest, generateId, mergeOntologyUpdates, normalizeSourceHash, normalizeSourceRef, normalizeTitleKey, parseEmbedding, resolveEdgeDefinition, resolveNodeType, validateInlineEdges, validateManifest };
-//# sourceMappingURL=chunk-M74FCWLB.mjs.map
-//# sourceMappingURL=chunk-M74FCWLB.mjs.map
+export { EmbeddingService, HOOK_TIMEOUT_MARKER, ImportExportService, IngestionService, JobManager, MaintenanceService, PromptService, PrunePartialFailureError, RetrievalService, SearchService, WikiBusyError, WriteService, __privateAdd, __privateGet, __privateSet, configureRandomSource, emptyManifest, generateId, mergeOntologyUpdates, normalizeSourceHash, normalizeSourceRef, normalizeTitleKey, parseEmbedding, resolveEdgeDefinition, resolveNodeType, validateInlineEdges, validateManifest };
+//# sourceMappingURL=chunk-AV2ZNKEA.mjs.map
+//# sourceMappingURL=chunk-AV2ZNKEA.mjs.map