@kubohiroya/turbowarp-http-server 0.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 (63) hide show
  1. package/LICENSE +373 -0
  2. package/README.ja.md +346 -0
  3. package/README.md +874 -0
  4. package/dist/auth/digest-file.d.ts +17 -0
  5. package/dist/auth/digest-file.js +90 -0
  6. package/dist/auth/digest-file.js.map +1 -0
  7. package/dist/auth/digest.d.ts +23 -0
  8. package/dist/auth/digest.js +139 -0
  9. package/dist/auth/digest.js.map +1 -0
  10. package/dist/cli.d.ts +1 -0
  11. package/dist/cli.js +156 -0
  12. package/dist/cli.js.map +1 -0
  13. package/dist/community.d.ts +81 -0
  14. package/dist/community.js +689 -0
  15. package/dist/community.js.map +1 -0
  16. package/dist/digest-cli.d.ts +1 -0
  17. package/dist/digest-cli.js +159 -0
  18. package/dist/digest-cli.js.map +1 -0
  19. package/dist/extension-manifest.json +441 -0
  20. package/dist/protocol.d.ts +59 -0
  21. package/dist/protocol.js +71 -0
  22. package/dist/protocol.js.map +1 -0
  23. package/dist/server.d.ts +89 -0
  24. package/dist/server.js +650 -0
  25. package/dist/server.js.map +1 -0
  26. package/dist/turbowarp-http-server.js +1110 -0
  27. package/docs/deployment-targets.ja.md +274 -0
  28. package/docs/turbowarp-http-server.architecture.html +15149 -0
  29. package/docs/turbowarp-http-server.architecture.json +1014 -0
  30. package/docs/turbowarp-http-server.architecture.visual-check.1440x900.dark.png +0 -0
  31. package/docs/turbowarp-http-server.architecture.visual-check.1440x900.light.png +0 -0
  32. package/docs/turbowarp-http-server.architecture.visual-check.2048x1320.dark.png +0 -0
  33. package/docs/turbowarp-http-server.architecture.visual-check.2048x1320.light.png +0 -0
  34. package/docs/turbowarp-http-server.architecture.visual-check.html +32 -0
  35. package/docs/turbowarp-http-server.architecture.visual-check.json +547 -0
  36. package/examples/01-hello-form/README.ja.md +46 -0
  37. package/examples/01-hello-form/server.mjs +59 -0
  38. package/examples/02-visitor-counter/README.ja.md +39 -0
  39. package/examples/02-visitor-counter/server.mjs +44 -0
  40. package/examples/03-message-board/README.ja.md +47 -0
  41. package/examples/03-message-board/server.mjs +72 -0
  42. package/examples/04-image-upload/README.ja.md +46 -0
  43. package/examples/04-image-upload/server.mjs +149 -0
  44. package/examples/05-live-camera/README.ja.md +47 -0
  45. package/examples/05-live-camera/server.mjs +147 -0
  46. package/examples/06-scratch-like-community/README.ja.md +82 -0
  47. package/examples/06-scratch-like-community/server.mjs +17 -0
  48. package/examples/README.ja.md +20 -0
  49. package/package.json +75 -0
  50. package/schemas/extension-manifest.schema.json +49 -0
  51. package/src/auth/digest-file.ts +115 -0
  52. package/src/auth/digest.ts +170 -0
  53. package/src/block-definitions.json +417 -0
  54. package/src/cli.ts +172 -0
  55. package/src/community.ts +815 -0
  56. package/src/config.ts +12 -0
  57. package/src/digest-cli.ts +178 -0
  58. package/src/extension-manifest.ts +149 -0
  59. package/src/extension.ts +713 -0
  60. package/src/globals.d.ts +30 -0
  61. package/src/index.ts +8 -0
  62. package/src/protocol.ts +132 -0
  63. package/src/server.ts +880 -0
@@ -0,0 +1,17 @@
1
+ import type { DigestCredentialStore } from './digest.js';
2
+ export interface HtdigestEntry {
3
+ username: string;
4
+ realm: string;
5
+ ha1: string;
6
+ }
7
+ export declare class HtdigestFile implements DigestCredentialStore {
8
+ private readonly path;
9
+ constructor(path: string);
10
+ getHa1(username: string, realm: string): Promise<string | undefined>;
11
+ }
12
+ export declare function readHtdigestFile(path: string): Promise<HtdigestEntry[]>;
13
+ export declare function writeHtdigestFile(path: string, entries: readonly HtdigestEntry[]): Promise<void>;
14
+ export declare function setHtdigestPassword(path: string, username: string, realm: string, password: string): Promise<'created' | 'updated'>;
15
+ export declare function updateHtdigestPassword(path: string, username: string, realm: string, password: string): Promise<boolean>;
16
+ export declare function deleteHtdigestUser(path: string, username: string, realm: string): Promise<boolean>;
17
+ export declare function validateField(name: 'username' | 'realm', value: string): void;
@@ -0,0 +1,90 @@
1
+ import { readFile, rename, writeFile } from 'node:fs/promises';
2
+ import { createHa1 } from './digest.js';
3
+ export class HtdigestFile {
4
+ constructor(path) {
5
+ this.path = path;
6
+ }
7
+ async getHa1(username, realm) {
8
+ const entries = await readHtdigestFile(this.path);
9
+ return entries.find((entry) => entry.username === username && entry.realm === realm)?.ha1;
10
+ }
11
+ }
12
+ export async function readHtdigestFile(path) {
13
+ let text = '';
14
+ try {
15
+ text = await readFile(path, 'utf8');
16
+ }
17
+ catch (error) {
18
+ if (isNodeError(error) && error.code === 'ENOENT')
19
+ return [];
20
+ throw error;
21
+ }
22
+ const entries = [];
23
+ for (const [index, line] of text.split(/\r?\n/).entries()) {
24
+ if (!line.trim())
25
+ continue;
26
+ const parts = line.split(':');
27
+ const [username, realm, ha1] = parts;
28
+ if (parts.length !== 3 || !username || !realm || !ha1 || !/^[0-9a-f]{32}$/i.test(ha1)) {
29
+ throw new Error(`Invalid htdigest entry at ${path}:${index + 1}.`);
30
+ }
31
+ entries.push({
32
+ username,
33
+ realm,
34
+ ha1: ha1.toLowerCase()
35
+ });
36
+ }
37
+ return entries;
38
+ }
39
+ export async function writeHtdigestFile(path, entries) {
40
+ const body = entries
41
+ .map((entry) => `${entry.username}:${entry.realm}:${entry.ha1.toLowerCase()}`)
42
+ .join('\n');
43
+ const tmpPath = `${path}.${process.pid}.${Date.now()}.tmp`;
44
+ await writeFile(tmpPath, body ? `${body}\n` : '', { mode: 0o600 });
45
+ await rename(tmpPath, path);
46
+ }
47
+ export async function setHtdigestPassword(path, username, realm, password) {
48
+ validateField('username', username);
49
+ validateField('realm', realm);
50
+ const entries = await readHtdigestFile(path);
51
+ const ha1 = createHa1(username, realm, password);
52
+ const existing = entries.find((entry) => entry.username === username && entry.realm === realm);
53
+ if (existing) {
54
+ existing.ha1 = ha1;
55
+ await writeHtdigestFile(path, entries);
56
+ return 'updated';
57
+ }
58
+ entries.push({ username, realm, ha1 });
59
+ entries.sort((left, right) => `${left.realm}\0${left.username}`.localeCompare(`${right.realm}\0${right.username}`));
60
+ await writeHtdigestFile(path, entries);
61
+ return 'created';
62
+ }
63
+ export async function updateHtdigestPassword(path, username, realm, password) {
64
+ validateField('username', username);
65
+ validateField('realm', realm);
66
+ const entries = await readHtdigestFile(path);
67
+ const existing = entries.find((entry) => entry.username === username && entry.realm === realm);
68
+ if (!existing)
69
+ return false;
70
+ existing.ha1 = createHa1(username, realm, password);
71
+ await writeHtdigestFile(path, entries);
72
+ return true;
73
+ }
74
+ export async function deleteHtdigestUser(path, username, realm) {
75
+ const entries = await readHtdigestFile(path);
76
+ const nextEntries = entries.filter((entry) => entry.username !== username || entry.realm !== realm);
77
+ if (nextEntries.length === entries.length)
78
+ return false;
79
+ await writeHtdigestFile(path, nextEntries);
80
+ return true;
81
+ }
82
+ export function validateField(name, value) {
83
+ if (!value || /[:\r\n]/.test(value)) {
84
+ throw new Error(`${name} must be non-empty and must not contain colon or line breaks.`);
85
+ }
86
+ }
87
+ function isNodeError(error) {
88
+ return error instanceof Error && 'code' in error;
89
+ }
90
+ //# sourceMappingURL=digest-file.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"digest-file.js","sourceRoot":"","sources":["../../src/auth/digest-file.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ export declare const DIGEST_AUTH_USER_HEADER = "x-turbowarp-http-auth-user";
2
+ export interface DigestCredentialStore {
3
+ getHa1(username: string, realm: string): string | undefined | Promise<string | undefined>;
4
+ }
5
+ export interface DigestAuthOptions {
6
+ realm: string;
7
+ credentials: DigestCredentialStore;
8
+ nonceMaxAgeMs?: number;
9
+ nonceSecret?: string;
10
+ }
11
+ export interface DigestAuthResult {
12
+ ok: boolean;
13
+ username?: string;
14
+ challenge?: string;
15
+ }
16
+ export declare function createHa1(username: string, realm: string, password: string): string;
17
+ export declare function createDigestChallenge(options: DigestAuthOptions): string;
18
+ export declare function verifyDigestAuth(request: Request, method: string, options: DigestAuthOptions): Promise<DigestAuthResult>;
19
+ export declare function parseDigestAuthorization(value: string): Record<string, string>;
20
+ export declare function isLocalAddress(address: string | undefined): boolean;
21
+ declare global {
22
+ var __turbowarpHttpDigestNonceSecret: string | undefined;
23
+ }
@@ -0,0 +1,139 @@
1
+ import { createHash, randomBytes, timingSafeEqual } from 'node:crypto';
2
+ export const DIGEST_AUTH_USER_HEADER = 'x-turbowarp-http-auth-user';
3
+ const DEFAULT_NONCE_MAX_AGE_MS = 5 * 60 * 1000;
4
+ const QOP = 'auth';
5
+ const ALGORITHM = 'MD5';
6
+ export function createHa1(username, realm, password) {
7
+ return md5(`${username}:${realm}:${password}`);
8
+ }
9
+ export function createDigestChallenge(options) {
10
+ const nonce = createNonce(options.nonceSecret ?? defaultNonceSecret(), Date.now());
11
+ const opaque = md5(options.realm);
12
+ return `Digest realm="${escapeQuoted(options.realm)}", qop="${QOP}", algorithm=${ALGORITHM}, nonce="${nonce}", opaque="${opaque}"`;
13
+ }
14
+ export async function verifyDigestAuth(request, method, options) {
15
+ const challenge = createDigestChallenge(options);
16
+ const authorization = request.headers.get('authorization');
17
+ if (!authorization)
18
+ return { ok: false, challenge };
19
+ const schemeMatch = authorization.match(/^Digest\s+/i);
20
+ if (!schemeMatch)
21
+ return { ok: false, challenge };
22
+ const params = parseDigestAuthorization(authorization.slice(schemeMatch[0].length));
23
+ const username = params.username;
24
+ const realm = params.realm;
25
+ const nonce = params.nonce;
26
+ const uri = params.uri;
27
+ const response = params.response;
28
+ if (!username || realm !== options.realm || !nonce || !uri || !response) {
29
+ return { ok: false, challenge };
30
+ }
31
+ if (!verifyNonce(nonce, options.nonceSecret ?? defaultNonceSecret(), options.nonceMaxAgeMs)) {
32
+ return { ok: false, challenge };
33
+ }
34
+ const ha1 = await options.credentials.getHa1(username, realm);
35
+ if (!ha1 || !/^[0-9a-f]{32}$/i.test(ha1))
36
+ return { ok: false, challenge };
37
+ const requestUrl = new URL(request.url);
38
+ if (uri !== `${requestUrl.pathname}${requestUrl.search}`)
39
+ return { ok: false, challenge };
40
+ const ha2 = md5(`${method.toUpperCase()}:${uri}`);
41
+ const expected = params.qop === QOP && params.nc && params.cnonce
42
+ ? md5(`${ha1}:${nonce}:${params.nc}:${params.cnonce}:${QOP}:${ha2}`)
43
+ : md5(`${ha1}:${nonce}:${ha2}`);
44
+ if (!safeEqualHex(response, expected))
45
+ return { ok: false, challenge };
46
+ return { ok: true, username };
47
+ }
48
+ export function parseDigestAuthorization(value) {
49
+ const params = {};
50
+ let index = 0;
51
+ while (index < value.length) {
52
+ while (value[index] === ' ' || value[index] === ',')
53
+ index += 1;
54
+ const keyStart = index;
55
+ while (index < value.length && value[index] !== '=' && value[index] !== ',')
56
+ index += 1;
57
+ const key = value.slice(keyStart, index).trim();
58
+ if (!key || value[index] !== '=')
59
+ break;
60
+ index += 1;
61
+ let paramValue = '';
62
+ if (value[index] === '"') {
63
+ index += 1;
64
+ while (index < value.length) {
65
+ const char = value[index];
66
+ if (char === '\\') {
67
+ index += 1;
68
+ if (index < value.length)
69
+ paramValue += value[index];
70
+ }
71
+ else if (char === '"') {
72
+ index += 1;
73
+ break;
74
+ }
75
+ else {
76
+ paramValue += char;
77
+ }
78
+ index += 1;
79
+ }
80
+ }
81
+ else {
82
+ const valueStart = index;
83
+ while (index < value.length && value[index] !== ',')
84
+ index += 1;
85
+ paramValue = value.slice(valueStart, index).trim();
86
+ }
87
+ params[key] = paramValue;
88
+ }
89
+ return params;
90
+ }
91
+ export function isLocalAddress(address) {
92
+ if (!address)
93
+ return false;
94
+ return (address === '127.0.0.1' ||
95
+ address === '::1' ||
96
+ address === '::ffff:127.0.0.1' ||
97
+ address.startsWith('127.'));
98
+ }
99
+ function createNonce(secret, timestamp) {
100
+ const payload = `${timestamp.toString(36)}:${randomBytes(12).toString('base64url')}`;
101
+ const signature = md5(`${payload}:${secret}`);
102
+ return Buffer.from(`${payload}:${signature}`, 'utf8').toString('base64url');
103
+ }
104
+ function verifyNonce(nonce, secret, maxAgeMs = DEFAULT_NONCE_MAX_AGE_MS) {
105
+ try {
106
+ const decoded = Buffer.from(nonce, 'base64url').toString('utf8');
107
+ const parts = decoded.split(':');
108
+ if (parts.length !== 3)
109
+ return false;
110
+ const [timestampText, randomText, signature] = parts;
111
+ if (!timestampText || !randomText || !signature)
112
+ return false;
113
+ const timestamp = Number.parseInt(timestampText, 36);
114
+ if (!Number.isFinite(timestamp) || Date.now() - timestamp > maxAgeMs)
115
+ return false;
116
+ return safeEqualHex(signature, md5(`${timestampText}:${randomText}:${secret}`));
117
+ }
118
+ catch {
119
+ return false;
120
+ }
121
+ }
122
+ function defaultNonceSecret() {
123
+ globalThis.__turbowarpHttpDigestNonceSecret ?? (globalThis.__turbowarpHttpDigestNonceSecret = randomBytes(32).toString('base64url'));
124
+ return globalThis.__turbowarpHttpDigestNonceSecret;
125
+ }
126
+ function md5(value) {
127
+ return createHash('md5').update(value).digest('hex');
128
+ }
129
+ function safeEqualHex(left, right) {
130
+ if (!/^[0-9a-f]+$/i.test(left) || !/^[0-9a-f]+$/i.test(right))
131
+ return false;
132
+ const leftBuffer = Buffer.from(left.toLowerCase(), 'hex');
133
+ const rightBuffer = Buffer.from(right.toLowerCase(), 'hex');
134
+ return leftBuffer.byteLength === rightBuffer.byteLength && timingSafeEqual(leftBuffer, rightBuffer);
135
+ }
136
+ function escapeQuoted(value) {
137
+ return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
138
+ }
139
+ //# sourceMappingURL=digest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"digest.js","sourceRoot":"","sources":["../../src/auth/digest.ts"],"names":[],"mappings":"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"}
package/dist/cli.d.ts ADDED
@@ -0,0 +1 @@
1
+ export {};
package/dist/cli.js ADDED
@@ -0,0 +1,156 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { HtdigestFile } from './auth/digest-file.js';
3
+ import { startServer } from './server.js';
4
+ const options = parseArgs(process.argv.slice(2));
5
+ const server = startServer(toServerOptions(options));
6
+ console.log(`turbowarp-http-server listening on ${options.tlsCert ? 'https' : 'http'}://${server.hostname}:${server.port}`);
7
+ function shutdown(signal) {
8
+ console.log(`Received ${signal}; shutting down.`);
9
+ server
10
+ .close()
11
+ .catch((error) => {
12
+ console.error(error);
13
+ process.exitCode = 1;
14
+ })
15
+ .finally(() => {
16
+ process.exit();
17
+ });
18
+ }
19
+ process.on('SIGINT', () => shutdown('SIGINT'));
20
+ process.on('SIGTERM', () => shutdown('SIGTERM'));
21
+ function parseArgs(args) {
22
+ const options = {
23
+ hostname: process.env.HOST ?? '127.0.0.1',
24
+ port: parsePort(process.env.PORT ?? '8787'),
25
+ community: isTruthy(process.env.COMMUNITY) ? {} : false
26
+ };
27
+ if (process.env.TURBOWARP_HTTP_DIGEST_FILE) {
28
+ options.authDigestFile = process.env.TURBOWARP_HTTP_DIGEST_FILE;
29
+ }
30
+ if (process.env.TURBOWARP_HTTP_DIGEST_REALM) {
31
+ options.authRealm = process.env.TURBOWARP_HTTP_DIGEST_REALM;
32
+ }
33
+ if (process.env.TURBOWARP_HTTP_TLS_CERT) {
34
+ options.tlsCert = process.env.TURBOWARP_HTTP_TLS_CERT;
35
+ }
36
+ if (process.env.TURBOWARP_HTTP_TLS_KEY) {
37
+ options.tlsKey = process.env.TURBOWARP_HTTP_TLS_KEY;
38
+ }
39
+ for (let index = 0; index < args.length; index += 1) {
40
+ const arg = args[index];
41
+ if (arg === '--host') {
42
+ options.hostname = requireValue(args, index, '--host');
43
+ index += 1;
44
+ }
45
+ else if (arg === '--port') {
46
+ options.port = parsePort(requireValue(args, index, '--port'));
47
+ index += 1;
48
+ }
49
+ else if (arg === '--community') {
50
+ options.community = {};
51
+ }
52
+ else if (arg === '--auth-digest') {
53
+ options.authDigestFile = requireValue(args, index, '--auth-digest');
54
+ index += 1;
55
+ }
56
+ else if (arg === '--auth-realm') {
57
+ options.authRealm = requireValue(args, index, '--auth-realm');
58
+ index += 1;
59
+ }
60
+ else if (arg === '--tls-cert') {
61
+ options.tlsCert = requireValue(args, index, '--tls-cert');
62
+ index += 1;
63
+ }
64
+ else if (arg === '--tls-key') {
65
+ options.tlsKey = requireValue(args, index, '--tls-key');
66
+ index += 1;
67
+ }
68
+ else if (arg === '--help' || arg === '-h') {
69
+ printHelp();
70
+ process.exit(0);
71
+ }
72
+ else {
73
+ throw new Error(`Unknown argument: ${arg}`);
74
+ }
75
+ }
76
+ if (options.authDigestFile && !options.authRealm) {
77
+ throw new Error('--auth-realm is required when --auth-digest is specified.');
78
+ }
79
+ if (!options.authDigestFile && options.authRealm) {
80
+ throw new Error('--auth-digest is required when --auth-realm is specified.');
81
+ }
82
+ if (Boolean(options.tlsCert) !== Boolean(options.tlsKey)) {
83
+ throw new Error('--tls-cert and --tls-key must be specified together.');
84
+ }
85
+ return options;
86
+ }
87
+ function toServerOptions(options) {
88
+ const serverOptions = {
89
+ hostname: options.hostname,
90
+ port: options.port
91
+ };
92
+ if (options.community !== undefined)
93
+ serverOptions.community = options.community;
94
+ const digestAuth = toDigestAuthOptions(options);
95
+ if (digestAuth)
96
+ serverOptions.digestAuth = digestAuth;
97
+ if (options.tlsCert && options.tlsKey) {
98
+ serverOptions.tls = {
99
+ cert: readFileSync(options.tlsCert),
100
+ key: readFileSync(options.tlsKey)
101
+ };
102
+ }
103
+ return serverOptions;
104
+ }
105
+ function toDigestAuthOptions(options) {
106
+ if (!options.authDigestFile || !options.authRealm)
107
+ return undefined;
108
+ return {
109
+ realm: options.authRealm,
110
+ credentials: new HtdigestFile(options.authDigestFile)
111
+ };
112
+ }
113
+ function requireValue(args, index, name) {
114
+ const value = args[index + 1];
115
+ if (value === undefined || value.startsWith('--')) {
116
+ throw new Error(`${name} requires a value.`);
117
+ }
118
+ return value;
119
+ }
120
+ function parsePort(value) {
121
+ const port = Number.parseInt(value, 10);
122
+ if (!Number.isInteger(port) || port < 1 || port > 65535) {
123
+ throw new Error(`Invalid port: ${value}`);
124
+ }
125
+ return port;
126
+ }
127
+ function isTruthy(value) {
128
+ return value === '1' || value === 'true' || value === 'yes';
129
+ }
130
+ function printHelp() {
131
+ console.log(`Usage: turbowarp-http-server [--host <host>] [--port <port>]
132
+
133
+ Starts the companion HTTP/WebSocket bridge for the TurboWarp extension.
134
+
135
+ Options:
136
+ --host <host> Hostname or address to bind. Defaults to HOST or 127.0.0.1.
137
+ --port <port> TCP port to bind. Defaults to PORT or 8787.
138
+ --community Enable the learning-only Scratch-like community routes.
139
+ --auth-digest <file>
140
+ Enable HTTP Digest authentication using an htdigest file.
141
+ --auth-realm <realm>
142
+ HTTP Digest authentication realm.
143
+ --tls-cert <file>
144
+ Enable HTTPS with the certificate file.
145
+ --tls-key <file>
146
+ Enable HTTPS with the private key file.
147
+ -h, --help Show this help.
148
+
149
+ Environment:
150
+ TURBOWARP_HTTP_DIGEST_FILE
151
+ TURBOWARP_HTTP_DIGEST_REALM
152
+ TURBOWARP_HTTP_TLS_CERT
153
+ TURBOWARP_HTTP_TLS_KEY
154
+ `);
155
+ }
156
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,81 @@
1
+ import { Hono } from 'hono';
2
+ export interface CommunityServerOptions {
3
+ storage?: CommunityStorage;
4
+ maxSb3Bytes?: number;
5
+ maxImageBytes?: number;
6
+ oauthProviders?: Record<string, OAuthProviderConfig | undefined>;
7
+ }
8
+ export interface OAuthProviderConfig {
9
+ clientId: string;
10
+ authorizationUrl: string;
11
+ redirectUri?: string;
12
+ scope?: string;
13
+ }
14
+ export interface CommunityUser {
15
+ id: string;
16
+ username: string;
17
+ passwordHash?: string;
18
+ oauthProvider?: string;
19
+ oauthSubject?: string;
20
+ createdAt: string;
21
+ }
22
+ export interface CommunityProject {
23
+ id: string;
24
+ ownerId: string;
25
+ title: string;
26
+ description: string;
27
+ sb3Bytes: Uint8Array;
28
+ sb3FileName: string;
29
+ sb3MimeType: string;
30
+ thumbnailBytes?: Uint8Array;
31
+ thumbnailFileName?: string;
32
+ thumbnailMimeType?: string;
33
+ remixOfProjectId?: string;
34
+ createdAt: string;
35
+ updatedAt: string;
36
+ }
37
+ export interface CommunitySession {
38
+ id: string;
39
+ csrfToken: string;
40
+ userId?: string;
41
+ oauthState?: string | undefined;
42
+ oauthProvider?: string | undefined;
43
+ expiresAt: number;
44
+ }
45
+ export interface CommunityStorage {
46
+ createUser(input: Omit<CommunityUser, 'id' | 'createdAt'>): Promise<CommunityUser>;
47
+ findUserByUsername(username: string): Promise<CommunityUser | null>;
48
+ findUserById(id: string): Promise<CommunityUser | null>;
49
+ findUserByOAuth(provider: string, subject: string): Promise<CommunityUser | null>;
50
+ createSession(input: Pick<CommunitySession, 'csrfToken' | 'expiresAt'>): Promise<CommunitySession>;
51
+ getSession(id: string): Promise<CommunitySession | null>;
52
+ saveSession(session: CommunitySession): Promise<void>;
53
+ deleteSession(id: string): Promise<void>;
54
+ createProject(input: Omit<CommunityProject, 'id' | 'createdAt' | 'updatedAt'>): Promise<CommunityProject>;
55
+ findProjectById(id: string): Promise<CommunityProject | null>;
56
+ listProjects(): Promise<readonly CommunityProject[]>;
57
+ saveProject(project: CommunityProject): Promise<void>;
58
+ deleteProject(id: string): Promise<boolean>;
59
+ }
60
+ export declare function createCommunityApp(options?: CommunityServerOptions): Hono;
61
+ export declare class InMemoryCommunityStorage implements CommunityStorage {
62
+ private userSequence;
63
+ private projectSequence;
64
+ private readonly users;
65
+ private readonly sessions;
66
+ private readonly projects;
67
+ createUser(input: Omit<CommunityUser, 'id' | 'createdAt'>): Promise<CommunityUser>;
68
+ findUserByUsername(username: string): Promise<CommunityUser | null>;
69
+ findUserById(id: string): Promise<CommunityUser | null>;
70
+ findUserByOAuth(provider: string, subject: string): Promise<CommunityUser | null>;
71
+ createSession(input: Pick<CommunitySession, 'csrfToken' | 'expiresAt'>): Promise<CommunitySession>;
72
+ getSession(id: string): Promise<CommunitySession | null>;
73
+ saveSession(session: CommunitySession): Promise<void>;
74
+ deleteSession(id: string): Promise<void>;
75
+ createProject(input: Omit<CommunityProject, 'id' | 'createdAt' | 'updatedAt'>): Promise<CommunityProject>;
76
+ findProjectById(id: string): Promise<CommunityProject | null>;
77
+ listProjects(): Promise<readonly CommunityProject[]>;
78
+ saveProject(project: CommunityProject): Promise<void>;
79
+ deleteProject(id: string): Promise<boolean>;
80
+ }
81
+ export declare function readOAuthProvidersFromEnv(env: NodeJS.ProcessEnv): Record<string, OAuthProviderConfig>;