@wpkernel/core v0.12.1-beta.3

---

@wpkernel/core / ActionContext

Type Alias: ActionContext

type ActionContext = object;

Primary API surface passed to action implementations.

The ActionContext provides actions with all the integration points they need:

• Event emission for domain events
• Cache invalidation for resource stores
• Background job scheduling
• Authorization checks
• Structured logging
• Identity metadata (requestId, namespace)

This is the second parameter to every action function.

Example

async function CreatePost(ctx: ActionContext, input: CreatePostInput) {
  // Authorization
  ctx.capability.assert('edit_posts');

  // Logging
  ctx.reporter.info('Creating post', { input });

  // Resource mutation
  const post = await api.posts.create(input);

  // Domain event
  ctx.emit('post.created', { postId: post.id });

  // Cache invalidation
  ctx.invalidate(['posts', `post:${post.id}`]);

  // Background job
  await ctx.jobs.enqueue('email.notification', { postId: post.id });

  return post;
}

Properties

capability

readonly capability: Pick<CapabilityHelpers<Record<string, unknown>>, "assert" | "can">;

Capability enforcement helpers.

---

emit()

emit: (eventName, payload) => void;

Emit canonical events.

Parameters

eventName

string

payload

unknown

Returns

void

---

invalidate()

invalidate: (patterns, options?) => void;

Invalidate cache keys.

Parameters

patterns

CacheKeyPattern | CacheKeyPattern[]

options?

InvalidateOptions

Returns

void

---

jobs

readonly jobs: ActionJobs;

Background job helpers.

---

namespace

readonly namespace: string;

Resolved namespace of the current action.

---

reporter

readonly reporter: Reporter;

Structured logging surface.

---

requestId

readonly requestId: string;

Correlation identifier shared with transport calls.