@viyv/account-client 0.1.0 → 0.2.0

package/dist/react.cjs

@@ -60,6 +60,7 @@ var SIGNED_OUT = {
   entitlement: null
 };
 async function loadAccount(apiBase, opts = {}) {
+  if (opts.devAccount) return opts.devAccount;
   const doFetch = opts.fetchImpl ?? fetch;
   const session = await fetchJson(
     doFetch,
@@ -94,6 +95,7 @@ function AccountProvider({
   cookieDomain,
   signInUrl = "https://app.viyv.io/signin",
   skipEntitlement = false,
+  devAccount,
   children
 }) {
   const clientRef = react.useRef(null);
@@ -109,7 +111,7 @@ function AccountProvider({
     async (signal) => {
       try {
         setError(null);
-        const result = await loadAccount(apiBase, { skipEntitlement, signal });
+        const result = await loadAccount(apiBase, { skipEntitlement, signal, devAccount });
         setUser(result.user);
         setActiveOrg(result.activeOrg);
         setEntitlement(result.entitlement);
@@ -123,7 +125,7 @@ function AccountProvider({
         setStatus("unauthenticated");
       }
     },
-    [apiBase, skipEntitlement]
+    [apiBase, skipEntitlement, devAccount]
   );
   react.useEffect(() => {
     const ctrl = new AbortController();
@@ -206,6 +208,7 @@ function SignOutButton({ children, className, onSignedOut }) {
 exports.AccountProvider = AccountProvider;
 exports.SignInButton = SignInButton;
 exports.SignOutButton = SignOutButton;
+exports.loadAccount = loadAccount;
 exports.useAccount = useAccount;
 exports.useActiveOrg = useActiveOrg;
 exports.useEntitlement = useEntitlement;

package/dist/react.d.cts

@@ -60,6 +60,29 @@ interface ProductEntitlement {
 }
 
 type AccountStatus = "loading" | "authenticated" | "unauthenticated";
+interface LoadedAccount {
+    status: "authenticated" | "unauthenticated";
+    user: AccountUser | null;
+    activeOrg: AccountOrg | null;
+    entitlement: Entitlement | null;
+}
+/**
+ * Resolve the current account (session + active org + entitlement) from
+ * api.viyv.io using the `.viyv.io` cookie. Pure + DOM-free so it is unit-testable
+ * with a mocked fetch. Throws on a transport/HTTP error (the caller decides how
+ * to surface it); a missing session resolves to {@link SIGNED_OUT}.
+ */
+declare function loadAccount(apiBase: string, opts?: {
+    skipEntitlement?: boolean;
+    signal?: AbortSignal;
+    fetchImpl?: typeof fetch;
+    /**
+     * Dev escape hatch: when supplied, short-circuit ALL network I/O and resolve
+     * to this synthetic account. Intended for local `next dev` against an
+     * unreachable viyv-account. Env-agnostic — the consumer owns the gate.
+     */
+    devAccount?: LoadedAccount | null;
+}): Promise<LoadedAccount>;
 interface AccountContextValue {
     status: AccountStatus;
     user: AccountUser | null;
@@ -84,9 +107,15 @@ interface AccountProviderProps {
     signInUrl?: string;
     /** Skip the entitlement fetch (session-only consumers). Default false. */
     skipEntitlement?: boolean;
+    /**
+     * Dev escape hatch: a synthetic account to render instead of fetching from
+     * api.viyv.io. Intended for local `next dev` (gate it on a NEXT_PUBLIC_* flag
+     * the consumer owns). null/undefined → normal cookie-session flow.
+     */
+    devAccount?: LoadedAccount | null;
     children?: ReactNode;
 }
-declare function AccountProvider({ apiBase, cookieDomain, signInUrl, skipEntitlement, children, }: AccountProviderProps): react.FunctionComponentElement<react.ProviderProps<AccountContextValue | null>>;
+declare function AccountProvider({ apiBase, cookieDomain, signInUrl, skipEntitlement, devAccount, 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. */
@@ -99,4 +128,4 @@ declare function useActiveOrg(): AccountOrg | null;
  */
 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 };
+export { type AccountContextValue, type AccountOrg, AccountProvider, type AccountProviderProps, type AccountStatus, type AccountUser, type Entitlement, type LoadedAccount, type ProductEntitlement, SignInButton, type SignInButtonProps, SignOutButton, type SignOutButtonProps, loadAccount, useAccount, useActiveOrg, useEntitlement, useUser };

package/dist/react.d.ts

@@ -60,6 +60,29 @@ interface ProductEntitlement {
 }
 
 type AccountStatus = "loading" | "authenticated" | "unauthenticated";
+interface LoadedAccount {
+    status: "authenticated" | "unauthenticated";
+    user: AccountUser | null;
+    activeOrg: AccountOrg | null;
+    entitlement: Entitlement | null;
+}
+/**
+ * Resolve the current account (session + active org + entitlement) from
+ * api.viyv.io using the `.viyv.io` cookie. Pure + DOM-free so it is unit-testable
+ * with a mocked fetch. Throws on a transport/HTTP error (the caller decides how
+ * to surface it); a missing session resolves to {@link SIGNED_OUT}.
+ */
+declare function loadAccount(apiBase: string, opts?: {
+    skipEntitlement?: boolean;
+    signal?: AbortSignal;
+    fetchImpl?: typeof fetch;
+    /**
+     * Dev escape hatch: when supplied, short-circuit ALL network I/O and resolve
+     * to this synthetic account. Intended for local `next dev` against an
+     * unreachable viyv-account. Env-agnostic — the consumer owns the gate.
+     */
+    devAccount?: LoadedAccount | null;
+}): Promise<LoadedAccount>;
 interface AccountContextValue {
     status: AccountStatus;
     user: AccountUser | null;
@@ -84,9 +107,15 @@ interface AccountProviderProps {
     signInUrl?: string;
     /** Skip the entitlement fetch (session-only consumers). Default false. */
     skipEntitlement?: boolean;
+    /**
+     * Dev escape hatch: a synthetic account to render instead of fetching from
+     * api.viyv.io. Intended for local `next dev` (gate it on a NEXT_PUBLIC_* flag
+     * the consumer owns). null/undefined → normal cookie-session flow.
+     */
+    devAccount?: LoadedAccount | null;
     children?: ReactNode;
 }
-declare function AccountProvider({ apiBase, cookieDomain, signInUrl, skipEntitlement, children, }: AccountProviderProps): react.FunctionComponentElement<react.ProviderProps<AccountContextValue | null>>;
+declare function AccountProvider({ apiBase, cookieDomain, signInUrl, skipEntitlement, devAccount, 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. */
@@ -99,4 +128,4 @@ declare function useActiveOrg(): AccountOrg | null;
  */
 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 };
+export { type AccountContextValue, type AccountOrg, AccountProvider, type AccountProviderProps, type AccountStatus, type AccountUser, type Entitlement, type LoadedAccount, type ProductEntitlement, SignInButton, type SignInButtonProps, SignOutButton, type SignOutButtonProps, loadAccount, useAccount, useActiveOrg, useEntitlement, useUser };

package/dist/react.js

@@ -58,6 +58,7 @@ var SIGNED_OUT = {
   entitlement: null
 };
 async function loadAccount(apiBase, opts = {}) {
+  if (opts.devAccount) return opts.devAccount;
   const doFetch = opts.fetchImpl ?? fetch;
   const session = await fetchJson(
     doFetch,
@@ -92,6 +93,7 @@ function AccountProvider({
   cookieDomain,
   signInUrl = "https://app.viyv.io/signin",
   skipEntitlement = false,
+  devAccount,
   children
 }) {
   const clientRef = useRef(null);
@@ -107,7 +109,7 @@ function AccountProvider({
     async (signal) => {
       try {
         setError(null);
-        const result = await loadAccount(apiBase, { skipEntitlement, signal });
+        const result = await loadAccount(apiBase, { skipEntitlement, signal, devAccount });
         setUser(result.user);
         setActiveOrg(result.activeOrg);
         setEntitlement(result.entitlement);
@@ -121,7 +123,7 @@ function AccountProvider({
         setStatus("unauthenticated");
       }
     },
-    [apiBase, skipEntitlement]
+    [apiBase, skipEntitlement, devAccount]
   );
   useEffect(() => {
     const ctrl = new AbortController();
@@ -201,6 +203,6 @@ function SignOutButton({ children, className, onSignedOut }) {
   );
 }
 
-export { AccountProvider, SignInButton, SignOutButton, useAccount, useActiveOrg, useEntitlement, useUser };
+export { AccountProvider, SignInButton, SignOutButton, loadAccount, useAccount, useActiveOrg, useEntitlement, useUser };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viyv/account-client",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "React SDK for viyv account SSO (useUser, useEntitlement, AccountProvider).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -36,6 +36,12 @@
     "access": "public"
   },
   "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "test": "vitest run"
+  },
   "peerDependencies": {
     "react": ">=18"
   },
@@ -48,17 +54,11 @@
     "better-auth": "^1.6.12"
   },
   "devDependencies": {
+    "@viyv/shared": "workspace:*",
     "@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"
+    "vitest": "^3.2.4"
   }
-}
+}

package/LICENSE

@@ -1,27 +0,0 @@
-Copyright (c) 2026 viyv. All Rights Reserved.
-
-PROPRIETARY AND CONFIDENTIAL
-
-This software and its source code (the "Software") are the proprietary and
-confidential property of viyv. Unauthorized copying, distribution,
-modification, public display, public performance, reverse engineering, or
-commercial use of the Software, in whole or in part, via any medium, is
-strictly prohibited without the express prior written permission of viyv.
-
-No license, express or implied, by estoppel or otherwise, to any intellectual
-property rights is granted by this document. The receipt or possession of the
-Software does not convey or imply any right to use, reproduce, disclose, or
-distribute its contents.
-
-Separately published SDK packages (e.g. @viyv/account-client,
-@viyv/license-verify) may be distributed as compiled artifacts under their own
-published package terms; that distribution does not grant any rights to this
-repository's source code.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.