reqon-dsl 0.2.0

package/docusaurus/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "docusaurus",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "docusaurus": "docusaurus",
+    "start": "docusaurus start",
+    "build": "docusaurus build",
+    "swizzle": "docusaurus swizzle",
+    "deploy": "docusaurus deploy",
+    "clear": "docusaurus clear",
+    "serve": "docusaurus serve",
+    "write-translations": "docusaurus write-translations",
+    "write-heading-ids": "docusaurus write-heading-ids",
+    "typecheck": "tsc"
+  },
+  "dependencies": {
+    "@docusaurus/core": "3.9.2",
+    "@docusaurus/preset-classic": "3.9.2",
+    "@mdx-js/react": "^3.0.0",
+    "clsx": "^2.0.0",
+    "prism-react-renderer": "^2.3.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@docusaurus/module-type-aliases": "3.9.2",
+    "@docusaurus/tsconfig": "3.9.2",
+    "@docusaurus/types": "3.9.2",
+    "typescript": "~5.6.2"
+  },
+  "browserslist": {
+    "production": [
+      ">0.5%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 3 chrome version",
+      "last 3 firefox version",
+      "last 5 safari version"
+    ]
+  },
+  "engines": {
+    "node": ">=20.0"
+  }
+}

package/docusaurus/sidebars.ts

@@ -0,0 +1,155 @@
+import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
+
+const sidebars: SidebarsConfig = {
+  docsSidebar: [
+    'intro',
+    'getting-started',
+    'cli',
+    {
+      type: 'category',
+      label: 'Core Concepts',
+      link: {
+        type: 'generated-index',
+        title: 'Core Concepts',
+        description: 'Learn about the fundamental building blocks of Reqon',
+      },
+      items: [
+        'core-concepts/missions',
+        'core-concepts/actions',
+        'core-concepts/sources',
+        'core-concepts/stores',
+        'core-concepts/schemas',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'DSL Syntax',
+      link: {
+        type: 'generated-index',
+        title: 'DSL Syntax Reference',
+        description: 'Complete reference for Reqon DSL syntax',
+      },
+      items: [
+        'dsl-syntax/fetch',
+        'dsl-syntax/for-loops',
+        'dsl-syntax/map',
+        'dsl-syntax/validate',
+        'dsl-syntax/match',
+        'dsl-syntax/pipelines',
+        'dsl-syntax/expressions',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'HTTP & Fetching',
+      link: {
+        type: 'generated-index',
+        title: 'HTTP & Fetching',
+        description: 'Learn about HTTP requests, pagination, and retry strategies',
+      },
+      items: [
+        'http/requests',
+        'http/pagination',
+        'http/retry',
+        'http/incremental-sync',
+        'http/rate-limiting',
+        'http/circuit-breaker',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Authentication',
+      link: {
+        type: 'generated-index',
+        title: 'Authentication',
+        description: 'Configure authentication for API sources',
+      },
+      items: [
+        'authentication/overview',
+        'authentication/oauth2',
+        'authentication/bearer',
+        'authentication/api-key',
+        'authentication/basic',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Error Handling',
+      link: {
+        type: 'generated-index',
+        title: 'Error Handling',
+        description: 'Handle errors with flow control directives',
+      },
+      items: [
+        'error-handling/flow-control',
+        'error-handling/retry-strategies',
+        'error-handling/dead-letter-queues',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Store Adapters',
+      link: {
+        type: 'generated-index',
+        title: 'Store Adapters',
+        description: 'Persist data to various backends',
+      },
+      items: [
+        'stores/overview',
+        'stores/memory',
+        'stores/file',
+        'stores/postgrest',
+        'stores/custom-adapters',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'OpenAPI Integration',
+      link: {
+        type: 'generated-index',
+        title: 'OpenAPI Integration',
+        description: 'Use OpenAPI specs for type-safe API calls',
+      },
+      items: [
+        'openapi/overview',
+        'openapi/loading-specs',
+        'openapi/operation-calls',
+        'openapi/response-validation',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Scheduling',
+      link: {
+        type: 'generated-index',
+        title: 'Scheduling',
+        description: 'Schedule missions to run automatically',
+      },
+      items: [
+        'scheduling/overview',
+        'scheduling/cron',
+        'scheduling/intervals',
+        'scheduling/daemon-mode',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Advanced Topics',
+      link: {
+        type: 'generated-index',
+        title: 'Advanced Topics',
+        description: 'Deep dive into advanced Reqon features',
+      },
+      items: [
+        'advanced/multi-file-missions',
+        'advanced/execution-state',
+        'advanced/parallel-execution',
+        'advanced/extending-reqon',
+      ],
+    },
+    'examples',
+    'api-reference',
+  ],
+};
+
+export default sidebars;

package/docusaurus/src/components/HomepageFeatures/index.tsx

@@ -0,0 +1,105 @@
+import type {ReactNode} from 'react';
+import clsx from 'clsx';
+import Heading from '@theme/Heading';
+import styles from './styles.module.css';
+
+type FeatureItem = {
+  title: string;
+  icon: string;
+  description: ReactNode;
+};
+
+const FeatureList: FeatureItem[] = [
+  {
+    title: 'Declarative Syntax',
+    icon: '📝',
+    description: (
+      <>
+        Write clean, readable pipelines that describe what you want, not how to do it.
+        Reqon handles pagination, retries, and error handling automatically.
+      </>
+    ),
+  },
+  {
+    title: 'Built-in Best Practices',
+    icon: '⚡',
+    description: (
+      <>
+        Automatic pagination, exponential backoff, rate limiting, circuit breakers,
+        and incremental sync are all built in. No boilerplate required.
+      </>
+    ),
+  },
+  {
+    title: 'Multiple Auth Methods',
+    icon: '🔐',
+    description: (
+      <>
+        Support for OAuth 2.0, Bearer tokens, API keys, and Basic auth.
+        Automatic token refresh for OAuth flows.
+      </>
+    ),
+  },
+  {
+    title: 'OpenAPI Integration',
+    icon: '📋',
+    description: (
+      <>
+        Load OpenAPI specs for type-safe API calls. Validate responses against
+        schema definitions automatically.
+      </>
+    ),
+  },
+  {
+    title: 'Flexible Storage',
+    icon: '💾',
+    description: (
+      <>
+        Store data in memory, files, SQL (via PostgREST/Supabase), or NoSQL.
+        Create custom adapters for any backend.
+      </>
+    ),
+  },
+  {
+    title: 'Production Ready',
+    icon: '🚀',
+    description: (
+      <>
+        Built-in scheduling with cron and intervals. Run as a daemon with
+        health checks, metrics, and graceful shutdown.
+      </>
+    ),
+  },
+];
+
+function Feature({title, icon, description}: FeatureItem) {
+  return (
+    <div className={clsx('col col--4')}>
+      <div className="text--center padding-horiz--md">
+        <div className={styles.featureIcon}>{icon}</div>
+        <Heading as="h3">{title}</Heading>
+        <p>{description}</p>
+      </div>
+    </div>
+  );
+}
+
+export default function HomepageFeatures(): ReactNode {
+  return (
+    <section className={styles.features}>
+      <div className="container">
+        <div className="text--center margin-bottom--xl">
+          <Heading as="h2">Why Reqon?</Heading>
+          <p className="hero__subtitle">
+            Stop writing boilerplate. Start building data pipelines.
+          </p>
+        </div>
+        <div className="row">
+          {FeatureList.map((props, idx) => (
+            <Feature key={idx} {...props} />
+          ))}
+        </div>
+      </div>
+    </section>
+  );
+}

package/docusaurus/src/components/HomepageFeatures/styles.module.css

@@ -0,0 +1,12 @@
+.features {
+  display: flex;
+  align-items: center;
+  padding: 4rem 0;
+  width: 100%;
+  background-color: var(--ifm-background-surface-color);
+}
+
+.featureIcon {
+  font-size: 3rem;
+  margin-bottom: 1rem;
+}

package/docusaurus/src/css/custom.css

@@ -0,0 +1,169 @@
+/**
+ * Reqon Documentation Theme
+ * Based on a modern purple/violet color palette
+ */
+
+:root {
+  --ifm-color-primary: #6366f1;
+  --ifm-color-primary-dark: #4f46e5;
+  --ifm-color-primary-darker: #4338ca;
+  --ifm-color-primary-darkest: #3730a3;
+  --ifm-color-primary-light: #818cf8;
+  --ifm-color-primary-lighter: #a5b4fc;
+  --ifm-color-primary-lightest: #c7d2fe;
+
+  --ifm-code-font-size: 95%;
+  --ifm-font-family-base: 'Inter', system-ui, -apple-system, sans-serif;
+  --ifm-font-family-monospace: 'JetBrains Mono', 'Fira Code', 'Consolas', monospace;
+
+  --docusaurus-highlighted-code-line-bg: rgba(99, 102, 241, 0.1);
+
+  --ifm-heading-font-weight: 600;
+  --ifm-navbar-shadow: 0 1px 2px rgba(0, 0, 0, 0.05);
+}
+
+[data-theme='dark'] {
+  --ifm-color-primary: #818cf8;
+  --ifm-color-primary-dark: #6366f1;
+  --ifm-color-primary-darker: #4f46e5;
+  --ifm-color-primary-darkest: #4338ca;
+  --ifm-color-primary-light: #a5b4fc;
+  --ifm-color-primary-lighter: #c7d2fe;
+  --ifm-color-primary-lightest: #e0e7ff;
+
+  --docusaurus-highlighted-code-line-bg: rgba(129, 140, 248, 0.2);
+  --ifm-background-color: #0f172a;
+  --ifm-background-surface-color: #1e293b;
+}
+
+/* Code blocks */
+.prism-code {
+  border-radius: 8px;
+}
+
+code {
+  border-radius: 4px;
+  padding: 2px 6px;
+}
+
+/* Navbar styling */
+.navbar {
+  backdrop-filter: blur(8px);
+}
+
+.navbar__title {
+  font-weight: 700;
+}
+
+/* Hero section on homepage */
+.hero {
+  background: linear-gradient(135deg, var(--ifm-color-primary-lightest) 0%, var(--ifm-background-color) 100%);
+}
+
+[data-theme='dark'] .hero {
+  background: linear-gradient(135deg, var(--ifm-color-primary-darkest) 0%, var(--ifm-background-color) 100%);
+}
+
+/* Sidebar improvements */
+.menu__link {
+  border-radius: 6px;
+  transition: all 0.15s ease;
+}
+
+.menu__link:hover {
+  background-color: var(--ifm-color-primary-lightest);
+}
+
+[data-theme='dark'] .menu__link:hover {
+  background-color: rgba(129, 140, 248, 0.1);
+}
+
+.menu__link--active {
+  font-weight: 600;
+}
+
+/* Card styling for category indexes */
+.card {
+  border-radius: 12px;
+  border: 1px solid var(--ifm-color-emphasis-200);
+  transition: all 0.2s ease;
+}
+
+.card:hover {
+  border-color: var(--ifm-color-primary);
+  box-shadow: 0 4px 12px rgba(99, 102, 241, 0.1);
+}
+
+/* Tables */
+table {
+  border-radius: 8px;
+  overflow: hidden;
+}
+
+th {
+  background-color: var(--ifm-color-emphasis-100);
+}
+
+/* Admonitions */
+.admonition {
+  border-radius: 8px;
+}
+
+/* Footer */
+.footer {
+  background-color: var(--ifm-background-surface-color);
+}
+
+/* Custom syntax highlighting for Reqon DSL */
+.token.keyword {
+  color: var(--ifm-color-primary);
+  font-weight: 500;
+}
+
+/* Feature cards on homepage */
+.feature-card {
+  background: var(--ifm-background-surface-color);
+  border-radius: 12px;
+  padding: 1.5rem;
+  border: 1px solid var(--ifm-color-emphasis-200);
+  transition: all 0.2s ease;
+}
+
+.feature-card:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.1);
+}
+
+/* TOC styling */
+.table-of-contents__link:hover {
+  color: var(--ifm-color-primary);
+}
+
+.table-of-contents__link--active {
+  color: var(--ifm-color-primary);
+  font-weight: 500;
+}
+
+/* Breadcrumbs */
+.breadcrumbs__link {
+  border-radius: 4px;
+}
+
+/* Scrollbar styling */
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+::-webkit-scrollbar-thumb {
+  background: var(--ifm-color-emphasis-300);
+  border-radius: 4px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: var(--ifm-color-emphasis-400);
+}

package/docusaurus/src/pages/index.module.css

@@ -0,0 +1,48 @@
+.heroBanner {
+  padding: 4rem 0;
+  text-align: center;
+  position: relative;
+  overflow: hidden;
+}
+
+@media screen and (max-width: 996px) {
+  .heroBanner {
+    padding: 2rem;
+  }
+}
+
+.buttons {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+  flex-wrap: wrap;
+}
+
+.codeExample {
+  padding: 4rem 0;
+  background-color: var(--ifm-background-color);
+}
+
+.codeExample h2 {
+  margin-bottom: 1rem;
+}
+
+.codeExample ul {
+  margin: 1.5rem 0;
+  padding-left: 1.5rem;
+}
+
+.codeExample li {
+  margin-bottom: 0.5rem;
+}
+
+@media screen and (max-width: 996px) {
+  .codeExample .row {
+    flex-direction: column-reverse;
+  }
+
+  .codeExample .col {
+    margin-bottom: 2rem;
+  }
+}

package/docusaurus/src/pages/index.tsx

@@ -0,0 +1,110 @@
+import type {ReactNode} from 'react';
+import clsx from 'clsx';
+import Link from '@docusaurus/Link';
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+import Layout from '@theme/Layout';
+import HomepageFeatures from '@site/src/components/HomepageFeatures';
+import Heading from '@theme/Heading';
+import CodeBlock from '@theme/CodeBlock';
+
+import styles from './index.module.css';
+
+const exampleCode = `mission SyncCustomers {
+  source API { auth: bearer, base: "https://api.example.com" }
+  store customers: file("customers")
+
+  action Fetch {
+    get "/customers" {
+      paginate: offset(page, 100),
+      until: length(response) == 0,
+      since: lastSync
+    }
+
+    for customer in response {
+      map customer -> Customer {
+        id: .id,
+        name: .name,
+        email: lowercase(.email)
+      }
+      store customer -> customers { key: .id, upsert: true }
+    }
+  }
+
+  run Fetch
+}`;
+
+function HomepageHeader() {
+  const {siteConfig} = useDocusaurusContext();
+  return (
+    <header className={clsx('hero hero--primary', styles.heroBanner)}>
+      <div className="container">
+        <Heading as="h1" className="hero__title">
+          {siteConfig.title}
+        </Heading>
+        <p className="hero__subtitle">{siteConfig.tagline}</p>
+        <div className={styles.buttons}>
+          <Link
+            className="button button--secondary button--lg"
+            to="/docs/">
+            Get Started
+          </Link>
+          <Link
+            className="button button--outline button--lg"
+            style={{marginLeft: '1rem', color: 'white', borderColor: 'white'}}
+            to="/docs/examples">
+            View Examples
+          </Link>
+        </div>
+      </div>
+    </header>
+  );
+}
+
+function CodeExample() {
+  return (
+    <section className={styles.codeExample}>
+      <div className="container">
+        <div className="row">
+          <div className="col col--6">
+            <Heading as="h2">Declarative Data Pipelines</Heading>
+            <p>
+              Define what you want to happen, not how. Reqon handles pagination,
+              retries, rate limiting, and error handling automatically.
+            </p>
+            <ul>
+              <li>Automatic pagination with offset, page, or cursor strategies</li>
+              <li>Built-in retry with exponential backoff</li>
+              <li>Incremental sync with checkpoint tracking</li>
+              <li>Pattern matching for error handling</li>
+            </ul>
+            <Link
+              className="button button--primary button--lg"
+              to="/docs/getting-started">
+              Learn the Syntax
+            </Link>
+          </div>
+          <div className="col col--6">
+            <CodeBlock language="typescript" title="sync.vague">
+              {exampleCode}
+            </CodeBlock>
+          </div>
+        </div>
+      </div>
+    </section>
+  );
+}
+
+export default function Home(): ReactNode {
+  const {siteConfig} = useDocusaurusContext();
+  return (
+    <Layout
+      title="Declarative DSL for Data Pipelines"
+      description="Reqon is a declarative DSL framework for fetch, map, validate pipelines. Build robust data synchronization with clean, readable syntax.">
+      <HomepageHeader />
+      <main>
+        <HomepageFeatures />
+        <CodeExample />
+      </main>
+    </Layout>
+  );
+}

package/docusaurus/src/pages/markdown-page.md

@@ -0,0 +1,7 @@
+---
+title: Markdown page example
+---
+
+# Markdown page example
+
+You don't need React to write simple standalone pages.

package/docusaurus/static/img/logo.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100">
+  <defs>
+    <linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366f1;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#818cf8;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  <rect x="10" y="10" width="80" height="80" rx="16" fill="url(#grad)"/>
+  <text x="50" y="68" font-family="system-ui, -apple-system, sans-serif" font-size="48" font-weight="700" fill="white" text-anchor="middle">R</text>
+</svg>