@caatinga/core 2.3.0 → 2.4.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-Cq4ZofIq.cjs';
-export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.cjs';
+import { C as CaatingaArtifacts, c as ContractArtifact, d as CaatingaErrorCodeValue, a as CaatingaError } from './artifact.schema-BH5K-IiZ.cjs';
+export { e as CaatingaArtifactsSchema, b as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-BH5K-IiZ.cjs';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.3.0";
+declare const CAATINGA_CORE_VERSION = "2.4.0";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -75,7 +75,7 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>>;
-    frontend: z.ZodObject<{
+    frontend: z.ZodOptional<z.ZodObject<{
         framework: z.ZodDefault<z.ZodEnum<["vite-react", "next", "astro"]>>;
         bindingsOutput: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -84,7 +84,7 @@ declare const CaatingaConfigSchema: z.ZodObject<{
     }, {
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
-    }>;
+    }>>;
     zk: z.ZodOptional<z.ZodObject<{
         circuits: z.ZodRecord<z.ZodString, z.ZodObject<{
             path: z.ZodString;
@@ -130,10 +130,10 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>;
-    frontend: {
+    frontend?: {
         framework: "vite-react" | "next" | "astro";
         bindingsOutput: string;
-    };
+    } | undefined;
     zk?: {
         circuits: Record<string, {
             path: string;
@@ -154,11 +154,11 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>;
-    frontend: {
+    defaultNetwork?: string | undefined;
+    frontend?: {
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
-    };
-    defaultNetwork?: string | undefined;
+    } | undefined;
     zk?: {
         circuits: Record<string, {
             path: string;
@@ -286,6 +286,9 @@ type RunCommandOptions = {
 };
 declare function runCommand(command: string, args: string[], options?: RunCommandOptions): Promise<RunCommandResult>;
 
+declare function resolveSubprocessEnv(overrides?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+declare function isCargoBinMissingFromPath(baseEnv?: NodeJS.ProcessEnv): boolean;
+
 type CheckBinaryOptions = {
     skipStellarVersionCheck?: boolean;
 };
@@ -476,6 +479,11 @@ type InvokeTarget = {
     contractName: string;
     method: string;
 };
+declare const READ_CALL_FAILURE_REGEX: RegExp;
+declare function parseInvokeTarget(target: string): InvokeTarget;
+declare function buildReadCallHint(target: InvokeTarget, networkName: string): string;
+declare function isReadCallFailure(error: unknown): boolean;
+
 type InvokeContractOptions = {
     config: CaatingaConfig;
     target: string;
@@ -484,13 +492,26 @@ type InvokeContractOptions = {
     source?: string;
     cwd?: string;
 };
-declare function parseInvokeTarget(target: string): InvokeTarget;
 declare function invokeContract(options: InvokeContractOptions): Promise<{
     target: InvokeTarget;
     network: ResolvedNetwork;
     result: string;
 }>;
 
+type ReadContractOptions = {
+    config: CaatingaConfig;
+    target: string;
+    args?: string[];
+    networkName?: string;
+    source?: string;
+    cwd?: string;
+};
+declare function readContract(options: ReadContractOptions): Promise<{
+    target: InvokeTarget;
+    network: ResolvedNetwork;
+    result: string;
+}>;
+
 type CreateProjectFromTemplateOptions = {
     projectName: string;
     targetDir: string;
@@ -522,6 +543,25 @@ declare function createProjectFromTemplate(options: CreateProjectFromTemplateOpt
     };
 }>;
 
+type CreateZkProjectOptions = {
+    projectName: string;
+    targetDir: string;
+    force?: boolean;
+    projectFiles?: boolean;
+};
+declare function createZkProject(options: CreateZkProjectOptions): Promise<{
+    targetDir: string;
+}>;
+
+type CreateMinimalProjectOptions = {
+    projectName: string;
+    targetDir: string;
+    force?: boolean;
+};
+declare function createMinimalProject(options: CreateMinimalProjectOptions): Promise<{
+    targetDir: string;
+}>;
+
 declare const TemplateManifestSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
@@ -611,4 +651,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 CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, 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 CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateMinimalProjectOptions, type CreateProjectFromTemplateOptions, type CreateZkProjectOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, 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, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, buildReadCallHint, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createMinimalProject, createProjectFromTemplate, createZkProject, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isCargoBinMissingFromPath, isReadCallFailure, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, readContract, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, resolveSubprocessEnv, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-Cq4ZofIq.js';
-export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.js';
+import { C as CaatingaArtifacts, c as ContractArtifact, d as CaatingaErrorCodeValue, a as CaatingaError } from './artifact.schema-BH5K-IiZ.js';
+export { e as CaatingaArtifactsSchema, b as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './artifact.schema-BH5K-IiZ.js';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.3.0";
+declare const CAATINGA_CORE_VERSION = "2.4.0";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -75,7 +75,7 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>>;
-    frontend: z.ZodObject<{
+    frontend: z.ZodOptional<z.ZodObject<{
         framework: z.ZodDefault<z.ZodEnum<["vite-react", "next", "astro"]>>;
         bindingsOutput: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -84,7 +84,7 @@ declare const CaatingaConfigSchema: z.ZodObject<{
     }, {
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
-    }>;
+    }>>;
     zk: z.ZodOptional<z.ZodObject<{
         circuits: z.ZodRecord<z.ZodString, z.ZodObject<{
             path: z.ZodString;
@@ -130,10 +130,10 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>;
-    frontend: {
+    frontend?: {
         framework: "vite-react" | "next" | "astro";
         bindingsOutput: string;
-    };
+    } | undefined;
     zk?: {
         circuits: Record<string, {
             path: string;
@@ -154,11 +154,11 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         rpcUrl: string;
         networkPassphrase: string;
     }>;
-    frontend: {
+    defaultNetwork?: string | undefined;
+    frontend?: {
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
-    };
-    defaultNetwork?: string | undefined;
+    } | undefined;
     zk?: {
         circuits: Record<string, {
             path: string;
@@ -286,6 +286,9 @@ type RunCommandOptions = {
 };
 declare function runCommand(command: string, args: string[], options?: RunCommandOptions): Promise<RunCommandResult>;
 
+declare function resolveSubprocessEnv(overrides?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+declare function isCargoBinMissingFromPath(baseEnv?: NodeJS.ProcessEnv): boolean;
+
 type CheckBinaryOptions = {
     skipStellarVersionCheck?: boolean;
 };
@@ -476,6 +479,11 @@ type InvokeTarget = {
     contractName: string;
     method: string;
 };
+declare const READ_CALL_FAILURE_REGEX: RegExp;
+declare function parseInvokeTarget(target: string): InvokeTarget;
+declare function buildReadCallHint(target: InvokeTarget, networkName: string): string;
+declare function isReadCallFailure(error: unknown): boolean;
+
 type InvokeContractOptions = {
     config: CaatingaConfig;
     target: string;
@@ -484,13 +492,26 @@ type InvokeContractOptions = {
     source?: string;
     cwd?: string;
 };
-declare function parseInvokeTarget(target: string): InvokeTarget;
 declare function invokeContract(options: InvokeContractOptions): Promise<{
     target: InvokeTarget;
     network: ResolvedNetwork;
     result: string;
 }>;
 
+type ReadContractOptions = {
+    config: CaatingaConfig;
+    target: string;
+    args?: string[];
+    networkName?: string;
+    source?: string;
+    cwd?: string;
+};
+declare function readContract(options: ReadContractOptions): Promise<{
+    target: InvokeTarget;
+    network: ResolvedNetwork;
+    result: string;
+}>;
+
 type CreateProjectFromTemplateOptions = {
     projectName: string;
     targetDir: string;
@@ -522,6 +543,25 @@ declare function createProjectFromTemplate(options: CreateProjectFromTemplateOpt
     };
 }>;
 
+type CreateZkProjectOptions = {
+    projectName: string;
+    targetDir: string;
+    force?: boolean;
+    projectFiles?: boolean;
+};
+declare function createZkProject(options: CreateZkProjectOptions): Promise<{
+    targetDir: string;
+}>;
+
+type CreateMinimalProjectOptions = {
+    projectName: string;
+    targetDir: string;
+    force?: boolean;
+};
+declare function createMinimalProject(options: CreateMinimalProjectOptions): Promise<{
+    targetDir: string;
+}>;
+
 declare const TemplateManifestSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
@@ -611,4 +651,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 CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, 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 CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateMinimalProjectOptions, type CreateProjectFromTemplateOptions, type CreateZkProjectOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, 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, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, buildReadCallHint, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createMinimalProject, createProjectFromTemplate, createZkProject, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isCargoBinMissingFromPath, isReadCallFailure, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, readContract, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, resolveSubprocessEnv, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };