ludicord 2.1.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 (175) hide show
  1. package/README.md +17 -0
  2. package/bin/ludicord.js +5 -0
  3. package/dist/api/runtime.d.ts +27 -0
  4. package/dist/api/runtime.d.ts.map +1 -0
  5. package/dist/api/runtime.js +165 -0
  6. package/dist/api/runtime.js.map +1 -0
  7. package/dist/auth/client.d.ts +14 -0
  8. package/dist/auth/client.d.ts.map +1 -0
  9. package/dist/auth/client.js +150 -0
  10. package/dist/auth/client.js.map +1 -0
  11. package/dist/auth/index.d.ts +3 -0
  12. package/dist/auth/index.d.ts.map +1 -0
  13. package/dist/auth/index.js +2 -0
  14. package/dist/auth/index.js.map +1 -0
  15. package/dist/auth/server.d.ts +14 -0
  16. package/dist/auth/server.d.ts.map +1 -0
  17. package/dist/auth/server.js +201 -0
  18. package/dist/auth/server.js.map +1 -0
  19. package/dist/auth/types.d.ts +25 -0
  20. package/dist/auth/types.d.ts.map +1 -0
  21. package/dist/auth/types.js +2 -0
  22. package/dist/auth/types.js.map +1 -0
  23. package/dist/cli/index.d.ts +8 -0
  24. package/dist/cli/index.d.ts.map +1 -0
  25. package/dist/cli/index.js +215 -0
  26. package/dist/cli/index.js.map +1 -0
  27. package/dist/cli/project-commands.d.ts +8 -0
  28. package/dist/cli/project-commands.d.ts.map +1 -0
  29. package/dist/cli/project-commands.js +223 -0
  30. package/dist/cli/project-commands.js.map +1 -0
  31. package/dist/compiler/build.d.ts +36 -0
  32. package/dist/compiler/build.d.ts.map +1 -0
  33. package/dist/compiler/build.js +275 -0
  34. package/dist/compiler/build.js.map +1 -0
  35. package/dist/compiler/index.d.ts +7 -0
  36. package/dist/compiler/index.d.ts.map +1 -0
  37. package/dist/compiler/index.js +6 -0
  38. package/dist/compiler/index.js.map +1 -0
  39. package/dist/compiler/scanner.d.ts +7 -0
  40. package/dist/compiler/scanner.d.ts.map +1 -0
  41. package/dist/compiler/scanner.js +178 -0
  42. package/dist/compiler/scanner.js.map +1 -0
  43. package/dist/compiler/type-generation.d.ts +4 -0
  44. package/dist/compiler/type-generation.d.ts.map +1 -0
  45. package/dist/compiler/type-generation.js +84 -0
  46. package/dist/compiler/type-generation.js.map +1 -0
  47. package/dist/compiler/write-manifests.d.ts +3 -0
  48. package/dist/compiler/write-manifests.d.ts.map +1 -0
  49. package/dist/compiler/write-manifests.js +15 -0
  50. package/dist/compiler/write-manifests.js.map +1 -0
  51. package/dist/config/defaults.d.ts +3 -0
  52. package/dist/config/defaults.d.ts.map +1 -0
  53. package/dist/config/defaults.js +39 -0
  54. package/dist/config/defaults.js.map +1 -0
  55. package/dist/config/index.d.ts +3 -0
  56. package/dist/config/index.d.ts.map +1 -0
  57. package/dist/config/index.js +2 -0
  58. package/dist/config/index.js.map +1 -0
  59. package/dist/config/loader.d.ts +7 -0
  60. package/dist/config/loader.d.ts.map +1 -0
  61. package/dist/config/loader.js +23 -0
  62. package/dist/config/loader.js.map +1 -0
  63. package/dist/config/project-root.d.ts +2 -0
  64. package/dist/config/project-root.d.ts.map +1 -0
  65. package/dist/config/project-root.js +21 -0
  66. package/dist/config/project-root.js.map +1 -0
  67. package/dist/config/types.d.ts +80 -0
  68. package/dist/config/types.d.ts.map +1 -0
  69. package/dist/config/types.js +4 -0
  70. package/dist/config/types.js.map +1 -0
  71. package/dist/discord/events.d.ts +64 -0
  72. package/dist/discord/events.d.ts.map +1 -0
  73. package/dist/discord/events.js +338 -0
  74. package/dist/discord/events.js.map +1 -0
  75. package/dist/discord/index.d.ts +7 -0
  76. package/dist/discord/index.d.ts.map +1 -0
  77. package/dist/discord/index.js +4 -0
  78. package/dist/discord/index.js.map +1 -0
  79. package/dist/discord/runtime.d.ts +49 -0
  80. package/dist/discord/runtime.d.ts.map +1 -0
  81. package/dist/discord/runtime.js +172 -0
  82. package/dist/discord/runtime.js.map +1 -0
  83. package/dist/discord/safe-area.d.ts +12 -0
  84. package/dist/discord/safe-area.d.ts.map +1 -0
  85. package/dist/discord/safe-area.js +56 -0
  86. package/dist/discord/safe-area.js.map +1 -0
  87. package/dist/discord/testing.d.ts +11 -0
  88. package/dist/discord/testing.d.ts.map +1 -0
  89. package/dist/discord/testing.js +24 -0
  90. package/dist/discord/testing.js.map +1 -0
  91. package/dist/index.d.ts +5 -0
  92. package/dist/index.d.ts.map +1 -0
  93. package/dist/index.js +3 -0
  94. package/dist/index.js.map +1 -0
  95. package/dist/manifests/types.d.ts +32 -0
  96. package/dist/manifests/types.d.ts.map +1 -0
  97. package/dist/manifests/types.js +2 -0
  98. package/dist/manifests/types.js.map +1 -0
  99. package/dist/navigation/index.d.ts +20 -0
  100. package/dist/navigation/index.d.ts.map +1 -0
  101. package/dist/navigation/index.js +2 -0
  102. package/dist/navigation/index.js.map +1 -0
  103. package/dist/router/match.d.ts +6 -0
  104. package/dist/router/match.d.ts.map +1 -0
  105. package/dist/router/match.js +47 -0
  106. package/dist/router/match.js.map +1 -0
  107. package/dist/runtime/client/embed-router.d.ts +47 -0
  108. package/dist/runtime/client/embed-router.d.ts.map +1 -0
  109. package/dist/runtime/client/embed-router.js +202 -0
  110. package/dist/runtime/client/embed-router.js.map +1 -0
  111. package/dist/runtime/index.d.ts +5 -0
  112. package/dist/runtime/index.d.ts.map +1 -0
  113. package/dist/runtime/index.js +3 -0
  114. package/dist/runtime/index.js.map +1 -0
  115. package/dist/runtime/server/dev-server.d.ts +24 -0
  116. package/dist/runtime/server/dev-server.d.ts.map +1 -0
  117. package/dist/runtime/server/dev-server.js +287 -0
  118. package/dist/runtime/server/dev-server.js.map +1 -0
  119. package/dist/runtime/server/production-server.d.ts +22 -0
  120. package/dist/runtime/server/production-server.d.ts.map +1 -0
  121. package/dist/runtime/server/production-server.js +147 -0
  122. package/dist/runtime/server/production-server.js.map +1 -0
  123. package/dist/security/discord.d.ts +35 -0
  124. package/dist/security/discord.d.ts.map +1 -0
  125. package/dist/security/discord.js +129 -0
  126. package/dist/security/discord.js.map +1 -0
  127. package/dist/security/index.d.ts +3 -0
  128. package/dist/security/index.d.ts.map +1 -0
  129. package/dist/security/index.js +2 -0
  130. package/dist/security/index.js.map +1 -0
  131. package/dist/server/index.d.ts +3 -0
  132. package/dist/server/index.d.ts.map +1 -0
  133. package/dist/server/index.js +2 -0
  134. package/dist/server/index.js.map +1 -0
  135. package/dist/server/session.d.ts +4 -0
  136. package/dist/server/session.d.ts.map +1 -0
  137. package/dist/server/session.js +14 -0
  138. package/dist/server/session.js.map +1 -0
  139. package/dist/server/types.d.ts +14 -0
  140. package/dist/server/types.d.ts.map +1 -0
  141. package/dist/server/types.js +2 -0
  142. package/dist/server/types.js.map +1 -0
  143. package/dist/sessions/cookies.d.ts +13 -0
  144. package/dist/sessions/cookies.d.ts.map +1 -0
  145. package/dist/sessions/cookies.js +53 -0
  146. package/dist/sessions/cookies.js.map +1 -0
  147. package/dist/sessions/crypto.d.ts +5 -0
  148. package/dist/sessions/crypto.d.ts.map +1 -0
  149. package/dist/sessions/crypto.js +61 -0
  150. package/dist/sessions/crypto.js.map +1 -0
  151. package/dist/shared/errors.d.ts +7 -0
  152. package/dist/shared/errors.d.ts.map +1 -0
  153. package/dist/shared/errors.js +12 -0
  154. package/dist/shared/errors.js.map +1 -0
  155. package/dist/testing/index.d.ts +5 -0
  156. package/dist/testing/index.d.ts.map +1 -0
  157. package/dist/testing/index.js +4 -0
  158. package/dist/testing/index.js.map +1 -0
  159. package/dist/version.d.ts +2 -0
  160. package/dist/version.d.ts.map +1 -0
  161. package/dist/version.js +2 -0
  162. package/dist/version.js.map +1 -0
  163. package/dist/ws/client.d.ts +56 -0
  164. package/dist/ws/client.d.ts.map +1 -0
  165. package/dist/ws/client.js +168 -0
  166. package/dist/ws/client.js.map +1 -0
  167. package/dist/ws/index.d.ts +5 -0
  168. package/dist/ws/index.d.ts.map +1 -0
  169. package/dist/ws/index.js +3 -0
  170. package/dist/ws/index.js.map +1 -0
  171. package/dist/ws/server.d.ts +68 -0
  172. package/dist/ws/server.d.ts.map +1 -0
  173. package/dist/ws/server.js +292 -0
  174. package/dist/ws/server.js.map +1 -0
  175. package/package.json +108 -0
package/README.md ADDED
@@ -0,0 +1,17 @@
1
+ # ludicord
2
+
3
+ The full-stack React framework and CLI for Discord Activities.
4
+
5
+ ```bash
6
+ ludicord dev
7
+ ludicord build
8
+ ludicord start
9
+ ludicord routes
10
+ ludicord doctor
11
+ ludicord info
12
+ ludicord clean
13
+ ```
14
+
15
+ Public entry points include `ludicord`, `ludicord/config`, `ludicord/navigation`, `ludicord/discord`, `ludicord/auth`, `ludicord/server`, `ludicord/security`, `ludicord/ws/client`, and `ludicord/ws/server`.
16
+
17
+ See the repository [documentation](../../docs/README.md) for routing, Discord authentication, APIs, WebSockets, production deployment, and security.
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { runLudicordCli } from "../dist/cli/index.js";
4
+
5
+ process.exitCode = await runLudicordCli();
@@ -0,0 +1,27 @@
1
+ import type { NextFunction, Request as ExpressRequest, Response as ExpressResponse } from "express";
2
+ import type { ApiManifestEntry } from "../manifests/types.js";
3
+ import type { LudicordRequest, RouteContext } from "../server/types.js";
4
+ type RouteHandler = (request: LudicordRequest, context: RouteContext) => Response | Promise<Response>;
5
+ export interface ApiRouteModule {
6
+ readonly public?: boolean;
7
+ readonly auth?: boolean;
8
+ readonly GET?: RouteHandler;
9
+ readonly POST?: RouteHandler;
10
+ readonly PUT?: RouteHandler;
11
+ readonly PATCH?: RouteHandler;
12
+ readonly DELETE?: RouteHandler;
13
+ readonly HEAD?: RouteHandler;
14
+ readonly OPTIONS?: RouteHandler;
15
+ }
16
+ export interface ApiRuntimeOptions {
17
+ readonly projectRoot: string;
18
+ readonly getRoutes: () => readonly ApiManifestEntry[];
19
+ readonly loadModule?: (absoluteFile: string) => Promise<ApiRouteModule>;
20
+ readonly sessionSecret?: string;
21
+ readonly proxyVerification?: boolean;
22
+ readonly discordPublicKey?: string;
23
+ readonly now?: () => number;
24
+ }
25
+ export declare function createApiMiddleware(options: ApiRuntimeOptions): (request: ExpressRequest, response: ExpressResponse, next: NextFunction) => Promise<void>;
26
+ export {};
27
+ //# sourceMappingURL=runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/api/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,IAAI,cAAc,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,SAAS,CAAC;AAEpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAcxE,KAAK,YAAY,GAAG,CAClB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,YAAY,KAClB,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,SAAS,gBAAgB,EAAE,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAiFD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,IAI1D,SAAS,cAAc,EACvB,UAAU,eAAe,EACzB,MAAM,YAAY,KACjB,OAAO,CAAC,IAAI,CAAC,CA4GjB"}
@@ -0,0 +1,165 @@
1
+ import path from "node:path";
2
+ import { pathToFileURL } from "node:url";
3
+ import { matchRoutePattern, routeSpecificity } from "../router/match.js";
4
+ import { parseSessionCookie } from "../sessions/cookies.js";
5
+ import { verifyDiscordProxyRequest } from "../security/discord.js";
6
+ const HTTP_METHODS = [
7
+ "GET",
8
+ "POST",
9
+ "PUT",
10
+ "PATCH",
11
+ "DELETE",
12
+ "HEAD",
13
+ "OPTIONS",
14
+ ];
15
+ async function requestBody(request) {
16
+ if (request.method === "GET" || request.method === "HEAD")
17
+ return undefined;
18
+ const chunks = [];
19
+ for await (const chunk of request) {
20
+ chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
21
+ }
22
+ return Buffer.concat(chunks);
23
+ }
24
+ function webRequest(request, params, sessionSecret, body, proxyVerified) {
25
+ const origin = `${request.protocol}://${request.get("host") ?? "localhost"}`;
26
+ const headerEntries = [];
27
+ for (const [name, value] of Object.entries(request.headers)) {
28
+ if (value !== undefined) {
29
+ headerEntries.push([
30
+ name,
31
+ Array.isArray(value) ? value.join(", ") : value,
32
+ ]);
33
+ }
34
+ }
35
+ const web = new Request(new URL(request.originalUrl, origin), {
36
+ method: request.method,
37
+ headers: new Headers(headerEntries),
38
+ ...(body === undefined ? {} : { body: body }),
39
+ });
40
+ const session = sessionSecret === undefined
41
+ ? null
42
+ : parseSessionCookie(request.headers.cookie, sessionSecret);
43
+ Object.defineProperties(web, {
44
+ ludicord: { value: session, enumerable: true },
45
+ params: { value: params, enumerable: true },
46
+ verification: {
47
+ value: {
48
+ discordProxy: proxyVerified ? "verified" : "not-requested",
49
+ activityInstance: session?.activityInstanceVerified === true ? "verified" : "unverified",
50
+ },
51
+ enumerable: true,
52
+ },
53
+ });
54
+ return web;
55
+ }
56
+ async function sendWebResponse(response, webResponse, head) {
57
+ response.status(webResponse.status);
58
+ webResponse.headers.forEach((value, name) => {
59
+ response.setHeader(name, value);
60
+ });
61
+ if (head || webResponse.body === null) {
62
+ response.end();
63
+ return;
64
+ }
65
+ response.send(Buffer.from(await webResponse.arrayBuffer()));
66
+ }
67
+ function allowedMethods(module) {
68
+ const methods = HTTP_METHODS.filter((method) => typeof module[method] === "function");
69
+ if (methods.includes("GET") && !methods.includes("HEAD"))
70
+ methods.push("HEAD");
71
+ if (!methods.includes("OPTIONS"))
72
+ methods.push("OPTIONS");
73
+ return methods;
74
+ }
75
+ async function defaultModuleLoader(absoluteFile) {
76
+ return import(pathToFileURL(absoluteFile).href);
77
+ }
78
+ export function createApiMiddleware(options) {
79
+ const loadModule = options.loadModule ?? defaultModuleLoader;
80
+ return async (request, response, next) => {
81
+ const pathname = new URL(request.originalUrl, `${request.protocol}://${request.get("host") ?? "localhost"}`).pathname;
82
+ if (!pathname.startsWith("/api/") && pathname !== "/api") {
83
+ next();
84
+ return;
85
+ }
86
+ const matches = options
87
+ .getRoutes()
88
+ .map((route) => ({
89
+ route,
90
+ match: matchRoutePattern(route.route, pathname),
91
+ }))
92
+ .filter((candidate) => candidate.match !== null)
93
+ .sort((left, right) => routeSpecificity(right.route.route) -
94
+ routeSpecificity(left.route.route));
95
+ const selected = matches[0];
96
+ if (selected === undefined) {
97
+ response.status(404).json({ error: "LUDICORD_API_NOT_FOUND" });
98
+ return;
99
+ }
100
+ try {
101
+ const module = await loadModule(path.join(options.projectRoot, selected.route.file));
102
+ const body = await requestBody(request);
103
+ let proxyVerified = false;
104
+ if (options.proxyVerification === true) {
105
+ const publicKey = options.discordPublicKey ?? process.env.LUDICORD_DISCORD_PUBLIC_KEY;
106
+ if (publicKey === undefined || publicKey === "") {
107
+ response.status(500).json({ error: "LUDICORD_SECURITY_NOT_CONFIGURED" });
108
+ return;
109
+ }
110
+ const verification = verifyDiscordProxyRequest({
111
+ publicKey,
112
+ signature: request.get("x-signature-ed25519"),
113
+ timestamp: request.get("x-signature-timestamp"),
114
+ body: body ?? new Uint8Array(),
115
+ ...(options.now === undefined ? {} : { now: options.now() }),
116
+ });
117
+ if (!verification.verified) {
118
+ response.status(401).json({
119
+ error: "LUDICORD_DISCORD_SIGNATURE_INVALID",
120
+ reason: verification.reason,
121
+ });
122
+ return;
123
+ }
124
+ proxyVerified = true;
125
+ }
126
+ const method = request.method.toUpperCase();
127
+ const allowed = allowedMethods(module);
128
+ if (method === "OPTIONS" && typeof module.OPTIONS !== "function") {
129
+ response.setHeader("Allow", allowed.join(", "));
130
+ response.status(204).end();
131
+ return;
132
+ }
133
+ const handler = module[method] ??
134
+ (method === "HEAD" ? module.GET : undefined);
135
+ if (typeof handler !== "function") {
136
+ response.setHeader("Allow", allowed.join(", "));
137
+ response.status(405).json({ error: "LUDICORD_METHOD_NOT_ALLOWED" });
138
+ return;
139
+ }
140
+ const ludicordRequest = webRequest(request, selected.match.params, options.sessionSecret, body, proxyVerified);
141
+ if (module.public !== true &&
142
+ module.auth !== false &&
143
+ ludicordRequest.ludicord === null) {
144
+ response.status(401).json({ error: "LUDICORD_AUTH_REQUIRED" });
145
+ return;
146
+ }
147
+ const result = await handler(ludicordRequest, {
148
+ params: selected.match.params,
149
+ });
150
+ if (!(result instanceof Response)) {
151
+ throw new TypeError("LUDICORD8001: API handlers must return a Response.");
152
+ }
153
+ await sendWebResponse(response, result, method === "HEAD");
154
+ }
155
+ catch (error) {
156
+ if (error instanceof SyntaxError ||
157
+ (error instanceof TypeError && /JSON/.test(error.message))) {
158
+ response.status(400).json({ error: "LUDICORD_MALFORMED_BODY" });
159
+ return;
160
+ }
161
+ next(error);
162
+ }
163
+ };
164
+ }
165
+ //# sourceMappingURL=runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/api/runtime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import type { DiscordRuntimeSnapshot } from "../discord/runtime.js";
2
+ import type { LudicordAuthSnapshot, LudicordAuthStatus, LudicordSession } from "./types.js";
3
+ export interface AuthenticateLudicordOptions {
4
+ readonly fetch?: typeof fetch;
5
+ readonly scopes?: readonly string[];
6
+ readonly discord?: DiscordRuntimeSnapshot;
7
+ }
8
+ export declare function authenticateLudicord(options?: AuthenticateLudicordOptions): Promise<LudicordSession | null>;
9
+ export declare function initializeLudicordAuthFromEnvironment(discord: DiscordRuntimeSnapshot): Promise<LudicordSession | null>;
10
+ export declare function useLudicordSession(): LudicordSession | null;
11
+ export declare function useAuthStatus(): LudicordAuthStatus;
12
+ export declare function getLudicordAuthSnapshot(): LudicordAuthSnapshot;
13
+ export declare function resetLudicordAuthForTesting(): void;
14
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/auth/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AA0BpB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AA+ID,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAEjC;AAED,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOjC;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAM3D;AAED,wBAAgB,aAAa,IAAI,kBAAkB,CAMlD;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}
@@ -0,0 +1,150 @@
1
+ import { useSyncExternalStore } from "react";
2
+ import { getDiscordSnapshot, } from "../discord/runtime.js";
3
+ import { setDiscordUserFromAuth } from "../discord/events.js";
4
+ class LudicordAuthStore {
5
+ snapshot = {
6
+ status: "idle",
7
+ session: null,
8
+ error: null,
9
+ };
10
+ listeners = new Set();
11
+ authentication = null;
12
+ subscribe = (listener) => {
13
+ this.listeners.add(listener);
14
+ return () => this.listeners.delete(listener);
15
+ };
16
+ getSnapshot = () => this.snapshot;
17
+ update(status, session, error) {
18
+ this.snapshot = { status, session, error };
19
+ for (const listener of this.listeners)
20
+ listener();
21
+ }
22
+ run(options) {
23
+ if (this.authentication !== null)
24
+ return this.authentication;
25
+ this.authentication = performAuthentication(options);
26
+ return this.authentication;
27
+ }
28
+ }
29
+ let authStore = new LudicordAuthStore();
30
+ function authCommands(sdk) {
31
+ const commands = sdk.commands;
32
+ if (commands === undefined ||
33
+ typeof commands.authorize !== "function" ||
34
+ typeof commands.authenticate !== "function") {
35
+ throw new Error("LUDICORD6006: Discord SDK authentication commands are unavailable.");
36
+ }
37
+ return commands;
38
+ }
39
+ async function jsonOrError(response) {
40
+ const body = (await response.json());
41
+ if (!response.ok) {
42
+ const message = typeof body === "object" &&
43
+ body !== null &&
44
+ "message" in body &&
45
+ typeof body.message === "string"
46
+ ? body.message
47
+ : "Ludicord authentication request failed.";
48
+ throw new Error(message);
49
+ }
50
+ return body;
51
+ }
52
+ async function performAuthentication(options) {
53
+ const discord = options.discord ?? getDiscordSnapshot();
54
+ if (discord.status !== "ready" || discord.sdk === null) {
55
+ return null;
56
+ }
57
+ const clientId = discord.applicationId;
58
+ if (clientId === undefined) {
59
+ throw new Error("LUDICORD5001: Missing LUDICORD_DISCORD_CLIENT_ID.");
60
+ }
61
+ const fetchImplementation = options.fetch ?? globalThis.fetch;
62
+ const commands = authCommands(discord.sdk);
63
+ authStore.update("connecting", null, null);
64
+ try {
65
+ const stateResponse = await fetchImplementation("/_ludicord/auth/state", {
66
+ credentials: "include",
67
+ });
68
+ const stateBody = (await jsonOrError(stateResponse));
69
+ if (typeof stateBody.state !== "string") {
70
+ throw new Error("LUDICORD6003: Invalid OAuth state response.");
71
+ }
72
+ authStore.update("authorizing", null, null);
73
+ let authorization;
74
+ try {
75
+ authorization = await commands.authorize({
76
+ client_id: clientId,
77
+ response_type: "code",
78
+ state: stateBody.state,
79
+ scope: options.scopes ?? ["identify"],
80
+ prompt: "none",
81
+ });
82
+ }
83
+ catch (cause) {
84
+ const error = new Error("LUDICORD6007: Discord authorization was denied.", {
85
+ cause,
86
+ });
87
+ authStore.update("denied", null, error);
88
+ throw error;
89
+ }
90
+ const exchangeResponse = await fetchImplementation("/_ludicord/auth/exchange", {
91
+ method: "POST",
92
+ credentials: "include",
93
+ headers: { "content-type": "application/json" },
94
+ body: JSON.stringify({
95
+ code: authorization.code,
96
+ state: stateBody.state,
97
+ context: {
98
+ guildId: discord.guildId,
99
+ channelId: discord.channelId,
100
+ instanceId: discord.instanceId,
101
+ },
102
+ }),
103
+ });
104
+ const exchange = (await jsonOrError(exchangeResponse));
105
+ if (typeof exchange.access_token !== "string" ||
106
+ typeof exchange.session !== "object" ||
107
+ exchange.session === null) {
108
+ throw new Error("LUDICORD6004: Invalid authentication exchange response.");
109
+ }
110
+ await commands.authenticate({ access_token: exchange.access_token });
111
+ const session = exchange.session;
112
+ setDiscordUserFromAuth(session.user);
113
+ authStore.update("authenticated", session, null);
114
+ return session;
115
+ }
116
+ catch (cause) {
117
+ if (authStore.getSnapshot().status === "denied")
118
+ throw cause;
119
+ const error = cause instanceof Error
120
+ ? cause
121
+ : new Error("LUDICORD6008: Authentication failed.");
122
+ authStore.update("error", null, error);
123
+ throw error;
124
+ }
125
+ }
126
+ export function authenticateLudicord(options = {}) {
127
+ return authStore.run(options);
128
+ }
129
+ export async function initializeLudicordAuthFromEnvironment(discord) {
130
+ const config = globalThis.__LUDICORD_PUBLIC_CONFIG__;
131
+ if (config?.authRequired === false || discord.status !== "ready")
132
+ return null;
133
+ return authenticateLudicord({
134
+ discord,
135
+ scopes: config?.scopes ?? ["identify"],
136
+ });
137
+ }
138
+ export function useLudicordSession() {
139
+ return useSyncExternalStore(authStore.subscribe, authStore.getSnapshot, authStore.getSnapshot).session;
140
+ }
141
+ export function useAuthStatus() {
142
+ return useSyncExternalStore(authStore.subscribe, authStore.getSnapshot, authStore.getSnapshot).status;
143
+ }
144
+ export function getLudicordAuthSnapshot() {
145
+ return authStore.getSnapshot();
146
+ }
147
+ export function resetLudicordAuthForTesting() {
148
+ authStore = new LudicordAuthStore();
149
+ }
150
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/auth/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export { authenticateLudicord, initializeLudicordAuthFromEnvironment, useAuthStatus, useLudicordSession, } from "./client.js";
2
+ export type { LudicordAuthSnapshot, LudicordAuthStatus, LudicordSession, LudicordSessionUser, } from "./types.js";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qCAAqC,EACrC,aAAa,EACb,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { authenticateLudicord, initializeLudicordAuthFromEnvironment, useAuthStatus, useLudicordSession, } from "./client.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qCAAqC,EACrC,aAAa,EACb,kBAAkB,GACnB,MAAM,aAAa,CAAC"}
@@ -0,0 +1,14 @@
1
+ import type { Router } from "express";
2
+ export interface LudicordAuthServerOptions {
3
+ readonly clientId?: string;
4
+ readonly clientSecret?: string;
5
+ readonly sessionSecret?: string;
6
+ readonly production?: boolean;
7
+ readonly fetch?: typeof fetch;
8
+ readonly now?: () => number;
9
+ readonly activityInstanceVerification?: boolean;
10
+ readonly botToken?: string;
11
+ readonly activityInstanceCacheTtlMs?: number;
12
+ }
13
+ export declare function createLudicordAuthRouter(options?: LudicordAuthServerOptions): Router;
14
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/auth/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAsCtC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,4BAA4B,CAAC,EAAE,OAAO,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAC;CAC9C;AAsBD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,yBAA8B,GAAG,MAAM,CA8MxF"}
@@ -0,0 +1,201 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import express from "express";
3
+ import { OAUTH_STATE_COOKIE, SESSION_COOKIE, clearCookie, parseCookies, parseSessionCookie, serializeSessionCookie, serializeStateCookie, } from "../sessions/cookies.js";
4
+ import { safeEqual, sealLudicordSession } from "../sessions/crypto.js";
5
+ import { verifyDiscordActivityInstance } from "../security/discord.js";
6
+ function optionalString(value) {
7
+ return typeof value === "string" && value !== "" ? value : undefined;
8
+ }
9
+ function safeUser(user) {
10
+ return {
11
+ id: user.id,
12
+ username: user.username,
13
+ displayName: user.global_name ?? user.username,
14
+ avatar: user.avatar ?? null,
15
+ };
16
+ }
17
+ function unavailable(response) {
18
+ response.status(500).json({
19
+ error: "LUDICORD6001",
20
+ message: "Discord authentication is not configured on the server.",
21
+ });
22
+ }
23
+ export function createLudicordAuthRouter(options = {}) {
24
+ const router = express.Router();
25
+ const production = options.production ?? process.env.NODE_ENV === "production";
26
+ const clientId = options.clientId ?? process.env.LUDICORD_DISCORD_CLIENT_ID;
27
+ const clientSecret = options.clientSecret ?? process.env.LUDICORD_DISCORD_CLIENT_SECRET;
28
+ const sessionSecret = options.sessionSecret ?? process.env.LUDICORD_SESSION_SECRET;
29
+ const fetchImplementation = options.fetch ?? globalThis.fetch;
30
+ const now = options.now ?? Date.now;
31
+ const verifyActivityInstance = options.activityInstanceVerification ?? false;
32
+ const botToken = options.botToken ?? process.env.LUDICORD_DISCORD_BOT_TOKEN;
33
+ router.use(express.json({ limit: "64kb" }));
34
+ router.get("/state", (_request, response) => {
35
+ if (clientId === undefined || clientSecret === undefined || sessionSecret === undefined) {
36
+ unavailable(response);
37
+ return;
38
+ }
39
+ const state = randomBytes(32).toString("base64url");
40
+ response.setHeader("Set-Cookie", serializeStateCookie(state, { production }));
41
+ response.json({ state });
42
+ });
43
+ router.post("/exchange", async (request, response) => {
44
+ if (clientId === undefined || clientSecret === undefined || sessionSecret === undefined) {
45
+ unavailable(response);
46
+ return;
47
+ }
48
+ const body = request.body;
49
+ const code = optionalString(body.code);
50
+ const state = optionalString(body.state);
51
+ const stateCookie = parseCookies(request.headers.cookie)[OAUTH_STATE_COOKIE];
52
+ if (code === undefined ||
53
+ state === undefined ||
54
+ stateCookie === undefined ||
55
+ !safeEqual(state, stateCookie)) {
56
+ response.status(400).json({
57
+ error: "LUDICORD6003",
58
+ message: "Invalid OAuth code or state.",
59
+ });
60
+ return;
61
+ }
62
+ try {
63
+ const tokenResponse = await fetchImplementation("https://discord.com/api/oauth2/token", {
64
+ method: "POST",
65
+ headers: {
66
+ "content-type": "application/x-www-form-urlencoded",
67
+ },
68
+ body: new URLSearchParams({
69
+ client_id: clientId,
70
+ client_secret: clientSecret,
71
+ grant_type: "authorization_code",
72
+ code,
73
+ }),
74
+ });
75
+ if (!tokenResponse.ok) {
76
+ response.status(502).json({
77
+ error: "LUDICORD6004",
78
+ message: "Discord token exchange failed.",
79
+ });
80
+ return;
81
+ }
82
+ const token = (await tokenResponse.json());
83
+ if (typeof token.access_token !== "string" || token.access_token === "") {
84
+ response.status(502).json({
85
+ error: "LUDICORD6004",
86
+ message: "Discord token exchange returned an invalid response.",
87
+ });
88
+ return;
89
+ }
90
+ const userResponse = await fetchImplementation("https://discord.com/api/users/@me", {
91
+ headers: {
92
+ authorization: `Bearer ${token.access_token}`,
93
+ },
94
+ });
95
+ if (!userResponse.ok) {
96
+ response.status(502).json({
97
+ error: "LUDICORD6004",
98
+ message: "Discord user verification failed.",
99
+ });
100
+ return;
101
+ }
102
+ const user = (await userResponse.json());
103
+ if (typeof user.id !== "string" || typeof user.username !== "string") {
104
+ response.status(502).json({
105
+ error: "LUDICORD6004",
106
+ message: "Discord returned an invalid user.",
107
+ });
108
+ return;
109
+ }
110
+ const guildId = optionalString(body.context?.guildId);
111
+ const channelId = optionalString(body.context?.channelId);
112
+ const instanceId = optionalString(body.context?.instanceId);
113
+ let activityInstanceVerified = false;
114
+ if (verifyActivityInstance) {
115
+ if (botToken === undefined || botToken === "") {
116
+ unavailable(response);
117
+ return;
118
+ }
119
+ if (instanceId === undefined) {
120
+ response.status(400).json({
121
+ error: "LUDICORD6010",
122
+ message: "Discord Activity instance context is required.",
123
+ });
124
+ return;
125
+ }
126
+ const verification = await verifyDiscordActivityInstance({
127
+ applicationId: clientId,
128
+ instanceId,
129
+ botToken,
130
+ fetch: fetchImplementation,
131
+ now: now(),
132
+ ...(options.activityInstanceCacheTtlMs === undefined
133
+ ? {}
134
+ : { cacheTtlMs: options.activityInstanceCacheTtlMs }),
135
+ });
136
+ if (!verification.verified) {
137
+ response.status(verification.reason === "rate-limited" ? 429 : 401).json({
138
+ error: "LUDICORD6010",
139
+ message: "Discord Activity instance verification failed.",
140
+ reason: verification.reason,
141
+ ...(verification.retryAfterMs === undefined
142
+ ? {}
143
+ : { retryAfterMs: verification.retryAfterMs }),
144
+ });
145
+ return;
146
+ }
147
+ activityInstanceVerified = true;
148
+ }
149
+ const issuedAt = now();
150
+ const expiresInSeconds = typeof token.expires_in === "number" ? token.expires_in : 604_800;
151
+ const session = {
152
+ authenticated: true,
153
+ user: safeUser(user),
154
+ applicationId: clientId,
155
+ ...(guildId === undefined ? {} : { guildId }),
156
+ ...(channelId === undefined ? {} : { channelId }),
157
+ ...(instanceId === undefined ? {} : { instanceId }),
158
+ ...(activityInstanceVerified ? { activityInstanceVerified: true } : {}),
159
+ scopes: typeof token.scope === "string"
160
+ ? token.scope.split(/\s+/).filter(Boolean)
161
+ : [],
162
+ issuedAt,
163
+ expiresAt: issuedAt + expiresInSeconds * 1_000,
164
+ };
165
+ const sealed = sealLudicordSession(session, sessionSecret);
166
+ response.append("Set-Cookie", serializeSessionCookie(sealed, {
167
+ production,
168
+ maxAgeSeconds: expiresInSeconds,
169
+ }));
170
+ response.append("Set-Cookie", clearCookie(OAUTH_STATE_COOKIE, production));
171
+ response.json({
172
+ access_token: token.access_token,
173
+ session,
174
+ });
175
+ }
176
+ catch {
177
+ response.status(502).json({
178
+ error: "LUDICORD6004",
179
+ message: "Discord authentication request failed.",
180
+ });
181
+ }
182
+ });
183
+ router.get("/session", (request, response) => {
184
+ if (sessionSecret === undefined) {
185
+ unavailable(response);
186
+ return;
187
+ }
188
+ const session = parseSessionCookie(request.headers.cookie, sessionSecret);
189
+ if (session === null) {
190
+ response.status(401).json({ authenticated: false });
191
+ return;
192
+ }
193
+ response.json(session);
194
+ });
195
+ router.post("/logout", (_request, response) => {
196
+ response.setHeader("Set-Cookie", clearCookie(SESSION_COOKIE, production));
197
+ response.status(204).end();
198
+ });
199
+ return router;
200
+ }
201
+ //# sourceMappingURL=server.js.map