chore(template): clean-slate template snapshot from bb4a0c7

Curated, product-agnostic snapshot of the post-story-04 tree: demo
content deleted, auth-only reference feature, web-next shell, all gates
green. Product-specific docs, ADRs 027-029, PRDs/epics/archive, editor
library traces, and product naming are curated out; generic template
repairs (coverage provider devDeps, root test:coverage script, live
lint fixes, root-only release-please) are kept. See TEMPLATE.md for
provenance, curation list, and usage.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016j8z4VHjedXDTjEDNg7qHK

turbo/generators/templates/event/consume/event-task.ts.hbs

@@ -0,0 +1,26 @@
+// packages/{{kebabCase feature}}/src/integrations/cms/jobs/__events-{{kebabCase publisher}}-{{kebabCase event}}.task.ts
+// Generated by `gen event consume`. The PayloadJobsEventBus enqueues this task
+// when {{kebabCase publisher}} publishes `{{kebabCase publisher}}.{{event}}`. The handler
+// resolves the consumer's wrapped event handler from the per-feature container
+// and invokes it with the typed payload.
+import type { TaskConfig } from "payload";
+import { {{camelCase feature}}Container } from "../../../di/container";
+import { {{constantCase feature}}_SYMBOLS } from "../../../di/symbols";
+import type { IOn{{pascalCase publisher}}{{pascalCase event}}Handler } from "../../../events/handlers/on-{{kebabCase publisher}}-{{kebabCase event}}.handler";
+import type { {{pascalCase event}}Event } from "@repo/{{kebabCase publisher}}";
+
+export const on{{pascalCase publisher}}{{pascalCase event}}EventTask: TaskConfig<{
+  input: {{pascalCase event}}Event;
+  output: object;
+}> = {
+  slug: "__events.{{kebabCase publisher}}.{{event}}.{{kebabCase feature}}",
+  inputSchema: [],
+  retries: { attempts: 3, backoff: { type: "exponential", delay: 1000 } },
+  handler: async ({ input }) => {
+    const handler = {{camelCase feature}}Container.get<IOn{{pascalCase publisher}}{{pascalCase event}}Handler>(
+      {{constantCase feature}}_SYMBOLS.IOn{{pascalCase publisher}}{{pascalCase event}}Handler,
+    );
+    await handler(input);
+    return { output: {} };
+  },
+};

turbo/generators/templates/event/consume/handler.test.ts.hbs

@@ -0,0 +1,15 @@
+// packages/{{kebabCase feature}}/src/events/handlers/on-{{kebabCase publisher}}-{{kebabCase event}}.handler.test.ts
+import { describe, it, expect } from "vitest";
+import { on{{pascalCase publisher}}{{pascalCase event}}Handler } from "@/events/handlers/on-{{kebabCase publisher}}-{{kebabCase event}}.handler";
+
+describe("on{{pascalCase publisher}}{{pascalCase event}}Handler", () => {
+  it("returns a function (factory shape)", () => {
+    const handler = on{{pascalCase publisher}}{{pascalCase event}}Handler();
+    expect(typeof handler).toBe("function");
+  });
+
+  it("does not throw on a valid stub event", async () => {
+    const handler = on{{pascalCase publisher}}{{pascalCase event}}Handler();
+    await expect(handler({} as never)).resolves.toBeUndefined();
+  });
+});

turbo/generators/templates/event/consume/handler.ts.hbs

@@ -0,0 +1,14 @@
+// packages/{{kebabCase feature}}/src/events/handlers/on-{{kebabCase publisher}}-{{kebabCase event}}.handler.ts
+import type { {{pascalCase event}}Event } from "@repo/{{kebabCase publisher}}";
+
+export type IOn{{pascalCase publisher}}{{pascalCase event}}Handler = ReturnType<
+  typeof on{{pascalCase publisher}}{{pascalCase event}}Handler
+>;
+
+export const on{{pascalCase publisher}}{{pascalCase event}}Handler =
+  () =>
+  async (_event: {{pascalCase event}}Event): Promise<void> => {
+    // TODO: implement the reaction. Inject dependencies via the factory's
+    // constructor and use them here. The handler runs inside the consumer's
+    // span+capture sandwich, so just throwing on failure is the right shape.
+  };

turbo/generators/templates/event/publish/event.test.ts.hbs

@@ -0,0 +1,13 @@
+// packages/{{kebabCase feature}}/src/events/{{kebabCase event}}.event.test.ts
+import { describe, it, expect } from "vitest";
+import { {{camelCase event}}EventSchema, {{camelCase event}}Event } from "@/events/{{kebabCase event}}.event";
+
+describe("{{camelCase event}}Event", () => {
+  it("has the correct wire name", () => {
+    expect({{camelCase event}}Event.name).toBe("{{kebabCase feature}}.{{event}}");
+  });
+
+  it("validates an empty payload (stub schema)", () => {
+    expect(() => {{camelCase event}}EventSchema.parse({})).not.toThrow();
+  });
+});

turbo/generators/templates/event/publish/event.ts.hbs

@@ -0,0 +1,12 @@
+// packages/{{kebabCase feature}}/src/events/{{kebabCase event}}.event.ts
+import { z } from "zod";
+import { defineEvent } from "@repo/core-events";
+
+export const {{camelCase event}}EventSchema = z.object({}).strict();
+
+export type {{pascalCase event}}Event = z.infer<typeof {{camelCase event}}EventSchema>;
+
+export const {{camelCase event}}Event = defineEvent(
+  "{{kebabCase feature}}.{{event}}",
+  {{camelCase event}}EventSchema,
+);