@siglo/fastify 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Jerico de guzman
+
+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

@@ -1,3 +1,187 @@
-# Temporary Holding Version
+# @siglo/fastify Adapter Guide
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@siglo/fastify` provides an idiomatic Fastify route handler adapter for executing `Siglo` workflows. It is optimized for high-throughput, low-overhead microservices, taking advantage of Fastify's asynchronous request lifecycle, schema validation, and raw Node.js HTTP stream signals for cooperative cancellation.
+
+---
+
+## 1. Overview & Architecture
+
+Fastify is designed for minimal overhead. The `@siglo/fastify` handler adapter integrates as a standard Fastify route handler:
+
+```mermaid
+flowchart TD
+    Req["Fastify HTTP Request"] --> Handler["sigloFastifyHandler<br/>• Extract request.body / query<br/>• Extract request.raw.signal (Native AbortSignal)<br/>• Mirror X-Correlation-Id<br/>• Resolve Tenant Namespace"]
+    Handler --> WF["Siglo Workflow<br/>• Typed Input Parameters<br/>• Timeout Deadlines<br/>• Subgraph Step Execution"]
+    WF -->|Success| Success["Set Stack ID<br/>Return JSON"]
+    WF -->|Error| Error["getErrorStatusCode(err)<br/>reply.status(code).send()"]
+```
+
+---
+
+## 2. Installation & Requirements
+
+Install `@siglo/fastify` alongside Fastify:
+
+```bash
+npm install @siglo/core @siglo/fastify fastify
+```
+
+Peer dependency matrix:
+- `Siglo`: `*` (v1.0.0+)
+- `fastify`: `^4.0.0 || ^5.0.0`
+
+---
+
+## 3. API Reference
+
+### `sigloFastifyHandler(workflow, options)`
+
+Creates a Fastify route handler `(request, reply) => Promise<any>`:
+
+```typescript
+function sigloFastifyHandler<TInput = any, TOutput = any, TReq = any>(
+    workflow: Flow<TInput, TOutput>,
+    options?: SigloFastifyOptions<TReq, TInput, TOutput>
+): (request: any, reply: any) => Promise<any>;
+```
+
+---
+
+## 4. Configuration Options (`SigloFastifyOptions`)
+
+| Option | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `input` | `(req: TReq) => Promise<TInput> \| TInput` | `request.body \|\| request.query` | Function transforming incoming Fastify request into workflow parameters. |
+| `output` | `(result: TOutput, reply: FastifyReply) => Promise<any> \| any` | `result` | Function formatting the final response. If omitted, Fastify serializes the clean result. |
+| `timeout` | `number` | `undefined` | Execution timeout in milliseconds. |
+| `namespace` | `string \| ((req: TReq) => string \| undefined)` | `undefined` | Namespace identifier or extractor function for tenant partitioning. |
+| `allowHeaderNamespace` | `boolean` | `false` | When true, permits extracting tenant namespace from incoming `x-namespace` headers. Keep disabled when client requests are untrusted. |
+| `exposeErrorDetails` | `boolean` | `process.env.NODE_ENV !== 'production'` | Controls whether 500 error messages expose internal details. In production, a generic `'Internal workflow execution error'` is returned. |
+| `onError` | `(err: any, reply: FastifyReply) => Promise<any> \| any` | Default JSON error handler | Custom error responder. If omitted, maps status codes and returns sanitized `{ error: message }`. |
+| `correlationIdHeader` | `string` | `'x-correlation-id'` | Header name for correlation propagation. |
+
+---
+
+## 5. Status Code Resolution & Error Semantics
+
+If a workflow throws an unhandled error and no `onError` hook is specified, the adapter automatically categorizes the error and formats the response:
+
+| Error Name / Hierarchy | Status Code | HTTP Status |
+| :--- | :--- | :--- |
+| `StepTimeoutException` / `FlowTimeoutException` | `504` | Gateway Timeout |
+| `ValidationException` / `SpecFailedException` | `400` | Bad Request |
+| `IdempotencyConflictException` | `409` | Conflict |
+| `CancellationException` / `AbortError` | `499` | Client Closed Request |
+| Other `Error` instances | `500` | Internal Server Error (sanitized in production) |
+
+*Default Error JSON Payload:*
+```json
+{
+  "error": "Timeout occurred while executing step 'chargeCustomer'"
+}
+```
+
+---
+
+## 6. Native Request Abort & Cooperative Cancellation
+
+Fastify exposes Node.js's native `request.raw.signal`. When an HTTP client aborts (e.g. closes connection or timeout occurs on the client proxy), Fastify emits an abort event on `request.raw.signal`.
+
+The adapter extracts `request.raw.signal` and attaches it to the workflow's `ExecutionOptions`. Any workflow step calling external APIs can link their child operations:
+
+```typescript
+const queryExternalAPI = Step.create(async (param) => {
+    const signal = param.$signal?.();
+    const res = await fetch('https://api.upstream.io/data', { signal });
+    return await res.json();
+});
+```
+
+---
+
+## 7. Complete Production Example
+
+```typescript
+import Fastify from 'fastify';
+import { Step, flow } from '@siglo/core';
+import { sigloFastifyHandler } from '@siglo/fastify';
+
+const fastify = Fastify({
+    logger: true,
+});
+
+// 1. Workflow Definition
+interface KYCInput {
+    customerId: string;
+    ssn: string;
+    country: string;
+}
+
+const verifyIdentity = Step.create('verifyIdentity', async (input: KYCInput) => {
+    if (!input.customerId || !input.ssn) {
+        const err = new Error('customerId and ssn are required');
+        err.name = 'ValidationException';
+        throw err;
+    }
+    return { verified: true, riskScore: 12 };
+});
+
+const runSanctionCheck = Step.create('runSanctionCheck', async (param: any) => {
+    // Upstream sanctions database check
+    return { sanctioned: false, clearanceId: `clear_${Date.now()}` };
+});
+
+const kycPipeline = flow(verifyIdentity, runSanctionCheck);
+
+// 2. Fastify Route Schema + Handler Adapter
+fastify.post(
+    '/api/v1/kyc/verify',
+    {
+        schema: {
+            body: {
+                type: 'object',
+                required: ['customerId', 'ssn'],
+                properties: {
+                    customerId: { type: 'string' },
+                    ssn: { type: 'string' },
+                    country: { type: 'string', default: 'US' },
+                },
+            },
+        },
+    },
+    sigloFastifyHandler(kycPipeline, {
+        timeout: 8000, // 8-second timeout SLA
+        correlationIdHeader: 'x-request-id',
+        namespace: (req) => req.headers['x-tenant-id'] as string,
+        output: (result, reply) => {
+            reply.status(200).send({
+                success: true,
+                clearanceId: result.clearanceId,
+                verified: result.verified,
+                riskScore: result.riskScore,
+            });
+        },
+        onError: (err, reply) => {
+            if (err.name === 'ValidationException') {
+                return reply.status(400).send({ error: err.message, type: 'BAD_REQUEST' });
+            }
+            if (err.name === 'StepTimeoutException') {
+                return reply.status(504).send({ error: 'KYC check timed out', type: 'TIMEOUT' });
+            }
+            reply.status(500).send({ error: 'KYC verification failed', detail: err.message });
+        },
+    })
+);
+
+// Start server
+const start = async () => {
+    try {
+        await fastify.listen({ port: 3000, host: '0.0.0.0' });
+    } catch (err) {
+        fastify.log.error(err);
+        process.exit(1);
+    }
+};
+
+start();
+```

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { Flow } from '@siglo/core';
+export interface SigloFastifyOptions<TReq = any, TInput = any, TOutput = any> {
+    input?: (req: TReq) => Promise<TInput> | TInput;
+    output?: (result: TOutput, reply: any) => Promise<any> | any;
+    timeout?: number;
+    namespace?: string | ((req: TReq) => string | undefined);
+    onError?: (err: any, reply: any) => Promise<any> | any;
+    correlationIdHeader?: string;
+    allowHeaderNamespace?: boolean;
+    exposeErrorDetails?: boolean;
+}
+export declare function getErrorStatusCode(err: any): number;
+/**
+ * Creates a Fastify route handler for executing a rivulet workflow.
+ */
+export declare function sigloFastifyHandler<TInput = any, TOutput = any, TReq = any>(workflow: Flow<TInput, TOutput>, options?: SigloFastifyOptions<TReq, TInput, TOutput>): (request: any, reply: any) => Promise<any>;
+export type RivuletFastifyOptions<TReq = any, TInput = any, TOutput = any> = SigloFastifyOptions<TReq, TInput, TOutput>;
+export declare const rivuletFastifyHandler: typeof sigloFastifyHandler;
+//# 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,EAAE,IAAI,EAAoB,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,mBAAmB,CAAC,IAAI,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACxE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACvD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAoBnD;AAiBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,EACvE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAM,aAEjC,GAAG,SAAS,GAAG,KAAG,OAAO,CAAC,GAAG,CAAC,CAgExD;AAGD,MAAM,MAAM,qBAAqB,CAAC,IAAI,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACxH,eAAO,MAAM,qBAAqB,4BAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rivuletFastifyHandler = void 0;
+exports.getErrorStatusCode = getErrorStatusCode;
+exports.sigloFastifyHandler = sigloFastifyHandler;
+function getErrorStatusCode(err) {
+    if (!err) {
+        return 500;
+    }
+    const name = err.name || '';
+    const causeName = err.cause?.name || (err.error?.name) || '';
+    if (err.isTimeout || name.includes('Timeout') || causeName.includes('Timeout')) {
+        return 504;
+    }
+    if (name.includes('SpecFailed') || name.includes('Validation') || causeName.includes('SpecFailed') || causeName.includes('Validation')) {
+        return 400;
+    }
+    if (name.includes('Idempotency') || name.includes('Conflict') || causeName.includes('Idempotency') || causeName.includes('Conflict')) {
+        return 409;
+    }
+    if (err.isCancellation || name.includes('Cancellation') || name.includes('Abort') || causeName.includes('Cancellation') || causeName.includes('Abort') || err.message?.includes('aborted')) {
+        return 499;
+    }
+    return typeof err.status === 'number' ? err.status : 500;
+}
+function unwrapContext(obj) {
+    if (!obj || typeof obj !== 'object') {
+        return obj;
+    }
+    const clean = {};
+    for (const key of Object.keys(obj)) {
+        if (key.startsWith('$')) {
+            continue;
+        }
+        const val = typeof obj[key] === 'function' ? (obj[key].val !== undefined ? obj[key].val : (obj[key].length === 0 ? obj[key]() : obj[key])) : obj[key];
+        clean[key] = val;
+    }
+    return clean;
+}
+/**
+ * Creates a Fastify route handler for executing a rivulet workflow.
+ */
+function sigloFastifyHandler(workflow, options = {}) {
+    return async (request, reply) => {
+        try {
+            // Correlation ID handling
+            const corrHeader = (options.correlationIdHeader || 'x-correlation-id').toLowerCase();
+            const correlationId = request.headers?.[corrHeader] || request.headers?.['x-request-id'];
+            if (correlationId && reply.header) {
+                reply.header('X-Correlation-Id', correlationId);
+            }
+            let inputData = {};
+            if (options.input) {
+                inputData = await options.input(request);
+            }
+            else if (request.body) {
+                inputData = request.body;
+            }
+            else if (request.query) {
+                inputData = request.query;
+            }
+            let namespace;
+            if (typeof options.namespace === 'function') {
+                namespace = options.namespace(request);
+            }
+            else if (options.namespace) {
+                namespace = options.namespace;
+            }
+            else if (options.allowHeaderNamespace && request.headers?.['x-namespace']) {
+                namespace = request.headers['x-namespace'];
+            }
+            const abortSignal = request.raw?.signal;
+            const execOptions = {
+                signal: abortSignal,
+                timeout: options.timeout,
+                namespace,
+            };
+            const rawResult = await workflow.run(inputData, execOptions);
+            const stackId = typeof rawResult?.$stackId === 'function'
+                ? rawResult.$stackId()
+                : (rawResult?.stackId || rawResult?.$stackId);
+            if (stackId && reply.header) {
+                reply.header('X-Workflow-Stack-Id', stackId);
+            }
+            const cleanResult = unwrapContext(rawResult);
+            if (options.output) {
+                return await options.output(cleanResult, reply);
+            }
+            return cleanResult;
+        }
+        catch (err) {
+            if (options.onError) {
+                return await options.onError(err, reply);
+            }
+            const status = getErrorStatusCode(err);
+            const exposeDetails = options.exposeErrorDetails ?? (process.env.NODE_ENV !== 'production');
+            let errorMessage = err.message || 'Workflow execution error';
+            if (status === 500 && !exposeDetails) {
+                errorMessage = 'Internal workflow execution error';
+            }
+            return reply.status(status).send({ error: errorMessage });
+        }
+    };
+}
+exports.rivuletFastifyHandler = sigloFastifyHandler;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@siglo/fastify",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Fastify route handler adapter for executing Siglo workflows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && mocha -r tsx 'src/**/*.test.ts'"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsoftgem/siglo.git",
+    "directory": "packages/fastify"
+  },
+  "author": "Jerico de Guzman",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jsoftgem/siglo/issues"
+  },
+  "homepage": "https://github.com/jsoftgem/siglo#readme",
+  "dependencies": {
+    "@siglo/core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "fastify": "^4.0.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "fastify": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^26.6.5",
+    "chai": "^3.5.0",
+    "mocha": "^12.0.3",
+    "tsx": "^4.23.15",
+    "typescript": "~5.7.0"
+  }
+}