codexdb-sdk 0.1.0

package/PUBLISH.md

@@ -0,0 +1,21 @@
+# Publishing to npm
+
+To publish the CodexDB Node.js SDK to npm:
+
+1. Make sure you have an npm account: https://www.npmjs.com/signup
+2. Login to npm in your terminal:
+   ```sh
+   npm login
+   ```
+3. In the sdk/nodejs directory, publish the package:
+   ```sh
+   npm publish
+   ```
+
+If you get a name conflict error, choose a unique package name in package.json (e.g., codexdb-sdk-everton) and try again.
+
+## Versioning
+- Update the version field in package.json before publishing a new release.
+
+## Automated Publishing (optional)
+You can automate npm publishing using GitHub Actions or another CI/CD tool. Let me know if you want a workflow example!

package/README.md

@@ -0,0 +1,34 @@
+# CodexDB Node.js SDK
+
+Node.js SDK for CodexDB. Simple wrapper for `codex-cli` as an external process.
+
+## Installation
+
+Install via npm (from local directory):
+
+```sh
+npm install ./
+```
+
+Or, for development:
+
+```sh
+npm install -g ./
+```
+
+## Usage Example
+
+```js
+const { CodexClient } = require('codexdb-sdk');
+
+const client = new CodexClient({ file: 'test.db' });
+client.set('user:1', { name: 'Alice', age: 30 });
+console.log(client.get('user:1'));
+console.log(client.keys());
+client.delete('user:1');
+```
+
+## Requirements
+
+- Node.js 14+
+- `codex-cli` binary available in your PATH

package/example_app.js

@@ -0,0 +1,26 @@
+const path = require('path');
+const CodexClient = require('./index');
+
+const dbPath = path.resolve(__dirname, 'example-db.db');
+const client = new CodexClient({ file: dbPath });
+
+(async () => {
+  // Set a value
+  await client.set('greeting', { msg: 'Hello from Node.js!' });
+
+  // Get the value
+  const value = await client.get('greeting');
+  console.log('Greeting:', value.msg);
+
+  // List all keys
+  const keys = await client.keys();
+  console.log('All keys:', keys);
+
+  // Delete the key
+  const deleted = await client.delete('greeting');
+  console.log('Deleted:', deleted);
+
+  // Cleanup
+  const fs = require('fs');
+  try { fs.unlinkSync(dbPath); } catch (e) {}
+})();

package/index.js

@@ -0,0 +1,79 @@
+const { execFile } = require('child_process');
+
+function execCodexCli(cliPath, args, env = {}) {
+  return new Promise((resolve, reject) => {
+    execFile(cliPath, args, { env: { ...process.env, ...env } }, (error, stdout, stderr) => {
+      if (error) {
+        const message = stderr.trim() || stdout.trim() || error.message;
+        return reject(new Error(message));
+      }
+      resolve(stdout.trim());
+    });
+  });
+}
+
+class CodexClient {
+  constructor(options = {}) {
+    if (!options.file) {
+      throw new Error('options.file is required (path to database file)');
+    }
+
+    this.cliPath = options.cliPath || 'codex-cli';
+    this.file = options.file;
+    this.ledger = options.ledger ? '--ledger' : null;
+    this.env = {};
+
+    if (options.encryptionKey) {
+      this.env.CODEX_KEY = options.encryptionKey;
+    }
+  }
+
+  _baseArgs() {
+    const args = ['--file', this.file];
+    if (this.ledger) args.push(this.ledger);
+    return args;
+  }
+
+  async set(key, value) {
+    const payload = JSON.stringify(value);
+    const args = [...this._baseArgs(), 'set', key, payload];
+    await execCodexCli(this.cliPath, args, this.env);
+    return true;
+  }
+
+  async get(key) {
+    const args = [...this._baseArgs(), 'get', key];
+    const raw = await execCodexCli(this.cliPath, args, this.env);
+    if (!raw) return null;
+    return JSON.parse(raw);
+  }
+
+  async delete(key) {
+    const args = [...this._baseArgs(), 'delete', key];
+    await execCodexCli(this.cliPath, args, this.env);
+    return true;
+  }
+
+  async keys() {
+    const args = [...this._baseArgs(), 'keys'];
+    const raw = await execCodexCli(this.cliPath, args, this.env);
+    if (!raw) return [];
+    return raw.split('\n').filter((k) => k);
+  }
+
+  async has(key) {
+    const args = [...this._baseArgs(), 'has', key];
+    const raw = await execCodexCli(this.cliPath, args, this.env);
+    return raw.trim() === 'true';
+  }
+
+  async clear() {
+    const args = [...this._baseArgs(), 'clear'];
+    await execCodexCli(this.cliPath, args, this.env);
+    return true;
+  }
+}
+
+module.exports = {
+  CodexClient
+};

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "codexdb-sdk",
+  "version": "0.1.0",
+  "description": "Node.js SDK for CodexDB (wrapper around codex-cli)",
+  "main": "index.js",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": ["codexdb", "sdk", "database"],
+  "license": "MIT"
+}

package/test.js

@@ -0,0 +1,34 @@
+const path = require('path');
+const fs = require('fs');
+const CodexClient = require('./index');
+
+(async () => {
+  const dbPath = path.resolve(__dirname, 'test-db.db');
+
+  // cleanup before test
+  try { fs.unlinkSync(dbPath); } catch (e) {}
+
+  const client = new CodexClient({ file: dbPath });
+
+  await client.set('test-key', { hello: 'world' });
+  const value = await client.get('test-key');
+
+  if (value.hello !== 'world') throw new Error('value mismatch');
+
+  const hasKey = await client.has('test-key');
+  if (!hasKey) throw new Error('expected key to exist');
+
+  const keys = await client.keys();
+  if (!keys.includes('test-key')) throw new Error('expected keys to include test-key');
+
+  await client.delete('test-key');
+  const hasAfterDelete = await client.has('test-key');
+  if (hasAfterDelete) throw new Error('expected key to be deleted');
+
+  await client.clear();
+
+  // cleanup after test
+  try { fs.unlinkSync(dbPath); } catch (e) {}
+
+  console.log('Node.js SDK smoke test passed');
+})();