@anfenn/dync 1.0.27 → 1.0.30

package/dist/react/index.d.cts

@@ -1,4 +1,4 @@
-import { a as SyncApi, k as SyncState } from '../types-yJuzCcux.cjs';
+import { a as SyncApi, k as SyncState } from '../types-DW42y281.cjs';
 import '../dexie-T9m1mP1h.cjs';
 import 'dexie';
 import '../types-CSbIAfu2.cjs';

package/dist/react/index.d.ts

@@ -1,4 +1,4 @@
-import { a as SyncApi, k as SyncState } from '../types-BLw25Wlc.js';
+import { a as SyncApi, k as SyncState } from '../types-n8Zge2zF.js';
 import '../dexie-BFPA0JU2.js';
 import 'dexie';
 import '../types-CSbIAfu2.js';

package/dist/{types-yJuzCcux.d.cts → types-DW42y281.d.cts}

@@ -94,36 +94,10 @@ interface SyncOptions {
     onAfterMissingRemoteRecordDuringUpdate?: MissingRemoteRecordDuringUpdateCallback;
     conflictResolutionStrategy?: ConflictResolutionStrategy;
 }
-/**
- * Configuration options for creating a Dync instance.
- *
- * @example Per-table sync mode
- * ```ts
- * const db = new Dync<Store>({
- *     databaseName: 'my-app',
- *     storageAdapter: new SQLiteAdapter(driver),
- *     sync: { todos: todoSyncApi },
- * });
- * ```
- *
- * @example Batch sync mode
- * ```ts
- * const db = new Dync<Store>({
- *     databaseName: 'my-app',
- *     storageAdapter: new SQLiteAdapter(driver),
- *     sync: { syncTables: ['todos'], push, pull },
- * });
- * ```
- */
 interface DyncOptions<TStoreMap extends Record<string, any> = Record<string, any>> {
     databaseName: string;
     storageAdapter: StorageAdapter;
-    /**
-     * Sync configuration - either per-table APIs or batch sync.
-     * Per-table: `{ tableName: { add, update, remove, list } }`
-     * Batch: `{ syncTables: [...], push, pull }`
-     */
-    sync: Partial<Record<keyof TStoreMap, ApiFunctions>> | BatchSync;
+    sync?: Partial<Record<keyof TStoreMap, ApiFunctions>> | BatchSync;
     options?: SyncOptions;
 }
 interface FirstLoadProgress {
@@ -136,7 +110,6 @@ type FirstLoadProgressCallback = (progress: FirstLoadProgress) => void;
 type SyncApi = {
     enable: (enabled: boolean) => Promise<void>;
     startFirstLoad: (onProgress?: FirstLoadProgressCallback) => Promise<void>;
-    /** Current sync state - use useSyncState() hook for reactive updates in React */
     readonly state: SyncState;
     resolveConflict: (localId: string, keepLocal: boolean) => Promise<void>;
     onStateChange: (fn: (state: SyncState) => void) => () => void;

package/dist/{types-BLw25Wlc.d.ts → types-n8Zge2zF.d.ts}

@@ -94,36 +94,10 @@ interface SyncOptions {
     onAfterMissingRemoteRecordDuringUpdate?: MissingRemoteRecordDuringUpdateCallback;
     conflictResolutionStrategy?: ConflictResolutionStrategy;
 }
-/**
- * Configuration options for creating a Dync instance.
- *
- * @example Per-table sync mode
- * ```ts
- * const db = new Dync<Store>({
- *     databaseName: 'my-app',
- *     storageAdapter: new SQLiteAdapter(driver),
- *     sync: { todos: todoSyncApi },
- * });
- * ```
- *
- * @example Batch sync mode
- * ```ts
- * const db = new Dync<Store>({
- *     databaseName: 'my-app',
- *     storageAdapter: new SQLiteAdapter(driver),
- *     sync: { syncTables: ['todos'], push, pull },
- * });
- * ```
- */
 interface DyncOptions<TStoreMap extends Record<string, any> = Record<string, any>> {
     databaseName: string;
     storageAdapter: StorageAdapter;
-    /**
-     * Sync configuration - either per-table APIs or batch sync.
-     * Per-table: `{ tableName: { add, update, remove, list } }`
-     * Batch: `{ syncTables: [...], push, pull }`
-     */
-    sync: Partial<Record<keyof TStoreMap, ApiFunctions>> | BatchSync;
+    sync?: Partial<Record<keyof TStoreMap, ApiFunctions>> | BatchSync;
     options?: SyncOptions;
 }
 interface FirstLoadProgress {
@@ -136,7 +110,6 @@ type FirstLoadProgressCallback = (progress: FirstLoadProgress) => void;
 type SyncApi = {
     enable: (enabled: boolean) => Promise<void>;
     startFirstLoad: (onProgress?: FirstLoadProgressCallback) => Promise<void>;
-    /** Current sync state - use useSyncState() hook for reactive updates in React */
     readonly state: SyncState;
     resolveConflict: (localId: string, keepLocal: boolean) => Promise<void>;
     onStateChange: (fn: (state: SyncState) => void) => () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anfenn/dync",
-  "version": "1.0.27",
+  "version": "1.0.30",
   "private": false,
   "description": "Write once, run IndexedDB & SQLite with sync anywhere - React, React Native, Expo, Capacitor, Electron & Node.js",
   "keywords": [
@@ -132,8 +132,8 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "pnpm run format && pnpm run lint && pnpm exec tsc --noEmit && tsup",
-    "build:all": "pnpm run build && pnpm --filter react-capacitor build",
+    "build": "pnpm format && pnpm lint && pnpm exec tsc --noEmit && tsup",
+    "build:all": "pnpm build && pnpm --filter react-capacitor build",
     "dev": "tsup --watch",
     "lint": "eslint . --fix \"src/**/*.{js,jsx,ts,tsx,json}\"",
     "format": "prettier --write \"**/*.{ts,tsx,md}\"",
@@ -142,7 +142,9 @@
     "test:all": "pnpm --filter tests test:all",
     "test:ci": "pnpm --filter tests test:ci",
     "test:browser:full": "pnpm --filter tests test:browser:full",
-    "reinstall": "find . -name node_modules -type d -prune -exec rm -rf {} + && pnpm install"
+    "reinstall": "find . -name node_modules -type d -prune -exec rm -rf {} + && pnpm install",
+    "push": "bash -c '[ -n \"$1\" ] && git add . && git commit -m \"$1\" && git push' --",
+    "release": "bash -c '[ -n \"$1\" ] || { echo \"Usage: pnpm release <commit-message>\"; exit 1; } && pnpm build:all && pnpm test:all && pnpm test:browser:full && git add . && git commit -m \"$1\" && npm version patch && git push && git push --tags && npm publish' --"
   },
   "devDependencies": {
     "@capacitor-community/sqlite": "7.0.2",

package/src/core/tableEnhancers.ts

@@ -6,7 +6,7 @@ import type { WithTransaction } from './types';
 export type EmitMutation = (event: MutationEvent) => void;
 
 /**
- * Wraps a table with mutation emission for reactive updates.
+ * Wraps a table with mutation emission for reactive updates and auto-generates _localId.
  * This allows useLiveQuery to work with any table.
  */
 export function wrapWithMutationEmitter<T>(table: StorageTable<T>, tableName: string, emitMutation: EmitMutation): void {
@@ -21,13 +21,15 @@ export function wrapWithMutationEmitter<T>(table: StorageTable<T>, tableName: st
     const rawClear = table.raw.clear;
 
     table.add = async (item: AddItem<T>) => {
-        const result = await rawAdd(item as T);
+        const itemWithLocalId = { ...item, _localId: (item as any)._localId || createLocalId() } as T;
+        const result = await rawAdd(itemWithLocalId);
         emitMutation({ type: 'add', tableName, keys: [result] });
         return result;
     };
 
     table.put = async (item: T) => {
-        const result = await rawPut(item);
+        const itemWithLocalId = { ...item, _localId: (item as any)._localId || createLocalId() } as T;
+        const result = await rawPut(itemWithLocalId);
         emitMutation({ type: 'update', tableName, keys: [result] });
         return result;
     };
@@ -46,7 +48,11 @@ export function wrapWithMutationEmitter<T>(table: StorageTable<T>, tableName: st
     };
 
     table.bulkAdd = async (items: AddItem<T>[]) => {
-        const result = await rawBulkAdd(items as T[]);
+        const itemsWithLocalIds = items.map((item) => ({
+            ...item,
+            _localId: (item as any)._localId || createLocalId(),
+        })) as T[];
+        const result = await rawBulkAdd(itemsWithLocalIds);
         if (items.length > 0) {
             emitMutation({ type: 'add', tableName });
         }
@@ -54,7 +60,11 @@ export function wrapWithMutationEmitter<T>(table: StorageTable<T>, tableName: st
     };
 
     table.bulkPut = async (items: T[]) => {
-        const result = await rawBulkPut(items);
+        const itemsWithLocalIds = items.map((item) => ({
+            ...item,
+            _localId: (item as any)._localId || createLocalId(),
+        })) as T[];
+        const result = await rawBulkPut(itemsWithLocalIds);
         if (items.length > 0) {
             emitMutation({ type: 'update', tableName });
         }

package/src/index.shared.ts

@@ -85,15 +85,17 @@ class DyncBase<_TStoreMap extends Record<string, any> = Record<string, any>> {
     constructor(config: DyncOptions<_TStoreMap>) {
         const { databaseName, storageAdapter, sync: syncConfig, options } = config;
 
-        // Detect mode based on whether sync config has batch sync shape
-        const isBatchMode = typeof (syncConfig as BatchSync).push === 'function' && typeof (syncConfig as BatchSync).pull === 'function';
-
-        if (isBatchMode) {
-            this.batchSync = syncConfig as BatchSync;
-            this.syncedTables = new Set(this.batchSync.syncTables);
-        } else {
-            this.syncApis = syncConfig as Record<string, ApiFunctions>;
-            this.syncedTables = new Set(Object.keys(this.syncApis));
+        if (syncConfig) {
+            // Detect mode based on whether sync config has batch sync shape
+            const isBatchMode = typeof syncConfig.push === 'function' && typeof syncConfig.pull === 'function';
+
+            if (isBatchMode) {
+                this.batchSync = syncConfig as BatchSync;
+                this.syncedTables = new Set(this.batchSync.syncTables);
+            } else {
+                this.syncApis = syncConfig as Record<string, ApiFunctions>;
+                this.syncedTables = new Set(Object.keys(this.syncApis));
+            }
         }
 
         this.adapter = storageAdapter;
@@ -158,6 +160,9 @@ class DyncBase<_TStoreMap extends Record<string, any> = Record<string, any>> {
                             // Auto-inject sync fields for sync tables
                             // Note: updated_at is indexed to support user queries like orderBy('updated_at')
                             fullSchema[tableName] = `${LOCAL_PK}, &${SERVER_PK}, ${tableSchema}, ${UPDATED_AT}`;
+                        } else {
+                            // Auto-inject _localId as primary key for non-sync tables
+                            fullSchema[tableName] = `${LOCAL_PK}, ${tableSchema}`;
                         }
 
                         self.logger.debug(
@@ -167,6 +172,9 @@ class DyncBase<_TStoreMap extends Record<string, any> = Record<string, any>> {
                         if (isSyncTable) {
                             // Auto-inject sync columns for structured schemas
                             fullSchema[tableName] = self.injectSyncColumns(tableSchema);
+                        } else {
+                            // Auto-inject _localId column for non-sync structured schemas
+                            fullSchema[tableName] = self.injectLocalIdColumn(tableSchema);
                         }
 
                         const schemaColumns = Object.keys((fullSchema[tableName] as SQLiteTableDefinition).columns ?? {}).join(', ');
@@ -350,6 +358,26 @@ class DyncBase<_TStoreMap extends Record<string, any> = Record<string, any>> {
         };
     }
 
+    private injectLocalIdColumn(schema: SQLiteTableDefinition): SQLiteTableDefinition {
+        const columns = schema.columns ?? {};
+
+        // Validate user hasn't defined reserved _localId column
+        if (columns[LOCAL_PK]) {
+            throw new Error(`Column '${LOCAL_PK}' is auto-injected and cannot be defined manually.`);
+        }
+
+        // Inject _localId column as primary key
+        const injectedColumns: Record<string, any> = {
+            ...columns,
+            [LOCAL_PK]: { type: 'TEXT' },
+        };
+
+        return {
+            ...schema,
+            columns: injectedColumns,
+        };
+    }
+
     private enhanceSyncTable<T>(table: StorageTable<T & SyncedRecord>, tableName: string): void {
         enhanceSyncTable({
             table,

package/src/types.ts

@@ -122,36 +122,10 @@ export interface SyncOptions {
     conflictResolutionStrategy?: ConflictResolutionStrategy;
 }
 
-/**
- * Configuration options for creating a Dync instance.
- *
- * @example Per-table sync mode
- * ```ts
- * const db = new Dync<Store>({
- *     databaseName: 'my-app',
- *     storageAdapter: new SQLiteAdapter(driver),
- *     sync: { todos: todoSyncApi },
- * });
- * ```
- *
- * @example Batch sync mode
- * ```ts
- * const db = new Dync<Store>({
- *     databaseName: 'my-app',
- *     storageAdapter: new SQLiteAdapter(driver),
- *     sync: { syncTables: ['todos'], push, pull },
- * });
- * ```
- */
 export interface DyncOptions<TStoreMap extends Record<string, any> = Record<string, any>> {
     databaseName: string;
     storageAdapter: StorageAdapter;
-    /**
-     * Sync configuration - either per-table APIs or batch sync.
-     * Per-table: `{ tableName: { add, update, remove, list } }`
-     * Batch: `{ syncTables: [...], push, pull }`
-     */
-    sync: Partial<Record<keyof TStoreMap, ApiFunctions>> | BatchSync;
+    sync?: Partial<Record<keyof TStoreMap, ApiFunctions>> | BatchSync;
     options?: SyncOptions;
 }
 
@@ -167,7 +141,7 @@ export type FirstLoadProgressCallback = (progress: FirstLoadProgress) => void;
 export type SyncApi = {
     enable: (enabled: boolean) => Promise<void>;
     startFirstLoad: (onProgress?: FirstLoadProgressCallback) => Promise<void>;
-    /** Current sync state - use useSyncState() hook for reactive updates in React */
+    // Current sync state - use useSyncState() hook for reactive updates in React
     readonly state: SyncState;
     resolveConflict: (localId: string, keepLocal: boolean) => Promise<void>;
     onStateChange: (fn: (state: SyncState) => void) => () => void;