@crypto512/jicon-mcp 1.2.0 → 2.0.0

package/dist/utils/json-structure.d.ts

@@ -0,0 +1,121 @@
+/**
+ * JSON Structure Operations
+ *
+ * Provides unified structured access for JSON data (arrays and objects).
+ * Similar to XHTML buffer operations but for JSON data.
+ *
+ * Key design for ARRAYS:
+ * - Items get stable numeric IDs (stored in __jicon_id field)
+ * - IDs persist through insertions/deletions
+ * - Enables ID-based operations: append, insert, replace, remove
+ *
+ * Key design for OBJECTS:
+ * - Key-based access to top-level properties
+ * - No IDs needed - keys are the natural identifiers
+ */
+import type { JsonStructure } from "./content-buffer.js";
+/**
+ * Parse JSON string and build structure with IDs for array items
+ * If the JSON is an array, each item gets an ID.
+ * If it's an object with array fields, those arrays can be targeted by path.
+ */
+export declare function parseJsonStructure(jsonString: string): {
+    data: unknown;
+    structure: JsonStructure;
+    error?: string;
+};
+/**
+ * Create a new JSON buffer with structure tracking.
+ * Handles both arrays and objects:
+ * - Arrays: items get stable IDs for ID-based access
+ * - Objects: keys are extracted for key-based access
+ *
+ * @param data - Array or object to create structure for
+ * @returns content string and structure
+ */
+export declare function createJsonStructure(data: unknown): {
+    content: string;
+    structure: JsonStructure;
+};
+/**
+ * Append an item to a JSON array buffer
+ */
+export declare function appendToJsonArray(currentContent: string, currentStructure: JsonStructure, newItem: unknown): {
+    content: string;
+    structure: JsonStructure;
+    insertedId: number;
+    error?: string;
+};
+/**
+ * Insert an item into a JSON array relative to an existing item
+ */
+export declare function insertIntoJsonArray(currentContent: string, currentStructure: JsonStructure, newItem: unknown, targetId: number, position: "before" | "after"): {
+    content: string;
+    structure: JsonStructure;
+    insertedId: number;
+    error?: string;
+};
+/**
+ * Replace an item in a JSON array by ID
+ */
+export declare function replaceInJsonArray(currentContent: string, currentStructure: JsonStructure, targetId: number, newValue: unknown): {
+    content: string;
+    structure: JsonStructure;
+    error?: string;
+};
+/**
+ * Remove an item from a JSON array by ID
+ */
+export declare function removeFromJsonArray(currentContent: string, currentStructure: JsonStructure, targetId: number): {
+    content: string;
+    structure: JsonStructure;
+    error?: string;
+};
+/**
+ * Get an item from a JSON array by ID (without the internal ID field)
+ */
+export declare function getItemById(currentContent: string, currentStructure: JsonStructure, targetId: number): {
+    item: unknown;
+    error?: string;
+};
+/**
+ * Get all items from a JSON array buffer (without internal ID fields)
+ * For export/serialization
+ */
+export declare function getCleanItems(currentContent: string): {
+    items: unknown[];
+    error?: string;
+};
+/**
+ * Rebuild structure from content (for recovery/validation)
+ */
+export declare function rebuildStructure(currentContent: string): {
+    structure: JsonStructure;
+    error?: string;
+};
+/**
+ * Get a value from a JSON object by key
+ */
+export declare function getByKey(currentContent: string, currentStructure: JsonStructure, key: string): {
+    value: unknown;
+    error?: string;
+};
+/**
+ * Get items from a JSON array by index range (batch access)
+ * Returns items without internal __jicon_id fields
+ */
+export declare function getItemsByRange(currentContent: string, currentStructure: JsonStructure, start: number, count: number): {
+    items: Array<{
+        id: number;
+        item: unknown;
+    }>;
+    progress: {
+        start: number;
+        count: number;
+        total: number;
+        hasMore: boolean;
+        nextStart?: number;
+    };
+    error?: string;
+};
+//# sourceMappingURL=json-structure.d.ts.map

package/dist/utils/json-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-structure.d.ts","sourceRoot":"","sources":["../../src/utils/json-structure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAuFvE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG;IACtD,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA6DA;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;CAC1B,CA8DA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,aAAa,EAC/B,OAAO,EAAE,OAAO,GACf;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA8CA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,aAAa,EAC/B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAC3B;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAsEA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,aAAa,EAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,GAChB;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAsDA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,aAAa,EAC/B,QAAQ,EAAE,MAAM,GACf;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA8CA;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,aAAa,EAC/B,QAAQ,EAAE,MAAM,GACf;IACD,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAiCA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG;IACrD,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA0BA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG;IACxD,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAkDA;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,aAAa,EAC/B,GAAG,EAAE,MAAM,GACV;IACD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAgCA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,aAAa,EAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ;IACD,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5C,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA8CA"}