@caatinga/core 2.0.2 → 2.2.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-djYObNl8.cjs';
-export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-djYObNl8.cjs';
+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 { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.0.2";
+declare const CAATINGA_CORE_VERSION = "2.2.0";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -144,6 +144,78 @@ declare function updateArtifact(artifacts: CaatingaArtifacts, networkName: strin
     dependencyGraph?: Record<string, string[]>;
 }): CaatingaArtifacts;
 
+declare const BINDING_MARKER_FILENAME = ".caatinga-bindings.json";
+declare const BindingMarkerSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    contractId: z.ZodString;
+    wasmHash: z.ZodString;
+    network: z.ZodString;
+    generatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    contractId: string;
+    wasmHash: string;
+    version: 1;
+    network: string;
+    generatedAt: string;
+}, {
+    contractId: string;
+    wasmHash: string;
+    version: 1;
+    network: string;
+    generatedAt: string;
+}>;
+type BindingMarker = z.infer<typeof BindingMarkerSchema>;
+declare function writeBindingMarker(outputDir: string, marker: BindingMarker): Promise<void>;
+/** Returns null when the marker is absent or unreadable — freshness degrades, never throws. */
+declare function readBindingMarker(outputDir: string): Promise<BindingMarker | null>;
+
+type BindingFreshnessStatus = "fresh" | "stale" | "missing" | "unknown";
+type BindingFreshness = {
+    contractName: string;
+    status: BindingFreshnessStatus;
+    outputDir: string;
+    marker: BindingMarker | null;
+    reason?: string;
+};
+type EvaluateBindingFreshnessOptions = {
+    config: CaatingaConfig;
+    artifacts: CaatingaArtifacts;
+    networkName: string;
+    contractName: string;
+    cwd?: string;
+};
+declare function evaluateBindingFreshness(options: EvaluateBindingFreshnessOptions): Promise<BindingFreshness>;
+declare function evaluateBindingsFreshness(options: {
+    config: CaatingaConfig;
+    artifacts: CaatingaArtifacts;
+    networkName: string;
+    cwd?: string;
+}): Promise<BindingFreshness[]>;
+
+type ContractStatusEntry = {
+    name: string;
+    deployed: boolean;
+    contractId?: string;
+    wasmHash?: string;
+    deployedAt?: string;
+    dependencies: string[];
+    bindings: BindingFreshness;
+};
+type NetworkStatus = {
+    network: string;
+    contracts: ContractStatusEntry[];
+};
+type ProjectStatus = {
+    project: string;
+    networks: NetworkStatus[];
+};
+type CollectProjectStatusOptions = {
+    config: CaatingaConfig;
+    networkName?: string;
+    cwd?: string;
+};
+declare function collectProjectStatus(options: CollectProjectStatusOptions): Promise<ProjectStatus>;
+
 declare const WELL_KNOWN_NETWORKS: Record<string, NetworkConfig>;
 
 type ResolvedNetwork = {
@@ -327,9 +399,28 @@ declare function generateBindings(options: GenerateBindingsOptions): Promise<{
     outputDir: string;
     importPath: string;
     legacyStubRemoved: boolean;
+    marker: {
+        contractId: string;
+        wasmHash: string;
+        version: 1;
+        network: string;
+        generatedAt: string;
+    };
     output: string;
 }>;
 
+type GenerateBindingsGraphResult = {
+    network: ResolvedNetwork;
+    results: Array<Awaited<ReturnType<typeof generateBindings>>>;
+};
+declare function generateBindingsGraph(options: {
+    config: CaatingaConfig;
+    contractName?: string;
+    contractNames?: string[];
+    networkName?: string;
+    cwd?: string;
+}): Promise<GenerateBindingsGraphResult>;
+
 type InvokeTarget = {
     contractName: string;
     method: string;
@@ -468,4 +559,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-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 };
+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, resolveDeployArgs, resolveDeployOrder, resolveNetwork, 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-djYObNl8.js';
-export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-djYObNl8.js';
+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 { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.0.2";
+declare const CAATINGA_CORE_VERSION = "2.2.0";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -144,6 +144,78 @@ declare function updateArtifact(artifacts: CaatingaArtifacts, networkName: strin
     dependencyGraph?: Record<string, string[]>;
 }): CaatingaArtifacts;
 
+declare const BINDING_MARKER_FILENAME = ".caatinga-bindings.json";
+declare const BindingMarkerSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    contractId: z.ZodString;
+    wasmHash: z.ZodString;
+    network: z.ZodString;
+    generatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    contractId: string;
+    wasmHash: string;
+    version: 1;
+    network: string;
+    generatedAt: string;
+}, {
+    contractId: string;
+    wasmHash: string;
+    version: 1;
+    network: string;
+    generatedAt: string;
+}>;
+type BindingMarker = z.infer<typeof BindingMarkerSchema>;
+declare function writeBindingMarker(outputDir: string, marker: BindingMarker): Promise<void>;
+/** Returns null when the marker is absent or unreadable — freshness degrades, never throws. */
+declare function readBindingMarker(outputDir: string): Promise<BindingMarker | null>;
+
+type BindingFreshnessStatus = "fresh" | "stale" | "missing" | "unknown";
+type BindingFreshness = {
+    contractName: string;
+    status: BindingFreshnessStatus;
+    outputDir: string;
+    marker: BindingMarker | null;
+    reason?: string;
+};
+type EvaluateBindingFreshnessOptions = {
+    config: CaatingaConfig;
+    artifacts: CaatingaArtifacts;
+    networkName: string;
+    contractName: string;
+    cwd?: string;
+};
+declare function evaluateBindingFreshness(options: EvaluateBindingFreshnessOptions): Promise<BindingFreshness>;
+declare function evaluateBindingsFreshness(options: {
+    config: CaatingaConfig;
+    artifacts: CaatingaArtifacts;
+    networkName: string;
+    cwd?: string;
+}): Promise<BindingFreshness[]>;
+
+type ContractStatusEntry = {
+    name: string;
+    deployed: boolean;
+    contractId?: string;
+    wasmHash?: string;
+    deployedAt?: string;
+    dependencies: string[];
+    bindings: BindingFreshness;
+};
+type NetworkStatus = {
+    network: string;
+    contracts: ContractStatusEntry[];
+};
+type ProjectStatus = {
+    project: string;
+    networks: NetworkStatus[];
+};
+type CollectProjectStatusOptions = {
+    config: CaatingaConfig;
+    networkName?: string;
+    cwd?: string;
+};
+declare function collectProjectStatus(options: CollectProjectStatusOptions): Promise<ProjectStatus>;
+
 declare const WELL_KNOWN_NETWORKS: Record<string, NetworkConfig>;
 
 type ResolvedNetwork = {
@@ -327,9 +399,28 @@ declare function generateBindings(options: GenerateBindingsOptions): Promise<{
     outputDir: string;
     importPath: string;
     legacyStubRemoved: boolean;
+    marker: {
+        contractId: string;
+        wasmHash: string;
+        version: 1;
+        network: string;
+        generatedAt: string;
+    };
     output: string;
 }>;
 
+type GenerateBindingsGraphResult = {
+    network: ResolvedNetwork;
+    results: Array<Awaited<ReturnType<typeof generateBindings>>>;
+};
+declare function generateBindingsGraph(options: {
+    config: CaatingaConfig;
+    contractName?: string;
+    contractNames?: string[];
+    networkName?: string;
+    cwd?: string;
+}): Promise<GenerateBindingsGraphResult>;
+
 type InvokeTarget = {
     contractName: string;
     method: string;
@@ -468,4 +559,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-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 };
+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, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };