sensemaking 0.17.0 → 0.18.0

package/dist/cjs/output/output.d.cts

@@ -1,8 +1,9 @@
 export type Row = Record<string, unknown>;
 export type Format = 'table' | 'json';
 export type RowFormat = Format | 'csv';
+export declare function stringifyJson(value: unknown, indent?: number): string;
 export declare function printRows(rows: Row[], format: RowFormat, columns?: string[]): void;
-export declare function printRowStream(rows: Iterable<Row>, format: RowFormat, columns: string[]): void;
+export declare function printRowStream(rows: AsyncIterable<Row>, format: RowFormat, columns: string[]): Promise<void>;
 export declare function featureOffHint(name: string): string;
 export declare function featuresLine(features: {
     on: string[];

package/dist/cjs/output/output.d.ts

@@ -1,8 +1,9 @@
 export type Row = Record<string, unknown>;
 export type Format = 'table' | 'json';
 export type RowFormat = Format | 'csv';
+export declare function stringifyJson(value: unknown, indent?: number): string;
 export declare function printRows(rows: Row[], format: RowFormat, columns?: string[]): void;
-export declare function printRowStream(rows: Iterable<Row>, format: RowFormat, columns: string[]): void;
+export declare function printRowStream(rows: AsyncIterable<Row>, format: RowFormat, columns: string[]): Promise<void>;
 export declare function featureOffHint(name: string): string;
 export declare function featuresLine(features: {
     on: string[];

package/dist/cjs/output/output.js

@@ -30,6 +30,9 @@ _export(exports, {
     },
     get renderPeek () {
         return renderPeek;
+    },
+    get stringifyJson () {
+        return stringifyJson;
     }
 });
 function _array_like_to_array(arr, len) {
@@ -43,6 +46,73 @@ function _array_with_holes(arr) {
 function _array_without_holes(arr) {
     if (Array.isArray(arr)) return _array_like_to_array(arr);
 }
+function _async_iterator(iterable) {
+    var method, async, sync, retry = 2;
+    for("undefined" != typeof Symbol && (async = Symbol.asyncIterator, sync = Symbol.iterator); retry--;){
+        if (async && null != (method = iterable[async])) return method.call(iterable);
+        if (sync && null != (method = iterable[sync])) return new AsyncFromSyncIterator(method.call(iterable));
+        async = "@@asyncIterator", sync = "@@iterator";
+    }
+    throw new TypeError("Object is not async iterable");
+}
+function AsyncFromSyncIterator(s) {
+    function AsyncFromSyncIteratorContinuation(r) {
+        if (Object(r) !== r) return Promise.reject(new TypeError(r + " is not an object."));
+        var done = r.done;
+        return Promise.resolve(r.value).then(function(value) {
+            return {
+                value: value,
+                done: done
+            };
+        });
+    }
+    return AsyncFromSyncIterator = function(s) {
+        this.s = s, this.n = s.next;
+    }, AsyncFromSyncIterator.prototype = {
+        s: null,
+        n: null,
+        next: function() {
+            return AsyncFromSyncIteratorContinuation(this.n.apply(this.s, arguments));
+        },
+        return: function(value) {
+            var ret = this.s.return;
+            return void 0 === ret ? Promise.resolve({
+                value: value,
+                done: !0
+            }) : AsyncFromSyncIteratorContinuation(ret.apply(this.s, arguments));
+        },
+        throw: function(value) {
+            var thr = this.s.return;
+            return void 0 === thr ? Promise.reject(value) : AsyncFromSyncIteratorContinuation(thr.apply(this.s, arguments));
+        }
+    }, new AsyncFromSyncIterator(s);
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) resolve(value);
+    else Promise.resolve(value).then(_next, _throw);
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
 function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -95,6 +165,105 @@ function _sliced_to_array(arr, i) {
 function _to_consumable_array(arr) {
     return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
 }
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
 function _type_of(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
@@ -127,6 +296,21 @@ function warnOversize(bytes, rowCount) {
     if (bytes <= OVERSIZE_BYTES) return;
     console.warn("warning: result is ".concat(Math.round(bytes / 1000), " KB across ").concat(rowCount, " row(s); consider a LIMIT, fewer columns, snippet() instead of whole values, or --format csv redirected to a file"));
 }
+// Header names come from a row wherever there is one: a statement's column list keeps
+// duplicates that the row object has already collapsed, so `SELECT a AS x, b AS x` would print
+// b's value under both headers. `columns` is the fallback that labels a 0-row result, and with
+// no rows and no statement (a bounded command that found nothing) csv writes nothing at all --
+// a bare newline would read to a csv parser as one empty record.
+// JSON.stringify throws on BigInt, and stores return int64 as BigInt (DuckDB does). A value
+// that fits a safe integer stays a number; a larger one becomes its decimal string, since a
+// JSON number cannot carry it losslessly.
+var MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
+var bigintSafe = function bigintSafe(_key, value) {
+    return (typeof value === "undefined" ? "undefined" : _type_of(value)) === 'bigint' ? value >= -MAX_SAFE && value <= MAX_SAFE ? Number(value) : value.toString() : value;
+};
+function stringifyJson(value, indent) {
+    return JSON.stringify(value, bigintSafe, indent);
+}
 function printRows(rows, format, columns) {
     if (format === 'csv') {
         // Collapsed the same way a row object collapses them, so a statement naming a column
@@ -150,107 +334,341 @@ function printRows(rows, format, columns) {
     warnOversize(Buffer.byteLength(rendered1), rows.length);
 }
 function printRowStream(rows, format, columns) {
-    var iterator = rows[Symbol.iterator]();
-    // One step before any write. FTS5 parses a MATCH expression at step time rather than at
-    // prepare time, so a bad search string throws here, with stdout still clean for the error.
-    var first = iterator.next();
-    var rest = _define_property({}, Symbol.iterator, function() {
-        return iterator;
-    });
-    if (format === 'table') {
-        printRows(first.done ? [] : [
-            first.value
-        ].concat(_to_consumable_array(rest)), format, columns);
-        return;
-    }
-    var bytes = 0;
-    var rowCount = 0;
-    var write = function write(text) {
-        // Bytes, not code units -- CJK is 3 bytes per character.
-        bytes += Buffer.byteLength(text);
-        process.stdout.write(text);
-    };
-    if (format === 'json') {
-        // Byte-identical to JSON.stringify(rows, null, 2) + newline: each row re-indented one
-        // level, comma-joined, inside the array brackets written here.
-        // JSON.stringify throws on BigInt, so a row with an int64 past 2^53 (setReadBigInts) is
-        // converted via the replacer: a value that fits a safe integer stays a number, a larger one
-        // becomes its decimal string, since a JSON number cannot carry it losslessly.
-        var MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
-        var bigintSafe = function bigintSafe(_key, value) {
-            return (typeof value === "undefined" ? "undefined" : _type_of(value)) === 'bigint' ? value >= -MAX_SAFE && value <= MAX_SAFE ? Number(value) : value.toString() : value;
-        };
-        var indent = function indent(row) {
-            return JSON.stringify(row, bigintSafe, 2).split('\n').map(function(line) {
-                return "  ".concat(line);
-            }).join('\n');
-        };
-        if (first.done) {
-            write('[]\n');
-        } else {
-            write('[\n');
-            write(indent(first.value));
-            rowCount = 1;
-            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-            try {
-                for(var _iterator = rest[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                    var row = _step.value;
+    return _async_to_generator(function() {
+        var iterator, first, rest, collected, _iteratorAbruptCompletion, _didIteratorError, _iteratorError, _iterator, _step, _value, row, err, bytes, rowCount, write, indent, _iteratorAbruptCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, _value1, row1, err1, names, names1, _iteratorAbruptCompletion2, _didIteratorError2, _iteratorError2, _loop, _iterator2, _step2, err2;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    iterator = rows[Symbol.asyncIterator]();
+                    return [
+                        4,
+                        iterator.next()
+                    ];
+                case 1:
+                    first = _state.sent();
+                    rest = _define_property({}, Symbol.asyncIterator, function() {
+                        return iterator;
+                    });
+                    if (!(format === 'table')) return [
+                        3,
+                        14
+                    ];
+                    collected = first.done ? [] : [
+                        first.value
+                    ];
+                    _iteratorAbruptCompletion = false, _didIteratorError = false;
+                    _state.label = 2;
+                case 2:
+                    _state.trys.push([
+                        2,
+                        7,
+                        8,
+                        13
+                    ]);
+                    _iterator = _async_iterator(rest);
+                    _state.label = 3;
+                case 3:
+                    return [
+                        4,
+                        _iterator.next()
+                    ];
+                case 4:
+                    if (!(_iteratorAbruptCompletion = !(_step = _state.sent()).done)) return [
+                        3,
+                        6
+                    ];
+                    _value = _step.value;
+                    row = _value;
+                    collected.push(row);
+                    _state.label = 5;
+                case 5:
+                    _iteratorAbruptCompletion = false;
+                    return [
+                        3,
+                        3
+                    ];
+                case 6:
+                    return [
+                        3,
+                        13
+                    ];
+                case 7:
+                    err = _state.sent();
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                    return [
+                        3,
+                        13
+                    ];
+                case 8:
+                    _state.trys.push([
+                        8,
+                        ,
+                        11,
+                        12
+                    ]);
+                    if (!(_iteratorAbruptCompletion && _iterator.return != null)) return [
+                        3,
+                        10
+                    ];
+                    return [
+                        4,
+                        _iterator.return()
+                    ];
+                case 9:
+                    _state.sent();
+                    _state.label = 10;
+                case 10:
+                    return [
+                        3,
+                        12
+                    ];
+                case 11:
+                    if (_didIteratorError) {
+                        throw _iteratorError;
+                    }
+                    return [
+                        7
+                    ];
+                case 12:
+                    return [
+                        7
+                    ];
+                case 13:
+                    printRows(collected, format, columns);
+                    return [
+                        2
+                    ];
+                case 14:
+                    bytes = 0;
+                    rowCount = 0;
+                    write = function write(text) {
+                        // Bytes, not code units -- CJK is 3 bytes per character.
+                        bytes += Buffer.byteLength(text);
+                        process.stdout.write(text);
+                    };
+                    if (!(format === 'json')) return [
+                        3,
+                        29
+                    ];
+                    // Byte-identical to JSON.stringify(rows, null, 2) + newline: each row re-indented one
+                    // level, comma-joined, inside the array brackets written here.
+                    indent = function indent(row) {
+                        return stringifyJson(row, 2).split('\n').map(function(line) {
+                            return "  ".concat(line);
+                        }).join('\n');
+                    };
+                    if (!first.done) return [
+                        3,
+                        15
+                    ];
+                    write('[]\n');
+                    return [
+                        3,
+                        28
+                    ];
+                case 15:
+                    write('[\n');
+                    write(indent(first.value));
+                    rowCount = 1;
+                    _iteratorAbruptCompletion1 = false, _didIteratorError1 = false;
+                    _state.label = 16;
+                case 16:
+                    _state.trys.push([
+                        16,
+                        21,
+                        22,
+                        27
+                    ]);
+                    _iterator1 = _async_iterator(rest);
+                    _state.label = 17;
+                case 17:
+                    return [
+                        4,
+                        _iterator1.next()
+                    ];
+                case 18:
+                    if (!(_iteratorAbruptCompletion1 = !(_step1 = _state.sent()).done)) return [
+                        3,
+                        20
+                    ];
+                    _value1 = _step1.value;
+                    row1 = _value1;
                     write(',\n');
-                    write(indent(row));
+                    write(indent(row1));
                     rowCount++;
-                }
-            } catch (err) {
-                _didIteratorError = true;
-                _iteratorError = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion && _iterator.return != null) {
-                        _iterator.return();
+                    _state.label = 19;
+                case 19:
+                    _iteratorAbruptCompletion1 = false;
+                    return [
+                        3,
+                        17
+                    ];
+                case 20:
+                    return [
+                        3,
+                        27
+                    ];
+                case 21:
+                    err1 = _state.sent();
+                    _didIteratorError1 = true;
+                    _iteratorError1 = err1;
+                    return [
+                        3,
+                        27
+                    ];
+                case 22:
+                    _state.trys.push([
+                        22,
+                        ,
+                        25,
+                        26
+                    ]);
+                    if (!(_iteratorAbruptCompletion1 && _iterator1.return != null)) return [
+                        3,
+                        24
+                    ];
+                    return [
+                        4,
+                        _iterator1.return()
+                    ];
+                case 23:
+                    _state.sent();
+                    _state.label = 24;
+                case 24:
+                    return [
+                        3,
+                        26
+                    ];
+                case 25:
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
                     }
-                } finally{
-                    if (_didIteratorError) {
-                        throw _iteratorError;
+                    return [
+                        7
+                    ];
+                case 26:
+                    return [
+                        7
+                    ];
+                case 27:
+                    write('\n]\n');
+                    _state.label = 28;
+                case 28:
+                    return [
+                        3,
+                        42
+                    ];
+                case 29:
+                    if (!first.done) return [
+                        3,
+                        30
+                    ];
+                    names = _to_consumable_array(new Set(columns));
+                    if (names.length > 0) write("".concat(csvLine(names), "\n"));
+                    return [
+                        3,
+                        42
+                    ];
+                case 30:
+                    names1 = Object.keys(first.value);
+                    write("".concat(csvLine(names1), "\n"));
+                    write("".concat(csvLine(names1.map(function(name) {
+                        return first.value[name];
+                    })), "\n"));
+                    rowCount = 1;
+                    _iteratorAbruptCompletion2 = false, _didIteratorError2 = false;
+                    _state.label = 31;
+                case 31:
+                    _state.trys.push([
+                        31,
+                        36,
+                        37,
+                        42
+                    ]);
+                    _loop = function() {
+                        var _value = _step2.value;
+                        var row = _value;
+                        write("".concat(csvLine(names1.map(function(name) {
+                            return row[name];
+                        })), "\n"));
+                        rowCount++;
+                    };
+                    _iterator2 = _async_iterator(rest);
+                    _state.label = 32;
+                case 32:
+                    return [
+                        4,
+                        _iterator2.next()
+                    ];
+                case 33:
+                    if (!(_iteratorAbruptCompletion2 = !(_step2 = _state.sent()).done)) return [
+                        3,
+                        35
+                    ];
+                    _loop();
+                    _state.label = 34;
+                case 34:
+                    _iteratorAbruptCompletion2 = false;
+                    return [
+                        3,
+                        32
+                    ];
+                case 35:
+                    return [
+                        3,
+                        42
+                    ];
+                case 36:
+                    err2 = _state.sent();
+                    _didIteratorError2 = true;
+                    _iteratorError2 = err2;
+                    return [
+                        3,
+                        42
+                    ];
+                case 37:
+                    _state.trys.push([
+                        37,
+                        ,
+                        40,
+                        41
+                    ]);
+                    if (!(_iteratorAbruptCompletion2 && _iterator2.return != null)) return [
+                        3,
+                        39
+                    ];
+                    return [
+                        4,
+                        _iterator2.return()
+                    ];
+                case 38:
+                    _state.sent();
+                    _state.label = 39;
+                case 39:
+                    return [
+                        3,
+                        41
+                    ];
+                case 40:
+                    if (_didIteratorError2) {
+                        throw _iteratorError2;
                     }
-                }
-            }
-            write('\n]\n');
-        }
-    } else if (first.done) {
-        var names = _to_consumable_array(new Set(columns));
-        if (names.length > 0) write("".concat(csvLine(names), "\n"));
-    } else {
-        var names1 = Object.keys(first.value);
-        write("".concat(csvLine(names1), "\n"));
-        write("".concat(csvLine(names1.map(function(name) {
-            return first.value[name];
-        })), "\n"));
-        rowCount = 1;
-        var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-        try {
-            var _loop = function() {
-                var row = _step1.value;
-                write("".concat(csvLine(names1.map(function(name) {
-                    return row[name];
-                })), "\n"));
-                rowCount++;
-            };
-            for(var _iterator1 = rest[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true)_loop();
-        } catch (err) {
-            _didIteratorError1 = true;
-            _iteratorError1 = err;
-        } finally{
-            try {
-                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                    _iterator1.return();
-                }
-            } finally{
-                if (_didIteratorError1) {
-                    throw _iteratorError1;
-                }
+                    return [
+                        7
+                    ];
+                case 41:
+                    return [
+                        7
+                    ];
+                case 42:
+                    warnOversize(bytes, rowCount);
+                    return [
+                        2
+                    ];
             }
-        }
-    }
-    warnOversize(bytes, rowCount);
+        });
+    })();
 }
 // Tables are for reading, and a row wider than the terminal wraps unreadably: widest columns
 // give up space first, down to a floor. --format json is never truncated.
@@ -273,7 +691,7 @@ function fitWidths(widths, limit) {
 function renderRows(rows, format) {
     var width = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : process.stdout.columns;
     var _Math;
-    if (format === 'json') return JSON.stringify(rows, null, 2);
+    if (format === 'json') return stringifyJson(rows, 2);
     if (rows.length === 0) return '(0 rows)';
     var columns = Object.keys(rows[0]);
     var cells = rows.map(function(row) {