tersejson 0.1.0

package/dist/client.mjs

@@ -0,0 +1,188 @@
+// 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 expandObject(obj, shortToKey, maxDepth, currentDepth = 0) {
+  if (currentDepth >= maxDepth) return obj;
+  const expanded = {};
+  for (const [shortKey, value] of Object.entries(obj)) {
+    const originalKey = shortToKey.get(shortKey) ?? shortKey;
+    if (Array.isArray(value)) {
+      expanded[originalKey] = value.map((item) => {
+        if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+          return expandObject(
+            item,
+            shortToKey,
+            maxDepth,
+            currentDepth + 1
+          );
+        }
+        return item;
+      });
+    } else if (typeof value === "object" && value !== null) {
+      expanded[originalKey] = expandObject(
+        value,
+        shortToKey,
+        maxDepth,
+        currentDepth + 1
+      );
+    } else {
+      expanded[originalKey] = value;
+    }
+  }
+  return expanded;
+}
+function expand(payload) {
+  const shortToKey = new Map(
+    Object.entries(payload.k).map(([short, original]) => [short, original])
+  );
+  if (Array.isArray(payload.d)) {
+    return payload.d.map((item) => {
+      if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+        return expandObject(item, shortToKey, 10);
+      }
+      return item;
+    });
+  }
+  if (typeof payload.d === "object" && payload.d !== null) {
+    return expandObject(payload.d, shortToKey, 10);
+  }
+  return payload.d;
+}
+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/client.ts
+var DEFAULT_OPTIONS = {
+  headerName: "x-terse-json",
+  debug: false,
+  autoExpand: true
+};
+function process(data, options = {}) {
+  const { useProxy = true } = options;
+  if (isTersePayload(data)) {
+    return useProxy ? wrapWithProxy(data) : expand(data);
+  }
+  return data;
+}
+function createFetch(options = {}) {
+  const config = { ...DEFAULT_OPTIONS, ...options };
+  return async function terseFetch(input, init = {}) {
+    const headers = new Headers(init.headers);
+    headers.set("accept-terse", "true");
+    const response = await globalThis.fetch(input, {
+      ...init,
+      headers
+    });
+    const isTerse = response.headers.get(config.headerName) === "true";
+    if (!isTerse || !config.autoExpand) {
+      return response;
+    }
+    const clonedResponse = response.clone();
+    return new Proxy(response, {
+      get(target, prop) {
+        if (prop === "json") {
+          return async function() {
+            const data = await clonedResponse.json();
+            if (isTersePayload(data)) {
+              if (config.debug) {
+                console.log("[tersejson] Expanding terse response");
+              }
+              return wrapWithProxy(data);
+            }
+            return data;
+          };
+        }
+        const value = Reflect.get(target, prop);
+        return typeof value === "function" ? value.bind(target) : value;
+      }
+    });
+  };
+}
+var fetch = createFetch();
+function useTerseFetch(options = {}) {
+  return createFetch(options);
+}
+var axiosInterceptor = {
+  request: (config) => {
+    config.headers = config.headers || {};
+    config.headers["accept-terse"] = "true";
+    return config;
+  },
+  response: (response) => {
+    const isTerse = response.headers?.["x-terse-json"] === "true";
+    if (isTerse && isTersePayload(response.data)) {
+      response.data = wrapWithProxy(response.data);
+    }
+    return response;
+  }
+};
+var client_default = { fetch, createFetch, expand, proxy: wrapWithProxy, process };
+
+export { axiosInterceptor, createFetch, client_default as default, expand, fetch, isTersePayload, process, wrapWithProxy as proxy, useTerseFetch };
+//# sourceMappingURL=client.mjs.map
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/core.ts","../src/client.ts"],"names":[],"mappings":"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","file":"client.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 * 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 Client\n *\n * Transparent client-side handling of TerseJSON responses.\n * Use the fetch wrapper or manually expand responses.\n */\n\nimport {\n  TerseClientOptions,\n  isTersePayload,\n} from './types';\nimport { expand, wrapWithProxy } from './core';\n\nconst DEFAULT_OPTIONS: Required<TerseClientOptions> = {\n  headerName: 'x-terse-json',\n  debug: false,\n  autoExpand: true,\n};\n\n/**\n * Expands a TerseJSON payload back to original format\n * Use this if you want full expansion (not proxied)\n */\nexport { expand };\n\n/**\n * Wraps a TerseJSON payload with Proxy for transparent key access\n * More memory efficient than full expansion for large datasets\n */\nexport { wrapWithProxy as proxy };\n\n/**\n * Check if a response/data is a TerseJSON payload\n */\nexport { isTersePayload };\n\n/**\n * Process a potential TerseJSON response\n * Automatically detects and expands/proxies terse payloads\n */\nexport function process<T = unknown>(\n  data: unknown,\n  options: { useProxy?: boolean } = {}\n): T {\n  const { useProxy = true } = options;\n\n  if (isTersePayload(data)) {\n    return useProxy ? wrapWithProxy<T>(data) : expand<T>(data);\n  }\n\n  return data as T;\n}\n\n/**\n * Creates a fetch wrapper that automatically handles TerseJSON responses\n *\n * @example\n * ```typescript\n * import { createFetch } from 'tersejson/client';\n *\n * const fetch = createFetch();\n *\n * // Use exactly like regular fetch\n * const users = await fetch('/api/users').then(r => r.json());\n * console.log(users[0].firstName); // Works transparently!\n * ```\n */\nexport function createFetch(options: TerseClientOptions = {}): typeof globalThis.fetch {\n  const config = { ...DEFAULT_OPTIONS, ...options };\n\n  return async function terseFetch(\n    input: RequestInfo | URL,\n    init: RequestInit = {}\n  ): Promise<Response> {\n    // Add header to indicate we accept terse responses\n    const headers = new Headers(init.headers);\n    headers.set('accept-terse', 'true');\n\n    const response = await globalThis.fetch(input, {\n      ...init,\n      headers,\n    });\n\n    // Check if response is terse\n    const isTerse = response.headers.get(config.headerName) === 'true';\n\n    if (!isTerse || !config.autoExpand) {\n      return response;\n    }\n\n    // Clone response and override json() method\n    const clonedResponse = response.clone();\n\n    // Create a wrapper that intercepts .json()\n    return new Proxy(response, {\n      get(target, prop) {\n        if (prop === 'json') {\n          return async function (): Promise<unknown> {\n            const data = await clonedResponse.json();\n\n            if (isTersePayload(data)) {\n              if (config.debug) {\n                console.log('[tersejson] Expanding terse response');\n              }\n              return wrapWithProxy(data);\n            }\n\n            return data;\n          };\n        }\n\n        const value = Reflect.get(target, prop);\n        return typeof value === 'function' ? value.bind(target) : value;\n      },\n    });\n  };\n}\n\n/**\n * Drop-in fetch replacement with TerseJSON support\n *\n * @example\n * ```typescript\n * import { fetch } from 'tersejson/client';\n *\n * const users = await fetch('/api/users').then(r => r.json());\n * console.log(users[0].firstName); // Transparent!\n * ```\n */\nexport const fetch = createFetch();\n\n/**\n * React hook for fetching with TerseJSON support (if using React)\n * Returns a configured fetch function\n *\n * @example\n * ```typescript\n * function MyComponent() {\n *   const terseFetch = useTerseFetch();\n *   // Use in useEffect, etc.\n * }\n * ```\n */\nexport function useTerseFetch(options: TerseClientOptions = {}): typeof globalThis.fetch {\n  // This is a simple hook that just returns the configured fetch\n  // Could be extended with caching, SWR integration, etc.\n  return createFetch(options);\n}\n\n/**\n * Axios interceptor for TerseJSON support\n *\n * @example\n * ```typescript\n * import axios from 'axios';\n * import { axiosInterceptor } from 'tersejson/client';\n *\n * axios.interceptors.request.use(axiosInterceptor.request);\n * axios.interceptors.response.use(axiosInterceptor.response);\n * ```\n */\nexport const axiosInterceptor = {\n  request: (config: { headers?: Record<string, string> }) => {\n    config.headers = config.headers || {};\n    config.headers['accept-terse'] = 'true';\n    return config;\n  },\n\n  response: (response: { headers?: Record<string, string>; data?: unknown }) => {\n    const isTerse = response.headers?.['x-terse-json'] === 'true';\n\n    if (isTerse && isTersePayload(response.data)) {\n      response.data = wrapWithProxy(response.data);\n    }\n\n    return response;\n  },\n};\n\n// Default export for convenience\nexport default { fetch, createFetch, expand, proxy: wrapWithProxy, process };\n"]}

package/dist/express-BoL__Ao6.d.mts

@@ -0,0 +1,67 @@
+import { RequestHandler } from 'express';
+import { a as TerseMiddlewareOptions } from './types-CzaGQaV7.mjs';
+import analytics, { AnalyticsConfig, TerseAnalytics, AnalyticsStats, CompressionEvent, getAnalytics, initAnalytics } from './analytics.mjs';
+
+/**
+ * TerseJSON Express Middleware
+ *
+ * Automatically compresses JSON responses with repeated object structures.
+ * Zero configuration required - just add the middleware.
+ */
+
+/**
+ * Extended middleware options with analytics
+ */
+interface TerseMiddlewareOptionsWithAnalytics extends TerseMiddlewareOptions {
+    /**
+     * Analytics configuration
+     * Set to true for local-only analytics
+     * Set to { apiKey: 'xxx' } for cloud reporting
+     */
+    analytics?: boolean | Partial<AnalyticsConfig> | TerseAnalytics;
+}
+/**
+ * Creates the TerseJSON Express middleware
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { terse } from 'tersejson/express';
+ *
+ * const app = express();
+ * app.use(terse());
+ *
+ * app.get('/users', (req, res) => {
+ *   // Just send data as normal - compression is automatic
+ *   res.json(users);
+ * });
+ * ```
+ */
+declare function terse(options?: TerseMiddlewareOptionsWithAnalytics): RequestHandler;
+/**
+ * Middleware to automatically add x-accept-terse header based on query param
+ * Useful for testing or when you can't control client headers
+ *
+ * @example
+ * ```typescript
+ * app.use(terseQueryParam());
+ * // Now ?terse=true will enable compression
+ * ```
+ */
+declare function terseQueryParam(paramName?: string): RequestHandler;
+
+declare const express_AnalyticsConfig: typeof AnalyticsConfig;
+declare const express_AnalyticsStats: typeof AnalyticsStats;
+declare const express_CompressionEvent: typeof CompressionEvent;
+declare const express_TerseAnalytics: typeof TerseAnalytics;
+type express_TerseMiddlewareOptionsWithAnalytics = TerseMiddlewareOptionsWithAnalytics;
+declare const express_analytics: typeof analytics;
+declare const express_getAnalytics: typeof getAnalytics;
+declare const express_initAnalytics: typeof initAnalytics;
+declare const express_terse: typeof terse;
+declare const express_terseQueryParam: typeof terseQueryParam;
+declare namespace express {
+  export { express_AnalyticsConfig as AnalyticsConfig, express_AnalyticsStats as AnalyticsStats, express_CompressionEvent as CompressionEvent, express_TerseAnalytics as TerseAnalytics, type express_TerseMiddlewareOptionsWithAnalytics as TerseMiddlewareOptionsWithAnalytics, express_analytics as analytics, terse as default, express_getAnalytics as getAnalytics, express_initAnalytics as initAnalytics, express_terse as terse, express_terseQueryParam as terseQueryParam };
+}
+
+export { type TerseMiddlewareOptionsWithAnalytics as T, terseQueryParam as a, express as e, terse as t };

package/dist/express-LSVylWpN.d.ts

@@ -0,0 +1,67 @@
+import { RequestHandler } from 'express';
+import { a as TerseMiddlewareOptions } from './types-CzaGQaV7.js';
+import analytics, { AnalyticsConfig, TerseAnalytics, AnalyticsStats, CompressionEvent, getAnalytics, initAnalytics } from './analytics.js';
+
+/**
+ * TerseJSON Express Middleware
+ *
+ * Automatically compresses JSON responses with repeated object structures.
+ * Zero configuration required - just add the middleware.
+ */
+
+/**
+ * Extended middleware options with analytics
+ */
+interface TerseMiddlewareOptionsWithAnalytics extends TerseMiddlewareOptions {
+    /**
+     * Analytics configuration
+     * Set to true for local-only analytics
+     * Set to { apiKey: 'xxx' } for cloud reporting
+     */
+    analytics?: boolean | Partial<AnalyticsConfig> | TerseAnalytics;
+}
+/**
+ * Creates the TerseJSON Express middleware
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { terse } from 'tersejson/express';
+ *
+ * const app = express();
+ * app.use(terse());
+ *
+ * app.get('/users', (req, res) => {
+ *   // Just send data as normal - compression is automatic
+ *   res.json(users);
+ * });
+ * ```
+ */
+declare function terse(options?: TerseMiddlewareOptionsWithAnalytics): RequestHandler;
+/**
+ * Middleware to automatically add x-accept-terse header based on query param
+ * Useful for testing or when you can't control client headers
+ *
+ * @example
+ * ```typescript
+ * app.use(terseQueryParam());
+ * // Now ?terse=true will enable compression
+ * ```
+ */
+declare function terseQueryParam(paramName?: string): RequestHandler;
+
+declare const express_AnalyticsConfig: typeof AnalyticsConfig;
+declare const express_AnalyticsStats: typeof AnalyticsStats;
+declare const express_CompressionEvent: typeof CompressionEvent;
+declare const express_TerseAnalytics: typeof TerseAnalytics;
+type express_TerseMiddlewareOptionsWithAnalytics = TerseMiddlewareOptionsWithAnalytics;
+declare const express_analytics: typeof analytics;
+declare const express_getAnalytics: typeof getAnalytics;
+declare const express_initAnalytics: typeof initAnalytics;
+declare const express_terse: typeof terse;
+declare const express_terseQueryParam: typeof terseQueryParam;
+declare namespace express {
+  export { express_AnalyticsConfig as AnalyticsConfig, express_AnalyticsStats as AnalyticsStats, express_CompressionEvent as CompressionEvent, express_TerseAnalytics as TerseAnalytics, type express_TerseMiddlewareOptionsWithAnalytics as TerseMiddlewareOptionsWithAnalytics, express_analytics as analytics, terse as default, express_getAnalytics as getAnalytics, express_initAnalytics as initAnalytics, express_terse as terse, express_terseQueryParam as terseQueryParam };
+}
+
+export { type TerseMiddlewareOptionsWithAnalytics as T, terseQueryParam as a, express as e, terse as t };

package/dist/express.d.mts

@@ -0,0 +1,4 @@
+import 'express';
+import './types-CzaGQaV7.mjs';
+export { AnalyticsConfig, AnalyticsStats, CompressionEvent, TerseAnalytics, default as analytics, getAnalytics, initAnalytics } from './analytics.mjs';
+export { T as TerseMiddlewareOptionsWithAnalytics, t as default, t as terse, a as terseQueryParam } from './express-BoL__Ao6.mjs';

package/dist/express.d.ts

@@ -0,0 +1,4 @@
+import 'express';
+import './types-CzaGQaV7.js';
+export { AnalyticsConfig, AnalyticsStats, CompressionEvent, TerseAnalytics, default as analytics, getAnalytics, initAnalytics } from './analytics.js';
+export { T as TerseMiddlewareOptionsWithAnalytics, t as default, t as terse, a as terseQueryParam } from './express-LSVylWpN.js';