@viyv/account-client 0.1.0

package/dist/react.d.ts

@@ -0,0 +1,102 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { PlanTier, ProductSlug, EntitlementFeatures } from '@viyv/shared';
+export { EntitlementFeatures, PlanTier, ProductSlug } from '@viyv/shared';
+
+interface SignInButtonProps {
+    /** Where to return after sign-in. Default: current URL. */
+    returnTo?: string;
+    children?: ReactNode;
+    className?: string;
+}
+/** Redirects to the hosted sign-in page (app.viyv.io) with a return_to. */
+declare function SignInButton({ returnTo, children, className }: SignInButtonProps): react.DetailedReactHTMLElement<{
+    type: string;
+    className: string | undefined;
+    onClick: () => void;
+}, HTMLElement>;
+interface SignOutButtonProps {
+    children?: ReactNode;
+    className?: string;
+    onSignedOut?: () => void;
+}
+/** Signs out via better-auth and clears local account state. */
+declare function SignOutButton({ children, className, onSignedOut }: SignOutButtonProps): react.DetailedReactHTMLElement<{
+    type: string;
+    className: string | undefined;
+    onClick: () => Promise<void>;
+}, HTMLElement>;
+
+/** The signed-in user as returned by better-auth's get-session. */
+interface AccountUser {
+    id: string;
+    email: string;
+    name?: string | null;
+    image?: string | null;
+}
+/** Active organization, when the session carries one. */
+interface AccountOrg {
+    id: string;
+    slug?: string | null;
+    name?: string | null;
+}
+/** Shape of GET /v1/license/entitlement (docs/09 A-4). */
+interface Entitlement {
+    organizationId: string;
+    plan: PlanTier;
+    addons: string[];
+    /** Product slugs this org may use (free-start lists the agent family). */
+    products: ProductSlug[];
+    features: EntitlementFeatures;
+}
+/** Per-product entitlement view returned by useEntitlement(slug). */
+interface ProductEntitlement {
+    /** Whether the product is enabled for this org. */
+    enabled: boolean;
+    plan: PlanTier;
+    addons: string[];
+    /** The full feature map (callers branch on the flags they care about). */
+    features: EntitlementFeatures;
+}
+
+type AccountStatus = "loading" | "authenticated" | "unauthenticated";
+interface AccountContextValue {
+    status: AccountStatus;
+    user: AccountUser | null;
+    activeOrg: AccountOrg | null;
+    entitlement: Entitlement | null;
+    error: Error | null;
+    /** Re-fetch session + entitlement (e.g. after returning from checkout). */
+    refresh: () => Promise<void>;
+    /** Redirect to the hosted sign-in page (app.viyv.io) with a return_to. */
+    signIn: (returnTo?: string) => void;
+    /** Sign out via better-auth and drop local state. */
+    signOut: () => Promise<void>;
+    apiBase: string;
+    signInUrl: string;
+}
+interface AccountProviderProps {
+    /** e.g. "https://api.viyv.io" */
+    apiBase: string;
+    /** e.g. ".viyv.io" — kept for parity with docs/04 (cookies are server-set). */
+    cookieDomain?: string;
+    /** Hosted sign-in page. Default "https://app.viyv.io/signin". */
+    signInUrl?: string;
+    /** Skip the entitlement fetch (session-only consumers). Default false. */
+    skipEntitlement?: boolean;
+    children?: ReactNode;
+}
+declare function AccountProvider({ apiBase, cookieDomain, signInUrl, skipEntitlement, children, }: AccountProviderProps): react.FunctionComponentElement<react.ProviderProps<AccountContextValue | null>>;
+/** Read the full account context. Throws if used outside <AccountProvider>. */
+declare function useAccount(): AccountContextValue;
+/** The signed-in user, or null when unauthenticated/loading. */
+declare function useUser(): AccountUser | null;
+/** The active organization, or null. */
+declare function useActiveOrg(): AccountOrg | null;
+/**
+ * Per-product entitlement view. Returns null while loading / unauthenticated.
+ * Web products gate features on the returned `enabled` + `features` flags.
+ */
+declare function useEntitlement(product: ProductSlug): ProductEntitlement | null;
+
+export { type AccountContextValue, type AccountOrg, AccountProvider, type AccountProviderProps, type AccountStatus, type AccountUser, type Entitlement, type ProductEntitlement, SignInButton, type SignInButtonProps, SignOutButton, type SignOutButtonProps, useAccount, useActiveOrg, useEntitlement, useUser };

package/dist/react.js

@@ -0,0 +1,206 @@
+import { createContext, useRef, useState, useCallback, useEffect, useMemo, createElement, useContext } from 'react';
+import { createAuthClient } from 'better-auth/client';
+
+// src/entitlement.ts
+function parseEntitlement(wire) {
+  return {
+    organizationId: wire.organization_id,
+    plan: wire.plan,
+    addons: wire.addons ?? [],
+    products: wire.products ?? [],
+    features: wire.features
+  };
+}
+function entitlementForProduct(entitlement, product) {
+  if (!entitlement) return null;
+  return {
+    enabled: entitlement.products.includes(product),
+    plan: entitlement.plan,
+    addons: entitlement.addons,
+    features: entitlement.features
+  };
+}
+function createAccountClient(config) {
+  const client = createAuthClient({
+    baseURL: config.apiBase,
+    basePath: "/v1/auth",
+    fetchOptions: { credentials: "include" }
+  });
+  return {
+    raw: client,
+    signUp: (params) => client.signUp.email({
+      email: params.email,
+      password: params.password,
+      name: params.name ?? params.email.split("@")[0] ?? params.email
+    }),
+    signIn: (params) => client.signIn.email({
+      email: params.email,
+      password: params.password
+    }),
+    signOut: () => client.signOut(),
+    getSession: () => client.getSession()
+  };
+}
+
+// src/provider.tsx
+async function fetchJson(doFetch, url, signal) {
+  const res = await doFetch(url, { credentials: "include", signal });
+  if (res.status === 401 || res.status === 404) return null;
+  if (!res.ok) throw new Error(`${url} \u2192 ${res.status}`);
+  const text = await res.text();
+  if (!text || text === "null") return null;
+  return JSON.parse(text);
+}
+var SIGNED_OUT = {
+  status: "unauthenticated",
+  user: null,
+  activeOrg: null,
+  entitlement: null
+};
+async function loadAccount(apiBase, opts = {}) {
+  const doFetch = opts.fetchImpl ?? fetch;
+  const session = await fetchJson(
+    doFetch,
+    `${apiBase}/v1/auth/get-session`,
+    opts.signal
+  );
+  if (!session?.user) return SIGNED_OUT;
+  const user = {
+    id: session.user.id,
+    email: session.user.email,
+    name: session.user.name ?? null,
+    image: session.user.image ?? null
+  };
+  const [ent, orgsBody] = await Promise.all([
+    opts.skipEntitlement ? Promise.resolve(null) : fetchJson(
+      doFetch,
+      `${apiBase}/v1/license/entitlement`,
+      opts.signal
+    ),
+    fetchJson(doFetch, `${apiBase}/v1/users/me/orgs`, opts.signal)
+  ]);
+  const entitlement = ent ? parseEntitlement(ent) : null;
+  const activeId = session.session?.activeOrganizationId ?? entitlement?.organizationId ?? null;
+  const orgs = orgsBody?.organizations ?? [];
+  const match = activeId ? orgs.find((o) => o.organization_id === activeId) : orgs[0];
+  const activeOrg = match ? { id: match.organization_id, slug: match.slug ?? null, name: match.name ?? null } : activeId ? { id: activeId, slug: null, name: null } : null;
+  return { status: "authenticated", user, activeOrg, entitlement };
+}
+var AccountContext = createContext(null);
+function AccountProvider({
+  apiBase,
+  cookieDomain,
+  signInUrl = "https://app.viyv.io/signin",
+  skipEntitlement = false,
+  children
+}) {
+  const clientRef = useRef(null);
+  if (!clientRef.current) {
+    clientRef.current = createAccountClient({ apiBase});
+  }
+  const [status, setStatus] = useState("loading");
+  const [user, setUser] = useState(null);
+  const [activeOrg, setActiveOrg] = useState(null);
+  const [entitlement, setEntitlement] = useState(null);
+  const [error, setError] = useState(null);
+  const load = useCallback(
+    async (signal) => {
+      try {
+        setError(null);
+        const result = await loadAccount(apiBase, { skipEntitlement, signal });
+        setUser(result.user);
+        setActiveOrg(result.activeOrg);
+        setEntitlement(result.entitlement);
+        setStatus(result.status);
+      } catch (err) {
+        if (signal?.aborted) return;
+        setError(err instanceof Error ? err : new Error(String(err)));
+        setUser(null);
+        setActiveOrg(null);
+        setEntitlement(null);
+        setStatus("unauthenticated");
+      }
+    },
+    [apiBase, skipEntitlement]
+  );
+  useEffect(() => {
+    const ctrl = new AbortController();
+    void load(ctrl.signal);
+    return () => ctrl.abort();
+  }, [load]);
+  const signIn = useCallback(
+    (returnTo) => {
+      if (typeof window === "undefined") return;
+      const back = returnTo ?? window.location.href;
+      window.location.assign(`${signInUrl}?return_to=${encodeURIComponent(back)}`);
+    },
+    [signInUrl]
+  );
+  const signOut = useCallback(async () => {
+    await clientRef.current?.signOut();
+    setUser(null);
+    setActiveOrg(null);
+    setEntitlement(null);
+    setStatus("unauthenticated");
+  }, []);
+  const value = useMemo(
+    () => ({
+      status,
+      user,
+      activeOrg,
+      entitlement,
+      error,
+      refresh: () => load(),
+      signIn,
+      signOut,
+      apiBase,
+      signInUrl
+    }),
+    [status, user, activeOrg, entitlement, error, load, signIn, signOut, apiBase, signInUrl]
+  );
+  return createElement(AccountContext.Provider, { value }, children);
+}
+function useAccount() {
+  const ctx = useContext(AccountContext);
+  if (!ctx) throw new Error("useAccount must be used within <AccountProvider>");
+  return ctx;
+}
+function useUser() {
+  return useAccount().user;
+}
+function useActiveOrg() {
+  return useAccount().activeOrg;
+}
+function useEntitlement(product) {
+  const { entitlement } = useAccount();
+  return useMemo(() => entitlementForProduct(entitlement, product), [entitlement, product]);
+}
+
+// src/components.tsx
+function SignInButton({ returnTo, children, className }) {
+  const { signIn } = useAccount();
+  return createElement(
+    "button",
+    { type: "button", className, onClick: () => signIn(returnTo) },
+    children ?? "Sign in"
+  );
+}
+function SignOutButton({ children, className, onSignedOut }) {
+  const { signOut } = useAccount();
+  return createElement(
+    "button",
+    {
+      type: "button",
+      className,
+      onClick: async () => {
+        await signOut();
+        onSignedOut?.();
+      }
+    },
+    children ?? "Sign out"
+  );
+}
+
+export { AccountProvider, SignInButton, SignOutButton, useAccount, useActiveOrg, useEntitlement, useUser };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/server.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+// src/entitlement.ts
+function parseEntitlement(wire) {
+  return {
+    organizationId: wire.organization_id,
+    plan: wire.plan,
+    addons: wire.addons ?? [],
+    products: wire.products ?? [],
+    features: wire.features
+  };
+}
+
+// src/server.ts
+async function getJson(url, cookie) {
+  const res = await fetch(url, {
+    headers: { cookie },
+    // Server fetch: never cache an auth-scoped read.
+    cache: "no-store"
+  });
+  if (res.status === 401 || res.status === 404) return null;
+  if (!res.ok) throw new Error(`${url} \u2192 ${res.status}`);
+  const text = await res.text();
+  if (!text || text === "null") return null;
+  return JSON.parse(text);
+}
+async function getCurrentSession(config) {
+  const session = await getJson(`${config.apiBase}/v1/auth/get-session`, config.cookie);
+  if (!session?.user) return null;
+  return {
+    user: {
+      id: session.user.id,
+      email: session.user.email,
+      name: session.user.name ?? null,
+      image: session.user.image ?? null
+    },
+    activeOrganizationId: session.session?.activeOrganizationId ?? null
+  };
+}
+async function getEntitlement(config) {
+  const wire = await getJson(
+    `${config.apiBase}/v1/license/entitlement`,
+    config.cookie
+  );
+  return wire ? parseEntitlement(wire) : null;
+}
+
+exports.getCurrentSession = getCurrentSession;
+exports.getEntitlement = getEntitlement;
+//# sourceMappingURL=server.cjs.map
+//# sourceMappingURL=server.cjs.map

package/dist/server.d.cts

@@ -0,0 +1,21 @@
+import { a as AccountUser, E as Entitlement } from './entitlement-B3pXM2vO.cjs';
+import '@viyv/shared';
+
+interface ServerSessionConfig {
+    /** e.g. "https://api.viyv.io" */
+    apiBase: string;
+    /**
+     * The incoming `Cookie` header to forward (server has no ambient cookie jar).
+     * In Next RSC: `cookies().toString()` or `headers().get("cookie")`.
+     */
+    cookie: string;
+}
+/** Resolve the signed-in user from forwarded cookies (or null). */
+declare function getCurrentSession(config: ServerSessionConfig): Promise<{
+    user: AccountUser;
+    activeOrganizationId: string | null;
+} | null>;
+/** Resolve the org entitlement from forwarded cookies (or null). */
+declare function getEntitlement(config: ServerSessionConfig): Promise<Entitlement | null>;
+
+export { type ServerSessionConfig, getCurrentSession, getEntitlement };

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+import { a as AccountUser, E as Entitlement } from './entitlement-B3pXM2vO.js';
+import '@viyv/shared';
+
+interface ServerSessionConfig {
+    /** e.g. "https://api.viyv.io" */
+    apiBase: string;
+    /**
+     * The incoming `Cookie` header to forward (server has no ambient cookie jar).
+     * In Next RSC: `cookies().toString()` or `headers().get("cookie")`.
+     */
+    cookie: string;
+}
+/** Resolve the signed-in user from forwarded cookies (or null). */
+declare function getCurrentSession(config: ServerSessionConfig): Promise<{
+    user: AccountUser;
+    activeOrganizationId: string | null;
+} | null>;
+/** Resolve the org entitlement from forwarded cookies (or null). */
+declare function getEntitlement(config: ServerSessionConfig): Promise<Entitlement | null>;
+
+export { type ServerSessionConfig, getCurrentSession, getEntitlement };

package/dist/server.js

@@ -0,0 +1,39 @@
+import { parseEntitlement } from './chunk-UX6UAFIF.js';
+
+// src/server.ts
+async function getJson(url, cookie) {
+  const res = await fetch(url, {
+    headers: { cookie },
+    // Server fetch: never cache an auth-scoped read.
+    cache: "no-store"
+  });
+  if (res.status === 401 || res.status === 404) return null;
+  if (!res.ok) throw new Error(`${url} \u2192 ${res.status}`);
+  const text = await res.text();
+  if (!text || text === "null") return null;
+  return JSON.parse(text);
+}
+async function getCurrentSession(config) {
+  const session = await getJson(`${config.apiBase}/v1/auth/get-session`, config.cookie);
+  if (!session?.user) return null;
+  return {
+    user: {
+      id: session.user.id,
+      email: session.user.email,
+      name: session.user.name ?? null,
+      image: session.user.image ?? null
+    },
+    activeOrganizationId: session.session?.activeOrganizationId ?? null
+  };
+}
+async function getEntitlement(config) {
+  const wire = await getJson(
+    `${config.apiBase}/v1/license/entitlement`,
+    config.cookie
+  );
+  return wire ? parseEntitlement(wire) : null;
+}
+
+export { getCurrentSession, getEntitlement };
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@viyv/account-client",
+  "version": "0.1.0",
+  "description": "React SDK for viyv account SSO (useUser, useEntitlement, AccountProvider).",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./introspect": {
+      "types": "./dist/introspect.d.ts",
+      "import": "./dist/introspect.js",
+      "require": "./dist/introspect.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "better-auth": "^1.6.12"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.3",
+    "react": "^19.2.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@viyv/shared": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "test": "vitest run"
+  }
+}