@run-iq/plugin-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Abdou-Raouf ATARMLA
+
+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,104 @@
+# @run-iq/plugin-sdk
+
+SDK for building PPE plugins — provides base classes, parameter validation, and compliance testing utilities.
+
+## Install
+
+```bash
+npm install @run-iq/plugin-sdk
+```
+
+**Peer dependency:** `@run-iq/core >= 0.1.0`
+
+## Building a plugin
+
+Extend `BasePlugin` and declare your calculation models:
+
+```typescript
+import { BasePlugin, BaseModel, SchemaValidator } from '@run-iq/plugin-sdk';
+import type { Rule, ValidationResult } from '@run-iq/plugin-sdk';
+
+class MyModel extends BaseModel {
+  readonly name = 'MY_MODEL';
+  readonly version = '1.0.0';
+
+  validateParams(params: unknown): ValidationResult {
+    return SchemaValidator.validate(params, {
+      rate: { type: 'number', min: 0, max: 1 },
+      base: { type: 'string' },
+    });
+  }
+
+  calculate(input: Record<string, unknown>, _rule: Readonly<Rule>, params: unknown): number {
+    const { rate, base } = params as { rate: number; base: string };
+    return (input[base] as number) * rate;
+  }
+}
+
+export class MyPlugin extends BasePlugin {
+  readonly name = 'my-plugin';
+  readonly version = '1.0.0';
+  readonly models = [new MyModel()];
+}
+```
+
+`BasePlugin.onInit()` automatically registers all declared models into the engine's `ModelRegistry`.
+
+## Schema validation
+
+`SchemaValidator` validates `params` against a declarative schema:
+
+```typescript
+import { SchemaValidator } from '@run-iq/plugin-sdk';
+
+const result = SchemaValidator.validate(params, {
+  rate: { type: 'number', min: 0, max: 1 },
+  amount: { type: 'number', min: 0 },
+  label: { type: 'string' },
+});
+
+if (!result.valid) {
+  console.log(result.errors);
+}
+```
+
+## Compliance testing
+
+`PluginTester` verifies that a plugin respects PPE invariants:
+
+```typescript
+import { PluginTester } from '@run-iq/plugin-sdk';
+
+const tester = new PluginTester(myPlugin);
+const report = await tester.runAll(input, rules, context);
+
+console.log(report.summary); // 'PASS' or 'FAIL'
+```
+
+Individual assertions:
+
+| Method | Checks |
+|---|---|
+| `assertDeterminism()` | Same input x3 produces identical output |
+| `assertImmutability()` | Hooks never mutate received data |
+| `assertNoSideEffects()` | Consecutive calls produce identical results |
+| `assertParamsValidation()` | Model rejects invalid params |
+
+## Exports
+
+| Export | Type | Description |
+|---|---|---|
+| `BasePlugin` | class | Abstract plugin base with auto model registration |
+| `BaseModel` | class | Abstract model base with params validation guard |
+| `PluginTester` | class | Compliance test runner |
+| `SchemaValidator` | class | Declarative parameter validation |
+| All `@run-iq/core` types | re-export | Convenience re-exports |
+
+## Requirements
+
+- Node.js >= 20
+- `@run-iq/core` >= 0.1.0
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,224 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BaseModel: () => BaseModel,
+  BasePlugin: () => BasePlugin,
+  PluginTester: () => PluginTester,
+  SchemaValidator: () => SchemaValidator
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/base/BasePlugin.ts
+var BasePlugin = class {
+  onInit(context) {
+    for (const model of this.models) {
+      context.modelRegistry.register(model);
+    }
+  }
+  beforeEvaluate(input, _rules) {
+    return input;
+  }
+  afterEvaluate(_input, result) {
+    return result;
+  }
+  onError(_error, _input) {
+  }
+  teardown() {
+  }
+};
+
+// src/base/BaseModel.ts
+var BaseModel = class {
+};
+
+// src/testing/PluginTester.ts
+var PluginTester = class {
+  plugin;
+  constructor(plugin) {
+    this.plugin = plugin;
+  }
+  async assertDeterminism(input, rules, context) {
+    this.plugin.onInit(context);
+    const results = [];
+    for (let i = 0; i < 3; i++) {
+      if (this.plugin.beforeEvaluate) {
+        results.push(this.plugin.beforeEvaluate(input, rules));
+      }
+    }
+    if (results.length === 3) {
+      const json0 = JSON.stringify(results[0]);
+      const json1 = JSON.stringify(results[1]);
+      const json2 = JSON.stringify(results[2]);
+      if (json0 !== json1 || json1 !== json2) {
+        throw new Error("Determinism violation: different results for same input");
+      }
+    }
+  }
+  async assertImmutability(input, rules) {
+    const inputCopy = JSON.parse(JSON.stringify(input));
+    const rulesCopy = JSON.parse(JSON.stringify(rules));
+    if (this.plugin.beforeEvaluate) {
+      this.plugin.beforeEvaluate(input, rules);
+    }
+    if (JSON.stringify(input) !== JSON.stringify(inputCopy)) {
+      throw new Error("Immutability violation: beforeEvaluate mutated input");
+    }
+    if (JSON.stringify(rules) !== JSON.stringify(rulesCopy)) {
+      throw new Error("Immutability violation: beforeEvaluate mutated rules");
+    }
+  }
+  async assertParamsValidation(modelName, invalidParams, context) {
+    this.plugin.onInit(context);
+    const model = this.findModel(modelName, context);
+    if (!model) {
+      throw new Error(`Model "${modelName}" not found in plugin`);
+    }
+    for (const params of invalidParams) {
+      const result = model.validateParams(params);
+      if (result.valid) {
+        throw new Error(
+          `Expected model "${modelName}" to reject params: ${JSON.stringify(params)}`
+        );
+      }
+    }
+  }
+  async assertNoSideEffects(input, rules) {
+    if (this.plugin.beforeEvaluate) {
+      const r1 = this.plugin.beforeEvaluate(input, rules);
+      const r2 = this.plugin.beforeEvaluate(input, rules);
+      if (JSON.stringify(r1) !== JSON.stringify(r2)) {
+        throw new Error("Side effects detected: different results between calls");
+      }
+    }
+  }
+  async runAll(input, rules, context) {
+    const passed = [];
+    const failed = [];
+    const tests = [
+      { name: "determinism", fn: () => this.assertDeterminism(input, rules, context) },
+      { name: "immutability", fn: () => this.assertImmutability(input, rules) },
+      { name: "noSideEffects", fn: () => this.assertNoSideEffects(input, rules) }
+    ];
+    for (const t of tests) {
+      try {
+        await t.fn();
+        passed.push(t.name);
+      } catch (error) {
+        failed.push({
+          test: t.name,
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+    return {
+      passed,
+      failed,
+      summary: failed.length === 0 ? "PASS" : "FAIL"
+    };
+  }
+  findModel(name, context) {
+    try {
+      return context.modelRegistry.get(name);
+    } catch {
+      return void 0;
+    }
+  }
+};
+
+// src/validation/SchemaValidator.ts
+var SchemaValidator = class _SchemaValidator {
+  static validate(params, schema) {
+    const errors = [];
+    if (params === null || typeof params !== "object") {
+      return { valid: false, errors: ["params must be a non-null object"] };
+    }
+    const obj = params;
+    for (const [key, def] of Object.entries(schema)) {
+      const value = obj[key];
+      const isRequired = def.required !== false;
+      if (value === void 0 || value === null) {
+        if (isRequired) {
+          errors.push(`"${key}" is required`);
+        }
+        continue;
+      }
+      if (def.type === "number") {
+        if (typeof value !== "number" || Number.isNaN(value)) {
+          errors.push(`"${key}" must be a number`);
+          continue;
+        }
+        if (def.min !== void 0 && value < def.min) {
+          errors.push(`"${key}" must be >= ${def.min}`);
+        }
+        if (def.max !== void 0 && value > def.max) {
+          errors.push(`"${key}" must be <= ${def.max}`);
+        }
+      } else if (def.type === "string") {
+        if (typeof value !== "string") {
+          errors.push(`"${key}" must be a string`);
+          continue;
+        }
+        if (def.enum && !def.enum.includes(value)) {
+          errors.push(`"${key}" must be one of: ${def.enum.join(", ")}`);
+        }
+      } else if (def.type === "boolean") {
+        if (typeof value !== "boolean") {
+          errors.push(`"${key}" must be a boolean`);
+        }
+      } else if (def.type === "array") {
+        if (!Array.isArray(value)) {
+          errors.push(`"${key}" must be an array`);
+        }
+      } else if (def.type === "object") {
+        if (typeof value !== "object" || Array.isArray(value)) {
+          errors.push(`"${key}" must be an object`);
+        }
+      }
+    }
+    return errors.length > 0 ? { valid: false, errors } : { valid: true };
+  }
+  static number(value, opts) {
+    if (typeof value !== "number" || Number.isNaN(value)) return false;
+    if (opts?.min !== void 0 && value < opts.min) return false;
+    if (opts?.max !== void 0 && value > opts.max) return false;
+    return true;
+  }
+  static string(value, opts) {
+    if (typeof value !== "string") return false;
+    if (opts?.enum && !opts.enum.includes(value)) return false;
+    return true;
+  }
+  static positiveNumber(value) {
+    return _SchemaValidator.number(value, { min: 0 });
+  }
+  static rate(value) {
+    return _SchemaValidator.number(value, { min: 0, max: 1 });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseModel,
+  BasePlugin,
+  PluginTester,
+  SchemaValidator
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/base/BasePlugin.ts","../src/base/BaseModel.ts","../src/testing/PluginTester.ts","../src/validation/SchemaValidator.ts"],"sourcesContent":["export { BasePlugin } from './base/BasePlugin.js';\nexport { BaseModel } from './base/BaseModel.js';\nexport { PluginTester } from './testing/PluginTester.js';\nexport type { TestReport } from './testing/PluginTester.js';\nexport { SchemaValidator } from './validation/SchemaValidator.js';\nexport type { SchemaDefinition, SchemaFieldDef } from './validation/SchemaValidator.js';\nexport type {\n  Rule,\n  Expression,\n  EvaluationInput,\n  EvaluationResult,\n  BreakdownItem,\n  SkippedRule,\n  SkipReason,\n  PPEPlugin,\n  PluginContext,\n  CalculationModel,\n  ValidationResult,\n  DSLEvaluator,\n  ISnapshotAdapter,\n  Snapshot,\n  EvaluationTrace,\n  TraceStep,\n} from './types/index.js';\n","import type {\n  PPEPlugin,\n  PluginContext,\n  EvaluationInput,\n  EvaluationResult,\n  Rule,\n  CalculationModel,\n  PPEError,\n} from '@run-iq/core';\n\nexport abstract class BasePlugin implements PPEPlugin {\n  abstract readonly name: string;\n  abstract readonly version: string;\n  abstract readonly models: CalculationModel[];\n\n  onInit(context: PluginContext): void {\n    for (const model of this.models) {\n      context.modelRegistry.register(model);\n    }\n  }\n\n  beforeEvaluate(input: EvaluationInput, _rules: ReadonlyArray<Rule>): EvaluationInput {\n    return input;\n  }\n\n  afterEvaluate(_input: EvaluationInput, result: EvaluationResult): EvaluationResult {\n    return result;\n  }\n\n  onError(_error: PPEError, _input: EvaluationInput): void {\n    // no-op by default\n  }\n\n  teardown(): void {\n    // no-op by default\n  }\n}\n","import type { CalculationModel, ValidationResult, Rule } from '@run-iq/core';\n\nexport abstract class BaseModel implements CalculationModel {\n  abstract readonly name: string;\n  abstract readonly version: string;\n\n  abstract validateParams(params: unknown): ValidationResult;\n\n  abstract calculate(\n    input: Record<string, unknown>,\n    matchedRule: Readonly<Rule>,\n    params: unknown,\n  ): number;\n}\n","import type {\n  PPEPlugin,\n  PluginContext,\n  EvaluationInput,\n  Rule,\n  CalculationModel,\n} from '@run-iq/core';\n\nexport interface TestReport {\n  readonly passed: string[];\n  readonly failed: Array<{ test: string; error: string }>;\n  readonly summary: 'PASS' | 'FAIL';\n}\n\nexport class PluginTester {\n  private readonly plugin: PPEPlugin;\n\n  constructor(plugin: PPEPlugin) {\n    this.plugin = plugin;\n  }\n\n  async assertDeterminism(\n    input: EvaluationInput,\n    rules: ReadonlyArray<Rule>,\n    context: PluginContext,\n  ): Promise<void> {\n    this.plugin.onInit(context);\n\n    const results: EvaluationInput[] = [];\n    for (let i = 0; i < 3; i++) {\n      if (this.plugin.beforeEvaluate) {\n        results.push(this.plugin.beforeEvaluate(input, rules));\n      }\n    }\n\n    if (results.length === 3) {\n      const json0 = JSON.stringify(results[0]);\n      const json1 = JSON.stringify(results[1]);\n      const json2 = JSON.stringify(results[2]);\n      if (json0 !== json1 || json1 !== json2) {\n        throw new Error('Determinism violation: different results for same input');\n      }\n    }\n  }\n\n  async assertImmutability(input: EvaluationInput, rules: ReadonlyArray<Rule>): Promise<void> {\n    const inputCopy = JSON.parse(JSON.stringify(input)) as EvaluationInput;\n    const rulesCopy = JSON.parse(JSON.stringify(rules)) as Rule[];\n\n    if (this.plugin.beforeEvaluate) {\n      this.plugin.beforeEvaluate(input, rules);\n    }\n\n    if (JSON.stringify(input) !== JSON.stringify(inputCopy)) {\n      throw new Error('Immutability violation: beforeEvaluate mutated input');\n    }\n    if (JSON.stringify(rules) !== JSON.stringify(rulesCopy)) {\n      throw new Error('Immutability violation: beforeEvaluate mutated rules');\n    }\n  }\n\n  async assertParamsValidation(\n    modelName: string,\n    invalidParams: unknown[],\n    context: PluginContext,\n  ): Promise<void> {\n    this.plugin.onInit(context);\n\n    const model = this.findModel(modelName, context);\n    if (!model) {\n      throw new Error(`Model \"${modelName}\" not found in plugin`);\n    }\n\n    for (const params of invalidParams) {\n      const result = model.validateParams(params);\n      if (result.valid) {\n        throw new Error(\n          `Expected model \"${modelName}\" to reject params: ${JSON.stringify(params)}`,\n        );\n      }\n    }\n  }\n\n  async assertNoSideEffects(input: EvaluationInput, rules: ReadonlyArray<Rule>): Promise<void> {\n    if (this.plugin.beforeEvaluate) {\n      const r1 = this.plugin.beforeEvaluate(input, rules);\n      const r2 = this.plugin.beforeEvaluate(input, rules);\n\n      if (JSON.stringify(r1) !== JSON.stringify(r2)) {\n        throw new Error('Side effects detected: different results between calls');\n      }\n    }\n  }\n\n  async runAll(\n    input: EvaluationInput,\n    rules: ReadonlyArray<Rule>,\n    context: PluginContext,\n  ): Promise<TestReport> {\n    const passed: string[] = [];\n    const failed: Array<{ test: string; error: string }> = [];\n\n    const tests = [\n      { name: 'determinism', fn: () => this.assertDeterminism(input, rules, context) },\n      { name: 'immutability', fn: () => this.assertImmutability(input, rules) },\n      { name: 'noSideEffects', fn: () => this.assertNoSideEffects(input, rules) },\n    ];\n\n    for (const t of tests) {\n      try {\n        await t.fn();\n        passed.push(t.name);\n      } catch (error) {\n        failed.push({\n          test: t.name,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    return {\n      passed,\n      failed,\n      summary: failed.length === 0 ? 'PASS' : 'FAIL',\n    };\n  }\n\n  private findModel(name: string, context: PluginContext): CalculationModel | undefined {\n    try {\n      return context.modelRegistry.get(name);\n    } catch {\n      return undefined;\n    }\n  }\n}\n","import type { ValidationResult } from '@run-iq/core';\n\nexport interface SchemaFieldDef {\n  readonly type: 'number' | 'string' | 'boolean' | 'array' | 'object';\n  readonly min?: number | undefined;\n  readonly max?: number | undefined;\n  readonly enum?: readonly string[] | undefined;\n  readonly required?: boolean | undefined;\n}\n\nexport type SchemaDefinition = Record<string, SchemaFieldDef>;\n\nexport class SchemaValidator {\n  static validate(params: unknown, schema: SchemaDefinition): ValidationResult {\n    const errors: string[] = [];\n\n    if (params === null || typeof params !== 'object') {\n      return { valid: false, errors: ['params must be a non-null object'] };\n    }\n\n    const obj = params as Record<string, unknown>;\n\n    for (const [key, def] of Object.entries(schema)) {\n      const value = obj[key];\n      const isRequired = def.required !== false;\n\n      if (value === undefined || value === null) {\n        if (isRequired) {\n          errors.push(`\"${key}\" is required`);\n        }\n        continue;\n      }\n\n      if (def.type === 'number') {\n        if (typeof value !== 'number' || Number.isNaN(value)) {\n          errors.push(`\"${key}\" must be a number`);\n          continue;\n        }\n        if (def.min !== undefined && value < def.min) {\n          errors.push(`\"${key}\" must be >= ${def.min}`);\n        }\n        if (def.max !== undefined && value > def.max) {\n          errors.push(`\"${key}\" must be <= ${def.max}`);\n        }\n      } else if (def.type === 'string') {\n        if (typeof value !== 'string') {\n          errors.push(`\"${key}\" must be a string`);\n          continue;\n        }\n        if (def.enum && !def.enum.includes(value)) {\n          errors.push(`\"${key}\" must be one of: ${def.enum.join(', ')}`);\n        }\n      } else if (def.type === 'boolean') {\n        if (typeof value !== 'boolean') {\n          errors.push(`\"${key}\" must be a boolean`);\n        }\n      } else if (def.type === 'array') {\n        if (!Array.isArray(value)) {\n          errors.push(`\"${key}\" must be an array`);\n        }\n      } else if (def.type === 'object') {\n        if (typeof value !== 'object' || Array.isArray(value)) {\n          errors.push(`\"${key}\" must be an object`);\n        }\n      }\n    }\n\n    return errors.length > 0 ? { valid: false, errors } : { valid: true };\n  }\n\n  static number(value: unknown, opts?: { min?: number; max?: number }): boolean {\n    if (typeof value !== 'number' || Number.isNaN(value)) return false;\n    if (opts?.min !== undefined && value < opts.min) return false;\n    if (opts?.max !== undefined && value > opts.max) return false;\n    return true;\n  }\n\n  static string(value: unknown, opts?: { enum?: readonly string[] }): boolean {\n    if (typeof value !== 'string') return false;\n    if (opts?.enum && !opts.enum.includes(value)) return false;\n    return true;\n  }\n\n  static positiveNumber(value: unknown): boolean {\n    return SchemaValidator.number(value, { min: 0 });\n  }\n\n  static rate(value: unknown): boolean {\n    return SchemaValidator.number(value, { min: 0, max: 1 });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,62 @@
+import { PPEPlugin, CalculationModel, PluginContext, EvaluationInput, Rule, EvaluationResult, PPEError, ValidationResult } from '@run-iq/core';
+export { BreakdownItem, CalculationModel, DSLEvaluator, EvaluationInput, EvaluationResult, EvaluationTrace, Expression, ISnapshotAdapter, PPEPlugin, PluginContext, Rule, SkipReason, SkippedRule, Snapshot, TraceStep, ValidationResult } from '@run-iq/core';
+
+declare abstract class BasePlugin implements PPEPlugin {
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly models: CalculationModel[];
+    onInit(context: PluginContext): void;
+    beforeEvaluate(input: EvaluationInput, _rules: ReadonlyArray<Rule>): EvaluationInput;
+    afterEvaluate(_input: EvaluationInput, result: EvaluationResult): EvaluationResult;
+    onError(_error: PPEError, _input: EvaluationInput): void;
+    teardown(): void;
+}
+
+declare abstract class BaseModel implements CalculationModel {
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract validateParams(params: unknown): ValidationResult;
+    abstract calculate(input: Record<string, unknown>, matchedRule: Readonly<Rule>, params: unknown): number;
+}
+
+interface TestReport {
+    readonly passed: string[];
+    readonly failed: Array<{
+        test: string;
+        error: string;
+    }>;
+    readonly summary: 'PASS' | 'FAIL';
+}
+declare class PluginTester {
+    private readonly plugin;
+    constructor(plugin: PPEPlugin);
+    assertDeterminism(input: EvaluationInput, rules: ReadonlyArray<Rule>, context: PluginContext): Promise<void>;
+    assertImmutability(input: EvaluationInput, rules: ReadonlyArray<Rule>): Promise<void>;
+    assertParamsValidation(modelName: string, invalidParams: unknown[], context: PluginContext): Promise<void>;
+    assertNoSideEffects(input: EvaluationInput, rules: ReadonlyArray<Rule>): Promise<void>;
+    runAll(input: EvaluationInput, rules: ReadonlyArray<Rule>, context: PluginContext): Promise<TestReport>;
+    private findModel;
+}
+
+interface SchemaFieldDef {
+    readonly type: 'number' | 'string' | 'boolean' | 'array' | 'object';
+    readonly min?: number | undefined;
+    readonly max?: number | undefined;
+    readonly enum?: readonly string[] | undefined;
+    readonly required?: boolean | undefined;
+}
+type SchemaDefinition = Record<string, SchemaFieldDef>;
+declare class SchemaValidator {
+    static validate(params: unknown, schema: SchemaDefinition): ValidationResult;
+    static number(value: unknown, opts?: {
+        min?: number;
+        max?: number;
+    }): boolean;
+    static string(value: unknown, opts?: {
+        enum?: readonly string[];
+    }): boolean;
+    static positiveNumber(value: unknown): boolean;
+    static rate(value: unknown): boolean;
+}
+
+export { BaseModel, BasePlugin, PluginTester, type SchemaDefinition, type SchemaFieldDef, SchemaValidator, type TestReport };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import { PPEPlugin, CalculationModel, PluginContext, EvaluationInput, Rule, EvaluationResult, PPEError, ValidationResult } from '@run-iq/core';
+export { BreakdownItem, CalculationModel, DSLEvaluator, EvaluationInput, EvaluationResult, EvaluationTrace, Expression, ISnapshotAdapter, PPEPlugin, PluginContext, Rule, SkipReason, SkippedRule, Snapshot, TraceStep, ValidationResult } from '@run-iq/core';
+
+declare abstract class BasePlugin implements PPEPlugin {
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly models: CalculationModel[];
+    onInit(context: PluginContext): void;
+    beforeEvaluate(input: EvaluationInput, _rules: ReadonlyArray<Rule>): EvaluationInput;
+    afterEvaluate(_input: EvaluationInput, result: EvaluationResult): EvaluationResult;
+    onError(_error: PPEError, _input: EvaluationInput): void;
+    teardown(): void;
+}
+
+declare abstract class BaseModel implements CalculationModel {
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract validateParams(params: unknown): ValidationResult;
+    abstract calculate(input: Record<string, unknown>, matchedRule: Readonly<Rule>, params: unknown): number;
+}
+
+interface TestReport {
+    readonly passed: string[];
+    readonly failed: Array<{
+        test: string;
+        error: string;
+    }>;
+    readonly summary: 'PASS' | 'FAIL';
+}
+declare class PluginTester {
+    private readonly plugin;
+    constructor(plugin: PPEPlugin);
+    assertDeterminism(input: EvaluationInput, rules: ReadonlyArray<Rule>, context: PluginContext): Promise<void>;
+    assertImmutability(input: EvaluationInput, rules: ReadonlyArray<Rule>): Promise<void>;
+    assertParamsValidation(modelName: string, invalidParams: unknown[], context: PluginContext): Promise<void>;
+    assertNoSideEffects(input: EvaluationInput, rules: ReadonlyArray<Rule>): Promise<void>;
+    runAll(input: EvaluationInput, rules: ReadonlyArray<Rule>, context: PluginContext): Promise<TestReport>;
+    private findModel;
+}
+
+interface SchemaFieldDef {
+    readonly type: 'number' | 'string' | 'boolean' | 'array' | 'object';
+    readonly min?: number | undefined;
+    readonly max?: number | undefined;
+    readonly enum?: readonly string[] | undefined;
+    readonly required?: boolean | undefined;
+}
+type SchemaDefinition = Record<string, SchemaFieldDef>;
+declare class SchemaValidator {
+    static validate(params: unknown, schema: SchemaDefinition): ValidationResult;
+    static number(value: unknown, opts?: {
+        min?: number;
+        max?: number;
+    }): boolean;
+    static string(value: unknown, opts?: {
+        enum?: readonly string[];
+    }): boolean;
+    static positiveNumber(value: unknown): boolean;
+    static rate(value: unknown): boolean;
+}
+
+export { BaseModel, BasePlugin, PluginTester, type SchemaDefinition, type SchemaFieldDef, SchemaValidator, type TestReport };

package/dist/index.js

@@ -0,0 +1,194 @@
+// src/base/BasePlugin.ts
+var BasePlugin = class {
+  onInit(context) {
+    for (const model of this.models) {
+      context.modelRegistry.register(model);
+    }
+  }
+  beforeEvaluate(input, _rules) {
+    return input;
+  }
+  afterEvaluate(_input, result) {
+    return result;
+  }
+  onError(_error, _input) {
+  }
+  teardown() {
+  }
+};
+
+// src/base/BaseModel.ts
+var BaseModel = class {
+};
+
+// src/testing/PluginTester.ts
+var PluginTester = class {
+  plugin;
+  constructor(plugin) {
+    this.plugin = plugin;
+  }
+  async assertDeterminism(input, rules, context) {
+    this.plugin.onInit(context);
+    const results = [];
+    for (let i = 0; i < 3; i++) {
+      if (this.plugin.beforeEvaluate) {
+        results.push(this.plugin.beforeEvaluate(input, rules));
+      }
+    }
+    if (results.length === 3) {
+      const json0 = JSON.stringify(results[0]);
+      const json1 = JSON.stringify(results[1]);
+      const json2 = JSON.stringify(results[2]);
+      if (json0 !== json1 || json1 !== json2) {
+        throw new Error("Determinism violation: different results for same input");
+      }
+    }
+  }
+  async assertImmutability(input, rules) {
+    const inputCopy = JSON.parse(JSON.stringify(input));
+    const rulesCopy = JSON.parse(JSON.stringify(rules));
+    if (this.plugin.beforeEvaluate) {
+      this.plugin.beforeEvaluate(input, rules);
+    }
+    if (JSON.stringify(input) !== JSON.stringify(inputCopy)) {
+      throw new Error("Immutability violation: beforeEvaluate mutated input");
+    }
+    if (JSON.stringify(rules) !== JSON.stringify(rulesCopy)) {
+      throw new Error("Immutability violation: beforeEvaluate mutated rules");
+    }
+  }
+  async assertParamsValidation(modelName, invalidParams, context) {
+    this.plugin.onInit(context);
+    const model = this.findModel(modelName, context);
+    if (!model) {
+      throw new Error(`Model "${modelName}" not found in plugin`);
+    }
+    for (const params of invalidParams) {
+      const result = model.validateParams(params);
+      if (result.valid) {
+        throw new Error(
+          `Expected model "${modelName}" to reject params: ${JSON.stringify(params)}`
+        );
+      }
+    }
+  }
+  async assertNoSideEffects(input, rules) {
+    if (this.plugin.beforeEvaluate) {
+      const r1 = this.plugin.beforeEvaluate(input, rules);
+      const r2 = this.plugin.beforeEvaluate(input, rules);
+      if (JSON.stringify(r1) !== JSON.stringify(r2)) {
+        throw new Error("Side effects detected: different results between calls");
+      }
+    }
+  }
+  async runAll(input, rules, context) {
+    const passed = [];
+    const failed = [];
+    const tests = [
+      { name: "determinism", fn: () => this.assertDeterminism(input, rules, context) },
+      { name: "immutability", fn: () => this.assertImmutability(input, rules) },
+      { name: "noSideEffects", fn: () => this.assertNoSideEffects(input, rules) }
+    ];
+    for (const t of tests) {
+      try {
+        await t.fn();
+        passed.push(t.name);
+      } catch (error) {
+        failed.push({
+          test: t.name,
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+    return {
+      passed,
+      failed,
+      summary: failed.length === 0 ? "PASS" : "FAIL"
+    };
+  }
+  findModel(name, context) {
+    try {
+      return context.modelRegistry.get(name);
+    } catch {
+      return void 0;
+    }
+  }
+};
+
+// src/validation/SchemaValidator.ts
+var SchemaValidator = class _SchemaValidator {
+  static validate(params, schema) {
+    const errors = [];
+    if (params === null || typeof params !== "object") {
+      return { valid: false, errors: ["params must be a non-null object"] };
+    }
+    const obj = params;
+    for (const [key, def] of Object.entries(schema)) {
+      const value = obj[key];
+      const isRequired = def.required !== false;
+      if (value === void 0 || value === null) {
+        if (isRequired) {
+          errors.push(`"${key}" is required`);
+        }
+        continue;
+      }
+      if (def.type === "number") {
+        if (typeof value !== "number" || Number.isNaN(value)) {
+          errors.push(`"${key}" must be a number`);
+          continue;
+        }
+        if (def.min !== void 0 && value < def.min) {
+          errors.push(`"${key}" must be >= ${def.min}`);
+        }
+        if (def.max !== void 0 && value > def.max) {
+          errors.push(`"${key}" must be <= ${def.max}`);
+        }
+      } else if (def.type === "string") {
+        if (typeof value !== "string") {
+          errors.push(`"${key}" must be a string`);
+          continue;
+        }
+        if (def.enum && !def.enum.includes(value)) {
+          errors.push(`"${key}" must be one of: ${def.enum.join(", ")}`);
+        }
+      } else if (def.type === "boolean") {
+        if (typeof value !== "boolean") {
+          errors.push(`"${key}" must be a boolean`);
+        }
+      } else if (def.type === "array") {
+        if (!Array.isArray(value)) {
+          errors.push(`"${key}" must be an array`);
+        }
+      } else if (def.type === "object") {
+        if (typeof value !== "object" || Array.isArray(value)) {
+          errors.push(`"${key}" must be an object`);
+        }
+      }
+    }
+    return errors.length > 0 ? { valid: false, errors } : { valid: true };
+  }
+  static number(value, opts) {
+    if (typeof value !== "number" || Number.isNaN(value)) return false;
+    if (opts?.min !== void 0 && value < opts.min) return false;
+    if (opts?.max !== void 0 && value > opts.max) return false;
+    return true;
+  }
+  static string(value, opts) {
+    if (typeof value !== "string") return false;
+    if (opts?.enum && !opts.enum.includes(value)) return false;
+    return true;
+  }
+  static positiveNumber(value) {
+    return _SchemaValidator.number(value, { min: 0 });
+  }
+  static rate(value) {
+    return _SchemaValidator.number(value, { min: 0, max: 1 });
+  }
+};
+export {
+  BaseModel,
+  BasePlugin,
+  PluginTester,
+  SchemaValidator
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/base/BasePlugin.ts","../src/base/BaseModel.ts","../src/testing/PluginTester.ts","../src/validation/SchemaValidator.ts"],"sourcesContent":["import type {\n  PPEPlugin,\n  PluginContext,\n  EvaluationInput,\n  EvaluationResult,\n  Rule,\n  CalculationModel,\n  PPEError,\n} from '@run-iq/core';\n\nexport abstract class BasePlugin implements PPEPlugin {\n  abstract readonly name: string;\n  abstract readonly version: string;\n  abstract readonly models: CalculationModel[];\n\n  onInit(context: PluginContext): void {\n    for (const model of this.models) {\n      context.modelRegistry.register(model);\n    }\n  }\n\n  beforeEvaluate(input: EvaluationInput, _rules: ReadonlyArray<Rule>): EvaluationInput {\n    return input;\n  }\n\n  afterEvaluate(_input: EvaluationInput, result: EvaluationResult): EvaluationResult {\n    return result;\n  }\n\n  onError(_error: PPEError, _input: EvaluationInput): void {\n    // no-op by default\n  }\n\n  teardown(): void {\n    // no-op by default\n  }\n}\n","import type { CalculationModel, ValidationResult, Rule } from '@run-iq/core';\n\nexport abstract class BaseModel implements CalculationModel {\n  abstract readonly name: string;\n  abstract readonly version: string;\n\n  abstract validateParams(params: unknown): ValidationResult;\n\n  abstract calculate(\n    input: Record<string, unknown>,\n    matchedRule: Readonly<Rule>,\n    params: unknown,\n  ): number;\n}\n","import type {\n  PPEPlugin,\n  PluginContext,\n  EvaluationInput,\n  Rule,\n  CalculationModel,\n} from '@run-iq/core';\n\nexport interface TestReport {\n  readonly passed: string[];\n  readonly failed: Array<{ test: string; error: string }>;\n  readonly summary: 'PASS' | 'FAIL';\n}\n\nexport class PluginTester {\n  private readonly plugin: PPEPlugin;\n\n  constructor(plugin: PPEPlugin) {\n    this.plugin = plugin;\n  }\n\n  async assertDeterminism(\n    input: EvaluationInput,\n    rules: ReadonlyArray<Rule>,\n    context: PluginContext,\n  ): Promise<void> {\n    this.plugin.onInit(context);\n\n    const results: EvaluationInput[] = [];\n    for (let i = 0; i < 3; i++) {\n      if (this.plugin.beforeEvaluate) {\n        results.push(this.plugin.beforeEvaluate(input, rules));\n      }\n    }\n\n    if (results.length === 3) {\n      const json0 = JSON.stringify(results[0]);\n      const json1 = JSON.stringify(results[1]);\n      const json2 = JSON.stringify(results[2]);\n      if (json0 !== json1 || json1 !== json2) {\n        throw new Error('Determinism violation: different results for same input');\n      }\n    }\n  }\n\n  async assertImmutability(input: EvaluationInput, rules: ReadonlyArray<Rule>): Promise<void> {\n    const inputCopy = JSON.parse(JSON.stringify(input)) as EvaluationInput;\n    const rulesCopy = JSON.parse(JSON.stringify(rules)) as Rule[];\n\n    if (this.plugin.beforeEvaluate) {\n      this.plugin.beforeEvaluate(input, rules);\n    }\n\n    if (JSON.stringify(input) !== JSON.stringify(inputCopy)) {\n      throw new Error('Immutability violation: beforeEvaluate mutated input');\n    }\n    if (JSON.stringify(rules) !== JSON.stringify(rulesCopy)) {\n      throw new Error('Immutability violation: beforeEvaluate mutated rules');\n    }\n  }\n\n  async assertParamsValidation(\n    modelName: string,\n    invalidParams: unknown[],\n    context: PluginContext,\n  ): Promise<void> {\n    this.plugin.onInit(context);\n\n    const model = this.findModel(modelName, context);\n    if (!model) {\n      throw new Error(`Model \"${modelName}\" not found in plugin`);\n    }\n\n    for (const params of invalidParams) {\n      const result = model.validateParams(params);\n      if (result.valid) {\n        throw new Error(\n          `Expected model \"${modelName}\" to reject params: ${JSON.stringify(params)}`,\n        );\n      }\n    }\n  }\n\n  async assertNoSideEffects(input: EvaluationInput, rules: ReadonlyArray<Rule>): Promise<void> {\n    if (this.plugin.beforeEvaluate) {\n      const r1 = this.plugin.beforeEvaluate(input, rules);\n      const r2 = this.plugin.beforeEvaluate(input, rules);\n\n      if (JSON.stringify(r1) !== JSON.stringify(r2)) {\n        throw new Error('Side effects detected: different results between calls');\n      }\n    }\n  }\n\n  async runAll(\n    input: EvaluationInput,\n    rules: ReadonlyArray<Rule>,\n    context: PluginContext,\n  ): Promise<TestReport> {\n    const passed: string[] = [];\n    const failed: Array<{ test: string; error: string }> = [];\n\n    const tests = [\n      { name: 'determinism', fn: () => this.assertDeterminism(input, rules, context) },\n      { name: 'immutability', fn: () => this.assertImmutability(input, rules) },\n      { name: 'noSideEffects', fn: () => this.assertNoSideEffects(input, rules) },\n    ];\n\n    for (const t of tests) {\n      try {\n        await t.fn();\n        passed.push(t.name);\n      } catch (error) {\n        failed.push({\n          test: t.name,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    return {\n      passed,\n      failed,\n      summary: failed.length === 0 ? 'PASS' : 'FAIL',\n    };\n  }\n\n  private findModel(name: string, context: PluginContext): CalculationModel | undefined {\n    try {\n      return context.modelRegistry.get(name);\n    } catch {\n      return undefined;\n    }\n  }\n}\n","import type { ValidationResult } from '@run-iq/core';\n\nexport interface SchemaFieldDef {\n  readonly type: 'number' | 'string' | 'boolean' | 'array' | 'object';\n  readonly min?: number | undefined;\n  readonly max?: number | undefined;\n  readonly enum?: readonly string[] | undefined;\n  readonly required?: boolean | undefined;\n}\n\nexport type SchemaDefinition = Record<string, SchemaFieldDef>;\n\nexport class SchemaValidator {\n  static validate(params: unknown, schema: SchemaDefinition): ValidationResult {\n    const errors: string[] = [];\n\n    if (params === null || typeof params !== 'object') {\n      return { valid: false, errors: ['params must be a non-null object'] };\n    }\n\n    const obj = params as Record<string, unknown>;\n\n    for (const [key, def] of Object.entries(schema)) {\n      const value = obj[key];\n      const isRequired = def.required !== false;\n\n      if (value === undefined || value === null) {\n        if (isRequired) {\n          errors.push(`\"${key}\" is required`);\n        }\n        continue;\n      }\n\n      if (def.type === 'number') {\n        if (typeof value !== 'number' || Number.isNaN(value)) {\n          errors.push(`\"${key}\" must be a number`);\n          continue;\n        }\n        if (def.min !== undefined && value < def.min) {\n          errors.push(`\"${key}\" must be >= ${def.min}`);\n        }\n        if (def.max !== undefined && value > def.max) {\n          errors.push(`\"${key}\" must be <= ${def.max}`);\n        }\n      } else if (def.type === 'string') {\n        if (typeof value !== 'string') {\n          errors.push(`\"${key}\" must be a string`);\n          continue;\n        }\n        if (def.enum && !def.enum.includes(value)) {\n          errors.push(`\"${key}\" must be one of: ${def.enum.join(', ')}`);\n        }\n      } else if (def.type === 'boolean') {\n        if (typeof value !== 'boolean') {\n          errors.push(`\"${key}\" must be a boolean`);\n        }\n      } else if (def.type === 'array') {\n        if (!Array.isArray(value)) {\n          errors.push(`\"${key}\" must be an array`);\n        }\n      } else if (def.type === 'object') {\n        if (typeof value !== 'object' || Array.isArray(value)) {\n          errors.push(`\"${key}\" must be an object`);\n        }\n      }\n    }\n\n    return errors.length > 0 ? { valid: false, errors } : { valid: true };\n  }\n\n  static number(value: unknown, opts?: { min?: number; max?: number }): boolean {\n    if (typeof value !== 'number' || Number.isNaN(value)) return false;\n    if (opts?.min !== undefined && value < opts.min) return false;\n    if (opts?.max !== undefined && value > opts.max) return false;\n    return true;\n  }\n\n  static string(value: unknown, opts?: { enum?: readonly string[] }): boolean {\n    if (typeof value !== 'string') return false;\n    if (opts?.enum && !opts.enum.includes(value)) return false;\n    return true;\n  }\n\n  static positiveNumber(value: unknown): boolean {\n    return SchemaValidator.number(value, { min: 0 });\n  }\n\n  static rate(value: unknown): boolean {\n    return SchemaValidator.number(value, { min: 0, max: 1 });\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@run-iq/plugin-sdk",
+  "version": "0.1.0",
+  "description": "Plugin SDK for PPE — BasePlugin, BaseModel, PluginTester",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/ tests/ && prettier --check src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix && prettier --write src/ tests/"
+  },
+  "peerDependencies": {
+    "@run-iq/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.3.0"
+  },
+  "author": "Abdou-Raouf ATARMLA",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}