@procedures/json 0.4.0 → 0.6.0

package/dist/value.js.map

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

package/package.json

@@ -1,12 +1,13 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/json",
-  "version": "0.4.0",
-  "description": "Pure JSON and YAML procedures: a query with JSON Pointer or a path, JSON Patch, a diff, a merge patch, a JSON Schema check, and YAML to JSON and back.",
+  "version": "0.6.0",
+  "description": "Pure JSON, YAML and CSV procedures: a query with JSON Pointer or a path, JSON Patch, a diff, a merge patch, a JSON Schema check, YAML to JSON and back, and CSV (RFC 4180) to rows and back.",
   "keywords": [
     "procedures",
     "json",
     "yaml",
+    "csv",
     "json-pointer",
     "json-patch",
     "merge-patch",
@@ -69,8 +70,8 @@
     "procedures": "./dist/register.js"
   },
   "dependencies": {
-    "@procedures/client": "0.4.0",
-    "@procedures/compiler": "0.4.0",
+    "@procedures/client": "0.6.0",
+    "@procedures/compiler": "0.6.0",
     "yaml": "^2.9.1",
     "zod": "^4.6.5"
   },

package/src/csv.ts

@@ -0,0 +1,216 @@
+/**
+ * A CSV reader and writer (RFC 4180), without dependencies.
+ *
+ * - A field in double quotes can have the delimiter, a line break and a doubled quote (`""`).
+ * - A line break is CRLF, LF or CR. A line break at the end of the text does not start a row.
+ * - The parse removes a byte order mark at the start of the text.
+ * - A quote in a field without quotes is a normal character, as in most readers.
+ * - Each object that the parse makes has own data properties only, so a column `__proto__` stays data.
+ */
+
+import { hasOwn, isPlainObject, JsonError, put } from "./value.js";
+
+/** A row of `parseCsv` with `header`: the fields by the names of the columns. */
+export type CsvRecord = Record<string, string>;
+
+/** A value that `stringifyCsv` writes as a field. Null and undefined give an empty field. */
+export type CsvCell = string | number | boolean | null | undefined;
+
+/** The options of `parseCsv`. */
+export interface CsvParseOptions {
+  /** The character between two fields. The default is a comma. */
+  readonly delimiter?: string | undefined;
+  /** True: the first row has the names of the columns, and each other row becomes an object. The default is false. */
+  readonly header?: boolean | undefined;
+  /** True: the parse removes the white space at the start and at the end of each field. The default is false. */
+  readonly trim?: boolean | undefined;
+  /** False: an empty line gives a row with one empty field. The default (true) skips each empty line. */
+  readonly skipEmptyLines?: boolean | undefined;
+}
+
+/** The options of `stringifyCsv`. */
+export interface CsvStringifyOptions {
+  /** The character between two fields. The default is a comma. */
+  readonly delimiter?: string | undefined;
+  /**
+   * The names of the columns. For rows that are objects, the names select the keys and give their
+   * order. For rows that are arrays, the names are the first row.
+   */
+  readonly columns?: readonly string[] | undefined;
+  /** False: the text has no row with the names of the columns. The default is true. */
+  readonly header?: boolean | undefined;
+  /** The line break after each row: `"\r\n"` (the default, as RFC 4180 tells) or `"\n"`. */
+  readonly lineBreak?: "\r\n" | "\n" | undefined;
+}
+
+/** The byte order mark. */
+const BOM = "";
+
+/** One row of the text, before the header. */
+interface RawRow {
+  readonly fields: string[];
+  /** The line where the row starts, from 1. */
+  readonly line: number;
+  /** True for an empty line: one field without quotes and without text. */
+  readonly empty: boolean;
+}
+
+/** The delimiter of the options. It is one character, and not a quote or a line break. */
+function delimiterOf(delimiter: string | undefined, label: string): string {
+  if (delimiter === undefined) return ",";
+  if (delimiter.length !== 1 || delimiter === '"' || delimiter === "\r" || delimiter === "\n") {
+    throw new JsonError("INVALID_CSV", `${label}: the delimiter ${JSON.stringify(delimiter)} must be one character, and not a quote or a line break`);
+  }
+  return delimiter;
+}
+
+/** The number of line breaks in a text. CRLF is one line break. */
+const lineBreaks = (text: string): number => text.match(/\r\n|\r|\n/g)?.length ?? 0;
+
+/** True for a space or a tab that is not the delimiter. */
+const isBlank = (char: string | undefined, delimiter: string): boolean => (char === " " || char === "\t") && char !== delimiter;
+
+/** This function reads the rows of a CSV text. */
+function readRows(text: string, delimiter: string, trim: boolean): RawRow[] {
+  const rows: RawRow[] = [];
+  const end = text.length;
+  let at = 0;
+  let line = 1;
+  while (at < end) {
+    const start = line;
+    const fields: string[] = [];
+    let quoted = false;
+    for (;;) {
+      let next = at;
+      if (trim) while (isBlank(text[next], delimiter)) next += 1;
+      if (text[next] === '"') {
+        // A field in quotes: it ends at a quote that is not doubled
+        const open = line;
+        let value = "";
+        let from = next + 1;
+        for (;;) {
+          const quote = text.indexOf('"', from);
+          if (quote === -1) throw new JsonError("INVALID_CSV", `csv.parse: the quote at line ${open} has no closing quote`);
+          value += text.slice(from, quote);
+          if (text[quote + 1] === '"') {
+            value += '"';
+            from = quote + 2;
+          } else {
+            from = quote + 1;
+            break;
+          }
+        }
+        line += lineBreaks(text.slice(next, from));
+        if (trim) while (isBlank(text[from], delimiter)) from += 1;
+        const after = text[from];
+        if (after !== undefined && after !== delimiter && after !== "\r" && after !== "\n") {
+          throw new JsonError("INVALID_CSV", `csv.parse: line ${line} has the character ${JSON.stringify(after)} after the closing quote of a field`);
+        }
+        fields.push(trim ? value.trim() : value);
+        quoted = true;
+        at = from;
+      } else {
+        let stop = at;
+        while (stop < end && text[stop] !== delimiter && text[stop] !== "\r" && text[stop] !== "\n") stop += 1;
+        const value = text.slice(at, stop);
+        fields.push(trim ? value.trim() : value);
+        at = stop;
+      }
+      if (text[at] !== delimiter) break;
+      at += 1;
+    }
+    if (text[at] === "\r" || text[at] === "\n") {
+      at += text[at] === "\r" && text[at + 1] === "\n" ? 2 : 1;
+      line += 1;
+    }
+    rows.push({ fields, line: start, empty: fields.length === 1 && !quoted && fields[0] === "" });
+  }
+  return rows;
+}
+
+/** This function makes the objects of the rows with the first row as the names of the columns. */
+function records(rows: readonly RawRow[]): CsvRecord[] {
+  const [head, ...body] = rows;
+  if (head === undefined) return [];
+  const names = head.fields;
+  const seen = new Set<string>();
+  for (const name of names) {
+    if (seen.has(name)) throw new JsonError("INVALID_CSV", `csv.parse: the header has the column ${JSON.stringify(name)} two times`);
+    seen.add(name);
+  }
+  return body.map((row) => {
+    if (row.fields.length > names.length) {
+      throw new JsonError("INVALID_CSV", `csv.parse: the row at line ${row.line} has ${row.fields.length} fields, and the header has ${names.length}`);
+    }
+    const record: CsvRecord = {};
+    names.forEach((name, index) => put(record, name, row.fields[index] ?? ""));
+    return record;
+  });
+}
+
+/**
+ * This function parses CSV text (RFC 4180) into rows. Each row is an array of its fields. With
+ * `header`, the first row gives the names of the columns, and each other row is an object. A
+ * row with fewer fields gets empty text for the missing columns. Bad text throws `INVALID_CSV`.
+ */
+export function parseCsv(text: string, options: CsvParseOptions & { readonly header: true }): CsvRecord[];
+export function parseCsv(text: string, options?: CsvParseOptions & { readonly header?: false | undefined }): string[][];
+export function parseCsv(text: string, options?: CsvParseOptions): string[][] | CsvRecord[];
+export function parseCsv(text: string, options: CsvParseOptions = {}): string[][] | CsvRecord[] {
+  const delimiter = delimiterOf(options.delimiter, "csv.parse");
+  const body = text.startsWith(BOM) ? text.slice(BOM.length) : text;
+  const skip = options.skipEmptyLines ?? true;
+  const rows = readRows(body, delimiter, options.trim ?? false).filter((row) => !(skip && row.empty));
+  return options.header ? records(rows) : rows.map((row) => row.fields);
+}
+
+/** The text of one field. */
+function cellText(value: unknown, where: string): string {
+  if (value === null || value === undefined) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "boolean") return value ? "true" : "false";
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  throw new JsonError("INVALID_CSV", `csv.stringify: ${where} is not a string, a finite number, a boolean or null`);
+}
+
+/** The CSV form of one row. A field gets quotes when it has the delimiter, a quote or a line break. */
+function rowText(cells: readonly string[], delimiter: string): string {
+  // A row of one empty field gets quotes: an empty line is not a row for the parse
+  if (cells.length === 1 && cells[0] === "") return '""';
+  return cells
+    .map((cell) => (cell.includes(delimiter) || cell.includes('"') || cell.includes("\r") || cell.includes("\n") ? `"${cell.replaceAll('"', '""')}"` : cell))
+    .join(delimiter);
+}
+
+/**
+ * This function writes rows as CSV text (RFC 4180). The rows are all arrays or all objects. For
+ * objects, the first row has the names of the columns: by default, each key in the order that
+ * the rows first give it. Each row ends with a line break. Bad rows throw `INVALID_CSV`.
+ */
+export function stringifyCsv(rows: readonly (readonly CsvCell[])[] | readonly Readonly<Record<string, CsvCell>>[], options: CsvStringifyOptions = {}): string {
+  const delimiter = delimiterOf(options.delimiter, "csv.stringify");
+  const lineBreak = options.lineBreak ?? "\r\n";
+  if (lineBreak !== "\r\n" && lineBreak !== "\n") throw new JsonError("INVALID_CSV", 'csv.stringify: the line break must be "\\r\\n" or "\\n"');
+  const list: readonly unknown[] = rows;
+  const arrays = list.every((row) => Array.isArray(row));
+  if (!arrays && !list.every((row) => isPlainObject(row))) {
+    throw new JsonError("INVALID_CSV", "csv.stringify: the rows must be all arrays or all objects");
+  }
+  const lines: string[] = [];
+  let columns = options.columns;
+  if (!arrays && columns === undefined) {
+    const names = new Set<string>();
+    for (const row of list as readonly Record<string, unknown>[]) for (const key of Object.keys(row)) names.add(key);
+    columns = [...names];
+  }
+  if (columns !== undefined && options.header !== false && columns.length > 0) {
+    lines.push(rowText(columns.map((name, index) => cellText(name, `column ${index + 1} of the header`)), delimiter));
+  }
+  list.forEach((row, index) => {
+    const cells = arrays
+      ? (row as readonly unknown[]).map((value, column) => cellText(value, `field ${column + 1} of row ${index + 1}`))
+      : (columns ?? []).map((name) => cellText(hasOwn(row as object, name) ? (row as Record<string, unknown>)[name] : undefined, `the field ${JSON.stringify(name)} of row ${index + 1}`));
+    lines.push(rowText(cells, delimiter));
+  });
+  return lines.map((text) => text + lineBreak).join("");
+}

package/src/index.ts

@@ -3,6 +3,7 @@ export * from "./module.js";
 export * from "./types.js";
 export { jsonQuery, jsonPatch, jsonDiff, jsonMerge, jsonValidate } from "./procedures/json/index.js";
 export { yamlParse, yamlStringify } from "./procedures/yaml/index.js";
+export { csvParse, csvStringify } from "./procedures/csv/index.js";
 // The functions behind the procedures, for a program in the same process
 export { assertJson, cloneJson, jsonEqual, JsonError, PROTOTYPE_KEYS, formatPointer, escapeToken, type JsonErrorCode } from "./value.js";
 export { parsePointer, lookup, arrayIndex, type Lookup } from "./pointer.js";
@@ -12,3 +13,4 @@ export { diffJson } from "./diff.js";
 export { mergePatch } from "./merge.js";
 export { validateJson, NOT_EXAMINED, type ValidationIssue, type ValidationResult } from "./schema.js";
 export { parseYaml, stringifyYaml, type YamlParseOptions, type YamlStringifyOptions } from "./yaml.js";
+export { parseCsv, stringifyCsv, type CsvCell, type CsvParseOptions, type CsvRecord, type CsvStringifyOptions } from "./csv.js";

package/src/module.ts

@@ -16,7 +16,13 @@ import { jsonMerge } from "./procedures/json/merge.js";
 import { jsonValidate } from "./procedures/json/validate.js";
 import { yamlParse } from "./procedures/yaml/parse.js";
 import { yamlStringify } from "./procedures/yaml/stringify.js";
+import { csvParse } from "./procedures/csv/parse.js";
+import { csvStringify } from "./procedures/csv/stringify.js";
 import type {
+  CsvParseInput,
+  CsvParseOutput,
+  CsvStringifyInput,
+  CsvStringifyOutput,
   JsonDiffInput,
   JsonDiffOutput,
   JsonMergeInput,
@@ -109,6 +115,31 @@ const YamlStringifyInputSchema = z.object({
 
 const YamlStringifyOutputSchema = z.object({ text: z.string().describe("The YAML text") });
 
+const delimiter = z.string().length(1).optional().describe("The character between two fields (default: a comma)");
+
+const CsvParseInputSchema = z.object({
+  text: z.string().describe("The CSV text (RFC 4180)"),
+  header: z.boolean().optional().describe("True: the first row has the names of the columns, and each other row is an object"),
+  delimiter,
+  trim: z.boolean().optional().describe("True: remove the white space at the start and at the end of each field"),
+  skipEmptyLines: z.boolean().optional().describe("False: an empty line gives a row with one empty field (default: true, skip each empty line)"),
+});
+
+// The schema does not copy the rows, so a column `__proto__` stays data. The handler gives the type of the rows
+const CsvParseOutputSchema = z.object({
+  rows: z.array(json("A row: an array of fields, or with header an object of fields by column name")).describe("The rows, in the order of the text"),
+}) as z.ZodType<CsvParseOutput>;
+
+const CsvStringifyInputSchema = z.object({
+  rows: z.array(json("A row: an array of fields, or an object of fields by column name")).describe("The rows: all arrays or all objects. A field is a string, a number, a boolean or null"),
+  columns: z.array(z.string()).optional().describe("The names of the columns. For objects, they select the keys and give their order. For arrays, they are the first row"),
+  header: z.boolean().optional().describe("False: no row with the names of the columns (default: true)"),
+  delimiter,
+  lineBreak: z.enum(["\r\n", "\n"]).optional().describe("The line break after each row (default: CRLF)"),
+});
+
+const CsvStringifyOutputSchema = z.object({ text: z.string().describe("The CSV text") });
+
 // =============================================================================
 // Procedures
 // =============================================================================
@@ -211,6 +242,34 @@ const yamlStringifyProcedure = createProcedure()
   .handler(async (input: YamlStringifyInput): Promise<YamlStringifyOutput> => yamlStringify(input))
   .build();
 
+const csvParseProcedure = createProcedure()
+  .path(["csv", "parse"])
+  .input(zodAdapter<CsvParseInput>(CsvParseInputSchema))
+  .output(zodAdapter<CsvParseOutput>(CsvParseOutputSchema))
+  .meta({
+    description: "Parse CSV text into rows",
+    args: ["text"],
+    shorts: { delimiter: "d", trim: "t" },
+    output: "json",
+    effects: PURE_EFFECTS,
+  })
+  .handler(async (input: CsvParseInput): Promise<CsvParseOutput> => csvParse(input))
+  .build();
+
+const csvStringifyProcedure = createProcedure()
+  .path(["csv", "stringify"])
+  .input(zodAdapter<CsvStringifyInput>(CsvStringifyInputSchema))
+  .output(zodAdapter<CsvStringifyOutput>(CsvStringifyOutputSchema))
+  .meta({
+    description: "Write rows as CSV text",
+    args: [],
+    shorts: { delimiter: "d" },
+    output: "json",
+    effects: PURE_EFFECTS,
+  })
+  .handler(async (input: CsvStringifyInput): Promise<CsvStringifyOutput> => csvStringify(input))
+  .build();
+
 /**
  * The module of this package, for `createRegistry()`: its procedures as data. Importing this
  * file registers nothing.
@@ -223,6 +282,8 @@ export const jsonModule: ProcedureModule = defineModule("@procedures/json", [
   jsonValidateProcedure,
   yamlParseProcedure,
   yamlStringifyProcedure,
+  csvParseProcedure,
+  csvStringifyProcedure,
 ]);
 
 export default jsonModule;

package/src/procedures/csv/index.ts

@@ -0,0 +1,2 @@
+export { csvParse } from "./parse.js";
+export { csvStringify } from "./stringify.js";

package/src/procedures/csv/parse.ts

@@ -0,0 +1,23 @@
+/**
+ * csv.parse procedure
+ *
+ * Parse CSV text (RFC 4180) into rows. With `header`, the first row gives the names of the
+ * columns, and each other row is an object.
+ */
+
+import { parseCsv } from "../../csv.js";
+import type { CsvParseInput, CsvParseOutput } from "../../types.js";
+
+/**
+ * Parse CSV text into rows
+ */
+export async function csvParse(input: CsvParseInput): Promise<CsvParseOutput> {
+  return {
+    rows: parseCsv(input.text, {
+      header: input.header,
+      delimiter: input.delimiter,
+      trim: input.trim,
+      skipEmptyLines: input.skipEmptyLines,
+    }),
+  };
+}

package/src/procedures/csv/stringify.ts

@@ -0,0 +1,25 @@
+/**
+ * csv.stringify procedure
+ *
+ * Write rows as CSV text (RFC 4180). The rows are all arrays or all objects. `csv.parse` of the
+ * text gives the rows again.
+ */
+
+import { stringifyCsv, type CsvCell } from "../../csv.js";
+import type { CsvStringifyInput, CsvStringifyOutput } from "../../types.js";
+
+/**
+ * Write rows as CSV text
+ */
+export async function csvStringify(input: CsvStringifyInput): Promise<CsvStringifyOutput> {
+  // stringifyCsv examines each row and each field
+  const rows = input.rows as readonly (readonly CsvCell[])[];
+  return {
+    text: stringifyCsv(rows, {
+      delimiter: input.delimiter,
+      columns: input.columns,
+      header: input.header,
+      lineBreak: input.lineBreak,
+    }),
+  };
+}

package/src/types.ts

@@ -125,3 +125,45 @@ export interface YamlStringifyInput {
 export interface YamlStringifyOutput {
   text: string;
 }
+
+// =============================================================================
+// csv.parse Types - Parse CSV text into rows
+// =============================================================================
+
+export interface CsvParseInput {
+  text: string;
+  /** True: the first row has the names of the columns, and each other row is an object. */
+  header?: boolean | undefined;
+  /** The character between two fields. The default is a comma. */
+  delimiter?: string | undefined;
+  /** True: the parse removes the white space at the start and at the end of each field. */
+  trim?: boolean | undefined;
+  /** False: an empty line gives a row with one empty field. The default skips each empty line. */
+  skipEmptyLines?: boolean | undefined;
+}
+
+export interface CsvParseOutput {
+  /** The rows: arrays of fields, or with `header`, objects of fields by the names of the columns. */
+  rows: string[][] | Record<string, string>[];
+}
+
+// =============================================================================
+// csv.stringify Types - Write rows as CSV text
+// =============================================================================
+
+export interface CsvStringifyInput {
+  /** The rows: all arrays of fields, or all objects of fields by the names of the columns. */
+  rows: unknown[];
+  /** The names of the columns. For objects, they select the keys and give their order. For arrays, they are the first row. */
+  columns?: string[] | undefined;
+  /** False: the text has no row with the names of the columns. */
+  header?: boolean | undefined;
+  /** The character between two fields. The default is a comma. */
+  delimiter?: string | undefined;
+  /** The line break after each row. The default is CRLF. */
+  lineBreak?: "\r\n" | "\n" | undefined;
+}
+
+export interface CsvStringifyOutput {
+  text: string;
+}

package/src/value.ts

@@ -27,7 +27,9 @@ export type JsonErrorCode =
   /** The YAML text is not valid, or it has a value that JSON does not have. */
   | "INVALID_YAML"
   /** The JSON Schema is not a schema. */
-  | "INVALID_SCHEMA";
+  | "INVALID_SCHEMA"
+  /** The CSV text is not valid, or a row or an option of the CSV writer is not valid. */
+  | "INVALID_CSV";
 
 /** An error of a procedure of this package. A server sends it with its own code, for example `NOT_JSON`. */
 export class JsonError extends Error {