@schandlergarcia/sf-web-components 1.9.87 → 2.0.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/agentApiConfig.ts

@@ -1,36 +0,0 @@
-/**
- * Agentforce Agent API Configuration
- *
- * These values connect the ChatBar to the real Agentforce agent (Eva)
- * via the REST-based Agent API instead of the iframe-based
- * AgentforceConversationClient.
- *
- * Flow: OAuth token → create session → send messages → end session
- *
- * All requests are proxied through the Vite dev server to avoid CORS.
- * See vite.config.ts proxy rules:
- *   /sf-oauth/*  → myDomainUrl (for OAuth token)
- *   /sf-agent/*  → agentApiBaseUrl (for Agent API calls)
- */
-
-export const AGENT_API_CONFIG = {
-  myDomainUrl: "https://tdx26-keynote-org-1com.my.salesforce.com",
-
-  clientId:
-    "3MVG9Gm6vbdjgMWSOIAuIN3VSB5Rju6PgYQ5rl1yH3bVTTg9E2as4.C61Q0cyT.zqv2vUWNaxrm.A7SW5o3t7",
-  clientSecret:
-    "9ADF795A183A6B074A2E4B4CB1748B8DF7090C74191AF1C190213B512A733E03",
-
-  agentId: "0Xxa5000000rQlxCAE",
-
-  agentApiBaseUrl: "https://api.salesforce.com",
-
-  bypassUser: true,
-
-  demoTraveler: {
-    contactId: "003a500000mj4TlAAI",
-    email: "sarah.chen@arcline.ai",
-    firstName: "Sarah",
-    lastName: "Chen",
-  },
-};

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 ""