playcademy 0.27.0 → 0.27.1-beta.2

package/dist/bucket.js

@@ -94,7 +94,7 @@ var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.19",
+  version: "0.0.20-beta.1",
   type: "module",
   exports: {
     "./server": {

package/dist/cli.js

@@ -1196,7 +1196,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.19",
+  version: "0.0.20-beta.1",
   type: "module",
   exports: {
     "./server": {
@@ -2951,7 +2951,7 @@ import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as re
 import { join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.27.0";
+var cliVersion = false ? "0.0.0-dev" : "0.27.1-beta.2";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");

package/dist/constants.js

@@ -20,7 +20,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.19",
+  version: "0.0.20-beta.1",
   type: "module",
   exports: {
     "./server": {

package/dist/db.js

@@ -36,7 +36,7 @@ var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.19",
+  version: "0.0.20-beta.1",
   type: "module",
   exports: {
     "./server": {

package/dist/index.d.ts

@@ -831,6 +831,7 @@ interface DeploymentContext {
     isDryRun: boolean;
     deployBackend: boolean;
     forceBackend: boolean;
+    skipSecrets: boolean;
     forceIntegrationConfigSync?: string[];
     cancellationHandled?: boolean;
     /** Why a non-interactive deploy was cancelled; surfaced in --json error output. */

package/dist/index.js

@@ -326,7 +326,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.19",
+  version: "0.0.20-beta.1",
   type: "module",
   exports: {
     "./server": {
@@ -4140,7 +4140,7 @@ import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as rea
 import { join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.27.0";
+var cliVersion = false ? "0.0.0-dev" : "0.27.1-beta.2";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
@@ -12186,6 +12186,92 @@ async function validateDeployConfig(config) {
     throw new Error("Invalid configuration");
   }
 }
+async function validateDeploySecrets(context2) {
+  if (!context2.fullConfig?.integrations) {
+    return;
+  }
+  if (context2.skipSecrets && context2.isGameDeployed && context2.existingGame) {
+    await validatePlatformSecrets(context2, context2.existingGame.slug);
+  } else {
+    validateLocalSecrets(context2);
+  }
+}
+function validateLocalSecrets(context2) {
+  const missingSecrets = validateIntegrationSecrets(
+    context2.fullConfig,
+    context2.skipSecrets ? {} : context2.localSecrets ?? {}
+  );
+  if (missingSecrets.length === 0) {
+    return;
+  }
+  const missing = missingSecrets[0];
+  if (context2.json) {
+    const suffix = context2.skipSecrets ? " (a deploy with --skip-secrets will never push it)" : "";
+    throw new Error(
+      `Missing secret ${missing.key} required by ${missing.integration} integration${suffix}`
+    );
+  }
+  if (context2.skipSecrets) {
+    logger.admonition("warning", `Missing Secret: ${missing.key}`, [
+      `The <${missing.integration}> integration requires ${missing.key}, and a first`,
+      "deploy with `--skip-secrets` will never push it",
+      "",
+      "Deploy without `--skip-secrets` so your .env secrets ship",
+      "",
+      `Learn more: <<${missing.docs}>>`
+    ]);
+  } else {
+    logger.admonition("warning", `Missing Secret: ${missing.key}`, [
+      `The <${missing.integration}> integration requires ${missing.key} to be set in .env`,
+      "",
+      `Learn more: <<${missing.docs}>>`
+    ]);
+  }
+  process.exit(1);
+}
+async function validatePlatformSecrets(context2, gameSlug) {
+  const requiredSecrets = validateIntegrationSecrets(context2.fullConfig, {});
+  if (requiredSecrets.length === 0) {
+    return;
+  }
+  let remoteKeys;
+  try {
+    remoteKeys = await context2.client.dev.games.secrets.list(gameSlug);
+  } catch {
+  }
+  if (!remoteKeys) {
+    if (context2.json) {
+      logger.errLine(
+        `Warning: could not fetch platform secret keys to verify ${requiredSecrets[0].key}, and --skip-secrets will not push it. Confirm with \`playcademy secrets list\``
+      );
+    } else {
+      logger.admonition("warning", "Secrets Not Verified", [
+        "The platform secret keys could not be fetched, and `--skip-secrets`",
+        "will not push any",
+        "",
+        `Confirm ${requiredSecrets[0].key} is set with \`playcademy secrets list\``
+      ]);
+    }
+    return;
+  }
+  const missing = requiredSecrets.find((secret) => !remoteKeys.includes(secret.key));
+  if (!missing) {
+    return;
+  }
+  if (context2.json) {
+    throw new Error(
+      `Missing secret ${missing.key} required by ${missing.integration} integration (not set on the platform, and --skip-secrets will not push it)`
+    );
+  }
+  logger.admonition("warning", `Missing Secret: ${missing.key}`, [
+    `The <${missing.integration}> integration requires ${missing.key} to be set on the platform`,
+    "",
+    "Push it with `playcademy secrets push` or deploy without `--skip-secrets`",
+    "",
+    `Learn more: <<${missing.docs}>>`
+  ]);
+  process.exit(1);
+}
 
 // src/lib/deploy/interaction.ts
 async function selectEnvironment(options) {
@@ -12768,6 +12854,9 @@ function displayCurrentConfiguration(context2) {
   } else {
     logger.data("Status", "Not deployed", 1);
   }
+  if (context2.skipSecrets) {
+    logger.data("Secrets", "Sync skipped (--skip-secrets)", 1);
+  }
   logger.newLine();
 }
 async function reportNoChanges(context2) {
@@ -12985,6 +13074,7 @@ import { sql as sql2 } from "drizzle-orm";
 import { sql } from "drizzle-orm";
 import {
   boolean as boolean3,
+  doublePrecision,
   index,
   integer as integer2,
   pgEnum as pgEnum3,
@@ -13308,6 +13398,32 @@ var gameTimebackMetricDiscrepancyVerifications = pgTable3(
     )
   ]
 );
+var gameTimebackActivityCompletions = pgTable3(
+  "game_timeback_activity_completions",
+  {
+    id: uuid2("id").primaryKey().defaultRandom(),
+    gameId: uuid2("game_id").notNull().references(() => games.id, { onDelete: "cascade" }),
+    courseId: text3("course_id").notNull(),
+    studentId: text3("student_id").notNull(),
+    runId: uuid2("run_id").notNull(),
+    activityId: text3("activity_id").notNull(),
+    completedAt: timestamp3("completed_at", { withTimezone: true }),
+    reservedAt: timestamp3("reserved_at", { withTimezone: true, mode: "string" }).notNull().defaultNow(),
+    xpAwarded: doublePrecision("xp_awarded"),
+    masteredUnitsApplied: integer2("mastered_units_applied"),
+    pctCompleteApp: doublePrecision("pct_complete_app"),
+    createdAt: timestamp3("created_at", { withTimezone: true }).notNull().defaultNow()
+  },
+  (table) => [
+    uniqueIndex3("game_timeback_activity_completions_run_idx").on(
+      table.gameId,
+      table.courseId,
+      table.studentId,
+      table.runId,
+      table.activityId
+    )
+  ]
+);
 
 // src/lib/deploy/preparation.ts
 async function updateBuildMetadata(context2) {
@@ -13382,9 +13498,9 @@ async function prepareDeploymentContext(options) {
       buildHash = await hashFile(finalConfig.buildPath);
     }
   }
-  const localSecrets = hasEnvFile(projectPath) ? await readEnvFile(projectPath) : {};
+  const localSecrets = !options.skipSecrets && hasEnvFile(projectPath) ? await readEnvFile(projectPath) : {};
   let remoteSecretKeys;
-  if (existingGame && gameIsDeployed) {
+  if (!options.skipSecrets && existingGame && gameIsDeployed) {
     try {
       remoteSecretKeys = await client.dev.games.secrets.list(existingGame.slug);
     } catch {
@@ -13415,6 +13531,7 @@ async function prepareDeploymentContext(options) {
     isDryRun: options.dryRun ?? false,
     deployBackend: options.backend !== false,
     forceBackend: options.forceBackend ?? false,
+    skipSecrets: options.skipSecrets ?? false,
     minify: options.minify ?? true,
     verbose: options.verbose ?? false,
     debug: options.debug ?? false,
@@ -13484,12 +13601,13 @@ async function analyzeChanges(context2) {
     deployBackend,
     localSecrets,
     remoteSecretKeys,
-    deployedGameInfo
+    deployedGameInfo,
+    skipSecrets
   } = context2;
   let secretsDiff = void 0;
   const hasLocalSecrets = Object.keys(localSecrets ?? {}).length > 0;
   const hasRemoteSecrets = remoteSecretKeys && remoteSecretKeys.length > 0;
-  if (hasLocalSecrets || hasRemoteSecrets) {
+  if (!skipSecrets && (hasLocalSecrets || hasRemoteSecrets)) {
     secretsDiff = computeSecretsDiff({
       localSecrets: localSecrets ?? {},
       remoteKeys: remoteSecretKeys ?? [],
@@ -16334,6 +16452,7 @@ export {
   validateConfig,
   validateCustomHostname,
   validateDeployConfig,
+  validateDeploySecrets,
   validateDeploymentState,
   validateIntegrationSecrets,
   validateQueueHandlersConfig,

package/dist/runtime/backend-runtime/index.js

@@ -414,9 +414,9 @@ var init_routes = __esm({
 // ../edge-play/src/entry/metadata.ts
 function getRuntimeMetadata() {
   return {
-    cliVersion: true ? "0.27.0" : "0.0.0-dev",
-    sdkVersion: true ? "0.15.0" : "0.0.0-dev",
-    buildId: true ? "96e669093e53" : "dev-source"
+    cliVersion: true ? "0.27.1-beta.2" : "0.0.0-dev",
+    sdkVersion: true ? "0.15.1-beta.1" : "0.0.0-dev",
+    buildId: true ? "d545e8dcb239" : "dev-source"
   };
 }
 var init_metadata = __esm({
@@ -4118,6 +4118,12 @@ function createTimebackNamespace(client) {
      * @param payload.xpEarned - XP earned for this activity (required)
      * @param payload.masteredUnits - Optional mastery units completed this session
      * @param payload.extensions - Optional arbitrary extensions for the Caliper event
+     * @param payload.runId - Optional stable run identifier (UUID) enabling the
+     *   platform's duplicate-completion guard: at most one completion is recorded
+     *   per activity per run. A resubmission (e.g. a retry after a timeout) returns
+     *   `blockedByDedupeGuard: true` echoing the originally recorded award instead
+     *   of double-counting XP. Strongly recommended for any caller with retry
+     *   logic; use a fresh UUID per logical run.
      * @returns Promise resolving to the API response with status, courseId, and xpAwarded
      * @throws {Error} If grade or subject are missing
      * @throws {Error} If the API request fails
@@ -4125,6 +4131,7 @@ function createTimebackNamespace(client) {
      * @example
      * ```typescript
      * await client.timeback.endActivity('student-tb-id-123', {
+     *   runId: crypto.randomUUID(), // mint once per run; reuse on retries
      *   activityData: {
      *     activityId: 'math-quiz-1',
      *     activityName: 'Basic Arithmetic Quiz',
@@ -4153,6 +4160,7 @@ function createTimebackNamespace(client) {
       return client["request"]("/api/timeback/end-activity", "POST", {
         gameId: client.gameId,
         studentId,
+        ...payload.runId ? { runId: payload.runId } : {},
         activityData: enrichedActivityData,
         scoreData: payload.scoreData,
         timingData: payload.timingData,

package/dist/runtime/backend-runtime/manifest.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "0.27.0",
-  "sdkVersion": "0.15.0",
-  "runtimeBuildId": "96e669093e53",
-  "inputFingerprint": "96e669093e53c001ce1e40806382a3217960ba60faa4b92579faf7d0fe64ba73",
+  "cliVersion": "0.27.1-beta.2",
+  "sdkVersion": "0.15.1-beta.1",
+  "runtimeBuildId": "d545e8dcb239",
+  "inputFingerprint": "d545e8dcb2397340ecb4aeaf21a6cfa083edd51f1fba4ad42b3b2fb6ef89ed97",
   "entry": "index.js"
 }

package/dist/utils.js

@@ -359,7 +359,7 @@ var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.19",
+  version: "0.0.20-beta.1",
   type: "module",
   exports: {
     "./server": {
@@ -2603,7 +2603,7 @@ import { existsSync as existsSync9, mkdirSync as mkdirSync2, writeFileSync as wr
 import { dirname as dirname4, join as join14 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.27.0";
+var cliVersion = false ? "0.0.0-dev" : "0.27.1-beta.2";
 
 // src/lib/build/binary-resource.ts
 function writeFileTree(baseDir, files) {

package/dist/version.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.27.0";
+var cliVersion = false ? "0.0.0-dev" : "0.27.1-beta.2";
 export {
   cliVersion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.27.0",
+    "version": "0.27.1-beta.2",
     "type": "module",
     "exports": {
         ".": {
@@ -55,7 +55,7 @@
     },
     "dependencies": {
         "@inquirer/prompts": "^7.8.6",
-        "@playcademy/sdk": "0.15.0",
+        "@playcademy/sdk": "0.15.1-beta.1",
         "chokidar": "^4.0.3",
         "colorette": "^2.0.20",
         "commander": "^14.0.1",