@caatinga/core 0.2.4 → 2.0.1

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-CuET2GqM.cjs';
-export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-CuET2GqM.cjs';
+import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-djYObNl8.cjs';
+export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-djYObNl8.cjs';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "0.2.4";
+declare const CAATINGA_CORE_VERSION = "2.0.1";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -135,7 +135,10 @@ declare function loadConfig(options?: LoadConfigOptions): Promise<CaatingaConfig
 declare function readArtifacts(cwd?: string): Promise<CaatingaArtifacts>;
 
 declare function writeArtifacts(artifacts: CaatingaArtifacts, cwd?: string): Promise<string>;
-declare function createInitialArtifacts(project: string): CaatingaArtifacts;
+type CreateInitialArtifactsOptions = {
+    networks?: string[];
+};
+declare function createInitialArtifacts(project: string, options?: CreateInitialArtifactsOptions): CaatingaArtifacts;
 
 declare function updateArtifact(artifacts: CaatingaArtifacts, networkName: string, contractName: string, contractArtifact: ContractArtifact, networkExtras?: {
     dependencyGraph?: Record<string, string[]>;
@@ -157,14 +160,12 @@ type RunCommandResult = {
 type RunCommandOptions = {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
-    allowUntestedStellarCli?: boolean;
     skipStellarVersionCheck?: boolean;
     failureCode?: CaatingaErrorCodeValue;
 };
 declare function runCommand(command: string, args: string[], options?: RunCommandOptions): Promise<RunCommandResult>;
 
 type CheckBinaryOptions = {
-    allowUntestedStellarCli?: boolean;
     skipStellarVersionCheck?: boolean;
 };
 declare function checkBinary(binary: string, hint: string, options?: CheckBinaryOptions): Promise<void>;
@@ -172,12 +173,36 @@ declare function checkBinary(binary: string, hint: string, options?: CheckBinary
 declare function parseContractId(output: string): string;
 
 declare const STELLAR_CLI_MIN_VERSION = "23.0.0";
-declare const STELLAR_CLI_TESTED_MAX_VERSION = "25.2.0";
 declare function parseStellarCliVersion(output: string): string;
-declare function assertSupportedStellarCliVersion(input: {
+
+declare const STELLAR_CLI_LAST_TESTED_VERSION = "25.2.0";
+type CompatibilityStatus = "supported" | "untested" | "unsupported";
+type CompatibilityWarningCode = "STELLAR_CLI_UNTESTED_VERSION" | "STELLAR_CLI_MISSING_FEATURE";
+type CompatibilityWarning = {
+    code: CompatibilityWarningCode;
+    message: string;
+    remediation?: string;
+};
+type CompatibilityReport = {
+    version: string;
+    status: CompatibilityStatus;
+    minVersion: string;
+    lastTestedVersion: string;
+    warnings: CompatibilityWarning[];
+};
+type EvaluateStellarCliCompatibilityInput = {
     version: string;
-    allowUntested: boolean;
-}): string;
+    features?: readonly string[];
+    lastTestedVersion?: string;
+};
+declare function evaluateStellarCliCompatibility(input: EvaluateStellarCliCompatibilityInput): CompatibilityReport;
+
+type CheckStellarCliVersionOptions = {
+    features?: readonly string[];
+    lastTestedVersion?: string;
+    onWarning?: (warning: CompatibilityWarning) => void;
+};
+declare function checkStellarCliVersion(input?: CheckStellarCliVersionOptions): Promise<CompatibilityReport>;
 
 declare function validateSourceShape(source: string): CaatingaError | undefined;
 
@@ -193,7 +218,6 @@ type BuildContractOptions = {
     config: CaatingaConfig;
     contractName: string;
     cwd?: string;
-    allowUntestedStellarCli?: boolean;
 };
 declare function buildContract(options: BuildContractOptions): Promise<{
     contract: {
@@ -218,7 +242,6 @@ type DeployContractOptions = {
     networkName?: string;
     source?: string;
     cwd?: string;
-    allowUntestedStellarCli?: boolean;
     force?: boolean;
     checkStaleWasm?: boolean;
     resolvedDeployArgs?: Record<string, DeployArgValue>;
@@ -258,6 +281,7 @@ type SkippedContract = {
     network: string;
     reason: "already-deployed";
 };
+
 type StaleWasmWarning = {
     contract: string;
     message: string;
@@ -279,7 +303,6 @@ declare function deployContractGraph(options: {
     cwd?: string;
     includeDependencies: boolean;
     force: boolean;
-    allowUntestedStellarCli?: boolean;
     checkStaleWasm?: boolean;
     verifyDeps?: boolean;
 }): Promise<DeployContractGraphResult>;
@@ -297,7 +320,6 @@ type GenerateBindingsOptions = {
     contractName: string;
     networkName?: string;
     cwd?: string;
-    allowUntestedStellarCli?: boolean;
 };
 declare function generateBindings(options: GenerateBindingsOptions): Promise<{
     contractName: string;
@@ -317,7 +339,6 @@ type InvokeContractOptions = {
     networkName?: string;
     source?: string;
     cwd?: string;
-    allowUntestedStellarCli?: boolean;
 };
 declare function parseInvokeTarget(target: string): InvokeTarget;
 declare function invokeContract(options: InvokeContractOptions): Promise<{
@@ -445,4 +466,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, ContractArtifact, type ContractConfig, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_MIN_VERSION, STELLAR_CLI_TESTED_MAX_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, assertSupportedStellarCliVersion, buildContract, buildDependencyGraph, checkBinary, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };
+export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, 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, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateStellarCliCompatibility, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-CuET2GqM.js';
-export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-CuET2GqM.js';
+import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-djYObNl8.js';
+export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-djYObNl8.js';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "0.2.4";
+declare const CAATINGA_CORE_VERSION = "2.0.1";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -135,7 +135,10 @@ declare function loadConfig(options?: LoadConfigOptions): Promise<CaatingaConfig
 declare function readArtifacts(cwd?: string): Promise<CaatingaArtifacts>;
 
 declare function writeArtifacts(artifacts: CaatingaArtifacts, cwd?: string): Promise<string>;
-declare function createInitialArtifacts(project: string): CaatingaArtifacts;
+type CreateInitialArtifactsOptions = {
+    networks?: string[];
+};
+declare function createInitialArtifacts(project: string, options?: CreateInitialArtifactsOptions): CaatingaArtifacts;
 
 declare function updateArtifact(artifacts: CaatingaArtifacts, networkName: string, contractName: string, contractArtifact: ContractArtifact, networkExtras?: {
     dependencyGraph?: Record<string, string[]>;
@@ -157,14 +160,12 @@ type RunCommandResult = {
 type RunCommandOptions = {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
-    allowUntestedStellarCli?: boolean;
     skipStellarVersionCheck?: boolean;
     failureCode?: CaatingaErrorCodeValue;
 };
 declare function runCommand(command: string, args: string[], options?: RunCommandOptions): Promise<RunCommandResult>;
 
 type CheckBinaryOptions = {
-    allowUntestedStellarCli?: boolean;
     skipStellarVersionCheck?: boolean;
 };
 declare function checkBinary(binary: string, hint: string, options?: CheckBinaryOptions): Promise<void>;
@@ -172,12 +173,36 @@ declare function checkBinary(binary: string, hint: string, options?: CheckBinary
 declare function parseContractId(output: string): string;
 
 declare const STELLAR_CLI_MIN_VERSION = "23.0.0";
-declare const STELLAR_CLI_TESTED_MAX_VERSION = "25.2.0";
 declare function parseStellarCliVersion(output: string): string;
-declare function assertSupportedStellarCliVersion(input: {
+
+declare const STELLAR_CLI_LAST_TESTED_VERSION = "25.2.0";
+type CompatibilityStatus = "supported" | "untested" | "unsupported";
+type CompatibilityWarningCode = "STELLAR_CLI_UNTESTED_VERSION" | "STELLAR_CLI_MISSING_FEATURE";
+type CompatibilityWarning = {
+    code: CompatibilityWarningCode;
+    message: string;
+    remediation?: string;
+};
+type CompatibilityReport = {
+    version: string;
+    status: CompatibilityStatus;
+    minVersion: string;
+    lastTestedVersion: string;
+    warnings: CompatibilityWarning[];
+};
+type EvaluateStellarCliCompatibilityInput = {
     version: string;
-    allowUntested: boolean;
-}): string;
+    features?: readonly string[];
+    lastTestedVersion?: string;
+};
+declare function evaluateStellarCliCompatibility(input: EvaluateStellarCliCompatibilityInput): CompatibilityReport;
+
+type CheckStellarCliVersionOptions = {
+    features?: readonly string[];
+    lastTestedVersion?: string;
+    onWarning?: (warning: CompatibilityWarning) => void;
+};
+declare function checkStellarCliVersion(input?: CheckStellarCliVersionOptions): Promise<CompatibilityReport>;
 
 declare function validateSourceShape(source: string): CaatingaError | undefined;
 
@@ -193,7 +218,6 @@ type BuildContractOptions = {
     config: CaatingaConfig;
     contractName: string;
     cwd?: string;
-    allowUntestedStellarCli?: boolean;
 };
 declare function buildContract(options: BuildContractOptions): Promise<{
     contract: {
@@ -218,7 +242,6 @@ type DeployContractOptions = {
     networkName?: string;
     source?: string;
     cwd?: string;
-    allowUntestedStellarCli?: boolean;
     force?: boolean;
     checkStaleWasm?: boolean;
     resolvedDeployArgs?: Record<string, DeployArgValue>;
@@ -258,6 +281,7 @@ type SkippedContract = {
     network: string;
     reason: "already-deployed";
 };
+
 type StaleWasmWarning = {
     contract: string;
     message: string;
@@ -279,7 +303,6 @@ declare function deployContractGraph(options: {
     cwd?: string;
     includeDependencies: boolean;
     force: boolean;
-    allowUntestedStellarCli?: boolean;
     checkStaleWasm?: boolean;
     verifyDeps?: boolean;
 }): Promise<DeployContractGraphResult>;
@@ -297,7 +320,6 @@ type GenerateBindingsOptions = {
     contractName: string;
     networkName?: string;
     cwd?: string;
-    allowUntestedStellarCli?: boolean;
 };
 declare function generateBindings(options: GenerateBindingsOptions): Promise<{
     contractName: string;
@@ -317,7 +339,6 @@ type InvokeContractOptions = {
     networkName?: string;
     source?: string;
     cwd?: string;
-    allowUntestedStellarCli?: boolean;
 };
 declare function parseInvokeTarget(target: string): InvokeTarget;
 declare function invokeContract(options: InvokeContractOptions): Promise<{
@@ -445,4 +466,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, ContractArtifact, type ContractConfig, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_MIN_VERSION, STELLAR_CLI_TESTED_MAX_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, assertSupportedStellarCliVersion, buildContract, buildDependencyGraph, checkBinary, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };
+export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, 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, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateStellarCliCompatibility, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };