@matanetwork/sovereign-id-react 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 MATA Network
-
-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.
+MIT License
+
+Copyright (c) 2026 MATA Network
+
+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

@@ -226,7 +226,7 @@ const verified = await verifyResponse(req.body.jwt, {
 ```
 
 See the
-[main docs](https://github.com/mata-network/mata/tree/main/docs/sovereign-id)
+[main docs](https://github.com/Remade-With-Rust/sovereign-id/tree/main/docs/sovereign-id)
 for the integration guide, error-handling matrix, and protocol spec.
 
 ## What you don't have to think about

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matanetwork/sovereign-id-react",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "React adapter for @matanetwork/sovereign-id — drop-in <SignInButton/>, useSignIn() hook, useResumePendingSignIn() boot helper. Lowers Sovereign ID RP integration from ~20 LOC to one import.",
   "type": "module",
   "main": "src/index.js",
@@ -39,14 +39,14 @@
   "engines": {
     "node": ">=18"
   },
-  "homepage": "https://github.com/mata-network/mata/tree/main/packages/mata-sovereign-id-react#readme",
+  "homepage": "https://github.com/Remade-With-Rust/sovereign-id/tree/main/packages/sovereign-id-react#readme",
   "bugs": {
-    "url": "https://github.com/mata-network/mata/issues"
+    "url": "https://github.com/Remade-With-Rust/sovereign-id/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mata-network/mata.git",
-    "directory": "packages/mata-sovereign-id-react"
+    "url": "git+https://github.com/Remade-With-Rust/sovereign-id.git",
+    "directory": "packages/sovereign-id-react"
   },
   "peerDependencies": {
     "@matanetwork/sovereign-id": "^0.1.0",
@@ -63,5 +63,8 @@
   "devDependencies": {
     "@matanetwork/sovereign-id": "^0.1.0",
     "react": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/src/index.d.ts

@@ -1,225 +1,225 @@
-/**
- * Type declarations for @matanetwork/sovereign-id-react.
- *
- * Mirrors the JS runtime exactly. The runtime is pure JS (no build
- * step); this `.d.ts` exists so consumers using TypeScript get full
- * type-checking + IDE intellisense.
- */
-
-import type { CSSProperties, ReactNode, ButtonHTMLAttributes } from 'react';
-import type {
-  SignInError,
-  SignInRequest,
-  SignInSuccess,
-  ErrorCode,
-} from '@matanetwork/sovereign-id';
-
-// ─── Hook: useSignIn ───────────────────────────────────────────────────────
-
-export interface UseSignInOptions {
-  /**
-   * Default `rpOrigin` used by `signIn()`. If omitted, falls back to
-   * `window.location.origin`. RPs running SSR should set this
-   * explicitly.
-   */
-  rpOrigin?: string;
-
-  /**
-   * Async function that returns a fresh single-use nonce. Called
-   * once per `signIn()` invocation; the resolved string is passed
-   * through to the SDK. If omitted, `signIn()` must be called with
-   * a `nonce` override directly.
-   */
-  getNonce?: () => Promise<string>;
-
-  /**
-   * Default `claims` payload, merged with the per-call override.
-   * Almost always `{ required: ['did'], optional: [...] }`.
-   */
-  defaultClaims?: SignInRequest['claims'];
-
-  /**
-   * Forwarded to the SDK. When `false`, throws
-   * `ERR_NO_WALLET_INSTALLED` raw instead of showing the install
-   * upsell. Default: SDK default (`true`).
-   */
-  installUpsell?: boolean;
-
-  /**
-   * Forwarded to the SDK. Referral code attributed to signups that
-   * flow through the install upsell. Defaults to the hostname of
-   * `rpOrigin`. Pass `null` to opt out.
-   */
-  ref?: string | null;
-
-  /** Forwarded to the SDK. */
-  timeoutMs?: number;
-
-  /** Forwarded to the SDK. */
-  nativeAppCallback?: string;
-}
-
-export type SignInStatus = 'idle' | 'pending' | 'success' | 'error';
-
-export interface SignInOverrides {
-  rpOrigin?: string;
-  nonce?: string;
-  claims?: SignInRequest['claims'];
-  installUpsell?: boolean;
-  ref?: string | null;
-  timeoutMs?: number;
-  nativeAppCallback?: string;
-}
-
-export interface UseSignInReturn {
-  /**
-   * Fires a sign-in. Merges `overrides` over the hook-level
-   * options. Resolves to the result on success, `null` if the call
-   * was superseded by a newer signIn, or rejects with `SignInError`
-   * on failure.
-   */
-  signIn(overrides?: SignInOverrides): Promise<SignInSuccess | null>;
-  /** Drops result/error and returns to idle. */
-  reset(): void;
-  status: SignInStatus;
-  /** True iff `status === 'pending'`. */
-  isLoading: boolean;
-  result: SignInSuccess | null;
-  error: SignInError | null;
-}
-
-export function useSignIn(options?: UseSignInOptions): UseSignInReturn;
-
-// ─── Hook: useResumePendingSignIn ──────────────────────────────────────────
-
-export interface UseResumeOptions {
-  /**
-   * Called when a pending sign-in resumes and completes. RPs hand
-   * the JWT to their backend here.
-   */
-  onSuccess?: (result: SignInSuccess) => void;
-  /**
-   * Called when a pending sign-in was found but its resume threw.
-   * `err.code` is the same set the regular signIn() throws.
-   */
-  onError?: (err: SignInError) => void;
-  /**
-   * Called when there's no pending resume — most boots. Lets RPs
-   * record analytics on "did we hit the resume path on this boot"
-   * without watching the `noResume` flag.
-   */
-  onNothingPending?: () => void;
-}
-
-export interface UseResumeReturn {
-  status: SignInStatus;
-  result: SignInSuccess | null;
-  error: SignInError | null;
-  /**
-   * `true` once we've finished checking and confirmed no pending
-   * sign-in was waiting. Useful for RPs that want to delay
-   * rendering their logged-out UI until the resume check is done.
-   */
-  noResume: boolean;
-}
-
-export function useResumePendingSignIn(options?: UseResumeOptions): UseResumeReturn;
-
-// ─── Component: SignInButton ───────────────────────────────────────────────
-
-export interface SignInButtonProps {
-  /** Defaults to `window.location.origin`. */
-  rpOrigin?: string;
-  /** Async fn returning a fresh single-use nonce from your backend. */
-  getNonce: () => Promise<string>;
-  /** Claim catalog. `{ required: [...], optional?: [...] }`. */
-  claims: SignInRequest['claims'];
-  /** Called with the resulting JWT. */
-  onSuccess: (result: SignInSuccess) => void;
-  /**
-   * Called when the user explicitly chose not to sign in
-   * (`user_denied` from the consent screen, `upsell_canceled` from
-   * the install upsell modal).
-   */
-  onCancel?: (code: 'user_denied' | 'upsell_canceled') => void;
-  /**
-   * Called for any other failure path (timeout, wallet_unavailable,
-   * etc.). If omitted, errors are silently swallowed — RPs should
-   * usually pass at least a logger here.
-   */
-  onError?: (err: SignInError) => void;
-  /** SDK option pass-through. */
-  installUpsell?: boolean;
-  /** SDK referral code; defaults to the hostname of `rpOrigin`. */
-  ref?: string | null;
-  /** SDK option pass-through. */
-  timeoutMs?: number;
-  /** SDK option pass-through. */
-  nativeAppCallback?: string;
-  /** Button label. Defaults to `"Sign in with Sovereign ID"`. */
-  children?: ReactNode;
-  /**
-   * When set, the default inline styles are NOT applied; the RP has
-   * full control via CSS.
-   */
-  className?: string;
-  /**
-   * Merged with the default inline styles when `className` is not
-   * provided.
-   */
-  style?: CSSProperties;
-  /**
-   * Explicitly disable the button. The button is also disabled
-   * internally while a sign-in is in flight.
-   */
-  disabled?: boolean;
-  /** Spread onto the underlying `<button>`. */
-  buttonProps?: Omit<
-    ButtonHTMLAttributes<HTMLButtonElement>,
-    'onClick' | 'disabled' | 'type' | 'style' | 'className' | 'children'
-  >;
-}
-
-export function SignInButton(props: SignInButtonProps): JSX.Element;
-
-// ─── Re-exports from @matanetwork/sovereign-id ────────────────────────────
-
-export {
-  SignInError,
-  hasExtension,
-  showInstallUpsell,
-  pickInstallCta,
-  defaultRefFromOrigin,
-  clearPendingSignIn,
-  resumePendingSignIn,
-  signIn,
-  PROTOCOL_VERSION,
-  WINDOW_MID_GLOBAL,
-  MESSAGE_DISCRIMINATOR,
-  KIND_SIGN_IN_REQUEST,
-  KIND_SIGN_IN_RESPONSE,
-  URL_SCHEME,
-  SCHEME_PATH_REQUEST,
-  QUERY_PARAM_PAYLOAD,
-  FRAGMENT_KEY_RESPONSE,
-  ERR_USER_DENIED,
-  ERR_ORIGIN_MISMATCH,
-  ERR_INVALID_REQUEST,
-  ERR_WALLET_UNAVAILABLE,
-  ERR_REQUIRED_CLAIM_UNAVAILABLE,
-  ERR_INTERNAL,
-  ERR_NO_WALLET_INSTALLED,
-  ERR_TIMEOUT,
-  ERR_UPSELL_CANCELED,
-} from '@matanetwork/sovereign-id';
-
-export type {
-  SignInRequest,
-  SignInSuccess,
-  ErrorCode,
-  CustomClaim,
-  InstallCta,
-  InstallUpsellOptions,
-  InstallUpsellResult,
-  SignInOptions,
-} from '@matanetwork/sovereign-id';
+/**
+ * Type declarations for @matanetwork/sovereign-id-react.
+ *
+ * Mirrors the JS runtime exactly. The runtime is pure JS (no build
+ * step); this `.d.ts` exists so consumers using TypeScript get full
+ * type-checking + IDE intellisense.
+ */
+
+import type { CSSProperties, ReactNode, ButtonHTMLAttributes } from 'react';
+import type {
+  SignInError,
+  SignInRequest,
+  SignInSuccess,
+  ErrorCode,
+} from '@matanetwork/sovereign-id';
+
+// ─── Hook: useSignIn ───────────────────────────────────────────────────────
+
+export interface UseSignInOptions {
+  /**
+   * Default `rpOrigin` used by `signIn()`. If omitted, falls back to
+   * `window.location.origin`. RPs running SSR should set this
+   * explicitly.
+   */
+  rpOrigin?: string;
+
+  /**
+   * Async function that returns a fresh single-use nonce. Called
+   * once per `signIn()` invocation; the resolved string is passed
+   * through to the SDK. If omitted, `signIn()` must be called with
+   * a `nonce` override directly.
+   */
+  getNonce?: () => Promise<string>;
+
+  /**
+   * Default `claims` payload, merged with the per-call override.
+   * Almost always `{ required: ['did'], optional: [...] }`.
+   */
+  defaultClaims?: SignInRequest['claims'];
+
+  /**
+   * Forwarded to the SDK. When `false`, throws
+   * `ERR_NO_WALLET_INSTALLED` raw instead of showing the install
+   * upsell. Default: SDK default (`true`).
+   */
+  installUpsell?: boolean;
+
+  /**
+   * Forwarded to the SDK. Referral code attributed to signups that
+   * flow through the install upsell. Defaults to the hostname of
+   * `rpOrigin`. Pass `null` to opt out.
+   */
+  ref?: string | null;
+
+  /** Forwarded to the SDK. */
+  timeoutMs?: number;
+
+  /** Forwarded to the SDK. */
+  nativeAppCallback?: string;
+}
+
+export type SignInStatus = 'idle' | 'pending' | 'success' | 'error';
+
+export interface SignInOverrides {
+  rpOrigin?: string;
+  nonce?: string;
+  claims?: SignInRequest['claims'];
+  installUpsell?: boolean;
+  ref?: string | null;
+  timeoutMs?: number;
+  nativeAppCallback?: string;
+}
+
+export interface UseSignInReturn {
+  /**
+   * Fires a sign-in. Merges `overrides` over the hook-level
+   * options. Resolves to the result on success, `null` if the call
+   * was superseded by a newer signIn, or rejects with `SignInError`
+   * on failure.
+   */
+  signIn(overrides?: SignInOverrides): Promise<SignInSuccess | null>;
+  /** Drops result/error and returns to idle. */
+  reset(): void;
+  status: SignInStatus;
+  /** True iff `status === 'pending'`. */
+  isLoading: boolean;
+  result: SignInSuccess | null;
+  error: SignInError | null;
+}
+
+export function useSignIn(options?: UseSignInOptions): UseSignInReturn;
+
+// ─── Hook: useResumePendingSignIn ──────────────────────────────────────────
+
+export interface UseResumeOptions {
+  /**
+   * Called when a pending sign-in resumes and completes. RPs hand
+   * the JWT to their backend here.
+   */
+  onSuccess?: (result: SignInSuccess) => void;
+  /**
+   * Called when a pending sign-in was found but its resume threw.
+   * `err.code` is the same set the regular signIn() throws.
+   */
+  onError?: (err: SignInError) => void;
+  /**
+   * Called when there's no pending resume — most boots. Lets RPs
+   * record analytics on "did we hit the resume path on this boot"
+   * without watching the `noResume` flag.
+   */
+  onNothingPending?: () => void;
+}
+
+export interface UseResumeReturn {
+  status: SignInStatus;
+  result: SignInSuccess | null;
+  error: SignInError | null;
+  /**
+   * `true` once we've finished checking and confirmed no pending
+   * sign-in was waiting. Useful for RPs that want to delay
+   * rendering their logged-out UI until the resume check is done.
+   */
+  noResume: boolean;
+}
+
+export function useResumePendingSignIn(options?: UseResumeOptions): UseResumeReturn;
+
+// ─── Component: SignInButton ───────────────────────────────────────────────
+
+export interface SignInButtonProps {
+  /** Defaults to `window.location.origin`. */
+  rpOrigin?: string;
+  /** Async fn returning a fresh single-use nonce from your backend. */
+  getNonce: () => Promise<string>;
+  /** Claim catalog. `{ required: [...], optional?: [...] }`. */
+  claims: SignInRequest['claims'];
+  /** Called with the resulting JWT. */
+  onSuccess: (result: SignInSuccess) => void;
+  /**
+   * Called when the user explicitly chose not to sign in
+   * (`user_denied` from the consent screen, `upsell_canceled` from
+   * the install upsell modal).
+   */
+  onCancel?: (code: 'user_denied' | 'upsell_canceled') => void;
+  /**
+   * Called for any other failure path (timeout, wallet_unavailable,
+   * etc.). If omitted, errors are silently swallowed — RPs should
+   * usually pass at least a logger here.
+   */
+  onError?: (err: SignInError) => void;
+  /** SDK option pass-through. */
+  installUpsell?: boolean;
+  /** SDK referral code; defaults to the hostname of `rpOrigin`. */
+  ref?: string | null;
+  /** SDK option pass-through. */
+  timeoutMs?: number;
+  /** SDK option pass-through. */
+  nativeAppCallback?: string;
+  /** Button label. Defaults to `"Sign in with Sovereign ID"`. */
+  children?: ReactNode;
+  /**
+   * When set, the default inline styles are NOT applied; the RP has
+   * full control via CSS.
+   */
+  className?: string;
+  /**
+   * Merged with the default inline styles when `className` is not
+   * provided.
+   */
+  style?: CSSProperties;
+  /**
+   * Explicitly disable the button. The button is also disabled
+   * internally while a sign-in is in flight.
+   */
+  disabled?: boolean;
+  /** Spread onto the underlying `<button>`. */
+  buttonProps?: Omit<
+    ButtonHTMLAttributes<HTMLButtonElement>,
+    'onClick' | 'disabled' | 'type' | 'style' | 'className' | 'children'
+  >;
+}
+
+export function SignInButton(props: SignInButtonProps): JSX.Element;
+
+// ─── Re-exports from @matanetwork/sovereign-id ────────────────────────────
+
+export {
+  SignInError,
+  hasExtension,
+  showInstallUpsell,
+  pickInstallCta,
+  defaultRefFromOrigin,
+  clearPendingSignIn,
+  resumePendingSignIn,
+  signIn,
+  PROTOCOL_VERSION,
+  WINDOW_MID_GLOBAL,
+  MESSAGE_DISCRIMINATOR,
+  KIND_SIGN_IN_REQUEST,
+  KIND_SIGN_IN_RESPONSE,
+  URL_SCHEME,
+  SCHEME_PATH_REQUEST,
+  QUERY_PARAM_PAYLOAD,
+  FRAGMENT_KEY_RESPONSE,
+  ERR_USER_DENIED,
+  ERR_ORIGIN_MISMATCH,
+  ERR_INVALID_REQUEST,
+  ERR_WALLET_UNAVAILABLE,
+  ERR_REQUIRED_CLAIM_UNAVAILABLE,
+  ERR_INTERNAL,
+  ERR_NO_WALLET_INSTALLED,
+  ERR_TIMEOUT,
+  ERR_UPSELL_CANCELED,
+} from '@matanetwork/sovereign-id';
+
+export type {
+  SignInRequest,
+  SignInSuccess,
+  ErrorCode,
+  CustomClaim,
+  InstallCta,
+  InstallUpsellOptions,
+  InstallUpsellResult,
+  SignInOptions,
+} from '@matanetwork/sovereign-id';