@wvdsh/api 0.1.48 → 0.1.49

package/dist/_generated/constants.d.ts

@@ -207,6 +207,28 @@ export declare const UrlParams: {
     readonly SdkConfig: "sdkconfig";
     readonly Caller: "caller";
     readonly GameSlug: "gameSlug";
+    readonly UgcUploadExpires: "exp";
+    readonly UgcUploadSignature: "sig";
+};
+/** @internal UGC/userfs storage contract shared by Convex and the play worker — not game-facing API. */
+export declare const UgcStorage: {
+    readonly KEY_INFIX: "/ugcid/";
+    readonly buildKey: (gameCloudId: GenericId<"gameClouds">, uuid: string) => string;
+    readonly isUgcKey: (key: string) => boolean;
+    readonly USERFS_INFIX: "/userfs/";
+    readonly userfsPrefix: (gameCloudId: GenericId<"gameClouds">, userId: GenericId<"users">) => string;
+    readonly parseUserfsKey: (key: string) => {
+        gameCloudId: GenericId<"gameClouds">;
+        userId: GenericId<"users">;
+        path: string;
+    } | null;
+    readonly buildUploadSignaturePayload: (args: {
+        exp: string | number;
+        sub: string;
+        objectKey: string;
+    }) => string;
+    readonly encodeKeyPath: (objectKey: string) => string;
+    readonly decodeKeyPath: (pathname: string) => string;
 };
 export declare const PlayRouteCaller: {
     readonly Wavedash: "wavedash";

package/dist/_generated/constants.js

@@ -130,7 +130,62 @@ export const UrlParams = {
     SdkConfig: 'sdkconfig',
     Caller: 'caller',
     // Read by the cross-origin play iframe for its Sentry tags — it can't read this URL.
-    GameSlug: 'gameSlug'
+    GameSlug: 'gameSlug',
+    // Signed upload URL params authorizing a UGC/userfs PUT (see createUgcUploadUrl).
+    UgcUploadExpires: 'exp',
+    UgcUploadSignature: 'sig'
+};
+/** @internal UGC/userfs storage contract shared by Convex and the play worker — not game-facing API. */
+export const UgcStorage = {
+    // UGC keys: `{gameCloudId}/ugcid/{uuid}`
+    KEY_INFIX: '/ugcid/',
+    buildKey(gameCloudId, uuid) {
+        return `${gameCloudId}${UgcStorage.KEY_INFIX}${uuid}`;
+    },
+    // Cheap UGC-vs-userfs classifier used by the R2 event webhook
+    isUgcKey(key) {
+        return key.indexOf(UgcStorage.KEY_INFIX) > 0;
+    },
+    // userfs (cloud-save) keys: `{gameCloudId}/userfs/{userId}/{path}`
+    USERFS_INFIX: '/userfs/',
+    // R2 key prefix covering all of a user's cloud saves in a game cloud
+    userfsPrefix(gameCloudId, userId) {
+        return `${gameCloudId}${UgcStorage.USERFS_INFIX}${userId}/`;
+    },
+    // Inverse of userfsPrefix; null when the key isn't a userfs key
+    parseUserfsKey(key) {
+        const infix = key.indexOf(UgcStorage.USERFS_INFIX);
+        if (infix <= 0)
+            return null;
+        const gameCloudId = key.slice(0, infix);
+        const afterInfix = key.slice(infix + UgcStorage.USERFS_INFIX.length);
+        const slash = afterInfix.indexOf('/');
+        if (slash <= 0)
+            return null;
+        const userId = afterInfix.slice(0, slash);
+        const path = afterInfix.slice(slash + 1);
+        if (!path)
+            return null;
+        return { gameCloudId, userId, path };
+    },
+    // Signed into upload URLs; digits-only exp + fixed-length sub keep the split unambiguous
+    buildUploadSignaturePayload(args) {
+        return `${args.exp}@${args.sub}@${args.objectKey}`;
+    },
+    // Object key → URL path, per segment so keys never encode to `%2F`
+    encodeKeyPath(objectKey) {
+        return objectKey.split('/').map(encodeURIComponent).join('/');
+    },
+    // Inverse of encodeKeyPath; malformed escapes fall back to the raw path (matches the worker)
+    decodeKeyPath(pathname) {
+        const rawPath = pathname.startsWith('/') ? pathname.slice(1) : pathname;
+        try {
+            return decodeURIComponent(rawPath);
+        }
+        catch {
+            return rawPath;
+        }
+    }
 };
 export const PlayRouteCaller = {
     Wavedash: 'wavedash'

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wvdsh/api",
-	"version": "0.1.48",
+	"version": "0.1.49",
 	"description": "Public API types and shared constants for the Wavedash platform",
 	"type": "module",
 	"main": "./dist/index.js",