@feltdb/core 0.11.2 → 0.11.4

package/README.md

@@ -136,9 +136,9 @@ A write with `requireAbsent: true` is an atomic create. The authority assigns
 it `__version: 1`—overriding any caller-supplied version—so it can immediately
 be updated with `ifVersion: 1`.
 
-## Bounded authority queries
+## Bounded queries
 
-Remote databases can filter, order, and limit records inside the authority:
+All runtimes can filter, order, and limit records at their storage boundary:
 
 ```typescript
 const page = await db.query({
@@ -153,10 +153,12 @@ const page = await db.query({
 });
 ```
 
-The server adds `recordId` as a deterministic final tie-breaker and returns an
-opaque `nextCursor`. Page snapshots are stable across concurrent inserts and
-deletes. This method is intentionally unavailable on embedded runtimes;
-`Collection.where()` and `Collection.find()` retain their existing behavior.
+FeltDB adds record identity as a deterministic final tie-breaker and returns an
+opaque `nextCursor`. Managed authorities pin page snapshots across concurrent
+writes; embedded runtimes use a query-bound keyset cursor over unchanged
+committed state. Declare compound embedded indexes with `collection.createIndex`
+and inspect selection with `db.explain(query)`. `Collection.find()` retains its
+array result and accepts optional ordering and limit options.
 
 ## Durable Operation Management
 

package/dist/collection.d.ts

@@ -12,6 +12,14 @@ import { type FreshnessCapability, type Revision } from './freshness.js';
 import type { IndexConfig, CollectionQueryPlan } from './index-types.js';
 export type Predicate<T> = (item: T) => boolean;
 export type Subscriber<T> = (items: T[]) => void;
+export interface CollectionFindOptions {
+    orderBy?: Array<{
+        field: string;
+        direction: 'asc' | 'desc';
+    }>;
+    limit?: number;
+    cursor?: string;
+}
 /**
  * How a refresh decided whether the local cache could be reused.
  *
@@ -65,6 +73,8 @@ export declare class Collection<T> {
     private graphUnsubscribe;
     private runtimeUnsubscribe;
     private indexBackend;
+    /** Declarations include storage-boundary compound indexes not used by the legacy cache index. */
+    private declaredIndexes;
     private indexStore;
     private indexesLoaded;
     /** Incremented whenever `cache` is replaced, so the index can tell it is stale. */
@@ -113,7 +123,7 @@ export declare class Collection<T> {
      *
      * `lastQueryPlan()` reports which path ran.
      */
-    find(query?: Partial<T>): Promise<T[]>;
+    find(query?: Partial<T>, options?: CollectionFindOptions): Promise<T[]>;
     /** Query records by field equality through the canonical application API. */
     query(query?: Partial<T>): Promise<T[]>;
     /**

package/dist/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"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"}

package/dist/collection.js

@@ -46,6 +46,8 @@ export class Collection {
     graphUnsubscribe = null;
     runtimeUnsubscribe = null;
     indexBackend = new IndexBackend();
+    /** Declarations include storage-boundary compound indexes not used by the legacy cache index. */
+    declaredIndexes = new Map();
     indexStore;
     indexesLoaded = false;
     /** Incremented whenever `cache` is replaced, so the index can tell it is stale. */
@@ -94,7 +96,9 @@ export class Collection {
         try {
             const configs = await this.indexStore.loadIndexConfigs();
             for (const config of configs) {
-                this.indexBackend.createIndex(config);
+                this.declaredIndexes.set(config.name, config);
+                if (config.type !== 'compound')
+                    this.indexBackend.createIndex(config);
             }
             this.indexesLoaded = true;
         }
@@ -129,8 +133,24 @@ export class Collection {
      *
      * `lastQueryPlan()` reports which path ran.
      */
-    async find(query = {}) {
+    async find(query = {}, options) {
         const entries = Object.entries(query);
+        if (options && this.db.authority_query) {
+            const page = await this.db.authority_query({
+                collection: this.name,
+                where: entries.map(([field, eq]) => ({ field, eq })),
+                orderBy: options.orderBy,
+                limit: options.limit ?? 100,
+                cursor: options.cursor,
+            });
+            this.lastPlan = {
+                strategy: page.plan?.index ? 'index' : 'scan',
+                ...(page.plan?.index ? { indexName: page.plan.index } : { reason: 'runtime reported no applicable index' }),
+                candidatesExamined: page.plan?.actual_rows_scanned ?? page.records.length,
+                recordsReturned: page.records.length,
+            };
+            return page.records;
+        }
         if (entries.length > 0 && this.db.authority_query) {
             const records = [];
             let cursor;
@@ -278,7 +298,11 @@ export class Collection {
      * tasks.createIndex({ name: 'created_idx', type: 'sorted', field: 'createdAt' });
      */
     createIndex(config) {
-        this.indexBackend.createIndex(config);
+        if (this.declaredIndexes.has(config.name))
+            throw new Error(`Index ${config.name} already exists`);
+        this.declaredIndexes.set(config.name, config);
+        if (config.type !== 'compound')
+            this.indexBackend.createIndex(config);
         // Index existing data
         for (const item of this.cache) {
             const recordId = item?.id || JSON.stringify(item);
@@ -291,14 +315,19 @@ export class Collection {
      * List all indexes on this collection.
      */
     listIndexes() {
-        return this.indexBackend.listIndexes();
+        return [...this.declaredIndexes.values()];
     }
     /**
      * Rebuild all indexes for this collection.
      * Used to repair corrupted indexes or after data migration.
      */
     async rebuildIndexes() {
+        await this.db.rebuild_indexes?.();
         const configs = this.indexBackend.listIndexes();
+        // Compound indexes live entirely at the storage boundary and were rebuilt
+        // above; there is no reason to materialize this collection for them.
+        if (configs.length === 0)
+            return;
         const items = await this.all();
         for (const item of items) {
             const recordId = item?.id || JSON.stringify(item);
@@ -311,7 +340,7 @@ export class Collection {
      * Check if indexes are stale and need rebuilding.
      */
     async validateIndexes() {
-        const configs = this.indexBackend.listIndexes();
+        const configs = this.listIndexes();
         if (configs.length === 0)
             return true;
         const items = await this.all();

package/dist/create/package-versions.js

@@ -1,4 +1,4 @@
 // One release train keeps generated applications installable. The repository
 // validation script checks these values against every workspace manifest.
-export const FELTDB_PACKAGE_VERSION = '0.11.2';
+export const FELTDB_PACKAGE_VERSION = '0.11.4';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;

package/dist/create/server-source/crates/feltdb/src/lib.rs

@@ -108,6 +108,7 @@ pub mod replica_membership;
 pub mod replication_manager;
 pub mod replication_protocol;
 mod routing;
+pub mod semantic_decision;
 pub mod sharding;
 pub mod state_conflict_contract;
 pub mod state_contract;
@@ -223,6 +224,22 @@ pub use routing::{
     CapabilityRouter, ExecutionClaim, ExecutionClaimer, ExecutionResultPublisher, PeerStateVersion,
     RouteDecision,
 };
+pub use semantic_decision::{
+    authorize_context, decide_record, decision_cache_key, deterministic_request_key,
+    execute_decision_batch, execute_decision_transport, execute_inline_decision_transport, jev,
+    run_choice_diagnostics, run_decision_benchmark, validate_decision_definition,
+    validate_decision_result, BinaryDecisionResult, ChoiceDecisionResult, ChoiceDiagnosticsReport,
+    ChoiceExpansionObservation, ChoicePermutationObservation, DecisionAuthorizationConfig,
+    DecisionAuthorizationDecision, DecisionAuthorizationGate, DecisionBatch, DecisionBatchDecision,
+    DecisionBatchEvaluation, DecisionBenchmarkCase, DecisionBenchmarkReport, DecisionContextPacket,
+    DecisionDefinition, DecisionError, DecisionEvaluation, DecisionEvidence, DecisionEvidenceField,
+    DecisionExecutionMethod, DecisionJudgmentRecord, DecisionKind, DecisionOptions,
+    DecisionPrincipal, DecisionProvenance, DecisionRecordRef, DecisionRequest, DecisionResult,
+    DecisionRuntime, DecisionRuntimeCapabilities, DecisionRuntimeMetadata, DecisionStateReference,
+    DecisionStatus, DecisionTransportAuthorization, DecisionTransportExecutionRequest,
+    DecisionTransportExecutionResponse, DecisionTransportRuntime, DeterministicDecisionRuntime,
+    ScoreDecisionResult, WeightedOption, DEFAULT_DECISION_COLLECTION,
+};
 pub use sharding::{
     HotspotAlert, RebalanceOperation, ShardDistributionSummary, ShardId, ShardKey, ShardManager,
     ShardMetrics, ShardRange, ShardingStrategy,
@@ -1998,8 +2015,7 @@ impl FeltDb {
         let databases = OPEN_DATABASES.get_or_init(|| Mutex::new(HashMap::new()));
         let mut databases = databases.lock().expect("open database registry poisoned");
         if let Some(open) = databases.get(&path) {
-            if let (Some(inner), Some(ownership)) =
-                (open.inner.upgrade(), open.ownership.upgrade())
+            if let (Some(inner), Some(ownership)) = (open.inner.upgrade(), open.ownership.upgrade())
             {
                 return Ok(Self {
                     inner,
@@ -3342,12 +3358,7 @@ impl FeltDb {
             append_event_locked(&mut inner, &row)?;
             let base_revision = inner.authority_revision;
             inner.authority_revision += 1;
-            remember_operation_attribution(
-                &mut inner,
-                &row,
-                base_revision,
-                base_revision + 1,
-            );
+            remember_operation_attribution(&mut inner, &row, base_revision, base_revision + 1);
             inner.put_row(row);
             if let Some(revision) = planned {
                 persist_revision_locked(&mut inner, revision)?;
@@ -3428,12 +3439,7 @@ impl FeltDb {
             append_event_locked(&mut inner, &row)?;
             let base_revision = inner.authority_revision;
             inner.authority_revision += 1;
-            remember_operation_attribution(
-                &mut inner,
-                &row,
-                base_revision,
-                base_revision + 1,
-            );
+            remember_operation_attribution(&mut inner, &row, base_revision, base_revision + 1);
             inner.put_row(row);
             if let Some(revision) = planned {
                 persist_revision_locked(&mut inner, revision)?;
@@ -5109,15 +5115,12 @@ fn replay_log(inner: &mut Inner) -> Result<()> {
             inner.change_log.observed_versions = header.observed_versions;
             for attribution in header.transaction_history {
                 let attribution = normalize_transaction_attribution(attribution);
-                inner.authority_revision = inner
-                    .authority_revision
-                    .max(attribution.commit_revision);
-                inner
-                    .transaction_revisions
-                    .insert(
-                        attribution.transaction_id.clone(),
-                        (attribution.base_revision, attribution.commit_revision),
-                    );
+                inner.authority_revision =
+                    inner.authority_revision.max(attribution.commit_revision);
+                inner.transaction_revisions.insert(
+                    attribution.transaction_id.clone(),
+                    (attribution.base_revision, attribution.commit_revision),
+                );
                 inner
                     .applied_transactions
                     .insert(attribution.transaction_id.clone());
@@ -5232,12 +5235,7 @@ fn replay_log(inner: &mut Inner) -> Result<()> {
             let base_revision = inner.authority_revision;
             inner.authority_revision += 1;
             if !snapshot_log {
-                remember_operation_attribution(
-                    inner,
-                    &row,
-                    base_revision,
-                    base_revision + 1,
-                );
+                remember_operation_attribution(inner, &row, base_revision, base_revision + 1);
             }
         }
         if let Some(id) = row
@@ -5577,7 +5575,10 @@ mod tests {
         assert_eq!(held, TRANSACTION_ATTRIBUTION_WINDOW);
         let recent = db.recent_transactions(3).expect("attributions");
         assert_eq!(
-            recent.iter().map(|value| value.transaction_id.clone()).collect::<Vec<_>>(),
+            recent
+                .iter()
+                .map(|value| value.transaction_id.clone())
+                .collect::<Vec<_>>(),
             vec![
                 format!("tx_{}", commits - 1),
                 format!("tx_{}", commits - 2),