@iskra-bun/db-oracle 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @iskra-bun/db-oracle
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial public release.

package/README.md

@@ -0,0 +1,33 @@
+# @iskra-bun/db-oracle
+
+Soporte para Oracle Database en Iskra a traves de un puente/sidecar (IPC). Permite ejecutar consultas contra Oracle desde una app Iskra sin acoplar el cliente nativo al proceso principal.
+
+## Instalacion
+
+```bash
+bun add @iskra-bun/db-oracle @iskra-bun/core
+```
+
+## Uso rapido
+
+```typescript
+import { App } from '@iskra-bun/core'
+import { OracleDriver } from '@iskra-bun/db-oracle'
+
+const app = new App({ name: 'mi-app' })
+app.register(new OracleDriver({ /* config del puente */ }))
+
+await app.start()
+```
+
+## Estado
+
+Implementacion via puente/sidecar (protocolo request/response sobre un proceso Node). No incluye aun pooling de conexiones ni recuperacion avanzada de errores; ver la guia para los detalles del bridge.
+
+## Documentacion
+
+Guia completa: [docs/db-kit.md](../../docs/db-kit.md)
+
+## Licencia
+
+AGPL-3.0-or-later

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { Driver, App } from '@iskra-bun/core';
+
+declare class OracleDriver implements Driver {
+    name: string;
+    private proc;
+    private reqId;
+    private pending;
+    private bridgePath;
+    constructor(bridgePath?: string);
+    init(app: App): Promise<void>;
+    start(app?: App): Promise<void>;
+    stop(): Promise<void>;
+    query(sql: string, params?: any[]): Promise<unknown>;
+    private readStream;
+}
+
+export { OracleDriver };

package/dist/index.js

@@ -0,0 +1,99 @@
+// src/driver.ts
+import { spawn } from "bun";
+import { resolve } from "path";
+var OracleDriver = class {
+  name = "db";
+  // Replaces standard db driver if used, or can be 'oracle'
+  proc = null;
+  reqId = 0;
+  pending = /* @__PURE__ */ new Map();
+  bridgePath;
+  constructor(bridgePath) {
+    this.bridgePath = bridgePath || resolve(import.meta.dir, "../bridge/runner.js");
+  }
+  async init(app) {
+    app.context.set("oracle", this);
+  }
+  async start(app) {
+    if (!process.env.ORA_CONN) {
+      console.warn("Oracle connection string (ORA_CONN) not set. Oracle driver will not start.");
+      return;
+    }
+    this.proc = spawn(["node", this.bridgePath], {
+      stdin: "pipe",
+      stdout: "pipe",
+      env: { ...process.env }
+    });
+    if (!this.proc.stdout) {
+      throw new Error("Failed to spawn Oracle bridge process (no stdout)");
+    }
+    this.readStream(this.proc.stdout);
+  }
+  async stop() {
+    if (this.proc) {
+      this.proc.kill();
+      this.proc = null;
+    }
+  }
+  async query(sql, params = []) {
+    if (!this.proc || !this.proc.stdin) {
+      throw new Error("Oracle driver not started");
+    }
+    const id = this.reqId++;
+    return new Promise((resolve2, reject) => {
+      this.pending.set(id, { resolve: resolve2, reject });
+      const msg = JSON.stringify({ id, sql, params }) + "\n";
+      const stdin = this.proc.stdin;
+      if (stdin.write) {
+        stdin.write(msg);
+        stdin.flush();
+      }
+    });
+  }
+  async readStream(stream) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() || "";
+        for (const line of lines) {
+          if (!line.trim()) continue;
+          try {
+            const msg = JSON.parse(line);
+            if (msg.type === "ready") {
+              continue;
+            }
+            if (msg.type === "fatal") {
+              console.error("Oracle Bridge Fatal Error:", msg.error);
+              continue;
+            }
+            if (msg.id !== void 0 && this.pending.has(msg.id)) {
+              const { resolve: resolve2, reject } = this.pending.get(msg.id);
+              this.pending.delete(msg.id);
+              if (msg.error) {
+                reject(new Error(msg.error));
+              } else {
+                resolve2(msg.data);
+              }
+            }
+          } catch (err) {
+            console.error("Error parsing bridge message:", err, line);
+          }
+        }
+      }
+    } catch (err) {
+      console.error("Error reading from Oracle bridge:", err);
+    } finally {
+      reader.releaseLock();
+    }
+  }
+};
+export {
+  OracleDriver
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/driver.ts"],"sourcesContent":["import type { Driver, App } from '@iskra-bun/core';\nimport { spawn, type Subprocess } from 'bun';\nimport { resolve } from 'path';\n\nexport class OracleDriver implements Driver {\n    name = 'db'; // Replaces standard db driver if used, or can be 'oracle'\n    private proc: Subprocess | null = null;\n    private reqId = 0;\n    private pending = new Map<number, { resolve: (val: any) => void, reject: (err: any) => void }>();\n    private bridgePath: string;\n\n    constructor(bridgePath?: string) {\n        // Allow overriding path for flexibility (absolute path)\n        // Defaults to calculating relative to this file in a built package structure\n        // Adjust logic if needed based on where this file ends up (dist vs src)\n        // For dev (src), it's ../bridge/runner.js\n        this.bridgePath = bridgePath || resolve(import.meta.dir, '../bridge/runner.js');\n    }\n\n    async init(app: App) {\n        // If we want to replace the main 'db' object or sit alongside it\n        app.context.set('oracle', this);\n    }\n\n    async start(app?: App) { // app optional to satisfy interface but we might need config from it\n        // Check env vars\n        if (!process.env.ORA_CONN) {\n            console.warn('Oracle connection string (ORA_CONN) not set. Oracle driver will not start.');\n            return;\n        }\n\n        this.proc = spawn(['node', this.bridgePath], {\n            stdin: 'pipe',\n            stdout: 'pipe',\n            env: { ...process.env },\n        });\n\n        if (!this.proc.stdout) {\n            throw new Error('Failed to spawn Oracle bridge process (no stdout)');\n        }\n\n        this.readStream(this.proc.stdout as ReadableStream);\n\n        // Wait for ready signal?\n        // For now we assume optimistic start or we could wait for 'ready' message\n    }\n\n    async stop() {\n        if (this.proc) {\n            this.proc.kill();\n            this.proc = null;\n        }\n    }\n\n    async query(sql: string, params: any[] = []) {\n        if (!this.proc || !this.proc.stdin) {\n            throw new Error('Oracle driver not started');\n        }\n\n        const id = this.reqId++;\n\n        return new Promise((resolve, reject) => {\n            this.pending.set(id, { resolve, reject });\n\n            const msg = JSON.stringify({ id, sql, params }) + '\\n';\n            const stdin = this.proc!.stdin as any; // Bun FileSink/writer\n            if (stdin.write) {\n                stdin.write(msg);\n                stdin.flush();\n            }\n        });\n    }\n\n    private async readStream(stream: ReadableStream) {\n        const reader = stream.getReader();\n        const decoder = new TextDecoder();\n        let buffer = '';\n\n        try {\n            while (true) {\n                const { done, value } = await reader.read();\n                if (done) break;\n\n                buffer += decoder.decode(value, { stream: true });\n                const lines = buffer.split('\\n');\n                buffer = lines.pop() || ''; // Keep incomplete line\n\n                for (const line of lines) {\n                    if (!line.trim()) continue;\n                    try {\n                        const msg = JSON.parse(line);\n\n                        if (msg.type === 'ready') {\n                            // console.log('Oracle Bridge Ready');\n                            continue;\n                        }\n                        if (msg.type === 'fatal') {\n                            console.error('Oracle Bridge Fatal Error:', msg.error);\n                            // Reject all pending?\n                            continue;\n                        }\n\n                        if (msg.id !== undefined && this.pending.has(msg.id)) {\n                            const { resolve, reject } = this.pending.get(msg.id)!;\n                            this.pending.delete(msg.id);\n\n                            if (msg.error) {\n                                reject(new Error(msg.error));\n                            } else {\n                                resolve(msg.data);\n                            }\n                        }\n                    } catch (err) {\n                        console.error('Error parsing bridge message:', err, line);\n                    }\n                }\n            }\n        } catch (err) {\n            console.error('Error reading from Oracle bridge:', err);\n        } finally {\n            reader.releaseLock();\n        }\n    }\n}\n"],"mappings":"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","names":["resolve"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+    "name": "@iskra-bun/db-oracle",
+    "version": "0.1.0",
+    "description": "Soporte para Oracle Database en Iskra (via puente/sidecar).",
+    "keywords": [
+        "iskra",
+        "bun",
+        "typescript",
+        "oracle",
+        "database",
+        "sql",
+        "experimental"
+    ],
+    "author": "Joan Lascano",
+    "license": "AGPL-3.0-or-later",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/fearful/iskra.git",
+        "directory": "packages/db-oracle"
+    },
+    "homepage": "https://github.com/fearful/iskra/tree/main/packages/db-oracle#readme",
+    "bugs": "https://github.com/fearful/iskra/issues",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "source": "./src/index.ts",
+            "bun": "./src/index.ts",
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "src",
+        "README.md",
+        "CHANGELOG.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "test": "bun test",
+        "build": "tsup --config ../../tsup.config.ts"
+    },
+    "dependencies": {
+        "@iskra-bun/core": "0.1.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.10.2",
+        "bun-types": "latest"
+    }
+}

package/src/driver.ts

@@ -0,0 +1,124 @@
+import type { Driver, App } from '@iskra-bun/core';
+import { spawn, type Subprocess } from 'bun';
+import { resolve } from 'path';
+
+export class OracleDriver implements Driver {
+    name = 'db'; // Replaces standard db driver if used, or can be 'oracle'
+    private proc: Subprocess | null = null;
+    private reqId = 0;
+    private pending = new Map<number, { resolve: (val: any) => void, reject: (err: any) => void }>();
+    private bridgePath: string;
+
+    constructor(bridgePath?: string) {
+        // Allow overriding path for flexibility (absolute path)
+        // Defaults to calculating relative to this file in a built package structure
+        // Adjust logic if needed based on where this file ends up (dist vs src)
+        // For dev (src), it's ../bridge/runner.js
+        this.bridgePath = bridgePath || resolve(import.meta.dir, '../bridge/runner.js');
+    }
+
+    async init(app: App) {
+        // If we want to replace the main 'db' object or sit alongside it
+        app.context.set('oracle', this);
+    }
+
+    async start(app?: App) { // app optional to satisfy interface but we might need config from it
+        // Check env vars
+        if (!process.env.ORA_CONN) {
+            console.warn('Oracle connection string (ORA_CONN) not set. Oracle driver will not start.');
+            return;
+        }
+
+        this.proc = spawn(['node', this.bridgePath], {
+            stdin: 'pipe',
+            stdout: 'pipe',
+            env: { ...process.env },
+        });
+
+        if (!this.proc.stdout) {
+            throw new Error('Failed to spawn Oracle bridge process (no stdout)');
+        }
+
+        this.readStream(this.proc.stdout as ReadableStream);
+
+        // Wait for ready signal?
+        // For now we assume optimistic start or we could wait for 'ready' message
+    }
+
+    async stop() {
+        if (this.proc) {
+            this.proc.kill();
+            this.proc = null;
+        }
+    }
+
+    async query(sql: string, params: any[] = []) {
+        if (!this.proc || !this.proc.stdin) {
+            throw new Error('Oracle driver not started');
+        }
+
+        const id = this.reqId++;
+
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+
+            const msg = JSON.stringify({ id, sql, params }) + '\n';
+            const stdin = this.proc!.stdin as any; // Bun FileSink/writer
+            if (stdin.write) {
+                stdin.write(msg);
+                stdin.flush();
+            }
+        });
+    }
+
+    private async readStream(stream: ReadableStream) {
+        const reader = stream.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) break;
+
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || ''; // Keep incomplete line
+
+                for (const line of lines) {
+                    if (!line.trim()) continue;
+                    try {
+                        const msg = JSON.parse(line);
+
+                        if (msg.type === 'ready') {
+                            // console.log('Oracle Bridge Ready');
+                            continue;
+                        }
+                        if (msg.type === 'fatal') {
+                            console.error('Oracle Bridge Fatal Error:', msg.error);
+                            // Reject all pending?
+                            continue;
+                        }
+
+                        if (msg.id !== undefined && this.pending.has(msg.id)) {
+                            const { resolve, reject } = this.pending.get(msg.id)!;
+                            this.pending.delete(msg.id);
+
+                            if (msg.error) {
+                                reject(new Error(msg.error));
+                            } else {
+                                resolve(msg.data);
+                            }
+                        }
+                    } catch (err) {
+                        console.error('Error parsing bridge message:', err, line);
+                    }
+                }
+            }
+        } catch (err) {
+            console.error('Error reading from Oracle bridge:', err);
+        } finally {
+            reader.releaseLock();
+        }
+    }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './driver';