@schandlergarcia/sf-web-components 1.9.88 → 2.1.0

package/data/README.md

@@ -1,202 +0,0 @@
-# Data Assets
-
-This directory contains pre-packaged data assets for demo builds and prototyping.
-
-## Structure
-
-```
-data/
-├── engine-sample-data.js    # Engine Travel Command Center sample data
-├── schema.graphql            # Pre-built GraphQL schema from sample data
-└── README.md                 # This file
-```
-
-## Engine Travel Command Center Sample Data
-
-**Purpose:** Pre-seeded, dashboard-ready data for the Engine Travel demo. All field names match the Salesforce org schema (Trip__c, Flight__c, Booking__c, Disruption__c, Rebooking_Action__c, Travel_Policy__c) so switching from sample → live queries requires only a data-source swap.
-
-**Exports:**
-
-Raw Salesforce-shaped records:
-- `AIRPORTS` — Airport reference data with coordinates
-- `TRAVELERS` — Contact records (travelers)
-- `TRIPS` — Trip__c records
-- `FLIGHTS` — Flight__c records with real-time status
-- `HOTELS` — Hotel reservation records
-- `DISRUPTIONS` — Disruption__c records (delays, weather, closures)
-- `BOOKINGS` — Upcoming booking records
-- `REBOOKING_ACTIONS` — Rebooking_Action__c records (Eva activity)
-- `TRAVEL_POLICIES` — Travel_Policy__c records
-- `ACCOUNT` — Account stats
-- `MONTHLY_SPEND` — Spend history aggregated by month
-
-Dashboard-ready derivatives (pre-computed for immediate use):
-- `MAP_MARKERS` — City markers for GeoMap
-- `MAP_ARCS` — Flight arcs with progress & danger flags
-- `MAP_OVERLAYS` — Weather/disruption overlay circles
-- `FLIGHT_STATUS_LIST` — Glass strip flight status data
-- `TRAVELER_CARDS` — Traveler card props
-- `DISRUPTION_CARDS` — Disruption card props
-- `EVA_ACTIONS` — Eva activity feed items
-- `BOOKING_ROWS` — Booking table rows
-- `POLICY_ITEMS` — Policy status items
-- `DESTINATION_CHART_DATA` — Destination bar chart data
-- `SPEND_CHART_DATA` — Spend trend line data
-- `METRICS` — Computed KPI metrics (active travelers, spend MTD, compliance rate, etc.)
-
-**Installation:**
-
-Automatically installed to `src/data/engine-sample-data.js` by postinstall script.
-
-**Import in components:**
-
-```javascript
-import {
-  MAP_MARKERS,
-  MAP_ARCS,
-  MAP_OVERLAYS,
-  FLIGHT_STATUS_LIST,
-  TRAVELER_CARDS,
-  DISRUPTION_CARDS,
-  EVA_ACTIONS,
-  BOOKING_ROWS,
-  POLICY_ITEMS,
-  DESTINATION_CHART_DATA,
-  SPEND_CHART_DATA,
-  METRICS,
-} from '@/data/engine-sample-data';
-
-// Use directly in components
-<GeoMap markers={MAP_MARKERS} arcs={MAP_ARCS} overlays={MAP_OVERLAYS} />
-```
-
-**Switching to live Data Cloud:**
-
-The sample data uses the same field names as your Salesforce org schema. When you're ready to switch to live data:
-
-1. Query the objects using GraphQL or REST:
-   - Trip__c
-   - Flight__c
-   - Booking__c
-   - Disruption__c
-   - Rebooking_Action__c
-   - Travel_Policy__c
-
-2. Transform the query results using the same shape as the dashboard-ready exports
-
-3. Replace the imports — your components don't need to change
-
-**Field mapping reference:**
-
-All sample data uses Salesforce API field names:
-- Standard fields: `Id`, `Name`, `CreatedDate`
-- Custom fields: `Trip__c`, `Flight_Number__c`, `Departure_Airport__c`, `Status__c`, etc.
-- Relationships: `Contact__c`, `Trip__c`, `Impacted_Flight__c`
-
-## GraphQL Schema
-
-**Purpose:** Pre-built GraphQL schema for Engine Travel Command Center. Works even when org introspection is broken.
-
-**Problem it solves:**
-
-Org introspection can fail with "cannot invoke FieldDataType.equals(Object) because the return value of Field.getDataType() is null". This breaks:
-- `npm run graphql:schema` (introspection query)
-- IDE autocomplete that queries org directly
-- GraphQL codegen from org schema
-
-But **queries still work** - introspection is just metadata.
-
-**IMPORTANT: Codegen Auto-Run Disabled**
-
-This schema is **minimal** - it only contains Engine objects (Trip__c, Flight__c, etc.), not standard objects (Account, Contact, etc.).
-
-If you run `npm run graphql:codegen`, it will generate types from this minimal schema, which will be missing standard object types like `NullOrder`.
-
-**The vite.config.ts template has codegen auto-run disabled** to prevent this:
-- `runOnStart: false` - Won't run when you start dev server
-- `runOnBuild: false` - Won't run during build
-- `enableWatcher: false` - Won't watch for changes
-
-**Only run codegen manually** when you specifically want to regenerate from the minimal schema.
-
-See `.a4drules/troubleshooting/codegen-overwrites-types.md` for details.
-
-**Solution:**
-
-Pre-generate schema from sample data field names:
-1. Sample data already has correct Salesforce field names
-2. Generate `schema.graphql` from those field names
-3. Check schema into repo (automatically installed)
-4. GraphQL skills use the pre-built schema
-5. Queries execute normally using the same field names
-
-**Installation:**
-
-Automatically installed to `schema.graphql` (webapp root) by postinstall script.
-
-**Contents:**
-
-```graphql
-schema {
-  query: Query
-}
-
-type Query {
-  uiapi: UIAPI!
-}
-
-type UIAPI {
-  query: UIAPIQuery!
-}
-
-type UIAPIQuery {
-  Contact(first: Int, after: String, where: ContactFilter): ContactConnection
-  Trip__c(first: Int, after: String, where: Trip__cFilter): Trip__cConnection
-  Flight__c(first: Int, after: String, where: Flight__cFilter): Flight__cConnection
-  Booking__c(first: Int, after: String, where: Booking__cFilter): Booking__cConnection
-  Disruption__c(first: Int, after: String, where: Disruption__cFilter): Disruption__cConnection
-  Rebooking_Action__c(first: Int, after: String, where: Rebooking_Action__cFilter): Rebooking_Action__cConnection
-  Travel_Policy__c(first: Int, after: String, where: Travel_Policy__cFilter): Travel_Policy__cConnection
-}
-
-# ... Full schema with all types, connections, filters
-```
-
-**What this enables:**
-
-- ✅ `exploring-webapp-graphql-schema` skill works normally
-- ✅ `generating-webapp-graphql-read-query` skill works normally
-- ✅ `using-webapp-graphql` skill works normally
-- ✅ IDE autocomplete and validation
-- ✅ GraphQL codegen
-- ✅ Normal Phase 3 workflow without manual workarounds
-- ✅ Works in CI/CD without org access
-
-**Regenerating:**
-
-If you add new fields to sample data:
-
-```bash
-# From the webapp directory
-npm run graphql:schema:sample
-```
-
-This regenerates `schema.graphql` from the current sample data file. Then commit the updated schema to git.
-
-## Adding New Data Assets
-
-When adding new sample data:
-
-1. Create a new `.js` file in this directory
-2. Use Salesforce API field names throughout
-3. Export both raw records AND dashboard-ready derivatives
-4. Document the exports in this README
-5. Include transformation functions if needed
-
-## Guidelines
-
-- **Field names must match Salesforce schema** — this makes the live data swap seamless
-- **Pre-compute dashboard derivatives** — components should receive ready-to-render data
-- **Include realistic variety** — different statuses, edge cases, empty states
-- **Use ISO dates** — easier to parse and localize
-- **Keep data fresh** — dates relative to current time where relevant

package/data/USAGE.md

@@ -1,81 +0,0 @@
-# Using Sample Data from the Package
-
-When you install `@schandlergarcia/sf-web-components`, the sample data is included in the package.
-
-## Quick Copy Command
-
-From your webapp directory:
-
-```bash
-# Copy sample data to your webapp's src/data directory
-cp node_modules/@schandlergarcia/sf-web-components/data/engine-sample-data.js src/data/
-
-# Or use the included copy script
-bash node_modules/@schandlergarcia/sf-web-components/data/copy-to-webapp.sh .
-```
-
-## Manual Copy
-
-```bash
-# Create data directory if it doesn't exist
-mkdir -p src/data
-
-# Copy the sample data file
-cp node_modules/@schandlergarcia/sf-web-components/data/engine-sample-data.js src/data/
-```
-
-## Import in Your Components
-
-Once copied to `src/data/`, import the data:
-
-```javascript
-import {
-  MAP_MARKERS,
-  MAP_ARCS,
-  MAP_OVERLAYS,
-  FLIGHT_STATUS_LIST,
-  TRAVELER_CARDS,
-  DISRUPTION_CARDS,
-  EVA_ACTIONS,
-  BOOKING_ROWS,
-  POLICY_ITEMS,
-  DESTINATION_CHART_DATA,
-  SPEND_CHART_DATA,
-  METRICS,
-} from '@/data/engine-sample-data';
-
-// Use in components
-<GeoMap markers={MAP_MARKERS} arcs={MAP_ARCS} overlays={MAP_OVERLAYS} />
-```
-
-## What's Included
-
-See the [README.md](./README.md) for full documentation of available data exports.
-
-**Raw Salesforce records:**
-- AIRPORTS, TRAVELERS, TRIPS, FLIGHTS, HOTELS, DISRUPTIONS, BOOKINGS, etc.
-
-**Dashboard-ready derivatives:**
-- MAP_MARKERS, MAP_ARCS, FLIGHT_STATUS_LIST, TRAVELER_CARDS, etc.
-
-All data uses real Salesforce API field names, making it easy to swap for live data later.
-
-## Why Copy Instead of Import Directly?
-
-The data file is intentionally designed to be copied to your `src/` directory rather than imported directly from `node_modules` because:
-
-1. **Customization** - You can modify the sample data to match your specific use case
-2. **Version control** - Your data lives in your repo, not tied to package updates
-3. **Build optimization** - Some bundlers work better with files in `src/`
-4. **Switching to live data** - When ready, you replace the file with live queries
-
-## Switching to Live Data
-
-When you're ready to use live Salesforce data:
-
-1. Create a new file `src/data/live-data.js`
-2. Query the Salesforce objects (Trip__c, Flight__c, etc.) using GraphQL
-3. Transform the results to match the same shape as the sample data
-4. Update your imports from `engine-sample-data` to `live-data`
-
-Your components don't need to change - just the data source!

package/data/copy-to-webapp.sh

@@ -1,61 +0,0 @@
-#!/usr/bin/env bash
-#
-# Copy sample data to webapp src directory
-#
-# Usage:
-#   ./data/copy-to-webapp.sh [webapp-path]
-#
-# Examples:
-#   ./data/copy-to-webapp.sh force-app/main/default/webapplications/enginewebexperience
-#   ./data/copy-to-webapp.sh /path/to/your/webapp
-#
-
-set -e
-
-# Get the directory where this script lives
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-# Default webapp path (Engine Travel Command Center)
-DEFAULT_WEBAPP="force-app/main/default/webapplications/enginewebexperience"
-
-# Use provided path or default
-WEBAPP_PATH="${1:-$DEFAULT_WEBAPP}"
-
-# Make it absolute if relative
-if [[ ! "$WEBAPP_PATH" = /* ]]; then
-  WEBAPP_PATH="$PROJECT_ROOT/$WEBAPP_PATH"
-fi
-
-# Verify webapp exists
-if [ ! -d "$WEBAPP_PATH" ]; then
-  echo "❌ Error: Webapp directory not found: $WEBAPP_PATH"
-  echo ""
-  echo "Usage: $0 [webapp-path]"
-  echo ""
-  echo "Examples:"
-  echo "  $0"
-  echo "  $0 force-app/main/default/webapplications/enginewebexperience"
-  echo "  $0 /absolute/path/to/webapp"
-  exit 1
-fi
-
-# Create src/data directory if it doesn't exist
-DATA_DIR="$WEBAPP_PATH/src/data"
-mkdir -p "$DATA_DIR"
-
-# Copy the sample data file
-echo "📦 Copying sample data to webapp..."
-cp "$SCRIPT_DIR/engine-sample-data.js" "$DATA_DIR/engine-sample-data.js"
-
-echo "✅ Sample data copied to: $DATA_DIR/engine-sample-data.js"
-echo ""
-echo "Import in your components:"
-echo ""
-echo "  import {"
-echo "    MAP_MARKERS,"
-echo "    MAP_ARCS,"
-echo "    TRAVELER_CARDS,"
-echo "    // ... etc"
-echo "  } from '@/data/engine-sample-data';"
-echo ""

package/scripts/generate-schema-from-sample.mjs

@@ -1,370 +0,0 @@
-/**
- * Generate a minimal GraphQL schema from sample data when introspection is broken.
- *
- * This is a workaround for orgs where schema introspection fails due to fields
- * with null data types. It creates a schema.graphql file by analyzing the sample
- * data structure instead of querying the org.
- *
- * Usage:
- *   node scripts/generate-schema-from-sample.mjs
- */
-import { writeFileSync } from 'node:fs';
-import { resolve, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Import sample data to extract field names
-const TRAVELERS_FIELDS = [
-  'Id',
-  'FirstName',
-  'LastName',
-  'Department',
-  'Home_Airport__c',
-  'Travel_Policy_Tier__c',
-  'Is_Active_Traveler__c',
-  'Role__c',
-];
-
-const TRIPS_FIELDS = [
-  'Id',
-  'Trip_Name__c',
-  'Contact__c',
-  'Origin_City__c',
-  'Origin_Airport__c',
-  'Destination_City__c',
-  'Destination_Airport__c',
-  'Start_Date__c',
-  'End_Date__c',
-  'Status__c',
-  'Total_Cost__c',
-  'In_Policy__c',
-  'Has_Disruption__c',
-];
-
-const FLIGHTS_FIELDS = [
-  'Id',
-  'Flight_Number__c',
-  'Airline__c',
-  'Departure_Airport__c',
-  'Departure_City__c',
-  'Departure_Longitude__c',
-  'Departure_Latitude__c',
-  'Arrival_Airport__c',
-  'Arrival_City__c',
-  'Arrival_Longitude__c',
-  'Arrival_Latitude__c',
-  'Departure_DateTime__c',
-  'Flight_Status__c',
-  'Delay_Minutes__c',
-  'Cabin_Class__c',
-  'Contact__c',
-];
-
-const BOOKINGS_FIELDS = [
-  'Id',
-  'Contact__c',
-  'Booking_Type__c',
-  'Status__c',
-  'Cost__c',
-  'In_Policy__c',
-];
-
-const DISRUPTIONS_FIELDS = [
-  'Id',
-  'Flight_Number__c',
-  'Disruption_Type__c',
-  'Severity__c',
-  'Status__c',
-  'Impacted_Flight__c',
-  'Trip__c',
-  'City__c',
-  'Affected_Traveler_Count__c',
-  'Auto_Rebook_Eligible__c',
-  'Recommended_Action__c',
-  'Description__c',
-];
-
-const REBOOKING_ACTIONS_FIELDS = [
-  'Id',
-  'Action_Type__c',
-  'Status__c',
-  'Handled_By__c',
-  'Contact__c',
-  'Original_Flight__c',
-  'New_Flight__c',
-  'Cost_Difference__c',
-  'Notes__c',
-  'Created_DateTime__c',
-];
-
-const TRAVEL_POLICIES_FIELDS = [
-  'Id',
-  'Name',
-  'Description__c',
-  'Active__c',
-  'Policy_Tier__c',
-  'Max_Flight_Cost__c',
-  'Max_Hotel_Rate__c',
-  'Advance_Booking_Days__c',
-  'Preferred_Airlines__c',
-  'Preferred_Hotel_Chains__c',
-];
-
-function inferType(fieldName) {
-  if (fieldName === 'Id') return 'ID';
-  if (fieldName.includes('Count') || fieldName.includes('Cost') || fieldName.includes('Rate') || fieldName.includes('Days')) {
-    return 'Float';
-  }
-  if (fieldName.includes('Date') || fieldName.includes('DateTime')) {
-    return 'String'; // Dates come as ISO strings
-  }
-  if (fieldName.includes('Is_') || fieldName.includes('Has_') || fieldName.includes('Active') || fieldName.includes('In_Policy') || fieldName.includes('Eligible')) {
-    return 'Boolean';
-  }
-  if (fieldName.includes('Longitude') || fieldName.includes('Latitude') || fieldName.includes('Delay_Minutes')) {
-    return 'Float';
-  }
-  return 'String';
-}
-
-function generateFieldType(fieldName, indent = '  ') {
-  const type = inferType(fieldName);
-  if (fieldName === 'Id') {
-    return `${indent}${fieldName}: ${type}!`;
-  }
-  // All non-ID fields are wrapped in value object for FLS
-  return `${indent}${fieldName}: FieldValue${type}`;
-}
-
-function generateObjectType(objectName, fields) {
-  const fieldDefs = fields.map(f => generateFieldType(f, '  ')).join('\n');
-  return `type ${objectName} {\n${fieldDefs}\n}`;
-}
-
-const schema = `"""
-Generated schema for Engine Travel Command Center
-Source: src/data/engine-sample-data.js field names
-Note: This is a minimal schema for GraphQL tooling when introspection is broken
-"""
-
-schema {
-  query: Query
-}
-
-type Query {
-  uiapi: UIAPI!
-}
-
-type UIAPI {
-  query: UIAPIQuery!
-}
-
-type UIAPIQuery {
-  Contact(first: Int, after: String, where: ContactFilter): ContactConnection
-  Trip__c(first: Int, after: String, where: Trip__cFilter): Trip__cConnection
-  Flight__c(first: Int, after: String, where: Flight__cFilter): Flight__cConnection
-  Booking__c(first: Int, after: String, where: Booking__cFilter): Booking__cConnection
-  Disruption__c(first: Int, after: String, where: Disruption__cFilter): Disruption__cConnection
-  Rebooking_Action__c(first: Int, after: String, where: Rebooking_Action__cFilter): Rebooking_Action__cConnection
-  Travel_Policy__c(first: Int, after: String, where: Travel_Policy__cFilter): Travel_Policy__cConnection
-}
-
-# Field value wrappers for FLS
-type FieldValueString {
-  value: String
-  displayValue: String
-}
-
-type FieldValueFloat {
-  value: Float
-  displayValue: String
-}
-
-type FieldValueBoolean {
-  value: Boolean
-  displayValue: String
-}
-
-type FieldValueID {
-  value: ID
-  displayValue: String
-}
-
-# Contact (Travelers)
-${generateObjectType('Contact', TRAVELERS_FIELDS)}
-
-type ContactEdge {
-  node: Contact!
-  cursor: String!
-}
-
-type ContactConnection {
-  edges: [ContactEdge!]!
-  pageInfo: PageInfo!
-  totalCount: Int
-}
-
-input ContactFilter {
-  Id: IDFilter
-  FirstName: StringFilter
-  LastName: StringFilter
-  Department: StringFilter
-}
-
-# Trip__c
-${generateObjectType('Trip__c', TRIPS_FIELDS)}
-
-type Trip__cEdge {
-  node: Trip__c!
-  cursor: String!
-}
-
-type Trip__cConnection {
-  edges: [Trip__cEdge!]!
-  pageInfo: PageInfo!
-  totalCount: Int
-}
-
-input Trip__cFilter {
-  Id: IDFilter
-  Trip_Name__c: StringFilter
-  Status__c: StringFilter
-}
-
-# Flight__c
-${generateObjectType('Flight__c', FLIGHTS_FIELDS)}
-
-type Flight__cEdge {
-  node: Flight__c!
-  cursor: String!
-}
-
-type Flight__cConnection {
-  edges: [Flight__cEdge!]!
-  pageInfo: PageInfo!
-  totalCount: Int
-}
-
-input Flight__cFilter {
-  Id: IDFilter
-  Flight_Number__c: StringFilter
-  Flight_Status__c: StringFilter
-}
-
-# Booking__c
-${generateObjectType('Booking__c', BOOKINGS_FIELDS)}
-
-type Booking__cEdge {
-  node: Booking__c!
-  cursor: String!
-}
-
-type Booking__cConnection {
-  edges: [Booking__cEdge!]!
-  pageInfo: PageInfo!
-  totalCount: Int
-}
-
-input Booking__cFilter {
-  Id: IDFilter
-  Status__c: StringFilter
-}
-
-# Disruption__c
-${generateObjectType('Disruption__c', DISRUPTIONS_FIELDS)}
-
-type Disruption__cEdge {
-  node: Disruption__c!
-  cursor: String!
-}
-
-type Disruption__cConnection {
-  edges: [Disruption__cEdge!]!
-  pageInfo: PageInfo!
-  totalCount: Int
-}
-
-input Disruption__cFilter {
-  Id: IDFilter
-  Severity__c: StringFilter
-  Status__c: StringFilter
-}
-
-# Rebooking_Action__c
-${generateObjectType('Rebooking_Action__c', REBOOKING_ACTIONS_FIELDS)}
-
-type Rebooking_Action__cEdge {
-  node: Rebooking_Action__c!
-  cursor: String!
-}
-
-type Rebooking_Action__cConnection {
-  edges: [Rebooking_Action__cEdge!]!
-  pageInfo: PageInfo!
-  totalCount: Int
-}
-
-input Rebooking_Action__cFilter {
-  Id: IDFilter
-  Status__c: StringFilter
-}
-
-# Travel_Policy__c
-${generateObjectType('Travel_Policy__c', TRAVEL_POLICIES_FIELDS)}
-
-type Travel_Policy__cEdge {
-  node: Travel_Policy__c!
-  cursor: String!
-}
-
-type Travel_Policy__cConnection {
-  edges: [Travel_Policy__cEdge!]!
-  pageInfo: PageInfo!
-  totalCount: Int
-}
-
-input Travel_Policy__cFilter {
-  Id: IDFilter
-  Policy_Tier__c: StringFilter
-}
-
-# Pagination
-type PageInfo {
-  hasNextPage: Boolean!
-  hasPreviousPage: Boolean!
-  startCursor: String
-  endCursor: String
-}
-
-# Filter input types
-input IDFilter {
-  eq: ID
-  ne: ID
-  in: [ID!]
-  nin: [ID!]
-}
-
-input StringFilter {
-  eq: String
-  ne: String
-  like: String
-  in: [String!]
-  nin: [String!]
-}
-`;
-
-// Determine output path - write to current working directory (where the script was called from)
-const outputPath = resolve(process.cwd(), 'schema.graphql');
-
-try {
-  writeFileSync(outputPath, schema);
-  console.log(`✅ Schema generated successfully at ${outputPath}`);
-  console.log(`   Source: Sample data field names`);
-  console.log(`   Objects: Contact, Trip__c, Flight__c, Booking__c, Disruption__c, Rebooking_Action__c, Travel_Policy__c`);
-  console.log(`\nNote: This is a minimal schema for tooling. It may not include all fields or types from the actual org.`);
-} catch (error) {
-  console.error('❌ Failed to write schema:', error.message);
-  process.exit(1);
-}