korajs 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 import * as _korajs_core from '@korajs/core';
 import { KoraEventEmitter, SequenceConfig, Operation, SchemaDefinition, KoraEvent, SchemaInput, FieldBuilder, InferRecord, InferInsertInput, InferUpdateInput } from '@korajs/core';
-export { AtomicOp, AtomicOpType, CollectionDefinition, ConnectionQuality, Constraint, FieldDescriptor, FieldKindToType, HLCTimestamp, HybridLogicalClock, InferFieldType, InferInsertInput, InferRecord, InferUpdateInput, KoraError, KoraEvent, KoraEventEmitter, KoraEventListener, KoraEventType, MergeStrategy, MergeTrace, MigrationDefinition, MigrationStep, Operation, SchemaDefinition, SchemaInput, SequenceConfig, SyncRuleDefinition, TypedSchemaDefinition, VersionVector, createOperation, defineSchema, generateUUIDv7, migrate, op, t } from '@korajs/core';
+export { AppNotReadyError, AtomicOp, AtomicOpType, CollectionDefinition, ConnectionQuality, Constraint, FieldDescriptor, FieldKindToType, HLCTimestamp, HybridLogicalClock, InferFieldType, InferInsertInput, InferRecord, InferUpdateInput, KoraError, KoraEvent, KoraEventEmitter, KoraEventListener, KoraEventType, MergeStrategy, MergeTrace, MigrationDefinition, MigrationStep, Operation, SchemaDefinition, SchemaInput, SequenceConfig, SyncRuleDefinition, TypedSchemaDefinition, VersionVector, createOperation, defineSchema, generateUUIDv7, migrate, op, t } from '@korajs/core';
 import * as _korajs_sync from '@korajs/sync';
 import { SyncStatusInfo, SyncEngine } from '@korajs/sync';
 export { SyncConfig, SyncDiagnostics, SyncEncryptionConfig, SyncEngine, SyncState, SyncStatus, SyncStatusInfo, SyncStore, WebSocketTransport } from '@korajs/sync';
 import * as _korajs_store from '@korajs/store';
 import { CollectionRecord, BackupOptions, RestoreOptions, RestoreResult, ReplaySnapshot, AuditExportOptions, QueryBuilder, CollectionAccessor } from '@korajs/store';
 export { AuditExportManifest, AuditExportOptions, AuditExportPayload, BackupManifest, BackupOptions, BackupProgress, CollectionAccessor, CollectionRecord, PersistedAuditTrace, ReplaySnapshot, RestoreOptions, RestoreResult, SequenceManager, StorageAdapter, Store, StoreConfig, TransactionCollectionAccessor, TransactionContext, TransactionContextConfig, decodeAuditExport, exportBackup, readAuditExportManifest, readBackupManifest, restoreBackup, verifyAuditExportChecksum, verifyBackupChecksum } from '@korajs/store';
+import { AuthSyncBinding } from '@korajs/core/bindings';
+export { AuthSyncBinding } from '@korajs/core/bindings';
 export { MergeEngine, MergeInput, MergeResult } from '@korajs/merge';
 
 /**
@@ -37,25 +39,7 @@ interface StoreOptions {
     /** Max wait for a worker RPC (e.g. `open`). Defaults to 30000ms. */
     workerResponseTimeoutMs?: number;
 }
-/**
- * Pre-built auth binding from `createKoraAuthSync()` in `@korajs/auth`.
- * Wires token refresh, JWT scope maps, and device-bound sync node ids.
- */
-interface AuthSyncBinding {
-    /** Returns the access token for sync handshake (empty string when signed out). */
-    auth: () => Promise<{
-        token: string;
-    }>;
-    /** Builds a scope map from the current token and schema. */
-    resolveScopeMap?: () => Promise<Record<string, Record<string, unknown>> | undefined>;
-    /**
-     * Returns the device-bound sync node id from the token `dev` claim.
-     * Separate from the user id (`sub`).
-     */
-    resolveNodeId?: () => Promise<string | undefined>;
-    /** Notifies when auth state changes so sync can refresh scope or reconnect. */
-    subscribe?: (listener: () => void) => () => void;
-}
+
 /**
  * Sync configuration within createApp.
  */
@@ -250,6 +234,8 @@ interface KoraApp {
     getStore(): _korajs_store.Store;
     /** Get the underlying SyncEngine instance. Null if sync not configured. */
     getSyncEngine(): SyncEngine | null;
+    /** Per-app reference-counted cache for framework query subscriptions. */
+    getQueryStoreCache(): _korajs_store.QueryStoreCache;
     /** Gracefully close the app: stop sync, close store. */
     close(): Promise<void>;
     /**
@@ -344,6 +330,8 @@ type TypedKoraApp<S extends SchemaInput> = {
     getStore(): _korajs_store.Store;
     /** Get the underlying SyncEngine instance. Null if sync not configured. */
     getSyncEngine(): SyncEngine | null;
+    /** Per-app reference-counted cache for framework query subscriptions. */
+    getQueryStoreCache(): _korajs_store.QueryStoreCache;
     /** Gracefully close the app: stop sync, close store. */
     close(): Promise<void>;
     /** Execute multiple mutations atomically within a transaction. */
@@ -370,39 +358,8 @@ type TypedKoraApp<S extends SchemaInput> = {
  * Wires together store, merge engine, event emitter, and optionally sync
  * into a single developer-facing `KoraApp` object. Collection accessors
  * (e.g. `app.todos`) are defined as properties for immediate use after `await app.ready`.
- *
- * @param config - Application configuration including schema and optional sync settings
- * @returns A KoraApp instance with reactive collections ready for use
- *
- * @example
- * ```typescript
- * const app = createApp({
- *   schema: defineSchema({
- *     version: 1,
- *     collections: {
- *       todos: {
- *         fields: {
- *           title: t.string(),
- *           completed: t.boolean().default(false)
- *         }
- *       }
- *     }
- *   })
- * })
- *
- * await app.ready
- * const todo = await app.todos.insert({ title: 'Hello' })
- * ```
- */
-/**
- * Creates a new typed Kora application instance.
- * When the schema is created with `defineSchema()`, full type inference flows through
- * to collection accessors, providing autocomplete and type checking for all CRUD operations.
  */
 declare function createApp<const S extends SchemaInput>(config: TypedKoraConfig<S>): TypedKoraApp<S>;
-/**
- * Creates a new Kora application instance (untyped fallback).
- */
 declare function createApp(config: KoraConfig): KoraApp;
 
-export { type AdapterType, type AuthSyncBinding, type KoraApp, type KoraConfig, type SequenceAccessor, type StoreOptions, type SyncControl, type SyncOptions, type TransactionCollectionProxy, type TransactionProxy, type TypedCollectionAccessor, type TypedKoraApp, type TypedKoraConfig, createApp };
+export { type AdapterType, type KoraApp, type KoraConfig, type SequenceAccessor, type StoreOptions, type SyncControl, type SyncOptions, type TransactionCollectionProxy, type TransactionProxy, type TypedCollectionAccessor, type TypedKoraApp, type TypedKoraConfig, createApp };