@reflecterlab/bridge-sdk 1.0.0

package/README.md

@@ -0,0 +1,48 @@
+# @reflecter/bridge-sdk 🚪
+
+El SDK oficial para conectar tus aplicaciones con el ecosistema de **Open The Doorz**. Construye mini-apps Web3 que se ejecutan directamente en la billetera corporativa más potente de Starknet.
+
+## 📦 Instalación
+
+```bash
+npm install @reflecter/bridge-sdk
+```
+
+## 🚀 Uso Rápido
+
+### 1. Inicializa el Bridge
+Conéctate con el Host para recibir el contexto del usuario y la organización.
+
+```javascript
+import { OTDBridge } from '@reflecter/bridge-sdk';
+
+const bridge = new OTDBridge('mi-app-id');
+
+// Obtener contexto
+const { handle, orgName, walletAddress } = await bridge.init();
+console.log(`Hola ${handle} de ${orgName}`);
+```
+
+### 2. Solicita una Transacción
+No te preocupes por la gestión de llaves. Pide al Host que firme y ejecute la transacción por ti.
+
+```javascript
+try {
+  const result = await bridge.sendTransaction({
+    to: "0x0123...456",
+    amount: "10",
+    token: "STRK",
+    data: "0x..." // Opcional: calldata para contratos inteligentes
+  });
+  
+  console.log("Transacción enviada:", result.txHash);
+} catch (error) {
+  console.error("Usuario rechazó la transacción o error de red");
+}
+```
+
+## 🔐 Seguridad
+El Bridge utiliza un sistema de mensajería asíncrona segura. Tu aplicación nunca tiene acceso a las claves privadas del usuario. Todas las acciones críticas requieren la aprobación explícita del usuario en la interfaz nativa de Open The Doorz.
+
+---
+Construido por **Reflecter Labs** 🚀

package/package.json

@@ -0,0 +1,23 @@
+{
+    "name": "@reflecterlab/bridge-sdk",
+    "version": "1.0.0",
+    "description": "The official bridge to build mini-apps on Open The Doorz ecosystem.",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch"
+    },
+    "keywords": [
+        "starknet",
+        "web3",
+        "mini-apps",
+        "bridge",
+        "wallet-sdk"
+    ],
+    "author": "Reflecter Labs",
+    "license": "MIT",
+    "devDependencies": {
+        "typescript": "^5.0.0"
+    }
+}

package/src/client.ts

@@ -0,0 +1,73 @@
+/**
+ * @reflecter/bridge-sdk
+ * Pure TypeScript SDK to interact with Open The Doorz Host
+ */
+
+import { BridgeMessage, BridgeMessageType } from './types';
+
+export class OTDBridge {
+    private appId: string;
+    private targetOrigin: string;
+    private pendingRequests: Map<string, { resolve: Function, reject: Function }> = new Map();
+
+    constructor(appId: string, targetOrigin: string = '*') {
+        this.appId = appId;
+        this.targetOrigin = targetOrigin;
+        this.setupListener();
+    }
+
+    private setupListener() {
+        if (typeof window === 'undefined') return;
+
+        window.addEventListener('message', (event) => {
+            // Future: Strict origin validation can be added here
+            const message = event.data as BridgeMessage;
+
+            if (!message || !message.id || !this.pendingRequests.has(message.id)) return;
+
+            const { resolve, reject } = this.pendingRequests.get(message.id)!;
+            this.pendingRequests.delete(message.id);
+
+            if (message.type === 'OTD_ERROR') {
+                reject(message.payload);
+            } else {
+                resolve(message.payload);
+            }
+        });
+    }
+
+    private sendMessage(type: BridgeMessageType, payload: any): Promise<any> {
+        return new Promise((resolve, reject) => {
+            const id = Math.random().toString(36).substring(7);
+            const message: BridgeMessage = {
+                id,
+                type,
+                payload,
+                appId: this.appId,
+                origin: typeof window !== 'undefined' ? window.location.origin : ''
+            };
+
+            this.pendingRequests.set(id, { resolve, reject });
+
+            if (window.parent !== window) {
+                window.parent.postMessage(message, this.targetOrigin);
+            } else {
+                reject(new Error("Bridge must be executed inside Open The Doorz Host (Iframe)"));
+            }
+        });
+    }
+
+    /**
+     * Initialize connection and get user/org context
+     */
+    async init(): Promise<{ handle: string, orgName: string, walletAddress: string }> {
+        return this.sendMessage('OTD_INIT_REQUEST', {});
+    }
+
+    /**
+     * Request a transaction signature and execution
+     */
+    async sendTransaction(params: { to: string, amount: string, token: string, data?: string }): Promise<{ txHash: string }> {
+        return this.sendMessage('OTD_TX_REQUEST', params);
+    }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './client';
+export * from './types';

package/src/types.ts

@@ -0,0 +1,33 @@
+export interface MiniApp {
+    id: string;
+    name: string;
+    description: string;
+    url: string; // The hosted URL of the mini-app
+    icon?: string;
+    category: 'finance' | 'gaming' | 'social' | 'tools' | 'ecosystem';
+    permissions: AppPermission[];
+    developer_id: string; // ID of the organization or user who owns the app
+    created_at: Date;
+    status: 'pending' | 'active' | 'suspended';
+}
+
+export type AppPermission =
+    | 'read_identity'   // Access to user alias/handle
+    | 'read_balances'   // Access to token balances
+    | 'sign_transaction' // Ability to request a TX signature
+    | 'sign_message';    // Ability to request a Typed Data signature
+
+export interface BridgeMessage<T = any> {
+    id: string;         // Unique ID to match request/response
+    type: BridgeMessageType;
+    payload: T;
+    appId: string;      // Identity of the sender
+    origin: string;     // URL origin for validation
+}
+
+export type BridgeMessageType =
+    | 'OTD_INIT_REQUEST'
+    | 'OTD_INIT_RESPONSE'
+    | 'OTD_TX_REQUEST'
+    | 'OTD_TX_RESPONSE'
+    | 'OTD_ERROR';