dspx 0.1.1-alpha.0

package/.github/workflows/ci.yml

@@ -0,0 +1,185 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  # Test on Ubuntu with Redis service
+  test-ubuntu:
+    name: Test on Ubuntu - Node ${{ matrix.node-version }} (with Redis)
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: [18.x, 20.x, 22.x]
+
+    services:
+      redis:
+        image: redis:7-alpine
+        ports:
+          - 6379:6379
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: "npm"
+
+      - name: Install build tools
+        run: sudo apt-get update && sudo apt-get install -y build-essential python3 redis-tools
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build native addon
+        run: npm run build
+
+      - name: Copy native addon to src/build
+        run: |
+          mkdir -p src/build
+          cp build/Release/dspx.node src/build/
+
+      - name: Wait for Redis
+        run: |
+          timeout 30 bash -c 'until redis-cli ping; do sleep 1; done'
+          echo "✅ Redis is ready"
+
+      - name: Run all tests (with Redis integration tests)
+        run: npm test
+        env:
+          REDIS_URL: redis://localhost:6379
+
+      - name: Generate coverage report
+        if: matrix.node-version == '20.x'
+        run: npm run test:coverage || echo "⚠️ Coverage not configured"
+        continue-on-error: true
+
+      - name: Upload coverage to Codecov
+        if: matrix.node-version == '20.x'
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage/lcov.info
+          fail_ci_if_error: false
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  # Test on Windows and macOS (Redis optional)
+  test-other:
+    name: Test on ${{ matrix.os }} - Node ${{ matrix.node-version }}
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, macos-latest]
+        node-version: [18.x, 20.x, 22.x]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: "npm"
+
+      - name: Setup Redis (macOS)
+        if: matrix.os == 'macos-latest'
+        run: |
+          brew install redis
+          brew services start redis
+          sleep 2
+        continue-on-error: true
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build native addon
+        run: npm run build
+
+      - name: Copy native addon to src/build
+        shell: bash
+        run: |
+          mkdir -p src/build
+          cp build/Release/dspx.node src/build/
+
+      - name: Run all tests (Redis tests will skip if unavailable)
+        run: npm test
+        env:
+          REDIS_URL: redis://localhost:6379
+
+  prebuild:
+    name: Prebuild ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    needs: [test-ubuntu, test-other]
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+          cache: "npm"
+
+      - name: Install build tools (Linux)
+        if: ${{ matrix.os == 'ubuntu-latest' }}
+        run: sudo apt-get update && sudo apt-get install -y build-essential python3
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build prebuilds
+        run: npm run prebuildify
+
+      - name: Upload prebuilds
+        uses: actions/upload-artifact@v4
+        with:
+          name: prebuilds-${{ matrix.os }}
+          path: prebuilds/
+          retention-days: 90
+
+  lint:
+    name: Lint and Type Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Run ESLint (if configured)
+        run: npx eslint src --max-warnings=0 || echo "⚠️ ESLint not configured, skipping"
+        continue-on-error: true
+
+      - name: TypeScript type check
+        run: npx tsx --noEmit || echo "⚠️ TypeScript check skipped"
+        continue-on-error: true

package/.vscode/c_cpp_properties.json

@@ -0,0 +1,17 @@
+{
+  "configurations": [
+    {
+      "name": "Win32",
+      "includePath": [
+        "${workspaceFolder}/**",
+        "${workspaceFolder}/node_modules/node-addon-api"
+      ],
+      "defines": ["_DEBUG", "UNICODE", "_UNICODE"],
+      "windowsSdkVersion": "10.0.19041.0",
+      "cStandard": "c17",
+      "cppStandard": "c++17",
+      "intelliSenseMode": "windows-clang-x64"
+    }
+  ],
+  "version": 4
+}

package/.vscode/settings.json

@@ -0,0 +1,68 @@
+{
+  "files.associations": {
+    ".fantomasignore": "ignore",
+    "algorithm": "cpp",
+    "limits": "cpp",
+    "utility": "cpp",
+    "xutility": "cpp",
+    "vector": "cpp",
+    "numeric": "cpp",
+    "memory": "cpp",
+    "atomic": "cpp",
+    "bit": "cpp",
+    "cctype": "cpp",
+    "charconv": "cpp",
+    "clocale": "cpp",
+    "cmath": "cpp",
+    "compare": "cpp",
+    "concepts": "cpp",
+    "cstdarg": "cpp",
+    "cstddef": "cpp",
+    "cstdint": "cpp",
+    "cstdio": "cpp",
+    "cstdlib": "cpp",
+    "cstring": "cpp",
+    "ctime": "cpp",
+    "cwchar": "cpp",
+    "deque": "cpp",
+    "exception": "cpp",
+    "format": "cpp",
+    "functional": "cpp",
+    "initializer_list": "cpp",
+    "ios": "cpp",
+    "iosfwd": "cpp",
+    "iostream": "cpp",
+    "istream": "cpp",
+    "iterator": "cpp",
+    "list": "cpp",
+    "locale": "cpp",
+    "mutex": "cpp",
+    "new": "cpp",
+    "optional": "cpp",
+    "ostream": "cpp",
+    "ratio": "cpp",
+    "stdexcept": "cpp",
+    "stop_token": "cpp",
+    "streambuf": "cpp",
+    "string": "cpp",
+    "system_error": "cpp",
+    "thread": "cpp",
+    "tuple": "cpp",
+    "type_traits": "cpp",
+    "typeinfo": "cpp",
+    "unordered_map": "cpp",
+    "xfacet": "cpp",
+    "xhash": "cpp",
+    "xiosbase": "cpp",
+    "xlocale": "cpp",
+    "xlocbuf": "cpp",
+    "xlocinfo": "cpp",
+    "xlocmes": "cpp",
+    "xlocmon": "cpp",
+    "xlocnum": "cpp",
+    "xloctime": "cpp",
+    "xmemory": "cpp",
+    "xstring": "cpp",
+    "xtr1common": "cpp"
+  }
+}

package/.vscode/tasks.json

@@ -0,0 +1,28 @@
+{
+    "tasks": [
+        {
+            "type": "cppbuild",
+            "label": "C/C++: cl.exe build active file",
+            "command": "cl.exe",
+            "args": [
+                "/Zi",
+                "/EHsc",
+                "/nologo",
+                "/Fe${fileDirname}\\${fileBasenameNoExtension}.exe",
+                "${file}"
+            ],
+            "options": {
+                "cwd": "${fileDirname}"
+            },
+            "problemMatcher": [
+                "$msCompile"
+            ],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            },
+            "detail": "Task generated by Debugger."
+        }
+    ],
+    "version": "2.0.0"
+}

package/DISCLAIMER.md

@@ -0,0 +1,32 @@
+# Medical Device Disclaimer
+
+**NOT FOR CLINICAL USE**
+
+This software is provided for research, development, and educational purposes only.
+
+⚠️ **Important Limitations:**
+
+- This library has NOT been validated for medical diagnosis or treatment
+- NOT FDA cleared, CE marked, or approved by any regulatory body
+- NOT intended for use in medical devices or life-critical applications
+- NO clinical validation studies have been performed
+- NOT a substitute for professional medical advice or certified medical equipment
+
+**For Developers:**
+
+If you intend to use this software in medical devices or clinical applications:
+
+- Consult with regulatory experts (FDA, MDR, IEC 62304)
+- Conduct appropriate validation and verification studies
+- Obtain necessary certifications and clearances
+- Implement proper risk management per ISO 14971
+
+**Liability:**
+
+The authors and contributors assume no liability for any consequences arising
+from the use of this software in medical or life-critical applications.
+
+---
+
+For questions about clinical/regulatory use, please consult qualified regulatory
+affairs professionals.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alan Kochukalam George
+
+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.