Close the DDL gap in SQL: the 'ALTER' path of the parser now completed

Author: ox-harris

README.md

@@ -83,7 +83,7 @@ The big picture? **[SQL, reimagined for modern apps ↗](https://linked-ql.netli
 
 > [!IMPORTANT]
 > LinkedQL is backed by **1,000+ tests and growing**, with strong coverage across **FlashQL, live queries, edge transport, federation, WAL, sync, and parser/engine behavior**.<br>
-> The main areas still being expanded are **broader DDL parity, migrations, and deeper driver hardening across environments**.
+> The main areas still being expanded are **broader dialect parity, migrations, and deeper driver hardening across environments**.
 
 ---
 
@@ -1019,26 +1019,19 @@ Moving on to the goal of not just a local database but one that can mirror remot
 First, we create a local "namespace" – more traditionally called a "schema" – that contains the tables we'll use to mirror remote tables.
 
 ```js
-await db.storageEngine.transaction(async (tx) => {
-
-  await tx.createNamespace({
-    name: 'remote',
-
-    // Logical name of the remote system
-    replication_origin: 'primary', // The value passed to onCreateForeignClient()
-
-    // Indicates how to reach it (via EdgeClient)
-    replication_origin_type: 'edge',
-  });
-
-});
+await db.query(`
+  CREATE SCHEMA remote
+  WITH (
+    replication_origin = 'primary',
+    replication_origin_type = 'edge'
+  )
+`);
 ```
 
 ---
 
 ##### Decoding the above
 
-* The programmatic `tx.createNamespace()` call above is equivalent to `db.query('CREATE SCHEMA remote')`, but it lets us add the concept of **foreign origin**
 * `remote` is a **real local namespace (schema)** that can have tables and views (`VIEWS`) just like a regular namespace
 * The difference is what happens when you create a view inside it: those views will automatically resolve from the remote origin instead of the local database
 
@@ -1079,20 +1072,10 @@ We demonstrate each mode below.
 ##### Mode 1: Origin Views (Pure Federation)
 
 ```js
-await db.storageEngine.transaction(async (tx) => {
-
-  await tx.createView({
-    // Define under the local namespace called "remote"
-    namespace: 'remote',
-    name: 'users',
-
-    persistence: 'origin',
-
-    // Refers to public.users in the remote DB
-    view_spec: { namespace: 'public', name: 'users' },
-  });
-
-});
+await db.query(`
+  CREATE ORIGIN VIEW remote.users AS
+  SELECT * FROM public.users
+`);
 ```
 
 ---
@@ -1114,20 +1097,10 @@ This is the lightest-weight mode. It gives you unification without local storage
 ##### Mode 2: Materialized Views (Local Cache)
 
 ```js
-await db.storageEngine.transaction(async (tx) => {
-
-  await tx.createView({
-    // Define under the local namespace called "remote"
-    namespace: 'remote',
-    name: 'orders',
-
-    persistence: 'materialized',
-
-    // Refers to public.orders in the remote DB
-    view_spec: { namespace: 'public', name: 'orders' },
-  });
-
-});
+await db.query(`
+  CREATE MATERIALIZED VIEW remote.orders AS
+  SELECT * FROM public.orders
+`);
 ```
 
 ---
@@ -1153,20 +1126,12 @@ This is the mode to reach for when:
 ##### Mode 3: Realtime Views (Live Mirror)
 
 ```js
-await db.storageEngine.transaction(async (tx) => {
-
-  await tx.createView({
-    // Define under the local namespace called "remote"
-    namespace: 'remote',
-    name: 'posts',
-
-    persistence: 'realtime',
-
-    // Refers to public.posts in the remote DB
-    view_spec: { query: `SELECT * FROM public.posts WHERE post_type = 'NEWS'` },
-  });
-
-});
+await db.query(`
+  CREATE REALTIME VIEW remote.posts AS
+  SELECT *
+  FROM public.posts
+  WHERE post_type = 'NEWS'
+`);
 ```
 
 ---
@@ -1181,8 +1146,6 @@ This is **realtime mirroring**:
 
 > A local table that tracks and syncs with the remote table over time
 
-Notice from the above that `view_spec` for any of the modes can be any SQL query, as against just a `namespace → name` declaration.
-
 This is the richest mode:
 
 * it starts with local state
@@ -1240,6 +1203,8 @@ window.addEventListener('online', () => {
 At that point, your local database is no longer just "configured".
 It is now hydrated, subscribed where necessary, and ready to behave like a unified relational graph.
 
+> Note that the initial `db.sync.sync()` can be automatically-handled by FlashQL. Simply pass `autoSync: true` in constructor parameters.
+
 ---
 
 #### Step 5: Querying the Unified Graph

site/.vitepress/dist/404.html

@@ -6,18 +6,18 @@
     <title>404 | LinkedQL</title>
     <meta name="description" content="Not Found">
     <meta name="generator" content="VitePress v1.6.4">
-    <link rel="preload stylesheet" href="/assets/style.B7OmO4rY.css" as="style">
+    <link rel="preload stylesheet" href="/assets/style.DxeyQAKk.css" as="style">
     <link rel="preload stylesheet" href="/vp-icons.css" as="style">
 
-    <script type="module" src="/assets/app.DTyr3kCT.js"></script>
+    <script type="module" src="/assets/app.CFGO9TE3.js"></script>
     <link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
     <meta name="theme-color" content="gold">
     <script id="check-dark-mode">document.documentElement.classList.add("dark");</script>
     <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
   </head>
   <body>
     <div id="app"></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"capabilities.md\":\"5XW7Hrwb\",\"capabilities_changefeeds.md\":\"BtezjLjN\",\"capabilities_deeprefs.md\":\"D7SCP_Un\",\"capabilities_json-literals.md\":\"BDieiLDe\",\"capabilities_live-queries.md\":\"DWeHiTzS\",\"capabilities_streaming.md\":\"QgApYeWt\",\"capabilities_upsert.md\":\"C7HcciZq\",\"capabilities_version-binding.md\":\"BqZQkg34\",\"docs.md\":\"QFZYmWQj\",\"docs_query-api.md\":\"Daum4Gjm\",\"docs_setup.md\":\"iLHBWooU\",\"engineering_realtime-engine.md\":\"cGAlOLM6\",\"flashql.md\":\"D8bfmGjb\",\"flashql_foreign-io.md\":\"BqKcWz8r\",\"flashql_lang.md\":\"DK3S35m5\",\"flashql_sync.md\":\"_zCXhBd0\",\"index.md\":\"DlwrrdN6\",\"overview.md\":\"DO37abAg\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"LinkedQL\",\"description\":\"A modern take on SQL and SQL databases — with reactivity, versioning, and more.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":\"force-dark\",\"themeConfig\":{\"logo\":{\"src\":\"/img/brand/linked-ql-logo.png\",\"height\":140},\"siteTitle\":false,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/linked-db/linked-ql\"}],\"nav\":[{\"text\":\"What is LinkedQL\",\"link\":\"/overview\",\"activeMatch\":\"/overview\"},{\"text\":\"Capabilities\",\"link\":\"/capabilities\",\"activeMatch\":\"/capabilities\"},{\"text\":\"Docs\",\"link\":\"/docs\",\"activeMatch\":\"/docs\"},{\"text\":\"FlashQL\",\"link\":\"/flashql\",\"activeMatch\":\"/flashql\"},{\"text\":\"Engineering\",\"link\":\"/engineering/realtime-engine\",\"activeMatch\":\"/engineering\"},{\"text\":\"Star on GitHub\",\"link\":\"https://github.com/linked-db/linked-ql\"}],\"sidebar\":{\"/\":[{\"text\":\"Overview\",\"items\":[{\"text\":\"What is LinkedQL\",\"link\":\"/overview\"}]},{\"text\":\"Docs\",\"items\":[{\"text\":\"Getting Started\",\"link\":\"/docs\"},{\"text\":\"Dialects & Clients\",\"link\":\"/docs/setup\"},{\"text\":\"Query Interface\",\"link\":\"/docs/query-api\"}]},{\"text\":\"Capabilities\",\"items\":[{\"text\":\"Capabilities Overview\",\"link\":\"/capabilities\"},{\"text\":\"Live Queries\",\"link\":\"/capabilities/live-queries\"},{\"text\":\"Streaming\",\"link\":\"/capabilities/streaming\"},{\"text\":\"Changefeeds (WAL)\",\"link\":\"/capabilities/changefeeds\"},{\"text\":\"DeepRefs\",\"link\":\"/capabilities/deeprefs\"},{\"text\":\"JSON Literals\",\"link\":\"/capabilities/json-literals\"},{\"text\":\"UPSERT\",\"link\":\"/capabilities/upsert\"},{\"text\":\"Version Binding\",\"link\":\"/capabilities/version-binding\"}]},{\"text\":\"FlashQL\",\"items\":[{\"text\":\"FlashQL Overview\",\"link\":\"/flashql\"},{\"text\":\"Federation & Sync\",\"link\":\"/flashql/foreign-io\"},{\"text\":\"Sync\",\"link\":\"/flashql/sync\"},{\"text\":\"Language Reference\",\"link\":\"/flashql/lang\"}]},{\"text\":\"Engineering\",\"items\":[{\"text\":\"The Realtime Engine\",\"link\":\"/engineering/realtime-engine\"}]}]},\"footer\":{\"message\":\"MIT Licensed\",\"copyright\":\"© Oxford Harrison\"},\"search\":{\"provider\":\"local\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"capabilities.md\":\"F0SqD2Jn\",\"capabilities_changefeeds.md\":\"BbVKE835\",\"capabilities_deeprefs.md\":\"CEI21O9O\",\"capabilities_json-literals.md\":\"0XOfRqew\",\"capabilities_live-queries.md\":\"ELg9xpgj\",\"capabilities_streaming.md\":\"b3c0XtJ7\",\"capabilities_upsert.md\":\"Dmbzr96U\",\"capabilities_version-binding.md\":\"DcmNgFeX\",\"docs.md\":\"Bb25GAxu\",\"docs_query-api.md\":\"BxW7Asb7\",\"docs_setup.md\":\"C_FRjVi1\",\"engineering_realtime-engine.md\":\"C2aTCXTA\",\"flashql.md\":\"sgPfa8_k\",\"flashql_foreign-io.md\":\"TlXuRTa1\",\"flashql_lang.md\":\"CcCeyZpa\",\"flashql_sync.md\":\"rdQuHHEu\",\"index.md\":\"fUHeYgb-\",\"overview.md\":\"BhRo4Yxc\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"LinkedQL\",\"description\":\"A modern take on SQL and SQL databases — with reactivity, versioning, and more.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":\"force-dark\",\"themeConfig\":{\"logo\":{\"src\":\"/img/brand/linked-ql-logo.png\",\"height\":140},\"siteTitle\":false,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/linked-db/linked-ql\"}],\"nav\":[{\"text\":\"What is LinkedQL\",\"link\":\"/overview\",\"activeMatch\":\"/overview\"},{\"text\":\"Capabilities\",\"link\":\"/capabilities\",\"activeMatch\":\"/capabilities\"},{\"text\":\"Docs\",\"link\":\"/docs\",\"activeMatch\":\"/docs\"},{\"text\":\"FlashQL\",\"link\":\"/flashql\",\"activeMatch\":\"/flashql\"},{\"text\":\"Engineering\",\"link\":\"/engineering/realtime-engine\",\"activeMatch\":\"/engineering\"},{\"text\":\"Star on GitHub\",\"link\":\"https://github.com/linked-db/linked-ql\"}],\"sidebar\":{\"/\":[{\"text\":\"Overview\",\"items\":[{\"text\":\"What is LinkedQL\",\"link\":\"/overview\"}]},{\"text\":\"Docs\",\"items\":[{\"text\":\"Getting Started\",\"link\":\"/docs\"},{\"text\":\"Dialects & Clients\",\"link\":\"/docs/setup\"},{\"text\":\"Query Interface\",\"link\":\"/docs/query-api\"}]},{\"text\":\"Capabilities\",\"items\":[{\"text\":\"Capabilities Overview\",\"link\":\"/capabilities\"},{\"text\":\"Live Queries\",\"link\":\"/capabilities/live-queries\"},{\"text\":\"Streaming\",\"link\":\"/capabilities/streaming\"},{\"text\":\"Changefeeds (WAL)\",\"link\":\"/capabilities/changefeeds\"},{\"text\":\"DeepRefs\",\"link\":\"/capabilities/deeprefs\"},{\"text\":\"JSON Literals\",\"link\":\"/capabilities/json-literals\"},{\"text\":\"UPSERT\",\"link\":\"/capabilities/upsert\"},{\"text\":\"Version Binding\",\"link\":\"/capabilities/version-binding\"}]},{\"text\":\"FlashQL\",\"items\":[{\"text\":\"FlashQL Overview\",\"link\":\"/flashql\"},{\"text\":\"Federation & Sync\",\"link\":\"/flashql/foreign-io\"},{\"text\":\"Sync\",\"link\":\"/flashql/sync\"},{\"text\":\"Language Reference\",\"link\":\"/flashql/lang\"}]},{\"text\":\"Engineering\",\"items\":[{\"text\":\"The Realtime Engine\",\"link\":\"/engineering/realtime-engine\"}]}]},\"footer\":{\"message\":\"MIT Licensed\",\"copyright\":\"© Oxford Harrison\"},\"search\":{\"provider\":\"local\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
 
   </body>
 </html>