summaryrefslogtreecommitdiffstats
path: root/typescript/src/getAppID.ts
diff options
context:
space:
mode:
authorname <email@example.com>2023-09-27 13:34:23 +0200
committername <email@example.com>2023-09-27 13:34:23 +0200
commit72d8b4e6bee0ffac79e96dd649a9da2adb86b507 (patch)
tree8d1f37e5d88a598675b1a65128c35323c99825f5 /typescript/src/getAppID.ts
parentMerge pull request 'Please consider adding my instance' (#2) from superprivacy/wolfree-dockerfile:main into main (diff)
downloadwolfree-dockerfile-72d8b4e6bee0ffac79e96dd649a9da2adb86b507.tar
wolfree-dockerfile-72d8b4e6bee0ffac79e96dd649a9da2adb86b507.tar.gz
wolfree-dockerfile-72d8b4e6bee0ffac79e96dd649a9da2adb86b507.tar.bz2
wolfree-dockerfile-72d8b4e6bee0ffac79e96dd649a9da2adb86b507.tar.lz
wolfree-dockerfile-72d8b4e6bee0ffac79e96dd649a9da2adb86b507.tar.xz
wolfree-dockerfile-72d8b4e6bee0ffac79e96dd649a9da2adb86b507.tar.zst
wolfree-dockerfile-72d8b4e6bee0ffac79e96dd649a9da2adb86b507.zip
Diffstat (limited to 'typescript/src/getAppID.ts')
-rw-r--r--typescript/src/getAppID.ts67
1 files changed, 67 insertions, 0 deletions
diff --git a/typescript/src/getAppID.ts b/typescript/src/getAppID.ts
new file mode 100644
index 0000000..eed7e1b
--- /dev/null
+++ b/typescript/src/getAppID.ts
@@ -0,0 +1,67 @@
+/* SPDX-License-Identifier: AGPL-3.0-or-later */
+
+import AppID from "./AppID.js";
+import typescriptNever from "./typescriptNever.js";
+
+/**
+ * To generate a new AppID, please follow these steps:
+ *
+ * 1. Open Tor Browser and go to:
+ * https://products.wolframalpha.com/api/
+ * 2. Click the orange "Get API Access" button.
+ * Tor Browser will redirect you to:
+ * https://account.wolfram.com/login/oauth2/sign-in
+ * 3. Click the red "Create one" hyperlink to create a new Wolfram ID.
+ * Tor Browser will redirect you to:
+ * https://account.wolfram.com/login/create
+ * 4. Fill out the form with random alphanumeric characters.
+ * 5. Click the red "Create Wolfram ID" button.
+ * Tor Browser will redirect you to:
+ * https://developer.wolframalpha.com/portal/myapps/index.html
+ * 6. Click the orange "Sign up to get your first AppID" button.
+ * 7. Fill out the form with random alphanumeric characters.
+ * 8. Click the orange "Sign up" button.
+ * 9. Click the orange "Get an AppID" button.
+ * 10. Fill out the form with random alphanumeric characters.
+ * 11. Click the orange "Get AppID" button.
+ */
+const appIDArray: Readonly<AppID[]> = Object.freeze([
+ "H9V325-HTALUWHKGK",
+ "AKJTJT-LR5LL8WTG6",
+ "LKY83U-XW6ATU9URU",
+]);
+
+console.assert(appIDArray.length > 0);
+
+appIDArray.forEach((appID) => {
+ console.assert(appID.length === 17);
+ console.assert(/[0-9A-Z]{6}-[0-9A-Z]{10}/.test(appID));
+});
+
+export default (): AppID => {
+ const random = appIDArray[getRandomInt() % appIDArray.length];
+
+ if (typeof random === "string") {
+ return random;
+ } else if (random === undefined) {
+ console.warn({ random });
+ } else {
+ typescriptNever(random);
+ }
+
+ return "H9V325-HTALUWHKGK";
+};
+
+const getRandomInt = (): number => {
+ const random = crypto.getRandomValues(new Uint32Array(1))[0];
+
+ if (typeof random === "number") {
+ return random;
+ } else if (random === undefined) {
+ console.warn({ random });
+ } else {
+ typescriptNever(random);
+ }
+
+ return 0;
+};