playcademy 0.14.32-alpha.1 → 0.14.33

package/dist/cli.js

@@ -562,17 +562,11 @@ function displayApiError(error, indent) {
     return;
   }
   const statusCode = errorInfo.status;
-  let displayMessage = errorInfo.statusText;
+  let displayMessage = errorInfo.message;
   displayMessage = removeStatusPrefix(displayMessage, statusCode);
   const { cleanMessage, json: embeddedJson } = extractEmbeddedJson(displayMessage);
   displayMessage = cleanMessageSuffix(cleanMessage);
-  let errorCode;
-  if (error.details && typeof error.details === "object") {
-    const details = error.details;
-    if ("code" in details && typeof details.code === "string") {
-      errorCode = details.code;
-    }
-  }
+  const errorCode = error.code;
   let errorHeader = "API Error";
   if (errorCode) {
     errorHeader += ` ${redBright(`[${errorCode}]`)}`;
@@ -1050,7 +1044,7 @@ var package_default = {
     sort: "bunx sort-package-json **/package.json",
     test: "bun test",
     "test:unit": "bun scripts/test-unit.ts",
-    "test:integration": "bun scripts/test-integration.ts",
+    "test:e2e": "bun scripts/test-e2e.ts",
     "test:watch": "bun test --watch",
     "docker:relay": "bun run scripts/docker-relay.ts",
     "debug:leaderboard-notifications": "bunx sst shell -- bun scripts/debug/leaderboard-notifications.ts",
@@ -1210,6 +1204,104 @@ var CONFIG_FILE_NAMES = [
   "playcademy.config.mjs"
 ];
 
+// ../constants/src/achievements.ts
+var ACHIEVEMENT_IDS = {
+  PLAY_ANY_GAME_DAILY: "play_any_game_daily",
+  DAILY_CHEST_OPEN: "daily_chest_open",
+  LEADERBOARD_TOP3_DAILY: "leaderboard_top3_daily",
+  LEADERBOARD_TOP3_WEEKLY: "leaderboard_top3_weekly",
+  FIRST_SCORE_ANY_GAME: "first_score_any_game",
+  PERSONAL_BEST_ANY_GAME: "personal_best_any_game"
+};
+var ACHIEVEMENT_DEFINITIONS = [
+  {
+    id: ACHIEVEMENT_IDS.PLAY_ANY_GAME_DAILY,
+    title: "Play any game",
+    description: "Play any arcade game for at least 60 seconds in a single session.",
+    scope: "daily",
+    rewardCredits: 10,
+    limit: 1,
+    completionType: "time_played_session",
+    completionConfig: { minSeconds: 60 },
+    target: { anyArcadeGame: true },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.DAILY_CHEST_OPEN,
+    title: "Opened the daily chest",
+    description: "Find the chest on the map and open it to claim your reward.",
+    scope: "daily",
+    rewardCredits: 10,
+    limit: 1,
+    completionType: "interaction",
+    completionConfig: { triggerId: "bunny_chest" },
+    target: { map: "arcade" },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.LEADERBOARD_TOP3_DAILY,
+    title: "Daily Champion",
+    description: "Finish in the top 3 of any game leaderboard for the day.",
+    scope: "daily",
+    rewardCredits: 25,
+    // Base reward, overridden by rankRewards
+    limit: 1,
+    completionType: "leaderboard_rank",
+    completionConfig: {
+      rankRewards: [50, 30, 15]
+      // [1st place, 2nd place, 3rd place]
+    },
+    target: { anyArcadeGame: true },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.LEADERBOARD_TOP3_WEEKLY,
+    title: "Weekly Legend",
+    description: "Finish in the top 3 of any game leaderboard for the week.",
+    scope: "weekly",
+    rewardCredits: 50,
+    // Base reward, overridden by rankRewards
+    limit: 1,
+    completionType: "leaderboard_rank",
+    completionConfig: {
+      rankRewards: [100, 60, 30]
+      // [1st place, 2nd place, 3rd place]
+    },
+    target: { anyArcadeGame: true },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.FIRST_SCORE_ANY_GAME,
+    title: "First Score",
+    description: "Submit your first score in any arcade game.",
+    scope: "game",
+    // Scoped per game, no time limit
+    rewardCredits: 5,
+    limit: 1,
+    completionType: "first_score",
+    completionConfig: {},
+    target: { anyArcadeGame: true },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.PERSONAL_BEST_ANY_GAME,
+    title: "Personal Best",
+    description: "Beat your personal best score in any arcade game.",
+    scope: "daily",
+    rewardCredits: 5,
+    limit: 3,
+    // Can earn 3 times per day
+    completionType: "personal_best",
+    completionConfig: {},
+    target: { anyArcadeGame: true },
+    active: true
+  }
+];
+
+// ../constants/src/typescript.ts
+var TSC_PACKAGE = "@typescript/native-preview";
+var USE_NATIVE_TSC = TSC_PACKAGE.includes("native-preview");
+
 // ../constants/src/overworld.ts
 var ITEM_SLUGS = {
   /** Primary platform currency */
@@ -1280,6 +1372,9 @@ function normalizeGitignoreEntry(entry) {
 // src/lib/core/import.ts
 import * as esbuild from "esbuild";
 
+// src/lib/core/transpile.ts
+import * as esbuild2 from "esbuild";
+
 // src/lib/secrets/env.ts
 init_file_loader();
 import { existsSync as existsSync4, writeFileSync } from "fs";
@@ -1631,8 +1726,105 @@ function processConfigVariables(config) {
 
 // ../timeback/dist/constants.js
 var __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var ACHIEVEMENT_IDS2;
+var ACHIEVEMENT_DEFINITIONS2;
+var init_achievements = __esm2(() => {
+  ACHIEVEMENT_IDS2 = {
+    PLAY_ANY_GAME_DAILY: "play_any_game_daily",
+    DAILY_CHEST_OPEN: "daily_chest_open",
+    LEADERBOARD_TOP3_DAILY: "leaderboard_top3_daily",
+    LEADERBOARD_TOP3_WEEKLY: "leaderboard_top3_weekly",
+    FIRST_SCORE_ANY_GAME: "first_score_any_game",
+    PERSONAL_BEST_ANY_GAME: "personal_best_any_game"
+  };
+  ACHIEVEMENT_DEFINITIONS2 = [
+    {
+      id: ACHIEVEMENT_IDS2.PLAY_ANY_GAME_DAILY,
+      title: "Play any game",
+      description: "Play any arcade game for at least 60 seconds in a single session.",
+      scope: "daily",
+      rewardCredits: 10,
+      limit: 1,
+      completionType: "time_played_session",
+      completionConfig: { minSeconds: 60 },
+      target: { anyArcadeGame: true },
+      active: true
+    },
+    {
+      id: ACHIEVEMENT_IDS2.DAILY_CHEST_OPEN,
+      title: "Opened the daily chest",
+      description: "Find the chest on the map and open it to claim your reward.",
+      scope: "daily",
+      rewardCredits: 10,
+      limit: 1,
+      completionType: "interaction",
+      completionConfig: { triggerId: "bunny_chest" },
+      target: { map: "arcade" },
+      active: true
+    },
+    {
+      id: ACHIEVEMENT_IDS2.LEADERBOARD_TOP3_DAILY,
+      title: "Daily Champion",
+      description: "Finish in the top 3 of any game leaderboard for the day.",
+      scope: "daily",
+      rewardCredits: 25,
+      limit: 1,
+      completionType: "leaderboard_rank",
+      completionConfig: {
+        rankRewards: [50, 30, 15]
+      },
+      target: { anyArcadeGame: true },
+      active: true
+    },
+    {
+      id: ACHIEVEMENT_IDS2.LEADERBOARD_TOP3_WEEKLY,
+      title: "Weekly Legend",
+      description: "Finish in the top 3 of any game leaderboard for the week.",
+      scope: "weekly",
+      rewardCredits: 50,
+      limit: 1,
+      completionType: "leaderboard_rank",
+      completionConfig: {
+        rankRewards: [100, 60, 30]
+      },
+      target: { anyArcadeGame: true },
+      active: true
+    },
+    {
+      id: ACHIEVEMENT_IDS2.FIRST_SCORE_ANY_GAME,
+      title: "First Score",
+      description: "Submit your first score in any arcade game.",
+      scope: "game",
+      rewardCredits: 5,
+      limit: 1,
+      completionType: "first_score",
+      completionConfig: {},
+      target: { anyArcadeGame: true },
+      active: true
+    },
+    {
+      id: ACHIEVEMENT_IDS2.PERSONAL_BEST_ANY_GAME,
+      title: "Personal Best",
+      description: "Beat your personal best score in any arcade game.",
+      scope: "daily",
+      rewardCredits: 5,
+      limit: 3,
+      completionType: "personal_best",
+      completionConfig: {},
+      target: { anyArcadeGame: true },
+      active: true
+    }
+  ];
+});
 var init_auth = () => {
 };
+var TSC_PACKAGE2 = "@typescript/native-preview";
+var USE_NATIVE_TSC2;
+var init_typescript = __esm2(() => {
+  USE_NATIVE_TSC2 = TSC_PACKAGE2.includes("native-preview");
+});
+var init_character = () => {
+};
 var PLAYCADEMY_BASE_URLS2;
 var init_domains = __esm2(() => {
   PLAYCADEMY_BASE_URLS2 = {
@@ -1669,6 +1861,7 @@ var init_overworld = __esm2(() => {
     FIRST_GAME: ITEM_SLUGS2.FIRST_GAME_BADGE
   };
 });
+var TIMEBACK_CALIPER_SENSORS;
 var TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY";
 var TIMEBACK_ORG_NAME = "Playcademy Studios";
 var TIMEBACK_ORG_TYPE = "department";
@@ -1677,6 +1870,11 @@ var TIMEBACK_RESOURCE_DEFAULTS;
 var TIMEBACK_COMPONENT_DEFAULTS;
 var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS;
 var init_timeback = __esm2(() => {
+  TIMEBACK_CALIPER_SENSORS = [
+    "https://samuraimath.com",
+    "https://app.alphamath.school",
+    "https://mathraiders.com"
+  ];
   TIMEBACK_COURSE_DEFAULTS = {
     gradingScheme: "STANDARD",
     level: {
@@ -1717,7 +1915,10 @@ var init_timeback = __esm2(() => {
 var init_workers = () => {
 };
 var init_src = __esm2(() => {
+  init_achievements();
   init_auth();
+  init_typescript();
+  init_character();
   init_domains();
   init_env_vars();
   init_overworld();
@@ -2801,6 +3002,7 @@ var package_default2 = {
   ],
   scripts: {
     build: "bun build.ts",
+    check: "bunx @typescript/native-preview --noEmit",
     dev: "PLAYCADEMY_BASE_URL=http://localhost:5174 bun src/index.ts",
     pub: "bun publish.ts"
   },

package/dist/constants/src/achievements.ts

@@ -0,0 +1,107 @@
+/**
+ * Achievement definitions - single source of truth for all achievements
+ *
+ * Used by:
+ * - apps/cademy seed scripts
+ * - packages/sandbox seeding
+ * - packages/fns achievement awarding
+ *
+ * NOTE: Uses string literals instead of AchievementCompletionType enum
+ * to avoid circular dependency with @playcademy/data
+ */
+
+/**
+ * Achievement IDs as constants to avoid magic strings
+ */
+export const ACHIEVEMENT_IDS = {
+    PLAY_ANY_GAME_DAILY: 'play_any_game_daily',
+    DAILY_CHEST_OPEN: 'daily_chest_open',
+    LEADERBOARD_TOP3_DAILY: 'leaderboard_top3_daily',
+    LEADERBOARD_TOP3_WEEKLY: 'leaderboard_top3_weekly',
+    FIRST_SCORE_ANY_GAME: 'first_score_any_game',
+    PERSONAL_BEST_ANY_GAME: 'personal_best_any_game',
+} as const
+
+export type AchievementId = (typeof ACHIEVEMENT_IDS)[keyof typeof ACHIEVEMENT_IDS]
+
+/**
+ * Achievement definitions for platform seeding
+ */
+export const ACHIEVEMENT_DEFINITIONS = [
+    {
+        id: ACHIEVEMENT_IDS.PLAY_ANY_GAME_DAILY,
+        title: 'Play any game',
+        description: 'Play any arcade game for at least 60 seconds in a single session.',
+        scope: 'daily' as const,
+        rewardCredits: 10,
+        limit: 1,
+        completionType: 'time_played_session' as const,
+        completionConfig: { minSeconds: 60 },
+        target: { anyArcadeGame: true },
+        active: true,
+    },
+    {
+        id: ACHIEVEMENT_IDS.DAILY_CHEST_OPEN,
+        title: 'Opened the daily chest',
+        description: 'Find the chest on the map and open it to claim your reward.',
+        scope: 'daily' as const,
+        rewardCredits: 10,
+        limit: 1,
+        completionType: 'interaction' as const,
+        completionConfig: { triggerId: 'bunny_chest' },
+        target: { map: 'arcade' },
+        active: true,
+    },
+    {
+        id: ACHIEVEMENT_IDS.LEADERBOARD_TOP3_DAILY,
+        title: 'Daily Champion',
+        description: 'Finish in the top 3 of any game leaderboard for the day.',
+        scope: 'daily' as const,
+        rewardCredits: 25, // Base reward, overridden by rankRewards
+        limit: 1,
+        completionType: 'leaderboard_rank' as const,
+        completionConfig: {
+            rankRewards: [50, 30, 15], // [1st place, 2nd place, 3rd place]
+        },
+        target: { anyArcadeGame: true },
+        active: true,
+    },
+    {
+        id: ACHIEVEMENT_IDS.LEADERBOARD_TOP3_WEEKLY,
+        title: 'Weekly Legend',
+        description: 'Finish in the top 3 of any game leaderboard for the week.',
+        scope: 'weekly' as const,
+        rewardCredits: 50, // Base reward, overridden by rankRewards
+        limit: 1,
+        completionType: 'leaderboard_rank' as const,
+        completionConfig: {
+            rankRewards: [100, 60, 30], // [1st place, 2nd place, 3rd place]
+        },
+        target: { anyArcadeGame: true },
+        active: true,
+    },
+    {
+        id: ACHIEVEMENT_IDS.FIRST_SCORE_ANY_GAME,
+        title: 'First Score',
+        description: 'Submit your first score in any arcade game.',
+        scope: 'game' as const, // Scoped per game, no time limit
+        rewardCredits: 5,
+        limit: 1,
+        completionType: 'first_score' as const,
+        completionConfig: {},
+        target: { anyArcadeGame: true },
+        active: true,
+    },
+    {
+        id: ACHIEVEMENT_IDS.PERSONAL_BEST_ANY_GAME,
+        title: 'Personal Best',
+        description: 'Beat your personal best score in any arcade game.',
+        scope: 'daily' as const,
+        rewardCredits: 5,
+        limit: 3, // Can earn 3 times per day
+        completionType: 'personal_best' as const,
+        completionConfig: {},
+        target: { anyArcadeGame: true },
+        active: true,
+    },
+]

package/dist/constants/src/character.ts

@@ -0,0 +1,16 @@
+/**
+ * Character Constants
+ *
+ * Configuration for player character customization.
+ */
+
+/** Accessory slot configuration with unlock levels */
+export const ACCESSORY_SLOTS = [
+    { type: 'head', unlockLevel: 1, displayName: 'Head', maxItems: 1 },
+    { type: 'face', unlockLevel: 2, displayName: 'Face', maxItems: 1 },
+    { type: 'hands', unlockLevel: 10, displayName: 'Hands', maxItems: 1 },
+    { type: 'back', unlockLevel: 15, displayName: 'Back', maxItems: 1 },
+] as const
+
+/** Valid accessory slot types */
+export const VALID_SLOT_TYPES = ['head', 'face', 'hands', 'back'] as const

package/dist/constants/src/index.ts

@@ -6,7 +6,10 @@
  * and other constants that need to be consistent across multiple packages.
  */
 
+export * from './achievements'
 export * from './auth'
+export * from './typescript'
+export * from './character'
 export * from './domains'
 export * from './env-vars'
 export * from './overworld'

package/dist/constants/src/timeback.ts

@@ -4,6 +4,15 @@
  * Constants related to TimeBack Caliper integration.
  */
 
+/**
+ * TimeBack LTI issuer URLs by environment
+ * Used for JWT token verification (iss claim)
+ */
+export const TIMEBACK_LTI_ISSUER_URLS = {
+    production: 'https://timeback.com',
+    staging: 'https://staging.timeback.com',
+} as const
+
 /**
  * TimeBack Caliper sensor URLs
  * Allowed sensor URLs for Caliper event validation

package/dist/constants/src/typescript.ts

@@ -0,0 +1,19 @@
+/**
+ * TypeScript configuration constants
+ *
+ * Toggle between TypeScript compilers for type generation.
+ */
+
+/**
+ * TypeScript package to use for type generation via bunx.
+ *
+ * Options:
+ * - '@typescript/native-preview' - Native TypeScript compiler (faster)
+ * - 'typescript' - Standard TypeScript compiler
+ */
+export const TSC_PACKAGE = '@typescript/native-preview'
+
+/**
+ * Whether using the native TypeScript compiler.
+ */
+export const USE_NATIVE_TSC = TSC_PACKAGE.includes('native-preview')

package/dist/constants.js

@@ -72,7 +72,7 @@ var package_default = {
     sort: "bunx sort-package-json **/package.json",
     test: "bun test",
     "test:unit": "bun scripts/test-unit.ts",
-    "test:integration": "bun scripts/test-integration.ts",
+    "test:e2e": "bun scripts/test-e2e.ts",
     "test:watch": "bun test --watch",
     "docker:relay": "bun run scripts/docker-relay.ts",
     "debug:leaderboard-notifications": "bunx sst shell -- bun scripts/debug/leaderboard-notifications.ts",
@@ -292,6 +292,104 @@ var CONFIG_FILE_NAMES = [
   "playcademy.config.mjs"
 ];
 
+// ../constants/src/achievements.ts
+var ACHIEVEMENT_IDS = {
+  PLAY_ANY_GAME_DAILY: "play_any_game_daily",
+  DAILY_CHEST_OPEN: "daily_chest_open",
+  LEADERBOARD_TOP3_DAILY: "leaderboard_top3_daily",
+  LEADERBOARD_TOP3_WEEKLY: "leaderboard_top3_weekly",
+  FIRST_SCORE_ANY_GAME: "first_score_any_game",
+  PERSONAL_BEST_ANY_GAME: "personal_best_any_game"
+};
+var ACHIEVEMENT_DEFINITIONS = [
+  {
+    id: ACHIEVEMENT_IDS.PLAY_ANY_GAME_DAILY,
+    title: "Play any game",
+    description: "Play any arcade game for at least 60 seconds in a single session.",
+    scope: "daily",
+    rewardCredits: 10,
+    limit: 1,
+    completionType: "time_played_session",
+    completionConfig: { minSeconds: 60 },
+    target: { anyArcadeGame: true },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.DAILY_CHEST_OPEN,
+    title: "Opened the daily chest",
+    description: "Find the chest on the map and open it to claim your reward.",
+    scope: "daily",
+    rewardCredits: 10,
+    limit: 1,
+    completionType: "interaction",
+    completionConfig: { triggerId: "bunny_chest" },
+    target: { map: "arcade" },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.LEADERBOARD_TOP3_DAILY,
+    title: "Daily Champion",
+    description: "Finish in the top 3 of any game leaderboard for the day.",
+    scope: "daily",
+    rewardCredits: 25,
+    // Base reward, overridden by rankRewards
+    limit: 1,
+    completionType: "leaderboard_rank",
+    completionConfig: {
+      rankRewards: [50, 30, 15]
+      // [1st place, 2nd place, 3rd place]
+    },
+    target: { anyArcadeGame: true },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.LEADERBOARD_TOP3_WEEKLY,
+    title: "Weekly Legend",
+    description: "Finish in the top 3 of any game leaderboard for the week.",
+    scope: "weekly",
+    rewardCredits: 50,
+    // Base reward, overridden by rankRewards
+    limit: 1,
+    completionType: "leaderboard_rank",
+    completionConfig: {
+      rankRewards: [100, 60, 30]
+      // [1st place, 2nd place, 3rd place]
+    },
+    target: { anyArcadeGame: true },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.FIRST_SCORE_ANY_GAME,
+    title: "First Score",
+    description: "Submit your first score in any arcade game.",
+    scope: "game",
+    // Scoped per game, no time limit
+    rewardCredits: 5,
+    limit: 1,
+    completionType: "first_score",
+    completionConfig: {},
+    target: { anyArcadeGame: true },
+    active: true
+  },
+  {
+    id: ACHIEVEMENT_IDS.PERSONAL_BEST_ANY_GAME,
+    title: "Personal Best",
+    description: "Beat your personal best score in any arcade game.",
+    scope: "daily",
+    rewardCredits: 5,
+    limit: 3,
+    // Can earn 3 times per day
+    completionType: "personal_best",
+    completionConfig: {},
+    target: { anyArcadeGame: true },
+    active: true
+  }
+];
+
+// ../constants/src/typescript.ts
+var TSC_PACKAGE = "@typescript/native-preview";
+var USE_NATIVE_TSC = TSC_PACKAGE.includes("native-preview");
+
 // ../constants/src/domains.ts
 var PLAYCADEMY_DOMAINS = {
   /** Primary domain (hub, landing pages) */

package/dist/db.d.ts

@@ -30,9 +30,17 @@ import { Miniflare } from 'miniflare';
 declare function getDevDbPath(): string;
 
 /**
- * Seed Worker Bundler
- *
- * Bundles user's seed file into standalone Cloudflare Worker
+ * Environment context passed to seed functions
+ */
+interface SeedContext {
+    env: {
+        DB: unknown;
+        BUCKET?: unknown;
+        secrets?: Record<string, string>;
+    };
+}
+/**
+ * Result of bundling a seed file into a Cloudflare Worker
  */
 interface SeedWorkerBundle {
     /** Bundled worker code */
@@ -40,13 +48,29 @@ interface SeedWorkerBundle {
     /** Size in bytes */
     size: number;
 }
+
 /**
- * Bundle seed file into a Cloudflare Worker
+ * Seed Worker Bundler
+ *
+ * Bundles user's seed file into standalone Cloudflare Worker
+ * with enhanced logging capture and structured error reporting.
+ */
+
+/**
+ * Generate the worker entry code that wraps the user's seed function.
+ *
+ * The generated worker:
+ * - Imports the user's seed function from the specified path
+ * - Captures console output (log/warn/error/info) with timestamps
+ * - Parses D1/SQLite errors into structured details
+ * - Returns success/error as JSON with logs and timing
  *
- * Creates a minimal worker that:
- * 1. Imports user's seed function
- * 2. Wraps it in fetch handler
- * 3. Returns success/error as JSON
+ * @param seedFilePath - Absolute path to user's seed file
+ * @returns Worker entry code as a string
+ */
+declare function createSeedWorkerEntry(seedFilePath: string): Promise<string>;
+/**
+ * Bundle seed file into a Cloudflare Worker
  *
  * @param seedFilePath - Absolute path to seed file
  * @param projectPath - Project root (for resolving imports)
@@ -75,17 +99,6 @@ declare function resetDatabase(workspace: string, mf: Miniflare, options?: {
     debug?: boolean;
 }): Promise<void>;
 
-/**
- * Environment context passed to seed functions
- */
-interface SeedContext {
-    env: {
-        DB: unknown;
-        BUCKET?: unknown;
-        secrets?: Record<string, string>;
-    };
-}
-
 /**
  * Database Seed Utilities
  *
@@ -110,5 +123,40 @@ declare function getBucket(mf: Miniflare): Promise<unknown | null>;
  */
 declare function executeSeedFile(seedFilePath: string, mf: Miniflare, envSecrets?: Record<string, string>): Promise<void>;
 
-export { bundleSeedWorker, executeSeedFile, getBucket, getDevDbPath as getPath, importSeedModule, resetDatabase };
+/** Log entry captured from seed worker console output */
+interface SeedLogEntry {
+    /** Log level (log, warn, error, info) */
+    level: 'log' | 'warn' | 'error' | 'info';
+    /** Log message content */
+    message: string;
+    /** Milliseconds since seed execution started */
+    timestamp: number;
+}
+
+/**
+ * Seed Output Utilities
+ *
+ * Functions for displaying seed execution results and handling errors.
+ */
+
+/**
+ * Display captured logs from seed execution.
+ * Uses a vertical line to indicate output is from another source (the seed file).
+ *
+ * @param logs - Captured log entries
+ * @param status - 'success' for green bar, 'error' for red bar
+ */
+declare function displaySeedLogs(logs: SeedLogEntry[], status?: 'success' | 'error'): void;
+/**
+ * Handle seed-specific errors with helpful messages.
+ *
+ * For seed execution errors, displays captured logs with error styling.
+ * For infrastructure errors (network, auth, etc.), shows admonitions.
+ *
+ * Returns true if the error was handled (caller should show simple failure message).
+ * Returns false if not handled (caller should show the error message).
+ */
+declare function handleSeedError(error: unknown): boolean;
+
+export { bundleSeedWorker, createSeedWorkerEntry, displaySeedLogs, executeSeedFile, getBucket, getDevDbPath as getPath, handleSeedError, importSeedModule, resetDatabase };
 export type { SeedWorkerBundle };