neon-testing 1.0.0 → 1.0.2

package/README.md

@@ -1,10 +1,14 @@
 # Neon testing
 
-A Vitest utility for running database tests with isolated [Neon](https://neon.com/) branches. Each test file gets its own dedicated PostgreSQL database (Neon branch), ensuring clean, parallel, and reproducible tests.
+A Vitest utility for automated integration tests with [Neon](https://neon.com/).
+
+Each test file runs against its own isolated PostgreSQL database (Neon branch), ensuring clean, parallel, and reproducible testing of code that relies on a database. Because it uses a real database, you can test code logic that depends on database features such as transaction rollbacks, unique constraints, and more.
+
+Using an actual clone of your production database for integration testing lets you verify functionality that mocks cannot.
 
 ## Features
 
-- 🔄 **Isolated test environments** - Each test file runs against its own Neon branch
+- 🔄 **Isolated test environments** - Each test file runs against its own Postgres database with your actual schema and constraints
 - 🧹 **Automatic cleanup** - Neon test branches are created and destroyed automatically
 - 🛡️ **TypeScript native** - No JavaScript support
 - 🎯 **ESM only** - No CommonJS support
@@ -25,7 +29,7 @@ A Vitest utility for running database tests with isolated [Neon](https://neon.co
 
 ### Install
 
-```bash
+```sh
 bun add -d neon-testing
 ```
 
@@ -124,22 +128,18 @@ Tests within a single test file share the same database instance (Neon branch),
 
 This works because Vitest runs test files in parallel, but tests within each test file run one at a time.
 
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
 ## Contributing
 
 Contributions are welcome! Please open issues or pull requests on [GitHub](https://github.com/starmode-base/neon-testing/pulls).
 
-## Support
+## License
 
-For questions or support, open an issue on [GitHub](https://github.com/starmode-base/neon-testing/issues).
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-## Commercial support
+## Need expert help?
 
-Need professional help with database testing, AI integration, or modern web development?
+Hi, I'm [@lirbank](https://github.com/lirbank). I take on a few consulting projects each year where I help companies build, unblock, and ship. Here's what I do:
 
-**[STΛR MODΞ](https://www.starmode.dev/)** - I run this AI development studio with data scientist and ML/AI expert Spencer Smith. We specialize in building AI-first applications, advanced AI workflows, and agentic networks. We help companies build reliable AI solutions.
+**[STΛR MODΞ](https://www.starmode.dev/)** — A boutique AI development studio I run with AI/ML expert and data scientist [@spencer-g-smith](https://github.com/spencer-g-smith). We help companies build accurate AI solutions: AI-first apps, advanced workflows, and agentic systems.
 
-**[Mikael Lirbank](https://www.lirbank.com/)** - My individual consulting practice for web application development, test automation, code quality, and technical architecture.
+**[Mikael Lirbank](https://www.lirbank.com/)** — My solo practice, focused on web app development, test automation, code quality, and technical architecture. I'm friendly and happy to help with the hard stuff.

package/index.ts

@@ -17,7 +17,7 @@ import { afterAll, beforeAll } from "vitest";
  */
 function createConnectionUri(
   connectionParameters: ConnectionDetails,
-  type: "pooler" | "direct"
+  type: "pooler" | "direct",
 ) {
   const { role, password, host, pooler_host, database } =
     connectionParameters.connection_parameters;
@@ -77,7 +77,7 @@ export function makeNeonTesting(factoryOptions: NeonTestingOptions) {
       if (isTestBranch) {
         await apiClient.deleteProjectBranch(
           factoryOptions.projectId,
-          branch.id
+          branch.id,
         );
       }
     }
@@ -85,7 +85,7 @@ export function makeNeonTesting(factoryOptions: NeonTestingOptions) {
 
   const testDbSetup = (
     /** Override any factory options except apiKey */
-    overrides?: NeonTestingOverrides
+    overrides?: NeonTestingOverrides,
   ) => {
     // Merge factory options with overrides
     const options = { ...factoryOptions, ...overrides };
@@ -140,8 +140,6 @@ export function makeNeonTesting(factoryOptions: NeonTestingOptions) {
     afterAll(async () => {
       await deleteBranch();
       process.env.DATABASE_URL = undefined;
-
-      // await deleteAllTestBranches();
     });
   };
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "neon-testing",
-  "version": "1.0.0",
-  "description": "A Vitest utility for running database tests with isolated Neon branches",
+  "version": "1.0.2",
+  "description": "A Vitest utility for automated integration tests with Neon",
   "keywords": [
     "neon",
     "postgres",
@@ -16,28 +16,28 @@
   "bugs": "https://github.com/starmode-base/neon-testing/issues",
   "module": "index.ts",
   "type": "module",
+  "files": [
+    "index.ts"
+  ],
   "scripts": {
     "test": "vitest",
     "format": "prettier --write .",
-    "release": "bun publish && git tag v$(bun -p \"require('./package.json').version\") && git push --tags"
+    "release": "bun publish",
+    "prepublishOnly": "git diff-index --quiet HEAD || (echo 'Error: You have uncommitted changes' && exit 1) && tsc && vitest run && prettier --check .",
+    "postpublish": "git tag v$(bun -p \"require('./package.json').version\") && git push --tags"
   },
   "dependencies": {
-    "@neondatabase/api-client": "^2.0.0"
+    "@neondatabase/api-client": "^2.1.0"
   },
   "peerDependencies": {
-    "typescript": "^5",
-    "vitest": "^3"
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
   },
   "devDependencies": {
     "@neondatabase/serverless": "^1.0.1",
     "dotenv": "^16.5.0",
-    "pg": "^8.16.0",
+    "pg": "^8.16.2",
     "postgres": "^3.4.7",
     "prettier": "^3.5.3"
-  },
-  "files": [
-    "index.ts",
-    "README.md",
-    "LICENSE"
-  ]
+  }
 }