npm - @andrewkimjoseph/celina-sdk - Versions diffs - 0.15.1 → 0.15.2 - Mend

@@ -0,0 +1,12 @@
+export interface TestConfig {
+    rpcUrl: string;
+    ethRpcUrl?: string;
+    analyticsEnabled?: boolean;
+}
+export declare function hasCeloWallet(): boolean;
+export declare function hasSelfAgentKey(): boolean;
+export declare function allowsTestWrites(): boolean;
+export declare function allowsDestructiveTests(): boolean;
+export declare function getSignerAddress(): `0x${string}` | undefined;
+/** RPC URLs aligned with celina-mcp `loadConfig()`. */
+export declare function loadTestConfig(): TestConfig;

@@ -0,0 +1,29 @@
+import { privateKeyToAccount } from "viem/accounts";
+export function hasCeloWallet() {
+    return Boolean(process.env.CELO_PRIVATE_KEY);
+}
+export function hasSelfAgentKey() {
+    return Boolean(process.env.SELF_AGENT_PRIVATE_KEY);
+}
+export function allowsTestWrites() {
+    return process.env.CELINA_TEST_WRITES === "1";
+}
+export function allowsDestructiveTests() {
+    return process.env.CELINA_TEST_DESTRUCTIVE === "1";
+}
+export function getSignerAddress() {
+    const key = process.env.CELO_PRIVATE_KEY;
+    if (!key) {
+        return undefined;
+    }
+    return privateKeyToAccount(key).address;
+}
+/** RPC URLs aligned with celina-mcp `loadConfig()`. */
+export function loadTestConfig() {
+    return {
+        rpcUrl: process.env.CELO_RPC_URL_MAINNET ?? "https://forno.celo.org",
+        ethRpcUrl: process.env.ETH_RPC_URL_MAINNET,
+        analyticsEnabled: false,
+    };
+}
+//# sourceMappingURL=env.js.map

@@ -0,0 +1,3 @@
+import type { OperationSpec } from "../catalog/types.js";
+/** Returns a skip reason when the operation should not run, otherwise undefined. */
+export declare function getOperationSkipReason(spec: OperationSpec): string | undefined;

@@ -0,0 +1,23 @@
+import { allowsDestructiveTests, allowsTestWrites, hasCeloWallet, hasSelfAgentKey, } from "./env.js";
+const ENV_CHECKS = {
+    CELO_PRIVATE_KEY: hasCeloWallet,
+    SELF_AGENT_PRIVATE_KEY: hasSelfAgentKey,
+};
+/** Returns a skip reason when the operation should not run, otherwise undefined. */
+export function getOperationSkipReason(spec) {
+    if (spec.requiresDestructive && !allowsDestructiveTests()) {
+        return "Set CELINA_TEST_DESTRUCTIVE=1 to run destructive Self lifecycle tests";
+    }
+    if (spec.requiresWrites && !allowsTestWrites()) {
+        return "Set CELINA_TEST_WRITES=1 to run on-chain write tests";
+    }
+    if (spec.requiresEnv) {
+        for (const requirement of spec.requiresEnv) {
+            if (!ENV_CHECKS[requirement]()) {
+                return `Missing ${requirement}`;
+            }
+        }
+    }
+    return spec.skip?.() ?? undefined;
+}
+//# sourceMappingURL=gating.js.map

@@ -0,0 +1,6 @@
+export type { EnvRequirement, OperationLayer, OperationSpec, } from "./catalog/types.js";
+export { MCP_OPERATIONS, MCP_TOOL_NAMES, OPERATIONS, SDK_OPERATIONS, } from "./catalog/operations.js";
+export { ALL_TOOL_DEFINITIONS, getMcpToolNames, getBrowserToolNames, } from "../src/tools/catalog.js";
+export { getMainnetFixtures, type MainnetFixtures } from "./fixtures/mainnet.js";
+export { allowsDestructiveTests, allowsTestWrites, getSignerAddress, hasCeloWallet, hasSelfAgentKey, loadTestConfig, type TestConfig, } from "./helpers/env.js";
+export { getOperationSkipReason } from "./helpers/gating.js";

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina-sdk",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "Celina SDK — Celo mainnet reads, unsigned transaction preparation, and ERC-4337 createAAClient for sponsored UserOps.",
   "type": "module",
   "sideEffects": false,

@andrewkimjoseph/celina-sdk 0.15.1 → 0.15.2