API and SDK Documentation

\n \n

\n{`Emoji Summarizer API and SDK Documentation\n\nBase URL: https://dcm31-texttoemoji.web.val.run\n\nAPI Endpoint: /api/emojisummary\nMethod: GET\n\nQuery Parameters:\ntext: String of text to be summarized with an emoji (URL encoded)\n\nExample API usage:\nhttps://dcm31-texttoemoji.web.val.run/api/emojisummary?text=I%20love%20pizza%20for%20lunch\n\nResponse Format:\n{\n  \"emoji\": \"Single emoji summarizing the text\",\n  \"fullResponse\": \"JSON string containing the full OpenAI API response\",\n  \"fromCache\": \"Boolean indicating whether the response was retrieved from cache\"\n}\n\nExample response:\n{\n  \"emoji\": \"🍕\",\n  \"fullResponse\": \"{ ... full OpenAI API response ... }\",\n  \"fromCache\": false\n}\n\nNote: The fullResponse field contains the complete OpenAI API response as a JSON string.\nYou may want to parse this JSON string to access specific details of the API response.\n\nError Handling:\nIf an error occurs, the API will return a JSON object with an \"error\" field describing the issue.\n\n{\n  \"error\": \"Error message\",\n  \"fullResponse\": \"Error details or stack trace\"\n}\n\nExample URLs for testing:\n1. Happy: https://dcm31-texttoemoji.web.val.run/api/emojisummary?text=I%20feel%20happy%20today\n2. Sad: https://dcm31-texttoemoji.web.val.run/api/emojisummary?text=I'm%20feeling%20down%20and%20blue\n3. Excited: https://dcm31-texttoemoji.web.val.run/api/emojisummary?text=I%20can't%20wait%20for%20the%20party%20tonight!\n4. Angry: https://dcm31-texttoemoji.web.val.run/api/emojisummary?text=This%20traffic%20is%20making%20me%20furious\n\nSDK Usage:\nTo use the Emoji Summarizer SDK in your Val Town projects:\n\n1. Import the SDK:\n   import { EmojiSummarizerSDK } from \"https://esm.town/v/dcm31/texttoemoji\";\n\n   Note: You can use the '@' symbol for autocomplete when importing vals within Val Town.\n\n2. Create an instance of the SDK:\n   const sdk = new EmojiSummarizerSDK(\"https://dcm31-texttoemoji.web.val.run\");\n\n3. Use the summarize method:\n   const result = await sdk.summarize(\"I love pizza!\");\n   console.log(result.emoji);\n   console.log(result.fromCache);\n\nThe SDK provides a simple interface to interact with the Emoji Summarizer API.\n\nAll vals are hosted on esm.town and are available for import on Val Town, Deno, Node, the browser,\nand anywhere else https-imports are supported. Val Town builds upon these http-style imports\nto create a lightweight package registry where each snippet of code is a package.\n\nFor projects within Val Town, you can import files and folders relative to the project root (e.g., ./home).\nThis means you don't have to update your imports when you branch, fork, or rename a project.\n\nPrivate vals are only importable with the DENO_AUTH_TOKEN environment variable set,\nwhich is automatically set for you in Val Town, allowing only you to import your private vals.\n\nCaching:\nThe API now uses SQLite to cache responses. If a request for the same text is made again,\nthe cached emoji will be returned without calling the OpenAI API. This reduces API calls\nand improves response times for repeated queries.`}\n

\n );\n}\n\nfunction ApiTester() {\n const [testResults, setTestResults] = useState({});\n const sdk = new EmojiSummarizerSDK(\"https://dcm31-texttoemoji.web.val.run\");\n\n const testCases = [\n { name: \"Happy\", text: \"I feel happy today\" },\n { name: \"Sad\", text: \"I'm feeling down and blue\" },\n { name: \"Excited\", text: \"I can't wait for the party tonight!\" },\n { name: \"Angry\", text: \"This traffic is making me furious\" },\n ];\n\n const runTest = async (testCase) => {\n try {\n const result = await sdk.summarize(testCase.text);\n setTestResults(prev => ({\n ...prev,\n [testCase.name]: { \n emoji: result.emoji, \n fullResponse: result.fullResponse,\n fromCache: result.fromCache\n }\n }));\n } catch (err) {\n setTestResults(prev => ({\n ...prev,\n [testCase.name]: { error: \"Failed to fetch response\" }\n }));\n }\n };\n\n return (\n

API Tester

\n {testCases.map(testCase => (\n \n ))}\n

\n {Object.entries(testResults).map(([name, result]) => (\n

{name}

Input: \"{testCases.find(tc => tc.name === name).text}\"

\n {result.emoji ? (\n <>\n

Result: {result.emoji}

From Cache: {result.fromCache ? \"Yes\" : \"No\"}

Full Response

{result.fullResponse}

\n \n ) : (\n

{result.error}

\n )}\n

\n ))}\n

\n );\n}\n\nfunction App() {\n const [input, setInput] = useState(\"\");\n const [result, setResult] = useState(\"\");\n const [fullResponse, setFullResponse] = useState(\"\");\n const [fromCache, setFromCache] = useState(false);\n const sdk = new EmojiSummarizerSDK(\"https://dcm31-texttoemoji.web.val.run\");\n\n const handleSubmit = async (e) => {\n e.preventDefault();\n setResult(\"\");\n setFullResponse(\"\");\n setFromCache(false);\n try {\n const data = await sdk.summarize(input);\n setResult(data.emoji);\n setFullResponse(data.fullResponse);\n setFromCache(data.fromCache);\n } catch (err) {\n setResult(\"Failed to fetch response\");\n }\n };\n\n return (\n

Single Emoji Summarizer

\n );\n}\n\nfunction client() {\n createRoot(document.getElementById(\"root\")).render();\n}\nif (typeof document !== \"undefined\") { client(); }\n\nexport default async function server(request: Request): Promise {\n const { OpenAI } = await import(\"https://esm.town/v/std/openai\");\n const { sqlite } = await import(\"https://esm.town/v/stevekrouse/sqlite\");\n const openai = new OpenAI();\n\n const url = new URL(request.url);\n if (request.method === \"GET\" && url.pathname === \"/api/emojisummary\") {\n try {\n const text = url.searchParams.get(\"text\");\n if (!text) {\n throw new Error(\"Missing 'text' parameter\");\n }\n\n const KEY = \"textToEmoji\";\n const SCHEMA_VERSION = 1;\n\n // Create table if not exists\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS ${KEY}_emoji_cache_${SCHEMA_VERSION} (\n text TEXT PRIMARY KEY,\n emoji TEXT NOT NULL,\n full_response TEXT NOT NULL\n )\n `);\n\n // Check if the text is in the cache\n const cachedResult = await sqlite.execute(`\n SELECT emoji, full_response FROM ${KEY}_emoji_cache_${SCHEMA_VERSION}\n WHERE text = ?\n `, [text]);\n\n if (cachedResult.rows.length > 0) {\n const { emoji, full_response } = cachedResult.rows[0];\n return new Response(JSON.stringify({\n emoji,\n fullResponse: full_response,\n fromCache: true\n }), {\n headers: { \"Content-Type\": \"application/json\" },\n });\n }\n\n // If not in cache, call OpenAI API\n const completion = await openai.chat.completions.create({\n messages: [\n { role: \"system\", content: \"You are an emoji summarizer. Given a text, respond with exactly one emoji that best summarizes the content. Only respond with the single emoji, nothing else.\" },\n { role: \"user\", content: text },\n ],\n model: \"gpt-4-mini\",\n max_tokens: 5,\n });\n\n const emoji = completion.choices[0].message.content.trim();\n const fullResponse = JSON.stringify(completion, null, 2);\n\n // Only save to cache if the response is a single emoji\n if (/^[\\p{Emoji_Presentation}\\p{Emoji}\\p{Emoji_Modifier_Base}]$/u.test(emoji)) {\n await sqlite.execute(`\n INSERT OR REPLACE INTO ${KEY}_emoji_cache_${SCHEMA_VERSION} (text, emoji, full_response)\n VALUES (?, ?, ?)\n `, [text, emoji, fullResponse]);\n }\n\n return new Response(JSON.stringify({\n emoji,\n fullResponse,\n fromCache: false\n }), {\n headers: { \"Content-Type\": \"application/json\" },\n });\n } catch (error) {\n return new Response(JSON.stringify({\n error: error.message || \"Failed to process request\",\n fullResponse: error.toString()\n }), {\n status: 500,\n headers: { \"Content-Type\": \"application/json\" },\n });\n }\n }\n\n return new Response(`\n \n \n Single Emoji Summarizer\n \n \n \n

\n \n \n \n \n `,\n {\n headers: {\n \"content-type\": \"text/html\",\n },\n });\n}\n\nexport { EmojiSummarizerSDK };\n\nconst css = `\nbody {\n font-family: system-ui, sans-serif;\n max-width: 800px;\n margin: 0 auto;\n padding: 20px;\n}\n.container {\n display: flex;\n flex-direction: column;\n align-items: center;\n}\nform, .api-tester, .documentation {\n display: flex;\n flex-direction: column;\n width: 100%;\n max-width: 500px;\n margin-bottom: 20px;\n}\ntextarea {\n margin-bottom: 10px;\n padding: 10px;\n}\nbutton {\n padding: 10px;\n background-color: #0077cc;\n color: white;\n border: none;\n cursor: pointer;\n margin: 5px;\n}\nbutton:hover {\n background-color: #005fa3;\n}\n.result, .emoji-result {\n margin-top: 20px;\n font-size: 48px;\n}\npre {\n white-space: pre-wrap;\n word-wrap: break-word;\n background-color: #f0f0f0;\n padding: 10px;\n border-radius: 5px;\n max-width: 100%;\n overflow-x: auto;\n}\n.test-buttons {\n display: flex;\n flex-wrap: wrap;\n justify-content: center;\n}\n.test-result {\n margin-top: 20px;\n border: 1px solid #ccc;\n padding: 10px;\n border-radius: 5px;\n}\n.error {\n color: red;\n}\n`;","deleted","label","text-to-emoji",[98],"permalink","https://www.val.town/x/dcm31/textToEmoji/code/main.tsx","extension","actionData","errors"]