[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CJYGA31CP1EXTVRFSYP8QV":3,"skill-same:01M7CJYGA31CP1EXTVRFSYP8QV":60},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":40,"repositoryHtmlUrl":41,"repositoryHomepageUrl":42,"ownerHtmlUrl":43,"ownerBlogUrl":6,"ownerDescription":44,"updatedAt":45,"install":46,"resources":59},"01M7CJYGA31CP1EXTVRFSYP8QV","fp-backend",null,"Functional programming patterns for Node.js\u002FDeno backend development using fp-ts, ReaderTaskEither, and functional dependency injection","YYC-Cube\u002FYYC3-Knowledge-Base","YYC-Cube","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F235006543?v=4","01M79J2PH4SWD2X0825X6PN748","yyc3","01M79J2PHVK3F6ZBYT8K2SCZCW",1,"MIT","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Skills-技能包\u002FYYC3-Skills-技能包-antigravity-awesome-skills\u002Fskills\u002Ffp-backend\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: fp-backend\ndescription: Functional programming patterns for Node.js\u002FDeno backend development using fp-ts, ReaderTaskEither, and functional dependency injection\nrisk: unknown\nsource: community\nversion: 1.0.0\nauthor: kadu\ntags:\n  - fp-ts\n  - typescript\n  - backend\n  - functional-programming\n  - node\n  - deno\n  - dependency-injection\n  - reader-task-either\n---\n\n# fp-ts Backend Patterns\n\nFunctional programming patterns for building type-safe, testable backend services using fp-ts.\n\n## When to Use\n- You are building or refactoring a Node.js or Deno backend with fp-ts.\n- The task involves dependency injection, service composition, or typed backend errors with `ReaderTaskEither`.\n- You need functional backend architecture patterns rather than isolated utility snippets.\n\n## Core Concepts\n\n### ReaderTaskEither (RTE)\n\nThe `ReaderTaskEither\u003CR, E, A>` type is the backbone of functional backend development:\n- **R** (Reader): Dependencies\u002Fenvironment (database, config, logger)\n- **E** (Either left): Error type\n- **A** (Either right): Success value\n\n```typescript\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Define your dependencies\ntype Deps = {\n  db: DatabaseClient\n  logger: Logger\n  config: Config\n}\n\n\u002F\u002F Define domain errors\ntype AppError =\n  | { _tag: 'NotFound'; resource: string; id: string }\n  | { _tag: 'ValidationError'; message: string }\n  | { _tag: 'DatabaseError'; cause: unknown }\n  | { _tag: 'Unauthorized'; reason: string }\n\n\u002F\u002F A service function\nconst getUser = (id: string): RTE.ReaderTaskEither\u003CDeps, AppError, User> =>\n  pipe(\n    RTE.ask\u003CDeps>(),\n    RTE.flatMap(({ db, logger }) =>\n      pipe(\n        RTE.fromTaskEither(db.users.findById(id)),\n        RTE.mapLeft((e): AppError => ({ _tag: 'DatabaseError', cause: e })),\n        RTE.flatMap(user =>\n          user\n            ? RTE.right(user)\n            : RTE.left({ _tag: 'NotFound', resource: 'User', id })\n        ),\n        RTE.tap(user => RTE.fromIO(() => logger.info(`Found user: ${user.id}`)))\n      )\n    )\n  )\n```\n\n## Service Layer Patterns\n\n### Defining Service Modules\n\nStructure services as modules exporting RTE functions:\n\n```typescript\n\u002F\u002F src\u002Fservices\u002Fuser.service.ts\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as A from 'fp-ts\u002FArray'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\ntype UserDeps = {\n  db: DatabaseClient\n  hasher: PasswordHasher\n  mailer: EmailService\n}\n\ntype UserError =\n  | { _tag: 'UserNotFound'; id: string }\n  | { _tag: 'EmailExists'; email: string }\n  | { _tag: 'InvalidPassword' }\n\n\u002F\u002F Create user\nexport const create = (\n  input: CreateUserInput\n): RTE.ReaderTaskEither\u003CUserDeps, UserError, User> =>\n  pipe(\n    RTE.ask\u003CUserDeps>(),\n    RTE.flatMap(({ db, hasher }) =>\n      pipe(\n        \u002F\u002F Check email uniqueness\n        checkEmailUnique(input.email),\n        RTE.flatMap(() =>\n          RTE.fromTaskEither(hasher.hash(input.password))\n        ),\n        RTE.flatMap(hashedPassword =>\n          RTE.fromTaskEither(\n            db.users.create({\n              ...input,\n              password: hashedPassword,\n            })\n          )\n        )\n      )\n    )\n  )\n\n\u002F\u002F Find by ID\nexport const findById = (\n  id: string\n): RTE.ReaderTaskEither\u003CUserDeps, UserError, User> =>\n  pipe(\n    RTE.ask\u003CUserDeps>(),\n    RTE.flatMap(({ db }) =>\n      pipe(\n        RTE.fromTaskEither(db.users.findUnique({ where: { id } })),\n        RTE.flatMap(user =>\n          user\n            ? RTE.right(user)\n            : RTE.left({ _tag: 'UserNotFound' as const, id })\n        )\n      )\n    )\n  )\n\n\u002F\u002F Find many with pagination\nexport const findMany = (\n  params: PaginationParams\n): RTE.ReaderTaskEither\u003CUserDeps, UserError, PaginatedResult\u003CUser>> =>\n  pipe(\n    RTE.ask\u003CUserDeps>(),\n    RTE.flatMap(({ db }) =>\n      RTE.fromTaskEither(\n        pipe(\n          TE.Do,\n          TE.bind('users', () => db.users.findMany({\n            skip: params.offset,\n            take: params.limit,\n          })),\n          TE.bind('total', () => db.users.count()),\n          TE.map(({ users, total }) => ({\n            data: users,\n            total,\n            ...params,\n          }))\n        )\n      )\n    )\n  )\n\nconst checkEmailUnique = (\n  email: string\n): RTE.ReaderTaskEither\u003CUserDeps, UserError, void> =>\n  pipe(\n    RTE.ask\u003CUserDeps>(),\n    RTE.flatMap(({ db }) =>\n      pipe(\n        RTE.fromTaskEither(db.users.findUnique({ where: { email } })),\n        RTE.flatMap(existing =>\n          existing\n            ? RTE.left({ _tag: 'EmailExists' as const, email })\n            : RTE.right(undefined)\n        )\n      )\n    )\n  )\n```\n\n### Composing Services\n\n```typescript\n\u002F\u002F src\u002Fservices\u002Forder.service.ts\nimport * as UserService from '.\u002Fuser.service'\nimport * as ProductService from '.\u002Fproduct.service'\nimport * as PaymentService from '.\u002Fpayment.service'\n\ntype OrderDeps = UserService.UserDeps &\n  ProductService.ProductDeps &\n  PaymentService.PaymentDeps & {\n    db: DatabaseClient\n  }\n\nexport const createOrder = (\n  userId: string,\n  items: OrderItem[]\n): RTE.ReaderTaskEither\u003COrderDeps, OrderError, Order> =>\n  pipe(\n    RTE.Do,\n    \u002F\u002F Validate user exists\n    RTE.bind('user', () =>\n      pipe(\n        UserService.findById(userId),\n        RTE.mapLeft(toOrderError)\n      )\n    ),\n    \u002F\u002F Validate and get products\n    RTE.bind('products', () =>\n      pipe(\n        items,\n        A.traverse(RTE.ApplicativePar)(item =>\n          ProductService.findById(item.productId)\n        ),\n        RTE.mapLeft(toOrderError)\n      )\n    ),\n    \u002F\u002F Calculate total\n    RTE.bind('total', ({ products }) =>\n      RTE.right(calculateTotal(products, items))\n    ),\n    \u002F\u002F Process payment\n    RTE.bind('payment', ({ user, total }) =>\n      pipe(\n        PaymentService.charge(user, total),\n        RTE.mapLeft(toOrderError)\n      )\n    ),\n    \u002F\u002F Create order\n    RTE.flatMap(({ user, products, total, payment }) =>\n      createOrderRecord(user, products, items, total, payment)\n    )\n  )\n```\n\n## Functional Dependency Injection\n\n### Building the Dependency Container\n\n```typescript\n\u002F\u002F src\u002Fdeps.ts\nimport { pipe } from 'fp-ts\u002Ffunction'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\n\n\u002F\u002F Layer 0: Config (no dependencies)\ntype Config = {\n  database: { url: string; poolSize: number }\n  redis: { url: string }\n  jwt: { secret: string; expiresIn: string }\n}\n\nconst loadConfig = (): TE.TaskEither\u003CError, Config> =>\n  TE.tryCatch(\n    async () => ({\n      database: {\n        url: process.env.DATABASE_URL!,\n        poolSize: parseInt(process.env.DB_POOL_SIZE || '10'),\n      },\n      redis: { url: process.env.REDIS_URL! },\n      jwt: {\n        secret: process.env.JWT_SECRET!,\n        expiresIn: process.env.JWT_EXPIRES || '1d',\n      },\n    }),\n    (e) => new Error(`Config error: ${e}`)\n  )\n\n\u002F\u002F Layer 1: Infrastructure (depends on config)\ntype Infrastructure = {\n  config: Config\n  db: PrismaClient\n  redis: RedisClient\n  logger: Logger\n}\n\nconst buildInfrastructure = (\n  config: Config\n): TE.TaskEither\u003CError, Infrastructure> =>\n  pipe(\n    TE.Do,\n    TE.bind('db', () =>\n      TE.tryCatch(\n        async () => {\n          const prisma = new PrismaClient({\n            datasources: { db: { url: config.database.url } },\n          })\n          await prisma.$connect()\n          return prisma\n        },\n        (e) => new Error(`Database error: ${e}`)\n      )\n    ),\n    TE.bind('redis', () =>\n      TE.tryCatch(\n        async () => createRedisClient(config.redis.url),\n        (e) => new Error(`Redis error: ${e}`)\n      )\n    ),\n    TE.bind('logger', () => TE.right(createLogger())),\n    TE.map(({ db, redis, logger }) => ({\n      config,\n      db,\n      redis,\n      logger,\n    }))\n  )\n\n\u002F\u002F Layer 2: Services (depends on infrastructure)\ntype Services = {\n  hasher: PasswordHasher\n  jwt: JwtService\n  mailer: EmailService\n}\n\nconst buildServices = (infra: Infrastructure): Services => ({\n  hasher: createBcryptHasher(),\n  jwt: createJwtService(infra.config.jwt),\n  mailer: createEmailService(infra.config),\n})\n\n\u002F\u002F Full application dependencies\nexport type AppDeps = Infrastructure & Services\n\nexport const buildDeps = (): TE.TaskEither\u003CError, AppDeps> =>\n  pipe(\n    loadConfig(),\n    TE.flatMap(buildInfrastructure),\n    TE.map(infra => ({\n      ...infra,\n      ...buildServices(infra),\n    }))\n  )\n\n\u002F\u002F Cleanup\nexport const destroyDeps = (deps: AppDeps): TE.TaskEither\u003CError, void> =>\n  pipe(\n    TE.tryCatch(\n      async () => {\n        await deps.db.$disconnect()\n        await deps.redis.quit()\n      },\n      (e) => new Error(`Cleanup error: ${e}`)\n    )\n  )\n```\n\n### Running Programs with Dependencies\n\n```typescript\n\u002F\u002F src\u002Fmain.ts\nimport { pipe } from 'fp-ts\u002Ffunction'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\n\nconst program: RTE.ReaderTaskEither\u003CAppDeps, AppError, void> = pipe(\n  RTE.ask\u003CAppDeps>(),\n  RTE.flatMap(deps =>\n    pipe(\n      startServer(deps),\n      RTE.fromTaskEither\n    )\n  )\n)\n\nconst main = async () => {\n  const result = await pipe(\n    buildDeps(),\n    TE.mapLeft((e): AppError => ({ _tag: 'StartupError', cause: e })),\n    TE.flatMap(deps =>\n      pipe(\n        program(deps),\n        TE.tap(() => TE.fromIO(() => console.log('Server running'))),\n        \u002F\u002F Cleanup on exit\n        TE.tapError(() => destroyDeps(deps))\n      )\n    )\n  )()\n\n  if (result._tag === 'Left') {\n    console.error('Failed to start:', result.left)\n    process.exit(1)\n  }\n}\n\nmain()\n```\n\n## Database Operations\n\n### Prisma Wrappers\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fdb.ts\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as O from 'fp-ts\u002FOption'\nimport { PrismaClient, Prisma } from '@prisma\u002Fclient'\n\ntype DbError =\n  | { _tag: 'RecordNotFound'; model: string; id: string }\n  | { _tag: 'UniqueViolation'; field: string }\n  | { _tag: 'ForeignKeyViolation'; field: string }\n  | { _tag: 'UnknownDbError'; cause: unknown }\n\n\u002F\u002F Wrap Prisma operations\nconst wrapPrisma = \u003CA>(\n  operation: () => Promise\u003CA>\n): TE.TaskEither\u003CDbError, A> =>\n  TE.tryCatch(operation, (error): DbError => {\n    if (error instanceof Prisma.PrismaClientKnownRequestError) {\n      switch (error.code) {\n        case 'P2002':\n          return {\n            _tag: 'UniqueViolation',\n            field: (error.meta?.target as string[])?.join(', ') || 'unknown',\n          }\n        case 'P2003':\n          return {\n            _tag: 'ForeignKeyViolation',\n            field: error.meta?.field_name as string || 'unknown',\n          }\n        case 'P2025':\n          return {\n            _tag: 'RecordNotFound',\n            model: error.meta?.modelName as string || 'unknown',\n            id: 'unknown',\n          }\n      }\n    }\n    return { _tag: 'UnknownDbError', cause: error }\n  })\n\n\u002F\u002F Repository factory\nexport const createRepository = \u003C\n  Model,\n  CreateInput,\n  UpdateInput,\n  WhereUnique,\n  WhereMany\n>(\n  db: PrismaClient,\n  delegate: {\n    findUnique: (args: { where: WhereUnique }) => Promise\u003CModel | null>\n    findMany: (args: { where?: WhereMany; skip?: number; take?: number }) => Promise\u003CModel[]>\n    create: (args: { data: CreateInput }) => Promise\u003CModel>\n    update: (args: { where: WhereUnique; data: UpdateInput }) => Promise\u003CModel>\n    delete: (args: { where: WhereUnique }) => Promise\u003CModel>\n    count: (args?: { where?: WhereMany }) => Promise\u003Cnumber>\n  }\n) => ({\n  findUnique: (where: WhereUnique): TE.TaskEither\u003CDbError, O.Option\u003CModel>> =>\n    pipe(\n      wrapPrisma(() => delegate.findUnique({ where })),\n      TE.map(O.fromNullable)\n    ),\n\n  findMany: (\n    where?: WhereMany,\n    pagination?: { skip: number; take: number }\n  ): TE.TaskEither\u003CDbError, Model[]> =>\n    wrapPrisma(() => delegate.findMany({ where, ...pagination })),\n\n  create: (data: CreateInput): TE.TaskEither\u003CDbError, Model> =>\n    wrapPrisma(() => delegate.create({ data })),\n\n  update: (\n    where: WhereUnique,\n    data: UpdateInput\n  ): TE.TaskEither\u003CDbError, Model> =>\n    wrapPrisma(() => delegate.update({ where, data })),\n\n  delete: (where: WhereUnique): TE.TaskEither\u003CDbError, Model> =>\n    wrapPrisma(() => delegate.delete({ where })),\n\n  count: (where?: WhereMany): TE.TaskEither\u003CDbError, number> =>\n    wrapPrisma(() => delegate.count({ where })),\n})\n\n\u002F\u002F Usage\nconst userRepo = createRepository(prisma, prisma.user)\n```\n\n### Transaction Handling\n\n```typescript\n\u002F\u002F src\u002Flib\u002Ftransaction.ts\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport { PrismaClient } from '@prisma\u002Fclient'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\ntype TxClient = Omit\u003C\n  PrismaClient,\n  '$connect' | '$disconnect' | '$on' | '$transaction' | '$use'\n>\n\ntype TxDeps = { tx: TxClient }\n\n\u002F\u002F Transaction wrapper\nexport const withTransaction = \u003CR extends { db: PrismaClient }, E, A>(\n  program: RTE.ReaderTaskEither\u003CR & TxDeps, E, A>\n): RTE.ReaderTaskEither\u003CR, E | DbError, A> =>\n  pipe(\n    RTE.ask\u003CR>(),\n    RTE.flatMap(deps =>\n      RTE.fromTaskEither(\n        TE.tryCatch(\n          () =>\n            deps.db.$transaction(async tx => {\n              const result = await program({ ...deps, tx })()\n              if (result._tag === 'Left') {\n                throw result.left \u002F\u002F Rollback\n              }\n              return result.right\n            }),\n          (error): E | DbError => {\n            \u002F\u002F Re-throw domain errors\n            if (typeof error === 'object' && error !== null && '_tag' in error) {\n              return error as E\n            }\n            return { _tag: 'UnknownDbError', cause: error }\n          }\n        )\n      )\n    )\n  )\n\n\u002F\u002F Usage in service\nexport const transferFunds = (\n  fromId: string,\n  toId: string,\n  amount: number\n): RTE.ReaderTaskEither\u003CAppDeps, TransferError, Transfer> =>\n  withTransaction(\n    pipe(\n      RTE.Do,\n      RTE.bind('from', () => debitAccount(fromId, amount)),\n      RTE.bind('to', () => creditAccount(toId, amount)),\n      RTE.bind('transfer', ({ from, to }) =>\n        createTransferRecord(from, to, amount)\n      ),\n      RTE.map(({ transfer }) => transfer)\n    )\n  )\n\n\u002F\u002F Inside transaction, use tx instead of db\nconst debitAccount = (\n  accountId: string,\n  amount: number\n): RTE.ReaderTaskEither\u003CTxDeps, TransferError, Account> =>\n  pipe(\n    RTE.ask\u003CTxDeps>(),\n    RTE.flatMap(({ tx }) =>\n      RTE.fromTaskEither(\n        pipe(\n          TE.tryCatch(\n            () =>\n              tx.account.update({\n                where: { id: accountId },\n                data: { balance: { decrement: amount } },\n              }),\n            toDbError\n          ),\n          TE.flatMap(account =>\n            account.balance \u003C 0\n              ? TE.left({ _tag: 'InsufficientFunds' as const, accountId })\n              : TE.right(account)\n          )\n        )\n      )\n    )\n  )\n```\n\n## Middleware Patterns\n\n### Express Middleware\n\n```typescript\n\u002F\u002F src\u002Fmiddleware\u002Ffp-express.ts\nimport { Request, Response, NextFunction, RequestHandler } from 'express'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Convert RTE handler to Express middleware\nexport const toHandler =\n  \u003CR, E, A>(\n    getDeps: (req: Request) => R,\n    handler: (req: Request) => RTE.ReaderTaskEither\u003CR, E, A>,\n    onError: (error: E, res: Response) => void\n  ): RequestHandler =>\n  async (req, res, next) => {\n    const deps = getDeps(req)\n    const result = await handler(req)(deps)()\n\n    pipe(\n      result,\n      E.fold(\n        error => onError(error, res),\n        data => res.json(data)\n      )\n    )\n  }\n\n\u002F\u002F Error handler\nconst handleError = (error: AppError, res: Response): void => {\n  switch (error._tag) {\n    case 'NotFound':\n      res.status(404).json({ error: error.resource + ' not found' })\n      break\n    case 'ValidationError':\n      res.status(400).json({ error: error.message })\n      break\n    case 'Unauthorized':\n      res.status(401).json({ error: error.reason })\n      break\n    default:\n      res.status(500).json({ error: 'Internal server error' })\n  }\n}\n\n\u002F\u002F Usage\nconst getUserHandler = toHandler(\n  req => req.app.locals.deps as AppDeps,\n  req => UserService.findById(req.params.id),\n  handleError\n)\n\napp.get('\u002Fusers\u002F:id', getUserHandler)\n```\n\n### Hono Middleware\n\n```typescript\n\u002F\u002F src\u002Fmiddleware\u002Ffp-hono.ts\nimport { Hono, Context, MiddlewareHandler } from 'hono'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Store deps in context\ndeclare module 'hono' {\n  interface ContextVariableMap {\n    deps: AppDeps\n  }\n}\n\n\u002F\u002F Dependency injection middleware\nexport const withDeps = (deps: AppDeps): MiddlewareHandler =>\n  async (c, next) => {\n    c.set('deps', deps)\n    await next()\n  }\n\n\u002F\u002F Convert RTE to Hono handler\nexport const toHonoHandler =\n  \u003CE, A>(\n    handler: (c: Context) => RTE.ReaderTaskEither\u003CAppDeps, E, A>,\n    onError: (error: E, c: Context) => Response\n  ) =>\n  async (c: Context): Promise\u003CResponse> => {\n    const deps = c.get('deps')\n    const result = await handler(c)(deps)()\n\n    return pipe(\n      result,\n      E.fold(\n        error => onError(error, c),\n        data => c.json(data)\n      )\n    )\n  }\n\n\u002F\u002F Validation middleware\nexport const validate =\n  \u003CT>(schema: z.ZodSchema\u003CT>): MiddlewareHandler =>\n  async (c, next) => {\n    const body = await c.req.json()\n    const result = schema.safeParse(body)\n\n    if (!result.success) {\n      return c.json(\n        { error: 'Validation failed', details: result.error.flatten() },\n        400\n      )\n    }\n\n    c.set('validatedBody', result.data)\n    await next()\n  }\n\n\u002F\u002F Auth middleware using RTE\nexport const requireAuth: MiddlewareHandler = async (c, next) => {\n  const deps = c.get('deps')\n  const token = c.req.header('Authorization')?.replace('Bearer ', '')\n\n  if (!token) {\n    return c.json({ error: 'No token provided' }, 401)\n  }\n\n  const result = await pipe(\n    deps.jwt.verify(token),\n    TE.mapLeft(() => ({ _tag: 'Unauthorized' as const, reason: 'Invalid token' }))\n  )()\n\n  if (E.isLeft(result)) {\n    return c.json({ error: result.left.reason }, 401)\n  }\n\n  c.set('user', result.right)\n  await next()\n}\n\n\u002F\u002F Usage\nconst app = new Hono()\n\napp.use('*', withDeps(deps))\napp.use('\u002Fapi\u002F*', requireAuth)\n\napp.get(\n  '\u002Fapi\u002Fusers\u002F:id',\n  toHonoHandler(\n    c => UserService.findById(c.req.param('id')),\n    (error, c) => {\n      if (error._tag === 'UserNotFound') {\n        return c.json({ error: 'User not found' }, 404)\n      }\n      return c.json({ error: 'Internal error' }, 500)\n    }\n  )\n)\n```\n\n### Request Context Pattern\n\n```typescript\n\u002F\u002F src\u002Fcontext.ts\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Request-scoped context\ntype RequestContext = {\n  requestId: string\n  userId: O.Option\u003Cstring>\n  startTime: number\n}\n\ntype ContextDeps = AppDeps & { ctx: RequestContext }\n\n\u002F\u002F Logging with context\nconst logWithContext =\n  (level: 'info' | 'warn' | 'error') =>\n  (message: string, meta?: object): RTE.ReaderTaskEither\u003CContextDeps, never, void> =>\n    pipe(\n      RTE.ask\u003CContextDeps>(),\n      RTE.flatMap(({ logger, ctx }) =>\n        RTE.fromIO(() =>\n          loggerlevel,\n            elapsed: Date.now() - ctx.startTime,\n          })\n        )\n      )\n    )\n\nexport const log = {\n  info: logWithContext('info'),\n  warn: logWithContext('warn'),\n  error: logWithContext('error'),\n}\n\n\u002F\u002F Middleware to create context\nexport const withContext: MiddlewareHandler = async (c, next) => {\n  const deps = c.get('deps')\n  const ctx: RequestContext = {\n    requestId: crypto.randomUUID(),\n    userId: O.fromNullable(c.get('user')?.id),\n    startTime: Date.now(),\n  }\n\n  c.set('deps', { ...deps, ctx })\n\n  \u002F\u002F Log request start\n  deps.logger.info('Request started', {\n    requestId: ctx.requestId,\n    method: c.req.method,\n    path: c.req.path,\n  })\n\n  await next()\n\n  \u002F\u002F Log request end\n  deps.logger.info('Request completed', {\n    requestId: ctx.requestId,\n    status: c.res.status,\n    elapsed: Date.now() - ctx.startTime,\n  })\n}\n```\n\n## Error Handling Patterns\n\n### Typed Error Hierarchy\n\n```typescript\n\u002F\u002F src\u002Ferrors.ts\nimport * as E from 'fp-ts\u002FEither'\nimport * as O from 'fp-ts\u002FOption'\n\n\u002F\u002F Base error types\ntype DomainError =\n  | NotFoundError\n  | ValidationError\n  | ConflictError\n  | AuthError\n  | InfrastructureError\n\ntype NotFoundError = {\n  _tag: 'NotFoundError'\n  resource: string\n  id: string\n}\n\ntype ValidationError = {\n  _tag: 'ValidationError'\n  field: string\n  message: string\n  value?: unknown\n}\n\ntype ConflictError = {\n  _tag: 'ConflictError'\n  resource: string\n  field: string\n  value: string\n}\n\ntype AuthError =\n  | { _tag: 'Unauthenticated' }\n  | { _tag: 'Unauthorized'; required: string }\n  | { _tag: 'TokenExpired' }\n\ntype InfrastructureError = {\n  _tag: 'InfrastructureError'\n  service: string\n  cause: unknown\n}\n\n\u002F\u002F Smart constructors\nexport const notFound = (resource: string, id: string): NotFoundError => ({\n  _tag: 'NotFoundError',\n  resource,\n  id,\n})\n\nexport const validation = (\n  field: string,\n  message: string,\n  value?: unknown\n): ValidationError => ({\n  _tag: 'ValidationError',\n  field,\n  message,\n  value,\n})\n\nexport const conflict = (\n  resource: string,\n  field: string,\n  value: string\n): ConflictError => ({\n  _tag: 'ConflictError',\n  resource,\n  field,\n  value,\n})\n\n\u002F\u002F Error to HTTP status mapping\nexport const toHttpStatus = (error: DomainError): number => {\n  switch (error._tag) {\n    case 'NotFoundError':\n      return 404\n    case 'ValidationError':\n      return 400\n    case 'ConflictError':\n      return 409\n    case 'Unauthenticated':\n      return 401\n    case 'Unauthorized':\n      return 403\n    case 'TokenExpired':\n      return 401\n    case 'InfrastructureError':\n      return 503\n    default:\n      return 500\n  }\n}\n\n\u002F\u002F Error to response body\nexport const toResponseBody = (\n  error: DomainError\n): { error: string; details?: unknown } => {\n  switch (error._tag) {\n    case 'NotFoundError':\n      return { error: `${error.resource} not found` }\n    case 'ValidationError':\n      return {\n        error: 'Validation failed',\n        details: { field: error.field, message: error.message },\n      }\n    case 'ConflictError':\n      return {\n        error: `${error.resource} with ${error.field} already exists`,\n      }\n    case 'Unauthenticated':\n      return { error: 'Authentication required' }\n    case 'Unauthorized':\n      return { error: `Permission denied: ${error.required}` }\n    case 'TokenExpired':\n      return { error: 'Token expired' }\n    case 'InfrastructureError':\n      return { error: 'Service temporarily unavailable' }\n  }\n}\n```\n\n### Error Recovery\n\n```typescript\n\u002F\u002F src\u002Flib\u002Frecovery.ts\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Retry with exponential backoff\nexport const withRetry =\n  \u003CR, E, A>(\n    maxAttempts: number,\n    baseDelayMs: number,\n    shouldRetry: (error: E) => boolean\n  ) =>\n  (\n    operation: RTE.ReaderTaskEither\u003CR, E, A>\n  ): RTE.ReaderTaskEither\u003CR, E, A> =>\n    pipe(\n      RTE.ask\u003CR>(),\n      RTE.flatMap(deps => {\n        const attempt = (\n          remaining: number,\n          delay: number\n        ): TE.TaskEither\u003CE, A> =>\n          pipe(\n            operation(deps),\n            TE.orElse(error => {\n              if (remaining \u003C= 0 || !shouldRetry(error)) {\n                return TE.left(error)\n              }\n              return pipe(\n                TE.fromTask(() => new Promise(r => setTimeout(r, delay))),\n                TE.flatMap(() => attempt(remaining - 1, delay * 2))\n              )\n            })\n          )\n\n        return RTE.fromTaskEither(attempt(maxAttempts - 1, baseDelayMs))\n      })\n    )\n\n\u002F\u002F Fallback to cached value\nexport const withFallback =\n  \u003CR extends { cache: CacheClient }, E, A>(\n    cacheKey: string,\n    ttlSeconds: number\n  ) =>\n  (\n    operation: RTE.ReaderTaskEither\u003CR, E, A>\n  ): RTE.ReaderTaskEither\u003CR, E, A> =>\n    pipe(\n      RTE.ask\u003CR>(),\n      RTE.flatMap(({ cache, ...rest }) =>\n        pipe(\n          operation,\n          \u002F\u002F On success, cache the result\n          RTE.tap(result =>\n            RTE.fromTaskEither(cache.set(cacheKey, result, ttlSeconds))\n          ),\n          \u002F\u002F On failure, try to get cached value\n          RTE.orElse(error =>\n            pipe(\n              RTE.fromTaskEither(cache.get\u003CA>(cacheKey)),\n              RTE.flatMap(cached =>\n                cached ? RTE.right(cached) : RTE.left(error)\n              )\n            )\n          )\n        )\n      )\n    )\n\n\u002F\u002F Circuit breaker\ntype CircuitState = 'closed' | 'open' | 'half-open'\n\nexport const createCircuitBreaker = \u003CE>(\n  failureThreshold: number,\n  resetTimeoutMs: number,\n  isFailure: (error: E) => boolean\n) => {\n  let state: CircuitState = 'closed'\n  let failures = 0\n  let lastFailure = 0\n\n  return \u003CR, A>(\n    operation: RTE.ReaderTaskEither\u003CR, E, A>\n  ): RTE.ReaderTaskEither\u003CR, E | { _tag: 'CircuitOpen' }, A> =>\n    pipe(\n      RTE.ask\u003CR>(),\n      RTE.flatMap(deps => {\n        \u002F\u002F Check if circuit should reset\n        if (\n          state === 'open' &&\n          Date.now() - lastFailure > resetTimeoutMs\n        ) {\n          state = 'half-open'\n        }\n\n        if (state === 'open') {\n          return RTE.left({ _tag: 'CircuitOpen' as const })\n        }\n\n        return pipe(\n          operation,\n          RTE.tap(() => {\n            if (state === 'half-open') {\n              state = 'closed'\n              failures = 0\n            }\n            return RTE.right(undefined)\n          }),\n          RTE.tapError(error => {\n            if (isFailure(error)) {\n              failures++\n              lastFailure = Date.now()\n              if (failures >= failureThreshold) {\n                state = 'open'\n              }\n            }\n            return RTE.right(undefined)\n          })\n        )\n      })\n    )\n}\n```\n\n## Testing Strategies\n\n### Mocking Dependencies\n\n```typescript\n\u002F\u002F src\u002Fservices\u002F__tests__\u002Fuser.service.test.ts\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport * as O from 'fp-ts\u002FOption'\nimport { describe, it, expect, vi } from 'vitest'\nimport * as UserService from '..\u002Fuser.service'\n\n\u002F\u002F Create mock dependencies\nconst createMockDeps = (overrides: Partial\u003CUserDeps> = {}): UserDeps => ({\n  db: {\n    users: {\n      findUnique: vi.fn(() => Promise.resolve(null)),\n      create: vi.fn(data => Promise.resolve({ id: '1', ...data })),\n      update: vi.fn((where, data) => Promise.resolve({ id: where.id, ...data })),\n    },\n  },\n  hasher: {\n    hash: vi.fn(password => TE.right(`hashed_${password}`)),\n    verify: vi.fn(() => TE.right(true)),\n  },\n  mailer: {\n    send: vi.fn(() => TE.right(undefined)),\n  },\n  ...overrides,\n})\n\ndescribe('UserService', () => {\n  describe('create', () => {\n    it('should create a user with hashed password', async () => {\n      const deps = createMockDeps()\n      const input = {\n        email: 'test@example.com',\n        password: 'secret123',\n        name: 'Test User',\n      }\n\n      const result = await UserService.create(input)(deps)()\n\n      expect(E.isRight(result)).toBe(true)\n      if (E.isRight(result)) {\n        expect(result.right.email).toBe(input.email)\n      }\n      expect(deps.hasher.hash).toHaveBeenCalledWith('secret123')\n    })\n\n    it('should fail when email already exists', async () => {\n      const existingUser = { id: '1', email: 'test@example.com' }\n      const deps = createMockDeps({\n        db: {\n          users: {\n            findUnique: vi.fn(() => Promise.resolve(existingUser)),\n            create: vi.fn(),\n          },\n        },\n      })\n\n      const result = await UserService.create({\n        email: 'test@example.com',\n        password: 'secret',\n        name: 'Test',\n      })(deps)()\n\n      expect(E.isLeft(result)).toBe(true)\n      if (E.isLeft(result)) {\n        expect(result.left._tag).toBe('EmailExists')\n      }\n    })\n  })\n\n  describe('findById', () => {\n    it('should return user when found', async () => {\n      const user = { id: '1', email: 'test@example.com', name: 'Test' }\n      const deps = createMockDeps({\n        db: {\n          users: {\n            findUnique: vi.fn(() => Promise.resolve(user)),\n          },\n        },\n      })\n\n      const result = await UserService.findById('1')(deps)()\n\n      expect(E.isRight(result)).toBe(true)\n      if (E.isRight(result)) {\n        expect(result.right).toEqual(user)\n      }\n    })\n\n    it('should return NotFound when user does not exist', async () => {\n      const deps = createMockDeps()\n\n      const result = await UserService.findById('nonexistent')(deps)()\n\n      expect(E.isLeft(result)).toBe(true)\n      if (E.isLeft(result)) {\n        expect(result.left._tag).toBe('UserNotFound')\n        expect(result.left.id).toBe('nonexistent')\n      }\n    })\n  })\n})\n```\n\n### Integration Testing with Test Containers\n\n```typescript\n\u002F\u002F src\u002F__tests__\u002Fintegration\u002Fuser.integration.test.ts\nimport { PostgreSqlContainer } from '@testcontainers\u002Fpostgresql'\nimport { PrismaClient } from '@prisma\u002Fclient'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\nimport { describe, it, expect, beforeAll, afterAll } from 'vitest'\nimport { buildDeps, destroyDeps, AppDeps } from '..\u002F..\u002Fdeps'\nimport * as UserService from '..\u002F..\u002Fservices\u002Fuser.service'\n\ndescribe('UserService Integration', () => {\n  let container: PostgreSqlContainer\n  let deps: AppDeps\n\n  beforeAll(async () => {\n    \u002F\u002F Start PostgreSQL container\n    container = await new PostgreSqlContainer().start()\n\n    \u002F\u002F Build real dependencies with test database\n    process.env.DATABASE_URL = container.getConnectionUri()\n\n    const depsResult = await buildDeps()()\n    if (E.isLeft(depsResult)) {\n      throw new Error(`Failed to build deps: ${depsResult.left}`)\n    }\n    deps = depsResult.right\n\n    \u002F\u002F Run migrations\n    await deps.db.$executeRaw`CREATE EXTENSION IF NOT EXISTS \"uuid-ossp\"`\n    \u002F\u002F ... run Prisma migrations\n  }, 60000)\n\n  afterAll(async () => {\n    await destroyDeps(deps)()\n    await container.stop()\n  })\n\n  it('should create and retrieve a user', async () => {\n    \u002F\u002F Create user\n    const createResult = await UserService.create({\n      email: 'integration@test.com',\n      password: 'password123',\n      name: 'Integration Test',\n    })(deps)()\n\n    expect(E.isRight(createResult)).toBe(true)\n    if (E.isLeft(createResult)) return\n\n    const user = createResult.right\n\n    \u002F\u002F Retrieve user\n    const findResult = await UserService.findById(user.id)(deps)()\n\n    expect(E.isRight(findResult)).toBe(true)\n    if (E.isRight(findResult)) {\n      expect(findResult.right.email).toBe('integration@test.com')\n    }\n  })\n})\n```\n\n### Property-Based Testing\n\n```typescript\n\u002F\u002F src\u002F__tests__\u002Fproperty\u002Fuser.property.test.ts\nimport * as fc from 'fast-check'\nimport * as E from 'fp-ts\u002FEither'\nimport { describe, it, expect } from 'vitest'\nimport { validateEmail, validatePassword } from '..\u002F..\u002Fvalidation'\n\ndescribe('Validation Properties', () => {\n  it('valid emails should pass validation', () => {\n    fc.assert(\n      fc.property(fc.emailAddress(), email => {\n        const result = validateEmail(email)\n        return E.isRight(result)\n      })\n    )\n  })\n\n  it('passwords meeting requirements should pass', () => {\n    const validPassword = fc\n      .tuple(\n        fc.stringOf(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyz'), {\n          minLength: 4,\n        }),\n        fc.stringOf(fc.constantFrom(...'ABCDEFGHIJKLMNOPQRSTUVWXYZ'), {\n          minLength: 1,\n        }),\n        fc.stringOf(fc.constantFrom(...'0123456789'), { minLength: 1 }),\n        fc.stringOf(fc.constantFrom(...'!@#$%^&*'), { minLength: 1 })\n      )\n      .map(parts => parts.join(''))\n\n    fc.assert(\n      fc.property(validPassword, password => {\n        const result = validatePassword(password)\n        return E.isRight(result)\n      })\n    )\n  })\n\n  it('empty strings should fail email validation', () => {\n    const result = validateEmail('')\n    expect(E.isLeft(result)).toBe(true)\n  })\n})\n```\n\n## Quick Reference\n\n### Common Imports\n\n```typescript\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport * as O from 'fp-ts\u002FOption'\nimport * as A from 'fp-ts\u002FArray'\nimport * as T from 'fp-ts\u002FTask'\nimport { pipe, flow } from 'fp-ts\u002Ffunction'\n```\n\n### RTE Cheat Sheet\n\n| Operation | Description |\n|-----------|-------------|\n| `RTE.right(a)` | Lift value into success |\n| `RTE.left(e)` | Create error |\n| `RTE.ask\u003CR>()` | Get dependencies |\n| `RTE.fromTaskEither(te)` | Lift TaskEither |\n| `RTE.fromEither(e)` | Lift Either |\n| `RTE.fromOption(onNone)(o)` | Lift Option |\n| `RTE.flatMap(f)` | Chain operations |\n| `RTE.map(f)` | Transform success |\n| `RTE.mapLeft(f)` | Transform error |\n| `RTE.tap(f)` | Side effect on success |\n| `RTE.tapError(f)` | Side effect on error |\n| `RTE.orElse(f)` | Recover from error |\n| `RTE.getOrElse(f)` | Extract with fallback |\n\n### Service Template\n\n```typescript\n\u002F\u002F Template for a new service\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\ntype MyServiceDeps = {\n  db: DatabaseClient\n  \u002F\u002F ... other dependencies\n}\n\ntype MyServiceError =\n  | { _tag: 'NotFound'; id: string }\n  | { _tag: 'ValidationFailed'; reason: string }\n\nexport const myOperation = (\n  input: Input\n): RTE.ReaderTaskEither\u003CMyServiceDeps, MyServiceError, Output> =>\n  pipe(\n    RTE.ask\u003CMyServiceDeps>(),\n    RTE.flatMap(deps =>\n      \u002F\u002F Your implementation here\n      RTE.right(output)\n    )\n  )\n```\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","# fp-ts Backend Patterns\n\nFunctional programming patterns for building type-safe, testable backend services using fp-ts.\n\n## When to Use\n- You are building or refactoring a Node.js or Deno backend with fp-ts.\n- The task involves dependency injection, service composition, or typed backend errors with `ReaderTaskEither`.\n- You need functional backend architecture patterns rather than isolated utility snippets.\n\n## Core Concepts\n\n### ReaderTaskEither (RTE)\n\nThe `ReaderTaskEither\u003CR, E, A>` type is the backbone of functional backend development:\n- **R** (Reader): Dependencies\u002Fenvironment (database, config, logger)\n- **E** (Either left): Error type\n- **A** (Either right): Success value\n\n```typescript\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Define your dependencies\ntype Deps = {\n  db: DatabaseClient\n  logger: Logger\n  config: Config\n}\n\n\u002F\u002F Define domain errors\ntype AppError =\n  | { _tag: 'NotFound'; resource: string; id: string }\n  | { _tag: 'ValidationError'; message: string }\n  | { _tag: 'DatabaseError'; cause: unknown }\n  | { _tag: 'Unauthorized'; reason: string }\n\n\u002F\u002F A service function\nconst getUser = (id: string): RTE.ReaderTaskEither\u003CDeps, AppError, User> =>\n  pipe(\n    RTE.ask\u003CDeps>(),\n    RTE.flatMap(({ db, logger }) =>\n      pipe(\n        RTE.fromTaskEither(db.users.findById(id)),\n        RTE.mapLeft((e): AppError => ({ _tag: 'DatabaseError', cause: e })),\n        RTE.flatMap(user =>\n          user\n            ? RTE.right(user)\n            : RTE.left({ _tag: 'NotFound', resource: 'User', id })\n        ),\n        RTE.tap(user => RTE.fromIO(() => logger.info(`Found user: ${user.id}`)))\n      )\n    )\n  )\n```\n\n## Service Layer Patterns\n\n### Defining Service Modules\n\nStructure services as modules exporting RTE functions:\n\n```typescript\n\u002F\u002F src\u002Fservices\u002Fuser.service.ts\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as A from 'fp-ts\u002FArray'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\ntype UserDeps = {\n  db: DatabaseClient\n  hasher: PasswordHasher\n  mailer: EmailService\n}\n\ntype UserError =\n  | { _tag: 'UserNotFound'; id: string }\n  | { _tag: 'EmailExists'; email: string }\n  | { _tag: 'InvalidPassword' }\n\n\u002F\u002F Create user\nexport const create = (\n  input: CreateUserInput\n): RTE.ReaderTaskEither\u003CUserDeps, UserError, User> =>\n  pipe(\n    RTE.ask\u003CUserDeps>(),\n    RTE.flatMap(({ db, hasher }) =>\n      pipe(\n        \u002F\u002F Check email uniqueness\n        checkEmailUnique(input.email),\n        RTE.flatMap(() =>\n          RTE.fromTaskEither(hasher.hash(input.password))\n        ),\n        RTE.flatMap(hashedPassword =>\n          RTE.fromTaskEither(\n            db.users.create({\n              ...input,\n              password: hashedPassword,\n            })\n          )\n        )\n      )\n    )\n  )\n\n\u002F\u002F Find by ID\nexport const findById = (\n  id: string\n): RTE.ReaderTaskEither\u003CUserDeps, UserError, User> =>\n  pipe(\n    RTE.ask\u003CUserDeps>(),\n    RTE.flatMap(({ db }) =>\n      pipe(\n        RTE.fromTaskEither(db.users.findUnique({ where: { id } })),\n        RTE.flatMap(user =>\n          user\n            ? RTE.right(user)\n            : RTE.left({ _tag: 'UserNotFound' as const, id })\n        )\n      )\n    )\n  )\n\n\u002F\u002F Find many with pagination\nexport const findMany = (\n  params: PaginationParams\n): RTE.ReaderTaskEither\u003CUserDeps, UserError, PaginatedResult\u003CUser>> =>\n  pipe(\n    RTE.ask\u003CUserDeps>(),\n    RTE.flatMap(({ db }) =>\n      RTE.fromTaskEither(\n        pipe(\n          TE.Do,\n          TE.bind('users', () => db.users.findMany({\n            skip: params.offset,\n            take: params.limit,\n          })),\n          TE.bind('total', () => db.users.count()),\n          TE.map(({ users, total }) => ({\n            data: users,\n            total,\n            ...params,\n          }))\n        )\n      )\n    )\n  )\n\nconst checkEmailUnique = (\n  email: string\n): RTE.ReaderTaskEither\u003CUserDeps, UserError, void> =>\n  pipe(\n    RTE.ask\u003CUserDeps>(),\n    RTE.flatMap(({ db }) =>\n      pipe(\n        RTE.fromTaskEither(db.users.findUnique({ where: { email } })),\n        RTE.flatMap(existing =>\n          existing\n            ? RTE.left({ _tag: 'EmailExists' as const, email })\n            : RTE.right(undefined)\n        )\n      )\n    )\n  )\n```\n\n### Composing Services\n\n```typescript\n\u002F\u002F src\u002Fservices\u002Forder.service.ts\nimport * as UserService from '.\u002Fuser.service'\nimport * as ProductService from '.\u002Fproduct.service'\nimport * as PaymentService from '.\u002Fpayment.service'\n\ntype OrderDeps = UserService.UserDeps &\n  ProductService.ProductDeps &\n  PaymentService.PaymentDeps & {\n    db: DatabaseClient\n  }\n\nexport const createOrder = (\n  userId: string,\n  items: OrderItem[]\n): RTE.ReaderTaskEither\u003COrderDeps, OrderError, Order> =>\n  pipe(\n    RTE.Do,\n    \u002F\u002F Validate user exists\n    RTE.bind('user', () =>\n      pipe(\n        UserService.findById(userId),\n        RTE.mapLeft(toOrderError)\n      )\n    ),\n    \u002F\u002F Validate and get products\n    RTE.bind('products', () =>\n      pipe(\n        items,\n        A.traverse(RTE.ApplicativePar)(item =>\n          ProductService.findById(item.productId)\n        ),\n        RTE.mapLeft(toOrderError)\n      )\n    ),\n    \u002F\u002F Calculate total\n    RTE.bind('total', ({ products }) =>\n      RTE.right(calculateTotal(products, items))\n    ),\n    \u002F\u002F Process payment\n    RTE.bind('payment', ({ user, total }) =>\n      pipe(\n        PaymentService.charge(user, total),\n        RTE.mapLeft(toOrderError)\n      )\n    ),\n    \u002F\u002F Create order\n    RTE.flatMap(({ user, products, total, payment }) =>\n      createOrderRecord(user, products, items, total, payment)\n    )\n  )\n```\n\n## Functional Dependency Injection\n\n### Building the Dependency Container\n\n```typescript\n\u002F\u002F src\u002Fdeps.ts\nimport { pipe } from 'fp-ts\u002Ffunction'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\n\n\u002F\u002F Layer 0: Config (no dependencies)\ntype Config = {\n  database: { url: string; poolSize: number }\n  redis: { url: string }\n  jwt: { secret: string; expiresIn: string }\n}\n\nconst loadConfig = (): TE.TaskEither\u003CError, Config> =>\n  TE.tryCatch(\n    async () => ({\n      database: {\n        url: process.env.DATABASE_URL!,\n        poolSize: parseInt(process.env.DB_POOL_SIZE || '10'),\n      },\n      redis: { url: process.env.REDIS_URL! },\n      jwt: {\n        secret: process.env.JWT_SECRET!,\n        expiresIn: process.env.JWT_EXPIRES || '1d',\n      },\n    }),\n    (e) => new Error(`Config error: ${e}`)\n  )\n\n\u002F\u002F Layer 1: Infrastructure (depends on config)\ntype Infrastructure = {\n  config: Config\n  db: PrismaClient\n  redis: RedisClient\n  logger: Logger\n}\n\nconst buildInfrastructure = (\n  config: Config\n): TE.TaskEither\u003CError, Infrastructure> =>\n  pipe(\n    TE.Do,\n    TE.bind('db', () =>\n      TE.tryCatch(\n        async () => {\n          const prisma = new PrismaClient({\n            datasources: { db: { url: config.database.url } },\n          })\n          await prisma.$connect()\n          return prisma\n        },\n        (e) => new Error(`Database error: ${e}`)\n      )\n    ),\n    TE.bind('redis', () =>\n      TE.tryCatch(\n        async () => createRedisClient(config.redis.url),\n        (e) => new Error(`Redis error: ${e}`)\n      )\n    ),\n    TE.bind('logger', () => TE.right(createLogger())),\n    TE.map(({ db, redis, logger }) => ({\n      config,\n      db,\n      redis,\n      logger,\n    }))\n  )\n\n\u002F\u002F Layer 2: Services (depends on infrastructure)\ntype Services = {\n  hasher: PasswordHasher\n  jwt: JwtService\n  mailer: EmailService\n}\n\nconst buildServices = (infra: Infrastructure): Services => ({\n  hasher: createBcryptHasher(),\n  jwt: createJwtService(infra.config.jwt),\n  mailer: createEmailService(infra.config),\n})\n\n\u002F\u002F Full application dependencies\nexport type AppDeps = Infrastructure & Services\n\nexport const buildDeps = (): TE.TaskEither\u003CError, AppDeps> =>\n  pipe(\n    loadConfig(),\n    TE.flatMap(buildInfrastructure),\n    TE.map(infra => ({\n      ...infra,\n      ...buildServices(infra),\n    }))\n  )\n\n\u002F\u002F Cleanup\nexport const destroyDeps = (deps: AppDeps): TE.TaskEither\u003CError, void> =>\n  pipe(\n    TE.tryCatch(\n      async () => {\n        await deps.db.$disconnect()\n        await deps.redis.quit()\n      },\n      (e) => new Error(`Cleanup error: ${e}`)\n    )\n  )\n```\n\n### Running Programs with Dependencies\n\n```typescript\n\u002F\u002F src\u002Fmain.ts\nimport { pipe } from 'fp-ts\u002Ffunction'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\n\nconst program: RTE.ReaderTaskEither\u003CAppDeps, AppError, void> = pipe(\n  RTE.ask\u003CAppDeps>(),\n  RTE.flatMap(deps =>\n    pipe(\n      startServer(deps),\n      RTE.fromTaskEither\n    )\n  )\n)\n\nconst main = async () => {\n  const result = await pipe(\n    buildDeps(),\n    TE.mapLeft((e): AppError => ({ _tag: 'StartupError', cause: e })),\n    TE.flatMap(deps =>\n      pipe(\n        program(deps),\n        TE.tap(() => TE.fromIO(() => console.log('Server running'))),\n        \u002F\u002F Cleanup on exit\n        TE.tapError(() => destroyDeps(deps))\n      )\n    )\n  )()\n\n  if (result._tag === 'Left') {\n    console.error('Failed to start:', result.left)\n    process.exit(1)\n  }\n}\n\nmain()\n```\n\n## Database Operations\n\n### Prisma Wrappers\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fdb.ts\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as O from 'fp-ts\u002FOption'\nimport { PrismaClient, Prisma } from '@prisma\u002Fclient'\n\ntype DbError =\n  | { _tag: 'RecordNotFound'; model: string; id: string }\n  | { _tag: 'UniqueViolation'; field: string }\n  | { _tag: 'ForeignKeyViolation'; field: string }\n  | { _tag: 'UnknownDbError'; cause: unknown }\n\n\u002F\u002F Wrap Prisma operations\nconst wrapPrisma = \u003CA>(\n  operation: () => Promise\u003CA>\n): TE.TaskEither\u003CDbError, A> =>\n  TE.tryCatch(operation, (error): DbError => {\n    if (error instanceof Prisma.PrismaClientKnownRequestError) {\n      switch (error.code) {\n        case 'P2002':\n          return {\n            _tag: 'UniqueViolation',\n            field: (error.meta?.target as string[])?.join(', ') || 'unknown',\n          }\n        case 'P2003':\n          return {\n            _tag: 'ForeignKeyViolation',\n            field: error.meta?.field_name as string || 'unknown',\n          }\n        case 'P2025':\n          return {\n            _tag: 'RecordNotFound',\n            model: error.meta?.modelName as string || 'unknown',\n            id: 'unknown',\n          }\n      }\n    }\n    return { _tag: 'UnknownDbError', cause: error }\n  })\n\n\u002F\u002F Repository factory\nexport const createRepository = \u003C\n  Model,\n  CreateInput,\n  UpdateInput,\n  WhereUnique,\n  WhereMany\n>(\n  db: PrismaClient,\n  delegate: {\n    findUnique: (args: { where: WhereUnique }) => Promise\u003CModel | null>\n    findMany: (args: { where?: WhereMany; skip?: number; take?: number }) => Promise\u003CModel[]>\n    create: (args: { data: CreateInput }) => Promise\u003CModel>\n    update: (args: { where: WhereUnique; data: UpdateInput }) => Promise\u003CModel>\n    delete: (args: { where: WhereUnique }) => Promise\u003CModel>\n    count: (args?: { where?: WhereMany }) => Promise\u003Cnumber>\n  }\n) => ({\n  findUnique: (where: WhereUnique): TE.TaskEither\u003CDbError, O.Option\u003CModel>> =>\n    pipe(\n      wrapPrisma(() => delegate.findUnique({ where })),\n      TE.map(O.fromNullable)\n    ),\n\n  findMany: (\n    where?: WhereMany,\n    pagination?: { skip: number; take: number }\n  ): TE.TaskEither\u003CDbError, Model[]> =>\n    wrapPrisma(() => delegate.findMany({ where, ...pagination })),\n\n  create: (data: CreateInput): TE.TaskEither\u003CDbError, Model> =>\n    wrapPrisma(() => delegate.create({ data })),\n\n  update: (\n    where: WhereUnique,\n    data: UpdateInput\n  ): TE.TaskEither\u003CDbError, Model> =>\n    wrapPrisma(() => delegate.update({ where, data })),\n\n  delete: (where: WhereUnique): TE.TaskEither\u003CDbError, Model> =>\n    wrapPrisma(() => delegate.delete({ where })),\n\n  count: (where?: WhereMany): TE.TaskEither\u003CDbError, number> =>\n    wrapPrisma(() => delegate.count({ where })),\n})\n\n\u002F\u002F Usage\nconst userRepo = createRepository(prisma, prisma.user)\n```\n\n### Transaction Handling\n\n```typescript\n\u002F\u002F src\u002Flib\u002Ftransaction.ts\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport { PrismaClient } from '@prisma\u002Fclient'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\ntype TxClient = Omit\u003C\n  PrismaClient,\n  '$connect' | '$disconnect' | '$on' | '$transaction' | '$use'\n>\n\ntype TxDeps = { tx: TxClient }\n\n\u002F\u002F Transaction wrapper\nexport const withTransaction = \u003CR extends { db: PrismaClient }, E, A>(\n  program: RTE.ReaderTaskEither\u003CR & TxDeps, E, A>\n): RTE.ReaderTaskEither\u003CR, E | DbError, A> =>\n  pipe(\n    RTE.ask\u003CR>(),\n    RTE.flatMap(deps =>\n      RTE.fromTaskEither(\n        TE.tryCatch(\n          () =>\n            deps.db.$transaction(async tx => {\n              const result = await program({ ...deps, tx })()\n              if (result._tag === 'Left') {\n                throw result.left \u002F\u002F Rollback\n              }\n              return result.right\n            }),\n          (error): E | DbError => {\n            \u002F\u002F Re-throw domain errors\n            if (typeof error === 'object' && error !== null && '_tag' in error) {\n              return error as E\n            }\n            return { _tag: 'UnknownDbError', cause: error }\n          }\n        )\n      )\n    )\n  )\n\n\u002F\u002F Usage in service\nexport const transferFunds = (\n  fromId: string,\n  toId: string,\n  amount: number\n): RTE.ReaderTaskEither\u003CAppDeps, TransferError, Transfer> =>\n  withTransaction(\n    pipe(\n      RTE.Do,\n      RTE.bind('from', () => debitAccount(fromId, amount)),\n      RTE.bind('to', () => creditAccount(toId, amount)),\n      RTE.bind('transfer', ({ from, to }) =>\n        createTransferRecord(from, to, amount)\n      ),\n      RTE.map(({ transfer }) => transfer)\n    )\n  )\n\n\u002F\u002F Inside transaction, use tx instead of db\nconst debitAccount = (\n  accountId: string,\n  amount: number\n): RTE.ReaderTaskEither\u003CTxDeps, TransferError, Account> =>\n  pipe(\n    RTE.ask\u003CTxDeps>(),\n    RTE.flatMap(({ tx }) =>\n      RTE.fromTaskEither(\n        pipe(\n          TE.tryCatch(\n            () =>\n              tx.account.update({\n                where: { id: accountId },\n                data: { balance: { decrement: amount } },\n              }),\n            toDbError\n          ),\n          TE.flatMap(account =>\n            account.balance \u003C 0\n              ? TE.left({ _tag: 'InsufficientFunds' as const, accountId })\n              : TE.right(account)\n          )\n        )\n      )\n    )\n  )\n```\n\n## Middleware Patterns\n\n### Express Middleware\n\n```typescript\n\u002F\u002F src\u002Fmiddleware\u002Ffp-express.ts\nimport { Request, Response, NextFunction, RequestHandler } from 'express'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Convert RTE handler to Express middleware\nexport const toHandler =\n  \u003CR, E, A>(\n    getDeps: (req: Request) => R,\n    handler: (req: Request) => RTE.ReaderTaskEither\u003CR, E, A>,\n    onError: (error: E, res: Response) => void\n  ): RequestHandler =>\n  async (req, res, next) => {\n    const deps = getDeps(req)\n    const result = await handler(req)(deps)()\n\n    pipe(\n      result,\n      E.fold(\n        error => onError(error, res),\n        data => res.json(data)\n      )\n    )\n  }\n\n\u002F\u002F Error handler\nconst handleError = (error: AppError, res: Response): void => {\n  switch (error._tag) {\n    case 'NotFound':\n      res.status(404).json({ error: error.resource + ' not found' })\n      break\n    case 'ValidationError':\n      res.status(400).json({ error: error.message })\n      break\n    case 'Unauthorized':\n      res.status(401).json({ error: error.reason })\n      break\n    default:\n      res.status(500).json({ error: 'Internal server error' })\n  }\n}\n\n\u002F\u002F Usage\nconst getUserHandler = toHandler(\n  req => req.app.locals.deps as AppDeps,\n  req => UserService.findById(req.params.id),\n  handleError\n)\n\napp.get('\u002Fusers\u002F:id', getUserHandler)\n```\n\n### Hono Middleware\n\n```typescript\n\u002F\u002F src\u002Fmiddleware\u002Ffp-hono.ts\nimport { Hono, Context, MiddlewareHandler } from 'hono'\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Store deps in context\ndeclare module 'hono' {\n  interface ContextVariableMap {\n    deps: AppDeps\n  }\n}\n\n\u002F\u002F Dependency injection middleware\nexport const withDeps = (deps: AppDeps): MiddlewareHandler =>\n  async (c, next) => {\n    c.set('deps', deps)\n    await next()\n  }\n\n\u002F\u002F Convert RTE to Hono handler\nexport const toHonoHandler =\n  \u003CE, A>(\n    handler: (c: Context) => RTE.ReaderTaskEither\u003CAppDeps, E, A>,\n    onError: (error: E, c: Context) => Response\n  ) =>\n  async (c: Context): Promise\u003CResponse> => {\n    const deps = c.get('deps')\n    const result = await handler(c)(deps)()\n\n    return pipe(\n      result,\n      E.fold(\n        error => onError(error, c),\n        data => c.json(data)\n      )\n    )\n  }\n\n\u002F\u002F Validation middleware\nexport const validate =\n  \u003CT>(schema: z.ZodSchema\u003CT>): MiddlewareHandler =>\n  async (c, next) => {\n    const body = await c.req.json()\n    const result = schema.safeParse(body)\n\n    if (!result.success) {\n      return c.json(\n        { error: 'Validation failed', details: result.error.flatten() },\n        400\n      )\n    }\n\n    c.set('validatedBody', result.data)\n    await next()\n  }\n\n\u002F\u002F Auth middleware using RTE\nexport const requireAuth: MiddlewareHandler = async (c, next) => {\n  const deps = c.get('deps')\n  const token = c.req.header('Authorization')?.replace('Bearer ', '')\n\n  if (!token) {\n    return c.json({ error: 'No token provided' }, 401)\n  }\n\n  const result = await pipe(\n    deps.jwt.verify(token),\n    TE.mapLeft(() => ({ _tag: 'Unauthorized' as const, reason: 'Invalid token' }))\n  )()\n\n  if (E.isLeft(result)) {\n    return c.json({ error: result.left.reason }, 401)\n  }\n\n  c.set('user', result.right)\n  await next()\n}\n\n\u002F\u002F Usage\nconst app = new Hono()\n\napp.use('*', withDeps(deps))\napp.use('\u002Fapi\u002F*', requireAuth)\n\napp.get(\n  '\u002Fapi\u002Fusers\u002F:id',\n  toHonoHandler(\n    c => UserService.findById(c.req.param('id')),\n    (error, c) => {\n      if (error._tag === 'UserNotFound') {\n        return c.json({ error: 'User not found' }, 404)\n      }\n      return c.json({ error: 'Internal error' }, 500)\n    }\n  )\n)\n```\n\n### Request Context Pattern\n\n```typescript\n\u002F\u002F src\u002Fcontext.ts\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Request-scoped context\ntype RequestContext = {\n  requestId: string\n  userId: O.Option\u003Cstring>\n  startTime: number\n}\n\ntype ContextDeps = AppDeps & { ctx: RequestContext }\n\n\u002F\u002F Logging with context\nconst logWithContext =\n  (level: 'info' | 'warn' | 'error') =>\n  (message: string, meta?: object): RTE.ReaderTaskEither\u003CContextDeps, never, void> =>\n    pipe(\n      RTE.ask\u003CContextDeps>(),\n      RTE.flatMap(({ logger, ctx }) =>\n        RTE.fromIO(() =>\n          loggerlevel,\n            elapsed: Date.now() - ctx.startTime,\n          })\n        )\n      )\n    )\n\nexport const log = {\n  info: logWithContext('info'),\n  warn: logWithContext('warn'),\n  error: logWithContext('error'),\n}\n\n\u002F\u002F Middleware to create context\nexport const withContext: MiddlewareHandler = async (c, next) => {\n  const deps = c.get('deps')\n  const ctx: RequestContext = {\n    requestId: crypto.randomUUID(),\n    userId: O.fromNullable(c.get('user')?.id),\n    startTime: Date.now(),\n  }\n\n  c.set('deps', { ...deps, ctx })\n\n  \u002F\u002F Log request start\n  deps.logger.info('Request started', {\n    requestId: ctx.requestId,\n    method: c.req.method,\n    path: c.req.path,\n  })\n\n  await next()\n\n  \u002F\u002F Log request end\n  deps.logger.info('Request completed', {\n    requestId: ctx.requestId,\n    status: c.res.status,\n    elapsed: Date.now() - ctx.startTime,\n  })\n}\n```\n\n## Error Handling Patterns\n\n### Typed Error Hierarchy\n\n```typescript\n\u002F\u002F src\u002Ferrors.ts\nimport * as E from 'fp-ts\u002FEither'\nimport * as O from 'fp-ts\u002FOption'\n\n\u002F\u002F Base error types\ntype DomainError =\n  | NotFoundError\n  | ValidationError\n  | ConflictError\n  | AuthError\n  | InfrastructureError\n\ntype NotFoundError = {\n  _tag: 'NotFoundError'\n  resource: string\n  id: string\n}\n\ntype ValidationError = {\n  _tag: 'ValidationError'\n  field: string\n  message: string\n  value?: unknown\n}\n\ntype ConflictError = {\n  _tag: 'ConflictError'\n  resource: string\n  field: string\n  value: string\n}\n\ntype AuthError =\n  | { _tag: 'Unauthenticated' }\n  | { _tag: 'Unauthorized'; required: string }\n  | { _tag: 'TokenExpired' }\n\ntype InfrastructureError = {\n  _tag: 'InfrastructureError'\n  service: string\n  cause: unknown\n}\n\n\u002F\u002F Smart constructors\nexport const notFound = (resource: string, id: string): NotFoundError => ({\n  _tag: 'NotFoundError',\n  resource,\n  id,\n})\n\nexport const validation = (\n  field: string,\n  message: string,\n  value?: unknown\n): ValidationError => ({\n  _tag: 'ValidationError',\n  field,\n  message,\n  value,\n})\n\nexport const conflict = (\n  resource: string,\n  field: string,\n  value: string\n): ConflictError => ({\n  _tag: 'ConflictError',\n  resource,\n  field,\n  value,\n})\n\n\u002F\u002F Error to HTTP status mapping\nexport const toHttpStatus = (error: DomainError): number => {\n  switch (error._tag) {\n    case 'NotFoundError':\n      return 404\n    case 'ValidationError':\n      return 400\n    case 'ConflictError':\n      return 409\n    case 'Unauthenticated':\n      return 401\n    case 'Unauthorized':\n      return 403\n    case 'TokenExpired':\n      return 401\n    case 'InfrastructureError':\n      return 503\n    default:\n      return 500\n  }\n}\n\n\u002F\u002F Error to response body\nexport const toResponseBody = (\n  error: DomainError\n): { error: string; details?: unknown } => {\n  switch (error._tag) {\n    case 'NotFoundError':\n      return { error: `${error.resource} not found` }\n    case 'ValidationError':\n      return {\n        error: 'Validation failed',\n        details: { field: error.field, message: error.message },\n      }\n    case 'ConflictError':\n      return {\n        error: `${error.resource} with ${error.field} already exists`,\n      }\n    case 'Unauthenticated':\n      return { error: 'Authentication required' }\n    case 'Unauthorized':\n      return { error: `Permission denied: ${error.required}` }\n    case 'TokenExpired':\n      return { error: 'Token expired' }\n    case 'InfrastructureError':\n      return { error: 'Service temporarily unavailable' }\n  }\n}\n```\n\n### Error Recovery\n\n```typescript\n\u002F\u002F src\u002Flib\u002Frecovery.ts\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\n\u002F\u002F Retry with exponential backoff\nexport const withRetry =\n  \u003CR, E, A>(\n    maxAttempts: number,\n    baseDelayMs: number,\n    shouldRetry: (error: E) => boolean\n  ) =>\n  (\n    operation: RTE.ReaderTaskEither\u003CR, E, A>\n  ): RTE.ReaderTaskEither\u003CR, E, A> =>\n    pipe(\n      RTE.ask\u003CR>(),\n      RTE.flatMap(deps => {\n        const attempt = (\n          remaining: number,\n          delay: number\n        ): TE.TaskEither\u003CE, A> =>\n          pipe(\n            operation(deps),\n            TE.orElse(error => {\n              if (remaining \u003C= 0 || !shouldRetry(error)) {\n                return TE.left(error)\n              }\n              return pipe(\n                TE.fromTask(() => new Promise(r => setTimeout(r, delay))),\n                TE.flatMap(() => attempt(remaining - 1, delay * 2))\n              )\n            })\n          )\n\n        return RTE.fromTaskEither(attempt(maxAttempts - 1, baseDelayMs))\n      })\n    )\n\n\u002F\u002F Fallback to cached value\nexport const withFallback =\n  \u003CR extends { cache: CacheClient }, E, A>(\n    cacheKey: string,\n    ttlSeconds: number\n  ) =>\n  (\n    operation: RTE.ReaderTaskEither\u003CR, E, A>\n  ): RTE.ReaderTaskEither\u003CR, E, A> =>\n    pipe(\n      RTE.ask\u003CR>(),\n      RTE.flatMap(({ cache, ...rest }) =>\n        pipe(\n          operation,\n          \u002F\u002F On success, cache the result\n          RTE.tap(result =>\n            RTE.fromTaskEither(cache.set(cacheKey, result, ttlSeconds))\n          ),\n          \u002F\u002F On failure, try to get cached value\n          RTE.orElse(error =>\n            pipe(\n              RTE.fromTaskEither(cache.get\u003CA>(cacheKey)),\n              RTE.flatMap(cached =>\n                cached ? RTE.right(cached) : RTE.left(error)\n              )\n            )\n          )\n        )\n      )\n    )\n\n\u002F\u002F Circuit breaker\ntype CircuitState = 'closed' | 'open' | 'half-open'\n\nexport const createCircuitBreaker = \u003CE>(\n  failureThreshold: number,\n  resetTimeoutMs: number,\n  isFailure: (error: E) => boolean\n) => {\n  let state: CircuitState = 'closed'\n  let failures = 0\n  let lastFailure = 0\n\n  return \u003CR, A>(\n    operation: RTE.ReaderTaskEither\u003CR, E, A>\n  ): RTE.ReaderTaskEither\u003CR, E | { _tag: 'CircuitOpen' }, A> =>\n    pipe(\n      RTE.ask\u003CR>(),\n      RTE.flatMap(deps => {\n        \u002F\u002F Check if circuit should reset\n        if (\n          state === 'open' &&\n          Date.now() - lastFailure > resetTimeoutMs\n        ) {\n          state = 'half-open'\n        }\n\n        if (state === 'open') {\n          return RTE.left({ _tag: 'CircuitOpen' as const })\n        }\n\n        return pipe(\n          operation,\n          RTE.tap(() => {\n            if (state === 'half-open') {\n              state = 'closed'\n              failures = 0\n            }\n            return RTE.right(undefined)\n          }),\n          RTE.tapError(error => {\n            if (isFailure(error)) {\n              failures++\n              lastFailure = Date.now()\n              if (failures >= failureThreshold) {\n                state = 'open'\n              }\n            }\n            return RTE.right(undefined)\n          })\n        )\n      })\n    )\n}\n```\n\n## Testing Strategies\n\n### Mocking Dependencies\n\n```typescript\n\u002F\u002F src\u002Fservices\u002F__tests__\u002Fuser.service.test.ts\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport * as O from 'fp-ts\u002FOption'\nimport { describe, it, expect, vi } from 'vitest'\nimport * as UserService from '..\u002Fuser.service'\n\n\u002F\u002F Create mock dependencies\nconst createMockDeps = (overrides: Partial\u003CUserDeps> = {}): UserDeps => ({\n  db: {\n    users: {\n      findUnique: vi.fn(() => Promise.resolve(null)),\n      create: vi.fn(data => Promise.resolve({ id: '1', ...data })),\n      update: vi.fn((where, data) => Promise.resolve({ id: where.id, ...data })),\n    },\n  },\n  hasher: {\n    hash: vi.fn(password => TE.right(`hashed_${password}`)),\n    verify: vi.fn(() => TE.right(true)),\n  },\n  mailer: {\n    send: vi.fn(() => TE.right(undefined)),\n  },\n  ...overrides,\n})\n\ndescribe('UserService', () => {\n  describe('create', () => {\n    it('should create a user with hashed password', async () => {\n      const deps = createMockDeps()\n      const input = {\n        email: 'test@example.com',\n        password: 'secret123',\n        name: 'Test User',\n      }\n\n      const result = await UserService.create(input)(deps)()\n\n      expect(E.isRight(result)).toBe(true)\n      if (E.isRight(result)) {\n        expect(result.right.email).toBe(input.email)\n      }\n      expect(deps.hasher.hash).toHaveBeenCalledWith('secret123')\n    })\n\n    it('should fail when email already exists', async () => {\n      const existingUser = { id: '1', email: 'test@example.com' }\n      const deps = createMockDeps({\n        db: {\n          users: {\n            findUnique: vi.fn(() => Promise.resolve(existingUser)),\n            create: vi.fn(),\n          },\n        },\n      })\n\n      const result = await UserService.create({\n        email: 'test@example.com',\n        password: 'secret',\n        name: 'Test',\n      })(deps)()\n\n      expect(E.isLeft(result)).toBe(true)\n      if (E.isLeft(result)) {\n        expect(result.left._tag).toBe('EmailExists')\n      }\n    })\n  })\n\n  describe('findById', () => {\n    it('should return user when found', async () => {\n      const user = { id: '1', email: 'test@example.com', name: 'Test' }\n      const deps = createMockDeps({\n        db: {\n          users: {\n            findUnique: vi.fn(() => Promise.resolve(user)),\n          },\n        },\n      })\n\n      const result = await UserService.findById('1')(deps)()\n\n      expect(E.isRight(result)).toBe(true)\n      if (E.isRight(result)) {\n        expect(result.right).toEqual(user)\n      }\n    })\n\n    it('should return NotFound when user does not exist', async () => {\n      const deps = createMockDeps()\n\n      const result = await UserService.findById('nonexistent')(deps)()\n\n      expect(E.isLeft(result)).toBe(true)\n      if (E.isLeft(result)) {\n        expect(result.left._tag).toBe('UserNotFound')\n        expect(result.left.id).toBe('nonexistent')\n      }\n    })\n  })\n})\n```\n\n### Integration Testing with Test Containers\n\n```typescript\n\u002F\u002F src\u002F__tests__\u002Fintegration\u002Fuser.integration.test.ts\nimport { PostgreSqlContainer } from '@testcontainers\u002Fpostgresql'\nimport { PrismaClient } from '@prisma\u002Fclient'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\nimport { describe, it, expect, beforeAll, afterAll } from 'vitest'\nimport { buildDeps, destroyDeps, AppDeps } from '..\u002F..\u002Fdeps'\nimport * as UserService from '..\u002F..\u002Fservices\u002Fuser.service'\n\ndescribe('UserService Integration', () => {\n  let container: PostgreSqlContainer\n  let deps: AppDeps\n\n  beforeAll(async () => {\n    \u002F\u002F Start PostgreSQL container\n    container = await new PostgreSqlContainer().start()\n\n    \u002F\u002F Build real dependencies with test database\n    process.env.DATABASE_URL = container.getConnectionUri()\n\n    const depsResult = await buildDeps()()\n    if (E.isLeft(depsResult)) {\n      throw new Error(`Failed to build deps: ${depsResult.left}`)\n    }\n    deps = depsResult.right\n\n    \u002F\u002F Run migrations\n    await deps.db.$executeRaw`CREATE EXTENSION IF NOT EXISTS \"uuid-ossp\"`\n    \u002F\u002F ... run Prisma migrations\n  }, 60000)\n\n  afterAll(async () => {\n    await destroyDeps(deps)()\n    await container.stop()\n  })\n\n  it('should create and retrieve a user', async () => {\n    \u002F\u002F Create user\n    const createResult = await UserService.create({\n      email: 'integration@test.com',\n      password: 'password123',\n      name: 'Integration Test',\n    })(deps)()\n\n    expect(E.isRight(createResult)).toBe(true)\n    if (E.isLeft(createResult)) return\n\n    const user = createResult.right\n\n    \u002F\u002F Retrieve user\n    const findResult = await UserService.findById(user.id)(deps)()\n\n    expect(E.isRight(findResult)).toBe(true)\n    if (E.isRight(findResult)) {\n      expect(findResult.right.email).toBe('integration@test.com')\n    }\n  })\n})\n```\n\n### Property-Based Testing\n\n```typescript\n\u002F\u002F src\u002F__tests__\u002Fproperty\u002Fuser.property.test.ts\nimport * as fc from 'fast-check'\nimport * as E from 'fp-ts\u002FEither'\nimport { describe, it, expect } from 'vitest'\nimport { validateEmail, validatePassword } from '..\u002F..\u002Fvalidation'\n\ndescribe('Validation Properties', () => {\n  it('valid emails should pass validation', () => {\n    fc.assert(\n      fc.property(fc.emailAddress(), email => {\n        const result = validateEmail(email)\n        return E.isRight(result)\n      })\n    )\n  })\n\n  it('passwords meeting requirements should pass', () => {\n    const validPassword = fc\n      .tuple(\n        fc.stringOf(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyz'), {\n          minLength: 4,\n        }),\n        fc.stringOf(fc.constantFrom(...'ABCDEFGHIJKLMNOPQRSTUVWXYZ'), {\n          minLength: 1,\n        }),\n        fc.stringOf(fc.constantFrom(...'0123456789'), { minLength: 1 }),\n        fc.stringOf(fc.constantFrom(...'!@#$%^&*'), { minLength: 1 })\n      )\n      .map(parts => parts.join(''))\n\n    fc.assert(\n      fc.property(validPassword, password => {\n        const result = validatePassword(password)\n        return E.isRight(result)\n      })\n    )\n  })\n\n  it('empty strings should fail email validation', () => {\n    const result = validateEmail('')\n    expect(E.isLeft(result)).toBe(true)\n  })\n})\n```\n\n## Quick Reference\n\n### Common Imports\n\n```typescript\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport * as TE from 'fp-ts\u002FTaskEither'\nimport * as E from 'fp-ts\u002FEither'\nimport * as O from 'fp-ts\u002FOption'\nimport * as A from 'fp-ts\u002FArray'\nimport * as T from 'fp-ts\u002FTask'\nimport { pipe, flow } from 'fp-ts\u002Ffunction'\n```\n\n### RTE Cheat Sheet\n\n| Operation | Description |\n|-----------|-------------|\n| `RTE.right(a)` | Lift value into success |\n| `RTE.left(e)` | Create error |\n| `RTE.ask\u003CR>()` | Get dependencies |\n| `RTE.fromTaskEither(te)` | Lift TaskEither |\n| `RTE.fromEither(e)` | Lift Either |\n| `RTE.fromOption(onNone)(o)` | Lift Option |\n| `RTE.flatMap(f)` | Chain operations |\n| `RTE.map(f)` | Transform success |\n| `RTE.mapLeft(f)` | Transform error |\n| `RTE.tap(f)` | Side effect on success |\n| `RTE.tapError(f)` | Side effect on error |\n| `RTE.orElse(f)` | Recover from error |\n| `RTE.getOrElse(f)` | Extract with fallback |\n\n### Service Template\n\n```typescript\n\u002F\u002F Template for a new service\nimport * as RTE from 'fp-ts\u002FReaderTaskEither'\nimport { pipe } from 'fp-ts\u002Ffunction'\n\ntype MyServiceDeps = {\n  db: DatabaseClient\n  \u002F\u002F ... other dependencies\n}\n\ntype MyServiceError =\n  | { _tag: 'NotFound'; id: string }\n  | { _tag: 'ValidationFailed'; reason: string }\n\nexport const myOperation = (\n  input: Input\n): RTE.ReaderTaskEither\u003CMyServiceDeps, MyServiceError, Output> =>\n  pipe(\n    RTE.ask\u003CMyServiceDeps>(),\n    RTE.flatMap(deps =>\n      \u002F\u002F Your implementation here\n      RTE.right(output)\n    )\n  )\n```\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n",{"name":5,"risk":24,"tags":25,"author":34,"source":35,"version":36,"description":7},"unknown",[26,27,28,29,30,31,32,33],"fp-ts","typescript","backend","functional-programming","node","deno","dependency-injection","reader-task-either","kadu","community","1.0.0","main","87afe6ce96220accf50a345dea46784c8c9f210e","YYC3-Skills-技能包\u002FYYC3-Skills-技能包-antigravity-awesome-skills\u002Fskills\u002Ffp-backend",0,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base","https:\u002F\u002Fkb.yyc3.top\u002F","https:\u002F\u002Fgithub.com\u002FYYC-Cube","万象归元于云枢 | 深栈智启新纪元","2026-11-10 10:37:32",{"source":8,"skillName":5,"commands":47,"prompt":57,"zipAvailable":58},[48,51,54],{"tool":49,"command":50},"npx","npx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill fp-backend",{"tool":52,"command":53},"bunx","bunx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill fp-backend",{"tool":55,"command":56},"pnpm","pnpm dlx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill fp-backend","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-Skills-技能包\u002FYYC3-Skills-技能包-antigravity-awesome-skills\u002Fskills\u002Ffp-backend\u002FSKILL.md",true,[],[61,68,75,82,89,96],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7CTDWHERCXPQCP0K03A86AS","vercel-sandbox","Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include \"Vercel Sandbox browser\", \"microVM Chrome\", \"agent-browser in sandbox\", \"browser automation on Vercel\", or any task requiring Chrome in a Vercel Sandbox.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fvercel-sandbox\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7CTD8D2BNJY54S65M47HEJA","slack","Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include \"check my Slack\", \"what channels have unreads\", \"send a message to\", \"search Slack for\", \"extract from Slack\", \"find who said\", or any task requiring programmatic Slack interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fslack\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7CTCSSB8ZP3Q58C3YZDZK1W","electron","Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include \"automate Slack app\", \"control VS Code\", \"interact with Discord app\", \"test this Electron app\", \"connect to desktop app\", or any task requiring automation of a native Electron application.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Felectron\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7CTCBJY76688V4DCZGWFHGQ","dogfood","Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to \"dogfood\", \"QA\", \"exploratory test\", \"find issues\", \"bug hunt\", \"test this app\u002Fsite\u002Fplatform\", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fdogfood\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7CTC4H0FFGVEAQR9PA4GA1A","agent-browser","Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to \"open a website\", \"fill out a form\", \"click a button\", \"take a screenshot\", \"scrape data from a page\", \"test this web app\", \"login to a site\", \"automate browser actions\", or any task requiring programmatic web interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fagent-browser\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M7CTBKVFYBG78FDSABSDJTTQ","shadcn","Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn\u002Fui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for \"shadcn init\", \"create an app with --preset\", \"switch to --preset\", and for building a design system or applying a DESIGN.md or brand spec to shadcn\u002Fui.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-UI-界面组件\u002FYYC3-UI-界面组件-ui\u002Fskills\u002Fshadcn\u002FSKILL.md",[],[]]