@ajitems/devtools 0.1.0 → 0.3.0

package/README.md

@@ -0,0 +1,70 @@
+# devtools
+
+Headless engines for common developer utilities, implemented in Rust and compiled to **WebAssembly**. Use them in the browser or any JS runtime that can load WASM (for example via [wasm-bindgen](https://github.com/rustwasm/wasm-bindgen)).
+
+## Install
+
+```bash
+npm install @ajitems/devtools
+```
+
+## Usage
+
+The package is built with `wasm-pack` for the **`web`** target. Initialize the module once, then call the exported functions. Each engine returns a JSON-shaped object with `ok`, optional `data`, and optional `error` (see `ToolResult` in the sources).
+
+```javascript
+import init, { base64_encode, jwt_decode } from "@ajitems/devtools";
+
+await init(); // WASM start (e.g. panic hook)
+
+const encoded = base64_encode("hello", false);
+// { ok: true, data: { output: "...", inputBytes: 5, outputBytes: ... }, error: null }
+
+const decoded = jwt_decode("eyJ...");
+// { ok: true | false, data: ..., error: ... }
+```
+
+Exact import paths depend on how you bundle or serve the `.wasm` file; follow the [wasm-pack web workflow](https://rustwasm.github.io/docs/wasm-pack/tutorials/npm-browser-packages/index.html) for your toolchain.
+
+## What’s included
+
+| Area | Functions (high level) |
+|------|-------------------------|
+| Encoding | `base64_encode`, `base64_decode` |
+| JSON | `json_format`, `json_diff` |
+| JWT | `jwt_decode` |
+| URL | `url_process` |
+| Regex | `regex_test` |
+| Env files | `env_validate` |
+| Docker | `docker_convert` |
+| Tokens / prompts | `tokens_estimate`, `prompt_analyse` |
+| SLA | `sla_calculate` |
+| Payroll / tax (India-oriented) | `ctc_calculate`, `freelance_calculate`, `gst_calculate`, `gstin_validate`, `pan_validate` |
+| India utilities | `validate_ifsc`, `estimate_cloud_cost`, `calculate_working_days`, `calculate_automation_roi`, `calculate_sprint_velocity`, `calculate_retry_budget` |
+
+With the **`cron`** feature (enabled in published builds): `cron_parse`.
+
+## Build from source
+
+Prerequisites: stable Rust, `wasm32-unknown-unknown`, and [wasm-pack](https://rustwasm.github.io/wasm-pack/).
+
+```bash
+rustup target add wasm32-unknown-unknown
+wasm-pack build --target web --release -- --features cron
+cp package.npm.json pkg/package.json
+```
+
+Optional Cargo features:
+
+- **`cron`** — cron expression parsing (`cron_parse`).
+- **`minify`** — pulls in minify/CSS dependencies (see `Cargo.toml`; not required for the default npm build).
+
+CI runs `cargo clippy`, `cargo fmt --check`, `cargo test --all-features`, and the WASM build above.
+
+## Publish
+
+Releases are published to npm when a version tag `v*` is pushed (see `.github/workflows/publish.yml`).
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/devtools.d.ts

@@ -5,6 +5,16 @@ export function base64_decode(input: string, url_safe: boolean): any;
 
 export function base64_encode(input: string, url_safe: boolean): any;
 
+/**
+ * WASM: JSON `CtcInput` → JSON `ToolResult<CtcResult>`.
+ */
+export function calculateCtc(input: any): any;
+
+/**
+ * WASM: JSON [`SalaryHikeInput`] → JSON [`ToolResult<SalaryHikeResult>`].
+ */
+export function calculateHike(input: any): any;
+
 export function calculate_automation_roi(input: any): any;
 
 export function calculate_retry_budget(input: any): any;
@@ -13,6 +23,11 @@ export function calculate_sprint_velocity(input: any): any;
 
 export function calculate_working_days(input: any): any;
 
+/**
+ * WASM: JSON [`RegimeCompareInput`] → JSON [`ToolResult<RegimeCompareResult>`].
+ */
+export function compareTaxRegimes(input: any): any;
+
 export function cron_parse(expression: string): any;
 
 export function ctc_calculate(annual_ctc: number, is_metro: boolean, regime: string): any;
@@ -57,10 +72,13 @@ export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly base64_decode: (a: number, b: number, c: number) => number;
     readonly base64_encode: (a: number, b: number, c: number) => number;
+    readonly calculateCtc: (a: number) => number;
+    readonly calculateHike: (a: number) => number;
     readonly calculate_automation_roi: (a: number) => number;
     readonly calculate_retry_budget: (a: number) => number;
     readonly calculate_sprint_velocity: (a: number) => number;
     readonly calculate_working_days: (a: number) => number;
+    readonly compareTaxRegimes: (a: number) => number;
     readonly cron_parse: (a: number, b: number) => number;
     readonly ctc_calculate: (a: number, b: number, c: number, d: number) => number;
     readonly docker_convert: (a: number, b: number) => number;

package/devtools.js

@@ -24,6 +24,26 @@ export function base64_encode(input, url_safe) {
     return takeObject(ret);
 }
 
+/**
+ * WASM: JSON `CtcInput` → JSON `ToolResult<CtcResult>`.
+ * @param {any} input
+ * @returns {any}
+ */
+export function calculateCtc(input) {
+    const ret = wasm.calculateCtc(addHeapObject(input));
+    return takeObject(ret);
+}
+
+/**
+ * WASM: JSON [`SalaryHikeInput`] → JSON [`ToolResult<SalaryHikeResult>`].
+ * @param {any} input
+ * @returns {any}
+ */
+export function calculateHike(input) {
+    const ret = wasm.calculateHike(addHeapObject(input));
+    return takeObject(ret);
+}
+
 /**
  * @param {any} input
  * @returns {any}
@@ -60,6 +80,16 @@ export function calculate_working_days(input) {
     return takeObject(ret);
 }
 
+/**
+ * WASM: JSON [`RegimeCompareInput`] → JSON [`ToolResult<RegimeCompareResult>`].
+ * @param {any} input
+ * @returns {any}
+ */
+export function compareTaxRegimes(input) {
+    const ret = wasm.compareTaxRegimes(addHeapObject(input));
+    return takeObject(ret);
+}
+
 /**
  * @param {string} expression
  * @returns {any}
@@ -291,6 +321,13 @@ function __wbg_get_imports() {
             const ret = Number(getObject(arg0));
             return ret;
         },
+        __wbg_String_8564e559799eccda: function(arg0, arg1) {
+            const ret = String(getObject(arg1));
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
         __wbg___wbindgen_boolean_get_a86c216575a75c30: function(arg0) {
             const v = getObject(arg0);
             const ret = typeof(v) === 'boolean' ? v : undefined;

package/devtools_bg.wasm.d.ts

@@ -0,0 +1,36 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const base64_decode: (a: number, b: number, c: number) => number;
+export const base64_encode: (a: number, b: number, c: number) => number;
+export const calculateCtc: (a: number) => number;
+export const calculateHike: (a: number) => number;
+export const calculate_automation_roi: (a: number) => number;
+export const calculate_retry_budget: (a: number) => number;
+export const calculate_sprint_velocity: (a: number) => number;
+export const calculate_working_days: (a: number) => number;
+export const compareTaxRegimes: (a: number) => number;
+export const cron_parse: (a: number, b: number) => number;
+export const ctc_calculate: (a: number, b: number, c: number, d: number) => number;
+export const docker_convert: (a: number, b: number) => number;
+export const env_validate: (a: number, b: number) => number;
+export const estimate_cloud_cost: (a: number) => number;
+export const freelance_calculate: (a: number, b: number, c: number, d: number) => number;
+export const gst_calculate: (a: number, b: number, c: number, d: number, e: number) => number;
+export const gstin_validate: (a: number, b: number) => number;
+export const init: () => void;
+export const json_diff: (a: number, b: number, c: number, d: number) => number;
+export const json_format: (a: number, b: number, c: number) => number;
+export const jwt_decode: (a: number, b: number) => number;
+export const pan_validate: (a: number, b: number) => number;
+export const prompt_analyse: (a: number, b: number) => number;
+export const regex_test: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+export const sla_calculate: (a: number) => number;
+export const tokens_estimate: (a: number, b: number) => number;
+export const url_process: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+export const validate_ifsc: (a: number, b: number) => number;
+export const __wbindgen_export: (a: number, b: number) => number;
+export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export3: (a: number) => void;
+export const __wbindgen_export4: (a: number, b: number, c: number) => void;
+export const __wbindgen_start: () => void;

package/package.json

@@ -1,24 +1,35 @@
 {
   "name": "@ajitems/devtools",
-  "type": "module",
-  "collaborators": [
-    "Ajitem Sahasrabuddhe"
-  ],
+  "version": "0.3.0",
   "description": "Headless engines for common developer utilities. Compiled to WASM.",
-  "version": "0.1.0",
-  "license": "MIT",
+  "main": "devtools.js",
+  "types": "devtools.d.ts",
+  "files": [
+    "devtools_bg.wasm",
+    "devtools_bg.wasm.d.ts",
+    "devtools.js",
+    "devtools.d.ts",
+    "package.json"
+  ],
+  "sideEffects": false,
   "repository": {
     "type": "git",
     "url": "https://github.com/asahasrabuddhe/devtools"
   },
-  "files": [
-    "devtools_bg.wasm",
-    "devtools.js",
-    "devtools.d.ts"
+  "keywords": [
+    "devtools",
+    "wasm",
+    "webassembly",
+    "jwt",
+    "base64",
+    "regex",
+    "cron",
+    "json",
+    "prompt",
+    "docker",
+    "env",
+    "url"
   ],
-  "main": "devtools.js",
-  "types": "devtools.d.ts",
-  "sideEffects": [
-    "./snippets/*"
-  ]
-}
+  "author": "Ajitem Sahasrabuddhe",
+  "license": "MIT"
+}