@caatinga/cli 0.2.3 → 0.2.4

package/dist/index.js

@@ -419,12 +419,19 @@ import path from "path";
 import { fileURLToPath } from "url";
 import { CaatingaError as CaatingaError3, CaatingaErrorCode as CaatingaErrorCode3 } from "@caatinga/core";
 async function resolveTemplateDir(templateName) {
-  const envTemplatesDir = process.env.CAATINGA_TEMPLATES_DIR;
-  const candidates = [
-    envTemplatesDir ? path.join(envTemplatesDir, templateName) : void 0,
-    path.resolve(process.cwd(), "packages", "templates", templateName),
-    ...candidatePathsFromModule(templateName)
-  ].filter((candidate) => Boolean(candidate));
+  const candidates = buildTemplateCandidates(templateName);
+  if (process.env.CAATINGA_DEBUG_TEMPLATE_RESOLUTION === "1") {
+    const envValue = process.env.CAATINGA_TEMPLATES_DIR ?? "<unset>";
+    const cwd = process.cwd();
+    process.stderr.write(
+      `caatinga: template resolution candidates for "${templateName}": env=${envValue} cwd=${cwd}
+`
+    );
+    for (const candidate of candidates) {
+      process.stderr.write(`caatinga: candidate ${candidate}
+`);
+    }
+  }
   for (const candidate of candidates) {
     try {
       await access2(candidate);
@@ -435,9 +442,17 @@ async function resolveTemplateDir(templateName) {
   throw new CaatingaError3(
     `Template "${templateName}" was not found.`,
     CaatingaErrorCode3.TEMPLATE_NOT_FOUND,
-    "Set CAATINGA_TEMPLATES_DIR or run from a Caatinga checkout that includes packages/templates."
+    "Set CAATINGA_TEMPLATES_DIR, run `pnpm build` before `pnpm pack`, or run from a Caatinga checkout that includes packages/templates."
   );
 }
+function buildTemplateCandidates(templateName) {
+  const envTemplatesDir = process.env.CAATINGA_TEMPLATES_DIR;
+  return [
+    envTemplatesDir ? path.join(envTemplatesDir, templateName) : void 0,
+    path.resolve(process.cwd(), "packages", "templates", templateName),
+    ...candidatePathsFromModule(templateName)
+  ].filter((candidate) => Boolean(candidate));
+}
 function candidatePathsFromModule(templateName) {
   const currentFile = fileURLToPath(import.meta.url);
   const start = path.dirname(currentFile);
@@ -506,7 +521,7 @@ function registerInvokeCommand(program2) {
 }
 
 // src/version.ts
-var CAATINGA_CLI_VERSION = "0.2.3";
+var CAATINGA_CLI_VERSION = "0.2.4";
 
 // src/program.ts
 function createProgram() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/cli",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Caatinga CLI for building dApps on Stellar/Soroban",
   "keywords": [
     "stellar",
@@ -43,7 +43,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@caatinga/core": "^0.2.3",
+    "@caatinga/core": "^0.2.4",
     "chalk": "^5.4.1",
     "commander": "^12.1.0"
   },

package/templates/marketplace-with-token/README.md

@@ -0,0 +1,21 @@
+# __PROJECT_NAME__
+
+Experimental Caatinga multi-contract template with a real constructor dependency.
+
+## Deploy
+
+```bash
+npm install
+npx caatinga build token
+npx caatinga build marketplace
+npx caatinga deploy --network testnet --source alice
+npx caatinga generate token
+npx caatinga generate marketplace
+```
+
+Deploy order:
+
+1. `token`
+2. `marketplace`
+
+`marketplace.deployArgs.tokenContractId` resolves from `${contracts.token.contractId}` after the token deploy writes `caatinga.artifacts.json`. Caatinga passes that value to the contract `__constructor` as `--token_contract_id`.

package/templates/marketplace-with-token/caatinga.artifacts.json

@@ -0,0 +1,10 @@
+{
+  "project": "__PROJECT_NAME__",
+  "version": 1,
+  "networks": {
+    "testnet": {
+      "contracts": {},
+      "dependencyGraph": {}
+    }
+  }
+}

package/templates/marketplace-with-token/caatinga.config.ts

@@ -0,0 +1,30 @@
+import { defineConfig } from "@caatinga/core";
+
+export default defineConfig({
+  project: "__PROJECT_NAME__",
+  defaultNetwork: "testnet",
+  contracts: {
+    token: {
+      path: "./contracts/token",
+      wasm: "./contracts/token/target/wasm32v1-none/release/token.wasm"
+    },
+    marketplace: {
+      path: "./contracts/marketplace",
+      wasm: "./contracts/marketplace/target/wasm32v1-none/release/marketplace.wasm",
+      dependsOn: ["token"],
+      deployArgs: {
+        tokenContractId: "${contracts.token.contractId}"
+      }
+    }
+  },
+  networks: {
+    testnet: {
+      rpcUrl: "https://soroban-testnet.stellar.org",
+      networkPassphrase: "Test SDF Network ; September 2015"
+    }
+  },
+  frontend: {
+    framework: "vite-react",
+    bindingsOutput: "./src/contracts/generated"
+  }
+});

package/templates/marketplace-with-token/caatinga.template.json

@@ -0,0 +1,21 @@
+{
+  "name": "marketplace-with-token",
+  "version": "0.1.0",
+  "description": "Experimental multi-contract Soroban template with token dependency injection.",
+  "caatinga": {
+    "compatibleCore": "^0.2.4",
+    "templateVersion": 1
+  },
+  "frontend": {
+    "framework": "vite-react",
+    "packageManager": "npm"
+  },
+  "contracts": {
+    "path": "contracts",
+    "default": "marketplace"
+  },
+  "files": {
+    "config": "caatinga.config.ts",
+    "artifacts": "caatinga.artifacts.json"
+  }
+}