happy-sql 2.2.0 → 2.3.0

package/ChangeLog

@@ -1,3 +1,34 @@
+2026.08.24, v2.3.0
+
+fix:
+- 219bd9b happy-sql: parser: REPLACE INTO
+- 91b29e2 happy-sql: parser: intersect and except
+- 198b65b npmignore: fixture: exclude
+
+feature:
+- 9236576 happy-sql: printer: replaceInto
+- 7f333dc happy-sql: printer: intersect and except
+
+2026.08.24, v2.3.0
+
+feature:
+- 7f333dc printer: intersect and except
+- 9236576 printer: replaceInto
+
+fix:
+- 91b29e2 parser: intersect and except
+- 219bd9b parser: REPLACE INTO
+
+test:
+- fb2a0bc bin/convert coverage, 100% coverage
+- 498e25f round-trip: intersect, except
+- 720c219 round-trip: REPLACE INTO
+
+2026.08.24, v2.2.1
+
+fix:
+- c1535ff npmignore: fixture: exclude
+
 2026.08.24, v2.2.0
 
 fix:

package/lib/parser/visitors/clause/insert/insert.js

@@ -59,7 +59,31 @@ const convertUpsert = (upsertClause) => {
     return callExpression(identifier('onConflict'), [...targetArgs, actionNode]);
 };
 
-export const convertInsert = ({clauses}) => {
+const isReplaceInto = ({insertKw, orAction}) => !orAction && insertKw?.name === 'REPLACE';
+
+const convertReplaceInto = ({clauses}) => {
+    const ic = findClause(clauses, 'insert_clause');
+    const rc = findClause(clauses, 'returning_clause');
+    
+    const cols = ic.columns.expr.items;
+    const colArg = cols.length === 1 ? identifier(cols[0].name) : arrayExpression(cols.map(convertColToIdentifier));
+    const source = convertSource(findClause(clauses, 'values_clause'));
+    
+    return callExpression(identifier('replaceInto'), [
+        callExpression(identifier('into'), [
+            identifier(ic.table.name),
+            colArg,
+            source,
+        ]),
+        rc && convertReturning(rc),
+    ].filter(Boolean));
+};
+
+export const convertInsert = (stmt) => {
+    if (isReplaceInto(stmt.clauses[0]))
+        return convertReplaceInto(stmt);
+    
+    const {clauses} = stmt;
     const [ic] = clauses;
     const [, vc] = clauses;
     const uc = findClause(clauses, 'upsert_clause');

package/lib/parser/visitors/clause/union/union.js

@@ -16,10 +16,22 @@ const getOpNames = (operator) => {
     return [operator.name];
 };
 
+const getName = (ops) => {
+    if (ops.includes('INTERSECT'))
+        return 'intersect';
+    
+    if (ops.includes('EXCEPT'))
+        return 'except';
+    
+    if (ops.includes('ALL'))
+        return 'unionAll';
+    
+    return 'union';
+};
+
 export const convertUnion = (stmt) => {
     const ops = getOpNames(stmt.operator);
-    const isAll = ops.includes('ALL');
-    const name = isAll ? 'unionAll' : 'union';
+    const name = getName(ops);
     
     return callExpression(identifier(name), [
         convertClause(stmt.left),

package/lib/printer/visitors/call-expression/clauses/clauses.js

@@ -10,6 +10,7 @@ import {select} from './select/select.js';
 import {from} from './from/from.js';
 import {where} from './where/where.js';
 import {insert} from './insert/insert.js';
+import {replaceInto} from './replace-into/replace-into.js';
 import {into} from './into/into.js';
 import {values} from './values/values.js';
 import {onConflict} from './on-conflict/on-conflict.js';
@@ -24,6 +25,8 @@ import {withNamed} from './with-named/with-named.js';
 import {withRecursive} from './with-recursive/with-recursive.js';
 import {unionAll} from './union-all/union-all.js';
 import {union} from './union/union.js';
+import {intersect} from './intersect/intersect.js';
+import {except} from './except/except.js';
 import {groupBy} from './group-by/group-by.js';
 import {having} from './having/having.js';
 import {sum} from './sum/sum.js';
@@ -110,6 +113,7 @@ export const clauses = {
     select,
     where,
     insert,
+    replaceInto,
     into,
     orReplace,
     orIgnore,
@@ -140,6 +144,8 @@ export const clauses = {
     withRecursive,
     unionAll,
     union,
+    intersect,
+    except,
     groupBy,
     having,
     sum,

package/lib/printer/visitors/call-expression/clauses/except/except.js

@@ -0,0 +1,9 @@
+export const except = (path, {write, traverse}) => {
+    const [left, right] = path.get('arguments');
+    
+    traverse(left);
+    write.breakline();
+    write('EXCEPT');
+    write.breakline();
+    traverse(right);
+};

package/lib/printer/visitors/call-expression/clauses/intersect/intersect.js

@@ -0,0 +1,9 @@
+export const intersect = (path, {write, traverse}) => {
+    const [left, right] = path.get('arguments');
+    
+    traverse(left);
+    write.breakline();
+    write('INTERSECT');
+    write.breakline();
+    traverse(right);
+};

package/lib/printer/visitors/call-expression/clauses/replace-into/replace-into.js

@@ -0,0 +1,11 @@
+export const replaceInto = (path, {write, traverse}) => {
+    const args = path.get('arguments');
+    
+    write('REPLACE ');
+    traverse(args[0]);
+    
+    for (const arg of args.slice(1)) {
+        write.breakline();
+        traverse(arg);
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "happy-sql",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "type": "module",
   "description": "sql to js ast parser and printer",
   "exports": {

package/lib/parser/fixture/comment-fix.js

@@ -1,8 +0,0 @@
-[
-    select(
-        '*',
-        from(
-            users,
-        ),
-    ),
-];

package/lib/parser/fixture/comment.sql

@@ -1,2 +0,0 @@
--- hello world
-SELECT * FROM users;

package/lib/parser/fixture/section-multi-fix.js

@@ -1,24 +0,0 @@
-[
-    section(
-        '@fix', [
-            update(
-                Identifier,
-                set(
-                    name === 'isNaN',
-                ),
-                where(
-                    id === ':nan_id',
-                ),
-            ),
-            update(
-                BinaryExpression,
-                set(
-                    operator === '===',
-                ),
-                where(
-                    id === ':id',
-                ),
-            ),
-        ],
-    ),
-];

package/lib/parser/fixture/section-multi.sql

@@ -1,3 +0,0 @@
--- @fix
-UPDATE Identifier SET name = 'isNaN' WHERE id = :nan_id;
-UPDATE BinaryExpression SET operator = '===' WHERE id = :id;

package/lib/parser/fixture/select-fix.js

@@ -1,8 +0,0 @@
-[
-    select(
-        '*',
-        from(
-            users,
-        ),
-    ),
-];

package/lib/parser/fixture/select.sql

@@ -1 +0,0 @@
-SELECT * FROM users

package/lib/parser/fixture/with-named-fix.js

@@ -1,43 +0,0 @@
-[
-    withNamed(
-        call = insert(
-            into(
-                CallExpression,
-                parent_id,
-                values(
-                    ':parent_id',
-                ),
-            ),
-            returning(
-                id,
-            ),
-        ),
-        member = insert(
-            into(
-                MemberExpression,
-                parent_id,
-                select(
-                    id,
-                    from(
-                        call,
-                    ),
-                ),
-            ),
-            returning(
-                id,
-            ),
-        ),
-        insert(
-            into(
-                Identifier, [name, parent_id],
-                select(
-                    'x',
-                    id,
-                    from(
-                        member,
-                    ),
-                ),
-            ),
-        ),
-    ),
-];

package/lib/parser/fixture/with-named-insert-fix.js

@@ -1,44 +0,0 @@
-[
-    withNamed(
-        call = insert(
-            into(
-                CallExpression, [file, parent_id],
-                values(
-                    ':file',
-                    ':parent_id',
-                ),
-            ),
-            returning(
-                id,
-            ),
-        ),
-        member = insert(
-            into(
-                MemberExpression, [file, parent_id],
-                select(
-                    ':file',
-                    id,
-                    from(
-                        call,
-                    ),
-                ),
-            ),
-            returning(
-                id,
-            ),
-        ),
-        insert(
-            into(
-                Identifier, [file, name, parent_id],
-                select(
-                    ':file',
-                    'isNaN',
-                    id,
-                    from(
-                        member,
-                    ),
-                ),
-            ),
-        ),
-    ),
-];

package/lib/parser/fixture/with-named-insert.sql

@@ -1,13 +0,0 @@
-WITH
-    call AS (
-        INSERT INTO CallExpression (file, parent_id)
-        VALUES (':file', ':parent_id')
-        RETURNING id
-    ),
-    member AS (
-        INSERT INTO MemberExpression (file, parent_id)
-        SELECT ':file', id FROM call
-        RETURNING id
-    )
-INSERT INTO Identifier (file, name, parent_id)
-SELECT ':file', 'isNaN', id FROM member

package/lib/parser/fixture/with-named.sql

@@ -1,8 +0,0 @@
-WITH
-    call AS (
-        INSERT INTO CallExpression (parent_id) VALUES (:parent_id) RETURNING id
-    ),
-    member AS (
-        INSERT INTO MemberExpression (parent_id) SELECT id FROM call RETURNING id
-    )
-INSERT INTO Identifier (name, parent_id) SELECT 'x', id FROM member;

package/lib/parser/visitors/clause/alter-table/fixture/alter-table-add-column-fix.js

@@ -1,11 +0,0 @@
-[
-    alterTable(
-        t,
-        addColumn(
-            column(
-                y,
-                INT,
-            ),
-        ),
-    ),
-];

package/lib/parser/visitors/clause/alter-table/fixture/alter-table-add-column.sql

@@ -1 +0,0 @@
-ALTER TABLE t ADD COLUMN y INT

package/lib/parser/visitors/clause/alter-table/fixture/alter-table-alter-column-type-fix.js

@@ -1,9 +0,0 @@
-[
-    alterTable(
-        t,
-        alterColumnType(
-            x,
-            TEXT,
-        ),
-    ),
-];

package/lib/parser/visitors/clause/alter-table/fixture/alter-table-alter-column-type.sql

@@ -1 +0,0 @@
-ALTER TABLE t ALTER COLUMN x TYPE TEXT

package/lib/parser/visitors/clause/alter-table/fixture/alter-table-drop-column-fix.js

@@ -1,8 +0,0 @@
-[
-    alterTable(
-        t,
-        dropColumn(
-            name,
-        ),
-    ),
-];

package/lib/parser/visitors/clause/alter-table/fixture/alter-table-drop-column.sql

@@ -1 +0,0 @@
-ALTER TABLE t DROP COLUMN name

package/lib/parser/visitors/clause/alter-table/fixture/alter-table-rename-column-fix.js

@@ -1,9 +0,0 @@
-[
-    alterTable(
-        t,
-        renameColumn(
-            old_name,
-            new_name,
-        ),
-    ),
-];

package/lib/parser/visitors/clause/alter-table/fixture/alter-table-rename-column.sql

@@ -1 +0,0 @@
-ALTER TABLE t RENAME COLUMN old_name TO new_name

package/lib/parser/visitors/clause/attach/fixture/attach-fix.js

@@ -1,6 +0,0 @@
-[
-    attach(
-        'file.db',
-        other,
-    ),
-];

package/lib/parser/visitors/clause/attach/fixture/attach.sql

@@ -1 +0,0 @@
-ATTACH DATABASE 'file.db' AS other

package/lib/parser/visitors/clause/count/fixture/count-fix.js

@@ -1,10 +0,0 @@
-[
-    select(
-        count(
-            '*',
-        ),
-        from(
-            users,
-        ),
-    ),
-];

package/lib/parser/visitors/clause/count/fixture/count-one-fix.js

@@ -1,10 +0,0 @@
-[
-    select(
-        count(
-            1,
-        ),
-        from(
-            users,
-        ),
-    ),
-];

package/lib/parser/visitors/clause/count/fixture/count-one.sql

@@ -1 +0,0 @@
-SELECT COUNT(1) FROM users

package/lib/parser/visitors/clause/count/fixture/count.sql

@@ -1 +0,0 @@
-SELECT COUNT(*) FROM users

package/lib/parser/visitors/clause/create-index/fixture/create-index-fix.js

@@ -1,7 +0,0 @@
-[
-    createIndex(
-        idx,
-        t,
-        name,
-    ),
-];

package/lib/parser/visitors/clause/create-index/fixture/create-index.sql

@@ -1 +0,0 @@
-CREATE INDEX idx ON t (name)

package/lib/parser/visitors/clause/create-index/fixture/create-unique-index-fix.js

@@ -1,7 +0,0 @@
-[
-    createUniqueIndex(
-        idx,
-        t,
-        name,
-    ),
-];

package/lib/parser/visitors/clause/create-index/fixture/create-unique-index.sql

@@ -1 +0,0 @@
-CREATE UNIQUE INDEX idx ON t (name)

package/lib/parser/visitors/clause/create-sequence/fixture/create-sequence-fix.js

@@ -1,5 +0,0 @@
-[
-    createSequence(
-        users_id_seq,
-    ),
-];

package/lib/parser/visitors/clause/create-sequence/fixture/create-sequence.sql

@@ -1,2 +0,0 @@
-CREATE SEQUENCE users_id_seq
-

package/lib/parser/visitors/clause/create-table/fixture/create-table-autoincrement-fix.js

@@ -1,12 +0,0 @@
-[
-    createTable(
-        t, [
-            column(
-                id,
-                INTEGER,
-                primaryKey(),
-                autoIncrement(),
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-autoincrement.sql

@@ -1 +0,0 @@
-CREATE TABLE t (id INTEGER PRIMARY KEY AUTOINCREMENT)

package/lib/parser/visitors/clause/create-table/fixture/create-table-check-fix.js

@@ -1,13 +0,0 @@
-[
-    createTable(
-        t, [
-            column(
-                x,
-                INT,
-                check(
-                    x > 0,
-                ),
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-check.sql

@@ -1 +0,0 @@
-CREATE TABLE t (x INT CHECK (x > 0))

package/lib/parser/visitors/clause/create-table/fixture/create-table-default-fix.js

@@ -1,14 +0,0 @@
-[
-    createTable(
-        t, [
-            column(
-                id,
-                INTEGER,
-                default_(
-                    42,
-                ),
-                primaryKey(),
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-default-int-fix.js

@@ -1,13 +0,0 @@
-[
-    createTable(
-        t, [
-            column(
-                id,
-                INT,
-                default_(
-                    0,
-                ),
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-default-int.sql

@@ -1 +0,0 @@
-CREATE TABLE t (id INT DEFAULT 0)

package/lib/parser/visitors/clause/create-table/fixture/create-table-default.sql

@@ -1 +0,0 @@
-CREATE TABLE t (id INTEGER DEFAULT 42 PRIMARY KEY)

package/lib/parser/visitors/clause/create-table/fixture/create-table-identity-always-fix.js

@@ -1,12 +0,0 @@
-[
-    createTable(
-        t, [
-            column(
-                id,
-                BIGINT,
-                identity(),
-                primaryKey(),
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-identity-always.sql

@@ -1 +0,0 @@
-CREATE TABLE t (id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY)

package/lib/parser/visitors/clause/create-table/fixture/create-table-identity-by-default-fix.js

@@ -1,12 +0,0 @@
-[
-    createTable(
-        t, [
-            column(
-                id,
-                BIGINT,
-                identityByDefault(),
-                primaryKey(),
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-identity-by-default.sql

@@ -1 +0,0 @@
-CREATE TABLE t (id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY)

package/lib/parser/visitors/clause/create-table/fixture/create-table-if-not-exists-fix.js

@@ -1,10 +0,0 @@
-[
-    createTableIfNotExists(
-        t, [
-            column(
-                id,
-                INT,
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-if-not-exists.sql

@@ -1 +0,0 @@
-CREATE TABLE IF NOT EXISTS t (id INT)

package/lib/parser/visitors/clause/create-table/fixture/create-table-nextval-fix.js

@@ -1,18 +0,0 @@
-[
-    createTable(
-        users, [
-            column(
-                id,
-                INTEGER,
-                nextval(
-                    users_id_seq,
-                ),
-                primaryKey(),
-            ),
-            column(
-                name,
-                TEXT,
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-nextval.sql

@@ -1 +0,0 @@
-CREATE TABLE users (id INTEGER DEFAULT nextval('users_id_seq') PRIMARY KEY, name TEXT)

package/lib/parser/visitors/clause/create-table/fixture/create-table-not-null-fix.js

@@ -1,11 +0,0 @@
-[
-    createTable(
-        t, [
-            column(
-                id,
-                INT,
-                notNull(),
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-not-null.sql

@@ -1 +0,0 @@
-CREATE TABLE t (id INT NOT NULL)

package/lib/parser/visitors/clause/create-table/fixture/create-table-references-fix.js

@@ -1,14 +0,0 @@
-[
-    createTable(
-        orders, [
-            column(
-                user_id,
-                INT,
-                references(
-                    users,
-                    id,
-                ),
-            ),
-        ],
-    ),
-];

package/lib/parser/visitors/clause/create-table/fixture/create-table-references.sql

@@ -1 +0,0 @@
-CREATE TABLE orders (user_id INT REFERENCES users(id))