node-firebird-driver 2.3.0 → 3.0.0

package/dist/lib/impl/statement.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractStatement = void 0;
 /** AbstractStatement implementation. */
@@ -16,67 +7,66 @@ class AbstractStatement {
         this.attachment = attachment;
     }
     /** Disposes this statement's resources. */
-    dispose() {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            if (this.resultSet)
-                yield this.resultSet.close();
-            yield this.internalDispose();
-            this.attachment.statements.delete(this);
-            this.attachment = undefined;
-        });
+    async dispose() {
+        this.check();
+        if (this.resultSet)
+            await this.resultSet.close();
+        await this.internalDispose();
+        this.attachment.statements.delete(this);
+        this.attachment = undefined;
     }
     /** Executes a prepared statement that uses the SET TRANSACTION command. Returns the new transaction. */
-    executeTransaction(transaction) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            //// TODO: check opened resultSet.
-            return yield this.internalExecuteTransaction(transaction);
-        });
+    async executeTransaction(transaction) {
+        this.check();
+        //// TODO: check opened resultSet.
+        return await this.internalExecuteTransaction(transaction);
     }
     /** Executes a prepared statement that has no result set. */
-    execute(transaction, parameters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            //// TODO: check opened resultSet.
-            yield this.internalExecute(transaction, parameters, options || this.attachment.defaultExecuteOptions || this.attachment.client.defaultExecuteOptions);
-        });
+    async execute(transaction, parameters, options) {
+        this.check();
+        //// TODO: check opened resultSet.
+        await this.internalExecute(transaction, parameters, options || this.attachment.defaultExecuteOptions || this.attachment.client.defaultExecuteOptions);
     }
     /** Executes a statement that returns a single record as [col1, col2, ..., colN]. */
-    executeReturning(transaction, parameters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            //// TODO: check opened resultSet.
-            return yield this.internalExecute(transaction, parameters, options || this.attachment.defaultExecuteOptions || this.attachment.client.defaultExecuteOptions);
-        });
+    async executeSingleton(transaction, parameters, options) {
+        this.check();
+        //// TODO: check opened resultSet.
+        return await this.internalExecute(transaction, parameters, options || this.attachment.defaultExecuteOptions || this.attachment.client.defaultExecuteOptions);
     }
     /** Executes a statement that returns a single record as an object. */
-    executeReturningAsObject(transaction, parameters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            const row = yield this.executeReturning(transaction, parameters, options);
-            const cols = (yield (this === null || this === void 0 ? void 0 : this.columnLabels)) || [];
-            const obj = {};
-            // Loop on row column value.
-            row.forEach((v, idx) => {
-                const col = cols[idx];
-                obj[col] = v;
-            });
-            return obj;
+    async executeSingletonAsObject(transaction, parameters, options) {
+        this.check();
+        const row = await this.executeSingleton(transaction, parameters, options);
+        const cols = (await this?.columnLabels) || [];
+        const obj = {};
+        // Loop on row column value.
+        row.forEach((v, idx) => {
+            const col = cols[idx];
+            obj[col] = v;
         });
+        return obj;
+    }
+    /** Executes a statement that returns a single record as [col1, col2, ..., colN]. */
+    async executeReturning(transaction, parameters, options) {
+        return await this.executeSingleton(transaction, parameters, options);
+    }
+    /** Executes a statement that returns a single record as an object. */
+    async executeReturningAsObject(transaction, parameters, options) {
+        return await this.executeSingletonAsObject(transaction, parameters, options);
     }
     /** Executes a prepared statement that has result set. */
-    executeQuery(transaction, parameters, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            //// TODO: check opened resultSet.
-            const resultSet = yield this.internalExecuteQuery(transaction, parameters, options || this.attachment.defaultExecuteQueryOptions || this.attachment.client.defaultExecuteQueryOptions);
-            this.resultSet = resultSet;
-            return resultSet;
-        });
+    async executeQuery(transaction, parameters, options) {
+        this.check();
+        //// TODO: check opened resultSet.
+        const resultSet = await this.internalExecuteQuery(transaction, parameters, options || this.attachment.defaultExecuteQueryOptions || this.attachment.client.defaultExecuteQueryOptions);
+        this.resultSet = resultSet;
+        return resultSet;
+    }
+    get isValid() {
+        return !!this.attachment;
     }
     check() {
-        if (!this.attachment)
+        if (!this.isValid)
             throw new Error('Statement is already disposed.');
     }
 }

package/dist/lib/impl/statement.js.map

@@ -1 +1 @@
-{"version":3,"file":"statement.js","sourceRoot":"","sources":["../../../src/lib/impl/statement.ts"],"names":[],"mappings":";;;;;;;;;;;;AAYA,wCAAwC;AACxC,MAAsB,iBAAiB;IAkBtC,YAA6B,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAC5D,CAAC;IAED,2CAA2C;IACrC,OAAO;;YACZ,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,IAAI,IAAI,CAAC,SAAS;gBACjB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAE9B,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAE7B,IAAI,CAAC,UAAW,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC7B,CAAC;KAAA;IAED,wGAAwG;IAClG,kBAAkB,CAAC,WAAgC;;YACxD,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,kCAAkC;YAClC,OAAO,MAAM,IAAI,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC;QAC3D,CAAC;KAAA;IAED,4DAA4D;IACtD,OAAO,CAAC,WAAgC,EAAE,UAAkB,EAAE,OAAwB;;YAC3F,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,kCAAkC;YAClC,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,UAAU,EACjD,OAAO,IAAI,IAAI,CAAC,UAAW,CAAC,qBAAqB,IAAI,IAAI,CAAC,UAAW,CAAC,MAAO,CAAC,qBAAqB,CAAC,CAAC;QACvG,CAAC;KAAA;IAED,oFAAoF;IAC9E,gBAAgB,CAAC,WAAgC,EAAE,UAAkB,EAAE,OAAwB;;YACpG,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,kCAAkC;YAClC,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,UAAU,EACxD,OAAO,IAAI,IAAI,CAAC,UAAW,CAAC,qBAAqB,IAAI,IAAI,CAAC,UAAW,CAAC,MAAO,CAAC,qBAAqB,CAAC,CAAC;QACvG,CAAC;KAAA;IAED,sEAAsE;IAChE,wBAAwB,CAAmB,WAAgC,EAAE,UAAkB,EACnG,OAAwB;;YACzB,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,IAAI,GAAG,CAAC,MAAM,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,YAAY,CAAA,CAAC,IAAI,EAAE,CAAC;YAE9C,MAAM,GAAG,GAAG,EAAO,CAAC;YAEpB,4BAA4B;YAC5B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,GAAW,EAAE,EAAE;gBACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,GAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO,GAAG,CAAC;QACZ,CAAC;KAAA;IAED,yDAAyD;IACnD,YAAY,CAAC,WAAgC,EAAE,UAAkB,EAAE,OAA6B;;YAErG,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,kCAAkC;YAClC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,EAAE,UAAU,EACxE,OAAO,IAAI,IAAI,CAAC,UAAW,CAAC,0BAA0B,IAAI,IAAI,CAAC,UAAW,CAAC,MAAO,CAAC,0BAA0B,CAAC,CAAC;YAChH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,OAAO,SAAS,CAAC;QAClB,CAAC;KAAA;IAEO,KAAK;QACZ,IAAI,CAAC,IAAI,CAAC,UAAU;YACnB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;CAUD;AAxGD,8CAwGC"}
+{"version":3,"file":"statement.js","sourceRoot":"","sources":["../../../src/lib/impl/statement.ts"],"names":[],"mappings":"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"}

package/dist/lib/impl/transaction.d.ts

@@ -12,6 +12,7 @@ export declare abstract class AbstractTransaction implements Transaction {
     rollback(): Promise<void>;
     /** Rollbacks and maintains this transaction object for subsequent work. */
     rollbackRetaining(): Promise<void>;
+    get isValid(): boolean;
     private check;
     protected abstract internalCommit(): Promise<void>;
     protected abstract internalCommitRetaining(): Promise<void>;

package/dist/lib/impl/transaction.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractTransaction = void 0;
 /** AbstractTransaction implementation. */
@@ -16,39 +7,34 @@ class AbstractTransaction {
         this.attachment = attachment;
     }
     /** Commits and release this transaction object. */
-    commit() {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            yield this.internalCommit();
-            this.attachment.transactions.delete(this);
-            this.attachment = undefined;
-        });
+    async commit() {
+        this.check();
+        await this.internalCommit();
+        this.attachment.transactions.delete(this);
+        this.attachment = undefined;
     }
     /** Commits and maintains this transaction object for subsequent work. */
-    commitRetaining() {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            return yield this.internalCommitRetaining();
-        });
+    async commitRetaining() {
+        this.check();
+        return await this.internalCommitRetaining();
     }
     /** Rollbacks and release this transaction object. */
-    rollback() {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            yield this.internalRollback();
-            this.attachment.transactions.delete(this);
-            this.attachment = undefined;
-        });
+    async rollback() {
+        this.check();
+        await this.internalRollback();
+        this.attachment.transactions.delete(this);
+        this.attachment = undefined;
     }
     /** Rollbacks and maintains this transaction object for subsequent work. */
-    rollbackRetaining() {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.check();
-            return yield this.internalRollbackRetaining();
-        });
+    async rollbackRetaining() {
+        this.check();
+        return await this.internalRollbackRetaining();
+    }
+    get isValid() {
+        return !!this.attachment;
     }
     check() {
-        if (!this.attachment)
+        if (!this.isValid)
             throw new Error('Transaction is already committed or rolled back.');
     }
 }

package/dist/lib/impl/transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../src/lib/impl/transaction.ts"],"names":[],"mappings":";;;;;;;;;;;;AAKA,0CAA0C;AAC1C,MAAsB,mBAAmB;IACxC,YAA6B,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAC5D,CAAC;IAED,mDAAmD;IAC7C,MAAM;;YACX,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAE5B,IAAI,CAAC,UAAW,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC7B,CAAC;KAAA;IAED,yEAAyE;IACnE,eAAe;;YACpB,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,OAAO,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC7C,CAAC;KAAA;IAED,qDAAqD;IAC/C,QAAQ;;YACb,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE9B,IAAI,CAAC,UAAW,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC7B,CAAC;KAAA;IAED,2EAA2E;IACrE,iBAAiB;;YACtB,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,OAAO,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/C,CAAC;KAAA;IAEO,KAAK;QACZ,IAAI,CAAC,IAAI,CAAC,UAAU;YACnB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;CAMD;AA/CD,kDA+CC"}
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../src/lib/impl/transaction.ts"],"names":[],"mappings":";;;AAKA,0CAA0C;AAC1C,MAAsB,mBAAmB;IACxC,YAA6B,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAC5D,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,MAAM;QACX,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE5B,IAAI,CAAC,UAAW,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,eAAe;QACpB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,OAAO,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;IAC7C,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,QAAQ;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE9B,IAAI,CAAC,UAAW,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,iBAAiB;QACtB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,OAAO,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO;QACV,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IAC1B,CAAC;IAEO,KAAK;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO;YAChB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;CAMD;AAnDD,kDAmDC"}

package/dist/lib/index.d.ts

@@ -7,6 +7,8 @@ export interface Client {
     connect(uri: string, options?: ConnectOptions): Promise<Attachment>;
     /** Creates a database. */
     createDatabase(uri: string, options?: CreateDatabaseOptions): Promise<Attachment>;
+    /** True if the client has not been disposed. */
+    readonly isValid: boolean;
     /** Default connect options. */
     defaultConnectOptions?: ConnectOptions;
     /** Default create database options. */
@@ -67,6 +69,10 @@ export interface FetchOptions {
     /** Number of rows to fetch. */
     fetchSize?: number;
 }
+/** CreateBlobOptions interface. */
+export interface CreateBlobOptions {
+    type?: 'SEGMENTED' | 'STREAM';
+}
 /** Attachment interface. */
 export interface Attachment {
     /** Disconnects this attachment. */
@@ -74,7 +80,7 @@ export interface Attachment {
     /** Drops the database and release this attachment. */
     dropDatabase(): Promise<void>;
     /** Creates a blob and return its stream. */
-    createBlob(transaction: Transaction): Promise<BlobStream>;
+    createBlob(transaction: Transaction, options?: CreateBlobOptions): Promise<BlobStream>;
     /** Opens a blob's stream. */
     openBlob(transaction: Transaction, blob: Blob): Promise<BlobStream>;
     /** Starts a new transaction. */
@@ -91,11 +97,27 @@ export interface Attachment {
         executeOptions?: ExecuteOptions;
     }): Promise<void>;
     /** Executes a statement that returns a single record as [col1, col2, ..., colN]. */
-    executeReturning(transaction: Transaction, sqlStmt: string, parameters?: any[], options?: {
+    executeSingleton(transaction: Transaction, sqlStmt: string, parameters?: any[], options?: {
         prepareOptions?: PrepareOptions;
         executeOptions?: ExecuteOptions;
     }): Promise<any[]>;
     /** Executes a statement that returns a single record as an object. */
+    executeSingletonAsObject<T extends object>(transaction: Transaction, sqlStmt: string, parameters?: any[], options?: {
+        prepareOptions?: PrepareOptions;
+        executeOptions?: ExecuteOptions;
+    }): Promise<T>;
+    /**
+     * Executes a statement that returns a single record as [col1, col2, ..., colN].
+     * @deprecated since version 2.4.0 and will be removed in next major version. Replaced by executeSingleton.
+     */
+    executeReturning(transaction: Transaction, sqlStmt: string, parameters?: any[], options?: {
+        prepareOptions?: PrepareOptions;
+        executeOptions?: ExecuteOptions;
+    }): Promise<any[]>;
+    /**
+     * Executes a statement that returns a single record as an object.
+     * @deprecated since version 2.4.0 and will be removed in next major version. Replaced by executeSingletonAsObject.
+     */
     executeReturningAsObject<T extends object>(transaction: Transaction, sqlStmt: string, parameters?: any[], options?: {
         prepareOptions?: PrepareOptions;
         executeOptions?: ExecuteOptions;
@@ -106,6 +128,8 @@ export interface Attachment {
         executeOptions?: ExecuteQueryOptions;
     }): Promise<ResultSet>;
     queueEvents(names: string[], callBack: (counters: [string, number][]) => Promise<void>): Promise<Events>;
+    /** True if the attachment is connected. */
+    readonly isValid: boolean;
     /** Default transaction options. */
     defaultTransactionOptions?: TransactionOptions;
     /** Default query's prepare options. */
@@ -127,6 +151,8 @@ export interface Transaction {
     rollback(): Promise<void>;
     /** Rollbacks and maintains this transaction object for subsequent work. */
     rollbackRetaining(): Promise<void>;
+    /** True if the transaction is active. */
+    readonly isValid: boolean;
 }
 /** Statement interface. */
 export interface Statement {
@@ -137,8 +163,18 @@ export interface Statement {
     /** Executes a prepared statement that has no result set. */
     execute(transaction: Transaction, parameters?: any[], options?: ExecuteOptions): Promise<void>;
     /** Executes a statement that returns a single record as [col1, col2, ..., colN]. */
-    executeReturning(transaction: Transaction, parameters?: any[], executeOptions?: ExecuteOptions): Promise<any[]>;
+    executeSingleton(transaction: Transaction, parameters?: any[], executeOptions?: ExecuteOptions): Promise<any[]>;
     /** Executes a statement that returns a single record as an object. */
+    executeSingletonAsObject<T extends object>(transaction: Transaction, parameters?: any[], executeOptions?: ExecuteOptions): Promise<T>;
+    /**
+     * Executes a statement that returns a single record as [col1, col2, ..., colN].
+     * @deprecated since version 2.4.0 and will be removed in next major version. Replaced by executeSingleton.
+     */
+    executeReturning(transaction: Transaction, parameters?: any[], executeOptions?: ExecuteOptions): Promise<any[]>;
+    /**
+     * Executes a statement that returns a single record as an object.
+     * @deprecated since version 2.4.0 and will be removed in next major version. Replaced by executeSingletonAsObject.
+     */
     executeReturningAsObject<T extends object>(transaction: Transaction, parameters?: any[], options?: ExecuteOptions): Promise<T>;
     /** Executes a prepared statement that has result set. */
     executeQuery(transaction: Transaction, parameters?: any[], options?: ExecuteQueryOptions): Promise<ResultSet>;
@@ -148,6 +184,9 @@ export interface Statement {
      * Use with ResultSet.fetch({ fetchSize: 1 }) and other statement with WHERE CURRENT OF <cursorName>.
      */
     setCursorName(cursorName: string): Promise<void>;
+    getExecPathText(): Promise<string | undefined>;
+    /** True if the statement has not been disposed. */
+    readonly isValid: boolean;
     /** Gets the query's result columns labels. Returns empty array for queries without result. */
     readonly columnLabels: Promise<string[]>;
     /** When true, query result must be obtained with method executeQuery. */
@@ -180,11 +219,15 @@ export interface ResultSet {
      * If result set has no more rows, returns an empty array.
      */
     fetchAsObject<T extends object>(options?: FetchOptions): Promise<T[]>;
+    /** True if the ResultSet is open. */
+    readonly isValid: boolean;
     /** Default result set's fetch options. */
     defaultFetchOptions?: FetchOptions;
 }
 export interface Events {
     cancel(): Promise<void>;
+    /** True if the events' attachment is valid. */
+    readonly isValid: boolean;
 }
 /** Blob class. */
 export declare class Blob {
@@ -193,6 +236,13 @@ export declare class Blob {
     /** Gets the blob's id. */
     readonly id: Uint8Array;
     constructor(attachment: Attachment, id: Uint8Array);
+    /** True if the blob's attachment is valid. */
+    get isValid(): boolean;
+}
+export declare const enum BlobSeekWhence {
+    START = 0,
+    CURRENT = 1,
+    END = 2
 }
 /** BlobStream class. */
 export declare abstract class BlobStream {
@@ -205,6 +255,8 @@ export declare abstract class BlobStream {
     abstract close(): Promise<void>;
     /** Cancels the blob's creation. */
     abstract cancel(): Promise<void>;
+    /** Seeks into the blob stream and return the new position. */
+    abstract seek(offset: number, whence?: BlobSeekWhence): Promise<number>;
     /**
      * Reads data from the blob and return the number of bytes read or -1 for end-of-stream.
      * The number of bytes read may be less than the buffer' size while more data to be read exists.
@@ -212,6 +264,8 @@ export declare abstract class BlobStream {
     abstract read(buffer: Buffer): Promise<number>;
     /** Writes data to the blob. */
     abstract write(buffer: Buffer): Promise<void>;
+    /** True if the blob stream is open. */
+    abstract get isValid(): boolean;
 }
 /** TIME WITH TIME ZONE and TIMESTAMP WITH TIME ZONE to be sent as parameter */
 export interface ZonedDate {

package/dist/lib/index.js

@@ -16,6 +16,10 @@ class Blob {
         this.attachment = attachment;
         this.id.set(id);
     }
+    /** True if the blob's attachment is valid. */
+    get isValid() {
+        return this.attachment.isValid;
+    }
 }
 exports.Blob = Blob;
 /** BlobStream class. */

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":";;;AAmDA,gCAAgC;AAChC,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC/B,mDAA2B,CAAA;IAC3B,yDAAiC,CAAA;IACjC,6CAAqB,CAAA;AACtB,CAAC,EAJW,oBAAoB,GAApB,4BAAoB,KAApB,4BAAoB,QAI/B;AAoMD,kBAAkB;AAClB,MAAa,IAAI;IAOhB,YAAY,UAAsB,EAAE,EAAc;QAHlD,0BAA0B;QACjB,OAAE,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAG/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;CACD;AAXD,oBAWC;AAED,wBAAwB;AACxB,MAAsB,UAAU;IAO/B,YAAsB,IAAU;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CAgBD;AAzBD,gCAyBC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":";;;AAsDA,gCAAgC;AAChC,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC/B,mDAA2B,CAAA;IAC3B,yDAAiC,CAAA;IACjC,6CAAqB,CAAA;AACtB,CAAC,EAJW,oBAAoB,GAApB,4BAAoB,KAApB,4BAAoB,QAI/B;AA0PD,kBAAkB;AAClB,MAAa,IAAI;IAOhB,YAAY,UAAsB,EAAE,EAAc;QAHlD,0BAA0B;QACjB,OAAE,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAG/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,8CAA8C;IAC9C,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IAChC,CAAC;CACD;AAhBD,oBAgBC;AAQD,wBAAwB;AACxB,MAAsB,UAAU;IAO/B,YAAsB,IAAU;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CAsBD;AA/BD,gCA+BC"}