@playcademy/sdk 0.2.13 → 0.3.0

package/dist/internal.d.ts

@@ -1264,6 +1264,23 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        visibility: drizzle_orm_pg_core.PgColumn<{
+            name: "visibility";
+            tableName: "games";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "visible" | "unlisted" | "internal";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["visible", "unlisted", "internal"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         metadata: drizzle_orm_pg_core.PgColumn<{
             name: "metadata";
             tableName: "games";
@@ -3653,6 +3670,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     platform: z.ZodEnum<["web", "godot", "unity"]>;
     metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     gameType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hosted", "external"]>>>;
+    visibility: z.ZodOptional<z.ZodEnum<["visible", "unlisted", "internal"]>>;
     externalUrl: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     metadata: Record<string, unknown>;
@@ -3661,6 +3679,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     platform: "web" | "godot" | "unity";
     externalUrl?: string | undefined;
     mapElementId?: string | null | undefined;
+    visibility?: "visible" | "unlisted" | "internal" | undefined;
 }, {
     displayName: string;
     platform: "web" | "godot" | "unity";
@@ -3668,6 +3687,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     gameType?: "hosted" | "external" | undefined;
     externalUrl?: string | undefined;
     mapElementId?: string | null | undefined;
+    visibility?: "visible" | "unlisted" | "internal" | undefined;
 }>, {
     metadata: Record<string, unknown>;
     displayName: string;
@@ -3675,6 +3695,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     platform: "web" | "godot" | "unity";
     externalUrl?: string | undefined;
     mapElementId?: string | null | undefined;
+    visibility?: "visible" | "unlisted" | "internal" | undefined;
 }, {
     displayName: string;
     platform: "web" | "godot" | "unity";
@@ -3682,6 +3703,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     gameType?: "hosted" | "external" | undefined;
     externalUrl?: string | undefined;
     mapElementId?: string | null | undefined;
+    visibility?: "visible" | "unlisted" | "internal" | undefined;
 }>;
 
 declare const InsertItemSchema: drizzle_zod.BuildSchema<"insert", {
@@ -6501,6 +6523,14 @@ interface DatabaseIntegration {
      *  When omitted, auto-detects based on presence of a migrations directory with _journal.json. */
     strategy?: 'push' | 'migrate';
 }
+interface QueueConfig {
+    maxBatchSize?: number;
+    maxRetries?: number;
+    maxBatchTimeout?: number;
+    maxConcurrency?: number;
+    retryDelay?: number;
+    deadLetterQueue?: string;
+}
 /**
  * Integrations configuration
  * All backend features (database, custom routes, external services) are configured here
@@ -6518,6 +6548,8 @@ interface IntegrationsConfig {
     bucket?: boolean;
     /** Authentication (optional) */
     auth?: boolean;
+    /** Queues (optional) */
+    queues?: Record<string, QueueConfig | boolean>;
 }
 /**
  * Unified Playcademy configuration
@@ -6624,6 +6656,8 @@ interface BackendResourceBindings {
     keyValue?: string[];
     /** Object storage buckets to bind (maps to R2 on Cloudflare) */
     bucket?: string[];
+    /** Queue bindings to create and bind */
+    queues?: Record<string, QueueConfig | boolean>;
 }
 /**
  * Backend deployment bundle for uploading to Playcademy platform
@@ -6637,8 +6671,6 @@ interface BackendDeploymentBundle {
     bindings?: BackendResourceBindings;
     /** Optional schema information for database setup */
     schema?: SchemaInfo;
-    /** Optional game secrets */
-    secrets?: Record<string, string>;
 }
 
 /**

package/dist/internal.js

@@ -1650,6 +1650,38 @@ function createAdminNamespace(client) {
 }
 // src/namespaces/platform/dev.ts
 function createDevNamespace(client) {
+  const DEPLOY_JOB_POLL_INTERVAL_MS = 1000;
+  const DEPLOY_JOB_INACTIVITY_TIMEOUT_MS = 60 * 1000;
+  async function pollDeployJob(slug, jobId, hooks) {
+    hooks?.onEvent?.({ type: "finalizeStart" });
+    let seenEvents = 0;
+    let lastProgressAt = Date.now();
+    while (true) {
+      if (Date.now() - lastProgressAt > DEPLOY_JOB_INACTIVITY_TIMEOUT_MS) {
+        throw new Error("Deployment job timed out after 5 minutes without progress");
+      }
+      const job = await client["request"](`/games/${slug}/deploy?jobId=${encodeURIComponent(jobId)}`, "GET");
+      const newEvents = job.events.slice(seenEvents);
+      seenEvents = job.events.length;
+      if (newEvents.length > 0) {
+        lastProgressAt = Date.now();
+      }
+      for (const event of newEvents) {
+        hooks?.onEvent?.({
+          type: "finalizeStatus",
+          message: event.durationMs ? `${event.message} (${event.durationMs}ms)` : event.message
+        });
+      }
+      if (job.status === "succeeded") {
+        hooks?.onEvent?.({ type: "complete" });
+        return job;
+      }
+      if (job.status === "failed") {
+        throw new ApiError(job.errorStatus ?? 500, job.errorCode ?? "INTERNAL_ERROR", job.error || "Deployment failed", job);
+      }
+      await new Promise((resolve) => setTimeout(resolve, DEPLOY_JOB_POLL_INTERVAL_MS));
+    }
+  }
   return {
     status: {
       apply: () => client["request"]("/dev/apply", "POST"),
@@ -1723,19 +1755,6 @@ function createDevNamespace(client) {
           }
         }
         if (uploadToken || backend) {
-          const deployUrl = `${client.baseUrl}/games/${slug}/deploy`;
-          const authToken = client.getToken();
-          const tokenType = client.getTokenType();
-          const headers = {
-            "Content-Type": "application/json"
-          };
-          if (authToken) {
-            if (tokenType === "apiKey") {
-              headers["x-api-key"] = authToken;
-            } else {
-              headers["Authorization"] = `Bearer ${authToken}`;
-            }
-          }
           const requestBody = {};
           if (uploadToken)
             requestBody.uploadToken = uploadToken;
@@ -1748,89 +1767,24 @@ function createDevNamespace(client) {
               requestBody.bindings = backend.bindings;
             if (backend.schema)
               requestBody.schema = backend.schema;
-            if (backend.secrets)
-              requestBody.secrets = backend.secrets;
           }
-          const finalizeResponse = await fetch(deployUrl, {
-            method: "POST",
-            headers,
-            body: JSON.stringify(requestBody),
-            credentials: "omit"
+          const job = await client["request"](`/games/${slug}/deploy`, "POST", {
+            body: requestBody
           });
-          if (!finalizeResponse.ok) {
-            const errText = await finalizeResponse.text().catch(() => "");
-            throw new Error(`Deploy request failed: ${finalizeResponse.status} ${finalizeResponse.statusText}${errText ? ` - ${errText}` : ""}`);
-          }
-          if (!finalizeResponse.body) {
-            throw new Error("Deploy response body missing");
+          const completedJob = await pollDeployJob(slug, job.id, hooks);
+          if (!completedJob.result?.url) {
+            throw new Error("Deployment completed but no deployment URL was recorded");
           }
-          hooks?.onEvent?.({ type: "finalizeStart" });
-          let sawAnyServerEvent = false;
-          const reader = finalizeResponse.body.pipeThrough(new TextDecoderStream).getReader();
-          let buffer = "";
-          const processBuffer = () => {
-            let eolIndex;
-            while ((eolIndex = buffer.indexOf(`
-
-`)) >= 0) {
-              const message = buffer.slice(0, eolIndex);
-              buffer = buffer.slice(eolIndex + 2);
-              const eventLine = message.match(/^event: (.*)$/m);
-              const dataLine = message.match(/^data: (.*)$/m);
-              if (eventLine && dataLine) {
-                const eventType = eventLine[1];
-                const eventData = JSON.parse(dataLine[1]);
-                sawAnyServerEvent = true;
-                switch (eventType) {
-                  case "uploadProgress": {
-                    const percent = (eventData.value ?? 0) / 100;
-                    hooks?.onEvent?.({
-                      type: "finalizeProgress",
-                      percent,
-                      currentFileLabel: eventData.currentFileLabel || ""
-                    });
-                    break;
-                  }
-                  case "status": {
-                    if (eventData.message) {
-                      hooks?.onEvent?.({
-                        type: "finalizeStatus",
-                        message: eventData.message
-                      });
-                    }
-                    break;
-                  }
-                  case "complete": {
-                    hooks?.onEvent?.({ type: "complete" });
-                    reader.cancel();
-                    return eventData;
-                  }
-                  case "error": {
-                    reader.cancel();
-                    throw ApiError.fromResponse(eventData?.error?.status ?? 500, "Deployment error", eventData);
-                  }
-                }
-              }
-            }
-            return null;
-          };
-          while (true) {
-            const { done, value } = await reader.read();
-            if (value) {
-              buffer += value;
-            }
-            const result = processBuffer();
-            if (result)
-              return result;
-            if (done) {
-              if (!sawAnyServerEvent) {
-                hooks?.onClose?.();
-                hooks?.onEvent?.({ type: "close" });
+          for (let attempt = 0;attempt < 3; attempt++) {
+            try {
+              return await client["request"](`/games/${slug}`, "GET");
+            } catch {
+              if (attempt < 2) {
+                await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
               }
-              break;
             }
           }
-          throw new Error("Deployment completed but no final game data received");
+          throw new Error("Deploy succeeded but failed to fetch updated game after 3 attempts");
         }
         if (game) {
           return game;

package/dist/server.d.ts

@@ -386,6 +386,14 @@ interface DatabaseIntegration {
      *  When omitted, auto-detects based on presence of a migrations directory with _journal.json. */
     strategy?: 'push' | 'migrate';
 }
+interface QueueConfig {
+    maxBatchSize?: number;
+    maxRetries?: number;
+    maxBatchTimeout?: number;
+    maxConcurrency?: number;
+    retryDelay?: number;
+    deadLetterQueue?: string;
+}
 /**
  * Integrations configuration
  * All backend features (database, custom routes, external services) are configured here
@@ -403,6 +411,8 @@ interface IntegrationsConfig {
     bucket?: boolean;
     /** Authentication (optional) */
     auth?: boolean;
+    /** Queues (optional) */
+    queues?: Record<string, QueueConfig | boolean>;
 }
 /**
  * Unified Playcademy configuration
@@ -509,6 +519,8 @@ interface BackendResourceBindings {
     keyValue?: string[];
     /** Object storage buckets to bind (maps to R2 on Cloudflare) */
     bucket?: string[];
+    /** Queue bindings to create and bind */
+    queues?: Record<string, QueueConfig | boolean>;
 }
 /**
  * Backend deployment bundle for uploading to Playcademy platform
@@ -522,8 +534,6 @@ interface BackendDeploymentBundle {
     bindings?: BackendResourceBindings;
     /** Optional schema information for database setup */
     schema?: SchemaInfo;
-    /** Optional game secrets */
-    secrets?: Record<string, string>;
 }
 
 /**
@@ -715,4 +725,4 @@ declare function verifyGameToken(gameToken: string, options?: {
 }): Promise<VerifyGameTokenResponse>;
 
 export { PlaycademyClient, verifyGameToken };
-export type { ActivityData, BackendDeploymentBundle, BackendResourceBindings, ComponentConfig, ComponentResourceConfig, EndActivityPayload, IntegrationsConfig, OrganizationConfig, PlaycademyConfig, PlaycademyServerClientConfig, PlaycademyServerClientState, ResourceConfig, TimebackBaseConfig, TimebackCourseConfigWithOverrides, TimebackGrade, TimebackIntegrationConfig, TimebackSubject, UserInfo };
+export type { ActivityData, BackendDeploymentBundle, BackendResourceBindings, ComponentConfig, ComponentResourceConfig, EndActivityPayload, IntegrationsConfig, OrganizationConfig, PlaycademyConfig, PlaycademyServerClientConfig, PlaycademyServerClientState, QueueConfig, ResourceConfig, TimebackBaseConfig, TimebackCourseConfigWithOverrides, TimebackGrade, TimebackIntegrationConfig, TimebackSubject, UserInfo };

package/dist/types.d.ts

@@ -1086,6 +1086,23 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        visibility: drizzle_orm_pg_core.PgColumn<{
+            name: "visibility";
+            tableName: "games";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "visible" | "unlisted" | "internal";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["visible", "unlisted", "internal"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         metadata: drizzle_orm_pg_core.PgColumn<{
             name: "metadata";
             tableName: "games";
@@ -3475,6 +3492,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     platform: z.ZodEnum<["web", "godot", "unity"]>;
     metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     gameType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hosted", "external"]>>>;
+    visibility: z.ZodOptional<z.ZodEnum<["visible", "unlisted", "internal"]>>;
     externalUrl: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     metadata: Record<string, unknown>;
@@ -3483,6 +3501,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     platform: "web" | "godot" | "unity";
     externalUrl?: string | undefined;
     mapElementId?: string | null | undefined;
+    visibility?: "visible" | "unlisted" | "internal" | undefined;
 }, {
     displayName: string;
     platform: "web" | "godot" | "unity";
@@ -3490,6 +3509,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     gameType?: "hosted" | "external" | undefined;
     externalUrl?: string | undefined;
     mapElementId?: string | null | undefined;
+    visibility?: "visible" | "unlisted" | "internal" | undefined;
 }>, {
     metadata: Record<string, unknown>;
     displayName: string;
@@ -3497,6 +3517,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     platform: "web" | "godot" | "unity";
     externalUrl?: string | undefined;
     mapElementId?: string | null | undefined;
+    visibility?: "visible" | "unlisted" | "internal" | undefined;
 }, {
     displayName: string;
     platform: "web" | "godot" | "unity";
@@ -3504,6 +3525,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     gameType?: "hosted" | "external" | undefined;
     externalUrl?: string | undefined;
     mapElementId?: string | null | undefined;
+    visibility?: "visible" | "unlisted" | "internal" | undefined;
 }>;
 
 declare const InsertItemSchema: drizzle_zod.BuildSchema<"insert", {
@@ -5684,6 +5706,14 @@ interface DatabaseIntegration {
      *  When omitted, auto-detects based on presence of a migrations directory with _journal.json. */
     strategy?: 'push' | 'migrate';
 }
+interface QueueConfig {
+    maxBatchSize?: number;
+    maxRetries?: number;
+    maxBatchTimeout?: number;
+    maxConcurrency?: number;
+    retryDelay?: number;
+    deadLetterQueue?: string;
+}
 /**
  * Integrations configuration
  * All backend features (database, custom routes, external services) are configured here
@@ -5701,6 +5731,8 @@ interface IntegrationsConfig {
     bucket?: boolean;
     /** Authentication (optional) */
     auth?: boolean;
+    /** Queues (optional) */
+    queues?: Record<string, QueueConfig | boolean>;
 }
 /**
  * Unified Playcademy configuration

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.2.13",
+    "version": "0.3.0",
     "type": "module",
     "exports": {
         ".": {
@@ -49,7 +49,7 @@
         "@playcademy/timeback": "0.0.1",
         "@playcademy/utils": "0.0.1",
         "@types/bun": "latest",
-        "playcademy": "0.16.9",
+        "playcademy": "0.16.17",
         "rollup": "^4.50.2",
         "rollup-plugin-dts": "^6.2.3",
         "typescript": "^5.7.2"