@xenterprises/fastify-xstripe 1.0.0

package/.dockerignore

@@ -0,0 +1,62 @@
+# Git
+.git
+.gitignore
+.gitattributes
+
+# Node modules (will be installed in container)
+node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Dependencies
+.npm
+.eslintcache
+*.tsbuildinfo
+
+# Temporary files
+.DS_Store
+Thumbs.db
+*.tmp
+.env.local
+.env.*.local
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+*.swn
+*~
+
+# Test & Coverage
+coverage
+.nyc_output
+test
+*.test.js
+
+# Build artifacts (if any)
+dist
+build
+out
+
+# Docker files (not needed in image)
+Dockerfile*
+docker-compose*.yml
+.dockerignore
+
+# CI/CD
+.github
+.gitlab-ci.yml
+
+# Documentation (optional - include if you want docs in image)
+# *.md
+
+# Example/demo files
+examples
+demo
+
+# Logs
+logs
+*.log

package/.env.example

@@ -0,0 +1,116 @@
+# ============================================================================
+# xStripe Fastify Plugin - Environment Configuration
+# ============================================================================
+# This file defines environment variables for the xStripe module.
+# Copy this to .env and update values for your environment.
+# ============================================================================
+
+# ============================================================================
+# SERVER CONFIGURATION
+# ============================================================================
+
+# Server port (default: 3000)
+PORT=3000
+
+# Node environment (development | production | test)
+NODE_ENV=development
+
+# Server hostname/domain (used in webhook URLs and responses)
+# Update this to your actual domain in production
+DOMAIN=http://localhost:3000
+
+# ============================================================================
+# STRIPE CONFIGURATION - REQUIRED
+# ============================================================================
+
+# Stripe API Key (Secret Key)
+# Get from: https://dashboard.stripe.com/apikeys
+# Format: sk_test_... (test mode) or sk_live_... (production)
+# NEVER commit this value - use environment variables only
+STRIPE_API_KEY=sk_test_your_key_here
+
+# Stripe Webhook Signing Secret
+# Get from: https://dashboard.stripe.com/webhooks
+# Copy the "Signing secret" for your webhook endpoint
+# Format: whsec_...
+STRIPE_WEBHOOK_SECRET=whsec_your_secret_here
+
+# ============================================================================
+# WEBHOOK CONFIGURATION
+# ============================================================================
+
+# Webhook endpoint path (relative to domain)
+# Default: /webhooks/stripe
+# STRIPE_WEBHOOK_PATH=/webhooks/stripe
+
+# Webhook events to listen for (space or comma-separated)
+# Default: all supported events
+# Examples:
+#   customer.created,customer.updated,customer.deleted
+#   invoice.created,invoice.finalized,invoice.paid
+#   charge.succeeded,charge.failed
+# STRIPE_WEBHOOK_EVENTS=*
+
+# ============================================================================
+# LOGGING & MONITORING
+# ============================================================================
+
+# Fastify logger level (trace, debug, info, warn, error, fatal)
+LOG_LEVEL=info
+
+# Enable webhook event logging
+# LOG_WEBHOOK_EVENTS=true
+
+# Enable handler execution logging
+# LOG_HANDLER_EXECUTION=true
+
+# ============================================================================
+# ERROR HANDLING & RECOVERY
+# ============================================================================
+
+# Retry failed webhook handler executions
+# ENABLE_HANDLER_RETRY=false
+
+# Max retry attempts for failed handlers
+# HANDLER_RETRY_MAX_ATTEMPTS=3
+
+# Retry delay in milliseconds
+# HANDLER_RETRY_DELAY_MS=5000
+
+# ============================================================================
+# SECURITY
+# ============================================================================
+
+# Enable HTTPS enforcement (if behind reverse proxy)
+# HTTPS_ONLY=false
+
+# Rate limiting: max webhook requests per minute
+# WEBHOOK_RATE_LIMIT_WINDOW=1m
+# WEBHOOK_RATE_LIMIT_MAX=1000
+
+# Timeout for webhook handler execution (milliseconds)
+# Default: 30000 (30 seconds)
+# WEBHOOK_HANDLER_TIMEOUT=30000
+
+# ============================================================================
+# STRIPE ACCOUNT CONFIGURATION
+# ============================================================================
+
+# Stripe API Version (optional - uses account default if not set)
+# Format: YYYY-MM-DD or leave empty
+# STRIPE_API_VERSION=
+
+# Enable Stripe CLI webhooks in development
+# Set to true if using: stripe listen --forward-to localhost:3000/webhooks/stripe
+# STRIPE_CLI_MODE=false
+
+# ============================================================================
+# DATABASE/STORAGE (optional - for persisting event data)
+# ============================================================================
+
+# Database URL for event persistence (optional)
+# Example: postgresql://user:pass@localhost/stripe_events
+# DATABASE_URL=
+
+# Enable event persistence
+# PERSIST_WEBHOOK_EVENTS=false