@liquidmetal-ai/raindrop 0.13.0 → 0.15.0

package/bundle/commands/build/features.js

@@ -0,0 +1,192 @@
+import {
+  source_default
+} from "../../chunk-V6J23FL2.js";
+import {
+  BaseCommand
+} from "../../chunk-TFQY5TSY.js";
+import {
+  __toESM,
+  init_cjs_shims,
+  require_lib
+} from "../../chunk-KLOYSTZY.js";
+
+// src/commands/build/features.ts
+init_cjs_shims();
+var import_core = __toESM(require_lib(), 1);
+
+// src/feature-catalog.ts
+init_cjs_shims();
+var FEATURE_CATALOG = [
+  // === Data & Storage ===
+  {
+    id: "smartbucket",
+    name: "SmartBucket",
+    description: "File storage with AI-powered search",
+    category: "data",
+    available: true,
+    command: "raindrop build smartbucket setup"
+  },
+  {
+    id: "smartsql",
+    name: "SmartSQL",
+    description: "PostgreSQL with natural language queries",
+    category: "data",
+    available: true,
+    command: "raindrop build smartsql setup"
+  },
+  {
+    id: "smartmemory",
+    name: "SmartMemory",
+    description: "AI conversation memory management",
+    category: "data",
+    available: true,
+    command: "raindrop build smartmemory setup"
+  },
+  // === Architecture Patterns ===
+  {
+    id: "actor",
+    name: "Stateful Actor",
+    description: "Durable objects with state management",
+    category: "architecture",
+    available: true,
+    command: "raindrop build actor setup"
+  },
+  {
+    id: "queue",
+    name: "Queue Consumer",
+    description: "Background queue message processing",
+    category: "architecture",
+    available: true,
+    command: "raindrop build queue setup"
+  },
+  {
+    id: "bucket-events",
+    name: "Bucket Events",
+    description: "React to file upload/delete events",
+    category: "architecture",
+    available: true,
+    command: "raindrop build bucket-events setup"
+  },
+  // === Integrations ===
+  {
+    id: "workos",
+    name: "WorkOS Auth",
+    description: "Authentication with WorkOS",
+    category: "integration",
+    available: true,
+    command: "raindrop build workos setup"
+  },
+  {
+    id: "stripe",
+    name: "Stripe Payments",
+    description: "Payment processing with Stripe",
+    category: "integration",
+    available: true,
+    command: "raindrop build stripe setup"
+  }
+];
+function getFeatures(onlyAvailable = false) {
+  if (onlyAvailable) {
+    return FEATURE_CATALOG.filter((f) => f.available);
+  }
+  return FEATURE_CATALOG;
+}
+function getFeaturesByCategory() {
+  const grouped = {
+    data: [],
+    architecture: [],
+    integration: []
+  };
+  for (const feature of FEATURE_CATALOG) {
+    grouped[feature.category].push(feature);
+  }
+  return grouped;
+}
+
+// src/commands/build/features.ts
+var Features = class extends BaseCommand {
+  static args = {};
+  static description = "List available features and integrations for Raindrop apps";
+  static examples = [
+    `<%= config.bin %> <%= command.id %>
+List all available features grouped by category
+
+<%= config.bin %> <%= command.id %> --available-only
+Show only features that are currently ready to use
+
+<%= config.bin %> <%= command.id %> --output json
+Get machine-readable JSON output
+`
+  ];
+  static flags = {
+    ...BaseCommand.HIDDEN_FLAGS,
+    "available-only": import_core.Flags.boolean({
+      description: "show only features that are currently available",
+      default: false
+    }),
+    output: import_core.Flags.string({
+      char: "o",
+      description: "output format",
+      default: "text",
+      options: ["text", "json"]
+    })
+  };
+  async run() {
+    const onlyAvailable = this.flags["available-only"];
+    if (this.flags.output === "json") {
+      const features = getFeatures(onlyAvailable);
+      console.log(JSON.stringify(features, null, 2));
+      return;
+    }
+    this.log("");
+    this.log(source_default.bold.underline("Available Features for Raindrop Apps"));
+    this.log("");
+    const grouped = getFeaturesByCategory();
+    this.log(source_default.bold.cyan("\u{1F4E6} Data & Storage"));
+    this.log("");
+    for (const feature of grouped.data) {
+      if (onlyAvailable && !feature.available) continue;
+      const command = feature.command ? source_default.dim(`
+      $ ${feature.command}`) : source_default.yellow(" (planned)");
+      this.log(`  ${source_default.bold(feature.name.padEnd(20))} ${feature.description}${command}`);
+      this.log("");
+    }
+    this.log(source_default.bold.magenta("\u{1F3D7}  Architecture Patterns"));
+    this.log("");
+    for (const feature of grouped.architecture) {
+      if (onlyAvailable && !feature.available) continue;
+      const command = feature.command ? source_default.dim(`
+      $ ${feature.command}`) : source_default.yellow(" (planned)");
+      this.log(`  ${source_default.bold(feature.name.padEnd(20))} ${feature.description}${command}`);
+      this.log("");
+    }
+    this.log(source_default.bold.blue("\u{1F50C} Integrations"));
+    this.log("");
+    for (const feature of grouped.integration) {
+      if (onlyAvailable && !feature.available) continue;
+      const command = feature.command ? source_default.dim(`
+      $ ${feature.command}`) : source_default.yellow(" (planned)");
+      this.log(`  ${source_default.bold(feature.name.padEnd(20))} ${feature.description}${command}`);
+      this.log("");
+    }
+    this.log(source_default.dim("\u2500".repeat(60)));
+    const availableCount = getFeatures(true).length;
+    const totalCount = getFeatures(false).length;
+    this.log(source_default.dim(`${availableCount} available, ${totalCount - availableCount} planned`));
+    this.log("");
+    this.log(source_default.bold("How to add features:"));
+    this.log(source_default.dim("   Use the setup command for any feature above, for example:"));
+    this.log(source_default.dim("   $ raindrop build smartmemory setup"));
+    this.log(source_default.dim("   $ raindrop build smartsql setup"));
+    this.log(source_default.dim("   $ raindrop build smartbucket setup"));
+    this.log("");
+    this.log(source_default.bold("Common combinations:"));
+    this.log(source_default.dim("   Chatbot:   smartmemory + smartsql + ai"));
+    this.log(source_default.dim("   File API:   smartbucket + queue"));
+    this.log(source_default.dim("   Auth App:  workos + smartmemory"));
+    this.log("");
+  }
+};
+export {
+  Features as default
+};

package/bundle/commands/build/find.js

@@ -1,12 +1,12 @@
 import {
   checkAndDisplayKillswitchStatus
-} from "../../chunk-ER2RCPCY.js";
+} from "../../chunk-V54KHS5B.js";
 import {
   source_default
-} from "../../chunk-36GNZK4A.js";
+} from "../../chunk-V6J23FL2.js";
 import {
   BaseCommand
-} from "../../chunk-LDFYPOXJ.js";
+} from "../../chunk-TFQY5TSY.js";
 import {
   EPOCH_TS,
   QueryModulesResponseSchema,
@@ -17,7 +17,7 @@ import {
   timestampDate,
   toJsonString,
   valueOf
-} from "../../chunk-V5LHJTYS.js";
+} from "../../chunk-KLOYSTZY.js";
 
 // src/commands/build/find.ts
 init_cjs_shims();

package/bundle/commands/build/generate.js

@@ -4,17 +4,20 @@ import {
   codegenPlan,
   gatherEnvForHandler,
   renderCodegenPlan
-} from "../../chunk-AK77X5GL.js";
+} from "../../chunk-L6FRQULN.js";
+import {
+  source_default
+} from "../../chunk-V6J23FL2.js";
 import {
   BaseCommand
-} from "../../chunk-LDFYPOXJ.js";
+} from "../../chunk-TFQY5TSY.js";
 import {
   __toESM,
   getFrameworkVersion,
   init_cjs_shims,
   require_lib,
   valueOf
-} from "../../chunk-V5LHJTYS.js";
+} from "../../chunk-KLOYSTZY.js";
 
 // src/commands/build/generate.ts
 init_cjs_shims();
@@ -68,6 +71,52 @@ var Generate = class extends BaseCommand {
       await fs.mkdir(path.dirname(dest), { recursive: true });
       await fs.writeFile(dest, gatherEnvForHandler(handler, app));
     }
+    await this.suggestFeatures();
+  }
+  async suggestFeatures() {
+    const manifestPath = path.join(this.flags.root, this.flags.manifest);
+    let manifestContent = "";
+    try {
+      manifestContent = await fs.readFile(manifestPath, "utf-8");
+    } catch {
+      return;
+    }
+    const hasSmartMemory = /^\s*smartmemory\s+"/m.test(manifestContent);
+    const hasSmartSQL = /^\s*smartsql\s+"/m.test(manifestContent);
+    const hasSmartBucket = /^\s*smartbucket\s+"/m.test(manifestContent);
+    const hasQueue = /^\s*queue\s+"/m.test(manifestContent);
+    const suggestions = [];
+    if (hasSmartMemory && !await this.hasExampleFile("smartmemory-minimal.ts")) {
+      suggestions.push("raindrop build smartmemory setup");
+    }
+    if (hasSmartSQL && !await this.hasExampleFile("smartsql-minimal.ts")) {
+      suggestions.push("raindrop build smartsql setup");
+    }
+    if (hasSmartBucket && !await this.hasExampleFile("smartbucket-minimal.ts")) {
+      suggestions.push("raindrop build smartbucket setup");
+    }
+    if (hasQueue && !await this.hasExampleFile("queue-minimal.ts")) {
+      suggestions.push("raindrop build queue setup");
+    }
+    if (suggestions.length > 0) {
+      console.log("");
+      console.log(source_default.bold("Tip:") + " Get working examples with setup commands:");
+      suggestions.forEach((cmd) => console.log(source_default.dim(`   ${cmd}`)));
+      console.log("");
+    }
+    if (suggestions.length === 0 && (hasSmartMemory || hasSmartSQL || hasSmartBucket || hasQueue)) {
+      console.log("");
+      console.log(source_default.dim("Tip: Explore available features with: raindrop build features"));
+      console.log("");
+    }
+  }
+  async hasExampleFile(filename) {
+    try {
+      await fs.access(path.join(this.flags.root, "src", "examples", filename));
+      return true;
+    } catch {
+      return false;
+    }
   }
 };
 export {

package/bundle/commands/build/init-workspace.js

@@ -2,15 +2,15 @@ import {
   TEMPLATES_DIR,
   fileExists,
   renderTemplateFromFile
-} from "../../chunk-AK77X5GL.js";
+} from "../../chunk-L6FRQULN.js";
 import {
   BaseCommand
-} from "../../chunk-LDFYPOXJ.js";
+} from "../../chunk-TFQY5TSY.js";
 import {
   __toESM,
   init_cjs_shims,
   require_lib
-} from "../../chunk-V5LHJTYS.js";
+} from "../../chunk-KLOYSTZY.js";
 
 // src/commands/build/init-workspace.ts
 init_cjs_shims();

package/bundle/commands/build/init.js

@@ -2,17 +2,20 @@ import {
   codegenPlan,
   fileExists,
   renderCodegenPlan
-} from "../../chunk-AK77X5GL.js";
+} from "../../chunk-L6FRQULN.js";
+import {
+  source_default
+} from "../../chunk-V6J23FL2.js";
 import {
   BaseCommand
-} from "../../chunk-LDFYPOXJ.js";
+} from "../../chunk-TFQY5TSY.js";
 import {
   __toESM,
   getFrameworkVersion,
   init_cjs_shims,
   mustManifestFromString,
   require_lib
-} from "../../chunk-V5LHJTYS.js";
+} from "../../chunk-KLOYSTZY.js";
 
 // src/commands/build/init.ts
 init_cjs_shims();
@@ -69,6 +72,15 @@ Initialize a project in the current directory.
       this.error(`Could not initialize project at ${this.args.path}: ${error}`, { exit: 1 });
     }
     console.log(`Initialized LiquidMetal.AI in ${this.args.path}`);
+    console.log("");
+    console.log(source_default.bold("Next steps:"));
+    console.log("  1. cd", this.args.path);
+    console.log("  2. npm install");
+    console.log("  3. raindrop build generate");
+    console.log("  4. raindrop build features");
+    console.log("  5. raindrop build deploy --start");
+    console.log("");
+    console.log(source_default.dim('Tip: Discover available features with "raindrop build features"'));
   }
 };
 export {

package/bundle/commands/build/list.js

@@ -1,11 +1,11 @@
 import {
   List,
   statusString
-} from "../../chunk-2QWMBNE3.js";
-import "../../chunk-ER2RCPCY.js";
-import "../../chunk-36GNZK4A.js";
-import "../../chunk-LDFYPOXJ.js";
-import "../../chunk-V5LHJTYS.js";
+} from "../../chunk-3CMR7ES5.js";
+import "../../chunk-V54KHS5B.js";
+import "../../chunk-V6J23FL2.js";
+import "../../chunk-TFQY5TSY.js";
+import "../../chunk-KLOYSTZY.js";
 export {
   List as default,
   statusString

package/bundle/commands/build/queue/setup.js

@@ -0,0 +1,133 @@
+import {
+  TEMPLATES_DIR,
+  renderTemplateFromFile
+} from "../../../chunk-L6FRQULN.js";
+import {
+  source_default
+} from "../../../chunk-V6J23FL2.js";
+import {
+  BaseCommand
+} from "../../../chunk-TFQY5TSY.js";
+import {
+  __toESM,
+  init_cjs_shims,
+  require_lib
+} from "../../../chunk-KLOYSTZY.js";
+
+// src/commands/build/queue/setup.ts
+init_cjs_shims();
+var import_core = __toESM(require_lib(), 1);
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+var QueueSetup = class extends BaseCommand {
+  static args = {};
+  static description = "Add a queue with consumer (observer) to your Raindrop app";
+  static examples = [
+    `<%= config.bin %> <%= command.id %>
+Add queue with default name "my-queue"
+
+<%= config.bin %> <%= command.id %> --name tasks
+Add queue with custom name "tasks"
+`
+  ];
+  static flags = {
+    ...BaseCommand.HIDDEN_FLAGS,
+    name: import_core.Flags.string({
+      description: "Name for the queue",
+      default: "my-queue"
+    }),
+    "dry-run": import_core.Flags.boolean({
+      description: "Preview changes without applying them",
+      default: false
+    })
+  };
+  async run() {
+    const queueName = this.flags.name;
+    const observerName = `${queueName}-consumer`;
+    const dryRun = this.flags["dry-run"];
+    if (dryRun) {
+      this.log(source_default.blue.bold("DRY RUN - Preview of changes (no files will be modified)"));
+      this.log("");
+      this.log(source_default.blue("Would create:") + " " + source_default.bold(`src/${observerName}/index.ts`));
+      this.log(source_default.dim("  - 50 lines of queue consumer code"));
+      this.log(source_default.dim("  - Message processing, error handling, retry logic"));
+      this.log("");
+      this.log(source_default.blue("Would update:") + " " + source_default.bold("raindrop.manifest"));
+      this.log(source_default.dim(`  + queue "${queueName}" {}`));
+      this.log(source_default.dim(`  + observer "${observerName}" {`));
+      this.log(source_default.dim(`      source { queue = "${queueName}" ... }`));
+      this.log(source_default.dim(`    }`));
+      this.log("");
+      this.log(source_default.blue("Environment binding:") + " " + source_default.bold(`this.env.${queueName.toUpperCase().replace(/-/g, "_")}`));
+      this.log("");
+      this.log(source_default.yellow("Run without --dry-run to apply these changes"));
+      return;
+    }
+    try {
+      const observerDir = path.join(process.cwd(), "src", observerName);
+      await fs.mkdir(observerDir, { recursive: true });
+      const observerContent = await this.generateObserverFile(queueName);
+      const observerPath = path.join(observerDir, "index.ts");
+      await fs.writeFile(observerPath, observerContent);
+      this.log(source_default.green("\u2713") + " Created " + source_default.bold(`src/${observerName}/index.ts`));
+      await this.updateManifest(queueName, observerName);
+      this.log(source_default.green("\u2713") + " Updated " + source_default.bold("raindrop.manifest"));
+      this.log("");
+      this.log(source_default.bold.cyan("Next Steps:"));
+      this.log("");
+      this.log("1. Run " + source_default.bold("raindrop build generate") + " to update types");
+      this.log("2. Check out " + source_default.bold(`src/${observerName}/index.ts`) + " for the consumer code");
+      this.log("3. Send messages to the queue from your services:");
+      this.log("");
+      this.log(source_default.dim("Example usage:"));
+      this.log(source_default.dim(`  await this.env.${queueName.toUpperCase().replace(/-/g, "_")}.send({`));
+      this.log(source_default.dim(`    task: 'process-order',`));
+      this.log(source_default.dim(`    orderId: '12345'`));
+      this.log(source_default.dim(`  });`));
+      this.log("");
+    } catch (error) {
+      this.error(`Failed to set up queue: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
+  async generateObserverFile(queueName) {
+    const templatePath = path.join(TEMPLATES_DIR, "handlers", "queue-consumer-setup.ts.hbs");
+    return renderTemplateFromFile(templatePath, { queueName });
+  }
+  async updateManifest(queueName, observerName) {
+    const manifestPath = path.join(process.cwd(), "raindrop.manifest");
+    try {
+      let content = await fs.readFile(manifestPath, "utf-8");
+      if (content.includes(`queue "${queueName}"`)) {
+        this.log(source_default.yellow("\u26A0") + " Queue already exists in manifest");
+        return;
+      }
+      const appMatch = content.match(/application\s+"[^"]+"\s+\{/);
+      if (appMatch) {
+        const insertPos = appMatch.index + appMatch[0].length;
+        const binding = `
+  queue "${queueName}" {}
+
+  observer "${observerName}" {
+    source {
+      queue = "${queueName}"
+      max_retries = 5
+      batch_size = 1
+    }
+  }
+`;
+        content = content.slice(0, insertPos) + binding + content.slice(insertPos);
+        await fs.writeFile(manifestPath, content);
+      } else {
+        throw new Error("Could not find application block in raindrop.manifest");
+      }
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        throw new Error("raindrop.manifest not found. Are you in a Raindrop project directory?");
+      }
+      throw error;
+    }
+  }
+};
+export {
+  QueueSetup as default
+};

package/bundle/commands/build/sandbox.js

@@ -1,17 +1,17 @@
 import {
   sandbox
-} from "../../chunk-JLVDTXO2.js";
-import "../../chunk-KQZJHBNG.js";
-import "../../chunk-DLH7MI57.js";
-import "../../chunk-AK77X5GL.js";
+} from "../../chunk-DPV5HIG7.js";
+import "../../chunk-MJBLNWG3.js";
+import "../../chunk-JQONDSHY.js";
+import "../../chunk-L6FRQULN.js";
 import {
   BaseCommand
-} from "../../chunk-LDFYPOXJ.js";
+} from "../../chunk-TFQY5TSY.js";
 import {
   __toESM,
   init_cjs_shims,
   require_lib
-} from "../../chunk-V5LHJTYS.js";
+} from "../../chunk-KLOYSTZY.js";
 
 // src/commands/build/sandbox.ts
 init_cjs_shims();