wickra 0.1.2

package/README.md

@@ -0,0 +1,45 @@
+# @wickra/wickra
+
+Node.js bindings for the Wickra streaming-first technical indicators library.
+
+## Install
+
+Once published, install per platform via the precompiled native package:
+
+```bash
+npm install @wickra/wickra
+```
+
+## Build from source
+
+```bash
+cd bindings/node
+npm install
+npm run build
+npm test
+```
+
+The native module is built via [napi-rs](https://napi.rs/). The build script
+produces a `wickra.<platform>-<arch>.node` binary in the package root that
+`index.js` loads at runtime.
+
+## Usage
+
+```js
+import { SMA, RSI, MACD, version } from '@wickra/wickra';
+
+console.log('wickra', version());
+
+// Batch:
+const prices = Array.from({ length: 1000 }, (_, i) => 100 + Math.sin(i * 0.1) * 5);
+const rsi = new RSI(14).batch(prices);
+
+// Streaming:
+const macd = new MACD(12, 26, 9);
+for (const p of livePriceStream) {
+  const v = macd.update(p);
+  if (v && v.histogram > 0) console.log('bullish crossover candidate');
+}
+```
+
+See `index.d.ts` for the full TypeScript surface.

package/index.js

@@ -0,0 +1,50 @@
+/* eslint-disable */
+/* prettier-ignore */
+// Platform-aware loader for the Wickra Node native binding.
+//
+// In production (after `npm install wickra`) the actual `.node` binary
+// lives inside a per-platform subpackage that npm installs as an
+// optional dependency — e.g. `wickra-linux-x64-gnu`. In development
+// (after `napi build --platform`) the binary sits next to this file.
+// We try the local path first and fall back to the subpackage so the
+// same loader works in both modes.
+
+const { platform, arch } = process;
+const { join } = require('node:path');
+const { existsSync } = require('node:fs');
+
+const TARGETS = {
+  'linux-x64': 'linux-x64-gnu',
+  'darwin-x64': 'darwin-x64',
+  'darwin-arm64': 'darwin-arm64',
+  'win32-x64': 'win32-x64-msvc',
+};
+
+function load() {
+  const key = `${platform}-${arch}`;
+  const target = TARGETS[key];
+  if (!target) {
+    throw new Error(
+      `wickra: this platform/architecture combination is not supported (${key}). ` +
+        'Open an issue at https://github.com/kingchenc/wickra/issues with your platform details.'
+    );
+  }
+
+  const localBinary = join(__dirname, `wickra.${target}.node`);
+  if (existsSync(localBinary)) {
+    return require(localBinary);
+  }
+
+  try {
+    return require(`wickra-${target}`);
+  } catch (err) {
+    throw new Error(
+      `wickra: failed to load the native binding for ${key}. ` +
+        `Expected either ${localBinary} or the wickra-${target} package to be installed. ` +
+        `Run \`npm install\` again, or build from source with \`npm run build\`. ` +
+        `Underlying error: ${err.message}`
+    );
+  }
+}
+
+module.exports = load();

package/npm/darwin-arm64/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "wickra-darwin-arm64",
+  "version": "0.1.2",
+  "description": "Native binding for wickra (macOS Apple Silicon). Installed automatically as an optional dependency of wickra on matching platforms.",
+  "main": "wickra.darwin-arm64.node",
+  "files": [
+    "wickra.darwin-arm64.node"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">= 16"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingchenc/wickra"
+  },
+  "homepage": "https://github.com/kingchenc/wickra"
+}

package/npm/darwin-x64/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "wickra-darwin-x64",
+  "version": "0.1.2",
+  "description": "Native binding for wickra (macOS Intel). Installed automatically as an optional dependency of wickra on matching platforms.",
+  "main": "wickra.darwin-x64.node",
+  "files": [
+    "wickra.darwin-x64.node"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">= 16"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingchenc/wickra"
+  },
+  "homepage": "https://github.com/kingchenc/wickra"
+}

package/npm/linux-x64-gnu/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "wickra-linux-x64-gnu",
+  "version": "0.1.2",
+  "description": "Native binding for wickra (linux x64 GNU). Installed automatically as an optional dependency of wickra on matching platforms.",
+  "main": "wickra.linux-x64-gnu.node",
+  "files": [
+    "wickra.linux-x64-gnu.node"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">= 16"
+  },
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "libc": [
+    "glibc"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingchenc/wickra"
+  },
+  "homepage": "https://github.com/kingchenc/wickra"
+}

package/npm/win32-x64-msvc/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "wickra-win32-x64-msvc",
+  "version": "0.1.2",
+  "description": "Native binding for wickra (Windows x64 MSVC). Installed automatically as an optional dependency of wickra on matching platforms.",
+  "main": "wickra.win32-x64-msvc.node",
+  "files": [
+    "wickra.win32-x64-msvc.node"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">= 16"
+  },
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingchenc/wickra"
+  },
+  "homepage": "https://github.com/kingchenc/wickra"
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "wickra",
+  "version": "0.1.2",
+  "description": "Streaming-first technical indicators: incremental, fast, install-free. Node bindings powered by Rust.",
+  "author": "kingchenc <kingchencp@gmail.com>",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "trading",
+    "indicators",
+    "technical-analysis",
+    "ta-lib",
+    "finance",
+    "streaming",
+    "rust"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingchenc/wickra"
+  },
+  "bugs": {
+    "url": "https://github.com/kingchenc/wickra/issues"
+  },
+  "homepage": "https://github.com/kingchenc/wickra",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "npm",
+    "*.node"
+  ],
+  "napi": {
+    "name": "wickra",
+    "triples": {
+      "defaults": false,
+      "additional": [
+        "x86_64-unknown-linux-gnu",
+        "x86_64-apple-darwin",
+        "aarch64-apple-darwin",
+        "x86_64-pc-windows-msvc"
+      ]
+    }
+  },
+  "engines": {
+    "node": ">= 16"
+  },
+  "optionalDependencies": {
+    "wickra-linux-x64-gnu": "0.1.2",
+    "wickra-darwin-x64": "0.1.2",
+    "wickra-darwin-arm64": "0.1.2",
+    "wickra-win32-x64-msvc": "0.1.2"
+  },
+  "scripts": {
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "artifacts": "napi artifacts",
+    "universal": "napi universal",
+    "version": "napi version",
+    "test": "node --test __tests__/"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.0"
+  }
+}