@eagl-finance/celamine-node 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# @eagl/celamine-node
+
+Lightweight WASM-based spreadsheet parser for Node.js, powered by [calamine](https://github.com/tauri-apps/calamine).
+
+Parses **XLS** (binary BIFF), **XLSX**, **XLSB**, and **ODS** files — returns all sheets as `{ name, rows }[]`.
+
+## Install
+
+```bash
+npm install @eagl/celamine-node
+```
+
+## Usage
+
+```typescript
+import { getAllSheets } from "@eagl/celamine-node";
+import { readFileSync } from "fs";
+
+const buffer = readFileSync("spreadsheet.xlsx");
+const sheets = getAllSheets(new Uint8Array(buffer));
+
+for (const sheet of sheets) {
+  console.log(sheet.name, sheet.rows.length, "rows");
+}
+```
+
+## API
+
+### `getAllSheets(data: Uint8Array): SheetData[]`
+
+Returns all sheets from a workbook buffer.
+
+```typescript
+type SheetData = {
+  name: string;
+  rows: (string | null)[][];
+};
+```
+
+## Building from source
+
+Requires [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/) and Rust.
+
+```bash
+npm run build
+```
+
+## Supported formats
+
+| Format | Extension | Magic bytes |
+|--------|-----------|-------------|
+| XLS (BIFF) | .xls | `D0 CF 11 E0` |
+| XLSX | .xlsx | `50 4B 03 04` (ZIP) |
+| XLSB | .xlsb | `50 4B 03 04` (ZIP) |
+| ODS | .ods | `50 4B 03 04` (ZIP) |

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@eagl-finance/celamine-node",
+  "version": "0.1.0",
+  "description": "Lightweight WASM-based spreadsheet parser (XLS, XLSX, ODS) powered by calamine",
+  "main": "pkg/calamine_node.js",
+  "types": "pkg/calamine_node.d.ts",
+  "files": [
+    "pkg/calamine_node.js",
+    "pkg/calamine_node.d.ts",
+    "pkg/calamine_node_bg.wasm",
+    "pkg/calamine_node_bg.wasm.d.ts"
+  ],
+  "scripts": {
+    "build": "wasm-pack build --target nodejs --out-dir pkg",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eagl-ai/celamine-node"
+  },
+  "license": "MIT",
+  "keywords": [
+    "excel",
+    "xls",
+    "xlsx",
+    "ods",
+    "spreadsheet",
+    "calamine",
+    "wasm"
+  ]
+}

package/pkg/calamine_node.d.ts

@@ -0,0 +1,4 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export function getAllSheets(data: Uint8Array): any;

package/pkg/calamine_node.js

@@ -0,0 +1,166 @@
+/* @ts-self-types="./calamine_node.d.ts" */
+
+/**
+ * @param {Uint8Array} data
+ * @returns {any}
+ */
+function getAllSheets(data) {
+    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.getAllSheets(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+exports.getAllSheets = getAllSheets;
+
+function __wbg_get_imports() {
+    const import0 = {
+        __proto__: null,
+        __wbg_Error_4577686b3a6d9b3a: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
+        __wbg_String_8564e559799eccda: function(arg0, arg1) {
+            const ret = String(arg1);
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_throw_39bc967c0e5a9b58: function(arg0, arg1) {
+            throw new Error(getStringFromWasm0(arg0, arg1));
+        },
+        __wbg_new_cbee8c0d5c479eac: function() {
+            const ret = new Array();
+            return ret;
+        },
+        __wbg_new_ed69e637b553a997: function() {
+            const ret = new Object();
+            return ret;
+        },
+        __wbg_set_4c81cfb5dc3a333c: function(arg0, arg1, arg2) {
+            arg0[arg1 >>> 0] = arg2;
+        },
+        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
+            arg0[arg1] = arg2;
+        },
+        __wbindgen_cast_0000000000000001: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(String) -> Externref`.
+            const ret = getStringFromWasm0(arg0, arg1);
+            return ret;
+        },
+        __wbindgen_init_externref_table: function() {
+            const table = wasm.__wbindgen_externrefs;
+            const offset = table.grow(4);
+            table.set(0, undefined);
+            table.set(offset + 0, undefined);
+            table.set(offset + 1, null);
+            table.set(offset + 2, true);
+            table.set(offset + 3, false);
+        },
+    };
+    return {
+        __proto__: null,
+        "./calamine_node_bg.js": import0,
+    };
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return decodeText(ptr, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function passArray8ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 1, 1) >>> 0;
+    getUint8ArrayMemory0().set(arg, ptr / 1);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+function decodeText(ptr, len) {
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
+const wasmPath = `${__dirname}/calamine_node_bg.wasm`;
+const wasmBytes = require('fs').readFileSync(wasmPath);
+const wasmModule = new WebAssembly.Module(wasmBytes);
+let wasm = new WebAssembly.Instance(wasmModule, __wbg_get_imports()).exports;
+wasm.__wbindgen_start();

package/pkg/calamine_node_bg.wasm.d.ts

@@ -0,0 +1,9 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const getAllSheets: (a: number, b: number) => [number, number, number];
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_start: () => void;