@cuemath/web-utils 2.0.0-beta.0 → 2.1.10-beta.20

package/.eslintignore

@@ -0,0 +1,2 @@
+.next
+/dist

package/.eslintrc.json

@@ -0,0 +1,9 @@
+{
+  "root": true,
+  "extends": ["@cuemath"],
+  "settings": {
+    "react": {
+      "version": "16.13.1"
+    }
+  }
+}

package/.husky/pre-commit

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+yarn lint
+npx lint-staged

package/.huskyrc

@@ -0,0 +1,5 @@
+{
+  "hooks": {
+    "pre-commit": "lint-staged"
+  }
+}

package/.lintstagedrc.yml

@@ -0,0 +1,5 @@
+linters:
+  ./**/*.ts:
+    - prettier --write
+    - eslint
+    - git add

package/.nvmrc

@@ -0,0 +1 @@
+v18.12.1

package/.prettierrc.json

@@ -0,0 +1 @@
+"@cuemath/prettier-config"

package/.vscode/settings.json

@@ -0,0 +1 @@
+{}

package/README.md

@@ -1,334 +1 @@
-# @cuemath/web-utils v2.0.0
-
-Shared web utilities package optimized for Lambda@Edge, CloudFront, and browser environments.
-
-## Features
-
-- 🚀 **Lambda@Edge Ready** - Optimized bundles for AWS CloudFront edge computing
-- 📦 **Tree-Shakeable** - Import only what you need with ESM
-- ⚡ **Tiny Bundles** - CloudFront entry: 18KB gzipped (800KB limit)
-- 🔧 **Dual Formats** - ESM (primary) + CJS (legacy) support
-- 🎯 **TypeScript** - Full type definitions included
-- 🌐 **Universal** - Works in Node.js, browsers, and edge runtimes
-
-## Installation
-
-```bash
-yarn add @cuemath/web-utils
-# or
-npm install @cuemath/web-utils
-```
-
-## Entry Points
-
-### Main Entry (Universal)
-```typescript
-import { formatDateTime, getCurrentTimestamp } from '@cuemath/web-utils';
-```
-
-### CloudFront/Lambda@Edge (Server-Optimized)
-```typescript
-import {
-  parseCloudFrontCookies,
-  getABVariantFromCookies,
-  getABExperimentCacheKey
-} from '@cuemath/web-utils/cloudfront';
-```
-
-### Browser (DOM APIs)
-```typescript
-import {
-  getABVariant,
-  localStorageSet,
-  getAttributes
-} from '@cuemath/web-utils/browser';
-```
-
-### Timezone Functions (Optional)
-```typescript
-import {
-  dateByTimezone,
-  getTimezone
-} from '@cuemath/web-utils/date-time-helper/timezone';
-```
-
-## CloudFront Lambda@Edge Usage
-
-### Origin Request Handler Example
-
-```typescript
-import {
-  parseCloudFrontCookies,
-  getABVariantFromCookies,
-  getABExperimentCacheKey,
-  ISO_COUNTRY_CODE,
-  EXPERIMENT_KEYS,
-  VARIANTS,
-  AB_IDENTIFIER_KEY
-} from '@cuemath/web-utils/cloudfront';
-
-export const handler = async (event) => {
-  const request = event.Records[0].cf.request;
-  const headers = request.headers;
-  
-  // Parse CloudFront cookies (handles multiple Cookie headers)
-  const cookies = parseCloudFrontCookies(headers.cookie || []);
-  
-  // Get country from CloudFront-Viewer-Country header
-  const country = headers['cloudfront-viewer-country']?.[0]?.value || 'US';
-  
-  // Parse current A/B variants from cookie
-  const currentVariants = cookies[AB_IDENTIFIER_KEY] 
-    ? JSON.parse(decodeURIComponent(cookies[AB_IDENTIFIER_KEY]))
-    : {};
-  
-  // Parse last landing page cookie
-  const lastLandingPage = cookies['lastLandingPage']
-    ? JSON.parse(cookies['lastLandingPage'])
-    : { value: '', createdAt: '' };
-  
-  // Get A/B variant assignments (Lambda@Edge optimized)
-  const { isABExperimentsUpdated, abExperiment } = getABVariantFromCookies(
-    request.uri,
-    country,
-    currentVariants,
-    lastLandingPage,
-    cookies, // Pre-parsed cookies
-    'debug_ab' // Debug cookie name
-  );
-  
-  // Generate cache key for CloudFront
-  const cacheKey = getABExperimentCacheKey(abExperiment);
-  
-  // Add cache key to custom header for CloudFront caching
-  request.headers['x-ab-experiments'] = [{
-    key: 'X-AB-Experiments',
-    value: cacheKey
-  }];
-  
-  // Set cookie if experiments were updated
-  if (isABExperimentsUpdated) {
-    const cookieValue = encodeURIComponent(JSON.stringify(abExperiment));
-    request.headers['cookie'] = request.headers['cookie'] || [];
-    request.headers['cookie'].push({
-      key: 'Cookie',
-      value: `${AB_IDENTIFIER_KEY}=${cookieValue}`
-    });
-  }
-  
-  return request;
-};
-```
-
-### Viewer Response Handler (Set Cookies)
-
-```typescript
-export const handler = async (event) => {
-  const response = event.Records[0].cf.response;
-  const request = event.Records[0].cf.request;
-  
-  // Get A/B experiments from request header
-  const abHeader = request.headers['x-ab-experiments']?.[0]?.value;
-  
-  if (abHeader) {
-    // Set cookie with A/B variants
-    response.headers['set-cookie'] = [{
-      key: 'Set-Cookie',
-      value: `${AB_IDENTIFIER_KEY}=${abHeader}; Path=/; Max-Age=31536000; Secure; SameSite=Lax`
-    }];
-  }
-  
-  return response;
-};
-```
-
-## Migration from Cloudflare Workers
-
-### Before (Cloudflare Workers)
-```typescript
-import { getABVariant } from '@cuemath/web-utils';
-
-const result = getABVariant(
-  request.url,
-  'US',
-  currentVariants,
-  lastLanding,
-  'debug_ab',
-  request.headers.get('Cookie') // String
-);
-```
-
-### After (CloudFront Lambda@Edge)
-```typescript
-import {
-  parseCloudFrontCookies,
-  getABVariantFromCookies
-} from '@cuemath/web-utils/cloudfront';
-
-// CloudFront provides cookies as header array
-const cookies = parseCloudFrontCookies(
-  event.Records[0].cf.request.headers.cookie
-);
-
-const result = getABVariantFromCookies(
-  request.uri,
-  'US',
-  currentVariants,
-  lastLanding,
-  cookies, // Object
-  'debug_ab'
-);
-```
-
-**Key Differences:**
-1. CloudFront cookies are header arrays, not strings
-2. Use `parseCloudFrontCookies()` to convert to object
-3. Use `getABVariantFromCookies()` instead of `getABVariant()`
-4. CloudFront request URI instead of full URL
-5. Country from `cloudfront-viewer-country` header
-
-## Bundle Sizes
-
-| Entry Point | Gzipped | Uncompressed | Lambda@Edge Limit |
-|-------------|---------|--------------|-------------------|
-| CloudFront  | 18 KB   | ~60 KB       | 1 MB (1.8% used) |
-| Browser     | 22 KB   | ~90 KB       | N/A |
-| Main        | 24 KB   | ~95 KB       | N/A |
-| Timezone    | 4 KB    | ~12 KB       | N/A |
-
-All entry points are **well within Lambda@Edge limits** for origin-request handlers!
-
-## Breaking Changes (v2.0.0)
-
-### 1. Node.js 18+ Required
-```json
-{
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
-```
-
-### 2. Timezone Functions Separated
-```typescript
-// ❌ Old (v1.x)
-import { dateByTimezone } from '@cuemath/web-utils';
-
-// ✅ New (v2.x)
-import { dateByTimezone } from '@cuemath/web-utils/date-time-helper/timezone';
-```
-
-### 3. New CloudFront Entry Point
-```typescript
-// ✅ New in v2.0
-import { parseCloudFrontCookies, getABVariantFromCookies } from '@cuemath/web-utils/cloudfront';
-```
-
-### 4. Export Paths Changed
-```typescript
-// ❌ Old (v1.x)
-import utils from '@cuemath/web-utils';
-
-// ✅ New (v2.x) - Named imports only
-import { formatDateTime } from '@cuemath/web-utils';
-```
-
-## API Reference
-
-### Cookie Utilities
-
-#### `parseCookieString(cookieString: string): Record<string, string>`
-Parse a cookie string into key-value object. Works with Cloudflare Workers and browser `document.cookie`.
-
-#### `parseCloudFrontCookies(headers: Array<{key: string, value: string}>): Record<string, string>`
-Parse CloudFront cookie headers (handles multiple Cookie headers). **First occurrence takes priority.**
-
-#### `getCookie(name: string, cookie?: string): string`
-Get a specific cookie value. Works in both browser and server contexts.
-
-### A/B Testing
-
-#### `getABVariantFromCookies(...): { isABExperimentsUpdated: boolean, abExperiment: Record<string, string> }`
-Lambda@Edge optimized A/B variant assignment. Accepts pre-parsed cookies.
-
-**Parameters:**
-- `url: string` - Request URL/path
-- `countryCode: string` - ISO country code
-- `currentABVariant: Record<string, string>` - Current assignments
-- `lastLandingPageCookies: { value: string, createdAt: string }` - Landing page data
-- `parsedCookies: Record<string, string>` - Pre-parsed cookie object
-- `debugABCookieName: string` - Debug cookie name
-
-#### `getABExperimentCacheKey(experiments: Record<string, string>): string`
-Generate CloudFront cache key from A/B experiments. Returns sorted `key=value&key=value` string.
-
-### Date/Time Helpers (Core)
-
-#### `formatDateTime(dateTime, format): string`
-Format dates using dayjs format strings.
-
-#### `getCurrentTimestamp(): number`
-Get current Unix timestamp in seconds.
-
-#### `convertTimeStampToSeconds(timestamp): number`
-Normalize millisecond timestamps to seconds.
-
-### Date/Time Helpers (Timezone - Optional)
-
-#### `dateByTimezone(timestamp, timezone, format): string`
-Format timestamp with IANA timezone support.
-
-#### `getTimezone(): string`
-Get browser's IANA timezone identifier.
-
-## Performance Tips
-
-### 1. Import from Specific Entry Points
-```typescript
-// ✅ Good - Only CloudFront bundle (18KB)
-import { parseCloudFrontCookies } from '@cuemath/web-utils/cloudfront';
-
-// ❌ Avoid - Pulls in entire package
-import { parseCloudFrontCookies } from '@cuemath/web-utils';
-```
-
-### 2. Avoid Timezone Functions in Lambda@Edge
-```typescript
-// ✅ Good - No timezone dependencies (saves ~7KB)
-import { formatDateTime } from '@cuemath/web-utils/cloudfront';
-
-// ❌ Avoid - Adds timezone data bundle
-import { dateByTimezone } from '@cuemath/web-utils/date-time-helper/timezone';
-```
-
-### 3. Use Tree-Shaking
-```typescript
-// ✅ Good - Only imports what you use
-import { ISO_COUNTRY_CODE } from '@cuemath/web-utils/cloudfront';
-
-// ❌ Avoid - Imports everything
-import * as utils from '@cuemath/web-utils';
-```
-
-## Development
-
-```bash
-# Install dependencies
-yarn install
-
-# Build all entry points
-yarn build
-
-# Watch mode
-yarn build:watch
-
-# Check bundle sizes
-yarn size
-
-# Analyze bundles
-yarn build:analyze
-```
-
-## License
-
-ISC
+### Shared UI utils package

package/dist/constants/country/index.d.ts

@@ -0,0 +1,2 @@
+export { COUNTRY_NAME_COUNTRY_CODE_MAP as ISO_COUNTRY_CODE } from './iso-country-code';
+export declare const CUE_COUNTRY_CODE_KEY = "cue_country_code";

package/dist/constants/country/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CUE_COUNTRY_CODE_KEY = exports.ISO_COUNTRY_CODE = void 0;
+var iso_country_code_1 = require("./iso-country-code");
+Object.defineProperty(exports, "ISO_COUNTRY_CODE", { enumerable: true, get: function () { return iso_country_code_1.COUNTRY_NAME_COUNTRY_CODE_MAP; } });
+exports.CUE_COUNTRY_CODE_KEY = 'cue_country_code';
+//# sourceMappingURL=index.js.map

package/dist/constants/country/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/country/index.ts"],"names":[],"mappings":";;;AAAA,uDAAuF;AAA9E,oHAAA,6BAA6B,OAAoB;AAC7C,QAAA,oBAAoB,GAAG,kBAAkB,CAAC"}

package/dist/constants/country/iso-country-code.d.ts

@@ -0,0 +1,248 @@
+export declare const COUNTRY_NAME_COUNTRY_CODE_MAP: {
+    AFGHANISTAN: string;
+    'ALAND ISLANDS': string;
+    ALBANIA: string;
+    ALGERIA: string;
+    'AMERICAN SAMOA': string;
+    ANDORRA: string;
+    ANGOLA: string;
+    ANGUILLA: string;
+    ANTARCTICA: string;
+    'ANTIGUA AND BARBUDA': string;
+    ARGENTINA: string;
+    ARMENIA: string;
+    ARUBA: string;
+    AUSTRALIA: string;
+    AUSTRIA: string;
+    AZERBAIJAN: string;
+    BAHAMAS: string;
+    BAHRAIN: string;
+    BANGLADESH: string;
+    BARBADOS: string;
+    BELARUS: string;
+    BELGIUM: string;
+    BELIZE: string;
+    BENIN: string;
+    BERMUDA: string;
+    BHUTAN: string;
+    BOLIVIA: string;
+    'BOSNIA AND HERZEGOVINA': string;
+    BOTSWANA: string;
+    'BOUVET ISLAND': string;
+    BRAZIL: string;
+    'BRITISH INDIAN OCEAN TERRITORY': string;
+    'BRUNEI DARUSSALAM': string;
+    BULGARIA: string;
+    'BURKINA FASO': string;
+    BURUNDI: string;
+    CAMBODIA: string;
+    CAMEROON: string;
+    CANADA: string;
+    'CAPE VERDE': string;
+    'CAYMAN ISLANDS': string;
+    'CENTRAL AFRICAN REPUBLIC': string;
+    CHAD: string;
+    CHILE: string;
+    CHINA: string;
+    'CHRISTMAS ISLAND': string;
+    'COCOS (KEELING) ISLANDS': string;
+    COLOMBIA: string;
+    COMOROS: string;
+    CONGO: string;
+    'CONGO, DEMOCRATIC REPUBLIC': string;
+    'COOK ISLANDS': string;
+    'COSTA RICA': string;
+    'COTE D"IVOIRE': string;
+    CROATIA: string;
+    CUBA: string;
+    CYPRUS: string;
+    'CZECH REPUBLIC': string;
+    DENMARK: string;
+    DJIBOUTI: string;
+    DOMINICA: string;
+    'DOMINICAN REPUBLIC': string;
+    ECUADOR: string;
+    EGYPT: string;
+    'EL SALVADOR': string;
+    'EQUATORIAL GUINEA': string;
+    ERITREA: string;
+    ESTONIA: string;
+    ETHIOPIA: string;
+    'FALKLAND ISLANDS (MALVINAS)': string;
+    'FAROE ISLANDS': string;
+    FIJI: string;
+    FINLAND: string;
+    FRANCE: string;
+    'FRENCH GUIANA': string;
+    'FRENCH POLYNESIA': string;
+    'FRENCH SOUTHERN TERRITORIES': string;
+    GABON: string;
+    GAMBIA: string;
+    GEORGIA: string;
+    GERMANY: string;
+    GHANA: string;
+    GIBRALTAR: string;
+    GREECE: string;
+    GREENLAND: string;
+    GRENADA: string;
+    GUADELOUPE: string;
+    GUAM: string;
+    GUATEMALA: string;
+    GUERNSEY: string;
+    GUINEA: string;
+    'GUINEA-BISSAU': string;
+    GUYANA: string;
+    HAITI: string;
+    'HEARD ISLAND & MCDONALD ISLANDS': string;
+    'HOLY SEE (VATICAN CITY STATE)': string;
+    HONDURAS: string;
+    'HONG KONG': string;
+    HUNGARY: string;
+    ICELAND: string;
+    INDIA: string;
+    INDONESIA: string;
+    'IRAN, ISLAMIC REPUBLIC OF': string;
+    IRAQ: string;
+    IRELAND: string;
+    'ISLE OF MAN': string;
+    ISRAEL: string;
+    ITALY: string;
+    JAMAICA: string;
+    JAPAN: string;
+    JERSEY: string;
+    JORDAN: string;
+    KAZAKHSTAN: string;
+    KENYA: string;
+    KIRIBATI: string;
+    KOREA: string;
+    'NORTH KOREA': string;
+    KUWAIT: string;
+    KYRGYZSTAN: string;
+    'LAO PEOPLE"S DEMOCRATIC REPUBLIC': string;
+    LATVIA: string;
+    LEBANON: string;
+    LESOTHO: string;
+    LIBERIA: string;
+    'LIBYAN ARAB JAMAHIRIYA': string;
+    LIECHTENSTEIN: string;
+    LITHUANIA: string;
+    LUXEMBOURG: string;
+    MACAO: string;
+    MACEDONIA: string;
+    MADAGASCAR: string;
+    MALAWI: string;
+    MALAYSIA: string;
+    MALDIVES: string;
+    MALI: string;
+    MALTA: string;
+    'MARSHALL ISLANDS': string;
+    MARTINIQUE: string;
+    MAURITANIA: string;
+    MAURITIUS: string;
+    MAYOTTE: string;
+    MEXICO: string;
+    'MICRONESIA, FEDERATED STATES OF': string;
+    MOLDOVA: string;
+    MONACO: string;
+    MONGOLIA: string;
+    MONTENEGRO: string;
+    MONTSERRAT: string;
+    MOROCCO: string;
+    MOZAMBIQUE: string;
+    MYANMAR: string;
+    NAMIBIA: string;
+    NAURU: string;
+    NEPAL: string;
+    NETHERLANDS: string;
+    'NETHERLANDS ANTILLES': string;
+    'NEW CALEDONIA': string;
+    'NEW ZEALAND': string;
+    NICARAGUA: string;
+    NIGER: string;
+    NIGERIA: string;
+    NIUE: string;
+    'NORFOLK ISLAND': string;
+    'NORTHERN MARIANA ISLANDS': string;
+    NORWAY: string;
+    OMAN: string;
+    PAKISTAN: string;
+    PALAU: string;
+    'PALESTINIAN TERRITORY, OCCUPIED': string;
+    PANAMA: string;
+    'PAPUA NEW GUINEA': string;
+    PARAGUAY: string;
+    PERU: string;
+    PHILIPPINES: string;
+    PITCAIRN: string;
+    POLAND: string;
+    PORTUGAL: string;
+    'PUERTO RICO': string;
+    QATAR: string;
+    REUNION: string;
+    ROMANIA: string;
+    'RUSSIAN FEDERATION': string;
+    RWANDA: string;
+    'SAINT BARTHELEMY': string;
+    'SAINT HELENA': string;
+    'SAINT KITTS AND NEVIS': string;
+    'SAINT LUCIA': string;
+    'SAINT MARTIN': string;
+    'SAINT PIERRE AND MIQUELON': string;
+    'SAINT VINCENT AND GRENADINES': string;
+    SAMOA: string;
+    'SAN MARINO': string;
+    'SAO TOME AND PRINCIPE': string;
+    'SAUDI ARABIA': string;
+    SENEGAL: string;
+    SERBIA: string;
+    SEYCHELLES: string;
+    'SIERRA LEONE': string;
+    SINGAPORE: string;
+    SLOVAKIA: string;
+    SLOVENIA: string;
+    'SOLOMON ISLANDS': string;
+    SOMALIA: string;
+    'SOUTH AFRICA': string;
+    'SOUTH GEORGIA AND SANDWICH ISL.': string;
+    SPAIN: string;
+    'SRI LANKA': string;
+    SUDAN: string;
+    SURINAME: string;
+    'SVALBARD AND JAN MAYEN': string;
+    SWAZILAND: string;
+    SWEDEN: string;
+    SWITZERLAND: string;
+    'SYRIAN ARAB REPUBLIC': string;
+    TAIWAN: string;
+    TAJIKISTAN: string;
+    TANZANIA: string;
+    THAILAND: string;
+    'TIMOR-LESTE': string;
+    TOGO: string;
+    TOKELAU: string;
+    TONGA: string;
+    'TRINIDAD AND TOBAGO': string;
+    TUNISIA: string;
+    TURKEY: string;
+    TURKMENISTAN: string;
+    'TURKS AND CAICOS ISLANDS': string;
+    TUVALU: string;
+    UGANDA: string;
+    UKRAINE: string;
+    'UNITED ARAB EMIRATES': string;
+    'UNITED KINGDOM': string;
+    'UNITED STATES': string;
+    'UNITED STATES OUTLYING ISLANDS': string;
+    URUGUAY: string;
+    UZBEKISTAN: string;
+    VANUATU: string;
+    VENEZUELA: string;
+    VIETNAM: string;
+    'VIRGIN ISLANDS, BRITISH': string;
+    'VIRGIN ISLANDS, U.S.': string;
+    'WALLIS AND FUTUNA': string;
+    'WESTERN SAHARA': string;
+    YEMEN: string;
+    ZAMBIA: string;
+    ZIMBABWE: string;
+};