koffi 2.16.1 → 3.0.0-alpha.2

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.
Files changed (84) hide show
  1. package/CHANGELOG.md +2 -2
  2. package/README.md +8 -8
  3. package/build/koffi/darwin_arm64/koffi.node +0 -0
  4. package/build/koffi/darwin_x64/koffi.node +0 -0
  5. package/build/koffi/freebsd_arm64/koffi.node +0 -0
  6. package/build/koffi/freebsd_ia32/koffi.node +0 -0
  7. package/build/koffi/freebsd_x64/koffi.node +0 -0
  8. package/build/koffi/linux_arm64/koffi.node +0 -0
  9. package/build/koffi/linux_ia32/koffi.node +0 -0
  10. package/build/koffi/linux_x64/koffi.node +0 -0
  11. package/build/koffi/musl_arm64/koffi.node +0 -0
  12. package/build/koffi/musl_x64/koffi.node +0 -0
  13. package/build/koffi/openbsd_ia32/koffi.node +0 -0
  14. package/build/koffi/openbsd_x64/koffi.node +0 -0
  15. package/build/koffi/win32_ia32/koffi.node +0 -0
  16. package/build/koffi/win32_x64/koffi.node +0 -0
  17. package/doc/benchmarks.md +33 -33
  18. package/doc/benchmarks.xlsx +0 -0
  19. package/doc/contribute.md +37 -25
  20. package/doc/index.md +8 -8
  21. package/doc/variables.md +1 -1
  22. package/index.d.ts +11 -9
  23. package/index.js +1 -634
  24. package/indirect.js +1 -533
  25. package/lib/native/base/base.cc +63 -85
  26. package/lib/native/base/base.hh +178 -151
  27. package/package.json +3 -4
  28. package/src/build.js +1178 -0
  29. package/src/koffi/CMakeLists.txt +97 -34
  30. package/src/koffi/index.js +359 -0
  31. package/src/koffi/indirect.js +216 -0
  32. package/src/koffi/src/{abi_arm32.cc → abi/arm32.cc} +279 -275
  33. package/src/koffi/src/{abi_arm32_asm.S → abi/arm32_asm.S} +2 -5
  34. package/src/koffi/src/abi/arm64.cc +1511 -0
  35. package/src/koffi/src/{abi_arm64_asm.S → abi/arm64_asm.S} +44 -23
  36. package/src/koffi/src/{abi_arm64_asm.asm → abi/arm64_asm.asm} +32 -25
  37. package/src/koffi/src/{abi_loong64_asm.S → abi/loong64_asm.S} +1 -5
  38. package/src/koffi/src/{abi_riscv64.cc → abi/riscv64.cc} +279 -273
  39. package/src/koffi/src/{abi_riscv64_asm.S → abi/riscv64_asm.S} +1 -4
  40. package/src/koffi/src/abi/x64sysv.cc +1456 -0
  41. package/src/koffi/src/{abi_x64_sysv_asm.S → abi/x64sysv_asm.S} +30 -33
  42. package/src/koffi/src/abi/x64win.cc +1121 -0
  43. package/src/koffi/src/{abi_x64_win_asm.S → abi/x64win_asm.S} +8 -12
  44. package/src/koffi/src/{abi_x64_win_asm.asm → abi/x64win_asm.asm} +11 -14
  45. package/src/koffi/src/abi/x86.cc +1233 -0
  46. package/src/koffi/src/{abi_x86_asm.S → abi/x86_asm.S} +49 -25
  47. package/src/koffi/src/{abi_x86_asm.asm → abi/x86_asm.asm} +11 -14
  48. package/src/koffi/src/call.cc +458 -598
  49. package/src/koffi/src/call.hh +61 -82
  50. package/src/koffi/src/ffi.cc +595 -309
  51. package/src/koffi/src/ffi.hh +103 -89
  52. package/src/koffi/src/parser.cc +0 -4
  53. package/src/koffi/src/primitives.inc +39 -0
  54. package/src/koffi/{tools/write_trampolines.js → src/trampolines.js} +1 -1
  55. package/src/koffi/src/util.cc +503 -446
  56. package/src/koffi/src/util.hh +269 -57
  57. package/src/koffi/src/uv.cc +2 -2
  58. package/src/koffi/src/uv.def +3 -0
  59. package/src/koffi/src/win32.hh +30 -1
  60. package/vendor/node-addon-api/napi-inl.h +4 -0
  61. package/vendor/node-addon-api/napi.h +1 -0
  62. package/build/koffi/linux_armhf/koffi.node +0 -0
  63. package/build/koffi/linux_loong64/koffi.node +0 -0
  64. package/build/koffi/linux_riscv64d/koffi.node +0 -0
  65. package/build/koffi/win32_arm64/koffi.exp +0 -0
  66. package/build/koffi/win32_arm64/koffi.lib +0 -0
  67. package/build/koffi/win32_arm64/koffi.node +0 -0
  68. package/doc/platforms.md +0 -36
  69. package/src/cnoke/LICENSE.txt +0 -22
  70. package/src/cnoke/README.md +0 -99
  71. package/src/cnoke/assets/FindCNoke.cmake +0 -127
  72. package/src/cnoke/assets/toolchains.json +0 -126
  73. package/src/cnoke/assets/win_delay_hook.c +0 -36
  74. package/src/cnoke/cnoke.js +0 -170
  75. package/src/cnoke/package.json +0 -24
  76. package/src/cnoke/src/builder.js +0 -511
  77. package/src/cnoke/src/index.js +0 -10
  78. package/src/cnoke/src/tools.js +0 -407
  79. package/src/koffi/src/abi_arm64.cc +0 -1295
  80. package/src/koffi/src/abi_x64_sysv.cc +0 -939
  81. package/src/koffi/src/abi_x64_win.cc +0 -715
  82. package/src/koffi/src/abi_x86.cc +0 -860
  83. package/src/koffi/src/init.js +0 -105
  84. /package/src/koffi/src/{abi_loong64.cc → abi/loong64.cc} +0 -0
@@ -1,407 +0,0 @@
1
- // SPDX-License-Identifier: MIT
2
- // SPDX-FileCopyrightText: 2025 Niels Martignène <niels.martignene@protonmail.com>
3
-
4
- 'use strict';
5
-
6
- const crypto = require('crypto');
7
- const fs = require('fs');
8
- const http = require('https');
9
- const path = require('path');
10
- const zlib = require('zlib');
11
-
12
- async function download_http(url, dest) {
13
- console.log('>> Downloading ' + url);
14
-
15
- let [tmp_name, file] = open_temporary_stream(dest);
16
-
17
- try {
18
- await new Promise((resolve, reject) => {
19
- let request = http.get(url, response => {
20
- if (response.statusCode != 200) {
21
- let err = new Error(`Download failed: ${response.statusMessage} [${response.statusCode}]`);
22
- err.code = response.statusCode;
23
-
24
- reject(err);
25
-
26
- return;
27
- }
28
-
29
- response.pipe(file);
30
-
31
- file.on('finish', () => file.close(() => {
32
- try {
33
- fs.renameSync(file.path, dest);
34
- } catch (err) {
35
- if (!fs.existsSync(dest))
36
- reject(err);
37
- }
38
-
39
- resolve();
40
- }));
41
- });
42
-
43
- request.on('error', reject);
44
- file.on('error', reject);
45
- });
46
- } catch (err) {
47
- file.close();
48
-
49
- try {
50
- fs.unlinkSync(tmp_name);
51
- } catch (err) {
52
- if (err.code != 'ENOENT')
53
- throw err;
54
- }
55
-
56
- throw err;
57
- }
58
- }
59
-
60
- function open_temporary_stream(prefix) {
61
- let buf = Buffer.allocUnsafe(4);
62
-
63
- for (;;) {
64
- try {
65
- crypto.randomFillSync(buf);
66
-
67
- let suffix = buf.toString('hex').padStart(8, '0');
68
- let filename = `${prefix}.${suffix}`;
69
-
70
- let file = fs.createWriteStream(filename, { flags: 'wx', mode: 0o644 });
71
- return [filename, file];
72
- } catch (err) {
73
- if (err.code != 'EEXIST')
74
- throw err;
75
- }
76
- }
77
- }
78
-
79
- function extract_targz(filename, dest_dir, strip = 0) {
80
- let reader = fs.createReadStream(filename).pipe(zlib.createGunzip());
81
-
82
- return new Promise((resolve, reject) => {
83
- let header = null;
84
- let extended = {};
85
-
86
- reader.on('readable', () => {
87
- try {
88
- for (;;) {
89
- if (header == null) {
90
- let buf = reader.read(512);
91
- if (buf == null)
92
- break;
93
-
94
- // Two zeroed 512-byte blocks end the stream
95
- if (!buf[0])
96
- continue;
97
-
98
- header = {
99
- filename: buf.toString('utf-8', 0, 100).replace(/\0/g, ''),
100
- mode: parseInt(buf.toString('ascii', 100, 109), 8),
101
- size: parseInt(buf.toString('ascii', 124, 137), 8),
102
- type: String.fromCharCode(buf[156])
103
- };
104
-
105
- // UStar filename prefix
106
- /*if (buf.toString('ascii', 257, 263) == 'ustar\0') {
107
- let prefix = buf.toString('utf-8', 345, 500).replace(/\0/g, '');
108
- console.log(prefix);
109
- header.filename = prefix ? (prefix + '/' + header.filename) : header.filename;
110
- }*/
111
-
112
- Object.assign(header, extended);
113
- extended = {};
114
-
115
- // Safety checks
116
- header.filename = header.filename.replace(/\\/g, '/');
117
- if (!header.filename.length)
118
- throw new Error(`Insecure empty filename inside TAR archive`);
119
- if (path_is_absolute(header.filename[0]))
120
- throw new Error(`Insecure filename starting with / inside TAR archive`);
121
- if (path_has_dotdot(header.filename))
122
- throw new Error(`Insecure filename containing '..' inside TAR archive`);
123
-
124
- for (let i = 0; i < strip; i++)
125
- header.filename = header.filename.substr(header.filename.indexOf('/') + 1);
126
- }
127
-
128
- let aligned = Math.floor((header.size + 511) / 512) * 512;
129
- let data = header.size ? reader.read(aligned) : null;
130
- if (data == null) {
131
- if (header.size)
132
- break;
133
- data = Buffer.alloc(0);
134
- }
135
- data = data.subarray(0, header.size);
136
-
137
- if (header.type == '0' || header.type == '7') {
138
- let filename = dest_dir + '/' + header.filename;
139
- let dirname = path.dirname(filename);
140
-
141
- fs.mkdirSync(dirname, { recursive: true, mode: 0o755 });
142
- fs.writeFileSync(filename, data, { mode: header.mode });
143
- } else if (header.type == '5') {
144
- let filename = dest_dir + '/' + header.filename;
145
- fs.mkdirSync(filename, { recursive: true, mode: header.mode });
146
- } else if (header.type == 'L') { // GNU tar
147
- extended.filename = data.toString('utf-8').replace(/\0/g, '');
148
- } else if (header.type == 'x') { // PAX entry
149
- let str = data.toString('utf-8');
150
-
151
- try {
152
- while (str.length) {
153
- let matches = str.match(/^([0-9]+) ([a-zA-Z0-9\._]+)=(.*)\n/);
154
-
155
- let skip = parseInt(matches[1], 10);
156
- let key = matches[2];
157
- let value = matches[3];
158
-
159
- switch (key) {
160
- case 'path': { extended.filename = value; } break;
161
- case 'size': { extended.size = parseInt(value, 10); } break;
162
- }
163
-
164
- str = str.substr(skip).trimStart();
165
- }
166
- } catch (err) {
167
- throw new Error('Malformed PAX entry');
168
- }
169
- }
170
-
171
- header = null;
172
- }
173
- } catch (err) {
174
- reject(err);
175
- }
176
- });
177
-
178
- reader.on('error', reject);
179
- reader.on('end', resolve);
180
- });
181
- }
182
-
183
- function path_is_absolute(path) {
184
- if (process.platform == 'win32' && path.match(/^[a-zA-Z]:/))
185
- path = path.substr(2);
186
- return is_path_separator(path[0]);
187
- }
188
-
189
- function path_has_dotdot(path) {
190
- let start = 0;
191
-
192
- for (;;) {
193
- let offset = path.indexOf('..', start);
194
- if (offset < 0)
195
- break;
196
- start = offset + 2;
197
-
198
- if (offset && !is_path_separator(path[offset - 1]))
199
- continue;
200
- if (offset + 2 < path.length && !is_path_separator(path[offset + 2]))
201
- continue;
202
-
203
- return true;
204
- }
205
-
206
- return false;
207
- }
208
-
209
- function is_path_separator(c) {
210
- if (c == '/')
211
- return true;
212
- if (process.platform == 'win32' && c == '\\')
213
- return true;
214
-
215
- return false;
216
- }
217
-
218
- function sync_files(src_dir, dest_dir) {
219
- let keep = new Set;
220
-
221
- // Copy source files
222
- {
223
- let entries = fs.readdirSync(src_dir, { withFileTypes: true });
224
-
225
- for (let entry of entries) {
226
- if (!entry.isFile())
227
- continue;
228
-
229
- keep.add(entry.name);
230
- fs.copyFileSync(src_dir + `/${entry.name}`, dest_dir + `/${entry.name}`);
231
- }
232
- }
233
-
234
- // Delete old destination files
235
- {
236
- let entries = fs.readdirSync(dest_dir, { withFileTypes: true });
237
-
238
- for (let entry of entries) {
239
- if (!entry.isFile())
240
- continue;
241
- if (keep.has(entry.name))
242
- continue;
243
-
244
- fs.unlinkSync(dest_dir + `/${entry.name}`);
245
- }
246
- }
247
- }
248
-
249
- function determine_arch() {
250
- let arch = process.arch;
251
-
252
- if (arch == 'riscv32' || arch == 'riscv64') {
253
- let buf = read_file_header(process.execPath, 512);
254
- let header = decode_elf_header(buf);
255
- let float_abi = (header.e_flags & 0x6);
256
-
257
- switch (float_abi) {
258
- case 0: {} break;
259
- case 2: { arch += 'f'; } break;
260
- case 4: { arch += 'd'; } break;
261
- case 6: { arch += 'q'; } break;
262
- }
263
- } else if (arch == 'arm') {
264
- let buf = read_file_header(process.execPath, 512);
265
- let header = decode_elf_header(buf);
266
-
267
- if (header.e_flags & 0x400) {
268
- arch += 'hf';
269
- } else if (header.e_flags & 0x200) {
270
- arch += 'sf';
271
- } else {
272
- throw new Error('Unknown ARM floating-point ABI');
273
- }
274
- }
275
-
276
- return arch;
277
- }
278
-
279
- function read_file_header(filename, read) {
280
- let fd = null;
281
-
282
- try {
283
- let fd = fs.openSync(filename);
284
-
285
- let buf = Buffer.allocUnsafe(read);
286
- let len = fs.readSync(fd, buf);
287
-
288
- return buf.subarray(0, len);
289
- } finally {
290
- if (fd != null)
291
- fs.closeSync(fd);
292
- }
293
- }
294
-
295
- function decode_elf_header(buf) {
296
- let header = {};
297
-
298
- if (buf.length < 16)
299
- throw new Error('Truncated header');
300
- if (buf[0] != 0x7F || buf[1] != 69 || buf[2] != 76 || buf[3] != 70)
301
- throw new Error('Invalid magic number');
302
- if (buf[6] != 1)
303
- throw new Error('Invalid ELF version');
304
- if (buf[5] != 1)
305
- throw new Error('Big-endian architectures are not supported');
306
-
307
- let machine = buf.readUInt16LE(18);
308
-
309
- switch (machine) {
310
- case 3: { header.e_machine = 'ia32'; } break;
311
- case 40: { header.e_machine = 'arm'; } break;
312
- case 62: { header.e_machine = 'amd64'; } break;
313
- case 183: { header.e_machine = 'arm64'; } break;
314
- case 243: {
315
- switch (buf[4]) {
316
- case 1: { header.e_machine = 'riscv32'; } break;
317
- case 2: { header.e_machine = 'riscv64'; } break;
318
- }
319
- } break;
320
- case 248: {
321
- switch (buf[4]) {
322
- case 1: { header.e_machine = 'loong32'; } break;
323
- case 2: { header.e_machine = 'loong64'; } break;
324
- }
325
- } break;
326
- default: throw new Error('Unknown ELF machine type');
327
- }
328
-
329
- switch (buf[4]) {
330
- case 1: { // 32 bit
331
- buf = buf.subarray(0, 68);
332
- if (buf.length < 68)
333
- throw new Error('Truncated ELF header');
334
-
335
- header.ei_class = 32;
336
- header.e_flags = buf.readUInt32LE(36);
337
- } break;
338
- case 2: { // 64 bit
339
- buf = buf.subarray(0, 120);
340
- if (buf.length < 120)
341
- throw new Error('Truncated ELF header');
342
-
343
- header.ei_class = 64;
344
- header.e_flags = buf.readUInt32LE(48);
345
- } break;
346
- default: throw new Error('Invalid ELF class');
347
- }
348
-
349
- return header;
350
- }
351
-
352
- function unlink_recursive(path) {
353
- try {
354
- fs.rmSync(path, { recursive: true, maxRetries: process.platform == 'win32' ? 3 : 0 });
355
- } catch (err) {
356
- if (err.code !== 'ENOENT')
357
- throw err;
358
- }
359
- }
360
-
361
- function get_napi_version(napi, major) {
362
- if (napi > 8)
363
- return null;
364
-
365
- // https://nodejs.org/api/n-api.html#node-api-version-matrix
366
- const support = {
367
- 6: ['6.14.2', '6.14.2', '6.14.2'],
368
- 8: ['8.6.0', '8.10.0', '8.11.2'],
369
- 9: ['9.0.0', '9.3.0', '9.11.0'],
370
- 10: ['10.0.0', '10.0.0', '10.0.0', '10.16.0', '10.17.0', '10.20.0', '10.23.0'],
371
- 11: ['11.0.0', '11.0.0', '11.0.0', '11.8.0'],
372
- 12: ['12.0.0', '12.0.0', '12.0.0', '12.0.0', '12.11.0', '12.17.0', '12.19.0', '12.22.0'],
373
- 13: ['13.0.0', '13.0.0', '13.0.0', '13.0.0', '13.0.0'],
374
- 14: ['14.0.0', '14.0.0', '14.0.0', '14.0.0', '14.0.0', '14.0.0', '14.12.0', '14.17.0'],
375
- 15: ['15.0.0', '15.0.0', '15.0.0', '15.0.0', '15.0.0', '15.0.0', '15.0.0', '15.12.0']
376
- };
377
- const max = Math.max(...Object.keys(support).map(k => parseInt(k, 10)));
378
-
379
- if (major > max)
380
- return major + '.0.0';
381
- if (support[major] == null)
382
- return null;
383
-
384
- let required = support[major][napi - 1] || null;
385
- return required;
386
- }
387
-
388
- // Ignores prerelease suffixes
389
- function cmp_version(ver1, ver2) {
390
- ver1 = String(ver1).replace(/-.*$/, '').split('.').reduce((acc, v, idx) => acc + parseInt(v, 10) * Math.pow(10, 2 * (5 - idx)), 0);
391
- ver2 = String(ver2).replace(/-.*$/, '').split('.').reduce((acc, v, idx) => acc + parseInt(v, 10) * Math.pow(10, 2 * (5 - idx)), 0);
392
-
393
- let cmp = Math.min(Math.max(ver1 - ver2, -1), 1);
394
- return cmp;
395
- }
396
-
397
- module.exports = {
398
- download_http,
399
- extract_targz,
400
- path_is_absolute,
401
- path_has_dotdot,
402
- sync_files,
403
- determine_arch,
404
- unlink_recursive,
405
- get_napi_version,
406
- cmp_version
407
- };