duckdb 0.6.2-dev670.0 → 0.6.2-dev679.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/duckdb.d.ts CHANGED
@@ -15,12 +15,14 @@ export type RowData = {
15
15
  };
16
16
 
17
17
  export type TableData = RowData[];
18
+ export type ArrowIterable = Iterable<Uint8Array> | AsyncIterable<Uint8Array>;
19
+ export type ArrowArray = Uint8Array[];
18
20
 
19
21
  export class Connection {
20
22
  constructor(db: Database, callback?: Callback<any>);
21
23
 
22
24
  all(sql: string, ...args: [...any, Callback<TableData>] | []): void;
23
- arrowIPCAll(sql: string, ...args: [...any, Callback<TableData>] | []): void;
25
+ arrowIPCAll(sql: string, ...args: [...any, Callback<ArrowArray>] | []): void;
24
26
  each(sql: string, ...args: [...any, Callback<RowData>] | []): void;
25
27
  exec(sql: string, ...args: [...any, Callback<void>] | []): void;
26
28
 
@@ -41,13 +43,24 @@ export class Connection {
41
43
  unregister_udf(name: string, callback: Callback<any>): void;
42
44
 
43
45
  stream(sql: any, ...args: any[]): QueryResult;
44
- arrowIPCStream(sql: any, ...args: any[]): QueryResult;
46
+ arrowIPCStream(sql: any, ...args: any[]): IpcResultStreamIterator;
47
+
48
+ register_buffer(name: string, array: ArrowIterable, force: boolean, callback?: Callback<void>): void;
49
+ unregister_buffer(name: string, callback?: Callback<void>): void;
45
50
  }
46
51
 
47
- export class QueryResult {
52
+ export class QueryResult implements AsyncIterable<RowData> {
48
53
  [Symbol.asyncIterator](): AsyncIterator<RowData>;
49
54
  }
50
55
 
56
+ export class IpcResultStreamIterator implements AsyncIterator<Uint8Array>, AsyncIterable<Uint8Array> {
57
+ [Symbol.asyncIterator](): this;
58
+
59
+ next(...args: [] | [undefined]): Promise<IteratorResult<Uint8Array, any>>;
60
+
61
+ toArray(): Promise<ArrowArray>;
62
+ }
63
+
51
64
  export class Database {
52
65
  constructor(path: string, accessMode?: number | Record<string,string>, callback?: Callback<any>);
53
66
  constructor(path: string, callback?: Callback<any>);
@@ -57,7 +70,7 @@ export class Database {
57
70
  connect(): Connection;
58
71
 
59
72
  all(sql: string, ...args: [...any, Callback<TableData>] | []): this;
60
- arrowIPCAll(sql: string, ...args: [...any, Callback<QueryResult>] | []): void;
73
+ arrowIPCAll(sql: string, ...args: [...any, Callback<ArrowArray>] | []): void;
61
74
  each(sql: string, ...args: [...any, Callback<RowData>] | []): this;
62
75
  exec(sql: string, ...args: [...any, Callback<void>] | []): void;
63
76
 
@@ -72,7 +85,7 @@ export class Database {
72
85
  unregister_udf(name: string, callback: Callback<any>): void;
73
86
 
74
87
  stream(sql: any, ...args: any[]): QueryResult;
75
- arrowIPCStream(sql: any, ...args: any[]): Promise<QueryResult>;
88
+ arrowIPCStream(sql: any, ...args: any[]): Promise<IpcResultStreamIterator>;
76
89
 
77
90
  serialize(done?: Callback<void>): void;
78
91
  parallelize(done?: Callback<void>): void;
@@ -83,7 +96,7 @@ export class Database {
83
96
 
84
97
  interrupt(): void;
85
98
 
86
- register_buffer(name: string, array: ArrayLike<any>, force: boolean, callback?: Callback<void>): void;
99
+ register_buffer(name: string, array: ArrowIterable, force: boolean, callback?: Callback<void>): void;
87
100
 
88
101
  unregister_buffer(name: string, callback?: Callback<void>): void;
89
102
  }
@@ -95,7 +108,7 @@ export class Statement {
95
108
 
96
109
  all(...args: [...any, Callback<TableData>] | any[]): this;
97
110
 
98
- arrowIPCAll(...args: [...any, Callback<TableData>] | any[]): void;
111
+ arrowIPCAll(...args: [...any, Callback<ArrowArray>] | any[]): void;
99
112
 
100
113
  each(...args: [...any, Callback<RowData>] | any[]): this;
101
114
 
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "duckdb",
3
3
  "main": "./lib/duckdb.js",
4
4
  "types": "./lib/duckdb.d.ts",
5
- "version": "0.6.2-dev670.0",
5
+ "version": "0.6.2-dev679.0",
6
6
  "description": "DuckDB node.js API",
7
7
  "gypfile": true,
8
8
  "dependencies": {
@@ -1,7 +1,6 @@
1
1
  import * as duckdb from '..';
2
2
  import * as assert from 'assert';
3
- import * as fs from 'fs';
4
- import {QueryResult} from "..";
3
+ import {ArrowArray} from "..";
5
4
 
6
5
  describe('arrow IPC API fails neatly when extension not loaded', function() {
7
6
  // Note: arrow IPC api requires the arrow extension to be loaded. The tests for this functionality reside in:
@@ -25,7 +24,7 @@ describe('arrow IPC API fails neatly when extension not loaded', function() {
25
24
  }
26
25
  );
27
26
 
28
- db.arrowIPCAll(`SELECT * FROM ipc_table`, function (err: null | Error, result: QueryResult) {
27
+ db.arrowIPCAll(`SELECT * FROM ipc_table`, function (err: null | Error, result: ArrowArray) {
29
28
  if (err) {
30
29
  assert.ok(err.message.includes("Catalog Error: Function with name to_arrow_ipc is not on the catalog, but it exists in the arrow extension. To Install and Load the extension, run: INSTALL arrow; LOAD arrow;"))
31
30
  } else {
@@ -33,6 +32,7 @@ describe('arrow IPC API fails neatly when extension not loaded', function() {
33
32
  }
34
33
  });
35
34
 
35
+ // @ts-expect-error
36
36
  assert.throws(() => db.register_buffer("ipc_table", [1,'a',1], true), TypeError, "Incorrect parameters");
37
37
  });
38
38