From c25fe6724fde869483373601bdde0f37cacb1e34 Mon Sep 17 00:00:00 2001
From: Silberengel <silberengel7@protonmail.com>
Date: Thu, 19 Feb 2026 21:31:44 +0100
Subject: [PATCH] add more api help

Nostr-Signature: 165d9bb66132123e1ac956f442e13f2ffb784e204ecdd1d3643152a5274cdd5a 573634b648634cbad10f2451776089ea21090d9407f715e83c577b4611ae6edc deb8866643413806ec43e30faa8a47a78f0ede64616d6304e3b0a87ee3e267122e2308ed67131b73290a3ec10124c19198b05d2b5f142a3ff3e44858d1dff4fe
---
 nostr/commit-signatures.jsonl    |   1 +
 src/routes/api-docs/+page.svelte | 163 ++++++++++++++++++++++++++++++-
 2 files changed, 159 insertions(+), 5 deletions(-)

diff --git a/nostr/commit-signatures.jsonl b/nostr/commit-signatures.jsonl
index 34aab54..9fb2c9b 100644
--- a/nostr/commit-signatures.jsonl
+++ b/nostr/commit-signatures.jsonl
@@ -12,3 +12,4 @@
 {"kind":1640,"pubkey":"573634b648634cbad10f2451776089ea21090d9407f715e83c577b4611ae6edc","created_at":1771530049,"tags":[["author","Silberengel","silberengel7@protonmail.com"],["message","update docs"]],"content":"Signed commit: update docs","id":"23e1028e3df47a06cee8aaee5da173a73d1317bc6bede818cc002fa002041175","sig":"ac48caad27206d5e1fd7fccbe6afe77ff0a7dd14d4c07b07a91caac1f91f9482960e019531fdb66025c90a4cda6ba0b570ddfe3f64eb7b979e06daeb551b1dad"}
 {"kind":1640,"pubkey":"573634b648634cbad10f2451776089ea21090d9407f715e83c577b4611ae6edc","created_at":1771531630,"tags":[["author","Silberengel","silberengel7@protonmail.com"],["message","bug-fixes"]],"content":"Signed commit: bug-fixes","id":"a219cd3c4055c7e77a20f464b2192dfc236059eb6b0f4717c8e9cb26b80a959f","sig":"fb9eef37d37242483dde59b9d3d96fc2a3ff9f9fb1893000327d45e3a1c73bd028b358bfbb43df19633661cc9b9c6798a76a3fc9323d2f89a3dea50fdd035f16"}
 {"kind":1640,"pubkey":"573634b648634cbad10f2451776089ea21090d9407f715e83c577b4611ae6edc","created_at":1771532033,"tags":[["author","Silberengel","silberengel7@protonmail.com"],["message","fixing themes"]],"content":"Signed commit: fixing themes","id":"b415f46b54a30f022ece43f9acc4e13ffddaa56abfd6febe447a852c54ace23c","sig":"acec0d1ea91d8c77b7ac98f0837eae225eca1272d7f871c3c5ccefc744706cb933d2f20732d9a1e42dee4f978c2ca7d17d0bc4033088a8db0a39e66cf982cb62"}
+{"kind":1640,"pubkey":"573634b648634cbad10f2451776089ea21090d9407f715e83c577b4611ae6edc","created_at":1771532649,"tags":[["author","Silberengel","silberengel7@protonmail.com"],["message","adjust responsiveness"]],"content":"Signed commit: adjust responsiveness","id":"b585b4ee5862b2593c0e469974f94b16a1a60e9f57df988cf9ed157acba1c921","sig":"7daeaea11600c77d015448d293f8d7c7500c65d87cd4b496c13ba0fa9922fe5330353a3082eb4f5b540208630e668f163981cdb5e35f027191fb6abd6d0d380f"}
diff --git a/src/routes/api-docs/+page.svelte b/src/routes/api-docs/+page.svelte
index b1803c5..7c12935 100644
--- a/src/routes/api-docs/+page.svelte
+++ b/src/routes/api-docs/+page.svelte
@@ -1,6 +1,41 @@
 <script lang="ts">
   import { onMount } from 'svelte';
 
+  const browserExample = `// Get user's pubkey (hex format) from NIP-07 extension
+const userPubkey = await window.nostr.getPublicKey();
+// Convert npub to hex if needed
+const userPubkeyHex = /* convert npub to hex */;
+
+// Make API request
+const response = await fetch('/api/repos/list', {
+  headers: {
+    'X-User-Pubkey': userPubkeyHex
+  }
+});
+const data = await response.json();`;
+
+  const nip98Example = `// Create NIP-98 auth event
+import { finalizeEvent } from 'nostr-tools';
+const authEvent = finalizeEvent({
+  kind: 27235, // NIP-98 auth kind
+  created_at: Math.floor(Date.now() / 1000),
+  tags: [
+    ['u', 'https://gitrepublic.com/api/repos/list'],
+    ['method', 'GET']
+  ],
+  content: ''
+}, privateKey);
+
+// Encode to base64
+const base64Event = btoa(JSON.stringify(authEvent));
+
+// Make API request
+const response = await fetch('https://gitrepublic.com/api/repos/list', {
+  headers: {
+    'Authorization': \`Nostr \${base64Event}\`
+  }
+});`;
+
   onMount(() => {
     // Load Swagger UI from local static files
     const link = document.createElement('link');
@@ -58,10 +93,24 @@
 <div class="api-docs-container">
   <div class="api-docs-header">
     <h1>GitRepublic API Documentation</h1>
-    <p>Interactive API documentation with Swagger UI. All endpoints use NIP-98 HTTP authentication.</p>
+    <p>Interactive API documentation with Swagger UI. The API can be used from both browsers and command-line tools.</p>
+    
+    <div class="auth-methods">
+      <div class="auth-method">
+        <h3>Browser Usage (Simplified)</h3>
+        <p>For browser-based applications, you can use the simpler <code>X-User-Pubkey</code> header method:</p>
+        <pre class="code-example"><code>{browserExample}</code></pre>
+      </div>
+
+      <div class="auth-method">
+        <h3>External Clients / CLI (NIP-98)</h3>
+        <p>For external clients, command-line tools, or cross-origin requests, use NIP-98 HTTP authentication:</p>
+        <pre class="code-example"><code>{nip98Example}</code></pre>
+      </div>
+    </div>
+
     <p class="note">
-      <strong>Note:</strong> To authenticate, you need to provide a NIP-98 Authorization header.
-      The format is: <code>Authorization: Nostr &lt;base64-encoded-event-json&gt;</code>
+      <strong>Note:</strong> The Swagger UI below uses NIP-98 authentication. For browser usage, you can also use the simpler <code>X-User-Pubkey</code> header method shown above.
     </p>
   </div>
   <div id="swagger-ui"></div>
@@ -108,6 +157,61 @@
     border: 1px solid var(--border-light);
   }
 
+  .auth-methods {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 1.5rem;
+    margin: 1.5rem 0;
+  }
+
+  .auth-method {
+    padding: 1rem;
+    background: var(--bg-secondary);
+    border: 1px solid var(--border-color);
+    border-radius: 0.5rem;
+  }
+
+  .auth-method h3 {
+    margin: 0 0 0.75rem 0;
+    color: var(--text-primary);
+    font-size: 1rem;
+    font-weight: 600;
+  }
+
+  .auth-method p {
+    margin: 0.5rem 0;
+    color: var(--text-secondary);
+    font-size: 0.875rem;
+  }
+
+  .code-example {
+    background: var(--bg-primary);
+    border: 1px solid var(--border-color);
+    border-radius: 0.375rem;
+    padding: 1rem;
+    margin: 0.75rem 0;
+    overflow-x: auto;
+  }
+
+  .code-example code {
+    display: block;
+    background: transparent;
+    border: none;
+    padding: 0;
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 0.8125rem;
+    line-height: 1.5;
+    color: var(--text-primary);
+    white-space: pre;
+  }
+
+  @media (max-width: 768px) {
+    .auth-methods {
+      grid-template-columns: 1fr;
+      gap: 1rem;
+    }
+  }
+
   .api-docs-header .note strong {
     color: var(--text-primary);
   }
@@ -508,6 +612,34 @@
     background: var(--button-secondary-hover);
   }
 
+  /* Authorize button and other control buttons */
+  :global(.swagger-ui .btn.authorize),
+  :global(.swagger-ui .authorize button) {
+    background: var(--accent) !important;
+    color: var(--accent-text, #ffffff) !important;
+    border: 1px solid var(--accent) !important;
+  }
+
+  :global(.swagger-ui .btn.authorize:hover),
+  :global(.swagger-ui .authorize button:hover) {
+    background: var(--accent-hover) !important;
+    border-color: var(--accent-hover) !important;
+  }
+
+  /* Expand/collapse controls */
+  :global(.swagger-ui .opblock-summary-control),
+  :global(.swagger-ui .opblock-summary-control:hover) {
+    color: var(--text-primary) !important;
+    background: transparent !important;
+  }
+
+  /* Arrow icons in expand/collapse */
+  :global(.swagger-ui .opblock-summary-control::after),
+  :global(.swagger-ui .opblock-summary-control::before) {
+    color: var(--text-primary) !important;
+    opacity: 1 !important;
+  }
+
   /* Response sections */
   :global(.swagger-ui .responses-wrapper) {
     background: var(--bg-secondary) !important;
@@ -623,13 +755,34 @@
     background: var(--bg-secondary) !important;
   }
 
-  :global(.swagger-ui .model-container .model-toggle) {
+  :global(.swagger-ui .model-container .model-toggle),
+  :global(.swagger-ui .model-toggle) {
     background: var(--bg-tertiary) !important;
     color: var(--text-primary) !important;
+    border: 1px solid var(--border-color) !important;
+    padding: 0.25rem 0.5rem !important;
+    border-radius: 0.25rem !important;
+    cursor: pointer !important;
+    display: inline-block !important;
+    font-weight: 500 !important;
+    transition: all 0.2s ease !important;
   }
 
-  :global(.swagger-ui .model-container .model-toggle:hover) {
+  :global(.swagger-ui .model-container .model-toggle:hover),
+  :global(.swagger-ui .model-toggle:hover) {
     background: var(--bg-secondary) !important;
+    border-color: var(--accent) !important;
+    color: var(--accent) !important;
+  }
+
+  :global(.swagger-ui .model-toggle.collapsed::before),
+  :global(.swagger-ui .model-toggle::before) {
+    color: var(--text-primary) !important;
+    opacity: 1 !important;
+  }
+
+  :global(.swagger-ui .model-toggle:hover::before) {
+    color: var(--accent) !important;
   }
 
   /* Tables */