Credit Balance: {user.credits.balance}
Tier: {user.credits.tier}
{user.credits.isLowBalance && (
Running low on credits! Consider upgrading.
)}
{user.credits.nextAllocationDate && (
Next allocation: {new Date(user.credits.nextAllocationDate).toLocaleDateString()}
)}
);
}
}
```
### Credit History
View detailed transaction history:
```typescript theme={null}
const response = await fetch('/api/credits/transactions?page=1&limit=20');
const { transactions, hasMore, total } = await response.json();
transactions.forEach(tx => {
console.log(`${tx.type}: ${tx.amount} credits (${tx.description})`);
});
```
See [Credits System](/user/credits-system) for more details.
## Referral Information
Your profile includes referral statistics:
### Referral Code
Every user has a unique 8-character referral code:
```typescript theme={null}
const response = await fetch('/api/referrals/link');
const { code, referralUrl } = await response.json();
console.log('Your code:', code); // e.g., "K7M2P9X4"
console.log('Share this:', referralUrl); // e.g., "https://joip.app?r=..."
```
### Referral Stats
```typescript theme={null}
const response = await fetch('/api/referrals/stats');
const stats = await response.json();
console.log({
totalReferrals: stats.totalReferrals, // Number of successful referrals
creditsEarned: stats.creditsEarned, // Total credits from referrals
referralCode: stats.referralCode, // Your code
isProgramActive: stats.isProgramActive // Program status
});
```
### Who Referred You
If you were referred:
```typescript theme={null}
if (user.referredBy) {
console.log('You were referred by user:', user.referredBy);
// Note: Referrer's identity (email, name) is not exposed for privacy
}
```
See [Referral Program](/user/referrals) for more details.
## Usage Statistics
Your account tracks comprehensive usage metrics:
### Tracked Metrics
**Sessions:**
* Sessions created
* Sessions viewed
* Sessions edited/deleted
* Sessions shared/favorited
**Smart Captions:**
* Total captions generated
* Custom vs themed captions
* Caption themes used (JOI, Forced-Bi, Beta, etc.)
**Babecock Studio:**
* Images created
* Remixes created
* Layouts used (side-by-side vs top-bottom)
**HypnoCocks:**
* Total animations created
**Media Vault:**
* Media uploaded/deleted
* Media shared/downloaded
* Bulk downloads
**General:**
* Login count
* Pages viewed
* API calls total
* Time spent (minutes)
### Viewing Your Stats
Usage statistics are tracked in the `user_usage_stats` table:
```sql theme={null}
SELECT
sessions_created,
smart_captions_generated,
babecock_images_created,
media_uploaded,
login_count,
last_activity_at
FROM user_usage_stats
WHERE user_id = 'your-user-id';
```
**API Endpoint (if implemented):**
```typescript theme={null}
const response = await fetch('/api/user/stats');
const stats = await response.json();
```
### Activity Logs
Detailed activity logs are also maintained:
```typescript theme={null}
interface UserActivityLog {
id: number;
userId: string;
action: string; // e.g., 'session_created', 'caption_generated'
feature: string; // e.g., 'sessions', 'smart_captions'
details: object; // Action-specific metadata
ipAddress: string;
userAgent: string;
sessionId: string; // Browser session ID
createdAt: timestamp;
}
```
**Example Queries:**
```sql theme={null}
-- Recent activity
SELECT action, feature, created_at
FROM user_activity_logs
WHERE user_id = 'your-user-id'
ORDER BY created_at DESC
LIMIT 50;
-- Activity by feature
SELECT feature, COUNT(*) as count
FROM user_activity_logs
WHERE user_id = 'your-user-id'
GROUP BY feature
ORDER BY count DESC;
```
## Account Roles
### User Roles
| Role | Permissions |
| ------------- | ------------------------------------ |
| `user` | Standard access to all features |
| `admin` | User management, analytics, settings |
| `super_admin` | Full system access, admin management |
### Role-Based Access
Certain features require specific roles:
```typescript theme={null}
// Admin-only endpoints
app.get('/api/admin/users', isAdmin, handler);
app.get('/api/admin/analytics', isAdmin, handler);
// Admin check middleware
function isAdmin(req, res, next) {
const userId = getUserId(req);
const user = await storage.getUser(userId);
if (!user || (user.role !== 'admin' && user.role !== 'super_admin')) {
return res.status(403).json({ error: 'Admin access required' });
}
next();
}
```
### Requesting Admin Access
Admin access is granted manually:
1. Contact platform administrators
2. Provide justification for admin access
3. Admin creates temporary or permanent admin grant
4. Access logged in admin audit logs
## Profile Privacy
### What's Public
* First name (if you share content publicly)
* Profile image (if you share content publicly)
* Public sessions and media you create
### What's Private
* Email address
* Last name
* Birth date
* Credit balance and transactions
* Referral earnings
* Usage statistics
* Activity logs
* IP addresses
### Data Sanitization
Sensitive data is removed before sending to client:
```typescript theme={null}
function sanitizeUserForClient(user: User) {
const { password, ...safeUser } = user;
return safeUser;
}
```
**Never exposed:**
* Password hashes (local auth only)
* Session tokens
* Internal database IDs (in some contexts)
## Account Deletion
### Request Deletion
To delete your account:
1. Contact support with deletion request
2. Verify your identity
3. Admin processes deletion
### What Gets Deleted
**Immediately:**
* User profile record
* Session cookies
* Active sessions
**Cascading Deletes:**
* All sessions you created
* All media in your vault
* All activity logs
* Credit balance and transaction history
* Referral records (as referred user)
**Preserved (anonymized):**
* Community content you shared (anonymized)
* Referral records (as referrer - anonymized)
* Aggregate analytics (no personal identifiers)
### Cascade Behavior
Database foreign keys with `ON DELETE CASCADE`:
```sql theme={null}
-- Sessions deleted when user deleted
ALTER TABLE content_sessions
ADD CONSTRAINT fk_user
FOREIGN KEY (user_id) REFERENCES users(id)
ON DELETE CASCADE;
-- Media deleted when user deleted
ALTER TABLE user_media
ADD CONSTRAINT fk_user
FOREIGN KEY (user_id) REFERENCES users(id)
ON DELETE CASCADE;
```
## API Reference
### Get Current User