v1.0.9

src/lib/oauthClientId.test.ts

@@ -0,0 +1,56 @@
+/*
+ * SPDX-FileCopyrightText: 2020 Stalwart Labs LLC <[email protected]>
+ *
+ * SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-SEL
+ */
+
+import { describe, it, expect, afterEach, vi } from 'vitest';
+
+const originalHead = document.head.innerHTML;
+
+async function loadWithMeta(meta: string) {
+  document.head.innerHTML = meta;
+  vi.resetModules();
+  const { getOAuthClientId } = await import('./oauthClientId');
+  return getOAuthClientId;
+}
+
+afterEach(() => {
+  document.head.innerHTML = originalHead;
+  vi.resetModules();
+});
+
+describe('getOAuthClientId', () => {
+  it('prefers the client id injected by the server', async () => {
+    const getOAuthClientId = await loadWithMeta('<meta name="oauth-client-id" content="pocket-id-client" />');
+    expect(getOAuthClientId()).toBe('pocket-id-client');
+  });
+
+  it('trims surrounding whitespace from the injected client id', async () => {
+    const getOAuthClientId = await loadWithMeta('<meta name="oauth-client-id" content="  pocket-id-client  " />');
+    expect(getOAuthClientId()).toBe('pocket-id-client');
+  });
+
+  it('falls back to the built-in default when the placeholder is empty', async () => {
+    const getOAuthClientId = await loadWithMeta('<meta name="oauth-client-id" content="" />');
+    expect(getOAuthClientId()).toBe('stalwart-webui');
+  });
+
+  it('falls back to the built-in default when the placeholder is only whitespace', async () => {
+    const getOAuthClientId = await loadWithMeta('<meta name="oauth-client-id" content="   " />');
+    expect(getOAuthClientId()).toBe('stalwart-webui');
+  });
+
+  it('falls back to the built-in default when the placeholder is absent', async () => {
+    const getOAuthClientId = await loadWithMeta('');
+    expect(getOAuthClientId()).toBe('stalwart-webui');
+  });
+
+  it('reads the document only once', async () => {
+    const getOAuthClientId = await loadWithMeta('<meta name="oauth-client-id" content="pocket-id-client" />');
+    expect(getOAuthClientId()).toBe('pocket-id-client');
+
+    document.head.innerHTML = '<meta name="oauth-client-id" content="changed-later" />';
+    expect(getOAuthClientId()).toBe('pocket-id-client');
+  });
+});

src/lib/oauthClientId.ts

@@ -0,0 +1,17 @@
+/*
+ * SPDX-FileCopyrightText: 2020 Stalwart Labs LLC <[email protected]>
+ *
+ * SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-SEL
+ */
+
+const DEFAULT_CLIENT_ID = 'stalwart-webui';
+
+let cached: string | undefined;
+
+export function getOAuthClientId(): string {
+  if (cached !== undefined) return cached;
+
+  const injected = document.querySelector('meta[name="oauth-client-id"]')?.getAttribute('content')?.trim();
+  cached = injected ? injected : DEFAULT_CLIENT_ID;
+  return cached;
+}