ManagementExpressRouterOptions

Defined in: management-express/src/types.ts:140

Options for creating an Express router backed by the Monque Management Surface.

This extends the framework-neutral ManagementOptions from @monque/management with Express-specific request context creation and optional adapter-served OpenAPI JSON.

The adapter does not implement authentication itself. Put host authentication middleware before the router, then use context and authorize for action-grained management authorization when needed.

Example

Mount the adapter under /monque.

import { createManagementExpressRouter } from '@monque/management-express';
import express from 'express';

const app = express();

app.use(
	'/monque',
	requireOperator,
	createManagementExpressRouter({
		monque,
		context: ({ req }) => ({
			userId: req.get('x-user-id') ?? 'anonymous',
		}),
		authorize: ({ action, context }) => {
			return context.userId !== 'anonymous' || action === 'read';
		},
		openApi: {
			path: '/docs/openapi.json',
			serverUrl: 'https://ops.example.com/monque',
		},
	}),
);

Extends

• ManagementOptions<TContext>

Type Parameters

Type Parameter	Default type	Description
TContext	unknown	Application-specific context exposed to management hooks.

Properties

authorize?

optional authorize?: ManagementAuthorize<TContext>;

Defined in: management/dist/index.d.mts:112

Optional authorization hook invoked before reads and mutations.

Inherited from

ManagementOptions.authorize

---

context?

optional context?: ManagementExpressContextFactory<TContext>;

Defined in: management-express/src/types.ts:149

Optional factory that maps Express request state into Management Surface context.

The returned value is available to management authorize, serializePayload, and serializePayloadByJobName hooks as their context input.

---

maxBodySize?

optional maxBodySize?: number;

Defined in: management/dist/index.d.mts:107

Maximum request body size in bytes. Defaults to 65,536 bytes.

Inherited from

ManagementOptions.maxBodySize

---

monque

monque: ManagementMonque;

Defined in: management/dist/index.d.mts:105

Scheduler instance or facade backing the management endpoints.

Inherited from

ManagementOptions.monque

---

openApi?

optional openApi?: 
  | false
  | ManagementExpressOpenApiOptions;

Defined in: management-express/src/types.ts:158

Adapter-served OpenAPI JSON configuration.

Pass false when the host application serves the generated OpenAPI document itself. Pass an object to customize the router-relative path or OpenAPI server URL.

Default

{ path: '/openapi.json', serverUrl: req.baseUrl }

---

parallelCapabilityChecks?

optional parallelCapabilityChecks?: boolean;

Defined in: management/dist/index.d.mts:114

Opt in only when authorization checks can run independently. Defaults to sequential.

Inherited from

ManagementOptions.parallelCapabilityChecks

---

readOnly?

optional readOnly?: boolean;

Defined in: management/dist/index.d.mts:110

When true, all mutation endpoints return 403 even if the scheduler supports them.

Inherited from

ManagementOptions.readOnly

---

serializePayload?

optional serializePayload?: ManagementPayloadSerializer<TContext>;

Defined in: management/dist/index.d.mts:116

Default payload serializer for returned jobs.

Inherited from

ManagementOptions.serializePayload

---

serializePayloadByJobName?

optional serializePayloadByJobName?: Record<string, ManagementPayloadSerializer<TContext>>;

Defined in: management/dist/index.d.mts:118

Payload serializers keyed by job name, taking precedence over serializePayload.

Inherited from

ManagementOptions.serializePayloadByJobName

---

trustedOrigins?

optional trustedOrigins?: readonly string[];

Defined in: management/dist/index.d.mts:108

Inherited from

ManagementOptions.trustedOrigins