@devvit/server 0.11.16-next-2025-05-19-1403da2a7.0 → 0.11.16-next-2025-05-20-7f7f5d7b2.0

package/context.d.ts

@@ -0,0 +1,15 @@
+export type DevvitServerRequestContext = 42;
+/**
+ * Gets the current DevvitServerRequestContext. This is set by the server when handling a request.
+ * @returns The current DevvitServerRequestContext, or undefined if there is none.
+ */
+export declare function getContext(): DevvitServerRequestContext | undefined;
+/**
+ * Runs an async callback with the given DevvitServerRequestContext. Code in the callback can use
+ * `getContext()` to get the context.
+ * @internal
+ * @param context The context to run the callback with
+ * @param callback The callback to run
+ */
+export declare function runWithContext<T>(context: DevvitServerRequestContext, callback: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=context.d.ts.map

package/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAI5C;;;GAGG;AACH,wBAAgB,UAAU,IAAI,0BAA0B,GAAG,SAAS,CAEnE;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,OAAO,EAAE,0BAA0B,EACnC,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/context.js

@@ -0,0 +1,19 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const requestContext = new AsyncLocalStorage();
+/**
+ * Gets the current DevvitServerRequestContext. This is set by the server when handling a request.
+ * @returns The current DevvitServerRequestContext, or undefined if there is none.
+ */
+export function getContext() {
+    return requestContext.getStore();
+}
+/**
+ * Runs an async callback with the given DevvitServerRequestContext. Code in the callback can use
+ * `getContext()` to get the context.
+ * @internal
+ * @param context The context to run the callback with
+ * @param callback The callback to run
+ */
+export async function runWithContext(context, callback) {
+    return requestContext.run(context, callback);
+}

package/create-server.d.ts

@@ -0,0 +1,13 @@
+import { createServer as nodeCreateServer } from 'node:http';
+/**
+ * Creates a new Devvit server. This implements the same API as Node.js's `createServer` function,
+ * but we do not guarantee that this actually creates an HTTP server of any kind - it may be any
+ * kind of server under the hood. However, it will behave like an HTTP server in terms of the API.
+ */
+export declare const createServer: typeof nodeCreateServer;
+declare global {
+    namespace globalThis {
+        var enableWebbitBundlingHack: boolean;
+    }
+}
+//# sourceMappingURL=create-server.d.ts.map

package/create-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../src/create-server.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,gBAYjC,CAAC;AAuCF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU,CAAC;QAEnB,IAAI,wBAAwB,EAAE,OAAO,CAAC;KACvC;CACF"}

package/create-server.js

@@ -0,0 +1,39 @@
+import { createServer as nodeCreateServer } from 'node:http';
+import { runWithContext } from './context.js';
+/**
+ * Creates a new Devvit server. This implements the same API as Node.js's `createServer` function,
+ * but we do not guarantee that this actually creates an HTTP server of any kind - it may be any
+ * kind of server under the hood. However, it will behave like an HTTP server in terms of the API.
+ */
+export const createServer = (optionsOrRequestListener, requestListener) => {
+    if (typeof optionsOrRequestListener === 'function') {
+        return _createServer({}, optionsOrRequestListener);
+    }
+    return _createServer(optionsOrRequestListener ?? {}, requestListener);
+};
+function _createServer(options, requestListener) {
+    const server = nodeCreateServer(options, async (req, res) => {
+        // TODO: Implement request context
+        return runWithContext(42, async () => {
+            return requestListener?.(req, res);
+        });
+    });
+    // Modify the listen callback slightly, to do the Devvit-y bundling hack
+    // TODO: When we stop needing to execute code in the bundler, we can remove this. I suspect once
+    //  devvit.json is fully implemented, we won't need this anymore.
+    const originalListen = server.listen.bind(server);
+    server.listen = (...args) => {
+        // Yes we're using `any` here - we don't care about the types of the arguments, we just want to
+        // make sure we call the original listen function with the same arguments, and sadly using
+        // unknown here doesn't work.
+        if (globalThis.enableWebbitBundlingHack) {
+            // This is a hack to get around the fact that we use a side effect import to start the server in
+            // prod, but we really don't want to do that when we're just running the code to bundle it.
+            // We'll set this global variable in the bundler, and then we can check it here to see if we
+            // should actually start the server or not.
+            return server;
+        }
+        return originalListen(...args);
+    };
+    return server;
+}

package/get-server-port.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Gets the port the internal server should run on. Call this when starting the server to get the
+ * port to use.
+ * @example createServer(myHandler).listen(getServerPort());
+ * @returns The port to use for the server.
+ */
+export declare function getServerPort(): number;
+//# sourceMappingURL=get-server-port.d.ts.map

package/get-server-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-server-port.d.ts","sourceRoot":"","sources":["../src/get-server-port.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC"}

package/get-server-port.js

@@ -0,0 +1,14 @@
+import process from 'node:process';
+/**
+ * Gets the port the internal server should run on. Call this when starting the server to get the
+ * port to use.
+ * @example createServer(myHandler).listen(getServerPort());
+ * @returns The port to use for the server.
+ */
+export function getServerPort() {
+    const envPort = Number(process.env.WEBBIT_PORT);
+    if (isNaN(envPort)) {
+        return 3000;
+    }
+    return envPort;
+}

package/index.d.ts

@@ -1,3 +1,5 @@
+export { createServer } from './create-server.js';
+export { getServerPort } from './get-server-port.js';
 export { RequestContext, setRequestContext } from './request-context.js';
 export { defineConfig } from './webbit-post.js';
 export { webbitEnable } from './webbit-server.js';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/index.js

@@ -1,3 +1,5 @@
+export { createServer } from './create-server.js';
+export { getServerPort } from './get-server-port.js';
 export { RequestContext, setRequestContext } from './request-context.js';
 export { defineConfig } from './webbit-post.js';
 export { webbitEnable } from './webbit-server.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devvit/server",
-  "version": "0.11.16-next-2025-05-19-1403da2a7.0",
+  "version": "0.11.16-next-2025-05-20-7f7f5d7b2.0",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
@@ -23,13 +23,13 @@
   },
   "types": "./index.d.ts",
   "dependencies": {
-    "@devvit/protos": "0.11.16-next-2025-05-19-1403da2a7.0",
-    "@devvit/public-api": "0.11.16-next-2025-05-19-1403da2a7.0",
-    "@devvit/shared-types": "0.11.16-next-2025-05-19-1403da2a7.0"
+    "@devvit/protos": "0.11.16-next-2025-05-20-7f7f5d7b2.0",
+    "@devvit/public-api": "0.11.16-next-2025-05-20-7f7f5d7b2.0",
+    "@devvit/shared-types": "0.11.16-next-2025-05-20-7f7f5d7b2.0"
   },
   "devDependencies": {
-    "@devvit/repo-tools": "0.11.16-next-2025-05-19-1403da2a7.0",
-    "@devvit/tsconfig": "0.11.16-next-2025-05-19-1403da2a7.0",
+    "@devvit/repo-tools": "0.11.16-next-2025-05-20-7f7f5d7b2.0",
+    "@devvit/tsconfig": "0.11.16-next-2025-05-20-7f7f5d7b2.0",
     "eslint": "9.11.1",
     "typescript": "5.8.3",
     "vitest": "1.6.1"
@@ -38,5 +38,5 @@
     "directory": "dist"
   },
   "source": "./src/index.ts",
-  "gitHead": "862cc785cbc156fae11e746939f79905d6cb8888"
+  "gitHead": "7e1c25ed0a59347c7ae418749d076fa2b3bb81d7"
 }

package/webbit-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webbit-server.d.ts","sourceRoot":"","sources":["../src/webbit-server.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,oDAAoD,CAAC;AAI5D,wBAAgB,YAAY,IAAI,IAAI,CAInC;AAED,wBAAgB,eAAe,IAAI,YAAY,CAsB9C"}
+{"version":3,"file":"webbit-server.d.ts","sourceRoot":"","sources":["../src/webbit-server.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,oDAAoD,CAAC;AAM5D,wBAAgB,YAAY,IAAI,IAAI,CAInC;AAED,wBAAgB,eAAe,IAAI,YAAY,CAsB9C"}

package/webbit-server.js

@@ -1,6 +1,7 @@
 import { HttpMethod, WebbitServerDefinition, } from '@devvit/protos/types/devvit/actor/webbit/webbit.js';
 import { Devvit } from '@devvit/public-api';
 import { extendDevvitPrototype } from '@devvit/public-api/devvit/internals/helpers/extendDevvitPrototype.js';
+import { getServerPort } from './get-server-port.js';
 export function webbitEnable() {
     const server = newWebbitServer();
     extendDevvitPrototype('Request', server.Request);
@@ -9,7 +10,7 @@ export function webbitEnable() {
 export function newWebbitServer() {
     return {
         async Request(req, meta) {
-            const port = process.env.WEBBIT_PORT || '3000';
+            const port = getServerPort();
             // only set the body if the method is not GET or HEAD
             const body = [HttpMethod.GET, HttpMethod.HEAD].includes(req.method) ? null : req.body;
             const rsp = await fetch(new URL(req.path, `http://webbit.local:${port}`), {