summit-registration-lite 6.0.9 → 7.0.0

package/.claude/rules/summit-registration-lite-component-props.md

@@ -0,0 +1,95 @@
+# Component Prop Conventions
+
+## When to Apply
+
+Defining props for new components or understanding prop flow from widget to child components.
+
+## Pattern
+
+**Widget Root (RegistrationLiteWidget):**
+
+Parent app passes all props to widget, which wraps `<RegistrationLite>` in Redux Provider.
+
+**Main Component (RegistrationLite):**
+
+```javascript
+const RegistrationLite = ({
+    // Lifecycle callbacks (parent app control)
+    authUser,              // (provider) => void - handle SSO login
+    goToExtraQuestions,    // (attendeeId) => void - redirect to extra questions
+    goToEvent,             // () => void - redirect to event page
+    goToMyOrders,          // () => void - redirect to my orders
+    onPurchaseComplete,    // (order) => void - handle successful purchase
+    closeWidget,           // () => void - close/minimize widget
+
+    // Auth callbacks
+    getPasswordlessCode,   // (email) => void - request OTP code
+    loginWithCode,         // (email, code) => void - verify OTP
+    authErrorCallback,     // (error) => void - handle auth errors
+
+    // Error handling
+    onError,               // ({type, msg, exception}) => void
+    handleCompanyError,    // (error) => void - company dropdown errors
+
+    // Data
+    summitData,            // { id, name, time_zone, registration_disclaimer, ... }
+    profileData,           // { email, first_name, last_name, company, ... }
+
+    // Config
+    apiBaseUrl,            // Base URL for API calls
+    supportEmail,          // Support email for help text
+    allowPromoCodes,       // boolean - show/hide promo code field (default: true)
+    showCompanyInput,      // boolean - show/hide company field (default: true)
+    allowsNativeAuth,      // boolean - show email/password login
+    allowsOtpAuth,         // boolean - show passwordless OTP login
+    loginOptions,          // [{ button_color, provider_label, provider_param }]
+
+    // UI customization
+    loading,               // boolean - external loading state
+    showMultipleTicketTexts,  // boolean - show multi-ticket messaging
+    hidePostalCode,        // boolean - hide postal code in payment (default: false)
+    idpLogoDark,           // string - custom logo src (dark theme)
+    idpLogoLight,          // string - custom logo src (light theme)
+
+    // Messages (optional overrides)
+    noAllowedTicketsMessage,
+    ticketTaxesErrorMessage,
+
+    // Provider options
+    providerOptions,       // { stripe: {...}, lawpay: {...} }
+    successfulPaymentReturnUrl,  // Stripe return URL after payment
+
+    // Redux state (from connect)
+    step, reservation, ticketTypes, taxTypes, ...
+
+    // Redux actions (from connect)
+    loadSession, changeStep, reserveTicket, payTicketWithProvider, ...
+}) => { /* ... */ }
+```
+
+## Key Points
+
+- **Callback pattern:** Parent app controls navigation (`goToExtraQuestions`, `goToEvent`, etc.) - widget doesn't redirect directly
+- **Error handling delegation:** Widget calls `onError` / `authErrorCallback` / `handleCompanyError`, parent decides what to do
+- **Data vs. Config:** `summitData` is event info, `profileData` is user info, others are config/behavior flags
+- **Optional overrides:** Most text/messages have defaults but can be overridden via props
+- **Redux separation:** Connected props (`step`, `reservation`) vs. passed props (callbacks, config)
+
+## Prop Flow Example
+
+```
+Parent App
+  └─> RegistrationLiteWidget (wraps Provider)
+       └─> RegistrationLite (receives props + Redux state)
+            ├─> LoginComponent (loginOptions, allowsNativeAuth, allowsOtpAuth)
+            ├─> TicketTypeComponent (ticketTypes, summitData)
+            ├─> PersonalInfoComponent (profileData, showCompanyInput)
+            └─> PaymentComponent (reservation, providerOptions)
+```
+
+## Common Mistakes
+
+- Hardcoding navigation instead of calling prop callbacks (breaks widget embedding)
+- Not providing `apiBaseUrl` (causes API calls to fail)
+- Forgetting `onError` handler (errors go to console only, user sees nothing)
+- Passing incomplete `summitData` (missing `time_zone` breaks clock, missing `id` breaks API calls)

package/.claude/rules/summit-registration-lite-payment-providers.md

@@ -0,0 +1,69 @@
+# Payment Provider Integration
+
+## When to Apply
+
+Adding or modifying payment providers (Stripe, LawPay, or new providers).
+
+## Pattern
+
+**Factory Pattern:** `PaymentProviderFactory.build(provider, params)` returns provider instance.
+
+**Provider Structure:**
+
+```javascript
+export class NewProvider {
+    constructor({ reservation, summitId, userProfile, access_token, apiBaseUrl, dispatch }) {
+        // Store params as instance properties
+        this.reservation = reservation;
+        this.summitId = summitId;
+        // ... etc
+    }
+
+    payTicket = ({ /* provider-specific params */, onError = () => {} }) => async (dispatch) => {
+        // 1. Custom error handler for HTTP status codes
+        const errorHandler = (err, res) => (dispatch, state) => {
+            switch (err.status) {
+                case 404: onError({type: ERROR_TYPE_VALIDATION, msg: res.body.message, exception: null}); break;
+                case 500: onError({type: ERROR_TYPE_ERROR, msg: res.body.message, exception: null}); break;
+                default: authErrorHandler(err, res)(dispatch, state); break;
+            }
+        };
+
+        // 2. Free/prepaid orders skip payment gateway
+        if (isFreeOrder(this.reservation) || isPrePaidOrder(this.reservation)) {
+            return putRequest(/* ... checkout endpoint ... */)(params)(this.dispatch);
+        }
+
+        // 3. Payment gateway flow (provider-specific)
+        // Call gateway API, handle result, then checkout
+    }
+}
+```
+
+**Factory Registration:**
+
+```javascript
+// src/utils/payment-providers/payment-provider-factory.js
+import { NEW_PROVIDER } from '../constants';
+import { NewProvider } from './new-provider';
+
+case NEW_PROVIDER: {
+    currentProvider = new NewProvider({...params});
+    break;
+}
+```
+
+## Key Points
+
+- Free/prepaid orders always skip gateway, go straight to `/checkout` endpoint
+- Error types: `ERROR_TYPE_VALIDATION` (404), `ERROR_TYPE_ERROR` (500), `ERROR_TYPE_PAYMENT` (gateway errors)
+- Always dispatch `startWidgetLoading()` before async ops, `stopWidgetLoading()` after
+- Success flow: checkout API → `CLEAR_RESERVATION` → `changeStep(STEP_COMPLETE)`
+- Failure flow: `removeReservedTicket()` → `changeStep(STEP_PERSONAL_INFO)`
+- Checkout endpoint requires billing address fields from `userProfile`
+
+## Common Mistakes
+
+- Forgetting to handle free/prepaid orders (they don't have `payment_gateway_client_token`)
+- Not calling `removeReservedTicket()` on payment failure (leaves stale reservation)
+- Missing `stopWidgetLoading()` in catch blocks (spinner never stops)

package/.claude/rules/summit-registration-lite-project.md

@@ -0,0 +1,80 @@
+# Project: Summit Registration Lite
+
+**Last Updated:** 2026-03-05
+
+## Overview
+
+React widget for summit registration supporting authentication, ticket selection, payment processing, and order completion. Published as NPM package, designed to be embedded in parent applications.
+
+## Technology Stack
+
+- **Language:** JavaScript (ES6+)
+- **Framework:** React 16+ with Redux for state management
+- **Build Tool:** Webpack 5 (dev/prod configs)
+- **Testing:** Jest with @testing-library/react
+- **Package Manager:** Yarn
+- **Key Libraries:**
+  - openstack-uicore-foundation (HTTP utils, actions)
+  - redux-persist (state persistence)
+  - Stripe.js and custom payment providers
+  - Material-UI (@mui/material)
+
+## Directory Structure
+
+```
+summit-registration-lite/
+├── src/
+│   ├── components/          # React components (login, payment, tickets, etc.)
+│   ├── utils/
+│   │   ├── payment-providers/  # Stripe, LawPay provider implementations
+│   │   ├── hooks/              # Custom React hooks
+│   │   └── constants.js        # Step constants, error types
+│   ├── helpers/             # Formatting utilities
+│   ├── actions.js           # Redux action creators (API calls)
+│   ├── reducer.js           # Redux reducer
+│   ├── store.js             # Redux store configuration
+│   └── summit-registration-lite.js  # Main widget export
+├── webpack.common.js
+├── webpack.dev.js
+├── webpack.prod.js
+└── babel.config.js
+```
+
+## Key Files
+
+- **Entry:** `src/summit-registration-lite.js` - Provider wrapper, exports widget and standalone login components
+- **Main Component:** `src/components/registration-lite.js` - Multi-step registration flow
+- **Actions:** `src/actions.js` - API integration (ticket types, reservations, payments)
+- **Payment:** `src/utils/payment-providers/` - Factory pattern for payment provider abstraction
+- **Config:** `webpack.common.js` - Shared webpack configuration
+
+## Development Commands
+
+| Task | Command |
+|------|---------|
+| Install | `yarn` |
+| Dev Server | `yarn serve` |
+| Build Dev | `yarn build-dev` |
+| Build Prod | `yarn build` |
+| Test (watch) | `yarn test` |
+| Clean | `yarn clean` |
+| Publish | `yarn publish-package` |
+
+## Architecture Notes
+
+- **State:** Redux with redux-persist for cross-session state
+- **API Base:** Configurable via props (`apiBaseUrl`), uses openstack-uicore-foundation HTTP utils
+- **Payment Providers:** Factory pattern (`PaymentProviderFactory`) supports Stripe and LawPay
+- **Steps:** Multi-step flow defined in `utils/constants.js` (login, personal info, payment, complete)
+- **Auth:** Supports native auth, OTP (passwordless), and configurable SSO providers via `loginOptions` prop
+- **Integration:** Widget receives callbacks (`authUser`, `goToExtraQuestions`, `onPurchaseComplete`, etc.) for parent app control
+
+## Testing
+
+- Jest configuration in `package.json`
+- Component tests in `__tests__` directories alongside components
+- Mock files for static assets (`src/__mocks__/fileMock.js`)
+
+## Debug Mode
+
+URL hash override for testing time-based logic: `#now=2020-06-03,10:59:50` (summit timezone)

package/.claude/rules/summit-registration-lite-redux-actions.md

@@ -0,0 +1,65 @@
+# Redux API Action Patterns
+
+## When to Apply
+
+Creating new API actions or modifying existing ones in `src/actions.js`.
+
+## Pattern
+
+**Action Structure (openstack-uicore-foundation):**
+
+```javascript
+export const GET_DATA = 'GET_DATA';
+
+export const getData = (summitId) => async (dispatch, getState) => {
+    const { apiBaseUrl } = getState().registration;
+
+    const params = {
+        access_token: await accessTokenSelector()(dispatch, getState),
+        expand: 'relations,nested.relations'
+    };
+
+    return getRequest(
+        null,
+        createAction(GET_DATA),
+        `${apiBaseUrl}/api/v1/summits/${summitId}/resource`,
+        customErrorHandler  // optional
+    )(params)(dispatch);
+};
+```
+
+**Error Handling:**
+
+```javascript
+const customErrorHandler = (err, res) => (dispatch, state) => {
+    if (err.timeout) return err;
+    if (res?.statusCode === 404) return err;  // Handle specific codes
+    if (res?.statusCode === 500) return err;
+    return authErrorHandler(err, res)(dispatch, state);  // Default auth handling
+};
+```
+
+**Reducer Convention:**
+
+```javascript
+case GET_DATA: {
+    return {...state, data: payload.response};
+}
+```
+
+## Key Points
+
+- Actions exported as constants (`export const ACTION_NAME`) AND action creators (`export const actionName`)
+- Use `createAction()` from openstack-uicore-foundation for action creators
+- HTTP methods: `getRequest`, `postRequest`, `putRequest`, `deleteRequest`
+- Always pass `params` object with `access_token` (use `accessTokenSelector()` or widget prop)
+- Use `expand` param for nested relations (dot notation: `tickets.owner.extra_questions`)
+- Custom error handlers must return `authErrorHandler` as default case
+- Thunk signature: `(dispatch, getState) => { ... }`
+
+## Common Mistakes
+
+- Forgetting to await `accessTokenSelector()` (results in Promise instead of token)
+- Not handling 404/500 in custom error handlers (triggers unwanted auth errors)
+- Hardcoding API base URL (always use `state.registration.apiBaseUrl` or prop)
+- Missing `expand` params (causes N+1 queries or missing data in components)

package/.claude/rules/summit-registration-lite-testing.md

@@ -0,0 +1,97 @@
+# Testing Patterns
+
+## When to Apply
+
+Writing new component tests or maintaining existing tests.
+
+## Pattern
+
+**Test Structure:**
+
+```javascript
+import React from 'react';
+import { render, fireEvent, waitFor, screen } from '@testing-library/react';
+import '@testing-library/jest-dom';
+import ComponentName from '..';
+
+const mockCallback = jest.fn();
+
+afterEach(() => {
+    jest.clearAllMocks();  // Reset mocks between tests
+});
+
+it('describes expected behavior', () => {
+    const { getByTestId, getAllByTestId, queryByText } = render(
+        <ComponentName prop1={value1} callback={mockCallback} />
+    );
+
+    // Arrange: find elements
+    const button = getByTestId('button-id');
+
+    // Act: interact
+    fireEvent.click(button);
+
+    // Assert: verify outcome
+    expect(mockCallback).toHaveBeenCalledWith(expectedArg);
+});
+```
+
+**Common Queries:**
+
+```javascript
+// Single element (throws if not found)
+getByTestId('id')          // data-testid attribute
+getByText('text')          // visible text content
+getByRole('button')        // ARIA role
+
+// Multiple elements
+getAllByTestId('id')       // returns array
+
+// Nullable queries (returns null if not found)
+queryByText('text')        // useful for "expect().toBeFalsy()"
+
+// From screen utility
+screen.queryByText('text')
+```
+
+**Async Testing:**
+
+```javascript
+it('handles async behavior', async () => {
+    const { getByTestId } = render(<Component />);
+
+    fireEvent.click(getByTestId('async-button'));
+
+    await waitFor(() => {
+        expect(getByTestId('result')).toBeInTheDocument();
+    });
+});
+```
+
+## Key Points
+
+- Tests live in `__tests__/` directories alongside components
+- Use `data-testid` attributes for reliable element selection
+- Mock callbacks with `jest.fn()`, verify with `.toHaveBeenCalled()` or `.toHaveBeenCalledWith()`
+- Use `queryBy*` for negative assertions (`expect().toBeFalsy()`)
+- Use `getBy*` for positive assertions (throws if element missing)
+- `@testing-library/react` auto-cleanup enabled (no manual unmount needed)
+- CSS/SCSS mocked via `identity-obj-proxy` (className checks work)
+- Static assets (images) mocked via `src/__mocks__/fileMock.js`
+
+## Test Organization
+
+```
+src/components/my-component/
+├── index.js
+├── my-component.module.scss
+└── __tests__/
+    └── my-component.test.js
+```
+
+## Common Mistakes
+
+- Using brittle selectors (text content that changes) instead of `data-testid`
+- Forgetting `@testing-library/jest-dom` import (causes `.toBeInTheDocument()` to fail)
+- Not awaiting async operations (tests pass locally, fail in CI due to timing)
+- Testing implementation details instead of user behavior (prefer user interactions over internal state checks)

package/.claude/skills/summit-registration-lite-add-provider/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: summit-registration-lite-add-provider
+version: 1.0.0
+description: Scaffold new payment provider with factory registration
+triggers:
+  - add payment provider
+  - new payment gateway
+  - integrate payment
+---
+
+# Add Payment Provider Workflow
+
+Scaffolds a new payment provider class with factory registration, error handling, and test template.
+
+## Steps
+
+1. **Ask for provider details**
+   - Provider name (e.g., "PayPal", "Square")
+   - Provider constant (e.g., "PAYMENT_PROVIDER_PAYPAL")
+   - Gateway-specific fields needed (API keys, client IDs, etc.)
+
+2. **Add constant to utils/constants.js**
+   ```javascript
+   export const PAYMENT_PROVIDER_NEWNAME = 'new_provider_name';
+   ```
+
+3. **Create provider class**
+   File: `src/utils/payment-providers/{name}-provider.js`
+
+   Use StripeProvider as template:
+   - Constructor receives: `{ reservation, summitId, userProfile, access_token, apiBaseUrl, dispatch }`
+   - Implement `payTicket` method with signature:
+     ```javascript
+     payTicket = ({ /* gateway-specific params */, onError = () => {} }) => async (dispatch) => {
+       // Implementation
+     }
+     ```
+   - Handle free/prepaid orders (skip gateway, call `/checkout` directly)
+   - Custom error handler for HTTP status codes (404 → VALIDATION, 500 → ERROR)
+   - Success flow: checkout → CLEAR_RESERVATION → changeStep(STEP_COMPLETE)
+   - Failure flow: removeReservedTicket → changeStep(STEP_PERSONAL_INFO)
+
+4. **Register in factory**
+   File: `src/utils/payment-providers/payment-provider-factory.js`
+
+   Add import and case:
+   ```javascript
+   import { NewProvider } from './new-provider';
+
+   case PAYMENT_PROVIDER_NEWNAME: {
+       currentProvider = new NewProvider({...params});
+       break;
+   }
+   ```
+
+5. **Add provider component** (if custom UI needed)
+   File: `src/components/{name}-component/index.js`
+
+   Handles gateway-specific UI (payment form, buttons, etc.).
+
+6. **Create test file**
+   File: `src/utils/payment-providers/__tests__/{name}-provider.test.js`
+
+   Mock patterns:
+   - Mock API calls (putRequest)
+   - Mock gateway SDK (if any)
+   - Test free/prepaid flow
+   - Test error handling
+
+7. **Update PaymentComponent**
+   File: `src/components/payment/index.js`
+
+   Add conditional rendering for new provider UI.
+
+## Provider Template
+
+```javascript
+import { createAction, putRequest, authErrorHandler } from 'openstack-uicore-foundation/lib/utils/actions';
+import { CLEAR_RESERVATION, PAY_RESERVATION } from '../../actions';
+import { changeStep, removeReservedTicket, startWidgetLoading, stopWidgetLoading } from '../../actions';
+import { isFreeOrder, isPrePaidOrder } from '../utils';
+import { ERROR_TYPE_ERROR, ERROR_TYPE_VALIDATION, STEP_COMPLETE, STEP_PERSONAL_INFO } from '../constants';
+
+export class NewProvider {
+    constructor({ reservation, summitId, userProfile, access_token, apiBaseUrl, dispatch }) {
+        this.reservation = reservation;
+        this.summitId = summitId;
+        this.userProfile = userProfile;
+        this.access_token = access_token;
+        this.apiBaseUrl = apiBaseUrl;
+        this.dispatch = dispatch;
+    }
+
+    payTicket = ({ /* custom params */, onError = () => {} }) => async (dispatch) => {
+        const errorHandler = (err, res) => (dispatch, state) => {
+            let code = err.status;
+            switch (code) {
+                case 404: onError({type: ERROR_TYPE_VALIDATION, msg: res.body.message, exception: null}); break;
+                case 500: onError({type: ERROR_TYPE_ERROR, msg: res.body.message, exception: null}); break;
+                default: authErrorHandler(err, res)(dispatch, state); break;
+            }
+        };
+
+        const normalizedEntity = {
+            billing_address_1: this.userProfile?.address1 || '',
+            billing_address_2: this.userProfile?.address2 || '',
+            billing_address_city: this.userProfile?.locality || '',
+            billing_address_state: this.userProfile?.region || '',
+            billing_address_country: this.userProfile?.country || ''
+        };
+
+        dispatch(startWidgetLoading());
+
+        // Free/prepaid orders
+        if (isFreeOrder(this.reservation) || isPrePaidOrder(this.reservation)) {
+            return this.checkout(normalizedEntity, errorHandler, onError);
+        }
+
+        // Gateway-specific payment flow here
+        // Then call this.checkout() on success
+    };
+
+    checkout = (normalizedEntity, errorHandler, onError) => {
+        const params = { access_token: this.access_token, expand: 'tickets,tickets.owner,...' };
+
+        return putRequest(
+            null,
+            createAction(PAY_RESERVATION),
+            `${this.apiBaseUrl}/api/v1/summits/${this.summitId}/orders/${this.reservation.hash}/checkout`,
+            normalizedEntity,
+            errorHandler
+        )(params)(this.dispatch)
+            .then((payload) => {
+                this.dispatch(stopWidgetLoading());
+                this.dispatch(createAction(CLEAR_RESERVATION)({}));
+                this.dispatch(changeStep(STEP_COMPLETE));
+                return payload;
+            })
+            .catch(e => {
+                this.dispatch(stopWidgetLoading());
+                this.dispatch(removeReservedTicket());
+                this.dispatch(changeStep(STEP_PERSONAL_INFO));
+                onError({type: ERROR_TYPE_ERROR, msg: e?.message, exception: e});
+                return e;
+            });
+    };
+}
+```
+
+## Testing
+
+Run provider tests:
+```bash
+yarn test payment-providers
+```

package/.claude/skills/summit-registration-lite-dev-setup/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: summit-registration-lite-dev-setup
+version: 1.0.0
+description: Clean install and start development server
+triggers:
+  - setup dev environment
+  - start dev server
+  - clean install
+---
+
+# Development Setup Workflow
+
+Cleans existing installation and starts fresh development environment.
+
+## Steps
+
+### Option 1: Clean Setup (Recommended for Issues)
+
+1. **Clean all build artifacts and dependencies**
+   ```bash
+   yarn clean
+   ```
+   Removes `dist/` and `node_modules/`, then reinstalls with `yarn`.
+
+2. **Start dev server**
+   ```bash
+   yarn serve
+   ```
+   Starts webpack-dev-server on default port (usually 8080). Opens browser automatically.
+
+### Option 2: Quick Start (No Clean)
+
+1. **Install dependencies** (if `node_modules/` missing)
+   ```bash
+   yarn
+   ```
+
+2. **Start dev server**
+   ```bash
+   yarn serve
+   ```
+
+## Development Configuration
+
+- **Webpack config:** `webpack.dev.js` (extends `webpack.common.js`)
+- **Environment variables:**
+  - `API_BASE_URL` - API endpoint for development
+  - `ACCESS_TOKEN` - Auth token for standalone testing (stored in localStorage)
+
+Set these in shell or `.env` file:
+```bash
+export API_BASE_URL=https://api.dev.example.com
+export ACCESS_TOKEN=your_dev_token
+```
+
+## Standalone Testing
+
+The widget supports standalone mode in development. Set environment variables before running `yarn serve` to test without parent app.
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Port already in use | Kill process: `lsof -ti:8080 | xargs kill` or change port in webpack.dev.js |
+| Stale cache | Run `yarn clean` |
+| Module not found | Delete `node_modules/` and `yarn.lock`, then `yarn` |
+| Hot reload not working | Check webpack-dev-server config, ensure `watchFiles` configured |

package/.claude/skills/summit-registration-lite-publish/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: summit-registration-lite-publish
+version: 1.0.0
+description: Build and publish package to NPM registry
+triggers:
+  - publish to npm
+  - release package
+  - deploy widget
+---
+
+# Package Publishing Workflow
+
+Builds the production bundle and publishes to NPM registry.
+
+## Steps
+
+1. **Verify clean state**
+   ```bash
+   git status
+   ```
+   Ensure no uncommitted changes. If changes exist, ask user to commit or stash first.
+
+2. **Verify version**
+   ```bash
+   cat package.json | grep '"version"'
+   ```
+   Confirm version with user before publishing. Ask if version should be bumped (patch/minor/major).
+
+3. **Build production bundle**
+   ```bash
+   yarn build
+   ```
+   Compiles with webpack.prod.js. Output goes to `dist/`.
+
+4. **Verify build output**
+   ```bash
+   ls -lh dist/
+   ```
+   Check that `index.js` and `index.css` exist.
+
+5. **Publish to NPM**
+   ```bash
+   yarn publish
+   ```
+   Prompts for new version (if not already updated). Requires NPM authentication.
+
+## Alternative: Combined Command
+
+The `yarn publish-package` script combines build and publish:
+```bash
+yarn publish-package
+```
+
+## Prerequisites
+
+- NPM authentication configured (`npm login`)
+- Write access to `summit-registration-lite` package on NPM
+- Clean git working directory (or committed changes)
+
+## Post-Publish
+
+- Tag the release in git: `git tag v{version}`
+- Push tag: `git push origin v{version}`
+- Update CHANGELOG.md with release notes