cleanup

Author: pyramation

README.md

@@ -11,91 +11,67 @@
    <a href="https://github.com/launchql/supabase-test/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
 </p>
 
+A friendly playground for building and validating Supabase Row-Level Security (RLS) using LaunchQL. It includes real-world examples, migrations, and a comprehensive test suite you can run locally.
 
-A friendly playground for building and validating Supabase Row‑Level Security (RLS) using LaunchQL. It includes real‑world examples, migrations, and a comprehensive test suite you can run locally.
-
-Built with [supabase-test](https://www.npmjs.com/package/supabase-test) — a Supabase‑optimized version of `pgsql-test` for instant, isolated Postgres test databases with automatic rollbacks and Supabase defaults. See the package for install and features.
+Built with [supabase-test](https://www.npmjs.com/package/supabase-test) — a Supabase-optimized version of `pgsql-test` for instant, isolated Postgres test databases with automatic rollbacks and Supabase defaults.
 
 ## Features
 
-- 🔐 RLS policy‑driven example tests with example product database using Supabase users
-- 🧪 Comprehensive end‑to‑end test suite against native Supabase schemas/tables (auth, storage, functions, realtime, and more)
-- 🐘 Supabase CLI local stack for zero‑setup Postgres
-- 🧪 Jest‑based tests that exercise RLS behavior end‑to‑end
-- 🚀 GitHub Actions workflows to run integration/e2e tests in CI/CD
-- 🧩 Modular schema packages you can reuse and extend
+- 🔐 **RLS Policy Testing** - Real-world examples with users and products tables
+- 🧪 **Comprehensive Test Suite** - End-to-end tests against native Supabase schemas
+- 🐘 **Zero-Setup Postgres** - Supabase CLI local stack for instant development
+- ⚡ **Jest Integration** - Fast, isolated tests with automatic rollbacks
+- 🚀 **CI/CD Ready** - GitHub Actions workflows for automated testing
+- 🧩 **Modular Architecture** - Reusable schema packages you can extend
 
-## Quick start (tl;dr)
+## Quick Start
 
 ```bash
-# bring up a local supabase stack
+# Initialize and start local Supabase stack
 npx supabase init
 npx supabase start
 
-# install deps and run all package tests
+# Install dependencies
 pnpm install
 
-# rls-demo: run tests in watch mode
+# Run tests in watch mode
 cd packages/rls-demo
 pnpm test:watch
 ```
 
-## getting started (step by step)
-
-this section will walk through everything slowly, from installing tools to running focused tests and exploring the schemas.
-
-1. install prerequisites (node, pnpm, supabase cli)
-2. initialize supabase and confirm services are healthy
-3. configure pg env vars if your shell needs them
-4. run migrations or package deploys as needed
-5. run tests (full suite and targeted)
-6. inspect policies and iterate
-
-for the expanded guide with screenshots and copy‑paste commands, see `docs/img/USAGE.md` (coming soon).
+## Repository Structure
 
-## repository layout
+This is a LaunchQL workspace combining `pnpm` and `lql` for modular Postgres packages:
 
-The repository is a launchql workspace, which is a hybrid `pnpm`/`lql` workspace, which allows for modular postgres packages, that can be easily tested via `pgsql-test`, or in the case of this repository, `supabase-test`. Here are the packages of interest:
+- **`packages/supabase`** - Supabase-focused SQL, tests, and helpers
+- **`packages/rls-demo`** - Demo extension showcasing RLS with users/products
 
-- `packages/supabase`: supabase‑focused sql, tests, and helpers
-- `packages/rls-demo`: demo extension showcasing rls with users/products
+## Testing
 
-## testing
-
-If you want to see how to run tests in each of the relevant packages, here are handy snippets you may want to learn:
+Run tests in different modes:
 
 ```bash
-# rls-demo: run tests in watch mode
+# Run all tests from root
+pnpm test
+
+# Watch mode for specific package
 cd packages/rls-demo
 pnpm test:watch
 
-# edit tests in packages/rls-demo/__tests__/... and Jest will re-run
-```
-
-```bash
-# supabase: run tests in watch mode
+# Run Supabase package tests
 cd packages/supabase
 pnpm test:watch
 ```
 
-```bash
-# run all packages’ tests from the repo root
-pnpm test
-```
-
-## Adding a package using `lql`
-
-- [ ] TODO
-
 ## Requirements
 
 - Node.js 20+
 - pnpm 10+
 - Supabase CLI 2+
 
-## troubleshooting
+## Troubleshooting
 
-- if your environment needs explicit pg variables, export and retry:
+If you encounter connection issues, set your environment variables:
 
 ```bash
 export PGPORT=54322
@@ -104,9 +80,10 @@ export PGUSER=postgres
 export PGPASSWORD=postgres
 ```
 
-- if `pnpm test` can’t reach postgres, confirm supabase services are running and the `PG*` env vars match the port printed by `npx supabase start`
-- if ports are busy, stop old containers or pass a different port to supabase
-- node version mismatches can cause odd errors; use node 20+
+Common issues:
+- Ensure Supabase services are running (`npx supabase status`)
+- Check that ports match those shown by `npx supabase start`
+- Use Node.js 20+ to avoid compatibility issues
 
 ## Related LaunchQL Tooling
 
@@ -117,4 +94,4 @@ export PGPASSWORD=postgres
 
 AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
 
-No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.
+No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.

packages/rls-demo/README.md

@@ -1,41 +1,43 @@
-# @lql-pg/rls-demo
+# Supabase RLS Demo
 
-RLS (Row Level Security) demo extension for PostgreSQL.
+<p align="center" width="100%">
+  <img height="250" src="https://raw.githubusercontent.com/launchql/supabase-test/refs/heads/main/docs/img/logos.svg" />
+</p>
 
-Provides a demonstration of Row Level Security implementation with users and products tables, including:
-- `rls_test` schema with proper RLS policies
-- `users` table with RLS policies for user data access
-- `products` table with RLS policies for product ownership
-- Foreign key relationships and proper indexing
-- Automatic `updated_at` timestamp triggers
+<p align="center" width="100%">
+  <a href="https://github.com/launchql/supabase-test/actions/workflows/ci.yml">
+    <img height="20" src="https://github.com/launchql/supabase-test/actions/workflows/ci.yml/badge.svg" />
+  </a>
+   <a href="https://github.com/launchql/supabase-test/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
+</p>
 
-## Sample Data
+Supabase RLS (Row Level Security) demo, showcasing best practices for implementing secure, multi-tenant applications.
 
-This package includes sample data to demonstrate RLS functionality:
+## Features
 
-### Users
-- Alice Johnson ([email protected])
-- Bob Smith ([email protected]) 
-- Charlie Brown ([email protected])
-- Diana Prince ([email protected])
+- 🔐 Complete RLS implementation with users and products tables
+- 👥 Multi-tenant data isolation using Supabase auth
+- 🧪 Comprehensive test suite with real-world scenarios
 
-### Products
-- Alice owns: Laptop Pro ($1299.99), Wireless Mouse ($49.99)
-- Bob owns: Mechanical Keyboard ($149.99), Monitor 4K ($399.99)
-- Charlie owns: Webcam HD ($89.99), Headphones ($199.99)
-- Diana owns: Standing Desk ($599.99), Desk Lamp ($79.99)
+## Schema Overview
 
-## Data Insertion
+The `rls_test` schema includes:
+- **user_profiles** table with RLS policies for user data access
+- **products** table with RLS policies for product ownership
+- Proper foreign key constraints and indexes
 
-### Using SQL File
-```bash
-psql -d your_database -f seed-data.sql
-```
+## Quick Start
 
-### Using Node.js Script
 ```bash
-node insert-data.js
+# Run tests
+pnpm test
+
+# Watch mode for development
+pnpm test:watch
 ```
 
-### Using pgsql-test
-The test suite includes comprehensive data insertion and RLS testing examples.
+## Disclaimer
+
+AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
+
+No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.

packages/rls-demo/__tests__/rls-test-products.test.ts

@@ -1,13 +1,10 @@
 import { getConnections, PgTestClient } from 'supabase-test';
 
-let pg: PgTestClient;
 let db: PgTestClient;
 let teardown: () => Promise<void>;
 
 beforeAll(async () => {
-  
-  
-  ({ pg, db, teardown } = await getConnections());
+  ({ db, teardown } = await getConnections());
 });
 
 afterAll(async () => {

packages/rls-demo/__tests__/rls-test-users.test.ts

@@ -1,13 +1,10 @@
 import { getConnections, PgTestClient } from 'supabase-test';
 
-let pg: PgTestClient;
 let db: PgTestClient;
 let teardown: () => Promise<void>;
 
 beforeAll(async () => {
-  
-  
-  ({ pg, db, teardown } = await getConnections());
+  ({ db, teardown } = await getConnections());
 });
 
 afterAll(async () => {

packages/rls-demo/__tests__/rls/rls.advanced.test.ts

@@ -24,7 +24,7 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
     db.setContext({ role: 'service_role' });
 
     const user = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 1']
@@ -43,7 +43,7 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
     );
 
     const verifiedUsers = await db.any(
-      `SELECT id FROM rls_test.users WHERE id = $1`,
+      `SELECT id FROM rls_test.user_profiles WHERE id = $1`,
       [user.id]
     );
     expect(verifiedUsers.length).toBe(1);
@@ -57,7 +57,7 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
     db.clearContext();
 
     const anonUsers = await db.any(
-      `SELECT id FROM rls_test.users WHERE id = $1`,
+      `SELECT id FROM rls_test.user_profiles WHERE id = $1`,
       [user.id]
     );
     expect(anonUsers.length).toBe(0);
@@ -76,7 +76,7 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // create user as admin
     const user = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 2']
@@ -104,14 +104,14 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // create two users as admin
     const user1 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 3']
     );
 
     const user2 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 4']
@@ -154,14 +154,14 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // create multiple users as admin
     const user1 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 5']
     );
 
     const user2 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 6']
@@ -213,7 +213,7 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // create user as admin
     const user = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 7']
@@ -245,7 +245,7 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // user deletes themselves - products should cascade delete
     await db.any(
-      `DELETE FROM rls_test.users WHERE id = $1`,
+      `DELETE FROM rls_test.user_profiles WHERE id = $1`,
       [user.id]
     );
 
@@ -264,21 +264,21 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // create three users as admin
     const user1 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 8']
     );
 
     const user2 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 9']
     );
 
     const user3 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 10']
@@ -332,7 +332,7 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // create user as admin
     const user = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 11']
@@ -346,7 +346,7 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // should not be able to access user data with null user_id
     await expect(
-      db.one(`SELECT id FROM rls_test.users WHERE id = $1`, [user.id])
+      db.one(`SELECT id FROM rls_test.user_profiles WHERE id = $1`, [user.id])
     ).rejects.toThrow();
   });
 
@@ -356,14 +356,14 @@ describe('tutorial: advanced rls edge cases and scenarios', () => {
 
     // create two users as admin
     const user1 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 12']
     );
 
     const user2 = await db.one(
-      `INSERT INTO rls_test.users (email, name) 
+      `INSERT INTO rls_test.user_profiles (email, name) 
        VALUES ($1, $2) 
        RETURNING id`,
       ['[email protected]', 'Advanced User 13']