feat: initial commit of serverless-uv-requirements plugin

- Added package.json with metadata, scripts, and dependencies.
- Implemented UvRequirementsPlugin for managing Python dependencies using uv.
- Created utility functions for command execution and configuration management.
- Defined types for plugin configuration and serverless instance.
- Added Jest tests for plugin functionality and utility methods.
- Included setup file for Jest configuration and global mocks.
- Configured TypeScript with strict settings and output directory.
- Added example pyproject.toml and serverless.yml files for testing.

Author: Programmer-RD-AI

.eslintignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+coverage/
+*.js
+*.d.ts
+test/fixtures/

.eslintrc.js

@@ -0,0 +1,18 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended',
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+    es2020: true,
+  },
+  ignorePatterns: ['.eslintrc.js', 'dist/', 'coverage/', 'node_modules/'],
+  rules: {
+    'no-unused-vars': 'off',
+    'no-undef': 'off',
+  },
+};

.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [16.x, 18.x, 20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Run tests
+        run: npm run test:coverage
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v3
+        if: matrix.node-version == '18.x'
+        with:
+          file: ./coverage/lcov.info
+
+  integration-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js 18.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18.x
+          cache: "npm"
+
+      - name: Install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build plugin
+        run: npm run build
+
+      - name: Test plugin with real uv
+        run: |
+          cd test/fixtures
+          npm link ../../
+          npx serverless package

.github/workflows/release.yml

@@ -0,0 +1,35 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Use Node.js 18.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18.x
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build
+        run: npm run build
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release

README.md

@@ -1,2 +1,67 @@
 # serverless-uv-requirements
-Serverless UV Requirements – Blazing-fast dependency compile & freeze with uv during the Serverless package phase
+
+[![npm version](https://badge.fury.io/js/serverless-uv-requirements.svg)](https://badge.fury.io/js/serverless-uv-requirements)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Fast Python dependency resolution using [uv](https://docs.astral.sh/uv/) for Serverless Framework.
+
+Generates `requirements.txt` from `pyproject.toml` using uv's fast resolver, then works with `serverless-python-requirements` for Lambda packaging.
+
+## Installation
+
+```bash
+npm install --save-dev serverless-uv-requirements serverless-python-requirements
+```
+
+## Setup
+
+```yaml
+# serverless.yml
+plugins:
+  - serverless-uv-requirements
+  - serverless-python-requirements
+
+custom:
+  uv:
+    mode: compile
+    source: pyproject.toml
+    output: requirements.txt
+
+  pythonRequirements:
+    dockerizePip: non-linux
+```
+
+```toml
+# pyproject.toml
+[project]
+dependencies = [
+    "fastapi>=0.104.0",
+    "pydantic>=2.0.0",
+]
+```
+
+## Configuration
+
+```yaml
+custom:
+  uv:
+    mode: compile # 'compile' or 'freeze'
+    source: pyproject.toml # Input file
+    output: requirements.txt # Output file
+    verbose: false # Enable verbose logging
+    skipIfMissing: false # Skip if uv not available
+```
+
+## Requirements
+
+- **uv**: `curl -LsSf https://astral.sh/uv/install.sh | sh`
+- **Serverless Framework**: >=3.0.0
+
+## How it works
+
+1. uv resolves dependencies from `pyproject.toml` to `requirements.txt` (10-100x faster than pip)
+2. serverless-python-requirements handles Lambda packaging
+
+## License
+
+MIT

jest.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  preset: "ts-jest",
+  testEnvironment: "node",
+  roots: ["<rootDir>/src", "<rootDir>/test"],
+  testMatch: ["**/__tests__/**/*.ts", "**/?(*.)+(spec|test).ts"],
+  collectCoverageFrom: ["src/**/*.ts", "!src/**/*.d.ts"],
+  coverageDirectory: "coverage",
+  coverageReporters: ["text", "lcov", "html"],
+  setupFilesAfterEnv: ["<rootDir>/test/setup.ts"],
+};