ludicord 2.2.5 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. package/README.md +8 -4
  2. package/dist/activity/game-loop.d.ts +16 -0
  3. package/dist/activity/game-loop.js +33 -0
  4. package/dist/activity/index.d.ts +12 -0
  5. package/dist/activity/index.js +6 -0
  6. package/dist/activity/lifecycle.d.ts +11 -0
  7. package/dist/activity/lifecycle.js +41 -0
  8. package/dist/activity/presence.d.ts +10 -0
  9. package/dist/activity/presence.js +15 -0
  10. package/dist/activity/query.d.ts +21 -0
  11. package/dist/activity/query.js +148 -0
  12. package/dist/activity/shared-state.d.ts +10 -0
  13. package/dist/activity/shared-state.js +100 -0
  14. package/dist/activity/storage.d.ts +16 -0
  15. package/dist/activity/storage.js +88 -0
  16. package/dist/api/runtime.d.ts +5 -2
  17. package/dist/api/runtime.js +53 -10
  18. package/dist/auth/client.d.ts +0 -1
  19. package/dist/auth/client.js +3 -5
  20. package/dist/auth/index.d.ts +0 -1
  21. package/dist/auth/index.js +0 -1
  22. package/dist/auth/server.d.ts +2 -1
  23. package/dist/auth/server.js +161 -16
  24. package/dist/auth/types.d.ts +5 -1
  25. package/dist/auth/types.js +0 -1
  26. package/dist/cli/index.d.ts +0 -1
  27. package/dist/cli/index.js +116 -19
  28. package/dist/cli/project-commands.d.ts +1 -5
  29. package/dist/cli/project-commands.js +14 -162
  30. package/dist/compiler/build.d.ts +10 -1
  31. package/dist/compiler/build.js +124 -16
  32. package/dist/compiler/bundle-report.d.ts +17 -0
  33. package/dist/compiler/bundle-report.js +60 -0
  34. package/dist/compiler/client-entry.d.ts +0 -1
  35. package/dist/compiler/client-entry.js +28 -4
  36. package/dist/compiler/client-tooling.d.ts +0 -1
  37. package/dist/compiler/client-tooling.js +8 -2
  38. package/dist/compiler/index.d.ts +3 -1
  39. package/dist/compiler/index.js +2 -1
  40. package/dist/compiler/scanner.d.ts +0 -1
  41. package/dist/compiler/scanner.js +59 -4
  42. package/dist/compiler/server-bundle.d.ts +1 -2
  43. package/dist/compiler/server-bundle.js +11 -2
  44. package/dist/compiler/type-generation.d.ts +0 -1
  45. package/dist/compiler/type-generation.js +2 -1
  46. package/dist/compiler/write-manifests.d.ts +0 -1
  47. package/dist/compiler/write-manifests.js +0 -1
  48. package/dist/config/defaults.d.ts +0 -1
  49. package/dist/config/defaults.js +14 -2
  50. package/dist/config/environment.d.ts +0 -1
  51. package/dist/config/environment.js +0 -1
  52. package/dist/config/index.d.ts +0 -1
  53. package/dist/config/index.js +0 -1
  54. package/dist/config/loader.d.ts +0 -1
  55. package/dist/config/loader.js +0 -1
  56. package/dist/config/project-root.d.ts +0 -1
  57. package/dist/config/project-root.js +0 -1
  58. package/dist/config/types.d.ts +25 -1
  59. package/dist/config/types.js +0 -1
  60. package/dist/discord/assets.d.ts +5 -0
  61. package/dist/discord/assets.js +29 -0
  62. package/dist/discord/data.d.ts +38 -2
  63. package/dist/discord/data.js +178 -11
  64. package/dist/discord/events.d.ts +28 -2
  65. package/dist/discord/events.js +109 -39
  66. package/dist/discord/index.d.ts +6 -5
  67. package/dist/discord/index.js +3 -3
  68. package/dist/discord/payload.d.ts +6 -0
  69. package/dist/discord/payload.js +5 -0
  70. package/dist/discord/runtime.d.ts +0 -1
  71. package/dist/discord/runtime.js +0 -1
  72. package/dist/discord/safe-area.d.ts +0 -1
  73. package/dist/discord/safe-area.js +0 -1
  74. package/dist/discord/testing.d.ts +0 -1
  75. package/dist/discord/testing.js +0 -1
  76. package/dist/index.d.ts +6 -1
  77. package/dist/index.js +3 -1
  78. package/dist/lint/index.d.ts +6 -0
  79. package/dist/lint/index.js +71 -0
  80. package/dist/manifests/types.d.ts +11 -1
  81. package/dist/manifests/types.js +0 -1
  82. package/dist/metadata/index.d.ts +13 -0
  83. package/dist/metadata/index.js +4 -0
  84. package/dist/navigation/index.d.ts +3 -1
  85. package/dist/navigation/index.js +1 -1
  86. package/dist/navigation/link.d.ts +8 -0
  87. package/dist/navigation/link.js +38 -0
  88. package/dist/router/match.d.ts +0 -1
  89. package/dist/router/match.js +0 -1
  90. package/dist/runtime/client/dev-panel.d.ts +0 -1
  91. package/dist/runtime/client/dev-panel.js +722 -38
  92. package/dist/runtime/client/embed-router.d.ts +8 -1
  93. package/dist/runtime/client/embed-router.js +116 -62
  94. package/dist/runtime/client/files.d.ts +5 -1
  95. package/dist/runtime/client/files.js +0 -1
  96. package/dist/runtime/client/minimize-card.d.ts +0 -1
  97. package/dist/runtime/client/minimize-card.js +0 -1
  98. package/dist/runtime/client/minimize.d.ts +0 -1
  99. package/dist/runtime/client/minimize.js +0 -1
  100. package/dist/runtime/client/root.d.ts +5 -3
  101. package/dist/runtime/client/root.js +28 -3
  102. package/dist/runtime/index.d.ts +1 -2
  103. package/dist/runtime/index.js +0 -1
  104. package/dist/runtime/server/dev-server.d.ts +0 -1
  105. package/dist/runtime/server/dev-server.js +187 -30
  106. package/dist/runtime/server/diagnostics.d.ts +1 -1
  107. package/dist/runtime/server/diagnostics.js +5 -4
  108. package/dist/runtime/server/index.d.ts +0 -1
  109. package/dist/runtime/server/index.js +0 -1
  110. package/dist/runtime/server/production-server.d.ts +2 -1
  111. package/dist/runtime/server/production-server.js +145 -25
  112. package/dist/security/discord.d.ts +0 -1
  113. package/dist/security/discord.js +0 -1
  114. package/dist/security/index.d.ts +0 -1
  115. package/dist/security/index.js +0 -1
  116. package/dist/security/secret-scan.d.ts +0 -1
  117. package/dist/security/secret-scan.js +0 -1
  118. package/dist/server/discord-rest.d.ts +42 -7
  119. package/dist/server/discord-rest.js +135 -18
  120. package/dist/server/index.d.ts +7 -2
  121. package/dist/server/index.js +3 -1
  122. package/dist/server/instrumentation.d.ts +16 -0
  123. package/dist/server/instrumentation.js +3 -0
  124. package/dist/server/proxy.d.ts +21 -0
  125. package/dist/server/proxy.js +76 -0
  126. package/dist/server/session.d.ts +0 -1
  127. package/dist/server/session.js +0 -1
  128. package/dist/server/types.d.ts +0 -1
  129. package/dist/server/types.js +0 -1
  130. package/dist/sessions/cookies.d.ts +0 -1
  131. package/dist/sessions/cookies.js +0 -1
  132. package/dist/sessions/crypto.d.ts +0 -1
  133. package/dist/sessions/crypto.js +0 -1
  134. package/dist/sessions/data-store.d.ts +18 -0
  135. package/dist/sessions/data-store.js +45 -0
  136. package/dist/shared/errors.d.ts +0 -1
  137. package/dist/shared/errors.js +0 -1
  138. package/dist/testing/index.d.ts +0 -1
  139. package/dist/testing/index.js +2 -2
  140. package/dist/version.d.ts +1 -2
  141. package/dist/version.js +1 -2
  142. package/dist/ws/client.d.ts +0 -1
  143. package/dist/ws/client.js +0 -1
  144. package/dist/ws/index.d.ts +3 -2
  145. package/dist/ws/index.js +1 -1
  146. package/dist/ws/server.d.ts +5 -3
  147. package/dist/ws/server.js +65 -19
  148. package/dist/ws/shared-state.d.ts +13 -0
  149. package/dist/ws/shared-state.js +137 -0
  150. package/package.json +14 -1
@@ -1,12 +1,7 @@
1
- import { useSyncExternalStore } from "react";
1
+ import { useEffect, useRef, useSyncExternalStore } from "react";
2
2
  import { useDiscord } from "./runtime.js";
3
- function discordAvatarUrl(userId, avatar) {
4
- if (avatar === null || avatar === undefined || avatar.startsWith("http")) {
5
- return avatar ?? null;
6
- }
7
- const extension = avatar.startsWith("a_") ? "gif" : "png";
8
- return `https://cdn.discordapp.com/avatars/${userId}/${avatar}.${extension}`;
9
- }
3
+ import { discordRawPayload } from "./payload.js";
4
+ import { discordGuildIconUrl, discordGuildMemberAvatarUrl, discordUserAvatarUrl } from "./assets.js";
10
5
  const EVENT_NAMES = [
11
6
  "VOICE_STATE_UPDATE",
12
7
  "SPEAKING_START",
@@ -36,6 +31,8 @@ class DiscordEventStore {
36
31
  channelMembers: [],
37
32
  currentGuildMember: null,
38
33
  entitlements: [],
34
+ permissions: { guild: null, channel: null, member: null },
35
+ rawEvents: {},
39
36
  };
40
37
  listeners = new Set();
41
38
  subscribe = (listener) => {
@@ -55,6 +52,7 @@ class DiscordEventStore {
55
52
  let eventStore = new DiscordEventStore();
56
53
  let activeController = null;
57
54
  const warnedScopes = new Set();
55
+ const rawEventListeners = new Map();
58
56
  function valueFromPayload(payload, keys) {
59
57
  if (typeof payload !== "object" || payload === null)
60
58
  return undefined;
@@ -87,8 +85,9 @@ function normalizeUser(value) {
87
85
  id: source.id,
88
86
  username: source.username,
89
87
  displayName,
90
- avatar: discordAvatarUrl(source.id, typeof source.avatar === "string" ? source.avatar : null),
88
+ avatar: discordUserAvatarUrl(source.id, typeof source.avatar === "string" ? source.avatar : null),
91
89
  ...(typeof source.locale === "string" ? { locale: source.locale } : {}),
90
+ raw: discordRawPayload(source),
92
91
  };
93
92
  }
94
93
  function normalizeParticipant(value) {
@@ -110,8 +109,9 @@ function normalizeParticipant(value) {
110
109
  : {}),
111
110
  ...(displayName === undefined ? {} : { displayName }),
112
111
  ...(typeof source.avatar === "string" || source.avatar === null
113
- ? { avatar: discordAvatarUrl(id, source.avatar) }
112
+ ? { avatar: discordUserAvatarUrl(id, source.avatar) }
114
113
  : {}),
114
+ raw: discordRawPayload(source),
115
115
  };
116
116
  }
117
117
  function normalizeParticipants(payload) {
@@ -124,6 +124,24 @@ function normalizeParticipants(payload) {
124
124
  .map(normalizeParticipant)
125
125
  .filter((participant) => participant !== null);
126
126
  }
127
+ function normalizeGuildMember(value, fallbackUser = null, fallbackGuildId) {
128
+ if (typeof value !== "object" || value === null)
129
+ return null;
130
+ const source = value;
131
+ const user = normalizeUser(valueFromPayload(source, ["user"])) ?? fallbackUser;
132
+ if (user === null)
133
+ return null;
134
+ return {
135
+ user,
136
+ nickname: typeof source.nick === "string" ? source.nick : null,
137
+ roles: Array.isArray(source.roles)
138
+ ? source.roles.filter((role) => typeof role === "string")
139
+ : [],
140
+ avatar: discordGuildMemberAvatarUrl(typeof source.guild_id === "string" ? source.guild_id : fallbackGuildId ?? "", user.id, typeof source.avatar === "string" ? source.avatar : null),
141
+ ...(typeof source.joined_at === "string" ? { joinedAt: source.joined_at } : {}),
142
+ raw: discordRawPayload(source),
143
+ };
144
+ }
127
145
  function normalizeVoiceState(payload) {
128
146
  const value = valueFromPayload(payload, ["voice_state", "voiceState"]) ?? payload;
129
147
  if (typeof value !== "object" || value === null)
@@ -147,18 +165,32 @@ function normalizeVoiceState(payload) {
147
165
  ...(typeof source.self_deaf === "boolean"
148
166
  ? { selfDeaf: source.self_deaf }
149
167
  : {}),
168
+ raw: discordRawPayload(payload),
150
169
  };
151
170
  }
152
171
  function eventHandler(event, payload) {
172
+ eventStore.update((current) => ({
173
+ ...current,
174
+ rawEvents: { ...current.rawEvents, [event]: payload },
175
+ }));
176
+ for (const listener of rawEventListeners.get(event) ?? []) {
177
+ try {
178
+ listener(payload);
179
+ }
180
+ catch (error) {
181
+ queueMicrotask(() => { throw error; });
182
+ }
183
+ }
184
+ const update = (updater) => eventStore.update(updater);
153
185
  if (event === "ACTIVITY_INSTANCE_PARTICIPANTS_UPDATE") {
154
- eventStore.update({ participants: normalizeParticipants(payload) });
186
+ update({ participants: normalizeParticipants(payload) });
155
187
  return;
156
188
  }
157
189
  if (event === "SPEAKING_START" || event === "SPEAKING_STOP") {
158
190
  const userId = stringFromPayload(payload, ["user_id", "userId"]);
159
191
  if (userId === undefined)
160
192
  return;
161
- eventStore.update((current) => {
193
+ update((current) => {
162
194
  const speaking = new Set(current.speakingUserIds);
163
195
  if (event === "SPEAKING_START")
164
196
  speaking.add(userId);
@@ -172,7 +204,7 @@ function eventHandler(event, payload) {
172
204
  const voiceState = normalizeVoiceState(payload);
173
205
  if (voiceState === null)
174
206
  return;
175
- eventStore.update((current) => ({
207
+ update((current) => ({
176
208
  ...current,
177
209
  voiceStates: [
178
210
  ...current.voiceStates.filter(({ userId }) => userId !== voiceState.userId),
@@ -183,47 +215,40 @@ function eventHandler(event, payload) {
183
215
  }
184
216
  if (event === "CURRENT_USER_UPDATE") {
185
217
  const user = normalizeUser(valueFromPayload(payload, ["user", "current_user"]) ?? payload);
186
- eventStore.update({
218
+ update({
187
219
  user,
188
220
  locale: user?.locale ?? eventStore.getSnapshot().locale,
189
221
  });
190
222
  return;
191
223
  }
192
224
  if (event === "CURRENT_GUILD_MEMBER_UPDATE") {
193
- const source = payload;
194
- const user = normalizeUser(valueFromPayload(payload, ["user"])) ?? eventStore.getSnapshot().user;
195
- if (source !== null && typeof source === "object" && user !== null) {
196
- const nickname = typeof source.nick === "string" ? source.nick : null;
197
- eventStore.update({ currentGuildMember: {
198
- user, nickname,
199
- roles: Array.isArray(source.roles) ? source.roles.filter((role) => typeof role === "string") : [],
200
- avatar: typeof source.avatar === "string" ? source.avatar : null,
201
- } });
202
- }
225
+ const member = normalizeGuildMember(payload, eventStore.getSnapshot().user, eventStore.getSnapshot().guild?.id);
226
+ if (member !== null)
227
+ update({ currentGuildMember: member });
203
228
  return;
204
229
  }
205
230
  if (event === "ENTITLEMENT_CREATE" && typeof payload === "object" && payload !== null) {
206
231
  const entitlement = (valueFromPayload(payload, ["entitlement"]) ?? payload);
207
232
  if (typeof entitlement.id !== "string")
208
233
  return;
209
- eventStore.update((current) => ({ ...current, entitlements: [...current.entitlements.filter((item) => item.id !== entitlement.id), entitlement].slice(-500) }));
234
+ update((current) => ({ ...current, entitlements: [...current.entitlements.filter((item) => item.id !== entitlement.id), entitlement].slice(-500) }));
210
235
  return;
211
236
  }
212
237
  if (event === "ACTIVITY_LAYOUT_MODE_UPDATE") {
213
- eventStore.update({
238
+ update({
214
239
  layoutMode: layoutModeFromPayload(payload) ?? null,
215
240
  });
216
241
  return;
217
242
  }
218
243
  if (event === "ORIENTATION_UPDATE") {
219
- eventStore.update({
244
+ update({
220
245
  orientation: stringFromPayload(payload, ["orientation"]) ??
221
246
  { 0: "portrait", 1: "landscape" }[Number(valueFromPayload(payload, ["screen_orientation"]))] ?? null,
222
247
  });
223
248
  return;
224
249
  }
225
250
  if (event === "THERMAL_STATE_UPDATE") {
226
- eventStore.update({
251
+ update({
227
252
  thermalState: stringFromPayload(payload, ["thermal_state", "thermalState"]) ??
228
253
  { 0: "nominal", 1: "fair", 2: "serious", 3: "critical" }[Number(valueFromPayload(payload, ["thermal_state", "thermalState"]))] ?? null,
229
254
  });
@@ -269,11 +294,15 @@ async function initialChannel(sdk, channelId) {
269
294
  ...(typeof channel.topic === "string" ? { topic: channel.topic } : {}),
270
295
  ...(typeof channel.guild_id === "string" ? { guildId: channel.guild_id } : {}),
271
296
  ...(typeof channel.type === "number" ? { kind: channelTypeName(channel.type), isVoice: channel.type === 2 || channel.type === 13 } : {}),
297
+ raw: discordRawPayload(result),
272
298
  },
273
299
  ...(typeof channel.guild_id === "string"
274
300
  ? {
275
301
  guild: {
276
302
  id: channel.guild_id,
303
+ raw: current.guild?.id === channel.guild_id
304
+ ? current.guild.raw
305
+ : { id: channel.guild_id },
277
306
  ...(current.guild?.id === channel.guild_id ? current.guild : {}),
278
307
  },
279
308
  }
@@ -338,8 +367,12 @@ export async function initializeDiscordEventsFromEnvironment(discord, grantedSco
338
367
  const effectiveChannelId = discord.channelId ?? discord.sdk.channelId;
339
368
  const effectiveGuildId = discord.guildId ?? discord.sdk.guildId;
340
369
  eventStore.update({
341
- channel: effectiveChannelId === undefined ? null : { id: effectiveChannelId },
342
- guild: effectiveGuildId === undefined ? null : { ...eventStore.getSnapshot().guild, id: effectiveGuildId },
370
+ channel: effectiveChannelId === undefined ? null : { id: effectiveChannelId, raw: { id: effectiveChannelId } },
371
+ guild: effectiveGuildId === undefined ? null : {
372
+ raw: eventStore.getSnapshot().guild?.raw ?? { id: effectiveGuildId },
373
+ ...eventStore.getSnapshot().guild,
374
+ id: effectiveGuildId,
375
+ },
343
376
  });
344
377
  await initialChannel(discord.sdk, effectiveChannelId);
345
378
  const localeCommand = discord.sdk.commands?.userSettingsGetLocale;
@@ -355,7 +388,7 @@ export async function initializeDiscordEventsFromEnvironment(discord, grantedSco
355
388
  }
356
389
  export function setDiscordUserFromAuth(user) {
357
390
  if (user === null) {
358
- eventStore.update({ user: null, currentGuildMember: null, guild: null, channel: null, channelMembers: [], entitlements: [], scopes: [] });
391
+ eventStore.update({ user: null, currentGuildMember: null, guild: null, channel: null, channelMembers: [], entitlements: [], scopes: [], permissions: { guild: null, channel: null, member: null } });
359
392
  return;
360
393
  }
361
394
  eventStore.update({
@@ -364,6 +397,7 @@ export function setDiscordUserFromAuth(user) {
364
397
  username: user.username,
365
398
  displayName: user.displayName,
366
399
  avatar: user.avatar,
400
+ raw: user.raw ?? { id: user.id, username: user.username, avatar: user.avatar },
367
401
  },
368
402
  });
369
403
  }
@@ -371,13 +405,22 @@ export function enrichDiscordContext(context) {
371
405
  const guild = context.guild;
372
406
  const channel = context.channel;
373
407
  if (guild)
374
- eventStore.update({ guild: { id: guild.id, name: guild.name, icon: guild.icon ? `https://cdn.discordapp.com/icons/${guild.id}/${guild.icon}.png` : null,
375
- ...(guild.description === undefined ? {} : { description: guild.description }), ...(guild.approximate_member_count === undefined ? {} : { memberCount: guild.approximate_member_count }), ...(guild.features === undefined ? {} : { features: guild.features }) } });
408
+ eventStore.update({ guild: { id: guild.id, name: guild.name, icon: discordGuildIconUrl(guild.id, guild.icon),
409
+ ...(guild.description === undefined ? {} : { description: guild.description }), ...(guild.approximate_member_count === undefined ? {} : { memberCount: guild.approximate_member_count }), ...(guild.features === undefined ? {} : { features: guild.features }), raw: discordRawPayload(guild) } });
376
410
  if (channel)
377
411
  eventStore.update({ channel: { id: channel.id, type: channel.type, kind: channelTypeName(channel.type), isVoice: [2, 13].includes(channel.type),
378
- ...(channel.name === undefined ? {} : { name: channel.name }), ...(channel.guild_id === undefined ? {} : { guildId: channel.guild_id }), ...(channel.topic == null ? {} : { topic: channel.topic }) } });
379
- }
380
- export function setDiscordGuildFromAuth(guildId, guildName, guildIcon) {
412
+ ...(channel.name === undefined ? {} : { name: channel.name }), ...(channel.guild_id === undefined ? {} : { guildId: channel.guild_id }), ...(channel.topic == null ? {} : { topic: channel.topic }), raw: discordRawPayload(channel) } });
413
+ const member = normalizeGuildMember(context.member, eventStore.getSnapshot().user, guild?.id ?? eventStore.getSnapshot().guild?.id);
414
+ if (member !== null)
415
+ eventStore.update({ currentGuildMember: member });
416
+ if (context.permissions !== undefined)
417
+ eventStore.update({ permissions: {
418
+ guild: typeof context.permissions.guild === "string" ? context.permissions.guild : null,
419
+ channel: typeof context.permissions.channel === "string" ? context.permissions.channel : null,
420
+ member: typeof context.permissions.member === "string" ? context.permissions.member : null,
421
+ } });
422
+ }
423
+ export function setDiscordGuildFromAuth(guildId, guildName, guildIcon, raw) {
381
424
  if (guildId === undefined) {
382
425
  eventStore.update({ guild: null });
383
426
  return;
@@ -387,6 +430,7 @@ export function setDiscordGuildFromAuth(guildId, guildName, guildIcon) {
387
430
  ...(previous?.id === guildId ? previous : {}), id: guildId,
388
431
  ...(guildName === undefined ? {} : { name: guildName }),
389
432
  ...(guildIcon === undefined ? {} : { icon: guildIcon }),
433
+ raw: raw ?? (previous?.id === guildId ? previous.raw : { id: guildId }),
390
434
  } });
391
435
  }
392
436
  export function diagnoseDiscordScope(scope, feature) {
@@ -417,14 +461,40 @@ export function useDiscordChannel() {
417
461
  const { channelId } = useDiscord();
418
462
  if (eventChannel !== null)
419
463
  return eventChannel;
420
- return channelId === undefined ? null : { id: channelId };
464
+ return channelId === undefined ? null : { id: channelId, raw: { id: channelId } };
421
465
  }
422
466
  export function useDiscordGuild() {
423
467
  const eventGuild = useEventSnapshot().guild;
424
468
  const { guildId } = useDiscord();
425
469
  if (eventGuild !== null)
426
470
  return eventGuild;
427
- return guildId === undefined ? null : { id: guildId };
471
+ return guildId === undefined ? null : { id: guildId, raw: { id: guildId } };
472
+ }
473
+ export function useDiscordData() {
474
+ return useEventSnapshot();
475
+ }
476
+ export function useDiscordRawEvent(event) {
477
+ return useEventSnapshot().rawEvents[event];
478
+ }
479
+ export function useDiscordEvent(event, listener, options = {}) {
480
+ const listenerRef = useRef(listener);
481
+ listenerRef.current = listener;
482
+ useEffect(() => {
483
+ const wrapped = (payload) => listenerRef.current(payload);
484
+ const listeners = rawEventListeners.get(event) ?? new Set();
485
+ listeners.add(wrapped);
486
+ rawEventListeners.set(event, listeners);
487
+ if (options.replayLatest === true) {
488
+ const latest = eventStore.getSnapshot().rawEvents[event];
489
+ if (latest !== undefined)
490
+ wrapped(latest);
491
+ }
492
+ return () => {
493
+ listeners.delete(wrapped);
494
+ if (listeners.size === 0)
495
+ rawEventListeners.delete(event);
496
+ };
497
+ }, [event, options.replayLatest]);
428
498
  }
429
499
  export function useParticipants() {
430
500
  return useEventSnapshot().participants;
@@ -475,5 +545,5 @@ export async function resetDiscordEventStoreForTesting() {
475
545
  activeController = null;
476
546
  eventStore = new DiscordEventStore();
477
547
  warnedScopes.clear();
548
+ rawEventListeners.clear();
478
549
  }
479
- //# sourceMappingURL=events.js.map
@@ -1,9 +1,10 @@
1
1
  export { initializeDiscord, initializeDiscordFromEnvironment, useActivityInstance, useDiscord, } from "./runtime.js";
2
- export { useActivityLayoutMode, useDiscordChannel, useDiscordDiagnostics, useDiscordGuild, useDiscordLocale, useDiscordUser, useOrientation, useIsSpeaking, useParticipantVoiceState, useParticipants, useSpeakingUsers, useThermalState, useVoiceState, useChannelMembers, useCurrentGuildMember, useDiscordEntitlements, channelTypeName, } from "./events.js";
2
+ export { useActivityLayoutMode, useDiscordChannel, useDiscordDiagnostics, useDiscordGuild, useDiscordLocale, useDiscordUser, useOrientation, useIsSpeaking, useParticipantVoiceState, useParticipants, useSpeakingUsers, useThermalState, useVoiceState, useChannelMembers, useCurrentGuildMember, useDiscordEntitlements, useDiscordData, useDiscordRawEvent, useDiscordEvent, channelTypeName, } from "./events.js";
3
3
  export { LUDICORD_SAFE_AREA_CSS, LUDICORD_SAFE_AREA_STYLE_ID, getLudicordSafeAreaInsets, installLudicordSafeAreaVariables, useLudicordSafeArea, } from "./safe-area.js";
4
4
  export type { ActivityInstanceState, LudicordDiscordStatus, DiscordRuntimeOptions, DiscordRuntimeSnapshot, DiscordSdkLike, } from "./runtime.js";
5
- export type { LudicordDiscordChannel, LudicordDiscordEventSnapshot, LudicordDiscordGuild, LudicordDiscordUser, LudicordParticipant, LudicordVoiceState, LudicordGuildMember, } from "./events.js";
5
+ export type { LudicordDiscordChannel, LudicordDiscordEventSnapshot, LudicordDiscordGuild, LudicordDiscordUser, LudicordParticipant, LudicordVoiceState, LudicordGuildMember, LudicordDiscordEventName, } from "./events.js";
6
+ export type { DiscordRawPayload } from "./payload.js";
7
+ export { discordAvatarDecorationUrl, discordGuildIconUrl, discordGuildMemberAvatarUrl, discordUserAvatarUrl, discordUserBannerUrl, } from "./assets.js";
6
8
  export type { LudicordSafeAreaInsets } from "./safe-area.js";
7
- export { useDiscordCommands, useDiscordGuildMembers } from "./data.js";
8
- export type { LudicordDiscordCommand } from "./data.js";
9
- //# sourceMappingURL=index.d.ts.map
9
+ export { refreshDiscordData, useDiscordCommands, useDiscordGuildChannels, useDiscordGuildMember, useDiscordGuildMembers, useDiscordGuildRoles, useDiscordPermissions, } from "./data.js";
10
+ export type { LudicordDiscordCommand, LudicordDiscordResource, LudicordDiscordResourceStatus, LudicordDiscordRole, } from "./data.js";
@@ -1,5 +1,5 @@
1
1
  export { initializeDiscord, initializeDiscordFromEnvironment, useActivityInstance, useDiscord, } from "./runtime.js";
2
- export { useActivityLayoutMode, useDiscordChannel, useDiscordDiagnostics, useDiscordGuild, useDiscordLocale, useDiscordUser, useOrientation, useIsSpeaking, useParticipantVoiceState, useParticipants, useSpeakingUsers, useThermalState, useVoiceState, useChannelMembers, useCurrentGuildMember, useDiscordEntitlements, channelTypeName, } from "./events.js";
2
+ export { useActivityLayoutMode, useDiscordChannel, useDiscordDiagnostics, useDiscordGuild, useDiscordLocale, useDiscordUser, useOrientation, useIsSpeaking, useParticipantVoiceState, useParticipants, useSpeakingUsers, useThermalState, useVoiceState, useChannelMembers, useCurrentGuildMember, useDiscordEntitlements, useDiscordData, useDiscordRawEvent, useDiscordEvent, channelTypeName, } from "./events.js";
3
3
  export { LUDICORD_SAFE_AREA_CSS, LUDICORD_SAFE_AREA_STYLE_ID, getLudicordSafeAreaInsets, installLudicordSafeAreaVariables, useLudicordSafeArea, } from "./safe-area.js";
4
- export { useDiscordCommands, useDiscordGuildMembers } from "./data.js";
5
- //# sourceMappingURL=index.js.map
4
+ export { discordAvatarDecorationUrl, discordGuildIconUrl, discordGuildMemberAvatarUrl, discordUserAvatarUrl, discordUserBannerUrl, } from "./assets.js";
5
+ export { refreshDiscordData, useDiscordCommands, useDiscordGuildChannels, useDiscordGuildMember, useDiscordGuildMembers, useDiscordGuildRoles, useDiscordPermissions, } from "./data.js";
@@ -0,0 +1,6 @@
1
+ /**
2
+ * The complete object returned by Discord. Ludicord keeps this alongside its
3
+ * normalized fields so new or uncommon Discord properties are never dropped.
4
+ */
5
+ export type DiscordRawPayload = Readonly<Record<string, unknown>>;
6
+ export declare function discordRawPayload(value: unknown): DiscordRawPayload;
@@ -0,0 +1,5 @@
1
+ export function discordRawPayload(value) {
2
+ return typeof value === "object" && value !== null
3
+ ? { ...value }
4
+ : {};
5
+ }
@@ -46,4 +46,3 @@ export declare function useDiscordGuild(): {
46
46
  readonly id?: string;
47
47
  };
48
48
  export declare function resetDiscordRuntimeForTesting(): void;
49
- //# sourceMappingURL=runtime.d.ts.map
@@ -177,4 +177,3 @@ export function useDiscordGuild() {
177
177
  export function resetDiscordRuntimeForTesting() {
178
178
  store = new DiscordRuntimeStore();
179
179
  }
180
- //# sourceMappingURL=runtime.js.map
@@ -9,4 +9,3 @@ export declare const LUDICORD_SAFE_AREA_CSS = ":root {\n --ludicord-safe-top: v
9
9
  export declare function installLudicordSafeAreaVariables(targetDocument?: Document | undefined): boolean;
10
10
  export declare function getLudicordSafeAreaInsets(targetDocument?: Document | undefined): LudicordSafeAreaInsets;
11
11
  export declare function useLudicordSafeArea(): LudicordSafeAreaInsets;
12
- //# sourceMappingURL=safe-area.d.ts.map
@@ -53,4 +53,3 @@ export function useLudicordSafeArea() {
53
53
  }, []);
54
54
  return insets;
55
55
  }
56
- //# sourceMappingURL=safe-area.js.map
@@ -9,4 +9,3 @@ export interface MockDiscordController {
9
9
  }
10
10
  export declare function createMockDiscord(overrides?: Partial<DiscordSdkLike>): MockDiscordController;
11
11
  export { resetDiscordRuntimeForTesting };
12
- //# sourceMappingURL=testing.d.ts.map
@@ -31,4 +31,3 @@ export function createMockDiscord(overrides = {}) {
31
31
  };
32
32
  }
33
33
  export { resetDiscordRuntimeForTesting };
34
- //# sourceMappingURL=testing.js.map
package/dist/index.d.ts CHANGED
@@ -1,4 +1,10 @@
1
1
  export { LUDICORD_VERSION } from "./version.js";
2
+ export { defineMetadata } from "./metadata/index.js";
3
+ export { Link, } from "./navigation/link.js";
4
+ export type { LudicordLinkProps } from "./navigation/link.js";
5
+ export { clearActivityQueryCache, useActivityLifecycle, useActivityPresence, useActivityQuery, useActivityStorage, useGameLoop, useSharedActivityState, } from "./activity/index.js";
6
+ export type { LudicordActivityLifecycle, LudicordActivityPresence, LudicordActivityQuery, LudicordActivityQueryKey, LudicordActivityQueryOptions, LudicordActivityQueryStatus, LudicordActivityStorage, LudicordActivityStorageOptions, LudicordActivityStorageScope, LudicordGameFrame, LudicordGameLoop, LudicordGameLoopOptions, LudicordSharedActivityState, } from "./activity/index.js";
7
+ export type { LudicordMetadata, LudicordMetadataTitle } from "./metadata/index.js";
2
8
  export { LudicordActivity, LudicordErrorBoundary, LudicordLoadingBoundary, EmbedOutlet, } from "./runtime/client/embed-router.js";
3
9
  export { LudicordMinimizeProvider, useLudicordMinimize, } from "./runtime/client/minimize.js";
4
10
  export { Minimize } from "./runtime/client/minimize-card.js";
@@ -6,4 +12,3 @@ export type { MinimizeProps } from "./runtime/client/minimize-card.js";
6
12
  export type { LudicordActivityProps, LudicordEmbedDefinition, LudicordEmbedModule, LudicordErrorBoundaryProps, } from "./runtime/client/embed-router.js";
7
13
  export type { LudicordMinimizeProviderProps, LudicordMinimizeState, } from "./runtime/client/minimize.js";
8
14
  export type { LudicordApiRoute, LudicordEmbedParams, LudicordEmbedPattern, LudicordEmbedRoute, LudicordEmbedRouter, LudicordGeneratedConfig, LudicordRouteRegistry, LudicordWebSocketRoute, } from "./navigation/index.js";
9
- //# sourceMappingURL=index.d.ts.map
package/dist/index.js CHANGED
@@ -1,5 +1,7 @@
1
1
  export { LUDICORD_VERSION } from "./version.js";
2
+ export { defineMetadata } from "./metadata/index.js";
3
+ export { Link, } from "./navigation/link.js";
4
+ export { clearActivityQueryCache, useActivityLifecycle, useActivityPresence, useActivityQuery, useActivityStorage, useGameLoop, useSharedActivityState, } from "./activity/index.js";
2
5
  export { LudicordActivity, LudicordErrorBoundary, LudicordLoadingBoundary, EmbedOutlet, } from "./runtime/client/embed-router.js";
3
6
  export { LudicordMinimizeProvider, useLudicordMinimize, } from "./runtime/client/minimize.js";
4
7
  export { Minimize } from "./runtime/client/minimize-card.js";
5
- //# sourceMappingURL=index.js.map
@@ -0,0 +1,6 @@
1
+ export interface LudicordLintResult {
2
+ readonly errorCount: number;
3
+ readonly warningCount: number;
4
+ readonly output: string;
5
+ }
6
+ export declare function lintLudicordProject(projectRoot: string): Promise<LudicordLintResult>;
@@ -0,0 +1,71 @@
1
+ import path from "node:path";
2
+ import parser from "@typescript-eslint/parser";
3
+ import { ESLint } from "eslint";
4
+ import reactHooks from "eslint-plugin-react-hooks";
5
+ const FILES = [
6
+ "app/**/*.{js,jsx,ts,tsx,mjs,mts}",
7
+ "components/**/*.{js,jsx,ts,tsx,mjs,mts}",
8
+ "lib/**/*.{js,jsx,ts,tsx,mjs,mts}",
9
+ ];
10
+ const LUDICORD_COMPONENT_FILE = /(?:^|\/)(?:pages|embed|layout|loading|error|global-error|not-found|minimize|denied)\.[cm]?[jt]sx$/;
11
+ function normalizeConventionComponent(source, filename) {
12
+ const normalized = filename.replaceAll("\\", "/");
13
+ if (!LUDICORD_COMPONENT_FILE.test(normalized))
14
+ return source;
15
+ return source.replace(/(\bexport\s+default\s+(?:async\s+)?function\s+)([a-z])([A-Za-z0-9_$]*)/, (_match, prefix, first, rest) => `${prefix}${first.toUpperCase()}${rest}`);
16
+ }
17
+ export async function lintLudicordProject(projectRoot) {
18
+ const root = path.resolve(projectRoot);
19
+ const eslint = new ESLint({
20
+ cwd: root,
21
+ overrideConfigFile: true,
22
+ errorOnUnmatchedPattern: false,
23
+ overrideConfig: [
24
+ {
25
+ ignores: [
26
+ "**/node_modules/**",
27
+ "**/.ludicord/**",
28
+ "**/.dact/**",
29
+ "**/dist/**",
30
+ "**/ludicord.generated.d.ts",
31
+ ],
32
+ },
33
+ {
34
+ files: [...FILES],
35
+ languageOptions: {
36
+ parser: parser,
37
+ parserOptions: {
38
+ ecmaVersion: "latest",
39
+ sourceType: "module",
40
+ ecmaFeatures: { jsx: true },
41
+ },
42
+ },
43
+ plugins: {
44
+ "react-hooks": reactHooks,
45
+ ludicord: {
46
+ processors: {
47
+ conventions: {
48
+ meta: { name: "ludicord-conventions", version: "3.0.0" },
49
+ preprocess: (source, filename) => [normalizeConventionComponent(source, filename)],
50
+ postprocess: (messages) => messages[0] ?? [],
51
+ supportsAutofix: false,
52
+ },
53
+ },
54
+ },
55
+ },
56
+ processor: "ludicord/conventions",
57
+ rules: {
58
+ "react-hooks/rules-of-hooks": "error",
59
+ "react-hooks/exhaustive-deps": "warn",
60
+ },
61
+ },
62
+ ],
63
+ });
64
+ const results = await eslint.lintFiles([...FILES]);
65
+ const formatter = await eslint.loadFormatter("stylish");
66
+ return {
67
+ errorCount: results.reduce((total, result) => total + result.errorCount, 0),
68
+ warningCount: results.reduce((total, result) => total + result.warningCount, 0),
69
+ output: (await formatter.format(results)).trimEnd(),
70
+ };
71
+ }
@@ -1,9 +1,14 @@
1
1
  export type RouteKind = "embed" | "api" | "ws";
2
2
  export interface ActivityManifest {
3
3
  readonly root: "app/pages.tsx";
4
+ readonly metadata?: string;
5
+ readonly instrumentation?: string;
6
+ readonly proxy?: string;
4
7
  readonly layout?: string;
5
8
  readonly loading?: string;
6
9
  readonly error?: string;
10
+ readonly globalError?: string;
11
+ readonly notFound?: string;
7
12
  readonly minimize?: string;
8
13
  readonly authLoading?: string;
9
14
  readonly authError?: string;
@@ -20,6 +25,12 @@ export interface BaseRouteManifestEntry {
20
25
  }
21
26
  export interface EmbedManifestEntry extends BaseRouteManifestEntry {
22
27
  readonly kind: "embed";
28
+ /** Layouts inherited from app/embeds, ordered from outermost to nearest. */
29
+ readonly layouts?: readonly string[];
30
+ /** Nearest route-level loading.tsx convention. */
31
+ readonly loading?: string;
32
+ /** Nearest route-level error.tsx convention. */
33
+ readonly error?: string;
23
34
  }
24
35
  export interface ApiManifestEntry extends BaseRouteManifestEntry {
25
36
  readonly kind: "api";
@@ -33,4 +44,3 @@ export interface LudicordManifests {
33
44
  readonly api: readonly ApiManifestEntry[];
34
45
  readonly websocket: readonly WebSocketManifestEntry[];
35
46
  }
36
- //# sourceMappingURL=types.d.ts.map
@@ -1,2 +1 @@
1
1
  export {};
2
- //# sourceMappingURL=types.js.map
@@ -0,0 +1,13 @@
1
+ export interface LudicordMetadataTitle {
2
+ readonly default: string;
3
+ readonly template?: string;
4
+ }
5
+ export interface LudicordMetadata {
6
+ readonly title?: string | LudicordMetadataTitle;
7
+ readonly description?: string;
8
+ readonly applicationName?: string;
9
+ readonly themeColor?: string;
10
+ readonly colorScheme?: "normal" | "light" | "dark" | "light dark" | "dark light";
11
+ }
12
+ /** Gives app/metadata.ts a checked, editor-friendly metadata definition. */
13
+ export declare function defineMetadata<const TMetadata extends LudicordMetadata>(metadata: TMetadata): TMetadata;
@@ -0,0 +1,4 @@
1
+ /** Gives app/metadata.ts a checked, editor-friendly metadata definition. */
2
+ export function defineMetadata(metadata) {
3
+ return metadata;
4
+ }
@@ -1,4 +1,6 @@
1
1
  export { useEmbedParams, useEmbedPath, useEmbedRouter, } from "../runtime/client/embed-router.js";
2
+ export { Link } from "./link.js";
3
+ export type { LudicordLinkProps } from "./link.js";
2
4
  export interface LudicordRouteRegistry {
3
5
  }
4
6
  type RegisteredRoute<TKey extends PropertyKey> = TKey extends keyof LudicordRouteRegistry ? Extract<LudicordRouteRegistry[TKey], string> : string;
@@ -16,7 +18,7 @@ export type LudicordEmbedParams<TRoute extends string = LudicordEmbedPattern> =
16
18
  export interface LudicordEmbedRouter {
17
19
  push(path: LudicordEmbedRoute): void;
18
20
  replace(path: LudicordEmbedRoute): void;
21
+ prefetch(path: LudicordEmbedRoute): Promise<void>;
19
22
  back(): void;
20
23
  readonly canGoBack: boolean;
21
24
  }
22
- //# sourceMappingURL=index.d.ts.map
@@ -1,2 +1,2 @@
1
1
  export { useEmbedParams, useEmbedPath, useEmbedRouter, } from "../runtime/client/embed-router.js";
2
- //# sourceMappingURL=index.js.map
2
+ export { Link } from "./link.js";
@@ -0,0 +1,8 @@
1
+ import type { AnchorHTMLAttributes } from "react";
2
+ import type { LudicordEmbedRoute } from "./index.js";
3
+ export interface LudicordLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
4
+ readonly href: LudicordEmbedRoute;
5
+ readonly prefetch?: boolean;
6
+ readonly replace?: boolean;
7
+ }
8
+ export declare function Link({ href, prefetch, replace, onClick, onFocus, onMouseEnter, ...props }: LudicordLinkProps): import("react").JSX.Element;
@@ -0,0 +1,38 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { useCallback, useEffect, useRef } from "react";
3
+ import { useEmbedRouter } from "../runtime/client/embed-router.js";
4
+ function shouldHandle(event) {
5
+ return !event.defaultPrevented && event.button === 0 &&
6
+ !event.metaKey && !event.ctrlKey && !event.shiftKey && !event.altKey &&
7
+ (event.currentTarget.target === "" || event.currentTarget.target === "_self");
8
+ }
9
+ export function Link({ href, prefetch = true, replace = false, onClick, onFocus, onMouseEnter, ...props }) {
10
+ const router = useEmbedRouter();
11
+ const anchor = useRef(null);
12
+ const warm = useCallback(() => {
13
+ if (prefetch)
14
+ void router.prefetch(href).catch(() => undefined);
15
+ }, [href, prefetch, router]);
16
+ useEffect(() => {
17
+ if (!prefetch || anchor.current === null || typeof IntersectionObserver === "undefined")
18
+ return;
19
+ const observer = new IntersectionObserver((entries) => {
20
+ if (entries.some((entry) => entry.isIntersecting)) {
21
+ warm();
22
+ observer.disconnect();
23
+ }
24
+ }, { rootMargin: "160px" });
25
+ observer.observe(anchor.current);
26
+ return () => observer.disconnect();
27
+ }, [prefetch, warm]);
28
+ return _jsx("a", { ...props, ref: anchor, href: `#/${href}`, onClick: (event) => {
29
+ onClick?.(event);
30
+ if (!shouldHandle(event))
31
+ return;
32
+ event.preventDefault();
33
+ if (replace)
34
+ router.replace(href);
35
+ else
36
+ router.push(href);
37
+ }, onFocus: (event) => { onFocus?.(event); warm(); }, onMouseEnter: (event) => { onMouseEnter?.(event); warm(); } });
38
+ }
@@ -3,4 +3,3 @@ export interface RouteMatch {
3
3
  }
4
4
  export declare function matchRoutePattern(pattern: string, pathname: string): RouteMatch | null;
5
5
  export declare function routeSpecificity(pattern: string): number;
6
- //# sourceMappingURL=match.d.ts.map
@@ -44,4 +44,3 @@ export function routeSpecificity(pattern) {
44
44
  return score + 100;
45
45
  }, 0);
46
46
  }
47
- //# sourceMappingURL=match.js.map
@@ -1,2 +1 @@
1
1
  export {};
2
- //# sourceMappingURL=dev-panel.d.ts.map