@automattic/agenttic-client 0.1.1 → 0.1.2

package/dist/auth/jetpack.d.ts

@@ -28,31 +28,50 @@ interface TokenData {
     blogId: string;
     expire: number;
 }
+export interface JetpackApiError {
+    code?: string;
+    status?: number;
+    message?: string;
+}
+/**
+ * Error handler function type for Jetpack authentication errors
+ */
+export type JetpackErrorHandler = (error: JetpackApiError) => string;
 /**
  * Request a JWT token from Jetpack for API authentication
+ * @param errorHandler   - Function to handle and format error messages
  * @param useCachedToken - Whether to use cached token if available and valid
  * @return Token data with JWT token and blog ID, or null on failure
  */
-export declare function requestJetpackToken(useCachedToken?: boolean): Promise<TokenData | null>;
+export declare function requestJetpackToken(errorHandler: JetpackErrorHandler, useCachedToken?: boolean): Promise<TokenData | null>;
 /**
- * Jetpack authentication provider for use with Agenttic client.
+ * Create a Jetpack authentication provider for use with Agenttic client.
  *
- * This provider handles authentication for WordPress sites with Jetpack,
- * automatically managing token caching and refresh.
+ * This factory function creates an authentication provider that handles
+ * authentication for WordPress sites with Jetpack, automatically managing
+ * token caching and refresh.
  *
  * @example
  * ```typescript
- * import { jetpackAuthProvider } from '@automattic/agenttic-client';
+ * import { createJetpackAuthProvider } from '@automattic/agenttic-client';
  * import { useAgent } from '@automattic/agenttic-client';
  *
+ * const errorHandler = (error) => {
+ *   if (error.code === 'rest_forbidden') {
+ *     return 'Permission denied';
+ *   }
+ *   return 'Authentication failed';
+ * };
+ *
  * const { state, sendMessage } = useAgent({
  *   agentId: 'my-agent',
- *   authProvider: jetpackAuthProvider,
+ *   authProvider: createJetpackAuthProvider(errorHandler),
  * });
  * ```
  *
+ * @param errorHandler - Function to handle and format error messages
  * @return Authentication provider function that returns headers with JWT token
  */
-export declare const jetpackAuthProvider: AuthProvider;
+export declare const createJetpackAuthProvider: (errorHandler: JetpackErrorHandler) => AuthProvider;
 export {};
 //# sourceMappingURL=jetpack.d.ts.map

package/dist/auth/jetpack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jetpack.d.ts","sourceRoot":"","sources":["../../src/auth/jetpack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,eAAO,MAAM,YAAY,yBAAyB,CAAC;AACnD,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,2BAA2B,CAAC,EAAE;YAC7B,QAAQ,EAAE,MAAM,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC;YACnB,gBAAgB,EAAE;gBAAE,QAAQ,EAAE,OAAO,CAAA;aAAE,CAAC;SACxC,CAAC;QACF,4BAA4B,CAAC,EAAE;YAC9B,WAAW,EAAE,MAAM,CAAC;SACpB,CAAC;KACF;CACD;AAED,UAAU,SAAS;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf;AA4CD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACxC,cAAc,UAAO,GACnB,OAAO,CAAE,SAAS,GAAG,IAAI,CAAE,CA2E7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAkBjC,CAAC"}
+{"version":3,"file":"jetpack.d.ts","sourceRoot":"","sources":["../../src/auth/jetpack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,eAAO,MAAM,YAAY,yBAAyB,CAAC;AACnD,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,2BAA2B,CAAC,EAAE;YAC7B,QAAQ,EAAE,MAAM,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC;YACnB,gBAAgB,EAAE;gBAAE,QAAQ,EAAE,OAAO,CAAA;aAAE,CAAC;SACxC,CAAC;QACF,4BAA4B,CAAC,EAAE;YAC9B,WAAW,EAAE,MAAM,CAAC;SACpB,CAAC;KACF;CACD;AAED,UAAU,SAAS;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAE,KAAK,EAAE,eAAe,KAAM,MAAM,CAAC;AAmBvE;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,YAAY,EAAE,mBAAmB,EACjC,cAAc,UAAO,GACnB,OAAO,CAAE,SAAS,GAAG,IAAI,CAAE,CA2E7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,yBAAyB,GACrC,cAAc,mBAAmB,KAC/B,YAkBF,CAAC"}

package/dist/index.d.ts

@@ -18,5 +18,5 @@ export { BarChart, LineChart, ChartBlock } from './markdown-extensions/charts';
 export type { MarkdownExtensions, ChartExtensionConfig, ChartData, ChartSeries, } from './markdown-extensions/types';
 export { createFeedbackActions, useMessageActions } from './message-actions';
 export type { FeedbackActionsManager } from './message-actions';
-export { jetpackAuthProvider } from './auth/jetpack';
+export { createJetpackAuthProvider, type JetpackErrorHandler, type JetpackApiError, } from './auth/jetpack';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EACN,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,YAAY,EAEX,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,IAAI,EACJ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EAGvB,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,UAAU,EAGV,IAAI,EACJ,YAAY,EACZ,cAAc,EAGd,aAAa,EACb,eAAe,GACf,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACX,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,kBAAkB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/E,YAAY,EACX,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,WAAW,GACX,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EACN,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,YAAY,EAEX,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,IAAI,EACJ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EAGvB,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,UAAU,EAGV,IAAI,EACJ,YAAY,EACZ,cAAc,EAGd,aAAa,EACb,eAAe,GACf,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACX,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,kBAAkB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/E,YAAY,EACX,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,WAAW,GACX,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EACN,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -2181,24 +2181,16 @@ import apiFetch from "@wordpress/api-fetch";
 var JWT_TOKEN_ID = "jetpack-ai-jwt-token";
 var JWT_TOKEN_EXPIRATION_TIME = 30 * 60 * 1e3;
 function isSimpleSite() {
-  return Boolean(window.Jetpack_Editor_Initial_State?.wpcomBlogId);
-}
-function getJetpackErrorMessage(error) {
-  if (error?.code === "rest_invalid_nonce") {
-    return "Your session expired. Please refresh the page and try again or check your Jetpack connection.";
-  }
-  if (error?.code === "rest_forbidden" || error?.status === 403) {
-    return "You don't have permission to access Jetpack AI features. Please check your user permissions.";
-  }
-  if (error?.code === "rest_no_route" || error?.status === 404) {
-    return "Unable to connect to Jetpack. Please ensure the Jetpack plugin is active and up to date.";
-  }
-  if (error?.message?.includes("network") || error?.message?.includes("Network") || error?.message?.includes("fetch")) {
-    return "Network connection issue. Please check your internet connection and try again.";
+  const hasJetpackConnection = Boolean(window.JP_CONNECTION_INITIAL_STATE);
+  if (hasJetpackConnection) {
+    return false;
   }
-  return "Unable to authenticate with Jetpack. Please try again or contact support if the problem persists.";
+  const isSimple = Boolean(
+    window.Jetpack_Editor_Initial_State?.wpcomBlogId
+  );
+  return isSimple;
 }
-async function requestJetpackToken(useCachedToken = true) {
+async function requestJetpackToken(errorHandler, useCachedToken = true) {
   const token = localStorage.getItem(JWT_TOKEN_ID);
   let tokenData;
   if (token) {
@@ -2235,7 +2227,7 @@ async function requestJetpackToken(useCachedToken = true) {
     }
   } catch (error) {
     console.log("Failed to fetch Jetpack token:", error);
-    throw new Error(getJetpackErrorMessage(error));
+    throw new Error(errorHandler(error));
   }
   if (!data?.token) {
     throw new Error(
@@ -2254,18 +2246,20 @@ async function requestJetpackToken(useCachedToken = true) {
   }
   return newTokenData;
 }
-var jetpackAuthProvider = async () => {
-  const headers = {};
-  try {
-    const tokenData = await requestJetpackToken();
-    if (tokenData?.token) {
-      headers.Authorization = `${tokenData.token}`;
+var createJetpackAuthProvider = (errorHandler) => {
+  return async () => {
+    const headers = {};
+    try {
+      const tokenData = await requestJetpackToken(errorHandler);
+      if (tokenData?.token) {
+        headers.Authorization = `${tokenData.token}`;
+      }
+    } catch (error) {
+      console.error("Failed to get Jetpack token for auth:", error);
+      throw error;
     }
-  } catch (error) {
-    console.error("Failed to get Jetpack token for auth:", error);
-    throw error;
-  }
-  return headers;
+    return headers;
+  };
 };
 export {
   A2AErrorCodes,
@@ -2274,6 +2268,7 @@ export {
   LineChart,
   createClient,
   createFeedbackActions,
+  createJetpackAuthProvider,
   createMessageRenderer,
   createRequestId,
   createTaskId,
@@ -2281,7 +2276,6 @@ export {
   extractTextFromMessage,
   extractToolCallsFromMessage,
   getAgentManager,
-  jetpackAuthProvider,
   useAgentChat,
   useClientContext,
   useClientTools,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@automattic/agenttic-client",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"type": "module",
 	"description": "A TypeScript client library for A2A (Agent2Agent) protocol communication",
 	"main": "dist/index.js",