@the-situation/sdk 0.1.0-alpha.0

package/dist/utils/normalize.js

@@ -0,0 +1,69 @@
+/**
+ * Response normalization utilities for The Situation SDK.
+ *
+ * Handles conversion of snake_case keys from Starknet contract responses
+ * to camelCase for TypeScript consumption.
+ *
+ * @module utils/normalize
+ */
+/**
+ * Converts a snake_case string to camelCase.
+ *
+ * @param str - The snake_case string to convert
+ * @returns The camelCase string
+ *
+ * @example
+ * ```typescript
+ * snakeToCamel('is_initialized'); // 'isInitialized'
+ * snakeToCamel('total_collateral_locked'); // 'totalCollateralLocked'
+ * ```
+ */
+export function snakeToCamel(str) {
+    return str.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+}
+/**
+ * Recursively normalizes a contract response by converting all snake_case
+ * keys to camelCase.
+ *
+ * This function handles:
+ * - Objects with nested properties
+ * - Arrays of objects
+ * - Primitive values (passed through unchanged)
+ * - null/undefined (passed through unchanged)
+ * - BigInt values (passed through unchanged)
+ *
+ * @param raw - The raw response from a Starknet contract call
+ * @returns The normalized response with camelCase keys
+ *
+ * @example
+ * ```typescript
+ * const raw = {
+ *   is_initialized: true,
+ *   settlement_value: { limb0: 0n, limb1: 0n }
+ * };
+ * const normalized = normalizeResponse(raw);
+ * // { isInitialized: true, settlementValue: { limb0: 0n, limb1: 0n } }
+ * ```
+ */
+export function normalizeResponse(raw) {
+    // Pass through null/undefined
+    if (raw === null || raw === undefined) {
+        return raw;
+    }
+    // Pass through primitives (string, number, boolean, bigint, symbol)
+    if (typeof raw !== 'object') {
+        return raw;
+    }
+    // Handle arrays
+    if (Array.isArray(raw)) {
+        return raw.map((item) => normalizeResponse(item));
+    }
+    // Handle objects
+    const result = {};
+    for (const [key, value] of Object.entries(raw)) {
+        const camelKey = snakeToCamel(key);
+        result[camelKey] = normalizeResponse(value);
+    }
+    return result;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/utils/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/utils/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,iBAAiB,CAAI,GAAY;IAC/C,8BAA8B;IAC9B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,GAAQ,CAAC;IAClB,CAAC;IAED,oEAAoE;IACpE,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAQ,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAM,CAAC;IACzD,CAAC;IAED,iBAAiB;IACjB,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@the-situation/sdk",
+  "version": "0.1.0-alpha.0",
+  "description": "TypeScript SDK for The Situation prediction market contracts on Starknet",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test src/types src/contracts src/providers src/utils src/abi src/sdk",
+    "test:coverage": "bun test --coverage src/types src/contracts src/providers src/utils src/abi src/sdk",
+    "test:integration": "bun test src/__integration__/scenarios --timeout 120000",
+    "test:integration:e2e": "bun test src/__integration__/e2e --timeout 600000",
+    "test:all": "bun test --timeout 120000",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "format": "biome format --write .",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "clean": "rm -rf dist",
+    "pull-artifacts": "bun run scripts/pull-artifacts.ts",
+    "prepublishOnly": "bun run clean && bun run build"
+  },
+  "keywords": [
+    "starknet",
+    "prediction-market",
+    "defi",
+    "cairo",
+    "the-situation"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/the-situation/the-situation-sdk.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "starknet": "^9.2.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.13",
+    "@types/bun": "^1.1.0",
+    "typescript": "^5.4.0"
+  }
+}