@terreno/mcp 0.24.0 → 0.25.0

package/dist/docs/versioned/0.24.0/reference/generated/api/variables/logger.md

@@ -0,0 +1,109 @@
+> `const` **logger**: `object`
+
+Global application logger. Each method writes through Winston (console/file transports) and, when
+`USE_SENTRY_LOGGING=true`, mirrors the line to Sentry with the active request context attached.
+
+Prefer [createScopedLogger](../functions/createScopedLogger.md) when a workflow spans multiple log lines that should share a
+prefix or labels.
+
+## Type Declaration
+
+### catch
+
+> **catch**: (`e`) => `void`
+
+#### Parameters
+
+##### e
+
+`unknown`
+
+#### Returns
+
+`void`
+
+### debug
+
+> **debug**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+### error
+
+> **error**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+### info
+
+> **info**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+### warn
+
+> **warn**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+## Example
+
+```typescript
+import {logger} from "@terreno/api";
+
+logger.info("Server started", {port: 4000});
+logger.warn("Slow query", {ms: 500});
+logger.error("Failed to process", {error});
+logger.debug("Request details", {body: req.body});
+
+// Convenient `.catch` handler for promises – logs and captures the exception.
+await chargeCard(id).catch(logger.catch);
+```

package/dist/docs/versioned/0.24.0/reference/generated/rtk/README.md

@@ -0,0 +1,128 @@
+## Interfaces
+
+- [BaseUrls](interfaces/BaseUrls.md)
+- [BetterAuthClientConfig](interfaces/BetterAuthClientConfig.md)
+- [BetterAuthClientInterface](interfaces/BetterAuthClientInterface.md)
+- [BetterAuthSession](interfaces/BetterAuthSession.md)
+- [BetterAuthSessionData](interfaces/BetterAuthSessionData.md)
+- [BetterAuthState](interfaces/BetterAuthState.md)
+- [BetterAuthUser](interfaces/BetterAuthUser.md)
+- [ConflictRecord](interfaces/ConflictRecord.md)
+- [EmailSignupRequest](interfaces/EmailSignupRequest.md)
+- [ExpoConstantsShape](interfaces/ExpoConstantsShape.md)
+- [GenerateBetterAuthSliceConfig](interfaces/GenerateBetterAuthSliceConfig.md)
+- [GoogleLoginRequest](interfaces/GoogleLoginRequest.md)
+- [ListResponse](interfaces/ListResponse.md)
+- [OfflineMiddlewareConfig](interfaces/OfflineMiddlewareConfig.md)
+- [OfflineState](interfaces/OfflineState.md)
+- [OfflineStatus](interfaces/OfflineStatus.md)
+- [QueuedMutation](interfaces/QueuedMutation.md)
+- [RealtimeEvent](interfaces/RealtimeEvent.md)
+- [ResetPasswordRequest](interfaces/ResetPasswordRequest.md)
+- [ServerStatusOptions](interfaces/ServerStatusOptions.md)
+- [SocketConnection](interfaces/SocketConnection.md)
+- [StorageAdapter](interfaces/StorageAdapter.md)
+- [TerrenoFlagDefinition](interfaces/TerrenoFlagDefinition.md)
+- [UseFeatureFlagsOptions](interfaces/UseFeatureFlagsOptions.md)
+- [UserResponse](interfaces/UserResponse.md)
+- [UseSocketConnectionOptions](interfaces/UseSocketConnectionOptions.md)
+- [UseTerrenoFeatureFlagsOptions](interfaces/UseTerrenoFeatureFlagsOptions.md)
+- [UseTerrenoFeatureFlagsResult](interfaces/UseTerrenoFeatureFlagsResult.md)
+- [VersionCheckResponse](interfaces/VersionCheckResponse.md)
+
+## Type Aliases
+
+- [BetterAuthClient](type-aliases/BetterAuthClient.md)
+- [BetterAuthOAuthProvider](type-aliases/BetterAuthOAuthProvider.md)
+- [BetterAuthSlice](type-aliases/BetterAuthSlice.md)
+- [EmailLoginRequest](type-aliases/EmailLoginRequest.md)
+- [RootState](type-aliases/RootState.md)
+- [ServerStatus](type-aliases/ServerStatus.md)
+- [TerrenoFlagConfiguration](type-aliases/TerrenoFlagConfiguration.md)
+
+## Variables
+
+- [addConflict](variables/addConflict.md)
+- [AUTH\_DEBUG](variables/AUTH_DEBUG.md)
+- [baseTasksUrl](variables/baseTasksUrl.md)
+- [baseUrl](variables/baseUrl.md)
+- [baseWebsocketsUrl](variables/baseWebsocketsUrl.md)
+- [clearConflicts](variables/clearConflicts.md)
+- [clearQueue](variables/clearQueue.md)
+- [DEFAULT\_DEV\_API\_PORT](variables/DEFAULT_DEV_API_PORT.md)
+- [dequeue](variables/dequeue.md)
+- [dismissConflict](variables/dismissConflict.md)
+- [emptySplitApi](variables/emptySplitApi.md)
+- [enqueue](variables/enqueue.md)
+- [IsWeb](variables/IsWeb.md)
+- [LOGOUT\_ACTION\_TYPE](variables/LOGOUT_ACTION_TYPE.md)
+- [offlineReducer](variables/offlineReducer.md)
+- [offlineSlice](variables/offlineSlice.md)
+- [SAME\_ORIGIN\_SENTINEL](variables/SAME_ORIGIN_SENTINEL.md)
+- [selectUndismissedConflicts](variables/selectUndismissedConflicts.md)
+- [setOnlineStatus](variables/setOnlineStatus.md)
+- [setSyncing](variables/setSyncing.md)
+- [staggeredBaseQuery](variables/staggeredBaseQuery.md)
+- [TOKEN\_REFRESHED\_SUCCESS](variables/TOKEN_REFRESHED_SUCCESS.md)
+- [useGetVersionCheckQuery](variables/useGetVersionCheckQuery.md)
+- [useLazyGetVersionCheckQuery](variables/useLazyGetVersionCheckQuery.md)
+
+## Functions
+
+- [buildOptimisticCreateItem](functions/buildOptimisticCreateItem.md)
+- [configureOfflineMutationEndpoints](functions/configureOfflineMutationEndpoints.md)
+- [createBetterAuthClient](functions/createBetterAuthClient.md)
+- [createOfflineMiddleware](functions/createOfflineMiddleware.md)
+- [createSessionApi](functions/createSessionApi.md)
+- [createStorageAdapter](functions/createStorageAdapter.md)
+- [generateAuthSlice](functions/generateAuthSlice.md)
+- [generateBetterAuthSlice](functions/generateBetterAuthSlice.md)
+- [generateProfileEndpoints](functions/generateProfileEndpoints.md)
+- [generateTags](functions/generateTags.md)
+- [getAuthToken](functions/getAuthToken.md)
+- [getBaseQuery](functions/getBaseQuery.md)
+- [getFriendlyExpirationInfo](functions/getFriendlyExpirationInfo.md)
+- [getRealtimeSocket](functions/getRealtimeSocket.md)
+- [getTokenExpirationTimes](functions/getTokenExpirationTimes.md)
+- [isNetworkFetchError](functions/isNetworkFetchError.md)
+- [isWebsocketsDebugEnabled](functions/isWebsocketsDebugEnabled.md)
+- [logAuth](functions/logAuth.md)
+- [logSocket](functions/logSocket.md)
+- [populateId](functions/populateId.md)
+- [realtimeDocument](functions/realtimeDocument.md)
+- [realtimeList](functions/realtimeList.md)
+- [refreshAuthToken](functions/refreshAuthToken.md)
+- [registerTerrenoDevStore](functions/registerTerrenoDevStore.md)
+- [resolveBaseUrls](functions/resolveBaseUrls.md)
+- [resolveDevApiPort](functions/resolveDevApiPort.md)
+- [resolveFeatureFlagsOptions](functions/resolveFeatureFlagsOptions.md)
+- [selectBetterAuthError](functions/selectBetterAuthError.md)
+- [selectBetterAuthIsAuthenticated](functions/selectBetterAuthIsAuthenticated.md)
+- [selectBetterAuthIsLoading](functions/selectBetterAuthIsLoading.md)
+- [selectBetterAuthState](functions/selectBetterAuthState.md)
+- [selectBetterAuthUser](functions/selectBetterAuthUser.md)
+- [selectBetterAuthUserId](functions/selectBetterAuthUserId.md)
+- [selectConflicts](functions/selectConflicts.md)
+- [selectCurrentUserId](functions/selectCurrentUserId.md)
+- [selectIsAuthenticating](functions/selectIsAuthenticating.md)
+- [selectIsOnline](functions/selectIsOnline.md)
+- [selectIsOnlineSafe](functions/selectIsOnlineSafe.md)
+- [selectIsSyncing](functions/selectIsSyncing.md)
+- [selectLastTokenRefreshTimestamp](functions/selectLastTokenRefreshTimestamp.md)
+- [selectOfflineQueue](functions/selectOfflineQueue.md)
+- [selectQueueLength](functions/selectQueueLength.md)
+- [setRealtimeDebug](functions/setRealtimeDebug.md)
+- [setRealtimeSocket](functions/setRealtimeSocket.md)
+- [shouldDeferOfflineMutation](functions/shouldDeferOfflineMutation.md)
+- [shouldReplayQueuedMutation](functions/shouldReplayQueuedMutation.md)
+- [shouldShowStillThereModal](functions/shouldShowStillThereModal.md)
+- [useFeatureFlags](functions/useFeatureFlags.md)
+- [useOfflineStatus](functions/useOfflineStatus.md)
+- [useRealtimeDebug](functions/useRealtimeDebug.md)
+- [useSelectCurrentUserId](functions/useSelectCurrentUserId.md)
+- [useSelectIsAuthenticating](functions/useSelectIsAuthenticating.md)
+- [useServerStatus](functions/useServerStatus.md)
+- [useSocketConnection](functions/useSocketConnection.md)
+- [useSyncConnection](functions/useSyncConnection.md)
+- [useTerrenoFeatureFlags](functions/useTerrenoFeatureFlags.md)
+- [useUpgradeCheck](functions/useUpgradeCheck.md)

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

@@ -0,0 +1,14 @@
+> **registerTerrenoDevStore**(`store`): `void`
+
+Exposes the Redux store on `globalThis.__TERRENO_STORE__` in development so
+`terreno-mcp-local` can run `get_rtk_state` against the real app state.
+
+## Parameters
+
+### store
+
+`Store`\<`Record`\<`string`, `unknown`\>\>
+
+## Returns
+
+`void`

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

@@ -0,0 +1,32 @@
+> **resolveBaseUrls**(`args`): [`BaseUrls`](../interfaces/BaseUrls.md)
+
+Pure resolver for the base URLs used throughout the RTK package.
+Decoupled from the Expo-constants module so it can be unit tested.
+
+## Parameters
+
+### args
+
+#### devApiPort?
+
+`number`
+
+#### envApiUrl?
+
+`string`
+
+#### expoConstants
+
+[`ExpoConstantsShape`](../interfaces/ExpoConstantsShape.md)
+
+#### isDev
+
+`boolean`
+
+#### windowOrigin?
+
+`string`
+
+## Returns
+
+[`BaseUrls`](../interfaces/BaseUrls.md)

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

@@ -0,0 +1,23 @@
+> **resolveDevApiPort**(`args`): `number`
+
+Resolves the local dev API port. Apps whose backend listens on a non-default
+port (for example 3000 or 9000) override it via the `EXPO_PUBLIC_DEV_API_PORT`
+env var or `expoConfig.extra.DEV_API_PORT`, mirroring how `EXPO_PUBLIC_API_URL`
+and `extra.BASE_URL` are provided. Missing or invalid values fall back to the
+default port.
+
+## Parameters
+
+### args
+
+#### envDevApiPort?
+
+`string`
+
+#### expoConstants
+
+[`ExpoConstantsShape`](../interfaces/ExpoConstantsShape.md)
+
+## Returns
+
+`number`

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

@@ -0,0 +1,14 @@
+> **resolveFeatureFlagsOptions**(`basePathOrOptions?`): `ResolvedFeatureFlagsOptions`
+
+Normalizes the legacy-compatible `basePathOrOptions` argument into a
+`{basePath, skip, ...}` pair with defaults applied.
+
+## Parameters
+
+### basePathOrOptions?
+
+`string` \| [`UseFeatureFlagsOptions`](../interfaces/UseFeatureFlagsOptions.md)
+
+## Returns
+
+`ResolvedFeatureFlagsOptions`

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

@@ -0,0 +1,19 @@
+> **useTerrenoFeatureFlags**(`api`, `options?`): [`UseTerrenoFeatureFlagsResult`](../interfaces/UseTerrenoFeatureFlagsResult.md)
+
+Wires Terreno's bulk `/flagConfiguration` fetch into OpenFeature's
+TypedInMemoryProvider for the given domain. Prefer OpenFeature React
+hooks (`useBooleanFlagValue`, etc.) as children of `<OpenFeatureProvider>`.
+
+## Parameters
+
+### api
+
+`FlagsApi`
+
+### options?
+
+[`UseTerrenoFeatureFlagsOptions`](../interfaces/UseTerrenoFeatureFlagsOptions.md)
+
+## Returns
+
+[`UseTerrenoFeatureFlagsResult`](../interfaces/UseTerrenoFeatureFlagsResult.md)

package/dist/docs/versioned/0.24.0/reference/generated/rtk/interfaces/TerrenoFlagDefinition.md

@@ -0,0 +1,19 @@
+Shape returned by `GET .../flagConfiguration` (OpenFeature static flag map).
+
+## Properties
+
+### defaultVariant
+
+> **defaultVariant**: `string`
+
+***
+
+### disabled
+
+> **disabled**: `boolean`
+
+***
+
+### variants
+
+> **variants**: `Record`\<`string`, `boolean` \| `string`\>

package/dist/docs/versioned/0.24.0/reference/generated/rtk/interfaces/UseFeatureFlagsOptions.md

@@ -0,0 +1,50 @@
+Creates feature flag accessors from an RTK Query API instance.
+
+Injects a `GET {basePath}/flagConfiguration` endpoint into the API and returns
+accessors for reading flag values. Fetches once on mount and caches via
+RTK Query. Both `api` and `basePath` should be stable references.
+
+## Example
+
+```typescript
+const { getFlag, getVariant } = useFeatureFlags(terrenoApi);
+
+const showNewCheckout = getFlag("new-checkout-flow");       // true | false
+const variant = getVariant("checkout-experiment");           // "control" | "variant-a" | null
+```
+
+## Properties
+
+### basePath?
+
+> `optional` **basePath?**: `string`
+
+***
+
+### domain?
+
+> `optional` **domain?**: `string`
+
+***
+
+### skip?
+
+> `optional` **skip?**: `boolean`
+
+***
+
+### socket?
+
+> `optional` **socket?**: \{ `off`: (`event`, `handler`) => `void`; `on`: (`event`, `handler`) => `void`; \} \| `null`
+
+***
+
+### socketEventName?
+
+> `optional` **socketEventName?**: `string`
+
+***
+
+### userId?
+
+> `optional` **userId?**: `string` \| `null`

package/dist/docs/versioned/0.24.0/reference/generated/rtk/interfaces/UseTerrenoFeatureFlagsOptions.md

@@ -0,0 +1,41 @@
+## Properties
+
+### basePath?
+
+> `optional` **basePath?**: `string`
+
+***
+
+### domain?
+
+> `optional` **domain?**: `string`
+
+OpenFeature domain — must match `<OpenFeatureProvider domain>` on the client.
+
+***
+
+### skip?
+
+> `optional` **skip?**: `boolean`
+
+***
+
+### socket?
+
+> `optional` **socket?**: \{ `off`: (`event`, `handler`) => `void`; `on`: (`event`, `handler`) => `void`; \} \| `null`
+
+Optional socket.io client for live flag refresh.
+
+***
+
+### socketEventName?
+
+> `optional` **socketEventName?**: `string`
+
+***
+
+### userId?
+
+> `optional` **userId?**: `string` \| `null`
+
+Current user id — included in RTK cache key and OpenFeature targeting context.

package/dist/docs/versioned/0.24.0/reference/generated/rtk/interfaces/UseTerrenoFeatureFlagsResult.md

@@ -0,0 +1,33 @@
+## Properties
+
+### client
+
+> **client**: `Client`
+
+***
+
+### error
+
+> **error**: `unknown`
+
+***
+
+### flags
+
+> **flags**: [`TerrenoFlagConfiguration`](../type-aliases/TerrenoFlagConfiguration.md)
+
+***
+
+### isLoading
+
+> **isLoading**: `boolean`
+
+***
+
+### refetch
+
+> **refetch**: () => `unknown`
+
+#### Returns
+
+`unknown`

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

@@ -0,0 +1 @@
+> **TerrenoFlagConfiguration** = `Record`\<`string`, [`TerrenoFlagDefinition`](../interfaces/TerrenoFlagDefinition.md)\>

package/dist/docs/versioned/0.24.0/reference/generated/rtk/variables/DEFAULT_DEV_API_PORT.md

@@ -0,0 +1,4 @@
+> `const` **DEFAULT\_DEV\_API\_PORT**: `4000` = `4000`
+
+Default local API port used when resolving dev base URLs from the Expo
+host/experience URL or the localhost fallback. Matches the example backend.