@plurnk/plurnk-mimetypes-text-csv 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PossumTech Laboratories, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @plurnk/plurnk-mimetypes-text-csv
+
+`text/csv` mimetype handler for the [plurnk](https://github.com/plurnk) ecosystem.
+
+## install
+
+```
+npm i @plurnk/plurnk-mimetypes-text-csv
+```
+
+## what it does
+
+- `validate(content)` walks all records with the bundled RFC 4180 tokenizer; throws on unbalanced quotes or non-uniform column count.
+- `extract(content)` emits one `field` symbol per header column (the first record), at line 1.
+
+CSV's structural signal is the header row's column names — that's what surfaces in `symbols`. The actual data body is best previewed via the framework's raw-content fallback.
+
+## why no parser dependency
+
+CSV is the textbook case where RFC 4180 fits in <100 LOC of careful hand-rolled tokenizer and the available libraries all carry transitive dependencies that don't earn their keep for header extraction. The tokenizer (`parseAll`) is exported for re-use.
+
+## license
+
+MIT.

package/dist/TextCsv.d.ts

@@ -0,0 +1,8 @@
+import { BaseHandler } from "@plurnk/plurnk-mimetypes";
+import type { MimeSymbol } from "@plurnk/plurnk-mimetypes";
+export default class TextCsv extends BaseHandler {
+    validate(content: string): void;
+    extract(content: string): MimeSymbol[];
+}
+export declare function parseAll(content: string): string[][];
+//# sourceMappingURL=TextCsv.d.ts.map

package/dist/TextCsv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextCsv.d.ts","sourceRoot":"","sources":["../src/TextCsv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAY3D,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAa/B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;CAUzC;AAMD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAyEpD"}

package/dist/TextCsv.js

@@ -0,0 +1,109 @@
+import { BaseHandler } from "@plurnk/plurnk-mimetypes";
+// text/csv handler. CSV's structural signal is the header row's column names;
+// no library dependency — RFC 4180 is small enough to hand-roll correctly.
+//
+// validate(): walk all records, throw on unbalanced quotes or non-uniform
+//             column count across rows.
+// extract(): emit one `field` symbol per header column, at line 1.
+//
+// Quote-stripped header tokens become field names. Empty headers become
+// empty-named symbols (still emitted — surfacing the column count is
+// meaningful even when headers are blank).
+export default class TextCsv extends BaseHandler {
+    validate(content) {
+        const records = parseAll(content);
+        if (records.length === 0)
+            return;
+        const expected = records[0].length;
+        for (let i = 1; i < records.length; i += 1) {
+            if (records[i].length !== expected) {
+                throw new SyntaxError(`CSV row ${i + 1} has ${records[i].length} columns; header has ${expected}`);
+            }
+        }
+    }
+    extract(content) {
+        const records = parseAll(content);
+        if (records.length === 0)
+            return [];
+        return records[0].map((name) => ({
+            name,
+            kind: "field",
+            line: 1,
+            endLine: 1,
+        }));
+    }
+}
+// RFC 4180 tokenizer. Walks character by character, tracking quoted state,
+// handling escaped double-quotes inside quoted fields, accepting CR/LF/CRLF
+// line endings between unquoted records, and treating commas inside quoted
+// fields as literal characters. Throws on unbalanced quotes.
+export function parseAll(content) {
+    const records = [];
+    let row = [];
+    let field = "";
+    let inQuotes = false;
+    let i = 0;
+    while (i < content.length) {
+        const ch = content[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (i + 1 < content.length && content[i + 1] === '"') {
+                    // Escaped double-quote inside a quoted field.
+                    field += '"';
+                    i += 2;
+                    continue;
+                }
+                // End of quoted field.
+                inQuotes = false;
+                i += 1;
+                continue;
+            }
+            field += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === '"') {
+            inQuotes = true;
+            i += 1;
+            continue;
+        }
+        if (ch === ",") {
+            row.push(field);
+            field = "";
+            i += 1;
+            continue;
+        }
+        if (ch === "\r") {
+            // Treat CR (alone) or CRLF as record terminator.
+            row.push(field);
+            field = "";
+            records.push(row);
+            row = [];
+            i += 1;
+            if (i < content.length && content[i] === "\n")
+                i += 1;
+            continue;
+        }
+        if (ch === "\n") {
+            row.push(field);
+            field = "";
+            records.push(row);
+            row = [];
+            i += 1;
+            continue;
+        }
+        field += ch;
+        i += 1;
+    }
+    if (inQuotes) {
+        throw new SyntaxError("Unbalanced quote in CSV content");
+    }
+    // Flush the final partial row if there's content (handles files without
+    // a trailing newline).
+    if (field !== "" || row.length > 0) {
+        row.push(field);
+        records.push(row);
+    }
+    return records;
+}
+//# sourceMappingURL=TextCsv.js.map

package/dist/TextCsv.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as TextCsv } from "./TextCsv.ts";
+export { default } from "./TextCsv.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as TextCsv } from "./TextCsv.js";
+export { default } from "./TextCsv.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+    "name": "@plurnk/plurnk-mimetypes-text-csv",
+    "version": "0.1.0",
+    "description": "text/csv mimetype handler for plurnk-service. Homebrew RFC 4180 tokenizer; no parser dependency.",
+    "type": "module",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "plurnk": {
+        "kind": "mimetype",
+        "handlers": [
+            { "name": "text/csv", "glyph": "📊", "extensions": [".csv"] }
+        ]
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --test src/**/*.test.ts",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist",
+        "prepare": "npm run build"
+    },
+    "dependencies": {
+        "@plurnk/plurnk-mimetypes": "^0.2.1"
+    },
+    "devDependencies": {
+        "@types/node": "^25.8.0",
+        "typescript": "^6.0.3"
+    }
+}