Contributing to MediaProc

# Edit files
code .

# Run in watch mode during development
pnpm dev

# Run all tests
pnpm test

# Run specific test
pnpm test path/to/test.ts

# Run tests in watch mode
pnpm test:watch

# Check linting
pnpm lint

# Fix linting issues
pnpm lint:fix

# Format code
pnpm format

# Build all packages
pnpm build

# Build specific package
pnpm build --filter @mediaproc/image

# Link for local testing
pnpm link --global

# Test your changes
mediaproc image resize test.jpg -w 800

// Use TypeScript for all new code
export interface ResizeOptions {
  width?: number;
  height?: number;
  fit?: "cover" | "contain" | "fill";
}

// Avoid 'any' type
function process(options: ResizeOptions): Promise<void> {
  // Implementation
}

// Use async/await over callbacks
async function readFile(path: string): Promise<Buffer> {
  return await fs.readFile(path);
}

// Use 2 spaces for indentation
function example() {
  if (condition) {
    doSomething();
  }
}

// Use single quotes for strings
const message = "Hello, world!";

// Use template literals for interpolation
const greeting = `Hello, ${name}!`;

// Use arrow functions for callbacks
array.map((item) => item.value);

// Use destructuring
const { width, height } = options;

// Use async/await
async function process() {
  const data = await readFile(path);
  return processData(data);
}

// PascalCase for types and classes
interface ImageOptions {}
class ImageProcessor {}

// camelCase for variables and functions
const inputFile = "image.jpg";
function processImage() {}

// UPPER_CASE for constants
const MAX_FILE_SIZE = 1024 * 1024 * 10;

// kebab-case for file names
// image-processor.ts
// path-validator.ts

// Use custom error classes
class ValidationError extends Error {
  constructor(message: string) {
    super(message);
    this.name = "ValidationError";
  }
}

// Throw meaningful errors
if (!input) {
  throw new ValidationError("Input file is required");
}

// Handle errors appropriately
try {
  await processFile(input);
} catch (error) {
  if (error instanceof ValidationError) {
    console.error("Validation failed:", error.message);
  } else {
    console.error("Unexpected error:", error);
  }
  process.exit(1);
}

import { describe, it, expect } from "vitest";
import { validatePath } from "./validator";

describe("validatePath", () => {
  it("should accept valid paths", () => {
    expect(validatePath("/path/to/file.jpg")).toBe(true);
  });

  it("should reject empty paths", () => {
    expect(() => validatePath("")).toThrow("Path is required");
  });

  it("should reject invalid extensions", () => {
    expect(() => validatePath("file.txt")).toThrow("Invalid file type");
  });
});

describe("resize command", () => {
  it("should resize image to specified width", async () => {
    await resize("test.jpg", { width: 800 });
    const metadata = await getMetadata("test-resized.jpg");
    expect(metadata.width).toBe(800);
  });
});

feat(image): add smart crop command

Add new smart crop command that uses AI to detect important
areas in images and crop accordingly.

Closes #123

fix(video): correct fps calculation

The fps calculation was incorrect for variable frame rate videos.
Now properly handles VFR content.

Fixes #456

docs(readme): update installation instructions

Update instructions to use pnpm instead of npm.

# Fetch upstream changes
git fetch upstream

# Rebase your branch
git rebase upstream/main

# Push to your fork
git push origin feature/my-new-feature

# Make requested changes
git add .
git commit -m "Address review feedback"
git push origin feature/my-new-feature