nostr-wot-sdk 0.5.3 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,32 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-02-22
+
+### Added
+
+- **SolidJS integration** (`nostr-wot-sdk/solid`) - First-class SolidJS support with reactive primitives
+  - `WoTProvider` - Context provider with automatic extension detection
+  - `createWoT(pubkey)` - Get distance, score, and details for a pubkey
+  - `createIsInWoT(pubkey)` - Check if pubkey is in your WoT (boolean)
+  - `createTrustScore(pubkey)` - Get trust score only
+  - `createBatchWoT(pubkeys)` - Check multiple pubkeys efficiently
+  - `useExtension()` - Get extension connection state
+  - `useWoTInstance()` - Get raw WoT instance for advanced usage
+- `solid-js` as optional peer dependency (`>=1.0.0`)
+- SolidJS build target in tsup config
+
+### Changed
+
+- Updated package description to mention React and SolidJS support
+- Updated README with SolidJS documentation and examples
+
+## [0.5.3] - 2025-02-05
+
+### Fixed
+
+- **Improved extension detection with retry mechanism** - Extensions inject content scripts asynchronously after page load, so the SDK now polls for up to 1.5 seconds (15 attempts at 100ms intervals) to reliably detect the extension in both React and core contexts
+
 ## [0.5.2] - 2025-02-05
 
 ### Added
@@ -226,6 +252,8 @@ function Profile({ pubkey }) {
 - TypeScript support with full type definitions
 - Error classes: `WoTError`, `NetworkError`, `NotFoundError`, `TimeoutError`, `ValidationError`
 
+[0.6.0]: https://github.com/nostr-wot/nostr-wot-sdk/compare/v0.5.3...v0.6.0
+[0.5.3]: https://github.com/nostr-wot/nostr-wot-sdk/compare/v0.5.2...v0.5.3
 [0.5.2]: https://github.com/nostr-wot/nostr-wot-sdk/compare/v0.5.1...v0.5.2
 [0.5.1]: https://github.com/nostr-wot/nostr-wot-sdk/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/nostr-wot/nostr-wot-sdk/compare/v0.4.2...v0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # nostr-wot-sdk
 
-JavaScript/TypeScript SDK for querying Nostr Web of Trust.
+JavaScript/TypeScript SDK for querying Nostr Web of Trust. Includes first-class React and SolidJS support.
 
 ## Install
 ```bash
@@ -366,6 +366,83 @@ const {
 } = useExtension();
 ```
 
+### SolidJS
+
+The SDK also provides SolidJS support with reactive primitives and automatic extension detection. Wrap your app with `WoTProvider` and use `create*` primitives for fine-grained reactivity.
+
+```javascript
+import { WoTProvider, useExtension, createWoT } from 'nostr-wot-sdk/solid';
+
+// Wrap your app - automatically detects extension
+function App() {
+  return (
+    <WoTProvider>
+      <YourApp />
+    </WoTProvider>
+  );
+}
+
+// Check extension status anywhere
+function ExtensionStatus() {
+  const ext = useExtension();
+
+  return (
+    <Show when={!ext.isChecking()} fallback={<span>Checking...</span>}>
+      <Show when={ext.isConnected()} fallback={<span>Extension not available</span>}>
+        <span>Extension connected!</span>
+      </Show>
+    </Show>
+  );
+}
+
+// Use WoT data in components
+function Profile(props: { pubkey: string }) {
+  const wot = createWoT(() => props.pubkey);
+
+  return (
+    <Show when={!wot.loading()} fallback={<Spinner />}>
+      <Show when={wot.distance() !== null} fallback={<span>Not in your network</span>}>
+        <span>{wot.distance()} hops away (score: {wot.score().toFixed(2)})</span>
+      </Show>
+    </Show>
+  );
+}
+```
+
+#### Provider Options
+
+```javascript
+// With fallback for when extension is not available
+<WoTProvider options={{
+  fallback: { myPubkey: 'abc123...' }
+}}>
+```
+
+#### Available Primitives
+
+| Primitive | Description |
+|-----------|-------------|
+| `createWoT(pubkey)` | Get distance, score, and details for a pubkey |
+| `createIsInWoT(pubkey)` | Check if pubkey is in your WoT (boolean) |
+| `createTrustScore(pubkey)` | Get trust score only |
+| `createBatchWoT(pubkeys[])` | Check multiple pubkeys efficiently |
+| `useExtension()` | Get extension connection state |
+| `useWoTInstance()` | Get raw WoT instance for advanced usage |
+
+#### Extension State
+
+The `useExtension()` function provides extension status:
+
+```javascript
+const ext = useExtension();
+
+ext.state()        // 'checking' | 'connected' | 'not-available'
+ext.isConnected()  // Extension is connected and ready
+ext.isChecking()   // Currently checking
+ext.isChecked()    // Check complete
+ext.refresh()      // Function to re-check extension availability
+```
+
 ## TypeScript
 
 Full type definitions included: