@lobehub/market-sdk 0.27.1-beta.1 → 0.27.1-beta.3

package/dist/index.d.mts

@@ -1342,6 +1342,10 @@ interface OAuthConnection {
      * When the connection was created
      */
     createdAt: string;
+    /**
+     * Provider user email (if available)
+     */
+    providerEmail?: string;
     /**
      * Provider identifier
      */
@@ -1350,10 +1354,6 @@ interface OAuthConnection {
      * Provider display name
      */
     providerName: string;
-    /**
-     * Provider user email (if available)
-     */
-    providerEmail?: string;
     /**
      * Provider user ID
      */
@@ -1400,22 +1400,22 @@ interface ConnectionHealth {
  * Connection statistics
  */
 interface ConnectionStats {
-    /**
-     * Total number of connections
-     */
-    total: number;
     /**
      * Number of active/healthy connections
      */
     active: number;
+    /**
+     * Number of expired connections
+     */
+    expired: number;
     /**
      * Number of connections expiring soon
      */
     expiringSoon: number;
     /**
-     * Number of expired connections
+     * Total number of connections
      */
-    expired: number;
+    total: number;
 }
 /**
  * Response for listing providers
@@ -1490,6 +1490,10 @@ interface GetConnectionStatsResponse {
  * Response for connection health check
  */
 interface GetConnectionHealthResponse {
+    /**
+     * Token expiry time (ISO string)
+     */
+    expiresAt?: string;
     /**
      * Whether the connection is healthy
      */
@@ -1506,10 +1510,6 @@ interface GetConnectionHealthResponse {
      * Token status
      */
     tokenStatus: 'valid' | 'expiring_soon' | 'expired' | 'unknown';
-    /**
-     * Token expiry time (ISO string)
-     */
-    expiresAt?: string;
 }
 /**
  * Response for all connections health check
@@ -1527,11 +1527,11 @@ interface GetAllConnectionsHealthResponse {
      * Health summary
      */
     summary: {
-        total: number;
+        expired: number;
+        expiringSoon: number;
         healthy: number;
+        total: number;
         unhealthy: number;
-        expiringSoon: number;
-        expired: number;
     };
 }
 /**
@@ -1564,14 +1564,53 @@ interface RevokeConnectionResponse {
  * Parameters for getting authorize URL
  */
 interface GetAuthorizeUrlParams {
+    /**
+     * Redirect URI after authorization (optional)
+     */
+    redirectUri?: string;
     /**
      * Custom scopes to request (optional, uses provider defaults if not specified)
      */
     scopes?: string[];
+}
+/**
+ * Parameters for authorize request
+ */
+interface AuthorizeParams {
     /**
      * Redirect URI after authorization (optional)
      */
-    redirectUri?: string;
+    redirect_uri?: string;
+    /**
+     * Custom scopes to request (optional, uses provider defaults if not specified)
+     */
+    scopes?: string[];
+}
+/**
+ * Response for authorize request
+ *
+ * Returns a signed authorization code that can be used to initiate
+ * the OAuth flow in a browser context where Bearer tokens cannot be sent.
+ */
+interface AuthorizeResponse {
+    /**
+     * The full URL to open in browser to start OAuth flow
+     * Includes the signed code as a query parameter
+     */
+    authorize_url: string;
+    /**
+     * Signed authorization code
+     * Can be used with GET /api/connect/:provider/start?code=xxx
+     */
+    code: string;
+    /**
+     * Code expiration time in seconds (typically 300 = 5 minutes)
+     */
+    expires_in: number;
+    /**
+     * Whether the request was successful
+     */
+    success: boolean;
 }
 
 /**
@@ -3719,36 +3758,64 @@ declare class ConnectService extends BaseSDK {
      */
     getProvider(provider: string, options?: globalThis.RequestInit): Promise<GetConnectProviderResponse>;
     /**
-     * Generates the OAuth authorization URL for a provider
+     * Requests an authorization code for initiating OAuth flow
      *
-     * This URL should be opened in a browser (popup or redirect) for the user
-     * to authorize the connection. After authorization, the user will be
-     * redirected back to the callback URL.
+     * This method obtains a signed, short-lived authorization code that can be
+     * used to start the OAuth flow in a browser context where Bearer tokens
+     * cannot be sent (e.g., opening a popup or redirecting the page).
      *
-     * Note: This method does NOT make an API request. It constructs the URL
-     * that the user should visit to start the OAuth flow.
+     * The returned `authorize_url` can be directly opened in a browser.
      *
-     * @param provider - The provider ID (e.g., 'linear', 'github')
+     * **This is the recommended way to initiate OAuth authorization.**
+     *
+     * @param provider - The provider ID (e.g., 'linear', 'github', 'microsoft')
      * @param params - Optional parameters for scopes and redirect URI
-     * @returns The authorization URL to redirect the user to
+     * @param options - Optional request options (must include authentication)
+     * @returns Promise resolving to the authorization code and URL
      *
      * @example
      * ```typescript
-     * // Basic usage - opens in popup
-     * const url = sdk.connect.getAuthorizeUrl('linear');
-     * const popup = window.open(url, 'oauth', 'width=600,height=700');
+     * // Get authorization code and URL
+     * const { authorize_url, code, expires_in } = await sdk.connect.authorize('linear');
+     *
+     * // Open the URL in a popup
+     * const popup = window.open(authorize_url, 'oauth', 'width=600,height=700,popup=yes');
      *
      * // With custom scopes
-     * const url = sdk.connect.getAuthorizeUrl('github', {
+     * const { authorize_url } = await sdk.connect.authorize('github', {
      *   scopes: ['user', 'repo', 'read:org']
      * });
      *
      * // With redirect URI
-     * const url = sdk.connect.getAuthorizeUrl('linear', {
-     *   redirectUri: 'https://myapp.com/oauth/callback'
+     * const { authorize_url } = await sdk.connect.authorize('microsoft', {
+     *   scopes: ['Calendars.ReadWrite'],
+     *   redirect_uri: 'https://myapp.com/oauth/callback'
      * });
      * ```
      */
+    authorize(provider: string, params?: AuthorizeParams, options?: globalThis.RequestInit): Promise<AuthorizeResponse>;
+    /**
+     * Generates the OAuth authorization URL for a provider (deprecated)
+     *
+     * @deprecated Use `authorize()` instead. This method constructs a URL that
+     * requires Bearer token authentication, which doesn't work in browser redirects.
+     * The new `authorize()` method returns a URL with a signed code that works
+     * in browser contexts.
+     *
+     * @param provider - The provider ID (e.g., 'linear', 'github')
+     * @param params - Optional parameters for scopes and redirect URI
+     * @returns The authorization URL (requires Bearer token, won't work in browser)
+     *
+     * @example
+     * ```typescript
+     * // OLD way (deprecated) - won't work in browser
+     * const url = sdk.connect.getAuthorizeUrl('linear');
+     *
+     * // NEW way (recommended) - works in browser
+     * const { authorize_url } = await sdk.connect.authorize('linear');
+     * window.open(authorize_url, 'oauth', 'width=600,height=700');
+     * ```
+     */
     getAuthorizeUrl(provider: string, params?: GetAuthorizeUrlParams): string;
     /**
      * Gets the connection status for a specific provider
@@ -4678,4 +4745,4 @@ declare function buildTrustedClientPayload(params: {
     userId: string;
 }): TrustedClientPayload;
 
-export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAdmin, MarketSDK, type MarketSDKOptions, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OwnAgentListQuery, type PaginationQuery, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshConnectionResponse, type RefreshTokenRequest, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillErrorResponse, type SkillProviderInfo, type SkillProviderStatus, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };
+export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAdmin, MarketSDK, type MarketSDKOptions, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OwnAgentListQuery, type PaginationQuery, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshConnectionResponse, type RefreshTokenRequest, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillErrorResponse, type SkillProviderInfo, type SkillProviderStatus, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };

package/dist/index.mjs

@@ -2199,10 +2199,7 @@ var ConnectService = class extends BaseSDK {
   async listProviders(options) {
     var _a;
     log12("Listing connect providers");
-    const result = await this.request(
-      "/connect/providers",
-      options
-    );
+    const result = await this.request("/connect/providers", options);
     log12("Found %d connect providers", ((_a = result.providers) == null ? void 0 : _a.length) || 0);
     return result;
   }
@@ -2226,38 +2223,81 @@ var ConnectService = class extends BaseSDK {
     return result;
   }
   /**
-   * Generates the OAuth authorization URL for a provider
+   * Requests an authorization code for initiating OAuth flow
    *
-   * This URL should be opened in a browser (popup or redirect) for the user
-   * to authorize the connection. After authorization, the user will be
-   * redirected back to the callback URL.
+   * This method obtains a signed, short-lived authorization code that can be
+   * used to start the OAuth flow in a browser context where Bearer tokens
+   * cannot be sent (e.g., opening a popup or redirecting the page).
    *
-   * Note: This method does NOT make an API request. It constructs the URL
-   * that the user should visit to start the OAuth flow.
+   * The returned `authorize_url` can be directly opened in a browser.
    *
-   * @param provider - The provider ID (e.g., 'linear', 'github')
+   * **This is the recommended way to initiate OAuth authorization.**
+   *
+   * @param provider - The provider ID (e.g., 'linear', 'github', 'microsoft')
    * @param params - Optional parameters for scopes and redirect URI
-   * @returns The authorization URL to redirect the user to
+   * @param options - Optional request options (must include authentication)
+   * @returns Promise resolving to the authorization code and URL
    *
    * @example
    * ```typescript
-   * // Basic usage - opens in popup
-   * const url = sdk.connect.getAuthorizeUrl('linear');
-   * const popup = window.open(url, 'oauth', 'width=600,height=700');
+   * // Get authorization code and URL
+   * const { authorize_url, code, expires_in } = await sdk.connect.authorize('linear');
+   *
+   * // Open the URL in a popup
+   * const popup = window.open(authorize_url, 'oauth', 'width=600,height=700,popup=yes');
    *
    * // With custom scopes
-   * const url = sdk.connect.getAuthorizeUrl('github', {
+   * const { authorize_url } = await sdk.connect.authorize('github', {
    *   scopes: ['user', 'repo', 'read:org']
    * });
    *
    * // With redirect URI
-   * const url = sdk.connect.getAuthorizeUrl('linear', {
-   *   redirectUri: 'https://myapp.com/oauth/callback'
+   * const { authorize_url } = await sdk.connect.authorize('microsoft', {
+   *   scopes: ['Calendars.ReadWrite'],
+   *   redirect_uri: 'https://myapp.com/oauth/callback'
    * });
    * ```
    */
+  async authorize(provider, params, options) {
+    log12("Requesting authorization code for provider: %s", provider);
+    const result = await this.request(
+      `/connect/${encodeURIComponent(provider)}/authorize`,
+      {
+        body: params ? JSON.stringify(params) : void 0,
+        headers: {
+          "Content-Type": "application/json"
+        },
+        method: "POST",
+        ...options
+      }
+    );
+    log12("Authorization code obtained, expires in %d seconds", result.expires_in);
+    return result;
+  }
+  /**
+   * Generates the OAuth authorization URL for a provider (deprecated)
+   *
+   * @deprecated Use `authorize()` instead. This method constructs a URL that
+   * requires Bearer token authentication, which doesn't work in browser redirects.
+   * The new `authorize()` method returns a URL with a signed code that works
+   * in browser contexts.
+   *
+   * @param provider - The provider ID (e.g., 'linear', 'github')
+   * @param params - Optional parameters for scopes and redirect URI
+   * @returns The authorization URL (requires Bearer token, won't work in browser)
+   *
+   * @example
+   * ```typescript
+   * // OLD way (deprecated) - won't work in browser
+   * const url = sdk.connect.getAuthorizeUrl('linear');
+   *
+   * // NEW way (recommended) - works in browser
+   * const { authorize_url } = await sdk.connect.authorize('linear');
+   * window.open(authorize_url, 'oauth', 'width=600,height=700');
+   * ```
+   */
   getAuthorizeUrl(provider, params) {
-    log12("Generating authorize URL for provider: %s", provider);
+    log12("Generating authorize URL for provider: %s (deprecated, use authorize() instead)", provider);
     const queryParams = new URLSearchParams();
     if ((params == null ? void 0 : params.scopes) && params.scopes.length > 0) {
       queryParams.set("scope", params.scopes.join(","));