sbcwallet 0.0.1

package/examples/claim-flow.ts

@@ -0,0 +1,163 @@
+import { createParentSchedule, createChildTicket, getPkpassBuffer, updatePassStatus } from '../src/index.js'
+import { writeFile } from 'fs/promises'
+
+/**
+ * Example claim flow demonstrating the complete lifecycle of a
+ * Program Entry Schedule (PES) and Transport Order (TO) in the logistics profile.
+ */
+async function runClaimFlow() {
+  console.log('🚀 Starting sbcwallet Pass Claim Flow Example\n')
+
+  try {
+    // Step 1: Create Parent PES (Program Entry Schedule)
+    console.log('1️⃣  Creating Parent PES...')
+    const pes = await createParentSchedule({
+      profile: 'logistics',
+      programName: 'Morning Yard Veracruz',
+      site: 'Patio Gate 3',
+      window: {
+        from: '2025-10-18T08:00:00-06:00',
+        to: '2025-10-18T12:00:00-06:00',
+        tz: 'America/Mexico_City'
+      },
+      capacity: 50
+    })
+
+    console.log(`✅ Parent PES created: ${pes.id}`)
+    console.log(`   Program: ${pes.programName}`)
+    console.log(`   Site: ${pes.site}`)
+    console.log(`   Status: ${pes.status}`)
+    console.log(`   Hash: ${pes.hash}`)
+    console.log(`   Signature: ${pes.signature}\n`)
+
+    // Step 2: Create Child TO (Transport Order)
+    console.log('2️⃣  Creating Child TO...')
+    const to = await createChildTicket({
+      profile: 'logistics',
+      parentId: pes.id,
+      plate: 'ABC123A',
+      carrier: 'Transportes Golfo',
+      client: 'Cliente Y'
+    })
+
+    console.log(`✅ Child TO created: ${to.id}`)
+    console.log(`   Plate: ${to.plate}`)
+    console.log(`   Carrier: ${to.carrier}`)
+    console.log(`   Client: ${to.client}`)
+    console.log(`   Parent ID: ${to.parentId}`)
+    console.log(`   Status: ${to.status}`)
+    console.log(`   Hash: ${to.hash}`)
+    console.log(`   Signature: ${to.signature}\n`)
+
+    // Step 3: Simulate status transitions
+    console.log('3️⃣  Simulating status transitions...')
+
+    console.log('   → PRESENCE (vehicle arrives at gate)')
+    const toPresence = await updatePassStatus(to.id, 'PRESENCE')
+    console.log(`   ✓ Status: ${toPresence.status}`)
+
+    console.log('   → SCALE (vehicle on scale)')
+    const toScale = await updatePassStatus(to.id, 'SCALE')
+    console.log(`   ✓ Status: ${toScale.status}`)
+
+    console.log('   → OPS (operations in progress)')
+    const toOps = await updatePassStatus(to.id, 'OPS')
+    console.log(`   ✓ Status: ${toOps.status}`)
+
+    console.log('   → EXITED (vehicle has exited)')
+    const toExited = await updatePassStatus(to.id, 'EXITED')
+    console.log(`   ✓ Status: ${toExited.status}`)
+    console.log(`   ✓ New hash: ${toExited.hash}\n`)
+
+    // Step 4: Generate Apple Wallet .pkpass (will fail without valid certs, but demonstrates API)
+    console.log('4️⃣  Attempting to generate Apple Wallet .pkpass...')
+    try {
+      const pkpass = await getPkpassBuffer('child', toExited)
+      await writeFile('ticket.pkpass', pkpass)
+      console.log('✅ Saved pkpass: ticket.pkpass\n')
+    } catch (error) {
+      console.log('⚠️  Apple Wallet pass generation skipped (requires valid certificates)')
+      console.log(`   Error: ${error instanceof Error ? error.message : String(error)}\n`)
+    }
+
+    // Summary
+    console.log('📊 Summary:')
+    console.log(`   Parent PES: ${pes.id}`)
+    console.log(`   Child TO: ${to.id}`)
+    console.log(`   Final Status: ${toExited.status}`)
+    console.log(`   Status Flow: ISSUED → PRESENCE → SCALE → OPS → EXITED`)
+    console.log('\n✨ Claim flow completed successfully!')
+
+  } catch (error) {
+    console.error('❌ Error during claim flow:')
+    console.error(error)
+    process.exit(1)
+  }
+}
+
+/**
+ * Healthcare example demonstrating appointment batch and patient visits
+ */
+async function runHealthcareFlow() {
+  console.log('\n🏥 Starting Healthcare Flow Example\n')
+
+  try {
+    // Create appointment batch
+    console.log('1️⃣  Creating Appointment Batch...')
+    const batch = await createParentSchedule({
+      profile: 'healthcare',
+      programName: 'Cardiology Appointments - Dr. Smith',
+      site: 'Main Hospital - Floor 3',
+      window: {
+        from: '2025-10-20T09:00:00Z',
+        to: '2025-10-20T17:00:00Z'
+      },
+      capacity: 20
+    })
+
+    console.log(`✅ Appointment Batch created: ${batch.id}`)
+    console.log(`   Program: ${batch.programName}`)
+    console.log(`   Status: ${batch.status}\n`)
+
+    // Create patient visit
+    console.log('2️⃣  Creating Patient Visit...')
+    const visit = await createChildTicket({
+      profile: 'healthcare',
+      parentId: batch.id,
+      patientName: 'John Doe',
+      doctor: 'Dr. Smith',
+      procedure: 'Cardiac Consultation'
+    })
+
+    console.log(`✅ Patient Visit created: ${visit.id}`)
+    console.log(`   Patient: ${visit.patientName}`)
+    console.log(`   Doctor: ${visit.doctor}`)
+    console.log(`   Procedure: ${visit.procedure}`)
+    console.log(`   Status: ${visit.status}\n`)
+
+    // Status transitions
+    console.log('3️⃣  Processing patient visit...')
+    await updatePassStatus(visit.id, 'CHECKIN')
+    console.log('   ✓ CHECKIN')
+
+    await updatePassStatus(visit.id, 'PROCEDURE')
+    console.log('   ✓ PROCEDURE')
+
+    const discharged = await updatePassStatus(visit.id, 'DISCHARGED')
+    console.log('   ✓ DISCHARGED\n')
+
+    console.log('✨ Healthcare flow completed!')
+
+  } catch (error) {
+    console.error('❌ Error during healthcare flow:')
+    console.error(error)
+  }
+}
+
+// Run both examples
+runClaimFlow()
+  .then(() => runHealthcareFlow())
+  .catch(error => {
+    console.error('Fatal error:', error)
+    process.exit(1)
+  })

package/examples/loyalty-admin-server.js

@@ -0,0 +1,207 @@
+import 'dotenv/config'
+
+import http from 'node:http'
+import { readFile } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+
+import {
+  createBusiness,
+  createCustomerAccount,
+  createLoyaltyProgram,
+  issueLoyaltyCard,
+  updateLoyaltyPoints,
+  getGoogleObject,
+  getPass
+} from '../dist/index.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const PORT = Number(process.env.LOYALTY_ADMIN_PORT || 5179)
+
+function optionalEnv(name) {
+  const value = process.env[name]
+  return value && String(value).trim() ? String(value).trim() : undefined
+}
+
+function json(res, statusCode, data) {
+  res.writeHead(statusCode, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store'
+  })
+  res.end(JSON.stringify(data, null, 2))
+}
+
+async function readJson(req) {
+  const chunks = []
+  for await (const chunk of req) chunks.push(chunk)
+  const raw = Buffer.concat(chunks).toString('utf8')
+  if (!raw) return {}
+  try {
+    return JSON.parse(raw)
+  } catch {
+    throw new Error('Invalid JSON body')
+  }
+}
+
+function parseLocationsFromEnv() {
+  // LOYALTY_LOCATIONS="35.6892,51.389;35.7000,51.4000"
+  const raw = process.env.LOYALTY_LOCATIONS
+  if (!raw) return undefined
+
+  const pairs = raw
+    .split(';')
+    .map(s => s.trim())
+    .filter(Boolean)
+
+  const locations = pairs
+    .map(pair => {
+      const [latStr, lngStr] = pair.split(',').map(s => s.trim())
+      const latitude = Number(latStr)
+      const longitude = Number(lngStr)
+      if (!Number.isFinite(latitude) || !Number.isFinite(longitude)) return null
+      return { latitude, longitude }
+    })
+    .filter(Boolean)
+
+  return locations.length > 0 ? locations : undefined
+}
+
+let state = {
+  business: null,
+  program: null,
+  customer: null,
+  card: null,
+  saveUrl: null
+}
+
+async function initState() {
+  const logoUrl = optionalEnv('LOYALTY_LOGO_URL') || 'https://placehold.co/256x256/png?text=SBC'
+  if (!optionalEnv('LOYALTY_LOGO_URL')) {
+    console.warn('⚠️  LOYALTY_LOGO_URL not set; using placeholder logo (set it to your public HTTPS logo URL for production)')
+  }
+
+  const business = createBusiness({
+    name: process.env.LOYALTY_BUSINESS_NAME || 'SBC Coffee',
+    programName: process.env.LOYALTY_PROGRAM_NAME || 'SBC Coffee Rewards',
+    pointsLabel: process.env.LOYALTY_POINTS_LABEL || 'Points'
+  })
+
+  const locations = parseLocationsFromEnv() || [
+    { latitude: 35.6892, longitude: 51.389 },
+    { latitude: 35.7000, longitude: 51.4 }
+  ]
+
+  const program = await createLoyaltyProgram({
+    businessId: business.id,
+    site: process.env.LOYALTY_SITE || 'Downtown Branch',
+    countryCode: process.env.LOYALTY_COUNTRY_CODE || 'IR',
+    homepageUrl: process.env.LOYALTY_HOMEPAGE_URL || 'https://example.com',
+    locations,
+    metadata: {
+      googleWallet: {
+        issuerName: process.env.LOYALTY_ISSUER_NAME || business.name,
+        backgroundColor: process.env.LOYALTY_BG || '#111827',
+        logoUrl,
+        heroImageUrl: process.env.LOYALTY_HERO_URL,
+        wordMarkUrl: process.env.LOYALTY_WORDMARK_URL,
+        updateRequestUrl: process.env.LOYALTY_UPDATE_REQUEST_URL
+      }
+    }
+  })
+
+  // Ensure loyalty class exists in API (when creds exist)
+  await getGoogleObject('parent', program)
+
+  const customer = createCustomerAccount({
+    businessId: business.id,
+    fullName: process.env.LOYALTY_CUSTOMER_NAME || 'Milad Test'
+  })
+
+  const card = await issueLoyaltyCard({
+    businessId: business.id,
+    customerId: customer.id,
+    initialPoints: Number(process.env.LOYALTY_INITIAL_POINTS || 10)
+  })
+
+  const { saveUrl } = await getGoogleObject('child', card)
+
+  state = { business, program, customer, card, saveUrl }
+  return state
+}
+
+async function ensureState() {
+  if (!state.card || !state.program || !state.customer || !state.business) {
+    await initState()
+  }
+  return state
+}
+
+async function refreshSaveUrlForCard() {
+  const card = state.card
+  if (!card) return
+  const latest = getPass(card.id) || card
+  const { saveUrl } = await getGoogleObject('child', latest)
+  state.saveUrl = saveUrl
+  state.card = latest
+}
+
+const server = http.createServer(async (req, res) => {
+  try {
+    const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`)
+
+    if (req.method === 'GET' && url.pathname === '/') {
+      const html = await readFile(join(__dirname, 'loyalty-admin.html'), 'utf8')
+      res.writeHead(200, {
+        'content-type': 'text/html; charset=utf-8',
+        'cache-control': 'no-store'
+      })
+      res.end(html)
+      return
+    }
+
+    if (req.method === 'GET' && url.pathname === '/state') {
+      await ensureState()
+      json(res, 200, state)
+      return
+    }
+
+    if (req.method === 'POST' && url.pathname === '/init') {
+      await initState()
+      json(res, 200, state)
+      return
+    }
+
+    if (req.method === 'POST' && url.pathname === '/points') {
+      await ensureState()
+      const body = await readJson(req)
+
+      const cardId = state.card.id
+
+      if (body.setPoints !== undefined) {
+        await updateLoyaltyPoints({ cardId, setPoints: Number(body.setPoints) })
+      } else if (body.delta !== undefined) {
+        await updateLoyaltyPoints({ cardId, delta: Number(body.delta) })
+      } else {
+        throw new Error('Provide setPoints or delta')
+      }
+
+      // Upsert updated object in Google Wallet when creds exist
+      await refreshSaveUrlForCard()
+
+      json(res, 200, state)
+      return
+    }
+
+    json(res, 404, { error: 'Not found' })
+  } catch (err) {
+    json(res, 400, { error: err instanceof Error ? err.message : String(err) })
+  }
+})
+
+server.listen(PORT, () => {
+  console.log(`✅ Loyalty admin server running: http://localhost:${PORT}`)
+  console.log('Env required for real device add: GOOGLE_ISSUER_ID, GOOGLE_SA_JSON')
+  console.log('Optional: LOYALTY_LOCATIONS="lat,lng;lat,lng"')
+})

package/examples/loyalty-admin.html

@@ -0,0 +1,260 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>sbcwallet Loyalty Admin</title>
+    <style>
+      :root {
+        color-scheme: dark;
+      }
+      body {
+        margin: 0;
+        font-family: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica, Arial;
+        background: #0b1220;
+        color: #e5e7eb;
+      }
+      .wrap {
+        max-width: 920px;
+        margin: 0 auto;
+        padding: 28px 16px 48px;
+      }
+      h1 {
+        margin: 0 0 12px;
+        font-size: 22px;
+      }
+      .card {
+        background: rgba(17, 24, 39, 0.8);
+        border: 1px solid rgba(148, 163, 184, 0.18);
+        border-radius: 14px;
+        padding: 16px;
+        box-shadow: 0 20px 60px rgba(0,0,0,0.35);
+      }
+      .row {
+        display: flex;
+        gap: 12px;
+        flex-wrap: wrap;
+        align-items: center;
+      }
+      .kv {
+        display: grid;
+        grid-template-columns: 160px 1fr;
+        gap: 6px 10px;
+        margin-top: 12px;
+      }
+      .k { color: #9ca3af; }
+      .v { color: #f9fafb; overflow-wrap: anywhere; }
+      button {
+        background: #111827;
+        border: 1px solid rgba(148, 163, 184, 0.25);
+        color: #f9fafb;
+        padding: 10px 12px;
+        border-radius: 10px;
+        cursor: pointer;
+      }
+      button:hover { border-color: rgba(148, 163, 184, 0.45); }
+      input {
+        background: #0b1220;
+        border: 1px solid rgba(148, 163, 184, 0.25);
+        color: #f9fafb;
+        padding: 10px 12px;
+        border-radius: 10px;
+        width: 120px;
+      }
+      a { color: #60a5fa; }
+      .muted { color: #9ca3af; font-size: 13px; }
+      .pill {
+        display: inline-flex;
+        align-items: center;
+        gap: 8px;
+        padding: 8px 10px;
+        border-radius: 999px;
+        border: 1px solid rgba(148, 163, 184, 0.25);
+        background: rgba(2, 6, 23, 0.35);
+        font-size: 13px;
+      }
+      .points {
+        font-size: 44px;
+        font-weight: 750;
+        letter-spacing: -0.02em;
+      }
+      .danger { color: #fca5a5; }
+      code {
+        background: rgba(2, 6, 23, 0.55);
+        border: 1px solid rgba(148, 163, 184, 0.18);
+        padding: 2px 6px;
+        border-radius: 6px;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="wrap">
+      <h1>sbcwallet — Loyalty Admin</h1>
+      <p class="muted">
+        This page talks to the local server (<code>loyalty-admin-server.js</code>) to create a loyalty card and update its points.
+      </p>
+
+      <div class="card">
+        <div class="row" style="justify-content: space-between;">
+          <div class="pill"><span>Card</span> <span id="status" class="muted">loading…</span></div>
+          <button id="btnInit">(Re)Init Card</button>
+        </div>
+
+        <div style="margin-top: 14px;" class="row">
+          <div>
+            <div class="muted">Points</div>
+            <div class="points" id="points">—</div>
+          </div>
+          <div class="row">
+            <button data-delta="-10">-10</button>
+            <button data-delta="-1">-1</button>
+            <button data-delta="+1">+1</button>
+            <button data-delta="+10">+10</button>
+          </div>
+          <div class="row">
+            <input id="setPoints" type="number" min="0" placeholder="Set" />
+            <button id="btnSet">Set Points</button>
+          </div>
+          <div class="row">
+            <button id="btnRefresh">Refresh</button>
+          </div>
+        </div>
+
+        <div class="kv">
+          <div class="k">Member ID (QR)</div>
+          <div class="v" id="memberId">—</div>
+
+          <div class="k">Customer</div>
+          <div class="v" id="customerName">—</div>
+
+          <div class="k">Card ID</div>
+          <div class="v" id="cardId">—</div>
+
+          <div class="k">Save URL</div>
+          <div class="v"><a id="saveUrl" href="#" target="_blank" rel="noreferrer">—</a></div>
+
+          <div class="k">Locations</div>
+          <div class="v" id="locations">—</div>
+        </div>
+
+        <p class="muted" style="margin-top: 14px;">
+          Tip: after you add the card once, click +/- to update points. The server upserts the Google Wallet object when creds exist.
+        </p>
+        <p id="error" class="muted danger" style="display:none;"></p>
+      </div>
+    </div>
+
+    <script>
+      const el = id => document.getElementById(id)
+      const setText = (id, v) => (el(id).textContent = v ?? '—')
+      const setError = msg => {
+        const e = el('error')
+        if (!msg) {
+          e.style.display = 'none'
+          e.textContent = ''
+          return
+        }
+        e.style.display = 'block'
+        e.textContent = msg
+      }
+
+      async function api(path, opts) {
+        const res = await fetch(path, {
+          headers: { 'content-type': 'application/json' },
+          ...opts
+        })
+        const body = await res.json().catch(() => ({}))
+        if (!res.ok) {
+          throw new Error(body?.error || `Request failed: ${res.status}`)
+        }
+        return body
+      }
+
+      function render(state) {
+        setError('')
+        setText('status', state?.card?.status || '—')
+        setText('points', state?.card?.points ?? '0')
+        setText('memberId', state?.customer?.memberId)
+        setText('customerName', state?.customer?.fullName)
+        setText('cardId', state?.card?.id)
+        const url = state?.saveUrl || ''
+        const a = el('saveUrl')
+        a.textContent = url || '—'
+        a.href = url || '#'
+
+        const loc = state?.program?.metadata?.googleWallet?.locations
+        if (Array.isArray(loc) && loc.length) {
+          el('locations').textContent = loc.map(p => `${p.latitude},${p.longitude}`).join(' | ')
+        } else {
+          el('locations').textContent = '—'
+        }
+      }
+
+      async function refresh() {
+        const s = await api('/state')
+        render(s)
+      }
+
+      async function init() {
+        const s = await api('/init', { method: 'POST', body: '{}' })
+        render(s)
+      }
+
+      async function deltaPoints(delta) {
+        const s = await api('/points', {
+          method: 'POST',
+          body: JSON.stringify({ delta })
+        })
+        render(s)
+      }
+
+      async function setPoints(setPoints) {
+        const s = await api('/points', {
+          method: 'POST',
+          body: JSON.stringify({ setPoints })
+        })
+        render(s)
+      }
+
+      document.querySelectorAll('button[data-delta]').forEach(btn => {
+        btn.addEventListener('click', async () => {
+          try {
+            const delta = Number(btn.getAttribute('data-delta'))
+            await deltaPoints(delta)
+          } catch (e) {
+            setError(e.message)
+          }
+        })
+      })
+
+      el('btnSet').addEventListener('click', async () => {
+        try {
+          const v = Number(el('setPoints').value)
+          if (!Number.isFinite(v) || v < 0) throw new Error('Enter a non-negative number')
+          await setPoints(v)
+        } catch (e) {
+          setError(e.message)
+        }
+      })
+
+      el('btnRefresh').addEventListener('click', async () => {
+        try {
+          await refresh()
+        } catch (e) {
+          setError(e.message)
+        }
+      })
+
+      el('btnInit').addEventListener('click', async () => {
+        try {
+          await init()
+        } catch (e) {
+          setError(e.message)
+        }
+      })
+
+      // initial load
+      refresh().catch(() => init().catch(e => setError(e.message)))
+    </script>
+  </body>
+</html>