thanh-kit 2.5.0 → 2.5.1

package/templates/skills/mobile-development/SKILL.md

@@ -1,8 +1,9 @@
 ---
-name: mobile-development
-description: Build modern mobile applications with React Native, Flutter, Swift/SwiftUI, and Kotlin/Jetpack Compose. Covers mobile-first design principles, performance optimization (battery, memory, network), offline-first architecture, platform-specific guidelines (iOS HIG, Material Design), testing strategies, security best practices, accessibility, app store deployment, and mobile development mindset. Use when building mobile apps, implementing mobile UX patterns, optimizing for mobile constraints, or making native vs cross-platform decisions.
+name: ck:mobile-development
+description: Build mobile apps with React Native, Flutter, Swift/SwiftUI, Kotlin/Jetpack Compose. Use for iOS/Android, mobile UX, performance optimization, offline-first, app store deployment.
 license: MIT
 version: 1.0.0
+argument-hint: "[platform] [feature]"
 ---
 
 # Mobile Development Skill

package/templates/skills/payment-integration/README.md

@@ -1,6 +1,6 @@
 # Payment Integration Skill
 
-Comprehensive payment integration skill for SePay (Vietnamese payment gateway) and Polar (global SaaS monetization platform).
+Comprehensive payment integration skill for SePay (Vietnamese payment gateway), Polar (global SaaS monetization platform), and Stripe (global payment infrastructure).
 
 ## Features
 
@@ -22,6 +22,15 @@ Comprehensive payment integration skill for SePay (Vietnamese payment gateway) a
 - Multi-language SDKs (TypeScript, Python, PHP, Go)
 - Framework adapters (Next.js, Laravel, Remix, etc.)
 
+### Stripe Integration
+- Global payment infrastructure
+- CheckoutSessions, PaymentIntents, SetupIntents APIs
+- Billing and subscriptions at scale
+- Connect for marketplaces and platforms
+- Payment Element for custom checkout experiences
+- Multi-language SDKs (Node.js, Python, Ruby, PHP, Java, Go, .NET)
+- Best practices for integration design and API version upgrades
+
 ## Structure
 
 ```
@@ -36,15 +45,18 @@ payment-integration/
 │   │   ├── sdk.md               # SDK usage (Node.js, PHP, Laravel)
 │   │   ├── qr-codes.md          # VietQR generation
 │   │   └── best-practices.md    # Security, patterns, monitoring
-│   └── polar/                   # Polar integration guides
-│       ├── overview.md          # Auth, MoR concept, environments
-│       ├── products.md          # Products, pricing, usage-based billing
-│       ├── checkouts.md         # Checkout flows and embedded checkout
-│       ├── subscriptions.md     # Lifecycle, upgrades, trials
-│       ├── webhooks.md          # Event handling and verification
-│       ├── benefits.md          # Automated benefit delivery
-│       ├── sdk.md               # Multi-language SDK usage
-│       └── best-practices.md    # Security, patterns, monitoring
+│   ├── polar/                   # Polar integration guides
+│   │   ├── overview.md          # Auth, MoR concept, environments
+│   │   ├── products.md          # Products, pricing, usage-based billing
+│   │   ├── checkouts.md         # Checkout flows and embedded checkout
+│   │   ├── subscriptions.md     # Lifecycle, upgrades, trials
+│   │   ├── webhooks.md          # Event handling and verification
+│   │   ├── benefits.md          # Automated benefit delivery
+│   │   ├── sdk.md               # Multi-language SDK usage
+│   │   └── best-practices.md    # Security, patterns, monitoring
+│   └── stripe/                  # Stripe integration guides
+│       ├── stripe-best-practices.md  # Integration design, API selection
+│       └── stripe-upgrade.md         # API versions, SDK upgrades
 └── scripts/                      # Integration helper scripts
     ├── sepay-webhook-verify.js   # SePay webhook verification
     ├── polar-webhook-verify.js   # Polar webhook verification
@@ -71,7 +83,7 @@ In conversations, simply reference the platforms:
 
 **SePay Webhook Verification:**
 ```bash
-cd .claude/skills/payment-integration/scripts
+cd $HOME/.claude/skills/payment-integration/scripts
 node sepay-webhook-verify.js '{"id":12345,"gateway":"Vietcombank",...}'
 ```
 
@@ -137,6 +149,14 @@ Load only the references you need for your current task.
 - Tax compliance (Merchant of Record)
 - Customer self-service
 
+**Choose Stripe for:**
+- Global payment infrastructure
+- Enterprise-grade payment processing
+- Connect platforms (marketplaces)
+- Billing/subscriptions at scale
+- Custom checkout experiences (Payment Element)
+- Maximum payment method coverage
+
 ## Examples
 
 ### SePay Payment Flow
@@ -154,6 +174,12 @@ Load only the references you need for your current task.
 5. Load `references/polar/webhooks.md` for events
 6. Load `references/polar/benefits.md` for automation
 
+### Stripe Integration Flow
+1. Load `references/stripe/stripe-best-practices.md` for integration design
+2. Choose: Checkout (hosted/embedded) or Payment Element
+3. Use CheckoutSessions API for most use cases
+4. Load `references/stripe/stripe-upgrade.md` when upgrading API versions
+
 ## Testing
 
 All scripts include comprehensive test coverage:
@@ -176,10 +202,16 @@ Run `npm test` in the scripts directory to verify functionality.
 - API Reference: https://polar.sh/docs/api-reference
 - GitHub: https://github.com/polarsource/polar
 
+### Stripe
+- Docs: https://docs.stripe.com
+- API Reference: https://docs.stripe.com/api
+- Changelog: https://docs.stripe.com/changelog
+- Go Live Checklist: https://docs.stripe.com/get-started/checklist/go-live
+
 ## License
 
 MIT
 
 ## Version
 
-1.0.0
+1.1.0

package/templates/skills/payment-integration/SKILL.md

@@ -1,118 +1,103 @@
 ---
-name: payment-integration
-description: Implement payment integrations with SePay (Vietnamese payment gateway with VietQR, bank transfers, cards) and Polar (global SaaS monetization platform with subscriptions, usage-based billing, automated benefits). Use when integrating payment processing, implementing checkout flows, managing subscriptions, handling webhooks, processing bank transfers, generating QR codes, automating benefit delivery, or building billing systems. Supports authentication (API keys, OAuth2), product management, customer portals, tax compliance (Polar as MoR), and comprehensive SDK integrations (Node.js, PHP, Python, Go, Laravel, Next.js).
-version: 1.0.0
+name: ck:payment-integration
+description: Integrate payments with SePay (VietQR), Polar, Stripe, Paddle (MoR subscriptions), Creem.io (licensing). Checkout, webhooks, subscriptions, QR codes, multi-provider orders.
+version: 2.2.0
 license: MIT
+argument-hint: "[provider] [task]"
 ---
 
 # Payment Integration
 
-Implement payment processing with SePay (Vietnamese payments) and Polar (global SaaS monetization).
+Production-proven payment processing with SePay (Vietnamese banks), Polar (global SaaS), Stripe (global infrastructure), Paddle (MoR subscriptions), and Creem.io (MoR + licensing).
 
 ## When to Use
 
-Use when implementing:
 - Payment gateway integration (checkout, processing)
 - Subscription management (trials, upgrades, billing)
-- Webhook handling (payment notifications)
+- Webhook handling (notifications, idempotency)
 - QR code payments (VietQR, NAPAS)
-- Usage-based billing (metering, credits)
-- Automated benefit delivery (licenses, GitHub access, Discord roles)
-- Customer portals (self-service management)
-- Bank transfer automation (Vietnamese banks)
-- Product catalogs with pricing
+- Software licensing (device activation)
+- Multi-provider order management
+- Revenue splits and commissions
 
 ## Platform Selection
 
-**Choose SePay for:**
-- Vietnamese market (VND currency)
-- Bank transfer automation
-- VietQR/NAPAS payments
-- Local payment methods
-- Direct bank account monitoring
-
-**Choose Polar for:**
-- Global SaaS products
-- Subscription management
-- Usage-based billing
-- Automated benefits (GitHub, Discord, licenses)
-- Merchant of Record (tax compliance)
-- Digital product sales
+| Platform | Best For |
+|----------|----------|
+| **SePay** | Vietnamese market, VND, bank transfers, VietQR |
+| **Polar** | Global SaaS, subscriptions, automated benefits (GitHub/Discord) |
+| **Stripe** | Enterprise payments, Connect platforms, custom checkout |
+| **Paddle** | MoR subscriptions, global tax compliance, churn prevention |
+| **Creem.io** | MoR + licensing, revenue splits, no-code checkout |
 
 ## Quick Reference
 
-### SePay Integration
-- **Overview & Auth**: `references/sepay/overview.md` - Platform capabilities, API/OAuth2 auth, supported banks
-- **API Reference**: `references/sepay/api.md` - Endpoints, transactions, bank accounts, virtual accounts
-- **Webhooks**: `references/sepay/webhooks.md` - Setup, payload structure, verification, retry logic
-- **SDK Usage**: `references/sepay/sdk.md` - Node.js, PHP, Laravel implementations
-- **QR Codes**: `references/sepay/qr-codes.md` - VietQR generation, templates, integration
-- **Best Practices**: `references/sepay/best-practices.md` - Security, patterns, monitoring
-
-### Polar Integration
-- **Overview & Auth**: `references/polar/overview.md` - Platform capabilities, authentication methods, MoR concept
-- **Products & Pricing**: `references/polar/products.md` - Product types, pricing models, usage-based billing
-- **Checkouts**: `references/polar/checkouts.md` - Checkout flows, embedded checkout, links
-- **Subscriptions**: `references/polar/subscriptions.md` - Lifecycle, upgrades, downgrades, trials
-- **Webhooks**: `references/polar/webhooks.md` - Event types, signature verification, monitoring
-- **Benefits**: `references/polar/benefits.md` - Automated delivery (GitHub, Discord, licenses, files)
-- **SDK Usage**: `references/polar/sdk.md` - TypeScript, Python, PHP, Go, framework adapters
-- **Best Practices**: `references/polar/best-practices.md` - Security, patterns, monitoring
-
-### Integration Scripts
-- **SePay Webhook Verification**: `scripts/sepay-webhook-verify.js` - Verify SePay webhook authenticity
-- **Polar Webhook Verification**: `scripts/polar-webhook-verify.js` - Verify Polar webhook signatures
-- **Checkout Helper**: `scripts/checkout-helper.js` - Generate checkout sessions for both platforms
-
-## Implementation Workflow
-
-### SePay Implementation
-1. Load `references/sepay/overview.md` for auth setup
-2. Load `references/sepay/api.md` or `references/sepay/sdk.md` for integration
-3. Load `references/sepay/webhooks.md` for payment notifications
-4. Use `scripts/sepay-webhook-verify.js` for webhook verification
-5. Load `references/sepay/best-practices.md` for production readiness
-
-### Polar Implementation
-1. Load `references/polar/overview.md` for auth and concepts
-2. Load `references/polar/products.md` for product setup
-3. Load `references/polar/checkouts.md` for payment flows
-4. Load `references/polar/webhooks.md` for event handling
-5. Use `scripts/polar-webhook-verify.js` for webhook verification
-6. Load `references/polar/benefits.md` if automating delivery
-7. Load `references/polar/best-practices.md` for production readiness
+### SePay
+- `references/sepay/overview.md` - Auth, supported banks
+- `references/sepay/api.md` - Endpoints, transactions
+- `references/sepay/webhooks.md` - Setup, verification
+- `references/sepay/sdk.md` - Node.js, PHP, Laravel
+- `references/sepay/qr-codes.md` - VietQR generation
+- `references/sepay/best-practices.md` - Production patterns
+
+### Polar
+- `references/polar/overview.md` - Auth, MoR concept
+- `references/polar/products.md` - Pricing models
+- `references/polar/checkouts.md` - Checkout flows
+- `references/polar/subscriptions.md` - Lifecycle management
+- `references/polar/webhooks.md` - Event handling
+- `references/polar/benefits.md` - Automated delivery
+- `references/polar/sdk.md` - Multi-language SDKs
+- `references/polar/best-practices.md` - Production patterns
+
+### Stripe
+- `references/stripe/stripe-best-practices.md` - Integration design
+- `references/stripe/stripe-sdks.md` - Server SDKs
+- `references/stripe/stripe-js.md` - Payment Element
+- `references/stripe/stripe-cli.md` - Local testing
+- `references/stripe/stripe-upgrade.md` - Version upgrades
+- External: https://docs.stripe.com/llms.txt
+
+### Paddle
+- `references/paddle/overview.md` - MoR, auth, entity IDs
+- `references/paddle/api.md` - Products, prices, transactions
+- `references/paddle/paddle-js.md` - Checkout overlay/inline
+- `references/paddle/subscriptions.md` - Trials, upgrades, pause
+- `references/paddle/webhooks.md` - SHA256 verification
+- `references/paddle/sdk.md` - Node, Python, PHP, Go
+- `references/paddle/best-practices.md` - Production patterns
+- External: https://developer.paddle.com/llms.txt
+
+### Creem.io
+- `references/creem/overview.md` - MoR, auth, global support
+- `references/creem/api.md` - Products, checkout sessions
+- `references/creem/checkouts.md` - No-code links, storefronts
+- `references/creem/subscriptions.md` - Trials, seat-based
+- `references/creem/licensing.md` - Device activation
+- `references/creem/webhooks.md` - Signature verification
+- `references/creem/sdk.md` - Next.js, Better Auth
+- External: https://docs.creem.io/llms.txt
+
+### Multi-Provider
+- `references/multi-provider-order-management-patterns.md` - Unified orders, currency conversion
+
+### Scripts
+- `scripts/sepay-webhook-verify.js` - SePay webhook verification
+- `scripts/polar-webhook-verify.js` - Polar webhook verification
+- `scripts/checkout-helper.js` - Checkout session generator
 
 ## Key Capabilities
 
-**SePay:**
-- Payment gateway (QR, bank transfer, cards)
-- Bank account monitoring with webhooks
-- Order-based virtual accounts
-- VietQR generation API
-- 44+ Vietnamese banks supported
-- Rate limit: 2 calls/second
-
-**Polar:**
-- Merchant of Record (global tax compliance)
-- Subscription lifecycle management
-- Usage-based billing (events, meters)
-- Automated benefits (GitHub, Discord, licenses)
-- Customer portal (self-service)
-- Multi-language SDKs
-- Rate limit: 300 req/min
-
-## Instructions
-
-When implementing payment integration:
-
-1. **Identify platform** based on requirements (Vietnamese vs global, payment types)
-2. **Load relevant references** progressively as needed
-3. **Implement authentication** using platform-specific methods
-4. **Set up products/pricing** according to business model
-5. **Implement checkout flow** (hosted, embedded, or API-driven)
-6. **Configure webhooks** with proper verification
-7. **Handle payment events** (success, failure, refund)
-8. **Test thoroughly** in sandbox before production
-9. **Monitor and optimize** using platform analytics
-
-Load only the references needed for current implementation step to maintain context efficiency.
+| Platform | Highlights |
+|----------|------------|
+| **SePay** | QR/bank/cards, 44+ VN banks, webhooks, 2 req/s |
+| **Polar** | MoR, subscriptions, usage billing, benefits, 300 req/min |
+| **Stripe** | CheckoutSessions, Billing, Connect, Payment Element |
+| **Paddle** | MoR, overlay/inline checkout, Retain (churn prevention), tax |
+| **Creem.io** | MoR, licensing, revenue splits, no-code checkout |
+
+## Implementation
+
+See `references/implementation-workflows.md` for step-by-step guides per platform.
+
+**General flow:** auth → products → checkout → webhooks → events

package/templates/skills/payment-integration/references/creem/api.md

@@ -0,0 +1,139 @@
+# Creem.io API Reference
+
+## Checkout Sessions
+
+### Create Checkout Session
+
+```javascript
+// POST /v1/checkout/sessions
+const session = await creem.checkout.sessions.create({
+  product_id: 'prod_xxx',
+  success_url: 'https://example.com/success',
+  cancel_url: 'https://example.com/cancel',
+  customer_email: 'user@example.com', // Optional
+  metadata: { order_id: '123' }       // Optional
+});
+// Returns: { url: 'https://checkout.creem.io/xxx', id: 'cs_xxx' }
+```
+
+## Products
+
+### Create Product
+
+```javascript
+// POST /v1/products
+const product = await creem.products.create({
+  name: 'Pro Plan',
+  description: 'Full access to all features',
+  price: 2900,           // Amount in cents
+  currency: 'usd',
+  recurring: {           // Optional - for subscriptions
+    interval: 'month',
+    interval_count: 1
+  }
+});
+```
+
+### Retrieve Product
+
+```javascript
+// GET /v1/products/:id
+const product = await creem.products.retrieve('prod_xxx');
+```
+
+## Transactions
+
+### Retrieve Transaction
+
+```javascript
+// GET /v1/transactions/:id
+const transaction = await creem.transactions.retrieve('txn_xxx');
+```
+
+### List Transactions
+
+```javascript
+// GET /v1/transactions
+const transactions = await creem.transactions.list({
+  customer_id: 'cus_xxx',      // Optional filter
+  product_id: 'prod_xxx',      // Optional filter
+  status: 'completed',         // Optional filter
+  limit: 25,
+  starting_after: 'txn_xxx'    // Pagination cursor
+});
+```
+
+## Customers
+
+### Retrieve Customer
+
+```javascript
+// GET /v1/customers/:id
+const customer = await creem.customers.retrieve('cus_xxx');
+
+// GET /v1/customers/email/:email
+const customer = await creem.customers.retrieveByEmail('user@example.com');
+```
+
+### List Customers
+
+```javascript
+// GET /v1/customers
+const customers = await creem.customers.list({
+  limit: 25,
+  starting_after: 'cus_xxx'
+});
+```
+
+### Generate Portal Link
+
+```javascript
+// POST /v1/customers/:id/portal
+const portal = await creem.customers.createPortalSession('cus_xxx');
+// Returns: { url: 'https://portal.creem.io/xxx' }
+```
+
+## Discount Codes
+
+### Create Discount
+
+```javascript
+// POST /v1/discounts
+const discount = await creem.discounts.create({
+  code: 'LAUNCH20',
+  type: 'percentage',    // or 'fixed'
+  value: 20,             // 20% or 20 cents
+  expires_at: '2024-12-31T23:59:59Z',
+  max_redemptions: 100   // Optional
+});
+```
+
+### Retrieve Discount
+
+```javascript
+// GET /v1/discounts/:code
+const discount = await creem.discounts.retrieve('LAUNCH20');
+```
+
+### Delete Discount
+
+```javascript
+// DELETE /v1/discounts/:code
+await creem.discounts.delete('LAUNCH20');
+```
+
+## Error Handling
+
+```javascript
+try {
+  const session = await creem.checkout.sessions.create({...});
+} catch (error) {
+  if (error.type === 'invalid_request_error') {
+    console.error('Invalid parameters:', error.message);
+  } else if (error.type === 'authentication_error') {
+    console.error('Invalid API key');
+  } else if (error.type === 'rate_limit_error') {
+    console.error('Rate limited, retry after:', error.retry_after);
+  }
+}
+```

package/templates/skills/payment-integration/references/creem/checkouts.md

@@ -0,0 +1,99 @@
+# Creem.io Checkouts
+
+## Checkout Options
+
+1. **Programmatic Sessions** - Full API control
+2. **Checkout Links** - No-code, shareable URLs
+3. **Storefronts** - Hosted product pages
+
+## Create Checkout Session
+
+```javascript
+const session = await creem.checkout.sessions.create({
+  product_id: 'prod_xxx',
+  success_url: 'https://example.com/success?session_id={CHECKOUT_SESSION_ID}',
+  cancel_url: 'https://example.com/cancel',
+
+  // Optional parameters
+  customer_email: 'user@example.com',
+  customer_id: 'cus_xxx',           // Existing customer
+  quantity: 1,                       // For seat-based products
+  discount_code: 'LAUNCH20',         // Pre-apply discount
+  metadata: {
+    order_id: '123',
+    referral_code: 'abc'
+  },
+
+  // Custom fields
+  custom_fields: [
+    { key: 'company', label: 'Company Name', required: true }
+  ]
+});
+
+// Redirect user to checkout
+redirect(session.url);
+```
+
+## Checkout Customization
+
+Configure in dashboard or via API:
+
+- **Branding**: Logo, colors, themes
+- **Email Receipts**: Custom templates
+- **Localization**: Auto-detect or force language (42 supported)
+- **Custom Fields**: Collect additional data
+
+## Retrieve Session
+
+```javascript
+// GET /v1/checkout/sessions/:id
+const session = await creem.checkout.sessions.retrieve('cs_xxx');
+// Returns: { id, status, customer_id, product_id, amount, metadata, ... }
+```
+
+## Success URL Parameters
+
+Creem replaces `{CHECKOUT_SESSION_ID}` in success URL:
+
+```javascript
+// Frontend: parse session ID from URL
+const urlParams = new URLSearchParams(window.location.search);
+const sessionId = urlParams.get('session_id');
+
+// Backend: verify and fulfill
+const session = await creem.checkout.sessions.retrieve(sessionId);
+if (session.status === 'complete') {
+  await fulfillOrder(session);
+}
+```
+
+## No-Code Checkout Links
+
+Create in dashboard - shareable URLs for any product. Good for:
+- Social media links
+- Email campaigns
+- Quick sales without integration
+
+## Storefronts
+
+Hosted product pages - display multiple products without custom website:
+
+1. Configure storefront in dashboard
+2. Add products to display
+3. Share storefront URL
+4. Customers browse and checkout
+
+## Cart Abandonment Recovery
+
+Enable in dashboard - automatic emails sent when checkout abandoned:
+- Configurable delay before sending
+- Customizable email content
+- Include discount code incentive
+
+## Embedding (Coming)
+
+For embedded checkout in your site, see SDK adapters:
+- Next.js Adapter
+- React components
+
+See `references/creem/sdk.md` for implementation details.