(feat) (openai/gpt-5.5, reviewed T, tested T) add core sdk package

Author: paoloanzn

README.md

@@ -16,6 +16,7 @@ At the foundation of fcf is the **Repository Identity Key** (**RIK**), an ERC-72
 
 - `contracts/`: EVM smart contracts that define protocol identity and funding primitives.
 - `packages/cli/`: command-line tooling for repository onboarding and protocol operations.
+- `packages/core-sdk/`: core TypeScript SDK for fcf integrations.
 
 ## Create a RIK
 

packages/core-sdk/.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+dist/

packages/core-sdk/README.md

@@ -0,0 +1,3 @@
+# @freecodexyz/core-sdk
+
+Core TypeScript SDK for fcf.

packages/core-sdk/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@freecodexyz/core-sdk",
+  "version": "0.1.0",
+  "description": "",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/freecodexyz/fcf.git",
+    "directory": "packages/core-sdk"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "packageManager": "pnpm@10.24.0",
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  }
+}

packages/core-sdk/src/index.ts

@@ -0,0 +1 @@
+export {};

packages/core-sdk/tsconfig.json

@@ -0,0 +1,54 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // know bug -> https://github.com/egoist/tsup/issues/1389
+    "ignoreDeprecations": "6.0",
+    // File Layout
+    "rootDir": ".",
+    "outDir": "./dist",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+
+    // JSON Module Import
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "nodenext",
+    "target": "esnext",
+    "types": ["node"],
+    "lib": ["esnext"],
+    // For nodejs:
+    // "lib": ["esnext"],
+    // "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+  }
+}