getWorldHandlers

Returns a restricted view of the World exposing only the members that are safe to use at build time: createQueueHandler and specVersion. Framework adapters use it while generating workflow route handlers, before the deployment's runtime environment variables exist.

Unlike getWorld(), this function does not cache a fully configured World instance: caching at build time would lock in incomplete environment configuration.

import { getWorldHandlers } from "workflow/runtime";

const handlers = await getWorldHandlers();
console.log(handlers.specVersion);

API signature

Parameters

This function does not accept any parameters.

Returns

Returns a Promise<WorldHandlers>, where:

import type { World } from "@workflow/world";

type WorldHandlers = Pick<World, "createQueueHandler" | "specVersion">;

Related functions

• getWorld(): Resolve the full World instance at runtime.
• workflowEntrypoint(): Create the runtime route handler that shares the full World instance.