@ajitems/devtools 0.1.0 → 0.2.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_bg.wasm.d.ts

@@ -0,0 +1,33 @@
+/* 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 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 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.2.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"
+}