V1.0.0.1 release

.gitignore

@@ -1,6 +1,7 @@
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
 .idea
+.cursor
 .env
 
 # dependencies

README.md

@@ -105,12 +105,23 @@ VITE_AUTHENTIK_REDIRECT_URI="https://your-athentik-redirect"
 
 ## Scripts/Commands - Mock Servers, Testing, Type/Zod Generation
 
-- `npm run mock:server:vitest`: Runs a Prism mock server to run the vitest test suite.
-- `npm run mock:server:cypress`: Runs a Prism mock server to run the cypress test suite.
+- `npm run mock:server:vitest`: Runs a Prism mock server to run the vitest test suite. Uses the committed `openapi-auth.json` in the repo root (no network fetch for startup).
+- `npm run mock:server:cypress`: Runs a Prism mock server to run the cypress test suite. Same spec file as vitest.
 - `npm run test:run`: Runs the Vitest test suite a single time.
 - `npx cypress open`: Opens the Cypress browser to run and interact with Cypress tests.
 - `npx cypress run`: Runs the Cypress test suite in headless mode a single time.
-- `npm run openapi:generate`: Runs hey-api typescript generation for types and zod schemas in `/generated`
+- `npm run openapi:generate`: Runs hey-api TypeScript and Zod generation using `./openapi-auth.json` into `src/generated`.
+
+## Refreshing the OpenAPI spec
+
+Prism mocks and codegen both use **`openapi-auth.json`** at the repo root. When the staging API adds or changes schemas, refresh the file from staging and regenerate so contract tests and `zWellResponse` validation stay aligned:
+
+```bash
+curl -fsSL "https://ocotillo-api-staging.newmexicowaterdata.org/openapi-auth.json" -o openapi-auth.json
+npm run openapi:generate
+```
+
+Then run tests and commit `openapi-auth.json` plus `src/generated/` updates as needed.
 
 ## Running the Vitest Test Suite
 
@@ -150,14 +161,15 @@ npx cypress run
 
 ## Tests in CI and Openapi-TS Generation
 
-Both the Vitest and Cypress test suites run via a Github action on PR. The Vitest contract tests may fail because of changes to the Ocotillo API if you have not recently run the test suite locally.
-In the case of failing contract tests, you'll have to make sure your types and zod schemas are up to date with the openapi.json spec by:
+Both the Vitest and Cypress test suites run via a Github action on PR. The Vitest contract tests may fail when the committed **`openapi-auth.json`** is older than the API schemas your Zod types expect.
+
+When the API changes, refresh **`openapi-auth.json`** from staging (see **Refreshing the OpenAPI spec** above), run:
 
-- Running the opnenapi-ts generation from the Ocotillo Staging API `openapi.json` spec:
 ```bash
 npm run openapi:generate
 ```
-- Fixing any failing tests and related code
+
+Fix any failing tests and related code, then commit `openapi-auth.json` and `src/generated/` together with your changes.
 
 ## Building and Serving Production Build
 

openapi-ts.config.ts

@@ -1,7 +1,7 @@
 import { defineConfig } from '@hey-api/openapi-ts'
 
 export default defineConfig({
-  input: 'https://ocotillo-api-staging.newmexicowaterdata.org/openapi-auth.json',
+  input: './openapi-auth.json',
   output: {path: './src/generated', clean: true},
   plugins: [
     {

package.json

@@ -15,8 +15,8 @@
     "test:run": "vitest run",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc",
-    "mock:server:vitest": "prism mock https://ocotillo-api-staging.newmexicowaterdata.org/openapi-auth.json --dynamic=false --port 4010",
-    "mock:server:cypress": "prism mock https://ocotillo-api-staging.newmexicowaterdata.org/openapi-auth.json --dynamic=true --port 4010 --seed 12345",
+    "mock:server:vitest": "prism mock openapi-auth.json --dynamic=false --port 4010",
+    "mock:server:cypress": "prism mock openapi-auth.json --dynamic=true --port 4010 --seed 12345",
     "openapi:generate": "npx @hey-api/openapi-ts"
   },
   "browserslist": {

public/content/about.md

@@ -36,4 +36,4 @@ One of the things the process revealed was that data sharing problems exist with
 
 ## Questions or feedback?
 
-Use the [Report a Bug](/report-a-bug) page to submit issues or suggestions, or reach out to the Data Services team at [newmexicowaterdata@nmt.edu](mailto:newmexicowaterdata@nmt.edu).
+Use the [Report a Bug](/report-a-bug) page to submit issues or suggestions, or reach out to the Data Services team at [ocotillo-nmbg@nmt.edu](mailto:ocotillo-nmbg@nmt.edu).

public/content/report-a-bug.md

@@ -5,7 +5,7 @@ deck: Found something broken or have a suggestion? Let us know.
 
 ## How to report an issue
 
-If you've encountered an error, unexpected behavior, or have a suggestion for improvement, please submit an issue through one of the channels below.
+If you've encountered an error, unexpected behavior, or have a suggestion for improvement, we want to know about it! Your feedback is essential to help us improve Ocotillo. Please email us with bug reports or feature requests at [ocotillo-nmbg@nmt.edu](mailto:ocotillo-nmbg@nmt.edu).
 
 ## What to include
 
@@ -15,8 +15,8 @@ A good bug report includes:
 - **What actually happened**
 - **Steps to reproduce** -- the more specific the better
 - **Browser and operating system** (e.g. Chrome on macOS)
-- **Screenshots** if the issue is visual
+- **Screenshots are extremely helpful** if the issue is visual
 
 ## Contact
 
-For urgent issues or questions, reach out directly to the development team at [newmexicowaterdata@nmt.edu](mailto:newmexicowaterdata@nmt.edu).
+For urgent issues or questions, reach out directly to the development team at [ocotillo-nmbg@nmt.edu](mailto:ocotillo-nmbg@nmt.edu).

src/components/Button/ReportBugButton.tsx

@@ -0,0 +1,43 @@
+import { Button } from '@mui/material'
+import { BugReportOutlined } from '@mui/icons-material'
+import { buildBugReportUrl } from '@/utils'
+
+interface ReportBugButtonProps {
+  user?: {
+    name?: string
+    email?: string
+  }
+}
+
+export const ReportBugButton = ({ user }: ReportBugButtonProps) => {
+  const handleClick = () => {
+    const url = buildBugReportUrl({
+      userName: user?.name,
+      userEmail: user?.email,
+    })
+    window.open(url, '_blank', 'noopener,noreferrer')
+  }
+
+  return (
+    <Button
+      onClick={handleClick}
+      size="small"
+      variant="text"
+      startIcon={<BugReportOutlined sx={{ fontSize: '0.9rem !important', mr: -0.5 }} />}
+      aria-label="Get help / report a bug"
+      sx={{
+        textTransform: 'none',
+        color: 'text.secondary',
+        fontSize: '0.8rem',
+        fontWeight: 400,
+        minWidth: 0,
+        px: 1.5,
+        borderRadius: 999,
+        whiteSpace: 'nowrap',
+        '&:hover': { color: 'text.primary', bgcolor: 'action.hover' },
+      }}
+    >
+      Get Help
+    </Button>
+  )
+}

src/components/Button/WellPDFDownload.tsx

@@ -23,7 +23,7 @@ export const WellPDFDownloadButton = ({
 }: {
   well: IWell
   isLoading: boolean
-  observations: readonly Partial<IObservation>[]
+  observations: readonly Partial<Omit<IObservation, 'created_at'>>[]
   assets: BaseRecord[]
   contacts: IContact[]
   sample?: Partial<ISample>

src/components/Button/index.ts

@@ -1,2 +1,3 @@
+export * from './ReportBugButton'
 export * from './WellPDFPreview'
 export * from './WellPDFDownload'