chore: add CLAUDE.md and pnpm workspace config, update README

Introduces CLAUDE.md with guidance for Claude Code, adds pnpm-workspace.yaml for workspace dependency management, and updates README with installation, usage, and development instructions. Also documents new FileStore interface methods and improves code examples.

Author: saby1101

CLAUDE.md

@@ -0,0 +1,44 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Common Development Commands
+
+- **Build**: `pnpm run build` - Cleans dist and compiles TypeScript
+- **Test**: `pnpm test` - Runs Jest test suite
+- **Test with coverage**: `pnpm run test:coverage` - Runs tests with coverage report
+- **Format code**: `pnpm run pretty` - Formats code with Prettier
+- **Clean**: `pnpm run clean` - Removes dist directory
+- **Transpile**: `pnpm run transpile` - TypeScript compilation only
+
+## Project Architecture
+
+This is a Fastify plugin library (`@stackbox-dev/fp-plugins`) that provides reusable plugins for Stackbox applications. The architecture follows a modular plugin-based design:
+
+### Core Structure
+- **Main exports** (`src/index.ts`): Exposes `Plugins.EventBus` and `Plugins.FileStore`
+- **Event Bus Plugin** (`src/event-bus/`): Message broker abstraction supporting RabbitMQ, GCP Pub/Sub, Azure Service Bus, and local in-process messaging
+- **File Store Plugin** (`src/file-store.ts`): Cloud storage abstraction supporting AWS S3, GCS, Azure Blob Storage, MinIO, and local filesystem
+
+### Event Bus System
+- Uses a factory pattern to instantiate different message brokers based on `busType` configuration
+- Provides event consumer functionality for external event processing
+- Includes built-in `/event-bus/publish/:event` endpoint (can be disabled)
+- Supports delayed event processing and retry mechanisms with exponential backoff
+
+### File Store System
+- Implements a common `FileStore` interface across all storage providers
+- Supports both streaming and buffer-based file operations
+- Uses environment variables for provider-specific configuration
+- Handles authentication through provider-specific credential chains (AWS IAM, GCP ADC, Azure Managed Identity)
+
+### Plugin Registration
+Both plugins are registered as Fastify plugins using `fastify-plugin` and follow the standard Fastify plugin lifecycle. They decorate the Fastify instance with their respective interfaces (`EventBus` and `FileStore`).
+
+## Testing
+Tests are configured with Jest and ts-jest, located in the `src/` directory with `.spec.ts` extension. Coverage reports are generated in the `coverage/` directory.
+
+## Build Configuration
+- TypeScript configuration uses `tsconfig.build.json` for production builds
+- Excludes test files (`**/*.spec.ts`) from production builds
+- Outputs to `dist/` directory with type definitions

README.md

@@ -5,6 +5,8 @@ Fastify plugins for Stackbox applications.
 ## Installation
 
 ```bash
+pnpm install @stackbox/fp-plugins
+# or
 npm install @stackbox/fp-plugins
 ```
 
@@ -100,7 +102,7 @@ app.register(Plugins.EventBus, {
 #### Usage Example
 
 ```typescript
-import { EventBus, Plugins } from "@stackbox/fp-plugins";
+import { EventBus, Plugins, EventBusOptions, EventMessage } from "@stackbox/fp-plugins";
 
 const app = fastify();
 
@@ -251,6 +253,7 @@ The plugin provides a `FileStore` interface with the following methods:
 ```typescript
 interface FileStore {
   exists(filepath: string): Promise<boolean>;
+  getInfo(filepath: string): Promise<FileInfo | null>;
   save(
     filepath: string,
     contentType: string,
@@ -269,12 +272,18 @@ interface FileStore {
     localFilepath: string,
   ): Promise<void>;
 }
+
+interface FileInfo {
+  size: number;
+  contentType: string;
+  lastModified: Date;
+}
 ```
 
 #### Usage Example
 
 ```typescript
-import { Plugins } from "@stackbox/fp-plugins";
+import { Plugins, FileStore } from "@stackbox/fp-plugins";
 import { fastify } from "fastify";
 
 const app = fastify();
@@ -291,6 +300,12 @@ app.post("/upload", async (request, reply) => {
   // Check if file exists
   const exists = await request.server.FileStore.exists(filepath);
 
+  // Get file info (returns null if file doesn't exist)
+  const fileInfo = await request.server.FileStore.getInfo(filepath);
+  if (fileInfo) {
+    console.log(`File size: ${fileInfo.size}, Content type: ${fileInfo.contentType}`);
+  }
+
   // Save file
   await request.server.FileStore.save(filepath, contentType, data);
 
@@ -318,6 +333,26 @@ app.post("/upload", async (request, reply) => {
 });
 ```
 
+## Development
+
+### Prerequisites
+- Node.js 18+ 
+- pnpm
+
+### Setup
+```bash
+pnpm install
+```
+
+### Common Commands
+- `pnpm test` - Run tests
+- `pnpm run test:coverage` - Run tests with coverage
+- `pnpm run build` - Build the project
+- `pnpm run pretty` - Format code
+
+### Testing
+Tests are written using Jest and located alongside source files with `.spec.ts` extension.
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+onlyBuiltDependencies:
+  - protobufjs
+  - unrs-resolver