sbcwallet 0.0.1

package/src/types.ts

@@ -0,0 +1,324 @@
+import { z } from 'zod'
+
+// Profile types
+export type ProfileType = 'logistics' | 'healthcare' | 'loyalty'
+
+// Status types
+export type LogisticsStatus = 'ISSUED' | 'PRESENCE' | 'SCALE' | 'OPS' | 'EXITED'
+export type HealthcareStatus = 'SCHEDULED' | 'CHECKIN' | 'PROCEDURE' | 'DISCHARGED'
+export type LoyaltyStatus = 'ACTIVE' | 'SUSPENDED'
+export type PassStatus = LogisticsStatus | HealthcareStatus | LoyaltyStatus
+
+// Time window schema
+export const TimeWindowSchema = z.object({
+  from: z.string(),
+  to: z.string(),
+  tz: z.string().optional()
+})
+
+export type TimeWindow = z.infer<typeof TimeWindowSchema>
+
+// Base pass data
+export interface BasePassData {
+  id: string
+  profile: ProfileType
+  createdAt: string
+  updatedAt: string
+  status: PassStatus
+  hash?: string
+  signature?: string
+  anchorId?: string
+}
+
+// Parent pass data (PES or AppointmentBatch)
+export interface ParentPassData extends BasePassData {
+  type: 'parent'
+  programName: string
+  site?: string
+  window?: TimeWindow
+  capacity?: number
+  metadata?: Record<string, any>
+}
+
+// Child pass data (TO or PatientVisit)
+export interface ChildPassData extends BasePassData {
+  type: 'child'
+  parentId: string
+  // Logistics specific
+  plate?: string
+  carrier?: string
+  client?: string
+  // Healthcare specific
+  patientName?: string
+  procedure?: string
+  doctor?: string
+
+  // Loyalty specific
+  businessId?: string
+  customerId?: string
+  customerName?: string
+  memberId?: string
+  points?: number
+  metadata?: Record<string, any>
+}
+
+// Unified pass data
+export type PassData = ParentPassData | ChildPassData
+
+// Create parent input schema
+export const CreateParentInputSchema = z.object({
+  id: z.string().min(1).optional(),
+  profile: z.enum(['logistics', 'healthcare', 'loyalty']).default('logistics'),
+  programName: z.string(),
+  site: z.string().optional(),
+  window: TimeWindowSchema.optional(),
+  capacity: z.number().positive().optional(),
+  metadata: z.record(z.any()).optional()
+})
+
+export type CreateParentInput = z.infer<typeof CreateParentInputSchema>
+
+// Create child input schema
+export const CreateChildInputSchema = z.object({
+  id: z.string().min(1).optional(),
+  profile: z.enum(['logistics', 'healthcare', 'loyalty']).default('logistics'),
+  parentId: z.string(),
+  // Logistics fields
+  plate: z.string().optional(),
+  carrier: z.string().optional(),
+  client: z.string().optional(),
+  // Healthcare fields
+  patientName: z.string().optional(),
+  procedure: z.string().optional(),
+  doctor: z.string().optional(),
+
+  // Loyalty fields
+  businessId: z.string().optional(),
+  customerId: z.string().optional(),
+  customerName: z.string().optional(),
+  memberId: z.string().optional(),
+  points: z.number().nonnegative().optional(),
+  metadata: z.record(z.any()).optional()
+})
+
+// Loyalty domain (multi-tenant) types
+export interface LoyaltyBusiness {
+  id: string
+  name: string
+  programName: string
+  pointsLabel: string
+  loyaltyProgramId?: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface LoyaltyCustomerAccount {
+  id: string
+  businessId: string
+  fullName: string
+  memberId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export const CreateBusinessInputSchema = z.object({
+  id: z.string().min(1).optional(),
+  name: z.string().min(1),
+  programName: z.string().min(1).optional(),
+  pointsLabel: z.string().min(1).optional()
+})
+
+export type CreateBusinessInput = z.infer<typeof CreateBusinessInputSchema>
+
+export const CreateCustomerAccountInputSchema = z.object({
+  id: z.string().min(1).optional(),
+  businessId: z.string().min(1),
+  fullName: z.string().min(1),
+  memberId: z.string().min(1).optional()
+})
+
+export type CreateCustomerAccountInput = z.infer<typeof CreateCustomerAccountInputSchema>
+
+export const CreateLoyaltyProgramInputSchema = z.object({
+  programId: z.string().min(1).optional(),
+  businessId: z.string().min(1),
+  // Optional overrides
+  programName: z.string().min(1).optional(),
+  site: z.string().optional(),
+  // Google Wallet geo-fence locations (latitude/longitude pairs)
+  locations: z.array(z.object({
+    latitude: z.number().min(-90).max(90),
+    longitude: z.number().min(-180).max(180)
+  })).optional(),
+  countryCode: z.string().length(2).optional(),
+  homepageUrl: z.string().url().optional(),
+  metadata: z.record(z.any()).optional()
+})
+
+export type CreateLoyaltyProgramInput = z.infer<typeof CreateLoyaltyProgramInputSchema>
+
+export const IssueLoyaltyCardInputSchema = z.object({
+  cardId: z.string().min(1).optional(),
+  businessId: z.string().min(1),
+  customerId: z.string().min(1),
+  initialPoints: z.number().nonnegative().optional().default(0),
+  metadata: z.record(z.any()).optional()
+})
+
+export type IssueLoyaltyCardInput = z.infer<typeof IssueLoyaltyCardInputSchema>
+
+export const UpdateLoyaltyPointsInputSchema = z.object({
+  cardId: z.string().min(1),
+  // Use either setPoints or delta
+  setPoints: z.number().nonnegative().optional(),
+  delta: z.number().int().optional()
+}).refine(v => v.setPoints !== undefined || v.delta !== undefined, {
+  message: 'Provide either setPoints or delta'
+})
+
+export type UpdateLoyaltyPointsInput = z.infer<typeof UpdateLoyaltyPointsInputSchema>
+
+export type GeoLocation = {
+  latitude: number
+  longitude: number
+}
+
+export type CreateChildInput = z.infer<typeof CreateChildInputSchema>
+
+// Apple Wallet specific types
+export interface ApplePassConfig {
+  teamId: string
+  passTypeId: string
+  certPath: string
+  certPassword: string
+  wwdrPath: string
+}
+
+export interface ApplePassField {
+  key: string
+  label: string
+  value: string | number
+  textAlignment?: 'PKTextAlignmentLeft' | 'PKTextAlignmentCenter' | 'PKTextAlignmentRight' | 'PKTextAlignmentNatural'
+}
+
+export interface ApplePassTemplate {
+  formatVersion: number
+  passTypeIdentifier: string
+  serialNumber: string
+  teamIdentifier: string
+  organizationName: string
+  description: string
+  backgroundColor?: string
+  foregroundColor?: string
+  labelColor?: string
+  logoText?: string
+  generic?: {
+    primaryFields?: ApplePassField[]
+    secondaryFields?: ApplePassField[]
+    auxiliaryFields?: ApplePassField[]
+    backFields?: ApplePassField[]
+    headerFields?: ApplePassField[]
+  }
+  barcode?: {
+    message: string
+    format: string
+    messageEncoding: string
+  }
+  barcodes?: Array<{
+    message: string
+    format: string
+    messageEncoding: string
+  }>
+}
+
+// Google Wallet specific types
+export interface GooglePassConfig {
+  issuerId: string
+  serviceAccountPath?: string
+}
+
+export interface GoogleTextField {
+  header?: string
+  body?: string
+}
+
+export interface GooglePassClass {
+  id: string
+  issuerName: string
+  reviewStatus?: string
+}
+
+export interface GooglePassObject {
+  id: string
+  classId: string
+  state?: string
+  locations?: GeoLocation[]
+  linksModuleData?: {
+    uris: Array<{
+      uri: string
+      description?: string
+      id?: string
+    }>
+  }
+  imageModulesData?: Array<{
+    mainImage: {
+      sourceUri: {
+        uri: string
+      }
+    }
+  }>
+  messages?: Array<{
+    id: string
+    header: string
+    body: string
+    messageType?: string
+  }>
+  barcode?: {
+    type: string
+    value: string
+  }
+  cardTitle?: GoogleTextField
+  header?: GoogleTextField
+  textModulesData?: Array<{
+    header: string
+    body: string
+    id: string
+  }>
+  heroImage?: {
+    sourceUri: {
+      uri: string
+    }
+  }
+  hexBackgroundColor?: string
+}
+
+// Profile configuration
+export interface ProfileFieldMap {
+  parent: Record<string, { label: string; key: string }>
+  child: Record<string, { label: string; key: string }>
+}
+
+export interface ProfileConfig {
+  name: ProfileType
+  fieldMap: ProfileFieldMap
+  statusFlow: PassStatus[]
+  defaultTemplates: {
+    apple: {
+      parent: Partial<ApplePassTemplate>
+      child: Partial<ApplePassTemplate>
+    }
+    google: {
+      parentClass: Partial<GooglePassClass>
+      parentObject: Partial<GooglePassObject>
+      childObject: Partial<GooglePassObject>
+    }
+  }
+}
+
+// Pass generation result
+export interface PassGenerationResult {
+  passData: PassData
+  applePkpass?: Buffer
+  googleSaveUrl?: string
+  googleObject?: GooglePassObject
+}

package/src/utils/progress-image.ts

@@ -0,0 +1,130 @@
+import { createCanvas } from 'canvas'
+
+export type LogisticsStatus = 'ISSUED' | 'PRESENCE' | 'SCALE' | 'OPS' | 'EXITED'
+export type HealthcareStatus = 'SCHEDULED' | 'CHECKIN' | 'PROCEDURE' | 'DISCHARGED'
+
+const LOGISTICS_STEPS = ['ISSUED', 'PRESENCE', 'SCALE', 'OPS', 'EXITED']
+const HEALTHCARE_STEPS = ['SCHEDULED', 'CHECKIN', 'PROCEDURE', 'DISCHARGED']
+
+const STATUS_COLORS = {
+  ISSUED: { bg: '#4A90E2', text: '#FFFFFF', bar: '#2E5C8A' },
+  PRESENCE: { bg: '#F5A623', text: '#FFFFFF', bar: '#C47F1A' },
+  SCALE: { bg: '#7B68EE', text: '#FFFFFF', bar: '#5B4BB8' },
+  OPS: { bg: '#50E3C2', text: '#1A1A1A', bar: '#3AB89E' },
+  EXITED: { bg: '#7ED321', text: '#FFFFFF', bar: '#5FA519' },
+  SCHEDULED: { bg: '#4A90E2', text: '#FFFFFF', bar: '#2E5C8A' },
+  CHECKIN: { bg: '#F5A623', text: '#FFFFFF', bar: '#C47F1A' },
+  PROCEDURE: { bg: '#E94B3C', text: '#FFFFFF', bar: '#B93A2E' },
+  DISCHARGED: { bg: '#7ED321', text: '#FFFFFF', bar: '#5FA519' }
+}
+
+interface ProgressImageOptions {
+  width?: number
+  height?: number
+  status: LogisticsStatus | HealthcareStatus
+  steps: string[]
+  title?: string
+}
+
+/**
+ * Generates a progress bar image for Google Wallet hero image
+ * Dimensions: 1032×336 px (3:1 ratio) as recommended by Google
+ */
+export async function generateProgressImage(options: ProgressImageOptions): Promise<Buffer> {
+  const {
+    width = 1032,
+    height = 336,
+    status,
+    steps,
+    title = 'Progress'
+  } = options
+
+  const canvas = createCanvas(width, height)
+  const ctx = canvas.getContext('2d')
+
+  const colors = STATUS_COLORS[status as keyof typeof STATUS_COLORS]
+  const currentIndex = steps.indexOf(status)
+  const progress = (currentIndex + 1) / steps.length
+
+  // Background gradient
+  const gradient = ctx.createLinearGradient(0, 0, 0, height)
+  gradient.addColorStop(0, colors.bg)
+  gradient.addColorStop(1, colors.bar)
+  ctx.fillStyle = gradient
+  ctx.fillRect(0, 0, width, height)
+
+  // Title
+  ctx.fillStyle = colors.text
+  ctx.font = 'bold 48px Arial, sans-serif'
+  ctx.textAlign = 'center'
+  ctx.fillText(title, width / 2, 70)
+
+  // Current status
+  ctx.font = 'bold 64px Arial, sans-serif'
+  ctx.fillText(status, width / 2, 150)
+
+  // Progress bar background
+  const barWidth = width * 0.8
+  const barHeight = 40
+  const barX = (width - barWidth) / 2
+  const barY = height - 120
+
+  ctx.fillStyle = 'rgba(255, 255, 255, 0.3)'
+  ctx.roundRect(barX, barY, barWidth, barHeight, 20)
+  ctx.fill()
+
+  // Progress bar fill
+  ctx.fillStyle = colors.text
+  ctx.roundRect(barX, barY, barWidth * progress, barHeight, 20)
+  ctx.fill()
+
+  // Step indicators
+  const stepWidth = barWidth / steps.length
+  ctx.font = 'bold 20px Arial, sans-serif'
+  ctx.textAlign = 'center'
+
+  steps.forEach((step, index) => {
+    const x = barX + stepWidth * index + stepWidth / 2
+    const y = barY - 20
+
+    // Step dot
+    ctx.beginPath()
+    ctx.arc(x, barY + barHeight / 2, 12, 0, Math.PI * 2)
+    ctx.fillStyle = index <= currentIndex ? colors.text : 'rgba(255, 255, 255, 0.5)'
+    ctx.fill()
+
+    // Step label
+    ctx.fillStyle = 'rgba(255, 255, 255, 0.9)'
+    ctx.fillText(step, x, y)
+  })
+
+  // Progress percentage
+  ctx.font = 'bold 28px Arial, sans-serif'
+  ctx.fillStyle = colors.text
+  ctx.textAlign = 'center'
+  ctx.fillText(`${Math.round(progress * 100)}% Complete`, width / 2, height - 40)
+
+  return canvas.toBuffer('image/png')
+}
+
+/**
+ * Generate hero image for logistics passes
+ */
+export async function generateLogisticsHeroImage(status: LogisticsStatus): Promise<Buffer> {
+  return generateProgressImage({
+    status,
+    steps: LOGISTICS_STEPS,
+    title: 'Transport Order Progress'
+  })
+}
+
+/**
+ * Generate hero image for healthcare passes
+ */
+export async function generateHealthcareHeroImage(status: HealthcareStatus): Promise<Buffer> {
+  return generateProgressImage({
+    status,
+    steps: HEALTHCARE_STEPS,
+    title: 'Patient Visit Progress'
+  })
+}

package/test-google-wallet.js

@@ -0,0 +1,78 @@
+import { createParentSchedule, createChildTicket, getGoogleObject } from './dist/index.js';
+import 'dotenv/config';
+async function testGoogleWallet() {
+    console.log('🧪 Testing Google Wallet Pass Generation\n');
+    // Verify environment variables
+    if (!process.env.GOOGLE_ISSUER_ID) {
+        console.error('❌ GOOGLE_ISSUER_ID not set in .env file');
+        console.log('\nPlease add to .env:');
+        console.log('GOOGLE_ISSUER_ID=your_issuer_id_here');
+        process.exit(1);
+    }
+    if (!process.env.GOOGLE_SA_JSON) {
+        console.error('❌ GOOGLE_SA_JSON not set in .env file');
+        console.log('\nReal device testing requires a Google service account JSON key:');
+        console.log('GOOGLE_SA_JSON=./certs/google-credentials.json');
+        console.log('\nWithout this, the Save URL will be unsigned and Google Wallet will not accept it.');
+        process.exit(1);
+    }
+    console.log('✅ Issuer ID found:', process.env.GOOGLE_ISSUER_ID);
+    // Create parent
+    const parent = await createParentSchedule({
+        profile: 'logistics',
+        programName: 'Test Yard Veracruz',
+        site: 'Patio Gate 3',
+        window: {
+            from: '2025-10-20T08:00:00-06:00',
+            to: '2025-10-20T12:00:00-06:00',
+            tz: 'America/Mexico_City'
+        }
+    });
+    console.log('\n✅ Parent created:', parent.id);
+    console.log('   Program:', parent.programName);
+    console.log('   Site:', parent.site);
+    // Create child
+    const child = await createChildTicket({
+        profile: 'logistics',
+        parentId: parent.id,
+        plate: 'TEST123',
+        carrier: 'Test Transport',
+        client: 'Test Client'
+    });
+    console.log('\n✅ Child created:', child.id);
+    console.log('   Plate:', child.plate);
+    console.log('   Carrier:', child.carrier);
+    // Generate Google Wallet object
+    try {
+        const { object, saveUrl } = await getGoogleObject('child', child);
+        console.log('\n' + '='.repeat(60));
+        console.log('✅ GOOGLE WALLET OBJECT GENERATED!');
+        console.log('='.repeat(60));
+        console.log('\n📋 Object Details:');
+        console.log(JSON.stringify(object, null, 2));
+        console.log('\n' + '='.repeat(60));
+        console.log('🔗 SAVE TO WALLET URL:');
+        console.log('='.repeat(60));
+        console.log(saveUrl);
+        const looksSigned = saveUrl.includes('/eyJ');
+        if (!looksSigned) {
+            console.log('\n⚠️  Save URL does not look like a signed JWT.');
+            console.log('   Ensure GOOGLE_SA_JSON points to a valid service account JSON file.');
+        }
+        console.log('\n' + '='.repeat(60));
+        console.log('📱 TO TEST ON YOUR DEVICE:');
+        console.log('='.repeat(60));
+        console.log('1. Copy the Save URL above');
+        console.log('2. Open it on your Android phone or any browser');
+        console.log('3. Click "Save to Google Wallet"');
+        console.log('4. Pass will appear in your Google Wallet app!');
+        console.log('\n' + '='.repeat(60));
+        console.log('🎉 SUCCESS!');
+        console.log('='.repeat(60));
+    }
+    catch (error) {
+        console.error('\n❌ Error generating pass:', error);
+        throw error;
+    }
+}
+testGoogleWallet().catch(console.error);

package/test-google-wallet.ts

@@ -0,0 +1,94 @@
+import { createParentSchedule, createChildTicket, getGoogleObject } from './dist/index.js'
+import 'dotenv/config'
+
+async function testGoogleWallet() {
+  console.log('🧪 Testing Google Wallet Pass Generation\n')
+
+  // Verify environment variables
+  if (!process.env.GOOGLE_ISSUER_ID) {
+    console.error('❌ GOOGLE_ISSUER_ID not set in .env file')
+    console.log('\nPlease add to .env:')
+    console.log('GOOGLE_ISSUER_ID=your_issuer_id_here')
+    process.exit(1)
+  }
+
+  if (!process.env.GOOGLE_SA_JSON) {
+    console.error('❌ GOOGLE_SA_JSON not set in .env file')
+    console.log('\nReal device testing requires a Google service account JSON key:')
+    console.log('GOOGLE_SA_JSON=./certs/google-credentials.json')
+    console.log('\nWithout this, the Save URL will be unsigned and Google Wallet will not accept it.')
+    process.exit(1)
+  }
+
+  console.log('✅ Issuer ID found:', process.env.GOOGLE_ISSUER_ID)
+
+  // Create parent
+  const parent = await createParentSchedule({
+    profile: 'logistics',
+    programName: 'Test Yard Veracruz',
+    site: 'Patio Gate 3',
+    window: {
+      from: '2025-10-20T08:00:00-06:00',
+      to: '2025-10-20T12:00:00-06:00',
+      tz: 'America/Mexico_City'
+    }
+  })
+
+  console.log('\n✅ Parent created:', parent.id)
+  console.log('   Program:', parent.programName)
+  console.log('   Site:', parent.site)
+
+  // Create child
+  const child = await createChildTicket({
+    profile: 'logistics',
+    parentId: parent.id,
+    plate: 'TEST123',
+    carrier: 'Test Transport',
+    client: 'Test Client'
+  })
+
+  console.log('\n✅ Child created:', child.id)
+  console.log('   Plate:', child.plate)
+  console.log('   Carrier:', child.carrier)
+
+  // Generate Google Wallet object
+  try {
+    const { object, saveUrl } = await getGoogleObject('child', child)
+
+    console.log('\n' + '='.repeat(60))
+    console.log('✅ GOOGLE WALLET OBJECT GENERATED!')
+    console.log('='.repeat(60))
+
+    console.log('\n📋 Object Details:')
+    console.log(JSON.stringify(object, null, 2))
+
+    console.log('\n' + '='.repeat(60))
+    console.log('🔗 SAVE TO WALLET URL:')
+    console.log('='.repeat(60))
+    console.log(saveUrl)
+
+    const looksSigned = saveUrl.includes('/eyJ')
+    if (!looksSigned) {
+      console.log('\n⚠️  Save URL does not look like a signed JWT.')
+      console.log('   Ensure GOOGLE_SA_JSON points to a valid service account JSON file.')
+    }
+
+    console.log('\n' + '='.repeat(60))
+    console.log('📱 TO TEST ON YOUR DEVICE:')
+    console.log('='.repeat(60))
+    console.log('1. Copy the Save URL above')
+    console.log('2. Open it on your Android phone or any browser')
+    console.log('3. Click "Save to Google Wallet"')
+    console.log('4. Pass will appear in your Google Wallet app!')
+
+    console.log('\n' + '='.repeat(60))
+    console.log('🎉 SUCCESS!')
+    console.log('='.repeat(60))
+
+  } catch (error) {
+    console.error('\n❌ Error generating pass:', error)
+    throw error
+  }
+}
+
+testGoogleWallet().catch(console.error)