@lunnoa/client 2.0.0 → 2.1.0

package/dist/react.d.cts

@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
 import { UIMessage, UIMessageChunk } from 'ai';
 
 /**
- * Pluggable storage for Pattern B JWTs.
+ * Pluggable storage for Lunnoa user JWTs.
  * The SDK never uses httpOnly cookies: Automate auth is bearer JWT based.
  */
 interface TokenStore {
@@ -24,20 +24,20 @@ interface LunnoaClientOptions {
      */
     baseUrl: string;
     /**
-     * Server-side machine credential (`lna_...`). Never usable in browsers —
-     * the constructor throws if one is supplied while `window` exists.
+     * Machine credential (`lna_...`) for the CLI and operator scripts, not for app login.
+     * Never usable in browsers: the constructor throws if one is supplied while `window` exists.
      */
     apiKey?: string;
     /**
      * User JWT obtained from login / SSO. The supported credential for browser
      * applications. May be a function so refreshed tokens are picked up per request.
      *
-     * Prefer {@link tokenStore} for Pattern B so login/refresh can persist tokens
+     * Prefer {@link tokenStore} so login/refresh can persist tokens
      * and optionally auto-refresh on 401.
      */
     accessToken?: string | (() => string | Promise<string>);
     /**
-     * Optional JWT store for Pattern B. When set, authenticated requests read
+     * Optional JWT store for a signed-in Lunnoa user. When set, authenticated requests read
      * the access token from the store. Login / refresh helpers write back into it.
      */
     tokenStore?: TokenStore;
@@ -2796,7 +2796,7 @@ interface CurrentUser {
 }
 
 /**
- * Login, refresh, SSO discovery, and session helpers for Pattern B.
+ * Login, refresh, SSO discovery, and session helpers for Lunnoa users.
  *
  * Password login, token exchange, refresh, and SSO provider listing are
  * **public** endpoints (no Bearer). `me()` requires a user JWT.
@@ -3453,28 +3453,21 @@ declare class WorkflowsResource {
 /**
  * Typed client for the Lunnoa Automate Public API.
  *
- * Server-side (Pattern A — the backend holds the key):
- * ```ts
- * const lunnoa = new LunnoaClient({
- *   baseUrl: 'https://lunnoa.acme.example',
- *   apiKey: process.env.LUNNOA_API_KEY, // lna_...
- * });
- * ```
- *
- * Browser (Pattern B — the end user is a Lunnoa user):
+ * Apps sign people in as Lunnoa users:
  * ```ts
  * import { createBrowserClient } from '@lunnoa/client';
  * const lunnoa = createBrowserClient({ baseUrl: 'https://lunnoa.acme.example' });
  * await lunnoa.auth.login({ email, password });
  * ```
  *
- * Passing an `lna_` API key in a browser throws immediately: API keys are
- * workspace-wide server credentials and must never ship to browsers.
+ * `apiKey` (`lna_...`) is for the CLI and operator scripts (codegen, discovery,
+ * deploy). It is not an app login. Passing one while `window` exists throws:
+ * a leaked key acts as that service account across its whole workspace.
  */
 declare class LunnoaClient {
     /** The underlying HTTP layer, exposed for advanced/escape-hatch requests. */
     readonly http: HttpClient;
-    /** Login, refresh, SSO discovery, and session helpers (Pattern B). */
+    /** Login, refresh, SSO discovery, and session helpers for Lunnoa users. */
     readonly auth: AuthResource;
     readonly agents: AgentsResource;
     readonly tasks: TasksResource;
@@ -3525,7 +3518,7 @@ interface CreateBrowserClientOptions {
 
 type AuthStatus = 'loading' | 'authenticated' | 'unauthenticated';
 interface LunnoaAuthContextValue {
-    /** Shared Lunnoa client (Pattern B token store). */
+    /** Shared Lunnoa client (user JWT token store). */
     client: LunnoaClient;
     /** Current user from `GET /api/users/me`, or null when signed out. */
     user: CurrentUser | null;
@@ -3567,7 +3560,7 @@ interface LunnoaAuthContextValue {
     getAccessToken: () => Promise<string | null>;
 }
 type LunnoaAuthProviderProps = {
-    /** Existing Pattern B client (from `createBrowserClient`). */
+    /** Existing browser client (from `createBrowserClient`). */
     client: LunnoaClient;
     children: ReactNode;
 } | (CreateBrowserClientOptions & {
@@ -3575,7 +3568,7 @@ type LunnoaAuthProviderProps = {
     children: ReactNode;
 });
 /**
- * Provides a Pattern B Lunnoa client and session helpers to React trees.
+ * Provides a Lunnoa user client and session helpers to React trees.
  *
  * ```tsx
  * <LunnoaAuthProvider baseUrl={import.meta.env.VITE_LUNNOA_URL}>
@@ -3584,7 +3577,7 @@ type LunnoaAuthProviderProps = {
  * ```
  */
 declare function LunnoaAuthProvider(props: LunnoaAuthProviderProps): react.FunctionComponentElement<react.ProviderProps<LunnoaAuthContextValue | null>>;
-/** Full auth session API for Pattern B React apps. */
+/** Full auth session API for React apps whose users sign in to Lunnoa. */
 declare function useLunnoaAuth(): LunnoaAuthContextValue;
 /** The Lunnoa client from the nearest {@link LunnoaAuthProvider}. */
 declare function useLunnoaClient(): LunnoaClient;

package/dist/react.d.ts

@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
 import { UIMessage, UIMessageChunk } from 'ai';
 
 /**
- * Pluggable storage for Pattern B JWTs.
+ * Pluggable storage for Lunnoa user JWTs.
  * The SDK never uses httpOnly cookies: Automate auth is bearer JWT based.
  */
 interface TokenStore {
@@ -24,20 +24,20 @@ interface LunnoaClientOptions {
      */
     baseUrl: string;
     /**
-     * Server-side machine credential (`lna_...`). Never usable in browsers —
-     * the constructor throws if one is supplied while `window` exists.
+     * Machine credential (`lna_...`) for the CLI and operator scripts, not for app login.
+     * Never usable in browsers: the constructor throws if one is supplied while `window` exists.
      */
     apiKey?: string;
     /**
      * User JWT obtained from login / SSO. The supported credential for browser
      * applications. May be a function so refreshed tokens are picked up per request.
      *
-     * Prefer {@link tokenStore} for Pattern B so login/refresh can persist tokens
+     * Prefer {@link tokenStore} so login/refresh can persist tokens
      * and optionally auto-refresh on 401.
      */
     accessToken?: string | (() => string | Promise<string>);
     /**
-     * Optional JWT store for Pattern B. When set, authenticated requests read
+     * Optional JWT store for a signed-in Lunnoa user. When set, authenticated requests read
      * the access token from the store. Login / refresh helpers write back into it.
      */
     tokenStore?: TokenStore;
@@ -2796,7 +2796,7 @@ interface CurrentUser {
 }
 
 /**
- * Login, refresh, SSO discovery, and session helpers for Pattern B.
+ * Login, refresh, SSO discovery, and session helpers for Lunnoa users.
  *
  * Password login, token exchange, refresh, and SSO provider listing are
  * **public** endpoints (no Bearer). `me()` requires a user JWT.
@@ -3453,28 +3453,21 @@ declare class WorkflowsResource {
 /**
  * Typed client for the Lunnoa Automate Public API.
  *
- * Server-side (Pattern A — the backend holds the key):
- * ```ts
- * const lunnoa = new LunnoaClient({
- *   baseUrl: 'https://lunnoa.acme.example',
- *   apiKey: process.env.LUNNOA_API_KEY, // lna_...
- * });
- * ```
- *
- * Browser (Pattern B — the end user is a Lunnoa user):
+ * Apps sign people in as Lunnoa users:
  * ```ts
  * import { createBrowserClient } from '@lunnoa/client';
  * const lunnoa = createBrowserClient({ baseUrl: 'https://lunnoa.acme.example' });
  * await lunnoa.auth.login({ email, password });
  * ```
  *
- * Passing an `lna_` API key in a browser throws immediately: API keys are
- * workspace-wide server credentials and must never ship to browsers.
+ * `apiKey` (`lna_...`) is for the CLI and operator scripts (codegen, discovery,
+ * deploy). It is not an app login. Passing one while `window` exists throws:
+ * a leaked key acts as that service account across its whole workspace.
  */
 declare class LunnoaClient {
     /** The underlying HTTP layer, exposed for advanced/escape-hatch requests. */
     readonly http: HttpClient;
-    /** Login, refresh, SSO discovery, and session helpers (Pattern B). */
+    /** Login, refresh, SSO discovery, and session helpers for Lunnoa users. */
     readonly auth: AuthResource;
     readonly agents: AgentsResource;
     readonly tasks: TasksResource;
@@ -3525,7 +3518,7 @@ interface CreateBrowserClientOptions {
 
 type AuthStatus = 'loading' | 'authenticated' | 'unauthenticated';
 interface LunnoaAuthContextValue {
-    /** Shared Lunnoa client (Pattern B token store). */
+    /** Shared Lunnoa client (user JWT token store). */
     client: LunnoaClient;
     /** Current user from `GET /api/users/me`, or null when signed out. */
     user: CurrentUser | null;
@@ -3567,7 +3560,7 @@ interface LunnoaAuthContextValue {
     getAccessToken: () => Promise<string | null>;
 }
 type LunnoaAuthProviderProps = {
-    /** Existing Pattern B client (from `createBrowserClient`). */
+    /** Existing browser client (from `createBrowserClient`). */
     client: LunnoaClient;
     children: ReactNode;
 } | (CreateBrowserClientOptions & {
@@ -3575,7 +3568,7 @@ type LunnoaAuthProviderProps = {
     children: ReactNode;
 });
 /**
- * Provides a Pattern B Lunnoa client and session helpers to React trees.
+ * Provides a Lunnoa user client and session helpers to React trees.
  *
  * ```tsx
  * <LunnoaAuthProvider baseUrl={import.meta.env.VITE_LUNNOA_URL}>
@@ -3584,7 +3577,7 @@ type LunnoaAuthProviderProps = {
  * ```
  */
 declare function LunnoaAuthProvider(props: LunnoaAuthProviderProps): react.FunctionComponentElement<react.ProviderProps<LunnoaAuthContextValue | null>>;
-/** Full auth session API for Pattern B React apps. */
+/** Full auth session API for React apps whose users sign in to Lunnoa. */
 declare function useLunnoaAuth(): LunnoaAuthContextValue;
 /** The Lunnoa client from the nearest {@link LunnoaAuthProvider}. */
 declare function useLunnoaClient(): LunnoaClient;

package/dist/react.js

@@ -56,7 +56,7 @@ function isBrowserEnvironment() {
 function assertApiKeyAllowedInEnvironment(apiKey) {
   if (isBrowserEnvironment()) {
     throw new Error(
-      "Refusing to use a Lunnoa API key (lna_...) in a browser environment. API keys are server-side credentials: anyone opening dev tools could read the key and act as the service account across its whole workspace. Either call the Lunnoa API from your own backend which holds the key (backend-for-frontend pattern), or authenticate the end user with a Lunnoa user JWT and pass it as `accessToken`."
+      "Refusing to use a Lunnoa API key (lna_...) in a browser environment. API keys are for the CLI and operator scripts, not for app login. Anyone opening dev tools could read the key and act as the service account across its whole workspace. Sign the end user in with lunnoa.auth.login and pass their JWT as `accessToken`."
     );
   }
   if (!apiKey.startsWith(API_KEY_PREFIX)) {
@@ -138,7 +138,7 @@ var HttpClient = class {
     }
     if (!options.apiKey && !options.accessToken && !options.tokenStore) {
       throw new Error(
-        "LunnoaClient requires an apiKey (server-side), an accessToken (user JWT), or a tokenStore (Pattern B)."
+        "LunnoaClient requires an accessToken or tokenStore (Lunnoa user JWT), or an apiKey for operator scripts."
       );
     }
     if (options.apiKey) {
@@ -2089,7 +2089,7 @@ var WorkflowsResource = class {
 var LunnoaClient = class {
   /** The underlying HTTP layer, exposed for advanced/escape-hatch requests. */
   http;
-  /** Login, refresh, SSO discovery, and session helpers (Pattern B). */
+  /** Login, refresh, SSO discovery, and session helpers for Lunnoa users. */
   auth;
   agents;
   tasks;