@run-iq/server 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,108 @@
+# @run-iq/server
+
+HTTP REST server for the **Parametric Policy Engine (PPE)**. Wraps `@run-iq/core` behind a Fastify API for polyglot and non-Node integrations.
+
+## Installation
+
+```bash
+npm install @run-iq/server
+```
+
+## Quick start
+
+```typescript
+import { start } from '@run-iq/server';
+import { FiscalPlugin } from '@run-iq/plugin-fiscal';
+import { JsonLogicEvaluator } from '@run-iq/dsl-jsonlogic';
+
+await start({
+  port: 3000,
+  plugins: [new FiscalPlugin()],
+  dsls: [new JsonLogicEvaluator()],
+  strict: false,
+});
+```
+
+## API
+
+### `GET /health`
+
+```json
+{ "status": "ok", "engine": "0.1.2" }
+```
+
+### `POST /evaluate`
+
+**Request body:**
+
+```json
+{
+  "rules": [
+    {
+      "id": "rule-1",
+      "version": 1,
+      "model": "FLAT_RATE",
+      "params": { "rate": 0.18, "base": "grossSalary" },
+      "priority": 1,
+      "effectiveFrom": "2024-01-01T00:00:00.000Z",
+      "effectiveUntil": null,
+      "tags": ["togo", "irpp"],
+      "checksum": "abc123"
+    }
+  ],
+  "input": {
+    "requestId": "req-001",
+    "data": { "grossSalary": 2500000 },
+    "meta": { "tenantId": "tenant-1" }
+  }
+}
+```
+
+**Response 200:** `EvaluationResult` (JSON serialized)
+
+**Error responses:**
+
+| Status | Condition |
+|--------|-----------|
+| 400 | Malformed input or `ValidationError` |
+| 409 | `RuleConflictError` |
+| 422 | Other `PPEError` |
+| 503 | `SnapshotFailureError` |
+| 500 | Unexpected error |
+
+## Programmatic usage
+
+```typescript
+import { createApp } from '@run-iq/server';
+
+const app = createApp({
+  plugins: [myPlugin],
+  dsls: [myDsl],
+  strict: false,
+  logLevel: 'silent',
+});
+
+// Use app.inject() for testing
+const response = await app.inject({
+  method: 'POST',
+  url: '/evaluate',
+  payload: { rules: [...], input: {...} },
+});
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `port` | `number` | `3000` | Listen port |
+| `host` | `string` | `'0.0.0.0'` | Listen host |
+| `plugins` | `PPEPlugin[]` | required | PPE plugins to register |
+| `dsls` | `DSLEvaluator[]` | required | DSL evaluators to register |
+| `snapshot` | `ISnapshotAdapter` | — | Snapshot adapter |
+| `strict` | `boolean` | `true` | Strict mode |
+| `timeout` | `object` | — | Timeout config (`dsl`, `hook`, `pipeline`) |
+| `logLevel` | `string` | `'info'` | `'info'` \| `'warn'` \| `'error'` \| `'silent'` |
+
+## License
+
+MIT — Abdou-Raouf ATARMLA

package/dist/index.cjs

@@ -0,0 +1,251 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createApp: () => createApp,
+  resolveConfig: () => resolveConfig,
+  start: () => start
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/app.ts
+var import_fastify = __toESM(require("fastify"), 1);
+var import_core2 = require("@run-iq/core");
+
+// src/config.ts
+var DEFAULT_PORT = 3e3;
+var DEFAULT_HOST = "0.0.0.0";
+var DEFAULT_LOG_LEVEL = "info";
+function resolveConfig(partial) {
+  return {
+    port: partial.port ?? DEFAULT_PORT,
+    host: partial.host ?? DEFAULT_HOST,
+    plugins: partial.plugins,
+    dsls: partial.dsls,
+    snapshot: partial.snapshot,
+    strict: partial.strict ?? true,
+    timeout: partial.timeout,
+    logLevel: partial.logLevel ?? DEFAULT_LOG_LEVEL
+  };
+}
+
+// src/routes/health.ts
+var ENGINE_VERSION = "0.1.2";
+async function healthRoute(app) {
+  app.get("/health", async () => {
+    return { status: "ok", engine: ENGINE_VERSION };
+  });
+}
+
+// src/routes/evaluate.ts
+var import_core = require("@run-iq/core");
+
+// src/schemas/evaluate.ts
+var evaluateRequestSchema = {
+  type: "object",
+  required: ["rules", "input"],
+  properties: {
+    rules: {
+      type: "array",
+      items: {
+        type: "object",
+        required: [
+          "id",
+          "version",
+          "model",
+          "params",
+          "priority",
+          "effectiveFrom",
+          "tags",
+          "checksum"
+        ],
+        properties: {
+          id: { type: "string" },
+          version: { type: "number" },
+          model: { type: "string" },
+          params: {},
+          condition: {
+            type: "object",
+            properties: {
+              dsl: { type: "string" },
+              value: {}
+            }
+          },
+          priority: { type: "number" },
+          effectiveFrom: { type: "string" },
+          effectiveUntil: { type: ["string", "null"] },
+          tags: { type: "array", items: { type: "string" } },
+          checksum: { type: "string" },
+          schemaVersion: { type: "string" }
+        }
+      }
+    },
+    input: {
+      type: "object",
+      required: ["requestId", "data", "meta"],
+      properties: {
+        requestId: { type: "string" },
+        data: { type: "object" },
+        meta: {
+          type: "object",
+          required: ["tenantId"],
+          properties: {
+            tenantId: { type: "string" },
+            userId: { type: "string" },
+            tags: { type: "array", items: { type: "string" } },
+            context: { type: "object" },
+            effectiveDate: { type: "string" }
+          }
+        }
+      }
+    }
+  }
+};
+
+// src/routes/evaluate.ts
+function createEvaluateRoute(config) {
+  return async function evaluateRoute(app) {
+    const engineConfig = {
+      plugins: config.plugins,
+      dsls: config.dsls,
+      snapshot: config.snapshot,
+      strict: config.strict,
+      timeout: config.timeout,
+      dryRun: config.snapshot == null
+    };
+    const engine = new import_core.PPEEngine(engineConfig);
+    app.post(
+      "/evaluate",
+      {
+        schema: {
+          body: evaluateRequestSchema
+        }
+      },
+      async (request) => {
+        const { rules: rawRules, input: rawInput } = request.body;
+        const rules = (0, import_core.hydrateRules)(rawRules);
+        const input = {
+          requestId: rawInput.requestId,
+          data: rawInput.data,
+          meta: {
+            tenantId: rawInput.meta.tenantId,
+            userId: rawInput.meta.userId,
+            tags: rawInput.meta.tags,
+            context: rawInput.meta.context,
+            effectiveDate: rawInput.meta.effectiveDate ? new Date(rawInput.meta.effectiveDate) : void 0
+          }
+        };
+        const result = await engine.evaluate(rules, input);
+        return result;
+      }
+    );
+  };
+}
+
+// src/app.ts
+function createApp(partial) {
+  const config = resolveConfig(partial);
+  const app = (0, import_fastify.default)({
+    logger: config.logLevel !== "silent" ? { level: config.logLevel ?? "info" } : false
+  });
+  app.register(healthRoute);
+  app.register(createEvaluateRoute(config));
+  app.setErrorHandler((error, _request, reply) => {
+    if ("validation" in error && error.validation) {
+      return reply.status(400).send({
+        error: "Validation Error",
+        message: error.message,
+        statusCode: 400
+      });
+    }
+    if (error instanceof import_core2.ValidationError) {
+      return reply.status(400).send({
+        error: "Validation Error",
+        message: error.message,
+        code: error.code,
+        reasons: error.reasons,
+        statusCode: 400
+      });
+    }
+    if (error instanceof import_core2.RuleConflictError) {
+      return reply.status(409).send({
+        error: "Rule Conflict",
+        message: error.message,
+        code: error.code,
+        ruleIds: error.ruleIds,
+        statusCode: 409
+      });
+    }
+    if (error instanceof import_core2.SnapshotFailureError) {
+      return reply.status(503).send({
+        error: "Snapshot Failure",
+        message: error.message,
+        code: error.code,
+        statusCode: 503
+      });
+    }
+    if (error instanceof import_core2.PPEError) {
+      return reply.status(422).send({
+        error: "Processing Error",
+        message: error.message,
+        code: error.code,
+        statusCode: 422
+      });
+    }
+    return reply.status(500).send({
+      error: "Internal Server Error",
+      message: "An unexpected error occurred",
+      statusCode: 500
+    });
+  });
+  return app;
+}
+
+// src/server.ts
+async function start(partial) {
+  const config = resolveConfig(partial);
+  const app = createApp(partial);
+  const shutdown = async (signal) => {
+    app.log.info(`Received ${signal}, shutting down gracefully\u2026`);
+    await app.close();
+    process.exit(0);
+  };
+  process.on("SIGINT", () => void shutdown("SIGINT"));
+  process.on("SIGTERM", () => void shutdown("SIGTERM"));
+  await app.listen({ port: config.port, host: config.host });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createApp,
+  resolveConfig,
+  start
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/app.ts","../src/config.ts","../src/routes/health.ts","../src/routes/evaluate.ts","../src/schemas/evaluate.ts","../src/server.ts"],"sourcesContent":["export { createApp } from './app.js';\nexport { start } from './server.js';\nexport type { ServerConfig } from './config.js';\nexport { resolveConfig } from './config.js';\n","import Fastify from 'fastify';\nimport type { FastifyInstance, FastifyError } from 'fastify';\nimport { PPEError, ValidationError, RuleConflictError, SnapshotFailureError } from '@run-iq/core';\nimport { type ServerConfig, resolveConfig } from './config.js';\nimport { healthRoute } from './routes/health.js';\nimport { createEvaluateRoute } from './routes/evaluate.js';\n\nexport function createApp(\n  partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>,\n): FastifyInstance {\n  const config = resolveConfig(partial);\n\n  const app = Fastify({\n    logger: config.logLevel !== 'silent' ? { level: config.logLevel ?? 'info' } : false,\n  });\n\n  // Register routes\n  app.register(healthRoute);\n  app.register(createEvaluateRoute(config));\n\n  // Global error handler\n  app.setErrorHandler((error: FastifyError | Error, _request, reply) => {\n    if ('validation' in error && (error as FastifyError).validation) {\n      return reply.status(400).send({\n        error: 'Validation Error',\n        message: error.message,\n        statusCode: 400,\n      });\n    }\n\n    if (error instanceof ValidationError) {\n      return reply.status(400).send({\n        error: 'Validation Error',\n        message: error.message,\n        code: error.code,\n        reasons: error.reasons,\n        statusCode: 400,\n      });\n    }\n\n    if (error instanceof RuleConflictError) {\n      return reply.status(409).send({\n        error: 'Rule Conflict',\n        message: error.message,\n        code: error.code,\n        ruleIds: error.ruleIds,\n        statusCode: 409,\n      });\n    }\n\n    if (error instanceof SnapshotFailureError) {\n      return reply.status(503).send({\n        error: 'Snapshot Failure',\n        message: error.message,\n        code: error.code,\n        statusCode: 503,\n      });\n    }\n\n    if (error instanceof PPEError) {\n      return reply.status(422).send({\n        error: 'Processing Error',\n        message: error.message,\n        code: error.code,\n        statusCode: 422,\n      });\n    }\n\n    return reply.status(500).send({\n      error: 'Internal Server Error',\n      message: 'An unexpected error occurred',\n      statusCode: 500,\n    });\n  });\n\n  return app;\n}\n","import type { PPEPlugin, DSLEvaluator, ISnapshotAdapter } from '@run-iq/core';\n\nexport interface ServerConfig {\n  readonly port: number;\n  readonly host: string;\n  readonly plugins: PPEPlugin[];\n  readonly dsls: DSLEvaluator[];\n  readonly snapshot?: ISnapshotAdapter | undefined;\n  readonly strict?: boolean | undefined;\n  readonly timeout?:\n    | {\n        readonly dsl?: number | undefined;\n        readonly hook?: number | undefined;\n        readonly pipeline?: number | undefined;\n      }\n    | undefined;\n  readonly logLevel?: 'info' | 'warn' | 'error' | 'silent' | undefined;\n}\n\nconst DEFAULT_PORT = 3000;\nconst DEFAULT_HOST = '0.0.0.0';\nconst DEFAULT_LOG_LEVEL = 'info';\n\nexport function resolveConfig(\n  partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>,\n): ServerConfig {\n  return {\n    port: partial.port ?? DEFAULT_PORT,\n    host: partial.host ?? DEFAULT_HOST,\n    plugins: partial.plugins,\n    dsls: partial.dsls,\n    snapshot: partial.snapshot,\n    strict: partial.strict ?? true,\n    timeout: partial.timeout,\n    logLevel: partial.logLevel ?? DEFAULT_LOG_LEVEL,\n  };\n}\n","import type { FastifyInstance } from 'fastify';\n\nconst ENGINE_VERSION = '0.1.2';\n\nexport async function healthRoute(app: FastifyInstance): Promise<void> {\n  app.get('/health', async () => {\n    return { status: 'ok', engine: ENGINE_VERSION };\n  });\n}\n","import type { FastifyInstance, FastifyPluginAsync } from 'fastify';\nimport { PPEEngine, hydrateRules } from '@run-iq/core';\nimport type { PPEEngineConfig, EvaluationInput } from '@run-iq/core';\nimport type { ServerConfig } from '../config.js';\nimport { evaluateRequestSchema } from '../schemas/evaluate.js';\n\ninterface EvaluateBody {\n  rules: Record<string, unknown>[];\n  input: {\n    requestId: string;\n    data: Record<string, unknown>;\n    meta: {\n      tenantId: string;\n      userId?: string;\n      tags?: string[];\n      context?: Record<string, unknown>;\n      effectiveDate?: string;\n    };\n  };\n}\n\nexport function createEvaluateRoute(config: ServerConfig): FastifyPluginAsync {\n  return async function evaluateRoute(app: FastifyInstance): Promise<void> {\n    const engineConfig: PPEEngineConfig = {\n      plugins: config.plugins,\n      dsls: config.dsls,\n      snapshot: config.snapshot,\n      strict: config.strict,\n      timeout: config.timeout,\n      dryRun: config.snapshot == null,\n    };\n\n    const engine = new PPEEngine(engineConfig);\n\n    app.post<{ Body: EvaluateBody }>(\n      '/evaluate',\n      {\n        schema: {\n          body: evaluateRequestSchema,\n        },\n      },\n      async (request) => {\n        const { rules: rawRules, input: rawInput } = request.body;\n\n        const rules = hydrateRules(rawRules);\n\n        const input: EvaluationInput = {\n          requestId: rawInput.requestId,\n          data: rawInput.data,\n          meta: {\n            tenantId: rawInput.meta.tenantId,\n            userId: rawInput.meta.userId,\n            tags: rawInput.meta.tags,\n            context: rawInput.meta.context,\n            effectiveDate: rawInput.meta.effectiveDate\n              ? new Date(rawInput.meta.effectiveDate)\n              : undefined,\n          },\n        };\n\n        const result = await engine.evaluate(rules, input);\n\n        return result;\n      },\n    );\n  };\n}\n","export const evaluateRequestSchema = {\n  type: 'object',\n  required: ['rules', 'input'],\n  properties: {\n    rules: {\n      type: 'array',\n      items: {\n        type: 'object',\n        required: [\n          'id',\n          'version',\n          'model',\n          'params',\n          'priority',\n          'effectiveFrom',\n          'tags',\n          'checksum',\n        ],\n        properties: {\n          id: { type: 'string' },\n          version: { type: 'number' },\n          model: { type: 'string' },\n          params: {},\n          condition: {\n            type: 'object',\n            properties: {\n              dsl: { type: 'string' },\n              value: {},\n            },\n          },\n          priority: { type: 'number' },\n          effectiveFrom: { type: 'string' },\n          effectiveUntil: { type: ['string', 'null'] },\n          tags: { type: 'array', items: { type: 'string' } },\n          checksum: { type: 'string' },\n          schemaVersion: { type: 'string' },\n        },\n      },\n    },\n    input: {\n      type: 'object',\n      required: ['requestId', 'data', 'meta'],\n      properties: {\n        requestId: { type: 'string' },\n        data: { type: 'object' },\n        meta: {\n          type: 'object',\n          required: ['tenantId'],\n          properties: {\n            tenantId: { type: 'string' },\n            userId: { type: 'string' },\n            tags: { type: 'array', items: { type: 'string' } },\n            context: { type: 'object' },\n            effectiveDate: { type: 'string' },\n          },\n        },\n      },\n    },\n  },\n} as const;\n\nexport const evaluateResponseSchema = {\n  type: 'object',\n  properties: {\n    requestId: { type: 'string' },\n    value: {},\n    breakdown: { type: 'array' },\n    appliedRules: { type: 'array' },\n    skippedRules: { type: 'array' },\n    trace: { type: 'object' },\n    snapshotId: { type: 'string' },\n    engineVersion: { type: 'string' },\n    pluginVersions: { type: 'object' },\n    dslVersions: { type: 'object' },\n    timestamp: { type: 'string' },\n    meta: { type: 'object' },\n  },\n} as const;\n","import type { ServerConfig } from './config.js';\nimport { createApp } from './app.js';\nimport { resolveConfig } from './config.js';\n\nexport async function start(\n  partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>,\n): Promise<void> {\n  const config = resolveConfig(partial);\n  const app = createApp(partial);\n\n  const shutdown = async (signal: string): Promise<void> => {\n    app.log.info(`Received ${signal}, shutting down gracefully…`);\n    await app.close();\n    process.exit(0);\n  };\n\n  process.on('SIGINT', () => void shutdown('SIGINT'));\n  process.on('SIGTERM', () => void shutdown('SIGTERM'));\n\n  await app.listen({ port: config.port, host: config.host });\n}\n"],"mappings":"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","names":["import_core","Fastify"]}

package/dist/index.d.cts

@@ -0,0 +1,24 @@
+import { FastifyInstance } from 'fastify';
+import { PPEPlugin, DSLEvaluator, ISnapshotAdapter } from '@run-iq/core';
+
+interface ServerConfig {
+    readonly port: number;
+    readonly host: string;
+    readonly plugins: PPEPlugin[];
+    readonly dsls: DSLEvaluator[];
+    readonly snapshot?: ISnapshotAdapter | undefined;
+    readonly strict?: boolean | undefined;
+    readonly timeout?: {
+        readonly dsl?: number | undefined;
+        readonly hook?: number | undefined;
+        readonly pipeline?: number | undefined;
+    } | undefined;
+    readonly logLevel?: 'info' | 'warn' | 'error' | 'silent' | undefined;
+}
+declare function resolveConfig(partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>): ServerConfig;
+
+declare function createApp(partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>): FastifyInstance;
+
+declare function start(partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>): Promise<void>;
+
+export { type ServerConfig, createApp, resolveConfig, start };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { FastifyInstance } from 'fastify';
+import { PPEPlugin, DSLEvaluator, ISnapshotAdapter } from '@run-iq/core';
+
+interface ServerConfig {
+    readonly port: number;
+    readonly host: string;
+    readonly plugins: PPEPlugin[];
+    readonly dsls: DSLEvaluator[];
+    readonly snapshot?: ISnapshotAdapter | undefined;
+    readonly strict?: boolean | undefined;
+    readonly timeout?: {
+        readonly dsl?: number | undefined;
+        readonly hook?: number | undefined;
+        readonly pipeline?: number | undefined;
+    } | undefined;
+    readonly logLevel?: 'info' | 'warn' | 'error' | 'silent' | undefined;
+}
+declare function resolveConfig(partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>): ServerConfig;
+
+declare function createApp(partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>): FastifyInstance;
+
+declare function start(partial: Partial<ServerConfig> & Pick<ServerConfig, 'plugins' | 'dsls'>): Promise<void>;
+
+export { type ServerConfig, createApp, resolveConfig, start };

package/dist/index.js

@@ -0,0 +1,212 @@
+// src/app.ts
+import Fastify from "fastify";
+import { PPEError, ValidationError, RuleConflictError, SnapshotFailureError } from "@run-iq/core";
+
+// src/config.ts
+var DEFAULT_PORT = 3e3;
+var DEFAULT_HOST = "0.0.0.0";
+var DEFAULT_LOG_LEVEL = "info";
+function resolveConfig(partial) {
+  return {
+    port: partial.port ?? DEFAULT_PORT,
+    host: partial.host ?? DEFAULT_HOST,
+    plugins: partial.plugins,
+    dsls: partial.dsls,
+    snapshot: partial.snapshot,
+    strict: partial.strict ?? true,
+    timeout: partial.timeout,
+    logLevel: partial.logLevel ?? DEFAULT_LOG_LEVEL
+  };
+}
+
+// src/routes/health.ts
+var ENGINE_VERSION = "0.1.2";
+async function healthRoute(app) {
+  app.get("/health", async () => {
+    return { status: "ok", engine: ENGINE_VERSION };
+  });
+}
+
+// src/routes/evaluate.ts
+import { PPEEngine, hydrateRules } from "@run-iq/core";
+
+// src/schemas/evaluate.ts
+var evaluateRequestSchema = {
+  type: "object",
+  required: ["rules", "input"],
+  properties: {
+    rules: {
+      type: "array",
+      items: {
+        type: "object",
+        required: [
+          "id",
+          "version",
+          "model",
+          "params",
+          "priority",
+          "effectiveFrom",
+          "tags",
+          "checksum"
+        ],
+        properties: {
+          id: { type: "string" },
+          version: { type: "number" },
+          model: { type: "string" },
+          params: {},
+          condition: {
+            type: "object",
+            properties: {
+              dsl: { type: "string" },
+              value: {}
+            }
+          },
+          priority: { type: "number" },
+          effectiveFrom: { type: "string" },
+          effectiveUntil: { type: ["string", "null"] },
+          tags: { type: "array", items: { type: "string" } },
+          checksum: { type: "string" },
+          schemaVersion: { type: "string" }
+        }
+      }
+    },
+    input: {
+      type: "object",
+      required: ["requestId", "data", "meta"],
+      properties: {
+        requestId: { type: "string" },
+        data: { type: "object" },
+        meta: {
+          type: "object",
+          required: ["tenantId"],
+          properties: {
+            tenantId: { type: "string" },
+            userId: { type: "string" },
+            tags: { type: "array", items: { type: "string" } },
+            context: { type: "object" },
+            effectiveDate: { type: "string" }
+          }
+        }
+      }
+    }
+  }
+};
+
+// src/routes/evaluate.ts
+function createEvaluateRoute(config) {
+  return async function evaluateRoute(app) {
+    const engineConfig = {
+      plugins: config.plugins,
+      dsls: config.dsls,
+      snapshot: config.snapshot,
+      strict: config.strict,
+      timeout: config.timeout,
+      dryRun: config.snapshot == null
+    };
+    const engine = new PPEEngine(engineConfig);
+    app.post(
+      "/evaluate",
+      {
+        schema: {
+          body: evaluateRequestSchema
+        }
+      },
+      async (request) => {
+        const { rules: rawRules, input: rawInput } = request.body;
+        const rules = hydrateRules(rawRules);
+        const input = {
+          requestId: rawInput.requestId,
+          data: rawInput.data,
+          meta: {
+            tenantId: rawInput.meta.tenantId,
+            userId: rawInput.meta.userId,
+            tags: rawInput.meta.tags,
+            context: rawInput.meta.context,
+            effectiveDate: rawInput.meta.effectiveDate ? new Date(rawInput.meta.effectiveDate) : void 0
+          }
+        };
+        const result = await engine.evaluate(rules, input);
+        return result;
+      }
+    );
+  };
+}
+
+// src/app.ts
+function createApp(partial) {
+  const config = resolveConfig(partial);
+  const app = Fastify({
+    logger: config.logLevel !== "silent" ? { level: config.logLevel ?? "info" } : false
+  });
+  app.register(healthRoute);
+  app.register(createEvaluateRoute(config));
+  app.setErrorHandler((error, _request, reply) => {
+    if ("validation" in error && error.validation) {
+      return reply.status(400).send({
+        error: "Validation Error",
+        message: error.message,
+        statusCode: 400
+      });
+    }
+    if (error instanceof ValidationError) {
+      return reply.status(400).send({
+        error: "Validation Error",
+        message: error.message,
+        code: error.code,
+        reasons: error.reasons,
+        statusCode: 400
+      });
+    }
+    if (error instanceof RuleConflictError) {
+      return reply.status(409).send({
+        error: "Rule Conflict",
+        message: error.message,
+        code: error.code,
+        ruleIds: error.ruleIds,
+        statusCode: 409
+      });
+    }
+    if (error instanceof SnapshotFailureError) {
+      return reply.status(503).send({
+        error: "Snapshot Failure",
+        message: error.message,
+        code: error.code,
+        statusCode: 503
+      });
+    }
+    if (error instanceof PPEError) {
+      return reply.status(422).send({
+        error: "Processing Error",
+        message: error.message,
+        code: error.code,
+        statusCode: 422
+      });
+    }
+    return reply.status(500).send({
+      error: "Internal Server Error",
+      message: "An unexpected error occurred",
+      statusCode: 500
+    });
+  });
+  return app;
+}
+
+// src/server.ts
+async function start(partial) {
+  const config = resolveConfig(partial);
+  const app = createApp(partial);
+  const shutdown = async (signal) => {
+    app.log.info(`Received ${signal}, shutting down gracefully\u2026`);
+    await app.close();
+    process.exit(0);
+  };
+  process.on("SIGINT", () => void shutdown("SIGINT"));
+  process.on("SIGTERM", () => void shutdown("SIGTERM"));
+  await app.listen({ port: config.port, host: config.host });
+}
+export {
+  createApp,
+  resolveConfig,
+  start
+};
+//# sourceMappingURL=index.js.map