[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_264":265,"_266":267},"routes/_app.x.$handle.$name",{"_98":97,"_33":47,"_106":88,"_27":107,"_13":14,"_108":-5,"_11":109,"_110":111,"_112":113,"_114":115,"_116":117,"_20":-5,"_118":-5,"_119":-5,"_120":25,"_121":122,"_123":124,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_45":46,"_33":47,"_40":48,"_49":-5,"_50":25,"_51":52,"_53":52,"_54":55,"_56":57,"_18":58,"_59":-5,"_60":25,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":-5,"_68":-5,"_69":-5,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":25},"version",46,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":30},"file",{"_31":32,"_33":34,"_35":36,"_37":39,"_40":41,"_42":14,"_43":44,"_24":25},"previous",{"_31":32,"_33":34,"_35":36,"_37":38},"deleted",false,"deletedHere","path","backend/config.ts","latestPath","backend/config.tsx","fileId","93716b3c-38f1-11f0-be20-9e149126039e","name","config.ts","fileType","script","content","// Configuration constants\nexport const CONFIG = {\n // The emoji that triggers ticket creation\n // For custom Discord emoji (:charmaine:): use the emoji name\n TARGET_EMOJI: \"nazar_amulet\",\n\n // For custom Discord emoji (:charmaine:): use the emoji name\n // TARGET_EMOJI: \"charmaine\",\n\n // Linear ticket settings\n LINEAR_LABEL_NAME: \"discord-import\",\n LINEAR_PRIORITY: 3, // 1=Urgent, 2=High, 3=Medium, 4=Low\n\n // Discord message link format\n DISCORD_MESSAGE_URL_FORMAT: \"https://discord.com/channels/{guild_id}/{channel_id}/{message_id}\",\n\n // Maximum title length for Linear tickets\n MAX_TITLE_LENGTH: 100,\n} as const;\n\n// Environment variable helpers\nexport function getRequiredEnv(key: string): string {\n const value = Deno.env.get(key);\n if (!value) {\n throw new Error(`Required environment variable ${key} is not set`);\n }\n return value;\n}\n\nexport function getOptionalEnv(key: string): string | undefined {\n return Deno.env.get(key);\n}","// Configuration constants\nexport const CONFIG = {\n // The emoji that triggers ticket creation\n // For custom Discord emoji (:charmaine:): use the emoji name\n TARGET_EMOJI: \"nazar_amulet\",\n\n // For custom Discord emoji (:charmaine:): use the emoji name\n // TARGET_EMOJI: \"charmaine\",\n\n // Linear ticket settings\n LINEAR_LABEL_NAME: \"discord-import\",\n LINEAR_PRIORITY: 3, // 1=Urgent, 2=High, 3=Medium, 4=Low\n\n // Discord message link format\n DISCORD_MESSAGE_URL_FORMAT: \"https://discord.com/channels/{guild_id}/{channel_id}/{message_id}\",\n\n // Maximum title length for Linear tickets\n MAX_TITLE_LENGTH: 100,\n} as const;\n\n// Environment variable helpers\nexport function getRequiredEnv(key: string): string {\n const value = Deno.env.get(key);\n if (!value) {\n throw new Error(`Required environment variable ${key} is not set`);\n }\n return value.trim(); // Remove any leading/trailing whitespace\n}\n\nexport function getOptionalEnv(key: string): string | undefined {\n return Deno.env.get(key);\n}","createdAt",["D",1748128998312],"branchVersion","branchId","5029d24c-38f1-11f0-8c84-9e149126039e","id","50294ac0-38f1-11f0-8c84-9e149126039e","Discord-to-Linear",["D",1748126953162],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Discord -> Linear ticket based on emoji reaction trigger","imageUrl","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/a224e9a9-100a-4f16-9647-f859d9b95b00/square512?exp=1789570799&sig=0a8b0de385672b41ef48c6cf790d4285ffed7fce7d912092c23f4e7b70e7e0d5","c156eb0e-8b9d-4104-a055-502e9a0eb441","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",2,"orgId","2019e55b-c541-4c51-bef0-008eef10ef88","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_98":97,"_105":101},"org",{"_98":97,"_99":-5,"_100":101,"_18":58,"_102":103,"_104":25},"branch",{"_13":87,"_33":88,"_45":44,"_89":46,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":47,"_96":97},"isOwned",178,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","charmaine","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJ4cFpFME5pSXNZamJNd296dlZSYVJ0OVF1RSJ9","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_45":46,"_33":47,"_40":260,"_49":-5,"_50":25,"_51":52,"_53":52,"_54":55,"_56":57,"_18":58,"_59":-5,"_60":25,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":-5,"_68":-5,"_69":-5,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":261,"_82":262,"_84":263,"_86":25},"tree",[195,200,202,203,204,205],"files",[195,196,197,198,199,200,201,202,203,204,205],"counts",{"_182":159,"_183":184,"_185":186,"_187":188,"_189":190},"contents",[129,130,131,132,133,134],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_45":177,"_33":178,"_31":179,"_138":-5,"_43":44,"_42":64,"_140":124,"_40":180,"_13":159,"_35":175,"_37":-5,"_24":25,"_144":-5,"_27":181},{"_45":170,"_33":171,"_31":172,"_138":-5,"_43":44,"_42":173,"_140":25,"_40":174,"_13":159,"_35":175,"_37":-5,"_24":25,"_144":-5,"_27":176},{"_45":162,"_33":163,"_31":164,"_138":-5,"_43":44,"_42":165,"_140":25,"_40":166,"_13":167,"_35":20,"_37":168,"_24":25,"_144":-5,"_27":169},{"_45":154,"_33":155,"_31":156,"_138":-5,"_43":44,"_42":157,"_140":25,"_40":158,"_13":159,"_35":20,"_37":160,"_24":25,"_144":-5,"_27":161},{"_45":146,"_33":147,"_31":148,"_138":-5,"_43":44,"_42":149,"_140":25,"_40":150,"_13":151,"_35":36,"_37":152,"_24":25,"_144":-5,"_27":153},{"_45":135,"_33":136,"_31":137,"_138":-5,"_43":44,"_42":139,"_140":25,"_40":141,"_13":64,"_35":142,"_37":143,"_24":25,"_144":-5,"_27":145},"ab9754e4-38f4-11f0-8a59-9e149126039e","setup-dashboard.ts","9ba4465c-38f2-11f0-b6a5-9e149126039e","parentId",29,"latest",["D",1748128395043],"http","import { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { DiscordAPI } from \"./backend/discord.ts\";\nimport { LinearAPI } from \"./backend/linear.ts\";\nimport { CONFIG, getRequiredEnv, getOptionalEnv } from \"./backend/config.ts\";\nimport { readFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Initialize APIs lazily to avoid startup errors\nlet discord: DiscordAPI | null = null;\nlet linear: LinearAPI | null = null;\n\nfunction getDiscordAPI(): DiscordAPI {\n if (!discord) {\n discord = new DiscordAPI();\n }\n return discord;\n}\n\nfunction getLinearAPI(): LinearAPI {\n if (!linear) {\n linear = new LinearAPI();\n }\n return linear;\n}\n\n// Serve the setup dashboard\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\n// API health check\napp.get(\"/health\", (c) => {\n return c.json({\n status: \"ok\",\n service: \"Discord to Linear Automation - Setup Dashboard\",\n timestamp: new Date().toISOString(),\n });\n});\n\n// Test endpoint to manually create a ticket\napp.post(\"/test-ticket\", async (c) => {\n try {\n const { message_id, channel_id, guild_id } = await c.req.json();\n \n if (!message_id || !channel_id) {\n return c.json({ error: \"message_id and channel_id are required\" }, 400);\n }\n\n // Fetch the message\n const message = await getDiscordAPI().getMessage(channel_id, message_id);\n \n // Generate Discord message URL\n const discordUrl = getDiscordAPI().formatMessageUrl(\n guild_id || \"DM\",\n channel_id,\n message_id\n );\n\n // Generate ticket title and description\n const title = getDiscordAPI().generateTicketTitle(message, CONFIG.MAX_TITLE_LENGTH);\n const description = getDiscordAPI().formatMessageContent(message, discordUrl);\n\n // Get Linear team ID\n const teamId = getRequiredEnv(\"LINEAR_TEAM_ID\");\n\n // Create Linear ticket\n const result = await getLinearAPI().createDiscordTicket(\n title,\n description,\n teamId,\n CONFIG.LINEAR_LABEL_NAME,\n CONFIG.LINEAR_PRIORITY\n );\n\n if (result.data.issueCreate.success) {\n const issue = result.data.issueCreate.issue;\n \n return c.json({\n success: true,\n ticket: {\n id: issue.identifier,\n title: issue.title,\n url: issue.url,\n },\n discord_message: discordUrl,\n });\n } else {\n throw new Error(\"Failed to create Linear ticket\");\n }\n\n } catch (error) {\n console.error(\"Error creating test ticket:\", error);\n return c.json({\n error: \"Internal server error\",\n message: error.message,\n }, 500);\n }\n});\n\n// Get Linear teams (helpful for setup)\napp.get(\"/linear-teams\", async (c) => {\n try {\n const teams = await getLinearAPI().getTeams();\n return c.json(teams.data.teams.nodes);\n } catch (error) {\n console.error(\"Error fetching Linear teams:\", error);\n return c.json({\n error: \"Failed to fetch teams\",\n message: error.message,\n }, 500);\n }\n});\n\n// Configuration info endpoint\napp.get(\"/config\", (c) => {\n return c.json({\n target_emoji: CONFIG.TARGET_EMOJI,\n linear_label: CONFIG.LINEAR_LABEL_NAME,\n linear_priority: CONFIG.LINEAR_PRIORITY,\n environment_variables: {\n discord_bot_token: !!getOptionalEnv(\"DISCORD_BOT_TOKEN\"),\n linear_api_key: !!getOptionalEnv(\"LINEAR_API_KEY\"),\n linear_team_id: !!getOptionalEnv(\"LINEAR_TEAM_ID\"),\n },\n discord_permissions_needed: \"2147549248\",\n discord_invite_url_template: \"https://discord.com/api/oauth2/authorize?client_id=YOUR_BOT_CLIENT_ID&permissions=2147549248&scope=bot\",\n });\n});\n\n// Test Discord message fetch endpoint\napp.post(\"/test-discord-message\", async (c) => {\n try {\n const { channel_id, message_id } = await c.req.json();\n \n if (!channel_id || !message_id) {\n return c.json({ error: \"channel_id and message_id are required\" }, 400);\n }\n\n // Test fetching the message\n const message = await getDiscordAPI().getMessage(channel_id, message_id);\n \n return c.json({\n success: true,\n message: {\n id: message.id,\n content: message.content,\n author: message.author.username,\n timestamp: message.timestamp,\n channel_id: message.channel_id,\n },\n permissions_check: \"If you can see this message data, your bot has the correct permissions!\"\n });\n \n } catch (error) {\n console.error(\"Error fetching Discord message:\", error);\n return c.json({\n error: \"Failed to fetch Discord message\",\n message: error.message,\n possible_causes: [\n \"Bot doesn't have 'Read Message History' permission\",\n \"Bot is not in the server/channel\",\n \"Invalid message or channel ID\",\n \"Bot token is incorrect\"\n ]\n }, 500);\n }\n});\n\nexport default app.fetch;","label",[136],"82a44320-38f5-11f0-bdf7-9e149126039e","discord-linear-automation.ts","9173385a-38f2-11f0-8c57-9e149126039e",44,["D",1748128755837],3,"import { discordWebhook } from \"https://esm.town/v/stevekrouse/discordWebhook\";\nimport { CONFIG, getRequiredEnv } from \"./backend/config.ts\";\nimport { DiscordAPI } from \"./backend/discord.ts\";\nimport { LinearAPI } from \"./backend/linear.ts\";\n\n// This is the main automation function that gets triggered by Discord reactions\nexport default discordWebhook(async (event) => {\n console.log(`📥 Received Discord event:`, JSON.stringify(event, null, 2));\n \n // Only process MESSAGE_REACTION_ADD events\n if (event.t !== \"MESSAGE_REACTION_ADD\") {\n console.log(`Ignoring event type: ${event.t}`);\n return;\n }\n\n const reactionEvent = event.d;\n console.log(`🎯 Processing reaction event:`, JSON.stringify(reactionEvent, null, 2));\n \n // Check if it's the target emoji\n console.log(`🔍 Checking emoji: \"${reactionEvent.emoji.name}\" vs target: \"${CONFIG.TARGET_EMOJI}\"`);\n console.log(`🔍 Full emoji object:`, JSON.stringify(reactionEvent.emoji, null, 2));\n \n // Check for multiple possible emoji names\n const isTargetEmoji = reactionEvent.emoji.name === CONFIG.TARGET_EMOJI || \n reactionEvent.emoji.name === \"🧿\" ||\n reactionEvent.emoji.name === \"charmaine\" ||\n reactionEvent.emoji.name === \"amulet\";\n \n if (!isTargetEmoji) {\n console.log(`Ignoring reaction: ${reactionEvent.emoji.name} (looking for ${CONFIG.TARGET_EMOJI}, 🧿, charmaine, or amulet)`);\n return;\n }\n\n console.log(`🧿 Target emoji detected on message ${reactionEvent.message_id} in channel ${reactionEvent.channel_id}`);\n\n try {\n // Initialize APIs\n const discord = new DiscordAPI();\n const linear = new LinearAPI();\n\n // Fetch the original message\n const message = await discord.getMessage(reactionEvent.channel_id, reactionEvent.message_id);\n\n // Generate Discord message URL\n const discordUrl = discord.formatMessageUrl(\n reactionEvent.guild_id || \"DM\",\n reactionEvent.channel_id,\n reactionEvent.message_id,\n );\n\n // Generate ticket title and description\n const title = discord.generateTicketTitle(message, CONFIG.MAX_TITLE_LENGTH);\n const description = discord.formatMessageContent(message, discordUrl);\n\n // Get Linear team ID\n const teamId = getRequiredEnv(\"LINEAR_TEAM_ID\");\n\n // Create Linear ticket\n const result = await linear.createDiscordTicket(\n title,\n description,\n teamId,\n CONFIG.LINEAR_LABEL_NAME,\n CONFIG.LINEAR_PRIORITY,\n );\n\n if (result.data.issueCreate.success) {\n const issue = result.data.issueCreate.issue;\n console.log(`✅ Created Linear ticket: ${issue.identifier} - ${issue.url}`);\n\n // Optionally, you could react to the original message to indicate success\n // or send a DM to the user who reacted\n\n return {\n success: true,\n ticket: {\n id: issue.identifier,\n title: issue.title,\n url: issue.url,\n },\n discord_message: discordUrl,\n };\n } else {\n throw new Error(\"Failed to create Linear ticket\");\n }\n } catch (error) {\n console.error(\"❌ Error processing Discord reaction:\", error);\n\n // You could optionally react with an error emoji or send a notification\n throw error;\n }\n});",[147],"dad3c028-38f2-11f0-a9bc-9e149126039e","USAGE.md","dad3c104-38f2-11f0-a9bc-9e149126039e",23,["D",1748127615300],0,"# How to Use the Discord to Linear Automation\n\n## 🎯 Overview\n\nThis automation automatically creates Linear tickets when team members react to Discord messages with the 🧿 emoji. It's perfect for capturing important discussions, bug reports, feature requests, or any message that needs to become a trackable task.\n\n## 🚀 Getting Started\n\n### Step 1: Set Up Environment Variables\n\nIn your Val Town environment, set these three required variables:\n\n1. **`DISCORD_BOT_TOKEN`**\n - Go to [Discord Developer Portal](https://discord.com/developers/applications)\n - Create a new application → Bot\n - Copy the bot token\n - Required permissions: \"Read Message History\" and \"Add Reactions\"\n\n2. **`LINEAR_API_KEY`**\n - Go to Linear → Settings → API\n - Create a Personal API key\n - Copy the key\n\n3. **`LINEAR_TEAM_ID`**\n - Use the setup dashboard to find your team ID\n - Or check Linear's URL when viewing your team\n\n### Step 2: Add Bot to Discord Server\n\n1. In Discord Developer Portal, go to OAuth2 → URL Generator\n2. Select \"bot\" scope\n3. Select permissions: \"Read Message History\", \"Add Reactions\"\n4. Use the generated URL to add the bot to your server\n\n### Step 3: Test the Setup\n\n1. Open the setup dashboard (`/setup-dashboard.ts`)\n2. Check that all environment variables show as \"Set\"\n3. Use the test form to create a ticket from any Discord message\n4. Verify the ticket appears in Linear\n\n## 📱 Daily Usage\n\n### Creating Tickets\n\n1. **Find a message** in Discord that needs to become a Linear ticket\n2. **React with 🧿** (the charmaine emoji)\n3. **Wait a moment** - the automation will:\n - Fetch the full message content\n - Create a Linear ticket with a descriptive title\n - Include the message content and a link back to Discord\n - Add the \"discord-import\" label\n\n### What Gets Included\n\nThe Linear ticket will contain:\n- **Title**: First 100 characters of the Discord message\n- **Description**: \n - Link to the original Discord message\n - Author information\n - Full message content\n - Any attachments or embeds\n- **Label**: \"discord-import\" (automatically created)\n- **Priority**: Medium (configurable)\n\n## 🔧 Customization\n\nEdit `/backend/config.ts` to customize:\n\n```typescript\nexport const CONFIG = {\n TARGET_EMOJI: \"🧿\", // Change the trigger emoji\n LINEAR_LABEL_NAME: \"discord-import\", // Change the label name\n LINEAR_PRIORITY: 3, // 1=Urgent, 2=High, 3=Medium, 4=Low\n MAX_TITLE_LENGTH: 100, // Maximum characters in ticket title\n} as const;\n```\n\n## 💡 Best Practices\n\n### When to Use the Automation\n\n✅ **Good use cases:**\n- Bug reports from users\n- Feature requests\n- Important discussions that need follow-up\n- Action items from meetings\n- Customer feedback\n- Technical issues\n\n❌ **Avoid for:**\n- Casual conversations\n- Already resolved issues\n- Duplicate reports (check Linear first)\n\n### Message Guidelines\n\nFor best results, ensure Discord messages:\n- Have clear, descriptive content\n- Include relevant context\n- Mention specific steps or requirements\n- Include screenshots/attachments when helpful\n\n### Team Workflow\n\n1. **Anyone can trigger**: Any team member can react with 🧿\n2. **Review tickets**: Regularly review \"discord-import\" labeled tickets\n3. **Triage and assign**: Move tickets to appropriate projects/assignees\n4. **Update status**: Remove the \"discord-import\" label once triaged\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n**\"Environment variable not set\" error:**\n- Check that all three environment variables are configured\n- Verify there are no extra spaces in the values\n\n**\"Discord API error\" messages:**\n- Verify the bot token is correct\n- Ensure the bot is in the Discord server\n- Check bot permissions include \"Read Message History\"\n\n**\"Linear API error\" messages:**\n- Verify the Linear API key is valid\n- Check that the team ID exists and you have access\n- Ensure the API key has permission to create issues\n\n**Tickets not being created:**\n- Check the automation logs for errors\n- Verify you're using the exact 🧿 emoji\n- Test with the setup dashboard first\n\n### Getting Help\n\n1. **Check the setup dashboard** for configuration status\n2. **Use the test form** to isolate issues\n3. **Check Val Town logs** for detailed error messages\n4. **Verify permissions** in both Discord and Linear\n\n## 📊 Monitoring\n\n### Track Usage\n\n- Monitor the \"discord-import\" label in Linear\n- Review automation logs in Val Town\n- Check for any failed ticket creations\n\n### Performance\n\n- The automation typically creates tickets within 5-10 seconds\n- Failed attempts are logged with detailed error messages\n- No rate limiting issues under normal usage\n\n## 🎉 Success Tips\n\n1. **Train your team** on when and how to use the 🧿 reaction\n2. **Set up Linear workflows** to handle imported tickets\n3. **Regular cleanup** of the \"discord-import\" label\n4. **Monitor for duplicates** before reacting to messages\n5. **Use descriptive Discord messages** for better ticket titles\n\n---\n\n**Need help?** Check the setup dashboard or review the automation logs in Val Town for detailed error information.",[155],"dedd56b0-38f3-11f0-a752-9e149126039e","README.md","89ac5e36-38f1-11f0-adc0-9e149126039e",28,["D",1748128051569],7,"# Discord to Linear Ticket Automation\n\nThis automation creates Linear tickets from Discord messages when they receive a specific emoji reaction (🧿 :charmaine:).\n\n## 🚀 Quick Start\n\n1. **Set environment variables**: Add `DISCORD_BOT_TOKEN`, `LINEAR_API_KEY`, and `LINEAR_TEAM_ID` to your Val Town environment\n2. **Create and add Discord bot**: Follow the setup instructions below\n3. **Test the integration**: Use the setup dashboard to verify everything works\n4. **Start using**: React to Discord messages with 🧿 to create tickets!\n\n## 📋 Environment Variables\n\nSet these in your Val Town environment:\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| `DISCORD_BOT_TOKEN` | Your Discord bot token | ✅ |\n| `LINEAR_API_KEY` | Your Linear API key | ✅ |\n| `LINEAR_TEAM_ID` | The Linear team ID where tickets should be created | ✅ |\n\n## 🔧 Setup Instructions\n\n### 1. Set Environment Variables\nIn your Val Town environment, add these 3 required variables:\n- `DISCORD_BOT_TOKEN` - Your Discord bot token\n- `LINEAR_API_KEY` - Your Linear API key\n- `LINEAR_TEAM_ID` - Your Linear team ID\n\n### 2. Create Discord Bot\n1. Go to [Discord Developer Portal](https://discord.com/developers/applications)\n2. Create a new application and bot\n3. Copy the bot token to `DISCORD_BOT_TOKEN`\n4. Enable these bot permissions:\n - Read Message History\n - Add Reactions\n\n### 3. Add Bot to Your Discord Server\n1. In Discord Developer Portal, go to OAuth2 → URL Generator\n2. Select \"bot\" scope\n3. Select the permissions mentioned above\n4. Use the generated URL to invite the bot to your server\n\n### 4. Get Linear API Key\n1. Go to Linear Settings → API\n2. Create a new Personal API key\n3. Copy it to `LINEAR_API_KEY`\n\n### 5. Find Your Linear Team ID\n1. Open the setup dashboard (`/setup-dashboard.ts`)\n2. Click \"Get Linear Teams\" button\n3. Copy your team ID to `LINEAR_TEAM_ID`\n\n### 6. Test the Setup\n1. Use the setup dashboard to verify all environment variables are set\n2. Test ticket creation with the built-in test form\n3. Try reacting to a Discord message with 🧿\n\n## ✅ No Webhook Setup Required!\nThis automation uses Val Town's built-in `discordWebhook` utility, so **no manual webhook configuration is needed**. The system automatically handles all Discord event processing.\n\n## 🎯 How It Works\n\n1. User reacts to a Discord message with the configured emoji (🧿)\n2. Val Town's Discord webhook automatically triggers the automation\n3. Service fetches the full message content\n4. Creates a Linear ticket with:\n - **Title**: First 100 characters of the message\n - **Description**: Full message content + link to Discord message\n - **Labels**: \"discord-import\"\n - **Priority**: Medium (configurable)\n\n## 📁 Project Structure\n\n```\n├── discord-linear-automation.ts # Main automation (uses discordWebhook)\n├── setup-dashboard.ts # Setup interface and testing tools\n├── backend/\n│ ├── discord.ts # Discord API integration\n│ ├── linear.ts # Linear API integration\n│ ├── config.ts # Configuration and constants\n│ └── types.ts # TypeScript type definitions\n├── frontend/\n│ └── index.html # Setup dashboard interface\n└── README.md\n```\n\n## 🔗 Key Files\n\n- **`discord-linear-automation.ts`** - The main automation that processes Discord reactions\n- **`setup-dashboard.ts`** - Web interface for configuration and testing\n- Use the setup dashboard to test ticket creation and verify your configuration\n\n## ⚙️ Configuration\n\nEdit `/backend/config.ts` to customize:\n- Target emoji (default: 🧿)\n- Linear label name (default: \"discord-import\")\n- Ticket priority (default: 3 = Medium)\n- Title length limit (default: 100 characters)\n\n## 🧪 Testing\n\n1. **Use the setup dashboard** (`/setup-dashboard.ts`) to:\n - Check configuration status\n - Test ticket creation with any Discord message\n - Get your Linear team IDs\n2. **Manual API testing**:\n ```bash\n curl -X POST https://your-setup-dashboard.web.val.run/test-ticket \\\n -H \"Content-Type: application/json\" \\\n -d '{\"message_id\": \"123\", \"channel_id\": \"456\", \"guild_id\": \"789\"}'\n ```\n3. **Live testing**: React to any Discord message with 🧿\n\n## 🔍 Troubleshooting\n\n1. **Check configuration status** on the setup dashboard\n2. **Verify environment variables** are set correctly in Val Town\n3. **Test Discord bot permissions** - ensure bot can read message history\n4. **Check Linear API key** has proper permissions to create issues\n5. **Use the test form** in the setup dashboard to isolate issues\n6. **Check Val Town logs** for detailed error messages\n\n### Common Issues\n\n- **Bot not responding**: Verify bot is in the server and has correct permissions\n- **API errors**: Check that environment variables are set without extra spaces\n- **Wrong emoji**: Make sure you're using the exact 🧿 emoji (not a similar one)\n\n## 🛠️ Development\n\nThe automation is built with:\n- **Val Town's discordWebhook utility** for Discord integration\n- **Hono** for the setup dashboard HTTP server\n- **Discord API v10** for message fetching\n- **Linear GraphQL API** for ticket creation\n- **TypeScript** for type safety\n- **TailwindCSS** for the frontend\n\n## 📝 Notes\n\n- Uses Val Town's built-in Discord webhook system (much simpler than manual webhooks!)\n- Only processes `MESSAGE_REACTION_ADD` events\n- Automatically creates the \"discord-import\" label if it doesn't exist\n- Handles both text messages and messages with attachments/embeds\n- Generates meaningful ticket titles from message content\n- Includes full context and links back to original Discord message\n\n## 🎉 Benefits of Using discordWebhook\n\n- ✅ **No manual webhook configuration** - Val Town handles all Discord integration\n- ✅ **Automatic Discord event handling** - Built-in processing for reactions\n- ✅ **Built-in error handling and retries** - Reliable message delivery\n- ✅ **Simplified deployment** - Just set environment variables and go\n- ✅ **Seamless Val Town integration** - Works perfectly with the platform\n- ✅ **No webhook URLs to manage** - Everything is handled automatically",[163],"e91374d6-38f1-11f0-9231-9e149126039e","frontend","17b5edd0-cef1-4b47-ad12-2db5891ce834",12,["D",1748127209707],"directory",[171],"8f5047ee-38f1-11f0-9c4d-9e149126039e","backend","dd4e68a6-5d3a-486e-9b6b-8f73795ac9b8",["D",1748127059110],[178],"pulls","branches",1,"forks",4,"envVars",{"_191":193,"_194":159},"connections",{"_191":159,"_192":159},"count","unfilledCount",5,"emptyCount",{"_45":177,"_33":178,"_31":179,"_138":-5,"_43":44,"_42":64,"_140":124,"_40":257,"_13":159,"_35":175,"_37":-5,"_24":25,"_144":-5,"_207":258,"_27":259},{"_45":252,"_33":34,"_31":32,"_138":179,"_43":44,"_42":14,"_140":25,"_40":253,"_13":254,"_35":36,"_37":39,"_24":25,"_144":-5,"_207":255,"_27":256},{"_45":245,"_33":246,"_31":247,"_138":179,"_43":44,"_42":186,"_140":25,"_40":248,"_13":159,"_35":36,"_37":249,"_24":25,"_144":-5,"_207":250,"_27":251},{"_45":237,"_33":238,"_31":239,"_138":179,"_43":44,"_42":240,"_140":25,"_40":241,"_13":184,"_35":36,"_37":242,"_24":25,"_144":-5,"_207":243,"_27":244},{"_45":230,"_33":231,"_31":232,"_138":179,"_43":44,"_42":64,"_140":25,"_40":233,"_13":159,"_35":36,"_37":234,"_24":25,"_144":-5,"_207":235,"_27":236},{"_45":170,"_33":171,"_31":172,"_138":-5,"_43":44,"_42":173,"_140":25,"_40":227,"_13":159,"_35":175,"_37":-5,"_24":25,"_144":-5,"_207":228,"_27":229},{"_45":219,"_33":220,"_31":221,"_138":172,"_43":44,"_42":222,"_140":25,"_40":223,"_13":193,"_35":20,"_37":224,"_24":25,"_144":-5,"_207":225,"_27":226},{"_45":162,"_33":163,"_31":164,"_138":-5,"_43":44,"_42":165,"_140":25,"_40":216,"_13":167,"_35":20,"_37":168,"_24":25,"_144":-5,"_207":217,"_27":218},{"_45":154,"_33":155,"_31":156,"_138":-5,"_43":44,"_42":157,"_140":25,"_40":213,"_13":159,"_35":20,"_37":160,"_24":25,"_144":-5,"_207":214,"_27":215},{"_45":146,"_33":147,"_31":148,"_138":-5,"_43":44,"_42":149,"_140":25,"_40":210,"_13":151,"_35":36,"_37":152,"_24":25,"_144":-5,"_207":211,"_27":212},{"_45":135,"_33":136,"_31":137,"_138":-5,"_43":44,"_42":139,"_140":25,"_40":206,"_13":64,"_35":142,"_37":143,"_24":25,"_144":-5,"_207":208,"_27":209},["D",1748128395043],"children",[],[136],["D",1748128755837],[],[147],["D",1748127615300],[],[155],["D",1748128051569],[],[163],"c9a42656-38f4-11f0-ab73-9e149126039e","index.html","e913597e-38f1-11f0-9231-9e149126039e",32,["D",1748128445454],"\n\n\n \n \n Discord to Linear Automation\n \n \n\n\n

🧿 Discord to Linear Automation

Automatically create Linear tickets from Discord messages with emoji reactions

\n\n

\n \n

\n ⚙️\n Configuration Status\n

\n \n

\n\n \n

\n 🔍\n Test Discord Permissions\n

\n \n

\n\n

\n \n

\n 🧪\n Test Ticket Creation\n

\n \n

\n\n \n

\n 📋\n Setup Instructions\n

\n \n

1. Environment Variables

Set these in your Val Town environment:

DISCORD_BOT_TOKEN - Your Discord bot token
LINEAR_API_KEY - Your Linear API key
LINEAR_TEAM_ID - The Linear team ID where tickets should be created

\n\n

2. Discord Bot Setup

🔑 Important: Use Permissions Integer 2147549248

\n When creating your bot invite URL, use this exact permissions integer: 2147549248\n

Go to Discord Developer Portal
Create a new application and bot
Copy the bot token to DISCORD_BOT_TOKEN
Go to OAuth2 → URL Generator
Select \"bot\" scope
Paste permissions integer: 2147549248
Use the generated URL to invite your bot to your Discord server

\n This permissions integer includes: View Channels, Read Message History, Add Reactions\n

\n\n

3. Discord Integration

✅ No webhook setup required!

\n This automation uses Val Town's built-in Discord webhook utility, so no manual webhook configuration is needed.\n Just ensure your bot is in the server and has the required permissions.\n

\n\n

4. Linear API Setup

Go to Linear Settings → API
Create a new Personal API key
Copy it to LINEAR_API_KEY
Find your team ID and set LINEAR_TEAM_ID

\n \n

\n\n

5. How It Works

\n Once configured, react to any Discord message with the 🧿 emoji and it will automatically create a Linear ticket with the message content and a link back to Discord.\n

\n\n \n\n",[],[171,220],["D",1748127209707],[201],[171],"8f5023fe-38f1-11f0-9c4d-9e149126039e","types.ts","8f5024b2-38f1-11f0-9c4d-9e149126039e",["D",1748127059110],"// Discord API Types\nexport interface DiscordUser {\n id: string;\n username: string;\n discriminator: string;\n avatar?: string;\n}\n\nexport interface DiscordMessage {\n id: string;\n channel_id: string;\n guild_id?: string;\n author: DiscordUser;\n content: string;\n timestamp: string;\n edited_timestamp?: string;\n attachments: DiscordAttachment[];\n embeds: DiscordEmbed[];\n}\n\nexport interface DiscordAttachment {\n id: string;\n filename: string;\n url: string;\n proxy_url: string;\n size: number;\n content_type?: string;\n}\n\nexport interface DiscordEmbed {\n title?: string;\n description?: string;\n url?: string;\n timestamp?: string;\n color?: number;\n}\n\nexport interface DiscordReactionAddEvent {\n user_id: string;\n channel_id: string;\n message_id: string;\n guild_id?: string;\n emoji: {\n id?: string;\n name: string;\n animated?: boolean;\n };\n}\n\nexport interface DiscordWebhookPayload {\n t: string; // event type\n d: DiscordReactionAddEvent;\n}\n\n// Linear API Types\nexport interface LinearIssueInput {\n title: string;\n description?: string;\n teamId: string;\n labelIds?: string[];\n priority?: number;\n}\n\nexport interface LinearIssue {\n id: string;\n identifier: string;\n title: string;\n url: string;\n createdAt: string;\n}\n\nexport interface LinearCreateIssueResponse {\n data: {\n issueCreate: {\n success: boolean;\n issue: LinearIssue;\n };\n };\n}\n\nexport interface LinearTeamsResponse {\n data: {\n teams: {\n nodes: Array<{\n id: string;\n name: string;\n key: string;\n }>;\n };\n };\n}",[],[178,231],"0b3b75be-38f6-11f0-8083-9e149126039e","linear.ts","a46290e2-38f1-11f0-9231-9e149126039e",45,["D",1748128984995],"import { LinearIssueInput, LinearCreateIssueResponse, LinearTeamsResponse } from \"./types.ts\";\nimport { getRequiredEnv } from \"./config.ts\";\n\nconst LINEAR_API_BASE = \"https://api.linear.app/graphql\";\n\nexport class LinearAPI {\n private apiKey: string;\n\n constructor() {\n this.apiKey = getRequiredEnv(\"LINEAR_API_KEY\");\n }\n\n private async makeRequest(query: string, variables?: any): Promise {\n const response = await fetch(LINEAR_API_BASE, {\n method: \"POST\",\n headers: {\n \"Authorization\": this.apiKey,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n query,\n variables,\n }),\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new Error(`Linear API error: ${response.status} ${response.statusText} - ${errorText}`);\n }\n\n const result = await response.json();\n \n if (result.errors) {\n throw new Error(`Linear GraphQL error: ${JSON.stringify(result.errors)}`);\n }\n\n return result;\n }\n\n async createIssue(input: LinearIssueInput): Promise {\n const mutation = `\n mutation IssueCreate($input: IssueCreateInput!) {\n issueCreate(input: $input) {\n success\n issue {\n id\n identifier\n title\n url\n createdAt\n }\n }\n }\n `;\n\n return this.makeRequest(mutation, { input });\n }\n\n async getTeams(): Promise {\n const query = `\n query Teams {\n teams {\n nodes {\n id\n name\n key\n }\n }\n }\n `;\n\n return this.makeRequest(query);\n }\n\n async findOrCreateLabel(teamId: string, labelName: string): Promise {\n // First, try to find existing label\n const findQuery = `\n query FindLabel($filter: IssueLabelFilter) {\n issueLabels(filter: $filter) {\n nodes {\n id\n name\n }\n }\n }\n `;\n\n const findResult = await this.makeRequest(findQuery, {\n filter: {\n name: { eq: labelName }\n }\n });\n\n const existingLabel = findResult.data.issueLabels.nodes.find(\n (label: any) => label.name === labelName\n );\n\n if (existingLabel) {\n return existingLabel.id;\n }\n\n // Create new label if it doesn't exist\n const createMutation = `\n mutation IssueLabelCreate($input: IssueLabelCreateInput!) {\n issueLabelCreate(input: $input) {\n success\n issueLabel {\n id\n name\n }\n }\n }\n `;\n\n const createResult = await this.makeRequest(createMutation, {\n input: {\n name: labelName,\n color: \"#7C3AED\", // Purple color for Discord imports\n }\n });\n\n if (!createResult.data.issueLabelCreate.success) {\n throw new Error(\"Failed to create Linear label\");\n }\n\n return createResult.data.issueLabelCreate.issueLabel.id;\n }\n\n async createDiscordTicket(\n title: string,\n description: string,\n teamId: string,\n labelName: string,\n priority: number = 3\n ): Promise {\n // Get or create the label\n const labelId = await this.findOrCreateLabel(teamId, labelName);\n\n const input: LinearIssueInput = {\n title,\n description,\n teamId,\n labelIds: [labelId],\n priority,\n };\n\n return this.createIssue(input);\n }\n}",[],[178,238],"9bfbf844-38f1-11f0-a83d-9e149126039e","discord.ts","9bfbf902-38f1-11f0-a83d-9e149126039e",["D",1748127080369],"import { DiscordMessage } from \"./types.ts\";\nimport { getRequiredEnv } from \"./config.ts\";\n\nconst DISCORD_API_BASE = \"https://discord.com/api/v10\";\n\nexport class DiscordAPI {\n private token: string;\n\n constructor() {\n this.token = getRequiredEnv(\"DISCORD_BOT_TOKEN\");\n }\n\n private async makeRequest(endpoint: string): Promise {\n const response = await fetch(`${DISCORD_API_BASE}${endpoint}`, {\n headers: {\n \"Authorization\": `Bot ${this.token}`,\n \"Content-Type\": \"application/json\",\n },\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new Error(`Discord API error: ${response.status} ${response.statusText} - ${errorText}`);\n }\n\n return response.json();\n }\n\n async getMessage(channelId: string, messageId: string): Promise {\n return this.makeRequest(`/channels/${channelId}/messages/${messageId}`);\n }\n\n async getChannel(channelId: string): Promise {\n return this.makeRequest(`/channels/${channelId}`);\n }\n\n async getGuild(guildId: string): Promise {\n return this.makeRequest(`/guilds/${guildId}`);\n }\n\n formatMessageUrl(guildId: string, channelId: string, messageId: string): string {\n return `https://discord.com/channels/${guildId}/${channelId}/${messageId}`;\n }\n\n formatMessageContent(message: DiscordMessage, discordUrl: string): string {\n let content = `**Original Discord Message:**\\n${discordUrl}\\n\\n`;\n \n content += `**Author:** ${message.author.username}#${message.author.discriminator}\\n`;\n content += `**Posted:** ${new Date(message.timestamp).toLocaleString()}\\n\\n`;\n \n if (message.content) {\n content += `**Message:**\\n${message.content}\\n\\n`;\n }\n\n if (message.attachments && message.attachments.length > 0) {\n content += `**Attachments:**\\n`;\n for (const attachment of message.attachments) {\n content += `- [${attachment.filename}](${attachment.url})\\n`;\n }\n content += \"\\n\";\n }\n\n if (message.embeds && message.embeds.length > 0) {\n content += `**Embeds:**\\n`;\n for (const embed of message.embeds) {\n if (embed.title) content += `Title: ${embed.title}\\n`;\n if (embed.description) content += `Description: ${embed.description}\\n`;\n if (embed.url) content += `URL: ${embed.url}\\n`;\n content += \"\\n\";\n }\n }\n\n return content;\n }\n\n generateTicketTitle(message: DiscordMessage, maxLength: number = 100): string {\n let title = message.content || \"Discord Message\";\n \n // Remove markdown and clean up\n title = title.replace(/[*_`~]/g, \"\");\n title = title.replace(/\\n/g, \" \");\n title = title.trim();\n \n // Truncate if too long\n if (title.length > maxLength) {\n title = title.substring(0, maxLength - 3) + \"...\";\n }\n \n // Fallback if empty\n if (!title || title === \"...\") {\n title = `Message from ${message.author.username}`;\n }\n \n return title;\n }\n}",[],[178,246],"132b0b40-38f6-11f0-8caa-9e149126039e",["D",1748128998312],10,[],[178,34],["D",1748127059110],[196,197,198,199],[178],["D",1748126953162],{"_98":97,"_105":101},{"_98":97,"_99":-5,"_100":101,"_18":58,"_102":103,"_104":25},{"_13":87,"_33":88,"_45":44,"_89":46,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":47,"_96":97},"ctx",{"_80":-5,"_126":297,"_298":299,"_300":301,"_302":25,"_303":25,"_304":25,"_305":124,"_306":-5,"_307":-7,"_308":-7,"_309":159,"_310":25,"_311":25,"_312":-5,"_313":25,"_314":25,"_315":25,"_316":-5},"ENV",{"_268":269,"_270":271,"_272":88,"_273":274,"_275":276,"_277":278,"_279":280,"_281":282,"_283":284,"_285":286,"_287":288,"_289":290,"_291":292,"_293":294,"_295":296},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","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 · v46