@playcademy/sdk 0.12.1-beta.3 → 0.13.0-beta.1

package/dist/assets.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Content-addressable asset resolver.
+ *
+ * Provides a synchronous `asset()` function that maps logical asset paths
+ * to their content-hashed R2 URLs. The manifest is injected into the page
+ * by the edge worker via HTMLRewriter before any JS modules evaluate,
+ * so `asset()` is safe to use at module scope.
+ *
+ * @example
+ * ```ts
+ * import { asset } from '@playcademy/sdk/assets'
+ *
+ * // Regular function call
+ * const heroUrl = asset('sprites/hero.png')
+ *
+ * // Tagged template literal
+ * const bossUrl = asset`bosses/${bossId}/idle.png`
+ *
+ * // Module-scope constants (safe — manifest is available before module evaluation)
+ * const ASSETS = {
+ *     bg: asset('backgrounds/title.webp'),
+ *     music: asset('audio/theme.mp3'),
+ * }
+ * ```
+ *
+ * @module
+ */
+/**
+ * Resolves a logical asset path to its content-hashed URL.
+ *
+ * Supports both regular function calls and tagged template literals:
+ * - `asset('sprites/hero.png')` — string argument
+ * - `asset\`sprites/${name}.png\`` — tagged template
+ *
+ * When no manifest is available (local dev, or the game doesn't use the asset
+ * pipeline), returns the path unchanged.
+ */
+declare function asset(pathOrStrings: string | TemplateStringsArray, ...values: unknown[]): string;
+
+export { asset };

package/dist/assets.js

@@ -0,0 +1,38 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/assets.ts
+function getManifest() {
+  return globalThis.__PLAYCADEMY_ASSET_MANIFEST ?? null;
+}
+function asset(pathOrStrings, ...values) {
+  let path;
+  if (Array.isArray(pathOrStrings) && "raw" in pathOrStrings) {
+    const strings = pathOrStrings;
+    path = strings.reduce((acc, str, i) => acc + str + (values[i] != null ? String(values[i]) : ""), "");
+  } else {
+    path = pathOrStrings;
+  }
+  const cleanPath = path.startsWith("./") ? path.slice(2) : path;
+  const manifest = getManifest();
+  if (!manifest) {
+    return cleanPath;
+  }
+  const hashedKey = manifest.files[cleanPath];
+  if (hashedKey === undefined) {
+    return cleanPath;
+  }
+  return manifest.base != null ? `${manifest.base}${hashedKey}` : hashedKey;
+}
+export {
+  asset
+};

package/dist/index.js

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

package/dist/internal.d.ts

@@ -2215,7 +2215,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     metadata: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>>>;
     gameType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hosted", "external"]>>>;
     visibility: z.ZodOptional<z.ZodEnum<["visible", "unlisted", "internal"]>>;
-    externalUrl: z.ZodOptional<z.ZodString>;
+    externalUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
     displayName: string;
     platform: "godot" | "unity" | "web";
@@ -2631,6 +2631,17 @@ interface CustomRoutesIntegration {
     /** Directory for custom API routes (defaults to 'server/api') */
     directory?: string;
 }
+/**
+ * Bucket storage integration
+ */
+interface BucketIntegration {
+    /**
+     * Directory whose contents are synced to the bucket by `playcademy bucket
+     * sync` (defaults to 'bucket'). Synced as a single content-addressed tree:
+     * the whole directory is the manifest's source of truth.
+     */
+    directory?: string;
+}
 /**
  * Database integration
  */
@@ -2663,7 +2674,7 @@ interface IntegrationsConfig {
     /** Key-Value storage (optional) */
     kv?: boolean;
     /** Bucket storage (optional) */
-    bucket?: boolean;
+    bucket?: BucketIntegration | boolean;
     /** Authentication (optional) */
     auth?: boolean;
     /** Queues (optional) */

package/dist/internal.js

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

package/dist/server/edge.d.ts

@@ -64,6 +64,17 @@ interface CustomRoutesIntegration {
     /** Directory for custom API routes (defaults to 'server/api') */
     directory?: string;
 }
+/**
+ * Bucket storage integration
+ */
+interface BucketIntegration {
+    /**
+     * Directory whose contents are synced to the bucket by `playcademy bucket
+     * sync` (defaults to 'bucket'). Synced as a single content-addressed tree:
+     * the whole directory is the manifest's source of truth.
+     */
+    directory?: string;
+}
 /**
  * Database integration
  */
@@ -96,7 +107,7 @@ interface IntegrationsConfig {
     /** Key-Value storage (optional) */
     kv?: boolean;
     /** Bucket storage (optional) */
-    bucket?: boolean;
+    bucket?: BucketIntegration | boolean;
     /** Authentication (optional) */
     auth?: boolean;
     /** Queues (optional) */

package/dist/server/edge.js

@@ -233,7 +233,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.12.1-beta.3";
+var SDK_VERSION = "0.13.0-beta.1";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.d.ts

@@ -64,6 +64,17 @@ interface CustomRoutesIntegration {
     /** Directory for custom API routes (defaults to 'server/api') */
     directory?: string;
 }
+/**
+ * Bucket storage integration
+ */
+interface BucketIntegration {
+    /**
+     * Directory whose contents are synced to the bucket by `playcademy bucket
+     * sync` (defaults to 'bucket'). Synced as a single content-addressed tree:
+     * the whole directory is the manifest's source of truth.
+     */
+    directory?: string;
+}
 /**
  * Database integration
  */
@@ -96,7 +107,7 @@ interface IntegrationsConfig {
     /** Key-Value storage (optional) */
     kv?: boolean;
     /** Bucket storage (optional) */
-    bucket?: boolean;
+    bucket?: BucketIntegration | boolean;
     /** Authentication (optional) */
     auth?: boolean;
     /** Queues (optional) */

package/dist/server.js

@@ -422,7 +422,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.12.1-beta.3";
+var SDK_VERSION = "0.13.0-beta.1";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/types.d.ts

@@ -257,6 +257,17 @@ interface CustomRoutesIntegration {
     /** Directory for custom API routes (defaults to 'server/api') */
     directory?: string;
 }
+/**
+ * Bucket storage integration
+ */
+interface BucketIntegration {
+    /**
+     * Directory whose contents are synced to the bucket by `playcademy bucket
+     * sync` (defaults to 'bucket'). Synced as a single content-addressed tree:
+     * the whole directory is the manifest's source of truth.
+     */
+    directory?: string;
+}
 /**
  * Database integration
  */
@@ -289,7 +300,7 @@ interface IntegrationsConfig {
     /** Key-Value storage (optional) */
     kv?: boolean;
     /** Bucket storage (optional) */
-    bucket?: boolean;
+    bucket?: BucketIntegration | boolean;
     /** Authentication (optional) */
     auth?: boolean;
     /** Queues (optional) */
@@ -1049,7 +1060,7 @@ declare const UpsertGameMetadataSchema: z.ZodEffects<z.ZodObject<{
     metadata: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>>>;
     gameType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["hosted", "external"]>>>;
     visibility: z.ZodOptional<z.ZodEnum<["visible", "unlisted", "internal"]>>;
-    externalUrl: z.ZodOptional<z.ZodString>;
+    externalUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
     displayName: string;
     platform: "godot" | "unity" | "web";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.12.1-beta.3",
+    "version": "0.13.0-beta.1",
     "type": "module",
     "exports": {
         ".": {
@@ -33,6 +33,12 @@
             "import": "./dist/server/edge.js",
             "require": "./dist/server/edge.js"
         },
+        "./assets": {
+            "source": "./src/assets.ts",
+            "types": "./dist/assets.d.ts",
+            "import": "./dist/assets.js",
+            "require": "./dist/assets.js"
+        },
         "./test": {
             "import": "./src/test.ts",
             "types": "./src/test.ts"