csv-sql-engine 0.0.1 → 0.0.2

package/dist/csv/csv-text.d.ts

@@ -1,4 +1,3 @@
-import { type RequireExactlyOne } from 'type-fest';
 /**
  * Converts multiple rows of values into a CSV file string.
  *
@@ -11,21 +10,6 @@ export declare function convertRowsToCsv(rows: ReadonlyArray<ReadonlyArray<strin
  * @category CSV
  */
 export declare function convertRowToCsv(row: ReadonlyArray<string>): string;
-/**
- * Sorts values for CSV insertion or reading.
- *
- * @category CSV
- */
-export declare function sortValues({ csvFileHeaderOrder, sqlQueryHeaderOrder, from, }: Readonly<{
-    csvFileHeaderOrder: ReadonlyArray<string>;
-    sqlQueryHeaderOrder: ReadonlyArray<string>;
-    from: RequireExactlyOne<{
-        /** When a CSV value array is provided, they are sorted to the SQL header order. */
-        csvFile: ReadonlyArray<string>;
-        /** When a SQL value array is provided, they are sorted to the CSV header order. */
-        sqlQuery: ReadonlyArray<string>;
-    }>;
-}>): string[];
 /**
  * Reads a CSV file contents string and converts it into multiple rows of strings.
  *

package/dist/csv/csv-text.js

@@ -26,28 +26,6 @@ export function convertRowToCsv(row) {
     })
         .join(',');
 }
-/**
- * Sorts values for CSV insertion or reading.
- *
- * @category CSV
- */
-export function sortValues({ csvFileHeaderOrder, sqlQueryHeaderOrder, from, }) {
-    const fromOrder = from.sqlQuery ? sqlQueryHeaderOrder : csvFileHeaderOrder;
-    const toOrder = (from.sqlQuery ? csvFileHeaderOrder : sqlQueryHeaderOrder).flatMap((header) => {
-        if (header === '*') {
-            return csvFileHeaderOrder;
-        }
-        else {
-            return header;
-        }
-    });
-    const values = from.csvFile || from.sqlQuery;
-    return toOrder.map((header) => {
-        const sourceIndex = fromOrder.indexOf(header);
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return values[sourceIndex];
-    });
-}
 /**
  * Reads a CSV file contents string and converts it into multiple rows of strings.
  *

package/dist/engine/handlers/row-delete.handler.js

@@ -1,9 +1,9 @@
 import { check } from '@augment-vir/assert';
 import { awaitedBlockingMap } from '@augment-vir/common';
 import { nameCsvTableFile, readCsvFile, readCsvHeaders, writeCsvFile } from '../../csv/csv-file.js';
-import { sortValues } from '../../csv/csv-text.js';
 import { AstType } from '../../sql/ast.js';
 import { defineAstHandler } from '../define-ast-handler.js';
+import { sortValues } from '../sort-values.js';
 import { findWhereMatches } from '../where-matcher.js';
 /**
  * Handles deleting rows.
@@ -12,7 +12,7 @@ import { findWhereMatches } from '../where-matcher.js';
  */
 export const rowDeleteHandler = defineAstHandler({
     name: 'row-delete',
-    async handler({ ast, csvDirPath }) {
+    async handler({ ast, csvDirPath, sql }) {
         if (ast.type === AstType.Delete) {
             const tableNames = ast.table.map((table) => table.table);
             const returning = await awaitedBlockingMap(tableNames, async (tableName) => {
@@ -36,6 +36,7 @@ export const rowDeleteHandler = defineAstHandler({
                         from: {
                             csvFile: row,
                         },
+                        unconsumedInterpolationValues: sql.unconsumedValues,
                     }))
                     : undefined;
                 rowIndexesToDelete.forEach((rowIndexToDelete) => {

package/dist/engine/handlers/row-insert.handler.js

@@ -1,9 +1,9 @@
 import { check } from '@augment-vir/assert';
 import { awaitedBlockingMap } from '@augment-vir/common';
 import { appendCsvRow, nameCsvTableFile, readCsvHeaders } from '../../csv/csv-file.js';
-import { sortValues } from '../../csv/csv-text.js';
 import { AstType } from '../../sql/ast.js';
 import { defineAstHandler } from '../define-ast-handler.js';
+import { sortValues } from '../sort-values.js';
 /**
  * Handles inserting rows.
  *
@@ -11,7 +11,7 @@ import { defineAstHandler } from '../define-ast-handler.js';
  */
 export const rowInsertHandler = defineAstHandler({
     name: 'row-insert',
-    async handler({ ast, csvDirPath }) {
+    async handler({ ast, csvDirPath, sql }) {
         if (ast.type === AstType.Insert) {
             const tableNames = ast.table.map((table) => table.table);
             const returning = await awaitedBlockingMap(tableNames, async (tableName) => {
@@ -24,23 +24,23 @@ export const rowInsertHandler = defineAstHandler({
                     csvFilePath: tableFilePath,
                     sanitizedTableName,
                 });
-                const values = ast.columns
-                    ? sortValues({
-                        csvFileHeaderOrder,
-                        sqlQueryHeaderOrder: ast.columns,
-                        from: {
-                            sqlQuery: rawValues,
-                        },
-                    })
-                    : rawValues;
-                await appendCsvRow(values, tableFilePath);
+                const newRow = sortValues({
+                    csvFileHeaderOrder,
+                    sqlQueryHeaderOrder: ast.columns || csvFileHeaderOrder,
+                    from: {
+                        sqlQuery: rawValues,
+                    },
+                    unconsumedInterpolationValues: sql.unconsumedValues,
+                });
+                await appendCsvRow(newRow, tableFilePath);
                 if (ast.returning) {
                     return sortValues({
                         csvFileHeaderOrder,
                         sqlQueryHeaderOrder: ast.returning.columns.map((column) => column.expr.column),
                         from: {
-                            csvFile: values,
+                            csvFile: newRow,
                         },
+                        unconsumedInterpolationValues: undefined,
                     });
                 }
                 else {

package/dist/engine/handlers/row-select.handler.js

@@ -1,9 +1,9 @@
 import { check } from '@augment-vir/assert';
 import { awaitedBlockingMap } from '@augment-vir/common';
 import { nameCsvTableFile, readCsvFile, readCsvHeaders, writeCsvFile } from '../../csv/csv-file.js';
-import { sortValues } from '../../csv/csv-text.js';
 import { AstType } from '../../sql/ast.js';
 import { defineAstHandler } from '../define-ast-handler.js';
+import { sortValues } from '../sort-values.js';
 import { findWhereMatches } from '../where-matcher.js';
 /**
  * Handles SQL selection.
@@ -12,7 +12,7 @@ import { findWhereMatches } from '../where-matcher.js';
  */
 export const rowSelectHandler = defineAstHandler({
     name: 'row-select',
-    async handler({ ast, csvDirPath }) {
+    async handler({ ast, csvDirPath, sql }) {
         if (ast.type === AstType.Select) {
             const tableNames = ast.from.map((table) => table.table);
             const allSelections = await awaitedBlockingMap(tableNames, async (tableName) => {
@@ -35,6 +35,7 @@ export const rowSelectHandler = defineAstHandler({
                     from: {
                         csvFile: row,
                     },
+                    unconsumedInterpolationValues: sql.unconsumedValues,
                 }));
                 await writeCsvFile(tableFilePath, csvContents);
                 return selection;

package/dist/engine/handlers/row-update.handler.js

@@ -1,10 +1,10 @@
 import { assertWrap, check } from '@augment-vir/assert';
 import { awaitedBlockingMap } from '@augment-vir/common';
 import { createCsvHeaderMaps, nameCsvTableFile, readCsvFile, readCsvHeaders, writeCsvFile, } from '../../csv/csv-file.js';
-import { sortValues } from '../../csv/csv-text.js';
 import { CsvColumnDoesNotExistError } from '../../errors/csv.error.js';
 import { AstType } from '../../sql/ast.js';
 import { defineAstHandler } from '../define-ast-handler.js';
+import { sortValues } from '../sort-values.js';
 import { findWhereMatches } from '../where-matcher.js';
 /**
  * Handles updating rows.
@@ -13,7 +13,7 @@ import { findWhereMatches } from '../where-matcher.js';
  */
 export const rowUpdateHandler = defineAstHandler({
     name: 'row-update',
-    async handler({ ast, csvDirPath }) {
+    async handler({ ast, csvDirPath, sql }) {
         if (ast.type === AstType.Update) {
             const tableNames = ast.table.map((table) => table.table);
             const returning = await awaitedBlockingMap(tableNames, async (tableName) => {
@@ -40,7 +40,7 @@ export const rowUpdateHandler = defineAstHandler({
                         row[headerIndex] = set.value.value;
                     });
                 });
-                const returning = returningRequirement
+                const updatedRow = returningRequirement
                     ? csvContents
                         .filter((row, index) => rowIndexesToUpdate.includes(index))
                         .map((row) => sortValues({
@@ -49,10 +49,11 @@ export const rowUpdateHandler = defineAstHandler({
                         from: {
                             csvFile: row,
                         },
+                        unconsumedInterpolationValues: sql.unconsumedValues,
                     }))
                     : undefined;
                 await writeCsvFile(tableFilePath, csvContents);
-                return returning;
+                return updatedRow;
             });
             return returning.flat().filter(check.isTruthy);
         }

package/dist/engine/sort-values.d.ts

@@ -0,0 +1,18 @@
+import { type RequireExactlyOne } from 'type-fest';
+import { type ConsumableValue } from '../sql/sql.js';
+/**
+ * Sorts values for CSV insertion or reading and handle interpolated values.
+ *
+ * @category Internal
+ */
+export declare function sortValues({ csvFileHeaderOrder, sqlQueryHeaderOrder, from, unconsumedInterpolationValues, }: Readonly<{
+    csvFileHeaderOrder: ReadonlyArray<string>;
+    sqlQueryHeaderOrder: ReadonlyArray<string>;
+    from: RequireExactlyOne<{
+        /** When a CSV value array is provided, they are sorted to the SQL header order. */
+        csvFile: ReadonlyArray<string>;
+        /** When a SQL value array is provided, they are sorted to the CSV header order. */
+        sqlQuery: ReadonlyArray<string>;
+    }>;
+    unconsumedInterpolationValues: undefined | ConsumableValue[];
+}>): string[];

package/dist/engine/sort-values.js

@@ -0,0 +1,38 @@
+/**
+ * Sorts values for CSV insertion or reading and handle interpolated values.
+ *
+ * @category Internal
+ */
+export function sortValues({ csvFileHeaderOrder, sqlQueryHeaderOrder, from, unconsumedInterpolationValues, }) {
+    const fromOrder = from.sqlQuery ? sqlQueryHeaderOrder : csvFileHeaderOrder;
+    const toOrder = (from.sqlQuery ? csvFileHeaderOrder : sqlQueryHeaderOrder).flatMap((header) => {
+        if (header === '*') {
+            return csvFileHeaderOrder;
+        }
+        else {
+            return header;
+        }
+    });
+    const values = (from.csvFile || from.sqlQuery).map((value) => {
+        if (value === '?') {
+            if (unconsumedInterpolationValues) {
+                if (unconsumedInterpolationValues.length) {
+                    return unconsumedInterpolationValues.shift() || '';
+                }
+                else {
+                    throw new Error('Encountered ? but all interpolation values have already been used.');
+                }
+            }
+            else {
+                throw new Error('Encountered ? but received no interpolation values.');
+            }
+        }
+        else {
+            return value;
+        }
+    });
+    return toOrder.map((header) => {
+        const sourceIndex = fromOrder.indexOf(header);
+        return values[sourceIndex] ?? '';
+    });
+}

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export * from './engine/handlers/table-alter.handler.js';
 export * from './engine/handlers/table-create.handler.js';
 export * from './engine/handlers/table-drop.handler.js';
 export * from './engine/params.js';
+export * from './engine/sort-values.js';
 export * from './engine/where-matcher.js';
 export * from './errors/csv-sql-engine.error.js';
 export * from './errors/csv.error.js';

package/dist/index.js

@@ -11,6 +11,7 @@ export * from './engine/handlers/table-alter.handler.js';
 export * from './engine/handlers/table-create.handler.js';
 export * from './engine/handlers/table-drop.handler.js';
 export * from './engine/params.js';
+export * from './engine/sort-values.js';
 export * from './engine/where-matcher.js';
 export * from './errors/csv-sql-engine.error.js';
 export * from './errors/csv.error.js';

package/dist/sql/sql.d.ts

@@ -1,5 +1,11 @@
-import { type MaybeArray } from '@augment-vir/common';
+import { type Branded } from '@augment-vir/common';
 import { Sql as OriginalSql } from 'sql-template-tag';
+/**
+ * Used to mark consumable values so we don't accidentally assign the wrong array for mutation.
+ *
+ * @category Internal
+ */
+export type ConsumableValue = Branded<string, 'consumable-values'>;
 /**
  * A SQL command's strings and values.
  *
@@ -7,6 +13,9 @@ import { Sql as OriginalSql } from 'sql-template-tag';
  */
 export declare class Sql extends OriginalSql {
     values: string[];
+    /** This will be mutated by whatever is reading this SQL. */
+    unconsumedValues: ConsumableValue[];
+    constructor(rawStrings: readonly string[], rawValues: readonly (Sql | string)[]);
 }
 /**
  * Parses a SQL string with interpolations extracted into values so that they can be properly
@@ -14,7 +23,7 @@ export declare class Sql extends OriginalSql {
  *
  * @category SQL
  */
-export declare function sql(strings: ReadonlyArray<string>, ...values: Array<MaybeArray<string> | Sql>): Sql;
+export declare function sql(strings: ReadonlyArray<string>, ...values: Array<string | number | Sql>): Sql;
 /**
  * Creates a raw, _unsafe_, {@link Sql} command. Prefer {@link sql} whenever possible.
  *

package/dist/sql/sql.js

@@ -5,6 +5,12 @@ import { Sql as OriginalSql } from 'sql-template-tag';
  * @category Internal
  */
 export class Sql extends OriginalSql {
+    /** This will be mutated by whatever is reading this SQL. */
+    unconsumedValues;
+    constructor(rawStrings, rawValues) {
+        super(rawStrings, rawValues);
+        this.unconsumedValues = [...this.values];
+    }
 }
 /**
  * Parses a SQL string with interpolations extracted into values so that they can be properly
@@ -13,7 +19,14 @@ export class Sql extends OriginalSql {
  * @category SQL
  */
 export function sql(strings, ...values) {
-    return new Sql(strings, values);
+    return new Sql(strings, values.map((value) => {
+        if (value instanceof Sql) {
+            return value;
+        }
+        else {
+            return String(value);
+        }
+    }));
 }
 /**
  * Creates a raw, _unsafe_, {@link Sql} command. Prefer {@link sql} whenever possible.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "csv-sql-engine",
-    "version": "0.0.1",
+    "version": "0.0.2",
     "description": "API for executing SQL statements on CSV files.",
     "keywords": [
         "CSV",