better-cf 0.2.1 → 1.0.0

package/README.md

@@ -121,7 +121,7 @@ expect(result.acked).toHaveLength(1);
 | Local dev orchestration | Team-managed scripts | One `better-cf dev` loop |
 | Queue test harness | Custom mocks/harnesses | `testQueue` helper |
 
-Detailed comparison: `/apps/docs/src/content/docs/comparison/cloudflare-vs-better-cf.mdx`
+Detailed comparison is being migrated to the separate docs repository.
 
 ## Limitations
 
@@ -142,7 +142,5 @@ Use native Cloudflare APIs directly where the SDK intentionally does not abstrac
 
 ## Docs
 
-- Site source: `apps/docs`
-- Getting started page: `apps/docs/src/content/docs/getting-started.md`
-- File structure guide: `apps/docs/src/content/docs/guides/file-structure.md`
-- Cookbook page: `apps/docs/src/content/docs/examples/cookbook.md`
+Docs are being migrated to a separate Next.js application repository.
+During migration, legacy docs source may still exist under `apps/docs`, but it is no longer part of package CI/CD.

package/dist/cli/index.js

@@ -610,11 +610,15 @@ var RESERVED_KEYS = /* @__PURE__ */ new Set([
   "visibilityTimeout",
   "batch",
   "consumer",
+  "args",
+  "handler",
+  "batchHandler",
   "message",
   "process",
   "processBatch",
   "onFailure"
 ]);
+var DEFINE_QUEUE_HELPERS = /* @__PURE__ */ new Set(["defineQueue", "defineQueues"]);
 async function scanQueues(config) {
   const diagnostics = [];
   const candidates = collectSourceFiles(config.rootDir, config.ignore);
@@ -688,7 +692,7 @@ async function scanQueues(config) {
     diagnostics.push({
       level: "warning",
       code: "NO_QUEUES_FOUND",
-      message: "No defineQueue exports found in this project."
+      message: "No defineQueue/defineQueues exports found in this project."
     });
   }
   return {
@@ -732,7 +736,7 @@ function collectSourceFiles(rootDir, ignore) {
       }
       if (entry.name.endsWith(".ts") || entry.name.endsWith(".tsx")) {
         const content = fs8.readFileSync(absolutePath, "utf8");
-        if (content.includes("defineQueue")) {
+        if (content.includes("defineQueue") || content.includes("defineQueues")) {
           files.push(absolutePath);
         }
       }
@@ -749,7 +753,7 @@ function getDefineQueueLocalNames(sourceFile) {
       continue;
     }
     for (const namedImport of importDecl.getNamedImports()) {
-      if (namedImport.getName() !== "defineQueue") {
+      if (!DEFINE_QUEUE_HELPERS.has(namedImport.getName())) {
         continue;
       }
       names.add(namedImport.getAliasNode()?.getText() ?? namedImport.getName());
@@ -782,19 +786,19 @@ function extractQueueConfig(call, absolutePath, diagnostics, rootDir) {
   const firstArg = call.getArguments()[0];
   if (!firstArg || firstArg.getKind() !== SyntaxKind.ObjectLiteralExpression) {
     return {
-      hasProcess: false,
-      hasProcessBatch: false,
+      hasHandler: false,
+      hasBatchHandler: false,
       isMultiJob: false
     };
   }
   const objectLiteral = firstArg;
-  const hasProcess = hasProperty(objectLiteral, "process");
-  const hasProcessBatch = hasProperty(objectLiteral, "processBatch");
-  if (hasProcess && hasProcessBatch) {
+  const hasHandler = hasProperty(objectLiteral, "handler");
+  const hasBatchHandler = hasProperty(objectLiteral, "batchHandler");
+  if (hasHandler && hasBatchHandler) {
     diagnostics.push({
       level: "error",
-      code: "INVALID_PROCESS_MODE",
-      message: "Queue config cannot include both process and processBatch.",
+      code: "INVALID_HANDLER_MODE",
+      message: "Queue config cannot include both handler and batchHandler.",
       filePath: path3.relative(rootDir, absolutePath),
       hint: "Pick exactly one processing mode for worker consumers."
     });
@@ -830,7 +834,7 @@ function extractQueueConfig(call, absolutePath, diagnostics, rootDir) {
   const batchTimeout = batchObject ? readNumberOrStringProperty(batchObject, "timeout", diagnostics, absolutePath, rootDir) : void 0;
   const maxConcurrency = batchObject ? readNumberProperty(batchObject, "maxConcurrency", diagnostics, absolutePath, rootDir) : void 0;
   let isMultiJob = false;
-  if (!hasProcess && !hasProcessBatch) {
+  if (!hasHandler && !hasBatchHandler) {
     for (const property of objectLiteral.getProperties()) {
       if (!Node.isPropertyAssignment(property)) {
         continue;
@@ -844,20 +848,20 @@ function extractQueueConfig(call, absolutePath, diagnostics, rootDir) {
         continue;
       }
       const jobObject = initializer;
-      if (hasProperty(jobObject, "message") && hasProperty(jobObject, "process")) {
+      if (hasProperty(jobObject, "args") && hasProperty(jobObject, "handler")) {
         isMultiJob = true;
         break;
       }
     }
   }
   const relativeFile = path3.relative(rootDir, absolutePath);
-  if (consumerType === "http_pull" && (hasProcess || hasProcessBatch)) {
+  if (consumerType === "http_pull" && (hasHandler || hasBatchHandler)) {
     diagnostics.push({
       level: "error",
       code: "INVALID_PULL_MODE_HANDLER",
-      message: 'Queue with consumer.type="http_pull" cannot include process/processBatch.',
+      message: 'Queue with consumer.type="http_pull" cannot include handler/batchHandler.',
       filePath: relativeFile,
-      hint: "Remove process handlers for pull consumers and consume via HTTP pull APIs."
+      hint: "Remove handlers for pull consumers and consume via HTTP pull APIs."
     });
   }
   if (consumerType === "http_pull" && isMultiJob) {
@@ -879,8 +883,8 @@ function extractQueueConfig(call, absolutePath, diagnostics, rootDir) {
     maxConcurrency,
     visibilityTimeout,
     consumerType,
-    hasProcess,
-    hasProcessBatch,
+    hasHandler,
+    hasBatchHandler,
     isMultiJob
   };
 }
@@ -1555,7 +1559,7 @@ function defaultConfigTemplate() {
 
 // Auto-inferred env types are generated under .better-cf/*.d.ts
 // You can still switch to createSDK<Env>() when you need explicit overrides.
-export const { defineQueue, defineWorker } = createSDK();
+export const { defineQueue, defineQueues, defineWorker } = createSDK();
 
 export const betterCfConfig = {
   // workerEntry: 'worker.ts',