@gp2f/server 0.1.7 → 0.1.8

package/README.md

@@ -72,6 +72,34 @@ async function main() {
 main().catch(console.error);
 ```
 
+### 3. Fluent Policy Builder
+
+Build policy ASTs with a chainable API instead of raw JSON objects:
+
+```typescript
+import { p } from '@gp2f/server';
+
+// Field equality
+const policy = p.field('/role').eq('admin');
+
+// Logical AND
+const policy = p.and(
+  p.field('/role').eq('clinician'),
+  p.exists('/patient_id'),
+);
+
+// Role allow-list
+const policy = p.field('/role').in(['admin', 'editor', 'reviewer']);
+
+// Numeric comparison
+const policy = p.field('/score').gte(80);
+
+// Vibe Engine gate
+const policy = p.vibe('frustrated').withConfidence(0.8).build();
+```
+
+The builder output is a plain `AstNode` that works with `evaluate()`, `evaluateWithTrace()`, `addActivity()`, and anywhere else a policy AST is accepted.
+
 ## Development
 This package uses `napi-rs` to build the Rust bindings.
 

package/lib/policy-builder.js

@@ -32,47 +32,41 @@ class FieldBuilder {
   _op(kind, value) {
     return {
       kind,
-      children: [
-        { kind: 'Field', path: this._path },
-        { kind: 'Literal', value },
-      ],
+      children: [{ kind: 'Field', path: this._path }],
+      value: String(value)
     }
   }
 
   // Equality
-  equal(value) { return this._op('Eq', String(value)) }
+  equal(value) { return this._op('Eq', value) }
   eq(value) { return this.equal(value) }
-  notEqual(value) { return this._op('Neq', String(value)) }
+  notEqual(value) { return this._op('Neq', value) }
   neq(value) { return this.notEqual(value) }
 
   // Comparisons
-  greaterThan(value) { return this._op('Gt', String(value)) }
+  greaterThan(value) { return this._op('Gt', value) }
   gt(value) { return this.greaterThan(value) }
-  greaterThanOrEqual(value) { return this._op('Gte', String(value)) }
+  greaterThanOrEqual(value) { return this._op('Gte', value) }
   gte(value) { return this.greaterThanOrEqual(value) }
-  lessThan(value) { return this._op('Lt', String(value)) }
+  lessThan(value) { return this._op('Lt', value) }
   lt(value) { return this.lessThan(value) }
-  lessThanOrEqual(value) { return this._op('Lte', String(value)) }
+  lessThanOrEqual(value) { return this._op('Lte', value) }
   lte(value) { return this.lessThanOrEqual(value) }
 
   // Collection
   in(values) {
     return {
       kind: 'In',
-      children: [
-        { kind: 'Field', path: this._path },
-        { kind: 'Literal', value: JSON.stringify(values) },
-      ],
+      children: [{ kind: 'Field', path: this._path }],
+      value: JSON.stringify(values)
     }
   }
 
   contains(value) {
     return {
       kind: 'Contains',
-      children: [
-        { kind: 'Field', path: this._path },
-        { kind: 'Literal', value },
-      ],
+      children: [{ kind: 'Field', path: this._path }],
+      value: String(value)
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gp2f/server",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Native Node.js bindings for the GP2F policy engine – powered by napi-rs",
   "main": "index.js",
   "types": "index.d.ts",