@duckdb/node-bindings 1.1.2-alpha.3 → 1.1.3-alpha.10

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2018-2023 Stichting DuckDB Foundation
+Copyright 2018-2025 Stichting DuckDB Foundation
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/README.md

@@ -6,6 +6,8 @@ See [@duckdb/node-api](https://www.npmjs.com/package/@duckdb/node-api) for a hig
 
 ### Supported Platforms
 
+- Linux arm64 (experimental)
 - Linux x64
 - Mac OS X (Darwin) arm64 (Apple Silicon)
+- Mac OS X (Darwin) x64 (Intel)
 - Windows (Win32) x64

package/duckdb.d.ts

@@ -246,7 +246,7 @@ export function interrupt(connection: Connection): void;
 export function query_progress(connection: Connection): QueryProgress;
 
 // DUCKDB_API void duckdb_disconnect(duckdb_connection *connection);
-// not exposed: disconnected in finalizer
+export function disconnect(connection: Connection): void;
 
 // DUCKDB_API const char *duckdb_library_version();
 export function library_version(): string;
@@ -288,7 +288,10 @@ export function column_logical_type(result: Result, column_index: number): Logic
 export function column_count(result: Result): number;
 
 // #ifndef DUCKDB_API_NO_DEPRECATED
+
 // DUCKDB_API idx_t duckdb_row_count(duckdb_result *result);
+export function row_count(result: Result): number;
+
 // #endif
 
 // DUCKDB_API idx_t duckdb_rows_changed(duckdb_result *result);
@@ -306,9 +309,16 @@ export function rows_changed(result: Result): number;
 // not exposed: query, execute_prepared, and execute_pending reject promise with error
 
 // #ifndef DUCKDB_API_NO_DEPRECATED
+
 // DUCKDB_API duckdb_data_chunk duckdb_result_get_chunk(duckdb_result result, idx_t chunk_index);
+export function result_get_chunk(result: Result, chunkIndex: number): DataChunk;
+
 // DUCKDB_API bool duckdb_result_is_streaming(duckdb_result result);
+export function result_is_streaming(result: Result): boolean;
+
 // DUCKDB_API idx_t duckdb_result_chunk_count(duckdb_result result);
+export function result_chunk_count(result: Result): number;
+
 // #endif
 
 // DUCKDB_API duckdb_result_type duckdb_result_return_type(duckdb_result result);
@@ -510,7 +520,10 @@ export function bind_null(prepared_statement: PreparedStatement, index: number):
 export function execute_prepared(prepared_statement: PreparedStatement): Promise<Result>;
 
 // #ifndef DUCKDB_API_NO_DEPRECATED
+
 // DUCKDB_API duckdb_state duckdb_execute_prepared_streaming(duckdb_prepared_statement prepared_statement, duckdb_result *out_result);
+export function execute_prepared_streaming(prepared_statement: PreparedStatement): Promise<Result>;
+
 // #endif
 
 // DUCKDB_API idx_t duckdb_extract_statements(duckdb_connection connection, const char *query, duckdb_extracted_statements *out_extracted_statements);
@@ -529,7 +542,10 @@ export function extract_statements_error(extracted_statements: ExtractedStatemen
 export function pending_prepared(prepared_statement: PreparedStatement): PendingResult;
 
 // #ifndef DUCKDB_API_NO_DEPRECATED
+
 // DUCKDB_API duckdb_state duckdb_pending_prepared_streaming(duckdb_prepared_statement prepared_statement, duckdb_pending_result *out_result);
+export function pending_prepared_streaming(prepared_statement: PreparedStatement): PendingResult;
+
 // #endif
 
 // DUCKDB_API void duckdb_destroy_pending(duckdb_pending_result *pending_result);
@@ -824,7 +840,7 @@ export function vector_ensure_validity_writable(vector: Vector): void;
 export function vector_assign_string_element(vector: Vector, index: number, str: string): void;
 
 // DUCKDB_API void duckdb_vector_assign_string_element_len(duckdb_vector vector, idx_t index, const char *str, idx_t str_len);
-// not exposed: JS string includes length
+export function vector_assign_string_element_len(vector: Vector, index: number, data: Uint8Array): void;
 
 // DUCKDB_API duckdb_vector duckdb_list_vector_get_child(duckdb_vector vector);
 export function list_vector_get_child(vector: Vector): Vector;
@@ -845,7 +861,7 @@ export function struct_vector_get_child(vector: Vector, index: number): Vector;
 export function array_vector_get_child(vector: Vector): Vector;
 
 // DUCKDB_API bool duckdb_validity_row_is_valid(uint64_t *validity, idx_t row);
-export function validity_row_is_valid(validity: Uint8Array, row_index: number): boolean;
+export function validity_row_is_valid(validity: Uint8Array | null, row_index: number): boolean;
 
 // DUCKDB_API void duckdb_validity_set_row_validity(uint64_t *validity, idx_t row, bool valid);
 export function validity_set_row_validity(validity: Uint8Array, row_index: number, valid: boolean): void;
@@ -1072,7 +1088,7 @@ export function append_data_chunk(appender: Appender, chunk: DataChunk): void;
 // #endif
 
 // DUCKDB_API duckdb_data_chunk duckdb_fetch_chunk(duckdb_result result);
-export function fetch_chunk(result: Result): Promise<DataChunk>;
+export function fetch_chunk(result: Result): Promise<DataChunk | null>;
 
 // DUCKDB_API duckdb_cast_function duckdb_create_cast_function();
 // DUCKDB_API void duckdb_cast_function_set_source_type(duckdb_cast_function cast_function, duckdb_logical_type source_type);
@@ -1094,3 +1110,23 @@ export function fetch_chunk(result: Result): Promise<DataChunk>;
  * Used to read from `duckdb_string_t`s with non-inlined data that are embedded in VARCHAR, BLOB, and BIT vectors.
  */
 export function get_data_from_pointer(array_buffer: ArrayBuffer, pointer_offset: number, byte_count: number): Uint8Array;
+
+// ADDED
+/** 
+ * Copy `source_byte_count` bytes from `source_buffer` at `source_byte_offset` into `target_vector` at `target_byte_offset`.
+ * 
+ * Used to write to data chunks.
+ *
+ * Performs an efficient-but-unsafe memory copy. Use with care.
+ */
+export function copy_data_to_vector(target_vector: Vector, target_byte_offset: number, source_buffer: ArrayBuffer, source_byte_offset: number, source_byte_count: number): void;
+
+// ADDED
+/** 
+ * Copy `source_byte_count` bytes from `source_buffer` at `source_byte_offset` into the validity of `target_vector` at `target_byte_offset`.
+ * 
+ * Used to write to data chunks.
+ *
+ * Performs an efficient-but-unsafe memory copy. Use with care.
+ */
+export function copy_data_to_vector_validity(target_vector: Vector, target_byte_offset: number, source_buffer: ArrayBuffer, source_byte_offset: number, source_byte_count: number): void;

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@duckdb/node-bindings",
-  "version": "1.1.2-alpha.3",
+  "version": "1.1.3-alpha.10",
   "main": "./duckdb.js",
   "types": "./duckdb.d.ts",
   "optionalDependencies": {
-    "@duckdb/node-bindings-win32-x64": "1.1.2-alpha.3",
-    "@duckdb/node-bindings-linux-x64": "1.1.2-alpha.3",
-    "@duckdb/node-bindings-darwin-arm64": "1.1.2-alpha.3"
+    "@duckdb/node-bindings-darwin-arm64": "1.1.3-alpha.10",
+    "@duckdb/node-bindings-linux-arm64": "1.1.3-alpha.10",
+    "@duckdb/node-bindings-darwin-x64": "1.1.3-alpha.10",
+    "@duckdb/node-bindings-linux-x64": "1.1.3-alpha.10",
+    "@duckdb/node-bindings-win32-x64": "1.1.3-alpha.10"
   },
   "repository": {
     "type": "git",