fix: align documentation with actual source APIs and fix template code issues

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

apps/docs/app/docs/[[...slug]]/page.tsx

@@ -23,7 +23,7 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
         <ViewOptions
           markdownUrl={`${page.url}.mdx`}
           // update it to match your repo
-          githubUrl={`https://github.com/${gitConfig.user}/${gitConfig.repo}/blob/${gitConfig.branch}/content/docs/${page.path}`}
+          githubUrl={`https://github.com/${gitConfig.user}/${gitConfig.repo}/blob/${gitConfig.branch}/apps/docs/content/docs/${page.path}`}
         />
       </div>
       <DocsBody>

apps/docs/app/og/docs/[...slug]/route.tsx

@@ -21,7 +21,6 @@ export async function GET(_req: Request, { params }: RouteContext<'/og/docs/[...
 
 export function generateStaticParams() {
   return source.getPages().map((page) => ({
-    lang: page.locale,
     slug: getPageImage(page).segments,
   }));
 }

apps/docs/components/ai/page-actions.tsx

@@ -24,16 +24,13 @@ export function LLMCopyButton({
     setLoading(true);
 
     try {
-      await navigator.clipboard.write([
-        new ClipboardItem({
-          'text/plain': fetch(markdownUrl).then(async (res) => {
-            const content = await res.text();
-            cache.set(markdownUrl, content);
-
-            return content;
-          }),
-        }),
-      ]);
+      const res = await fetch(markdownUrl);
+      if (!res.ok) {
+        throw new Error(`Failed to fetch markdown: ${res.status}`);
+      }
+      const content = await res.text();
+      cache.set(markdownUrl, content);
+      await navigator.clipboard.writeText(content);
     } finally {
       setLoading(false);
     }

apps/docs/content/docs/libraries/auth.mdx

@@ -21,7 +21,7 @@ setObjectStackApiUrl('https://your-server.objectstack.com');
 const client = createObjectStackClient(authToken);
 
 // Retrieve existing singleton
-const client = getObjectStackClient();
+const existingClient = getObjectStackClient();
 ```
 
 ## auth-client.ts

apps/docs/content/docs/libraries/data.mdx

@@ -25,20 +25,22 @@ Write-ahead sync queue for offline mutations. Entries are stored in SQLite and p
 
 ```ts
 interface SyncQueueEntry {
-  id: string;
+  id: number;
   objectName: string;
+  recordId: string;
   operation: 'create' | 'update' | 'delete';
-  recordId?: string;
-  payload: Record<string, unknown>;
+  payload: string;            // JSON-encoded
   status: 'pending' | 'in_progress' | 'failed' | 'conflict';
-  retryCount: number;
-  createdAt: number;
+  retries: number;
+  errorMessage: string | null;
+  createdAt: number;          // timestamp (ms)
+  updatedAt: number;          // timestamp (ms)
 }
 
 interface ConflictInfo {
-  localVersion: Record<string, unknown>;
-  serverVersion: Record<string, unknown>;
-  conflictFields: string[];
+  entry: SyncQueueEntry;
+  serverRecord: Record<string, unknown> | null;
+  localRecord: Record<string, unknown> | null;
 }
 ```
 
@@ -82,14 +84,14 @@ Uses `expo-background-fetch` and `expo-task-manager` to drain the sync queue whe
 ObjectQL filter AST helpers for building typed query filters.
 
 ```ts
-import { OPERATOR_META } from '@/lib/query-builder';
-
-// Available operators with metadata
-OPERATOR_META = {
-  eq: { label: 'Equals', types: ['text', 'number', 'date', ...] },
-  neq: { label: 'Not Equals', types: ['text', 'number', 'date', ...] },
-  contains: { label: 'Contains', types: ['text'] },
-  between: { label: 'Between', types: ['number', 'date'] },
-  // ... more operators
-};
+import { OPERATOR_META, operatorsForFieldType } from '@/lib/query-builder';
+
+// Read operator metadata (exported as a const)
+OPERATOR_META.eq;       // { label: 'equals', valueCount: 1 }
+OPERATOR_META.between;  // { label: 'is between', valueCount: 2 }
+OPERATOR_META.is_null;  // { label: 'is empty', valueCount: 0 }
+
+// Get valid operators for a field type
+const ops = operatorsForFieldType('text');
+// ['eq', 'neq', 'is_null', 'is_not_null', 'contains', 'not_contains', 'starts_with', 'ends_with', 'in', 'not_in']
 ```

apps/docs/content/docs/libraries/monitoring.mdx

@@ -29,7 +29,7 @@ import { createAnalyticsTracker } from '@/lib/analytics';
 const tracker = createAnalyticsTracker({
   endpoint: 'https://analytics.objectstack.com/events',
   batchSize: 20,
-  flushInterval: 30000, // 30 seconds
+  flushIntervalMs: 30_000, // 30 seconds
 });
 
 // Track events (queued and flushed in batches)
@@ -56,21 +56,33 @@ try {
 }
 ```
 
-Error codes: `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `VALIDATION`, `CONFLICT`, `RATE_LIMITED`, `SERVER_ERROR`, `NETWORK_ERROR`, `TIMEOUT`.
+Error codes: `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `VALIDATION_ERROR`, `CONFLICT`, `RATE_LIMITED`, `INTERNAL_ERROR`, `NETWORK_ERROR`, `TIMEOUT`.
 
 ## performance-benchmark.ts
 
 Performance metric tracking with configurable thresholds.
 
 ```ts
-import type { BenchmarkConfig } from '@/lib/performance-benchmark';
-
-const config: BenchmarkConfig = {
-  appStartup: { threshold: 2000 },    // 2s max
-  screenRender: { threshold: 500 },   // 500ms max
-  apiResponse: { threshold: 3000 },   // 3s max
-  frameTime: { threshold: 16.67 },    // 60fps target
-};
+import { createPerformanceBenchmark } from '@/lib/performance-benchmark';
+
+const bench = createPerformanceBenchmark({
+  appStartup: 2000,     // 2s max
+  screenRender: 500,    // 500ms max
+  apiResponse: 3000,    // 3s max
+  frameTime: 16.67,     // 60fps target
+});
+
+// Record a measurement
+bench.measure('login-api', 450, 'apiResponse');
+
+// Time an async operation
+const { result, measurement } = await bench.timeAsync(
+  'fetch-contacts', () => fetchContacts(), 'apiResponse',
+);
+
+// Get aggregate report
+const report = bench.getReport();
+// { measurements, thresholds, passedCount, failedCount, passRate }
 ```
 
 ## memory-profiler.ts
@@ -80,16 +92,19 @@ Memory leak detection for development builds.
 ```ts
 import { createMemoryTracker } from '@/lib/memory-profiler';
 
-const tracker = createMemoryTracker({
-  leakThreshold: 10, // Report after 10 unmatched mounts
-});
+const tracker = createMemoryTracker();
+
+// Register a resource (component mount, subscription, etc.)
+tracker.track('ContactList', () => cleanup());
+
+// Unregister when done (component unmount, unsubscribe)
+tracker.untrack('ContactList');
 
-// Track component lifecycle
-tracker.onMount('ContactList');
-tracker.onUnmount('ContactList');
+// Report entries tracked longer than 30s (potential leaks)
+const leaks = tracker.reportLeaks(30_000);
 
-// Check for leaks
-const leaks = tracker.getLeaks();
+// Clean up all tracked entries
+tracker.disposeAll();
 ```
 
-Tracks component mounts, subscriptions, and event listeners. Reports potential memory leaks when unmount counts don't match mount counts above a configurable threshold.
+Tracks component mounts, subscriptions, and event listeners. Entries that remain tracked beyond the threshold are reported as potential leaks in development builds.

apps/docs/content/docs/libraries/security.mdx

@@ -13,33 +13,43 @@ import {
   validateCertificatePin,
 } from '@/lib/certificate-pinning';
 
-// Build a pinning policy
-const policy = buildPinningPolicy({
-  hostname: 'api.objectstack.com',
-  pins: ['sha256/AAAA...', 'sha256/BBBB...'],
-});
-
-// Validate during network requests
-const isValid = await validateCertificatePin(policy);
+// Build a pinning policy from the API base URL
+const policy = buildPinningPolicy(
+  'https://api.objectstack.com',
+  ['sha256/AAAA...', 'sha256/BBBB...'],
+);
+// Returns: { hostname, pins, enforced: true, maxChainLength: 3 }
+
+// Validate a certificate hash against the policy
+const isValid = validateCertificatePin(policy, 'sha256/AAAA...');
 ```
 
 ## security-audit.ts
 
 Pre-release security checklist and audit report generator.
 
 ```ts
-import { createSecurityAudit } from '@/lib/security-audit';
+import { createSecurityAudit, getDefaultSecurityChecks } from '@/lib/security-audit';
 
 const audit = createSecurityAudit();
 
-// Register checks
-audit.addCheck('https-enforced', () => checkHTTPS());
-audit.addCheck('cert-pinning', () => checkCertPinning());
-audit.addCheck('secure-storage', () => checkSecureStorage());
+// Register checks using the AuditCheckDefinition shape
+audit.addCheck({
+  id: 'https-only',
+  description: 'API communication uses HTTPS',
+  severity: 'critical',
+  evaluate: () => apiUrl.startsWith('https://'),
+  failureDetail: 'All API communication must use HTTPS.',
+});
+
+// Or use the built-in check set
+for (const check of getDefaultSecurityChecks({ httpsOnly: true, biometricEnabled: true })) {
+  audit.addCheck(check);
+}
 
 // Generate report
 const report = await audit.run();
-// { passed: ['https-enforced', ...], failed: [...], score: 0.95 }
+// { checks: AuditCheckResult[], passedCount, failedCount, score: 0–100 }
 ```
 
 ## app-lock.ts

apps/docs/content/docs/libraries/utilities.mdx

@@ -50,14 +50,22 @@ Feature flag manager with A/B testing support.
 import { createFeatureFlagManager } from '@/lib/feature-flags';
 
 const manager = createFeatureFlagManager({
-  flags: {
-    'new-dashboard': { enabled: true, rollout: 50 },
-    'ai-search': { enabled: false },
-  },
+  endpoint: 'https://server.objectstack.com/flags',
+  refreshIntervalMs: 300_000, // 5 minutes
+  defaults: [
+    { key: 'new-dashboard', enabled: true, rolloutPercentage: 50 },
+    { key: 'ai-search', enabled: false },
+  ],
 });
 
-// Evaluate a flag (considers rollout percentage)
-const isEnabled = manager.evaluate('new-dashboard', userId);
+// Set user for rollout bucketing
+manager.setUserId(userId);
+
+// Evaluate a flag (considers rolloutPercentage)
+const enabled = manager.isEnabled('new-dashboard');
+
+// Start periodic refresh
+manager.startPolling();
 ```
 
 Uses `hashUserToPercentage()` for deterministic percentage-based bucketing.
@@ -71,25 +79,30 @@ import { createRemoteConfigManager } from '@/lib/remote-config';
 
 const config = createRemoteConfigManager({
   endpoint: 'https://server.objectstack.com/config',
-  pollInterval: 300000, // 5 minutes
+  refreshIntervalMs: 600_000, // 10 minutes
+  defaults: { maxUploadSizeMB: 10 },
 });
 
 // Fetch latest config
 await config.refresh();
 
 // Get a value (falls back to cached)
-const value = config.get('maxUploadSizeMB'); // 10
+const value = config.getValue<number>('maxUploadSizeMB');
+
+// Get with fallback
+const limit = config.getValueWithDefault('maxUploadSizeMB', 10);
 ```
 
 ## app-store-review.ts
 
-App Store submission checklist validation.
+App Store submission checklist validation against Expo app config.
 
 ```ts
-import type { ReviewChecklist } from '@/lib/app-store-review';
+import { validateAppStoreReadiness } from '@/lib/app-store-review';
+import type { AppConfig, ReviewReport, ReviewCheckItem } from '@/lib/app-store-review';
 
-// Validates against expo app.json config
-// Checks: metadata, assets, privacy, compliance
+const report: ReviewReport = validateAppStoreReadiness(appConfig);
+// { checks: ReviewCheckItem[], passedCount, failedCount, readiness: 0–100 }
 ```
 
 ## utils.ts

apps/docs/next.config.mjs

@@ -7,6 +7,10 @@ const config = {
   reactStrictMode: true,
   async rewrites() {
     return [
+      {
+        source: '/docs.mdx',
+        destination: '/llms.mdx/docs',
+      },
       {
         source: '/docs/:path*.mdx',
         destination: '/llms.mdx/docs/:path*',