tersejson 0.1.1 → 0.2.0

package/dist/graphql-client.mjs

@@ -0,0 +1,207 @@
+// src/types.ts
+function isGraphQLTersePayload(value) {
+  return typeof value === "object" && value !== null && "data" in value && "__terse__" in value && typeof value.__terse__ === "object" && value.__terse__ !== null && "v" in value.__terse__ && "k" in value.__terse__ && "paths" in value.__terse__;
+}
+
+// src/core.ts
+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);
+}
+
+// src/graphql-client.ts
+var DEFAULT_OPTIONS = {
+  useProxy: true,
+  debug: false
+};
+function getAtPath(obj, path) {
+  const parts = path.split(/\.|\[(\d+)\]/).filter(Boolean);
+  let current = obj;
+  for (const part of parts) {
+    if (current === null || current === void 0) return void 0;
+    const isIndex = /^\d+$/.test(part);
+    if (isIndex) {
+      current = current[parseInt(part, 10)];
+    } else {
+      current = current[part];
+    }
+  }
+  return current;
+}
+function setAtPath(obj, path, value) {
+  const parts = path.split(/\.|\[(\d+)\]/).filter(Boolean);
+  let current = obj;
+  for (let i = 0; i < parts.length - 1; i++) {
+    const part = parts[i];
+    const isIndex = /^\d+$/.test(part);
+    if (isIndex) {
+      current = current[parseInt(part, 10)];
+    } else {
+      current = current[part];
+    }
+  }
+  const lastPart = parts[parts.length - 1];
+  const isLastIndex = /^\d+$/.test(lastPart);
+  if (isLastIndex) {
+    current[parseInt(lastPart, 10)] = value;
+  } else {
+    current[lastPart] = value;
+  }
+}
+function expandObject(obj, keyMap, maxDepth = 10, currentDepth = 0) {
+  if (currentDepth >= maxDepth) return obj;
+  const shortToKey = new Map(
+    Object.entries(keyMap).map(([short, original]) => [short, original])
+  );
+  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, keyMap, maxDepth, currentDepth + 1);
+        }
+        return item;
+      });
+    } else if (typeof value === "object" && value !== null) {
+      expanded[originalKey] = expandObject(
+        value,
+        keyMap,
+        maxDepth,
+        currentDepth + 1
+      );
+    } else {
+      expanded[originalKey] = value;
+    }
+  }
+  return expanded;
+}
+function wrapArrayWithProxies(array, keyMap) {
+  return array.map((item) => createTerseProxy(item, keyMap));
+}
+function expandArray(array, keyMap) {
+  return array.map((item) => expandObject(item, keyMap));
+}
+function processGraphQLResponse(response, options = {}) {
+  const config = { ...DEFAULT_OPTIONS, ...options };
+  if (!isGraphQLTersePayload(response)) {
+    return response;
+  }
+  const terseResponse = response;
+  const { data, __terse__, ...rest } = terseResponse;
+  const { k: keyMap, paths } = __terse__;
+  if (config.debug) {
+    console.log("[tersejson/graphql-client] Processing terse response");
+    console.log("[tersejson/graphql-client] Paths:", paths);
+    console.log("[tersejson/graphql-client] Key map:", keyMap);
+  }
+  const clonedData = JSON.parse(JSON.stringify(data));
+  const result = { data: clonedData, ...rest };
+  for (const path of paths) {
+    const array = getAtPath(result, path);
+    if (!array || !Array.isArray(array)) {
+      if (config.debug) {
+        console.warn(`[tersejson/graphql-client] Path not found or not array: ${path}`);
+      }
+      continue;
+    }
+    if (config.useProxy) {
+      const proxied = wrapArrayWithProxies(array, keyMap);
+      setAtPath(result, path, proxied);
+    } else {
+      const expanded = expandArray(array, keyMap);
+      setAtPath(result, path, expanded);
+    }
+  }
+  return result;
+}
+function createTerseLink(options = {}) {
+  const config = { ...DEFAULT_OPTIONS, ...options };
+  return {
+    request(operation, forward) {
+      operation.setContext({
+        ...operation.getContext(),
+        headers: {
+          ...operation.getContext().headers || {},
+          "accept-terse": "true"
+        }
+      });
+      return forward(operation).map((result) => {
+        if (isGraphQLTersePayload(result)) {
+          if (config.debug) {
+            console.log("[tersejson/apollo] Processing terse response");
+          }
+          return processGraphQLResponse(result, config);
+        }
+        return result;
+      });
+    }
+  };
+}
+function createGraphQLFetch(options = {}) {
+  const config = { ...DEFAULT_OPTIONS, ...options };
+  return async function graphqlFetch(url, body, init = {}) {
+    const headers = new Headers(init.headers);
+    headers.set("Content-Type", "application/json");
+    headers.set("accept-terse", "true");
+    const response = await fetch(url, {
+      ...init,
+      method: "POST",
+      headers,
+      body: JSON.stringify(body)
+    });
+    const data = await response.json();
+    return processGraphQLResponse(data, config);
+  };
+}
+var graphql_client_default = processGraphQLResponse;
+
+export { createGraphQLFetch, createTerseLink, graphql_client_default as default, isGraphQLTersePayload, processGraphQLResponse };
+//# sourceMappingURL=graphql-client.mjs.map
+//# sourceMappingURL=graphql-client.mjs.map

package/dist/graphql-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/core.ts","../src/graphql-client.ts"],"names":[],"mappings":"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","file":"graphql-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/**\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 GraphQL Client\n *\n * Apollo Client Link and utilities for expanding GraphQL responses.\n */\n\nimport { GraphQLTerseResponse, isGraphQLTersePayload } from './types';\nimport { createTerseProxy } from './core';\n\n/**\n * Options for GraphQL client processing\n */\nexport interface GraphQLTerseClientOptions {\n  /**\n   * Use Proxy for lazy expansion (more memory efficient)\n   * @default true\n   */\n  useProxy?: boolean;\n\n  /**\n   * Enable debug logging\n   * @default false\n   */\n  debug?: boolean;\n}\n\nconst DEFAULT_OPTIONS: Required<GraphQLTerseClientOptions> = {\n  useProxy: true,\n  debug: false,\n};\n\n/**\n * Gets a value at a path in an object\n */\nfunction getAtPath(obj: unknown, path: string): unknown {\n  const parts = path.split(/\\.|\\[(\\d+)\\]/).filter(Boolean);\n  let current: unknown = obj;\n\n  for (const part of parts) {\n    if (current === null || current === undefined) return undefined;\n    const isIndex = /^\\d+$/.test(part);\n    if (isIndex) {\n      current = (current as unknown[])[parseInt(part, 10)];\n    } else {\n      current = (current as Record<string, unknown>)[part];\n    }\n  }\n\n  return current;\n}\n\n/**\n * Sets a value at a path in an object (mutates the object)\n */\nfunction setAtPath(obj: Record<string, unknown>, path: string, value: unknown): void {\n  const parts = path.split(/\\.|\\[(\\d+)\\]/).filter(Boolean);\n  let current: unknown = obj;\n\n  for (let i = 0; i < parts.length - 1; i++) {\n    const part = parts[i];\n    const isIndex = /^\\d+$/.test(part);\n    if (isIndex) {\n      current = (current as unknown[])[parseInt(part, 10)];\n    } else {\n      current = (current as Record<string, unknown>)[part];\n    }\n  }\n\n  const lastPart = parts[parts.length - 1];\n  const isLastIndex = /^\\d+$/.test(lastPart);\n  if (isLastIndex) {\n    (current as unknown[])[parseInt(lastPart, 10)] = value;\n  } else {\n    (current as Record<string, unknown>)[lastPart] = value;\n  }\n}\n\n/**\n * Expands an object using the key mapping\n */\nfunction expandObject(\n  obj: Record<string, unknown>,\n  keyMap: Record<string, string>,\n  maxDepth: number = 10,\n  currentDepth: number = 0\n): Record<string, unknown> {\n  if (currentDepth >= maxDepth) return obj;\n\n  const shortToKey = new Map(\n    Object.entries(keyMap).map(([short, original]) => [short, original])\n  );\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(item as Record<string, unknown>, keyMap, maxDepth, currentDepth + 1);\n        }\n        return item;\n      });\n    } else if (typeof value === 'object' && value !== null) {\n      expanded[originalKey] = expandObject(\n        value as Record<string, unknown>,\n        keyMap,\n        maxDepth,\n        currentDepth + 1\n      );\n    } else {\n      expanded[originalKey] = value;\n    }\n  }\n\n  return expanded;\n}\n\n/**\n * Wraps an array with Proxies for transparent key access\n */\nfunction wrapArrayWithProxies<T extends Record<string, unknown>>(\n  array: Record<string, unknown>[],\n  keyMap: Record<string, string>\n): T[] {\n  return array.map(item => createTerseProxy<T>(item, keyMap));\n}\n\n/**\n * Expands an array to its original form\n */\nfunction expandArray(\n  array: Record<string, unknown>[],\n  keyMap: Record<string, string>\n): Record<string, unknown>[] {\n  return array.map(item => expandObject(item, keyMap));\n}\n\n/**\n * Processes a GraphQL terse response, expanding compressed arrays\n *\n * @example\n * ```typescript\n * import { processGraphQLResponse } from 'tersejson/graphql-client';\n *\n * const response = await fetch('/graphql', {\n *   method: 'POST',\n *   headers: {\n *     'Content-Type': 'application/json',\n *     'accept-terse': 'true',\n *   },\n *   body: JSON.stringify({ query: '{ users { firstName lastName } }' }),\n * }).then(r => r.json());\n *\n * const expanded = processGraphQLResponse(response);\n * console.log(expanded.data.users[0].firstName); // Works transparently\n * ```\n */\nexport function processGraphQLResponse<T = unknown>(\n  response: unknown,\n  options: GraphQLTerseClientOptions = {}\n): T {\n  const config = { ...DEFAULT_OPTIONS, ...options };\n\n  // If not a terse response, return as-is\n  if (!isGraphQLTersePayload(response)) {\n    return response as T;\n  }\n\n  const terseResponse = response as GraphQLTerseResponse;\n  const { data, __terse__, ...rest } = terseResponse;\n  const { k: keyMap, paths } = __terse__;\n\n  if (config.debug) {\n    console.log('[tersejson/graphql-client] Processing terse response');\n    console.log('[tersejson/graphql-client] Paths:', paths);\n    console.log('[tersejson/graphql-client] Key map:', keyMap);\n  }\n\n  // Clone the data to avoid mutating\n  const clonedData = JSON.parse(JSON.stringify(data));\n  const result: Record<string, unknown> = { data: clonedData, ...rest };\n\n  // Process each compressed path\n  for (const path of paths) {\n    const array = getAtPath(result, path) as Record<string, unknown>[] | undefined;\n\n    if (!array || !Array.isArray(array)) {\n      if (config.debug) {\n        console.warn(`[tersejson/graphql-client] Path not found or not array: ${path}`);\n      }\n      continue;\n    }\n\n    if (config.useProxy) {\n      // Wrap with proxies for lazy expansion\n      const proxied = wrapArrayWithProxies(array, keyMap);\n      setAtPath(result, path, proxied);\n    } else {\n      // Fully expand the array\n      const expanded = expandArray(array, keyMap);\n      setAtPath(result, path, expanded);\n    }\n  }\n\n  return result as T;\n}\n\n/**\n * Type for Apollo Link (avoiding direct dependency)\n */\ninterface ApolloLinkLike {\n  request(\n    operation: { getContext: () => Record<string, unknown>; setContext: (ctx: Record<string, unknown>) => void },\n    forward: (operation: unknown) => { map: (fn: (result: unknown) => unknown) => unknown }\n  ): unknown;\n}\n\n/**\n * Creates an Apollo Client Link for TerseJSON\n *\n * This link automatically adds the accept-terse header and processes\n * terse responses transparently.\n *\n * @example\n * ```typescript\n * import { ApolloClient, InMemoryCache, HttpLink, from } from '@apollo/client';\n * import { createTerseLink } from 'tersejson/graphql-client';\n *\n * const terseLink = createTerseLink({ debug: true });\n *\n * const httpLink = new HttpLink({\n *   uri: '/graphql',\n * });\n *\n * const client = new ApolloClient({\n *   link: from([terseLink, httpLink]),\n *   cache: new InMemoryCache(),\n * });\n *\n * // Usage is completely transparent\n * const { data } = await client.query({\n *   query: gql`\n *     query GetUsers {\n *       users { firstName lastName email }\n *     }\n *   `,\n * });\n *\n * console.log(data.users[0].firstName); // Just works!\n * ```\n */\nexport function createTerseLink(options: GraphQLTerseClientOptions = {}): ApolloLinkLike {\n  const config = { ...DEFAULT_OPTIONS, ...options };\n\n  return {\n    request(operation, forward) {\n      // Add accept-terse header to the request\n      operation.setContext({\n        ...operation.getContext(),\n        headers: {\n          ...((operation.getContext().headers as Record<string, string>) || {}),\n          'accept-terse': 'true',\n        },\n      });\n\n      // Forward the operation and process the response\n      return forward(operation).map((result: unknown) => {\n        if (isGraphQLTersePayload(result)) {\n          if (config.debug) {\n            console.log('[tersejson/apollo] Processing terse response');\n          }\n          return processGraphQLResponse(result, config);\n        }\n        return result;\n      });\n    },\n  };\n}\n\n/**\n * Creates a fetch wrapper for GraphQL requests\n *\n * Useful for non-Apollo GraphQL clients or direct fetch usage.\n *\n * @example\n * ```typescript\n * import { createGraphQLFetch } from 'tersejson/graphql-client';\n *\n * const gqlFetch = createGraphQLFetch({ debug: true });\n *\n * const result = await gqlFetch('/graphql', {\n *   query: `{ users { firstName lastName } }`,\n * });\n *\n * console.log(result.data.users[0].firstName);\n * ```\n */\nexport function createGraphQLFetch(options: GraphQLTerseClientOptions = {}) {\n  const config = { ...DEFAULT_OPTIONS, ...options };\n\n  return async function graphqlFetch<T = unknown>(\n    url: string,\n    body: { query: string; variables?: Record<string, unknown>; operationName?: string },\n    init: RequestInit = {}\n  ): Promise<T> {\n    const headers = new Headers(init.headers);\n    headers.set('Content-Type', 'application/json');\n    headers.set('accept-terse', 'true');\n\n    const response = await fetch(url, {\n      ...init,\n      method: 'POST',\n      headers,\n      body: JSON.stringify(body),\n    });\n\n    const data = await response.json();\n\n    return processGraphQLResponse<T>(data, config);\n  };\n}\n\n// Re-export type guard for convenience\nexport { isGraphQLTersePayload } from './types';\n\n// Default export\nexport default processGraphQLResponse;\n"]}

package/dist/graphql.d.mts

@@ -0,0 +1,3 @@
+import 'express';
+import './types-BTonKlz8.mjs';
+export { c as compressGraphQLResponse, a as createTerseFormatFn, t as default, f as findCompressibleArrays, t as terseGraphQL } from './graphql-C3PTnqnZ.mjs';

package/dist/graphql.d.ts

@@ -0,0 +1,3 @@
+import 'express';
+import './types-BTonKlz8.js';
+export { c as compressGraphQLResponse, a as createTerseFormatFn, t as default, f as findCompressibleArrays, t as terseGraphQL } from './graphql-DmtweJgh.js';

package/dist/graphql.js

@@ -0,0 +1,304 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// 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 isCompressibleArray(data) {
+  if (!Array.isArray(data) || data.length === 0) return false;
+  return data.every(
+    (item) => typeof item === "object" && item !== null && !Array.isArray(item)
+  );
+}
+
+// src/graphql.ts
+var DEFAULT_OPTIONS = {
+  minArrayLength: 2,
+  debug: false,
+  minKeyLength: 3,
+  maxDepth: 10,
+  keyPattern: "alpha",
+  nestedHandling: "deep",
+  homogeneousOnly: false,
+  excludeKeys: [],
+  includeKeys: [],
+  excludePaths: []
+};
+function findCompressibleArrays(data, basePath = "data", options, currentDepth = 0) {
+  const results = [];
+  if (currentDepth >= options.maxDepth) return results;
+  if (Array.isArray(data)) {
+    if (isCompressibleArray(data) && data.length >= options.minArrayLength && !options.excludePaths.includes(basePath)) {
+      results.push({ path: basePath, data });
+    }
+    data.forEach((item, index) => {
+      if (typeof item === "object" && item !== null) {
+        const nestedResults = findCompressibleArrays(
+          item,
+          `${basePath}[${index}]`,
+          options,
+          currentDepth + 1
+        );
+        results.push(...nestedResults);
+      }
+    });
+  } else if (typeof data === "object" && data !== null) {
+    for (const [key, value] of Object.entries(data)) {
+      const path = `${basePath}.${key}`;
+      const nestedResults = findCompressibleArrays(value, path, options, currentDepth + 1);
+      results.push(...nestedResults);
+    }
+  }
+  return results;
+}
+function collectKeysFromArrays(arrays, options) {
+  const allKeys = /* @__PURE__ */ new Set();
+  const { minKeyLength = 3, excludeKeys = [], includeKeys = [] } = options;
+  function collectFromObject(obj, depth = 0) {
+    if (depth >= (options.maxDepth ?? 10)) return;
+    for (const key of Object.keys(obj)) {
+      if (excludeKeys.includes(key)) continue;
+      const shouldInclude = includeKeys.includes(key) || key.length >= minKeyLength;
+      if (shouldInclude) {
+        allKeys.add(key);
+      }
+      const value = obj[key];
+      if (Array.isArray(value)) {
+        for (const item of value) {
+          if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+            collectFromObject(item, depth + 1);
+          }
+        }
+      } else if (typeof value === "object" && value !== null) {
+        collectFromObject(value, depth + 1);
+      }
+    }
+  }
+  for (const { data } of arrays) {
+    for (const item of data) {
+      collectFromObject(item);
+    }
+  }
+  return allKeys;
+}
+function compressObjectWithMap(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)) {
+      compressed[shortKey] = value.map((item) => {
+        if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+          return compressObjectWithMap(
+            item,
+            keyToShort,
+            maxDepth,
+            currentDepth + 1
+          );
+        }
+        return item;
+      });
+    } else if (typeof value === "object" && value !== null) {
+      compressed[shortKey] = compressObjectWithMap(
+        value,
+        keyToShort,
+        maxDepth,
+        currentDepth + 1
+      );
+    } else {
+      compressed[shortKey] = value;
+    }
+  }
+  return compressed;
+}
+function setAtPath(obj, path, value) {
+  const parts = path.split(/\.|\[(\d+)\]/).filter(Boolean);
+  let current = obj;
+  for (let i = 0; i < parts.length - 1; i++) {
+    const part = parts[i];
+    const isIndex = /^\d+$/.test(part);
+    if (isIndex) {
+      current = current[parseInt(part, 10)];
+    } else {
+      current = current[part];
+    }
+  }
+  const lastPart = parts[parts.length - 1];
+  const isLastIndex = /^\d+$/.test(lastPart);
+  if (isLastIndex) {
+    current[parseInt(lastPart, 10)] = value;
+  } else {
+    current[lastPart] = value;
+  }
+}
+function compressGraphQLResponse(response, options = {}) {
+  const config = { ...DEFAULT_OPTIONS, ...options };
+  if (!response.data) {
+    return response;
+  }
+  const arrays = findCompressibleArrays(response.data, "data", {
+    minArrayLength: config.minArrayLength,
+    excludePaths: config.excludePaths,
+    maxDepth: config.maxDepth
+  });
+  const filteredArrays = config.shouldCompress ? arrays.filter(({ path, data }) => config.shouldCompress(data, path)) : arrays;
+  if (filteredArrays.length === 0) {
+    return response;
+  }
+  const allKeys = collectKeysFromArrays(filteredArrays, config);
+  const sortedKeys = Array.from(allKeys).sort();
+  const { generator } = createKeyGenerator(config.keyPattern);
+  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;
+    }
+  });
+  if (Object.keys(keyMap).length === 0) {
+    return response;
+  }
+  const clonedData = JSON.parse(JSON.stringify(response.data));
+  const sortedArrays = [...filteredArrays].sort((a, b) => {
+    const depthA = (a.path.match(/\./g) || []).length + (a.path.match(/\[/g) || []).length;
+    const depthB = (b.path.match(/\./g) || []).length + (b.path.match(/\[/g) || []).length;
+    return depthB - depthA;
+  });
+  const paths = [];
+  for (const { path, data } of sortedArrays) {
+    const compressedArray = data.map(
+      (item) => compressObjectWithMap(item, keyToShort, config.maxDepth)
+    );
+    setAtPath({ data: clonedData }, path, compressedArray);
+    paths.push(path);
+  }
+  const terseMeta = {
+    v: 1,
+    k: keyMap,
+    paths
+  };
+  const terseResponse = {
+    data: clonedData,
+    __terse__: terseMeta
+  };
+  if ("errors" in response && response.errors) {
+    terseResponse.errors = response.errors;
+  }
+  if ("extensions" in response && response.extensions) {
+    terseResponse.extensions = response.extensions;
+  }
+  if (config.debug) {
+    const originalSize = JSON.stringify(response).length;
+    const compressedSize = JSON.stringify(terseResponse).length;
+    const savings = ((1 - compressedSize / originalSize) * 100).toFixed(1);
+    console.log(
+      `[tersejson/graphql] Compressed ${originalSize} -> ${compressedSize} bytes (${savings}% savings)`
+    );
+    console.log(`[tersejson/graphql] Compressed paths: ${paths.join(", ")}`);
+  }
+  return terseResponse;
+}
+function createTerseFormatFn(options = {}) {
+  return function formatResult(result, _context, _info) {
+    return compressGraphQLResponse(result, options);
+  };
+}
+function terseGraphQL(graphqlMiddleware, options = {}) {
+  const config = { ...DEFAULT_OPTIONS, ...options };
+  return function terseGraphQLMiddleware(req, res, next) {
+    const acceptsTerse = req.headers["accept-terse"] === "true" || req.headers["x-accept-terse"] === "true";
+    if (!acceptsTerse) {
+      graphqlMiddleware(req, res, next);
+      return;
+    }
+    const originalJson = res.json.bind(res);
+    res.json = function terseGraphQLJson(data) {
+      if (typeof data === "object" && data !== null && "data" in data) {
+        try {
+          const compressed = compressGraphQLResponse(
+            data,
+            config
+          );
+          if ("__terse__" in compressed) {
+            res.setHeader("x-terse-json", "graphql");
+          }
+          return originalJson(compressed);
+        } catch (error) {
+          if (config.debug) {
+            console.error("[tersejson/graphql] Compression failed:", error);
+          }
+          return originalJson(data);
+        }
+      }
+      return originalJson(data);
+    };
+    graphqlMiddleware(req, res, next);
+  };
+}
+var graphql_default = terseGraphQL;
+
+exports.compressGraphQLResponse = compressGraphQLResponse;
+exports.createTerseFormatFn = createTerseFormatFn;
+exports.default = graphql_default;
+exports.findCompressibleArrays = findCompressibleArrays;
+exports.terseGraphQL = terseGraphQL;
+//# sourceMappingURL=graphql.js.map
+//# sourceMappingURL=graphql.js.map