muya 2.4.94 → 2.4.96

package/esm/sqlite/create-sqlite.js

@@ -1 +1 @@
-import{STATE_SCHEDULER as l}from"../create";import{getId as m}from"../utils/id";import{createTable as d}from"./table/table";function D(u){let s;async function a(){if(!s){const{backend:e,...n}=u,t=e instanceof Promise?await e:e;s=await d({backend:t,...n})}return s}const i=m();l.add(i,{onScheduleDone(e){if(!e)return;const n=e,t={};for(const c of n)c.removedAll&&(t.removedAll=!0),c.mutations&&(t.mutations||(t.mutations=[]),t.mutations.push(...c.mutations));for(const c of r)c(t)}});function o(e){l.schedule(i,e)}const r=new Set;return{subscribe(e){return r.add(e),()=>r.delete(e)},async clear(){const e=await a();return o({removedAll:!0}),e.clear()},async set(e){const t=await(await a()).set(e);return o({mutations:[t]}),t},async batchSet(e){const t=await(await a()).batchSet(e);return o({mutations:t}),t},async delete(e){const t=await(await a()).delete(e);return t&&o({mutations:[t]}),t},async deleteBy(e){const t=await(await a()).deleteBy(e);return o({mutations:t}),t},async get(e,n){return(await a()).get(e,n)},async*search(e={}){const n=await a();for await(const t of n.search(e))yield t},async count(e){return await(await a()).count(e)}}}export{D as createSqliteState};
+import{STATE_SCHEDULER as u}from"../create";import{getId as m}from"../utils/id";import{createTable as d}from"./table/table";function h(l){let s;async function o(){if(!s){const{backend:e,...n}=l,t=e instanceof Promise?await e:e;s=await d({backend:t,...n})}return s}const i=m();u.add(i,{onScheduleDone(e){if(!e)return;const n=e,t={};for(const c of n)c.removedAll&&(t.removedAll=!0),c.mutations&&(t.mutations||(t.mutations=[]),t.mutations.push(...c.mutations));for(const c of r)c(t)}});function a(e){u.schedule(i,e)}const r=new Set;return{subscribe(e){return r.add(e),()=>r.delete(e)},async clear(){const e=await o();return a({removedAll:!0}),e.clear()},async set(e){const t=await(await o()).set(e);return a({mutations:[t]}),t},async batchSet(e){const t=await(await o()).batchSet(e);return a({mutations:t}),t},async batchDelete(e){const t=await(await o()).batchDelete(e);return a({mutations:t}),t},async delete(e){const t=await(await o()).delete(e);return t&&a({mutations:[t]}),t},async deleteBy(e){const t=await(await o()).deleteBy(e);return a({mutations:t}),t},async get(e,n){return(await o()).get(e,n)},async*search(e={}){const n=await o();for await(const t of n.search(e))yield t},async count(e){return await(await o()).count(e)}}}export{h as createSqliteState};

package/esm/sqlite/table/table.js

@@ -1,4 +1,4 @@
-import{unicodeTokenizer as _}from"./tokenizer";import{getWhereQuery as g}from"./where";const x=500,C=100;function m(l){return"$."+l}function M(l,s){if(!(!l||!s))return s.split(".").reduce((t,y)=>{if(typeof t=="object"&&t!==null&&y in t)return t[y]},l)}async function G(l){const{backend:s,tableName:t,indexes:y,key:$,disablePragmaOptimization:L}=l,u=$!==void 0;L||(await s.execute("PRAGMA journal_mode=WAL;"),await s.execute("PRAGMA synchronous=NORMAL;"),await s.execute("PRAGMA temp_store=MEMORY;"),await s.execute("PRAGMA cache_size=-20000;")),u?await s.execute(`
+import{unicodeTokenizer as _}from"./tokenizer";import{getWhereQuery as g}from"./where";const x=500,C=100;function R(l){return"$."+l}function M(l,s){if(!(!l||!s))return s.split(".").reduce((t,w)=>{if(typeof t=="object"&&t!==null&&w in t)return t[w]},l)}async function G(l){const{backend:s,tableName:t,indexes:w,key:$,disablePragmaOptimization:L}=l,E=$!==void 0;L||(await s.execute("PRAGMA journal_mode=WAL;"),await s.execute("PRAGMA synchronous=NORMAL;"),await s.execute("PRAGMA temp_store=MEMORY;"),await s.execute("PRAGMA cache_size=-20000;")),E?await s.execute(`
       CREATE TABLE IF NOT EXISTS ${t} (
         key TEXT PRIMARY KEY,
         data TEXT NOT NULL
@@ -7,8 +7,8 @@ import{unicodeTokenizer as _}from"./tokenizer";import{getWhereQuery as g}from"./
       CREATE TABLE IF NOT EXISTS ${t} (
         data TEXT NOT NULL
       );
-    `);let d;const T=[],f={};for(const e of y??[])if(typeof e=="string"&&e.startsWith("fts:")){const n=e.slice(4),o=n.replaceAll(".","_");T.push(n),f[n]=o}else if(typeof e=="object"&&e.type==="fts"){const n=e.path,o=n.replaceAll(".","_");if(T.push(n),f[n]=o,e.tokenizer){if(!d)d=e.tokenizer;else if(d!==e.tokenizer)throw new Error(`Conflicting FTS tokenizers: already using "${d}", got "${e.tokenizer}"`)}}else{const n=String(e);await s.execute(`CREATE INDEX IF NOT EXISTS idx_${t}_${n.replaceAll(/\W/g,"_")}
-       ON ${t} (json_extract(data, '${m(n)}'));`)}if(T.length>0){let e;typeof d=="object"?e=_(d):d===void 0?e='"unicode61", "remove_diacritics=1"':e=d;const n=T.map(r=>f[r]).join(", "),o=`
+    `);let d;const T=[],f={};for(const e of w??[])if(typeof e=="string"&&e.startsWith("fts:")){const n=e.slice(4),o=n.replaceAll(".","_");T.push(n),f[n]=o}else if(typeof e=="object"&&e.type==="fts"){const n=e.path,o=n.replaceAll(".","_");if(T.push(n),f[n]=o,e.tokenizer){if(!d)d=e.tokenizer;else if(d!==e.tokenizer)throw new Error(`Conflicting FTS tokenizers: already using "${d}", got "${e.tokenizer}"`)}}else{const n=String(e);await s.execute(`CREATE INDEX IF NOT EXISTS idx_${t}_${n.replaceAll(/\W/g,"_")}
+       ON ${t} (json_extract(data, '${R(n)}'));`)}if(T.length>0){let e;typeof d=="object"?e=_(d):d===void 0?e='"unicode61", "remove_diacritics=1"':e=d;const n=T.map(r=>f[r]).join(", "),o=`
         CREATE VIRTUAL TABLE IF NOT EXISTS ${t}_fts
         USING fts5(${n}, tokenize=${e});
 `;await s.execute(o),await s.execute(`
@@ -18,7 +18,7 @@ import{unicodeTokenizer as _}from"./tokenizer";import{getWhereQuery as g}from"./
         INSERT INTO ${t}_fts(rowid, ${n})
         VALUES (
           new.rowid,
-          ${T.map(r=>`json_extract(new.data, '${m(r)}')`).join(", ")}
+          ${T.map(r=>`json_extract(new.data, '${R(r)}')`).join(", ")}
         );
       END;
     `),await s.execute(`
@@ -32,7 +32,7 @@ import{unicodeTokenizer as _}from"./tokenizer";import{getWhereQuery as g}from"./
       AFTER UPDATE ON ${t}
       BEGIN
         UPDATE ${t}_fts
-        SET ${T.map(r=>`${f[r]}=json_extract(new.data, '${m(r)}')`).join(", ")}
+        SET ${T.map(r=>`${f[r]}=json_extract(new.data, '${R(r)}')`).join(", ")}
         WHERE rowid = old.rowid;
       END;
-    `)}function A(e){if(u)return M(e,String($))}const k={backend:s,async set(e,n){const o=n??s,r=JSON.stringify(e);if(u){const a=A(e);if(a==null)throw new Error(`Document is missing the configured key "${String($)}".`);return(await o.select(`SELECT key FROM ${t} WHERE key = ?`,[a])).length>0?(await o.execute(`UPDATE ${t} SET data = ? WHERE key = ?`,[r,a]),{key:a,op:"update"}):(await o.execute(`INSERT INTO ${t} (key, data) VALUES (?, ?)`,[a,r]),{key:a,op:"insert"})}await o.execute(`INSERT INTO ${t} (data) VALUES (?)`,[r]);const c=(await o.select("SELECT last_insert_rowid() AS id"))[0]?.id;if(typeof c!="number")throw new Error("Failed to retrieve last_insert_rowid()");return{key:c,op:"insert"}},async get(e,n=o=>o){const o=u?"key = ?":"rowid = ?",r=await s.select(`SELECT rowid, data FROM ${t} WHERE ${o}`,[e]);if(r.length===0)return;const{data:E,rowid:c}=r[0],a=JSON.parse(E),i=u?A(a)??c:c;return n(a,{rowId:c,key:i})},async delete(e){const n=u?"key = ?":"rowid = ?";if(await s.execute(`DELETE FROM ${t} WHERE ${n}`,[e]),((await s.select("SELECT changes() AS c"))[0]?.c??0)>0)return{key:e,op:"delete"}},async*search(e={}){const{sortBy:n,order:o="asc",limit:r,offset:E=0,where:c,select:a=w=>w,pageSize:i=C}=e,S=g(c,t),h=`SELECT rowid, data FROM ${t} ${S}`;let p=0,I=E;for(;;){let w=h;n?w+=` ORDER BY json_extract(data, '${m(String(n))}') COLLATE NOCASE ${o.toUpperCase()}`:w+=u?` ORDER BY key COLLATE NOCASE ${o.toUpperCase()}`:` ORDER BY rowid ${o.toUpperCase()}`;const N=r?Math.min(i,r-p):i;w+=` LIMIT ${N} OFFSET ${I}`;const R=await s.select(w);if(R.length===0)break;for(const{rowid:O,data:F}of R){if(r&&p>=r)return;const D=JSON.parse(F),b=u?A(D)??O:O;yield a(D,{rowId:O,key:b}),p++}if(R.length<N||r&&p>=r)break;I+=R.length}},async count(e={}){const n=g(e.where,t),o=`SELECT COUNT(*) as count FROM ${t} ${n}`;return(await s.select(o))[0]?.count??0},async deleteBy(e){const n=g(e,t),o=u?"key":"rowid",r=[];return await s.transaction(async E=>{const c=await E.select(`SELECT ${o} AS k FROM ${t} ${n}`);if(c.length===0)return;const a=c.map(i=>i.k);for(let i=0;i<a.length;i+=x){const S=a.slice(i,i+x),h=S.map(()=>"?").join(",");await E.execute(`DELETE FROM ${t} WHERE ${o} IN (${h})`,S)}for(const i of a)r.push({key:i,op:"delete"})}),r},async clear(){await s.execute(`DELETE FROM ${t}`)},async batchSet(e){const n=[];return await s.transaction(async o=>{for(const r of e){const E=await k.set(r,o);n.push(E)}}),n}};return k}export{C as DEFAULT_PAGE_SIZE,G as createTable,M as getByPath,m as toJsonPath};
+    `)}function h(e){if(E)return M(e,String($))}const A={backend:s,async set(e,n){const o=n??s,r=JSON.stringify(e);if(E){const a=h(e);if(a==null)throw new Error(`Document is missing the configured key "${String($)}".`);return(await o.select(`SELECT key FROM ${t} WHERE key = ?`,[a])).length>0?(await o.execute(`UPDATE ${t} SET data = ? WHERE key = ?`,[r,a]),{key:a,op:"update",document:e}):(await o.execute(`INSERT INTO ${t} (key, data) VALUES (?, ?)`,[a,r]),{key:a,op:"insert",document:e})}await o.execute(`INSERT INTO ${t} (data) VALUES (?)`,[r]);const u=(await o.select("SELECT last_insert_rowid() AS id"))[0]?.id;if(typeof u!="number")throw new Error("Failed to retrieve last_insert_rowid()");return{key:u,op:"insert",document:e}},async get(e,n=o=>o){const o=E?"key = ?":"rowid = ?",r=await s.select(`SELECT rowid, data FROM ${t} WHERE ${o}`,[e]);if(r.length===0)return;const{data:c,rowid:u}=r[0],a=JSON.parse(c),i=E?h(a)??u:u;return n(a,{rowId:u,key:i})},async delete(e,n){const o=n??s,r=E?"key = ?":"rowid = ?";if(await o.execute(`DELETE FROM ${t} WHERE ${r}`,[e]),((await s.select("SELECT changes() AS c"))[0]?.c??0)>0)return{key:e,op:"delete"}},async*search(e={}){const{sortBy:n,order:o="asc",limit:r,offset:c=0,where:u,select:a=y=>y,pageSize:i=C}=e,p=g(u,t),k=`SELECT rowid, data FROM ${t} ${p}`;let S=0,D=c;for(;;){let y=k;n?y+=` ORDER BY json_extract(data, '${R(String(n))}') COLLATE NOCASE ${o.toUpperCase()}`:y+=E?` ORDER BY key COLLATE NOCASE ${o.toUpperCase()}`:` ORDER BY rowid ${o.toUpperCase()}`;const I=r?Math.min(i,r-S):i;y+=` LIMIT ${I} OFFSET ${D}`;const m=await s.select(y);if(m.length===0)break;for(const{rowid:O,data:b}of m){if(r&&S>=r)return;const N=JSON.parse(b),F=E?h(N)??O:O;yield a(N,{rowId:O,key:F}),S++}if(m.length<I||r&&S>=r)break;D+=m.length}},async count(e={}){const n=g(e.where,t),o=`SELECT COUNT(*) as count FROM ${t} ${n}`;return(await s.select(o))[0]?.count??0},async deleteBy(e){const n=g(e,t),o=E?"key":"rowid",r=[];return await s.transaction(async c=>{const u=await c.select(`SELECT ${o} AS k FROM ${t} ${n}`);if(u.length===0)return;const a=u.map(i=>i.k);for(let i=0;i<a.length;i+=x){const p=a.slice(i,i+x),k=p.map(()=>"?").join(",");await c.execute(`DELETE FROM ${t} WHERE ${o} IN (${k})`,p)}for(const i of a)r.push({key:i,op:"delete",document:void 0})}),r},async clear(){await s.execute(`DELETE FROM ${t}`)},async batchSet(e){const n=[];return await s.transaction(async o=>{for(const r of e){const c=await A.set(r,o);n.push(c)}}),n},async batchDelete(e){const n=[];return await s.transaction(async o=>{for(const r of e){const c=await A.delete(r,o);c&&n.push(c)}}),n}};return A}export{C as DEFAULT_PAGE_SIZE,G as createTable,M as getByPath,R as toJsonPath};

package/esm/sqlite/use-sqlite.js

@@ -1 +1 @@
-import{useCallback as f,useLayoutEffect as P,useReducer as _,useRef as D}from"react";import{DEFAULT_PAGE_SIZE as C}from"./table";import{shallow as E}from"../utils/shallow";const T=1e4;function z(a,w={},I=[]){const{select:m,pageSize:q=C}=w,e=D(null),[,k]=_(c=>c+1,0),n=D(new Map),x=D(null),A=f(()=>{const{select:c,...i}=w;x.current=a.search({select:(u,l)=>({doc:u,meta:l}),...i})},[a,...I]),d=f(()=>{e.current=[],n.current.clear(),A()},[A]),y=f(async c=>{e.current===null&&(e.current=[]),c===!0&&d();const{current:i}=x;if(!i)return!0;let u=!1;for(let l=0;l<q;l++){const o=await i.next();if(o.done){x.current=null,u=!0;break}n.current.has(o.value.meta.key)||(e.current.push(m?m(o.value.doc):o.value.doc),n.current.set(o.value.meta.key,e.current.length-1))}return e.current=[...e.current],u},[]),p=f(async()=>{const c=await y(!1);return k(),c},[y]);P(()=>{const c=a.subscribe(async i=>{const{mutations:u,removedAll:l}=i;if(l&&d(),!u)return;const o=e.current?.length??0;let g=o,h=!1;const S=new Set;for(const s of u){const{key:r,op:b}=s;switch(b){case"insert":{g+=1;break}case"delete":{if(e.current&&e.current.length>0&&n.current.has(r)){const t=n.current.get(r);if(t===void 0)break;S.add(t),h=!0}break}case"update":{if(n.current.has(r)){const t=n.current.get(r);if(t!==void 0&&e.current){const v=await a.get(r,m),O=e.current[t];E(O,v)||(e.current[t]=v,e.current=[...e.current],h=!0)}}else{const t=await a.get(r,m);t&&(e.current=[...e.current??[],t],n.current.set(r,e.current.length-1),h=!0)}break}}}if(S.size>0&&e.current&&e.current.length>0){const s=new Map;e.current=e.current?.filter((b,t)=>!S.has(t));let r=0;for(const[b,t]of n.current)S.has(t)||(s.set(b,r),r++);n.current=s}const L=o!==g;if(L||h){if(L){await y(!0);let s=0;for(;(e.current?.length??0)<g&&s<T;)await y(!1),s++;s===T&&console.warn("Reached maximum iterations in fillNextPage loop. Possible duplicate or data issue.")}k()}});return()=>{c()}},[a]),P(()=>{d(),p()},I);const R=f(async()=>{d(),await p()},[p,d]);return[e.current,{nextPage:p,reset:R,keysIndex:n.current}]}export{z as useSqliteValue};
+import{useCallback as y,useLayoutEffect as T,useReducer as C,useRef as w}from"react";import{DEFAULT_PAGE_SIZE as E}from"./table";import{shallow as K}from"../utils/shallow";const q=1e4;function F(d,k={},I=[]){const{select:f,pageSize:R=E}=k,e=w(null),[,A]=C(c=>c+1,0),t=w(new Map),g=w(null),L=y(()=>{const{select:c,...a}=k;g.current=d.search({select:(u,i)=>({doc:u,meta:i}),...a})},[d,...I]),m=y(()=>{e.current=[],t.current.clear(),L()},[L]),p=y(async c=>{e.current===null&&(e.current=[]),c===!0&&m();const{current:a}=g;if(!a)return!0;let u=!1;for(let i=0;i<R;i++){const o=await a.next();if(o.done){g.current=null,u=!0;break}t.current.has(o.value.meta.key)||(e.current.push(f?f(o.value.doc):o.value.doc),t.current.set(o.value.meta.key,e.current.length-1))}return e.current=[...e.current],u},[]),h=y(async()=>{const c=await p(!1);return A(),c},[p]);T(()=>{const c=d.subscribe(async a=>{const{mutations:u,removedAll:i}=a;if(i&&m(),!u)return;const o=e.current?.length??0;let D=o,S=!1;const b=new Set;for(const s of u){const{key:n,op:x,document:l}=s;switch(x){case"insert":{D+=1;break}case"delete":{if(e.current&&e.current.length>0&&t.current.has(n)){const r=t.current.get(n);if(r===void 0)break;b.add(r),S=!0}break}case"update":{if(t.current.has(n)){const r=t.current.get(n);if(r!==void 0&&e.current){const P=f?f(l):l,_=e.current[r];K(_,P)||(e.current[r]=P,e.current=[...e.current],S=!0)}}else{const r=await d.get(n,f);r&&(e.current=[...e.current??[],r],t.current.set(n,e.current.length-1),S=!0)}break}}}if(b.size>0&&e.current&&e.current.length>0){const s=new Map;e.current=e.current?.filter((x,l)=>!b.has(l));let n=0;for(const[x,l]of t.current)b.has(l)||(s.set(x,n),n++);t.current=s}const v=o!==D;if(v||S){if(v){await p(!0);let s=0;for(;(e.current?.length??0)<D&&s<q;)await p(!1),s++;s===q&&console.warn("Reached maximum iterations in fillNextPage loop. Possible duplicate or data issue.")}A()}});return()=>{c()}},[d]),T(()=>{m(),h()},I);const O=y(async()=>{m(),await h()},[h,m]);return[e.current,{nextPage:h,reset:O,keysIndex:t.current}]}export{F as useSqliteValue};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "muya",
-  "version": "2.4.94",
+  "version": "2.4.96",
   "author": "samuel.gjabel@gmail.com",
   "repository": "https://github.com/samuelgjabel/muya",
   "main": "cjs/index.js",

package/src/sqlite/__tests__/use-sqlite.test.tsx

@@ -489,4 +489,35 @@ describe('use-sqlite-state', () => {
       expect(result.current[0]?.length).toBe(ITEMS_COUNT)
     })
   })
+  it("should test batch delete and its impact on the hook's results", async () => {
+    const sql = createSqliteState<Person>({ backend, tableName: 'BatchDeleteState', key: 'id' })
+    const people: Person[] = []
+    for (let index = 1; index <= 20; index++) {
+      people.push({ id: index.toString(), name: `Person${index}`, age: 20 + (index % 50) })
+    }
+    await sql.batchSet(people)
+
+    let reRenders = 0
+    const { result } = renderHook(() => {
+      reRenders++
+      return useSqliteValue(sql, {}, [])
+    })
+
+    await waitFor(() => {
+      expect(result.current[0]?.length).toBe(20)
+      expect(reRenders).toBe(2)
+    })
+
+    act(() => {
+      sql.batchDelete(['5', '10', '15'])
+    })
+
+    await waitFor(() => {
+      expect(result.current[0]?.length).toBe(17)
+      expect(result.current[0]?.find((p) => p.id === '5')).toBeUndefined()
+      expect(result.current[0]?.find((p) => p.id === '10')).toBeUndefined()
+      expect(result.current[0]?.find((p) => p.id === '15')).toBeUndefined()
+      expect(reRenders).toBe(3)
+    })
+  })
 })

package/src/sqlite/create-sqlite.ts

@@ -9,21 +9,22 @@ export interface CreateSqliteOptions<Document extends DocType> extends Omit<DbOp
   readonly backend: Backend | Promise<Backend>
 }
 
-export interface MutationItems {
-  mutations?: MutationResult[]
+export interface MutationItems<Doc> {
+  mutations?: MutationResult<Doc>[]
   removedAll?: boolean
 }
 
 export interface SyncTable<Document extends DocType> {
-  readonly subscribe: (listener: (mutation: MutationItems) => void) => () => void
-  readonly set: (document: Document) => Promise<MutationResult>
-  readonly batchSet: (documents: Document[]) => Promise<MutationResult[]>
+  readonly subscribe: (listener: (mutation: MutationItems<Document>) => void) => () => void
+  readonly set: (document: Document) => Promise<MutationResult<Document>>
+  readonly batchSet: (documents: Document[]) => Promise<MutationResult<Document>[]>
+  readonly batchDelete: (keys: Key[]) => Promise<MutationResult<Document>[]>
   readonly get: <Selected = Document>(key: Key, selector?: (document: Document) => Selected) => Promise<Selected | undefined>
 
-  readonly delete: (key: Key) => Promise<MutationResult | undefined>
+  readonly delete: (key: Key) => Promise<MutationResult<Document> | undefined>
   readonly search: <Selected = Document>(options?: SearchOptions<Document, Selected>) => AsyncIterableIterator<Selected>
   readonly count: (options?: { where?: Where<Document> }) => Promise<number>
-  readonly deleteBy: (where: Where<Document>) => Promise<MutationResult[]>
+  readonly deleteBy: (where: Where<Document>) => Promise<MutationResult<Document>[]>
   readonly clear: () => Promise<void>
 }
 
@@ -53,8 +54,8 @@ export function createSqliteState<Document extends DocType>(options: CreateSqlit
       if (!unknownItems) {
         return
       }
-      const items = unknownItems as MutationItems[]
-      const merged: MutationItems = {}
+      const items = unknownItems as MutationItems<Document>[]
+      const merged: MutationItems<Document> = {}
       for (const item of items) {
         if (item.removedAll) {
           merged.removedAll = true
@@ -76,11 +77,11 @@ export function createSqliteState<Document extends DocType>(options: CreateSqlit
    * Notify all subscribers of changes
    * @param item The mutation items to notify subscribers about
    */
-  function handleChanges(item: MutationItems) {
+  function handleChanges(item: MutationItems<Document>) {
     STATE_SCHEDULER.schedule(id, item)
   }
 
-  const listeners = new Set<(mutation: MutationItems) => void>()
+  const listeners = new Set<(mutation: MutationItems<Document>) => void>()
 
   const state: SyncTable<Document> = {
     subscribe(listener) {
@@ -104,6 +105,12 @@ export function createSqliteState<Document extends DocType>(options: CreateSqlit
       handleChanges({ mutations: changes })
       return changes
     },
+    async batchDelete(keys) {
+      const table = await getTable()
+      const changes = await table.batchDelete(keys)
+      handleChanges({ mutations: changes })
+      return changes
+    },
     async delete(key) {
       const table = await getTable()
       const changes = await table.delete(key)

package/src/sqlite/table/table.ts

@@ -3,6 +3,7 @@
 /* eslint-disable sonarjs/cognitive-complexity */
 /* eslint-disable @typescript-eslint/no-shadow */
 /* eslint-disable no-shadow */
+import type { Backend } from './backend'
 import type { Table, DbOptions, DocType, Key, SearchOptions, MutationResult } from './table.types'
 import { unicodeTokenizer, type FtsTokenizerOptions } from './tokenizer'
 import type { Where } from './where'
@@ -181,10 +182,10 @@ export async function createTable<Document extends DocType>(options: DbOptions<D
 
         if (existing.length > 0) {
           await db.execute(`UPDATE ${tableName} SET data = ? WHERE key = ?`, [json, id])
-          return { key: id, op: 'update' }
+          return { key: id, op: 'update', document }
         } else {
           await db.execute(`INSERT INTO ${tableName} (key, data) VALUES (?, ?)`, [id, json])
-          return { key: id, op: 'insert' }
+          return { key: id, op: 'insert', document }
         }
       }
 
@@ -192,7 +193,7 @@ export async function createTable<Document extends DocType>(options: DbOptions<D
       const rows = await db.select<Array<{ id: number }>>(`SELECT last_insert_rowid() AS id`)
       const rowid = rows[0]?.id
       if (typeof rowid !== 'number') throw new Error('Failed to retrieve last_insert_rowid()')
-      return { key: rowid, op: 'insert' }
+      return { key: rowid, op: 'insert', document }
     },
 
     async get<Selected = Document>(
@@ -211,9 +212,10 @@ export async function createTable<Document extends DocType>(options: DbOptions<D
       return selector(document, { rowId: rowid, key: logicalKey }) as Selected
     },
 
-    async delete(keyValue: Key) {
+    async delete(keyValue: Key, backendOverride?: Backend) {
+      const db = backendOverride ?? backend
       const whereKey = hasUserKey ? `key = ?` : `rowid = ?`
-      await backend.execute(`DELETE FROM ${tableName} WHERE ${whereKey}`, [keyValue])
+      await db.execute(`DELETE FROM ${tableName} WHERE ${whereKey}`, [keyValue])
       const changed = await backend.select<Array<{ c: number }>>(`SELECT changes() AS c`)
       if ((changed[0]?.c ?? 0) > 0) return { key: keyValue, op: 'delete' }
       return
@@ -274,7 +276,7 @@ export async function createTable<Document extends DocType>(options: DbOptions<D
     async deleteBy(where: Where<Document>) {
       const whereSql = getWhereQuery<Document>(where, tableName)
       const keyCol = hasUserKey ? 'key' : 'rowid'
-      const results: MutationResult[] = []
+      const results: MutationResult<Document>[] = []
 
       await backend.transaction(async (tx) => {
         const rows = await tx.select<Array<{ k: Key }>>(`SELECT ${keyCol} AS k FROM ${tableName} ${whereSql}`)
@@ -287,7 +289,7 @@ export async function createTable<Document extends DocType>(options: DbOptions<D
           await tx.execute(`DELETE FROM ${tableName} WHERE ${keyCol} IN (${placeholders})`, chunk as unknown[])
         }
 
-        for (const k of allKeys) results.push({ key: k, op: 'delete' })
+        for (const k of allKeys) results.push({ key: k, op: 'delete', document: undefined })
       })
 
       return results
@@ -298,7 +300,7 @@ export async function createTable<Document extends DocType>(options: DbOptions<D
     },
 
     async batchSet(documents: Document[]) {
-      const mutations: MutationResult[] = []
+      const mutations: MutationResult<Document>[] = []
       await backend.transaction(async (tx) => {
         for (const document of documents) {
           const m = await table.set(document, tx)
@@ -307,6 +309,16 @@ export async function createTable<Document extends DocType>(options: DbOptions<D
       })
       return mutations
     },
+    async batchDelete(keys: Key[]) {
+      const mutations: MutationResult<Document>[] = []
+      await backend.transaction(async (tx) => {
+        for (const key of keys) {
+          const m = await table.delete(key, tx)
+          if (m) mutations.push(m)
+        }
+      })
+      return mutations
+    },
   }
 
   return table

package/src/sqlite/table/table.types.ts

@@ -67,20 +67,35 @@ interface DbNotGeneric {
 export type Key = string | number
 
 export type MutationOp = 'insert' | 'update' | 'delete'
-export interface MutationResult {
+
+interface MutationResultBase<T> {
   key: Key
   op: MutationOp
+  document?: T
+}
+interface MutationResultDelete<T> extends MutationResultBase<T> {
+  key: Key
+  op: 'delete'
 }
 
+interface MutationResultUpdateInsert<T> extends MutationResultBase<T> {
+  key: Key
+  op: 'update' | 'insert'
+  document: T
+}
+
+export type MutationResult<T> = MutationResultDelete<T> | MutationResultUpdateInsert<T>
+
 export interface Table<Document extends DocType> extends DbNotGeneric {
-  readonly set: (document: Document, backendOverride?: Backend) => Promise<MutationResult>
-  readonly batchSet: (documents: Document[]) => Promise<MutationResult[]>
+  readonly set: (document: Document, backendOverride?: Backend) => Promise<MutationResult<Document>>
+  readonly batchSet: (documents: Document[]) => Promise<MutationResult<Document>[]>
+  readonly batchDelete: (keys: Key[]) => Promise<MutationResult<Document>[]>
   readonly get: <Selected = Document>(key: Key, selector?: (document: Document) => Selected) => Promise<Selected | undefined>
 
-  readonly delete: (key: Key) => Promise<MutationResult | undefined>
+  readonly delete: (key: Key, backendOverride?: Backend) => Promise<MutationResult<Document> | undefined>
   readonly search: <Selected = Document>(options?: SearchOptions<Document, Selected>) => AsyncIterableIterator<Selected>
   readonly count: (options?: { where?: Where<Document> }) => Promise<number>
-  readonly deleteBy: (where: Where<Document>) => Promise<MutationResult[]>
+  readonly deleteBy: (where: Where<Document>) => Promise<MutationResult<Document>[]>
   readonly clear: () => Promise<void>
 }
 

package/src/sqlite/use-sqlite.ts

@@ -114,7 +114,7 @@ export function useSqliteValue<Document extends DocType, Selected = Document>(
       let hasUpdate = false
       const removeIndexes = new Set<number>()
       for (const mutation of mutations) {
-        const { key, op } = mutation
+        const { key, op, document } = mutation
         switch (op) {
           case 'insert': {
             newLength += 1
@@ -133,7 +133,7 @@ export function useSqliteValue<Document extends DocType, Selected = Document>(
             if (keysIndex.current.has(key)) {
               const index = keysIndex.current.get(key)
               if (index !== undefined && itemsRef.current) {
-                const newItem = (await state.get(key, select)) as Selected
+                const newItem = select ? select(document as Document) : (document as unknown as Selected)
                 const previousItem = itemsRef.current[index]
 
                 // 🆕 Only update & rerender if shallow comparison fails

package/types/sqlite/create-sqlite.d.ts

@@ -4,21 +4,22 @@ import type { Where } from './table/where';
 export interface CreateSqliteOptions<Document extends DocType> extends Omit<DbOptions<Document>, 'backend'> {
     readonly backend: Backend | Promise<Backend>;
 }
-export interface MutationItems {
-    mutations?: MutationResult[];
+export interface MutationItems<Doc> {
+    mutations?: MutationResult<Doc>[];
     removedAll?: boolean;
 }
 export interface SyncTable<Document extends DocType> {
-    readonly subscribe: (listener: (mutation: MutationItems) => void) => () => void;
-    readonly set: (document: Document) => Promise<MutationResult>;
-    readonly batchSet: (documents: Document[]) => Promise<MutationResult[]>;
+    readonly subscribe: (listener: (mutation: MutationItems<Document>) => void) => () => void;
+    readonly set: (document: Document) => Promise<MutationResult<Document>>;
+    readonly batchSet: (documents: Document[]) => Promise<MutationResult<Document>[]>;
+    readonly batchDelete: (keys: Key[]) => Promise<MutationResult<Document>[]>;
     readonly get: <Selected = Document>(key: Key, selector?: (document: Document) => Selected) => Promise<Selected | undefined>;
-    readonly delete: (key: Key) => Promise<MutationResult | undefined>;
+    readonly delete: (key: Key) => Promise<MutationResult<Document> | undefined>;
     readonly search: <Selected = Document>(options?: SearchOptions<Document, Selected>) => AsyncIterableIterator<Selected>;
     readonly count: (options?: {
         where?: Where<Document>;
     }) => Promise<number>;
-    readonly deleteBy: (where: Where<Document>) => Promise<MutationResult[]>;
+    readonly deleteBy: (where: Where<Document>) => Promise<MutationResult<Document>[]>;
     readonly clear: () => Promise<void>;
 }
 /**

package/types/sqlite/table/table.types.d.ts

@@ -44,20 +44,32 @@ interface DbNotGeneric {
 }
 export type Key = string | number;
 export type MutationOp = 'insert' | 'update' | 'delete';
-export interface MutationResult {
+interface MutationResultBase<T> {
     key: Key;
     op: MutationOp;
+    document?: T;
 }
+interface MutationResultDelete<T> extends MutationResultBase<T> {
+    key: Key;
+    op: 'delete';
+}
+interface MutationResultUpdateInsert<T> extends MutationResultBase<T> {
+    key: Key;
+    op: 'update' | 'insert';
+    document: T;
+}
+export type MutationResult<T> = MutationResultDelete<T> | MutationResultUpdateInsert<T>;
 export interface Table<Document extends DocType> extends DbNotGeneric {
-    readonly set: (document: Document, backendOverride?: Backend) => Promise<MutationResult>;
-    readonly batchSet: (documents: Document[]) => Promise<MutationResult[]>;
+    readonly set: (document: Document, backendOverride?: Backend) => Promise<MutationResult<Document>>;
+    readonly batchSet: (documents: Document[]) => Promise<MutationResult<Document>[]>;
+    readonly batchDelete: (keys: Key[]) => Promise<MutationResult<Document>[]>;
     readonly get: <Selected = Document>(key: Key, selector?: (document: Document) => Selected) => Promise<Selected | undefined>;
-    readonly delete: (key: Key) => Promise<MutationResult | undefined>;
+    readonly delete: (key: Key, backendOverride?: Backend) => Promise<MutationResult<Document> | undefined>;
     readonly search: <Selected = Document>(options?: SearchOptions<Document, Selected>) => AsyncIterableIterator<Selected>;
     readonly count: (options?: {
         where?: Where<Document>;
     }) => Promise<number>;
-    readonly deleteBy: (where: Where<Document>) => Promise<MutationResult[]>;
+    readonly deleteBy: (where: Where<Document>) => Promise<MutationResult<Document>[]>;
     readonly clear: () => Promise<void>;
 }
 export type MakeAllFieldAsRequired<T> = {