@lupinum/better-convex-nuxt 1.0.0-beta.6 → 1.0.0-beta.7

package/README.md

@@ -127,6 +127,35 @@ or the first signing key. It refuses production provisioning.
 
 MCP remains opt in. Installing the Vue or Nuxt package does not start an MCP server or grant application authority.
 
+<!-- BEGIN:consumer-onboarding -->
+
+## Use a coding agent
+
+A coding agent is a development tool that can inspect and change your project.
+After installation, copy this prompt into your coding agent:
+
+```text
+Add Better Convex to this application using the smallest suitable Nuxt, Vue,
+or MCP package. Read the project's existing instructions first. Resolve the
+installed @lupinum/better-convex-*/agent-docs export from this application's
+directory and read its starting pages. Use the installed version's examples
+and public types. Preserve existing authorization, routes, conventions, and
+AGENTS.md instructions. Convex functions remain the source of truth for
+authorization; do not move that rule into client state, Nuxt middleware, or MCP
+transport. Add or update one short Better Convex pointer in AGENTS.md if the
+project allows it; do not duplicate the documentation. If the file is absent,
+create only that pointer. Report missing guidance. Verify the affected type,
+build, runtime, authentication, and disposal boundaries.
+```
+
+If the installed package has no `agent-docs` export, read its packaged README
+and types. Use documentation from the matching source tag when more detail is
+needed. Installing or updating the package does not edit project instructions.
+The pointer resolves the installed package, so upgrades and rollbacks select
+the matching documentation without copying it into your application.
+
+<!-- END:consumer-onboarding -->
+
 ## Documentation
 
 Read the [Better Convex documentation](https://better-convex.lupinum.com). Start with [choose your path](https://better-convex.lupinum.com/docs/get-started/choose-your-path), the [mental model](https://better-convex.lupinum.com/docs/understand/mental-model), and [limitations](https://better-convex.lupinum.com/docs/overview/limitations).

package/dist/agent/AGENTS.md

@@ -0,0 +1,102 @@
+# @lupinum/better-convex-nuxt
+
+Documentation for installed version 1.0.0-beta.7.
+
+Read the relevant local pages before changing this package’s integration.
+Project instructions govern architecture, style and permissions.
+
+## Start here
+
+- [Choose Your Path](./pages/docs/get-started/choose-your-path.md) — /docs/get-started/choose-your-path
+- [Installation](./pages/docs/get-started/installation.md) — /docs/get-started/installation
+- [Limitations and Trade-offs](./pages/docs/overview/limitations.md) — /docs/overview/limitations
+
+## Find a page
+
+The index below maps public documentation routes to this installed snapshot.
+For links to this documentation site, use the matching local page in manifest.json
+instead of fetching a possibly different website version. Preserve URL fragments.
+External dependencies have their own versioned contracts. Report missing guidance.
+
+- [Better Convex documentation](./pages/docs.md) — /docs
+- [Vue MCP Apps](./pages/docs/build/agents/mcp-apps.md) — /docs/build/agents/mcp-apps
+- [MCP on Convex](./pages/docs/build/agents/mcp.md) — /docs/build/agents/mcp
+- [Connection State](./pages/docs/build/application-behavior/connection-state.md) — /docs/build/application-behavior/connection-state
+- [DevTools](./pages/docs/build/application-behavior/devtools.md) — /docs/build/application-behavior/devtools
+- [Error Handling](./pages/docs/build/application-behavior/error-handling.md) — /docs/build/application-behavior/error-handling
+- [Logging](./pages/docs/build/application-behavior/logging.md) — /docs/build/application-behavior/logging
+- [Performance](./pages/docs/build/application-behavior/performance.md) — /docs/build/application-behavior/performance
+- [Auth State and User Data](./pages/docs/build/authentication/auth-state-and-user.md) — /docs/build/authentication/auth-state-and-user
+- [Backend Authorization](./pages/docs/build/authentication/backend-authorization.md) — /docs/build/authentication/backend-authorization
+- [Better Auth Plugins](./pages/docs/build/authentication/better-auth-plugins.md) — /docs/build/authentication/better-auth-plugins
+- [Better Auth Setup](./pages/docs/build/authentication/better-auth-setup.md) — /docs/build/authentication/better-auth-setup
+- [Custom User Fields](./pages/docs/build/authentication/custom-user-fields.md) — /docs/build/authentication/custom-user-fields
+- [Delegated OAuth and MCP](./pages/docs/build/authentication/delegated-oauth-and-mcp.md) — /docs/build/authentication/delegated-oauth-and-mcp
+- [Authentication](./pages/docs/build/authentication/overview.md) — /docs/build/authentication/overview
+- [Route Protection](./pages/docs/build/authentication/route-protection.md) — /docs/build/authentication/route-protection
+- [Sign In and Sign Out](./pages/docs/build/authentication/sign-in-and-sign-out.md) — /docs/build/authentication/sign-in-and-sign-out
+- [Transactional auth email](./pages/docs/build/authentication/transactional-email.md) — /docs/build/authentication/transactional-email
+- [User Synchronization](./pages/docs/build/authentication/user-synchronization.md) — /docs/build/authentication/user-synchronization
+- [Workforce authentication candidate](./pages/docs/build/authentication/workforce-profile.md) — /docs/build/authentication/workforce-profile
+- [Storage URLs](./pages/docs/build/files/storage-urls.md) — /docs/build/files/storage-urls
+- [Upload Files](./pages/docs/build/files/upload-files.md) — /docs/build/files/upload-files
+- [File Validation and Deletion](./pages/docs/build/files/validation-and-deletion.md) — /docs/build/files/validation-and-deletion
+- [Loading and Stale Data](./pages/docs/build/queries/loading-and-stale-data.md) — /docs/build/queries/loading-and-stale-data
+- [Pagination](./pages/docs/build/queries/pagination.md) — /docs/build/queries/pagination
+- [Queries](./pages/docs/build/queries/queries.md) — /docs/build/queries/queries
+- [Reactive Arguments](./pages/docs/build/queries/reactive-arguments.md) — /docs/build/queries/reactive-arguments
+- [Query Execution Options](./pages/docs/build/queries/ssr-options.md) — /docs/build/queries/ssr-options
+- [Credentials and Server Security](./pages/docs/build/server/credentials-and-security.md) — /docs/build/server/credentials-and-security
+- [serverConvex](./pages/docs/build/server/server-convex.md) — /docs/build/server/server-convex
+- [Server Routes](./pages/docs/build/server/server-routes.md) — /docs/build/server/server-routes
+- [Webhooks and Jobs](./pages/docs/build/server/webhooks-and-jobs.md) — /docs/build/server/webhooks-and-jobs
+- [Actions](./pages/docs/build/write-data/actions.md) — /docs/build/write-data/actions
+- [Concurrent Operations](./pages/docs/build/write-data/concurrent-operations.md) — /docs/build/write-data/concurrent-operations
+- [Form submissions](./pages/docs/build/write-data/forms.md) — /docs/build/write-data/forms
+- [Mutations](./pages/docs/build/write-data/mutations.md) — /docs/build/write-data/mutations
+- [Optimistic Updates](./pages/docs/build/write-data/optimistic-updates.md) — /docs/build/write-data/optimistic-updates
+- [Add a Mutation](./pages/docs/get-started/add-a-mutation.md) — /docs/get-started/add-a-mutation
+- [Add Authentication](./pages/docs/get-started/add-authentication.md) — /docs/get-started/add-authentication
+- [Choose Your Path](./pages/docs/get-started/choose-your-path.md) — /docs/get-started/choose-your-path
+- [First Real-Time Page](./pages/docs/get-started/first-realtime-page.md) — /docs/get-started/first-realtime-page
+- [Installation](./pages/docs/get-started/installation.md) — /docs/get-started/installation
+- [Next Steps](./pages/docs/get-started/next-steps.md) — /docs/get-started/next-steps
+- [Plain Vue and Vite](./pages/docs/get-started/plain-vue.md) — /docs/get-started/plain-vue
+- [Project Structure](./pages/docs/get-started/project-structure.md) — /docs/get-started/project-structure
+- [Protect Data](./pages/docs/get-started/protect-data.md) — /docs/get-started/protect-data
+- [Migrate beta.3 users](./pages/docs/operations/beta3-session-generation-migration.md) — /docs/operations/beta3-session-generation-migration
+- [Deployment](./pages/docs/operations/deployment.md) — /docs/operations/deployment
+- [Environment Variables](./pages/docs/operations/environment-variables.md) — /docs/operations/environment-variables
+- [Release Compatibility](./pages/docs/operations/release-compatibility.md) — /docs/operations/release-compatibility
+- [Security Model](./pages/docs/operations/security-model.md) — /docs/operations/security-model
+- [Troubleshooting](./pages/docs/operations/troubleshooting.md) — /docs/operations/troubleshooting
+- [Compare Nuxt Integrations](./pages/docs/overview/comparison.md) — /docs/overview/comparison
+- [Better Convex Nuxt](./pages/docs/overview/introduction.md) — /docs/overview/introduction
+- [Limitations and Trade-offs](./pages/docs/overview/limitations.md) — /docs/overview/limitations
+- [Use Cases](./pages/docs/overview/use-cases.md) — /docs/overview/use-cases
+- [Who It Is For](./pages/docs/overview/who-it-is-for.md) — /docs/overview/who-it-is-for
+- [Why Better Convex Nuxt](./pages/docs/overview/why-better-convex-nuxt.md) — /docs/overview/why-better-convex-nuxt
+- [Authenticated Server Route](./pages/docs/recipes/authenticated-server-route.md) — /docs/recipes/authenticated-server-route
+- [Test Signed-In Screens](./pages/docs/recipes/component-testing.md) — /docs/recipes/component-testing
+- [File Upload Form](./pages/docs/recipes/file-upload-form.md) — /docs/recipes/file-upload-form
+- [Infinite Scroll](./pages/docs/recipes/infinite-scroll.md) — /docs/recipes/infinite-scroll
+- [Optimistic Todo List](./pages/docs/recipes/optimistic-todo-list.md) — /docs/recipes/optimistic-todo-list
+- [Organization Permissions](./pages/docs/recipes/organization-permissions.md) — /docs/recipes/organization-permissions
+- [Protected Dashboard](./pages/docs/recipes/protected-dashboard.md) — /docs/recipes/protected-dashboard
+- [Public and Private Data](./pages/docs/recipes/public-and-private-data.md) — /docs/recipes/public-and-private-data
+- [Real-Time Feed](./pages/docs/recipes/realtime-feed.md) — /docs/recipes/realtime-feed
+- [API Surface](./pages/docs/reference/api-surface.md) — /docs/reference/api-surface
+- [Composables](./pages/docs/reference/composables.md) — /docs/reference/composables
+- [Error Types](./pages/docs/reference/error-types.md) — /docs/reference/error-types
+- [Module Configuration](./pages/docs/reference/module-configuration.md) — /docs/reference/module-configuration
+- [Package Exports](./pages/docs/reference/package-exports.md) — /docs/reference/package-exports
+- [Server API](./pages/docs/reference/server-api.md) — /docs/reference/server-api
+- [Authentication and Identity](./pages/docs/understand/authentication-and-identity.md) — /docs/understand/authentication-and-identity
+- [Design Decisions](./pages/docs/understand/design-decisions.md) — /docs/understand/design-decisions
+- [Errors and Failures](./pages/docs/understand/errors-and-failures.md) — /docs/understand/errors-and-failures
+- [Glossary](./pages/docs/understand/glossary.md) — /docs/understand/glossary
+- [Mental Model](./pages/docs/understand/mental-model.md) — /docs/understand/mental-model
+- [Query Ownership and Caching](./pages/docs/understand/query-ownership-and-caching.md) — /docs/understand/query-ownership-and-caching
+- [Request Lifecycle](./pages/docs/understand/request-lifecycle.md) — /docs/understand/request-lifecycle
+- [Server and Client Boundaries](./pages/docs/understand/server-and-client-boundaries.md) — /docs/understand/server-and-client-boundaries
+- [SSR, Hydration, and Real-Time](./pages/docs/understand/ssr-hydration-realtime.md) — /docs/understand/ssr-hydration-realtime