hyperdb-wasm 0.0.26281-dev.wasm.g39d82636

package/examples/browser.html

@@ -0,0 +1,84 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>HyperDB WebAssembly Example</title>
+    <style>
+        :root { color-scheme: light dark; font-family: ui-monospace, SFMono-Regular, Consolas, monospace; }
+        body { margin: 0 auto; max-width: 960px; padding: 2rem; }
+        textarea { box-sizing: border-box; min-height: 10rem; padding: 1rem; resize: vertical; width: 100%; }
+        button { cursor: pointer; margin: 1rem 0; padding: 0.6rem 1rem; }
+        table { border-collapse: collapse; width: 100%; }
+        th, td { border: 1px solid currentColor; padding: 0.5rem; text-align: left; }
+        #status { min-height: 1.5rem; }
+    </style>
+</head>
+<body>
+    <h1>HyperDB in the browser</h1>
+    <p>Edit the SQL and run it locally in the WebAssembly worker.</p>
+    <textarea id="sql">select department, count(*) as employees, sum(salary) as payroll
+from (values
+    ('Engineering', 120000),
+    ('Engineering', 135000),
+    ('Sales', 95000)
+) as employees(department, salary)
+group by department
+order by department</textarea>
+    <button id="run" type="button">Run query</button>
+    <p id="status">Loading HyperDB...</p>
+    <div id="result"></div>
+
+    <script type="module">
+        import { HyperDB } from '../dist/browser.js';
+
+        const sql = document.querySelector('#sql');
+        const run = document.querySelector('#run');
+        const status = document.querySelector('#status');
+        const result = document.querySelector('#result');
+
+        const database = await HyperDB.create();
+        const connection = await database.connect();
+        status.textContent = 'Ready';
+
+        function render(table) {
+            const names = table.schema.fields.map(({ name }) => name);
+            const rows = Array.from({ length: table.numRows }, (_, row) =>
+                names.map((name) => String(table.getChild(name)?.get(row) ?? 'NULL')),
+            );
+            const tableElement = document.createElement('table');
+            const header = tableElement.createTHead().insertRow();
+            for (const name of names) {
+                const cell = document.createElement('th');
+                cell.textContent = name;
+                header.append(cell);
+            }
+            const body = tableElement.createTBody();
+            for (const values of rows) {
+                const row = body.insertRow();
+                for (const value of values) row.insertCell().textContent = value;
+            }
+            result.replaceChildren(tableElement);
+        }
+
+        run.addEventListener('click', async () => {
+            run.disabled = true;
+            status.textContent = 'Running...';
+            try {
+                const table = await connection.query(sql.value);
+                render(table);
+                status.textContent = `${table.numRows} row(s)`;
+            } catch (error) {
+                result.textContent = error instanceof Error ? error.message : String(error);
+                status.textContent = 'Query failed';
+            } finally {
+                run.disabled = false;
+            }
+        });
+
+        window.addEventListener('pagehide', () => {
+            void connection.close().then(() => database.terminate());
+        });
+    </script>
+</body>
+</html>

package/examples/node.mjs

@@ -0,0 +1,43 @@
+import { HyperDB } from 'hyperdb-wasm';
+
+function rows(table) {
+    return Array.from({ length: table.numRows }, (_, row) => Object.fromEntries(
+        table.schema.fields.map(({ name }) => [name, table.getChild(name)?.get(row)]),
+    ));
+}
+
+const database = await HyperDB.create();
+const connection = await database.connect();
+
+try {
+    const expressions = await connection.query(`
+        select
+            6 * 7 as answer,
+            upper('query Hyper from Node.js') as message
+    `);
+    console.table(rows(expressions));
+
+    const grouped = await connection.query(`
+        select department, count(*) as employees, sum(salary) as payroll
+        from (values
+            ('Engineering', 120000),
+            ('Engineering', 135000),
+            ('Sales', 95000)
+        ) as employees(department, salary)
+        group by department
+        order by department
+    `);
+    console.table(rows(grouped));
+
+    const reader = await connection.send(`
+        select value, value * value as square
+        from generate_series(1, 5) as numbers(value)
+        order by value
+    `);
+    for await (const batch of reader) {
+        console.log(`streamed Arrow batch with ${batch.numRows} rows`);
+    }
+} finally {
+    await connection.close();
+    await database.terminate();
+}

package/examples/serve.mjs

@@ -0,0 +1,35 @@
+import { createReadStream, existsSync, statSync } from 'node:fs';
+import { createServer } from 'node:http';
+import { extname, resolve, sep } from 'node:path';
+
+const packageRoot = resolve(import.meta.dirname, '..');
+const port = Number(process.env.PORT ?? 8000);
+const contentTypes = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.map': 'application/json',
+    '.wasm': 'application/wasm',
+};
+
+createServer((request, response) => {
+    response.setHeader('Cross-Origin-Opener-Policy', 'same-origin');
+    response.setHeader('Cross-Origin-Embedder-Policy', 'require-corp');
+
+    const pathname = new URL(request.url ?? '/', 'http://localhost').pathname;
+    const relativePath = pathname === '/' ? 'examples/browser.html' : pathname.slice(1);
+    const file = resolve(packageRoot, relativePath);
+    if (!file.startsWith(`${packageRoot}${sep}`) || !existsSync(file) || !statSync(file).isFile()) {
+        response.writeHead(404).end('Not found');
+        return;
+    }
+
+    const compressedWasm = file.endsWith('.wasm.br');
+    response.writeHead(200, {
+        ...(compressedWasm ? { 'Content-Encoding': 'br' } : {}),
+        'Content-Length': statSync(file).size,
+        'Content-Type': compressedWasm ? 'application/wasm' : contentTypes[extname(file)] ?? 'application/octet-stream',
+    });
+    createReadStream(file).pipe(response);
+}).listen(port, '127.0.0.1', () => {
+    console.log(`HyperDB browser example: http://127.0.0.1:${port}/`);
+});

package/package.json

@@ -0,0 +1,41 @@
+{
+    "name": "hyperdb-wasm",
+    "version": "0.0.26281-dev.wasm.g39d82636",
+    "type": "module",
+    "engines": {
+        "node": ">=24"
+    },
+    "files": [
+        "dist",
+        "examples"
+    ],
+    "exports": {
+        ".": {
+            "browser": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/browser.js"
+            },
+            "node": {
+                "types": "./dist/index.node.d.ts",
+                "default": "./dist/node.js"
+            },
+            "types": "./dist/index.d.ts",
+            "default": "./dist/browser.js"
+        },
+        "./raw": {
+            "browser": {
+                "types": "./dist/raw.browser.d.ts",
+                "default": "./dist/raw.browser.js"
+            },
+            "node": {
+                "types": "./dist/raw.node.d.ts",
+                "default": "./dist/raw.node.js"
+            },
+            "types": "./dist/raw.browser.d.ts",
+            "default": "./dist/raw.browser.js"
+        }
+    },
+    "dependencies": {
+        "apache-arrow": "^19.0.1"
+    }
+}