schema-idb 0.0.2 → 0.0.3

package/dist/createSchemaDB.d.ts

@@ -31,7 +31,7 @@ export type SchemaDatabase<TStores extends readonly AnySchemaStore[]> = {
     readonly ready: boolean;
     waitForReady(): Promise<void>;
     close(): void;
-    startTransaction<TNames extends StoreNames<TStores>>(storeNames: TNames[], options?: TransactionOptions): Transaction<TStores, TNames>;
+    startTransaction<TNames extends StoreNames<TStores>>(storeNames: TNames | TNames[], options?: TransactionOptions): Transaction<TStores, TNames>;
 } & {
     [K in TStores[number]['name']]: SchemaStoreAccessor<Extract<TStores[number], {
         name: K;

package/dist/createSchemaDB.js

@@ -1 +1 @@
-"use strict";var P=Object.defineProperty;var s=(e,r)=>P(e,"name",{value:r,configurable:!0});import{openDatabase as D}from"./utils.js";import{createStoreAccessor as h}from"./storeAccessor.js";import{createStartTransaction as T}from"./transaction.js";import{determineAutoVersion as v,applySafeChanges as E,openDatabaseForSchemaRead as b}from"./schemaDetection.js";import{ensureSchemaHistoryStore as x,getAppliedMigrations as p,recordMigrationApplied as z,initializeSchemaHistory as M}from"./migrationHistory.js";function H(e){return e}s(H,"getKeyPathString");function R(e,r,a){const n=s(async()=>{if(await e.readyPromise,!e.idb)throw new Error("Database initialization failed");return h(e.idb,r,a)},"getAccessor");return new Proxy({},{get(t,l){return l==="query"?u=>u?n().then(i=>i.query(u)):A(e,r,a):async(...u)=>(await n())[l](...u)}})}s(R,"createLazyStoreAccessor");function A(e,r,a){const n=s(async()=>{if(await e.readyPromise,!e.idb)throw new Error("Database initialization failed");return h(e.idb,r,a).query()},"getQueryBuilder"),t=s(l=>new Proxy({},{get(u,i){return i==="findAll"||i==="find"||i==="count"?()=>l().then(o=>o[i]()):(...o)=>t(s(()=>l().then(c=>c[i](...o)),"newGetBuilder"))}}),"createBuilderProxy");return t(n)}s(A,"createLazyQueryBuilder");function k(e,r){const a={get name(){return e.idb?.name??r},get version(){return e.idb?.version??0},get raw(){if(!e.idb)throw new Error("Database not ready. Call waitForReady() first or check ready property.");return e.idb},get ready(){return e.ready},waitForReady(){return e.readyPromise},close(){e.idb?.close()},startTransaction(...n){if(!e.startTransaction){const[t,l]=n;return j(e,t,l)}return e.startTransaction(...n)}};for(const n of e.stores)Object.defineProperty(a,n.name,{get(){return R(e,n.name,n.defaults)},enumerable:!0});return a}s(k,"buildSchemaDatabase");function j(e,r,a){const n={async commit(){if(await e.readyPromise,!e.startTransaction)throw new Error("Database initialization failed");return e.startTransaction(r,a).commit()},abort(){}};for(const t of r)e.stores.find(u=>u.name===t)&&Object.defineProperty(n,t,{get(){throw new Error("Transaction operations before ready state are not yet supported. Use await db.waitForReady() before starting transactions.")},enumerable:!0});return n}s(j,"createLazyTransaction");function q(e){const r=[],a=new Set;for(const n of e)for(const t of n.migrations){if(a.has(t.name))throw new Error(`Duplicate migration name "${t.name}" found across stores`);a.add(t.name),r.push(t)}return r.sort((n,t)=>n.name.localeCompare(t.name))}s(q,"collectMigrations");function S(e,r){const a=new Set(r);return e.filter(n=>!a.has(n.name)).sort((n,t)=>n.name.localeCompare(t.name))}s(S,"filterPendingMigrations");function B(e,r,a,n,t,l,u){if(x(e),a===0){for(const o of n){const f=e.createObjectStore(o.name,{keyPath:o.keyPath});for(const c of o.indexes)f.createIndex(c.name,c.keyPath,{unique:c.unique??!1,multiEntry:c.multiEntry??!1})}M(r)}else u&&u.safe.length>0&&E(e,r,u.safe,n);let i=[...l];for(const o of t)try{const f=o.up(e,r);f instanceof Promise&&f.catch(c=>{console.error(`Migration "${o.name}" failed:`,c),r.abort()}),z(r,o.name,i),i=[...i,o.name].sort()}catch(f){throw console.error(`Migration "${o.name}" failed:`,f),r.abort(),f}}s(B,"handleUpgrade");export function openDB(e){const{name:r,version:a,versionStrategy:n="explicit",stores:t,onBlocked:l,onVersionChange:u}=e,i=new Set;for(const m of t){if(i.has(m.name))throw new Error(`Duplicate store name: "${m.name}"`);i.add(m.name)}const o=q(t);let f=s(()=>{},"readyResolve"),c=s(()=>{},"readyReject");const g={idb:null,ready:!1,error:null,readyPromise:new Promise((m,y)=>{f=m,c=y}),readyResolve:f,readyReject:c,stores:t,startTransaction:null},d=k(g,r);return C(g,r,a,n,t,o,l,u),d}s(openDB,"openDB");async function C(e,r,a,n,t,l,u,i){try{let o=[],f=null,c;if(n==="auto"){const d=await v(r,t);if(c=d.version,f=d.changes,d.version>1){const y=await b(r);y&&(o=await p(y),y.close())}S(l,o).length>0&&!d.needsUpgrade&&(c=d.version+1)}else{if(a===void 0)throw new Error('Version is required when versionStrategy is "explicit"');c=a;const d=await b(r);d&&(o=await p(d),d.close())}const w=S(l,o),g=await D(r,c,(d,m,y)=>{B(d,m,y,t,w,o,f)},u);i&&(g.onversionchange=i),e.idb=g,e.startTransaction=T(g,t),e.ready=!0,e.readyResolve()}catch(o){e.error=o instanceof Error?o:new Error(String(o)),e.readyReject(e.error)}}s(C,"initializeDatabase");
+"use strict";var P=Object.defineProperty;var c=(e,r)=>P(e,"name",{value:r,configurable:!0});import{openDatabase as T}from"./utils.js";import{createStoreAccessor as b}from"./storeAccessor.js";import{createStartTransaction as v}from"./transaction.js";import{determineAutoVersion as D,applySafeChanges as E,openDatabaseForSchemaRead as h}from"./schemaDetection.js";import{ensureSchemaHistoryStore as A,getAppliedMigrations as p,recordMigrationApplied as R,initializeSchemaHistory as x}from"./migrationHistory.js";function G(e){return e}c(G,"getKeyPathString");function z(e,r,o){const t=c(async()=>{if(await e.readyPromise,!e.idb)throw new Error("Database initialization failed");return b(e.idb,r,o)},"getAccessor");return new Proxy({},{get(n,d){return d==="query"?s=>s?t().then(i=>i.query(s)):M(e,r,o):async(...s)=>(await t())[d](...s)}})}c(z,"createLazyStoreAccessor");function M(e,r,o){const t=c(async()=>{if(await e.readyPromise,!e.idb)throw new Error("Database initialization failed");return b(e.idb,r,o).query()},"getQueryBuilder"),n=c(d=>new Proxy({},{get(s,i){return i==="findAll"||i==="find"||i==="count"?()=>d().then(a=>a[i]()):(...a)=>n(c(()=>d().then(l=>l[i](...a)),"newGetBuilder"))}}),"createBuilderProxy");return n(t)}c(M,"createLazyQueryBuilder");function k(e,r){const o={get name(){return e.idb?.name??r},get version(){return e.idb?.version??0},get raw(){if(!e.idb)throw new Error("Database not ready. Call waitForReady() first or check ready property.");return e.idb},get ready(){return e.ready},waitForReady(){return e.readyPromise},close(){e.idb?.close()},startTransaction(...t){if(!e.startTransaction){const[n,d]=t,s=Array.isArray(n)?n:[n];return j(e,s,d)}return e.startTransaction(...t)}};for(const t of e.stores)Object.defineProperty(o,t.name,{get(){return z(e,t.name,t.defaults)},enumerable:!0});return o}c(k,"buildSchemaDatabase");function j(e,r,o){const t={get raw(){throw new Error("Transaction raw is not available before ready state. Use await db.waitForReady() before starting transactions.")},async commit(){if(await e.readyPromise,!e.startTransaction)throw new Error("Database initialization failed");return e.startTransaction(r,o).commit()},abort(){}};for(const n of r)e.stores.find(s=>s.name===n)&&Object.defineProperty(t,n,{get(){throw new Error("Transaction operations before ready state are not yet supported. Use await db.waitForReady() before starting transactions.")},enumerable:!0});return t}c(j,"createLazyTransaction");function q(e){const r=[],o=new Set;for(const t of e)for(const n of t.migrations){if(o.has(n.name))throw new Error(`Duplicate migration name "${n.name}" found across stores`);o.add(n.name),r.push(n)}return r.sort((t,n)=>t.name.localeCompare(n.name))}c(q,"collectMigrations");function S(e,r){const o=new Set(r);return e.filter(t=>!o.has(t.name)).sort((t,n)=>t.name.localeCompare(n.name))}c(S,"filterPendingMigrations");function B(e,r,o,t,n,d,s){if(A(e),o===0){for(const a of t){const f=e.createObjectStore(a.name,{keyPath:a.keyPath});for(const l of a.indexes)f.createIndex(l.name,l.keyPath,{unique:l.unique??!1,multiEntry:l.multiEntry??!1})}x(r)}else s&&s.safe.length>0&&E(e,r,s.safe,t);let i=[...d];for(const a of n)try{const f=a.up(e,r);f instanceof Promise&&f.catch(l=>{console.error(`Migration "${a.name}" failed:`,l),r.abort()}),R(r,a.name,i),i=[...i,a.name].sort()}catch(f){throw console.error(`Migration "${a.name}" failed:`,f),r.abort(),f}}c(B,"handleUpgrade");export function openDB(e){const{name:r,version:o,versionStrategy:t="explicit",stores:n,onBlocked:d,onVersionChange:s}=e,i=new Set;for(const m of n){if(i.has(m.name))throw new Error(`Duplicate store name: "${m.name}"`);i.add(m.name)}const a=q(n);let f=c(()=>{},"readyResolve"),l=c(()=>{},"readyReject");const w={idb:null,ready:!1,error:null,readyPromise:new Promise((m,y)=>{f=m,l=y}),readyResolve:f,readyReject:l,stores:n,startTransaction:null},u=k(w,r);return C(w,r,o,t,n,a,d,s),u}c(openDB,"openDB");async function C(e,r,o,t,n,d,s,i){try{let a=[],f=null,l;if(t==="auto"){const u=await D(r,n);if(l=u.version,f=u.changes,u.version>1){const y=await h(r);y&&(a=await p(y),y.close())}S(d,a).length>0&&!u.needsUpgrade&&(l=u.version+1)}else{if(o===void 0)throw new Error('Version is required when versionStrategy is "explicit"');l=o;const u=await h(r);u&&(a=await p(u),u.close())}const g=S(d,a),w=await T(r,l,(u,m,y)=>{B(u,m,y,n,g,a,f)},s);i&&(w.onversionchange=i),e.idb=w,e.startTransaction=v(w,n),e.ready=!0,e.readyResolve()}catch(a){e.error=a instanceof Error?a:new Error(String(a)),e.readyReject(e.error)}}c(C,"initializeDatabase");

package/dist/transaction.d.ts

@@ -3,7 +3,7 @@ import type { SchemaStoreDefinition } from './schema.js';
 type IDBCompatibleKey = IDBValidKey;
 type ConstrainedKey<S extends StoreSchema> = PrimaryKeyType<S> & IDBCompatibleKey;
 export interface TransactionOptions {
-    mode?: 'readonly' | 'readwrite';
+    mode?: 'write';
     durability?: 'default' | 'strict' | 'relaxed';
 }
 export interface TransactionStoreAccessor<S extends StoreSchema> {
@@ -23,8 +23,9 @@ type GetStoreSchema<TStores extends readonly AnySchemaStore[], TName extends str
 export type Transaction<TStores extends readonly AnySchemaStore[], TNames extends StoreNames<TStores>> = {
     [K in TNames]: TransactionStoreAccessor<GetStoreSchema<TStores, K>>;
 } & {
+    readonly raw: IDBTransaction;
     commit(): Promise<void>;
     abort(): void;
 };
-export declare function createStartTransaction<TStores extends readonly AnySchemaStore[]>(db: IDBDatabase, _storeDefinitions: TStores): <TNames extends StoreNames<TStores>>(storeNames: TNames[], options?: TransactionOptions) => Transaction<TStores, TNames>;
+export declare function createStartTransaction<TStores extends readonly AnySchemaStore[]>(db: IDBDatabase, _storeDefinitions: TStores): <TNames extends StoreNames<TStores>>(storeNamesInput: TNames | TNames[], options?: TransactionOptions) => Transaction<TStores, TNames>;
 export {};

package/dist/transaction.js

@@ -1 +1 @@
-"use strict";var b=Object.defineProperty;var e=(o,c)=>b(o,"name",{value:c,configurable:!0});function f(o,c){const n=o.objectStore(c);return{get(t){n.get(t)},getAll(){n.getAll()},getAllByIndex(t,r){n.index(t).getAll(r)},put(t,r){n.put(t,r)},add(t,r){n.add(t,r)},delete(t){n.delete(t)},clear(){n.clear()}}}e(f,"createTransactionStoreAccessor");function m(o,c,n){return{...o,commit:c,abort:n}}e(m,"buildTransaction");export function createStartTransaction(o,c){return e(function(t,r={}){const{mode:i="readonly",durability:u="default"}=r,a=o.transaction(t,i,{durability:u}),l={};for(const s of t)l[s]=f(a,s);return m(l,e(()=>new Promise((s,d)=>{a.oncomplete=()=>s(),a.onerror=()=>d(a.error),a.onabort=()=>d(new Error("Transaction aborted"))}),"commit"),e(()=>{a.abort()},"abort"))},"startTransaction")}e(createStartTransaction,"createStartTransaction");
+"use strict";var f=Object.defineProperty;var a=(e,c)=>f(e,"name",{value:c,configurable:!0});function A(e,c){const r=e.objectStore(c);return{get(t){r.get(t)},getAll(){r.getAll()},getAllByIndex(t,o){r.index(t).getAll(o)},put(t,o){r.put(t,o)},add(t,o){r.add(t,o)},delete(t){r.delete(t)},clear(){r.clear()}}}a(A,"createTransactionStoreAccessor");function m(e,c,r,t){return{...e,raw:c,commit:r,abort:t}}a(m,"buildTransaction");export function createStartTransaction(e,c){return a(function(t,o={}){const s=Array.isArray(t)?t:[t],{mode:u,durability:b="default"}=o,n=e.transaction(s,"readwrite",{durability:b}),d={};for(const i of s)d[i]=A(n,i);return m(d,n,a(()=>new Promise((i,l)=>{n.oncomplete=()=>i(),n.onerror=()=>l(n.error),n.onabort=()=>l(new Error("Transaction aborted"))}),"commit"),a(()=>{n.abort()},"abort"))},"startTransaction")}a(createStartTransaction,"createStartTransaction");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schema-idb",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Type-safe IndexedDB wrapper with chainable transactions",
   "main": "./dist/index.js",
   "module": "./dist/index.js",