Release/2.0.26

.github/scripts/configure-deps.ts

@@ -24,6 +24,10 @@ function isCI(): boolean {
   );
 }
 
+function isCFPages(): boolean {
+  return process.env.CF_PAGES === '1';
+}
+
 function printLocalFix(): void {
   console.error(`\n❌ ${TOKEN_VAR} is not exported in your shell.`);
   console.error('\nBun reads bunfig.toml before the preinstall hook runs, so the token');
@@ -47,8 +51,18 @@ async function configureDeps() {
   }
 
   if (isCI()) {
-    console.error(`❌ ${TOKEN_VAR} not found in CI environment`);
-    console.error(`Set ${TOKEN_VAR} in your CI secrets and expose it to this job.`);
+    if (isCFPages()) {
+      console.error(`❌ ${TOKEN_VAR} not found in Cloudflare Pages build environment.`);
+      console.error('Add it as an environment variable in the CF Pages project settings:');
+      console.error(
+        '  dash.cloudflare.com → Pages → packrat-guides → Settings → Environment variables',
+      );
+      console.error(`  Variable name: ${TOKEN_VAR}`);
+      console.error('  Value: a GitHub PAT with read:packages scope');
+    } else {
+      console.error(`❌ ${TOKEN_VAR} not found in CI environment`);
+      console.error(`Set ${TOKEN_VAR} in your CI secrets and expose it to this job.`);
+    }
     process.exit(1);
   }
 

.github/workflows/api-tests.yml

@@ -30,12 +30,11 @@ jobs:
       - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
 
       - name: Install dependencies
         env:
           PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Run API tests
         run: bun run --cwd packages/api test 2>&1 | tee /tmp/api-tests-output.log

.github/workflows/checks.yml

@@ -27,11 +27,10 @@ jobs:
       - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
       - name: Install dependencies
         env:
           PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
-        run: bun install
+        run: bun install --frozen-lockfile
       - name: Run Biome (check mode)
         if: ${{ !(github.event_name == 'workflow_dispatch' && inputs.fix == true) }}
         run: bun biome check

.github/workflows/copilot-setup-steps.yml

@@ -66,7 +66,6 @@ jobs:
         uses: oven-sh/setup-bun@v2
         with:
           bun-version: ${{ steps.bun-version.outputs.version }}
-          cache: true
 
       # Sanity-check that the runner satisfies the repo's engine constraints.
       - name: Verify runtime versions

.github/workflows/e2e-tests.yml

@@ -84,7 +84,7 @@ jobs:
       - name: Install dependencies
         env:
           PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Setup Expo
         uses: expo/expo-github-action@v8
@@ -343,7 +343,7 @@ jobs:
       - name: Install dependencies
         env:
           PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Setup Expo
         uses: expo/expo-github-action@v8

.github/workflows/lighthouse.yml

@@ -29,7 +29,6 @@ jobs:
       - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
 
       - name: Install dependencies
         env:
@@ -60,7 +59,6 @@ jobs:
       - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
 
       - name: Install dependencies
         env:

.github/workflows/migrations.yml

@@ -39,12 +39,11 @@ jobs:
         uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
 
       - name: Install dependencies
         env:
           PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Determine target environment
         id: env

.github/workflows/release-ios.yml

@@ -47,7 +47,6 @@ jobs:
         uses: oven-sh/setup-bun@v2
         with:
           bun-version: 1.3.10
-          cache: true
 
       - name: Validate release tag and app versions
         run: bun .github/scripts/validate-release-version.ts "${{ steps.release_tag.outputs.tag }}"

.github/workflows/sync-guides-r2.yml

@@ -32,14 +32,13 @@ jobs:
         uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
 
       - name: Authenticate with GitHub for private packages
         run: |
           echo "PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN=${{ secrets.GITHUB_TOKEN }}" >> $GITHUB_ENV
 
       - name: Install dependencies
-        run: bun install
+        run: bun install --frozen-lockfile
         timeout-minutes: 5
 
       - name: Sync guides to R2 bucket

.github/workflows/unit-tests.yml

@@ -50,12 +50,11 @@ jobs:
       - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
 
       - name: Install dependencies
         env:
           PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Run API unit tests
         run: bun run --cwd packages/api test:unit:coverage
@@ -80,12 +79,11 @@ jobs:
       - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
 
       - name: Install dependencies
         env:
           PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Run Expo unit tests
         run: bun run --cwd apps/expo test:coverage

.gitignore

@@ -41,6 +41,11 @@ report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
 .claude/scheduled_tasks.lock
 .dev.vars
 
+# Generated OG images (produced at build time by scripts/generate-og-images.ts)
+apps/landing/public/og-image.png
+apps/guides/public/og-image.png
+apps/guides/public/og/
+
 # Git worktrees
 .worktrees/
 .worktrees

apps/admin/components/edit-catalog-dialog.tsx

@@ -49,7 +49,7 @@ export function EditCatalogDialog({ item }: EditCatalogDialogProps) {
       : null;
     const weightRaw = fd.get('weight')?.toString().trim();
     const weight = weightRaw ? Number(weightRaw) : undefined;
-    const weightUnit = fd.get('weightUnit')?.toString().trim() || item.weightUnit;
+    const weightUnit = fd.get('weightUnit')?.toString().trim() || item.weightUnit || undefined;
     const priceRaw = fd.get('price')?.toString().trim();
     const price = priceRaw ? Number(priceRaw) : null;
 
@@ -108,7 +108,7 @@ export function EditCatalogDialog({ item }: EditCatalogDialogProps) {
               <Input
                 id="weightUnit"
                 name="weightUnit"
-                defaultValue={item.weightUnit}
+                defaultValue={item.weightUnit ?? ''}
                 placeholder="g"
               />
             </div>

apps/admin/lib/api.ts

@@ -3,10 +3,15 @@ import type { App } from '@packrat/api';
 import type {
   ActiveUsersSchema,
   ActivityPointSchema,
+  AdminCatalogItemSchema,
+  AdminPackItemSchema,
+  AdminUserItemSchema,
   BrandRowSchema,
   BreakdownItemSchema,
   CatalogOverviewSchema,
   EmbeddingStatsSchema,
+  EtlFailureSummarySchema,
+  EtlJobFailuresSchema,
   EtlJobSchema,
   EtlResponseSchema,
   GrowthPointSchema,
@@ -69,17 +74,7 @@ export async function getStats(): Promise<AdminStats> {
 
 // ─── Users ────────────────────────────────────────────────────────────────────
 
-export interface AdminUser {
-  id: number;
-  email: string;
-  firstName: string | null;
-  lastName: string | null;
-  role: string | null;
-  emailVerified: boolean | null;
-  avatarUrl: string | null;
-  createdAt: string | null;
-  updatedAt: string | null;
-}
+export type AdminUser = Static<typeof AdminUserItemSchema>;
 
 export interface PaginatedResponse<T> {
   data: T[];
@@ -106,42 +101,30 @@ export async function getUsers({
   return unwrap(data, 'users');
 }
 
-export async function deleteUser(id: number): Promise<{ success: boolean }> {
-  const { data, error } = await adminClient.users({ id: String(id) }).delete();
+export async function deleteUser(id: string): Promise<{ success: boolean }> {
+  const { data, error } = await adminClient.users({ id }).delete();
   if (error) throwOnError(error);
   return unwrap(data, 'deleteUser');
 }
 
 export async function hardDeleteUser(
-  id: number,
+  id: string,
   reason: string,
 ): Promise<{ success: boolean; purged: boolean }> {
-  const { data, error } = await adminClient.users({ id: String(id) }).hard.delete({ reason });
+  const { data, error } = await adminClient.users({ id }).hard.delete({ reason });
   if (error) throwOnError(error);
   return unwrap(data, 'hardDeleteUser');
 }
 
-export async function restoreUser(id: number): Promise<{ success: boolean }> {
-  const { data, error } = await adminClient.users({ id: String(id) }).restore.post();
+export async function restoreUser(id: string): Promise<{ success: boolean }> {
+  const { data, error } = await adminClient.users({ id }).restore.post();
   if (error) throwOnError(error);
   return unwrap(data, 'restoreUser');
 }
 
 // ─── Packs ────────────────────────────────────────────────────────────────────
 
-export interface AdminPack {
-  id: string;
-  name: string;
-  description: string | null;
-  category: string;
-  isPublic: boolean | null;
-  isAIGenerated: boolean;
-  tags: string[] | null;
-  image: string | null;
-  createdAt: string | null;
-  updatedAt: string | null;
-  userEmail: string | null;
-}
+export type AdminPack = Static<typeof AdminPackItemSchema>;
 
 export async function getPacks({
   limit = 100,
@@ -169,32 +152,7 @@ export async function deletePack(id: string): Promise<{ success: boolean }> {
 
 // ─── Catalog Items ────────────────────────────────────────────────────────────
 
-export interface AdminCatalogItem {
-  id: number;
-  name: string;
-  description: string | null;
-  categories: string[] | null;
-  brand: string | null;
-  model: string | null;
-  sku: string | null;
-  price: number | null;
-  currency: string | null;
-  weight: number | null;
-  weightUnit: string;
-  availability: string | null;
-  ratingValue: number | null;
-  reviewCount: number | null;
-  color: string | null;
-  size: string | null;
-  material: string | null;
-  seller: string | null;
-  productUrl: string | null;
-  images: string[] | null;
-  variants: Array<{ attribute: string; values: string[] }> | null;
-  techs: Record<string, string> | null;
-  links: Array<{ title: string; url: string }> | null;
-  createdAt: string | null;
-}
+export type AdminCatalogItem = Static<typeof AdminCatalogItemSchema>;
 
 export interface UpdateCatalogItemInput {
   name?: string;
@@ -377,27 +335,18 @@ export async function deleteTrailCondition(reportId: string): Promise<{ success:
   return unwrap(data, 'deleteTrailCondition');
 }
 
+async function adminFetch<T>(path: string, init?: RequestInit): Promise<T> {
+  const res = await adminFetcher(`${API_BASE}/api/admin${path}`, init);
+  if (!res.ok) throw new Error(`Admin API error: ${res.status}`);
+  return res.json();
+}
+
 export function resetStuckEtlJobs(): Promise<{ reset: number; ids: string[] }> {
   return adminFetch('/analytics/catalog/etl/reset-stuck', { method: 'POST' });
 }
 
-export type EtlErrorRow = { field: string; reason: string; count: number };
-
-export type EtlFailureSummary = {
-  topErrors: EtlErrorRow[];
-  totalInvalidItems: number;
-};
-
-export type EtlJobFailures = {
-  jobId: string;
-  errorBreakdown: EtlErrorRow[];
-  samples: Array<{
-    rowIndex: number;
-    errors: Array<{ field: string; reason: string; value?: unknown }>;
-    rawData: unknown;
-  }>;
-  totalShown: number;
-};
+export type EtlFailureSummary = Static<typeof EtlFailureSummarySchema>;
+export type EtlJobFailures = Static<typeof EtlJobFailuresSchema>;
 
 export function getEtlFailureSummary(limit = 20): Promise<EtlFailureSummary> {
   return adminFetch(`/analytics/catalog/etl/failure-summary?limit=${limit}`);

apps/admin/lib/queryKeys.ts

@@ -37,6 +37,13 @@ export const queryKeys = {
     breakdown: () => [...queryKeys.platform.all(), 'breakdown'] as const,
   },
 
+  osm: {
+    all: () => ['osm'] as const,
+    search: (q: string, sport?: string) => [...queryKeys.osm.all(), 'search', q, sport] as const,
+    trail: (osmId: string) => [...queryKeys.osm.all(), 'trail', osmId] as const,
+    conditions: (search?: string) => [...queryKeys.osm.all(), 'conditions', search] as const,
+  },
+
   catalogAnalytics: {
     all: () => ['catalogAnalytics'] as const,
     overview: () => [...queryKeys.catalogAnalytics.all(), 'overview'] as const,