@snaha/swarm-id 0.0.1

package/dist/swarm-id-proxy.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Swarm ID Proxy - Runs inside the iframe
+ *
+ * Responsibilities:
+ * - Receive app-specific secrets from auth popup
+ * - Store secrets in partitioned localStorage
+ * - Proxy Bee API calls from parent dApp
+ * - Augment requests with authentication
+ * - Return responses to parent dApp
+ */
+export declare class SwarmIdProxy {
+    private parentOrigin;
+    private parentIdentified;
+    private authenticated;
+    private authLoading;
+    private appSecret;
+    private postageBatchId;
+    private signerKey;
+    private stamper;
+    private stamperDepth;
+    private storagePartitioned;
+    private pendingChallenge;
+    private storagePartitionedIdentity;
+    private utilizationStore;
+    private beeApiUrl;
+    private authButtonContainer;
+    private currentStyles;
+    private buttonConfig;
+    private popupMode;
+    private appMetadata;
+    private bee;
+    private unsubscribeConnectedApps;
+    private isConnecting;
+    private parentWindow;
+    private utilizationChannel;
+    constructor();
+    /**
+     * Subscribe to connected apps storage changes for direct mode authentication.
+     * When a user completes authentication in the /connect popup (direct mode),
+     * the popup writes to localStorage. This storage event notifies the proxy
+     * to check for a new valid connection and send authSuccess to the parent.
+     * Also handles disconnection when the connection is removed or invalidated.
+     *
+     * Note: We always set up this listener, even when storage might be partitioned.
+     * In some browsers/configurations (like localhost development), storage events
+     * work between same-origin windows even in iframes. If storage IS partitioned,
+     * the listener simply won't fire, and we fall back to postMessage from the popup.
+     */
+    private setupConnectedAppsListener;
+    /**
+     * Handle changes to connected apps storage (triggered by storage events from other windows).
+     * Handles new connections, identity changes, and disconnections.
+     */
+    private handleConnectedAppsChange;
+    /**
+     * Authenticate using data from connected apps storage
+     */
+    private authenticateFromStorage;
+    /**
+     * Handle messages from the auth popup (same-origin postMessage).
+     * Used as storage partitioning fallback when storage events don't fire due to partitioning.
+     */
+    private handlePopupMessage;
+    /**
+     * Clean up resources when the proxy is destroyed.
+     * Call this method when the proxy iframe is being unloaded.
+     */
+    destroy(): void;
+    /**
+     * Setup listener for utilization updates from other tabs.
+     * When another tab completes a write, it broadcasts an update.
+     * This tab applies the delta update directly from the message.
+     */
+    private setupUtilizationListener;
+    /**
+     * Execute a write operation with an exclusive lock across all tabs.
+     * Uses Web Locks API to ensure only one write happens at a time.
+     * Lock is scoped to the batch ID to allow different batches to write concurrently.
+     */
+    private withWriteLock;
+    /**
+     * Announce that proxy is ready to receive messages
+     * Broadcasts to parent with wildcard origin since we don't know parent origin yet
+     */
+    private announceReady;
+    /**
+     * Get the stored postage batch ID
+     */
+    getPostageBatchId(): string | undefined;
+    /**
+     * Get the stored signer key
+     */
+    getSignerKey(): string | undefined;
+    /**
+     * Initialize the Stamper for client-side signing
+     * Uses UtilizationAwareStamper to track bucket usage
+     */
+    private initializeStamper;
+    /**
+     * Save stamper bucket state to IndexedDB
+     * Utilization-aware stamper persists bucket state automatically
+     */
+    private saveStamperState;
+    /**
+     * Setup message listener for parent and popup messages
+     */
+    private setupMessageListener;
+    /**
+     * Handle parent identification
+     */
+    private handleParentIdentify;
+    /**
+     * Handle messages from parent window
+     */
+    private handleParentMessage;
+    /**
+     * Load authentication data from shared storage (ConnectedApp records).
+     */
+    private loadAuthData;
+    /**
+     * Look up the postage stamp for the currently connected app's identity
+     * by reading from shared localStorage stores.
+     */
+    private lookupPostageStampForApp;
+    /**
+     * Look up the account for the currently connected app's identity
+     * by reading from shared localStorage stores.
+     *
+     * @returns Account info with owner address and encryption key, or undefined if not found
+     */
+    private lookupAccountForApp;
+    /**
+     * Check if a connection is still valid based on connectedUntil timestamp
+     */
+    private isConnectionValid;
+    /**
+     * Find the most recently connected valid entry for the current parent origin.
+     * Resolves ambiguity when multiple identities are connected to the same app
+     * by sorting by lastConnectedAt descending and returning the first valid one.
+     */
+    private findMostRecentConnection;
+    /**
+     * Look up the app secret from shared storage for the current parent origin.
+     * Returns the secret and identityId if found and connection is valid.
+     */
+    private lookupAppSecretFromSharedStorage;
+    /**
+     * Clear authentication data
+     */
+    private clearAuthData;
+    /**
+     * Send error message to parent
+     */
+    private sendErrorToParent;
+    private ensureCanUpload;
+    /**
+     * Send message to parent
+     */
+    private sendToParent;
+    private handleCheckAuth;
+    private handleGetConnectionInfo;
+    private handleIsConnected;
+    private handleGetNodeInfo;
+    private handleDisconnect;
+    private handleRequestAuth;
+    /**
+     * Show authentication button in the UI
+     */
+    private showAuthButton;
+    private handleConnect;
+    /**
+     * Open the authentication popup window.
+     * Returns true if popup was opened, false if parent origin is not set.
+     */
+    private openAuthPopup;
+    /**
+     * Handle login button click
+     */
+    private handleLoginClick;
+    /**
+     * Handle disconnect button click
+     */
+    private handleDisconnectClick;
+    /**
+     * Set container element for auth button
+     */
+    setAuthButtonContainer(container: HTMLElement): void;
+    private handleUploadData;
+    private handleDownloadData;
+    private handleUploadFile;
+    private handleDownloadFile;
+    private handleUploadChunk;
+    private handleDownloadChunk;
+    private handleGsocMine;
+    private handleGsocSend;
+    private handleSocUpload;
+    private handleSocRawUpload;
+    private handleSocDownload;
+    private handleSocRawDownload;
+    private handleSocGetOwner;
+    private parseFeedTimestamp;
+    private parseFeedIndex;
+    private makeSequentialFeedIdentifier;
+    private findLatestSequentialIndex;
+    private sequentialNextIndex;
+    private handleFeedGetOwner;
+    private handleEpochFeedDownloadReference;
+    private handleEpochFeedUploadReference;
+    private handleSequentialFeedGetOwner;
+    private resolveSequentialOwner;
+    private parseSequentialPayload;
+    private resolveSequentialIndex;
+    private handleSequentialFeedDownloadPayload;
+    private handleSequentialFeedDownloadRawPayload;
+    private handleSequentialFeedDownloadReference;
+    private buildSequentialPayload;
+    private handleSequentialFeedUploadPayload;
+    private handleSequentialFeedUploadRawPayload;
+    private handleSequentialFeedUploadReference;
+    private handleActUploadData;
+    private handleActDownloadData;
+    private handleActAddGrantees;
+    private handleActRevokeGrantees;
+    private handleActGetGrantees;
+    private handleGetPostageBatch;
+    /**
+     * Handle createFeedManifest request
+     * Creates a feed manifest for accessing feed content via URL
+     */
+    private handleCreateFeedManifest;
+}
+/**
+ * Initialize the proxy (called from HTML page)
+ */
+export declare function initProxy(): SwarmIdProxy;
+//# sourceMappingURL=swarm-id-proxy.d.ts.map

package/dist/swarm-id-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-id-proxy.d.ts","sourceRoot":"","sources":["../src/swarm-id-proxy.ts"],"names":[],"mappings":"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"}