reqon-dsl 0.2.0 → 0.3.0

package/docusaurus/docs/stores/postgrest.md

@@ -1,316 +0,0 @@
----
-sidebar_position: 4
----
-
-# PostgREST Store
-
-The PostgREST store adapter connects to PostgreSQL via PostgREST or Supabase, enabling production-ready SQL storage.
-
-## Configuration
-
-### Mission File
-
-```vague
-store items: sql("items")
-store users: sql("users")
-```
-
-### Store Configuration
-
-Create `stores.json`:
-
-```json
-{
-  "sql": {
-    "type": "postgrest",
-    "url": "https://your-project.supabase.co/rest/v1",
-    "apiKey": "your-anon-key"
-  }
-}
-```
-
-Run with:
-
-```bash
-reqon mission.vague --store-config ./stores.json
-```
-
-## Supabase Setup
-
-### 1. Create Supabase Project
-
-1. Go to [supabase.com](https://supabase.com)
-2. Create a new project
-3. Note your project URL and anon key
-
-### 2. Create Tables
-
-```sql
-CREATE TABLE items (
-  id TEXT PRIMARY KEY,
-  data JSONB NOT NULL,
-  created_at TIMESTAMPTZ DEFAULT NOW(),
-  updated_at TIMESTAMPTZ DEFAULT NOW()
-);
-
-CREATE TABLE users (
-  id TEXT PRIMARY KEY,
-  email TEXT UNIQUE NOT NULL,
-  name TEXT,
-  metadata JSONB,
-  created_at TIMESTAMPTZ DEFAULT NOW()
-);
-```
-
-### 3. Configure Reqon
-
-```json
-{
-  "sql": {
-    "type": "postgrest",
-    "url": "https://abc123.supabase.co/rest/v1",
-    "apiKey": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
-  }
-}
-```
-
-## Self-Hosted PostgREST
-
-### Docker Setup
-
-```yaml
-# docker-compose.yml
-version: '3'
-services:
-  db:
-    image: postgres:15
-    environment:
-      POSTGRES_PASSWORD: secret
-    volumes:
-      - pgdata:/var/lib/postgresql/data
-
-  postgrest:
-    image: postgrest/postgrest
-    environment:
-      PGRST_DB_URI: postgres://postgres:secret@db:5432/postgres
-      PGRST_DB_ANON_ROLE: anon
-    ports:
-      - "3000:3000"
-
-volumes:
-  pgdata:
-```
-
-### Configuration
-
-```json
-{
-  "sql": {
-    "type": "postgrest",
-    "url": "http://localhost:3000"
-  }
-}
-```
-
-## Operations
-
-### Write
-
-```vague
-// Insert
-store response -> items { key: .id }
-
-// Upsert
-store response -> items { key: .id, upsert: true }
-
-// Partial update
-store response -> items { key: .id, partial: true }
-```
-
-### Read
-
-```vague
-for item in items { }
-for item in items where .status == "active" { }
-```
-
-### Delete
-
-```vague
-delete items[item.id]
-```
-
-## Query Mapping
-
-Reqon where clauses map to PostgREST queries:
-
-| Reqon | PostgREST |
-|-------|-----------|
-| `.field == "value"` | `?field=eq.value` |
-| `.field != "value"` | `?field=neq.value` |
-| `.field > 10` | `?field=gt.10` |
-| `.field >= 10` | `?field=gte.10` |
-| `.field < 10` | `?field=lt.10` |
-| `.field <= 10` | `?field=lte.10` |
-
-## Authentication
-
-### Anon Key
-
-```json
-{
-  "sql": {
-    "type": "postgrest",
-    "url": "https://abc.supabase.co/rest/v1",
-    "apiKey": "anon-key"
-  }
-}
-```
-
-### Service Role Key
-
-For full access:
-
-```json
-{
-  "sql": {
-    "type": "postgrest",
-    "url": "https://abc.supabase.co/rest/v1",
-    "apiKey": "service-role-key"
-  }
-}
-```
-
-### Row Level Security
-
-With RLS enabled:
-
-```json
-{
-  "sql": {
-    "type": "postgrest",
-    "url": "https://abc.supabase.co/rest/v1",
-    "apiKey": "anon-key",
-    "headers": {
-      "Authorization": "Bearer user-jwt"
-    }
-  }
-}
-```
-
-## Best Practices
-
-### Table Design
-
-```sql
-CREATE TABLE items (
-  -- Use text ID for compatibility
-  id TEXT PRIMARY KEY,
-
-  -- Store full record as JSONB
-  data JSONB NOT NULL,
-
-  -- Add common query fields
-  status TEXT,
-  created_at TIMESTAMPTZ DEFAULT NOW(),
-  updated_at TIMESTAMPTZ DEFAULT NOW()
-);
-
--- Index common queries
-CREATE INDEX items_status_idx ON items(status);
-CREATE INDEX items_created_idx ON items(created_at);
-```
-
-### Upsert with Timestamps
-
-```sql
--- Add trigger for updated_at
-CREATE OR REPLACE FUNCTION update_updated_at()
-RETURNS TRIGGER AS $$
-BEGIN
-  NEW.updated_at = NOW();
-  RETURN NEW;
-END;
-$$ LANGUAGE plpgsql;
-
-CREATE TRIGGER items_updated
-  BEFORE UPDATE ON items
-  FOR EACH ROW
-  EXECUTE FUNCTION update_updated_at();
-```
-
-### Connection Pooling
-
-For high-volume usage:
-
-```json
-{
-  "sql": {
-    "type": "postgrest",
-    "url": "https://abc.supabase.co/rest/v1",
-    "apiKey": "...",
-    "poolSize": 10
-  }
-}
-```
-
-## Error Handling
-
-```vague
-action SafeStore {
-  get "/items"
-
-  for item in response.items {
-    match {
-      _ where true -> {
-        store item -> items { key: .id }
-      }
-    } catch {
-      { code: 23505 } -> skip,  // Unique violation
-      { code: 23503 } -> skip,  // Foreign key violation
-      _ -> queue errors { item: { id: item.id, error: "Store failed" } }
-    }
-  }
-}
-```
-
-## Monitoring
-
-### Query Logs
-
-Enable in Supabase Dashboard or PostgREST config.
-
-### Performance
-
-```sql
--- Check slow queries
-SELECT * FROM pg_stat_statements
-ORDER BY total_time DESC
-LIMIT 10;
-```
-
-## Troubleshooting
-
-### "Relation does not exist"
-
-Table hasn't been created:
-
-```sql
-CREATE TABLE your_table (...);
-```
-
-### "Permission denied"
-
-Check RLS policies:
-
-```sql
-CREATE POLICY "Allow all" ON items FOR ALL USING (true);
-```
-
-### Connection Issues
-
-Verify URL and credentials:
-
-```bash
-curl -H "apikey: your-key" https://abc.supabase.co/rest/v1/items
-```

package/docusaurus/docusaurus.config.ts

@@ -1,148 +0,0 @@
-import {themes as prismThemes} from 'prism-react-renderer';
-import type {Config} from '@docusaurus/types';
-import type * as Preset from '@docusaurus/preset-classic';
-
-const config: Config = {
-  title: 'Reqon',
-  tagline: 'Declarative DSL for fetch, map, validate pipelines',
-  favicon: 'img/favicon.ico',
-
-  future: {
-    v4: true,
-  },
-
-  url: 'https://reqon.dev',
-  baseUrl: '/',
-
-  organizationName: 'mcclowes',
-  projectName: 'reqon',
-
-  onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'warn',
-
-  i18n: {
-    defaultLocale: 'en',
-    locales: ['en'],
-  },
-
-  presets: [
-    [
-      'classic',
-      {
-        docs: {
-          sidebarPath: './sidebars.ts',
-          editUrl: 'https://github.com/mcclowes/reqon/tree/main/docusaurus/',
-          routeBasePath: 'docs',
-        },
-        blog: false,
-        theme: {
-          customCss: './src/css/custom.css',
-        },
-      } satisfies Preset.Options,
-    ],
-  ],
-
-  themeConfig: {
-    image: 'img/reqon-social-card.png',
-    colorMode: {
-      defaultMode: 'light',
-      respectPrefersColorScheme: true,
-    },
-    navbar: {
-      title: 'Reqon',
-      logo: {
-        alt: 'Reqon Logo',
-        src: 'img/logo.svg',
-      },
-      items: [
-        {
-          type: 'docSidebar',
-          sidebarId: 'docsSidebar',
-          position: 'left',
-          label: 'Documentation',
-        },
-        {
-          to: '/docs/examples',
-          label: 'Examples',
-          position: 'left',
-        },
-        {
-          to: '/docs/api-reference',
-          label: 'API',
-          position: 'left',
-        },
-        {
-          href: 'https://github.com/mcclowes/vague',
-          label: 'Vague DSL',
-          position: 'right',
-        },
-        {
-          href: 'https://github.com/mcclowes/reqon',
-          label: 'GitHub',
-          position: 'right',
-        },
-      ],
-    },
-    footer: {
-      style: 'dark',
-      links: [
-        {
-          title: 'Learn',
-          items: [
-            {
-              label: 'Getting Started',
-              to: '/docs/getting-started',
-            },
-            {
-              label: 'Core Concepts',
-              to: '/docs/category/core-concepts',
-            },
-            {
-              label: 'Examples',
-              to: '/docs/examples',
-            },
-          ],
-        },
-        {
-          title: 'Reference',
-          items: [
-            {
-              label: 'DSL Syntax',
-              to: '/docs/category/dsl-syntax',
-            },
-            {
-              label: 'API Reference',
-              to: '/docs/api-reference',
-            },
-            {
-              label: 'CLI',
-              to: '/docs/cli',
-            },
-          ],
-        },
-        {
-          title: 'More',
-          items: [
-            {
-              label: 'GitHub',
-              href: 'https://github.com/mcclowes/reqon',
-            },
-            {
-              label: 'Vague DSL',
-              href: 'https://github.com/mcclowes/vague',
-            },
-          ],
-        },
-      ],
-      copyright: `Copyright © ${new Date().getFullYear()} Reqon. Built with Docusaurus.`,
-    },
-    prism: {
-      theme: prismThemes.github,
-      darkTheme: prismThemes.dracula,
-      additionalLanguages: ['bash', 'json', 'yaml'],
-    },
-    algolia: undefined,
-  } satisfies Preset.ThemeConfig,
-};
-
-export default config;