calabasas 0.1.6 → 0.1.7

package/dist/index.js

@@ -2972,6 +2972,14 @@ function generateSchemaFile(sync) {
   syncedAt: v.number(),
 })
   .index("by_discord_id", ["discordId"]);`);
+    tables.push(`export const calabasasGuildAdmins = defineTable({
+  guildDiscordId: v.string(),
+  discordUserId: v.string(),
+  syncedAt: v.number(),
+})
+  .index("by_user", ["discordUserId"])
+  .index("by_guild", ["guildDiscordId"])
+  .index("by_user_guild", ["discordUserId", "guildDiscordId"]);`);
   }
   if (sync.channels) {
     tables.push(`export const calabasasChannels = defineTable({
@@ -3020,8 +3028,10 @@ function generateSchemaFile(sync) {
   .index("by_guild", ["guildDiscordId"]);`);
   }
   const tableNames = [];
-  if (sync.guilds)
+  if (sync.guilds) {
     tableNames.push("calabasasGuilds");
+    tableNames.push("calabasasGuildAdmins");
+  }
   if (sync.channels)
     tableNames.push("calabasasChannels");
   if (sync.roles)
@@ -3139,6 +3149,14 @@ var MEMBER_TYPE = `{
   roles?: string[];
   joinedAt?: string;
 }`;
+var GUILD_ADMIN_VALIDATOR = `v.object({
+    guildId: v.string(),
+    adminUserIds: v.array(v.string()),
+  })`;
+var GUILD_ADMIN_TYPE = `{
+  guildId: string;
+  adminUserIds: string[];
+}`;
 function generateGuildMutation() {
   return `export const syncGuild = internalMutation({
   args: {
@@ -3318,6 +3336,59 @@ function generateMemberMutation() {
   },
 });`;
 }
+function generateGuildAdminMutation() {
+  return `export const _syncGuildAdmins = internalMutation({
+  args: {
+    data: guildAdminValidator,
+  },
+  returns: v.null(),
+  handler: async (ctx, { data }) => {
+    // Delete all existing admin entries for this guild
+    const existing = await ctx.db
+      .query("calabasasGuildAdmins")
+      .withIndex("by_guild", (q) => q.eq("guildDiscordId", data.guildId))
+      .collect();
+
+    await Promise.all(existing.map((entry) => ctx.db.delete(entry._id)));
+
+    // Insert new admin entries
+    const now = Date.now();
+    await Promise.all(
+      data.adminUserIds.map((userId) =>
+        ctx.db.insert("calabasasGuildAdmins", {
+          guildDiscordId: data.guildId,
+          discordUserId: userId,
+          syncedAt: now,
+        })
+      )
+    );
+
+    return null;
+  },
+});`;
+}
+function generateGuildAdminPublicMutation() {
+  return `
+/**
+ * Public mutation called by Calabasas gateway.
+ * Validates secret and delegates to internal mutation.
+ */
+export const syncGuildAdmins = mutation({
+  args: {
+    secret: v.string(),
+    data: guildAdminValidator,
+  },
+  returns: v.null(),
+  handler: async (ctx, { secret, data }) => {
+    const expectedSecret = process.env.CALABASAS_SECRET;
+    if (!expectedSecret || secret !== expectedSecret) {
+      throw new Error("Invalid secret");
+    }
+    await ctx.runMutation(internal.calabasas.sync._syncGuildAdmins, { data });
+    return null;
+  },
+});`;
+}
 function generatePublicSyncMutation(type) {
   const capitalType = type.charAt(0).toUpperCase() + type.slice(1);
   return `
@@ -3353,9 +3424,13 @@ function generateSyncFile(sync) {
   const enabledTypes = [];
   if (sync.guilds) {
     validators.push(`const guildValidator = ${GUILD_VALIDATOR};`);
+    validators.push(`const guildAdminValidator = ${GUILD_ADMIN_VALIDATOR};`);
     types.push(`export type GuildSync = ${GUILD_TYPE};`);
+    types.push(`export type GuildAdminSync = ${GUILD_ADMIN_TYPE};`);
     internalMutations.push(generateInternalSyncMutation("guild", generateGuildMutation()));
+    internalMutations.push(generateGuildAdminMutation());
     publicMutations.push(generatePublicSyncMutation("guild"));
+    publicMutations.push(generateGuildAdminPublicMutation());
     enabledTypes.push("guild");
   }
   if (sync.channels) {
@@ -3870,7 +3945,18 @@ async function generate(options) {
     console.log("   });");
     console.log("");
     console.log("2. Re-export sync mutations in convex/discord.ts:");
-    console.log('   export { syncGuild, syncChannel, syncRole, syncMember } from "./calabasas/sync";');
+    const syncExports = [];
+    if (syncConfig.guilds) {
+      syncExports.push("syncGuild");
+      syncExports.push("syncGuildAdmins");
+    }
+    if (syncConfig.channels)
+      syncExports.push("syncChannel");
+    if (syncConfig.roles)
+      syncExports.push("syncRole");
+    if (syncConfig.members)
+      syncExports.push("syncMember");
+    console.log(`   export { ${syncExports.join(", ")} } from "./calabasas/sync";`);
     console.log("");
     console.log("3. Add CALABASAS_SECRET to your Convex environment variables");
     console.log("4. Create your event handler in convex/discord.ts");
@@ -3932,6 +4018,13 @@ When sync is enabled, Discord data is automatically mirrored to Convex:
 | Channels | \`calabasasChannels\` | Create, update, delete |
 | Roles | \`calabasasRoles\` | Create, update, delete |
 | Members | \`calabasasMembers\` | Join, update, leave |
+| Guild Admins | \`calabasasGuildAdmins\` | Guild create (reconnect) |
+
+#### Guild Admins Table
+
+\`calabasasGuildAdmins\` is a junction table that maps guild admins (users with ADMINISTRATOR permission or guild owners). Unlike other sync tables that store entity data, this is a many-to-many relationship table with fields: \`guildDiscordId\`, \`discordUserId\`, \`syncedAt\`.
+
+Indexed by \`by_user\`, \`by_guild\`, and \`by_user_guild\` — use \`by_user\` to find all guilds where a user is admin (e.g., for "mutual servers" queries). Automatically populated when \`sync.guilds\` is enabled; recomputed on every bot connect/reconnect.
 
 ### ⚠️ Schema Integration (Required)
 
@@ -3952,7 +4045,7 @@ Then re-export the sync mutations so the gateway can call them:
 
 \`\`\`typescript
 // convex/discord.ts
-export { syncGuild, syncChannel, syncRole, syncMember } from "./calabasas/sync";
+export { syncGuild, syncGuildAdmins, syncChannel, syncRole, syncMember } from "./calabasas/sync";
 \`\`\`
 
 Without this step, Convex will reject sync operations because the tables are not defined in the schema.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "calabasas",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "CLI for Calabasas - Discord Gateway as a Service for Convex",
   "type": "module",
   "bin": {