[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_434":435,"_436":437},"routes/_app.x.$handle.$name",{"_94":93,"_32":44,"_102":84,"_27":103,"_13":14,"_104":-5,"_11":105,"_106":107,"_108":109,"_110":111,"_112":113,"_20":-5,"_114":-5,"_115":-5,"_116":26,"_117":118,"_119":24,"_120":-5,"_121":-5,"_122":123},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_42":43,"_32":44,"_37":45,"_46":-5,"_47":26,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":55,"_56":24,"_57":24,"_58":-5,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":-5,"_66":-5,"_67":68,"_69":68,"_70":71,"_72":71,"_73":71,"_74":68,"_75":68,"_76":77,"_78":79,"_80":81,"_82":26},"version",69,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":26,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":20,"_35":36,"_37":38,"_39":14,"_40":41,"_23":26},"previous","deleted",true,"deletedHere",false,"path","embedded-app-sdk-main/docs/embedded-app-sdk-v1-migration.md","latestPath","fileId","9465c84a-c6c6-11f0-a9de-42dde27851f2","name","embedded-app-sdk-v1-migration.md","fileType","content","# embedded-app-sdk V1 Migration\n\nIf you were previously using activity-iframe-sdk, this guide is for you. Think of `@discord/embedded-app-sdk` as the next version of `activity-iframe-sdk` with a few breaking changes. This document is aimed to help developers migrate their activity code from activity-iframe-sdk v2 to @discord/embedded-app-sdk v1.0.0 and beyond. If you are upgrading from activity-iframe-sdk v1, please first reference [this document](/docs/activity-iframe-sdk-v2-migration.md)\n\n## tldr;\n\nHere's the high level list of changes\n\n- [New SDK Name](#new-sdk-name)\n- [Typescript support for subscribe and unsubscribe](#typescript-support-for-subscribe-and-unsubscribe)\n- [initializeNetworkShims is different](#initializenetworkshims-is-different)\n- [Removing unused commands, events, and types](#removing-unused-commands-events-and-types)\n\n### New SDK Name\n\nWe've renamed the SDK to align with the long-term vision for Discord apps. If you're embedding an app inside of Discord, this SDK has got you covered. The main use case today is for Discord apps which launch activities via iframes, however, as this name implies, this SDK could support use for Discord applications beyond just activities.\n\n### Typescript support for subscribe and unsubscribe\n\nPreviously, there were no typescript types provided when subscribing to events. Now, as soon as you provide an event name, typescript can help infer the shape of data returned by the callback, as well as additional subscribeArgs, when necessary.\n\nOften, you may not want to describe the subscription callback inline. If you are using typescript, you can define the event shape outside of the callback, using the generic type `EventPayloadData`. Check out this example where we subscribe to the `SPEAKING_START` event.\n\n```ts\nimport {DiscordSDK, EventPayloadData} from '@discord/embedded-app-sdk';\n\n// Initialize the SDK\nconst discordSdk = new DiscordSDK(CLIENT_ID);\n\n// Retrieve the typescript type for the SPEAKING_START event\ntype SPEAKING_START_EVENT = EventPayloadData<'SPEAKING_START'>;\n\n// Define the callback function that will fire whenever a SPEAKING_START event is captured\nfunction handleStartTalking(event: SPEAKING_START_EVENT) {\n console.log(`user ${event.user_id} started talking`);\n}\n\n// Subscribe to the SPEAKING_START event and pass appropriate\ndiscordSdk.subscribe('SPEAKING_START', handleStartTalking, {channel_id: discordSdk.channelId});\n```\n\n### initializeNetworkShims is different\n\nIf you're using `initializeNetworkShims` in your activity, you will need to migrate it to the new API `patchUrlMappings`. It's the same in spirit, but it has a few differences:\n\n- We have renamed `initializeNetworkShims` to `patchUrlMappings`\n- `patchUrlMappings` is now exported as a utility separate from the SDK. This allows you to initialize shims as soon as possible, separate from SDK initialization\n- `patchUrlMappings` now includes new functionality that can update html `src` attributes to adjust to your url mappings.\n- `patchUrlMappings` now includes a second argument where you can set specific configuration for each \"shim\". See usage in the example below\n\n```ts\nimport {patchUrlMappings} from '@discord/embedded-app-sdk';\n\npatchUrlMappings(\n [\n {\n target: 'google.com',\n prefix: '/google',\n },\n ],\n {\n patchFetch: true, // Defaults to true\n patchWebSocket: true, // Defaults to true\n patchXhr: true, // Defaults to true\n patchSrcAttributes: true, // Defaults to false (potentially compute expensive for your UI)\n }\n);\n```\n\n### Removing unused commands and events\n\nThe original SDK included several events and commands which are either no longer relevant, unusable, or otherwise not something we want in the SDK.\n\nThe following were removed or modified:\n\n- Removed Events\n - `ACTIVITY_JOIN`\n - If you are using this today, we encourage subscribing to the `ACTIVITY_INSTANCE_PARTICIPANTS_UPDATE` event instead\n - `ACTIVITY_SPECTATE`\n - If you are using this today, we encourage subscribing to the `ACTIVITY_INSTANCE_PARTICIPANTS_UPDATE` event instead\n - `ACTIVITY_PIP_MODE_UPDATE`\n - If you are using this today, we encourage subscribing to the `ACTIVITY_LAYOUT_MODE_UPDATE` event instead\n - `CAPTURE_SHORTCUT_CHANGE`\n - `GUILD_STATUS`\n - `GUILD_CREATE`\n - `CHANNEL_CREATE`\n - `VOICE_CHANNEL_CREATE`\n - `NOTIFICATION_CREATE`\n - `ACTIVITY_JOIN_REQUEST`\n - `VOICE_STATE_CREATE`\n - `VOICE_STATE_DELETE`\n - `VOICE_SETTINGS_UPDATE`\n - `VOICE_CONNECTION_STATUS`\n- Removed Commands\n - `getSelectedVoiceChannel`\n We recommend using `getChannel` instead, where appropriate. If you need access to the current channel's id, it can be accessed immediately by the SDK, directly at `discordSdk.channelId`\n - `subscribeToLayoutModeUpdatesCompat` and `unsubscribeFromLayoutModeUpdatesCompat`\n - If you are using these today, we encourage subscribing to the `ACTIVITY_LAYOUT_MODE_UPDATE` event instead\n - `setUserVoiceSettings`\n - `setVoiceSettings`\n - `getVoiceSettings`\n - `startPremiumPurchase`\n\n# Step by Step Guide\n\nEach activity is implemented differently, but migrating to embedded-app-sdk from activity-iframe-sdk should be straightforward with the use of typescript. Here is a simple outline of how we expect the migration should occur.\n\n0. If you are upgrading from `activity-iframe-sdk` v1, please review and implement the [activity-iframe-sdk v2 migration guide](/docs/activity-iframe-sdk-v2-migration.md) before following these steps.\n1. Upgrade by uninstalling the old package and installing the new.\n - `npm uninstall @discord-external/activity-iframe-sdk`\n - `npm install @discord/embedded-app-sdk`\n2. Remove any code related to installing a private github package. This will most likely look like removing a `.npmrc` file or other references to `npm.pkg.github.com`\n3. Run typescript (`tsc`) and observe errors. Most of the errors will be related to usage of `subscribe`, or usage of removed commands and events, as expected.\n4. Fix typescript errors. We expect most of not all typescript errors will be related to `subscribe`. The type `EventPayloadData<'YOUR_EVENT'>` will be your biggest helper here. Remove usage of unsupported events and command, and migrate as necessary, per recommandations [above](#removing-unused-commands-and-events)\n5. Perform a basic test of key functionality.\n6. Profit from having type safety and the latest SDK updates from here on out!\n\n## SDK Playground Example migration\n\nAs a real example, our `sdk-playground` example application migrated to @discord/embedded-app-sdk 1.0.0 from @discord/activity-iframe-sdk. This is a summary of all the changes required.\n\n### Migrate subscribeToLayoutModeUpdatesCompat command to instead subscribe to the ACTIVITY_LAYOUT_MODE_UPDATE event\n\n```diff\nexamples/sdk-playground/packages/client/src/pages/LayoutMode.tsx\n- import {Common} from '@discord/activity-iframe-sdk';\n+ import {Common, EventPayloadData} from '@discord/embedded-app-sdk';\n\n- const handleLayoutModeUpdate = React.useCallback((update: {layout_mode: number}) => {\n+ const handleLayoutModeUpdate = React.useCallback((update: EventPayloadData<'ACTIVITY_LAYOUT_MODE_UPDATE'>) => {\n\n React.useEffect(() => {\n- discordSdk.subscribeToLayoutModeUpdatesCompat(handleLayoutModeUpdate);\n+ discordSdk.subscribe('ACTIVITY_LAYOUT_MODE_UPDATE', handleLayoutModeUpdate);\n return () => {\n- discordSdk.unsubscribeFromLayoutModeUpdatesCompat(handleLayoutModeUpdate);\n+ discordSdk.unsubscribe('ACTIVITY_LAYOUT_MODE_UPDATE', handleLayoutModeUpdate);\n```\n\n### Migrate event subscriptions to define event shape\n\n```diff\nexamples/sdk-playground/packages/client/src/pages/Instance.tsx\n- import {Events, Types} from '@discord/activity-iframe-sdk';\n+ import {Events, EventPayloadData} from '@discord/embedded-app-sdk';\n\n- type UpdateEvent = Types.GetActivityInstanceConnectedParticipantsResponse;\n+ type UpdateEvent = EventPayloadData<'ACTIVITY_INSTANCE_PARTICIPANTS_UPDATE'>;\n```\n\n### Migrate usage of initializeNetworkShims to patchUrlMappings\n\n```diff\n\n- import {DiscordSDK, DiscordSDKMock, IDiscordSDK} from '@discord/embedded-app-sdk';\n+ import {DiscordSDK, DiscordSDKMock, IDiscordSDK, patchUrlMappings} from '@discord/embedded-app-sdk';\n\n- discordSdk.initializeNetworkShims(mappings);\n+ patchUrlMappings(mappings);\n```\n","createdAt",["D",1763721664395],"branchVersion","branchId","6b9c74d8-c68d-11f0-90e3-42dde27851f2","id","6b9c21e0-c68d-11f0-90e3-42dde27851f2","discordActivity",["D",1763697114652],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","imageUrl","3c6e69f0-47e4-11f0-9a03-7b3078c543a6","pinnedFileId","2d1f1624-c6ca-11f0-8285-42dde27851f2","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","3523fab4-eae5-464b-8111-01449ed5f821","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_94":93,"_101":97},"org",{"_94":93,"_95":-5,"_96":97,"_18":53,"_98":99,"_100":26},"branch",{"_13":83,"_32":84,"_42":41,"_85":43,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":-5,"_91":44,"_92":93},"isOwned",270,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","cookiemonster0921","handle","displayName","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/63bb8d1a-a2d4-4835-8d55-b5e643afa200/square512?exp=1789595428&sig=12080590192c4d96052694f1329830a192bfcc6ab5349a484ce9fbd081d84ebc","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_42":43,"_32":44,"_37":430,"_46":-5,"_47":26,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":55,"_56":24,"_57":24,"_58":-5,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":-5,"_66":-5,"_67":68,"_69":68,"_70":71,"_72":71,"_73":71,"_74":68,"_75":68,"_76":431,"_78":432,"_80":433,"_82":26},"tree",[209,233,234,235,236,237,238,239],"files",[209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239],"counts",{"_197":60,"_198":199,"_200":60,"_201":202,"_203":204},"contents",[124,125,126,127,128,129,130,131],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":190,"_32":191,"_30":192,"_135":-5,"_40":41,"_39":193,"_137":26,"_37":194,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_27":196},{"_42":183,"_32":184,"_30":185,"_135":-5,"_40":41,"_39":186,"_137":26,"_37":187,"_13":60,"_34":20,"_35":188,"_23":26,"_142":-5,"_27":189},{"_42":176,"_32":177,"_30":178,"_135":-5,"_40":41,"_39":179,"_137":26,"_37":180,"_13":60,"_34":20,"_35":181,"_23":26,"_142":-5,"_27":182},{"_42":168,"_32":169,"_30":170,"_135":-5,"_40":41,"_39":171,"_137":26,"_37":172,"_13":173,"_34":150,"_35":174,"_23":26,"_142":-5,"_27":175},{"_42":161,"_32":162,"_30":163,"_135":-5,"_40":41,"_39":164,"_137":26,"_37":165,"_13":60,"_34":20,"_35":166,"_23":26,"_142":-5,"_27":167},{"_42":153,"_32":154,"_30":155,"_135":-5,"_40":41,"_39":156,"_137":26,"_37":157,"_13":158,"_34":20,"_35":159,"_23":26,"_142":-5,"_27":160},{"_42":144,"_32":145,"_30":146,"_135":-5,"_40":41,"_39":147,"_137":26,"_37":148,"_13":149,"_34":150,"_35":151,"_23":26,"_142":-5,"_27":152},{"_42":132,"_32":133,"_30":134,"_135":-5,"_40":41,"_39":136,"_137":26,"_37":138,"_13":139,"_34":140,"_35":141,"_23":26,"_142":-5,"_27":143},"49fe994a-c6c5-11f0-872d-42dde27851f2","script.js","d0681f5c-c6bf-11f0-a681-42dde27851f2","parentId",45,"latest",["D",1763721110068],5,"script","import { DiscordSDK } from \"/Users/shujiang/Downloads/embedded-app-sdk-main\";\n\ndocument.body.append('

vgbhjnb hj

');\n// Will eventually store the authenticated user's access_token\nlet auth;\n\nconst discordSdk = new DiscordSDK(import.meta.env.VITE_DISCORD_CLIENT_ID);\n\nsetupDiscordSdk().then(() => {\n console.log(\"Discord SDK is authenticated\");\n\n // We can now make API calls within the scopes we requested in setupDiscordSDK()\n // Note: the access_token returned is a sensitive secret and should be treated as such\n});\n\nasync function setupDiscordSdk() {\n await discordSdk.ready();\n console.log(\"Discord SDK is ready\");\n\n // Authorize with Discord Client\n const { code } = await discordSdk.commands.authorize({\n client_id: import.meta.env.VITE_DISCORD_CLIENT_ID,\n response_type: \"code\",\n state: \"\",\n prompt: \"none\",\n scope: [\n \"identify\",\n \"guilds\",\n \"applications.commands\",\n ],\n });\n\n // Retrieve an access_token from your activity's server\n const response = await fetch(\"/api/token\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n code,\n }),\n });\n const { access_token } = await response.json();\n\n // Authenticate with Discord client (using the access_token)\n auth = await discordSdk.commands.authenticate({\n access_token,\n });\n\n if (auth == null) {\n throw new Error(\"Authenticate command failed\");\n }\n}\n\ndocument.querySelector(\"#app\").innerHTML = `\n

Hello, World!

\n`;","label",[133],"9dc80530-c692-11f0-a485-42dde27851f2","main.ts","6b9e6e46-c68d-11f0-90e3-42dde27851f2",12,["D",1763699346307],11,"http","// Learn more: https://docs.val.town/vals/http/\n\nimport { fetch } from \"https://esm.town/v/std/fetch\";\n\nconst clientId = Deno.env.get(\"VITE_DISCORD_CLIENT_ID\");\nconst clientSecret = Deno.env.get(\"DISCORD_CLIENT_SECRET\");\n\nexport default async function (req: Request): Promise {\n if (req.method == \"GET\") {\n return new Response(\"Hello, world!\");\n }\n if (req.method == \"POST\") {\n const body = await req.json();\n console.log(body);\n const url = new URL(req.url);\n // Access the pathname property\n const pathname = url.pathname;\n if (pathname == \"/api/token\") {\n console.log(\"efdcs\");\n // Exchange the code for an access_token\n const response = await fetch(`https://discord.com/api/oauth2/token`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n client_id: clientId,\n client_secret: clientSecret,\n grant_type: \"authorization_code\",\n code: body.code,\n }),\n });\n const { access_token } = await response.json();\n return new Response(JSON.stringify({ access_token }));\n }\n return new Response(\"sd\");\n }\n}",[145],"cecfe6ec-c6c0-11f0-9cec-42dde27851f2","index.html","e1fb4b54-c6bf-11f0-b224-42dde27851f2",39,["D",1763719185411],6,"\n\n \n \n \n \n Hello, World\n \n \n

btrgefdsvgrtrf

\n \n \n",[154],"49c06184-c6c5-11f0-872d-42dde27851f2","deno.json","49c0621a-c6c5-11f0-872d-42dde27851f2",43,["D",1763721109648],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[162],"92800730-c6c0-11f0-ac0a-42dde27851f2","client.ts","a20dd4ee-c692-11f0-bc7b-42dde27851f2",37,["D",1763719084230],16,"// Learn more: https://docs.val.town/vals/http/\n\nimport { DiscordSDK } from \"npm:@discord/embedded-app-sdk\";\nlet car = \"car\";\nconst clientId = Deno.env.get(\"VITE_DISCORD_CLIENT_ID\");\nconst clientSecret = Deno.env.get(\"DISCORD_CLIENT_SECRET\");\nlet auth;\nexport default async function (req: Request): Promise {\n // Instantiate the SDK\n const discordSdk = new DiscordSDK(clientId);\n\n setupDiscordSdk().then(() => {\n console.log(\"Discord SDK is ready\");\n });\n\n async function setupDiscordSdk() {\n console.log(\"[gfgf\");\n await discordSdk.ready();\n car = \"dfc\";\n const { code } = await discordSdk.commands.authorize({\n client_id: clientId,\n response_type: \"code\",\n state: \"\",\n prompt: \"none\",\n scope: [\n \"identify\",\n \"guilds\",\n \"applications.commands\",\n ],\n });\n\n // Retrieve an access_token from your activity's server\n const response = await fetch(\n \"https://cookiemonster0921--6b9e6e46c68d11f090e342dde27851f2.web.val.run/api/token\",\n {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n code,\n }),\n },\n );\n car = \"uoio\";\n const { access_token } = await response.json();\n console.log(access_token);\n // Authenticate with Discord client (using the access_token)\n auth = await discordSdk.commands.authenticate({\n access_token,\n });\n if (auth == null) {\n throw new Error(\"Authenticate command failed\");\n }\n }\n const response = await fetch(\n \"https://esm.town/v/cookiemonster0921/discordActivity/index.html\",\n );\n\n if (!response.ok) {\n throw new Error(`HTTP error! status: ${response.status}`);\n }\n\n const htmlContent = await response.text();\n\n return new Response(htmlContent, {\n status: 200,\n headers: {\n \"Content-Type\": \"text/html\",\n \"Access-Control-Allow-Origin\": \"*\",\n },\n });\n}",[169],"49c3286a-c6c5-11f0-99d9-42dde27851f2","AGENTS.md","49c3293c-c6c5-11f0-99d9-42dde27851f2",44,["D",1763721109647],"You are an advanced assistant specialized in generating Val Town code.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript or TSX\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious operations)\n- Follow modern ES6+ conventions and functional programming practices if possible\n\n## Types of triggers\n\n### 1. HTTP Trigger\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\nFiles that are HTTP triggers have http in their name like `foobar.http.tsx`\n\n### 2. Cron Triggers\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\nFiles that are Cron triggers have cron in their name like `foobar.cron.tsx`\n\n### 3. Email Triggers\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\nFiles that are Email triggers have email in their name like `foobar.email.tsx`\n\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nconst TABLE_NAME = 'todo_app_users_2';\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(`SELECT * FROM ${TABLE_NAME} WHERE id = ?`, [1]);\n```\n\nNote: When changing a SQLite table's schema, change the table's name (e.g., add _2 or _3) to create a fresh table.\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({ \n subject: \"Hi\", \n text: \"Hi\", \n html: \"

Hi

\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\" urls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's *extremely importing* to note that `parseProject` and other Standard Library utilities ONLY RUN ON THE SERVER.\nIf you need access to this data on the client, run it in the server and pass it to the client by splicing it into the HTML page\nor by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use: `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **View Source:** Add a view source link by importing & using `import.meta.url.replace(\"ems.sh\", \"val.town)\"` (or passing this data to the client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add `` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n \n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n \n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n \n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n \n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:** \n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n",[177],"49bcfbde-c6c5-11f0-8b53-42dde27851f2",".vtignore","49bcfc88-c6c5-11f0-8b53-42dde27851f2",42,["D",1763721109640],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[184],"9147a318-c6c6-11f0-8d26-42dde27851f2","embedded-app-sdk-main","9147a3fe-c6c6-11f0-8d26-42dde27851f2",46,["D",1763721659166],"directory",[191],"pulls","branches",1,"forks","envVars",{"_205":207,"_208":60},"connections",{"_205":60,"_206":60},"count","unfilledCount",2,"emptyCount",{"_42":190,"_32":191,"_30":192,"_135":-5,"_40":41,"_39":193,"_137":26,"_37":427,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":428,"_27":429},{"_42":422,"_32":421,"_30":416,"_135":192,"_40":41,"_39":423,"_137":26,"_37":424,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":425,"_27":426},{"_42":413,"_32":414,"_30":415,"_135":416,"_40":41,"_39":417,"_137":26,"_37":418,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":419,"_27":420},{"_42":408,"_32":399,"_30":393,"_135":192,"_40":41,"_39":409,"_137":26,"_37":410,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":411,"_27":412},{"_42":400,"_32":401,"_30":402,"_135":393,"_40":41,"_39":403,"_137":26,"_37":404,"_13":60,"_34":20,"_35":405,"_23":26,"_142":-5,"_241":406,"_27":407},{"_42":390,"_32":391,"_30":392,"_135":393,"_40":41,"_39":394,"_137":26,"_37":395,"_13":60,"_34":20,"_35":396,"_23":26,"_142":-5,"_241":397,"_27":398},{"_42":383,"_32":384,"_30":385,"_135":192,"_40":41,"_39":386,"_137":26,"_37":387,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":388,"_27":389},{"_42":378,"_32":365,"_30":359,"_135":192,"_40":41,"_39":379,"_137":26,"_37":380,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":381,"_27":382},{"_42":370,"_32":371,"_30":372,"_135":359,"_40":41,"_39":373,"_137":26,"_37":374,"_13":60,"_34":20,"_35":375,"_23":26,"_142":-5,"_241":376,"_27":377},{"_42":366,"_32":33,"_30":31,"_135":359,"_40":41,"_39":14,"_137":26,"_37":367,"_13":60,"_34":20,"_35":36,"_23":26,"_142":-5,"_241":368,"_27":369},{"_42":356,"_32":357,"_30":358,"_135":359,"_40":41,"_39":360,"_137":26,"_37":361,"_13":60,"_34":20,"_35":362,"_23":26,"_142":-5,"_241":363,"_27":364},{"_42":349,"_32":350,"_30":351,"_135":192,"_40":41,"_39":352,"_137":26,"_37":353,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":354,"_27":355},{"_42":342,"_32":343,"_30":344,"_135":192,"_40":41,"_39":345,"_137":26,"_37":346,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":347,"_27":348},{"_42":337,"_32":302,"_30":305,"_135":192,"_40":41,"_39":338,"_137":26,"_37":339,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":340,"_27":341},{"_42":331,"_32":295,"_30":332,"_135":305,"_40":41,"_39":333,"_137":26,"_37":334,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":335,"_27":336},{"_42":324,"_32":325,"_30":326,"_135":305,"_40":41,"_39":327,"_137":26,"_37":328,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":329,"_27":330},{"_42":317,"_32":318,"_30":319,"_135":305,"_40":41,"_39":320,"_137":26,"_37":321,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":322,"_27":323},{"_42":310,"_32":311,"_30":312,"_135":305,"_40":41,"_39":313,"_137":26,"_37":314,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":315,"_27":316},{"_42":304,"_32":303,"_30":297,"_135":305,"_40":41,"_39":306,"_137":26,"_37":307,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":308,"_27":309},{"_42":294,"_32":295,"_30":296,"_135":297,"_40":41,"_39":298,"_137":26,"_37":299,"_13":60,"_34":195,"_35":-5,"_23":26,"_142":-5,"_241":300,"_27":301},{"_42":286,"_32":287,"_30":288,"_135":192,"_40":41,"_39":289,"_137":26,"_37":290,"_13":60,"_34":20,"_35":291,"_23":26,"_142":-5,"_241":292,"_27":293},{"_42":278,"_32":279,"_30":280,"_135":192,"_40":41,"_39":281,"_137":26,"_37":282,"_13":60,"_34":20,"_35":283,"_23":26,"_142":-5,"_241":284,"_27":285},{"_42":270,"_32":271,"_30":272,"_135":192,"_40":41,"_39":273,"_137":26,"_37":274,"_13":60,"_34":20,"_35":275,"_23":26,"_142":-5,"_241":276,"_27":277},{"_42":262,"_32":263,"_30":264,"_135":192,"_40":41,"_39":265,"_137":26,"_37":266,"_13":60,"_34":20,"_35":267,"_23":26,"_142":-5,"_241":268,"_27":269},{"_42":183,"_32":184,"_30":185,"_135":-5,"_40":41,"_39":186,"_137":26,"_37":259,"_13":60,"_34":20,"_35":188,"_23":26,"_142":-5,"_241":260,"_27":261},{"_42":176,"_32":177,"_30":178,"_135":-5,"_40":41,"_39":179,"_137":26,"_37":256,"_13":60,"_34":20,"_35":181,"_23":26,"_142":-5,"_241":257,"_27":258},{"_42":168,"_32":169,"_30":170,"_135":-5,"_40":41,"_39":171,"_137":26,"_37":253,"_13":173,"_34":150,"_35":174,"_23":26,"_142":-5,"_241":254,"_27":255},{"_42":161,"_32":162,"_30":163,"_135":-5,"_40":41,"_39":164,"_137":26,"_37":250,"_13":60,"_34":20,"_35":166,"_23":26,"_142":-5,"_241":251,"_27":252},{"_42":153,"_32":154,"_30":155,"_135":-5,"_40":41,"_39":156,"_137":26,"_37":247,"_13":158,"_34":20,"_35":159,"_23":26,"_142":-5,"_241":248,"_27":249},{"_42":144,"_32":145,"_30":146,"_135":-5,"_40":41,"_39":147,"_137":26,"_37":244,"_13":149,"_34":150,"_35":151,"_23":26,"_142":-5,"_241":245,"_27":246},{"_42":132,"_32":133,"_30":134,"_135":-5,"_40":41,"_39":136,"_137":26,"_37":240,"_13":139,"_34":140,"_35":141,"_23":26,"_142":-5,"_241":242,"_27":243},["D",1763721110068],"children",[],[133],["D",1763699346307],[],[145],["D",1763719185411],[],[154],["D",1763721109648],[],[162],["D",1763719084230],[],[169],["D",1763721109647],[],[177],["D",1763721109640],[],[184],"93f4544e-c6c6-11f0-87e1-42dde27851f2","rollup.config.mjs","93f45502-c6c6-11f0-87e1-42dde27851f2",61,["D",1763721663651],"import typescript from '@rollup/plugin-typescript';\nimport {nodeResolve} from '@rollup/plugin-node-resolve';\nimport commonjs from '@rollup/plugin-commonjs';\nimport json from '@rollup/plugin-json';\nimport {join} from 'path';\n\nconst srcDir = join(__dirname, 'src');\nconst outDir = 'output';\n\n/**\n * Builds a rollup config for esm or cjs\n *\n * @type {(format: 'cjs' | 'esm') => import('rollup').RollupOptions}\n */\nfunction buildConfig(format) {\n return {\n //external: ['zod', 'lodash.transform', 'events', 'uuid'],\n input: 'src/index.ts',\n output: {\n dir: outDir,\n format,\n name: 'DiscordSDK',\n preserveModules: true,\n exports: 'named',\n entryFileNames(chunk) {\n const ext = format == 'cjs' ? 'cjs' : 'mjs';\n // Flatten src dir so output is `output/index.js`\n // instead of `ouput/src/index.js`.\n if (chunk.facadeModuleId.startsWith(srcDir)) {\n const name = chunk.name.replace(/^src\\//, '');\n return `${name}.${ext}`;\n }\n // Since node modules are bundled, renamed the output\n // directory so it doesn't clash with node_modules semantics.\n if (chunk.facadeModuleId.includes('node_modules/')) {\n const name = chunk.name\n .replaceAll('node_modules/', 'lib/')\n // Also remove the .npm prefix if present\n .replace('.npm/', '');\n return `${name}.${ext}`;\n }\n\n return `[name].${ext}`;\n },\n },\n plugins: [\n // i dont want to include the node modules\n // but it's causing issues\n nodeResolve({\n preferBuiltins: false,\n }),\n commonjs(),\n typescript({\n declaration: true,\n outDir: outDir,\n }),\n json(),\n ],\n };\n}\n\nexport default [buildConfig('cjs'), buildConfig('esm')];\n",[],[191,263],"941fce80-c6c6-11f0-adf8-42dde27851f2","renovate.json","941fcf20-c6c6-11f0-adf8-42dde27851f2",64,["D",1763721663938],"{\n \"$schema\": \"https://docs.renovatebot.com/renovate-schema.json\",\n \"extends\": [\n \"config:recommended\",\n \":disableDependencyDashboard\",\n \":preserveSemverRanges\"\n ],\n \"ignorePaths\": [\n \"**/node_modules/**\"\n ],\n \"packageRules\": [\n {\n \"matchPackagePatterns\": [\"colyseus\"],\n \"groupName\": \"colyseus\"\n }\n ]\n}\n",[],[191,271],"9404b852-c6c6-11f0-b245-42dde27851f2","LICENSE.md","9404b906-c6c6-11f0-b245-42dde27851f2",63,["D",1763721663667],"MIT License\n\nCopyright (c) 2024 Discord Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n",[],[191,279],"93f80b52-c6c6-11f0-9716-42dde27851f2","CHANGELOG.md","93f80bf2-c6c6-11f0-9716-42dde27851f2",62,["D",1763721663665],"# Changelog\n\n## [2.4.0](https://github.com/discord/embedded-app-sdk/compare/v2.3.1...v2.4.0) (2025-09-03)\n\n\n### Features\n\n* upgrade sync script and run it ([#336](https://github.com/discord/embedded-app-sdk/issues/336)) ([b284080](https://github.com/discord/embedded-app-sdk/commit/b284080a80545ed5a4c0f87d63e4961888c2c2ed))\n\n## [2.3.1](https://github.com/discord/embedded-app-sdk/compare/v2.3.0...v2.3.1) (2025-09-02)\n\n\n### Bug Fixes\n\n* properly export the quest commands ([#334](https://github.com/discord/embedded-app-sdk/issues/334)) ([e096ab4](https://github.com/discord/embedded-app-sdk/commit/e096ab40cb9a02156e8cbe2d9f208b315ac42a98))\n\n## [2.3.0](https://github.com/discord/embedded-app-sdk/compare/v2.2.0...v2.3.0) (2025-09-02)\n\n\n### Features\n\n* add Quests commands + event ([#329](https://github.com/discord/embedded-app-sdk/issues/329)) ([5a3b04f](https://github.com/discord/embedded-app-sdk/commit/5a3b04f8c1713c64724ed819de145b033a6214c4))\n\n\n### Bug Fixes\n\n* **deps:** update dependency uuid to v11 ([#275](https://github.com/discord/embedded-app-sdk/issues/275)) ([84735bd](https://github.com/discord/embedded-app-sdk/commit/84735bd85d02e4ef502722b69c9a8b4a3b1a57f7))\n* **patchUrlMappings:** fix double slash when rewriting urls with prefix ending in `/` ([#333](https://github.com/discord/embedded-app-sdk/issues/333)) ([2ebe536](https://github.com/discord/embedded-app-sdk/commit/2ebe536acc2c0e5e7ba34926d5e907cb18a455c3))\n\n## [2.2.0](https://github.com/discord/embedded-app-sdk/compare/v2.1.0...v2.2.0) (2025-08-05)\n\n\n### Features\n\n* add ACTIVITY_JOIN event ([#324](https://github.com/discord/embedded-app-sdk/issues/324)) ([9d9e155](https://github.com/discord/embedded-app-sdk/commit/9d9e155fb238779def00d53ca441947a024f7760))\n\n## [2.1.0](https://github.com/discord/embedded-app-sdk/compare/v2.0.0...v2.1.0) (2025-07-11)\n\n\n### Features\n\n* add state/details/large/small_url ([#319](https://github.com/discord/embedded-app-sdk/issues/319)) ([f81b623](https://github.com/discord/embedded-app-sdk/commit/f81b623234cda079e98aaab28458ec37b7e87005))\n\n## [2.0.0](https://github.com/discord/embedded-app-sdk/compare/v1.9.0...v2.0.0) (2025-03-27)\n\n\n### ⚠ BREAKING CHANGES\n\n* remove referrer_id from shareLink API ([#312](https://github.com/discord/embedded-app-sdk/issues/312))\n\n### Features\n\n* add activity invite command ([#305](https://github.com/discord/embedded-app-sdk/issues/305)) ([5d54cde](https://github.com/discord/embedded-app-sdk/commit/5d54cde51834229900f85c9aa2400c5b32eabd63))\n* add new GetRelationships command ([#301](https://github.com/discord/embedded-app-sdk/issues/301)) ([8bff274](https://github.com/discord/embedded-app-sdk/commit/8bff274ee5a9a987058fce01115c636505d8b81f))\n* add new GetUser command ([#308](https://github.com/discord/embedded-app-sdk/issues/308)) ([9aa310f](https://github.com/discord/embedded-app-sdk/commit/9aa310f3864aab435f351fdf120e28b800af3626))\n* add RELATIONSHIP_UPDATE event ([#306](https://github.com/discord/embedded-app-sdk/issues/306)) ([7d3b134](https://github.com/discord/embedded-app-sdk/commit/7d3b13486bac04821391045ff2cff5ff093c7310))\n* remove referrer_id from shareLink API ([#312](https://github.com/discord/embedded-app-sdk/issues/312)) ([1186ade](https://github.com/discord/embedded-app-sdk/commit/1186adeedb07ebb42ee5140a7e53defe71cd2e1a))\n\n\n### Bug Fixes\n\n* sync schema for shareLink command ([#311](https://github.com/discord/embedded-app-sdk/issues/311)) ([0f8855d](https://github.com/discord/embedded-app-sdk/commit/0f8855dec8613338b1dc161ab91153317e0f7e8b))\n\n## [1.9.0](https://github.com/discord/embedded-app-sdk/compare/v1.8.1...v1.9.0) (2025-01-09)\n\n\n### Features\n\n* add shareLink command ([#297](https://github.com/discord/embedded-app-sdk/issues/297)) ([effd59b](https://github.com/discord/embedded-app-sdk/commit/effd59b378cd969ba82551d95b35e6ac12532ad1))\n\n## [1.8.1](https://github.com/discord/embedded-app-sdk/compare/v1.8.0...v1.8.1) (2024-12-16)\n\n\n### Bug Fixes\n\n* add new params to IDiscordSDK ([#293](https://github.com/discord/embedded-app-sdk/issues/293)) ([6182474](https://github.com/discord/embedded-app-sdk/commit/618247414b6ae18e9c2fea5b58e2cb49bdeba354))\n\n## [1.8.0](https://github.com/discord/embedded-app-sdk/compare/v1.7.1...v1.8.0) (2024-12-16)\n\n\n### Features\n\n* add custom_id and referrer_id query params ([96777ac](https://github.com/discord/embedded-app-sdk/commit/96777ac976693309be9019657a60af4044765436))\n\n## [1.7.1](https://github.com/discord/embedded-app-sdk/compare/v1.7.0...v1.7.1) (2024-12-05)\n\n\n### Bug Fixes\n\n* don't infinitely set the src which triggers the mutation observer again ([#287](https://github.com/discord/embedded-app-sdk/issues/287)) ([7adc57e](https://github.com/discord/embedded-app-sdk/commit/7adc57e9aa020d8beac8839eb4da948d115fe40b))\n\n## [1.7.0](https://github.com/discord/embedded-app-sdk/compare/v1.6.1...v1.7.0) (2024-11-19)\n\n\n### Features\n\n* openExternalLink returns a `{ opened: boolean | null }` result ([#282](https://github.com/discord/embedded-app-sdk/issues/282)) ([d3bd375](https://github.com/discord/embedded-app-sdk/commit/d3bd375094735a5994f302a29f1845510cc7e045))\n* **locationId** added as SDK instance variable ([#281](https://github.com/discord/embedded-app-sdk/pull/281/files)) ([2cb879a](https://github.com/discord/embedded-app-sdk/commit/2cb879af80535b87d4a80cd98597f8ce3062f1cc))\n\n\n### Bug Fixes\n\n* **authorize:** remove token response type ([#273](https://github.com/discord/embedded-app-sdk/issues/273)) ([f45973b](https://github.com/discord/embedded-app-sdk/commit/f45973babc63dcd33281370b2db969c4cb1b38ca))\n\n## [1.6.1](https://github.com/discord/embedded-app-sdk/compare/v1.6.0...v1.6.1) (2024-10-21)\n\n\n### Bug Fixes\n\n* bump flag numbers to correct value ([#270](https://github.com/discord/embedded-app-sdk/issues/270)) ([61f4381](https://github.com/discord/embedded-app-sdk/commit/61f4381fa159a5d715c0db6f9be043702d54bcf3))\n\n## [1.6.0](https://github.com/discord/embedded-app-sdk/compare/v1.5.0...v1.6.0) (2024-10-21)\n\n\n### Features\n\n* extend Constants.Permissions to include all permission flags ([#268](https://github.com/discord/embedded-app-sdk/issues/268)) ([17a2012](https://github.com/discord/embedded-app-sdk/commit/17a2012812384bc6298babebfc619ea17a438b89))\n\n## [1.5.0](https://github.com/discord/embedded-app-sdk/compare/v1.4.3...v1.5.0) (2024-10-01)\n\n\n### Features\n\n* add sdk_version to HANDSHAKE message ([#262](https://github.com/discord/embedded-app-sdk/issues/262)) ([86a3a17](https://github.com/discord/embedded-app-sdk/commit/86a3a178b4fe37b6e1b8a8f6a719c7068a7ca326))\n\n## [1.4.3](https://github.com/discord/embedded-app-sdk/compare/v1.4.2...v1.4.3) (2024-09-20)\n\n\n### Bug Fixes\n\n* prevent multiple remappings from applying the .proxy path twice ([#252](https://github.com/discord/embedded-app-sdk/issues/252)) ([1c63d30](https://github.com/discord/embedded-app-sdk/commit/1c63d3043bd7ad79ee2b753a2765e01e97fa566c))\n\n## [1.4.2](https://github.com/discord/embedded-app-sdk/compare/v1.4.1...v1.4.2) (2024-08-13)\n\n\n### Bug Fixes\n\n* **patchUrlMappings:** recreate script elements when patching their src attribute ([#242](https://github.com/discord/embedded-app-sdk/issues/242)) ([b915ebf](https://github.com/discord/embedded-app-sdk/commit/b915ebf06620b0af758aeeed51a312bde7c42e74))\n\n## [1.4.1](https://github.com/discord/embedded-app-sdk/compare/v1.4.0...v1.4.1) (2024-07-30)\n\n\n### Bug Fixes\n\n* do not prepend PROXY_PREFIX if already prepends path ([#237](https://github.com/discord/embedded-app-sdk/issues/237)) ([c564b2d](https://github.com/discord/embedded-app-sdk/commit/c564b2dc26ee0f9d687bc22364d2e6677c49eff8))\n* prepend /.proxy to discord-starter-activity token fetch ([#233](https://github.com/discord/embedded-app-sdk/issues/233)) ([6e2cd1d](https://github.com/discord/embedded-app-sdk/commit/6e2cd1dda417b1790faae0d777d557ddfddf4c8f))\n\n## [1.4.0](https://github.com/discord/embedded-app-sdk/compare/v1.3.0...v1.4.0) (2024-07-10)\n\n\n### Features\n\n* add UPDATE_CURRENT_GUILD_MEMBER sdk hook and playground page ([#218](https://github.com/discord/embedded-app-sdk/issues/218)) ([d25deb2](https://github.com/discord/embedded-app-sdk/commit/d25deb298a03c69371b4a0deef7db20279b7e2a8))\n* rewrite requests through /.proxy/ using patchUrlMappings ([#222](https://github.com/discord/embedded-app-sdk/issues/222)) ([44787c5](https://github.com/discord/embedded-app-sdk/commit/44787c52a9611c0dcb9214d7deb49942687011bc))\n\n\n### Bug Fixes\n\n* **deps:** update dependency esbuild to ^0.23.0 ([#226](https://github.com/discord/embedded-app-sdk/issues/226)) ([63bf436](https://github.com/discord/embedded-app-sdk/commit/63bf436e763c001dc03a02969576aceff9b9425d))\n\n## [1.3.0](https://github.com/discord/embedded-app-sdk/compare/v1.2.0...v1.3.0) (2024-06-25)\n\n\n### Features\n\n* add applications.commands to OAuthScopes and use the type in authorize command ([#223](https://github.com/discord/embedded-app-sdk/issues/223)) ([d4d319d](https://github.com/discord/embedded-app-sdk/commit/d4d319d96377d6bfe1b082b7399ce51872e2e2a4))\n\n\n### Bug Fixes\n\n* **deps:** unpin big-integer and decimal.js-light ([#156](https://github.com/discord/embedded-app-sdk/issues/156)) ([860cd87](https://github.com/discord/embedded-app-sdk/commit/860cd874dc7ea21beec58a8adbf81661b910e80d))\n* **deps:** update dependency @types/uuid to v10 ([#221](https://github.com/discord/embedded-app-sdk/issues/221)) ([46cf04e](https://github.com/discord/embedded-app-sdk/commit/46cf04e89a21194eb15425d64a1ad3b1f25461a7))\n* **deps:** update dependency esbuild to v0.21.3 ([#198](https://github.com/discord/embedded-app-sdk/issues/198)) ([08e77ef](https://github.com/discord/embedded-app-sdk/commit/08e77ef4d80215611c87c5b981533890f8ee19e0))\n* **deps:** update dependency eventemitter3 to v5 ([#187](https://github.com/discord/embedded-app-sdk/issues/187)) ([2aa5971](https://github.com/discord/embedded-app-sdk/commit/2aa5971600d339e24aa0648358546b705600b095))\n* **deps:** update dependency uuid to v10 ([#217](https://github.com/discord/embedded-app-sdk/issues/217)) ([c7ffadf](https://github.com/discord/embedded-app-sdk/commit/c7ffadf83f927f8c671b0a8cb9424edcdb1101ec))\n* remove unavailable options from \"setActivity\" command ([#193](https://github.com/discord/embedded-app-sdk/issues/193)) ([e70decc](https://github.com/discord/embedded-app-sdk/commit/e70deccc7a473eda53f90d2c643e241dfe683b5b))\n\n## [1.2.0](https://github.com/discord/embedded-app-sdk/compare/v1.1.2...v1.2.0) (2024-04-23)\n\n\n### Features\n\n* add CommandInput and CommandResponse as types ([6f65ef3](https://github.com/discord/embedded-app-sdk/commit/6f65ef3c8c80c6aa603e9fc6fbc3d8f85dab9f72))\n\n\n### Bug Fixes\n\n* **deps:** update to uuid v9 ([#118](https://github.com/discord/embedded-app-sdk/issues/118)) ([a25bde1](https://github.com/discord/embedded-app-sdk/commit/a25bde13b3061590d549e4076f51b832f14507cc))\n\n## [1.1.2](https://github.com/discord/embedded-app-sdk/compare/v1.1.1...v1.1.2) (2024-04-04)\n\n\n### Bug Fixes\n\n* add back frameId to mock ([#97](https://github.com/discord/embedded-app-sdk/issues/97)) ([9a21ca2](https://github.com/discord/embedded-app-sdk/commit/9a21ca211802691efc503261306f5e9aa5e253ab))\n\n## [1.1.1](https://github.com/discord/embedded-app-sdk/compare/v1.1.0...v1.1.1) (2024-04-02)\n\n\n### Bug Fixes\n\n* remove unused frameId from mock ([#75](https://github.com/discord/embedded-app-sdk/issues/75)) ([facc2f3](https://github.com/discord/embedded-app-sdk/commit/facc2f3f96f6f56191d8f7311b6057f04eb8e02a))\n\n## [1.1.0](https://github.com/discord/embedded-app-sdk/compare/v1.0.0...v1.1.0) (2024-04-01)\n\n\n### Features\n\n* expose source and sourceOrigin class properties ([#66](https://github.com/discord/embedded-app-sdk/issues/66)) ([f1590b3](https://github.com/discord/embedded-app-sdk/commit/f1590b3980abff50a354c89be5e347fb9878d8d4))\n\n\n### Bug Fixes\n\n* remove unnecessary FILE_EXTENSION_REGEX check from matchAndRewriteURL ([#65](https://github.com/discord/embedded-app-sdk/issues/65)) ([4616621](https://github.com/discord/embedded-app-sdk/commit/46166212f12e07ba08886ceabfb28d8f1767adf9))\n* support ssr and non-browser environments ([#45](https://github.com/discord/embedded-app-sdk/issues/45)) ([2beca00](https://github.com/discord/embedded-app-sdk/commit/2beca00fa2f07be5a6c6837a95513e24c9de5c8d))\n",[],[191,287],"93c70a8e-c6c6-11f0-b0b2-42dde27851f2","__tests__","93c70b38-c6c6-11f0-b0b2-42dde27851f2","931a84bc-c6c6-11f0-adf8-42dde27851f2",60,["D",1763721663356],[],[191,302,303,295],"src","utils","931a8412-c6c6-11f0-adf8-42dde27851f2","92900864-c6c6-11f0-9297-42dde27851f2",56,["D",1763721662224],[228],[191,302,303],"93483ef2-c6c6-11f0-bb11-42dde27851f2","schema","93483f9c-c6c6-11f0-bb11-42dde27851f2",57,["D",1763721662524],[],[191,302,311],"92ec1c26-c6c6-11f0-adf8-42dde27851f2","generated","92ec1ce4-c6c6-11f0-adf8-42dde27851f2",55,["D",1763721661920],[],[191,302,318],"939d86aa-c6c6-11f0-b0b2-42dde27851f2","commands","939d879a-c6c6-11f0-b0b2-42dde27851f2",59,["D",1763721663084],[],[191,302,325],"9371f652-c6c6-11f0-adf8-42dde27851f2","9371f6fc-c6c6-11f0-adf8-42dde27851f2",58,["D",1763721662798],[],[191,302,295],"929006e8-c6c6-11f0-9297-42dde27851f2",53,["D",1763721661315],[223,224,225,226,227],[191,302],"9204de56-c6c6-11f0-8336-42dde27851f2","scripts","9204df50-c6c6-11f0-8336-42dde27851f2",50,["D",1763721660404],[],[191,343],"91d6b3c8-c6c6-11f0-89af-42dde27851f2","examples","91d6b4b8-c6c6-11f0-89af-42dde27851f2",49,["D",1763721660103],[],[191,350],"94614f4a-c6c6-11f0-b6a0-42dde27851f2","local-sdk-development.md","94615008-c6c6-11f0-b6a0-42dde27851f2","91a97c00-c6c6-11f0-94ab-42dde27851f2",68,["D",1763721664364],"# Local SDK development\n\nWhen developing the SDK locally, you can enable the SDK to rebuild \"on save\" by running `npm run dev`.\n\nWe recommend testing changes to the SDK against the SDK-Playground example, which can be found [here](https://github.com/discord/embedded-app-sdk-examples/tree/main/sdk-playground#testing-sdk-changes-locally).\n\n## JSON Schema updates\n\nIf you need to update any generated JSON schema values, follow the guide [here](/docs/schema-gen.md).\n",[],[191,365,357],"docs","9465c796-c6c6-11f0-a9de-42dde27851f2",["D",1763721664395],[],[191,365,33],"94314de0-c6c6-11f0-b6a0-42dde27851f2","activity-iframe-sdk-v2-migration.md","94314e8a-c6c6-11f0-b6a0-42dde27851f2",65,["D",1763721664052],"# V2 Migration\n\nVersion 2.0.0 represents a breaking change to the shape of the SDK. This document is aimed to help developers migrate their activity code from a v1 release to v2.0.0 and beyond.\n\nIf you are migrating from `@discord/activity-iframe-sdk` v2 to `@discord/embedded-app-sdk` v1 please see [this document](/docs/embedded-app-sdk-v1-migration.md) instead.\n\n# Command Migration\n\nThe primary change to the SDK in 2.0.0 is a standardization of the command return shape. Previously, a command could return the \"Paylod\" or the \"Data\", and each command was different. For example, `authorize` would return \"data\" but `getChannelPermissions` would return a \"Payload\".\n\n```ts\n// V1\n\n// \"Data\" command\nconst {code} = await sdk.commands.authorize();\n\n// \"Payload\" command\nconst {\n cmd,\n data: {permissions},\n evt,\n nonce,\n} = await discordSdk.commands.getChannelPermissions();\n```\n\nThe additional field of \"Payload\" commands are not useful for activity developers, and are used internally in the SDK. As such, we decided to make all commands \"Data\" commands, meaning in v2.0.0+ all commands simply return the desired data.\n\n```ts\n// V2\n\nconst {code} = await sdk.commands.authorize();\nconst {permissions} = await discordSdk.commands.getChannelPermissions();\n```\n\nAn additional benefit of standardization of commands is better type inference. Previously, return value of the command was not obvious, and often referenced `zod`, a library used in the SDK to parse messages sent across the IPC bridge. We made it easier for typescript and activity developers to understand what any command does by annontating the commands with `zod`-less, straightforward types. Let's use `getChannelPermissions` as an example again.\n\n```diff\n- (property) getChannelPermissions: TPayloadCommand // v1\n+ (property) getChannelPermissions: (args: void) => Promise<{ permissions: string | bigint;}> // v2\n```\n\nThe v1 shape is undecipherable, and references other enums and shapes from within the SDK. It is not even clear that `getChannelPermissions` is a function.\nThe v2 shape, on the other hand, is quite clear. `getChannelPermissions` is an async function which returns an object containing attribute `permissions` which is either a `string` or a `bigint`.\n\n# Step by Step Guide\n\nEach activity is implemented differently, but migrating to v2 from v1 should be straightforward with the use of typescript. Here is a simple outline of how we expect the migration should occur.\n\n1. Upgrade to 2.0.0 by updating `package.json` and installing (eg `yarn install`).\n2. Run typescript (`tsc`) and observe errors. Most of the errors will be about the shape of commands, as expected.\n3. Fix typescript errors. We expect most of not all typescript errors will be related to commands, and most of these will be fixed simply be removing `.data` from command responses (as now the response is the data) or changing the way the command response is deconstructed to simply deconstruct the data object.\n4. Perform another audit of command usage within your activity, to catch those that are potentially not covered by typescript.\n5. Perform a basic test of key functionality.\n6. Profit from having standardized command shapes and better types from here on out!\n\n## SDK Playground Example migration\n\nAs a real example, here are several examples' files migrated to 2.0.0 from v1.11.0 and this is a summary of all the changes required.\n\n```diff\nexamples/discord-activity-starter/packages/client/src/main.ts\n const {data: selectedVoiceChannel} = await discordSdk.commands.getSelectedVoiceChannel();\n+ const selectedVoiceChannel = await discordSdk.commands.getSelectedVoiceChannel();\n\nexamples/sdk-playground/packages/client/src/pages/CurrentGuild.tsx\n- const {data} = await discordSdk.commands.getSelectedVoiceChannel();\n- const guildId = data?.guild_id;\n+ const channel = await discordSdk.commands.getSelectedVoiceChannel();\n+ const guildId = channel?.guild_id;\n\nexamples/sdk-playground/packages/client/src/pages/EncourageHardwareAcceleration.tsx\n- const {data} = await discordSdk.commands.encourageHardwareAcceleration();\n- setHWAccEnabled(data?.enabled ?? null);\n+ const {enabled} = await discordSdk.commands.encourageHardwareAcceleration();\n+ setHWAccEnabled(enabled === true);\n\nexamples/sdk-playground/packages/client/src/pages/InAppPurchase.tsx\n- const skusResp = await discordSdk.commands.getSkus();\n- setRpcSkus(skusResp.data as Sku[]);\n+ const skus = await discordSdk.commands.getSkus();\n+ setRpcSkus(skus);\n\nexamples/sdk-playground/packages/client/src/pages/OpenInviteDialog.tsx\n- const { data: {permissions} } = await discordSdk.commands.getChannelPermissions();\n+ const {permissions} = await discordSdk.commands.getChannelPermissions();\n\nexamples/sdk-playground/packages/client/src/pages/PlatformBehaviors.tsx\n- const {data} = await discordSdk.commands.getPlatformBehaviors();\n- setPlatformBehaviors(data);\n+ const behaviors = await discordSdk.commands.getPlatformBehaviors();\n+ setPlatformBehaviors(behaviors);\n\nexamples/sdk-playground/packages/client/src/pages/VoiceSettings.tsx\n- const voiceSettingsResp = await discordSdk.commands.getVoiceSettings();\n- setVoiceSettings(voiceSettingsResp.data);\n+ const voiceSettings = await discordSdk.commands.getVoiceSettings();\n- setVoiceSettings(voiceSettings);\n```\n",[],[191,365,371],"91a97b2e-c6c6-11f0-94ab-42dde27851f2",48,["D",1763721659807],[217,218,219],[191,365],"925f83e2-c6c6-11f0-b0b2-42dde27851f2","assets","925f8482-c6c6-11f0-b0b2-42dde27851f2",52,["D",1763721660998],[],[191,384],"94386f94-c6c6-11f0-87e1-42dde27851f2","pre-commit","94387048-c6c6-11f0-87e1-42dde27851f2","917b26c0-c6c6-11f0-8d26-42dde27851f2",67,["D",1763721664086],"npx lint-staged\n",[],[191,399,391],".husky","9434e41e-c6c6-11f0-8b4c-42dde27851f2","commit-msg","9434e4b4-c6c6-11f0-8b4c-42dde27851f2",66,["D",1763721664068],"npx --no -- commitlint --edit $1\n",[],[191,399,401],"917b2602-c6c6-11f0-8d26-42dde27851f2",47,["D",1763721659496],[213,214],[191,399],"92bcad4c-c6c6-11f0-adf8-42dde27851f2","workflows","92bcadec-c6c6-11f0-adf8-42dde27851f2","9232b40c-c6c6-11f0-b0b2-42dde27851f2",54,["D",1763721661605],[],[191,421,414],".github","9232b358-c6c6-11f0-b0b2-42dde27851f2",51,["D",1763721660688],[211],[191,421],["D",1763721659166],[210,212,215,216,220,221,222,229,230,231,232],[191],["D",1763697114652],{"_94":93,"_101":97},{"_94":93,"_95":-5,"_96":97,"_18":53,"_98":99,"_100":26},{"_13":83,"_32":84,"_42":41,"_85":43,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":-5,"_91":44,"_92":93},"ctx",{"_76":-5,"_121":467,"_468":469,"_470":471,"_472":26,"_473":26,"_474":26,"_475":24,"_476":-5,"_477":-7,"_478":-7,"_479":60,"_480":26,"_481":26,"_482":-5,"_483":26,"_484":26,"_485":26,"_486":-5},"ENV",{"_438":439,"_440":441,"_442":84,"_443":444,"_445":446,"_447":448,"_449":450,"_451":452,"_453":454,"_455":456,"_457":458,"_459":460,"_461":462,"_463":464,"_465":466},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","518c05f2c13b243481ef29134a5672756425e459","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v69