@playcademy/sdk 0.16.1-beta.6 → 0.16.1-beta.7

package/dist/index.js

@@ -3421,7 +3421,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.6";
+var SDK_VERSION = "0.16.1-beta.7";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/internal.d.ts

@@ -3216,6 +3216,29 @@ interface BucketFile {
     lastModified: string;
     contentType?: string;
 }
+/**
+ * Options for a single-page bucket listing
+ */
+interface BucketListPageOptions {
+    /** Restrict results to keys starting with this prefix */
+    prefix?: string;
+    /** Opaque continuation cursor from the previous page's result */
+    cursor?: string;
+    /** Page size (1-1000); the server may return fewer */
+    limit?: number;
+    /** Roll deeper keys into `prefixes` entries, S3 delimiter style */
+    delimiter?: string;
+}
+/**
+ * One page of a bucket listing
+ */
+interface BucketFilePage {
+    files: BucketFile[];
+    /** Rolled-up common prefixes; present for delimiter listings that found any */
+    prefixes?: string[];
+    /** Present only when more pages remain */
+    cursor?: string;
+}
 /**
  * KV key entry
  */
@@ -3790,6 +3813,7 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
             };
             bucket: {
                 list: (slug: string, prefix?: string) => Promise<BucketFile[]>;
+                listPage: (slug: string, options?: BucketListPageOptions) => Promise<BucketFilePage>;
                 get: (slug: string, key: string) => Promise<ArrayBuffer>;
                 put: (slug: string, key: string, content: Blob | ArrayBuffer | Uint8Array, contentType?: string) => Promise<void>;
                 initiateUpload: (slug: string, key: string, contentType: string) => Promise<{
@@ -4051,4 +4075,4 @@ interface BeginInitHandshakeOptions {
 declare function beginInitHandshake({ iframe, origin, payload, onTimeout, onSendError }: BeginInitHandshakeOptions): () => void;
 
 export { ApiError, HANDSHAKE_MAX_DURATION_MS, HANDSHAKE_RESEND_INTERVAL_MS, INIT_WAIT_TIMEOUT_MS, MessageEvents, PlaycademyInternalClient as PlaycademyClient, PlaycademyError, PlaycademyInternalClient, beginInitHandshake, extractApiErrorInfo, isTrustedIframeMessage, messaging };
-export type { ApiErrorCode, ApiErrorInfo, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, ChildCheckpointRelay, ClientConfig, ClientEvents, CourseMastery, CourseXp, DemoEndOptions, DemoEndPayload, DevUploadEvent, DevUploadHooks, EmbedActivity, EmbedActivityAbandoned, EmbedActivityCompleted, EmbedActivityFailed, EmbedLaunchOptions, EmbedResumeEnvelope, EmbedResumeStore, EmbedSession, EmbedSessionTiming, EmbedTimebackRecording, ErrorResponseBody, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameCustomHostname, GameInitUser, GameRow as GameRecord, GameTokenResponse, GetHighestGradeMasteredOptions, GetMasteryOptions, GetXpOptions, HighestGradeMasteredResponse, HostedGame, InitErrorPayload, InitPayload, KVKeyEntry, KVKeyMetadata, KVSeedEntry, KVStatsResponse, KeyEventPayload, LaunchIntent, LoginResponse, MasteryResponse, MessageEventMap, ParentGameContext, ParentGameHandle, PlatformTimebackUser, PlatformTimebackUserContext, PlaycademyMode, PlaycademyServerClientConfig, PlaycademyServerClientState, ScoreSubmission, StartActivityOptions, StartActivityResult, TelemetryPayload, TimebackActivityEndRelay, TimebackActivityStartRelay, TimebackEnrollment, TimebackHeartbeatRelayRequest, TimebackInitContext, TimebackOrganization, TimebackUser, TimebackUserContext, TimebackUserHighestGradeMastered, TimebackUserMastery, TimebackUserRefreshField, TimebackUserRefreshOptions, TimebackUserXp, TokenRefreshPayload, TokenType, UpsertGameMetadataInput, UserRow as User, XpResponse };
+export type { ApiErrorCode, ApiErrorInfo, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, BucketFilePage, BucketListPageOptions, ChildCheckpointRelay, ClientConfig, ClientEvents, CourseMastery, CourseXp, DemoEndOptions, DemoEndPayload, DevUploadEvent, DevUploadHooks, EmbedActivity, EmbedActivityAbandoned, EmbedActivityCompleted, EmbedActivityFailed, EmbedLaunchOptions, EmbedResumeEnvelope, EmbedResumeStore, EmbedSession, EmbedSessionTiming, EmbedTimebackRecording, ErrorResponseBody, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameCustomHostname, GameInitUser, GameRow as GameRecord, GameTokenResponse, GetHighestGradeMasteredOptions, GetMasteryOptions, GetXpOptions, HighestGradeMasteredResponse, HostedGame, InitErrorPayload, InitPayload, KVKeyEntry, KVKeyMetadata, KVSeedEntry, KVStatsResponse, KeyEventPayload, LaunchIntent, LoginResponse, MasteryResponse, MessageEventMap, ParentGameContext, ParentGameHandle, PlatformTimebackUser, PlatformTimebackUserContext, PlaycademyMode, PlaycademyServerClientConfig, PlaycademyServerClientState, ScoreSubmission, StartActivityOptions, StartActivityResult, TelemetryPayload, TimebackActivityEndRelay, TimebackActivityStartRelay, TimebackEnrollment, TimebackHeartbeatRelayRequest, TimebackInitContext, TimebackOrganization, TimebackUser, TimebackUserContext, TimebackUserHighestGradeMastered, TimebackUserMastery, TimebackUserRefreshField, TimebackUserRefreshOptions, TimebackUserXp, TokenRefreshPayload, TokenType, UpsertGameMetadataInput, UserRow as User, XpResponse };

package/dist/internal.js

@@ -3461,8 +3461,26 @@ class DeployPipeline {
 }
 
 // src/namespaces/platform/dev.ts
+var BUCKET_LIST_PAGE_SIZE = 1000;
 function createDevNamespace(client) {
   const deploy = new DeployPipeline(client);
+  async function fetchBucketPage(slug, options = {}) {
+    const params = new URLSearchParams;
+    if (options.prefix) {
+      params.set("prefix", options.prefix);
+    }
+    if (options.cursor) {
+      params.set("cursor", options.cursor);
+    }
+    if (options.limit !== undefined) {
+      params.set("limit", String(options.limit));
+    }
+    if (options.delimiter) {
+      params.set("delimiter", options.delimiter);
+    }
+    const query = params.size > 0 ? `?${params.toString()}` : "";
+    return client["request"](`/games/${slug}/bucket${query}`, "GET");
+  }
   return {
     status: {
       apply: () => client["request"]("/dev/apply", "POST"),
@@ -3594,10 +3612,22 @@ function createDevNamespace(client) {
       },
       bucket: {
         list: async (slug, prefix) => {
-          const params = prefix ? `?prefix=${encodeURIComponent(prefix)}` : "";
-          const result = await client["request"](`/games/${slug}/bucket${params}`, "GET");
-          return result.files;
+          const files = [];
+          let cursor;
+          do {
+            const page = await fetchBucketPage(slug, {
+              prefix,
+              cursor,
+              limit: BUCKET_LIST_PAGE_SIZE
+            });
+            for (const file of page.files) {
+              files.push(file);
+            }
+            cursor = page.cursor;
+          } while (cursor);
+          return files;
         },
+        listPage: fetchBucketPage,
         get: async (slug, key) => {
           const res = await client["request"](`/games/${slug}/bucket/${encodeURIComponent(key)}`, "GET", { raw: true });
           if (!res.ok) {
@@ -4266,7 +4296,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.6";
+var SDK_VERSION = "0.16.1-beta.7";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/server/edge.js

@@ -303,7 +303,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.6";
+var SDK_VERSION = "0.16.1-beta.7";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.js

@@ -492,7 +492,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.6";
+var SDK_VERSION = "0.16.1-beta.7";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/types.d.ts

@@ -2578,6 +2578,29 @@ interface BucketFile {
     lastModified: string;
     contentType?: string;
 }
+/**
+ * Options for a single-page bucket listing
+ */
+interface BucketListPageOptions {
+    /** Restrict results to keys starting with this prefix */
+    prefix?: string;
+    /** Opaque continuation cursor from the previous page's result */
+    cursor?: string;
+    /** Page size (1-1000); the server may return fewer */
+    limit?: number;
+    /** Roll deeper keys into `prefixes` entries, S3 delimiter style */
+    delimiter?: string;
+}
+/**
+ * One page of a bucket listing
+ */
+interface BucketFilePage {
+    files: BucketFile[];
+    /** Rolled-up common prefixes; present for delimiter listings that found any */
+    prefixes?: string[];
+    /** Present only when more pages remain */
+    cursor?: string;
+}
 /**
  * KV key entry
  */
@@ -2671,4 +2694,4 @@ interface PlatformTimebackUser extends PlatformTimebackUserContext {
 }
 
 export { PlaycademyClient };
-export type { AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, ChildCheckpointRelay, ClientConfig, ClientEvents, CourseMastery, CourseXp, DemoEndOptions, DemoEndPayload, DevUploadEvent, DevUploadHooks, EmbedActivity, EmbedActivityAbandoned, EmbedActivityCompleted, EmbedActivityFailed, EmbedLaunchOptions, EmbedResumeEnvelope, EmbedResumeStore, EmbedSession, EmbedSessionTiming, EmbedTimebackRecording, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameCustomHostname, GameInitUser, GameRow as GameRecord, GameTokenResponse, GetHighestGradeMasteredOptions, GetMasteryOptions, GetXpOptions, HighestGradeMasteredResponse, HostedGame, InitErrorPayload, InitPayload, KVKeyEntry, KVKeyMetadata, KVSeedEntry, KVStatsResponse, KeyEventPayload, LaunchIntent, LoginResponse, MasteryResponse, ParentGameContext, ParentGameHandle, PlatformTimebackUser, PlatformTimebackUserContext, PlaycademyMode, PlaycademyServerClientConfig, PlaycademyServerClientState, ScoreSubmission, StartActivityOptions, StartActivityResult, TelemetryPayload, TimebackActivityEndRelay, TimebackActivityStartRelay, TimebackEnrollment, TimebackHeartbeatRelayRequest, TimebackInitContext, TimebackOrganization, TimebackUser, TimebackUserContext, TimebackUserHighestGradeMastered, TimebackUserMastery, TimebackUserRefreshField, TimebackUserRefreshOptions, TimebackUserXp, TokenRefreshPayload, TokenType, UpsertGameMetadataInput, UserRow as User, XpResponse };
+export type { AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, BucketFilePage, BucketListPageOptions, ChildCheckpointRelay, ClientConfig, ClientEvents, CourseMastery, CourseXp, DemoEndOptions, DemoEndPayload, DevUploadEvent, DevUploadHooks, EmbedActivity, EmbedActivityAbandoned, EmbedActivityCompleted, EmbedActivityFailed, EmbedLaunchOptions, EmbedResumeEnvelope, EmbedResumeStore, EmbedSession, EmbedSessionTiming, EmbedTimebackRecording, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameCustomHostname, GameInitUser, GameRow as GameRecord, GameTokenResponse, GetHighestGradeMasteredOptions, GetMasteryOptions, GetXpOptions, HighestGradeMasteredResponse, HostedGame, InitErrorPayload, InitPayload, KVKeyEntry, KVKeyMetadata, KVSeedEntry, KVStatsResponse, KeyEventPayload, LaunchIntent, LoginResponse, MasteryResponse, ParentGameContext, ParentGameHandle, PlatformTimebackUser, PlatformTimebackUserContext, PlaycademyMode, PlaycademyServerClientConfig, PlaycademyServerClientState, ScoreSubmission, StartActivityOptions, StartActivityResult, TelemetryPayload, TimebackActivityEndRelay, TimebackActivityStartRelay, TimebackEnrollment, TimebackHeartbeatRelayRequest, TimebackInitContext, TimebackOrganization, TimebackUser, TimebackUserContext, TimebackUserHighestGradeMastered, TimebackUserMastery, TimebackUserRefreshField, TimebackUserRefreshOptions, TimebackUserXp, TokenRefreshPayload, TokenType, UpsertGameMetadataInput, UserRow as User, XpResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.16.1-beta.6",
+    "version": "0.16.1-beta.7",
     "type": "module",
     "exports": {
         ".": {