@petradb/engine 1.1.1 → 1.2.1

package/README.md

@@ -24,6 +24,18 @@ const [{ rows }] = await db.execute('SELECT * FROM users');
 console.log(rows); // [{ id: 1, name: 'Alice', email: 'alice@example.com' }]
 ```
 
+### Persistent Storage
+
+Data survives restarts with crash-safe durable storage in a single file:
+
+```javascript
+const db = new Session({ storage: 'persistent', path: './mydb' });
+// ... use the database ...
+db.close();
+```
+
+Also available: `{ storage: 'text', path: './data.ptxt' }` for human-readable text files.
+
 ## Documentation
 
 Full documentation, SQL reference, and API details are available at **[petradb.dev](https://petradb.dev)**.

package/index.d.ts

@@ -1,5 +1,8 @@
 export interface SessionOptions {
     rowMode?: 'object' | 'array';
+    storage?: 'memory' | 'persistent' | 'text';
+    path?: string;
+    pageSize?: number;
 }
 
 export interface ExecuteOptions {
@@ -50,6 +53,16 @@ export interface AlterTableResult {
     command: 'alter table';
 }
 
+export interface CreateViewResult {
+    command: 'create view';
+    view: string;
+}
+
+export interface DropViewResult {
+    command: 'drop view';
+    view: string;
+}
+
 export interface PrepareResult {
     command: 'prepare';
     name: string;
@@ -104,6 +117,8 @@ export type ExecuteResult =
     | DropIndexResult
     | TruncateTableResult
     | AlterTableResult
+    | CreateViewResult
+    | DropViewResult
     | InsertResult
     | SelectResult
     | UpdateResult
@@ -122,4 +137,5 @@ export class Session {
     constructor(options?: SessionOptions);
     execute(sql: string, options?: ExecuteOptions): Promise<ExecuteResult[]>;
     prepare(sql: string): PreparedStatement;
+    close(): void;
 }