gesttalt 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pedro Piñera Buendía
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# Gesttalt Node.js Bindings
+
+High-performance snippets CRUD bindings for Gesttalt, powered by Zig.
+
+## Install
+
+```bash
+npm install gesttalt
+```
+
+## Usage
+
+```js
+const {
+  createSnippet,
+  readSnippet,
+  updateSnippet,
+  deleteSnippet,
+} = require('gesttalt');
+
+const projectDir = '.';
+const timestamp = 1735148400;
+
+const path = createSnippet(
+  projectDir,
+  timestamp,
+  'Example snippet',
+  'const x = 1;',
+  'example.zig'
+);
+
+const snippet = readSnippet(projectDir, timestamp);
+console.log(snippet);
+
+updateSnippet(projectDir, timestamp, {
+  description: 'Updated description',
+});
+
+deleteSnippet(projectDir, timestamp);
+```
+
+## Browser
+
+This package ships a WASM build for browser runtimes. Because snippets CRUD requires filesystem access, you must provide a WASI-compatible runtime with a mounted directory for the project.
+
+```js
+import { init, createSnippet } from 'gesttalt';
+
+await init();
+createSnippet('/project', 1735148400, 'Example snippet', 'const x = 1;', 'example.zig');
+```
+
+## Bun and Deno
+
+Bun and Deno can use the same binding via their Node.js compatibility layers.
+
+```bash
+bun run test.js
+```
+
+```bash
+deno run --allow-ffi --allow-read --allow-write test.js
+```
+
+## Development
+
+```bash
+# From project root
+zig build -Doptimize=ReleaseFast
+
+# Build the Node addon
+cd bindings/nodejs
+npm install
+npm test
+```
+
+## API
+
+- `createSnippet(projectDir, timestamp, description, body, filename)`
+- `readSnippet(projectDir, timestamp)`
+- `updateSnippet(projectDir, timestamp, update)`
+- `deleteSnippet(projectDir, timestamp)`
+
+## License
+
+MIT

package/binding.gyp

@@ -0,0 +1,26 @@
+{
+  "targets": [
+    {
+      "target_name": "gesttalt",
+      "sources": ["src/gesttalt.c"],
+      "include_dirs": [],
+      "libraries": [
+        "<(module_root_dir)/../../zig-out/lib/libgesttalt_ffi.a"
+      ],
+      "cflags": ["-Wall", "-Wextra"],
+      "xcode_settings": {
+        "OTHER_LDFLAGS": [
+          "<(module_root_dir)/../../zig-out/lib/libgesttalt_ffi.a"
+        ]
+      },
+      "conditions": [
+        ["OS=='linux'", {
+          "libraries": ["-lm", "-lpthread"]
+        }],
+        ["OS=='mac'", {
+          "libraries": ["-lm"]
+        }]
+      ]
+    }
+  ]
+}

package/browser.mjs

@@ -0,0 +1,184 @@
+// Browser-only WASM module for Gesttalt snippets
+
+let wasmModule = null;
+let wasmReady = false;
+let initPromise = null;
+
+const errorMessages = {
+  1: 'Invalid timestamp',
+  2: 'Duplicate snippet',
+  3: 'Snippet not found',
+  4: 'Invalid extension',
+  5: 'Invalid description',
+  6: 'Invalid filename',
+  7: 'Parse error',
+  8: 'I/O error',
+  9: 'Out of memory',
+  100: 'Unknown error',
+};
+
+export class GesttaltError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = 'GesttaltError';
+    this.code = code;
+  }
+}
+
+export async function init() {
+  if (wasmReady) return;
+  if (initPromise) return initPromise;
+
+  initPromise = (async () => {
+    const response = await fetch(new URL('./gesttalt.wasm', import.meta.url));
+    const wasmBuffer = await response.arrayBuffer();
+    const result = await WebAssembly.instantiate(wasmBuffer, {});
+    wasmModule = result.instance;
+    wasmReady = true;
+  })();
+
+  return initPromise;
+}
+
+function ensureWasmReady() {
+  if (!wasmReady) {
+    throw new Error('Gesttalt WASM not initialized. Call init() first.');
+  }
+}
+
+function throwForCode(code) {
+  if (code === 0) return;
+  const message = errorMessages[code] || errorMessages[100];
+  throw new GesttaltError(code, message);
+}
+
+function writeString(exports, memory, value) {
+  const encoder = new TextEncoder();
+  const bytes = encoder.encode(value);
+  const ptr = exports.alloc(bytes.length);
+  if (!ptr) {
+    throw new GesttaltError(9, errorMessages[9]);
+  }
+  new Uint8Array(memory.buffer, ptr, bytes.length).set(bytes);
+  return { ptr, len: bytes.length };
+}
+
+function readResult(exports, memory) {
+  const resultPtr = exports.get_result_ptr();
+  const resultLen = exports.get_result_len();
+  if (!resultPtr || resultLen === 0) {
+    return '';
+  }
+  const decoder = new TextDecoder();
+  const resultStr = decoder.decode(new Uint8Array(memory.buffer, resultPtr, resultLen));
+  exports.free_result();
+  return resultStr;
+}
+
+function createSnippetWasm(projectDir, timestamp, description, body, filename) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const desc = writeString(exports, memory, description);
+  const bodyBuf = writeString(exports, memory, body);
+  const file = writeString(exports, memory, filename);
+
+  const rc = exports.snippet_create(
+    project.ptr, project.len,
+    BigInt(timestamp),
+    desc.ptr, desc.len,
+    bodyBuf.ptr, bodyBuf.len,
+    file.ptr, file.len
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(desc.ptr, desc.len);
+  exports.dealloc(bodyBuf.ptr, bodyBuf.len);
+  exports.dealloc(file.ptr, file.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function readSnippetWasm(projectDir, timestamp) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.snippet_read(project.ptr, project.len, BigInt(timestamp));
+  exports.dealloc(project.ptr, project.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function updateSnippetWasm(projectDir, timestamp, description, body, filename) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const desc = description != null ? writeString(exports, memory, description) : null;
+  const bodyBuf = body != null ? writeString(exports, memory, body) : null;
+  const file = filename != null ? writeString(exports, memory, filename) : null;
+
+  const rc = exports.snippet_update(
+    project.ptr, project.len,
+    BigInt(timestamp),
+    desc ? desc.ptr : 0, desc ? desc.len : 0,
+    bodyBuf ? bodyBuf.ptr : 0, bodyBuf ? bodyBuf.len : 0,
+    file ? file.ptr : 0, file ? file.len : 0
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  if (desc) exports.dealloc(desc.ptr, desc.len);
+  if (bodyBuf) exports.dealloc(bodyBuf.ptr, bodyBuf.len);
+  if (file) exports.dealloc(file.ptr, file.len);
+
+  throwForCode(rc);
+}
+
+function deleteSnippetWasm(projectDir, timestamp) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.snippet_delete(project.ptr, project.len, BigInt(timestamp));
+  exports.dealloc(project.ptr, project.len);
+
+  throwForCode(rc);
+}
+
+export function createSnippet(projectDir, timestamp, description, body, filename) {
+  return createSnippetWasm(projectDir, timestamp, description, body, filename);
+}
+
+export function readSnippet(projectDir, timestamp) {
+  const json = readSnippetWasm(projectDir, timestamp);
+  return json ? JSON.parse(json) : null;
+}
+
+export function updateSnippet(projectDir, timestamp, update = {}) {
+  const description = update.description ?? null;
+  const body = update.body ?? null;
+  const filename = update.filename ?? null;
+  return updateSnippetWasm(projectDir, timestamp, description, body, filename);
+}
+
+export function deleteSnippet(projectDir, timestamp) {
+  return deleteSnippetWasm(projectDir, timestamp);
+}
+
+export function isNative() {
+  return false;
+}
+
+export function isWasm() {
+  return wasmReady;
+}
+
+export default { init, createSnippet, readSnippet, updateSnippet, deleteSnippet, isNative, isWasm, GesttaltError };

package/index.d.ts

@@ -0,0 +1,40 @@
+export interface Snippet {
+  id: string;
+  date: string;
+  description: string;
+  filename: string;
+  code: string;
+}
+
+export interface SnippetUpdate {
+  description?: string;
+  body?: string;
+  filename?: string;
+}
+
+export class GesttaltError extends Error {
+  code: number;
+}
+
+export function init(): Promise<void>;
+
+export function createSnippet(
+  projectDir: string,
+  timestamp: number,
+  description: string,
+  body: string,
+  filename: string
+): string;
+
+export function readSnippet(projectDir: string, timestamp: number): Snippet | null;
+
+export function updateSnippet(
+  projectDir: string,
+  timestamp: number,
+  update?: SnippetUpdate
+): void;
+
+export function deleteSnippet(projectDir: string, timestamp: number): void;
+
+export function isNative(): boolean;
+export function isWasm(): boolean;

package/index.js

@@ -0,0 +1,220 @@
+const path = require('path');
+const fs = require('fs');
+
+let native = null;
+let wasmModule = null;
+let wasmReady = false;
+
+const errorMessages = {
+  1: 'Invalid timestamp',
+  2: 'Duplicate snippet',
+  3: 'Snippet not found',
+  4: 'Invalid extension',
+  5: 'Invalid description',
+  6: 'Invalid filename',
+  7: 'Parse error',
+  8: 'I/O error',
+  9: 'Out of memory',
+  100: 'Unknown error',
+};
+
+class GesttaltError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = 'GesttaltError';
+    this.code = code;
+  }
+}
+
+try {
+  native = require('node-gyp-build')(__dirname);
+} catch (e) {
+  try {
+    native = require('./build/Release/gesttalt.node');
+  } catch (e2) {
+    // Native not available, will use WASM
+  }
+}
+
+async function init() {
+  if (native) {
+    wasmReady = true;
+    return;
+  }
+
+  if (wasmModule) {
+    return;
+  }
+
+  const wasmPath = path.join(__dirname, 'gesttalt.wasm');
+  const wasmBuffer = fs.readFileSync(wasmPath);
+  const result = await WebAssembly.instantiate(wasmBuffer, {});
+  wasmModule = result.instance;
+  wasmReady = true;
+}
+
+function ensureWasmReady() {
+  if (!wasmReady) {
+    throw new Error('Gesttalt WASM not initialized. Call init() first.');
+  }
+}
+
+function throwForCode(code) {
+  if (code === 0) return;
+  const message = errorMessages[code] || errorMessages[100];
+  throw new GesttaltError(code, message);
+}
+
+function writeString(exports, memory, value) {
+  const encoder = new TextEncoder();
+  const bytes = encoder.encode(value);
+  const ptr = exports.alloc(bytes.length);
+  if (!ptr) {
+    throw new GesttaltError(9, errorMessages[9]);
+  }
+  new Uint8Array(memory.buffer, ptr, bytes.length).set(bytes);
+  return { ptr, len: bytes.length };
+}
+
+function readResult(exports, memory) {
+  const resultPtr = exports.get_result_ptr();
+  const resultLen = exports.get_result_len();
+  if (!resultPtr || resultLen === 0) {
+    return '';
+  }
+  const decoder = new TextDecoder();
+  const resultStr = decoder.decode(new Uint8Array(memory.buffer, resultPtr, resultLen));
+  exports.free_result();
+  return resultStr;
+}
+
+function createSnippetWasm(projectDir, timestamp, description, body, filename) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const desc = writeString(exports, memory, description);
+  const bodyBuf = writeString(exports, memory, body);
+  const file = writeString(exports, memory, filename);
+
+  const rc = exports.snippet_create(
+    project.ptr, project.len,
+    BigInt(timestamp),
+    desc.ptr, desc.len,
+    bodyBuf.ptr, bodyBuf.len,
+    file.ptr, file.len
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(desc.ptr, desc.len);
+  exports.dealloc(bodyBuf.ptr, bodyBuf.len);
+  exports.dealloc(file.ptr, file.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function readSnippetWasm(projectDir, timestamp) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.snippet_read(project.ptr, project.len, BigInt(timestamp));
+  exports.dealloc(project.ptr, project.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function updateSnippetWasm(projectDir, timestamp, description, body, filename) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const desc = description != null ? writeString(exports, memory, description) : null;
+  const bodyBuf = body != null ? writeString(exports, memory, body) : null;
+  const file = filename != null ? writeString(exports, memory, filename) : null;
+
+  const rc = exports.snippet_update(
+    project.ptr, project.len,
+    BigInt(timestamp),
+    desc ? desc.ptr : 0, desc ? desc.len : 0,
+    bodyBuf ? bodyBuf.ptr : 0, bodyBuf ? bodyBuf.len : 0,
+    file ? file.ptr : 0, file ? file.len : 0
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  if (desc) exports.dealloc(desc.ptr, desc.len);
+  if (bodyBuf) exports.dealloc(bodyBuf.ptr, bodyBuf.len);
+  if (file) exports.dealloc(file.ptr, file.len);
+
+  throwForCode(rc);
+}
+
+function deleteSnippetWasm(projectDir, timestamp) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.snippet_delete(project.ptr, project.len, BigInt(timestamp));
+  exports.dealloc(project.ptr, project.len);
+
+  throwForCode(rc);
+}
+
+function createSnippet(projectDir, timestamp, description, body, filename) {
+  if (native) {
+    return native.createSnippet(projectDir, timestamp, description, body, filename);
+  }
+  return createSnippetWasm(projectDir, timestamp, description, body, filename);
+}
+
+function readSnippet(projectDir, timestamp) {
+  if (native) {
+    const json = native.readSnippet(projectDir, timestamp);
+    return json ? JSON.parse(json) : null;
+  }
+  const json = readSnippetWasm(projectDir, timestamp);
+  return json ? JSON.parse(json) : null;
+}
+
+function updateSnippet(projectDir, timestamp, update = {}) {
+  const description = update.description ?? null;
+  const body = update.body ?? null;
+  const filename = update.filename ?? null;
+
+  if (native) {
+    return native.updateSnippet(projectDir, timestamp, description, body, filename);
+  }
+  return updateSnippetWasm(projectDir, timestamp, description, body, filename);
+}
+
+function deleteSnippet(projectDir, timestamp) {
+  if (native) {
+    return native.deleteSnippet(projectDir, timestamp);
+  }
+  return deleteSnippetWasm(projectDir, timestamp);
+}
+
+function isNative() {
+  return native !== null;
+}
+
+function isWasm() {
+  return native === null && wasmReady;
+}
+
+module.exports = {
+  init,
+  createSnippet,
+  readSnippet,
+  updateSnippet,
+  deleteSnippet,
+  isNative,
+  isWasm,
+  GesttaltError,
+};

package/index.mjs

@@ -0,0 +1,230 @@
+import { createRequire } from 'module';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { readFileSync } from 'fs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+let native = null;
+let wasmModule = null;
+let wasmReady = false;
+let initPromise = null;
+
+const errorMessages = {
+  1: 'Invalid timestamp',
+  2: 'Duplicate snippet',
+  3: 'Snippet not found',
+  4: 'Invalid extension',
+  5: 'Invalid description',
+  6: 'Invalid filename',
+  7: 'Parse error',
+  8: 'I/O error',
+  9: 'Out of memory',
+  100: 'Unknown error',
+};
+
+export class GesttaltError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = 'GesttaltError';
+    this.code = code;
+  }
+}
+
+try {
+  native = require('node-gyp-build')(__dirname);
+} catch (e) {
+  try {
+    native = require('./build/Release/gesttalt.node');
+  } catch (e2) {
+    // Native not available, will use WASM
+  }
+}
+
+export async function init() {
+  if (native) {
+    wasmReady = true;
+    return;
+  }
+
+  if (initPromise) {
+    return initPromise;
+  }
+
+  initPromise = (async () => {
+    const wasmPath = join(__dirname, 'gesttalt.wasm');
+    const wasmBuffer = readFileSync(wasmPath);
+    const result = await WebAssembly.instantiate(wasmBuffer, {});
+    wasmModule = result.instance;
+    wasmReady = true;
+  })();
+
+  return initPromise;
+}
+
+function ensureWasmReady() {
+  if (!wasmReady) {
+    throw new Error('Gesttalt WASM not initialized. Call init() first.');
+  }
+}
+
+function throwForCode(code) {
+  if (code === 0) return;
+  const message = errorMessages[code] || errorMessages[100];
+  throw new GesttaltError(code, message);
+}
+
+function writeString(exports, memory, value) {
+  const encoder = new TextEncoder();
+  const bytes = encoder.encode(value);
+  const ptr = exports.alloc(bytes.length);
+  if (!ptr) {
+    throw new GesttaltError(9, errorMessages[9]);
+  }
+  new Uint8Array(memory.buffer, ptr, bytes.length).set(bytes);
+  return { ptr, len: bytes.length };
+}
+
+function readResult(exports, memory) {
+  const resultPtr = exports.get_result_ptr();
+  const resultLen = exports.get_result_len();
+  if (!resultPtr || resultLen === 0) {
+    return '';
+  }
+  const decoder = new TextDecoder();
+  const resultStr = decoder.decode(new Uint8Array(memory.buffer, resultPtr, resultLen));
+  exports.free_result();
+  return resultStr;
+}
+
+function createSnippetWasm(projectDir, timestamp, description, body, filename) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const desc = writeString(exports, memory, description);
+  const bodyBuf = writeString(exports, memory, body);
+  const file = writeString(exports, memory, filename);
+
+  const rc = exports.snippet_create(
+    project.ptr, project.len,
+    BigInt(timestamp),
+    desc.ptr, desc.len,
+    bodyBuf.ptr, bodyBuf.len,
+    file.ptr, file.len
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  exports.dealloc(desc.ptr, desc.len);
+  exports.dealloc(bodyBuf.ptr, bodyBuf.len);
+  exports.dealloc(file.ptr, file.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function readSnippetWasm(projectDir, timestamp) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.snippet_read(project.ptr, project.len, BigInt(timestamp));
+  exports.dealloc(project.ptr, project.len);
+
+  throwForCode(rc);
+  return readResult(exports, memory);
+}
+
+function updateSnippetWasm(projectDir, timestamp, description, body, filename) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const desc = description != null ? writeString(exports, memory, description) : null;
+  const bodyBuf = body != null ? writeString(exports, memory, body) : null;
+  const file = filename != null ? writeString(exports, memory, filename) : null;
+
+  const rc = exports.snippet_update(
+    project.ptr, project.len,
+    BigInt(timestamp),
+    desc ? desc.ptr : 0, desc ? desc.len : 0,
+    bodyBuf ? bodyBuf.ptr : 0, bodyBuf ? bodyBuf.len : 0,
+    file ? file.ptr : 0, file ? file.len : 0
+  );
+
+  exports.dealloc(project.ptr, project.len);
+  if (desc) exports.dealloc(desc.ptr, desc.len);
+  if (bodyBuf) exports.dealloc(bodyBuf.ptr, bodyBuf.len);
+  if (file) exports.dealloc(file.ptr, file.len);
+
+  throwForCode(rc);
+}
+
+function deleteSnippetWasm(projectDir, timestamp) {
+  ensureWasmReady();
+  const exports = wasmModule.exports;
+  const memory = exports.memory;
+
+  const project = writeString(exports, memory, projectDir);
+  const rc = exports.snippet_delete(project.ptr, project.len, BigInt(timestamp));
+  exports.dealloc(project.ptr, project.len);
+
+  throwForCode(rc);
+}
+
+export function createSnippet(projectDir, timestamp, description, body, filename) {
+  if (native) {
+    return native.createSnippet(projectDir, timestamp, description, body, filename);
+  }
+  return createSnippetWasm(projectDir, timestamp, description, body, filename);
+}
+
+export function readSnippet(projectDir, timestamp) {
+  if (native) {
+    const json = native.readSnippet(projectDir, timestamp);
+    return json ? JSON.parse(json) : null;
+  }
+  const json = readSnippetWasm(projectDir, timestamp);
+  return json ? JSON.parse(json) : null;
+}
+
+export function updateSnippet(projectDir, timestamp, update = {}) {
+  const description = update.description ?? null;
+  const body = update.body ?? null;
+  const filename = update.filename ?? null;
+
+  if (native) {
+    return native.updateSnippet(projectDir, timestamp, description, body, filename);
+  }
+  return updateSnippetWasm(projectDir, timestamp, description, body, filename);
+}
+
+export function deleteSnippet(projectDir, timestamp) {
+  if (native) {
+    return native.deleteSnippet(projectDir, timestamp);
+  }
+  return deleteSnippetWasm(projectDir, timestamp);
+}
+
+export function isNative() {
+  return native !== null;
+}
+
+export function isWasm() {
+  return native === null && wasmReady;
+}
+
+export default {
+  init,
+  createSnippet,
+  readSnippet,
+  updateSnippet,
+  deleteSnippet,
+  isNative,
+  isWasm,
+  GesttaltError,
+};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "gesttalt",
+  "version": "0.1.0",
+  "description": "Gesttalt snippets CRUD bindings powered by Zig",
+  "main": "index.js",
+  "module": "index.mjs",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "browser": "./browser.mjs",
+      "import": "./index.mjs",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "node-gyp rebuild",
+    "install": "node-gyp-build || node-gyp rebuild",
+    "test": "node test.js",
+    "prebuild": "prebuildify --napi --strip"
+  },
+  "keywords": [
+    "gesttalt",
+    "snippets",
+    "crud",
+    "zig",
+    "ffi",
+    "wasm",
+    "browser"
+  ],
+  "author": "Pedro Pinera Buendia",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pepicrft/gesttalt.git"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "node-gyp-build": "^4.8.4"
+  },
+  "devDependencies": {
+    "node-gyp": "^10.0.0",
+    "prebuildify": "^6.0.0"
+  },
+  "files": [
+    "index.js",
+    "index.mjs",
+    "index.d.ts",
+    "browser.mjs",
+    "gesttalt.wasm",
+    "binding.gyp",
+    "src/",
+    "prebuilds/"
+  ],
+  "browser": {
+    "./index.js": "./browser.mjs",
+    "./index.mjs": "./browser.mjs"
+  }
+}

package/src/gesttalt.c

@@ -0,0 +1,287 @@
+#include <node_api.h>
+#include <string.h>
+#include <stdlib.h>
+#include <stdint.h>
+
+int gesttalt_snippet_create(const char *project_dir, int64_t timestamp,
+                            const char *description, const char *body,
+                            const char *filename, char **out_path);
+int gesttalt_snippet_read(const char *project_dir, int64_t timestamp,
+                          char **out_json);
+int gesttalt_snippet_update(const char *project_dir, int64_t timestamp,
+                            const char *description, const char *body,
+                            const char *filename);
+int gesttalt_snippet_delete(const char *project_dir, int64_t timestamp);
+void gesttalt_free(char *ptr);
+
+static const char *error_message(int code) {
+    switch (code) {
+        case 1: return "Invalid timestamp";
+        case 2: return "Duplicate snippet";
+        case 3: return "Snippet not found";
+        case 4: return "Invalid extension";
+        case 5: return "Invalid description";
+        case 6: return "Invalid filename";
+        case 7: return "Parse error";
+        case 8: return "I/O error";
+        case 9: return "Out of memory";
+        default: return "Unknown error";
+    }
+}
+
+static void throw_error(napi_env env, int code) {
+    napi_value msg;
+    napi_value err;
+    napi_value code_val;
+
+    napi_create_string_utf8(env, error_message(code), NAPI_AUTO_LENGTH, &msg);
+    napi_create_error(env, NULL, msg, &err);
+    napi_create_int32(env, code, &code_val);
+    napi_set_named_property(env, err, "code", code_val);
+    napi_throw(env, err);
+}
+
+static bool get_string(napi_env env, napi_value value, char **out, size_t *out_len) {
+    napi_status status = napi_get_value_string_utf8(env, value, NULL, 0, out_len);
+    if (status != napi_ok) {
+        return false;
+    }
+    *out = malloc(*out_len + 1);
+    if (!*out) {
+        return false;
+    }
+    napi_get_value_string_utf8(env, value, *out, *out_len + 1, out_len);
+    return true;
+}
+
+static bool get_optional_string(napi_env env, napi_value value, char **out) {
+    napi_valuetype type;
+    napi_typeof(env, value, &type);
+    if (type == napi_null || type == napi_undefined) {
+        *out = NULL;
+        return true;
+    }
+    size_t len = 0;
+    if (!get_string(env, value, out, &len)) {
+        return false;
+    }
+    return true;
+}
+
+static napi_value CreateSnippet(napi_env env, napi_callback_info info) {
+    size_t argc = 5;
+    napi_value args[5];
+    napi_status status = napi_get_cb_info(env, info, &argc, args, NULL, NULL);
+    if (status != napi_ok || argc < 5) {
+        napi_throw_error(env, NULL, "Expected 5 arguments");
+        return NULL;
+    }
+
+    char *project_dir = NULL;
+    char *description = NULL;
+    char *body = NULL;
+    char *filename = NULL;
+    size_t tmp_len = 0;
+    int64_t timestamp = 0;
+
+    if (!get_string(env, args[0], &project_dir, &tmp_len)) {
+        napi_throw_error(env, NULL, "project_dir must be a string");
+        return NULL;
+    }
+    if (napi_get_value_int64(env, args[1], &timestamp) != napi_ok) {
+        free(project_dir);
+        napi_throw_error(env, NULL, "timestamp must be a number");
+        return NULL;
+    }
+    if (!get_string(env, args[2], &description, &tmp_len)) {
+        free(project_dir);
+        napi_throw_error(env, NULL, "description must be a string");
+        return NULL;
+    }
+    if (!get_string(env, args[3], &body, &tmp_len)) {
+        free(project_dir);
+        free(description);
+        napi_throw_error(env, NULL, "body must be a string");
+        return NULL;
+    }
+    if (!get_string(env, args[4], &filename, &tmp_len)) {
+        free(project_dir);
+        free(description);
+        free(body);
+        napi_throw_error(env, NULL, "filename must be a string");
+        return NULL;
+    }
+
+    char *out_path = NULL;
+    int rc = gesttalt_snippet_create(project_dir, timestamp, description, body, filename, &out_path);
+
+    free(project_dir);
+    free(description);
+    free(body);
+    free(filename);
+
+    if (rc != 0) {
+        throw_error(env, rc);
+        return NULL;
+    }
+
+    napi_value result;
+    if (out_path) {
+        napi_create_string_utf8(env, out_path, strlen(out_path), &result);
+        gesttalt_free(out_path);
+    } else {
+        napi_get_undefined(env, &result);
+    }
+    return result;
+}
+
+static napi_value ReadSnippet(napi_env env, napi_callback_info info) {
+    size_t argc = 2;
+    napi_value args[2];
+    napi_status status = napi_get_cb_info(env, info, &argc, args, NULL, NULL);
+    if (status != napi_ok || argc < 2) {
+        napi_throw_error(env, NULL, "Expected 2 arguments");
+        return NULL;
+    }
+
+    char *project_dir = NULL;
+    size_t tmp_len = 0;
+    int64_t timestamp = 0;
+
+    if (!get_string(env, args[0], &project_dir, &tmp_len)) {
+        napi_throw_error(env, NULL, "project_dir must be a string");
+        return NULL;
+    }
+    if (napi_get_value_int64(env, args[1], &timestamp) != napi_ok) {
+        free(project_dir);
+        napi_throw_error(env, NULL, "timestamp must be a number");
+        return NULL;
+    }
+
+    char *out_json = NULL;
+    int rc = gesttalt_snippet_read(project_dir, timestamp, &out_json);
+    free(project_dir);
+
+    if (rc != 0) {
+        throw_error(env, rc);
+        return NULL;
+    }
+
+    napi_value result;
+    if (out_json) {
+        napi_create_string_utf8(env, out_json, strlen(out_json), &result);
+        gesttalt_free(out_json);
+    } else {
+        napi_get_undefined(env, &result);
+    }
+    return result;
+}
+
+static napi_value UpdateSnippet(napi_env env, napi_callback_info info) {
+    size_t argc = 5;
+    napi_value args[5];
+    napi_status status = napi_get_cb_info(env, info, &argc, args, NULL, NULL);
+    if (status != napi_ok || argc < 5) {
+        napi_throw_error(env, NULL, "Expected 5 arguments");
+        return NULL;
+    }
+
+    char *project_dir = NULL;
+    char *description = NULL;
+    char *body = NULL;
+    char *filename = NULL;
+    size_t tmp_len = 0;
+    int64_t timestamp = 0;
+
+    if (!get_string(env, args[0], &project_dir, &tmp_len)) {
+        napi_throw_error(env, NULL, "project_dir must be a string");
+        return NULL;
+    }
+    if (napi_get_value_int64(env, args[1], &timestamp) != napi_ok) {
+        free(project_dir);
+        napi_throw_error(env, NULL, "timestamp must be a number");
+        return NULL;
+    }
+    if (!get_optional_string(env, args[2], &description) ||
+        !get_optional_string(env, args[3], &body) ||
+        !get_optional_string(env, args[4], &filename)) {
+        free(project_dir);
+        free(description);
+        free(body);
+        free(filename);
+        napi_throw_error(env, NULL, "Invalid update fields");
+        return NULL;
+    }
+
+    int rc = gesttalt_snippet_update(project_dir, timestamp, description, body, filename);
+
+    free(project_dir);
+    free(description);
+    free(body);
+    free(filename);
+
+    if (rc != 0) {
+        throw_error(env, rc);
+        return NULL;
+    }
+
+    napi_value result;
+    napi_get_undefined(env, &result);
+    return result;
+}
+
+static napi_value DeleteSnippet(napi_env env, napi_callback_info info) {
+    size_t argc = 2;
+    napi_value args[2];
+    napi_status status = napi_get_cb_info(env, info, &argc, args, NULL, NULL);
+    if (status != napi_ok || argc < 2) {
+        napi_throw_error(env, NULL, "Expected 2 arguments");
+        return NULL;
+    }
+
+    char *project_dir = NULL;
+    size_t tmp_len = 0;
+    int64_t timestamp = 0;
+
+    if (!get_string(env, args[0], &project_dir, &tmp_len)) {
+        napi_throw_error(env, NULL, "project_dir must be a string");
+        return NULL;
+    }
+    if (napi_get_value_int64(env, args[1], &timestamp) != napi_ok) {
+        free(project_dir);
+        napi_throw_error(env, NULL, "timestamp must be a number");
+        return NULL;
+    }
+
+    int rc = gesttalt_snippet_delete(project_dir, timestamp);
+    free(project_dir);
+
+    if (rc != 0) {
+        throw_error(env, rc);
+        return NULL;
+    }
+
+    napi_value result;
+    napi_get_undefined(env, &result);
+    return result;
+}
+
+static napi_value Init(napi_env env, napi_value exports) {
+    napi_value fn;
+
+    napi_create_function(env, NULL, 0, CreateSnippet, NULL, &fn);
+    napi_set_named_property(env, exports, "createSnippet", fn);
+
+    napi_create_function(env, NULL, 0, ReadSnippet, NULL, &fn);
+    napi_set_named_property(env, exports, "readSnippet", fn);
+
+    napi_create_function(env, NULL, 0, UpdateSnippet, NULL, &fn);
+    napi_set_named_property(env, exports, "updateSnippet", fn);
+
+    napi_create_function(env, NULL, 0, DeleteSnippet, NULL, &fn);
+    napi_set_named_property(env, exports, "deleteSnippet", fn);
+
+    return exports;
+}
+
+NAPI_MODULE(NODE_GYP_MODULE_NAME, Init)