@caatinga/client 2.0.1 → 2.1.0

package/README.md

@@ -82,7 +82,7 @@ Primary flow:
 ```ts
 import { createCaatingaClient } from "@caatinga/client";
 import { createStellarWalletsKitAdapter } from "@caatinga/client/stellar-wallets-kit";
-import * as Counter from "./contracts/generated/counter";
+import * as Counter from "./contracts/generated/counter/src/index.js";
 import artifacts from "../caatinga.artifacts.json";
 
 const wallet = createStellarWalletsKitAdapter();

package/dist/index.cjs

@@ -76,6 +76,13 @@ var import_browser2 = require("@caatinga/core/browser");
 function createDefaultBindingAdapter(binding) {
   return {
     createClient({ contractId, publicKey, rpcUrl, networkPassphrase }) {
+      if (binding.__caatingaPlaceholder) {
+        throw new import_browser2.CaatingaError(
+          "Placeholder bindings are still in use; the app cannot reach the contract.",
+          import_browser2.CaatingaErrorCode.PLACEHOLDER_BINDING,
+          "Run `caatinga generate <contract> --network <network>`, then restart the dev server."
+        );
+      }
       if (!binding.Client) {
         throw new import_browser2.CaatingaError(
           "Generated binding does not export Client.",

package/dist/index.d.cts

@@ -16,6 +16,12 @@ interface BindingWithClient {
         rpcUrl: string;
         networkPassphrase: string;
     }) => unknown;
+    /**
+     * Set by the scaffolded placeholder binding (`src/contracts/generated/.../index.ts`)
+     * that ships with templates so they type-check before `caatinga generate`. Real
+     * Stellar CLI bindings never set this, so its presence means generate hasn't run.
+     */
+    __caatingaPlaceholder?: boolean;
 }
 declare function createDefaultBindingAdapter(binding: BindingWithClient): CaatingaBindingAdapter;
 

package/dist/index.d.ts

@@ -16,6 +16,12 @@ interface BindingWithClient {
         rpcUrl: string;
         networkPassphrase: string;
     }) => unknown;
+    /**
+     * Set by the scaffolded placeholder binding (`src/contracts/generated/.../index.ts`)
+     * that ships with templates so they type-check before `caatinga generate`. Real
+     * Stellar CLI bindings never set this, so its presence means generate hasn't run.
+     */
+    __caatingaPlaceholder?: boolean;
 }
 declare function createDefaultBindingAdapter(binding: BindingWithClient): CaatingaBindingAdapter;
 

package/dist/index.js

@@ -46,6 +46,13 @@ import { CaatingaError as CaatingaError2, CaatingaErrorCode as CaatingaErrorCode
 function createDefaultBindingAdapter(binding) {
   return {
     createClient({ contractId, publicKey, rpcUrl, networkPassphrase }) {
+      if (binding.__caatingaPlaceholder) {
+        throw new CaatingaError2(
+          "Placeholder bindings are still in use; the app cannot reach the contract.",
+          CaatingaErrorCode2.PLACEHOLDER_BINDING,
+          "Run `caatinga generate <contract> --network <network>`, then restart the dev server."
+        );
+      }
       if (!binding.Client) {
         throw new CaatingaError2(
           "Generated binding does not export Client.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/client",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Browser and Node client for Soroban smart contracts — connects generated bindings, Caatinga artifacts, and wallet adapters",
   "keywords": [
     "stellar",
@@ -51,7 +51,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@caatinga/core": "^2.0.1"
+    "@caatinga/core": "^2.1.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",