Add optional API key support in settings

Author: jmetrikat

package.json

@@ -764,6 +764,13 @@
       "type": "textfield",
       "default": "http://127.0.0.1:31009",
       "required": false
+    },
+    {
+      "name": "apiKey",
+      "title": "API Key",
+      "description": "Optional API key for the Anytype API. Leave empty to use the built-in authentication flow with your Anytype desktop app, or enter an API key (e.g., from a headless Anytype instance) to use manual authentication.",
+      "type": "password",
+      "required": false
     }
   ],
   "dependencies": {

src/components/EnsureAuthenticated.tsx

@@ -64,7 +64,7 @@ export function EnsureAuthenticated({ placeholder, viewType, children }: EnsureA
 
   useEffect(() => {
     const retrieveAndValidateToken = async () => {
-      const token = await LocalStorage.getItem<string>(localStorageKeys.appKey);
+      const token = getPreferenceValues().apiKey || (await LocalStorage.getItem(localStorageKeys.appKey));
       if (token) {
         const isValid = await checkApiTokenValidity();
         setHasToken(true);
@@ -125,6 +125,20 @@ export function EnsureAuthenticated({ placeholder, viewType, children }: EnsureA
     return <>{children}</>;
   }
 
+  // If API key is set in settings, no need for pairing flow
+  const settingsApiKey = getPreferenceValues().apiKey;
+  if (settingsApiKey) {
+    return (
+      <List searchBarPlaceholder="Invalid API Key">
+        <List.EmptyView
+          icon={Icon.XMarkCircle}
+          title="Invalid API Key"
+          description="The API key provided in settings is invalid. Please check your settings."
+        />
+      </List>
+    );
+  }
+
   return challengeId ? (
     <Form
       isLoading={isLoading}

src/utils/api.ts

@@ -1,4 +1,4 @@
-import { LocalStorage } from "@raycast/api";
+import { getPreferenceValues, LocalStorage } from "@raycast/api";
 import fetch, { Headers as FetchHeaders } from "node-fetch";
 import { currentApiVersion, errorConnectionMessage, localStorageKeys } from "./constant";
 import { checkResponseError } from "./error";
@@ -22,11 +22,12 @@ export interface ApiResponse<T> {
  */
 export async function apiFetch<T>(url: string, options: FetchOptions): Promise<ApiResponse<T>> {
   try {
-    const token = await LocalStorage.getItem(localStorageKeys.appKey);
+    const token = getPreferenceValues().apiKey || (await LocalStorage.getItem(localStorageKeys.appKey));
+
     const response = await fetch(url, {
       method: options.method,
       headers: {
-        Authorization: token ? `Bearer ${token}` : "",
+        Authorization: `Bearer ${token}`,
         "Content-Type": "application/json",
         "Anytype-Version": currentApiVersion,
         ...options.headers,