@t1mmen/srtd 0.2.1 → 0.3.0

package/README.md

@@ -2,11 +2,17 @@
 
 Live-reloading SQL templates for [Supabase](https://supabase.com) projects. DX supercharged! 🚀
 
+[![npm version](https://badge.fury.io/js/@t1mmen%2Fsrtd.svg)](https://www.npmjs.com/package/@t1mmen/srtd)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI/CD](https://github.com/t1mmen/srtd/actions/workflows/ci.yml/badge.svg)](https://github.com/t1mmen/srtd/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/t1mmen/srtd/graph/badge.svg?token=CIMAZ55KCJ)](https://codecov.io/gh/t1mmen/srtd)
 
-`srtd` enhances the [Supabase](https://supabase.com) development workflow by adding live-reloading SQL templates, and a single-source-of-truth template migrations system for your database functions, RLS policies, etc. Drastically simplify code reviews 💪
+`srtd` enhances the [Supabase](https://supabase.com) DX by adding live-reloading SQL templates into local db. The single-source-of-truth template ➡️ migrations system brings sanity to code reviews, making `git blame` useful.
 
 Built specifically for projects using the standard [Supabase](https://supabase.com) stack (but probably works alright for other Postgres-based projects, too).
 
+**Read the introductory blog post: [Introducing `srtd`: Live-Reloading SQL Templates for Supabase](https://timm.stokke.me/blog/srtd-live-reloading-and-sql-templates-for-supabase)**
+
 ## Why This Exists 🤔
 
 While building [Timely](https://www.timely.com)'s next-generation [Memory Engine](https://www.timely.com/memory-app) on [Supabase](https://supabase.com), we found ourselves facing two major annoyances:
@@ -19,8 +25,8 @@ After over a year of looking-but-not-finding a better way, I paired up with [Cla
 ## Key Features ✨
 
 - **Live Reload**: Changes to your SQL templates instantly update your local database
-- **Single Source of Truth**: Templates are the source of all (non-mutable) database objects, making code reviews a breeze
-- **Clean Migrations**: Generate standard [Supabase](https://supabase.com) migrations when you're ready to deploy
+- **Single Source of Truth**: Templates are the source of all (non-mutable) database objects, improving code-review clarity
+- **Just SQL**: Templates build as standard [Supabase](https://supabase.com) migrations when you're ready to deploy
 - **Developer Friendly**: Interactive CLI with visual feedback for all operations
 
 ## Requirements
@@ -31,22 +37,29 @@ After over a year of looking-but-not-finding a better way, I paired up with [Cla
 
 ## Quick Start 🚀
 
-First, install `srtd` globally or in your project:
+### Installation
 
 ```bash
-npm install -g srtd  # Global installation
-# or
-npm install --save-dev srtd  # Project installation
+# Global installation
+npm install -g @t1mmen/srtd
+
+# Project installation
+npm install --save-dev @t1mmen/srtd
+
+# Or run directly
+npx @t1mmen/srtd
 ```
 
-Then set up in your [Supabase](https://supabase.com) project:
+### Setup
 
 ```bash
 cd your-supabase-project
 srtd init
 ```
 
-Create a template (e.g., `supabase/migrations-templates/my_function.sql`):
+### Create Your First Template
+
+Create `supabase/migrations-templates/my_function.sql`:
 
 ```sql
 CREATE OR REPLACE FUNCTION my_function()
@@ -57,21 +70,23 @@ END;
 $$ LANGUAGE plpgsql;
 ```
 
-Start development mode:
+### Development Workflow
 
+1. Start watch mode:
 ```bash
 srtd watch  # Changes auto-apply to local database
 ```
 
-When ready to deploy:
-
+2. When ready to deploy:
 ```bash
-srtd build  # Creates timestamped migration file
-supabase migrate up  # Apply using Supabase CLI
+srtd build        # Creates timestamped migration file
+supabase migration up  # Apply using Supabase CLI
 ```
 
 ## Commands 🎮
 
+### Interactive Mode
+
 Running `srtd` without arguments opens an interactive menu:
 
 ```
@@ -81,68 +96,101 @@ Running `srtd` without arguments opens an interactive menu:
   👀  watch - Watch templates for changes, apply directly to database
 ```
 
-Or use these commands directly:
+### CLI Mode
 
-- 🏗️  `build` - Generate [Supabase](https://supabase.com) migrations from templates
-- ▶️  `apply` - Apply templates directly to local database
-- ✍️  `register [file.sql]` - Mark templates as already built (interactive UI if no file specified)
-- 👀 `watch` - Watch templates and apply changes instantly
+- 🏗️  `build [--force]` - Generate migrations from templates
+- ▶️  `apply [--force]` - Apply templates directly to local database
+- ✍️  `register [file.sql]` - Mark templates as already built
+- 👀 `watch` - Watch and auto-apply changes
+
+> [!IMPORTANT]
+> `watch` and `apply` commands modify your local database directly and don't clean up after themselves. Use with caution!
 
 ## Perfect For 🎯
 
-Ideal for [Supabase](https://supabase.com) database objects that need full redefinition:
+### Ideal Use Cases
 
-✅ Functions and stored procedures:
+✅ Database functions:
 ```sql
-CREATE OR REPLACE FUNCTION search_products(query text, category_id uuid DEFAULT NULL)
-RETURNS SETOF products AS $$
+-- Reusable auth helper
+CREATE OR REPLACE FUNCTION auth.user_id()
+RETURNS uuid AS $$
+  SELECT auth.uid()::uuid;
+$$ LANGUAGE sql SECURITY DEFINER;
+
+-- Event notifications
+CREATE OR REPLACE FUNCTION notify_changes()
+RETURNS trigger AS $$
 BEGIN
-  RETURN QUERY
-    SELECT p.* FROM products p
-    LEFT JOIN product_categories pc ON pc.product_id = p.id
-    WHERE to_tsvector('english',
-      p.name || ' ' ||
-      p.description || ' ' ||
-      p.tags || ' ' ||
-      COALESCE((
-        SELECT string_agg(c.name, ' ')
-        FROM categories c
-        WHERE c.id = ANY(p.category_ids)
-      ), '')
-    ) @@ plainto_tsquery('english', query)
-    AND (category_id IS NULL OR pc.category_id = category_id);
+  PERFORM pg_notify(
+    'changes',
+    json_build_object('table', TG_TABLE_NAME, 'id', NEW.id)::text
+  );
+  RETURN NEW;
 END;
 $$ LANGUAGE plpgsql;
 ```
 
-✅ Row-Level Security (RLS) policies:
+✅ Row-Level Security (RLS):
+```sql
+-- Replace/update policies safely
+DROP POLICY IF EXISTS "workspace_access" ON resources;
+CREATE POLICY "workspace_access" ON resources
+  USING (workspace_id IN (
+    SELECT id FROM workspaces
+    WHERE organization_id = auth.organization_id()
+  ));
+```
+
+✅ Views for data abstraction:
 ```sql
-CREATE POLICY "users can view own data"
-  ON profiles FOR SELECT
-  USING (auth.uid() = user_id);
+CREATE OR REPLACE VIEW active_subscriptions AS
+SELECT
+  s.*,
+  p.name as plan_name,
+  p.features
+FROM subscriptions s
+JOIN plans p ON p.id = s.plan_id
+WHERE s.status = 'active'
+  AND s.expires_at > CURRENT_TIMESTAMP;
 ```
 
-✅ Roles and permissions:
+✅ Roles and Permissions:
 ```sql
-CREATE ROLE authenticated;
+-- Revoke all first for clean state
+REVOKE ALL ON ALL TABLES IN SCHEMA public FROM public;
+
+-- Grant specific access
 GRANT USAGE ON SCHEMA public TO authenticated;
 GRANT SELECT ON ALL TABLES IN SCHEMA public TO authenticated;
 ```
 
-**Not recommended for:**
+✅ Safe Type Extensions:
+```sql
+DO $$
+BEGIN
+  -- Add new enum values idempotently
+  IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'notification_type') THEN
+    CREATE TYPE notification_type AS ENUM ('email', 'sms');
+  END IF;
+
+  -- Extend existing enum safely
+  ALTER TYPE notification_type ADD VALUE IF NOT EXISTS 'push';
+END $$;
+```
+
+### Not Recommended For
 
 * ❌ Table structures
 * ❌ Indexes
 * ❌ Data modifications
-* ❌ Anything that is not fully re-definable, really.
+* ❌ Non-idempotent operations
 
-In these cases, use regular [Supabase](https://supabase.com) migrations.
+Use regular [Supabase](https://supabase.com) migrations for these cases.
 
 ## The Power of Templates 💪
 
-Here's why templates make your life easier. Consider a PR that adds priority to our notification dispatch function.
-
-With templates, the change is clear and reviewable:
+Templates make code reviews meaningful. Consider this PR adding priority to a notification function:
 
 ```diff
 CREATE OR REPLACE FUNCTION dispatch_notification(
@@ -179,23 +227,37 @@ CREATE OR REPLACE FUNCTION dispatch_notification(
     RETURNING id INTO notification_id;
 ```
 
-Without templates, the same change appears as a complete new file in your PR.
+Without templates, this would appear as a complete rewrite in your PR.
 
 ## Configuration 📝
 
-During initialization, `srtd` creates a `srtd.config.json`:
+`srtd.config.json` created during initialization:
 
-```json
+```jsonc
 {
+  // Prevents building templates with this extension
   "wipIndicator": ".wip",
+
+  // Migration file naming: 20211001000000_srtd-my_function.sql
+  "migrationPrefix": "srtd",
+
+  // Template discovery
   "filter": "**/*.sql",
+
+  // Migration file comments
   "banner": "You very likely **DO NOT** want to manually edit this generated file.",
   "footer": "",
+
+  // Wrap migrations in transaction
   "wrapInTransaction": true,
+
+  // File paths
   "templateDir": "supabase/migrations-templates",
   "migrationDir": "supabase/migrations",
   "buildLog": "supabase/migrations-templates/.buildlog.json",
   "localBuildLog": "supabase/migrations-templates/.buildlog.local.json",
+
+  // Database connection
   "pgConnection": "postgresql://postgres:postgres@localhost:54322/postgres"
 }
 ```
@@ -204,74 +266,73 @@ During initialization, `srtd` creates a `srtd.config.json`:
 
 ### Work in Progress Templates
 
-Add `.wip.sql` extension to templates under development to prevent accidental migration generation:
-
+Add `.wip.sql` extension to prevent migration generation:
 ```bash
-my_function.wip.sql  # Won't generate migrations during build
+my_function.wip.sql  # Only applied locally, never built
 ```
 
 ### Template State Management
 
-`srtd` maintains two logs:
-
-- `.buildlog.json` - Tracks which templates have been built into migrations (commit this)
-- `.buildlog.local.json` - Tracks local database state (add to .gitignore)
+Two state tracking files:
+- `.buildlog.json` - Migration build state (commit this)
+- `.buildlog.local.json` - Local database state (add to `.gitignore`)
 
 ### Register Existing Objects
 
-Import existing database objects into the template system:
-
+Import existing database objects:
 ```bash
-srtd register my_function.sql  # Won't generate new migration until changed
-# or
-srtd register  # Opens interactive UI for selecting multiple templates
+# Register specific template
+srtd register my_function.sql
+
+# Interactive multi-select UI
+srtd register
 ```
 
 ## Development 🛠️
 
-This project uses TypeScript and modern Node.js features. To contribute:
+### Local Setup
 
-1. Set up the development environment:
 ```bash
+# Clone and install
 git clone https://github.com/stokke/srtd.git
 cd srtd
 npm install
-```
 
-2. Start development:
-```bash
-npm run dev  # Watches for changes
-npm test     # Runs tests
-npm start    # Builds, links, and runs CLI
-```
+# Development
+npm run dev    # Watch mode
+npm test       # Run tests
+npm start      # Build, link, run
 
-3. Other useful commands:
-```bash
-npm run typecheck       # Type checking
-npm run lint           # Lint and fix
-npm run test:coverage  # Test coverage
+# Quality Checks
+npm run typecheck        # Type checking
+npm run lint            # Lint and fix
+npm run test:coverage   # Test coverage
 ```
 
 ## Contributing 🤝
 
-This tool was built to solve specific problems in our [Supabase](https://supabase.com) development workflow. While it's considered feature-complete for our needs, we welcome improvements through pull requests, especially for:
+While feature-complete for our needs, we welcome:
 
-- Bug fixes and reliability improvements
-- Documentation improvements and examples
-- Test coverage
-- Performance optimizations
+- 🐛 Bug fixes and reliability improvements
+- 📚 Documentation improvements
+- ✅ Test coverage enhancements
+- ⚡️ Performance optimizations
 
-### Contribution Guidelines
+### Contribution Process
 
 1. Create a [changeset](https://github.com/changesets/changesets) (`npm run changeset`)
 2. Ensure tests pass (`npm test`)
 3. Follow existing code style
-4. Update documentation as needed
+4. Update documentation
 
-Note that new features may or may not be accepted depending on whether they align with the project's focused scope. However, improvements to existing functionality, documentation, and tests are always welcome!
+Note: New features are evaluated based on alignment with project scope.
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+MIT License - see [LICENSE](LICENSE) file.
+
+---
 
 Made with 🪄 by [Timm Stokke](https://timm.stokke.me) & [Claude Sonnet](https://claude.ai)
+
+[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/t1mmen)

package/dist/__tests__/watch.test.js

@@ -18,7 +18,6 @@ describe('Watch Command', () => {
         await new Promise(resolve => setTimeout(resolve, 100));
         const output = lastFrame();
         expect(output).toContain('Watch Mode');
-        expect(output).toContain('Watching for template changes');
     });
 });
 //# sourceMappingURL=watch.test.js.map

package/dist/__tests__/watch.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch.test.js","sourceRoot":"","sources":["../../src/__tests__/watch.test.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,KAAK,MAAM,sBAAsB,CAAC;AAEzC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAC,cAAc,EAAC,EAAE;IACpC,MAAM,MAAM,GAAG,CAAC,MAAM,cAAc,EAAE,CAAyB,CAAC;IAChE,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,oBAAC,KAAK,OAAG,CAAC,CAAC;QACxC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"watch.test.js","sourceRoot":"","sources":["../../src/__tests__/watch.test.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,KAAK,MAAM,sBAAsB,CAAC;AAEzC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAC,cAAc,EAAC,EAAE;IACpC,MAAM,MAAM,GAAG,CAAC,MAAM,cAAc,EAAE,CAAyB,CAAC;IAChE,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,oBAAC,KAAK,OAAG,CAAC,CAAC;QACxC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env -S node --no-warnings
 import Pastel from 'pastel';
+import updateNotifier from 'update-notifier';
+import packageJson from '../package.json' assert { type: 'json' };
+updateNotifier({ pkg: packageJson }).notify();
 const app = new Pastel({
     importMeta: import.meta,
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":";AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,IAAI;CACxB,CAAC,CAAC;AAEH,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.tsx"],"names":[],"mappings":";AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,cAAc,MAAM,iBAAiB,CAAC;AAC7C,OAAO,WAAW,MAAM,iBAAiB,CAAC,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;AAElE,cAAc,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE9C,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,IAAI;CACxB,CAAC,CAAC;AAEH,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC"}

package/dist/commands/_app.js

@@ -1,7 +1,27 @@
-import { Box } from 'ink';
+import { Alert, ThemeProvider, defaultTheme, extendTheme } from '@inkjs/ui';
+import { Box, Static, Text } from 'ink';
 import React from 'react';
+import { useDatabaseConnection } from '../hooks/useDatabaseConnection.js';
+const customTheme = extendTheme(defaultTheme, {
+    components: {
+        Spinner: {
+            styles: {
+                frame: () => ({
+                    color: 'magenta',
+                }),
+            },
+        },
+    },
+});
 export default function App({ Component, commandProps }) {
-    return (React.createElement(Box, { flexDirection: "column" },
+    const { error } = useDatabaseConnection();
+    return (React.createElement(ThemeProvider, { theme: customTheme },
+        !!error && (React.createElement(Static, { items: [error] }, error => (React.createElement(Box, { key: error },
+            React.createElement(Alert, { variant: "error" },
+                React.createElement(Text, { bold: true, color: "red" },
+                    "Error:",
+                    ' '),
+                error))))),
         React.createElement(Component, { ...commandProps })));
 }
 //# sourceMappingURL=_app.js.map

package/dist/commands/_app.js.map

@@ -1 +1 @@
-{"version":3,"file":"_app.js","sourceRoot":"","sources":["../../src/commands/_app.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,SAAS,EAAE,YAAY,EAAY;IAC/D,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;QACzB,oBAAC,SAAS,OAAK,YAAY,GAAI,CAC3B,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"_app.js","sourceRoot":"","sources":["../../src/commands/_app.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAkB,MAAM,KAAK,CAAC;AAExD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,EAAE;IAC5C,UAAU,EAAE;QACV,OAAO,EAAE;YACP,MAAM,EAAE;gBACN,KAAK,EAAE,GAAc,EAAE,CAAC,CAAC;oBACvB,KAAK,EAAE,SAAS;iBACjB,CAAC;aACH;SACF;KACF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,SAAS,EAAE,YAAY,EAAY;IAC/D,MAAM,EAAE,KAAK,EAAE,GAAG,qBAAqB,EAAE,CAAC;IAE1C,OAAO,CACL,oBAAC,aAAa,IAAC,KAAK,EAAE,WAAW;QAC9B,CAAC,CAAC,KAAK,IAAI,CACV,oBAAC,MAAM,IAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IACnB,KAAK,CAAC,EAAE,CAAC,CACR,oBAAC,GAAG,IAAC,GAAG,EAAE,KAAK;YACb,oBAAC,KAAK,IAAC,OAAO,EAAC,OAAO;gBACpB,oBAAC,IAAI,IAAC,IAAI,QAAC,KAAK,EAAC,KAAK;;oBACb,GAAG,CACL;gBACN,KAAK,CACA,CACJ,CACP,CACM,CACV;QACD,oBAAC,SAAS,OAAK,YAAY,GAAI,CACjB,CACjB,CAAC;AACJ,CAAC"}

package/dist/commands/apply.d.ts

@@ -1 +1,13 @@
-export default function Apply(): null;
+import zod from 'zod';
+export declare const options: zod.ZodObject<{
+    force: zod.ZodBoolean;
+}, "strip", zod.ZodTypeAny, {
+    force: boolean;
+}, {
+    force: boolean;
+}>;
+type Props = {
+    options: zod.infer<typeof options>;
+};
+export default function Apply({ options }: Props): null;
+export {};

package/dist/commands/apply.js

@@ -1,20 +1,32 @@
+// commands/build.tsx
+import { useApp } from 'ink';
+import { option } from 'pastel';
 import React from 'react';
+import zod from 'zod';
 import { TemplateManager } from '../lib/templateManager.js';
-export default function Apply() {
+export const options = zod.object({
+    force: zod.boolean().describe(option({
+        description: 'Force apply of all templates, irrespective of changes',
+        alias: 'f',
+    })),
+});
+export default function Apply({ options }) {
+    const { exit } = useApp();
     React.useEffect(() => {
         async function doApply() {
             try {
                 const manager = await TemplateManager.create(process.cwd());
-                await manager.processTemplates({ apply: true });
-                process.exit(0);
+                await manager.processTemplates({ apply: true, force: options.force });
+                exit();
             }
             catch (err) {
-                console.error('Error:', err instanceof Error ? err.message : String(err));
-                process.exit(1);
+                if (err instanceof Error) {
+                    exit(err);
+                }
             }
         }
         void doApply();
-    }, []);
+    }, [exit, options]);
     return null;
 }
 //# sourceMappingURL=apply.js.map

package/dist/commands/apply.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/commands/apply.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,CAAC,OAAO,UAAU,KAAK;IAC3B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,KAAK,UAAU,OAAO;YACpB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC5D,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;IACjB,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/commands/apply.tsx"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAC3B,MAAM,CAAC;QACL,WAAW,EAAE,uDAAuD;QACpE,KAAK,EAAE,GAAG;KACX,CAAC,CACH;CACF,CAAC,CAAC;AAMH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,EAAE,OAAO,EAAS;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,KAAK,UAAU,OAAO;YACpB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC5D,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;gBACtE,IAAI,EAAE,CAAC;YACT,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,GAAG,CAAC,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commands/build.d.ts

@@ -1 +1,13 @@
-export default function Build(): null;
+import zod from 'zod';
+export declare const options: zod.ZodObject<{
+    force: zod.ZodBoolean;
+}, "strip", zod.ZodTypeAny, {
+    force: boolean;
+}, {
+    force: boolean;
+}>;
+type Props = {
+    options: zod.infer<typeof options>;
+};
+export default function Build({ options }: Props): null;
+export {};

package/dist/commands/build.js

@@ -1,15 +1,25 @@
 // commands/build.tsx
+import { useApp } from 'ink';
+import { option } from 'pastel';
 import React from 'react';
+import zod from 'zod';
 import { TemplateManager } from '../lib/templateManager.js';
-export default function Build() {
+export const options = zod.object({
+    force: zod.boolean().describe(option({
+        description: 'Force building of all templates, irrespective of changes',
+        alias: 'f',
+    })),
+});
+export default function Build({ options }) {
+    const { exit } = useApp();
     React.useEffect(() => {
         async function doBuild() {
             const manager = await TemplateManager.create(process.cwd());
-            await manager.processTemplates({ generateFiles: true });
-            process.exit(0);
+            await manager.processTemplates({ generateFiles: true, force: options.force });
+            exit();
         }
         doBuild();
-    }, []);
+    }, [options, exit]);
     return null;
 }
 //# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.tsx"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,CAAC,OAAO,UAAU,KAAK;IAC3B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,KAAK,UAAU,OAAO;YACpB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5D,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.tsx"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAC3B,MAAM,CAAC;QACL,WAAW,EAAE,0DAA0D;QACvE,KAAK,EAAE,GAAG;KACX,CAAC,CACH;CACF,CAAC,CAAC;AAMH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,EAAE,OAAO,EAAS;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,KAAK,UAAU,OAAO;YACpB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5D,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9E,IAAI,EAAE,CAAC;QACT,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAEpB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commands/index.js

@@ -1,37 +1,47 @@
-import { Select } from '@inkjs/ui';
-import { Box } from 'ink';
+// commands/index.tsx
+import { Select, Spinner } from '@inkjs/ui';
+import { Box, Text } from 'ink';
 import React from 'react';
 import Branding from '../components/Branding.js';
+import Quittable from '../components/Quittable.js';
+import { useDatabaseConnection } from '../hooks/useDatabaseConnection.js';
 import Apply from './apply.js';
 import Build from './build.js';
 import Register from './register.js';
 import Watch from './watch.js';
 export default function UI() {
+    const { error, isChecking, isConnected } = useDatabaseConnection();
     const [selectedCommand, setSelectedCommand] = React.useState(null);
-    // For now, we only demonstrate navigation to "register"
+    const handleOnChange = async (value) => {
+        setSelectedCommand(value);
+    };
     if (selectedCommand === 'register') {
         return React.createElement(Register, { args: undefined });
     }
     if (selectedCommand === 'apply') {
-        return React.createElement(Apply, null);
+        return React.createElement(Apply, { options: { force: false } });
     }
     if (selectedCommand === 'build') {
-        return React.createElement(Build, null);
+        return React.createElement(Build, { options: { force: false } });
     }
     if (selectedCommand === 'watch') {
         return React.createElement(Watch, null);
     }
     const menuItems = [
-        { label: '🏗️  build - Build Supabase migrations from templates', value: 'build' },
-        { label: '▶️  apply - Apply migration templates directly to database', value: 'apply' },
-        { label: '✍️  register - Register templates as already built', value: 'register' },
+        { label: '🏗️ build - Build Supabase migrations from templates', value: 'build' },
+        { label: '▶️ apply - Apply migration templates directly to database', value: 'apply' },
+        { label: '✍️ register - Register templates as already built', value: 'register' },
         {
-            label: '👀  watch - Watch templates for changes and apply directly to database',
+            label: '👀 watch - Watch templates for changes and apply directly to database',
             value: 'watch',
         },
     ];
     return (React.createElement(Box, { flexDirection: "column" },
         React.createElement(Branding, null),
-        React.createElement(Select, { options: menuItems, onChange: value => setSelectedCommand(value) })));
+        error ? (React.createElement(Box, { gap: 1 },
+            React.createElement(Text, { color: "red", bold: true }, "Error"),
+            React.createElement(Text, null, "Check your database connection and try again."))) : (React.createElement(Select, { options: menuItems, isDisabled: !isConnected, onChange: handleOnChange })),
+        isChecking ? (React.createElement(Box, { marginTop: 1 },
+            React.createElement(Spinner, { label: "Checking database connection..." }))) : (React.createElement(Quittable, null))));
 }
 //# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,CAAC,OAAO,UAAU,EAAE;IACxB,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAElF,wDAAwD;IACxD,IAAI,eAAe,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,oBAAC,QAAQ,IAAC,IAAI,EAAE,SAAS,GAAI,CAAC;IACvC,CAAC;IAED,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,oBAAC,KAAK,OAAG,CAAC;IACnB,CAAC;IAED,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,oBAAC,KAAK,OAAG,CAAC;IACnB,CAAC;IAED,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,oBAAC,KAAK,OAAG,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG;QAChB,EAAE,KAAK,EAAE,uDAAuD,EAAE,KAAK,EAAE,OAAO,EAAE;QAClF,EAAE,KAAK,EAAE,4DAA4D,EAAE,KAAK,EAAE,OAAO,EAAE;QACvF,EAAE,KAAK,EAAE,oDAAoD,EAAE,KAAK,EAAE,UAAU,EAAE;QAClF;YACE,KAAK,EAAE,wEAAwE;YAC/E,KAAK,EAAE,OAAO;SACf;KACF,CAAC;IAEF,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;QACzB,oBAAC,QAAQ,OAAG;QACZ,oBAAC,MAAM,IAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAI,CACxE,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.tsx"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,SAAS,MAAM,4BAA4B,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,CAAC,OAAO,UAAU,EAAE;IACxB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACnE,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAElF,MAAM,cAAc,GAAG,KAAK,EAAE,KAAa,EAAE,EAAE;QAC7C,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,IAAI,eAAe,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,oBAAC,QAAQ,IAAC,IAAI,EAAE,SAAS,GAAI,CAAC;IACvC,CAAC;IAED,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,oBAAC,KAAK,IAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAI,CAAC;IAC9C,CAAC;IAED,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,oBAAC,KAAK,IAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAI,CAAC;IAC9C,CAAC;IAED,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,oBAAC,KAAK,OAAG,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG;QAChB,EAAE,KAAK,EAAE,sDAAsD,EAAE,KAAK,EAAE,OAAO,EAAE;QACjF,EAAE,KAAK,EAAE,2DAA2D,EAAE,KAAK,EAAE,OAAO,EAAE;QACtF,EAAE,KAAK,EAAE,mDAAmD,EAAE,KAAK,EAAE,UAAU,EAAE;QACjF;YACE,KAAK,EAAE,uEAAuE;YAC9E,KAAK,EAAE,OAAO;SACf;KACF,CAAC;IAEF,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;QACzB,oBAAC,QAAQ,OAAG;QACX,KAAK,CAAC,CAAC,CAAC,CACP,oBAAC,GAAG,IAAC,GAAG,EAAE,CAAC;YACT,oBAAC,IAAI,IAAC,KAAK,EAAC,KAAK,EAAC,IAAI,kBAEf;YACP,oBAAC,IAAI,wDAAqD,CACtD,CACP,CAAC,CAAC,CAAC,CACF,oBAAC,MAAM,IAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAI,CACnF;QAEA,UAAU,CAAC,CAAC,CAAC,CACZ,oBAAC,GAAG,IAAC,SAAS,EAAE,CAAC;YACf,oBAAC,OAAO,IAAC,KAAK,EAAC,iCAAiC,GAAG,CAC/C,CACP,CAAC,CAAC,CAAC,CACF,oBAAC,SAAS,OAAG,CACd,CACG,CACP,CAAC;AACJ,CAAC"}