dink-pets-shared 1.0.0

package/dist/src/theme.js

@@ -0,0 +1,343 @@
+// =============================================================================
+// SHARED THEME CONFIGURATION
+// =============================================================================
+// Single source of truth for colors across mobile and web.
+//
+// How it works:
+// 1. This file defines all colors as hex values
+// 2. Build script generates mobile/global.css with CSS variables
+// 3. Web layout.tsx generates CSS variables dynamically
+// 4. Components use `tw` tokens - never raw color names
+// =============================================================================
+import { activityTypes } from "./enums.js";
+// =============================================================================
+// TAILWIND COLOR PALETTE
+// =============================================================================
+// Subset of Tailwind's default colors that we use.
+// https://tailwindcss.com/docs/customizing-colors
+export const palette = {
+    white: "#ffffff",
+    black: "#000000",
+    gray: {
+        100: "#f3f4f6",
+        200: "#e5e7eb",
+        400: "#9ca3af",
+        500: "#6b7280",
+        600: "#4b5563",
+        700: "#374151",
+        800: "#1f2937",
+        900: "#111827",
+    },
+    purple: {
+        100: "#f3e8ff",
+        300: "#d8b4fe",
+        400: "#a78bfa",
+        500: "#8b5cf6",
+        600: "#7c3aed",
+        900: "#4c1d95",
+    },
+    pink: {
+        300: "#f9a8d4",
+        500: "#ec4899",
+        900: "#831843",
+    },
+    orange: {
+        300: "#fdba74",
+        500: "#f97316",
+    },
+    green: {
+        500: "#22c55e",
+    },
+    red: {
+        500: "#ef4444",
+    },
+    yellow: {
+        400: "#facc15",
+        500: "#eab308",
+    },
+    blue: {
+        500: "#3b82f6",
+    },
+    amber: {
+        500: "#f59e0b",
+    },
+    cyan: {
+        500: "#06b6d4",
+    },
+    teal: {
+        500: "#14b8a6",
+    },
+    indigo: {
+        500: "#6366f1",
+    },
+};
+// =============================================================================
+// SEMANTIC COLORS
+// =============================================================================
+// Map UI concepts to palette colors for light and dark modes.
+export const semantic = {
+    light: {
+        // Backgrounds
+        background: palette.white,
+        backgroundSubtle: palette.gray[100],
+        card: palette.white,
+        // Gradients
+        gradientFrom: palette.purple[400],
+        gradientVia: palette.pink[300],
+        gradientTo: palette.orange[300],
+        // Text
+        textPrimary: palette.gray[800],
+        textSecondary: palette.gray[500],
+        textMuted: palette.gray[400],
+        textInverse: palette.white,
+        textOnGradient: palette.white,
+        // Accents
+        accentPrimary: palette.purple[600],
+        accentSecondary: palette.pink[500],
+        // Semantic states
+        success: palette.green[500],
+        destructive: palette.red[500],
+        destructiveSubtle: "#fef2f2", // red-50
+        // Borders
+        border: palette.gray[200],
+        borderStrong: palette.gray[400],
+        // Interactive
+        buttonPrimary: palette.purple[600],
+        buttonPrimaryText: palette.white,
+        buttonSecondary: palette.white,
+        buttonSecondaryText: palette.purple[600],
+        // Pressed/active states (10% opacity overlays)
+        pressedOverlay: "rgba(0,0,0,0.1)",
+        // Avatar fallback gradient (subtle purple to pink)
+        avatarGradientFrom: "rgba(167, 139, 250, 0.25)", // purple-400/25
+        avatarGradientTo: "rgba(249, 168, 212, 0.25)", // pink-300/25
+    },
+    dark: {
+        // Backgrounds
+        background: palette.gray[900],
+        backgroundSubtle: palette.gray[800],
+        card: "#252033", // Purple-tinted dark that complements the gradient
+        // Gradients
+        gradientFrom: palette.gray[900],
+        gradientVia: palette.purple[900],
+        gradientTo: palette.pink[900],
+        // Text
+        textPrimary: palette.gray[200],
+        textSecondary: palette.gray[400],
+        textMuted: palette.gray[500],
+        textInverse: palette.gray[900],
+        textOnGradient: palette.gray[200],
+        // Accents
+        accentPrimary: palette.purple[400],
+        accentSecondary: palette.pink[500],
+        // Semantic states
+        success: palette.green[500],
+        destructive: palette.red[500],
+        destructiveSubtle: "#450a0a", // red-950
+        // Borders
+        border: palette.gray[600],
+        borderStrong: palette.gray[400],
+        // Interactive
+        buttonPrimary: palette.purple[500],
+        buttonPrimaryText: palette.white,
+        buttonSecondary: palette.gray[800],
+        buttonSecondaryText: palette.purple[400],
+        // Pressed/active states (10% opacity overlays)
+        pressedOverlay: "rgba(255,255,255,0.1)",
+        // Avatar fallback gradient (subtle purple to pink)
+        avatarGradientFrom: "rgba(139, 92, 246, 0.15)", // purple-500/15
+        avatarGradientTo: "rgba(236, 72, 153, 0.15)", // pink-500/15
+    },
+};
+// =============================================================================
+// ACTIVITY TYPE COLORS
+// =============================================================================
+// Colors for each ActivityType enum value. These don't change between light/dark.
+export const activityTypeColors = {
+    WALK: palette.green[500],
+    MEAL: palette.orange[500],
+    BATHROOM: palette.amber[500],
+    TREAT: palette.yellow[400],
+    PLAYTIME: palette.cyan[500],
+    MEDICATION: palette.indigo[500],
+    VET_APPOINTMENT: palette.red[500],
+    GROOMING: palette.pink[500],
+    BATH: palette.teal[500],
+    NAIL_TRIM: palette.purple[300],
+};
+// =============================================================================
+// APP SECTION COLORS
+// =============================================================================
+// Colors for app UI sections (not activity types).
+export const appSections = ["achievements", "photos", "schedule"];
+export const appSectionColors = {
+    achievements: palette.yellow[500],
+    photos: palette.purple[500],
+    schedule: palette.blue[500],
+};
+// =============================================================================
+// CSS VARIABLES
+// =============================================================================
+// Used to generate CSS for both platforms.
+// Keys become CSS variable names (e.g., --color-card).
+export const cssVariables = {
+    light: {
+        "--color-background": semantic.light.background,
+        "--color-background-subtle": semantic.light.backgroundSubtle,
+        "--color-card": semantic.light.card,
+        "--color-gradient-from": semantic.light.gradientFrom,
+        "--color-gradient-via": semantic.light.gradientVia,
+        "--color-gradient-to": semantic.light.gradientTo,
+        "--color-text-primary": semantic.light.textPrimary,
+        "--color-text-secondary": semantic.light.textSecondary,
+        "--color-text-muted": semantic.light.textMuted,
+        "--color-text-inverse": semantic.light.textInverse,
+        "--color-text-on-gradient": semantic.light.textOnGradient,
+        "--color-accent-primary": semantic.light.accentPrimary,
+        "--color-accent-secondary": semantic.light.accentSecondary,
+        "--color-destructive": semantic.light.destructive,
+        "--color-destructive-subtle": semantic.light.destructiveSubtle,
+        "--color-border": semantic.light.border,
+        "--color-border-strong": semantic.light.borderStrong,
+        "--color-button-primary": semantic.light.buttonPrimary,
+        "--color-button-primary-text": semantic.light.buttonPrimaryText,
+        "--color-button-secondary": semantic.light.buttonSecondary,
+        "--color-button-secondary-text": semantic.light.buttonSecondaryText,
+    },
+    dark: {
+        "--color-background": semantic.dark.background,
+        "--color-background-subtle": semantic.dark.backgroundSubtle,
+        "--color-card": semantic.dark.card,
+        "--color-gradient-from": semantic.dark.gradientFrom,
+        "--color-gradient-via": semantic.dark.gradientVia,
+        "--color-gradient-to": semantic.dark.gradientTo,
+        "--color-text-primary": semantic.dark.textPrimary,
+        "--color-text-secondary": semantic.dark.textSecondary,
+        "--color-text-muted": semantic.dark.textMuted,
+        "--color-text-inverse": semantic.dark.textInverse,
+        "--color-text-on-gradient": semantic.dark.textOnGradient,
+        "--color-accent-primary": semantic.dark.accentPrimary,
+        "--color-accent-secondary": semantic.dark.accentSecondary,
+        "--color-destructive": semantic.dark.destructive,
+        "--color-destructive-subtle": semantic.dark.destructiveSubtle,
+        "--color-border": semantic.dark.border,
+        "--color-border-strong": semantic.dark.borderStrong,
+        "--color-button-primary": semantic.dark.buttonPrimary,
+        "--color-button-primary-text": semantic.dark.buttonPrimaryText,
+        "--color-button-secondary": semantic.dark.buttonSecondary,
+        "--color-button-secondary-text": semantic.dark.buttonSecondaryText,
+    },
+};
+// =============================================================================
+// TAILWIND EXTEND COLORS
+// =============================================================================
+// For Tailwind config - maps class names to CSS variables.
+/**
+ * Build a Record with prefixed keys from a readonly array.
+ * TypeScript can't infer template literal key types from Object.fromEntries,
+ * so this utility provides proper generic constraints.
+ */
+function buildPrefixedRecord(prefix, keys, valueFn) {
+    const result = {};
+    for (const key of keys) {
+        result[`${prefix}${key}`] = valueFn(key);
+    }
+    return result;
+}
+// Generate activity type color entries: { "activity-WALK": "#hex", ... }
+const activityColorEntries = buildPrefixedRecord("activity-", activityTypes, (type) => activityTypeColors[type]);
+// Generate app section color entries: { "section-achievements": "#hex", ... }
+const sectionColorEntries = buildPrefixedRecord("section-", appSections, (section) => appSectionColors[section]);
+export const extendColors = {
+    // Semantic colors (use CSS variables for dark mode)
+    background: "var(--color-background)",
+    "background-subtle": "var(--color-background-subtle)",
+    card: "var(--color-card)",
+    "text-primary": "var(--color-text-primary)",
+    "text-secondary": "var(--color-text-secondary)",
+    "text-muted": "var(--color-text-muted)",
+    "text-inverse": "var(--color-text-inverse)",
+    "text-on-gradient": "var(--color-text-on-gradient)",
+    "accent-primary": "var(--color-accent-primary)",
+    "accent-secondary": "var(--color-accent-secondary)",
+    destructive: "var(--color-destructive)",
+    "destructive-subtle": "var(--color-destructive-subtle)",
+    border: "var(--color-border)",
+    "border-strong": "var(--color-border-strong)",
+    "button-primary": "var(--color-button-primary)",
+    "button-primary-text": "var(--color-button-primary-text)",
+    "button-secondary": "var(--color-button-secondary)",
+    "button-secondary-text": "var(--color-button-secondary-text)",
+    // Activity type colors (static, same in light/dark)
+    ...activityColorEntries,
+    // App section colors
+    ...sectionColorEntries,
+};
+// =============================================================================
+// TW - COMPONENT CLASS TOKENS
+// =============================================================================
+// Import these in components instead of writing raw Tailwind classes.
+// This ensures consistency and makes refactoring easy.
+//
+// Usage:
+//   import { tw } from "dink-pets-shared";
+//   <View className={tw.card}>
+//   <Text className={tw.textPrimary}>
+// =============================================================================
+// Helper: Convert SCREAMING_SNAKE to PascalCase (e.g., VET_APPOINTMENT -> VetAppointment)
+const toPascalCase = (str) => str.toLowerCase().replace(/(^|_)(\w)/g, (_, __, c) => c.toUpperCase());
+// Generate tw tokens for activity types: { activityWalk: "bg-...", textActivityWalk: "text-..." }
+const twActivityColors = Object.fromEntries(activityTypes.flatMap((type) => {
+    const pascal = toPascalCase(type);
+    return [
+        [`activity${pascal}`, `bg-activity-${type}`],
+        [`textActivity${pascal}`, `text-activity-${type}`],
+    ];
+}));
+// Generate tw tokens for app sections: { sectionAchievements: "bg-...", textSectionAchievements: "text-..." }
+const twSectionColors = Object.fromEntries(appSections.flatMap((section) => {
+    const pascal = section.charAt(0).toUpperCase() + section.slice(1);
+    return [
+        [`section${pascal}`, `bg-section-${section}`],
+        [`textSection${pascal}`, `text-section-${section}`],
+    ];
+}));
+export const tw = {
+    // Backgrounds
+    background: "bg-background",
+    backgroundSubtle: "bg-background-subtle",
+    card: "bg-card rounded-xl",
+    cardPadded: "bg-card rounded-xl p-4",
+    // Text
+    textPrimary: "text-text-primary",
+    textSecondary: "text-text-secondary",
+    textMuted: "text-text-muted",
+    textInverse: "text-text-inverse",
+    textOnGradient: "text-text-on-gradient",
+    // Headings
+    heading: "text-text-primary text-2xl font-bold",
+    subheading: "text-text-primary text-xl font-semibold",
+    title: "text-text-primary text-3xl font-bold",
+    // Accents
+    accentPrimary: "text-accent-primary",
+    accentSecondary: "text-accent-secondary",
+    bgAccentPrimary: "bg-accent-primary",
+    bgAccentSecondary: "bg-accent-secondary",
+    // Buttons
+    buttonPrimary: "bg-button-primary text-button-primary-text px-6 py-3 rounded-full font-semibold",
+    buttonSecondary: "bg-button-secondary text-button-secondary-text px-6 py-3 rounded-full font-semibold border border-accent-primary",
+    // Gradient background (for main screens)
+    gradientBg: "bg-gradient-to-br from-[var(--color-gradient-from)] via-[var(--color-gradient-via)] to-[var(--color-gradient-to)]",
+    // Activity type background and text colors (generated from activityTypes)
+    ...twActivityColors,
+    // App section background and text colors (generated from appSections)
+    ...twSectionColors,
+    // Layout utilities
+    screenCenter: "flex-1 items-center justify-center",
+    container: "flex-1 p-6",
+    // Web-specific layout
+    pageCenter: "flex min-h-screen flex-col items-center justify-center",
+    pageContent: "flex min-h-screen flex-col items-center justify-center gap-8 p-8",
+    // Store download buttons
+    storeButton: "rounded-lg bg-accent-primary px-6 py-3 text-text-inverse hover:opacity-90",
+};

package/dist/src/updates.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { PetId, UserId } from "./ids.js";
+export declare const UpdatePayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"PET_ACCESS_GRANTED">;
+    data: z.ZodObject<{
+        petId: z.ZodPipe<z.ZodString, z.ZodCustom<PetId, PetId>>;
+        petName: z.ZodString;
+        addedById: z.ZodPipe<z.ZodString, z.ZodCustom<UserId, UserId>>;
+        role: z.ZodEnum<{
+            OWNER: "OWNER";
+            COOWNER: "COOWNER";
+            CARETAKER: "CARETAKER";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"ACHIEVEMENT_UNLOCKED">;
+    data: z.ZodObject<{
+        petId: z.ZodPipe<z.ZodString, z.ZodCustom<PetId, PetId>>;
+        petName: z.ZodString;
+        achievementType: z.ZodEnum<{
+            FIRST_WALK: "FIRST_WALK";
+            FIRST_PHOTO: "FIRST_PHOTO";
+            DAYS_TOGETHER_30: "DAYS_TOGETHER_30";
+            DAYS_TOGETHER_100: "DAYS_TOGETHER_100";
+            DAYS_TOGETHER_365: "DAYS_TOGETHER_365";
+            WALKS_STREAK_7: "WALKS_STREAK_7";
+            WALKS_STREAK_30: "WALKS_STREAK_30";
+            MEALS_ON_TIME_7: "MEALS_ON_TIME_7";
+            WALKS_100: "WALKS_100";
+            WALKS_500: "WALKS_500";
+            PHOTOS_50: "PHOTOS_50";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"REFERRAL_ACCEPTED">;
+    data: z.ZodObject<{
+        referredUserId: z.ZodPipe<z.ZodString, z.ZodCustom<UserId, UserId>>;
+        referredUserName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strict>], "type">;
+export type UpdatePayload = z.infer<typeof UpdatePayloadSchema>;
+/**
+ * Type-safe update payload builder.
+ *
+ * Provides compile-time safety (TypeScript enforces correct data shape per type)
+ * and runtime validation (Zod parses and validates).
+ *
+ * @example
+ * createUpdatePayload("PET_ACCESS_GRANTED", { petId, petName, addedById, role })
+ */
+export declare function createUpdatePayload<T extends UpdatePayload["type"]>(type: T, data: Extract<UpdatePayload, {
+    type: T;
+}>["data"]): UpdatePayload;

package/dist/src/updates.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { AchievementType, PetRole, UpdateType } from "./enums.js";
+import { PetId, UserId } from "./ids.js";
+import { Name } from "./schemas.js";
+// Update data schemas - one per UpdateType enum value in Prisma.
+// These define the shape of the JSON stored in Update.data column.
+const PetAccessGrantedUpdate = z
+    .object({
+    type: z.literal(UpdateType.enum.PET_ACCESS_GRANTED),
+    data: z.object({
+        petId: PetId,
+        petName: Name,
+        addedById: UserId,
+        role: PetRole,
+    }),
+})
+    .strict();
+const AchievementUnlockedUpdate = z
+    .object({
+    type: z.literal(UpdateType.enum.ACHIEVEMENT_UNLOCKED),
+    data: z.object({
+        petId: PetId,
+        petName: Name,
+        achievementType: AchievementType,
+    }),
+})
+    .strict();
+const ReferralAcceptedUpdate = z
+    .object({
+    type: z.literal(UpdateType.enum.REFERRAL_ACCEPTED),
+    data: z.object({
+        referredUserId: UserId,
+        referredUserName: Name.optional(),
+    }),
+})
+    .strict();
+// =============================================================================
+// UPDATE PAYLOAD SCHEMA
+// =============================================================================
+// Discriminated union of all update types. Ensures type field matches data shape.
+// Used for validation on both server (creation) and client (consumption).
+export const UpdatePayloadSchema = z.discriminatedUnion("type", [
+    PetAccessGrantedUpdate,
+    AchievementUnlockedUpdate,
+    ReferralAcceptedUpdate,
+]);
+/**
+ * Type-safe update payload builder.
+ *
+ * Provides compile-time safety (TypeScript enforces correct data shape per type)
+ * and runtime validation (Zod parses and validates).
+ *
+ * @example
+ * createUpdatePayload("PET_ACCESS_GRANTED", { petId, petName, addedById, role })
+ */
+export function createUpdatePayload(type, data) {
+    return UpdatePayloadSchema.parse({ type, data });
+}

package/dist/src/uploads.d.ts

@@ -0,0 +1,41 @@
+/**
+ * File upload validation constants and utilities.
+ *
+ * These values must stay in sync with Supabase Storage bucket limits.
+ * Current bucket config (media): 5MB max, image/* MIME types only.
+ */
+/** Maximum file size in MB for display purposes. */
+export declare const MAX_UPLOAD_SIZE_MB = 5;
+/** Maximum file size in bytes (5MB). Must match Supabase bucket limit. */
+export declare const MAX_UPLOAD_SIZE_BYTES: number;
+/** Allowed MIME types for image uploads. Must match Supabase bucket config. */
+export declare const ALLOWED_IMAGE_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/webp", "image/heic"];
+export type AllowedImageMimeType = (typeof ALLOWED_IMAGE_MIME_TYPES)[number];
+export type UploadValidationError = {
+    type: "FILE_TOO_LARGE";
+    maxBytes: number;
+    actualBytes: number;
+} | {
+    type: "INVALID_MIME_TYPE";
+    allowed: readonly string[];
+    actual: string;
+};
+/**
+ * Validates file size is within allowed limit.
+ * @returns Error object if invalid, null if valid
+ */
+export declare function validateFileSize(sizeBytes: number): UploadValidationError | null;
+/**
+ * Validates MIME type is an allowed image type.
+ * @returns Error object if invalid, null if valid
+ */
+export declare function validateImageMimeType(mimeType: string | null | undefined): UploadValidationError | null;
+/**
+ * Validates both file size and MIME type.
+ * @returns First validation error found, or null if valid
+ */
+export declare function validateImageUpload(sizeBytes: number, mimeType: string | null | undefined): UploadValidationError | null;
+/**
+ * Formats a validation error into a user-friendly message.
+ */
+export declare function formatUploadError(error: UploadValidationError): string;

package/dist/src/uploads.js

@@ -0,0 +1,73 @@
+/**
+ * File upload validation constants and utilities.
+ *
+ * These values must stay in sync with Supabase Storage bucket limits.
+ * Current bucket config (media): 5MB max, image/* MIME types only.
+ */
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/** Maximum file size in MB for display purposes. */
+export const MAX_UPLOAD_SIZE_MB = 5;
+/** Maximum file size in bytes (5MB). Must match Supabase bucket limit. */
+export const MAX_UPLOAD_SIZE_BYTES = MAX_UPLOAD_SIZE_MB * 1024 * 1024;
+/** Allowed MIME types for image uploads. Must match Supabase bucket config. */
+export const ALLOWED_IMAGE_MIME_TYPES = [
+    "image/jpeg",
+    "image/png",
+    "image/webp",
+    "image/heic",
+];
+/**
+ * Validates file size is within allowed limit.
+ * @returns Error object if invalid, null if valid
+ */
+export function validateFileSize(sizeBytes) {
+    if (sizeBytes > MAX_UPLOAD_SIZE_BYTES) {
+        return {
+            type: "FILE_TOO_LARGE",
+            maxBytes: MAX_UPLOAD_SIZE_BYTES,
+            actualBytes: sizeBytes,
+        };
+    }
+    return null;
+}
+/**
+ * Validates MIME type is an allowed image type.
+ * @returns Error object if invalid, null if valid
+ */
+export function validateImageMimeType(mimeType) {
+    if (!mimeType || !ALLOWED_IMAGE_MIME_TYPES.some((t) => t === mimeType)) {
+        return {
+            type: "INVALID_MIME_TYPE",
+            allowed: ALLOWED_IMAGE_MIME_TYPES,
+            actual: mimeType ?? "unknown",
+        };
+    }
+    return null;
+}
+/**
+ * Validates both file size and MIME type.
+ * @returns First validation error found, or null if valid
+ */
+export function validateImageUpload(sizeBytes, mimeType) {
+    return validateFileSize(sizeBytes) ?? validateImageMimeType(mimeType);
+}
+/**
+ * Formats a validation error into a user-friendly message.
+ */
+export function formatUploadError(error) {
+    switch (error.type) {
+        case "FILE_TOO_LARGE": {
+            const actualMB = (error.actualBytes / (1024 * 1024)).toFixed(1);
+            return `File too large. Yours is ${actualMB}MB, max is ${MAX_UPLOAD_SIZE_MB}MB.`;
+        }
+        case "INVALID_MIME_TYPE": {
+            // Show friendly type names instead of MIME types
+            const friendlyTypes = error.allowed
+                .map((t) => t.replace("image/", "").toUpperCase())
+                .join(", ");
+            return `Unsupported file type. Allowed: ${friendlyTypes}.`;
+        }
+    }
+}

package/dist/src/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Use in the default case of a switch statement to get a compile-time error
+ * if you forget to handle a case.
+ *
+ * How it works: If all cases are handled, the default branch is unreachable
+ * and the value is inferred as `never`. If you add a new case to the union
+ * but don't handle it, TypeScript errors because the value isn't `never`.
+ *
+ * @example
+ * type Event = "created" | "updated" | "deleted";
+ *
+ * switch (event) {
+ *     case "created": ... break;
+ *     case "updated": ... break;
+ *     // Forgot "deleted" - TypeScript error at exhaustiveSwitch(event)
+ *     default:
+ *         exhaustiveSwitch(event);
+ * }
+ */
+export declare function exhaustiveSwitch(value: never): never;

package/dist/src/utils.js

@@ -0,0 +1,22 @@
+/**
+ * Use in the default case of a switch statement to get a compile-time error
+ * if you forget to handle a case.
+ *
+ * How it works: If all cases are handled, the default branch is unreachable
+ * and the value is inferred as `never`. If you add a new case to the union
+ * but don't handle it, TypeScript errors because the value isn't `never`.
+ *
+ * @example
+ * type Event = "created" | "updated" | "deleted";
+ *
+ * switch (event) {
+ *     case "created": ... break;
+ *     case "updated": ... break;
+ *     // Forgot "deleted" - TypeScript error at exhaustiveSwitch(event)
+ *     default:
+ *         exhaustiveSwitch(event);
+ * }
+ */
+export function exhaustiveSwitch(value) {
+    throw new Error(`Unhandled switch case: ${value}`);
+}

package/dist/src/web-routes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Web routes and URLs - single source of truth for both mobile and web.
+ */
+export declare const WEBAPP_BASE_URL = "https://app.dinkpets.app";
+/** Path segments (without leading slash for flexibility) */
+export declare const webPaths: {
+    readonly about: "about";
+    readonly help: "help";
+    readonly faq: "faq";
+    readonly terms: "terms";
+    readonly privacy: "privacy";
+    readonly download: "download";
+};
+/** Full URLs for external linking */
+export declare const webUrls: {
+    readonly about: "https://app.dinkpets.app/about";
+    readonly help: "https://app.dinkpets.app/help";
+    readonly faq: "https://app.dinkpets.app/faq";
+    readonly terms: "https://app.dinkpets.app/terms";
+    readonly privacy: "https://app.dinkpets.app/privacy";
+    readonly download: "https://app.dinkpets.app/download";
+};
+/** Email addresses (raw, without display names) */
+export declare const emails: {
+    readonly support: "support@dinkpets.app";
+    readonly noReply: "noreply@dinkpets.app";
+    readonly hello: "hello@dinkpets.app";
+};

package/dist/src/web-routes.js

@@ -0,0 +1,28 @@
+/**
+ * Web routes and URLs - single source of truth for both mobile and web.
+ */
+export const WEBAPP_BASE_URL = "https://app.dinkpets.app";
+/** Path segments (without leading slash for flexibility) */
+export const webPaths = {
+    about: "about",
+    help: "help",
+    faq: "faq",
+    terms: "terms",
+    privacy: "privacy",
+    download: "download",
+};
+/** Full URLs for external linking */
+export const webUrls = {
+    about: `${WEBAPP_BASE_URL}/${webPaths.about}`,
+    help: `${WEBAPP_BASE_URL}/${webPaths.help}`,
+    faq: `${WEBAPP_BASE_URL}/${webPaths.faq}`,
+    terms: `${WEBAPP_BASE_URL}/${webPaths.terms}`,
+    privacy: `${WEBAPP_BASE_URL}/${webPaths.privacy}`,
+    download: `${WEBAPP_BASE_URL}/${webPaths.download}`,
+};
+/** Email addresses (raw, without display names) */
+export const emails = {
+    support: "support@dinkpets.app",
+    noReply: "noreply@dinkpets.app",
+    hello: "hello@dinkpets.app",
+};