@basicbit/vrchat-mcp 0.1.0

package/dist/src/services/friends/match.js

@@ -0,0 +1,98 @@
+export function normalizeName(value) {
+    return value.trim().toLowerCase();
+}
+export function scoreNameMatch(query, candidate) {
+    if (!query || !candidate)
+        return null;
+    if (candidate === query)
+        return { score: 100, type: 'exact' };
+    if (candidate.startsWith(query))
+        return { score: 80, type: 'prefix' };
+    if (candidate.includes(query))
+        return { score: 60, type: 'contains' };
+    return null;
+}
+export function parseLocation(raw) {
+    if (!raw)
+        return { raw: null, type: 'unknown' };
+    if (raw === 'offline')
+        return { raw, type: 'offline' };
+    if (raw === 'private')
+        return { raw, type: 'private' };
+    if (raw === 'traveling')
+        return { raw, type: 'traveling' };
+    if (raw.startsWith('wrld_') && raw.includes(':')) {
+        const [worldId, rest] = raw.split(':');
+        const instanceId = rest?.split('~')[0] ?? rest;
+        const info = { raw, type: 'instance', worldId, instanceId };
+        const groupId = extractGroupId(raw);
+        const accessType = extractAccessType(raw);
+        const region = extractRegion(raw);
+        if (groupId)
+            info.groupId = groupId;
+        if (accessType)
+            info.accessType = accessType;
+        if (region)
+            info.region = region;
+        return info;
+    }
+    return { raw, type: 'unknown' };
+}
+function extractGroupId(raw) {
+    const match = /~group\(([^)]+)\)/i.exec(raw);
+    if (!match)
+        return undefined;
+    return match[1];
+}
+function extractAccessType(raw) {
+    if (raw.includes('~group(') || raw.includes('~groupAccessType'))
+        return 'group';
+    if (raw.includes('~private'))
+        return 'private';
+    if (raw.includes('~friends'))
+        return 'friends';
+    if (raw.includes('~hidden'))
+        return 'hidden';
+    if (raw.includes('~public'))
+        return 'public';
+    return raw.includes('~') ? 'custom' : undefined;
+}
+function extractRegion(raw) {
+    const match = /~region\(([^)]+)\)/i.exec(raw);
+    if (!match)
+        return undefined;
+    return match[1];
+}
+export function findFriendByNameOrId(friends, options) {
+    const { name, userId } = options;
+    if (userId) {
+        return friends.find((friend) => String(friend.id ?? '') === userId);
+    }
+    if (!name)
+        return undefined;
+    const targetName = normalizeName(name);
+    return friends.find((friend) => normalizeName(String(friend.displayName ?? '')) === targetName);
+}
+export function searchFriendsByName(friends, query) {
+    const normalizedQuery = normalizeName(query);
+    if (!normalizedQuery)
+        return [];
+    const matches = [];
+    for (const friend of friends) {
+        const displayName = typeof friend.displayName === 'string' ? friend.displayName : '';
+        const score = scoreNameMatch(normalizedQuery, normalizeName(displayName));
+        if (!score)
+            continue;
+        matches.push({
+            userId: String(friend.id ?? ''),
+            displayName,
+            location: typeof friend.location === 'string' ? friend.location : undefined,
+            status: typeof friend.status === 'string' ? friend.status : undefined,
+            matchScore: score.score,
+            matchType: score.type,
+        });
+    }
+    matches.sort((a, b) => b.matchScore - a.matchScore || a.displayName.localeCompare(b.displayName));
+    return matches;
+}
+//# sourceMappingURL=match.js.map

package/dist/src/services/friends/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../../../src/services/friends/match.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,SAAiB;IAEjB,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC9D,IAAI,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACtE,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAChD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACvD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACvD,IAAI,GAAG,KAAK,WAAW;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC3D,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC/C,MAAM,IAAI,GAAiB,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACpC,IAAI,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7C,IAAI,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,OAAO,CAAC;IAChF,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAY,EACZ,OAA2C;IAE3C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACjC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAA2B,EAAE,KAAa;IAC5E,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,eAAe;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,MAAM,KAAK,GAAG,cAAc,CAAC,eAAe,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;YAC/B,WAAW;YACX,QAAQ,EAAE,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YAC3E,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACrE,UAAU,EAAE,KAAK,CAAC,KAAK;YACvB,SAAS,EAAE,KAAK,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAClG,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/services/groups/allowlist.js

@@ -0,0 +1,19 @@
+import { getConfig } from '../../config/index.js';
+function getAllowlist() {
+    const entries = getConfig().groups.allowlist;
+    if (!entries || entries.length === 0)
+        return null;
+    return new Set(entries);
+}
+export function checkGroupAllowed(groupId) {
+    const allowlist = getAllowlist();
+    if (!allowlist)
+        return { ok: true };
+    if (allowlist.has(groupId))
+        return { ok: true };
+    return {
+        ok: false,
+        reason: `Group ${groupId} is not in groups.allowlist.`,
+    };
+}
+//# sourceMappingURL=allowlist.js.map

package/dist/src/services/groups/allowlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.js","sourceRoot":"","sources":["../../../../src/services/groups/allowlist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,SAAS,YAAY;IACnB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAChD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,SAAS,OAAO,8BAA8B;KACvD,CAAC;AACJ,CAAC"}

package/dist/src/services/groups/curated.js

@@ -0,0 +1,343 @@
+import { callReadOperationParsed } from '../api/client.js';
+import { buildCacheKey, cacheConfig, cacheManager } from '../cache.js';
+import { toGroupInstanceSummary, toGroupMemberSummary, toGroupPostSummary, toGroupSummary, } from '../../models/groups.js';
+import { getMonthKeys, monthKeyToDateTime, parseEventTime, parseIsoDate, toMonthDateTime, } from '../events/utils.js';
+const DEFAULT_GROUP_PAGE_SIZE = 50;
+const DEFAULT_GROUP_MAX_PAGES = 10;
+const DEFAULT_GROUP_MEMBER_PAGE_SIZE = 100;
+const DEFAULT_GROUP_MEMBER_MAX_PAGES = 100;
+const DEFAULT_GROUP_POSTS_PAGE_SIZE = 50;
+const DEFAULT_GROUP_POSTS_MAX_PAGES = 10;
+const DEFAULT_GROUP_EVENT_PAGE_SIZE = 50;
+const DEFAULT_GROUP_EVENT_MAX_PAGES = 10;
+export async function searchGroups(input) {
+    const query = input.query.trim();
+    const pageSize = typeof input.pageSize === 'number' ? Math.floor(input.pageSize) : DEFAULT_GROUP_PAGE_SIZE;
+    const maxPages = typeof input.maxPages === 'number' ? Math.floor(input.maxPages) : DEFAULT_GROUP_MAX_PAGES;
+    const maxItems = typeof input.maxItems === 'number' ? Math.floor(input.maxItems) : pageSize * maxPages;
+    const cacheKey = buildCacheKey('groups:search', { query, pageSize, maxPages, maxItems });
+    const tags = ['groups', `groups:search:${query.toLowerCase()}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const result = await callReadOperationParsed('searchGroups', { query }, {
+            page: {
+                enabled: true,
+                size: pageSize,
+                maxPages,
+                maxItems,
+            },
+        });
+        const groups = result.data
+            .map(toGroupSummary)
+            .filter((group) => Boolean(group));
+        return {
+            groups,
+            page: result.page,
+            truncated: result.page?.truncated ?? false,
+        };
+    });
+    return {
+        groups: value.groups,
+        page: value.page,
+        truncated: value.truncated,
+        stale,
+        pageSize,
+        maxPages,
+        maxItems,
+    };
+}
+export async function resolveGroupId(input) {
+    if (input?.groupId) {
+        return { ok: true, groupId: input.groupId, resolvedBy: 'id' };
+    }
+    const shortCode = typeof input?.shortCode === 'string' ? input.shortCode.trim() : '';
+    if (!shortCode) {
+        return {
+            ok: false,
+            reason: 'Provide groupId or shortCode.',
+            status: 'not_found',
+            nextSteps: ['vrchat_groups_search'],
+        };
+    }
+    const results = await searchGroups({ query: shortCode, pageSize: 25, maxPages: 2, maxItems: 50 });
+    const match = results.groups.find((group) => group.shortCode?.toLowerCase() === shortCode.toLowerCase());
+    if (!match) {
+        return {
+            ok: false,
+            reason: `No group found with shortCode "${shortCode}".`,
+            status: 'not_found',
+            nextSteps: ['vrchat_groups_search'],
+        };
+    }
+    return { ok: true, groupId: match.groupId, resolvedBy: 'shortCode' };
+}
+export async function getGroupProfile(groupId) {
+    const cacheKey = buildCacheKey('groups:profile', { groupId });
+    const tags = ['groups', `groups:${groupId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const result = await callReadOperationParsed('getGroup', { groupId });
+        const group = result.data ?? null;
+        return { group };
+    });
+    return { group: value.group, stale };
+}
+export async function listGroupMembers(groupId, input) {
+    const pageSize = typeof input.pageSize === 'number' ? Math.floor(input.pageSize) : DEFAULT_GROUP_MEMBER_PAGE_SIZE;
+    const maxPages = typeof input.maxPages === 'number' ? Math.floor(input.maxPages) : DEFAULT_GROUP_MEMBER_MAX_PAGES;
+    const maxItems = typeof input.maxItems === 'number' ? Math.floor(input.maxItems) : pageSize * maxPages;
+    const offset = typeof input.offset === 'number' ? Math.floor(input.offset) : 0;
+    const roleId = typeof input.roleId === 'string' ? input.roleId : undefined;
+    const sort = typeof input.sort === 'string' ? input.sort : undefined;
+    const cacheKey = buildCacheKey('groups:members', {
+        groupId,
+        roleId,
+        sort,
+        pageSize,
+        maxPages,
+        maxItems,
+        offset,
+    });
+    const tags = ['groups', `groups:${groupId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const result = await callReadOperationParsed('getGroupMembers', { groupId, roleId, sort, offset }, {
+            page: {
+                enabled: true,
+                size: pageSize,
+                maxPages,
+                maxItems,
+            },
+        });
+        const members = result.data
+            .map(toGroupMemberSummary)
+            .filter((member) => Boolean(member));
+        const byId = new Map();
+        for (const member of members) {
+            if (!byId.has(member.userId))
+                byId.set(member.userId, member);
+        }
+        return {
+            members: [...byId.values()],
+            page: result.page,
+            truncated: result.page?.truncated ?? false,
+        };
+    });
+    return {
+        members: value.members,
+        page: value.page,
+        truncated: value.truncated,
+        stale,
+    };
+}
+export async function listGroupPosts(groupId, input) {
+    const pageSize = typeof input.pageSize === 'number' ? Math.floor(input.pageSize) : DEFAULT_GROUP_POSTS_PAGE_SIZE;
+    const maxPages = typeof input.maxPages === 'number' ? Math.floor(input.maxPages) : DEFAULT_GROUP_POSTS_MAX_PAGES;
+    const maxItems = typeof input.maxItems === 'number' ? Math.floor(input.maxItems) : pageSize * maxPages;
+    const publicOnly = input.publicOnly === true;
+    const cacheKey = buildCacheKey('groups:posts', { groupId, pageSize, maxPages, maxItems, publicOnly });
+    const tags = ['groups', `groups:${groupId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const result = await callReadOperationParsed('getGroupPosts', { groupId, publicOnly }, {
+            page: {
+                enabled: true,
+                size: pageSize,
+                maxPages,
+                maxItems,
+            },
+        });
+        const posts = result.data
+            .map(toGroupPostSummary)
+            .filter((post) => Boolean(post));
+        return {
+            posts,
+            page: result.page,
+            truncated: result.page?.truncated ?? false,
+        };
+    });
+    return {
+        posts: value.posts,
+        page: value.page,
+        truncated: value.truncated,
+        stale,
+        pageSize,
+        maxPages,
+    };
+}
+export async function listGroupEvents(groupId, input) {
+    const dateInput = typeof input.date === 'string' ? input.date : undefined;
+    const parsedDate = dateInput ? parseIsoDate(dateInput) : null;
+    if (dateInput && !parsedDate) {
+        throw new Error('date must be a valid ISO date/time string.');
+    }
+    const monthDate = parsedDate ? toMonthDateTime(parsedDate) : undefined;
+    const pageSize = typeof input.pageSize === 'number' ? Math.floor(input.pageSize) : DEFAULT_GROUP_EVENT_PAGE_SIZE;
+    const maxPages = typeof input.maxPages === 'number' ? Math.floor(input.maxPages) : DEFAULT_GROUP_EVENT_MAX_PAGES;
+    const maxItems = typeof input.maxItems === 'number' ? Math.floor(input.maxItems) : pageSize * maxPages;
+    const cacheKey = buildCacheKey('groups:events:list', {
+        groupId,
+        date: dateInput ?? '',
+        pageSize,
+        maxPages,
+        maxItems,
+    });
+    const tags = ['groups', `groups:${groupId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const result = await callReadOperationParsed('getGroupCalendarEvents', { groupId, date: monthDate }, {
+            page: {
+                enabled: true,
+                size: pageSize,
+                maxPages,
+                maxItems,
+            },
+        });
+        const events = result.data;
+        return {
+            events,
+            page: result.page,
+            truncated: result.page?.truncated ?? false,
+        };
+    });
+    return {
+        events: value.events,
+        page: value.page,
+        truncated: value.truncated,
+        stale,
+        pageSize,
+        maxPages,
+        maxItems,
+        date: dateInput,
+    };
+}
+export async function getGroupEvent(groupId, input) {
+    const calendarId = typeof input.calendarId === 'string' ? input.calendarId.trim() : '';
+    if (!calendarId) {
+        throw new Error('calendarId is required.');
+    }
+    const cacheKey = buildCacheKey('groups:event', { groupId, calendarId });
+    const tags = ['groups', `groups:${groupId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const result = await callReadOperationParsed('getGroupCalendarEvent', { groupId, calendarId }, {});
+        const event = result.data ?? null;
+        return { event };
+    });
+    return { event: value.event ?? null, stale };
+}
+export async function getGroupNextEvent(groupId) {
+    const cacheKey = buildCacheKey('groups:event:next', { groupId });
+    const tags = ['groups', `groups:${groupId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const result = await callReadOperationParsed('getGroupNextCalendarEvent', { groupId }, {});
+        const event = result.data ?? null;
+        return { event };
+    });
+    return { event: value.event ?? null, stale };
+}
+export async function listGroupEventsUpcoming(groupId, input) {
+    const fromInput = parseIsoDate(input.from);
+    if (input.from && !fromInput) {
+        throw new Error('from must be a valid ISO date/time string.');
+    }
+    const fromDate = fromInput ?? new Date();
+    const windowHours = typeof input.windowHours === 'number' ? Math.floor(input.windowHours) : 168;
+    const toDate = new Date(fromDate.getTime() + windowHours * 60 * 60 * 1000);
+    const pageSize = typeof input.pageSize === 'number' ? Math.floor(input.pageSize) : DEFAULT_GROUP_EVENT_PAGE_SIZE;
+    const maxPages = typeof input.maxPages === 'number' ? Math.floor(input.maxPages) : DEFAULT_GROUP_EVENT_MAX_PAGES;
+    const maxItems = typeof input.maxItems === 'number' ? Math.floor(input.maxItems) : pageSize * maxPages;
+    const cacheKey = buildCacheKey('groups:events', {
+        groupId,
+        from: fromDate.toISOString(),
+        windowHours,
+        pageSize,
+        maxPages,
+        maxItems,
+    });
+    const tags = ['groups', `groups:${groupId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const dateKeys = getMonthKeys(fromDate, toDate);
+        const segments = [];
+        const collected = [];
+        const seenIds = new Set();
+        let truncated = false;
+        for (const date of dateKeys) {
+            const remaining = maxItems - collected.length;
+            if (remaining <= 0) {
+                truncated = true;
+                break;
+            }
+            const result = await callReadOperationParsed('getGroupCalendarEvents', { groupId, date: monthKeyToDateTime(date) }, {
+                page: {
+                    enabled: true,
+                    size: pageSize,
+                    maxPages,
+                    maxItems: remaining,
+                },
+            });
+            const data = result.data;
+            const filtered = data.filter((event) => {
+                const ts = parseEventTime(event.startsAt);
+                if (ts === null)
+                    return false;
+                return ts >= fromDate.getTime() && ts < toDate.getTime();
+            });
+            for (const event of filtered) {
+                const id = event.id;
+                if (typeof id === 'string') {
+                    if (seenIds.has(id))
+                        continue;
+                    seenIds.add(id);
+                }
+                collected.push(event);
+            }
+            if (result.page) {
+                segments.push({ date, page: result.page });
+            }
+            else {
+                segments.push({ date });
+            }
+            if (result.page?.truncated) {
+                truncated = true;
+            }
+        }
+        collected.sort((a, b) => {
+            const aTime = parseEventTime(a?.startsAt);
+            const bTime = parseEventTime(b?.startsAt);
+            if (aTime === null && bTime === null)
+                return 0;
+            if (aTime === null)
+                return 1;
+            if (bTime === null)
+                return -1;
+            return aTime - bTime;
+        });
+        const events = collected.slice(0, maxItems);
+        if (events.length < collected.length) {
+            truncated = true;
+        }
+        return { events, truncated, segments };
+    });
+    return {
+        events: value.events,
+        truncated: value.truncated,
+        stale,
+        segments: value.segments,
+        from: fromDate,
+        to: toDate,
+        windowHours,
+        pageSize,
+        maxPages,
+        maxItems,
+    };
+}
+export async function getGroupInstancesOverview(groupId, maxInstances) {
+    const cacheKey = buildCacheKey('groups:instances', { groupId });
+    const tags = ['groups', `groups:${groupId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, cacheConfig.groupsTtlMs, cacheConfig.groupsStaleTtlMs, tags, async () => {
+        const result = await callReadOperationParsed('getGroupInstances', { groupId });
+        const instances = result.data
+            .map(toGroupInstanceSummary)
+            .filter((instance) => Boolean(instance));
+        return { instances };
+    });
+    const instances = value.instances.slice(0, Math.max(1, maxInstances));
+    const totalMembers = instances.reduce((sum, entry) => sum + entry.memberCount, 0);
+    return { instances, stale, totalMembers };
+}
+//# sourceMappingURL=curated.js.map

package/dist/src/services/groups/curated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curated.js","sourceRoot":"","sources":["../../../../src/services/groups/curated.ts"],"names":[],"mappings":"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"}

package/dist/src/services/groups/index.js

@@ -0,0 +1,3 @@
+export * from './allowlist.js';
+export * from './curated.js';
+//# sourceMappingURL=index.js.map

package/dist/src/services/groups/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/groups/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/src/services/instances/curated.js

@@ -0,0 +1,80 @@
+import { checkGroupAllowed } from '../groups/allowlist.js';
+import { callWriteOperationParsed } from '../api/client.js';
+function resolveOwnerId(input) {
+    if (input.type === 'group') {
+        const groupId = input.groupId ?? input.ownerId ?? null;
+        if (!groupId) {
+            return { ok: false, reason: 'groupId (or ownerId) is required when type=group.' };
+        }
+        const allowed = checkGroupAllowed(groupId);
+        if (!allowed.ok) {
+            return { ok: false, reason: allowed.reason };
+        }
+        return { ok: true, ownerId: groupId };
+    }
+    if (input.groupId) {
+        return { ok: false, reason: 'groupId is only valid when type=group.' };
+    }
+    return { ok: true, ownerId: input.ownerId ?? null };
+}
+function applyOptionalFields(request, input) {
+    if (input.displayName)
+        request.displayName = input.displayName;
+    if (input.inviteOnly !== undefined)
+        request.inviteOnly = input.inviteOnly;
+    if (input.canRequestInvite !== undefined)
+        request.canRequestInvite = input.canRequestInvite;
+    if (input.queueEnabled !== undefined)
+        request.queueEnabled = input.queueEnabled;
+    if (input.ageGate !== undefined)
+        request.ageGate = input.ageGate;
+    if (input.calendarEntryId !== undefined)
+        request.calendarEntryId = input.calendarEntryId;
+    if (input.instancePersistenceEnabled !== undefined) {
+        request.instancePersistenceEnabled = input.instancePersistenceEnabled;
+    }
+    if (input.playerPersistenceEnabled !== undefined) {
+        request.playerPersistenceEnabled = input.playerPersistenceEnabled;
+    }
+    if (input.closedAt)
+        request.closedAt = input.closedAt;
+    if (input.hardClose !== undefined)
+        request.hardClose = input.hardClose;
+    if (input.contentSettings)
+        request.contentSettings = input.contentSettings;
+}
+function applyGroupFields(request, input) {
+    if (input.type === 'group') {
+        if (input.groupAccessType)
+            request.groupAccessType = input.groupAccessType;
+        if (input.roleIds)
+            request.roleIds = input.roleIds;
+        return { ok: true, request };
+    }
+    if (input.groupAccessType || input.roleIds) {
+        return { ok: false, reason: 'groupAccessType and roleIds only apply to group instances.' };
+    }
+    return { ok: true, request };
+}
+export function prepareInstanceCreate(input) {
+    const ownerResult = resolveOwnerId(input);
+    if (!ownerResult.ok)
+        return ownerResult;
+    const request = {
+        worldId: input.worldId,
+        type: input.type,
+        region: input.region,
+    };
+    if (ownerResult.ownerId)
+        request.ownerId = ownerResult.ownerId;
+    const groupFieldsResult = applyGroupFields(request, input);
+    if (!groupFieldsResult.ok)
+        return groupFieldsResult;
+    applyOptionalFields(request, input);
+    return { ok: true, request };
+}
+export async function createInstance(request) {
+    const result = await callWriteOperationParsed('createInstance', undefined, request);
+    return result.data ?? null;
+}
+//# sourceMappingURL=curated.js.map

package/dist/src/services/instances/curated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curated.js","sourceRoot":"","sources":["../../../../src/services/instances/curated.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAA2B,MAAM,kBAAkB,CAAC;AAUrF,SAAS,cAAc,CAAC,KAA0B;IAChD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC;QACvD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mDAAmD,EAAE,CAAC;QACpF,CAAC;QACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wCAAwC,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA8B,EAAE,KAA0B;IACrF,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC/D,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAC1E,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAC5F,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAChF,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACjE,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IACzF,IAAI,KAAK,CAAC,0BAA0B,KAAK,SAAS,EAAE,CAAC;QACnD,OAAO,CAAC,0BAA0B,GAAG,KAAK,CAAC,0BAA0B,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,CAAC,wBAAwB,KAAK,SAAS,EAAE,CAAC;QACjD,OAAO,CAAC,wBAAwB,GAAG,KAAK,CAAC,wBAAwB,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACtD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACvE,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;AAC7E,CAAC;AAED,SAAS,gBAAgB,CACvB,OAA8B,EAC9B,KAA0B;IAE1B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,eAAe;YAAE,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;QAC3E,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACnD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,4DAA4D,EAAE,CAAC;IAC7F,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAA0B;IAC9D,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC;IAExC,MAAM,OAAO,GAA0B;QACrC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;IAEF,IAAI,WAAW,CAAC,OAAO;QAAE,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAE/D,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3D,IAAI,CAAC,iBAAiB,CAAC,EAAE;QAAE,OAAO,iBAAiB,CAAC;IAEpD,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,gBAAgB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACpF,OAAO,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;AAC7B,CAAC"}

package/dist/src/services/instances/index.js

@@ -0,0 +1,3 @@
+export * from './curated.js';
+export * from './read.js';
+//# sourceMappingURL=index.js.map

package/dist/src/services/instances/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/instances/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/src/services/instances/read.js

@@ -0,0 +1,14 @@
+import { callReadOperationParsed } from '../api/client.js';
+import { buildCacheKey, cacheConfig, cacheManager } from '../cache.js';
+const INSTANCE_TTL_MS = cacheConfig.notificationsTtlMs;
+const INSTANCE_STALE_TTL_MS = cacheConfig.notificationsStaleTtlMs;
+export async function getInstanceDetails(worldId, instanceId) {
+    const cacheKey = buildCacheKey('instances:get', { worldId, instanceId });
+    const tags = ['instances', `instances:${worldId}`];
+    const { value, stale } = await cacheManager.getOrSetStale(cacheKey, INSTANCE_TTL_MS, INSTANCE_STALE_TTL_MS, tags, async () => {
+        const result = await callReadOperationParsed('getInstance', { worldId, instanceId });
+        return result.data ?? null;
+    });
+    return { instance: value, stale };
+}
+//# sourceMappingURL=read.js.map

package/dist/src/services/instances/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/services/instances/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAA0B,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,eAAe,GAAG,WAAW,CAAC,kBAAkB,CAAC;AACvD,MAAM,qBAAqB,GAAG,WAAW,CAAC,uBAAuB,CAAC;AAIlE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,UAAkB;IAElB,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,aAAa,OAAO,EAAE,CAAC,CAAC;IACnD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,aAAa,CACvD,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,IAAI,EACJ,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;IAC7B,CAAC,CACF,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC"}