@liively/swc-jest-coverage-nestjs-plugin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Liively Pty Ltd
+
+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,145 @@
+# @liively/swc-jest-coverage-nestjs-plugin
+
+SWC plugin that eliminates phantom coverage targets generated by NestJS decorator transpilation, giving you accurate function and branch coverage when using `@swc/jest`.
+
+## Problem
+
+When SWC transpiles TypeScript decorators it generates wrapper code — arrow functions for type parameters, `_ts_metadata` calls for reflection — that Istanbul/Jest counts as coverable targets. These targets can never be "called" by your tests, so your coverage reports show artificially low numbers (e.g. 64% function coverage on a fully-tested resolver).
+
+This plugin transforms the generated code at compile time so that Istanbul sees only the targets that correspond to real application logic.
+
+## Installation
+
+```bash
+npm install --save-dev @liively/swc-jest-coverage-nestjs-plugin
+# or
+pnpm add --save-dev @liively/swc-jest-coverage-nestjs-plugin
+# or
+yarn add --dev @liively/swc-jest-coverage-nestjs-plugin
+```
+
+## Configuration
+
+Add the plugin to your Jest SWC config (usually in `jest.config.js` or `jest.config.ts`):
+
+```js
+// jest.config.js
+module.exports = {
+  transform: {
+    '^.+\\.tsx?$': [
+      '@swc/jest',
+      {
+        jsc: {
+          experimental: {
+            plugins: [
+              ['@liively/swc-jest-coverage-nestjs-plugin', {
+                // All options shown with their defaults:
+                // unwrapTypeArrows: true,
+                // unwrapDecoratorArrows: true,
+                // stripMetadata: false,
+              }],
+            ],
+          },
+        },
+      },
+    ],
+  },
+};
+```
+
+> **Important:** After installing or updating the plugin, clear the Jest cache:
+> ```bash
+> npx jest --clearCache
+> ```
+
+### Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `unwrapTypeArrows` | `boolean` | `true` | Unwrap `type: () => String` → `type: String` in decorator option objects |
+| `unwrapDecoratorArrows` | `boolean` | `true` | Unwrap `ResolveField(() => String)` → `ResolveField(String)` in decorator call arguments |
+| `stripMetadata` | `boolean` | `false` | Remove `_ts_metadata("design:type", ...)` calls from `_ts_decorate` arrays |
+
+> **Note:** `stripMetadata` defaults to `false` because `@nestjs/mongoose` depends on `design:type` metadata at runtime for schema type inference. Only enable it if your project does not use Mongoose (or any other library that reads `design:type` metadata).
+
+## How It Works
+
+The plugin applies up to three transforms on `_ts_decorate([ ... ])` call sites:
+
+### 1. Unwrap decorator arrow arguments (`unwrapDecoratorArrows`)
+
+```js
+// Before — Istanbul counts the arrow as a coverable function
+(0, _graphql.Query)(() => Menu)
+
+// After — no phantom function target
+(0, _graphql.Query)(Menu)
+```
+
+### 2. Unwrap type property arrows (`unwrapTypeArrows`)
+
+```js
+// Before
+_ts_param(0, (0, _graphql.Args)('id', { type: () => String }))
+
+// After
+_ts_param(0, (0, _graphql.Args)('id', { type: String }))
+```
+
+### 3. Strip metadata calls (`stripMetadata`)
+
+```js
+// Before
+_ts_decorate([
+    (0, _graphql.Query)(),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [Object]),
+    _ts_metadata("design:returntype", Promise)
+], Resolver.prototype, "method", null);
+
+// After
+_ts_decorate([
+    (0, _graphql.Query)()
+], Resolver.prototype, "method", null);
+```
+
+Only "simple" arrows are unwrapped — the body must be an identifier (`String`), member expression (`SomeModule.Type`), or array expression (`[String]`). Complex arrows with block bodies are left untouched to avoid changing runtime behavior.
+
+## Compatibility
+
+| Dependency | Version |
+|---|---|
+| `@swc/core` | `>= 1.15.0` (swc_core v50 plugin ABI) |
+| Node.js | `>= 18` |
+| Jest | `>= 29` with `@swc/jest` |
+
+### `swc_core` version compatibility
+
+| Plugin version | `swc_core` | `@swc/core` |
+|---|---|---|
+| `0.1.x` | `50` | `>= 1.15.0` |
+
+## Development
+
+```bash
+# Run tests
+cargo test
+
+# Build WASM (debug)
+cargo build --target wasm32-wasip1
+
+# Build WASM (release)
+bash build.sh
+```
+
+### Adding test fixtures
+
+Each fixture is a directory under `tests/fixture/` containing:
+
+- `input.js` — the SWC-transpiled code to transform
+- `output.js` — the expected output after transformation
+- `config.json` (optional) — plugin options to use instead of defaults
+
+## License
+
+[MIT](LICENSE)

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@liively/swc-jest-coverage-nestjs-plugin",
+  "version": "0.1.0",
+  "description": "SWC plugin to transform NestJS decorator metadata for accurate Jest coverage",
+  "main": "swc_jest_coverage_nestjs_plugin.wasm",
+  "files": [
+    "swc_jest_coverage_nestjs_plugin.wasm"
+  ],
+  "scripts": {
+    "build": "bash build.sh",
+    "build:dev": "cargo build --target wasm32-wasip1 && cp target/wasm32-wasip1/debug/swc_jest_coverage_nestjs_plugin.wasm .",
+    "build:release": "bash build.sh",
+    "prepublishOnly": "bash build.sh"
+  },
+  "keywords": [
+    "swc",
+    "plugin",
+    "nestjs",
+    "jest",
+    "coverage",
+    "decorators"
+  ],
+  "license": "MIT",
+  "directories": {
+    "test": "tests"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LIIVE-LY/swc-jest-coverage-nestjs-plugin.git"
+  },
+  "author": "Liively",
+  "bugs": {
+    "url": "https://github.com/LIIVE-LY/swc-jest-coverage-nestjs-plugin/issues"
+  },
+  "homepage": "https://github.com/LIIVE-LY/swc-jest-coverage-nestjs-plugin#readme"
+}