tersejson 0.2.1 → 0.3.1

package/dist/server-memory.mjs

@@ -0,0 +1,451 @@
+// src/types.ts
+function isTersePayload(value) {
+  return typeof value === "object" && value !== null && "__terse__" in value && value.__terse__ === true && "v" in value && "k" in value && "d" in value;
+}
+
+// src/core.ts
+function alphaGenerator(index) {
+  let key = "";
+  let remaining = index;
+  do {
+    key = String.fromCharCode(97 + remaining % 26) + key;
+    remaining = Math.floor(remaining / 26) - 1;
+  } while (remaining >= 0);
+  return key;
+}
+function numericGenerator(index) {
+  return String(index);
+}
+function alphanumericGenerator(index) {
+  const letterIndex = Math.floor(index / 9);
+  const numIndex = index % 9 + 1;
+  return alphaGenerator(letterIndex) + numIndex;
+}
+function shortGenerator(index) {
+  if (index === 0) return "_";
+  return alphaGenerator(index - 1);
+}
+function prefixedGenerator(prefix, style = "numeric") {
+  return (index) => {
+    if (style === "alpha") {
+      return prefix + alphaGenerator(index);
+    }
+    return prefix + index;
+  };
+}
+function createKeyGenerator(pattern) {
+  if (typeof pattern === "function") {
+    return { generator: pattern, name: "custom" };
+  }
+  if (typeof pattern === "string") {
+    switch (pattern) {
+      case "alpha":
+        return { generator: alphaGenerator, name: "alpha" };
+      case "numeric":
+        return { generator: numericGenerator, name: "numeric" };
+      case "alphanumeric":
+        return { generator: alphanumericGenerator, name: "alphanumeric" };
+      case "short":
+        return { generator: shortGenerator, name: "short" };
+      case "prefixed":
+        return { generator: prefixedGenerator("k"), name: "prefixed:k" };
+      default:
+        return { generator: alphaGenerator, name: "alpha" };
+    }
+  }
+  if (typeof pattern === "object" && "prefix" in pattern) {
+    return {
+      generator: prefixedGenerator(pattern.prefix, pattern.style || "numeric"),
+      name: `prefixed:${pattern.prefix}`
+    };
+  }
+  return { generator: alphaGenerator, name: "alpha" };
+}
+function resolveNestedDepth(handling, maxDepth) {
+  if (handling === void 0 || handling === "deep") {
+    return maxDepth;
+  }
+  if (handling === "shallow") {
+    return 1;
+  }
+  if (handling === "arrays") {
+    return maxDepth;
+  }
+  if (typeof handling === "number") {
+    return handling;
+  }
+  return maxDepth;
+}
+function collectKeys(data, options, currentDepth = 0) {
+  const keys = /* @__PURE__ */ new Set();
+  const { minKeyLength, maxDepth, nestedHandling, excludeKeys, includeKeys } = options;
+  if (currentDepth >= maxDepth) return keys;
+  const keyCounts = /* @__PURE__ */ new Map();
+  for (const item of data) {
+    if (typeof item !== "object" || item === null) continue;
+    for (const key of Object.keys(item)) {
+      if (excludeKeys?.includes(key)) continue;
+      const shouldInclude = includeKeys?.includes(key) || key.length >= minKeyLength;
+      if (shouldInclude) {
+        keys.add(key);
+        keyCounts.set(key, (keyCounts.get(key) || 0) + 1);
+      }
+      const value = item[key];
+      if (nestedHandling === "shallow") {
+        continue;
+      }
+      if (Array.isArray(value) && value.length > 0 && isCompressibleArray(value)) {
+        const nestedKeys = collectKeys(
+          value,
+          options,
+          currentDepth + 1
+        );
+        nestedKeys.forEach((k) => keys.add(k));
+      } else if (nestedHandling !== "arrays" && typeof value === "object" && value !== null && !Array.isArray(value)) {
+        const nestedKeys = collectKeys(
+          [value],
+          options,
+          currentDepth + 1
+        );
+        nestedKeys.forEach((k) => keys.add(k));
+      }
+    }
+  }
+  if (options.homogeneousOnly && data.length > 0) {
+    for (const [key, count] of keyCounts) {
+      if (count < data.length) {
+        keys.delete(key);
+      }
+    }
+  }
+  return keys;
+}
+function isCompressibleArray(data) {
+  if (!Array.isArray(data) || data.length === 0) return false;
+  return data.every(
+    (item) => typeof item === "object" && item !== null && !Array.isArray(item)
+  );
+}
+function compressObject(obj, keyToShort, maxDepth, currentDepth = 0) {
+  if (currentDepth >= maxDepth) return obj;
+  const compressed = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const shortKey = keyToShort.get(key) ?? key;
+    if (Array.isArray(value) && isCompressibleArray(value)) {
+      compressed[shortKey] = value.map(
+        (item) => compressObject(
+          item,
+          keyToShort,
+          maxDepth,
+          currentDepth + 1
+        )
+      );
+    } else if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+      compressed[shortKey] = compressObject(
+        value,
+        keyToShort,
+        maxDepth,
+        currentDepth + 1
+      );
+    } else {
+      compressed[shortKey] = value;
+    }
+  }
+  return compressed;
+}
+function compress(data, options = {}) {
+  const {
+    minKeyLength = 3,
+    maxDepth = 10,
+    keyPattern = "alpha",
+    nestedHandling = "deep",
+    homogeneousOnly = false,
+    excludeKeys,
+    includeKeys
+  } = options;
+  const { generator, name: patternName } = createKeyGenerator(keyPattern);
+  const effectiveDepth = resolveNestedDepth(nestedHandling, maxDepth);
+  const allKeys = collectKeys(data, {
+    minKeyLength,
+    maxDepth: effectiveDepth,
+    nestedHandling,
+    excludeKeys,
+    includeKeys,
+    homogeneousOnly
+  });
+  const sortedKeys = Array.from(allKeys).sort();
+  const keyToShort = /* @__PURE__ */ new Map();
+  const keyMap = {};
+  sortedKeys.forEach((key, index) => {
+    const shortKey = generator(index);
+    if (shortKey.length < key.length) {
+      keyToShort.set(key, shortKey);
+      keyMap[shortKey] = key;
+    }
+  });
+  const compressed = data.map(
+    (item) => compressObject(item, keyToShort, effectiveDepth)
+  );
+  return {
+    __terse__: true,
+    v: 1,
+    k: keyMap,
+    d: compressed,
+    p: patternName
+  };
+}
+function createTerseProxy(compressed, keyMap) {
+  const originalToShort = new Map(
+    Object.entries(keyMap).map(([short, original]) => [original, short])
+  );
+  const handler = {
+    get(target, prop) {
+      if (typeof prop === "symbol") {
+        return Reflect.get(target, prop);
+      }
+      const shortKey = originalToShort.get(prop);
+      const actualKey = shortKey ?? prop;
+      const value = target[actualKey];
+      if (Array.isArray(value)) {
+        return value.map((item) => {
+          if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+            return createTerseProxy(item, keyMap);
+          }
+          return item;
+        });
+      }
+      if (typeof value === "object" && value !== null) {
+        return createTerseProxy(value, keyMap);
+      }
+      return value;
+    },
+    has(target, prop) {
+      if (typeof prop === "symbol") {
+        return Reflect.has(target, prop);
+      }
+      const shortKey = originalToShort.get(prop);
+      return (shortKey ?? prop) in target;
+    },
+    ownKeys(target) {
+      return Object.keys(target).map((shortKey) => keyMap[shortKey] ?? shortKey);
+    },
+    getOwnPropertyDescriptor(target, prop) {
+      if (typeof prop === "symbol") {
+        return Reflect.getOwnPropertyDescriptor(target, prop);
+      }
+      const shortKey = originalToShort.get(prop);
+      const actualKey = shortKey ?? prop;
+      const descriptor = Object.getOwnPropertyDescriptor(target, actualKey);
+      if (descriptor) {
+        return { ...descriptor, enumerable: true, configurable: true };
+      }
+      return void 0;
+    }
+  };
+  return new Proxy(compressed, handler);
+}
+function wrapWithProxy(payload) {
+  if (Array.isArray(payload.d)) {
+    return payload.d.map((item) => {
+      if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+        return createTerseProxy(item, payload.k);
+      }
+      return item;
+    });
+  }
+  if (typeof payload.d === "object" && payload.d !== null) {
+    return createTerseProxy(payload.d, payload.k);
+  }
+  return payload.d;
+}
+
+// src/server-memory.ts
+var TerseCache = class {
+  constructor(options = {}) {
+    this.accessOrder = [];
+    this.cache = /* @__PURE__ */ new Map();
+    this.options = options;
+  }
+  /**
+   * Store data in compressed form
+   */
+  set(key, data, ttl) {
+    if (this.options.maxSize && this.cache.size >= this.options.maxSize) {
+      const oldestKey = this.accessOrder.shift();
+      if (oldestKey) {
+        this.cache.delete(oldestKey);
+      }
+    }
+    const payload = compress(data, this.options.compressOptions);
+    const effectiveTTL = ttl ?? this.options.defaultTTL;
+    const expiresAt = effectiveTTL ? Date.now() + effectiveTTL : void 0;
+    this.cache.set(key, { payload, expiresAt });
+    this.updateAccessOrder(key);
+  }
+  /**
+   * Get data wrapped in Proxy for lazy expansion.
+   * Only accessed fields are expanded from compressed form.
+   */
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return void 0;
+    if (entry.expiresAt && Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      this.removeFromAccessOrder(key);
+      return void 0;
+    }
+    this.updateAccessOrder(key);
+    return wrapWithProxy(entry.payload);
+  }
+  /**
+   * Get the raw compressed payload without expansion.
+   * Useful for forwarding to other services.
+   */
+  getRaw(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return void 0;
+    if (entry.expiresAt && Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      this.removeFromAccessOrder(key);
+      return void 0;
+    }
+    return entry.payload;
+  }
+  /**
+   * Check if key exists (and is not expired)
+   */
+  has(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    if (entry.expiresAt && Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      this.removeFromAccessOrder(key);
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Delete an entry
+   */
+  delete(key) {
+    this.removeFromAccessOrder(key);
+    return this.cache.delete(key);
+  }
+  /**
+   * Clear all entries
+   */
+  clear() {
+    this.cache.clear();
+    this.accessOrder = [];
+  }
+  /**
+   * Get current cache size
+   */
+  get size() {
+    return this.cache.size;
+  }
+  updateAccessOrder(key) {
+    this.removeFromAccessOrder(key);
+    this.accessOrder.push(key);
+  }
+  removeFromAccessOrder(key) {
+    const index = this.accessOrder.indexOf(key);
+    if (index > -1) {
+      this.accessOrder.splice(index, 1);
+    }
+  }
+};
+async function* compressStream(source, options = {}) {
+  const batchSize = options.batchSize ?? 100;
+  const { batchSize: _, ...compressOptions } = options;
+  let batch = [];
+  for await (const item of source) {
+    batch.push(item);
+    if (batch.length >= batchSize) {
+      yield compress(batch, compressOptions);
+      batch = [];
+    }
+  }
+  if (batch.length > 0) {
+    yield compress(batch, compressOptions);
+  }
+}
+function createTerseServiceClient(config) {
+  const {
+    baseUrl,
+    expandOnReceive = true,
+    headers: customHeaders = {},
+    fetch: customFetch = globalThis.fetch
+  } = config;
+  const defaultHeaders = {
+    "Accept-Terse": "true",
+    "Content-Type": "application/json",
+    ...customHeaders
+  };
+  return {
+    /**
+     * GET request - receives TerseJSON and returns Proxy-wrapped (or raw)
+     */
+    async get(path, options) {
+      const response = await customFetch(`${baseUrl}${path}`, {
+        method: "GET",
+        headers: { ...defaultHeaders, ...options?.headers }
+      });
+      if (!response.ok) {
+        throw new Error(`TerseServiceClient: GET ${path} failed with status ${response.status}`);
+      }
+      const data = await response.json();
+      if (isTersePayload(data) && expandOnReceive) {
+        return wrapWithProxy(data);
+      }
+      return data;
+    },
+    /**
+     * POST request with automatic compression
+     */
+    async post(path, data, options) {
+      const shouldCompress = options?.compress ?? Array.isArray(data);
+      const body = shouldCompress && Array.isArray(data) ? JSON.stringify(compress(data)) : JSON.stringify(data);
+      const headers = {
+        ...defaultHeaders,
+        ...options?.headers,
+        ...shouldCompress ? { "X-Terse-JSON": "true" } : {}
+      };
+      const response = await customFetch(`${baseUrl}${path}`, {
+        method: "POST",
+        headers,
+        body
+      });
+      if (!response.ok) {
+        throw new Error(`TerseServiceClient: POST ${path} failed with status ${response.status}`);
+      }
+      const responseData = await response.json();
+      if (isTersePayload(responseData) && expandOnReceive) {
+        return wrapWithProxy(responseData);
+      }
+      return responseData;
+    },
+    /**
+     * Forward a raw TersePayload to another endpoint without expansion.
+     * Useful for passing data between services without intermediate deserialization.
+     */
+    async forward(path, payload, options) {
+      const response = await customFetch(`${baseUrl}${path}`, {
+        method: "POST",
+        headers: {
+          ...defaultHeaders,
+          ...options?.headers,
+          "X-Terse-JSON": "true"
+        },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        throw new Error(`TerseServiceClient: forward to ${path} failed with status ${response.status}`);
+      }
+    }
+  };
+}
+
+export { TerseCache, compressStream, createTerseServiceClient };
+//# sourceMappingURL=server-memory.mjs.map
+//# sourceMappingURL=server-memory.mjs.map

package/dist/server-memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/core.ts","../src/server-memory.ts"],"names":[],"mappings":";AAiKO,SAAS,eAAe,KAAA,EAAuC;AACpE,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,QACV,WAAA,IAAe,KAAA,IACd,KAAA,CAAuB,SAAA,KAAc,IAAA,IACtC,GAAA,IAAO,KAAA,IACP,GAAA,IAAO,SACP,GAAA,IAAO,KAAA;AAEX;;;ACrJA,SAAS,eAAe,KAAA,EAAuB;AAC7C,EAAA,IAAI,GAAA,GAAM,EAAA;AACV,EAAA,IAAI,SAAA,GAAY,KAAA;AAEhB,EAAA,GAAG;AACD,IAAA,GAAA,GAAM,MAAA,CAAO,YAAA,CAAa,EAAA,GAAM,SAAA,GAAY,EAAG,CAAA,GAAI,GAAA;AACnD,IAAA,SAAA,GAAY,IAAA,CAAK,KAAA,CAAM,SAAA,GAAY,EAAE,CAAA,GAAI,CAAA;AAAA,EAC3C,SAAS,SAAA,IAAa,CAAA;AAEtB,EAAA,OAAO,GAAA;AACT;AAKA,SAAS,iBAAiB,KAAA,EAAuB;AAC/C,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAKA,SAAS,sBAAsB,KAAA,EAAuB;AACpD,EAAA,MAAM,WAAA,GAAc,IAAA,CAAK,KAAA,CAAM,KAAA,GAAQ,CAAC,CAAA;AACxC,EAAA,MAAM,QAAA,GAAY,QAAQ,CAAA,GAAK,CAAA;AAC/B,EAAA,OAAO,cAAA,CAAe,WAAW,CAAA,GAAI,QAAA;AACvC;AAMA,SAAS,eAAe,KAAA,EAAuB;AAC7C,EAAA,IAAI,KAAA,KAAU,GAAG,OAAO,GAAA;AACxB,EAAA,OAAO,cAAA,CAAe,QAAQ,CAAC,CAAA;AACjC;AAKA,SAAS,iBAAA,CAAkB,MAAA,EAAgB,KAAA,GAA6B,SAAA,EAAyB;AAC/F,EAAA,OAAO,CAAC,KAAA,KAAkB;AACxB,IAAA,IAAI,UAAU,OAAA,EAAS;AACrB,MAAA,OAAO,MAAA,GAAS,eAAe,KAAK,CAAA;AAAA,IACtC;AACA,IAAA,OAAO,MAAA,GAAS,KAAA;AAAA,EAClB,CAAA;AACF;AAKO,SAAS,mBAAmB,OAAA,EAAgE;AAEjG,EAAA,IAAI,OAAO,YAAY,UAAA,EAAY;AACjC,IAAA,OAAO,EAAE,SAAA,EAAW,OAAA,EAAS,IAAA,EAAM,QAAA,EAAS;AAAA,EAC9C;AAGA,EAAA,IAAI,OAAO,YAAY,QAAA,EAAU;AAC/B,IAAA,QAAQ,OAAA;AAAS,MACf,KAAK,OAAA;AACH,QAAA,OAAO,EAAE,SAAA,EAAW,cAAA,EAAgB,IAAA,EAAM,OAAA,EAAQ;AAAA,MACpD,KAAK,SAAA;AACH,QAAA,OAAO,EAAE,SAAA,EAAW,gBAAA,EAAkB,IAAA,EAAM,SAAA,EAAU;AAAA,MACxD,KAAK,cAAA;AACH,QAAA,OAAO,EAAE,SAAA,EAAW,qBAAA,EAAuB,IAAA,EAAM,cAAA,EAAe;AAAA,MAClE,KAAK,OAAA;AACH,QAAA,OAAO,EAAE,SAAA,EAAW,cAAA,EAAgB,IAAA,EAAM,OAAA,EAAQ;AAAA,MACpD,KAAK,UAAA;AACH,QAAA,OAAO,EAAE,SAAA,EAAW,iBAAA,CAAkB,GAAG,CAAA,EAAG,MAAM,YAAA,EAAa;AAAA,MACjE;AACE,QAAA,OAAO,EAAE,SAAA,EAAW,cAAA,EAAgB,IAAA,EAAM,OAAA,EAAQ;AAAA;AACtD,EACF;AAGA,EAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,QAAA,IAAY,OAAA,EAAS;AACtD,IAAA,OAAO;AAAA,MACL,WAAW,iBAAA,CAAkB,OAAA,CAAQ,MAAA,EAAQ,OAAA,CAAQ,SAAS,SAAS,CAAA;AAAA,MACvE,IAAA,EAAM,CAAA,SAAA,EAAY,OAAA,CAAQ,MAAM,CAAA;AAAA,KAClC;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,SAAA,EAAW,cAAA,EAAgB,IAAA,EAAM,OAAA,EAAQ;AACpD;AAKA,SAAS,kBAAA,CAAmB,UAAsC,QAAA,EAA0B;AAC1F,EAAA,IAAI,QAAA,KAAa,MAAA,IAAa,QAAA,KAAa,MAAA,EAAQ;AACjD,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,aAAa,SAAA,EAAW;AAC1B,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,IAAI,aAAa,QAAA,EAAU;AACzB,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAO,aAAa,QAAA,EAAU;AAChC,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,OAAO,QAAA;AACT;AAgBA,SAAS,WAAA,CACP,IAAA,EACA,OAAA,EACA,YAAA,GAAuB,CAAA,EACV;AACb,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,MAAM,EAAE,YAAA,EAAc,QAAA,EAAU,cAAA,EAAgB,WAAA,EAAa,aAAY,GAAI,OAAA;AAE7E,EAAA,IAAI,YAAA,IAAgB,UAAU,OAAO,IAAA;AAGrC,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAoB;AAE1C,EAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,IAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAE/C,IAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,IAAI,CAAA,EAAG;AAEnC,MAAA,IAAI,WAAA,EAAa,QAAA,CAAS,GAAG,CAAA,EAAG;AAGhC,MAAA,MAAM,gBAAgB,WAAA,EAAa,QAAA,CAAS,GAAG,CAAA,IAAK,IAAI,MAAA,IAAU,YAAA;AAElE,MAAA,IAAI,aAAA,EAAe;AACjB,QAAA,IAAA,CAAK,IAAI,GAAG,CAAA;AACZ,QAAA,SAAA,CAAU,IAAI,GAAA,EAAA,CAAM,SAAA,CAAU,IAAI,GAAG,CAAA,IAAK,KAAK,CAAC,CAAA;AAAA,MAClD;AAGA,MAAA,MAAM,KAAA,GAAQ,KAAK,GAAG,CAAA;AAEtB,MAAA,IAAI,mBAAmB,SAAA,EAAW;AAEhC,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,KAAA,CAAM,QAAQ,KAAK,CAAA,IAAK,MAAM,MAAA,GAAS,CAAA,IAAK,mBAAA,CAAoB,KAAK,CAAA,EAAG;AAE1E,QAAA,MAAM,UAAA,GAAa,WAAA;AAAA,UACjB,KAAA;AAAA,UACA,OAAA;AAAA,UACA,YAAA,GAAe;AAAA,SACjB;AACA,QAAA,UAAA,CAAW,OAAA,CAAQ,CAAA,CAAA,KAAK,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA;AAAA,MACrC,CAAA,MAAA,IACE,cAAA,KAAmB,QAAA,IACnB,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EACpB;AAEA,QAAA,MAAM,UAAA,GAAa,WAAA;AAAA,UACjB,CAAC,KAAgC,CAAA;AAAA,UACjC,OAAA;AAAA,UACA,YAAA,GAAe;AAAA,SACjB;AACA,QAAA,UAAA,CAAW,OAAA,CAAQ,CAAA,CAAA,KAAK,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA;AAAA,MACrC;AAAA,IACF;AAAA,EACF;AAGA,EAAA,IAAI,OAAA,CAAQ,eAAA,IAAmB,IAAA,CAAK,MAAA,GAAS,CAAA,EAAG;AAC9C,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,SAAA,EAAW;AACpC,MAAA,IAAI,KAAA,GAAQ,KAAK,MAAA,EAAQ;AACvB,QAAA,IAAA,CAAK,OAAO,GAAG,CAAA;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAKO,SAAS,oBAAoB,IAAA,EAAkD;AACpF,EAAA,IAAI,CAAC,MAAM,OAAA,CAAQ,IAAI,KAAK,IAAA,CAAK,MAAA,KAAW,GAAG,OAAO,KAAA;AAGtD,EAAA,OAAO,IAAA,CAAK,KAAA;AAAA,IACV,CAAA,IAAA,KAAQ,OAAO,IAAA,KAAS,QAAA,IAAY,SAAS,IAAA,IAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,IAAI;AAAA,GAC1E;AACF;AAKA,SAAS,cAAA,CACP,GAAA,EACA,UAAA,EACA,QAAA,EACA,eAAuB,CAAA,EACE;AACzB,EAAA,IAAI,YAAA,IAAgB,UAAU,OAAO,GAAA;AAErC,EAAA,MAAM,aAAsC,EAAC;AAE7C,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA,EAAG;AAC9C,IAAA,MAAM,QAAA,GAAW,UAAA,CAAW,GAAA,CAAI,GAAG,CAAA,IAAK,GAAA;AAExC,IAAA,IAAI,MAAM,OAAA,CAAQ,KAAK,CAAA,IAAK,mBAAA,CAAoB,KAAK,CAAA,EAAG;AAEtD,MAAA,UAAA,CAAW,QAAQ,IAAI,KAAA,CAAM,GAAA;AAAA,QAAI,CAAA,IAAA,KAC/B,cAAA;AAAA,UACE,IAAA;AAAA,UACA,UAAA;AAAA,UACA,QAAA;AAAA,UACA,YAAA,GAAe;AAAA;AACjB,OACF;AAAA,IACF,CAAA,MAAA,IAAW,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AAE/E,MAAA,UAAA,CAAW,QAAQ,CAAA,GAAI,cAAA;AAAA,QACrB,KAAA;AAAA,QACA,UAAA;AAAA,QACA,QAAA;AAAA,QACA,YAAA,GAAe;AAAA,OACjB;AAAA,IACF,CAAA,MAAO;AACL,MAAA,UAAA,CAAW,QAAQ,CAAA,GAAI,KAAA;AAAA,IACzB;AAAA,EACF;AAEA,EAAA,OAAO,UAAA;AACT;AAmDO,SAAS,QAAA,CACd,IAAA,EACA,OAAA,GAA2B,EAAC,EACH;AACzB,EAAA,MAAM;AAAA,IACJ,YAAA,GAAe,CAAA;AAAA,IACf,QAAA,GAAW,EAAA;AAAA,IACX,UAAA,GAAa,OAAA;AAAA,IACb,cAAA,GAAiB,MAAA;AAAA,IACjB,eAAA,GAAkB,KAAA;AAAA,IAClB,WAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAGJ,EAAA,MAAM,EAAE,SAAA,EAAW,IAAA,EAAM,WAAA,EAAY,GAAI,mBAAmB,UAAU,CAAA;AAGtE,EAAA,MAAM,cAAA,GAAiB,kBAAA,CAAmB,cAAA,EAAgB,QAAQ,CAAA;AAGlE,EAAA,MAAM,OAAA,GAAU,YAAY,IAAA,EAAM;AAAA,IAChC,YAAA;AAAA,IACA,QAAA,EAAU,cAAA;AAAA,IACV,cAAA;AAAA,IACA,WAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA,GACD,CAAA;AAID,EAAA,MAAM,UAAA,GAAa,KAAA,CAAM,IAAA,CAAK,OAAO,EAAE,IAAA,EAAK;AAG5C,EAAA,MAAM,UAAA,uBAAiB,GAAA,EAAoB;AAC3C,EAAA,MAAM,SAAiC,EAAC;AAExC,EAAA,UAAA,CAAW,OAAA,CAAQ,CAAC,GAAA,EAAK,KAAA,KAAU;AACjC,IAAA,MAAM,QAAA,GAAW,UAAU,KAAK,CAAA;AAEhC,IAAA,IAAI,QAAA,CAAS,MAAA,GAAS,GAAA,CAAI,MAAA,EAAQ;AAChC,MAAA,UAAA,CAAW,GAAA,CAAI,KAAK,QAAQ,CAAA;AAC5B,MAAA,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAAA,IACrB;AAAA,EACF,CAAC,CAAA;AAGD,EAAA,MAAM,aAAa,IAAA,CAAK,GAAA;AAAA,IAAI,CAAA,IAAA,KAC1B,cAAA,CAAe,IAAA,EAAM,UAAA,EAAY,cAAc;AAAA,GACjD;AAEA,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,IAAA;AAAA,IACX,CAAA,EAAG,CAAA;AAAA,IACH,CAAA,EAAG,MAAA;AAAA,IACH,CAAA,EAAG,UAAA;AAAA,IACH,CAAA,EAAG;AAAA,GACL;AACF;AA8BO,SAAS,gBAAA,CACd,YACA,MAAA,EACG;AAEH,EAAA,MAAM,kBAAkB,IAAI,GAAA;AAAA,IAC1B,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,KAAA,EAAO,QAAQ,CAAA,KAAM,CAAC,QAAA,EAAU,KAAK,CAAC;AAAA,GACrE;AAEA,EAAA,MAAM,OAAA,GAAiD;AAAA,IACrD,GAAA,CAAI,QAAQ,IAAA,EAAuB;AACjC,MAAA,IAAI,OAAO,SAAS,QAAA,EAAU;AAC5B,QAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,MAAA,EAAQ,IAAI,CAAA;AAAA,MACjC;AAGA,MAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,GAAA,CAAI,IAAI,CAAA;AACzC,MAAA,MAAM,YAAY,QAAA,IAAY,IAAA;AAC9B,MAAA,MAAM,KAAA,GAAQ,OAAO,SAAS,CAAA;AAG9B,MAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,QAAA,OAAO,KAAA,CAAM,IAAI,CAAA,IAAA,KAAQ;AACvB,UAAA,IAAI,OAAO,SAAS,QAAA,IAAY,IAAA,KAAS,QAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG;AACrE,YAAA,OAAO,gBAAA,CAAiB,MAAiC,MAAM,CAAA;AAAA,UACjE;AACA,UAAA,OAAO,IAAA;AAAA,QACT,CAAC,CAAA;AAAA,MACH;AAEA,MAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,EAAM;AAC/C,QAAA,OAAO,gBAAA,CAAiB,OAAkC,MAAM,CAAA;AAAA,MAClE;AAEA,MAAA,OAAO,KAAA;AAAA,IACT,CAAA;AAAA,IAEA,GAAA,CAAI,QAAQ,IAAA,EAAuB;AACjC,MAAA,IAAI,OAAO,SAAS,QAAA,EAAU;AAC5B,QAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,MAAA,EAAQ,IAAI,CAAA;AAAA,MACjC;AACA,MAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,GAAA,CAAI,IAAI,CAAA;AACzC,MAAA,OAAA,CAAQ,YAAY,IAAA,KAAS,MAAA;AAAA,IAC/B,CAAA;AAAA,IAEA,QAAQ,MAAA,EAAQ;AAEd,MAAA,OAAO,MAAA,CAAO,KAAK,MAAM,CAAA,CAAE,IAAI,CAAA,QAAA,KAAY,MAAA,CAAO,QAAQ,CAAA,IAAK,QAAQ,CAAA;AAAA,IACzE,CAAA;AAAA,IAEA,wBAAA,CAAyB,QAAQ,IAAA,EAAuB;AACtD,MAAA,IAAI,OAAO,SAAS,QAAA,EAAU;AAC5B,QAAA,OAAO,OAAA,CAAQ,wBAAA,CAAyB,MAAA,EAAQ,IAAI,CAAA;AAAA,MACtD;AACA,MAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,GAAA,CAAI,IAAI,CAAA;AACzC,MAAA,MAAM,YAAY,QAAA,IAAY,IAAA;AAC9B,MAAA,MAAM,UAAA,GAAa,MAAA,CAAO,wBAAA,CAAyB,MAAA,EAAQ,SAAS,CAAA;AACpE,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,OAAO,EAAE,GAAG,UAAA,EAAY,UAAA,EAAY,IAAA,EAAM,cAAc,IAAA,EAAK;AAAA,MAC/D;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACF;AAEA,EAAA,OAAO,IAAI,KAAA,CAAM,UAAA,EAAY,OAAO,CAAA;AACtC;AAKO,SAAS,cAAiB,OAAA,EAA0B;AACzD,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAA,EAAG;AAC5B,IAAA,OAAO,OAAA,CAAQ,CAAA,CAAE,GAAA,CAAI,CAAA,IAAA,KAAQ;AAC3B,MAAA,IAAI,OAAO,SAAS,QAAA,IAAY,IAAA,KAAS,QAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG;AACrE,QAAA,OAAO,gBAAA,CAAiB,IAAA,EAAiC,OAAA,CAAQ,CAAC,CAAA;AAAA,MACpE;AACA,MAAA,OAAO,IAAA;AAAA,IACT,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,IAAI,OAAO,OAAA,CAAQ,CAAA,KAAM,QAAA,IAAY,OAAA,CAAQ,MAAM,IAAA,EAAM;AACvD,IAAA,OAAO,gBAAA,CAAiB,OAAA,CAAQ,CAAA,EAA8B,OAAA,CAAQ,CAAC,CAAA;AAAA,EACzE;AAEA,EAAA,OAAO,OAAA,CAAQ,CAAA;AACjB;;;AClcO,IAAM,aAAN,MAAkF;AAAA,EAKvF,WAAA,CAAY,OAAA,GAA6B,EAAC,EAAG;AAF7C,IAAA,IAAA,CAAQ,cAAwB,EAAC;AAG/B,IAAA,IAAA,CAAK,KAAA,uBAAY,GAAA,EAAI;AACrB,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,GAAA,CAAI,GAAA,EAAa,IAAA,EAAS,GAAA,EAAoB;AAE5C,IAAA,IAAI,IAAA,CAAK,QAAQ,OAAA,IAAW,IAAA,CAAK,MAAM,IAAA,IAAQ,IAAA,CAAK,QAAQ,OAAA,EAAS;AACnE,MAAA,MAAM,SAAA,GAAY,IAAA,CAAK,WAAA,CAAY,KAAA,EAAM;AACzC,MAAA,IAAI,SAAA,EAAW;AACb,QAAA,IAAA,CAAK,KAAA,CAAM,OAAO,SAAS,CAAA;AAAA,MAC7B;AAAA,IACF;AAEA,IAAA,MAAM,OAAA,GAAU,QAAA,CAAS,IAAA,EAAM,IAAA,CAAK,QAAQ,eAAe,CAAA;AAC3D,IAAA,MAAM,YAAA,GAAe,GAAA,IAAO,IAAA,CAAK,OAAA,CAAQ,UAAA;AACzC,IAAA,MAAM,SAAA,GAAY,YAAA,GAAe,IAAA,CAAK,GAAA,KAAQ,YAAA,GAAe,MAAA;AAE7D,IAAA,IAAA,CAAK,MAAM,GAAA,CAAI,GAAA,EAAK,EAAE,OAAA,EAAS,WAAW,CAAA;AAC1C,IAAA,IAAA,CAAK,kBAAkB,GAAG,CAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,GAAA,EAA4B;AAC9B,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AAGnB,IAAA,IAAI,MAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAI,GAAI,MAAM,SAAA,EAAW;AACnD,MAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AACrB,MAAA,IAAA,CAAK,sBAAsB,GAAG,CAAA;AAC9B,MAAA,OAAO,MAAA;AAAA,IACT;AAEA,IAAA,IAAA,CAAK,kBAAkB,GAAG,CAAA;AAC1B,IAAA,OAAO,aAAA,CAAiB,MAAM,OAAO,CAAA;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,GAAA,EAA0C;AAC/C,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AAEnB,IAAA,IAAI,MAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAI,GAAI,MAAM,SAAA,EAAW;AACnD,MAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AACrB,MAAA,IAAA,CAAK,sBAAsB,GAAG,CAAA;AAC9B,MAAA,OAAO,MAAA;AAAA,IACT;AAEA,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,GAAA,EAAsB;AACxB,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,KAAA;AAEnB,IAAA,IAAI,MAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAI,GAAI,MAAM,SAAA,EAAW;AACnD,MAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AACrB,MAAA,IAAA,CAAK,sBAAsB,GAAG,CAAA;AAC9B,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,GAAA,EAAsB;AAC3B,IAAA,IAAA,CAAK,sBAAsB,GAAG,CAAA;AAC9B,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,GAAG,CAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AACjB,IAAA,IAAA,CAAK,cAAc,EAAC;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,KAAK,KAAA,CAAM,IAAA;AAAA,EACpB;AAAA,EAEQ,kBAAkB,GAAA,EAAmB;AAC3C,IAAA,IAAA,CAAK,sBAAsB,GAAG,CAAA;AAC9B,IAAA,IAAA,CAAK,WAAA,CAAY,KAAK,GAAG,CAAA;AAAA,EAC3B;AAAA,EAEQ,sBAAsB,GAAA,EAAmB;AAC/C,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,WAAA,CAAY,OAAA,CAAQ,GAAG,CAAA;AAC1C,IAAA,IAAI,QAAQ,EAAA,EAAI;AACd,MAAA,IAAA,CAAK,WAAA,CAAY,MAAA,CAAO,KAAA,EAAO,CAAC,CAAA;AAAA,IAClC;AAAA,EACF;AACF;AA+BA,gBAAuB,cAAA,CACrB,MAAA,EACA,OAAA,GAAiC,EAAC,EACgB;AAClD,EAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACvC,EAAA,MAAM,EAAE,SAAA,EAAW,CAAA,EAAG,GAAG,iBAAgB,GAAI,OAAA;AAE7C,EAAA,IAAI,QAAa,EAAC;AAElB,EAAA,WAAA,MAAiB,QAAQ,MAAA,EAAQ;AAC/B,IAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AAEf,IAAA,IAAI,KAAA,CAAM,UAAU,SAAA,EAAW;AAC7B,MAAA,MAAM,QAAA,CAAS,OAAO,eAAe,CAAA;AACrC,MAAA,KAAA,GAAQ,EAAC;AAAA,IACX;AAAA,EACF;AAGA,EAAA,IAAI,KAAA,CAAM,SAAS,CAAA,EAAG;AACpB,IAAA,MAAM,QAAA,CAAS,OAAO,eAAe,CAAA;AAAA,EACvC;AACF;AAuCO,SAAS,yBAAyB,MAAA,EAAkC;AACzE,EAAA,MAAM;AAAA,IACJ,OAAA;AAAA,IACA,eAAA,GAAkB,IAAA;AAAA,IAClB,OAAA,EAAS,gBAAgB,EAAC;AAAA,IAC1B,KAAA,EAAO,cAAc,UAAA,CAAW;AAAA,GAClC,GAAI,MAAA;AAEJ,EAAA,MAAM,cAAA,GAAiB;AAAA,IACrB,cAAA,EAAgB,MAAA;AAAA,IAChB,cAAA,EAAgB,kBAAA;AAAA,IAChB,GAAG;AAAA,GACL;AAEA,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA,IAIL,MAAM,GAAA,CAAO,IAAA,EAAc,OAAA,EAA4D;AACrF,MAAA,MAAM,WAAW,MAAM,WAAA,CAAY,GAAG,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,QACtD,MAAA,EAAQ,KAAA;AAAA,QACR,SAAS,EAAE,GAAG,cAAA,EAAgB,GAAG,SAAS,OAAA;AAAQ,OACnD,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,wBAAA,EAA2B,IAAI,CAAA,oBAAA,EAAuB,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAAA,MACzF;AAEA,MAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAEjC,MAAA,IAAI,cAAA,CAAe,IAAI,CAAA,IAAK,eAAA,EAAiB;AAC3C,QAAA,OAAO,cAAiB,IAAqD,CAAA;AAAA,MAC/E;AAEA,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA;AAAA;AAAA;AAAA,IAKA,MAAM,IAAA,CACJ,IAAA,EACA,IAAA,EACA,OAAA,EACY;AACZ,MAAA,MAAM,cAAA,GAAiB,OAAA,EAAS,QAAA,IAAY,KAAA,CAAM,QAAQ,IAAI,CAAA;AAC9D,MAAA,MAAM,IAAA,GAAO,cAAA,IAAkB,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,GAC7C,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,IAAiC,CAAC,CAAA,GAC1D,IAAA,CAAK,UAAU,IAAI,CAAA;AAEvB,MAAA,MAAM,OAAA,GAAU;AAAA,QACd,GAAG,cAAA;AAAA,QACH,GAAG,OAAA,EAAS,OAAA;AAAA,QACZ,GAAI,cAAA,GAAiB,EAAE,cAAA,EAAgB,MAAA,KAAW;AAAC,OACrD;AAEA,MAAA,MAAM,WAAW,MAAM,WAAA,CAAY,GAAG,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,QACtD,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA;AAAA,QACA;AAAA,OACD,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,yBAAA,EAA4B,IAAI,CAAA,oBAAA,EAAuB,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAAA,MAC1F;AAEA,MAAA,MAAM,YAAA,GAAe,MAAM,QAAA,CAAS,IAAA,EAAK;AAEzC,MAAA,IAAI,cAAA,CAAe,YAAY,CAAA,IAAK,eAAA,EAAiB;AACnD,QAAA,OAAO,cAAiB,YAA6D,CAAA;AAAA,MACvF;AAEA,MAAA,OAAO,YAAA;AAAA,IACT,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,MAAM,OAAA,CACJ,IAAA,EACA,OAAA,EACA,OAAA,EACe;AACf,MAAA,MAAM,WAAW,MAAM,WAAA,CAAY,GAAG,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,QACtD,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,GAAG,cAAA;AAAA,UACH,GAAG,OAAA,EAAS,OAAA;AAAA,UACZ,cAAA,EAAgB;AAAA,SAClB;AAAA,QACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,OAAO;AAAA,OAC7B,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,IAAI,CAAA,oBAAA,EAAuB,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAAA,MAChG;AAAA,IACF;AAAA,GACF;AACF","file":"server-memory.mjs","sourcesContent":["/**\n * TerseJSON Types\n *\n * Defines the wire format and configuration options for transparent\n * JSON key compression.\n */\n\n/**\n * The compressed format sent over the wire\n */\nexport interface TersePayload<T = unknown> {\n  /** Marker to identify this as a TerseJSON payload */\n  __terse__: true;\n  /** Version for future compatibility */\n  v: 1;\n  /** Key mapping: short key -> original key */\n  k: Record<string, string>;\n  /** The compressed data with short keys */\n  d: T;\n  /** Pattern used for key generation (for debugging/info) */\n  p?: string;\n}\n\n/**\n * Built-in key pattern presets\n */\nexport type KeyPatternPreset =\n  | 'alpha'      // a, b, c, ... z, aa, ab (default)\n  | 'numeric'    // 0, 1, 2, ... 9, 10, 11\n  | 'alphanumeric' // a1, a2, ... a9, b1, b2\n  | 'short'      // _, __, ___, a, b (shortest possible)\n  | 'prefixed';  // k0, k1, k2 (with 'k' prefix)\n\n/**\n * Custom key generator function\n */\nexport type KeyGenerator = (index: number) => string;\n\n/**\n * Key pattern configuration\n */\nexport type KeyPattern =\n  | KeyPatternPreset\n  | { prefix: string; style?: 'numeric' | 'alpha' }\n  | KeyGenerator;\n\n/**\n * How to handle nested structures\n */\nexport type NestedHandling =\n  | 'deep'       // Compress all nested objects/arrays (default)\n  | 'shallow'    // Only compress top-level array\n  | 'arrays'     // Only compress nested arrays, not single objects\n  | number;      // Specific depth limit (1 = shallow, Infinity = deep)\n\n/**\n * Compression options\n */\nexport interface CompressOptions {\n  /**\n   * Minimum key length to consider for compression\n   * Keys shorter than this won't be shortened\n   * @default 3\n   */\n  minKeyLength?: number;\n\n  /**\n   * Maximum depth to traverse for nested objects\n   * @default 10\n   */\n  maxDepth?: number;\n\n  /**\n   * Key pattern to use for generating short keys\n   * @default 'alpha'\n   */\n  keyPattern?: KeyPattern;\n\n  /**\n   * How to handle nested objects and arrays\n   * @default 'deep'\n   */\n  nestedHandling?: NestedHandling;\n\n  /**\n   * Only compress keys that appear in all objects (homogeneous)\n   * @default false\n   */\n  homogeneousOnly?: boolean;\n\n  /**\n   * Keys to always exclude from compression\n   */\n  excludeKeys?: string[];\n\n  /**\n   * Keys to always include in compression (even if short)\n   */\n  includeKeys?: string[];\n}\n\n/**\n * Configuration options for the Express middleware\n */\nexport interface TerseMiddlewareOptions extends CompressOptions {\n  /**\n   * Minimum array length to trigger compression\n   * @default 2\n   */\n  minArrayLength?: number;\n\n  /**\n   * Custom function to determine if a response should be compressed\n   * Return false to skip compression for specific responses\n   */\n  shouldCompress?: (data: unknown, req: unknown) => boolean;\n\n  /**\n   * Custom header name for signaling terse responses\n   * @default 'x-terse-json'\n   */\n  headerName?: string;\n\n  /**\n   * Enable debug logging\n   * @default false\n   */\n  debug?: boolean;\n}\n\n/**\n * Configuration options for the client\n */\nexport interface TerseClientOptions {\n  /**\n   * Custom header name to check for terse responses\n   * @default 'x-terse-json'\n   */\n  headerName?: string;\n\n  /**\n   * Enable debug logging\n   * @default false\n   */\n  debug?: boolean;\n\n  /**\n   * Automatically expand terse responses\n   * @default true\n   */\n  autoExpand?: boolean;\n}\n\n/**\n * Type helper to preserve original types through compression\n */\nexport type Tersed<T> = T;\n\n/**\n * Check if a value is a TersePayload\n */\nexport function isTersePayload(value: unknown): value is TersePayload {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '__terse__' in value &&\n    (value as TersePayload).__terse__ === true &&\n    'v' in value &&\n    'k' in value &&\n    'd' in value\n  );\n}\n\n/**\n * GraphQL terse metadata (attached to response)\n */\nexport interface GraphQLTerseMetadata {\n  /** Version for compatibility */\n  v: 1;\n  /** Key mapping: short key -> original key */\n  k: Record<string, string>;\n  /** JSON paths to compressed arrays (e.g., [\"data.users\", \"data.products\"]) */\n  paths: string[];\n}\n\n/**\n * GraphQL response with terse compression\n */\nexport interface GraphQLTerseResponse<T = unknown> {\n  /** The compressed data with short keys in arrays */\n  data: T;\n  /** GraphQL errors (untouched) */\n  errors?: Array<{ message: string; [key: string]: unknown }>;\n  /** GraphQL extensions (untouched) */\n  extensions?: Record<string, unknown>;\n  /** Terse metadata */\n  __terse__: GraphQLTerseMetadata;\n}\n\n/**\n * GraphQL middleware options\n */\nexport interface GraphQLTerseOptions extends CompressOptions {\n  /**\n   * Minimum array length to trigger compression\n   * @default 2\n   */\n  minArrayLength?: number;\n\n  /**\n   * Custom function to determine if a path should be compressed\n   * Return false to skip compression for specific paths\n   */\n  shouldCompress?: (data: unknown, path: string) => boolean;\n\n  /**\n   * Paths to exclude from compression (e.g., [\"data.config\"])\n   */\n  excludePaths?: string[];\n\n  /**\n   * Enable debug logging\n   * @default false\n   */\n  debug?: boolean;\n}\n\n/**\n * Check if a value is a GraphQL terse response\n */\nexport function isGraphQLTersePayload(value: unknown): value is GraphQLTerseResponse {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'data' in value &&\n    '__terse__' in value &&\n    typeof (value as GraphQLTerseResponse).__terse__ === 'object' &&\n    (value as GraphQLTerseResponse).__terse__ !== null &&\n    'v' in (value as GraphQLTerseResponse).__terse__ &&\n    'k' in (value as GraphQLTerseResponse).__terse__ &&\n    'paths' in (value as GraphQLTerseResponse).__terse__\n  );\n}\n","/**\n * TerseJSON Core\n *\n * The core compression and expansion algorithms.\n */\n\nimport {\n  TersePayload,\n  isTersePayload,\n  KeyPattern,\n  KeyGenerator,\n  NestedHandling,\n  CompressOptions,\n} from './types';\n\n// ============================================================================\n// KEY PATTERN GENERATORS\n// ============================================================================\n\n/**\n * Alpha pattern: a, b, c, ... z, aa, ab, ...\n */\nfunction alphaGenerator(index: number): string {\n  let key = '';\n  let remaining = index;\n\n  do {\n    key = String.fromCharCode(97 + (remaining % 26)) + key;\n    remaining = Math.floor(remaining / 26) - 1;\n  } while (remaining >= 0);\n\n  return key;\n}\n\n/**\n * Numeric pattern: 0, 1, 2, ... 9, 10, 11, ...\n */\nfunction numericGenerator(index: number): string {\n  return String(index);\n}\n\n/**\n * Alphanumeric pattern: a1, a2, ... a9, b1, b2, ...\n */\nfunction alphanumericGenerator(index: number): string {\n  const letterIndex = Math.floor(index / 9);\n  const numIndex = (index % 9) + 1;\n  return alphaGenerator(letterIndex) + numIndex;\n}\n\n/**\n * Short pattern: uses shortest possible keys\n * _, a, b, ..., z, aa, ab, ...\n */\nfunction shortGenerator(index: number): string {\n  if (index === 0) return '_';\n  return alphaGenerator(index - 1);\n}\n\n/**\n * Prefixed pattern: k0, k1, k2, ...\n */\nfunction prefixedGenerator(prefix: string, style: 'numeric' | 'alpha' = 'numeric'): KeyGenerator {\n  return (index: number) => {\n    if (style === 'alpha') {\n      return prefix + alphaGenerator(index);\n    }\n    return prefix + index;\n  };\n}\n\n/**\n * Creates a key generator from a pattern configuration\n */\nexport function createKeyGenerator(pattern: KeyPattern): { generator: KeyGenerator; name: string } {\n  // If it's already a function, use it directly\n  if (typeof pattern === 'function') {\n    return { generator: pattern, name: 'custom' };\n  }\n\n  // If it's a preset string\n  if (typeof pattern === 'string') {\n    switch (pattern) {\n      case 'alpha':\n        return { generator: alphaGenerator, name: 'alpha' };\n      case 'numeric':\n        return { generator: numericGenerator, name: 'numeric' };\n      case 'alphanumeric':\n        return { generator: alphanumericGenerator, name: 'alphanumeric' };\n      case 'short':\n        return { generator: shortGenerator, name: 'short' };\n      case 'prefixed':\n        return { generator: prefixedGenerator('k'), name: 'prefixed:k' };\n      default:\n        return { generator: alphaGenerator, name: 'alpha' };\n    }\n  }\n\n  // If it's a prefix config object\n  if (typeof pattern === 'object' && 'prefix' in pattern) {\n    return {\n      generator: prefixedGenerator(pattern.prefix, pattern.style || 'numeric'),\n      name: `prefixed:${pattern.prefix}`,\n    };\n  }\n\n  return { generator: alphaGenerator, name: 'alpha' };\n}\n\n/**\n * Resolves nested handling to a numeric depth\n */\nfunction resolveNestedDepth(handling: NestedHandling | undefined, maxDepth: number): number {\n  if (handling === undefined || handling === 'deep') {\n    return maxDepth;\n  }\n  if (handling === 'shallow') {\n    return 1;\n  }\n  if (handling === 'arrays') {\n    return maxDepth; // Special handling in collect/compress functions\n  }\n  if (typeof handling === 'number') {\n    return handling;\n  }\n  return maxDepth;\n}\n\n// Legacy generateShortKey removed - use createKeyGenerator instead\n\ninterface CollectKeysOptions {\n  minKeyLength: number;\n  maxDepth: number;\n  nestedHandling: NestedHandling;\n  excludeKeys?: string[];\n  includeKeys?: string[];\n  homogeneousOnly?: boolean;\n}\n\n/**\n * Collects all unique keys from an array of objects\n */\nfunction collectKeys(\n  data: Record<string, unknown>[],\n  options: CollectKeysOptions,\n  currentDepth: number = 0\n): Set<string> {\n  const keys = new Set<string>();\n  const { minKeyLength, maxDepth, nestedHandling, excludeKeys, includeKeys } = options;\n\n  if (currentDepth >= maxDepth) return keys;\n\n  // For homogeneous mode, track key counts\n  const keyCounts = new Map<string, number>();\n\n  for (const item of data) {\n    if (typeof item !== 'object' || item === null) continue;\n\n    for (const key of Object.keys(item)) {\n      // Skip excluded keys\n      if (excludeKeys?.includes(key)) continue;\n\n      // Include if in includeKeys, or if meets minKeyLength\n      const shouldInclude = includeKeys?.includes(key) || key.length >= minKeyLength;\n\n      if (shouldInclude) {\n        keys.add(key);\n        keyCounts.set(key, (keyCounts.get(key) || 0) + 1);\n      }\n\n      // Handle nested structures based on nestedHandling option\n      const value = item[key];\n\n      if (nestedHandling === 'shallow') {\n        // Don't process nested structures\n        continue;\n      }\n\n      if (Array.isArray(value) && value.length > 0 && isCompressibleArray(value)) {\n        // Nested array of objects - always process\n        const nestedKeys = collectKeys(\n          value as Record<string, unknown>[],\n          options,\n          currentDepth + 1\n        );\n        nestedKeys.forEach(k => keys.add(k));\n      } else if (\n        nestedHandling !== 'arrays' &&\n        typeof value === 'object' &&\n        value !== null &&\n        !Array.isArray(value)\n      ) {\n        // Single nested object - skip if nestedHandling is 'arrays'\n        const nestedKeys = collectKeys(\n          [value as Record<string, unknown>],\n          options,\n          currentDepth + 1\n        );\n        nestedKeys.forEach(k => keys.add(k));\n      }\n    }\n  }\n\n  // If homogeneous mode, only keep keys that appear in ALL objects\n  if (options.homogeneousOnly && data.length > 0) {\n    for (const [key, count] of keyCounts) {\n      if (count < data.length) {\n        keys.delete(key);\n      }\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Checks if an array is compressible (array of objects with consistent structure)\n */\nexport function isCompressibleArray(data: unknown): data is Record<string, unknown>[] {\n  if (!Array.isArray(data) || data.length === 0) return false;\n\n  // Check if all items are objects\n  return data.every(\n    item => typeof item === 'object' && item !== null && !Array.isArray(item)\n  );\n}\n\n/**\n * Compresses an object using the key mapping\n */\nfunction compressObject(\n  obj: Record<string, unknown>,\n  keyToShort: Map<string, string>,\n  maxDepth: number,\n  currentDepth: number = 0\n): Record<string, unknown> {\n  if (currentDepth >= maxDepth) return obj;\n\n  const compressed: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    const shortKey = keyToShort.get(key) ?? key;\n\n    if (Array.isArray(value) && isCompressibleArray(value)) {\n      // Recursively compress nested arrays\n      compressed[shortKey] = value.map(item =>\n        compressObject(\n          item as Record<string, unknown>,\n          keyToShort,\n          maxDepth,\n          currentDepth + 1\n        )\n      );\n    } else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n      // Compress single nested objects too\n      compressed[shortKey] = compressObject(\n        value as Record<string, unknown>,\n        keyToShort,\n        maxDepth,\n        currentDepth + 1\n      );\n    } else {\n      compressed[shortKey] = value;\n    }\n  }\n\n  return compressed;\n}\n\n/**\n * Expands an object using the key mapping\n */\nfunction expandObject(\n  obj: Record<string, unknown>,\n  shortToKey: Map<string, string>,\n  maxDepth: number,\n  currentDepth: number = 0\n): Record<string, unknown> {\n  if (currentDepth >= maxDepth) return obj;\n\n  const expanded: Record<string, unknown> = {};\n\n  for (const [shortKey, value] of Object.entries(obj)) {\n    const originalKey = shortToKey.get(shortKey) ?? shortKey;\n\n    if (Array.isArray(value)) {\n      expanded[originalKey] = value.map(item => {\n        if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n          return expandObject(\n            item as Record<string, unknown>,\n            shortToKey,\n            maxDepth,\n            currentDepth + 1\n          );\n        }\n        return item;\n      });\n    } else if (typeof value === 'object' && value !== null) {\n      expanded[originalKey] = expandObject(\n        value as Record<string, unknown>,\n        shortToKey,\n        maxDepth,\n        currentDepth + 1\n      );\n    } else {\n      expanded[originalKey] = value;\n    }\n  }\n\n  return expanded;\n}\n\n// Re-export CompressOptions from types for backwards compatibility\nexport type { CompressOptions } from './types';\n\n/**\n * Compresses an array of objects by replacing keys with short aliases\n */\nexport function compress<T extends Record<string, unknown>[]>(\n  data: T,\n  options: CompressOptions = {}\n): TersePayload<unknown[]> {\n  const {\n    minKeyLength = 3,\n    maxDepth = 10,\n    keyPattern = 'alpha',\n    nestedHandling = 'deep',\n    homogeneousOnly = false,\n    excludeKeys,\n    includeKeys,\n  } = options;\n\n  // Create key generator\n  const { generator, name: patternName } = createKeyGenerator(keyPattern);\n\n  // Resolve nested depth\n  const effectiveDepth = resolveNestedDepth(nestedHandling, maxDepth);\n\n  // Collect all unique keys\n  const allKeys = collectKeys(data, {\n    minKeyLength,\n    maxDepth: effectiveDepth,\n    nestedHandling,\n    excludeKeys,\n    includeKeys,\n    homogeneousOnly,\n  });\n\n  // Sort keys by frequency of use (most used first) for optimal compression\n  // For now, just sort alphabetically for deterministic output\n  const sortedKeys = Array.from(allKeys).sort();\n\n  // Create bidirectional mapping\n  const keyToShort = new Map<string, string>();\n  const keyMap: Record<string, string> = {};\n\n  sortedKeys.forEach((key, index) => {\n    const shortKey = generator(index);\n    // Only use short key if it's actually shorter\n    if (shortKey.length < key.length) {\n      keyToShort.set(key, shortKey);\n      keyMap[shortKey] = key;\n    }\n  });\n\n  // Compress the data\n  const compressed = data.map(item =>\n    compressObject(item, keyToShort, effectiveDepth)\n  );\n\n  return {\n    __terse__: true,\n    v: 1,\n    k: keyMap,\n    d: compressed,\n    p: patternName,\n  };\n}\n\n/**\n * Expands a TersePayload back to its original form\n */\nexport function expand<T = unknown>(payload: TersePayload): T {\n  const shortToKey = new Map(\n    Object.entries(payload.k).map(([short, original]) => [short, original])\n  );\n\n  if (Array.isArray(payload.d)) {\n    return payload.d.map(item => {\n      if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n        return expandObject(item as Record<string, unknown>, shortToKey, 10);\n      }\n      return item;\n    }) as T;\n  }\n\n  if (typeof payload.d === 'object' && payload.d !== null) {\n    return expandObject(payload.d as Record<string, unknown>, shortToKey, 10) as T;\n  }\n\n  return payload.d as T;\n}\n\n/**\n * Creates a Proxy that transparently maps original keys to short keys\n * This is the magic that makes client-side access seamless\n */\nexport function createTerseProxy<T extends Record<string, unknown>>(\n  compressed: Record<string, unknown>,\n  keyMap: Record<string, string> // short -> original\n): T {\n  // Create reverse map: original -> short\n  const originalToShort = new Map(\n    Object.entries(keyMap).map(([short, original]) => [original, short])\n  );\n\n  const handler: ProxyHandler<Record<string, unknown>> = {\n    get(target, prop: string | symbol) {\n      if (typeof prop === 'symbol') {\n        return Reflect.get(target, prop);\n      }\n\n      // Check if accessing by original key name\n      const shortKey = originalToShort.get(prop);\n      const actualKey = shortKey ?? prop;\n      const value = target[actualKey];\n\n      // Recursively proxy nested objects/arrays\n      if (Array.isArray(value)) {\n        return value.map(item => {\n          if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n            return createTerseProxy(item as Record<string, unknown>, keyMap);\n          }\n          return item;\n        });\n      }\n\n      if (typeof value === 'object' && value !== null) {\n        return createTerseProxy(value as Record<string, unknown>, keyMap);\n      }\n\n      return value;\n    },\n\n    has(target, prop: string | symbol) {\n      if (typeof prop === 'symbol') {\n        return Reflect.has(target, prop);\n      }\n      const shortKey = originalToShort.get(prop);\n      return (shortKey ?? prop) in target;\n    },\n\n    ownKeys(target) {\n      // Return original key names\n      return Object.keys(target).map(shortKey => keyMap[shortKey] ?? shortKey);\n    },\n\n    getOwnPropertyDescriptor(target, prop: string | symbol) {\n      if (typeof prop === 'symbol') {\n        return Reflect.getOwnPropertyDescriptor(target, prop);\n      }\n      const shortKey = originalToShort.get(prop);\n      const actualKey = shortKey ?? prop;\n      const descriptor = Object.getOwnPropertyDescriptor(target, actualKey);\n      if (descriptor) {\n        return { ...descriptor, enumerable: true, configurable: true };\n      }\n      return undefined;\n    },\n  };\n\n  return new Proxy(compressed, handler) as T;\n}\n\n/**\n * Wraps TersePayload data with Proxies for transparent access\n */\nexport function wrapWithProxy<T>(payload: TersePayload): T {\n  if (Array.isArray(payload.d)) {\n    return payload.d.map(item => {\n      if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n        return createTerseProxy(item as Record<string, unknown>, payload.k);\n      }\n      return item;\n    }) as T;\n  }\n\n  if (typeof payload.d === 'object' && payload.d !== null) {\n    return createTerseProxy(payload.d as Record<string, unknown>, payload.k) as T;\n  }\n\n  return payload.d as T;\n}\n\n// Re-export for convenience\nexport { isTersePayload };\n","/**\n * TerseJSON Server-Side Memory Optimization\n *\n * Utilities for memory-efficient data handling on the server:\n * - TerseCache: Store compressed data, return Proxy-wrapped on access\n * - compressStream: Compress data as it streams from database cursors\n * - createTerseServiceClient: Inter-service communication with compressed payloads\n */\n\nimport { compress, wrapWithProxy, isTersePayload } from './core';\nimport type { TersePayload, CompressOptions } from './types';\n\n/**\n * Options for TerseCache\n */\nexport interface TerseCacheOptions {\n  /** Compression options passed to compress() */\n  compressOptions?: CompressOptions;\n  /** Maximum number of entries (simple LRU when exceeded) */\n  maxSize?: number;\n  /** Default TTL in milliseconds (optional) */\n  defaultTTL?: number;\n}\n\n/**\n * A memory-efficient cache that stores data in compressed form.\n *\n * Data is compressed on set() and stays compressed in memory.\n * On get(), data is returned wrapped in a Proxy for lazy expansion.\n *\n * @example\n * ```typescript\n * const cache = new TerseCache<User[]>();\n *\n * // Store compressed - uses less memory\n * cache.set('users', largeUserArray);\n *\n * // Get returns Proxy-wrapped data\n * const users = cache.get('users');\n * users?.map(u => u.name); // Only 'name' field expands\n * ```\n */\nexport class TerseCache<T extends Record<string, unknown>[] = Record<string, unknown>[]> {\n  private cache: Map<string, { payload: TersePayload<T>; expiresAt?: number }>;\n  private options: TerseCacheOptions;\n  private accessOrder: string[] = [];\n\n  constructor(options: TerseCacheOptions = {}) {\n    this.cache = new Map();\n    this.options = options;\n  }\n\n  /**\n   * Store data in compressed form\n   */\n  set(key: string, data: T, ttl?: number): void {\n    // Enforce max size with simple LRU eviction\n    if (this.options.maxSize && this.cache.size >= this.options.maxSize) {\n      const oldestKey = this.accessOrder.shift();\n      if (oldestKey) {\n        this.cache.delete(oldestKey);\n      }\n    }\n\n    const payload = compress(data, this.options.compressOptions) as TersePayload<T>;\n    const effectiveTTL = ttl ?? this.options.defaultTTL;\n    const expiresAt = effectiveTTL ? Date.now() + effectiveTTL : undefined;\n\n    this.cache.set(key, { payload, expiresAt });\n    this.updateAccessOrder(key);\n  }\n\n  /**\n   * Get data wrapped in Proxy for lazy expansion.\n   * Only accessed fields are expanded from compressed form.\n   */\n  get(key: string): T | undefined {\n    const entry = this.cache.get(key);\n    if (!entry) return undefined;\n\n    // Check TTL\n    if (entry.expiresAt && Date.now() > entry.expiresAt) {\n      this.cache.delete(key);\n      this.removeFromAccessOrder(key);\n      return undefined;\n    }\n\n    this.updateAccessOrder(key);\n    return wrapWithProxy<T>(entry.payload);\n  }\n\n  /**\n   * Get the raw compressed payload without expansion.\n   * Useful for forwarding to other services.\n   */\n  getRaw(key: string): TersePayload<T> | undefined {\n    const entry = this.cache.get(key);\n    if (!entry) return undefined;\n\n    if (entry.expiresAt && Date.now() > entry.expiresAt) {\n      this.cache.delete(key);\n      this.removeFromAccessOrder(key);\n      return undefined;\n    }\n\n    return entry.payload;\n  }\n\n  /**\n   * Check if key exists (and is not expired)\n   */\n  has(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n\n    if (entry.expiresAt && Date.now() > entry.expiresAt) {\n      this.cache.delete(key);\n      this.removeFromAccessOrder(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Delete an entry\n   */\n  delete(key: string): boolean {\n    this.removeFromAccessOrder(key);\n    return this.cache.delete(key);\n  }\n\n  /**\n   * Clear all entries\n   */\n  clear(): void {\n    this.cache.clear();\n    this.accessOrder = [];\n  }\n\n  /**\n   * Get current cache size\n   */\n  get size(): number {\n    return this.cache.size;\n  }\n\n  private updateAccessOrder(key: string): void {\n    this.removeFromAccessOrder(key);\n    this.accessOrder.push(key);\n  }\n\n  private removeFromAccessOrder(key: string): void {\n    const index = this.accessOrder.indexOf(key);\n    if (index > -1) {\n      this.accessOrder.splice(index, 1);\n    }\n  }\n}\n\n/**\n * Options for streaming compression\n */\nexport interface CompressStreamOptions extends CompressOptions {\n  /** Number of items per batch (default: 100) */\n  batchSize?: number;\n}\n\n/**\n * Compress data as it streams from an async source (e.g., database cursor).\n *\n * Yields compressed batches without loading entire result set into memory.\n *\n * @example\n * ```typescript\n * // MongoDB cursor\n * const cursor = db.collection('users').find().stream();\n * for await (const batch of compressStream(cursor, { batchSize: 100 })) {\n *   // Send batch to client or process\n *   res.write(JSON.stringify(batch));\n * }\n *\n * // PostgreSQL stream\n * const stream = client.query(new QueryStream('SELECT * FROM users'));\n * for await (const batch of compressStream(stream)) {\n *   // Process compressed batches\n * }\n * ```\n */\nexport async function* compressStream<T extends Record<string, unknown>>(\n  source: AsyncIterable<T>,\n  options: CompressStreamOptions = {}\n): AsyncGenerator<TersePayload<T[]>, void, unknown> {\n  const batchSize = options.batchSize ?? 100;\n  const { batchSize: _, ...compressOptions } = options;\n\n  let batch: T[] = [];\n\n  for await (const item of source) {\n    batch.push(item);\n\n    if (batch.length >= batchSize) {\n      yield compress(batch, compressOptions) as TersePayload<T[]>;\n      batch = [];\n    }\n  }\n\n  // Yield remaining items\n  if (batch.length > 0) {\n    yield compress(batch, compressOptions) as TersePayload<T[]>;\n  }\n}\n\n/**\n * Configuration for TerseServiceClient\n */\nexport interface TerseServiceClientConfig {\n  /** Base URL for the service */\n  baseUrl: string;\n  /** Whether to expand responses with Proxy (default: true) */\n  expandOnReceive?: boolean;\n  /** Custom headers to include in all requests */\n  headers?: Record<string, string>;\n  /** Custom fetch implementation (for testing or Node.js < 18) */\n  fetch?: typeof globalThis.fetch;\n}\n\n/**\n * HTTP client for inter-service communication with TerseJSON.\n *\n * Services can pass compressed data without intermediate expansion,\n * reducing memory usage across the request chain.\n *\n * @example\n * ```typescript\n * const serviceB = createTerseServiceClient({\n *   baseUrl: 'http://service-b:3000',\n * });\n *\n * // GET - returns Proxy-wrapped data\n * const users = await serviceB.get<User[]>('/api/users');\n * users.map(u => u.name); // Only accessed fields expand\n *\n * // Forward compressed payload to another service\n * const raw = cache.getRaw('users');\n * if (raw) {\n *   await serviceB.forward('/api/users/sync', raw);\n * }\n * ```\n */\nexport function createTerseServiceClient(config: TerseServiceClientConfig) {\n  const {\n    baseUrl,\n    expandOnReceive = true,\n    headers: customHeaders = {},\n    fetch: customFetch = globalThis.fetch,\n  } = config;\n\n  const defaultHeaders = {\n    'Accept-Terse': 'true',\n    'Content-Type': 'application/json',\n    ...customHeaders,\n  };\n\n  return {\n    /**\n     * GET request - receives TerseJSON and returns Proxy-wrapped (or raw)\n     */\n    async get<T>(path: string, options?: { headers?: Record<string, string> }): Promise<T> {\n      const response = await customFetch(`${baseUrl}${path}`, {\n        method: 'GET',\n        headers: { ...defaultHeaders, ...options?.headers },\n      });\n\n      if (!response.ok) {\n        throw new Error(`TerseServiceClient: GET ${path} failed with status ${response.status}`);\n      }\n\n      const data = await response.json();\n\n      if (isTersePayload(data) && expandOnReceive) {\n        return wrapWithProxy<T>(data as TersePayload<T extends unknown[] ? T : never>);\n      }\n\n      return data as T;\n    },\n\n    /**\n     * POST request with automatic compression\n     */\n    async post<T, R = unknown>(\n      path: string,\n      data: T,\n      options?: { headers?: Record<string, string>; compress?: boolean }\n    ): Promise<R> {\n      const shouldCompress = options?.compress ?? Array.isArray(data);\n      const body = shouldCompress && Array.isArray(data)\n        ? JSON.stringify(compress(data as Record<string, unknown>[]))\n        : JSON.stringify(data);\n\n      const headers = {\n        ...defaultHeaders,\n        ...options?.headers,\n        ...(shouldCompress ? { 'X-Terse-JSON': 'true' } : {}),\n      };\n\n      const response = await customFetch(`${baseUrl}${path}`, {\n        method: 'POST',\n        headers,\n        body,\n      });\n\n      if (!response.ok) {\n        throw new Error(`TerseServiceClient: POST ${path} failed with status ${response.status}`);\n      }\n\n      const responseData = await response.json();\n\n      if (isTersePayload(responseData) && expandOnReceive) {\n        return wrapWithProxy<R>(responseData as TersePayload<R extends unknown[] ? R : never>);\n      }\n\n      return responseData as R;\n    },\n\n    /**\n     * Forward a raw TersePayload to another endpoint without expansion.\n     * Useful for passing data between services without intermediate deserialization.\n     */\n    async forward<T extends Record<string, unknown>[]>(\n      path: string,\n      payload: TersePayload<T>,\n      options?: { headers?: Record<string, string> }\n    ): Promise<void> {\n      const response = await customFetch(`${baseUrl}${path}`, {\n        method: 'POST',\n        headers: {\n          ...defaultHeaders,\n          ...options?.headers,\n          'X-Terse-JSON': 'true',\n        },\n        body: JSON.stringify(payload),\n      });\n\n      if (!response.ok) {\n        throw new Error(`TerseServiceClient: forward to ${path} failed with status ${response.status}`);\n      }\n    },\n  };\n}\n\n// Re-export core types for convenience\nexport type { TersePayload, CompressOptions };\n"]}

package/package.json

@@ -1,9 +1,15 @@
 {
   "name": "tersejson",
-  "version": "0.2.1",
-  "description": "Transparent JSON key compression for Express APIs. Reduce bandwidth by up to 80% with zero code changes.",
+  "version": "0.3.1",
+  "description": "Memory-efficient JSON processing. Lazy Proxy expansion uses 70% less RAM than JSON.parse - plus 30-80% smaller payloads.",
   "keywords": [
     "json",
+    "memory-efficient",
+    "lazy-loading",
+    "proxy",
+    "low-memory",
+    "gc-friendly",
+    "partial-deserialization",
     "compression",
     "express",
     "middleware",
@@ -17,11 +23,8 @@
     "payload",
     "reduce",
     "compact",
-    "shrink",
     "performance",
     "network",
-    "http",
-    "response",
     "nodejs",
     "node",
     "fetch",
@@ -29,13 +32,12 @@
     "react-query",
     "swr",
     "angular",
-    "restful",
+    "mongodb",
+    "mongoose",
+    "database",
     "key-compression",
-    "json-minify",
     "api-optimization",
-    "payload-compression",
     "lightweight",
-    "proxy",
     "transparent"
   ],
   "author": "Tim Carter",
@@ -86,6 +88,16 @@
       "types": "./dist/graphql-client.d.ts",
       "import": "./dist/graphql-client.mjs",
       "require": "./dist/graphql-client.js"
+    },
+    "./server-memory": {
+      "types": "./dist/server-memory.d.ts",
+      "import": "./dist/server-memory.mjs",
+      "require": "./dist/server-memory.js"
+    },
+    "./mongodb": {
+      "types": "./dist/mongodb.d.ts",
+      "import": "./dist/mongodb.mjs",
+      "require": "./dist/mongodb.js"
     }
   },
   "files": [
@@ -105,14 +117,16 @@
     "@types/node": "^20.11.0",
     "eslint": "^8.56.0",
     "express": "^4.18.2",
+    "mongodb": "^7.0.0",
     "sharp": "^0.34.5",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^1.2.0"
   },
   "peerDependencies": {
+    "@apollo/client": ">=3.0.0",
     "express": ">=4.0.0",
-    "@apollo/client": ">=3.0.0"
+    "mongodb": ">=5.0.0"
   },
   "peerDependenciesMeta": {
     "express": {
@@ -120,6 +134,9 @@
     },
     "@apollo/client": {
       "optional": true
+    },
+    "mongodb": {
+      "optional": true
     }
   },
   "engines": {