@playcademy/sandbox 0.7.1-beta.6 → 0.7.1-beta.7

package/dist/cli.js

@@ -1118,7 +1118,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.7.1-beta.6",
+    version: "0.7.1-beta.7",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -32690,6 +32690,10 @@ var init_assessment_runtime_lock_util = __esm(() => {
 });
 
 // ../api-core/src/services/bucket.service.ts
+function hasPagingOptions(options) {
+  return options.cursor !== undefined || options.limit !== undefined || options.delimiter !== undefined;
+}
+
 class BucketService {
   deps;
   constructor(deps) {
@@ -32710,16 +32714,18 @@ class BucketService {
   getBucketName(slug) {
     return getGameDeploymentId(slug, this.deps.sstStage);
   }
-  async listFiles(slug, user, prefix) {
+  async listFiles(slug, user, options = {}) {
     const game2 = await this.deps.validateDeveloperAccessBySlug(user, slug);
     const bucketName = this.getBucketName(game2.slug);
-    const files = await this.deps.storage.listObjects(bucketName, prefix);
+    const paged = hasPagingOptions(options);
+    const page = paged ? await this.deps.storage.listObjectsPage(bucketName, options) : { files: await this.deps.storage.listObjects(bucketName, options.prefix) };
     setAttributes({
       "app.bucket.operation": "list",
-      "app.bucket.file_count": files.length,
-      "app.bucket.key_prefix": BucketService.getKeyPrefix(prefix)
+      "app.bucket.file_count": page.files.length,
+      "app.bucket.key_prefix": BucketService.getKeyPrefix(options.prefix),
+      "app.bucket.paged": paged
     });
-    return files;
+    return page;
   }
   async getFile(slug, key, user) {
     const game2 = await this.deps.validateDeveloperAccessBySlug(user, slug);
@@ -95256,6 +95262,13 @@ var init_cache_provider = __esm(() => {
   cache = new Map;
 });
 
+// ../utils/src/keys.ts
+function keyLevelEntry(key, prefix, delimiter) {
+  const remainder = key.slice(prefix.length);
+  const cut = remainder.indexOf(delimiter);
+  return cut === -1 ? { name: key, rolled: false } : { name: prefix + remainder.slice(0, cut + delimiter.length), rolled: true };
+}
+
 // src/infrastructure/api/providers/storage.provider.ts
 function getBucket(bucketName) {
   let bucket = storage.get(bucketName);
@@ -95269,18 +95282,57 @@ function createSandboxStorageProvider() {
   return {
     async listObjects(bucketName, prefix) {
       const bucket = getBucket(bucketName);
+      const keys = [...bucket.keys()].filter((key) => !prefix || key.startsWith(prefix)).toSorted();
+      return keys.map((key) => {
+        const data = bucket.get(key);
+        return {
+          key,
+          size: data.body.length,
+          lastModified: new Date().toISOString(),
+          contentType: data.contentType
+        };
+      });
+    },
+    async listObjectsPage(bucketName, options) {
+      const { cursor: cursor2, delimiter } = options;
+      const all = await this.listObjects(bucketName, options.prefix);
+      let entries;
+      if (delimiter) {
+        const requestPrefix = options.prefix ?? "";
+        const seen = new Set;
+        entries = [];
+        for (const file3 of all) {
+          const entry = keyLevelEntry(file3.key, requestPrefix, delimiter);
+          if (!entry.rolled) {
+            entries.push({ name: entry.name, file: file3 });
+          } else if (!seen.has(entry.name)) {
+            seen.add(entry.name);
+            entries.push({ name: entry.name });
+          }
+        }
+      } else {
+        entries = all.map((file3) => ({ name: file3.key, file: file3 }));
+      }
+      const remaining = cursor2 ? entries.filter((entry) => entry.name > cursor2) : entries;
+      const limit = options.limit ?? 1000;
+      const pageEntries = remaining.slice(0, limit);
       const files = [];
-      for (const [key, data] of bucket.entries()) {
-        if (!prefix || key.startsWith(prefix)) {
-          files.push({
-            key,
-            size: data.body.length,
-            lastModified: new Date().toISOString(),
-            contentType: data.contentType
-          });
+      const prefixes = [];
+      for (const entry of pageEntries) {
+        if (entry.file) {
+          files.push(entry.file);
+        } else {
+          prefixes.push(entry.name);
         }
       }
-      return files;
+      const page = { files };
+      if (prefixes.length > 0) {
+        page.prefixes = prefixes;
+      }
+      if (remaining.length > limit) {
+        page.cursor = pageEntries[pageEntries.length - 1].name;
+      }
+      return page;
     },
     async getObject(bucketName, key) {
       const bucket = getBucket(bucketName);
@@ -151126,6 +151178,17 @@ function requireUserId(userId) {
   }
   return userId;
 }
+function parseLimitParam(url4, max2) {
+  const raw2 = url4.searchParams.get("limit");
+  if (raw2 === null) {
+    return;
+  }
+  const limit = Number(raw2);
+  if (!Number.isInteger(limit) || limit < 1 || limit > max2) {
+    throw ApiError.badRequest(`limit must be an integer between 1 and ${max2}`);
+  }
+  return limit;
+}
 var init_params_util = __esm(() => {
   init_src5();
   init_errors2();
@@ -151197,8 +151260,10 @@ var init_bucket_controller = __esm(() => {
     }
     const url4 = ctx.url;
     const prefix2 = url4.searchParams.get("prefix") || undefined;
-    const files = await ctx.services.bucket.listFiles(slug2, ctx.user, prefix2);
-    return { files };
+    const cursor2 = url4.searchParams.get("cursor") || undefined;
+    const delimiter = url4.searchParams.get("delimiter") || undefined;
+    const limit = parseLimitParam(url4, 1000);
+    return ctx.services.bucket.listFiles(slug2, ctx.user, { prefix: prefix2, cursor: cursor2, limit, delimiter });
   });
   getFile = requireDeveloper(async (ctx) => {
     const slug2 = ctx.params.slug;
@@ -151463,14 +151528,7 @@ var init_deployment_state_controller = __esm(() => {
   });
   history = requireDeveloper(async (ctx) => {
     const slug2 = requireSlug(ctx.params.slug);
-    const limitParam = ctx.url.searchParams.get("limit");
-    let limit;
-    if (limitParam !== null) {
-      limit = Number(limitParam);
-      if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
-        throw ApiError.badRequest("limit must be an integer between 1 and 100");
-      }
-    }
+    const limit = parseLimitParam(ctx.url, 100);
     return ctx.services.deploymentState.history(slug2, ctx.user, { limit });
   });
   restorePoints = requireDeveloper(async (ctx) => {

package/dist/server.js

@@ -1117,7 +1117,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.7.1-beta.6",
+    version: "0.7.1-beta.7",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -32689,6 +32689,10 @@ var init_assessment_runtime_lock_util = __esm(() => {
 });
 
 // ../api-core/src/services/bucket.service.ts
+function hasPagingOptions(options) {
+  return options.cursor !== undefined || options.limit !== undefined || options.delimiter !== undefined;
+}
+
 class BucketService {
   deps;
   constructor(deps) {
@@ -32709,16 +32713,18 @@ class BucketService {
   getBucketName(slug) {
     return getGameDeploymentId(slug, this.deps.sstStage);
   }
-  async listFiles(slug, user, prefix) {
+  async listFiles(slug, user, options = {}) {
     const game2 = await this.deps.validateDeveloperAccessBySlug(user, slug);
     const bucketName = this.getBucketName(game2.slug);
-    const files = await this.deps.storage.listObjects(bucketName, prefix);
+    const paged = hasPagingOptions(options);
+    const page = paged ? await this.deps.storage.listObjectsPage(bucketName, options) : { files: await this.deps.storage.listObjects(bucketName, options.prefix) };
     setAttributes({
       "app.bucket.operation": "list",
-      "app.bucket.file_count": files.length,
-      "app.bucket.key_prefix": BucketService.getKeyPrefix(prefix)
+      "app.bucket.file_count": page.files.length,
+      "app.bucket.key_prefix": BucketService.getKeyPrefix(options.prefix),
+      "app.bucket.paged": paged
     });
-    return files;
+    return page;
   }
   async getFile(slug, key, user) {
     const game2 = await this.deps.validateDeveloperAccessBySlug(user, slug);
@@ -95255,6 +95261,13 @@ var init_cache_provider = __esm(() => {
   cache = new Map;
 });
 
+// ../utils/src/keys.ts
+function keyLevelEntry(key, prefix, delimiter) {
+  const remainder = key.slice(prefix.length);
+  const cut = remainder.indexOf(delimiter);
+  return cut === -1 ? { name: key, rolled: false } : { name: prefix + remainder.slice(0, cut + delimiter.length), rolled: true };
+}
+
 // src/infrastructure/api/providers/storage.provider.ts
 function getBucket(bucketName) {
   let bucket = storage.get(bucketName);
@@ -95268,18 +95281,57 @@ function createSandboxStorageProvider() {
   return {
     async listObjects(bucketName, prefix) {
       const bucket = getBucket(bucketName);
+      const keys = [...bucket.keys()].filter((key) => !prefix || key.startsWith(prefix)).toSorted();
+      return keys.map((key) => {
+        const data = bucket.get(key);
+        return {
+          key,
+          size: data.body.length,
+          lastModified: new Date().toISOString(),
+          contentType: data.contentType
+        };
+      });
+    },
+    async listObjectsPage(bucketName, options) {
+      const { cursor: cursor2, delimiter } = options;
+      const all = await this.listObjects(bucketName, options.prefix);
+      let entries;
+      if (delimiter) {
+        const requestPrefix = options.prefix ?? "";
+        const seen = new Set;
+        entries = [];
+        for (const file3 of all) {
+          const entry = keyLevelEntry(file3.key, requestPrefix, delimiter);
+          if (!entry.rolled) {
+            entries.push({ name: entry.name, file: file3 });
+          } else if (!seen.has(entry.name)) {
+            seen.add(entry.name);
+            entries.push({ name: entry.name });
+          }
+        }
+      } else {
+        entries = all.map((file3) => ({ name: file3.key, file: file3 }));
+      }
+      const remaining = cursor2 ? entries.filter((entry) => entry.name > cursor2) : entries;
+      const limit = options.limit ?? 1000;
+      const pageEntries = remaining.slice(0, limit);
       const files = [];
-      for (const [key, data] of bucket.entries()) {
-        if (!prefix || key.startsWith(prefix)) {
-          files.push({
-            key,
-            size: data.body.length,
-            lastModified: new Date().toISOString(),
-            contentType: data.contentType
-          });
+      const prefixes = [];
+      for (const entry of pageEntries) {
+        if (entry.file) {
+          files.push(entry.file);
+        } else {
+          prefixes.push(entry.name);
         }
       }
-      return files;
+      const page = { files };
+      if (prefixes.length > 0) {
+        page.prefixes = prefixes;
+      }
+      if (remaining.length > limit) {
+        page.cursor = pageEntries[pageEntries.length - 1].name;
+      }
+      return page;
     },
     async getObject(bucketName, key) {
       const bucket = getBucket(bucketName);
@@ -151125,6 +151177,17 @@ function requireUserId(userId) {
   }
   return userId;
 }
+function parseLimitParam(url4, max2) {
+  const raw2 = url4.searchParams.get("limit");
+  if (raw2 === null) {
+    return;
+  }
+  const limit = Number(raw2);
+  if (!Number.isInteger(limit) || limit < 1 || limit > max2) {
+    throw ApiError.badRequest(`limit must be an integer between 1 and ${max2}`);
+  }
+  return limit;
+}
 var init_params_util = __esm(() => {
   init_src5();
   init_errors2();
@@ -151196,8 +151259,10 @@ var init_bucket_controller = __esm(() => {
     }
     const url4 = ctx.url;
     const prefix2 = url4.searchParams.get("prefix") || undefined;
-    const files = await ctx.services.bucket.listFiles(slug2, ctx.user, prefix2);
-    return { files };
+    const cursor2 = url4.searchParams.get("cursor") || undefined;
+    const delimiter = url4.searchParams.get("delimiter") || undefined;
+    const limit = parseLimitParam(url4, 1000);
+    return ctx.services.bucket.listFiles(slug2, ctx.user, { prefix: prefix2, cursor: cursor2, limit, delimiter });
   });
   getFile = requireDeveloper(async (ctx) => {
     const slug2 = ctx.params.slug;
@@ -151462,14 +151527,7 @@ var init_deployment_state_controller = __esm(() => {
   });
   history = requireDeveloper(async (ctx) => {
     const slug2 = requireSlug(ctx.params.slug);
-    const limitParam = ctx.url.searchParams.get("limit");
-    let limit;
-    if (limitParam !== null) {
-      limit = Number(limitParam);
-      if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
-        throw ApiError.badRequest("limit must be an integer between 1 and 100");
-      }
-    }
+    const limit = parseLimitParam(ctx.url, 100);
     return ctx.services.deploymentState.history(slug2, ctx.user, { limit });
   });
   restorePoints = requireDeveloper(async (ctx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sandbox",
-    "version": "0.7.1-beta.6",
+    "version": "0.7.1-beta.7",
     "description": "Local development server for Playcademy game development",
     "type": "module",
     "exports": {