@githat/nextjs 0.2.5 → 0.2.7

package/dist/index.d.mts

@@ -7,6 +7,11 @@ interface GitHatUser {
     name: string;
     avatarUrl: string | null;
     emailVerified: boolean;
+    githubUsername?: string;
+    cognitoUsername?: string;
+    cognitoSub?: string;
+    googleId?: string;
+    authProvider?: 'email' | 'github' | 'cognito' | 'google';
 }
 interface GitHatOrg {
     id: string;
@@ -105,6 +110,33 @@ declare function useGitHat(): {
     resendVerificationEmail: (email: string) => Promise<{
         success: boolean;
     }>;
+    getGitHubOAuthUrl: (options?: {
+        redirectUri?: string;
+        state?: string;
+    }) => Promise<{
+        url: string;
+    }>;
+    signInWithGitHub: (code: string, options?: {
+        redirectUri?: string;
+    }) => Promise<{
+        user: GitHatUser;
+        org: GitHatOrg | null;
+        isNewUser: boolean;
+    }>;
+    getCognitoOAuthUrl: (options?: {
+        redirectUri?: string;
+        state?: string;
+        identityProvider?: string;
+    }) => Promise<{
+        url: string;
+    }>;
+    signInWithCognito: (code: string, options?: {
+        redirectUri?: string;
+    }) => Promise<{
+        user: GitHatUser;
+        org: GitHatOrg | null;
+        isNewUser: boolean;
+    }>;
 };
 
 interface DataItem {
@@ -200,6 +232,52 @@ declare function useData(): {
     batch: (collection: string, operations: BatchOperation[]) => Promise<BatchResult>;
 };
 
+interface SendEmailOptions {
+    /** Recipient email address(es). Single string or array of up to 50 addresses. */
+    to: string | string[];
+    /** Email subject line (max 998 characters). */
+    subject: string;
+    /** HTML body (optional if text is provided). */
+    html?: string;
+    /** Plain text body (optional if html is provided). */
+    text?: string;
+    /** Reply-to email address. Recipients can reply directly to this address. */
+    replyTo?: string;
+}
+interface SendEmailResult {
+    /** SES message ID for tracking. */
+    messageId: string;
+    /** Recipient addresses the email was sent to. */
+    to: string[];
+    /** Subject line as sent. */
+    subject: string;
+    /** Whether the email was sent successfully. */
+    sent: boolean;
+}
+/**
+ * Hook for sending transactional emails via GitHat's Email API.
+ * Emails are sent from noreply@githat.io. Use replyTo for customer replies.
+ *
+ * @example
+ * ```tsx
+ * const { send } = useEmail();
+ *
+ * await send({
+ *   to: 'user@example.com',
+ *   subject: 'Your order is confirmed',
+ *   html: '<h1>Order Confirmed</h1><p>Thank you!</p>',
+ *   replyTo: 'support@myapp.com'
+ * });
+ * ```
+ */
+declare function useEmail(): {
+    /**
+     * Send a transactional email.
+     * @param options - Email options (to, subject, html/text, replyTo)
+     */
+    send: (options: SendEmailOptions) => Promise<SendEmailResult>;
+};
+
 interface SignInFormProps {
     onSuccess?: () => void;
     signUpUrl?: string;
@@ -279,6 +357,86 @@ interface ChangePasswordFormProps {
 }
 declare function ChangePasswordForm({ onSuccess, onError, minPasswordLength, }: ChangePasswordFormProps): react_jsx_runtime.JSX.Element;
 
+interface GitHubButtonProps {
+    /** Text to display on the button */
+    children?: React.ReactNode;
+    /** Custom redirect URI after GitHub auth */
+    redirectUri?: string;
+    /** Callback on successful auth */
+    onSuccess?: (result: {
+        user: any;
+        org: any;
+        isNewUser: boolean;
+    }) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Additional class names */
+    className?: string;
+    /** Button variant */
+    variant?: 'default' | 'outline';
+    /** Disable the button */
+    disabled?: boolean;
+}
+declare function GitHubButton({ children, redirectUri, onSuccess, onError, className, variant, disabled, }: GitHubButtonProps): react_jsx_runtime.JSX.Element;
+
+interface GitHubCallbackProps {
+    /** URL to redirect to after successful auth */
+    redirectUrl?: string;
+    /** URL for new users (onboarding) */
+    newUserRedirectUrl?: string;
+    /** Callback on successful auth */
+    onSuccess?: (result: {
+        user: any;
+        org: any;
+        isNewUser: boolean;
+    }) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Custom loading component */
+    loadingComponent?: React.ReactNode;
+    /** Custom error component */
+    errorComponent?: (error: string) => React.ReactNode;
+}
+declare function GitHubCallback({ redirectUrl, newUserRedirectUrl, onSuccess, onError, loadingComponent, errorComponent, }: GitHubCallbackProps): react_jsx_runtime.JSX.Element;
+
+interface CognitoButtonProps {
+    /** Text to display on the button */
+    children?: React.ReactNode;
+    /** Custom redirect URI after Cognito auth */
+    redirectUri?: string;
+    /** Specific identity provider (e.g., 'Google', 'Facebook') */
+    identityProvider?: string;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Additional class names */
+    className?: string;
+    /** Button variant */
+    variant?: 'default' | 'outline';
+    /** Disable the button */
+    disabled?: boolean;
+}
+declare function CognitoButton({ children, redirectUri, identityProvider, onError, className, variant, disabled, }: CognitoButtonProps): react_jsx_runtime.JSX.Element;
+
+interface CognitoCallbackProps {
+    /** URL to redirect to after successful auth */
+    redirectUrl?: string;
+    /** URL for new users (onboarding) */
+    newUserRedirectUrl?: string;
+    /** Callback on successful auth */
+    onSuccess?: (result: {
+        user: any;
+        org: any;
+        isNewUser: boolean;
+    }) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Custom loading component */
+    loadingComponent?: React.ReactNode;
+    /** Custom error component */
+    errorComponent?: (error: string) => React.ReactNode;
+}
+declare function CognitoCallback({ redirectUrl, newUserRedirectUrl, onSuccess, onError, loadingComponent, errorComponent, }: CognitoCallbackProps): react_jsx_runtime.JSX.Element;
+
 /**
  * @githat/nextjs/server
  *
@@ -327,5 +485,23 @@ interface WithAuthOptions {
      */
     onUnauthorized?: () => Response;
 }
+interface ServerSendEmailOptions {
+    /** Recipient email address(es). */
+    to: string | string[];
+    /** Email subject line. */
+    subject: string;
+    /** HTML body. */
+    html?: string;
+    /** Plain text body. */
+    text?: string;
+    /** Reply-to email address. */
+    replyTo?: string;
+}
+interface ServerSendEmailResult {
+    messageId: string;
+    to: string[];
+    subject: string;
+    sent: boolean;
+}
 
-export { type AuthActions, type AuthPayload, type AuthState, type AuthenticatedHandler, type BatchOperation, type BatchResult, ChangePasswordForm, type DataItem, type DeleteResult, type EmailVerificationResult, ForgotPasswordForm, type GitHatConfig, type GitHatContextValue, type GitHatOrg, GitHatProvider, type GitHatUser, type OrgMetadata, OrgSwitcher, type PasswordResetResult, ProtectedRoute, type PutResult, type QueryOptions, type QueryResult, ResetPasswordForm, SignInButton, SignInForm, SignUpButton, type SignUpData, SignUpForm, type SignUpResult, UserButton, VerifiedBadge, VerifyEmailStatus, type VerifyOptions, type WithAuthOptions, useAuth, useData, useGitHat };
+export { type AuthActions, type AuthPayload, type AuthState, type AuthenticatedHandler, type BatchOperation, type BatchResult, ChangePasswordForm, CognitoButton, CognitoCallback, type DataItem, type DeleteResult, type EmailVerificationResult, ForgotPasswordForm, type GitHatConfig, type GitHatContextValue, type GitHatOrg, GitHatProvider, type GitHatUser, GitHubButton, GitHubCallback, type OrgMetadata, OrgSwitcher, type PasswordResetResult, ProtectedRoute, type PutResult, type QueryOptions, type QueryResult, ResetPasswordForm, type SendEmailOptions, type SendEmailResult, type ServerSendEmailOptions, type ServerSendEmailResult, SignInButton, SignInForm, SignUpButton, type SignUpData, SignUpForm, type SignUpResult, UserButton, VerifiedBadge, VerifyEmailStatus, type VerifyOptions, type WithAuthOptions, useAuth, useData, useEmail, useGitHat };

package/dist/index.d.ts

@@ -7,6 +7,11 @@ interface GitHatUser {
     name: string;
     avatarUrl: string | null;
     emailVerified: boolean;
+    githubUsername?: string;
+    cognitoUsername?: string;
+    cognitoSub?: string;
+    googleId?: string;
+    authProvider?: 'email' | 'github' | 'cognito' | 'google';
 }
 interface GitHatOrg {
     id: string;
@@ -105,6 +110,33 @@ declare function useGitHat(): {
     resendVerificationEmail: (email: string) => Promise<{
         success: boolean;
     }>;
+    getGitHubOAuthUrl: (options?: {
+        redirectUri?: string;
+        state?: string;
+    }) => Promise<{
+        url: string;
+    }>;
+    signInWithGitHub: (code: string, options?: {
+        redirectUri?: string;
+    }) => Promise<{
+        user: GitHatUser;
+        org: GitHatOrg | null;
+        isNewUser: boolean;
+    }>;
+    getCognitoOAuthUrl: (options?: {
+        redirectUri?: string;
+        state?: string;
+        identityProvider?: string;
+    }) => Promise<{
+        url: string;
+    }>;
+    signInWithCognito: (code: string, options?: {
+        redirectUri?: string;
+    }) => Promise<{
+        user: GitHatUser;
+        org: GitHatOrg | null;
+        isNewUser: boolean;
+    }>;
 };
 
 interface DataItem {
@@ -200,6 +232,52 @@ declare function useData(): {
     batch: (collection: string, operations: BatchOperation[]) => Promise<BatchResult>;
 };
 
+interface SendEmailOptions {
+    /** Recipient email address(es). Single string or array of up to 50 addresses. */
+    to: string | string[];
+    /** Email subject line (max 998 characters). */
+    subject: string;
+    /** HTML body (optional if text is provided). */
+    html?: string;
+    /** Plain text body (optional if html is provided). */
+    text?: string;
+    /** Reply-to email address. Recipients can reply directly to this address. */
+    replyTo?: string;
+}
+interface SendEmailResult {
+    /** SES message ID for tracking. */
+    messageId: string;
+    /** Recipient addresses the email was sent to. */
+    to: string[];
+    /** Subject line as sent. */
+    subject: string;
+    /** Whether the email was sent successfully. */
+    sent: boolean;
+}
+/**
+ * Hook for sending transactional emails via GitHat's Email API.
+ * Emails are sent from noreply@githat.io. Use replyTo for customer replies.
+ *
+ * @example
+ * ```tsx
+ * const { send } = useEmail();
+ *
+ * await send({
+ *   to: 'user@example.com',
+ *   subject: 'Your order is confirmed',
+ *   html: '<h1>Order Confirmed</h1><p>Thank you!</p>',
+ *   replyTo: 'support@myapp.com'
+ * });
+ * ```
+ */
+declare function useEmail(): {
+    /**
+     * Send a transactional email.
+     * @param options - Email options (to, subject, html/text, replyTo)
+     */
+    send: (options: SendEmailOptions) => Promise<SendEmailResult>;
+};
+
 interface SignInFormProps {
     onSuccess?: () => void;
     signUpUrl?: string;
@@ -279,6 +357,86 @@ interface ChangePasswordFormProps {
 }
 declare function ChangePasswordForm({ onSuccess, onError, minPasswordLength, }: ChangePasswordFormProps): react_jsx_runtime.JSX.Element;
 
+interface GitHubButtonProps {
+    /** Text to display on the button */
+    children?: React.ReactNode;
+    /** Custom redirect URI after GitHub auth */
+    redirectUri?: string;
+    /** Callback on successful auth */
+    onSuccess?: (result: {
+        user: any;
+        org: any;
+        isNewUser: boolean;
+    }) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Additional class names */
+    className?: string;
+    /** Button variant */
+    variant?: 'default' | 'outline';
+    /** Disable the button */
+    disabled?: boolean;
+}
+declare function GitHubButton({ children, redirectUri, onSuccess, onError, className, variant, disabled, }: GitHubButtonProps): react_jsx_runtime.JSX.Element;
+
+interface GitHubCallbackProps {
+    /** URL to redirect to after successful auth */
+    redirectUrl?: string;
+    /** URL for new users (onboarding) */
+    newUserRedirectUrl?: string;
+    /** Callback on successful auth */
+    onSuccess?: (result: {
+        user: any;
+        org: any;
+        isNewUser: boolean;
+    }) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Custom loading component */
+    loadingComponent?: React.ReactNode;
+    /** Custom error component */
+    errorComponent?: (error: string) => React.ReactNode;
+}
+declare function GitHubCallback({ redirectUrl, newUserRedirectUrl, onSuccess, onError, loadingComponent, errorComponent, }: GitHubCallbackProps): react_jsx_runtime.JSX.Element;
+
+interface CognitoButtonProps {
+    /** Text to display on the button */
+    children?: React.ReactNode;
+    /** Custom redirect URI after Cognito auth */
+    redirectUri?: string;
+    /** Specific identity provider (e.g., 'Google', 'Facebook') */
+    identityProvider?: string;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Additional class names */
+    className?: string;
+    /** Button variant */
+    variant?: 'default' | 'outline';
+    /** Disable the button */
+    disabled?: boolean;
+}
+declare function CognitoButton({ children, redirectUri, identityProvider, onError, className, variant, disabled, }: CognitoButtonProps): react_jsx_runtime.JSX.Element;
+
+interface CognitoCallbackProps {
+    /** URL to redirect to after successful auth */
+    redirectUrl?: string;
+    /** URL for new users (onboarding) */
+    newUserRedirectUrl?: string;
+    /** Callback on successful auth */
+    onSuccess?: (result: {
+        user: any;
+        org: any;
+        isNewUser: boolean;
+    }) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Custom loading component */
+    loadingComponent?: React.ReactNode;
+    /** Custom error component */
+    errorComponent?: (error: string) => React.ReactNode;
+}
+declare function CognitoCallback({ redirectUrl, newUserRedirectUrl, onSuccess, onError, loadingComponent, errorComponent, }: CognitoCallbackProps): react_jsx_runtime.JSX.Element;
+
 /**
  * @githat/nextjs/server
  *
@@ -327,5 +485,23 @@ interface WithAuthOptions {
      */
     onUnauthorized?: () => Response;
 }
+interface ServerSendEmailOptions {
+    /** Recipient email address(es). */
+    to: string | string[];
+    /** Email subject line. */
+    subject: string;
+    /** HTML body. */
+    html?: string;
+    /** Plain text body. */
+    text?: string;
+    /** Reply-to email address. */
+    replyTo?: string;
+}
+interface ServerSendEmailResult {
+    messageId: string;
+    to: string[];
+    subject: string;
+    sent: boolean;
+}
 
-export { type AuthActions, type AuthPayload, type AuthState, type AuthenticatedHandler, type BatchOperation, type BatchResult, ChangePasswordForm, type DataItem, type DeleteResult, type EmailVerificationResult, ForgotPasswordForm, type GitHatConfig, type GitHatContextValue, type GitHatOrg, GitHatProvider, type GitHatUser, type OrgMetadata, OrgSwitcher, type PasswordResetResult, ProtectedRoute, type PutResult, type QueryOptions, type QueryResult, ResetPasswordForm, SignInButton, SignInForm, SignUpButton, type SignUpData, SignUpForm, type SignUpResult, UserButton, VerifiedBadge, VerifyEmailStatus, type VerifyOptions, type WithAuthOptions, useAuth, useData, useGitHat };
+export { type AuthActions, type AuthPayload, type AuthState, type AuthenticatedHandler, type BatchOperation, type BatchResult, ChangePasswordForm, CognitoButton, CognitoCallback, type DataItem, type DeleteResult, type EmailVerificationResult, ForgotPasswordForm, type GitHatConfig, type GitHatContextValue, type GitHatOrg, GitHatProvider, type GitHatUser, GitHubButton, GitHubCallback, type OrgMetadata, OrgSwitcher, type PasswordResetResult, ProtectedRoute, type PutResult, type QueryOptions, type QueryResult, ResetPasswordForm, type SendEmailOptions, type SendEmailResult, type ServerSendEmailOptions, type ServerSendEmailResult, SignInButton, SignInForm, SignUpButton, type SignUpData, SignUpForm, type SignUpResult, UserButton, VerifiedBadge, VerifyEmailStatus, type VerifyOptions, type WithAuthOptions, useAuth, useData, useEmail, useGitHat };