@proveanything/smartlinks 1.0.42 → 1.0.43

package/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.0.42  |  Generated: 2025-11-18T13:09:06.423Z
+Version: 1.0.43  |  Generated: 2025-11-22T12:58:28.713Z
 
 This is a concise summary of all available API functions and types.
 
@@ -14,6 +14,7 @@ The Smartlinks SDK is organized into the following namespaces:
 - **asset** - File upload and asset management for collections, products, and proofs
 - **attestation** - Digital attestations and verification for products
 - **auth** - Authentication, login, and user account management
+- **authKit** - Functions for authKit operations
 - **batch** - Product batch management and tracking
 - **claimSet** - Claim creation, management, and verification
 - **collection** - Collection CRUD operations and management
@@ -137,6 +138,119 @@ type UserAccountRegistrationRequest = {
 }
 ```
 
+### authKit
+
+**AuthKitUser** (interface)
+```typescript
+interface AuthKitUser {
+  uid: string
+  email?: string
+  displayName?: string | null
+  photoURL?: string | null
+  phoneNumber?: string | null
+  emailVerified?: boolean
+  accountData?: Record<string, any>
+}
+```
+
+**AuthLoginResponse** (interface)
+```typescript
+interface AuthLoginResponse {
+  token: string
+  user: AuthKitUser
+  accountData?: Record<string, any>
+}
+```
+
+**PhoneSendCodeResponse** (interface)
+```typescript
+interface PhoneSendCodeResponse {
+  verificationId: string
+  message: string
+}
+```
+
+**PhoneVerifyResponse** (interface)
+```typescript
+interface PhoneVerifyResponse {
+  token: string
+  user: AuthKitUser
+}
+```
+
+**PasswordResetRequestResponse** (interface)
+```typescript
+interface PasswordResetRequestResponse {
+  success: boolean
+  message: string
+}
+```
+
+**VerifyResetTokenResponse** (interface)
+```typescript
+interface VerifyResetTokenResponse {
+  valid: boolean
+  email?: string
+  expiresAt?: number
+  message?: string
+}
+```
+
+**PasswordResetCompleteResponse** (interface)
+```typescript
+interface PasswordResetCompleteResponse {
+  success: boolean
+  message: string
+}
+```
+
+**EmailVerificationActionResponse** (interface)
+```typescript
+interface EmailVerificationActionResponse {
+  success: boolean
+  message: string
+}
+```
+
+**EmailVerifyTokenResponse** (interface)
+```typescript
+interface EmailVerifyTokenResponse {
+  success: boolean
+  message: string
+  token?: string
+  user?: AuthKitUser
+}
+```
+
+**AuthKitBrandingConfig** (interface)
+```typescript
+interface AuthKitBrandingConfig {
+  logoUrl?: string
+  title?: string
+  subtitle?: string
+  primaryColor?: string
+  secondaryColor?: string
+  backgroundColor?: string
+  buttonStyle?: string
+  fontFamily?: string
+}
+```
+
+**AuthKitConfig** (interface)
+```typescript
+interface AuthKitConfig {
+  clientId: string
+  branding?: AuthKitBrandingConfig
+  enabledProviders?: string[]
+  customCss?: string
+  termsUrl?: string
+  privacyUrl?: string
+  supportEmail?: string
+  redirectUrl?: string
+  updatedAt?: string
+}
+```
+
 ### batch
 
 **BatchResponse** = `any`
@@ -645,6 +759,59 @@ Admin: Get a user bearer token (impersonation/automation). POST /admin/auth/user
 **getAccount**() → `Promise<AccountInfoResponse>`
 Gets current account information for the logged in user. Returns user, owner, account, and location objects.
 
+### authKit
+
+**login**(clientId: string, email: string, password: string) → `Promise<AuthLoginResponse>`
+Login with email + password (public).
+
+**register**(clientId: string, data: { email: string; password: string; displayName?: string; accountData?: Record<string, any> }) → `Promise<AuthLoginResponse>`
+Register a new user (public).
+
+**googleLogin**(clientId: string, idToken: string) → `Promise<AuthLoginResponse>`
+Google OAuth login (public).
+
+**sendPhoneCode**(clientId: string, phoneNumber: string) → `Promise<PhoneSendCodeResponse>`
+Send phone verification code (public).
+
+**verifyPhoneCode**(clientId: string, verificationId: string, code: string) → `Promise<PhoneVerifyResponse>`
+Verify phone verification code (public).
+
+**requestPasswordReset**(clientId: string, data: { email: string; redirectUrl?: string; clientName?: string }) → `Promise<PasswordResetRequestResponse>`
+Verify phone verification code (public).
+
+**verifyResetToken**(clientId: string, token: string) → `Promise<VerifyResetTokenResponse>`
+Verify phone verification code (public).
+
+**completePasswordReset**(clientId: string, token: string, newPassword: string) → `Promise<PasswordResetCompleteResponse>`
+Verify phone verification code (public).
+
+**sendEmailVerification**(clientId: string, data: { userId: string; email: string; redirectUrl?: string; clientName?: string }) → `Promise<EmailVerificationActionResponse>`
+Verify phone verification code (public).
+
+**verifyEmail**(clientId: string, token: string) → `Promise<EmailVerifyTokenResponse>`
+Verify phone verification code (public).
+
+**resendEmailVerification**(clientId: string, data: { userId: string; email: string; redirectUrl?: string; clientName?: string }) → `Promise<EmailVerificationActionResponse>`
+Verify phone verification code (public).
+
+**load**(authKitId: string) → `Promise<AuthKitConfig>`
+Verify phone verification code (public).
+
+**get**(collectionId: string, authKitId: string) → `Promise<AuthKitConfig>`
+Verify phone verification code (public).
+
+**list**(collectionId: string, admin?: boolean) → `Promise<AuthKitConfig[]>`
+Verify phone verification code (public).
+
+**create**(collectionId: string, data: any) → `Promise<AuthKitConfig>`
+Verify phone verification code (public).
+
+**update**(collectionId: string, authKitId: string, data: any) → `Promise<AuthKitConfig>`
+Verify phone verification code (public).
+
+**remove**(collectionId: string, authKitId: string) → `Promise<void>`
+Verify phone verification code (public).
+
 ### batch
 
 **get**(collectionId: string,

package/dist/api/authKit.d.ts

@@ -0,0 +1,48 @@
+import type { AuthLoginResponse, PhoneSendCodeResponse, PhoneVerifyResponse, PasswordResetRequestResponse, VerifyResetTokenResponse, PasswordResetCompleteResponse, EmailVerificationActionResponse, EmailVerifyTokenResponse, AuthKitConfig } from "../types/authKit";
+/**
+ * Namespace containing helper functions for the new AuthKit API.
+ * Legacy collection-based authKit helpers retained (marked as *Legacy*).
+ */
+export declare namespace authKit {
+    /** Login with email + password (public). */
+    function login(clientId: string, email: string, password: string): Promise<AuthLoginResponse>;
+    /** Register a new user (public). */
+    function register(clientId: string, data: {
+        email: string;
+        password: string;
+        displayName?: string;
+        accountData?: Record<string, any>;
+    }): Promise<AuthLoginResponse>;
+    /** Google OAuth login (public). */
+    function googleLogin(clientId: string, idToken: string): Promise<AuthLoginResponse>;
+    /** Send phone verification code (public). */
+    function sendPhoneCode(clientId: string, phoneNumber: string): Promise<PhoneSendCodeResponse>;
+    /** Verify phone verification code (public). */
+    function verifyPhoneCode(clientId: string, verificationId: string, code: string): Promise<PhoneVerifyResponse>;
+    function requestPasswordReset(clientId: string, data: {
+        email: string;
+        redirectUrl?: string;
+        clientName?: string;
+    }): Promise<PasswordResetRequestResponse>;
+    function verifyResetToken(clientId: string, token: string): Promise<VerifyResetTokenResponse>;
+    function completePasswordReset(clientId: string, token: string, newPassword: string): Promise<PasswordResetCompleteResponse>;
+    function sendEmailVerification(clientId: string, data: {
+        userId: string;
+        email: string;
+        redirectUrl?: string;
+        clientName?: string;
+    }): Promise<EmailVerificationActionResponse>;
+    function verifyEmail(clientId: string, token: string): Promise<EmailVerifyTokenResponse>;
+    function resendEmailVerification(clientId: string, data: {
+        userId: string;
+        email: string;
+        redirectUrl?: string;
+        clientName?: string;
+    }): Promise<EmailVerificationActionResponse>;
+    function load(authKitId: string): Promise<AuthKitConfig>;
+    function get(collectionId: string, authKitId: string): Promise<AuthKitConfig>;
+    function list(collectionId: string, admin?: boolean): Promise<AuthKitConfig[]>;
+    function create(collectionId: string, data: any): Promise<AuthKitConfig>;
+    function update(collectionId: string, authKitId: string, data: any): Promise<AuthKitConfig>;
+    function remove(collectionId: string, authKitId: string): Promise<void>;
+}

package/dist/api/authKit.js

@@ -0,0 +1,100 @@
+import { request, post, put, del } from "../http";
+/**
+ * Namespace containing helper functions for the new AuthKit API.
+ * Legacy collection-based authKit helpers retained (marked as *Legacy*).
+ */
+export var authKit;
+(function (authKit) {
+    /* ===================================
+     * Authentication (Per client)
+     * =================================== */
+    /** Login with email + password (public). */
+    async function login(clientId, email, password) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/login`, { email, password });
+    }
+    authKit.login = login;
+    /** Register a new user (public). */
+    async function register(clientId, data) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/register`, data);
+    }
+    authKit.register = register;
+    /** Google OAuth login (public). */
+    async function googleLogin(clientId, idToken) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/google`, { idToken });
+    }
+    authKit.googleLogin = googleLogin;
+    /** Send phone verification code (public). */
+    async function sendPhoneCode(clientId, phoneNumber) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/phone/send-code`, { phoneNumber });
+    }
+    authKit.sendPhoneCode = sendPhoneCode;
+    /** Verify phone verification code (public). */
+    async function verifyPhoneCode(clientId, verificationId, code) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/phone/verify`, { verificationId, code });
+    }
+    authKit.verifyPhoneCode = verifyPhoneCode;
+    /* ===================================
+     * Password Reset (Public flows)
+     * =================================== */
+    async function requestPasswordReset(clientId, data) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/reset-password`, data);
+    }
+    authKit.requestPasswordReset = requestPasswordReset;
+    async function verifyResetToken(clientId, token) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/verify-reset-token`, { token });
+    }
+    authKit.verifyResetToken = verifyResetToken;
+    async function completePasswordReset(clientId, token, newPassword) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/complete-reset`, { token, newPassword });
+    }
+    authKit.completePasswordReset = completePasswordReset;
+    /* ===================================
+     * Email Verification
+     * =================================== */
+    async function sendEmailVerification(clientId, data) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/send-verification`, data);
+    }
+    authKit.sendEmailVerification = sendEmailVerification;
+    async function verifyEmail(clientId, token) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/verify-email`, { token });
+    }
+    authKit.verifyEmail = verifyEmail;
+    async function resendEmailVerification(clientId, data) {
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/resend-verification`, data);
+    }
+    authKit.resendEmailVerification = resendEmailVerification;
+    /* ===================================
+     * Collection-based AuthKit
+     * =================================== */
+    async function load(authKitId) {
+        const path = `authKit/${encodeURIComponent(authKitId)}`;
+        return request(path);
+    }
+    authKit.load = load;
+    async function get(collectionId, authKitId) {
+        const path = `admin/collection/${encodeURIComponent(collectionId)}/authKit/${encodeURIComponent(authKitId)}`;
+        return request(path);
+    }
+    authKit.get = get;
+    async function list(collectionId, admin) {
+        const base = admin ? "/admin" : "/public";
+        const path = `${base}/collection/${encodeURIComponent(collectionId)}/authKit`;
+        return request(path);
+    }
+    authKit.list = list;
+    async function create(collectionId, data) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/authKit`;
+        return post(path, data);
+    }
+    authKit.create = create;
+    async function update(collectionId, authKitId, data) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/authKit/${encodeURIComponent(authKitId)}`;
+        return put(path, data);
+    }
+    authKit.update = update;
+    async function remove(collectionId, authKitId) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/authKit/${encodeURIComponent(authKitId)}`;
+        return del(path);
+    }
+    authKit.remove = remove;
+})(authKit || (authKit = {}));

package/dist/api/index.d.ts

@@ -7,6 +7,7 @@ export { asset } from "./asset";
 export { attestation } from "./attestation";
 export { auth } from "./auth";
 export { form } from "./form";
+export { authKit } from "./authKit";
 export { claimSet } from "./claimSet";
 export { crate } from "./crate";
 export { batch } from "./batch";

package/dist/api/index.js

@@ -9,6 +9,7 @@ export { asset } from "./asset";
 export { attestation } from "./attestation";
 export { auth } from "./auth";
 export { form } from "./form";
+export { authKit } from "./authKit";
 export { claimSet } from "./claimSet";
 export { crate } from "./crate";
 export { batch } from "./batch";

package/dist/types/authKit.d.ts

@@ -0,0 +1,67 @@
+export interface AuthKitUser {
+    uid: string;
+    email?: string;
+    displayName?: string | null;
+    photoURL?: string | null;
+    phoneNumber?: string | null;
+    emailVerified?: boolean;
+    accountData?: Record<string, any>;
+}
+export interface AuthLoginResponse {
+    token: string;
+    user: AuthKitUser;
+    accountData?: Record<string, any>;
+}
+export interface PhoneSendCodeResponse {
+    verificationId: string;
+    message: string;
+}
+export interface PhoneVerifyResponse {
+    token: string;
+    user: AuthKitUser;
+}
+export interface PasswordResetRequestResponse {
+    success: boolean;
+    message: string;
+}
+export interface VerifyResetTokenResponse {
+    valid: boolean;
+    email?: string;
+    expiresAt?: number;
+    message?: string;
+}
+export interface PasswordResetCompleteResponse {
+    success: boolean;
+    message: string;
+}
+export interface EmailVerificationActionResponse {
+    success: boolean;
+    message: string;
+}
+export interface EmailVerifyTokenResponse {
+    success: boolean;
+    message: string;
+    token?: string;
+    user?: AuthKitUser;
+}
+export interface AuthKitBrandingConfig {
+    logoUrl?: string;
+    title?: string;
+    subtitle?: string;
+    primaryColor?: string;
+    secondaryColor?: string;
+    backgroundColor?: string;
+    buttonStyle?: string;
+    fontFamily?: string;
+}
+export interface AuthKitConfig {
+    clientId: string;
+    branding?: AuthKitBrandingConfig;
+    enabledProviders?: string[];
+    customCss?: string;
+    termsUrl?: string;
+    privacyUrl?: string;
+    supportEmail?: string;
+    redirectUrl?: string;
+    updatedAt?: string;
+}

package/dist/types/authKit.js

@@ -0,0 +1,2 @@
+// Types for the AuthKit API
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.0.42",
+  "version": "1.0.43",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",