saasaloy 0.1.1 → 0.1.2

package/README.md

@@ -51,6 +51,7 @@ my-app/
   packages/db/         Drizzle schema + client (saasaloy add database-d1 | database-postgres)
   packages/auth/       Better Auth            (saasaloy add auth)
   packages/email/      email provider interface (saasaloy add email)
+  packages/queue/      background jobs + schedules (saasaloy add queue)
   .agents/skills/      agent skills, symlinked from .claude/skills/
   DESIGN.md            the design contract
   saasaloy.json        installed modules + alias map
@@ -64,6 +65,7 @@ my-app/
 | Database | Drizzle ORM on D1 (SQLite) or Postgres |
 | Auth | Better Auth |
 | Email | Cloudflare Email Sending, Plunk, or a console logger |
+| Background work | Cloudflare Queues and Cron Triggers, or an in-process runner |
 | Infra | wrangler per workspace, or Pulumi via the `infra` module |
 | Monorepo | Turborepo + pnpm |
 
@@ -89,9 +91,9 @@ Modules come in tiers. A **capability** scaffolds a workspace and sets conventio
 
 | Tier | Modules |
 |---|---|
-| Capability | `api`, `database`, `validators`, `logger`, `auth`, `admin`, `email`, `sms`, `infra` |
+| Capability | `api`, `database`, `validators`, `logger`, `auth`, `admin`, `email`, `sms`, `queue`, `infra` |
 | Feature | `waitlist`, `teams`, `email-react` |
-| Provider | `email-console`, `email-cloudflare`, `email-plunk`, `logger-console`, `sms-console` |
+| Provider | `email-console`, `email-cloudflare`, `email-plunk`, `logger-console`, `sms-console`, `queue-cloudflare`, `queue-memory` |
 | Driver | `database-d1`, `database-postgres` |
 
 `saasaloy add <name> --dry-run` prints what a module would do to your project before it does it. The one-table map of every module, what it gives you, and what it depends on is on the [Modules](https://github.com/mimukit/saasaloy/blob/main/docs/wiki/modules.md) page.
@@ -110,8 +112,9 @@ A few modules need something the free tier does not cover:
 | `email-plunk` | a [Plunk](https://www.useplunk.com) account and `PLUNK_API_KEY` |
 | `database-postgres` | a Postgres server reachable from a Worker, with its URL in `DATABASE_URL`. Install instead of `database-d1`, never alongside |
 | `sms` | a third-party SMS account for any real send. Cloudflare has no SMS product. `sms-console` is free |
+| `queue-cloudflare` | a Workers paid plan, and the two queues created once with `wrangler queues create`. Install `queue-memory` instead for local work |
 
-The console providers (`email-console`, `sms-console`, `logger-console`) log instead of sending, so local development needs no plan, domain, or key. Details for each are in the [Reference](https://github.com/mimukit/saasaloy/blob/main/docs/wiki/reference.md#email-providers).
+The local providers (`email-console`, `sms-console`, `logger-console`, `queue-memory`) log or run inline instead of calling a service, so local development needs no plan, domain, or key. Details for each are in the [Reference](https://github.com/mimukit/saasaloy/blob/main/docs/wiki/reference.md#email-providers).
 
 ## Deploy
 

package/dist/index.js

@@ -877,7 +877,8 @@ function upsertWranglerBinding(source, patch) {
   if (!root) {
     return source;
   }
-  const arrayNode = findNodeAtLocation(root, [patch.bindingType]);
+  const bindingPath = splitBindingType(patch.bindingType);
+  const arrayNode = findNodeAtLocation(root, bindingPath);
   const formattingOptions = inferFormatting(source);
   if (arrayNode?.type === "array") {
     const existing = (arrayNode.children ?? []).map(
@@ -892,7 +893,7 @@ function upsertWranglerBinding(source, patch) {
     }
     const edits2 = modify(
       source,
-      [patch.bindingType, existing.length],
+      [...bindingPath, existing.length],
       patch.entry,
       {
         formattingOptions,
@@ -901,7 +902,7 @@ function upsertWranglerBinding(source, patch) {
     );
     return applyEdits(source, edits2);
   }
-  const edits = modify(source, [patch.bindingType], [patch.entry], {
+  const edits = modify(source, bindingPath, [patch.entry], {
     formattingOptions
   });
   return applyEdits(source, edits);
@@ -911,7 +912,8 @@ function removeWranglerBinding(source, patch) {
   if (!root) {
     return source;
   }
-  const arrayNode = findNodeAtLocation(root, [patch.bindingType]);
+  const bindingPath = splitBindingType(patch.bindingType);
+  const arrayNode = findNodeAtLocation(root, bindingPath);
   if (arrayNode?.type !== "array") {
     return source;
   }
@@ -925,7 +927,7 @@ function removeWranglerBinding(source, patch) {
   if (matchWranglerBinding(source, patch)) {
     return source;
   }
-  const path = existing.length === 1 ? [patch.bindingType] : [patch.bindingType, index];
+  const path = existing.length === 1 ? emptiedAncestorPath(root, bindingPath) : [...bindingPath, index];
   const edits = modify(source, path, void 0, {
     formattingOptions: inferFormatting(source)
   });
@@ -938,6 +940,20 @@ function wranglerBindingRemoveRefusal(source, patch) {
   }
   return `${match.key} holds ${JSON.stringify(match.current)} now, not the entry that was applied, so it is not ours to delete`;
 }
+function splitBindingType(bindingType) {
+  return bindingType.split(".");
+}
+function emptiedAncestorPath(root, bindingPath) {
+  let cut = bindingPath.length;
+  for (let depth = bindingPath.length - 1; depth >= 1; depth -= 1) {
+    const parent = findNodeAtLocation(root, bindingPath.slice(0, depth));
+    if (parent?.type !== "object" || (parent.children?.length ?? 0) !== 1) {
+      break;
+    }
+    cut = depth;
+  }
+  return bindingPath.slice(0, cut);
+}
 function findEntryIndex(existing, patch) {
   const { entry } = patch;
   if (typeof entry === "string") {
@@ -957,7 +973,10 @@ function matchWranglerBinding(source, patch) {
   if (!root) {
     return void 0;
   }
-  const arrayNode = findNodeAtLocation(root, [patch.bindingType]);
+  const arrayNode = findNodeAtLocation(
+    root,
+    splitBindingType(patch.bindingType)
+  );
   if (arrayNode?.type !== "array") {
     return void 0;
   }
@@ -3667,7 +3686,7 @@ import { fileURLToPath as fileURLToPath3 } from "url";
 // package.json
 var package_default = {
   name: "saasaloy",
-  version: "0.1.1",
+  version: "0.1.2",
   description: "Composable SaaS accelerator kit.",
   keywords: [
     "saas",
@@ -3888,6 +3907,19 @@ function recordBaseFiles(manifest, files) {
 function isBaseTracked(lock, manifest) {
   return lock.base !== void 0 && Object.keys(baseEntries(manifest)).length > 0;
 }
+async function missingBaseTargets(root, manifest, templateDir) {
+  const seed = new Set((await readBaseDeclaration(templateDir)).seedFiles);
+  const missing = [];
+  for (const target of Object.keys(baseEntries(manifest))) {
+    if (seed.has(target)) {
+      continue;
+    }
+    if (await readIfPresent(resolveWithinRoot(root, target)) === void 0) {
+      missing.push(target);
+    }
+  }
+  return missing.toSorted((a, b) => a < b ? -1 : 1);
+}
 async function renderTemplate(root, templateDir) {
   const dir = await mkdtemp2(join10(tmpdir2(), "saasaloy-base-render-"));
   const files = await copyTemplate(
@@ -4326,7 +4358,7 @@ var HELP2 = {
   usage: USAGE2,
   flags: {}
 };
-var DEFAULT_PATH = "modules";
+var DEFAULT_PATH = ".";
 function parseArgs2(argv) {
   const positional = [];
   const unknown = [];
@@ -4425,9 +4457,8 @@ async function runDoctor(argv) {
   const path = opts.path ?? DEFAULT_PATH;
   try {
     if (!await pathExists(path)) {
-      const hint = opts.path === void 0 && await pathExists(CONFIG_FILE) ? ` Run \`saasaloy doctor .\` to check this project instead.` : "";
       cancel2(
-        `No such path: ${path} \u2014 point \`doctor\` at a module folder or at a directory of them.${hint}`
+        `No such path: ${path} \u2014 point \`doctor\` at a module folder or at a directory of them.`
       );
       return EXIT_REFUSED;
     }
@@ -6244,6 +6275,7 @@ function baseLabel(version2, hash) {
 }
 function compareBase(args) {
   const { lock, manifest, runningHash, runningVersion } = args;
+  const missing = args.missingTargets ?? [];
   const latest = baseLabel(runningVersion, runningHash);
   if (!isBaseTracked(lock, manifest) || !lock.base) {
     return {
@@ -6256,13 +6288,18 @@ function compareBase(args) {
       detail: "not recorded \u2014 run `saasaloy update` to adopt the base at this CLI"
     };
   }
+  const moved = lock.base.templateHash !== runningHash;
   return {
     name: BASE_MODULE,
     source: BASE_SOURCE,
     ref: BASE_REF,
     current: baseLabel(lock.base.cliVersion, lock.base.templateHash),
     latest,
-    status: lock.base.templateHash === runningHash ? "current" : "outdated"
+    status: moved || missing.length > 0 ? "outdated" : "current",
+    // Say why, or an unmoved hash beside `outdated` reads as a bug.
+    ...!moved && missing.length > 0 ? {
+      detail: `${missing.length} tracked file${missing.length === 1 ? " is" : "s are"} missing from disk`
+    } : {}
   };
 }
 function recordRefRewrites(lock, comparisons) {
@@ -6923,11 +6960,13 @@ async function runOutdated(argv) {
         `${REGISTRY_ENV} is set, so every module reads as local \u2014 unset it to compare against the registry.`
       );
     }
+    const templateDir = await baseTemplateDir();
     const baseRow = compareBase({
       lock,
       manifest,
-      runningHash: await templateHash(await baseTemplateDir()),
-      runningVersion: await readVersion()
+      runningHash: await templateHash(templateDir),
+      runningVersion: await readVersion(),
+      missingTargets: await missingBaseTargets(root, manifest, templateDir)
     });
     const resolvers = /* @__PURE__ */ new Map();
     const remote = (slug, ref) => {
@@ -7953,7 +7992,8 @@ async function runUpdate(argv) {
         lock,
         manifest,
         runningHash: await templateHash(templateDir),
-        runningVersion: cliVersion
+        runningVersion: cliVersion,
+        missingTargets: await missingBaseTargets(root, manifest, templateDir)
       });
     }
     if (targets.length === 0 && !baseComparison) {