@varity-labs/sdk 2.0.0-alpha.1

package/dist/core/credentials.js

@@ -0,0 +1,345 @@
+/**
+ * Varity SDK - Shared Development Credentials
+ *
+ * Provides shared development credentials for seamless developer experience.
+ * Developers can use Varity packages without manually setting up Privy and thirdweb credentials.
+ *
+ * **IMPORTANT**: These credentials are for DEVELOPMENT/TESTING ONLY.
+ * For production deployments, you MUST use your own credentials.
+ *
+ * @example Zero-config development
+ * ```tsx
+ * import { PrivyStack } from '@varity-labs/ui-kit';
+ *
+ * // Works immediately - uses shared dev credentials
+ * <PrivyStack>
+ *   <YourApp />
+ * </PrivyStack>
+ * ```
+ *
+ * @example Production with custom credentials
+ * ```tsx
+ * import { PrivyStack } from '@varity-labs/ui-kit';
+ *
+ * <PrivyStack
+ *   appId={process.env.PRIVY_APP_ID}
+ *   thirdwebClientId={process.env.THIRDWEB_CLIENT_ID}
+ * >
+ *   <YourApp />
+ * </PrivyStack>
+ * ```
+ */
+/**
+ * Shared development credentials configuration
+ *
+ * These credentials are managed by Varity and shared across all development environments.
+ * They enable developers to start building immediately without manual credential setup.
+ *
+ * **Security Notes**:
+ * - Rate limiting is applied to prevent abuse
+ * - Only works with Varity L3 Testnet (Chain ID 33529)
+ * - Not suitable for production use
+ * - May be rotated periodically
+ *
+ * **When to Upgrade**:
+ * - Moving to production
+ * - Need custom branding in auth flows
+ * - Require higher rate limits
+ * - Building on non-Varity chains
+ */
+/**
+ * VARITY_DEV_CREDENTIALS - Loaded from Credential Proxy or Environment Variables
+ *
+ * SECURITY: Credentials are NO LONGER hardcoded in this file.
+ * They are fetched from:
+ * 1. Varity Credential Proxy (api.varity.so/credentials) - Recommended
+ * 2. Environment variables (VARITY_PRIVY_APP_ID, VARITY_THIRDWEB_CLIENT_ID)
+ *
+ * The credential proxy ensures credentials are never exposed in client bundles.
+ */
+export const VARITY_DEV_CREDENTIALS = {
+    /**
+     * Privy configuration
+     *
+     * Privy provides authentication (email, social, wallet).
+     * Get your own credentials at: https://dashboard.privy.io
+     */
+    privy: {
+        /**
+         * Privy App ID - loaded from environment variable
+         *
+         * Set VARITY_PRIVY_APP_ID in your environment
+         * Or use the Varity Credential Proxy for automatic credentials
+         */
+        appId: process.env.VARITY_PRIVY_APP_ID || '',
+    },
+    /**
+     * thirdweb configuration
+     *
+     * thirdweb provides blockchain infrastructure (chain abstraction, contracts, storage).
+     * Get your own credentials at: https://thirdweb.com/dashboard
+     */
+    thirdweb: {
+        /**
+         * thirdweb Client ID - loaded from environment variable
+         *
+         * Set VARITY_THIRDWEB_CLIENT_ID in your environment
+         * Or use the Varity Credential Proxy for automatic credentials
+         */
+        clientId: process.env.VARITY_THIRDWEB_CLIENT_ID || '',
+    },
+    /**
+     * Rate limiting information (informational only)
+     */
+    rateLimits: {
+        privy: {
+            monthlyActiveUsers: 1000,
+            note: 'Shared via Varity Credential Proxy',
+        },
+        thirdweb: {
+            requestsPerSecond: 100,
+            note: 'Shared via Varity Credential Proxy',
+        },
+    },
+};
+/**
+ * Check if using shared development credentials
+ *
+ * @param appId - Privy app ID to check
+ * @param clientId - thirdweb client ID to check
+ * @returns true if using shared development credentials
+ *
+ * @example
+ * ```typescript
+ * if (isUsingDevCredentials(appId, clientId)) {
+ *   console.warn('Using shared dev credentials - upgrade for production');
+ * }
+ * ```
+ */
+export function isUsingDevCredentials(appId, clientId) {
+    const defaultAppId = VARITY_DEV_CREDENTIALS.privy.appId;
+    const defaultClientId = VARITY_DEV_CREDENTIALS.thirdweb.clientId;
+    return appId === defaultAppId || clientId === defaultClientId;
+}
+/**
+ * Check if credentials are suitable for production use
+ *
+ * @param appId - Privy app ID to check
+ * @param clientId - thirdweb client ID to check
+ * @returns true if credentials are production-ready
+ *
+ * @example
+ * ```typescript
+ * if (!isProductionCredentials(appId, clientId)) {
+ *   throw new Error('Production requires custom credentials');
+ * }
+ * ```
+ */
+export function isProductionCredentials(appId, clientId) {
+    return !isUsingDevCredentials(appId, clientId) && !!appId && !!clientId;
+}
+/**
+ * Get warning message for development credential usage
+ *
+ * @param environment - Current environment (development, staging, production)
+ * @returns Warning message or null (deprecated - always returns null)
+ *
+ * @deprecated This function is deprecated. Varity now uses credential proxy
+ * and provides a seamless experience without warnings.
+ *
+ * @example
+ * ```typescript
+ * const warning = getCredentialWarning('production');
+ * // Always returns null now
+ * ```
+ */
+export function getCredentialWarning(environment) {
+    // Deprecated: Warnings removed to provide seamless developer experience
+    // Varity Credential Proxy handles credentials securely without user intervention
+    return null;
+}
+/**
+ * Log development credential usage warning
+ *
+ * @param appId - Privy app ID being used
+ * @param clientId - thirdweb client ID being used
+ * @param usingProxy - Whether credentials are from proxy (suppresses warnings)
+ *
+ * @example
+ * ```typescript
+ * logCredentialUsage(appId, clientId);
+ * // Logs friendly message if using shared dev credentials
+ * ```
+ */
+export function logCredentialUsage(appId, clientId, usingProxy = false) {
+    if (!isUsingDevCredentials(appId, clientId)) {
+        return; // Using custom credentials - no message needed
+    }
+    // If using proxy, it handles its own messaging
+    if (usingProxy) {
+        return;
+    }
+    // Show single friendly message (only in development)
+    if (process.env.NODE_ENV === 'development') {
+        console.log('✓ Using Varity authentication (no setup required)');
+    }
+    // In production, silently use credentials without warnings
+    // Developer can upgrade to custom credentials when ready
+}
+/**
+ * Resolve credentials with fallback to dev credentials
+ *
+ * @param appId - Custom Privy app ID (optional)
+ * @param clientId - Custom thirdweb client ID (optional)
+ * @param usingProxy - Whether credentials are from proxy (suppresses warnings)
+ * @returns Resolved credential configuration
+ *
+ * @example
+ * ```typescript
+ * const creds = resolveCredentials(customAppId, customClientId);
+ * // Falls back to VARITY_DEV_CREDENTIALS if custom credentials not provided
+ * ```
+ */
+export function resolveCredentials(appId, clientId, usingProxy = false) {
+    // Try to resolve from provided values, env vars, or VARITY_DEV_CREDENTIALS
+    const resolvedAppId = appId ||
+        process.env.VARITY_PRIVY_APP_ID ||
+        VARITY_DEV_CREDENTIALS.privy.appId;
+    const resolvedClientId = clientId ||
+        process.env.VARITY_THIRDWEB_CLIENT_ID ||
+        VARITY_DEV_CREDENTIALS.thirdweb.clientId;
+    // Check if we have valid credentials
+    if (!resolvedAppId || !resolvedClientId) {
+        throw new Error(`Varity credentials not configured.
+
+Please provide credentials via:
+1. Component props (appId, thirdwebClientId)
+2. Environment variables (VARITY_PRIVY_APP_ID, VARITY_THIRDWEB_CLIENT_ID)
+3. Varity Credential Proxy (automatic when deployed via Varity)
+
+Get credentials at:
+- Privy: https://dashboard.privy.io
+- thirdweb: https://thirdweb.com/dashboard`);
+    }
+    const resolved = {
+        privy: {
+            appId: resolvedAppId,
+        },
+        thirdweb: {
+            clientId: resolvedClientId,
+        },
+    };
+    // Log usage info (suppressed if using proxy)
+    logCredentialUsage(resolved.privy.appId, resolved.thirdweb.clientId, usingProxy);
+    return resolved;
+}
+/**
+ * Validate credentials are configured correctly
+ *
+ * @param appId - Privy app ID to validate
+ * @param clientId - thirdweb client ID to validate
+ * @throws Error if credentials are invalid
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validateCredentials(appId, clientId);
+ * } catch (error) {
+ *   console.error('Invalid credentials:', error.message);
+ * }
+ * ```
+ */
+export function validateCredentials(appId, clientId) {
+    if (!appId || appId.trim() === '') {
+        throw new Error('Privy App ID is required. Get one at: https://dashboard.privy.io');
+    }
+    if (!clientId || clientId.trim() === '') {
+        throw new Error('thirdweb Client ID is required. Get one at: https://thirdweb.com/dashboard');
+    }
+    // Validate format (basic checks)
+    if (!appId.startsWith('clp')) {
+        console.warn(`⚠️  Privy App ID should start with 'clp'. Current: ${appId}`);
+    }
+}
+/**
+ * Get upgrade instructions for production
+ *
+ * @returns Markdown-formatted upgrade instructions
+ *
+ * @example
+ * ```typescript
+ * console.log(getUpgradeInstructions());
+ * ```
+ */
+export function getUpgradeInstructions() {
+    return `
+# Upgrading to Production Credentials
+
+## Why Upgrade?
+
+Shared development credentials (VARITY_DEV_CREDENTIALS) are:
+- Rate limited across all developers
+- May be rotated periodically
+- Not suitable for production use
+- Lack custom branding options
+
+## How to Upgrade
+
+### 1. Get Privy App ID
+
+1. Visit https://dashboard.privy.io
+2. Sign up or log in
+3. Create a new app
+4. Copy your App ID (starts with 'clp')
+5. Configure login methods (email, social, wallet)
+
+### 2. Get thirdweb Client ID
+
+1. Visit https://thirdweb.com/dashboard
+2. Sign up or log in
+3. Create a new project
+4. Copy your Client ID
+5. Configure allowed domains
+
+### 3. Set Environment Variables
+
+\`\`\`bash
+# .env.local
+PRIVY_APP_ID=your-privy-app-id
+THIRDWEB_CLIENT_ID=your-thirdweb-client-id
+\`\`\`
+
+### 4. Update Your Code
+
+\`\`\`tsx
+import { PrivyStack } from '@varity-labs/ui-kit';
+
+<PrivyStack
+  appId={process.env.PRIVY_APP_ID}
+  thirdwebClientId={process.env.THIRDWEB_CLIENT_ID}
+>
+  <YourApp />
+</PrivyStack>
+\`\`\`
+
+## Benefits
+
+- ✅ Unlimited usage (within your plan limits)
+- ✅ Custom branding in auth flows
+- ✅ Production support
+- ✅ Analytics and monitoring
+- ✅ No credential rotation concerns
+
+## Cost
+
+Both Privy and thirdweb offer generous free tiers:
+- **Privy**: Free up to 1,000 MAU
+- **thirdweb**: Free tier available
+
+## Need Help?
+
+- Documentation: https://docs.varity.io/credentials
+- Discord: https://discord.gg/varity
+- Support: support@varity.io
+`;
+}

package/dist/core/template-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Template Loader
+ *
+ * Utility for loading and registering built-in templates
+ */
+import { TemplateConfig } from './template';
+/**
+ * Load built-in ISO template
+ */
+export declare function loadISOTemplate(): TemplateConfig;
+/**
+ * Load all built-in templates
+ */
+export declare function loadAllTemplates(): void;
+//# sourceMappingURL=template-loader.d.ts.map

package/dist/core/template-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-loader.d.ts","sourceRoot":"","sources":["../../src/core/template-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAA;AAO7D;;GAEG;AACH,wBAAgB,eAAe,IAAI,cAAc,CAsWhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}