@log-ingestor/mssql 0.0.1 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arit Vyas
+
+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,164 @@
+# @log-ingestor/mssql
+
+Disk-first Node.js logger with automatic ingestion into Microsoft SQL Server — no ELK, no log management headaches.
+
+This package is the **MSSQL adapter** for the `log-ingestor` ecosystem.  
+It writes structured logs to disk and reliably ingests them into **Microsoft SQL Server** using a high‑performance background ingestor.
+
+---
+
+## Why this exists
+
+Most Node.js applications:
+- Print logs to console
+- Rotate files manually
+- Lose logs on crashes
+- Overpay for ELK
+
+This solves that with a simple model:
+
+**App → disk → background ingestor → MSSQL**
+
+No Kafka. No ELK. No ops pain.
+
+---
+
+## Features
+
+- Structured JSON logging
+- Disk-first (crash-safe)
+- Automatic background ingestion
+- Batch inserts with retry
+- Auto table creation
+- One ingestor per process
+- Production-ready defaults
+
+---
+
+## Installation
+
+```bash
+npm install @log-ingestor/mssql
+```
+
+---
+
+## Basic Usage
+
+```js
+const { createLogger } = require("@log-ingestor/mssql");
+
+const logger = createLogger({
+  service: {
+    name: "order-service",
+    version: "1.0.0"
+  },
+  logging: {
+    logDir: "./logs"
+  },
+  db: {
+    type: "mssql",
+    connection: process.env.MSSQL_CONNECTION
+  },
+  batch: {
+    size: 200
+  }
+});
+
+logger.info("order created", { orderId: 123 });
+logger.error("payment failed", { reason: "timeout" });
+```
+
+That’s it.  
+The ingestor starts automatically in the background.
+
+---
+
+## How it works
+
+1. Logs are written as JSON lines to disk
+2. A background ingestor binary starts automatically
+3. Logs are batched and inserted into MSSQL
+4. Retries happen automatically on failure
+
+Your app never blocks on DB writes.
+
+---
+
+## Configuration
+
+### Logger options
+
+```ts
+{
+  service: {
+    name: string,
+    version?: string
+  },
+  logging: {
+    logDir?: string // default: ./logs
+  },
+  db: {
+    type: "mssql",
+    connection: string,
+    table?: string // default: unified_logs
+  },
+  batch?: {
+    size?: number        // default: 200
+    maxRetries?: number  // default: 3
+  }
+}
+```
+
+---
+
+## Output format (example)
+
+```json
+{
+  "logId": "uuid",
+  "timestamp": "2026-01-05T10:20:30.000Z",
+  "level": "INFO",
+  "service": {
+    "name": "order-service",
+    "version": "1.0.0"
+  },
+  "message": "order created",
+  "data": {
+    "orderId": 123
+  }
+}
+```
+
+---
+
+## Internal components
+
+- **@log-ingestor/core** – shared logger logic
+- **@log-ingestor/mssql** – MSSQL ingestion adapter
+- **Ingestor binary** – high-performance background worker
+
+---
+
+## What this is NOT
+
+- Not a console logger
+- Not a replacement for application metrics
+- Not an ELK stack
+
+This is for **durable, queryable application logs**.
+
+---
+
+## Roadmap
+
+- PostgreSQL adapter
+- MySQL adapter
+- MongoDB adapter
+- DynamoDB adapter
+
+---
+
+## License
+
+MIT

package/package.json

@@ -1,11 +1,42 @@
 {
   "name": "@log-ingestor/mssql",
-  "version": "0.0.1",
-  "description": "MSSQL adapter for log-ingestor",
+  "version": "0.2.0",
+  "description": "Disk-first structured logger for Node.js with local ingestion to Microsoft SQL Server (MSSQL)",
   "license": "MIT",
   "private": false,
-  "main": "index.js",
+  "main": "src/index.js",
   "dependencies": {
-    "@log-ingestor/core": "^0.0.1"
+    "@log-ingestor/core": "^0.2.0"
+  },
+  "files": [
+    "src",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "logger",
+    "logging",
+    "structured-logging",
+    "disk-logging",
+    "database-logging",
+    "node-logger",
+    "mssql",
+    "sql-server",
+    "enterprise-logging",
+    "backend-logging",
+    "durable-logging"
+  ],
+  "author": "Arit Vyas <aritvyas@hotmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aritvyas/unified-logger-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aritvyas/unified-logger-sdk/issues"
+  },
+  "homepage": "https://github.com/aritvyas/unified-logger-sdk#readme",
+  "engines": {
+    "node": ">=16"
   }
-}
+}

package/src/config.js

@@ -0,0 +1,24 @@
+function buildIngestorConfig({ logDir, db, batch }) {
+  if (!logDir) {
+    throw new Error("logDir is required");
+  }
+
+  if (!db?.type || !db?.connection) {
+    throw new Error("db.type and db.connection are required");
+  }
+
+  return {
+    logDir,
+    db: {
+      type: db.type,                
+      connection: db.connection,
+      table: db.table || "unified_logs"
+    },
+    batch: {
+      size: batch?.size || 200,
+      maxRetries: batch?.maxRetries || 3
+    }
+  };
+}
+
+module.exports = { buildIngestorConfig };

package/src/index.js

@@ -0,0 +1,9 @@
+const { Logger } = require("./logger");
+
+function createLogger(options) {
+  return new Logger(options);
+}
+
+module.exports = {
+  createLogger
+};

package/src/ingestor.js

@@ -0,0 +1,55 @@
+const os = require("os");
+const fs = require("fs");
+const path = require("path");
+const { spawn } = require("child_process");
+
+function resolveBinary() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  let binDir, binName;
+
+  if (platform === "win32") {
+    binDir = "win";
+    binName = "ingestor-win.exe";
+  } else if (platform === "linux" && arch === "x64") {
+    binDir = "linux-amd64";
+    binName = "ingestor-linux";
+  } else if (platform === "darwin" && arch === "arm64") {
+    binDir = "darwin-arm64";
+    binName = "ingestor-darwin";
+  } else {
+    throw new Error(`Unsupported platform: ${platform} ${arch}`);
+  }
+
+  const pkgRoot = path.resolve(__dirname, "..");
+  const binPath = path.join(pkgRoot, "bin", binDir, binName);
+
+  if (!fs.existsSync(binPath)) {
+    throw new Error(`Ingestor binary not found at ${binPath}`);
+  }
+
+  return binPath;
+}
+
+function startIngestor(config) {
+  const bin = resolveBinary();
+  const cfgPath = path.join(process.cwd(), "ingestor.config.json");
+
+  fs.writeFileSync(cfgPath, JSON.stringify(config, null, 2));
+
+  const internalDir = path.join(process.cwd(), "logs", "_internal");
+  fs.mkdirSync(internalDir, { recursive: true });
+
+  const errLog = path.join(internalDir, "ingestor.err.log");
+
+  const proc = spawn(bin, [cfgPath], {
+    windowsHide: true,
+    stdio: ["ignore", "ignore", fs.openSync(errLog, "a")],
+    detached: true
+  });
+
+  proc.unref();
+}
+
+module.exports = { startIngestor };

package/src/logger.js

@@ -0,0 +1,19 @@
+const { BaseLogger } = require("@log-ingestor/core");
+const { startIngestor } = require("./ingestor");
+const { buildIngestorConfig } = require("./config");
+
+class Logger extends BaseLogger {
+  constructor(options) {
+    super(options);
+
+    const ingestorConfig = buildIngestorConfig({
+      logDir: options.logging?.logDir || "./logs",
+      db: options.db,
+      batch: options.batch
+    });
+
+    startIngestor(ingestorConfig);
+  }
+}
+
+module.exports = { Logger };

package/index.js

@@ -1 +0,0 @@
-module.exports = {};