@caatinga/core 3.3.0 → 3.3.1

package/dist/index.cjs

@@ -38,6 +38,7 @@ __export(index_exports, {
   CaatingaConfigSchema: () => CaatingaConfigSchema,
   CaatingaError: () => CaatingaError,
   CaatingaErrorCode: () => CaatingaErrorCode,
+  DEFAULT_CLI_SOURCE: () => DEFAULT_CLI_SOURCE,
   READ_CALL_FAILURE_REGEX: () => READ_CALL_FAILURE_REGEX,
   STELLAR_CLI_LAST_TESTED_VERSION: () => STELLAR_CLI_LAST_TESTED_VERSION,
   STELLAR_CLI_MIN_VERSION: () => STELLAR_CLI_MIN_VERSION,
@@ -59,6 +60,7 @@ __export(index_exports, {
   defineConfig: () => defineConfig,
   deployContract: () => deployContract,
   deployContractGraph: () => deployContractGraph,
+  describeCliSource: () => describeCliSource,
   estimateDeployCost: () => estimateDeployCost,
   evaluateBindingFreshness: () => evaluateBindingFreshness,
   evaluateBindingsFreshness: () => evaluateBindingsFreshness,
@@ -1282,6 +1284,36 @@ function validateSourceShape(source) {
   return void 0;
 }
 
+// src/contracts/source-account.ts
+function assertSafeSourceAccount(source) {
+  if (!source) {
+    throw new CaatingaError(
+      "A source account or Stellar CLI identity is required.",
+      CaatingaErrorCode.SOURCE_ACCOUNT_REQUIRED,
+      "Pass a Stellar CLI identity alias, for example: --source alice"
+    );
+  }
+  const unsafeSource = validateSourceShape(source);
+  if (unsafeSource) {
+    throw unsafeSource;
+  }
+  return source;
+}
+var DEFAULT_CLI_SOURCE = "alice";
+function describeCliSource(explicit) {
+  if (explicit) {
+    return { source: assertSafeSourceAccount(explicit), origin: "explicit" };
+  }
+  const fromEnv = process.env.CAATINGA_SOURCE;
+  if (fromEnv) {
+    return { source: assertSafeSourceAccount(fromEnv), origin: "env" };
+  }
+  return { source: assertSafeSourceAccount(DEFAULT_CLI_SOURCE), origin: "default" };
+}
+function resolveCliSource(explicit) {
+  return describeCliSource(explicit).source;
+}
+
 // src/contracts/resolve-contract.ts
 var import_node_path8 = __toESM(require("path"), 1);
 function resolveContract(config, contractName, cwd = process.cwd()) {
@@ -1594,25 +1626,6 @@ function resolveDeployArgs(input) {
   return resolved;
 }
 
-// src/contracts/source-account.ts
-function assertSafeSourceAccount(source) {
-  if (!source) {
-    throw new CaatingaError(
-      "A source account or Stellar CLI identity is required.",
-      CaatingaErrorCode.SOURCE_ACCOUNT_REQUIRED,
-      "Pass a Stellar CLI identity alias, for example: --source alice"
-    );
-  }
-  const unsafeSource = validateSourceShape(source);
-  if (unsafeSource) {
-    throw unsafeSource;
-  }
-  return source;
-}
-function resolveCliSource(explicit) {
-  return assertSafeSourceAccount(explicit ?? process.env.CAATINGA_SOURCE ?? "alice");
-}
-
 // src/contracts/deploy-contract.ts
 var DEFAULT_DEPLOY_RETRY_DELAYS_MS = [2e3, 5e3];
 function sleep(ms) {
@@ -2647,13 +2660,19 @@ async function replaceTemplateVariables(dir, projectName) {
   const entries = await (0, import_promises10.readdir)(dir);
   await Promise.all(
     entries.map(async (entry) => {
+      if (TEMPLATE_COPY_EXCLUDED_DIRS.has(entry)) {
+        return;
+      }
       const entryPath = import_node_path14.default.join(dir, entry);
-      const entryStat = await (0, import_promises10.stat)(entryPath);
+      const entryStat = await (0, import_promises10.lstat)(entryPath);
+      if (entryStat.isSymbolicLink()) {
+        return;
+      }
       if (entryStat.isDirectory()) {
         await replaceTemplateVariables(entryPath, projectName);
         return;
       }
-      if (!isTextTemplateFile(entryPath)) {
+      if (!entryStat.isFile() || !isTextTemplateFile(entryPath)) {
         return;
       }
       const content = await (0, import_promises10.readFile)(entryPath, "utf8");
@@ -2980,6 +2999,7 @@ function isTransientTestnetSmokeFailure(logText) {
   CaatingaConfigSchema,
   CaatingaError,
   CaatingaErrorCode,
+  DEFAULT_CLI_SOURCE,
   READ_CALL_FAILURE_REGEX,
   STELLAR_CLI_LAST_TESTED_VERSION,
   STELLAR_CLI_MIN_VERSION,
@@ -3001,6 +3021,7 @@ function isTransientTestnetSmokeFailure(logText) {
   defineConfig,
   deployContract,
   deployContractGraph,
+  describeCliSource,
   estimateDeployCost,
   evaluateBindingFreshness,
   evaluateBindingsFreshness,

package/dist/index.d.cts

@@ -459,6 +459,21 @@ declare function checkStellarSdkVersion(input?: CheckStellarSdkVersionOptions):
 
 declare function validateSourceShape(source: string): CaatingaError | undefined;
 
+/** Identity used when neither --source nor CAATINGA_SOURCE is provided. */
+declare const DEFAULT_CLI_SOURCE = "alice";
+/** Where a resolved CLI source value came from, for honest disclosure to users. */
+type CliSourceOrigin = "explicit" | "env" | "default";
+type ResolvedCliSource = {
+    source: string;
+    origin: CliSourceOrigin;
+};
+/**
+ * Resolve the CLI source identity and report where the value came from so the
+ * CLI can disclose an implicit fallback instead of silently signing/simulating
+ * as `alice`.
+ */
+declare function describeCliSource(explicit?: string): ResolvedCliSource;
+
 type ResolvedContract = {
     name: string;
     config: ContractConfig;
@@ -837,4 +852,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CheckStellarSdkVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractInspectResult, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateMinimalProjectOptions, type CreateProjectFromTemplateOptions, type CreateZkProjectOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type DeployCostEstimate, type EstimateDeployCostOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type EvaluateStellarSdkCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InspectContractOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, READ_CALL_FAILURE_REGEX, type ReadContractOptions, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, STELLAR_SDK_LAST_TESTED_VERSION, STELLAR_SDK_MIN_VERSION, type SdkCompatibilityReport, type SdkCompatibilityStatus, type SdkCompatibilityWarning, type SdkCompatibilityWarningCode, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, buildReadCallHint, checkBinary, checkStellarCliVersion, checkStellarSdkVersion, collectProjectStatus, createInitialArtifacts, createMinimalProject, createProjectFromTemplate, createZkProject, defineConfig, deployContract, deployContractGraph, estimateDeployCost, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, evaluateStellarSdkCompatibility, generateBindings, generateBindingsGraph, inspectContract, invokeContract, isCargoBinMissingFromPath, isReadCallFailure, isTransientTestnetSmokeFailure, loadConfig, migrateArtifactsFile, migrateArtifactsToV2, parseContractId, parseInvokeTarget, parseStellarCliVersion, parseStellarSdkVersion, readArtifacts, readBindingMarker, readContract, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, resolveSubprocessEnv, restoreArtifactFromHistory, rollbackContractArtifact, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };
+export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CheckStellarSdkVersionOptions, type CliSourceOrigin, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractInspectResult, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateMinimalProjectOptions, type CreateProjectFromTemplateOptions, type CreateZkProjectOptions, DEFAULT_CLI_SOURCE, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type DeployCostEstimate, type EstimateDeployCostOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type EvaluateStellarSdkCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InspectContractOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, READ_CALL_FAILURE_REGEX, type ReadContractOptions, type ResolvedCliSource, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, STELLAR_SDK_LAST_TESTED_VERSION, STELLAR_SDK_MIN_VERSION, type SdkCompatibilityReport, type SdkCompatibilityStatus, type SdkCompatibilityWarning, type SdkCompatibilityWarningCode, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, buildReadCallHint, checkBinary, checkStellarCliVersion, checkStellarSdkVersion, collectProjectStatus, createInitialArtifacts, createMinimalProject, createProjectFromTemplate, createZkProject, defineConfig, deployContract, deployContractGraph, describeCliSource, estimateDeployCost, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, evaluateStellarSdkCompatibility, generateBindings, generateBindingsGraph, inspectContract, invokeContract, isCargoBinMissingFromPath, isReadCallFailure, isTransientTestnetSmokeFailure, loadConfig, migrateArtifactsFile, migrateArtifactsToV2, parseContractId, parseInvokeTarget, parseStellarCliVersion, parseStellarSdkVersion, readArtifacts, readBindingMarker, readContract, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, resolveSubprocessEnv, restoreArtifactFromHistory, rollbackContractArtifact, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };

package/dist/index.d.ts

@@ -459,6 +459,21 @@ declare function checkStellarSdkVersion(input?: CheckStellarSdkVersionOptions):
 
 declare function validateSourceShape(source: string): CaatingaError | undefined;
 
+/** Identity used when neither --source nor CAATINGA_SOURCE is provided. */
+declare const DEFAULT_CLI_SOURCE = "alice";
+/** Where a resolved CLI source value came from, for honest disclosure to users. */
+type CliSourceOrigin = "explicit" | "env" | "default";
+type ResolvedCliSource = {
+    source: string;
+    origin: CliSourceOrigin;
+};
+/**
+ * Resolve the CLI source identity and report where the value came from so the
+ * CLI can disclose an implicit fallback instead of silently signing/simulating
+ * as `alice`.
+ */
+declare function describeCliSource(explicit?: string): ResolvedCliSource;
+
 type ResolvedContract = {
     name: string;
     config: ContractConfig;
@@ -837,4 +852,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CheckStellarSdkVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractInspectResult, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateMinimalProjectOptions, type CreateProjectFromTemplateOptions, type CreateZkProjectOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type DeployCostEstimate, type EstimateDeployCostOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type EvaluateStellarSdkCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InspectContractOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, READ_CALL_FAILURE_REGEX, type ReadContractOptions, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, STELLAR_SDK_LAST_TESTED_VERSION, STELLAR_SDK_MIN_VERSION, type SdkCompatibilityReport, type SdkCompatibilityStatus, type SdkCompatibilityWarning, type SdkCompatibilityWarningCode, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, buildReadCallHint, checkBinary, checkStellarCliVersion, checkStellarSdkVersion, collectProjectStatus, createInitialArtifacts, createMinimalProject, createProjectFromTemplate, createZkProject, defineConfig, deployContract, deployContractGraph, estimateDeployCost, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, evaluateStellarSdkCompatibility, generateBindings, generateBindingsGraph, inspectContract, invokeContract, isCargoBinMissingFromPath, isReadCallFailure, isTransientTestnetSmokeFailure, loadConfig, migrateArtifactsFile, migrateArtifactsToV2, parseContractId, parseInvokeTarget, parseStellarCliVersion, parseStellarSdkVersion, readArtifacts, readBindingMarker, readContract, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, resolveSubprocessEnv, restoreArtifactFromHistory, rollbackContractArtifact, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };
+export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CheckStellarSdkVersionOptions, type CliSourceOrigin, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractInspectResult, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateMinimalProjectOptions, type CreateProjectFromTemplateOptions, type CreateZkProjectOptions, DEFAULT_CLI_SOURCE, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type DeployCostEstimate, type EstimateDeployCostOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type EvaluateStellarSdkCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InspectContractOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, READ_CALL_FAILURE_REGEX, type ReadContractOptions, type ResolvedCliSource, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, STELLAR_SDK_LAST_TESTED_VERSION, STELLAR_SDK_MIN_VERSION, type SdkCompatibilityReport, type SdkCompatibilityStatus, type SdkCompatibilityWarning, type SdkCompatibilityWarningCode, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, buildReadCallHint, checkBinary, checkStellarCliVersion, checkStellarSdkVersion, collectProjectStatus, createInitialArtifacts, createMinimalProject, createProjectFromTemplate, createZkProject, defineConfig, deployContract, deployContractGraph, describeCliSource, estimateDeployCost, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, evaluateStellarSdkCompatibility, generateBindings, generateBindingsGraph, inspectContract, invokeContract, isCargoBinMissingFromPath, isReadCallFailure, isTransientTestnetSmokeFailure, loadConfig, migrateArtifactsFile, migrateArtifactsToV2, parseContractId, parseInvokeTarget, parseStellarCliVersion, parseStellarSdkVersion, readArtifacts, readBindingMarker, readContract, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, resolveSubprocessEnv, restoreArtifactFromHistory, rollbackContractArtifact, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };

package/dist/index.js

@@ -1179,6 +1179,36 @@ function validateSourceShape(source) {
   return void 0;
 }
 
+// src/contracts/source-account.ts
+function assertSafeSourceAccount(source) {
+  if (!source) {
+    throw new CaatingaError(
+      "A source account or Stellar CLI identity is required.",
+      CaatingaErrorCode.SOURCE_ACCOUNT_REQUIRED,
+      "Pass a Stellar CLI identity alias, for example: --source alice"
+    );
+  }
+  const unsafeSource = validateSourceShape(source);
+  if (unsafeSource) {
+    throw unsafeSource;
+  }
+  return source;
+}
+var DEFAULT_CLI_SOURCE = "alice";
+function describeCliSource(explicit) {
+  if (explicit) {
+    return { source: assertSafeSourceAccount(explicit), origin: "explicit" };
+  }
+  const fromEnv = process.env.CAATINGA_SOURCE;
+  if (fromEnv) {
+    return { source: assertSafeSourceAccount(fromEnv), origin: "env" };
+  }
+  return { source: assertSafeSourceAccount(DEFAULT_CLI_SOURCE), origin: "default" };
+}
+function resolveCliSource(explicit) {
+  return describeCliSource(explicit).source;
+}
+
 // src/contracts/resolve-contract.ts
 import path8 from "path";
 function resolveContract(config, contractName, cwd = process.cwd()) {
@@ -1491,25 +1521,6 @@ function resolveDeployArgs(input) {
   return resolved;
 }
 
-// src/contracts/source-account.ts
-function assertSafeSourceAccount(source) {
-  if (!source) {
-    throw new CaatingaError(
-      "A source account or Stellar CLI identity is required.",
-      CaatingaErrorCode.SOURCE_ACCOUNT_REQUIRED,
-      "Pass a Stellar CLI identity alias, for example: --source alice"
-    );
-  }
-  const unsafeSource = validateSourceShape(source);
-  if (unsafeSource) {
-    throw unsafeSource;
-  }
-  return source;
-}
-function resolveCliSource(explicit) {
-  return assertSafeSourceAccount(explicit ?? process.env.CAATINGA_SOURCE ?? "alice");
-}
-
 // src/contracts/deploy-contract.ts
 var DEFAULT_DEPLOY_RETRY_DELAYS_MS = [2e3, 5e3];
 function sleep(ms) {
@@ -2392,7 +2403,7 @@ async function inspectContract(options) {
 }
 
 // src/templates/create-project-from-template.ts
-import { cp, mkdir as mkdir3, readFile as readFile6, readdir as readdir3, stat as stat2, writeFile as writeFile4 } from "fs/promises";
+import { cp, lstat, mkdir as mkdir3, readFile as readFile6, readdir as readdir3, stat as stat2, writeFile as writeFile4 } from "fs/promises";
 import path14 from "path";
 import { z as z7 } from "zod";
 
@@ -2544,13 +2555,19 @@ async function replaceTemplateVariables(dir, projectName) {
   const entries = await readdir3(dir);
   await Promise.all(
     entries.map(async (entry) => {
+      if (TEMPLATE_COPY_EXCLUDED_DIRS.has(entry)) {
+        return;
+      }
       const entryPath = path14.join(dir, entry);
-      const entryStat = await stat2(entryPath);
+      const entryStat = await lstat(entryPath);
+      if (entryStat.isSymbolicLink()) {
+        return;
+      }
       if (entryStat.isDirectory()) {
         await replaceTemplateVariables(entryPath, projectName);
         return;
       }
-      if (!isTextTemplateFile(entryPath)) {
+      if (!entryStat.isFile() || !isTextTemplateFile(entryPath)) {
         return;
       }
       const content = await readFile6(entryPath, "utf8");
@@ -2874,6 +2891,7 @@ export {
   CaatingaConfigSchema,
   CaatingaError,
   CaatingaErrorCode,
+  DEFAULT_CLI_SOURCE,
   READ_CALL_FAILURE_REGEX,
   STELLAR_CLI_LAST_TESTED_VERSION,
   STELLAR_CLI_MIN_VERSION,
@@ -2895,6 +2913,7 @@ export {
   defineConfig,
   deployContract,
   deployContractGraph,
+  describeCliSource,
   estimateDeployCost,
   evaluateBindingFreshness,
   evaluateBindingsFreshness,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/core",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "Core config, artifacts, command orchestration, and error primitives for Caatinga/Soroban toolkit",
   "keywords": [
     "stellar",