@sampleapp.ai/sdk 1.0.29 → 1.0.31

package/dist/lib/api-client.example.js

@@ -0,0 +1,60 @@
+/**
+ * Example usage of the API client
+ *
+ * This file demonstrates how to use the API client to interact with
+ * the SampleApp backend API.
+ *
+ * The apiKey will be passed in from SandboxProps.apiKey (from types.ts)
+ */
+import { createApiClient } from "./api-client";
+// Example: How to use the API client with apiKey from SandboxProps
+function createClientFromSandboxProps(props, baseUrl = "http://127.0.0.1:8000") {
+    return createApiClient({
+        baseUrl,
+        apiKey: props.apiKey, // apiKey comes from SandboxProps
+    });
+}
+// Initialize the API client (example)
+const client = createApiClient({
+    baseUrl: "http://127.0.0.1:8000", // or your production URL
+    apiKey: "your-api-key-here", // This will come from SandboxProps.apiKey
+});
+// Example 1: Get public sandbox content
+// Note: sandboxId from SandboxProps maps to sandbox_content_uid
+async function getSandboxContentExample(apiKey, sandboxId, baseUrl = "http://127.0.0.1:8000") {
+    try {
+        const client = createApiClient({
+            baseUrl,
+            apiKey, // apiKey from SandboxProps.apiKey
+        });
+        // sandboxId from SandboxProps maps to sandbox_content_uid
+        const sandboxContent = await client.sandboxContent.getPublic(sandboxId);
+        console.log("Sandbox content:", sandboxContent);
+        return sandboxContent;
+    }
+    catch (error) {
+        console.error("Error fetching sandbox content:", error);
+        throw error;
+    }
+}
+// Example 2: Start a sandbox
+async function startSandboxExample() {
+    try {
+        const response = await client.sdk.startSandbox({
+            env: {
+                API_KEY: "your-api-key",
+                ENVIRONMENT: "production",
+            },
+            apiKey: "your-sdk-api-key",
+            chatUid: "your-chat-uid",
+        });
+        console.log("Container URL:", response.container_url);
+        return response;
+    }
+    catch (error) {
+        console.error("Error starting sandbox:", error);
+        throw error;
+    }
+}
+// Export examples for use in other files
+export { getSandboxContentExample, startSandboxExample, createClientFromSandboxProps, };

package/dist/lib/api-client.js

@@ -0,0 +1,140 @@
+/**
+ * SDK API Client for interacting with the SampleApp backend API
+ */
+/**
+ * Extract container ID from a browser URL
+ * @param browserUrl - URL like "https://nextjs-a3fcd2bb-2a15-4f9b-bd13-aeac52baebd2.sampleapp.love/?_ts=1767897000670"
+ * @returns Container ID like "nextjs-a3fcd2bb-2a15-4f9b-bd13-aeac52baebd2" or null if not found
+ */
+export function extractContainerIdFromUrl(browserUrl) {
+    try {
+        const url = new URL(browserUrl);
+        // Hostname is like "nextjs-a3fcd2bb-2a15-4f9b-bd13-aeac52baebd2.sampleapp.love"
+        const hostname = url.hostname;
+        // Split by the first dot to get the container ID
+        const parts = hostname.split(".");
+        if (parts.length >= 2) {
+            return parts[0]; // e.g., "nextjs-a3fcd2bb-2a15-4f9b-bd13-aeac52baebd2"
+        }
+        return null;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+const getBaseUrl = () => {
+    return process.env.BASE_API_URL || "https://api.sampleapp.ai";
+};
+/**
+ * Main API client class
+ */
+class ApiClient {
+    constructor(config) {
+        /**
+         * Sandbox content endpoints
+         */
+        this.sandboxContent = {
+            /**
+             * Get public sandbox content by UID
+             * @param sandboxContentUid - The UID of the sandbox content
+             * @returns The sandbox content data
+             */
+            getPublic: async (sandboxContentUid) => {
+                return this.request([
+                    "sandbox-content",
+                    sandboxContentUid,
+                    "public",
+                ]);
+            },
+            /**
+             * Get all sandbox contents for a specific playground (public access with truncated fields)
+             * @param playgroundUid - The UID of the playground
+             * @param skip - Number of records to skip (default: 0)
+             * @param limit - Maximum number of records to return (default: 100)
+             * @returns Array of sandbox content data with only uid and markdown fields
+             */
+            getByPlayground: async (playgroundUid, skip = 0, limit = 100) => {
+                return this.request(["sandbox-content", "playground", playgroundUid, "public"], {
+                    method: "GET",
+                }, false, // Public endpoint, no API key required
+                { skip, limit });
+            },
+        };
+        /**
+         * SDK endpoints
+         */
+        this.sdk = {
+            /**
+             * Start a sandbox
+             * @param request - The start sandbox request
+             * @returns The sandbox response with container URL
+             */
+            startSandbox: async (request) => {
+                return this.request(["sdk", "start-sandbox"], {
+                    method: "POST",
+                    body: JSON.stringify(request),
+                });
+            },
+            /**
+             * Get the download URL for a container's code
+             * @param containerId - The container ID (extracted from browserUrl)
+             * @returns The full URL to download the code
+             */
+            getDownloadCodeUrl: (containerId) => {
+                return `${this.baseUrl}/api/v1/sdk/download-code?container_id=${encodeURIComponent(containerId)}`;
+            },
+            /**
+             * Download code from a container
+             * @param containerId - The container ID (extracted from browserUrl)
+             * @returns Triggers a file download
+             */
+            downloadCode: (containerId) => {
+                const url = this.sdk.getDownloadCodeUrl(containerId);
+                window.open(url, "_blank");
+            },
+        };
+        const defaultBaseUrl = getBaseUrl();
+        this.baseUrl = defaultBaseUrl.replace(/\/$/, ""); // Remove trailing slash
+        this.apiKey = config.apiKey;
+    }
+    /**
+     * Makes a request to the API
+     */
+    async request(endpoint, options = {}, useApiKeyHeader = false, queryParams) {
+        let url = `${this.baseUrl}/api/v1/${endpoint.join("/")}`;
+        if (queryParams) {
+            const params = new URLSearchParams();
+            Object.entries(queryParams).forEach(([key, value]) => {
+                params.append(key, value.toString());
+            });
+            url += `?${params.toString()}`;
+        }
+        const headers = Object.assign({ "Content-Type": "application/json" }, options.headers);
+        if (this.apiKey) {
+            if (useApiKeyHeader) {
+                headers["x-api-key"] = this.apiKey;
+            }
+            else {
+                headers["Authorization"] = `Bearer ${this.apiKey}`;
+            }
+        }
+        const response = await fetch(url, Object.assign(Object.assign({}, options), { headers }));
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API request failed: ${response.status} ${response.statusText}. ${errorText}`);
+        }
+        return response.json();
+    }
+}
+/**
+ * Create an API client instance
+ * @param config - Configuration for the API client
+ * @returns An API client instance
+ */
+export function createApiClient(config) {
+    return new ApiClient(config);
+}
+/**
+ * Default export for convenience
+ */
+export default ApiClient;