clarityxo-sdk 0.2.0 → 0.4.0

package/README.md

@@ -197,6 +197,8 @@ The SDK includes utility functions for board analysis:
 6. Format: `npm run format`
 7. Submit a PR
 
+If you'd like to contribute a bugfix or small improvement, open an issue first with a short description of the change. For larger features, open a discussion or draft PR so we can coordinate before significant design work.
+
 ## License
 
 MIT

package/dist/chunk-2P6NUM7A.mjs

@@ -0,0 +1,350 @@
+// src/constants.ts
+var CONTRACT_NAME = "tictactoe";
+var CONTRACT_ADDRESS = "SP30VGN68PSGVWGNMD0HH2WQMM5T486EK3YGP7Z3Y.clarity-xo-game";
+var MAINNET_API = "https://api.mainnet.hiro.so";
+var TESTNET_API = "https://api.testnet.hiro.so";
+var DEFAULT_LEADERBOARD_API = "https://clarityxo.onrender.com";
+var DEFAULT_NETWORK = "testnet";
+var CONTRACT_FUNCTIONS = {
+  START_NEW_GAME: "start-new-game",
+  MAKE_MOVE: "make-move",
+  RESIGN_GAME: "resign-game",
+  GET_BOARD_STATE: "get-board-state",
+  GET_GAME_STATUS: "get-game-status",
+  GET_WINNER: "get-winner",
+  GET_CURRENT_TURN: "get-current-turn",
+  IS_VALID_MOVE: "is-valid-move"
+};
+
+// src/contract/read.ts
+import { callReadOnlyFunction, uintCV } from "@stacks/transactions";
+
+// src/utils/network.ts
+import { StacksMainnet, StacksTestnet } from "@stacks/network";
+function getStacksNetwork(network) {
+  return network === "mainnet" ? new StacksMainnet() : new StacksTestnet();
+}
+
+// src/utils/cv.ts
+function parseBoardCV(cv) {
+  const rows = cv;
+  const board = [
+    [null, null, null],
+    [null, null, null],
+    [null, null, null]
+  ];
+  for (let i = 0; i < 3; i++) {
+    const row = rows.list[i].list;
+    for (let j = 0; j < 3; j++) {
+      const cell = row[j];
+      if (cell.type === "some") {
+        board[i][j] = cell.value.value;
+      } else {
+        board[i][j] = null;
+      }
+    }
+  }
+  return board;
+}
+function parseGameStatusCV(cv) {
+  const value = cv.value;
+  if (value === "active") return "active";
+  if (value === "finished") return "finished";
+  if (value === "not-started") return "not-started";
+  throw new Error(`Invalid game status: ${value}`);
+}
+function parseWinnerCV(cv) {
+  const value = cv.value;
+  if (value === "player") return "player";
+  if (value === "ai") return "ai";
+  if (value === "draw") return "draw";
+  return null;
+}
+function parseTurnCV(cv) {
+  const value = cv.value;
+  if (value === "player") return "player";
+  if (value === "ai") return "ai";
+  throw new Error(`Invalid turn: ${value}`);
+}
+
+// src/contract/read.ts
+async function getBoardState(config) {
+  const network = getStacksNetwork(config.network);
+  const contractName = config.contractName || CONTRACT_NAME;
+  const contractAddress = config.contractAddress || CONTRACT_ADDRESS;
+  const cv = await callReadOnlyFunction({
+    network,
+    contractAddress,
+    contractName,
+    functionName: CONTRACT_FUNCTIONS.GET_BOARD_STATE,
+    functionArgs: [],
+    senderAddress: contractAddress
+    // arbitrary
+  });
+  return parseBoardCV(cv);
+}
+async function getGameStatus(config) {
+  const network = getStacksNetwork(config.network);
+  const contractName = config.contractName || CONTRACT_NAME;
+  const contractAddress = config.contractAddress || CONTRACT_ADDRESS;
+  const cv = await callReadOnlyFunction({
+    network,
+    contractAddress,
+    contractName,
+    functionName: CONTRACT_FUNCTIONS.GET_GAME_STATUS,
+    functionArgs: [],
+    senderAddress: contractAddress
+  });
+  return parseGameStatusCV(cv);
+}
+async function getWinner(config) {
+  const network = getStacksNetwork(config.network);
+  const contractName = config.contractName || CONTRACT_NAME;
+  const contractAddress = config.contractAddress || CONTRACT_ADDRESS;
+  const cv = await callReadOnlyFunction({
+    network,
+    contractAddress,
+    contractName,
+    functionName: CONTRACT_FUNCTIONS.GET_WINNER,
+    functionArgs: [],
+    senderAddress: contractAddress
+  });
+  return parseWinnerCV(cv);
+}
+async function getCurrentTurn(config) {
+  const network = getStacksNetwork(config.network);
+  const contractName = config.contractName || CONTRACT_NAME;
+  const contractAddress = config.contractAddress || CONTRACT_ADDRESS;
+  const cv = await callReadOnlyFunction({
+    network,
+    contractAddress,
+    contractName,
+    functionName: CONTRACT_FUNCTIONS.GET_CURRENT_TURN,
+    functionArgs: [],
+    senderAddress: contractAddress
+  });
+  return parseTurnCV(cv);
+}
+async function isValidMove(config, row, col) {
+  const network = getStacksNetwork(config.network);
+  const contractName = config.contractName || CONTRACT_NAME;
+  const contractAddress = config.contractAddress || CONTRACT_ADDRESS;
+  const cv = await callReadOnlyFunction({
+    network,
+    contractAddress,
+    contractName,
+    functionName: CONTRACT_FUNCTIONS.IS_VALID_MOVE,
+    functionArgs: [uintCV(row), uintCV(col)],
+    senderAddress: contractAddress
+  });
+  return cv.value;
+}
+async function getFullGameState(config) {
+  const [board, status, winner, currentTurn] = await Promise.all([
+    getBoardState(config),
+    getGameStatus(config),
+    getWinner(config),
+    getCurrentTurn(config)
+  ]);
+  return { board, status, winner, currentTurn };
+}
+
+// src/contract/write.ts
+import { makeContractCall, broadcastTransaction, uintCV as uintCV2 } from "@stacks/transactions";
+async function startNewGame(config) {
+  if (!config.senderKey || !config.senderAddress) {
+    throw new Error("senderKey and senderAddress are required for write operations");
+  }
+  const network = getStacksNetwork(config.network);
+  const contractName = config.contractName || CONTRACT_NAME;
+  const contractAddress = config.contractAddress || CONTRACT_ADDRESS;
+  const tx = await makeContractCall({
+    network,
+    contractAddress,
+    contractName,
+    functionName: CONTRACT_FUNCTIONS.START_NEW_GAME,
+    functionArgs: [],
+    senderKey: config.senderKey,
+    anchorMode: "any"
+  });
+  const broadcastResponse = await broadcastTransaction(tx, network);
+  return { txId: broadcastResponse.txid };
+}
+async function makeMove(config, row, col) {
+  if (!config.senderKey || !config.senderAddress) {
+    throw new Error("senderKey and senderAddress are required for write operations");
+  }
+  const network = getStacksNetwork(config.network);
+  const contractName = config.contractName || CONTRACT_NAME;
+  const contractAddress = config.contractAddress || CONTRACT_ADDRESS;
+  const tx = await makeContractCall({
+    network,
+    contractAddress,
+    contractName,
+    functionName: CONTRACT_FUNCTIONS.MAKE_MOVE,
+    functionArgs: [uintCV2(row), uintCV2(col)],
+    senderKey: config.senderKey,
+    anchorMode: "any"
+  });
+  const broadcastResponse = await broadcastTransaction(tx, network);
+  return { txId: broadcastResponse.txid };
+}
+async function resignGame(config) {
+  if (!config.senderKey || !config.senderAddress) {
+    throw new Error("senderKey and senderAddress are required for write operations");
+  }
+  const network = getStacksNetwork(config.network);
+  const contractName = config.contractName || CONTRACT_NAME;
+  const contractAddress = config.contractAddress || CONTRACT_ADDRESS;
+  const tx = await makeContractCall({
+    network,
+    contractAddress,
+    contractName,
+    functionName: CONTRACT_FUNCTIONS.RESIGN_GAME,
+    functionArgs: [],
+    senderKey: config.senderKey,
+    anchorMode: "any"
+  });
+  const broadcastResponse = await broadcastTransaction(tx, network);
+  return { txId: broadcastResponse.txid };
+}
+
+// src/leaderboard/api.ts
+function getBaseUrl(config) {
+  return config.leaderboardApiUrl || DEFAULT_LEADERBOARD_API;
+}
+async function getLeaderboard(config, month) {
+  const baseUrl = getBaseUrl(config);
+  const response = await fetch(`${baseUrl}/api/leaderboard?month=${month}`);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch leaderboard: ${response.statusText}`);
+  }
+  return response.json();
+}
+async function submitResult(config, result) {
+  const baseUrl = getBaseUrl(config);
+  const response = await fetch(`${baseUrl}/api/leaderboard/result`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(result)
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to submit result: ${response.statusText}`);
+  }
+}
+async function syncLeaderboard(config) {
+  const baseUrl = getBaseUrl(config);
+  const response = await fetch(`${baseUrl}/api/sync`, {
+    method: "POST"
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to sync leaderboard: ${response.statusText}`);
+  }
+}
+async function healthCheck(config) {
+  const baseUrl = getBaseUrl(config);
+  try {
+    const response = await fetch(`${baseUrl}/health`);
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+async function getPlayerStats(config, playerAddress, month) {
+  const currentMonth = month || (/* @__PURE__ */ new Date()).toISOString().slice(0, 7);
+  const leaderboard = await getLeaderboard(config, currentMonth);
+  const entry = leaderboard.entries.find((e) => e.player === playerAddress);
+  if (!entry) {
+    return null;
+  }
+  const totalGames = entry.wins + entry.losses + entry.draws;
+  const winRate = totalGames > 0 ? entry.wins / totalGames * 100 : 0;
+  return {
+    ...entry,
+    totalGames,
+    winRate: Math.round(winRate * 100) / 100
+    // Round to 2 decimal places
+  };
+}
+
+// src/client.ts
+var ClarityXOClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  config;
+  // Game state
+  getBoardState() {
+    return getBoardState(this.config);
+  }
+  getGameStatus() {
+    return getGameStatus(this.config);
+  }
+  getWinner() {
+    return getWinner(this.config);
+  }
+  getCurrentTurn() {
+    return getCurrentTurn(this.config);
+  }
+  isValidMove(row, col) {
+    return isValidMove(this.config, row, col);
+  }
+  getFullGameState() {
+    return getFullGameState(this.config);
+  }
+  // Transactions
+  startNewGame() {
+    return startNewGame(this.config);
+  }
+  makeMove(row, col) {
+    return makeMove(this.config, row, col);
+  }
+  resignGame() {
+    return resignGame(this.config);
+  }
+  // Leaderboard
+  getLeaderboard(month) {
+    return getLeaderboard(this.config, month);
+  }
+  submitResult(result) {
+    return submitResult(this.config, result);
+  }
+  syncLeaderboard() {
+    return syncLeaderboard(this.config);
+  }
+  healthCheck() {
+    return healthCheck(this.config);
+  }
+  getPlayerStats(playerAddress, month) {
+    return getPlayerStats(this.config, playerAddress, month);
+  }
+};
+function createClient(config) {
+  return new ClarityXOClient(config);
+}
+
+export {
+  CONTRACT_NAME,
+  CONTRACT_ADDRESS,
+  MAINNET_API,
+  TESTNET_API,
+  DEFAULT_LEADERBOARD_API,
+  DEFAULT_NETWORK,
+  CONTRACT_FUNCTIONS,
+  getBoardState,
+  getGameStatus,
+  getWinner,
+  getCurrentTurn,
+  isValidMove,
+  getFullGameState,
+  startNewGame,
+  makeMove,
+  resignGame,
+  getLeaderboard,
+  submitResult,
+  syncLeaderboard,
+  healthCheck,
+  getPlayerStats,
+  ClarityXOClient,
+  createClient
+};

package/dist/cli/index.js

@@ -359,10 +359,10 @@ function isValidStacksAddress(address) {
 }
 function validateContractAddress(address) {
   if (!address) {
-    throw new Error("Contract address is required");
+    throw new Error("Contract address is required. Pass it via --contract <address> or set it in your config.");
   }
   if (!isValidStacksAddress(address)) {
-    throw new Error("Invalid Stacks address format");
+    throw new Error("Invalid Stacks address format. Ensure the address starts with SP (mainnet) or ST (testnet).");
   }
 }
 function validateNetwork(network) {
@@ -372,13 +372,13 @@ function validateNetwork(network) {
 }
 function validateWriteConfig(key, address) {
   if (!key) {
-    throw new Error("--key (sender private key) is required for write operations");
+    throw new Error("--key (sender private key) is required for write operations. Provide it via --key <private-key>.");
   }
   if (!address) {
-    throw new Error("--address (sender address) is required for write operations");
+    throw new Error("--address (sender address) is required for write operations. Provide it via --address <sender-address>.");
   }
   if (!isValidStacksAddress(address)) {
-    throw new Error("Invalid sender address format");
+    throw new Error("Invalid sender address format. Ensure it is a valid Stacks address.");
   }
 }
 
@@ -616,6 +616,14 @@ command6.description("Start a new game").option("--contract [address]", "Contrac
     process.exit(1);
   }
 });
+command6.addHelpText(
+  "after",
+  `
+Examples:
+  clarityxo start --contract <contract-address> --key <private-key> --address <sender-address>
+  clarityxo start --network testnet --key <private-key> --address <sender-address>
+`
+);
 var start_default = command6;
 
 // src/cli/commands/resign.ts

package/dist/cli/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   createClient
-} from "../chunk-ETEDBK3G.mjs";
+} from "../chunk-2P6NUM7A.mjs";
 
 // src/cli/index.ts
 import { Command as Command8 } from "commander";
@@ -17,10 +17,10 @@ function isValidStacksAddress(address) {
 }
 function validateContractAddress(address) {
   if (!address) {
-    throw new Error("Contract address is required");
+    throw new Error("Contract address is required. Pass it via --contract <address> or set it in your config.");
   }
   if (!isValidStacksAddress(address)) {
-    throw new Error("Invalid Stacks address format");
+    throw new Error("Invalid Stacks address format. Ensure the address starts with SP (mainnet) or ST (testnet).");
   }
 }
 function validateNetwork(network) {
@@ -30,13 +30,13 @@ function validateNetwork(network) {
 }
 function validateWriteConfig(key, address) {
   if (!key) {
-    throw new Error("--key (sender private key) is required for write operations");
+    throw new Error("--key (sender private key) is required for write operations. Provide it via --key <private-key>.");
   }
   if (!address) {
-    throw new Error("--address (sender address) is required for write operations");
+    throw new Error("--address (sender address) is required for write operations. Provide it via --address <sender-address>.");
   }
   if (!isValidStacksAddress(address)) {
-    throw new Error("Invalid sender address format");
+    throw new Error("Invalid sender address format. Ensure it is a valid Stacks address.");
   }
 }
 
@@ -274,6 +274,14 @@ command6.description("Start a new game").option("--contract [address]", "Contrac
     process.exit(1);
   }
 });
+command6.addHelpText(
+  "after",
+  `
+Examples:
+  clarityxo start --contract <contract-address> --key <private-key> --address <sender-address>
+  clarityxo start --network testnet --key <private-key> --address <sender-address>
+`
+);
 var start_default = command6;
 
 // src/cli/commands/resign.ts

package/dist/index.d.mts

@@ -22,7 +22,7 @@ type Turn = 'player' | 'ai';
 interface GameState {
     board: Board;
     status: GameStatus;
-    winner: 'player' | 'ai' | 'draw' | null;
+    winner: Winner;
     currentTurn: Turn;
 }
 interface LeaderboardEntry {
@@ -52,6 +52,7 @@ interface GameResult {
     outcome: 'win' | 'loss' | 'draw';
     month: string;
 }
+type Winner = 'player' | 'ai' | 'draw' | null;
 interface ClarityXOConfig {
     network: Network;
     contractAddress?: string;
@@ -92,6 +93,7 @@ declare const CONTRACT_ADDRESS = "SP30VGN68PSGVWGNMD0HH2WQMM5T486EK3YGP7Z3Y.clar
 declare const MAINNET_API = "https://api.mainnet.hiro.so";
 declare const TESTNET_API = "https://api.testnet.hiro.so";
 declare const DEFAULT_LEADERBOARD_API = "https://clarityxo.onrender.com";
+declare const DEFAULT_NETWORK: 'testnet' | 'mainnet';
 declare const CONTRACT_FUNCTIONS: {
     readonly START_NEW_GAME: "start-new-game";
     readonly MAKE_MOVE: "make-move";
@@ -134,4 +136,6 @@ declare function getBoardString(board: Board): string;
 declare function cloneBoard(board: Board): Board;
 declare function makeMoveOnBoard(board: Board, row: number, col: number, player: CellValue): Board;
 
-export { type Board, CONTRACT_ADDRESS, CONTRACT_FUNCTIONS, CONTRACT_NAME, type CellValue, ClarityXOClient, type ClarityXOConfig, DEFAULT_LEADERBOARD_API, type GameResult, type GameState, type GameStatus, type LeaderboardEntry, type LeaderboardMonth, MAINNET_API, type Network, type PlayerStats, TESTNET_API, type Turn, checkWin, cloneBoard, createClient, getAvailableMoves, getBoardState, getBoardString, getCurrentTurn, getFullGameState, getGameStatus, getLeaderboard, getPlayerStats, getWinner, healthCheck, isBoardFull, isDraw, isValidMove, makeMove, makeMoveOnBoard, resignGame, startNewGame, submitResult, syncLeaderboard };
+declare function debug(message: string, ...args: unknown[]): void;
+
+export { type Board, CONTRACT_ADDRESS, CONTRACT_FUNCTIONS, CONTRACT_NAME, type CellValue, ClarityXOClient, type ClarityXOConfig, DEFAULT_LEADERBOARD_API, DEFAULT_NETWORK, type GameResult, type GameState, type GameStatus, type LeaderboardEntry, type LeaderboardMonth, MAINNET_API, type Network, type PlayerStats, TESTNET_API, type Turn, type Winner, checkWin, cloneBoard, createClient, debug, getAvailableMoves, getBoardState, getBoardString, getCurrentTurn, getFullGameState, getGameStatus, getLeaderboard, getPlayerStats, getWinner, healthCheck, isBoardFull, isDraw, isValidMove, makeMove, makeMoveOnBoard, resignGame, startNewGame, submitResult, syncLeaderboard };

package/dist/index.d.ts

@@ -22,7 +22,7 @@ type Turn = 'player' | 'ai';
 interface GameState {
     board: Board;
     status: GameStatus;
-    winner: 'player' | 'ai' | 'draw' | null;
+    winner: Winner;
     currentTurn: Turn;
 }
 interface LeaderboardEntry {
@@ -52,6 +52,7 @@ interface GameResult {
     outcome: 'win' | 'loss' | 'draw';
     month: string;
 }
+type Winner = 'player' | 'ai' | 'draw' | null;
 interface ClarityXOConfig {
     network: Network;
     contractAddress?: string;
@@ -92,6 +93,7 @@ declare const CONTRACT_ADDRESS = "SP30VGN68PSGVWGNMD0HH2WQMM5T486EK3YGP7Z3Y.clar
 declare const MAINNET_API = "https://api.mainnet.hiro.so";
 declare const TESTNET_API = "https://api.testnet.hiro.so";
 declare const DEFAULT_LEADERBOARD_API = "https://clarityxo.onrender.com";
+declare const DEFAULT_NETWORK: 'testnet' | 'mainnet';
 declare const CONTRACT_FUNCTIONS: {
     readonly START_NEW_GAME: "start-new-game";
     readonly MAKE_MOVE: "make-move";
@@ -134,4 +136,6 @@ declare function getBoardString(board: Board): string;
 declare function cloneBoard(board: Board): Board;
 declare function makeMoveOnBoard(board: Board, row: number, col: number, player: CellValue): Board;
 
-export { type Board, CONTRACT_ADDRESS, CONTRACT_FUNCTIONS, CONTRACT_NAME, type CellValue, ClarityXOClient, type ClarityXOConfig, DEFAULT_LEADERBOARD_API, type GameResult, type GameState, type GameStatus, type LeaderboardEntry, type LeaderboardMonth, MAINNET_API, type Network, type PlayerStats, TESTNET_API, type Turn, checkWin, cloneBoard, createClient, getAvailableMoves, getBoardState, getBoardString, getCurrentTurn, getFullGameState, getGameStatus, getLeaderboard, getPlayerStats, getWinner, healthCheck, isBoardFull, isDraw, isValidMove, makeMove, makeMoveOnBoard, resignGame, startNewGame, submitResult, syncLeaderboard };
+declare function debug(message: string, ...args: unknown[]): void;
+
+export { type Board, CONTRACT_ADDRESS, CONTRACT_FUNCTIONS, CONTRACT_NAME, type CellValue, ClarityXOClient, type ClarityXOConfig, DEFAULT_LEADERBOARD_API, DEFAULT_NETWORK, type GameResult, type GameState, type GameStatus, type LeaderboardEntry, type LeaderboardMonth, MAINNET_API, type Network, type PlayerStats, TESTNET_API, type Turn, type Winner, checkWin, cloneBoard, createClient, debug, getAvailableMoves, getBoardState, getBoardString, getCurrentTurn, getFullGameState, getGameStatus, getLeaderboard, getPlayerStats, getWinner, healthCheck, isBoardFull, isDraw, isValidMove, makeMove, makeMoveOnBoard, resignGame, startNewGame, submitResult, syncLeaderboard };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -25,11 +35,13 @@ __export(index_exports, {
   CONTRACT_NAME: () => CONTRACT_NAME,
   ClarityXOClient: () => ClarityXOClient,
   DEFAULT_LEADERBOARD_API: () => DEFAULT_LEADERBOARD_API,
+  DEFAULT_NETWORK: () => DEFAULT_NETWORK,
   MAINNET_API: () => MAINNET_API,
   TESTNET_API: () => TESTNET_API,
   checkWin: () => checkWin,
   cloneBoard: () => cloneBoard,
   createClient: () => createClient,
+  debug: () => debug,
   getAvailableMoves: () => getAvailableMoves,
   getBoardState: () => getBoardState,
   getBoardString: () => getBoardString,
@@ -61,6 +73,7 @@ var CONTRACT_ADDRESS = "SP30VGN68PSGVWGNMD0HH2WQMM5T486EK3YGP7Z3Y.clarity-xo-gam
 var MAINNET_API = "https://api.mainnet.hiro.so";
 var TESTNET_API = "https://api.testnet.hiro.so";
 var DEFAULT_LEADERBOARD_API = "https://clarityxo.onrender.com";
+var DEFAULT_NETWORK = "testnet";
 var CONTRACT_FUNCTIONS = {
   START_NEW_GAME: "start-new-game",
   MAKE_MOVE: "make-move",
@@ -428,6 +441,14 @@ function makeMoveOnBoard(board, row, col, player) {
   newBoard[row][col] = player;
   return newBoard;
 }
+
+// src/utils/log.ts
+var import_chalk = __toESM(require("chalk"));
+function debug(message, ...args) {
+  if (process.env.DEBUG && process.env.DEBUG !== "0") {
+    console.debug(import_chalk.default.gray("[clarityxo]"), message, ...args);
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CONTRACT_ADDRESS,
@@ -435,11 +456,13 @@ function makeMoveOnBoard(board, row, col, player) {
   CONTRACT_NAME,
   ClarityXOClient,
   DEFAULT_LEADERBOARD_API,
+  DEFAULT_NETWORK,
   MAINNET_API,
   TESTNET_API,
   checkWin,
   cloneBoard,
   createClient,
+  debug,
   getAvailableMoves,
   getBoardState,
   getBoardString,

package/dist/index.mjs

@@ -4,6 +4,7 @@ import {
   CONTRACT_NAME,
   ClarityXOClient,
   DEFAULT_LEADERBOARD_API,
+  DEFAULT_NETWORK,
   MAINNET_API,
   TESTNET_API,
   createClient,
@@ -21,7 +22,7 @@ import {
   startNewGame,
   submitResult,
   syncLeaderboard
-} from "./chunk-ETEDBK3G.mjs";
+} from "./chunk-2P6NUM7A.mjs";
 
 // src/utils/board.ts
 function checkWin(board, player) {
@@ -75,17 +76,27 @@ function makeMoveOnBoard(board, row, col, player) {
   newBoard[row][col] = player;
   return newBoard;
 }
+
+// src/utils/log.ts
+import chalk from "chalk";
+function debug(message, ...args) {
+  if (process.env.DEBUG && process.env.DEBUG !== "0") {
+    console.debug(chalk.gray("[clarityxo]"), message, ...args);
+  }
+}
 export {
   CONTRACT_ADDRESS,
   CONTRACT_FUNCTIONS,
   CONTRACT_NAME,
   ClarityXOClient,
   DEFAULT_LEADERBOARD_API,
+  DEFAULT_NETWORK,
   MAINNET_API,
   TESTNET_API,
   checkWin,
   cloneBoard,
   createClient,
+  debug,
   getAvailableMoves,
   getBoardState,
   getBoardString,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clarityxo-sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "TypeScript SDK and CLI for the ClarityXO on-chain Tic-Tac-Toe game on Stacks",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -10,14 +10,15 @@
   },
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     }
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "prepare": "npm run build",
     "test": "vitest",
     "lint": "eslint src --ext .ts",
     "format": "prettier --write src"