socialfi-thesis 0.0.0-stage → 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CabalSpy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# socialfi-thesis — token theses for any crypto app
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/socialfi-thesis.svg)](https://www.npmjs.com/package/socialfi-thesis) [![ci](https://github.com/CabalSpy/socialfi-thesis/actions/workflows/ci.yml/badge.svg)](https://github.com/CabalSpy/socialfi-thesis/actions/workflows/ci.yml) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**socialfi-thesis** brings SocialFi token theses to your app: holders-only opinions on a token, each with the author's real position and live PnL, replies, reactions, moderation — shared across every platform that uses CabalSpy ID. Use the drop-in SocialFi widget, or build your own UI on the thesis API.
+
+Part of **[CabalSpy ID](https://id.cabalspy.xyz)** — the SocialFi layer for crypto apps. [Website](https://www.cabalspy.xyz/cabalspy-id/) · [Docs](https://docs.cabalspy.xyz/cabalspy-id) · [API dashboard](https://apidashboard.cabalspy.xyz) · [Full SDK: cabalspy-id](https://github.com/CabalSpy/cabalspy-id-js)
+
+```bash
+npm install socialfi-thesis
+```
+
+**React widget**
+
+```tsx
+import { CabalSpyTheses } from 'socialfi-thesis/react';
+
+<CabalSpyTheses chain="solana" mint={mint} clientId="csid_..." theme="dark" accessToken={accessToken} />
+```
+
+**Your own UI** (public thesis API with the user's access token, no API key)
+
+```ts
+import { ThesisClient } from 'socialfi-thesis';
+
+const theses = new ThesisClient({ accessToken, clientId: 'csid_...' });
+const { items, summary } = await theses.list('solana', mint, { sort: 'top' });
+if ((await theses.me('solana', mint)).can_post) await theses.post('solana', mint, { body: 'Strong community.', stance: 'bull' });
+const live = theses.live('solana', mint);
+live.on('thesis', (t) => render(t));
+await live.connect();
+```
+
+**Server** (Data API key: read everything, write in your users' names, live theses for up to 200 tokens)
+
+```ts
+import { CabalSpyID } from 'socialfi-thesis';
+
+const csid = new CabalSpyID({ apiKey: process.env.CABALSPY_API_KEY });
+await csid.postThesis({ blockchain: 'solana', mint, body: 'Accumulating here.', stance: 'bull', csid_id: userSub });
+const ts = csid.thesesStream();
+ts.on('thesis', (t) => addMarker(t));
+await ts.connect();
+ts.subscribe([{ blockchain: 'solana', mint }]);
+```
+
+Contents: the `cabalspy-id/thesis` entry point (`CabalSpyID` thesis methods, `ThesisClient`, `ThesisLive`, `ThesesStream`, thesis types) and `socialfi-thesis/react` (`<CabalSpyTheses />`, `useCabalSpyID()`). Full reference: [cabalspy-id README — Token theses](https://github.com/CabalSpy/cabalspy-id-js#token-theses).
+
+Versions follow `cabalspy-id`: 0.5.0 depends on `cabalspy-id` 0.5.0. This package contains no code of its own — it re-exports part of `cabalspy-id`, so behaviour, fixes and types are always the same.
+
+## License
+
+MIT

package/index.cjs

@@ -0,0 +1,2 @@
+// socialfi-thesis — token theses by CabalSpy ID (cabalspy-id/thesis).
+module.exports = require('cabalspy-id/thesis');

package/index.d.ts

@@ -0,0 +1 @@
+export * from 'cabalspy-id/thesis';

package/index.js

@@ -0,0 +1,2 @@
+// socialfi-thesis — token theses by CabalSpy ID (cabalspy-id/thesis).
+export * from 'cabalspy-id/thesis';

package/package.json

@@ -1,6 +1,95 @@
 {
   "name": "socialfi-thesis",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.0",
+  "description": "SocialFi token theses — holders-only opinions on a token with the author's real position and live PnL, replies, reactions and a drop-in thesis widget for any crypto app. By CabalSpy ID.",
+  "keywords": [
+    "socialfi-thesis",
+    "token-thesis",
+    "token-theses",
+    "socialfi-widget",
+    "socialfi",
+    "social-trading",
+    "copy-trading",
+    "crypto-social",
+    "web3-social",
+    "kol",
+    "kol-tracker",
+    "wallet-tracker",
+    "trading-leaderboard",
+    "pnl",
+    "crypto-login",
+    "solana",
+    "bnb",
+    "base",
+    "ethereum",
+    "cabalspy",
+    "cabalspy-id",
+    "sdk",
+    "react"
+  ],
+  "license": "MIT",
+  "homepage": "https://www.cabalspy.xyz/cabalspy-id/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CabalSpy/socialfi-thesis.git",
+    "directory": "js"
+  },
+  "bugs": {
+    "url": "https://github.com/CabalSpy/socialfi-thesis/issues"
+  },
+  "type": "module",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.cjs"
+    },
+    "./react": {
+      "types": "./react.d.ts",
+      "import": "./react.js",
+      "require": "./react.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "react": [
+        "./react.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "index.cjs",
+    "index.d.ts",
+    "index.js",
+    "react.cjs",
+    "react.d.ts",
+    "react.js"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test test/exports.test.mjs"
+  },
+  "dependencies": {
+    "cabalspy-id": "^0.5.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/react.cjs

@@ -0,0 +1,7 @@
+'use client';
+// socialfi-thesis/react — the token theses widget for React.
+const r = require('cabalspy-id/react');
+exports.CabalSpyTheses = r.CabalSpyTheses;
+exports.useCabalSpyID = r.useCabalSpyID;
+exports.loadCabalSpyIDWidget = r.loadCabalSpyIDWidget;
+exports.WIDGET_SRC = r.WIDGET_SRC;

package/react.d.ts

@@ -0,0 +1 @@
+export { CabalSpyTheses, useCabalSpyID, loadCabalSpyIDWidget, WIDGET_SRC, type CabalSpyThesesProps, type ThesisWidgetOptions, type UseCabalSpyIDOptions, type UseCabalSpyIDResult, type CSIDGlobal } from 'cabalspy-id/react';

package/react.js

@@ -0,0 +1,3 @@
+'use client';
+// socialfi-thesis/react — the token theses widget for React.
+export { CabalSpyTheses, useCabalSpyID, loadCabalSpyIDWidget, WIDGET_SRC } from 'cabalspy-id/react';