@bluxcc/core 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,80 @@
+Business Source License 1.1
+
+License text copyright (c) 2025 Blux Team, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor: Blux Team
+
+Licensed Work: Blux Kit
+The Licensed Work is (c) 2025 Blux Team
+
+Additional Use Grant: None
+
+Change Date: The earlier of 2028-02-05 or a date specified by the Licensor.
+
+Change License: GNU Affero General Public License v3.0 (AGPL-3.0)
+
+-----------------------------------------------------------------------------
+
+Terms
+
+1. Grant of Rights
+The Licensor grants you the right to modify, create derivative works, and contribute changes to the Licensed Work through official channels (e.g., pull requests).
+
+2. Copying and Redistribution Restriction
+You may not copy, redistribute, or publicly share the Licensed Work in any form. The Licensed Work may only be used within the scope of contribution to the official repository.
+
+3. Production Use Restriction
+Production use is strictly prohibited before the Change Date.
+For the purposes of this License, "Production Use" means any deployment of the Licensed Work that:
+- Provides services to third parties (commercial or non-commercial).
+- Generates revenue, directly or indirectly.
+- Supports business operations in any capacity, including internal use.
+
+If you wish to use the Licensed Work in production before the Change Date, you must obtain a commercial license from the Licensor at support@blux.cc.
+
+4. Derivative Works and Contributions
+- You may not modify or remove references to "Blux Team" in any derivative works, copies, or modified versions of the Licensed Work.
+- Any modifications must be submitted as pull requests to the official repository.
+
+5. Change License and Change Date
+- On the Change Date, or the fourth anniversary of a specific version’s first public distribution, whichever comes first, this License terminates, and the Licensed Work will be available under the Change License (AGPL-3.0).
+- Only the latest version of the Licensed Work at the Change Date will be subject to AGPL-3.0.
+- The Licensor reserves the right to extend the Change Date for future versions of the Licensed Work.
+
+6. License Compliance and Enforcement
+- If your use of the Licensed Work does not comply with the requirements of this License, your rights to use all versions of the Licensed Work terminate immediately.
+- Violations may result in legal action, including but not limited to seeking injunctive relief and damages.
+
+7. Trademark and Branding
+- This License does not grant any rights to use the "Blux Team" name, logo, or trademarks, except where expressly required by this License.
+
+8. Warranty Disclaimer
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED "AS IS" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. Use GNU Affero General Public License Version 3.0 (AGPL-3.0) or a later version as the Change License.
+2. Either specify an Additional Use Grant that does not impose additional restrictions, or insert "None".
+3. Specify a Change Date for each version.
+4. Provide commercial or special-use licenses upon request at support@blux.cc.
+5. Not modify this License in any way that conflicts with the above terms.
+
+-----------------------------------------------------------------------------
+
+Notice
+The Business Source License (this document, or the "License") is not an Open Source license. However, the Licensed Work will eventually be made available under an Open Source License, as stated in this License.
+

package/README.md

@@ -0,0 +1,108 @@
+# Blux Wallet Kit - The Missing Piece for Stellar dApps
+
+Blux is a **comprehensive authentication and wallet connect kit** designed for Stellar dApps. It simplifies onboarding by integrating multiple authentication methods, including **wallets, email, phone, and OAuth**. With Blux, developers can create seamless multi-auth experiences without the complexity of building custom authentication solutions from scratch.
+
+## Features
+
+- **Multi-Wallet Support**: Easily integrate Stellar wallets such as **Rabet, xBull, Lobstr, Freighter, and Albedo**.
+- **OAuth & Social Login** _(Coming Soon)_: Support for **Apple, Meta, Google, and more**.
+- **Email & Phone Authentication** _(Coming Soon)_: Securely onboard users with non-crypto credentials.
+- **Customizable UI**: Adjust themes, fonts, backgrounds, logos, border radius, and text colors.
+- **Configurable Networks**: Set up and modify network preferences via API keys.
+- **Future-Proof**: More wallets and authentication methods will be added based on community feedback.
+
+## Installation
+
+Blux can be installed via npm:
+
+```sh
+npm i @bluxcc/core
+```
+
+or using yarn:
+
+```sh
+yarn add @bluxcc/core
+```
+
+## Usage
+
+Include Blux and set up the authentication flow:
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Blux Example</title>
+    <script src="https://unpkg.com/@bluxcc/core/dist/index.iife.js"></script>
+  </head>
+  <body>
+    <button id="loginBtn">Login with Blux</button>
+
+    <script>
+      Blux.createConfig({
+        appName: 'your-app-name',
+        appId: 'get-id-from-dashboard',
+        networks: ['Public Global Stellar Network ; September 2015'],
+      });
+
+      document.getElementById('loginBtn').onclick = async () => {
+        const user = await Blux.Blux.login();
+
+        console.log('Logged in:', user);
+      };
+    </script>
+  </body>
+</html>
+```
+
+## Customization
+
+Developers can customize various UI elements:
+
+- **Themes & Fonts**
+- **Backgrounds, Logos**
+- **Border Radius & Text Colors**
+- **Authentication Limits** (Free tier supports 500-1000 accounts per auth method)
+
+Configuration options can be passed in the `config` object when initializing Blux, or set via environment variables.
+
+## Supported Wallets
+
+Currently supported connection methods:
+
+- [x] **Rabet**
+- [x] **xBull**
+- [x] **Lobstr**
+- [x] **Freighter**
+- [x] **Albedo**
+- [x] **Hana**
+- [ ] **Ledger**
+- [ ] **Trezor**
+- [ ] **WalletConnect**
+- [ ] **OAuth**
+- [ ] **Email**
+
+## License & Usage Restrictions
+
+- **No Production Use**: This software is provided under the **Blux Team License** with restrictions on production use.
+- **No Forking or Unauthorized Modifications**: Removing references to **Blux Team** or forking without attribution is strictly prohibited.
+- **Custom Licensing Available**: Contact us at [support@blux.cc](mailto:support@blux.cc) to discuss licensing options.
+
+## Support & Contact
+
+For support, licensing, or inquiries, reach out via:
+
+- **Email**: [support@blux.cc](mailto:support@blux.cc)
+- **X (Twitter)**: [@BluxOfficial](https://twitter.com/BluxOfficial)
+
+## Roadmap & Future Plans
+
+Blux is evolving. Follow our updates on [X (Twitter)](https://twitter.com/BluxOfficial) for:
+
+- **OAuth Authentication (Apple, Meta, Google, etc.)**
+- **Email & Phone-Based Authentication**
+- **More Wallet Integrations**
+- **Enhanced Customization & Security Features**
+
+Stay tuned. We have many exciting developments ahead!

package/dist/assets/Logos.d.ts

@@ -22,3 +22,7 @@ export declare const StellarSmallLogo: ({ fill }: {
     fill?: string;
 }) => import("react/jsx-runtime").JSX.Element;
 export declare const GoogleLogo: () => import("react/jsx-runtime").JSX.Element;
+export declare const WalletConnectLogo: ({ fill, background, }: {
+    fill?: string;
+    background?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/components/QRCode/index.d.ts

@@ -4,7 +4,8 @@ interface QRCodeCanvasProps {
     size?: number;
     bgColor?: string;
     fgColor?: string;
-    level?: "L" | "M" | "Q" | "H";
+    level?: 'L' | 'M' | 'Q' | 'H';
+    imgSize?: number;
 }
-declare const QRCode: ({ value, title, size, bgColor, fgColor, level, ...rest }: QRCodeCanvasProps) => import("react/jsx-runtime").JSX.Element;
+declare const QRCode: ({ value, title, size, bgColor, fgColor, level, imgSize, ...rest }: QRCodeCanvasProps) => import("react/jsx-runtime").JSX.Element;
 export default QRCode;

package/dist/enums.d.ts

@@ -4,7 +4,10 @@ export declare enum SupportedWallet {
     Freighter = "Freighter",
     Xbull = "xBull",
     Lobstr = "LOBSTR",
-    Hana = "Hana"
+    Hana = "Hana",
+    WalletConnect = "Wallet Connect",
+    Hot = "Hot",
+    Klever = "Klever"
 }
 export declare enum StellarNetwork {
     PUBLIC = "Public Global Stellar Network ; September 2015",
@@ -18,6 +21,7 @@ export declare enum Route {
     WRONG_NETWORK = "WRONG_NETWORK",// View for selecting a wallet
     WAITING = "WAITING",// View for connection process
     SUCCESSFUL = "SUCCESSFUL",// View for connection success process
+    FAILED = "FAILED",
     PROFILE = "PROFILE",// User profile view
     SEND_TRANSACTION = "SEND_TRANSACTION",// User sign transaction view
     SEND = "SEND",// User sign transaction view
@@ -29,5 +33,6 @@ export declare enum Route {
     BALANCE_DETAILS = "BALANCE_DETAILS",// View for asset details
     ABOUT = "ABOUT",// View for what is blux
     ADD_TOKEN = "ADD_TOKEN",// View for adding new token
-    SIGN_MESSAGE = "SIGN_MESSAGE"
+    SIGN_MESSAGE = "SIGN_MESSAGE",// User sign message view
+    WALLET_CONNECT = "WALLET_CONNECT"
 }

package/dist/exports/blux.d.ts

@@ -1,12 +1,18 @@
 export declare const login: () => Promise<void>;
-export declare const sendTransaction: (xdr: string, options: {
+export declare const sendTransaction: (xdr: string, options?: {
+    network: string;
+}) => Promise<unknown>;
+export declare const signMessage: (message: string, options?: {
     network: string;
 }) => Promise<unknown>;
 export declare const blux: {
     login: () => Promise<void>;
     logout: () => void;
     profile: () => void;
-    sendTransaction: (xdr: string, options: {
+    signMessage: (message: string, options?: {
+        network: string;
+    }) => Promise<unknown>;
+    sendTransaction: (xdr: string, options?: {
         network: string;
     }) => Promise<unknown>;
     readonly isReady: boolean;

package/dist/exports/createConfig.d.ts

@@ -0,0 +1,3 @@
+import { IConfig } from '../types';
+import '../tailwind.css';
+export declare function createConfig(config: IConfig): void;

package/dist/exports/index.d.ts

@@ -133,7 +133,10 @@ declare const _default: {
         login: () => Promise<void>;
         logout: () => void;
         profile: () => void;
-        sendTransaction: (xdr: string, options: {
+        signMessage: (message: string, options?: {
+            network: string;
+        }) => Promise<unknown>;
+        sendTransaction: (xdr: string, options?: {
             network: string;
         }) => Promise<unknown>;
         readonly isReady: boolean;