@porulle/adapter-tax-manual 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# @porulle/adapter-tax-manual
+
+`TaxAdapter` that applies a single flat rate. For stores that need basic tax math without a third-party service.
+
+## Usage
+
+```ts
+import { defineConfig } from "@porulle/core";
+import { manualTaxAdapter } from "@porulle/adapter-tax-manual";
+
+export default defineConfig({
+  tax: {
+    adapter: manualTaxAdapter({
+      rate: 0.08,                  // 8% flat
+      shippingTaxable: true,       // default: true
+    }),
+  },
+  // …
+});
+```
+
+## What it does
+
+`calculateTax` applies the rate to the line-item subtotal (post-discount) plus shipping if `shippingTaxable` is true. `reportTransaction` and `voidTransaction` are no-ops — there's nothing to file.
+
+## When to use this
+
+- Single-jurisdiction stores
+- Local development / tests
+- Markets where you handle filing manually outside the framework
+
+For multi-jurisdiction tax calculation and automated filing, use `@porulle/adapter-taxjar` (or build a new adapter for your jurisdiction's preferred service).

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { type TaxAdapter } from "@porulle/core";
+export interface ManualTaxAdapterOptions {
+    rate: number;
+    shippingTaxable?: boolean;
+}
+export declare function manualTaxAdapter(options: ManualTaxAdapterOptions): TaxAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,UAAU,EAA6B,MAAM,eAAe,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAUD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU,CAqB7E"}

package/dist/index.js

@@ -0,0 +1,26 @@
+import { Ok } from "@porulle/core";
+function taxableSubtotal(params, shippingTaxable) {
+    const lineTaxable = params.lineItems.reduce((sum, lineItem) => sum + lineItem.unitPrice * lineItem.quantity - (lineItem.discount ?? 0), 0);
+    return lineTaxable + (shippingTaxable ? params.shippingAmount : 0);
+}
+export function manualTaxAdapter(options) {
+    const rate = Math.max(0, options.rate);
+    return {
+        providerId: "tax-manual",
+        async calculateTax(params) {
+            const taxableAmount = taxableSubtotal(params, options.shippingTaxable ?? true);
+            const amountToCollect = Math.round(taxableAmount * rate);
+            return Ok({
+                amountToCollect,
+                taxableAmount,
+                rate,
+            });
+        },
+        async reportTransaction(params) {
+            return Ok({ transactionId: params.transactionId });
+        },
+        async voidTransaction(params) {
+            return Ok({ transactionId: params.transactionId });
+        },
+    };
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@porulle/adapter-tax-manual",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.build.tsbuildinfo && tsc -p tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 1000",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@porulle/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@repo/eslint-config": "*",
+    "@repo/typescript-config": "*",
+    "@types/node": "^24.5.2",
+    "eslint": "^9.39.1",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md"
+  ],
+  "description": "TaxAdapter that applies a single flat rate. For stores that need basic tax math without a third-party service.",
+  "homepage": "https://porulle-docs.vercel.app",
+  "bugs": {
+    "url": "https://github.com/asyncdotengineering/porulle/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asyncdotengineering/porulle.git",
+    "directory": "packages/adapters/adapter-tax-manual"
+  },
+  "author": "Porulle contributors"
+}

package/src/index.ts

@@ -0,0 +1,37 @@
+import { Ok, type TaxAdapter, type TaxCalculationParams } from "@porulle/core";
+
+export interface ManualTaxAdapterOptions {
+  rate: number;
+  shippingTaxable?: boolean;
+}
+
+function taxableSubtotal(params: TaxCalculationParams, shippingTaxable: boolean): number {
+  const lineTaxable = params.lineItems.reduce(
+    (sum, lineItem) => sum + lineItem.unitPrice * lineItem.quantity - (lineItem.discount ?? 0),
+    0,
+  );
+  return lineTaxable + (shippingTaxable ? params.shippingAmount : 0);
+}
+
+export function manualTaxAdapter(options: ManualTaxAdapterOptions): TaxAdapter {
+  const rate = Math.max(0, options.rate);
+
+  return {
+    providerId: "tax-manual",
+    async calculateTax(params) {
+      const taxableAmount = taxableSubtotal(params, options.shippingTaxable ?? true);
+      const amountToCollect = Math.round(taxableAmount * rate);
+      return Ok({
+        amountToCollect,
+        taxableAmount,
+        rate,
+      });
+    },
+    async reportTransaction(params) {
+      return Ok({ transactionId: params.transactionId });
+    },
+    async voidTransaction(params) {
+      return Ok({ transactionId: params.transactionId });
+    },
+  };
+}