@terreno/mcp 0.27.0 → 0.29.0

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/generateBetterAuthSlice.md

@@ -1,87 +0,0 @@
-> **generateBetterAuthSlice**(`config`): `object`
-
-Generates a Better Auth Redux slice with session management.
-
-## Parameters
-
-### config
-
-[`GenerateBetterAuthSliceConfig`](../interfaces/GenerateBetterAuthSliceConfig.md)
-
-## Returns
-
-### actions
-
-> **actions**: `CaseReducerActions`\<\{ `clearSession`: (`state`) => `void`; `logout`: (`state`) => `void`; `setError`: (`state`, `action`) => `void`; `setLoading`: (`state`, `action`) => `void`; `setSession`: (`state`, `action`) => `void`; \}, `"betterAuth"`\> = `betterAuthSlice.actions`
-
-Actions for the Better Auth slice.
-
-### authClient
-
-> **authClient**: [`BetterAuthClientInterface`](../interfaces/BetterAuthClientInterface.md)
-
-The Better Auth client instance.
-
-### middleware
-
-> **middleware**: `ListenerMiddleware`\<`unknown`, `ThunkDispatch`\<`unknown`, `unknown`, `UnknownAction`\>, `unknown`\>[]
-
-Middleware for handling Better Auth side effects.
-
-### reducer
-
-> **reducer**: `Reducer`\<[`BetterAuthState`](../interfaces/BetterAuthState.md)\> = `betterAuthSlice.reducer`
-
-The reducer for the Better Auth slice.
-
-### slice
-
-> **slice**: `Slice`\<[`BetterAuthState`](../interfaces/BetterAuthState.md), \{ `clearSession`: (`state`) => `void`; `logout`: (`state`) => `void`; `setError`: (`state`, `action`) => `void`; `setLoading`: (`state`, `action`) => `void`; `setSession`: (`state`, `action`) => `void`; \}, `"betterAuth"`, `"betterAuth"`, `SliceSelectors`\<[`BetterAuthState`](../interfaces/BetterAuthState.md)\>\> = `betterAuthSlice`
-
-The Better Auth Redux slice.
-
-### syncSession
-
-> **syncSession**: (`dispatch`) => `Promise`\<`void`\>
-
-Function to sync session state from Better Auth to Redux.
-
-Syncs the session state from Better Auth to Redux.
-Call this on app startup and periodically to keep state in sync.
-
-#### Parameters
-
-##### dispatch
-
-`any`
-
-#### Returns
-
-`Promise`\<`void`\>
-
-## Example
-
-```typescript
-const authClient = createBetterAuthClient({
-  baseURL: "http://localhost:3000",
-  scheme: "terreno",
-});
-
-const betterAuthSlice = generateBetterAuthSlice({ authClient });
-
-// Add to your store
-const store = configureStore({
-  reducer: {
-    betterAuth: betterAuthSlice.reducer,
-  },
-  middleware: (getDefaultMiddleware) =>
-    getDefaultMiddleware().concat(betterAuthSlice.middleware),
-});
-
-// Use in components
-const isAuthenticated = useSelector(selectBetterAuthIsAuthenticated);
-const user = useSelector(selectBetterAuthUser);
-
-// Trigger logout
-dispatch(betterAuthSlice.actions.logout());
-```

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectBetterAuthError.md

@@ -1,13 +0,0 @@
-> **selectBetterAuthError**(`state`): `string` \| `null`
-
-Selects the last error message.
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-`string` \| `null`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectBetterAuthIsAuthenticated.md

@@ -1,13 +0,0 @@
-> **selectBetterAuthIsAuthenticated**(`state`): `boolean`
-
-Selects whether the user is authenticated.
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-`boolean`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectBetterAuthIsLoading.md

@@ -1,13 +0,0 @@
-> **selectBetterAuthIsLoading**(`state`): `boolean`
-
-Selects whether the auth state is loading.
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-`boolean`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectBetterAuthState.md

@@ -1,13 +0,0 @@
-> **selectBetterAuthState**(`state`): [`BetterAuthState`](../interfaces/BetterAuthState.md) \| `undefined`
-
-Selects the entire Better Auth state.
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-[`BetterAuthState`](../interfaces/BetterAuthState.md) \| `undefined`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectBetterAuthUser.md

@@ -1,13 +0,0 @@
-> **selectBetterAuthUser**(`state`): [`BetterAuthUser`](../interfaces/BetterAuthUser.md) \| `null`
-
-Selects the current user data.
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-[`BetterAuthUser`](../interfaces/BetterAuthUser.md) \| `null`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectBetterAuthUserId.md

@@ -1,13 +0,0 @@
-> **selectBetterAuthUserId**(`state`): `string` \| `null`
-
-Selects the current user ID.
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-`string` \| `null`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectCurrentUserId.md

@@ -1,11 +0,0 @@
-> **selectCurrentUserId**(`state`): `string` \| `undefined`
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-`string` \| `undefined`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectIsAuthenticating.md

@@ -1,11 +0,0 @@
-> **selectIsAuthenticating**(`state`): `boolean`
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-`boolean`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/selectLastTokenRefreshTimestamp.md

@@ -1,11 +0,0 @@
-> **selectLastTokenRefreshTimestamp**(`state`): `number` \| `null`
-
-## Parameters
-
-### state
-
-`any`
-
-## Returns
-
-`number` \| `null`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/functions/shouldDeferOfflineMutation.md

@@ -1,18 +0,0 @@
-> **shouldDeferOfflineMutation**(`endpointName`, `getState`): `boolean`
-
-When true, the base query should return a network error without making a request.
-The offline middleware will queue the mutation and apply an optimistic update.
-
-## Parameters
-
-### endpointName
-
-`string`
-
-### getState
-
-() => `any`
-
-## Returns
-
-`boolean`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/type-aliases/RootState.md

@@ -1 +0,0 @@
-> **RootState** = `any`

package/dist/docs/versioned/0.24.0/reference/ui.md

@@ -1,418 +0,0 @@
-# @terreno/ui
-
-React Native UI component library (88+ components). Layout (Box, Page, Card), forms (TextField, SelectField), display (Text, DataTable), actions (Button), feedback (Modal, Toast), and theming via TerrenoProvider.
-
-## Key exports
-
-- Layout: `Box`, `Page`, `SplitPage`, `Card`
-- Forms: `TextField`, `SelectField`, `DateTimeField`, `CheckBox`
-- Display: `Text`, `Heading`, `Badge`, `DataTable`
-- Actions: `Button`, `IconButton`, `Link`
-- Feedback: `Spinner`, `Modal`, `Toast`
-- Authentication: `SocialLoginButton`, `LoginScreen`, `SignUpScreen`
-- Theming: `TerrenoProvider`, `useTheme`
-- **Type re-exports:** `StyleProp`, `ViewStyle` (re-exported from react-native to avoid version conflicts)
-
-## Type Re-exports
-
-@terreno/ui re-exports commonly-used React Native types to help consumers avoid version conflicts:
-
-``````typescript
-import {StyleProp, ViewStyle} from "@terreno/ui";
-
-// Use these instead of importing from react-native directly
-const customStyle: StyleProp<ViewStyle> = {
-  flex: 1,
-  backgroundColor: "#fff",
-};
-``````
-
-**Benefits:**
-- Avoids version mismatches between your app's react-native and @terreno/ui's react-native
-- Ensures type compatibility when passing styles to @terreno/ui components
-- Simplifies imports (one package instead of two)
-
-## Component Behaviors
-
-### Button Layout Behavior
-
-Buttons automatically size to their content unless `fullWidth` is specified:
-
-``````typescript
-// Button takes only the space it needs
-<Box direction="column">
-  <Button text="Save" onClick={handleSave} />  {/* Auto-sized */}
-</Box>
-
-// Button stretches to full width
-<Box direction="column">
-  <Button text="Save" onClick={handleSave} fullWidth />  {/* Full width */}
-</Box>
-``````
-
-Internally, Button sets `alignSelf: 'flex-start'` when `fullWidth={false}` to prevent stretching in column layouts.
-
-## Authentication Components
-
-### SocialLoginButton
-
-Branded social login buttons for OAuth authentication with Google, GitHub, and Apple.
-
-``````typescript
-import {SocialLoginButton} from "@terreno/ui";
-import {authClient} from "@/store/authClient";
-
-<SocialLoginButton
-  provider="google"  // "google" | "github" | "apple"
-  variant="primary"  // "primary" | "outline"
-  onPress={async () => {
-    await authClient.signIn.social({
-      provider: "google",
-      callbackURL: "yourapp://auth/callback",
-    });
-  }}
-  loading={isLoading}
-  fullWidth
-/>
-``````
-
-**Features:**
-- Proper brand colors for each provider (follows brand guidelines)
-- Built-in icons (FontAwesome 6)
-- Primary and outline variants
-- Loading states with spinner
-- Automatic text: "Continue with {Provider}"
-
-### LoginScreen
-
-Complete login screen with email/password and optional social providers.
-
-``````typescript
-import {LoginScreen} from "@terreno/ui";
-import {authClient} from "@/store/authClient";
-
-<LoginScreen
-  onEmailLogin={async ({email, password}) => {
-    await authClient.signIn.email({email, password});
-  }}
-  onSocialLogin={async (provider) => {
-    await authClient.signIn.social({provider, callbackURL: "yourapp://auth"});
-  }}
-  socialProviders={["google", "github", "apple"]}
-  onForgotPassword={() => navigation.navigate("ForgotPassword")}
-  onSignUp={() => navigation.navigate("SignUp")}
-/>
-``````
-
-### SignUpScreen
-
-Complete signup screen with email/password and optional social providers.
-
-``````typescript
-import {SignUpScreen} from "@terreno/ui";
-import {authClient} from "@/store/authClient";
-
-<SignUpScreen
-  onEmailSignUp={async ({email, password, name}) => {
-    await authClient.signUp.email({email, password, name});
-  }}
-  onSocialLogin={async (provider) => {
-    await authClient.signIn.social({provider, callbackURL: "yourapp://auth"});
-  }}
-  socialProviders={["google", "github"]}
-  onSignIn={() => navigation.navigate("Login")}
-  requireName
-  requireTermsAcceptance
-/>
-``````
-
-**Learn more:** [Configure Better Auth](../how-to/configure-better-auth.md)
-
-## Testing Utilities
-
-@terreno/ui provides test helpers for writing component tests with @testing-library/react-native.
-
-### renderWithTheme
-
-Wraps components in ThemeProvider for testing.
-
-``````typescript
-import {renderWithTheme} from "@terreno/ui";
-import {describe, it, expect} from "bun:test";
-
-describe("MyComponent", () => {
-  it("renders correctly", () => {
-    const {getByTestId} = renderWithTheme(<MyComponent testID="my-comp" />);
-    expect(getByTestID("my-comp")).toBeTruthy();
-  });
-});
-``````
-
-**Why:** Most @terreno/ui components require ThemeProvider context to access theme values.
-
-### createCommonMocks
-
-Creates mock functions for common component callbacks.
-
-``````typescript
-import {createCommonMocks} from "@terreno/ui";
-
-const mocks = createCommonMocks();
-// Returns: {onBlur, onChange, onEnter, onFocus, onIconClick, onSubmitEditing}
-
-<TextField
-  value="test"
-  onChange={mocks.onChange}
-  onBlur={mocks.onBlur}
-  onFocus={mocks.onFocus}
-/>
-
-// Assert mock was called
-expect(mocks.onChange).toHaveBeenCalledWith("new value");
-``````
-
-### setupComponentTest / teardownComponentTest
-
-Lifecycle helpers for test setup and cleanup.
-
-``````typescript
-import {setupComponentTest, teardownComponentTest} from "@terreno/ui";
-
-describe("MyForm", () => {
-  let mocks;
-
-  beforeEach(() => {
-    mocks = setupComponentTest(); // Returns createCommonMocks()
-  });
-
-  afterEach(() => {
-    teardownComponentTest(); // No-op in Bun (auto-cleanup)
-  });
-
-  it("submits form", () => {
-    // Test with mocks
-  });
-});
-``````
-
-## Date Utilities
-
-Luxon-based helpers for date comparison and formatting.
-
-``````typescript
-import {
-  isToday,
-  isTomorrow,
-  isYesterday,
-  isThisYear,
-  isWithinWeek,
-  getIsoDate,
-} from "@terreno/ui";
-
-const date = DateTime.now();
-
-if (isToday(date)) console.log("Today!");
-if (isTomorrow(date)) console.log("Tomorrow!");
-if (isYesterday(date)) console.log("Yesterday!");
-if (isThisYear(date)) console.log("This year!");
-if (isWithinWeek(date)) console.log("Within 7 days!");
-
-// Convert to ISO date string
-const isoString = getIsoDate(date); // "2026-02-15"
-``````
-
-### Timezone Utilities
-
-``````typescript
-import {getTimezoneOptions} from "@terreno/ui";
-
-// Get USA timezones only
-const usaTimezones = getTimezoneOptions("usa");
-// Returns: [{label: "Pacific Time", value: "America/Los_Angeles"}, ...]
-
-// Get worldwide timezones
-const allTimezones = getTimezoneOptions("worldwide");
-// Returns: [{label: "UTC", value: "UTC"}, {label: "New York", value: "America/New_York"}, ...]
-``````
-
-**Use case:** Populate SelectField with timezone choices.
-
-## Address Utilities
-
-Google Places API integration helpers for address handling.
-
-### formatAddress
-
-``````typescript
-import {formatAddress} from "@terreno/ui";
-
-const address = {
-  street: "123 Main St",
-  city: "San Francisco",
-  state: "CA",
-  zipCode: "94102",
-};
-
-const formatted = formatAddress(address);
-// "123 Main St, San Francisco, CA 94102"
-``````
-
-### processAddressComponents
-
-Parses Google Places API address_components into structured data.
-
-``````typescript
-import {processAddressComponents} from "@terreno/ui";
-
-// From Google Places API response
-const components = place.address_components;
-
-const parsed = processAddressComponents(components);
-// Returns: {street, city, state, zipCode, country, county}
-``````
-
-### findAddressComponent
-
-``````typescript
-import {findAddressComponent} from "@terreno/ui";
-
-const city = findAddressComponent(components, "locality");
-const state = findAddressComponent(components, "administrative_area_level_1", "short_name");
-``````
-
-### Validation
-
-``````typescript
-import {isValidGoogleApiKey, formattedCountyCode} from "@terreno/ui";
-
-if (!isValidGoogleApiKey(apiKey)) {
-  console.error("Invalid Google API key");
-}
-
-// Format US county codes
-const county = formattedCountyCode("6075"); // "6075" (Santa Cruz County, CA)
-``````
-
-## Media Query Helpers
-
-Responsive design utilities for breakpoints and device detection.
-
-``````typescript
-import {
-  mediaQuery,
-  mediaQueryLargerThan,
-  mediaQuerySmallerThan,
-  isMobileDevice,
-} from "@terreno/ui";
-
-// Check if matches breakpoint
-if (mediaQuery("md")) {
-  console.log("Medium or larger");
-}
-
-// Greater than breakpoint
-if (mediaQueryLargerThan("sm")) {
-  console.log("Larger than small");
-}
-
-// Smaller than breakpoint
-if (mediaQuerySmallerThan("lg")) {
-  console.log("Smaller than large");
-}
-
-// Detect mobile
-if (isMobileDevice()) {
-  console.log("Running on mobile device");
-}
-``````
-
-**Breakpoints:**
-- `sm`: 640px
-- `md`: 768px
-- `lg`: 1024px
-- `xl`: 1280px
-
-## Icons
-
-### FontAwesome Icons
-
-All 2000+ FontAwesome 6 icons available via the `Icon` component:
-
-``````typescript
-import {Icon} from "@terreno/ui";
-
-<Icon name="check" size={24} color="primary" />
-<Icon name="user" size={32} color="secondary" />
-<Icon name="chevron-right" size={16} color="neutral700" />
-``````
-
-### Custom SVG Icons
-
-@terreno/ui includes custom status icons:
-
-``````typescript
-import {MobileIcon, OnlineIcon, OfflineIcon, OutOfOfficeIcon} from "@terreno/ui";
-
-<MobileIcon width={20} height={20} fill="#007AFF" />
-<OnlineIcon width={16} height={16} />
-<OfflineIcon width={16} height={16} />
-<OutOfOfficeIcon width={16} height={16} />
-``````
-
-**Use case:** User status indicators, device type badges.
-
-## Style Utilities
-
-### Unifier Class
-
-Color manipulation helper:
-
-``````typescript
-import {Unifier} from "@terreno/ui";
-
-// Darken/lighten colors
-const darkColor = Unifier.changeColorLuminance("#007AFF", -0.2); // Darker
-const lightColor = Unifier.changeColorLuminance("#007AFF", 0.2); // Lighter
-``````
-
-### Style Helpers
-
-``````typescript
-import {identity, concat, fromClassName, toggle, binding, union} from "@terreno/ui";
-
-// Compose style objects
-const styles = concat(baseStyles, conditionalStyles);
-
-// Toggle styles
-const buttonStyles = toggle(isPressed, pressedStyles, defaultStyles);
-``````
-
-**Note:** Most use cases are better served by Box props (`padding`, `color`, etc.).
-
-## Environment Variables
-
-@terreno/ui components do not require environment variables. All configuration is done at runtime via:
-
-- **TerrenoProvider props** — Theme customization, error handlers, base URL
-- **Theme hooks** — `useTheme()`, `setTheme()`, `setPrimitives()`
-- **Component props** — Direct prop overrides for individual components
-
-**Example configuration:**
-
-``````typescript
-import {TerrenoProvider} from "@terreno/ui";
-
-<TerrenoProvider
-  baseUrl="https://api.example.com"
-  theme={{
-    surface: {primary: "secondary500"},
-  }}
-  onError={(error) => console.error(error)}
->
-  {children}
-</TerrenoProvider>
-``````
-
-## Related Documentation
-
-See the [ui package source](../../ui/src/) and [.cursor/rules/ui/](../../.cursor/rules/ui/) for props and conventions.

package/src/docs/versioned/0.23.0/explanation/README.md

@@ -1,13 +0,0 @@
-# Explanation
-
-Understanding-oriented documentation: concepts, architecture, and context.
-
-## Contents
-
-- [AI-powered workflows](ai-workflows.md) — Autonomous documentation, testing, and maintenance workflows
-- [Authentication architecture](authentication.md) — How JWT, OAuth, and token refresh work
-- [Configuration system](configuration-system.md) — Runtime configuration with database persistence
-- [Dependency management](dependency-management.md) — Dependabot, auto-merge, and security practices
-- [GCP hosting architecture](gcp-hosting-architecture.md) — Static site hosting with GCS and Cloud CDN
-- [Modular API design](modular-api-design.md) — 🚧 Why TerrenoApp replaces setupServer
-- [modelRouter actions](model-router-actions.md) — Named collection and instance operations on modelRouter

package/src/docs/versioned/0.23.0/how-to/README.md

@@ -1,20 +0,0 @@
-# How-to Guides
-
-Problem-oriented, practical steps. Use these when you know what you want to do.
-
-## Contents
-
-- [Create a Mongoose model](create-a-model.md) — Define models with proper conventions
-- [Add GitHub OAuth authentication](add-github-oauth.md) — Enable GitHub login for your API
-- [Configure Better Auth](configure-better-auth.md) — Set up Better Auth with social OAuth (Google, GitHub, Apple)
-- [Add WebSocket integration](websocket-integration.md) — Set up real-time Socket.io connections
-- [Deploy to Google Cloud Platform](deploy-to-gcp.md) — Deploy demo and example apps to GCS with CDN
-
-## Coming Soon
-
-- [Add feature flags](add-feature-flags.md) — Add feature flags and A/B testing to your app
-- Add custom permissions
-- Implement file uploads
-- Configure email notifications
-- Customize AI workflows
-- Set up custom CI/CD pipelines