@plurnk/plurnk-mimetypes-application-json 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PossumTech Laboratories
+
+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,29 @@
+# @plurnk/plurnk-mimetypes-application-json
+
+`application/json` mimetype handler for the [plurnk](https://github.com/plurnk) ecosystem.
+
+## install
+
+```
+npm install @plurnk/plurnk-mimetypes-application-json
+```
+
+plurnk-service discovers this handler automatically via its `plurnk.kind: "mimetype"` declaration.
+
+## what it does
+
+- `validate(content)` throws on malformed JSON (via `JSON.parse`). Per framework error policy, this error propagates to the caller as a contract violation.
+- `extract(content)` returns the document's top-level keys as `field` symbols. Nested keys are out of scope; a JSON document's "API surface" is its top level. Line numbers come from a single-pass scan of the raw source.
+- Array and scalar JSON roots have no named top-level keys → empty `Symbol[]`.
+
+## development
+
+```
+npm install
+npm run build
+npm test
+```
+
+## license
+
+MIT.

package/dist/ApplicationJson.d.ts

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

package/dist/ApplicationJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationJson.d.ts","sourceRoot":"","sources":["../src/ApplicationJson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAmB3D,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAW;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;CAoBzC"}

package/dist/ApplicationJson.js

@@ -0,0 +1,64 @@
+import { BaseHandler } from "@plurnk/plurnk-mimetypes";
+// application/json handler. Two responsibilities beyond BaseHandler defaults:
+//
+//   1. validate(content) throws on malformed JSON. Per framework error policy
+//      (SPEC §7), validate errors propagate through Mimetypes.process to the
+//      caller — this is the contract for "the consumer asserted this is JSON,
+//      but it isn't."
+//
+//   2. extract(content) returns the document's top-level keys as `field`
+//      symbols. Matches the legacy ANTLR-backed policy: a JSON document's
+//      "API surface" is its top-level keys; nested structure is recursive
+//      and out of scope for the structural outline. Array and scalar roots
+//      have no named top-level keys → empty Symbol[].
+//
+// Line numbers are derived from a single-pass scan of the raw source — JSON.parse
+// itself doesn't preserve positions. The scan is approximate (a `"key":` pattern
+// inside a string value could in principle be mis-matched as a key) but accurate
+// for well-formed documents in practical use.
+export default class ApplicationJson extends BaseHandler {
+    validate(content) {
+        JSON.parse(content);
+    }
+    extract(content) {
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch {
+            return [];
+        }
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            return [];
+        }
+        const keys = Object.keys(parsed);
+        const lineMap = mapKeysToLines(content, keys);
+        return keys.map((name) => {
+            const line = lineMap.get(name) ?? 1;
+            return { name, kind: "field", line, endLine: line };
+        });
+    }
+}
+// Scan content for the first occurrence of each `"key":` pattern (key followed
+// by optional whitespace and a colon, signaling a key position rather than a
+// value). Returns key → 1-indexed line number.
+function mapKeysToLines(content, keys) {
+    const result = new Map();
+    const remaining = new Set(keys);
+    if (remaining.size === 0)
+        return result;
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length && remaining.size > 0; i += 1) {
+        const line = lines[i];
+        for (const key of remaining) {
+            const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            const pattern = new RegExp(`"${escaped}"\\s*:`);
+            if (pattern.test(line)) {
+                result.set(key, i + 1);
+                remaining.delete(key);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=ApplicationJson.js.map

package/dist/ApplicationJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationJson.js","sourceRoot":"","sources":["../src/ApplicationJson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,8EAA8E;AAC9E,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAC9E,sBAAsB;AACtB,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,sDAAsD;AACtD,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AACjF,iFAAiF;AACjF,8CAA8C;AAC9C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAW;IACpD,QAAQ,CAAC,OAAe;QACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,OAAe;QACnB,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzE,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAE9C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACrB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjE,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAED,+EAA+E;AAC/E,6EAA6E;AAC7E,+CAA+C;AAC/C,SAAS,cAAc,CAAC,OAAe,EAAE,IAAc;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAExC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,OAAO,QAAQ,CAAC,CAAC;YAChD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACvB,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ApplicationJson } from "./ApplicationJson.ts";
+export { default } from "./ApplicationJson.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,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as ApplicationJson } from "./ApplicationJson.js";
+export { default } from "./ApplicationJson.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,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+    "name": "@plurnk/plurnk-mimetypes-application-json",
+    "version": "0.1.0",
+    "description": "application/json mimetype handler for plurnk-service.",
+    "type": "module",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "plurnk": {
+        "kind": "mimetype",
+        "name": "application/json",
+        "glyph": "📋",
+        "extensions": [".json"]
+    },
+    "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.1.1"
+    },
+    "devDependencies": {
+        "@types/node": "^25.8.0",
+        "typescript": "^6.0.3"
+    }
+}