@playbasis-ai/qwikcard-sdk 2.3.4

package/src/theme/tokens.ts

@@ -0,0 +1,68 @@
+export interface ColorTokens {
+  primary: string;
+  secondary: string;
+  background: string;
+  surface: string;
+  text: {
+    primary: string;
+    secondary: string;
+    onPrimary: string;
+  };
+  gradients: {
+    sunset: [string, string, string, string];
+    card: [string, string, string];
+    button: [string, string];
+    glass: [string, string];
+  };
+}
+
+export interface QwikTheme {
+  colors: ColorTokens;
+  spacing: {
+    xs: number;
+    s: number;
+    m: number;
+    l: number;
+    xl: number;
+  };
+  borderRadius: {
+    s: number;
+    m: number;
+    l: number;
+    xl: number;
+  };
+}
+
+export const qwikTheme: QwikTheme = {
+  colors: {
+    primary: '#FF4500', // OrangeRed
+    secondary: '#FFD4C8', // Pale Coral
+    background: '#0F1419', // Deep dark
+    surface: 'rgba(255, 255, 255, 0.08)',
+    text: {
+      primary: '#FFFFFF',
+      secondary: '#94A3B8',
+      onPrimary: '#FFFFFF',
+    },
+    gradients: {
+      // Smoother sunset: Pink -> Orange -> Gold -> Purple
+      sunset: ['#FF69B4', '#FF8C00', '#FFD700', '#DA70D6'],
+      card: ['rgba(255, 255, 255, 0.1)', 'rgba(255, 255, 255, 0.05)', 'rgba(255, 255, 255, 0)'],
+      button: ['#FF4500', '#FF69B4'],
+      glass: ['rgba(255, 255, 255, 0.15)', 'rgba(255, 255, 255, 0.05)'],
+    },
+  },
+  spacing: {
+    xs: 4,
+    s: 8,
+    m: 16,
+    l: 24,
+    xl: 32,
+  },
+  borderRadius: {
+    s: 8,
+    m: 12,
+    l: 16,
+    xl: 24,
+  },
+};

package/src/types/index.ts

@@ -0,0 +1,176 @@
+/**
+ * TypeScript types for QwikCard SDK
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Core Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface Player {
+  id: string;
+  displayName: string;
+  email?: string;
+  metadata?: PlayerMetadata;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface PlayerMetadata {
+  externalId?: string; // QwikCard users.id
+  qwikTag?: string; // @handle
+  collegeName?: string;
+  qwikGoals?: string[];
+  workStatus?: string;
+  [key: string]: unknown;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Points & Currency
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface PointBalance {
+  currency: string;
+  balance: number;
+  updatedAt: string;
+}
+
+export type Currency = 'xp' | 'coins';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Quests
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface Quest {
+  id: string;
+  name: string;
+  description: string;
+  status: QuestStatus;
+  progress: number;
+  target: number;
+  rewards: QuestReward[];
+  expiresAt?: string;
+  completedAt?: string;
+}
+
+export type QuestStatus = 'not_started' | 'in_progress' | 'completed' | 'expired';
+
+export interface QuestReward {
+  type: 'points' | 'badge' | 'reward';
+  currency?: string;
+  amount?: number;
+  badgeId?: string;
+  rewardId?: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Badges
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface Badge {
+  id: string;
+  name: string;
+  description: string;
+  imageUrl?: string;
+  earnedAt?: string;
+  isEarned: boolean;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Rewards
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface Reward {
+  id: string;
+  name: string;
+  description: string;
+  imageUrl?: string;
+  cost: number;
+  currency: string;
+  available: boolean;
+  expiresAt?: string;
+}
+
+export interface RedemptionResult {
+  success: boolean;
+  redemptionId?: string;
+  code?: string;
+  message?: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Leaderboard
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface LeaderboardEntry {
+  playerId: string;
+  displayName: string;
+  rank: number;
+  score: number;
+  metadata?: PlayerMetadata;
+}
+
+export interface PlayerRank {
+  playerId: string;
+  rank: number;
+  score: number;
+  above: LeaderboardEntry[];
+  below: LeaderboardEntry[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Events (QwikCard-specific)
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type QwikCardEventType =
+  | 'card.purchase'
+  | 'card.deposit'
+  | 'card.atm'
+  | 'qwikit.sent'
+  | 'qwikit.received'
+  | 'referral.signup'
+  | 'profile.complete';
+
+export interface TrackEventInput {
+  type: QwikCardEventType;
+  playerId: string;
+  referenceId?: string;
+  data?: Record<string, unknown>;
+}
+
+export interface CardPurchaseData {
+  i2cTransId: string;
+  amount: number;
+  mcc?: string;
+  category?: string;
+  merchant?: string;
+}
+
+export interface QwikItData {
+  recipientPlayerId: string;
+  amount: number;
+  senderQwikTag?: string;
+  recipientQwikTag?: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// API Response Types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface ApiResponse<T> {
+  success: boolean;
+  data?: T;
+  error?: ApiError;
+}
+
+export interface ApiError {
+  code: string;
+  message: string;
+  details?: Record<string, unknown>;
+}
+
+export interface PaginatedResponse<T> {
+  items: T[];
+  total: number;
+  cursor?: string;
+  hasMore: boolean;
+}

package/src/web/widgetAssets.d.ts

@@ -0,0 +1,3 @@
+export declare const WIDGET_SDK_VERSION = "0.0.14";
+export declare const WIDGET_UMD_JS: string;
+export declare const WIDGET_CSS: string;