korajs 0.3.2 → 0.4.0

package/dist/index.d.cts

@@ -1,10 +1,11 @@
-import { KoraEventEmitter, SchemaDefinition, SchemaInput, FieldBuilder, InferRecord, InferInsertInput, InferUpdateInput } from '@korajs/core';
-export { CollectionDefinition, ConnectionQuality, Constraint, FieldDescriptor, FieldKindToType, HLCTimestamp, HybridLogicalClock, InferFieldType, InferInsertInput, InferRecord, InferUpdateInput, KoraError, KoraEvent, KoraEventEmitter, KoraEventListener, KoraEventType, MergeStrategy, MergeTrace, Operation, SchemaDefinition, SchemaInput, TypedSchemaDefinition, VersionVector, createOperation, defineSchema, generateUUIDv7, t } from '@korajs/core';
+import { KoraEventEmitter, SequenceConfig, Operation, SchemaDefinition, 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, TypedSchemaDefinition, VersionVector, createOperation, defineSchema, generateUUIDv7, migrate, op, t } from '@korajs/core';
 import * as _korajs_store from '@korajs/store';
-import { QueryBuilder, CollectionAccessor } from '@korajs/store';
-export { CollectionAccessor, CollectionRecord, StorageAdapter, Store, StoreConfig } from '@korajs/store';
+import { CollectionRecord, QueryBuilder, CollectionAccessor } from '@korajs/store';
+export { CollectionAccessor, CollectionRecord, SequenceManager, StorageAdapter, Store, StoreConfig, TransactionCollectionAccessor, TransactionContext, TransactionContextConfig } from '@korajs/store';
+import * as _korajs_sync from '@korajs/sync';
 import { SyncStatusInfo, SyncEngine } from '@korajs/sync';
-export { SyncConfig, SyncEngine, SyncState, SyncStatus, SyncStatusInfo, SyncStore, WebSocketTransport } from '@korajs/sync';
+export { SyncConfig, SyncDiagnostics, SyncEngine, SyncState, SyncStatus, SyncStatusInfo, SyncStore, WebSocketTransport } from '@korajs/sync';
 export { MergeEngine, MergeInput, MergeResult } from '@korajs/merge';
 
 /**
@@ -40,6 +41,22 @@ interface SyncOptions {
     }>;
     /** Sync scopes per collection. */
     scopes?: Record<string, (ctx: Record<string, unknown>) => Record<string, unknown>>;
+    /**
+     * Flat scope values. Combined with schema scope declarations to build
+     * per-collection scope filters sent to the server during handshake.
+     *
+     * @example
+     * ```typescript
+     * createApp({
+     *   schema,
+     *   sync: {
+     *     url: 'wss://server/kora',
+     *     scope: { orgId: 'org-123', storeId: 'store-456' },
+     *   },
+     * })
+     * ```
+     */
+    scope?: Record<string, unknown>;
     /** Number of operations per batch. Defaults to 100. */
     batchSize?: number;
     /** Schema version of this client. */
@@ -89,6 +106,71 @@ interface SyncControl {
     disconnect(): Promise<void>;
     /** Get the current developer-facing sync status. */
     getStatus(): SyncStatusInfo;
+    /** Force an immediate reconnection attempt. No-op if already connected. */
+    retryNow(): Promise<void>;
+    /** Export a diagnostics snapshot for debugging and support tickets. */
+    exportDiagnostics(): _korajs_sync.SyncDiagnostics;
+}
+/**
+ * A transaction collection accessor providing insert, update, delete, and findById.
+ */
+interface TransactionCollectionProxy {
+    insert(data: Record<string, unknown>): Promise<CollectionRecord>;
+    update(id: string, data: Record<string, unknown>): Promise<CollectionRecord>;
+    delete(id: string): Promise<void>;
+    findById(id: string): Promise<CollectionRecord | null>;
+}
+/**
+ * Transaction proxy passed to the transaction callback.
+ * Provides collection accessors as direct properties (e.g., tx.todos.insert(...)).
+ */
+interface TransactionProxy {
+    /** Dynamic collection accessors for transaction operations. */
+    [collection: string]: TransactionCollectionProxy;
+}
+/**
+ * Accessor for offline-safe sequences.
+ * Generates monotonically increasing, collision-free identifiers
+ * that work across offline devices.
+ */
+interface SequenceAccessor {
+    /**
+     * Get the next value in a sequence, atomically incrementing the counter.
+     *
+     * @param name - The sequence name (e.g., 'receipt', 'invoice')
+     * @param config - Optional configuration for scope, format, and starting value
+     * @returns The formatted sequence value
+     *
+     * @example
+     * ```typescript
+     * const receiptNo = await app.sequences.next('receipt', {
+     *   scope: storeId,
+     *   format: 'S-{date}-{node4}-{seq}',
+     * })
+     * // → "S-20260508-a1b2-0042"
+     * ```
+     */
+    next(name: string, config?: SequenceConfig): Promise<string>;
+    /**
+     * Get the current counter value without incrementing.
+     *
+     * @param name - The sequence name
+     * @param config - Optional scope
+     * @returns The current counter value, or 0 if never used
+     */
+    current(name: string, config?: {
+        scope?: string;
+    }): Promise<number>;
+    /**
+     * Reset a sequence counter.
+     *
+     * @param name - The sequence name
+     * @param config - Optional scope and target value
+     */
+    reset(name: string, config?: {
+        scope?: string;
+        to?: number;
+    }): Promise<void>;
 }
 /**
  * The main application object returned by createApp().
@@ -101,12 +183,41 @@ interface KoraApp {
     events: KoraEventEmitter;
     /** Sync control (connect/disconnect/status). Null if sync not configured. */
     sync: SyncControl | null;
+    /** Offline-safe sequence generation. */
+    sequences: SequenceAccessor;
     /** Get the underlying Store instance (for advanced use / React integration). */
     getStore(): _korajs_store.Store;
     /** Get the underlying SyncEngine instance. Null if sync not configured. */
     getSyncEngine(): SyncEngine | null;
     /** Gracefully close the app: stop sync, close store. */
     close(): Promise<void>;
+    /**
+     * Execute multiple mutations atomically within a transaction.
+     * All operations are committed together or rolled back on error.
+     * Subscription notifications are batched after commit.
+     *
+     * @example
+     * ```typescript
+     * await app.transaction(async (tx) => {
+     *   await tx.sales.update(saleId, { status: 'completed' })
+     *   await tx.payments.insert({ saleId, method: 'cash', amount: total })
+     * })
+     * ```
+     */
+    transaction(fn: (tx: TransactionProxy) => Promise<void>): Promise<Operation[]>;
+    /**
+     * Execute a named mutation — a transaction with a human-readable name.
+     * The mutation name is attached to all operations and visible in DevTools.
+     *
+     * @example
+     * ```typescript
+     * await app.mutation('complete-sale', async (tx) => {
+     *   await tx.sales.update(saleId, { status: 'completed' })
+     *   await tx.payments.insert({ saleId, method: 'cash', amount: total })
+     * })
+     * ```
+     */
+    mutation(name: string, fn: (tx: TransactionProxy) => Promise<void>): Promise<Operation[]>;
     /** Dynamic collection accessors (e.g., app.todos). Typed via Object.defineProperty. */
     [collection: string]: unknown;
 }
@@ -137,12 +248,18 @@ type TypedKoraApp<S extends SchemaInput> = {
     events: KoraEventEmitter;
     /** Sync control (connect/disconnect/status). Null if sync not configured. */
     sync: SyncControl | null;
+    /** Offline-safe sequence generation. */
+    sequences: SequenceAccessor;
     /** Get the underlying Store instance (for advanced use / React integration). */
     getStore(): _korajs_store.Store;
     /** Get the underlying SyncEngine instance. Null if sync not configured. */
     getSyncEngine(): SyncEngine | null;
     /** Gracefully close the app: stop sync, close store. */
     close(): Promise<void>;
+    /** Execute multiple mutations atomically within a transaction. */
+    transaction(fn: (tx: TransactionProxy) => Promise<void>): Promise<Operation[]>;
+    /** Execute a named mutation — a transaction with a DevTools-visible name. */
+    mutation(name: string, fn: (tx: TransactionProxy) => Promise<void>): Promise<Operation[]>;
 } & {
     readonly [C in keyof S['collections'] & string]: S['collections'][C] extends {
         fields: infer F extends Record<string, FieldBuilder<any, any, any>>;
@@ -190,4 +307,4 @@ declare function createApp<const S extends SchemaInput>(config: TypedKoraConfig<
  */
 declare function createApp(config: KoraConfig): KoraApp;
 
-export { type AdapterType, type KoraApp, type KoraConfig, type StoreOptions, type SyncControl, type SyncOptions, 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 };

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-import { KoraEventEmitter, SchemaDefinition, SchemaInput, FieldBuilder, InferRecord, InferInsertInput, InferUpdateInput } from '@korajs/core';
-export { CollectionDefinition, ConnectionQuality, Constraint, FieldDescriptor, FieldKindToType, HLCTimestamp, HybridLogicalClock, InferFieldType, InferInsertInput, InferRecord, InferUpdateInput, KoraError, KoraEvent, KoraEventEmitter, KoraEventListener, KoraEventType, MergeStrategy, MergeTrace, Operation, SchemaDefinition, SchemaInput, TypedSchemaDefinition, VersionVector, createOperation, defineSchema, generateUUIDv7, t } from '@korajs/core';
+import { KoraEventEmitter, SequenceConfig, Operation, SchemaDefinition, 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, TypedSchemaDefinition, VersionVector, createOperation, defineSchema, generateUUIDv7, migrate, op, t } from '@korajs/core';
 import * as _korajs_store from '@korajs/store';
-import { QueryBuilder, CollectionAccessor } from '@korajs/store';
-export { CollectionAccessor, CollectionRecord, StorageAdapter, Store, StoreConfig } from '@korajs/store';
+import { CollectionRecord, QueryBuilder, CollectionAccessor } from '@korajs/store';
+export { CollectionAccessor, CollectionRecord, SequenceManager, StorageAdapter, Store, StoreConfig, TransactionCollectionAccessor, TransactionContext, TransactionContextConfig } from '@korajs/store';
+import * as _korajs_sync from '@korajs/sync';
 import { SyncStatusInfo, SyncEngine } from '@korajs/sync';
-export { SyncConfig, SyncEngine, SyncState, SyncStatus, SyncStatusInfo, SyncStore, WebSocketTransport } from '@korajs/sync';
+export { SyncConfig, SyncDiagnostics, SyncEngine, SyncState, SyncStatus, SyncStatusInfo, SyncStore, WebSocketTransport } from '@korajs/sync';
 export { MergeEngine, MergeInput, MergeResult } from '@korajs/merge';
 
 /**
@@ -40,6 +41,22 @@ interface SyncOptions {
     }>;
     /** Sync scopes per collection. */
     scopes?: Record<string, (ctx: Record<string, unknown>) => Record<string, unknown>>;
+    /**
+     * Flat scope values. Combined with schema scope declarations to build
+     * per-collection scope filters sent to the server during handshake.
+     *
+     * @example
+     * ```typescript
+     * createApp({
+     *   schema,
+     *   sync: {
+     *     url: 'wss://server/kora',
+     *     scope: { orgId: 'org-123', storeId: 'store-456' },
+     *   },
+     * })
+     * ```
+     */
+    scope?: Record<string, unknown>;
     /** Number of operations per batch. Defaults to 100. */
     batchSize?: number;
     /** Schema version of this client. */
@@ -89,6 +106,71 @@ interface SyncControl {
     disconnect(): Promise<void>;
     /** Get the current developer-facing sync status. */
     getStatus(): SyncStatusInfo;
+    /** Force an immediate reconnection attempt. No-op if already connected. */
+    retryNow(): Promise<void>;
+    /** Export a diagnostics snapshot for debugging and support tickets. */
+    exportDiagnostics(): _korajs_sync.SyncDiagnostics;
+}
+/**
+ * A transaction collection accessor providing insert, update, delete, and findById.
+ */
+interface TransactionCollectionProxy {
+    insert(data: Record<string, unknown>): Promise<CollectionRecord>;
+    update(id: string, data: Record<string, unknown>): Promise<CollectionRecord>;
+    delete(id: string): Promise<void>;
+    findById(id: string): Promise<CollectionRecord | null>;
+}
+/**
+ * Transaction proxy passed to the transaction callback.
+ * Provides collection accessors as direct properties (e.g., tx.todos.insert(...)).
+ */
+interface TransactionProxy {
+    /** Dynamic collection accessors for transaction operations. */
+    [collection: string]: TransactionCollectionProxy;
+}
+/**
+ * Accessor for offline-safe sequences.
+ * Generates monotonically increasing, collision-free identifiers
+ * that work across offline devices.
+ */
+interface SequenceAccessor {
+    /**
+     * Get the next value in a sequence, atomically incrementing the counter.
+     *
+     * @param name - The sequence name (e.g., 'receipt', 'invoice')
+     * @param config - Optional configuration for scope, format, and starting value
+     * @returns The formatted sequence value
+     *
+     * @example
+     * ```typescript
+     * const receiptNo = await app.sequences.next('receipt', {
+     *   scope: storeId,
+     *   format: 'S-{date}-{node4}-{seq}',
+     * })
+     * // → "S-20260508-a1b2-0042"
+     * ```
+     */
+    next(name: string, config?: SequenceConfig): Promise<string>;
+    /**
+     * Get the current counter value without incrementing.
+     *
+     * @param name - The sequence name
+     * @param config - Optional scope
+     * @returns The current counter value, or 0 if never used
+     */
+    current(name: string, config?: {
+        scope?: string;
+    }): Promise<number>;
+    /**
+     * Reset a sequence counter.
+     *
+     * @param name - The sequence name
+     * @param config - Optional scope and target value
+     */
+    reset(name: string, config?: {
+        scope?: string;
+        to?: number;
+    }): Promise<void>;
 }
 /**
  * The main application object returned by createApp().
@@ -101,12 +183,41 @@ interface KoraApp {
     events: KoraEventEmitter;
     /** Sync control (connect/disconnect/status). Null if sync not configured. */
     sync: SyncControl | null;
+    /** Offline-safe sequence generation. */
+    sequences: SequenceAccessor;
     /** Get the underlying Store instance (for advanced use / React integration). */
     getStore(): _korajs_store.Store;
     /** Get the underlying SyncEngine instance. Null if sync not configured. */
     getSyncEngine(): SyncEngine | null;
     /** Gracefully close the app: stop sync, close store. */
     close(): Promise<void>;
+    /**
+     * Execute multiple mutations atomically within a transaction.
+     * All operations are committed together or rolled back on error.
+     * Subscription notifications are batched after commit.
+     *
+     * @example
+     * ```typescript
+     * await app.transaction(async (tx) => {
+     *   await tx.sales.update(saleId, { status: 'completed' })
+     *   await tx.payments.insert({ saleId, method: 'cash', amount: total })
+     * })
+     * ```
+     */
+    transaction(fn: (tx: TransactionProxy) => Promise<void>): Promise<Operation[]>;
+    /**
+     * Execute a named mutation — a transaction with a human-readable name.
+     * The mutation name is attached to all operations and visible in DevTools.
+     *
+     * @example
+     * ```typescript
+     * await app.mutation('complete-sale', async (tx) => {
+     *   await tx.sales.update(saleId, { status: 'completed' })
+     *   await tx.payments.insert({ saleId, method: 'cash', amount: total })
+     * })
+     * ```
+     */
+    mutation(name: string, fn: (tx: TransactionProxy) => Promise<void>): Promise<Operation[]>;
     /** Dynamic collection accessors (e.g., app.todos). Typed via Object.defineProperty. */
     [collection: string]: unknown;
 }
@@ -137,12 +248,18 @@ type TypedKoraApp<S extends SchemaInput> = {
     events: KoraEventEmitter;
     /** Sync control (connect/disconnect/status). Null if sync not configured. */
     sync: SyncControl | null;
+    /** Offline-safe sequence generation. */
+    sequences: SequenceAccessor;
     /** Get the underlying Store instance (for advanced use / React integration). */
     getStore(): _korajs_store.Store;
     /** Get the underlying SyncEngine instance. Null if sync not configured. */
     getSyncEngine(): SyncEngine | null;
     /** Gracefully close the app: stop sync, close store. */
     close(): Promise<void>;
+    /** Execute multiple mutations atomically within a transaction. */
+    transaction(fn: (tx: TransactionProxy) => Promise<void>): Promise<Operation[]>;
+    /** Execute a named mutation — a transaction with a DevTools-visible name. */
+    mutation(name: string, fn: (tx: TransactionProxy) => Promise<void>): Promise<Operation[]>;
 } & {
     readonly [C in keyof S['collections'] & string]: S['collections'][C] extends {
         fields: infer F extends Record<string, FieldBuilder<any, any, any>>;
@@ -190,4 +307,4 @@ declare function createApp<const S extends SchemaInput>(config: TypedKoraConfig<
  */
 declare function createApp(config: KoraConfig): KoraApp;
 
-export { type AdapterType, type KoraApp, type KoraConfig, type StoreOptions, type SyncControl, type SyncOptions, 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 };

package/dist/index.js

@@ -1,9 +1,15 @@
 // src/create-app.ts
+import { buildScopeMap } from "@korajs/core";
 import { SimpleEventEmitter } from "@korajs/core/internal";
 import { Instrumenter } from "@korajs/devtools";
 import { MergeEngine } from "@korajs/merge";
 import { Store } from "@korajs/store";
-import { ConnectionMonitor, ReconnectionManager, SyncEngine, WebSocketTransport } from "@korajs/sync";
+import {
+  ConnectionMonitor,
+  ReconnectionManager,
+  SyncEngine,
+  WebSocketTransport
+} from "@korajs/sync";
 
 // src/adapter-resolver.ts
 function detectAdapterType() {
@@ -24,8 +30,10 @@ function detectAdapterType() {
 async function createAdapter(type, dbName, workerUrl) {
   switch (type) {
     case "tauri-sqlite": {
-      const dynamicImport = new Function("specifier", "return import(specifier)");
-      const { TauriSqliteAdapter } = await dynamicImport("@korajs/tauri");
+      const { TauriSqliteAdapter } = await import(
+        /* @vite-ignore */
+        "@korajs/tauri"
+      );
       return new TauriSqliteAdapter({ path: `${dbName}.db` });
     }
     case "better-sqlite3": {
@@ -69,23 +77,23 @@ var MergeAwareSyncStore = class {
   async getOperationRange(nodeId, fromSeq, toSeq) {
     return this.store.getOperationRange(nodeId, fromSeq, toSeq);
   }
-  async applyRemoteOperation(op) {
-    if (op.type !== "update" || !op.data || !op.previousData) {
-      return this.store.applyRemoteOperation(op);
+  async applyRemoteOperation(op2) {
+    if (op2.type !== "update" || !op2.data || !op2.previousData) {
+      return this.store.applyRemoteOperation(op2);
     }
     const schema = this.store.getSchema();
-    const collectionDef = schema.collections[op.collection];
+    const collectionDef = schema.collections[op2.collection];
     if (!collectionDef) {
-      return this.store.applyRemoteOperation(op);
+      return this.store.applyRemoteOperation(op2);
     }
-    const accessor = this.store.collection(op.collection);
-    const currentRecord = await accessor.findById(op.recordId);
+    const accessor = this.store.collection(op2.collection);
+    const currentRecord = await accessor.findById(op2.recordId);
     if (!currentRecord) {
-      return this.store.applyRemoteOperation(op);
+      return this.store.applyRemoteOperation(op2);
     }
     let hasConflict = false;
-    for (const field of Object.keys(op.data)) {
-      const expectedBase = op.previousData[field];
+    for (const field of Object.keys(op2.data)) {
+      const expectedBase = op2.previousData[field];
       const currentLocal = currentRecord[field];
       if (!deepEqual(expectedBase, currentLocal)) {
         hasConflict = true;
@@ -93,24 +101,24 @@ var MergeAwareSyncStore = class {
       }
     }
     if (!hasConflict) {
-      return this.store.applyRemoteOperation(op);
+      return this.store.applyRemoteOperation(op2);
     }
     this.emitter?.emit({
       type: "merge:started",
-      operationA: op,
-      operationB: op
+      operationA: op2,
+      operationB: op2
     });
-    const baseState = { ...op.previousData };
+    const baseState = { ...op2.previousData };
     const localOp = {
-      ...op,
+      ...op2,
       // The "local" operation's data is the diff between base and current local state
-      data: buildLocalDiff(op.previousData, currentRecord, Object.keys(op.data)),
-      previousData: op.previousData,
+      data: buildLocalDiff(op2.previousData, currentRecord, Object.keys(op2.data)),
+      previousData: op2.previousData,
       nodeId: this.store.getNodeId()
     };
     const input = {
       local: localOp,
-      remote: op,
+      remote: op2,
       baseState,
       collectionDef
     };
@@ -123,7 +131,7 @@ var MergeAwareSyncStore = class {
       this.emitter?.emit({ type: "merge:completed", trace: firstTrace });
     }
     const mergedOp = {
-      ...op,
+      ...op2,
       data: result.mergedData
     };
     return this.store.applyRemoteOperation(mergedOp);
@@ -245,13 +253,104 @@ function createApp(config) {
       if (syncEngine) {
         return syncEngine.getStatus();
       }
-      return { status: "offline", pendingOperations: 0, lastSyncedAt: null };
+      return {
+        status: "offline",
+        pendingOperations: 0,
+        lastSyncedAt: null,
+        lastSuccessfulPush: null,
+        lastSuccessfulPull: null,
+        conflicts: 0
+      };
+    },
+    async retryNow() {
+      await ready;
+      if (syncEngine) {
+        await syncEngine.retryNow();
+      }
+    },
+    exportDiagnostics() {
+      if (syncEngine) {
+        return syncEngine.exportDiagnostics();
+      }
+      return {
+        state: "disconnected",
+        status: {
+          status: "offline",
+          pendingOperations: 0,
+          lastSyncedAt: null,
+          lastSuccessfulPush: null,
+          lastSuccessfulPull: null,
+          conflicts: 0
+        },
+        nodeId: "",
+        url: config.sync?.url ?? "",
+        schemaVersion: config.schema.version,
+        lastSyncedAt: null,
+        lastSuccessfulPush: null,
+        lastSuccessfulPull: null,
+        conflicts: 0,
+        pendingOperations: 0,
+        hasInFlightBatch: false,
+        reconnecting: false,
+        timestamp: Date.now()
+      };
     }
   } : null;
+  async function executeTransaction(fn, mutationName) {
+    await ready;
+    if (!store) {
+      throw new Error("Store not initialized. Await app.ready before using transactions.");
+    }
+    const txContext = store.createTransaction();
+    if (mutationName !== void 0) {
+      txContext.setMutationName(mutationName);
+    }
+    const collectionNames = Object.keys(config.schema.collections);
+    const proxy = {};
+    for (const name of collectionNames) {
+      Object.defineProperty(proxy, name, {
+        get() {
+          return txContext.collection(name);
+        },
+        enumerable: true,
+        configurable: false
+      });
+    }
+    try {
+      await fn(proxy);
+      const { operations } = await txContext.commit();
+      for (const op2 of operations) {
+        store.getSubscriptionManager().notify(op2.collection, op2);
+        emitter.emit({ type: "operation:created", operation: op2 });
+      }
+      return operations;
+    } catch (error) {
+      txContext.rollback();
+      throw error;
+    }
+  }
+  const sequences = {
+    async next(name, config2) {
+      await ready;
+      if (!store) throw new Error("Store not initialized. Await app.ready before using sequences.");
+      return store.getSequenceManager().next(name, config2);
+    },
+    async current(name, config2) {
+      await ready;
+      if (!store) throw new Error("Store not initialized. Await app.ready before using sequences.");
+      return store.getSequenceManager().current(name, config2);
+    },
+    async reset(name, config2) {
+      await ready;
+      if (!store) throw new Error("Store not initialized. Await app.ready before using sequences.");
+      return store.getSequenceManager().reset(name, config2);
+    }
+  };
   const app = {
     ready,
     events: emitter,
     sync: syncControl,
+    sequences,
     getStore() {
       if (!store) {
         throw new Error("Store not initialized. Await app.ready before accessing the store.");
@@ -261,6 +360,12 @@ function createApp(config) {
     getSyncEngine() {
       return syncEngine;
     },
+    async transaction(fn) {
+      return executeTransaction(fn);
+    },
+    async mutation(name, fn) {
+      return executeTransaction(fn, name);
+    },
     async close() {
       await ready;
       intentionalDisconnect = true;
@@ -314,6 +419,7 @@ async function initializeAsync(config, emitter, mergeEngine) {
   if (config.sync) {
     const transport = new WebSocketTransport();
     const mergeAwareStore = new MergeAwareSyncStore(store, mergeEngine, emitter);
+    const scopeMap = config.sync.scope ? buildScopeMap(config.schema, config.sync.scope) : void 0;
     syncEngine = new SyncEngine({
       transport,
       store: mergeAwareStore,
@@ -322,7 +428,8 @@ async function initializeAsync(config, emitter, mergeEngine) {
         transport: config.sync.transport,
         auth: config.sync.auth,
         batchSize: config.sync.batchSize,
-        schemaVersion: config.sync.schemaVersion ?? config.schema.version
+        schemaVersion: config.sync.schemaVersion ?? config.schema.version,
+        scopeMap
       },
       emitter
     });
@@ -415,25 +522,31 @@ function createPendingQueryBuilder(initialWhere) {
 }
 
 // src/index.ts
-import { defineSchema, t } from "@korajs/core";
+import { defineSchema, migrate, t } from "@korajs/core";
 import { HybridLogicalClock } from "@korajs/core";
 import { generateUUIDv7 } from "@korajs/core";
 import { createOperation } from "@korajs/core";
 import { KoraError } from "@korajs/core";
-import { Store as Store2 } from "@korajs/store";
+import { op } from "@korajs/core";
+import { SequenceManager, Store as Store2 } from "@korajs/store";
+import { TransactionContext } from "@korajs/store";
 import { MergeEngine as MergeEngine2 } from "@korajs/merge";
 import { SyncEngine as SyncEngine2, WebSocketTransport as WebSocketTransport2 } from "@korajs/sync";
 export {
   HybridLogicalClock,
   KoraError,
   MergeEngine2 as MergeEngine,
+  SequenceManager,
   Store2 as Store,
   SyncEngine2 as SyncEngine,
+  TransactionContext,
   WebSocketTransport2 as WebSocketTransport,
   createApp,
   createOperation,
   defineSchema,
   generateUUIDv7,
+  migrate,
+  op,
   t
 };
 //# sourceMappingURL=index.js.map