local-serverless-stack 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,104 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.1] - 2026-01-23
+
+### Added
+
+- 🎉 **Initial public release** of Local Serverless Stack (LSS)
+- **CLI Tool**: Background process management with `lss start/stop/status/logs` commands
+- **Orchestrator**: Express API server with embedded Vue 3 UI dashboard
+- **LocalStack Integration**: Single centralized instance for all microservices
+- **Auto-provisioning**: CloudFormation template parsing and resource creation
+- **Lambda Proxies**: On-demand proxy generation for event source mappings
+- **Event Source Mappings**: Automatic connection of DynamoDB/SQS/SNS to Lambda handlers
+- **Serverless Plugin**: Auto-registration of services during `sls package`
+- **Web UI**: Real-time dashboard for monitoring services and resources
+- **Comprehensive Testing**: 34 integration tests with 100% pass rate
+- **CI/CD Pipeline**: Automated testing and NPM publishing via GitHub Actions
+- **Complete Documentation**: README, API docs, and examples
+
+### Features
+
+#### Core Capabilities
+- Centralized LocalStack container management (port 4566)
+- CloudFormation resource provisioning:
+  - DynamoDB tables with streams
+  - SQS queues with event mappings
+  - SNS topics with subscriptions
+  - Lambda proxies (on-demand creation)
+- Event flow: AWS Service → Lambda Proxy → Serverless Offline
+- Service registration via plugin or API
+- Process management (PID files, background mode)
+
+#### CLI Commands
+- `lss start` - Start orchestrator in background
+- `lss stop` - Stop orchestrator gracefully
+- `lss status` - Check running status
+- `lss logs` - View recent logs
+- `lss help` - Display usage information
+
+#### API Endpoints
+- `POST /api/services/register` - Register new service
+- `GET /api/services` - List all services
+- `DELETE /api/services/:name` - Remove service
+- `GET /api/resources` - List provisioned resources
+- `GET /api/health` - Health check
+
+#### Optimizations
+- Lambda functions created only on-demand (not duplicated)
+- Proxy functions forward to serverless-offline HTTP invoke
+- Event transformation for DynamoDB streams, SQS messages, SNS notifications
+- Efficient CloudFormation intrinsic function resolution
+
+### Testing
+- **CLI Tests**: 10/10 passing
+- **Orchestrator Tests**: 12/12 passing
+- **Plugin Tests**: 6/6 passing
+- **Smoke Tests**: 6/6 passing
+- **Total Coverage**: 34/34 tests (100%)
+
+### Development
+- TypeScript throughout
+- ESM modules
+- Vue 3 with Composition API
+- Express.js server
+- AWS SDK v3
+- Jest for testing
+- GitHub Actions for CI/CD
+
+### Documentation
+- Complete README with quick start guide
+- Architecture diagrams (Mermaid)
+- API documentation
+- Plugin integration examples
+- Release process guide
+- Contribution guidelines
+
+### Known Limitations
+- Requires Docker for LocalStack
+- Tested on Linux (Ubuntu/Debian)
+- Node.js >= 18 required
+- Serverless Framework >= 3.0 required
+
+### Breaking Changes
+None (initial release)
+
+### Migration Guide
+Not applicable (initial release)
+
+---
+
+## [Unreleased]
+
+### Planned Features
+- S3 bucket provisioning
+- EventBridge integration
+- Enhanced UI with real-time updates
+- Multi-region support
+- CloudWatch logs integration
+- Improved error handling and validation

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LSS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.