@duckdb/node-bindings 1.5.5-r.2 → 1.5.5-r.4

package/duckdb.d.ts

@@ -95,7 +95,6 @@ export enum Type {
   VARIANT = 41,
 }
 
-
 // Types (no explicit destroy)
 
 export interface Date_ {
@@ -183,14 +182,46 @@ export interface TimestampParts {
   time: TimeParts;
 }
 
-export interface BindInfo {
+// The C API reuses one opaque handle type for bind info, init info and function
+// info across function families, but the struct behind each handle differs per
+// family and is reinterpret_cast with no check. Passing one family's handle to
+// another family's accessor corrupts memory rather than failing, so each family
+// gets its own type here, and its own runtime type tag in the bindings.
+//
+// __duckdb_type records the underlying C type; __duckdb_function_kind is what
+// keeps the families from being assignable to one another.
+
+export interface ScalarFunctionBindInfo {
+  __duckdb_type: 'duckdb_bind_info';
+  __duckdb_function_kind: 'scalar_function';
+}
+
+export interface ScalarFunctionInfo {
+  __duckdb_type: 'duckdb_function_info';
+  __duckdb_function_kind: 'scalar_function';
+}
+
+export interface TableFunctionBindInfo {
   __duckdb_type: 'duckdb_bind_info';
+  __duckdb_function_kind: 'table_function';
+}
+
+export interface TableFunctionInitInfo {
+  __duckdb_type: 'duckdb_init_info';
+  __duckdb_function_kind: 'table_function';
 }
 
-export interface FunctionInfo {
+export interface TableFunctionInfo {
   __duckdb_type: 'duckdb_function_info';
+  __duckdb_function_kind: 'table_function';
 }
 
+/** @deprecated Renamed to ScalarFunctionBindInfo. */
+export type BindInfo = ScalarFunctionBindInfo;
+
+/** @deprecated Renamed to ScalarFunctionInfo. */
+export type FunctionInfo = ScalarFunctionInfo;
+
 export interface Vector {
   __duckdb_type: 'duckdb_vector';
 }
@@ -253,6 +284,10 @@ export interface ScalarFunction {
   __duckdb_type: 'duckdb_scalar_function';
 }
 
+export interface TableFunction {
+  __duckdb_type: 'duckdb_table_function';
+}
+
 // export interface SelectionVector {
 //   __duckdb_type: 'duckdb_selection_vector';
 // }
@@ -273,8 +308,12 @@ export interface ExtractedStatementsAndCount {
   statement_count: number;
 }
 
-export type ScalarFunctionBindFunction = (info: BindInfo) => void;
-export type ScalarFunctionMainFunction = (info: FunctionInfo, input: DataChunk, output: Vector) => void;
+export type ScalarFunctionBindFunction = (info: ScalarFunctionBindInfo) => void;
+export type ScalarFunctionMainFunction = (info: ScalarFunctionInfo, input: DataChunk, output: Vector) => void;
+
+export type TableFunctionBindFunction = (info: TableFunctionBindInfo) => void;
+export type TableFunctionInitFunction = (info: TableFunctionInitInfo) => void;
+export type TableFunctionMainFunction = (info: TableFunctionInfo, output: DataChunk) => void;
 
 // Functions
 
@@ -1018,8 +1057,10 @@ export function data_chunk_get_size(chunk: DataChunk): number;
 export function data_chunk_set_size(chunk: DataChunk, size: number): void;
 
 // DUCKDB_C_API duckdb_vector duckdb_create_vector(duckdb_logical_type type, idx_t capacity);
+export function create_vector(logical_type: LogicalType, capacity: number): Vector;
 
 // DUCKDB_C_API void duckdb_destroy_vector(duckdb_vector *vector);
+// not exposed: destroyed in finalizer
 
 // DUCKDB_C_API duckdb_logical_type duckdb_vector_get_column_type(duckdb_vector vector);
 export function vector_get_column_type(vector: Vector): LogicalType;
@@ -1064,6 +1105,7 @@ export function array_vector_get_child(vector: Vector): Vector;
 // DUCKDB_C_API void duckdb_vector_copy_sel(duckdb_vector src, duckdb_vector dst, duckdb_selection_vector sel, idx_t src_count, idx_t src_offset, idx_t dst_offset);
 
 // DUCKDB_C_API void duckdb_vector_reference_value(duckdb_vector vector, duckdb_value value);
+export function vector_reference_value(vector: Vector, value: Value): void;
 
 // DUCKDB_C_API void duckdb_vector_reference_vector(duckdb_vector to_vector, duckdb_vector from_vector);
 
@@ -1110,13 +1152,13 @@ export function scalar_function_set_extra_info(scalar_function: ScalarFunction,
 export function scalar_function_set_bind(scalar_function: ScalarFunction, func: ScalarFunctionBindFunction): void;
 
 // DUCKDB_C_API void duckdb_scalar_function_set_bind_data(duckdb_bind_info info, void *bind_data, duckdb_delete_callback_t destroy);
-export function scalar_function_set_bind_data(info: BindInfo, bind_data: object): void;
+export function scalar_function_set_bind_data(info: ScalarFunctionBindInfo, bind_data: object): void;
 
 // DUCKDB_C_API void duckdb_scalar_function_set_bind_data_copy(duckdb_bind_info info, duckdb_copy_callback_t copy);
 // not exposed: handled by scalar_function_set_bind_data
 
 // DUCKDB_C_API void duckdb_scalar_function_bind_set_error(duckdb_bind_info info, const char *error);
-export function scalar_function_bind_set_error(bind_info: BindInfo, error: string): void;
+export function scalar_function_bind_set_error(bind_info: ScalarFunctionBindInfo, error: string): void;
 
 // DUCKDB_C_API void duckdb_scalar_function_set_function(duckdb_scalar_function scalar_function, duckdb_scalar_function_t function);
 export function scalar_function_set_function(scalar_function: ScalarFunction, func: ScalarFunctionMainFunction): void;
@@ -1125,19 +1167,19 @@ export function scalar_function_set_function(scalar_function: ScalarFunction, fu
 export function register_scalar_function(connection: Connection, scalar_function: ScalarFunction): void;
 
 // DUCKDB_C_API void *duckdb_scalar_function_get_extra_info(duckdb_function_info info);
-export function scalar_function_get_extra_info(function_info: FunctionInfo): object | undefined;
+export function scalar_function_get_extra_info(function_info: ScalarFunctionInfo): object | undefined;
 
 // DUCKDB_C_API void *duckdb_scalar_function_bind_get_extra_info(duckdb_bind_info info);
-export function scalar_function_bind_get_extra_info(bind_info: BindInfo): object | undefined;
+export function scalar_function_bind_get_extra_info(bind_info: ScalarFunctionBindInfo): object | undefined;
 
 // DUCKDB_C_API void *duckdb_scalar_function_get_bind_data(duckdb_function_info info);
-export function scalar_function_get_bind_data(function_info: FunctionInfo): object | undefined;
+export function scalar_function_get_bind_data(function_info: ScalarFunctionInfo): object | undefined;
 
 // DUCKDB_C_API void duckdb_scalar_function_get_client_context(duckdb_bind_info info, duckdb_client_context *out_context);
-export function scalar_function_get_client_context(bind_info: BindInfo): ClientContext;
+export function scalar_function_get_client_context(bind_info: ScalarFunctionBindInfo): ClientContext;
 
 // DUCKDB_C_API void duckdb_scalar_function_set_error(duckdb_function_info info, const char *error);
-export function scalar_function_set_error(function_info: FunctionInfo, error: string): void;
+export function scalar_function_set_error(function_info: ScalarFunctionInfo, error: string): void;
 
 // DUCKDB_C_API duckdb_scalar_function_set duckdb_create_scalar_function_set(const char *name);
 // DUCKDB_C_API void duckdb_destroy_scalar_function_set(duckdb_scalar_function_set *scalar_function_set);
@@ -1178,41 +1220,103 @@ export function scalar_function_set_error(function_info: FunctionInfo, error: st
 // DUCKDB_C_API duckdb_state duckdb_register_aggregate_function_set(duckdb_connection con, duckdb_aggregate_function_set set);
 
 // DUCKDB_C_API duckdb_table_function duckdb_create_table_function();
+export function create_table_function(): TableFunction;
+
 // DUCKDB_C_API void duckdb_destroy_table_function(duckdb_table_function *table_function);
+export function destroy_table_function_sync(table_function: TableFunction): void;
+
 // DUCKDB_C_API void duckdb_table_function_set_name(duckdb_table_function table_function, const char *name);
+export function table_function_set_name(table_function: TableFunction, name: string): void;
+
 // DUCKDB_C_API void duckdb_table_function_add_parameter(duckdb_table_function table_function, duckdb_logical_type type);
+export function table_function_add_parameter(table_function: TableFunction, logical_type: LogicalType): void;
+
 // DUCKDB_C_API void duckdb_table_function_add_named_parameter(duckdb_table_function table_function, const char *name, duckdb_logical_type type);
+export function table_function_add_named_parameter(table_function: TableFunction, name: string, logical_type: LogicalType): void;
+
 // DUCKDB_C_API void duckdb_table_function_set_extra_info(duckdb_table_function table_function, void *extra_info, duckdb_delete_callback_t destroy);
+export function table_function_set_extra_info(table_function: TableFunction, extra_info: object): void;
+
 // DUCKDB_C_API void duckdb_table_function_set_bind(duckdb_table_function table_function, duckdb_table_function_bind_t bind);
+export function table_function_set_bind(table_function: TableFunction, func: TableFunctionBindFunction): void;
+
 // DUCKDB_C_API void duckdb_table_function_set_init(duckdb_table_function table_function, duckdb_table_function_init_t init);
+export function table_function_set_init(table_function: TableFunction, func: TableFunctionInitFunction): void;
+
 // DUCKDB_C_API void duckdb_table_function_set_local_init(duckdb_table_function table_function, duckdb_table_function_init_t init);
+export function table_function_set_local_init(table_function: TableFunction, func: TableFunctionInitFunction): void;
+
 // DUCKDB_C_API void duckdb_table_function_set_function(duckdb_table_function table_function, duckdb_table_function_t function);
+export function table_function_set_function(table_function: TableFunction, func: TableFunctionMainFunction): void;
+
 // DUCKDB_C_API void duckdb_table_function_supports_projection_pushdown(duckdb_table_function table_function, bool pushdown);
+export function table_function_supports_projection_pushdown(table_function: TableFunction, pushdown: boolean): void;
+
 // DUCKDB_C_API duckdb_state duckdb_register_table_function(duckdb_connection con, duckdb_table_function function);
+export function register_table_function(connection: Connection, table_function: TableFunction): void;
 
 // DUCKDB_C_API void *duckdb_bind_get_extra_info(duckdb_bind_info info);
+export function bind_get_extra_info(bind_info: TableFunctionBindInfo): object | undefined;
+
 // DUCKDB_C_API void duckdb_table_function_get_client_context(duckdb_bind_info info, duckdb_client_context *out_context);
+export function table_function_get_client_context(bind_info: TableFunctionBindInfo): ClientContext;
+
 // DUCKDB_C_API void duckdb_bind_add_result_column(duckdb_bind_info info, const char *name, duckdb_logical_type type);
+export function bind_add_result_column(bind_info: TableFunctionBindInfo, name: string, logical_type: LogicalType): void;
+
 // DUCKDB_C_API idx_t duckdb_bind_get_parameter_count(duckdb_bind_info info);
+export function bind_get_parameter_count(bind_info: TableFunctionBindInfo): number;
+
 // DUCKDB_C_API duckdb_value duckdb_bind_get_parameter(duckdb_bind_info info, idx_t index);
+export function bind_get_parameter(bind_info: TableFunctionBindInfo, index: number): Value;
+
 // DUCKDB_C_API duckdb_value duckdb_bind_get_named_parameter(duckdb_bind_info info, const char *name);
+export function bind_get_named_parameter(bind_info: TableFunctionBindInfo, name: string): Value | null;
+
 // DUCKDB_C_API void duckdb_bind_set_bind_data(duckdb_bind_info info, void *bind_data, duckdb_delete_callback_t destroy);
+export function bind_set_bind_data(bind_info: TableFunctionBindInfo, bind_data: object): void;
+
 // DUCKDB_C_API void duckdb_bind_set_cardinality(duckdb_bind_info info, idx_t cardinality, bool is_exact);
+export function bind_set_cardinality(bind_info: TableFunctionBindInfo, cardinality: number, is_exact: boolean): void;
+
 // DUCKDB_C_API void duckdb_bind_set_error(duckdb_bind_info info, const char *error);
+export function bind_set_error(bind_info: TableFunctionBindInfo, error: string): void;
 
 // DUCKDB_C_API void *duckdb_init_get_extra_info(duckdb_init_info info);
+export function init_get_extra_info(init_info: TableFunctionInitInfo): object | undefined;
+
 // DUCKDB_C_API void *duckdb_init_get_bind_data(duckdb_init_info info);
+export function init_get_bind_data(init_info: TableFunctionInitInfo): object | undefined;
+
 // DUCKDB_C_API void duckdb_init_set_init_data(duckdb_init_info info, void *init_data, duckdb_delete_callback_t destroy);
+export function init_set_init_data(init_info: TableFunctionInitInfo, init_data: object): void;
+
 // DUCKDB_C_API idx_t duckdb_init_get_column_count(duckdb_init_info info);
+export function init_get_column_count(init_info: TableFunctionInitInfo): number;
+
 // DUCKDB_C_API idx_t duckdb_init_get_column_index(duckdb_init_info info, idx_t column_index);
+export function init_get_column_index(init_info: TableFunctionInitInfo, column_index: number): number;
+
 // DUCKDB_C_API void duckdb_init_set_max_threads(duckdb_init_info info, idx_t max_threads);
+export function init_set_max_threads(init_info: TableFunctionInitInfo, max_threads: number): void;
+
 // DUCKDB_C_API void duckdb_init_set_error(duckdb_init_info info, const char *error);
+export function init_set_error(init_info: TableFunctionInitInfo, error: string): void;
 
 // DUCKDB_C_API void *duckdb_function_get_extra_info(duckdb_function_info info);
+export function function_get_extra_info(function_info: TableFunctionInfo): object | undefined;
+
 // DUCKDB_C_API void *duckdb_function_get_bind_data(duckdb_function_info info);
+export function function_get_bind_data(function_info: TableFunctionInfo): object | undefined;
+
 // DUCKDB_C_API void *duckdb_function_get_init_data(duckdb_function_info info);
+export function function_get_init_data(function_info: TableFunctionInfo): object | undefined;
+
 // DUCKDB_C_API void *duckdb_function_get_local_init_data(duckdb_function_info info);
+export function function_get_local_init_data(function_info: TableFunctionInfo): object | undefined;
+
 // DUCKDB_C_API void duckdb_function_set_error(duckdb_function_info info, const char *error);
+export function function_set_error(function_info: TableFunctionInfo, error: string): void;
 
 // DUCKDB_C_API void duckdb_add_replacement_scan(duckdb_database db, duckdb_replacement_callback_t replacement, void *extra_data, duckdb_delete_callback_t delete_callback);
 // DUCKDB_C_API void duckdb_replacement_scan_set_function_name(duckdb_replacement_scan_info info, const char *function_name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckdb/node-bindings",
-  "version": "1.5.5-r.2",
+  "version": "1.5.5-r.4",
   "license": "MIT",
   "main": "./duckdb.js",
   "types": "./duckdb.d.ts",
@@ -8,14 +8,14 @@
     "detect-libc": "^2.1.2"
   },
   "optionalDependencies": {
-    "@duckdb/node-bindings-darwin-arm64": "1.5.5-r.2",
-    "@duckdb/node-bindings-darwin-x64": "1.5.5-r.2",
-    "@duckdb/node-bindings-linux-arm64-musl": "1.5.5-r.2",
-    "@duckdb/node-bindings-linux-x64": "1.5.5-r.2",
-    "@duckdb/node-bindings-linux-arm64": "1.5.5-r.2",
-    "@duckdb/node-bindings-linux-x64-musl": "1.5.5-r.2",
-    "@duckdb/node-bindings-win32-arm64": "1.5.5-r.2",
-    "@duckdb/node-bindings-win32-x64": "1.5.5-r.2"
+    "@duckdb/node-bindings-darwin-arm64": "1.5.5-r.4",
+    "@duckdb/node-bindings-linux-arm64": "1.5.5-r.4",
+    "@duckdb/node-bindings-linux-arm64-musl": "1.5.5-r.4",
+    "@duckdb/node-bindings-linux-x64": "1.5.5-r.4",
+    "@duckdb/node-bindings-darwin-x64": "1.5.5-r.4",
+    "@duckdb/node-bindings-linux-x64-musl": "1.5.5-r.4",
+    "@duckdb/node-bindings-win32-arm64": "1.5.5-r.4",
+    "@duckdb/node-bindings-win32-x64": "1.5.5-r.4"
   },
   "repository": {
     "type": "git",