fastify-effect-runtime 0.0.1

package/README.md

@@ -0,0 +1,54 @@
+# `fastify-effect-runtime`
+
+Library for integrating effect runtime into fastify
+
+## Installation
+
+```sh
+npm i fastify-effect-runtime
+# yarn add fastify-effect-runtime
+# pnpm add fastify-effect-runtime
+```
+
+## Usage
+
+
+Register the plugin:
+
+```js
+import { Layer } from 'effect'
+import fastifyEffectRuntime from 'fastify-effect-runtime'
+
+const app = fastify()
+
+await app.register(fastifyEffectRuntime, {
+  layers: Layer.mergeAll(YourFirstLayer, YourSecondLayer)
+})
+```
+
+Use effect inside of routes:
+
+```js
+import { withEffect } from 'fastify-effect-runtime'
+
+app.get('/health',
+  withEffect((_, reply) =>
+    Effect.succeed(
+      reply.status(200).send({ status: 'ok!' })
+    )
+  )
+)
+```
+
+## Contributing
+
+
+If you want to contribute to improving the project, firstly read [CONTRIBUTING.md](https://github.com/OneLiL05/fastify-effect-runtime/blob/main/CONTRIBUTING.md)
+
+## Stay in touch
+
+Author - [Kyrylo Savieliev](https://github.com/OneLiL05)
+
+## License
+
+`fastify-effect-runtime` is [MIT licensed](https://github.com/OneLiL05/fastify-effect-runtime/blob/main/LICENSE)

package/dist/index.d.mts

@@ -0,0 +1,23 @@
+import { Effect, Layer, Runtime, Scope } from "effect";
+import { FastifyPluginCallback, FastifyReply, FastifyRequest } from "fastify";
+
+//#region src/utils.d.ts
+declare const withEffect: <A, E, R extends FastifyRequest = FastifyRequest>(handler: (request: R, reply: FastifyReply) => Effect.Effect<A, E, unknown>) => (request: R, reply: FastifyReply) => Promise<A>;
+//#endregion
+//#region src/index.d.ts
+interface FastifyEffectOptions<R = any> {
+  layer: Layer.Layer<R, never, any>;
+}
+declare module "fastify" {
+  interface FastifyInstance {
+    effectRuntime: Runtime.Runtime<unknown>;
+    effectScope: Scope.CloseableScope;
+  }
+  interface FastifyRequest {
+    effectScope?: Runtime.Runtime<unknown>;
+  }
+}
+declare const fastifyEffectPlugin: FastifyPluginCallback<FastifyEffectOptions<any>>;
+//#endregion
+export { fastifyEffectPlugin as default, withEffect };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":["fastifyEffectPlugin: FastifyPluginCallback<FastifyEffectOptions<any>>"],"sources":["../src/utils.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;cAkBM,gBAjB4C,CAAA,EAiBd,UAAA,cAAA,GAAiB,cAAjB,CAAiB,CAAA,OAAA,EAAA,CAAA,OAAA,EAChC,CADgC,EAAA,KAAA,EACtB,YADsB,EAAA,GACL,MAAA,CAAO,MADF,CACS,CADT,EACY,CADZ,EAAA,OAAA,CAAA,EAAA,GAAA,CAAA,OAAA,EAG5B,CAH4B,EAAA,KAAA,EAGlB,YAHkB,EAAA,GAGH,OAHG,CAGK,CAHL,CAAA;;;UCd3C;SAEF,KAAA,CAAM,MAAM;ADL8B;eAiBd,SAAA,CAAA;EAAiB,UAAA,eAAA,CAAA;IAChC,aAAA,ECJJ,OAAA,CAAQ,ODIJ,CAAA,OAAA,CAAA;IAAU,WAAA,ECHhB,KAAA,CAAM,cDGU;EAA+B;EAAG,UAAA,cAAA,CAAA;IAAjB,WAAO,CAAA,ECCvC,OAAA,CAAQ,ODD+B,CAAA,OAAA,CAAA;EAE9B;;cCoDnBA,mBDpDoD,ECoD/B,qBDpD+B,CCoDT,oBDpDS,CAAA,GAAA,CAAA,CAAA"}

package/dist/index.mjs

@@ -0,0 +1,51 @@
+import { Cause, Effect, Exit, Layer, Runtime, Scope } from "effect";
+import fp from "fastify-plugin";
+
+//#region src/utils.ts
+const handleEffectResult = (exit, reply) => {
+	if (Exit.isSuccess(exit)) return exit.value;
+	if (Cause.isDie(exit.cause)) return reply.status(500).send({ error: "Internal server error" });
+	return reply.status(500).send({ error: "An error occurred" });
+};
+const withEffect = (handler) => {
+	return async (request, reply) => {
+		if (!request.effectScope) return reply.status(500).send({ error: "Effect runtime not available" });
+		const program = handler(request, reply);
+		return handleEffectResult(await Runtime.runPromiseExit(request.effectScope)(program), reply);
+	};
+};
+
+//#endregion
+//#region src/index.ts
+const fastifyEffectRuntime = (fastify, opts, next) => {
+	fastify.decorate("effectRuntime", void 0);
+	fastify.decorate("effectScope", void 0);
+	fastify.decorateRequest("effectScope", void 0);
+	fastify.decorateRequest("runEffect", void 0);
+	fastify.addHook("onReady", async function effectOnReady() {
+		const scope = Effect.runSync(Scope.make());
+		fastify.effectRuntime = await Effect.runPromise(Layer.toRuntime(opts.layer).pipe(Effect.scoped, Scope.extend(scope)));
+		fastify.effectScope = scope;
+	});
+	fastify.addHook("onRequest", async function createEffectScope(request) {
+		const requestRuntime = fastify.effectRuntime;
+		if (!requestRuntime) throw new Error("Effect runtime is not initialized");
+		request.effectScope = requestRuntime;
+	});
+	fastify.addHook("onClose", async function effectOnClose() {
+		if (fastify.effectScope) try {
+			await Effect.runPromise(Scope.close(fastify.effectScope, Exit.void));
+		} catch (error) {
+			throw error;
+		}
+	});
+	next();
+};
+const fastifyEffectPlugin = fp(fastifyEffectRuntime, {
+	name: "fastify-effect",
+	fastify: "5.x"
+});
+
+//#endregion
+export { fastifyEffectPlugin as default, withEffect };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["fastifyEffectRuntime: FastifyPluginCallback<FastifyEffectOptions>","fastifyEffectPlugin: FastifyPluginCallback<FastifyEffectOptions<any>>"],"sources":["../src/utils.ts","../src/index.ts"],"sourcesContent":["import { Cause, Effect, Exit, Runtime } from \"effect\"\nimport type { FastifyReply, FastifyRequest } from \"fastify\"\n\nconst handleEffectResult = <A, E>(\n  exit: Exit.Exit<A, E>,\n  reply: FastifyReply,\n): FastifyReply | A => {\n  if (Exit.isSuccess(exit)) {\n    return exit.value\n  }\n\n  if (Cause.isDie(exit.cause)) {\n    return reply.status(500).send({ error: 'Internal server error' })\n  }\n\n  return reply.status(500).send({ error: 'An error occurred' })\n}\n\nconst withEffect = <A, E, R extends FastifyRequest = FastifyRequest>(\n  handler: (request: R, reply: FastifyReply) => Effect.Effect<A, E, unknown>,\n) => {\n  return async (request: R, reply: FastifyReply): Promise<A> => {\n    if (!request.effectScope) {\n      return reply.status(500).send({ error: 'Effect runtime not available' })\n    }\n\n    const program = handler(request, reply)\n    const exit = await Runtime.runPromiseExit(request.effectScope)(program)\n\n    return handleEffectResult(exit, reply)\n  }\n}\n\nexport { withEffect }\n","import { Effect, Exit, Layer, Runtime, Scope } from \"effect\"\nimport type { FastifyPluginCallback, FastifyRequest } from \"fastify\"\nimport fp from \"fastify-plugin\"\n\ninterface FastifyEffectOptions<R = any> {\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tlayer: Layer.Layer<R, never, any>\n}\n\ninterface FastifyRequestWithEffect extends FastifyRequest {\n\teffectScope: Runtime.Runtime<unknown>\n}\n\ndeclare module 'fastify' {\n\tinterface FastifyInstance {\n\t\teffectRuntime: Runtime.Runtime<unknown>\n\t\teffectScope: Scope.CloseableScope\n\t}\n\n\tinterface FastifyRequest {\n\t\teffectScope?: Runtime.Runtime<unknown>\n\t}\n}\n\nconst fastifyEffectRuntime: FastifyPluginCallback<FastifyEffectOptions> = (\n  fastify,\n\topts,\n  next\n) => {\n  fastify.decorate(\n\t\t'effectRuntime',\n\t\tundefined as unknown as Runtime.Runtime<unknown>,\n\t)\n\tfastify.decorate('effectScope', undefined as unknown as Scope.CloseableScope)\n\n\tfastify.decorateRequest('effectScope', undefined)\n\tfastify.decorateRequest('runEffect', undefined)\n\n\tfastify.addHook('onReady', async function effectOnReady() {\n\t\tconst scope = Effect.runSync(Scope.make())\n\n\t\tconst runtime = await Effect.runPromise(\n\t\t\t// @ts-expect-error will be fixed when any type will not be used anymore\n\t\t\tLayer.toRuntime(opts.layer).pipe(Effect.scoped, Scope.extend(scope)),\n\t\t)\n\n\t\tfastify.effectRuntime = runtime\n\t\tfastify.effectScope = scope\n\t})\n\n\tfastify.addHook('onRequest', async function createEffectScope(request) {\n\t\tconst requestRuntime = fastify.effectRuntime\n\n\t\tif (!requestRuntime) {\n\t\t\tthrow new Error('Effect runtime is not initialized')\n\t\t}\n\n\t\t;(request as FastifyRequestWithEffect).effectScope = requestRuntime\n\t})\n\n\tfastify.addHook('onClose', async function effectOnClose() {\n\t\tif (fastify.effectScope) {\n\t\t\ttry {\n\t\t\t\tawait Effect.runPromise(Scope.close(fastify.effectScope, Exit.void))\n\t\t\t} catch (error) {\n\t\t\t\tthrow error\n\t\t\t}\n\t\t}\n\t})\n\n\tnext()\n}\n\nconst fastifyEffectPlugin: FastifyPluginCallback<FastifyEffectOptions<any>> = fp(fastifyEffectRuntime, {\n\tname: 'fastify-effect',\n\tfastify: '5.x',\n})\n\nexport { withEffect } from './utils.js'\nexport { fastifyEffectPlugin as default }\n"],"mappings":";;;;AAGA,MAAM,sBACJ,MACA,UACqB;AACrB,KAAI,KAAK,UAAU,KAAK,CACtB,QAAO,KAAK;AAGd,KAAI,MAAM,MAAM,KAAK,MAAM,CACzB,QAAO,MAAM,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,yBAAyB,CAAC;AAGnE,QAAO,MAAM,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,qBAAqB,CAAC;;AAG/D,MAAM,cACJ,YACG;AACH,QAAO,OAAO,SAAY,UAAoC;AAC5D,MAAI,CAAC,QAAQ,YACX,QAAO,MAAM,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,gCAAgC,CAAC;EAG1E,MAAM,UAAU,QAAQ,SAAS,MAAM;AAGvC,SAAO,mBAFM,MAAM,QAAQ,eAAe,QAAQ,YAAY,CAAC,QAAQ,EAEvC,MAAM;;;;;;ACL1C,MAAMA,wBACJ,SACD,MACC,SACG;AACH,SAAQ,SACR,iBACA,OACA;AACD,SAAQ,SAAS,eAAe,OAA6C;AAE7E,SAAQ,gBAAgB,eAAe,OAAU;AACjD,SAAQ,gBAAgB,aAAa,OAAU;AAE/C,SAAQ,QAAQ,WAAW,eAAe,gBAAgB;EACzD,MAAM,QAAQ,OAAO,QAAQ,MAAM,MAAM,CAAC;AAO1C,UAAQ,gBALQ,MAAM,OAAO,WAE5B,MAAM,UAAU,KAAK,MAAM,CAAC,KAAK,OAAO,QAAQ,MAAM,OAAO,MAAM,CAAC,CACpE;AAGD,UAAQ,cAAc;GACrB;AAEF,SAAQ,QAAQ,aAAa,eAAe,kBAAkB,SAAS;EACtE,MAAM,iBAAiB,QAAQ;AAE/B,MAAI,CAAC,eACJ,OAAM,IAAI,MAAM,oCAAoC;AAGpD,EAAC,QAAqC,cAAc;GACpD;AAEF,SAAQ,QAAQ,WAAW,eAAe,gBAAgB;AACzD,MAAI,QAAQ,YACX,KAAI;AACH,SAAM,OAAO,WAAW,MAAM,MAAM,QAAQ,aAAa,KAAK,KAAK,CAAC;WAC5D,OAAO;AACf,SAAM;;GAGP;AAEF,OAAM;;AAGP,MAAMC,sBAAwE,GAAG,sBAAsB;CACtG,MAAM;CACN,SAAS;CACT,CAAC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+	"name": "fastify-effect-runtime",
+	"version": "0.0.1",
+	"type": "module",
+	"description": "Library for integrating Effect runtime into fastify",
+	"scripts": {
+		"build": "tsdown"
+	},
+	"keywords": [
+		"fastify",
+		"node.js",
+		"effect"
+	],
+	"author": "Kyrylo Savieliev <k_savieliev@icloud.com>",
+	"homepage": "https://github.com/OneLiL05/fastify-effect-runtime",
+	"maintainers": [
+		{
+			"name": "Kyrylo Savieliev",
+			"url": "https://github.com/OneLiL05"
+		}
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+ssh://git@github.com/OneLiL05/fastify-effect-runtime.git"
+	},
+	"bugs": {
+		"url": "https://github.com/OneLiL05/fastify-effect-runtime/issues"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"license": "MIT",
+	"exports": {
+		".": "./dist/index.mjs",
+		"./package.json": "./package.json"
+	},
+	"main": "./dist/index.mjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.mts",
+	"files": [
+		"dist"
+	],
+	"lint-staged": {
+		"**/*.{js,ts,tsx}": [
+			"eslint --fix"
+		],
+		"**/*": "prettier --write --ignore-unknown"
+	},
+	"dependencies": {
+		"fastify-plugin": "^5.1.0"
+	},
+	"devDependencies": {
+		"@commitlint/cli": "^20.2.0",
+		"@commitlint/config-conventional": "^20.2.0",
+		"@types/node": "^25.0.3",
+		"@typescript-eslint/eslint-plugin": "^8.50.1",
+		"@typescript-eslint/parser": "^8.50.1",
+		"eslint": "^9.39.2",
+		"eslint-config-prettier": "^10.1.8",
+		"eslint-plugin-prettier": "^5.5.4",
+		"globals": "^16.5.0",
+		"husky": "^9.1.7",
+		"lint-staged": "^16.2.7",
+		"prettier": "^3.7.4",
+		"tsdown": "^0.18.3",
+		"typescript": "^5.9.3"
+	},
+	"peerDependencies": {
+		"effect": ">=3.0.0",
+		"fastify": ">=5.0.0"
+	},
+	"packageManager": "pnpm@10.22.0",
+	"private": false
+}