@f-o-t/money 1.1.1 → 1.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FOT (F-O-T)
+
+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

@@ -482,6 +482,153 @@ const result = evaluator.evaluate(
 // - money_positive, money_negative, money_zero
 ```
 
+### Rules Engine Integration
+
+Use money operators with `@f-o-t/rules-engine` to build complex financial business rules:
+
+```typescript
+import { createEngine } from "@f-o-t/rules-engine";
+import { moneyOperators } from "@f-o-t/money/plugins/operators";
+import { z } from "zod";
+
+// Define consequence types for your rules
+const TransactionConsequences = {
+  approve: z.object({ approved: z.boolean() }),
+  require_review: z.object({ reason: z.string() }),
+  reject: z.object({ reason: z.string() }),
+  apply_fee: z.object({ amount: z.string(), currency: z.string() }),
+};
+
+// Create engine with money operators
+const engine = createEngine({
+  operators: moneyOperators,
+  consequences: TransactionConsequences,
+});
+
+// Add rules for high-value transactions
+engine.addRule({
+  name: "high-value-transaction-review",
+  priority: 100,
+  conditions: {
+    id: "g1",
+    operator: "AND",
+    conditions: [
+      {
+        id: "c1",
+        type: "custom",
+        field: "amount",
+        operator: "money_gt",
+        value: { amount: "10000.00", currency: "BRL" },
+      },
+    ],
+  },
+  consequences: [
+    {
+      type: "require_review",
+      payload: { reason: "High value transaction requires approval" },
+    },
+  ],
+});
+
+// Add rules for transaction fees
+engine.addRule({
+  name: "pix-fee-waiver",
+  priority: 50,
+  conditions: {
+    id: "g2",
+    operator: "AND",
+    conditions: [
+      {
+        id: "c1",
+        type: "string",
+        field: "paymentMethod",
+        operator: "eq",
+        value: "pix",
+      },
+      {
+        id: "c2",
+        type: "custom",
+        field: "amount",
+        operator: "money_lt",
+        value: { amount: "100.00", currency: "BRL" },
+      },
+    ],
+  },
+  consequences: [
+    {
+      type: "apply_fee",
+      payload: { amount: "0.00", currency: "BRL" },
+    },
+  ],
+});
+
+// Evaluate rules
+const result = await engine.evaluate({
+  amount: { amount: "15000.00", currency: "BRL" },
+  paymentMethod: "pix",
+});
+
+console.log(result.matchedRules);    // Rules that matched
+console.log(result.consequences);    // Actions to take
+```
+
+**Complex multi-condition rules:**
+
+```typescript
+// Discount eligibility with money conditions
+engine.addRule({
+  name: "volume-discount",
+  conditions: {
+    id: "g1",
+    operator: "AND",
+    conditions: [
+      {
+        id: "c1",
+        type: "custom",
+        field: "cartTotal",
+        operator: "money_between",
+        value: [
+          { amount: "500.00", currency: "BRL" },
+          { amount: "2000.00", currency: "BRL" },
+        ],
+      },
+      {
+        id: "c2",
+        type: "custom",
+        field: "customerLifetimeValue",
+        operator: "money_gt",
+        value: { amount: "5000.00", currency: "BRL" },
+      },
+      {
+        id: "c3",
+        type: "boolean",
+        field: "isPremiumMember",
+        operator: "eq",
+        value: true,
+      },
+    ],
+  },
+  consequences: [
+    {
+      type: "apply_discount",
+      payload: { percentage: 15 },
+    },
+  ],
+});
+```
+
+**Available money operators for rules:**
+- `money_eq` - Equal to
+- `money_neq` - Not equal to  
+- `money_gt` - Greater than
+- `money_gte` - Greater than or equal
+- `money_lt` - Less than
+- `money_lte` - Less than or equal
+- `money_between` - Between two values (inclusive)
+- `money_positive` - Is positive (> 0)
+- `money_negative` - Is negative (< 0)
+- `money_zero` - Is zero
+
 ### Custom Currencies
 
 Register currencies not in ISO 4217:

package/package.json

@@ -1,72 +1,48 @@
 {
-   "bugs": {
-      "url": "https://github.com/F-O-T/montte-nx/issues"
+   "name": "@f-o-t/money",
+   "version": "1.2.2",
+   "type": "module",
+   "files": [
+      "dist"
+   ],
+   "main": "./dist/index.js",
+   "types": "./dist/index.d.ts",
+   "exports": {
+      ".": {
+         "types": "./dist/index.d.ts",
+         "default": "./dist/index.js"
+      },
+      "./plugins/operators": {
+         "types": "./dist/plugins/operators/index.d.ts",
+         "default": "./dist/plugins/operators/index.js"
+      }
+   },
+   "scripts": {
+      "build": "bun x --bun fot build",
+      "test": "bun x --bun fot test",
+      "lint": "bun x --bun fot lint",
+      "format": "bun x --bun fot format",
+      "typecheck": "bun x --bun fot typecheck"
    },
    "dependencies": {
-      "@f-o-t/condition-evaluator": "2.0.0",
-      "zod": "4.3.4"
+      "@f-o-t/bigint": "^1.0.0",
+      "zod": "^4.3.6"
    },
-   "description": "Type-safe money handling library with BigInt precision and ISO 4217 currency support",
    "devDependencies": {
-      "@biomejs/biome": "2.3.10",
-      "@types/bun": "1.3.5",
-      "bumpp": "10.3.2",
-      "bunup": "0.16.11",
-      "typescript": "5.9.3"
+      "@f-o-t/cli": "^1.0.0",
+      "@f-o-t/config": "^1.0.0"
    },
-   "exports": {
-      ".": {
-         "bun": "./src/index.ts",
-         "import": {
-            "default": "./dist/index.js",
-            "types": "./dist/index.d.ts"
-         },
-         "types": "./src/index.ts"
-      },
-      "./operators": {
-         "bun": "./src/operators/index.ts",
-         "import": {
-            "default": "./dist/operators/index.js",
-            "types": "./dist/operators/index.d.ts"
-         },
-         "types": "./src/operators/index.ts"
-      },
-      "./package.json": "./package.json"
-   },
-   "files": [
-      "dist"
-   ],
-   "homepage": "https://github.com/F-O-T/montte-nx/blob/master/libraries/money",
-   "license": "MIT",
-   "module": "./dist/index.js",
-   "name": "@f-o-t/money",
    "peerDependencies": {
-      "typescript": ">=4.5.0"
+      "@f-o-t/condition-evaluator": "^2.0.2"
    },
    "peerDependenciesMeta": {
-      "typescript": {
+      "@f-o-t/condition-evaluator": {
          "optional": true
       }
    },
-   "private": false,
-   "publishConfig": {
-      "access": "public"
-   },
    "repository": {
       "type": "git",
-      "url": "https://github.com/F-O-T/montte-nx.git"
-   },
-   "scripts": {
-      "build": "bunup",
-      "check": "biome check --write .",
-      "dev": "bunup --watch",
-      "release": "bumpp --commit --push --tag",
-      "test": "bun test",
-      "test:coverage": "bun test --coverage",
-      "test:watch": "bun test --watch",
-      "typecheck": "tsc"
-   },
-   "type": "module",
-   "types": "./dist/index.d.ts",
-   "version": "1.1.1"
+      "url": "https://github.com/F-O-T/libraries.git",
+      "directory": "libraries/money"
+   }
 }