create-nexwire 4.0.0 → 4.1.0

package/express/src/framework/maker-cli/stubs/example/job.ts.stub

@@ -1,75 +0,0 @@
-import { cache, dispatchEvent, shouldQueue } from "@/framework/facade.js";
-import { generatePdfToken } from "@/modules/{{module}}/controllers/{{module}}.controller.js";
-
-/**
- * event: Event name this worker listens to.
- * queue: Queue name where jobs are consumed from.
- * handler: Async processor that receives `job.data`.
- */
-shouldQueue("{{module}}.process", "default", async (job) => {
-  const waitSeconds = Number(job.data.waitSeconds || 1);
-  await new Promise(resolve => setTimeout(resolve, waitSeconds * 1000));
-
-  await cache.put("{{module}}:last-command-job", {
-    payload: job.data,
-    handledAt: new Date().toISOString()
-  }, 120);
-
-  /**
-   * dispatchEvent name: Event id to publish to listeners.
-   * payload: Data sent to queue/broadcast consumers.
-   * queue: Optional queue target for async event consumers.
-   * broadcast: Optional realtime fanout (all/users/roles/rooms).
-   */
-  await dispatchEvent("{{module}}.process.finished", {
-    ...job.data,
-    handledAt: new Date().toISOString()
-  }, {
-    broadcast: { all: true }
-  });
-
-  return { ok: true, mode: "queue" };
-});
-
-shouldQueue("{{module}}.created", "default", async (job) => {
-  await cache.put("{{module}}:last-created-event", job.data, 120);
-  return { ok: true, mode: "event-queue" };
-});
-
-shouldQueue("{{module}}.scheduler.tick", "default", async (job) => {
-  await cache.put("{{module}}:last-scheduler-job", job.data, 120);
-  return { ok: true, mode: "scheduler-queue" };
-});
-
-shouldQueue("{{module}}.pdf.generate", "default", async (job) => {
-  const requestId = String(job.data.requestId || "");
-
-  if (!requestId) {
-    return { ok: false, mode: "pdf-queue", message: "Missing requestId" };
-  }
-
-  const key = `{{module}}:pdf:status:${requestId}`;
-
-  try {
-    const token = await generatePdfToken({
-      title: String(job.data.title || "Example PDF Report"),
-      rows: Number(job.data.rows || 1000),
-      chunkSize: Number(job.data.chunkSize || 250)
-    });
-
-    await cache.put(key, {
-      state: "ready",
-      token,
-      readyAt: new Date().toISOString()
-    }, 1800);
-
-    return { ok: true, mode: "pdf-queue" };
-  } catch (error) {
-    await cache.put(key, {
-      state: "failed",
-      message: error instanceof Error ? error.message : "Unknown error"
-    }, 1800);
-    return { ok: false, mode: "pdf-queue" };
-  }
-});
-

package/express/src/framework/maker-cli/stubs/example/route.api.ts.stub

@@ -1,207 +0,0 @@
-import { createRoute, createRouter, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
-import { env } from "@/env.js";
-import { downloadGenerated, downloadGeneratedExcel, downloadGeneratedPdf, fire, fireBroadcast, fireQueued, fireQueuedBroadcast, generateDownload, generateExcelDownload, generatePdfDownload, importExcel, queueCommand, upload } from "@/modules/{{module}}/controllers/{{module}}.controller.js";
-import { DownloadTokenSchema, ExcelDownloadRequestSchema, ExampleEventSchema, PdfGenerateAcceptedSchema, PdfGenerateRequestSchema, QueueCommandRequestSchema, UploadResponseSchema } from "@/modules/{{module}}/controllers/{{module}}.schema.js";
-
-const eventRoute = createRoute({
-  path: "/event",
-  method: "post",
-  tags: ["Examples"],
-  request: {
-    body: jsonContent(ExampleEventSchema, "Examples event payload")
-  },
-  responses: {
-    [HttpStatusCodes.ACCEPTED]: jsonContent(z.object({ message: z.string(), data: ExampleEventSchema }), "Event accepted")
-  }
-});
-
-const queueCommandRoute = createRoute({
-  path: "/queue/command",
-  method: "post",
-  tags: ["Examples"],
-  request: {
-    body: jsonContent(QueueCommandRequestSchema, "Queue command payload")
-  },
-  responses: {
-    [HttpStatusCodes.ACCEPTED]: jsonContent(z.object({ message: z.string(), data: QueueCommandRequestSchema }), "Queue command dispatched")
-  }
-});
-
-const queuedEventRoute = createRoute({
-  path: "/event/queued",
-  method: "post",
-  tags: ["Examples"],
-  request: {
-    body: jsonContent(ExampleEventSchema, "Queued event payload")
-  },
-  responses: {
-    [HttpStatusCodes.ACCEPTED]: jsonContent(z.object({ message: z.string(), data: ExampleEventSchema }), "Queued event accepted")
-  }
-});
-
-const queuedBroadcastEventRoute = createRoute({
-  path: "/event/queued-broadcast",
-  method: "post",
-  tags: ["Examples"],
-  request: {
-    body: jsonContent(ExampleEventSchema, "Queued broadcast event payload")
-  },
-  responses: {
-    [HttpStatusCodes.ACCEPTED]: jsonContent(z.object({ message: z.string(), data: ExampleEventSchema }), "Queued broadcast event accepted")
-  }
-});
-
-const broadcastRoute = createRoute({
-  path: "/event/broadcast",
-  method: "post",
-  tags: ["Examples"],
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent(z.object({
-      message: z.string(),
-      data: z.object({ message: z.string(), firedAt: z.string() })
-    }), "Broadcast event dispatched")
-  }
-});
-
-const uploadRoute = createRoute({
-  path: "/upload",
-  method: "post",
-  tags: ["Examples"],
-  request: {
-    body: {
-      content: {
-        "multipart/form-data": {
-          schema: z.object({ file: z.any().openapi({ type: "string", format: "binary" }) })
-        }
-      }
-    }
-  },
-  responses: {
-    [HttpStatusCodes.OK]: {
-      description: "File uploaded",
-      content: { "application/json": { schema: UploadResponseSchema } }
-    }
-  }
-});
-
-const importExcelRoute = createRoute({
-  path: "/import/excel",
-  method: "post",
-  tags: ["Examples"],
-  request: {
-    body: {
-      content: {
-        "multipart/form-data": {
-          schema: z.object({ file: z.any().openapi({ type: "string", format: "binary" }) })
-        }
-      }
-    }
-  },
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent(z.object({
-      message: z.string(),
-      data: z.object({
-        sheetName: z.string(),
-        headers: z.array(z.string()),
-        totalRows: z.number(),
-        preview: z.array(z.record(z.string(), z.union([z.string(), z.number(), z.null()])))
-      })
-    }), "Excel import preview")
-  }
-});
-
-const generateDownloadRoute = createRoute({
-  path: "/download/generate",
-  method: "post",
-  tags: ["Examples"],
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent(DownloadTokenSchema, "Temporary download token")
-  }
-});
-
-const downloadRoute = createRoute({
-  path: "/download/{*token}",
-  method: "get",
-  tags: ["Examples"],
-  request: {
-    params: z.object({ token: z.string() })
-  },
-  responses: {
-    [HttpStatusCodes.OK]: { description: "Downloads generated file and deletes it" },
-    [HttpStatusCodes.NOT_FOUND]: jsonContent(z.object({ message: z.string() }), "Invalid token")
-  }
-});
-
-const generateExcelRoute = createRoute({
-  path: "/download/excel/generate",
-  method: "post",
-  tags: ["Examples"],
-  request: {
-    body: jsonContent(ExcelDownloadRequestSchema, "Excel generation payload")
-  },
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent(DownloadTokenSchema, "Excel temporary download token")
-  }
-});
-
-const downloadExcelRoute = createRoute({
-  path: "/download/excel/{*token}",
-  method: "get",
-  tags: ["Examples"],
-  request: {
-    params: z.object({ token: z.string() })
-  },
-  responses: {
-    [HttpStatusCodes.OK]: { description: "Downloads generated Excel file and deletes it" },
-    [HttpStatusCodes.NOT_FOUND]: jsonContent(z.object({ message: z.string() }), "Invalid token")
-  }
-});
-
-const generatePdfRoute = createRoute({
-  path: "/download/pdf/generate",
-  method: "post",
-  tags: ["Examples"],
-  request: {
-    body: jsonContent(PdfGenerateRequestSchema, "Hybrid PDF generation payload")
-  },
-  responses: {
-    [HttpStatusCodes.ACCEPTED]: jsonContent(PdfGenerateAcceptedSchema, "Queued or inline PDF response")
-  }
-});
-
-const downloadPdfRoute = createRoute({
-  path: "/download/pdf/{requestId}",
-  method: "get",
-  tags: ["Examples"],
-  request: {
-    params: z.object({ requestId: z.string() })
-  },
-  responses: {
-    [HttpStatusCodes.OK]: { description: "Downloads generated PDF" },
-    [HttpStatusCodes.ACCEPTED]: jsonContent(z.object({ message: z.string(), state: z.string() }), "Still generating"),
-    [HttpStatusCodes.NOT_FOUND]: jsonContent(z.object({ message: z.string() }), "Unknown request")
-  }
-});
-
-const enabled = env.ENABLE_EXAMPLES;
-const router = createRouter();
-
-if (enabled) {
-  router
-    .api(eventRoute, fire)
-    .api(queueCommandRoute, queueCommand)
-    .api(queuedEventRoute, fireQueued)
-    .api(queuedBroadcastEventRoute, fireQueuedBroadcast)
-    .api(broadcastRoute, fireBroadcast)
-    .api(uploadRoute, upload)
-    .api(importExcelRoute, importExcel)
-    .api(generateDownloadRoute, generateDownload)
-    .api(downloadRoute, downloadGenerated)
-    .api(generateExcelRoute, generateExcelDownload)
-    .api(downloadExcelRoute, downloadGeneratedExcel)
-    .api(generatePdfRoute, generatePdfDownload)
-    .api(downloadPdfRoute, downloadGeneratedPdf);
-}
-
-export default router;
-

package/express/src/framework/maker-cli/stubs/example/route.plain.ts.stub

@@ -1,18 +0,0 @@
-import { group } from "@/framework/facade.js";
-import { downloadGenerated, downloadGeneratedExcel, downloadGeneratedPdf, fire, fireBroadcast, fireQueued, fireQueuedBroadcast, generateDownload, generateExcelDownload, generatePdfDownload, importExcel, queueCommand, upload } from "@/modules/{{module}}/controllers/{{module}}.controller.js";
-
-export default group()
-  .post("/event", fire)
-  .post("/queue/command", queueCommand)
-  .post("/event/queued", fireQueued)
-  .post("/event/queued-broadcast", fireQueuedBroadcast)
-  .post("/event/broadcast", fireBroadcast)
-  .post("/upload", upload)
-  .post("/import/excel", importExcel)
-  .post("/download/generate", generateDownload)
-  .get("/download/:token", downloadGenerated)
-  .post("/download/excel/generate", generateExcelDownload)
-  .get("/download/excel/:token", downloadGeneratedExcel)
-  .post("/download/pdf/generate", generatePdfDownload)
-  .get("/download/pdf/:requestId", downloadGeneratedPdf);
-

package/express/src/framework/maker-cli/stubs/example/schema.plain.ts.stub

@@ -1,42 +0,0 @@
-import { z } from "@/framework/facade.js";
-
-export const ExampleEventSchema = z.object({
-  message: z.string(),
-  waitSeconds: z.number().optional()
-});
-
-export const UploadResponseSchema = z.object({
-  message: z.string(),
-  path: z.string(),
-  url: z.string()
-});
-
-export const DownloadTokenSchema = z.object({
-  message: z.string(),
-  token: z.string(),
-  downloadUrl: z.string()
-});
-
-export const ExcelDownloadRequestSchema = z.object({
-  title: z.string().min(2).max(100).default("Example Report")
-});
-
-export const QueueCommandRequestSchema = z.object({
-  message: z.string(),
-  waitSeconds: z.number().optional()
-});
-
-export const PdfGenerateRequestSchema = z.object({
-  title: z.string().min(2).max(100).default("Example PDF Report"),
-  rows: z.number().int().min(50).max(20000).default(1000),
-  chunkSize: z.number().int().min(50).max(1000).default(250)
-});
-
-export const PdfGenerateAcceptedSchema = z.object({
-  message: z.string(),
-  requestId: z.string(),
-  mode: z.enum(["queued", "inline"]),
-  statusUrl: z.string(),
-  downloadUrl: z.string()
-});
-

package/express/src/framework/maker-cli/stubs/example/schema.ts.stub

@@ -1,42 +0,0 @@
-import { z } from "zod";
-
-export const ExampleEventSchema = z.object({
-  message: z.string(),
-  waitSeconds: z.number().optional()
-});
-
-export const UploadResponseSchema = z.object({
-  message: z.string(),
-  path: z.string(),
-  url: z.string()
-});
-
-export const DownloadTokenSchema = z.object({
-  message: z.string(),
-  token: z.string(),
-  downloadUrl: z.string()
-});
-
-export const ExcelDownloadRequestSchema = z.object({
-  title: z.string().min(2).max(100).default("Example Report")
-});
-
-export const QueueCommandRequestSchema = z.object({
-  message: z.string(),
-  waitSeconds: z.number().optional()
-});
-
-export const PdfGenerateRequestSchema = z.object({
-  title: z.string().min(2).max(100).default("Example PDF Report"),
-  rows: z.number().int().min(50).max(20000).default(1000),
-  chunkSize: z.number().int().min(50).max(1000).default(250)
-});
-
-export const PdfGenerateAcceptedSchema = z.object({
-  message: z.string(),
-  requestId: z.string(),
-  mode: z.enum(["queued", "inline"]),
-  statusUrl: z.string(),
-  downloadUrl: z.string()
-});
-