init effect solutions

Rhys Sullivan committed 7 months ago

Commit c78d00fNo parent (first commit)13 files · +279 −0Browse files

Unified · Split

13 files

.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc +1 −0
.gitignore +34 −0
.reference/effect +1 −0
.reference/effect-atom +1 −0
.reference/executor +1 −0
.vscode/settings.json +4 −0
AGENTS.md +1 −0
CLAUDE.md +125 −0
README.md +15 −0
bun.lock +40 −0
index.ts +1 −0
package.json +20 −0
tsconfig.json +35 −0

.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc+1−0

@@ -0,0 +1 @@
	1	+../../CLAUDE.md

.gitignore+34−0

@@ -0,0 +1,34 @@
	1	+# dependencies (bun install)
	2	+node_modules
	3	+
	4	+# output
	5	+out
	6	+dist
	7	+*.tgz
	8	+
	9	+# code coverage
	10	+coverage
	11	+*.lcov
	12	+
	13	+# logs
	14	+logs
	15	+_.log
	16	+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
	17	+
	18	+# dotenv environment variable files
	19	+.env
	20	+.env.development.local
	21	+.env.test.local
	22	+.env.production.local
	23	+.env.local
	24	+
	25	+# caches
	26	+.eslintcache
	27	+.cache
	28	+*.tsbuildinfo
	29	+
	30	+# IntelliJ based IDEs
	31	+.idea
	32	+
	33	+# Finder (MacOS) folder config
	34	+.DS_Store

.reference/effect+1−0

@@ -0,0 +1 @@
	1	+Subproject commit ec5c50507b1a2f5ad712c148a7da0fadb8cb9f52

.reference/effect-atom+1−0

@@ -0,0 +1 @@
	1	+Subproject commit 957095fdfc930eae666f78d65f7af8584959bffd

.reference/executor+1−0

@@ -0,0 +1 @@
	1	+Subproject commit 2d532f8322368eedc835fa09dc9223a9ddef9e1d

.vscode/settings.json+4−0

@@ -0,0 +1,4 @@
	1	+{
	2	+ "typescript.tsdk": "./node_modules/typescript/lib",
	3	+ "typescript.enablePromptUseWorkspaceTsdk": true
	4	+}

AGENTS.md+1−0

@@ -0,0 +1 @@
	1	+CLAUDE.md

CLAUDE.md+125−0

@@ -0,0 +1,125 @@
	1	+---
	2	+description: Use Bun instead of Node.js, npm, pnpm, or vite.
	3	+globs: ".ts, .tsx, .html, .css, .js, .jsx, package.json"
	4	+alwaysApply: false
	5	+---
	6	+
	7	+Default to using Bun instead of Node.js.
	8	+
	9	+- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
	10	+- Use `bun test` instead of `jest` or `vitest`
	11	+- Use `bun build <file.html\|file.ts\|file.css>` instead of `webpack` or `esbuild`
	12	+- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
	13	+- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
	14	+- Use `bunx <package> <command>` instead of `npx <package> <command>`
	15	+- Bun automatically loads .env, so don't use dotenv.
	16	+
	17	+## APIs
	18	+
	19	+- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
	20	+- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
	21	+- `Bun.redis` for Redis. Don't use `ioredis`.
	22	+- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
	23	+- `WebSocket` is built-in. Don't use `ws`.
	24	+- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
	25	+- Bun.$`ls` instead of execa.
	26	+
	27	+## Testing
	28	+
	29	+Use `bun test` to run tests.
	30	+
	31	+```ts#index.test.ts
	32	+import { test, expect } from "bun:test";
	33	+
	34	+test("hello world", () => {
	35	+ expect(1).toBe(1);
	36	+});
	37	+```
	38	+
	39	+## Frontend
	40	+
	41	+Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
	42	+
	43	+Server:
	44	+
	45	+```ts#index.ts
	46	+import index from "./index.html"
	47	+
	48	+Bun.serve({
	49	+ routes: {
	50	+ "/": index,
	51	+ "/api/users/:id": {
	52	+ GET: (req) => {
	53	+ return new Response(JSON.stringify({ id: req.params.id }));
	54	+ },
	55	+ },
	56	+ },
	57	+ // optional websocket support
	58	+ websocket: {
	59	+ open: (ws) => {
	60	+ ws.send("Hello, world!");
	61	+ },
	62	+ message: (ws, message) => {
	63	+ ws.send(message);
	64	+ },
	65	+ close: (ws) => {
	66	+ // handle close
	67	+ }
	68	+ },
	69	+ development: {
	70	+ hmr: true,
	71	+ console: true,
	72	+ }
	73	+})
	74	+```
	75	+
	76	+HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
	77	+
	78	+```html#index.html
	79	+<html>
	80	+ <body>
	81	+ <h1>Hello, world!</h1>
	82	+ <script type="module" src="./frontend.tsx"></script>
	83	+ </body>
	84	+</html>
	85	+```
	86	+
	87	+With the following `frontend.tsx`:
	88	+
	89	+```tsx#frontend.tsx
	90	+import React from "react";
	91	+import { createRoot } from "react-dom/client";
	92	+
	93	+// import .css files directly and it works
	94	+import './index.css';
	95	+
	96	+const root = createRoot(document.body);
	97	+
	98	+export default function Frontend() {
	99	+ return <h1>Hello, world!</h1>;
	100	+}
	101	+
	102	+root.render(<Frontend />);
	103	+```
	104	+
	105	+Then, run index.ts
	106	+
	107	+```sh
	108	+bun --hot ./index.ts
	109	+```
	110	+
	111	+For more information, read the Bun API docs in `node_modules/bun-types/docs/**.mdx`.
	112	+
	113	+<!-- effect-solutions:start -->
	114	+## Effect Best Practices
	115	+
	116	+IMPORTANT: Always consult effect-solutions before writing Effect code.
	117	+
	118	+1. Run `effect-solutions list` to see available guides
	119	+2. Run `effect-solutions show <topic>...` for relevant patterns (supports multiple topics)
	120	+3. Search `~/.local/share/effect-solutions/effect` for real implementations
	121	+
	122	+Topics: quick-start, project-setup, tsconfig, basics, services-and-layers, data-modeling, error-handling, config, testing, cli.
	123	+
	124	+Never guess at Effect patterns - check the guide first.
	125	+<!-- effect-solutions:end -->

README.md+15−0

@@ -0,0 +1,15 @@
	1	+# v4-executor
	2	+
	3	+To install dependencies:
	4	+
	5	+```bash
	6	+bun install
	7	+```
	8	+
	9	+To run:
	10	+
	11	+```bash
	12	+bun run index.ts
	13	+```
	14	+
	15	+This project was created using `bun init` in bun v1.3.9. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

bun.lock+40−0

@@ -0,0 +1,40 @@
	1	+{
	2	+ "lockfileVersion": 1,
	3	+ "configVersion": 1,
	4	+ "workspaces": {
	5	+ "": {
	6	+ "name": "v4-executor",
	7	+ "dependencies": {
	8	+ "effect": "^3.21.0",
	9	+ },
	10	+ "devDependencies": {
	11	+ "@effect/language-service": "^0.84.2",
	12	+ "@types/bun": "latest",
	13	+ },
	14	+ "peerDependencies": {
	15	+ "typescript": "^5",
	16	+ },
	17	+ },
	18	+ },
	19	+ "packages": {
	20	+ "@effect/language-service": ["@effect/language-service@0.84.2", "", { "bin": { "effect-language-service": "cli.js" } }, "sha512-l04qNxpiA8rY5yXWckRPJ7Mk5MNerXuNymSFf+IdflfI5i8jgL1bpBNLuP6ijg7wgjdHc/KmTnCj2kT0SCntuA=="],
	21	+
	22	+ "@standard-schema/spec": ["@standard-schema/spec@1.1.0", "", {}, "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w=="],
	23	+
	24	+ "@types/bun": ["@types/bun@1.3.11", "", { "dependencies": { "bun-types": "1.3.11" } }, "sha512-5vPne5QvtpjGpsGYXiFyycfpDF2ECyPcTSsFBMa0fraoxiQyMJ3SmuQIGhzPg2WJuWxVBoxWJ2kClYTcw/4fAg=="],
	25	+
	26	+ "@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
	27	+
	28	+ "bun-types": ["bun-types@1.3.11", "", { "dependencies": { "@types/node": "*" } }, "sha512-1KGPpoxQWl9f6wcZh57LvrPIInQMn2TQ7jsgxqpRzg+l0QPOFvJVH7HmvHo/AiPgwXy+/Thf6Ov3EdVn1vOabg=="],
	29	+
	30	+ "effect": ["effect@3.21.0", "", { "dependencies": { "@standard-schema/spec": "^1.0.0", "fast-check": "^3.23.1" } }, "sha512-PPN80qRokCd1f015IANNhrwOnLO7GrrMQfk4/lnZRE/8j7UPWrNNjPV0uBrZutI/nHzernbW+J0hdqQysHiSnQ=="],
	31	+
	32	+ "fast-check": ["fast-check@3.23.2", "", { "dependencies": { "pure-rand": "^6.1.0" } }, "sha512-h5+1OzzfCC3Ef7VbtKdcv7zsstUQwUDlYpUTvjeUsJAssPgLn7QzbboPtL5ro04Mq0rPOsMzl7q5hIbRs2wD1A=="],
	33	+
	34	+ "pure-rand": ["pure-rand@6.1.0", "", {}, "sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA=="],
	35	+
	36	+ "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
	37	+
	38	+ "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
	39	+ }
	40	+}

index.ts+1−0

@@ -0,0 +1 @@
	1	+console.log("Hello via Bun!");

package.json+20−0

@@ -0,0 +1,20 @@
	1	+{
	2	+ "name": "v4-executor",
	3	+ "module": "index.ts",
	4	+ "type": "module",
	5	+ "private": true,
	6	+ "scripts": {
	7	+ "prepare": "effect-language-service patch",
	8	+ "typecheck": "tsc --noEmit"
	9	+ },
	10	+ "devDependencies": {
	11	+ "@effect/language-service": "^0.84.2",
	12	+ "@types/bun": "latest"
	13	+ },
	14	+ "peerDependencies": {
	15	+ "typescript": "^5"
	16	+ },
	17	+ "dependencies": {
	18	+ "effect": "^3.21.0"
	19	+ }
	20	+}

tsconfig.json+35−0

@@ -0,0 +1,35 @@
	1	+{
	2	+ "compilerOptions": {
	3	+ // Environment setup & latest features
	4	+ "lib": ["ESNext"],
	5	+ "target": "ESNext",
	6	+ "module": "Preserve",
	7	+ "moduleDetection": "force",
	8	+ "jsx": "react-jsx",
	9	+ "allowJs": true,
	10	+
	11	+ // Bundler mode
	12	+ "moduleResolution": "bundler",
	13	+ "allowImportingTsExtensions": true,
	14	+ "verbatimModuleSyntax": true,
	15	+ "noEmit": true,
	16	+
	17	+ // Best practices
	18	+ "strict": true,
	19	+ "skipLibCheck": true,
	20	+ "noFallthroughCasesInSwitch": true,
	21	+ "noUncheckedIndexedAccess": true,
	22	+ "noImplicitOverride": true,
	23	+ "exactOptionalPropertyTypes": true,
	24	+ "noUnusedLocals": true,
	25	+ "sourceMap": true,
	26	+ "declarationMap": true,
	27	+
	28	+ // Effect Language Service
	29	+ "plugins": [
	30	+ {
	31	+ "name": "@effect/language-service"
	32	+ }
	33	+ ]
	34	+ }
	35	+}