gitsheets 1.0.5 → 1.1.0

package/dist/cli/formats.d.ts

@@ -0,0 +1,30 @@
+import type { RecordLike } from '../path-template/index.js';
+export type InputFormat = 'json' | 'toml' | 'csv';
+export type OutputFormat = 'json' | 'toml' | 'csv' | 'tsv';
+/** Map a file extension (without the dot) to an input format. */
+export declare function inferInputFormat(input: string | undefined): InputFormat;
+/**
+ * Parse input text into an array of records, given the format.
+ *
+ * - JSON: a single object, an array, or JSONL (one object per line).
+ * - TOML: either a single record (the document maps to one record), an array
+ *   of records under `[[records]]`, or any top-level table where every value
+ *   is itself a table (each becomes a record keyed by table name).
+ * - CSV: the first row is the header. Each subsequent row is one record.
+ *   Numeric strings stay as strings — type coercion belongs in the consumer
+ *   schema, not in CSV parsing.
+ */
+export declare function parseRecords(text: string, format: InputFormat): RecordLike[];
+/**
+ * Stringify a single record into one piece of output text for the given
+ * format. For CSV / TSV, the caller drives header emission; this function
+ * formats one row only.
+ */
+export declare function stringifyRecord_text(record: RecordLike, format: OutputFormat, fields?: readonly string[]): string;
+/**
+ * Emit a CSV / TSV header row from a list of column names.
+ */
+export declare function csvHeader(columns: readonly string[], format: 'csv' | 'tsv'): string;
+export declare function validateInputFormat(s: string | undefined): InputFormat | undefined;
+export declare function validateOutputFormat(s: string | undefined): OutputFormat | undefined;
+//# sourceMappingURL=formats.d.ts.map

package/dist/cli/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/cli/formats.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAE3D,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAMvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU,EAAE,CAoD5E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,CAWR;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAKnF;AA2BD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAIlF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAIpF"}

package/dist/cli/formats.js

@@ -0,0 +1,145 @@
+// Input/output format adapters for the CLI (#145).
+//
+// `upsert` accepts JSON | TOML | CSV input.
+// `query` and `read` produce JSON | TOML | CSV | TSV output.
+// Encoding (`--encoding`) controls how on-disk inputs are decoded.
+import { parse as csvParse } from 'csv-parse/sync';
+import { stringify as csvStringify } from 'csv-stringify/sync';
+import { stringifyRecord, parseToml } from '../toml.js';
+import { RECORD_PATH_KEY, RECORD_SHEET_KEY } from '../sheet.js';
+/** Map a file extension (without the dot) to an input format. */
+export function inferInputFormat(input) {
+    if (!input || input === '-')
+        return 'json';
+    const lower = input.toLowerCase();
+    if (lower.endsWith('.toml'))
+        return 'toml';
+    if (lower.endsWith('.csv'))
+        return 'csv';
+    return 'json';
+}
+/**
+ * Parse input text into an array of records, given the format.
+ *
+ * - JSON: a single object, an array, or JSONL (one object per line).
+ * - TOML: either a single record (the document maps to one record), an array
+ *   of records under `[[records]]`, or any top-level table where every value
+ *   is itself a table (each becomes a record keyed by table name).
+ * - CSV: the first row is the header. Each subsequent row is one record.
+ *   Numeric strings stay as strings — type coercion belongs in the consumer
+ *   schema, not in CSV parsing.
+ */
+export function parseRecords(text, format) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [];
+    if (format === 'json') {
+        if (trimmed.startsWith('[')) {
+            const arr = JSON.parse(trimmed);
+            if (!Array.isArray(arr))
+                throw new Error('expected JSON array of records');
+            return arr;
+        }
+        if (trimmed.startsWith('{')) {
+            return [JSON.parse(trimmed)];
+        }
+        // JSONL fallback
+        return trimmed
+            .split('\n')
+            .filter((line) => line.trim().length > 0)
+            .map((line) => JSON.parse(line));
+    }
+    if (format === 'toml') {
+        const parsed = parseToml(text);
+        // [[records]] convention: an array of tables under the key "records"
+        if ('records' in parsed &&
+            Array.isArray(parsed.records)) {
+            return parsed.records;
+        }
+        // If every top-level value is a table, treat each as a record
+        const entries = Object.entries(parsed);
+        const allTables = entries.length > 0 &&
+            entries.every(([, v]) => typeof v === 'object' && v !== null && !Array.isArray(v) && !(v instanceof Date));
+        if (allTables) {
+            return entries.map(([, v]) => v);
+        }
+        // Otherwise, treat the document as a single record.
+        return [parsed];
+    }
+    // CSV
+    const rows = csvParse(text, {
+        columns: true,
+        skip_empty_lines: true,
+        relax_quotes: true,
+        trim: true,
+    });
+    return rows.map((row) => ({ ...row }));
+}
+/**
+ * Stringify a single record into one piece of output text for the given
+ * format. For CSV / TSV, the caller drives header emission; this function
+ * formats one row only.
+ */
+export function stringifyRecord_text(record, format, fields) {
+    const projected = projectRecord(record, fields);
+    if (format === 'json')
+        return `${JSON.stringify(projected)}\n`;
+    if (format === 'toml')
+        return stringifyRecord(stripGitsheetsSymbols(projected));
+    if (format === 'csv' || format === 'tsv') {
+        return csvStringify([projected], {
+            header: false,
+            delimiter: format === 'tsv' ? '\t' : ',',
+        });
+    }
+    throw new Error(`unsupported output format: ${String(format)}`);
+}
+/**
+ * Emit a CSV / TSV header row from a list of column names.
+ */
+export function csvHeader(columns, format) {
+    return csvStringify([columns], {
+        header: false,
+        delimiter: format === 'tsv' ? '\t' : ',',
+    });
+}
+/**
+ * Project a record to a subset of fields (in given order). When `fields` is
+ * undefined the record is returned with symbol keys stripped but otherwise
+ * unchanged.
+ */
+function projectRecord(record, fields) {
+    const cleaned = stripGitsheetsSymbols(record);
+    if (!fields)
+        return cleaned;
+    const out = {};
+    for (const field of fields) {
+        if (field in cleaned)
+            out[field] = cleaned[field];
+    }
+    return out;
+}
+function stripGitsheetsSymbols(record) {
+    // Object spread retains string-keyed enumerable props, drops symbols.
+    // Defensive: also delete the well-known symbols in case a future change
+    // produces them in non-spread ways.
+    const out = { ...record };
+    delete out[RECORD_PATH_KEY];
+    delete out[RECORD_SHEET_KEY];
+    return out;
+}
+export function validateInputFormat(s) {
+    if (s === undefined)
+        return undefined;
+    if (s === 'json' || s === 'toml' || s === 'csv')
+        return s;
+    throw new Error(`--format must be one of: json, toml, csv (got "${s}")`);
+}
+export function validateOutputFormat(s) {
+    if (s === undefined)
+        return undefined;
+    if (s === 'json' || s === 'toml' || s === 'csv' || s === 'tsv')
+        return s;
+    throw new Error(`--format must be one of: json, toml, csv, tsv (got "${s}")`);
+}
+//# sourceMappingURL=formats.js.map

package/dist/cli/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../src/cli/formats.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAsOA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAwGlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AA0vBA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA6MlF"}