@terreno/mcp 57.21.0 → 58.0.0-beta.1

package/dist/docs/resources/rtk.md

@@ -1,181 +0,0 @@
-# @terreno/rtk Documentation (legacy)
-
-> **Deprecated for data synchronization** as of `56.0.0`. Use `@terreno/syncdb` for collection CRUD. This resource documents RTK for OpenAPI SDK codegen, Better Auth session Redux, feature flags, and sockets during the support window. See [migrate-rtk-to-syncdb.md](https://github.com/TerrenoLabs/terreno/blob/master/docs/how-to/migrate-rtk-to-syncdb.md).
-
-Redux Toolkit Query utilities for frontends connecting to @terreno/api backends.
-
-## Key Exports
-
-- `emptyApi` - Base RTK Query API configured with axios
-- `authSlice` - Redux slice for auth state
-- `generateProfileEndpoints` - Auth endpoint builder
-- Token utilities: `getTokenExpirationTimes()`, `getFriendlyExpirationInfo()`, `getAuthToken()`
-
-## Setup
-
-### Store Configuration
-
-```typescript
-import { configureStore } from "@reduxjs/toolkit";
-import { emptyApi, authSlice } from "@terreno/rtk";
-import { openApiSdk } from "./openApiSdk";
-
-export const store = configureStore({
-  reducer: {
-    [openApiSdk.reducerPath]: openApiSdk.reducer,
-    auth: authSlice.reducer,
-  },
-  middleware: (getDefaultMiddleware) =>
-    getDefaultMiddleware().concat(openApiSdk.middleware),
-});
-```
-
-### SDK Generation
-
-The SDK is auto-generated from your backend's OpenAPI spec:
-
-```typescript
-// openApiSdk.ts - AUTO-GENERATED, DO NOT EDIT
-import { emptyApi } from "@terreno/rtk";
-
-export const openApiSdk = emptyApi.injectEndpoints({
-  endpoints: (build) => ({
-    getUsers: build.query<User[], GetUsersParams>({
-      query: (params) => ({ url: "/users", params }),
-    }),
-    createUser: build.mutation<User, CreateUserBody>({
-      query: (body) => ({ url: "/users", method: "POST", body }),
-    }),
-  }),
-});
-
-export const { useGetUsersQuery, useCreateUserMutation } = openApiSdk;
-```
-
-## Using the SDK
-
-```typescript
-import { useGetUsersQuery, useCreateUserMutation } from "@/store/openApiSdk";
-
-const UserList = () => {
-  const { data: users, isLoading, error } = useGetUsersQuery({ limit: 10 });
-  const [createUser, { isLoading: isCreating }] = useCreateUserMutation();
-
-  const handleCreate = async () => {
-    try {
-      const newUser = await createUser({ name: "John", email: "john@example.com" }).unwrap();
-      console.info("Created user:", newUser);
-    } catch (err) {
-      console.error("Failed to create user:", err);
-    }
-  };
-
-  if (isLoading) return <Text>Loading...</Text>;
-  if (error) return <Text>Error loading users</Text>;
-
-  return (
-    <Box>
-      {users?.map((user) => (
-        <Text key={user.id}>{user.name}</Text>
-      ))}
-      <Button text="Add User" onClick={handleCreate} loading={isCreating} />
-    </Box>
-  );
-};
-```
-
-## Authentication
-
-### Login
-
-```typescript
-import { useEmailLoginMutation } from "@/store/openApiSdk";
-import { useAppDispatch } from "@/store/index";
-import { authSlice } from "@terreno/rtk";
-
-const LoginScreen = () => {
-  const [email, setEmail] = useState("");
-  const [password, setPassword] = useState("");
-  const [emailLogin, { isLoading, error }] = useEmailLoginMutation();
-  const dispatch = useAppDispatch();
-
-  const handleLogin = async () => {
-    try {
-      const result = await emailLogin({ email, password }).unwrap();
-      // Auth state is automatically updated
-    } catch (err) {
-      console.error("Login failed:", err);
-    }
-  };
-
-  return (
-    <Box padding={4} gap={3}>
-      <EmailField label="Email" value={email} onChangeText={setEmail} />
-      <PasswordField label="Password" value={password} onChangeText={setPassword} />
-      <Button text="Login" onClick={handleLogin} loading={isLoading} />
-    </Box>
-  );
-};
-```
-
-### Auth State
-
-```typescript
-import { useAppSelector } from "@/store/appState";
-
-const Component = () => {
-  const userId = useAppSelector((state) => state.auth.userId);
-  const isAuthenticated = !!userId;
-
-  // ...
-};
-```
-
-### Logout
-
-```typescript
-import { LOGOUT_ACTION_TYPE } from "@terreno/rtk";
-
-const handleLogout = () => {
-  dispatch({ type: LOGOUT_ACTION_TYPE });
-};
-```
-
-## Token Management
-
-Tokens are automatically managed:
-- Stored in `expo-secure-store` (mobile) or AsyncStorage (web)
-- Auto-refresh with exponential backoff
-- Mutex-protected to prevent race conditions
-
-```typescript
-import { getAuthToken, getTokenExpirationTimes } from "@terreno/rtk";
-
-// Get current token
-const token = await getAuthToken();
-
-// Check expiration
-const { accessTokenExpiry, refreshTokenExpiry } = getTokenExpirationTimes(token);
-```
-
-## Platform Detection
-
-```typescript
-import { IsWeb, IsNative } from "@terreno/rtk";
-
-if (IsWeb) {
-  // Web-specific code
-}
-
-if (IsNative) {
-  // Mobile-specific code
-}
-```
-
-## Best Practices
-
-1. **Never use axios directly** - Always use generated SDK hooks
-2. **Don't modify generated SDK** - It's auto-generated from OpenAPI spec
-3. **Use .unwrap()** for mutations to get the result or throw error
-4. **Handle loading and error states** in your UI
-5. **Use TypeScript** - The SDK provides full type safety

package/dist/docs/templates/bootstrap/frontend/openapi-config.template.md

@@ -1,16 +0,0 @@
-import type {ConfigFile} from "@rtk-query/codegen-openapi";
-
-const config: ConfigFile = {
-  apiFile: "@terreno/rtk",
-  apiImport: "emptySplitApi",
-  argSuffix: "Args",
-  exportName: "openapi",
-  flattenArg: true,
-  hooks: true,
-  outputFile: "./store/openApiSdk.ts",
-  responseSuffix: "Res",
-  schemaFile: process.env.OPENAPI_URL ?? "http://localhost:4000/openapi.json",
-  tag: true,
-};
-
-export default config;

package/dist/docs/templates/bootstrap/frontend/scripts/generate-sdk.template.md

@@ -1,49 +0,0 @@
-#!/usr/bin/env bun
-
-import {exec} from "node:child_process";
-import {existsSync, readFileSync, writeFileSync} from "node:fs";
-import {join} from "node:path";
-
-const cliPath = join(
-  __dirname,
-  "..",
-  "node_modules",
-  "@rtk-query",
-  "codegen-openapi",
-  "lib",
-  "bin",
-  "cli.mjs"
-);
-const configPath = join(__dirname, "..", "openapi-config.ts");
-const tsConfigPath = join(__dirname, "..", "tsconfig.codegen.json");
-
-const command = `TS_NODE_PROJECT=${tsConfigPath} tsx ${cliPath} ${configPath}`;
-
-exec(command, (error, _stdout, stderr) => {
-  if (error) {
-    console.error(`Error: ${error.message}`);
-    process.exit(1);
-  }
-  if (stderr) {
-    console.error(`stderr: ${stderr}`);
-  }
-
-  const sdkPath = join(__dirname, "..", "store", "openApiSdk.ts");
-
-  if (existsSync(sdkPath)) {
-    let content = readFileSync(sdkPath, "utf8");
-    content = content.replace(/^export const \{\} = injectedRtkApi;\n?/m, "");
-    writeFileSync(sdkPath, content, "utf8");
-  }
-
-  exec(
-    "bunx biome check --unsafe --write store/openApiSdk.ts",
-    {cwd: join(__dirname, "..")},
-    (formatError) => {
-      if (formatError) {
-        console.error(`Formatting error: ${formatError.message}`);
-        process.exit(1);
-      }
-    }
-  );
-});

package/dist/docs/templates/bootstrap/frontend/store/appState.template.md

@@ -1,45 +0,0 @@
-import {createSlice, type PayloadAction} from "@reduxjs/toolkit";
-import type {RootState} from "@terreno/rtk";
-import {type TypedUseSelectorHook, useSelector} from "react-redux";
-
-export const useAppSelector: TypedUseSelectorHook<RootState> = useSelector;
-
-export type AppState = {
-  darkMode: boolean;
-  language: string;
-};
-
-const initialState: AppState = {
-  darkMode: false,
-  language: "en",
-};
-
-export const appStateSlice = createSlice({
-  initialState,
-  name: "appState",
-  reducers: {
-    resetAppState: () => initialState,
-    setDarkMode: (state, action: PayloadAction<boolean>) => {
-      state.darkMode = action.payload;
-    },
-    setLanguage: (state, action: PayloadAction<string>) => {
-      state.language = action.payload;
-    },
-  },
-});
-
-export const {setDarkMode, setLanguage, resetAppState} = appStateSlice.actions;
-
-export const useSelectDarkMode = (): boolean => {
-  return useAppSelector((state: RootState): boolean => {
-    return state.appState.darkMode;
-  });
-};
-
-export const useSelectLanguage = (): string => {
-  return useAppSelector((state: RootState): string => {
-    return state.appState.language;
-  });
-};
-
-export default appStateSlice.reducer;

package/dist/docs/templates/bootstrap/frontend/store/errors.template.md

@@ -1,51 +0,0 @@
-import type {Middleware} from "@reduxjs/toolkit";
-import {useToast} from "@terreno/ui";
-
-const ignoredErrors = [
-  "Password or username is incorrect",
-  "Token refresh failed with 401",
-  "Failed to refresh token",
-];
-
-// biome-ignore lint/suspicious/noExplicitAny: Generic middleware
-export const rtkQueryErrorMiddleware: Middleware = () => (next) => (action: any) => {
-  if (action?.error && action?.payload) {
-    const errorMessage =
-      action.payload?.data?.title ??
-      action.payload?.data?.message ??
-      action.payload?.error ??
-      JSON.stringify(action.payload);
-
-    let endpointInfo = "unknown endpoint";
-    if (action.meta?.baseQueryMeta?.request?.method && action.meta?.baseQueryMeta?.request?.url) {
-      endpointInfo = `${action.meta.baseQueryMeta.request.url} ${action.meta.baseQueryMeta.request.method}`;
-    } else if (action.meta?.arg?.endpointName) {
-      endpointInfo = `${action.meta.arg.endpointName} rejected ${action.meta.arg.type || ""}`;
-    }
-
-    const message = `${endpointInfo.trim()}: ${errorMessage}`;
-    console.debug(message);
-
-    if (action.payload.status === 404 || action.payload.status === 401) {
-      return next(action);
-    }
-
-    const shouldIgnore = ignoredErrors.some((err) => errorMessage.includes(err));
-    if (!shouldIgnore) {
-      console.warn(message);
-    }
-  }
-
-  return next(action);
-};
-
-export const useSentryAndToast = (): ((errorMessage: string) => void) => {
-  const toast = useToast();
-  return (error: string): void => {
-    if (!error) {
-      return;
-    }
-    toast.error(error);
-    console.warn(`Error: ${error}`);
-  };
-};

package/dist/docs/templates/bootstrap/frontend/store/index.template.md

@@ -1,86 +0,0 @@
-import AsyncStorage from "@react-native-async-storage/async-storage";
-import {combineReducers, configureStore} from "@reduxjs/toolkit";
-import {generateAuthSlice} from "@terreno/rtk";
-import {DateTime} from "luxon";
-import {useDispatch} from "react-redux";
-import type {Storage} from "redux-persist";
-import {persistReducer, persistStore} from "redux-persist";
-
-import appState from "./appState";
-import {rtkQueryErrorMiddleware} from "./errors";
-import {terrenoApi} from "./sdk";
-
-const authSlice = generateAuthSlice(terrenoApi);
-
-export const {logout} = authSlice;
-
-const createSafeStorage = (): Storage => {
-  return {
-    getItem: async (key: string): Promise<string | null> => {
-      if (typeof window !== "undefined") {
-        return AsyncStorage.getItem(key);
-      }
-      return null;
-    },
-    removeItem: async (key: string): Promise<void> => {
-      if (typeof window !== "undefined") {
-        return AsyncStorage.removeItem(key);
-      }
-    },
-    setItem: async (key: string, value: string): Promise<void> => {
-      if (typeof window !== "undefined") {
-        return AsyncStorage.setItem(key, value);
-      }
-    },
-  };
-};
-
-const persistConfig = {
-  blacklist: ["terreno-rtk"],
-  key: "root",
-  storage: createSafeStorage(),
-  timeout: 0,
-  version: 1,
-};
-
-const rootReducer = combineReducers({
-  appState,
-  auth: authSlice.authReducer,
-  "terreno-rtk": terrenoApi.reducer,
-});
-
-const persistedReducer = persistReducer(persistConfig, rootReducer);
-
-const store = configureStore({
-  devTools: process.env.NODE_ENV !== "production" && {
-    name: `App-${
-      typeof window !== "undefined"
-        // biome-ignore lint/suspicious/noAssignInExpressions: Window name assignment
-        ? window.name || ((window.name = `Window-${DateTime.now().toFormat("HH:mm:ss")}`))
-        : "Unknown"
-    }`,
-  },
-  middleware: (getDefaultMiddleware) => {
-    return getDefaultMiddleware({
-      immutableCheck: false,
-      serializableCheck: false,
-      thunk: true,
-    }).concat([
-      ...authSlice.middleware,
-      // biome-ignore lint/suspicious/noExplicitAny: RTK Query middleware typing
-      terrenoApi.middleware as any,
-      rtkQueryErrorMiddleware,
-      // biome-ignore lint/suspicious/noExplicitAny: Middleware array typing
-    ]) as any;
-  },
-  reducer: persistedReducer,
-});
-
-export const persistor = persistStore(store);
-
-export type RootState = ReturnType<typeof store.getState>;
-export type AppDispatch = typeof store.dispatch;
-
-export const useAppDispatch: () => AppDispatch = useDispatch;
-
-export default store;

package/dist/docs/templates/bootstrap/frontend/store/openApiSdk.template.md

@@ -1,49 +0,0 @@
-// THIS FILE IS AUTO-GENERATED. DO NOT EDIT.
-// Run "bun run sdk" to regenerate this file from the backend OpenAPI spec.
-
-import {emptySplitApi as api} from "@terreno/rtk";
-export const addTagTypes = ["Users", "Auth"] as const;
-const injectedRtkApi = api
-  .enhanceEndpoints({
-    addTagTypes,
-  })
-  .injectEndpoints({
-    endpoints: (build) => ({
-      emailLogin: build.mutation<EmailLoginRes, EmailLoginArgs>({
-        query: (queryArg) => ({
-          body: queryArg,
-          method: "POST",
-          url: `/auth/login`,
-        }),
-      }),
-      emailSignUp: build.mutation<EmailSignUpRes, EmailSignUpArgs>({
-        query: (queryArg) => ({
-          body: queryArg,
-          method: "POST",
-          url: `/auth/signup`,
-        }),
-      }),
-    }),
-    overrideExisting: false,
-  });
-export {injectedRtkApi as openapi};
-export type EmailLoginArgs = {
-  email: string;
-  password: string;
-};
-export type EmailLoginRes = {
-  token: string;
-  refreshToken: string;
-  userId: string;
-};
-export type EmailSignUpArgs = {
-  email: string;
-  password: string;
-  name: string;
-};
-export type EmailSignUpRes = {
-  token: string;
-  refreshToken: string;
-  userId: string;
-};
-export const {useEmailLoginMutation, useEmailSignUpMutation} = injectedRtkApi;

package/dist/docs/templates/bootstrap/frontend/store/sdk.template.md

@@ -1,80 +0,0 @@
-import {generateTags} from "@terreno/rtk";
-import startCase from "lodash/startCase";
-
-import {addTagTypes, openapi} from "./openApiSdk";
-
-export interface ProfileResponse {
-  data: {
-    _id: string;
-    id: string;
-    email: string;
-    name: string;
-  };
-}
-
-export interface UpdateProfileRequest {
-  name?: string;
-  email?: string;
-  /** Required by the server when `email` changes the mailbox. */
-  currentPassword?: string;
-  password?: string;
-}
-
-export const terrenoApi = openapi
-  .injectEndpoints({
-    endpoints: (builder) => ({
-      getMe: builder.query<ProfileResponse, void>({
-        providesTags: ["profile"],
-        query: () => ({
-          method: "GET",
-          url: "/auth/me",
-        }),
-      }),
-      patchMe: builder.mutation<ProfileResponse, UpdateProfileRequest>({
-        invalidatesTags: ["profile"],
-        query: (body) => ({
-          body,
-          method: "PATCH",
-          url: "/auth/me",
-        }),
-      }),
-    }),
-  })
-  .enhanceEndpoints({
-    addTagTypes: ["profile"],
-    endpoints: {
-      ...generateTags(openapi, [...addTagTypes]),
-    },
-  });
-
-export const {
-  useEmailLoginMutation,
-  useEmailSignUpMutation,
-  useGetMeQuery,
-  usePatchMeMutation,
-} = terrenoApi;
-export * from "./openApiSdk";
-
-type OpenApiEndpoints = Record<string, unknown>;
-
-export const getSdkHook = (
-  modelName: string,
-  type: "list" | "read" | "create" | "update" | "remove"
-): Record<string, unknown> => {
-  const modelPath = startCase(modelName).replace(/\s/g, "");
-  const endpoints = openapi.endpoints as OpenApiEndpoints;
-  switch (type) {
-    case "list":
-      return endpoints[`get${modelPath}`] as Record<string, unknown>;
-    case "read":
-      return endpoints[`get${modelPath}ById`] as Record<string, unknown>;
-    case "create":
-      return endpoints[`post${modelPath}`] as Record<string, unknown>;
-    case "update":
-      return endpoints[`patch${modelPath}ById`] as Record<string, unknown>;
-    case "remove":
-      return endpoints[`delete${modelPath}ById`] as Record<string, unknown>;
-    default:
-      throw new Error(`Invalid SDK hook: ${modelName}/${type}`);
-  }
-};

package/src/docs/guidelines/rtk/guidelines/core.md

@@ -1,26 +0,0 @@
-### @terreno/rtk
-
-Redux Toolkit Query integration:
-
-- **generateAuthSlice**: Creates auth reducer and middleware with JWT handling
-- **emptyApi**: Base RTK Query API for code generation
-- **Platform utilities**: Secure token storage (expo-secure-store for native, AsyncStorage for web)
-
-Key imports:
-
-```typescript
-import {generateAuthSlice} from "@terreno/rtk";
-```
-
-Always use generated SDK hooks — never use `axios` or `request` directly:
-
-```typescript
-// Correct
-import {useGetYourRouteQuery} from "@/store/openApiSdk";
-const {data, isLoading, error} = useGetYourRouteQuery({id: "value"});
-
-// Wrong - don't use axios directly
-// const result = await axios.get("/api/yourRoute/value");
-```
-
-**No barrel imports** in app store code — import hooks from `@/store/sdk` or `@/store/openApiSdk`, not `@/store`. See `docs/explanation/no-barrel-imports.md`.