@devvit/shared-types 0.13.7 → 0.13.8-next-2026-07-07-16-52-11-2d38e4efd.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devvit/shared-types",
-  "version": "0.13.7",
+  "version": "0.13.8-next-2026-07-07-16-52-11-2d38e4efd.0",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
@@ -32,13 +32,14 @@
   },
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@devvit/protos": "0.13.7",
+    "@devvit/protos": "0.13.8-next-2026-07-07-16-52-11-2d38e4efd.0",
     "jsonschema": "1.4.1",
+    "jwt-decode": "4.0.0",
     "uuid": "14.0.0"
   },
   "devDependencies": {
-    "@devvit/repo-tools": "0.13.7",
-    "@devvit/tsconfig": "0.13.7",
+    "@devvit/repo-tools": "0.13.8-next-2026-07-07-16-52-11-2d38e4efd.0",
+    "@devvit/tsconfig": "0.13.8-next-2026-07-07-16-52-11-2d38e4efd.0",
     "@types/node": "20.14.12",
     "@types/redis-mock": "0.17.1",
     "@types/uuid": "9.0.0",
@@ -51,5 +52,5 @@
     "vitest": "4.1.0"
   },
   "source": "./src/index.ts",
-  "gitHead": "0d74a011329bf736fdc2deb9e9bacc555b0eea1b"
+  "gitHead": "4eb74d95ef13ee856127c7c8f3b169c05e40f053"
 }

package/server/base-context.d.ts

@@ -0,0 +1,4 @@
+import type { Metadata } from '@devvit/protos/lib/Types.js';
+import type { BaseContext } from '../shared/baseContext.js';
+export declare function BaseContextFromMetadata(meta: Metadata, postId: string | undefined, commentId: string | undefined): BaseContext;
+//# sourceMappingURL=base-context.d.ts.map

package/server/base-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-context.d.ts","sourceRoot":"","sources":["../../src/server/base-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAM5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAS5D,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,WAAW,CA2Cb"}

package/server/base-context.js

@@ -0,0 +1,56 @@
+import { jwtDecode } from 'jwt-decode';
+import { Header } from '../Header.js';
+import { assertNonNull } from '../NonNull.js';
+import { T1, T2, T3, T5 } from '../tid.js';
+export function BaseContextFromMetadata(meta, postId, commentId) {
+    const subredditId = meta[Header.Subreddit]?.values[0];
+    assertNonNull(subredditId, 'subreddit is missing from Context');
+    // 'devvit-post-data' is a JSON string. If set in the header, parse it as
+    // DevvitPostData.
+    let postData;
+    const postDataJson = meta[Header.PostData]?.values[0];
+    if (postDataJson) {
+        // Hack: assume DevvitPostData is JSON compatible for outdated iOS releases
+        //       around 2025.39.1.616587.
+        postData = JSON.parse(postDataJson).developerData;
+    }
+    const appSlug = meta[Header.App]?.values[0];
+    let signedRequestContext;
+    try {
+        // TODO - Use the RequestContext to extract other metadata like postData,
+        // userId, username, etc.
+        signedRequestContext = decodeSignedRequestContext(meta[Header.Context]?.values[0]);
+    }
+    catch {
+        //
+    }
+    const loid = signedRequestContext?.user?.devvitLoid ??
+        // to-do: stop sending snake_case for some data inconsistently.
+        signedRequestContext?.user?.devvit_loid;
+    const userId = meta[Header.User]?.values[0];
+    return {
+        appName: appSlug,
+        appSlug,
+        appVersion: meta[Header.Version]?.values[0],
+        commentId: commentId ? T1(commentId) : undefined,
+        loid,
+        postData,
+        postId: postId ? T3(postId) : undefined,
+        snoovatar: meta[Header.UserSnoovatarUrl]?.values[0],
+        subredditId: T5(subredditId),
+        subredditName: meta[Header.SubredditName]?.values[0],
+        userId: userId ? T2(userId) : undefined,
+        username: meta[Header.Username]?.values[0],
+    };
+}
+/** Decodes the signed request-context JWT. */
+function decodeSignedRequestContext(token) {
+    if (!token)
+        return;
+    try {
+        return jwtDecode(token)?.devvit;
+    }
+    catch (err) {
+        throw Error('token decode failure', { cause: err });
+    }
+}

package/server/base-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-context.test.d.ts","sourceRoot":"","sources":["../../src/server/base-context.test.ts"],"names":[],"mappings":""}

package/test/fake-jwt.d.ts

@@ -0,0 +1,8 @@
+import type { RequestContext, UserContext } from '@devvit/protos/json/devvit/platform/v1/request_context.js';
+export type PartialRequestContext = Partial<Omit<RequestContext, 'user'>> & {
+    user?: Partial<UserContext> & {
+        devvit_loid?: string;
+    };
+};
+export declare function fakeContextJwt(reqCtx: Readonly<PartialRequestContext>): string;
+//# sourceMappingURL=fake-jwt.d.ts.map

package/test/fake-jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-jwt.d.ts","sourceRoot":"","sources":["../../src/test/fake-jwt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACZ,MAAM,2DAA2D,CAAC;AAEnE,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAAG;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD,CAAC;AAEF,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAI9E"}

package/test/fake-jwt.js

@@ -0,0 +1,5 @@
+export function fakeContextJwt(reqCtx) {
+    const header = btoa(JSON.stringify({ alg: 'none', typ: 'JWT' }));
+    const payload = btoa(JSON.stringify({ devvit: reqCtx }));
+    return `${header}.${payload}.`;
+}