artanis/PriceUpdaterAppv2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Cleaned up everything, updated docs, and removed unnecessary files.

Browse Source
This commit is contained in:
Spencer Grimes
2025-08-19 15:07:04 -05:00
parent 35960388cf
commit cd11efb856
28 changed files with 746 additions and 7096 deletions
Download Patch File Download Diff File Expand all files Collapse all files

509
README.md
View File

@@ -1,16 +1,32 @@
# Shopify Price Updater
A Node.js script that bulk updates product prices in your Shopify store based on product tags using Shopify's GraphQL Admin API.
A comprehensive Node.js command-line tool for bulk updating Shopify product prices based on product tags using Shopify's GraphQL Admin API. Supports both price updates and rollback operations with advanced scheduling, error handling, and progress tracking.
## Features
## 🚀 Key Features
- **Tag-based filtering**: Update prices only for products with specific tags
- **Percentage-based adjustments**: Increase or decrease prices by a configurable percentage
- **Batch processing**: Handles large inventories with automatic pagination
- **Error resilience**: Continues processing even if individual products fail
- **Rate limit handling**: Automatic retry logic for API rate limits
- **Progress tracking**: Detailed logging to both console and Progress.md file
- **Environment-based configuration**: Secure credential management via .env file
### Core Functionality
- **🏷️ Tag-based filtering**: Update prices only for products with specific tags
- **📊 Dual operation modes**: Price updates with percentage adjustments OR rollback to original prices
- **⏰ Scheduled execution**: Schedule price changes for specific dates and times
- **🔄 Rollback capability**: Revert promotional pricing using compare-at prices
- **📈 Percentage-based adjustments**: Increase or decrease prices by configurable percentages
### Advanced Features
- **🔁 Batch processing**: Handles large inventories with automatic pagination
- **🛡️ Error resilience**: Continues processing even if individual products fail
- **⚡ Rate limit handling**: Automatic retry logic with exponential backoff
- **📝 Progress tracking**: Detailed logging to console and Progress.md file
- **🔍 Debug tools**: Tag analysis and troubleshooting utilities
- **🔐 Secure configuration**: Environment-based credential management
### Enterprise Features
- **📊 Comprehensive reporting**: Success rates, error analysis, and recommendations
- **🎯 Validation**: Pre-flight checks for products, prices, and configuration
- **⏱️ Performance optimization**: Efficient API usage and batch processing
- **🔧 Troubleshooting**: Built-in debugging and error categorization
## Prerequisites
@@ -33,6 +49,42 @@ A Node.js script that bulk updates product prices in your Shopify store based on
```
4. Configure your environment variables (see Configuration section)
## 🔧 Complete Functionality Overview
### Operation Modes
| Mode | Description | Use Case | Configuration |
| ------------ | --------------------------- | ---------------------------------------- | ------------------------------------------------------- |
| **Update** | Adjust prices by percentage | Sales, promotions, price increases | `OPERATION_MODE=update` + `PRICE_ADJUSTMENT_PERCENTAGE` |
| **Rollback** | Revert to compare-at prices | End promotions, restore original pricing | `OPERATION_MODE=rollback` |
### Execution Types
| Type | Description | When to Use |
| ------------- | -------------------- | --------------------------------- |
| **Immediate** | Run now | Manual price updates, testing |
| **Scheduled** | Run at specific time | Automated sales, timed promotions |
### Supported Operations
| Operation | Capability | Examples |
| -------------------- | ------------------------ | ------------------------------- |
| **Price Increases** | Positive percentages | `+10%`, `+25%`, `+5.5%` |
| **Price Decreases** | Negative percentages | `-15%`, `-30%`, `-12.5%` |
| **Rollback** | Restore original prices | End sale, revert promotion |
| **Batch Processing** | Handle large inventories | 1000+ products |
| **Tag Filtering** | Target specific products | `sale`, `clearance`, `seasonal` |
### Advanced Features
| Feature | Description | Benefit |
| ----------------------- | ---------------------------------------- | ---------------------------- |
| **Rate Limit Handling** | Automatic retry with exponential backoff | Prevents API errors |
| **Error Recovery** | Continue processing despite failures | Maximizes success rate |
| **Progress Tracking** | Real-time console + file logging | Monitor operations |
| **Validation** | Pre-flight checks | Prevent configuration errors |
| **Debug Tools** | Tag analysis and troubleshooting | Identify issues quickly |
## Configuration
Edit the `.env` file with your Shopify store details:
@@ -144,48 +196,120 @@ This will:
- Suggest similar tags if exact match isn't found
- Help troubleshoot tag-related issues
### Example Scenarios
## 💡 Complete Usage Examples
#### Increase prices by 10% for sale items:
### Basic Price Updates
```env
TARGET_TAG=sale
PRICE_ADJUSTMENT_PERCENTAGE=10
```bash
# 10% price increase for sale items
set TARGET_TAG=sale && set PRICE_ADJUSTMENT_PERCENTAGE=10 && npm run update
# 15% discount for clearance items
set TARGET_TAG=clearance && set PRICE_ADJUSTMENT_PERCENTAGE=-15 && npm run update
# 5.5% increase for seasonal products
set TARGET_TAG=seasonal && set PRICE_ADJUSTMENT_PERCENTAGE=5.5 && npm run update
```
#### Decrease prices by 15% for clearance items:
### Promotional Campaigns
```env
TARGET_TAG=clearance
PRICE_ADJUSTMENT_PERCENTAGE=-15
```bash
# Black Friday: 30% off everything with "black-friday" tag
set TARGET_TAG=black-friday && set PRICE_ADJUSTMENT_PERCENTAGE=-30 && npm run update
# End of season: 50% off winter items
set TARGET_TAG=winter && set PRICE_ADJUSTMENT_PERCENTAGE=-50 && npm run update
# Flash sale: 20% off for 4 hours
set TARGET_TAG=flash-sale && set PRICE_ADJUSTMENT_PERCENTAGE=-20 && npm run update
# (Schedule rollback 4 hours later)
```
#### Apply a 5.5% increase to seasonal products:
### Rollback Operations
```env
TARGET_TAG=seasonal
PRICE_ADJUSTMENT_PERCENTAGE=5.5
```bash
# End Black Friday sale (restore original prices)
set TARGET_TAG=black-friday && npm run rollback
# End clearance promotion
set TARGET_TAG=clearance && npm run rollback
# Restore all promotional pricing
set TARGET_TAG=promotion && npm run rollback
```
## Output and Logging
### Scheduled Campaigns
The script provides detailed feedback in two ways:
```bash
# Christmas sale starts December 25th at 10:30 AM
set SCHEDULED_EXECUTION_TIME=2024-12-25T10:30:00 && set TARGET_TAG=christmas && set PRICE_ADJUSTMENT_PERCENTAGE=-25 && npm run update
### Console Output
# New Year sale ends January 1st at midnight
set SCHEDULED_EXECUTION_TIME=2025-01-01T00:00:00 && set TARGET_TAG=new-year && npm run rollback
- Configuration summary at startup
- Real-time progress updates
- Product-by-product price changes
- Final summary with success/failure counts
# Weekend flash sale (Friday 6 PM to Sunday 11 PM)
set SCHEDULED_EXECUTION_TIME=2024-12-20T18:00:00 && set TARGET_TAG=weekend && set PRICE_ADJUSTMENT_PERCENTAGE=-35 && npm run update
set SCHEDULED_EXECUTION_TIME=2024-12-22T23:00:00 && set TARGET_TAG=weekend && npm run rollback
```
### Progress.md File
### Advanced Scenarios
- Persistent log of all operations
- Timestamps for each run
- Detailed error information for debugging
- Historical record of price changes
```bash
# Gradual price increase (multiple steps)
# Step 1: 5% increase
set TARGET_TAG=premium && set PRICE_ADJUSTMENT_PERCENTAGE=5 && npm run update
# Step 2: Additional 3% (total ~8.15%)
set TARGET_TAG=premium && set PRICE_ADJUSTMENT_PERCENTAGE=3 && npm run update
Example console output:
# A/B testing setup
set TARGET_TAG=test-group-a && set PRICE_ADJUSTMENT_PERCENTAGE=-10 && npm run update
set TARGET_TAG=test-group-b && set PRICE_ADJUSTMENT_PERCENTAGE=-15 && npm run update
# Inventory clearance (progressive discounts)
set TARGET_TAG=clearance-week1 && set PRICE_ADJUSTMENT_PERCENTAGE=-20 && npm run update
set TARGET_TAG=clearance-week2 && set PRICE_ADJUSTMENT_PERCENTAGE=-35 && npm run update
set TARGET_TAG=clearance-final && set PRICE_ADJUSTMENT_PERCENTAGE=-50 && npm run update
```
### Configuration Examples
#### .env for Holiday Sale
```env
SHOPIFY_SHOP_DOMAIN=mystore.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_abc123...
TARGET_TAG=holiday-sale
PRICE_ADJUSTMENT_PERCENTAGE=-20
OPERATION_MODE=update
SCHEDULED_EXECUTION_TIME=2024-12-24T00:00:00
```
#### .env for Sale Rollback
```env
SHOPIFY_SHOP_DOMAIN=mystore.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_abc123...
TARGET_TAG=holiday-sale
OPERATION_MODE=rollback
SCHEDULED_EXECUTION_TIME=2025-01-02T00:00:00
```
#### .env for Immediate Update
```env
SHOPIFY_SHOP_DOMAIN=mystore.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_abc123...
TARGET_TAG=summer-collection
PRICE_ADJUSTMENT_PERCENTAGE=8
OPERATION_MODE=update
# No SCHEDULED_EXECUTION_TIME = immediate execution
```
## 📊 Monitoring & Reporting
### Real-time Console Output
The application provides comprehensive real-time feedback:
```
🚀 Starting Shopify Price Updater
@@ -193,15 +317,63 @@ Example console output:
Store: your-store.myshopify.com
Tag: sale
Adjustment: +10%
Mode: UPDATE
🔍 Found 25 products with tag 'sale'
✅ Updated Product A: $19.99 → $21.99
✅ Updated Product B: $29.99 → $32.99
✅ Updated Product A: $19.99 → $21.99 (Compare-at: $19.99)
✅ Updated Product B: $29.99 → $32.99 (Compare-at: $29.99)
⚠️ Skipped Product C: Invalid price data
...
🔄 Processing batch 2 of 3...
📊 Summary: 23 products updated, 2 skipped, 0 errors
🎉 Operation completed successfully!
```
### Progress.md Logging
Persistent logging with detailed information:
```markdown
# Shopify Price Update Progress Log
## Operation: Price Update - 2024-08-19 15:30:45
- **Store**: your-store.myshopify.com
- **Tag**: sale
- **Mode**: UPDATE (+10%)
- **Products Found**: 25
- **Variants Processed**: 47
### Results Summary
- ✅ **Successful Updates**: 45 (95.7%)
- ❌ **Failed Updates**: 2 (4.3%)
- ⏱️ **Duration**: 12 seconds
### Error Analysis
- Validation errors: 1
- Network errors: 1
- Recommendations: Check product data for SKU-12345
```
### Success Rate Indicators
| Success Rate | Status | Action |
| ------------ | ------------ | -------------------- |
| **90-100%** | 🎉 Excellent | Operation successful |
| **70-89%** | ⚠️ Good | Review minor issues |
| **50-69%** | ⚠️ Moderate | Investigate errors |
| **<50%** | ❌ Poor | Check configuration |
### Monitoring Features
- **📈 Real-time progress**: Live updates during processing
- **📊 Success metrics**: Detailed success/failure rates
- **🔍 Error categorization**: Grouped by error type
- **⏱️ Performance tracking**: Operation duration and speed
- **📝 Historical logs**: Complete operation history
- **🎯 Recommendations**: Actionable suggestions for issues
## Error Handling
The script is designed to be resilient:
@@ -229,45 +401,77 @@ The script is designed to be resilient:
4. Verify the changes in your Shopify admin
5. Once satisfied, update your configuration for the actual run
## Troubleshooting
## 🔧 Troubleshooting & FAQ
### Common Issues
### Common Issues & Solutions
**"Authentication failed"**
| Issue | Symptoms | Solution |
| ------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Authentication Failed** | `401 Unauthorized` errors | • Verify `SHOPIFY_ACCESS_TOKEN`<br>• Check app permissions (`read_products`, `write_products`) |
| **No Products Found** | `0 products found` message | • Run `npm run debug-tags`<br>• Check tag spelling (case-sensitive)<br>• Verify products have the tag |
| **Rate Limit Exceeded** | `429 Rate limit` errors | • Script handles automatically<br>• Reduce batch size if persistent |
| **Invalid Percentage** | Configuration errors | • Use numbers only: `10`, `-15`, `5.5`<br>• Negative for decreases |
| **Scheduling Errors** | Invalid time format | • Use ISO 8601: `2024-12-25T10:30:00`<br>• Ensure future date |
- Verify your `SHOPIFY_ACCESS_TOKEN` is correct
- Ensure your app has `read_products` and `write_products` permissions
### Debugging Workflow
**"No products found"**
```bash
# Step 1: Check configuration
npm run debug-tags
- Run `npm run debug-tags` to see all available tags in your store
- Check that products actually have the specified tag
- Tag matching is case-sensitive
- Verify the tag format (some tags may have spaces, hyphens, or different capitalization)
# Step 2: Test with small subset
# Set TARGET_TAG to a tag with few products
# Set PRICE_ADJUSTMENT_PERCENTAGE to 1
**"Rate limit exceeded"**
# Step 3: Run test update
npm run update
- The script handles this automatically, but you can reduce load by processing smaller batches
# Step 4: Verify in Shopify admin
# Check that prices changed correctly
**"Invalid percentage"**
# Step 5: Test rollback
npm run rollback
- Ensure `PRICE_ADJUSTMENT_PERCENTAGE` is a valid number
- Use negative values for price decreases
# Step 6: Check Progress.md for detailed logs
```
### Debugging Steps
### Debug Tools & Commands
1. **Run the debug script first**: `npm run debug-tags` to see what tags exist in your store
2. **Check the Progress.md file** for detailed error information
3. **Verify your .env configuration** matches the required format
4. **Test with a small subset** of products first
5. **Ensure your Shopify app** has the necessary permissions
| Tool | Command | Purpose |
| ----------------- | --------------------- | --------------------------------------------------------------------------- |
| **Tag Analysis** | `npm run debug-tags` | • List all store tags<br>• Find similar tags<br>• Verify tag existence |
| **Progress Logs** | Check `Progress.md` | • Detailed operation history<br>• Error messages<br>• Success/failure rates |
| **Test Mode** | Small percentage test | • Verify configuration<br>• Test API connectivity<br>• Validate results |
### Debug Scripts
### Frequently Asked Questions
The project includes debugging tools:
**Q: Can I undo price changes?**
A: Yes! Use rollback mode (`npm run rollback`) to revert to compare-at prices.
- `npm run debug-tags` - Analyze all product tags in your store
- `debug-tags.js` - Standalone script to check tag availability and troubleshoot tag-related issues
**Q: How do I schedule multiple operations?**
A: Run separate commands with different `SCHEDULED_EXECUTION_TIME` values.
**Q: What happens if the script fails mid-operation?**
A: The script continues processing remaining products and logs all errors. Partial updates are preserved.
**Q: Can I target multiple tags?**
A: Currently supports one tag per operation. Run multiple operations for different tags.
**Q: How do I handle large inventories?**
A: The script automatically handles pagination and rate limiting for any inventory size.
**Q: What's the maximum percentage change?**
A: No hard limit, but be cautious with large changes. Test with small percentages first.
### Error Categories & Meanings
| Category | Description | Action Required |
| ------------------ | ------------------- | --------------------------- |
| **Authentication** | Invalid credentials | Update `.env` file |
| **Validation** | Invalid data format | Check product data |
| **Rate Limiting** | API limits exceeded | Automatic retry (no action) |
| **Network** | Connection issues | Check internet, retry |
| **Configuration** | Invalid settings | Review `.env` configuration |
## Security Notes
@@ -300,86 +504,161 @@ shopify-price-updater/
└── README.md # This file
```
## Technical Details
## 🔧 Technical Specifications
### API Implementation
### API Integration
- Uses Shopify's GraphQL Admin API (version 2024-01)
- Implements `productVariantsBulkUpdate` mutation for price updates
- Built-in HTTPS client using Node.js native modules (no external HTTP dependencies)
- Automatic tag formatting (handles both "tag" and "tag:tagname" formats)
| Component | Specification | Details |
| ------------------ | --------------------------------- | ------------------------ |
| **API Version** | Shopify GraphQL Admin API 2024-01 | Latest stable version |
| **Authentication** | Private App Access Tokens | Secure token-based auth |
| **HTTP Client** | Node.js native HTTPS | No external dependencies |
| **Mutations** | `productVariantsBulkUpdate` | Efficient batch updates |
| **Queries** | `products` with pagination | Cursor-based pagination |
### Rate Limiting
### Performance & Scalability
- Implements exponential backoff for rate limit handling
- Maximum 3 retry attempts with increasing delays (1s, 2s, 4s)
- Respects Shopify's API rate limits automatically
| Metric | Specification | Notes |
| ----------------- | ----------------------------------- | ------------------------- |
| **Batch Size** | 10 variants per batch | Optimized for rate limits |
| **Page Size** | 50 products per page | Shopify recommended |
| **Retry Logic** | 3 attempts with exponential backoff | 1s, 2s, 4s delays |
| **Rate Limiting** | Automatic handling | Respects Shopify limits |
| **Memory Usage** | Streaming processing | Handles large inventories |
### Error Recovery
### Error Handling & Recovery
- Continues processing even if individual products fail
- Comprehensive error categorization and reporting
- Non-retryable errors are identified and logged appropriately
| Error Type | Handling Strategy | Recovery Action |
| ------------------------ | ------------------------- | --------------------------- |
| **Rate Limits (429)** | Exponential backoff retry | Automatic retry with delays |
| **Network Errors** | Connection retry | Up to 3 attempts |
| **Validation Errors** | Skip and continue | Log error, process next |
| **Authentication (401)** | Immediate failure | Check credentials |
| **Server Errors (5xx)** | Retry with backoff | Automatic recovery |
## Available Scripts
### Data Processing
### Immediate Execution Scripts
| Feature | Implementation | Benefit |
| ---------------------- | ---------------------------- | -------------------------- |
| **Price Calculations** | Decimal precision handling | Accurate currency math |
| **Tag Formatting** | Automatic "tag:" prefix | Shopify compatibility |
| **Validation** | Pre-flight checks | Prevent invalid operations |
| **Rollback Logic** | Compare-at price restoration | Safe promotional reversals |
| **Progress Tracking** | Real-time status updates | Operation visibility |
- `npm start` - Run the price updater (defaults to update mode for backward compatibility)
- `npm run update` - Run the price update script (explicitly set to update mode)
- `npm run rollback` - Run the price rollback script (set prices to compare-at prices)
- `npm run debug-tags` - Analyze all product tags in your store
- `npm test` - Run the test suite (if implemented)
### Security Features
### Scheduled Execution Scripts
| Security Aspect | Implementation | Protection |
| ------------------------ | ------------------------ | ----------------------- |
| **Credential Storage** | Environment variables | No hardcoded secrets |
| **API Token Validation** | Format and length checks | Invalid token detection |
| **Input Sanitization** | Parameter validation | Injection prevention |
| **Error Logging** | Sanitized error messages | No credential exposure |
| **Rate Limit Respect** | Built-in throttling | API abuse prevention |
- `npm run schedule-update` - Run scheduled price update (requires SCHEDULED_EXECUTION_TIME environment variable)
- `npm run schedule-rollback` - Run scheduled price rollback (requires SCHEDULED_EXECUTION_TIME environment variable)
### System Requirements
#### Scheduling Examples
| Requirement | Minimum | Recommended |
| ---------------- | --------------- | ------------------------------ |
| **Node.js** | v16.0.0+ | v18.0.0+ |
| **Memory** | 512MB | 1GB+ |
| **Network** | Stable internet | High-speed connection |
| **Storage** | 100MB | 500MB+ (for logs) |
| **Shopify Plan** | Basic | Shopify Plus (for high volume) |
**Schedule a sale to start at 10:30 AM on December 25th:**
### Supported Operations
| Operation | Capability | Limitations |
| -------------------- | ------------------------------ | ----------------------------------- |
| **Price Updates** | Any percentage change | Must result in positive prices |
| **Rollback** | Restore from compare-at prices | Requires existing compare-at prices |
| **Scheduling** | ISO 8601 datetime | Future dates only |
| **Tag Filtering** | Single tag per operation | Case-sensitive matching |
| **Batch Processing** | Unlimited products | Rate limit dependent |
## 📋 Available Scripts & Commands
### Core Operations
| Command | Description | Use Case |
| -------------------- | ------------------------- | --------------------------------- |
| `npm start` | Run with default settings | General price updates |
| `npm run update` | Explicit update mode | Price adjustments with percentage |
| `npm run rollback` | Rollback mode | Revert to original prices |
| `npm run debug-tags` | Tag analysis tool | Troubleshooting and discovery |
| `npm test` | Run test suite | Development and validation |
### Advanced Usage Examples
```bash
# Set environment variable and run
set SCHEDULED_EXECUTION_TIME=2024-12-25T10:30:00 && npm run schedule-update
# Basic price update
npm start
# Explicit update mode with 10% increase
set OPERATION_MODE=update && set PRICE_ADJUSTMENT_PERCENTAGE=10 && npm start
# Rollback promotional pricing
set OPERATION_MODE=rollback && npm start
# Debug tag issues
npm run debug-tags
# Scheduled execution (Christmas sale start)
set SCHEDULED_EXECUTION_TIME=2024-12-25T10:30:00 && npm run update
# Scheduled rollback (New Year sale end)
set SCHEDULED_EXECUTION_TIME=2025-01-01T00:00:00 && npm run rollback
```
**Schedule a sale to end (rollback) at midnight on January 1st:**
## ⏰ Scheduled Execution
Schedule price changes for specific dates and times using the `SCHEDULED_EXECUTION_TIME` environment variable.
### Scheduling Formats
| Format | Example | Description |
| ----------------- | --------------------------- | -------------------------- |
| Local time | `2024-12-25T10:30:00` | Uses system timezone |
| UTC time | `2024-12-25T10:30:00Z` | Universal Coordinated Time |
| Timezone specific | `2024-12-25T10:30:00-05:00` | Eastern Standard Time |
### Common Scheduling Scenarios
```bash
# Set environment variable and run
set SCHEDULED_EXECUTION_TIME=2025-01-01T00:00:00 && npm run schedule-rollback
# Black Friday sale start (25% off)
set SCHEDULED_EXECUTION_TIME=2024-11-29T00:00:00 && set PRICE_ADJUSTMENT_PERCENTAGE=-25 && npm run update
# Christmas sale start (15% off)
set SCHEDULED_EXECUTION_TIME=2024-12-25T10:30:00 && set PRICE_ADJUSTMENT_PERCENTAGE=-15 && npm run update
# New Year sale end (rollback to original prices)
set SCHEDULED_EXECUTION_TIME=2025-01-01T00:00:00 && npm run rollback
# Flash sale (2-hour window)
set SCHEDULED_EXECUTION_TIME=2024-12-15T14:00:00 && set PRICE_ADJUSTMENT_PERCENTAGE=-30 && npm run update
# Then schedule rollback 2 hours later
set SCHEDULED_EXECUTION_TIME=2024-12-15T16:00:00 && npm run rollback
```
**Schedule with specific timezone (EST):**
```bash
# Set environment variable with timezone and run
set SCHEDULED_EXECUTION_TIME=2024-12-25T10:30:00-05:00 && npm run schedule-update
```
**Using .env file for scheduling:**
### Using .env File for Scheduling
```env
# Add to your .env file
# Complete scheduled configuration
SCHEDULED_EXECUTION_TIME=2024-12-25T10:30:00
OPERATION_MODE=update
TARGET_TAG=sale
PRICE_ADJUSTMENT_PERCENTAGE=10
TARGET_TAG=holiday-sale
PRICE_ADJUSTMENT_PERCENTAGE=-20
SHOPIFY_SHOP_DOMAIN=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=your_token_here
```
Then run: `npm run schedule-update`
### Scheduling Features
**Common scheduling scenarios:**
- **Black Friday sale start**: Schedule price decreases for Friday morning
- **Sale end**: Schedule rollback to original prices after promotion period
- **Seasonal pricing**: Schedule price adjustments for seasonal campaigns
- **Flash sales**: Schedule short-term promotional pricing
- **Holiday promotions**: Schedule price changes for specific holidays
**Note**: When using scheduled execution, the script will display a countdown and wait until the specified time before executing the price updates. You can cancel the scheduled operation by pressing Ctrl+C during the waiting period.
- **📅 Countdown display**: Shows time remaining until execution
- **❌ Cancellation support**: Press Ctrl+C to cancel during countdown
- **🔒 Safe execution**: Cannot cancel during active price updates
- **📝 Logging**: All scheduled operations are logged with timestamps
- **⚠️ Validation**: Validates scheduled time format and future date
## License