dsh-subscriptions 0.1.0

package/lib/client/subscriptions-rpc.js

@@ -0,0 +1,34 @@
+/**
+ * The node half mounts every endpoint as an exact POST route on the shared
+ * `/api` channel (`/api/subscriptions-auth.<endpoint>`), so the browser
+ * reaches it through the `/api` channel with a prefixed endpoint name.
+ * A dedicated channel is no longer used: since dsh 0.1.5 `rpc.handle`
+ * cannot register one from a plugin (see `src/auth/rpc.ts`).
+ */
+const SUBSCRIPTIONS_AUTH_CHANNEL = '/api';
+const SUBSCRIPTIONS_AUTH_PREFIX = 'subscriptions-auth.';
+/** Business error returned by a `subscriptions-auth` endpoint (error branch message). */
+export class SubscriptionsAuthError extends Error {
+}
+/**
+ * Call one `subscriptions-auth` endpoint and unwrap the business result.
+ * Shared by the settings section, the composer Speed toggle, the usage
+ * badge, and the image/video toolviews.
+ * @param rpc - Connection RPC caller.
+ * @param endpoint - endpoint name (`status`, `usage`, `image`, ...).
+ * @param payload - endpoint-owned request payload.
+ * @returns the success value, cast by the caller to the endpoint's shape.
+ */
+export async function callSubscriptionsAuth(rpc, endpoint, payload) {
+    let result;
+    try {
+        result = await rpc.call(SUBSCRIPTIONS_AUTH_CHANNEL, `${SUBSCRIPTIONS_AUTH_PREFIX}${endpoint}`, payload);
+    }
+    catch (error) {
+        // The transport rejected rather than answering; surface the same way.
+        throw new SubscriptionsAuthError(error instanceof Error ? error.message : String(error));
+    }
+    if (!result.ok)
+        throw new SubscriptionsAuthError(result.error.message);
+    return result.value;
+}

package/lib/client/usage-badge-preferences.d.ts

@@ -0,0 +1,11 @@
+/** Display-only preference: no credentials or account history are stored. */
+export type UsageBadgeMode = 'recent' | 'hidden';
+export declare const USAGE_BADGE_REFRESH_EVENT = "dsh:subscriptions:usage-refresh";
+/** Read the browser preference; blocked storage retains the default display. */
+export declare function readUsageBadgeMode(): UsageBadgeMode;
+/** Save first, then notify; the settings control reports a rejected write. */
+export declare function setUsageBadgeMode(mode: UsageBadgeMode): void;
+/** Same-tab writes need a custom event; other tabs use the storage event. */
+export declare function subscribeUsageBadgeMode(notify: () => void): () => void;
+/** Shared React snapshot used by the settings control and every mounted badge. */
+export declare function useUsageBadgeMode(): UsageBadgeMode;

package/lib/client/usage-badge-preferences.js

@@ -0,0 +1,41 @@
+import { useSyncExternalStore } from 'react';
+const MODE_KEY = 'dsh.subscriptions.usageBadgeMode';
+const MODE_EVENT = 'dsh:subscriptions:usage-badge-mode';
+export const USAGE_BADGE_REFRESH_EVENT = 'dsh:subscriptions:usage-refresh';
+/** Read the browser preference; blocked storage retains the default display. */
+export function readUsageBadgeMode() {
+    if (typeof window === 'undefined')
+        return 'recent';
+    try {
+        return window.localStorage.getItem(MODE_KEY) === 'hidden' ? 'hidden' : 'recent';
+    }
+    catch (error) {
+        if (!(error instanceof DOMException) || error.name !== 'SecurityError')
+            throw error;
+        return 'recent';
+    }
+}
+/** Save first, then notify; the settings control reports a rejected write. */
+export function setUsageBadgeMode(mode) {
+    if (mode !== 'recent' && mode !== 'hidden')
+        throw new TypeError('Invalid subscription usage display mode');
+    window.localStorage.setItem(MODE_KEY, mode);
+    window.dispatchEvent(new Event(MODE_EVENT));
+}
+/** Same-tab writes need a custom event; other tabs use the storage event. */
+export function subscribeUsageBadgeMode(notify) {
+    const onStorage = (event) => {
+        if (event.key === MODE_KEY || event.key === null)
+            notify();
+    };
+    window.addEventListener(MODE_EVENT, notify);
+    window.addEventListener('storage', onStorage);
+    return () => {
+        window.removeEventListener(MODE_EVENT, notify);
+        window.removeEventListener('storage', onStorage);
+    };
+}
+/** Shared React snapshot used by the settings control and every mounted badge. */
+export function useUsageBadgeMode() {
+    return useSyncExternalStore(subscribeUsageBadgeMode, readUsageBadgeMode, () => 'recent');
+}