@proveanything/smartlinks 1.3.13 → 1.3.16

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.13  |  Generated: 2026-02-06T10:11:24.240Z
+Version: 1.3.16  |  Generated: 2026-02-06T12:14:25.408Z
 
 This is a concise summary of all available API functions and types.
 
@@ -63,15 +63,15 @@ Core HTTP functions for API configuration and communication:
 **isProxyEnabled**() → `boolean`
 Return whether proxy mode is currently enabled.
 
-**initializeApi**(options: {
-  baseURL: string
-  apiKey?: string
-  bearerToken?: string
-  proxyMode?: boolean
-  ngrokSkipBrowserWarning?: boolean
-  extraHeaders?: Record<string, string>
-  iframeAutoResize?: boolean // default true when in iframe
-  logger?: Logger // optional console-like or function to enable verbose logging
+**initializeApi**(options: {
+  baseURL: string
+  apiKey?: string
+  bearerToken?: string
+  proxyMode?: boolean
+  ngrokSkipBrowserWarning?: boolean
+  extraHeaders?: Record<string, string>
+  iframeAutoResize?: boolean // default true when in iframe
+  logger?: Logger // optional console-like or function to enable verbose logging
 }) → `void`
 Call this once (e.g. at app startup) to configure baseURL/auth.
 
@@ -84,34 +84,37 @@ Replace or augment globally applied custom headers.
 **setBearerToken**(token: string | undefined) → `void`
 Allows setting the bearerToken at runtime (e.g. after login/logout).
 
-**proxyUploadFormData**(path: string,
-  formData: FormData,
+**getBaseURL**() → `string | null`
+Get the currently configured API base URL. Returns null if initializeApi() has not been called yet.
+
+**proxyUploadFormData**(path: string,
+  formData: FormData,
   onProgress?: (percent: number) → `void`
 Upload a FormData payload via proxy with progress events using chunked postMessage. Parent is expected to implement the counterpart protocol.
 
 **request**(path: string) → `Promise<T>`
 Internal helper that performs a GET request to \`\${baseURL}\${path}\`, injecting headers for apiKey or bearerToken if present. Returns the parsed JSON as T, or throws an Error.
 
-**post**(path: string,
-  body: any,
+**post**(path: string,
+  body: any,
   extraHeaders?: Record<string, string>) → `Promise<T>`
 Internal helper that performs a POST request to `${baseURL}${path}`, injecting headers for apiKey or bearerToken if present. If body is FormData, Content-Type is not set. Returns the parsed JSON as T, or throws an Error.
 
-**put**(path: string,
-  body: any,
+**put**(path: string,
+  body: any,
   extraHeaders?: Record<string, string>) → `Promise<T>`
 Internal helper that performs a PUT request to `${baseURL}${path}`, injecting headers for apiKey or bearerToken if present. If body is FormData, Content-Type is not set. Returns the parsed JSON as T, or throws an Error.
 
-**patch**(path: string,
-  body: any,
+**patch**(path: string,
+  body: any,
   extraHeaders?: Record<string, string>) → `Promise<T>`
 Internal helper that performs a PATCH request to `${baseURL}${path}`, injecting headers for apiKey or bearerToken if present. If body is FormData, Content-Type is not set. Returns the parsed JSON as T, or throws an Error.
 
-**requestWithOptions**(path: string,
+**requestWithOptions**(path: string,
   options: RequestInit) → `Promise<T>`
 Internal helper that performs a request to `${baseURL}${path}` with custom options, injecting headers for apiKey or bearerToken if present. Returns the parsed JSON as T, or throws an Error.
 
-**del**(path: string,
+**del**(path: string,
   extraHeaders?: Record<string, string>) → `Promise<T>`
 Internal helper that performs a DELETE request to `${baseURL}${path}`, injecting headers for apiKey or bearerToken if present. Returns the parsed JSON as T, or throws an Error.
 

package/dist/http.d.ts

@@ -25,6 +25,11 @@ export declare function setExtraHeaders(headers: Record<string, string>): void;
  * Allows setting the bearerToken at runtime (e.g. after login/logout).
  */
 export declare function setBearerToken(token: string | undefined): void;
+/**
+ * Get the currently configured API base URL.
+ * Returns null if initializeApi() has not been called yet.
+ */
+export declare function getBaseURL(): string | null;
 /**
  * Upload a FormData payload via proxy with progress events using chunked postMessage.
  * Parent is expected to implement the counterpart protocol.

package/dist/http.js

@@ -208,6 +208,13 @@ export function setExtraHeaders(headers) {
 export function setBearerToken(token) {
     bearerToken = token;
 }
+/**
+ * Get the currently configured API base URL.
+ * Returns null if initializeApi() has not been called yet.
+ */
+export function getBaseURL() {
+    return baseURL;
+}
 // Map of pending proxy requests: id -> {resolve, reject}
 const proxyPending = {};
 function generateProxyId() {

package/dist/iframeResponder.js

@@ -3,6 +3,7 @@
 // =============================================================================
 import * as cache from './cache';
 import { collection } from './api/collection';
+import { getBaseURL } from './http';
 /**
  * Parent-side iframe responder for SmartLinks microapp embedding.
  *
@@ -217,38 +218,38 @@ export class IframeResponder {
             }
         }
         // Build URL - respect the URL format from server (hash routing or not)
-        const url = new URL(this.appUrl);
-        // Determine if this is a hash-routed app by checking if URL has a hash
-        const isHashRouted = url.hash.length > 0;
-        // If there's an initialPath, append it appropriately
-        if (this.options.initialPath) {
-            const path = this.options.initialPath;
-            const cleanPath = path.startsWith('/') ? path : '/' + path;
-            if (isHashRouted) {
-                // Hash routing - append to hash
-                const currentHash = url.hash.slice(1); // Remove leading #
-                const cleanHash = currentHash.replace(/\/$/, '');
-                url.hash = '#' + cleanHash + cleanPath;
+        let finalUrl = this.appUrl;
+        // Check if this URL uses hash routing (has a # in it)
+        const hasHash = finalUrl.includes('#');
+        console.log('[IframeResponder] URL has hash routing:', hasHash);
+        if (hasHash) {
+            // Hash-routed app - build params into the hash portion
+            const [baseWithHash, existingQuery = ''] = finalUrl.split('?');
+            const existingParams = new URLSearchParams(existingQuery);
+            params.forEach((value, key) => existingParams.set(key, value));
+            // Add initialPath if provided
+            if (this.options.initialPath) {
+                const path = this.options.initialPath.startsWith('/') ? this.options.initialPath : '/' + this.options.initialPath;
+                // Insert path before the ?
+                const [beforeHash, afterHash] = baseWithHash.split('#');
+                finalUrl = `${beforeHash}#${afterHash || ''}${path}?${existingParams.toString()}`;
             }
             else {
-                // Path routing - append to pathname
-                url.pathname = url.pathname.replace(/\/$/, '') + cleanPath;
+                finalUrl = `${baseWithHash}?${existingParams.toString()}`;
             }
         }
-        // Add query params
-        if (isHashRouted) {
-            // Hash routing - params go in the hash after ?
-            const hashParts = url.hash.slice(1).split('?'); // Remove # and split
-            const hashPath = hashParts[0];
-            const existingParams = hashParts[1] ? new URLSearchParams(hashParts[1]) : new URLSearchParams();
-            params.forEach((value, key) => existingParams.set(key, value));
-            url.hash = '#' + hashPath + '?' + existingParams.toString();
-        }
         else {
-            // Path routing - params go in searchParams
+            // Path-routed app - use URL API to add params normally
+            const url = new URL(finalUrl);
+            // Add initialPath if provided
+            if (this.options.initialPath) {
+                const path = this.options.initialPath.startsWith('/') ? this.options.initialPath : '/' + this.options.initialPath;
+                url.pathname = url.pathname.replace(/\/$/, '') + path;
+            }
+            // Add query params
             params.forEach((value, key) => url.searchParams.set(key, value));
+            finalUrl = url.toString();
         }
-        const finalUrl = url.toString();
         console.log('[IframeResponder] Final iframe URL:', finalUrl);
         return finalUrl;
     }
@@ -431,9 +432,11 @@ export class IframeResponder {
                     return;
                 }
             }
-            // Forward to actual API using SDK's http utilities
-            // Build full URL and use fetch for now (can be replaced with SDK request when needed)
-            const baseUrl = '/api/v1';
+            // Forward to actual API using SDK's configured baseURL
+            const baseUrl = getBaseURL();
+            if (!baseUrl) {
+                throw new Error('SDK not initialized - call initializeApi() first');
+            }
             const fetchOptions = {
                 method: proxyData.method,
                 headers: proxyData.headers,
@@ -524,7 +527,10 @@ export class IframeResponder {
                     upload.fields.forEach(([key, value]) => formData.append(key, value));
                     formData.append(upload.fileInfo.key || 'file', blob, upload.fileInfo.name || 'upload.bin');
                     const path = upload.path.startsWith('/') ? upload.path.slice(1) : upload.path;
-                    const baseUrl = '/api/v1';
+                    const baseUrl = getBaseURL();
+                    if (!baseUrl) {
+                        throw new Error('SDK not initialized - call initializeApi() first');
+                    }
                     const response = await fetch(`${baseUrl}/${path}`, {
                         method: 'POST',
                         body: formData,

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.13  |  Generated: 2026-02-06T10:11:24.240Z
+Version: 1.3.16  |  Generated: 2026-02-06T12:14:25.408Z
 
 This is a concise summary of all available API functions and types.
 
@@ -63,15 +63,15 @@ Core HTTP functions for API configuration and communication:
 **isProxyEnabled**() → `boolean`
 Return whether proxy mode is currently enabled.
 
-**initializeApi**(options: {
-  baseURL: string
-  apiKey?: string
-  bearerToken?: string
-  proxyMode?: boolean
-  ngrokSkipBrowserWarning?: boolean
-  extraHeaders?: Record<string, string>
-  iframeAutoResize?: boolean // default true when in iframe
-  logger?: Logger // optional console-like or function to enable verbose logging
+**initializeApi**(options: {
+  baseURL: string
+  apiKey?: string
+  bearerToken?: string
+  proxyMode?: boolean
+  ngrokSkipBrowserWarning?: boolean
+  extraHeaders?: Record<string, string>
+  iframeAutoResize?: boolean // default true when in iframe
+  logger?: Logger // optional console-like or function to enable verbose logging
 }) → `void`
 Call this once (e.g. at app startup) to configure baseURL/auth.
 
@@ -84,34 +84,37 @@ Replace or augment globally applied custom headers.
 **setBearerToken**(token: string | undefined) → `void`
 Allows setting the bearerToken at runtime (e.g. after login/logout).
 
-**proxyUploadFormData**(path: string,
-  formData: FormData,
+**getBaseURL**() → `string | null`
+Get the currently configured API base URL. Returns null if initializeApi() has not been called yet.
+
+**proxyUploadFormData**(path: string,
+  formData: FormData,
   onProgress?: (percent: number) → `void`
 Upload a FormData payload via proxy with progress events using chunked postMessage. Parent is expected to implement the counterpart protocol.
 
 **request**(path: string) → `Promise<T>`
 Internal helper that performs a GET request to \`\${baseURL}\${path}\`, injecting headers for apiKey or bearerToken if present. Returns the parsed JSON as T, or throws an Error.
 
-**post**(path: string,
-  body: any,
+**post**(path: string,
+  body: any,
   extraHeaders?: Record<string, string>) → `Promise<T>`
 Internal helper that performs a POST request to `${baseURL}${path}`, injecting headers for apiKey or bearerToken if present. If body is FormData, Content-Type is not set. Returns the parsed JSON as T, or throws an Error.
 
-**put**(path: string,
-  body: any,
+**put**(path: string,
+  body: any,
   extraHeaders?: Record<string, string>) → `Promise<T>`
 Internal helper that performs a PUT request to `${baseURL}${path}`, injecting headers for apiKey or bearerToken if present. If body is FormData, Content-Type is not set. Returns the parsed JSON as T, or throws an Error.
 
-**patch**(path: string,
-  body: any,
+**patch**(path: string,
+  body: any,
   extraHeaders?: Record<string, string>) → `Promise<T>`
 Internal helper that performs a PATCH request to `${baseURL}${path}`, injecting headers for apiKey or bearerToken if present. If body is FormData, Content-Type is not set. Returns the parsed JSON as T, or throws an Error.
 
-**requestWithOptions**(path: string,
+**requestWithOptions**(path: string,
   options: RequestInit) → `Promise<T>`
 Internal helper that performs a request to `${baseURL}${path}` with custom options, injecting headers for apiKey or bearerToken if present. Returns the parsed JSON as T, or throws an Error.
 
-**del**(path: string,
+**del**(path: string,
   extraHeaders?: Record<string, string>) → `Promise<T>`
 Internal helper that performs a DELETE request to `${baseURL}${path}`, injecting headers for apiKey or bearerToken if present. Returns the parsed JSON as T, or throws an Error.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.3.13",
+  "version": "1.3.16",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",