tersejson 0.1.0

package/dist/analytics.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/analytics.ts"],"names":[],"mappings":"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","file":"analytics.mjs","sourcesContent":["/**\n * TerseJSON Analytics\n *\n * Opt-in analytics to track compression savings.\n * Data is anonymous and helps improve the library.\n */\n\n/**\n * Compression event data\n */\nexport interface CompressionEvent {\n  /** Timestamp of the compression */\n  timestamp: number;\n  /** Original payload size in bytes */\n  originalSize: number;\n  /** Compressed payload size in bytes */\n  compressedSize: number;\n  /** Number of objects in the array */\n  objectCount: number;\n  /** Number of keys compressed */\n  keysCompressed: number;\n  /** Route/endpoint (optional, anonymized) */\n  endpoint?: string;\n  /** Key pattern used */\n  keyPattern: string;\n}\n\n/**\n * Aggregated stats for reporting\n */\nexport interface AnalyticsStats {\n  /** Total compression events */\n  totalEvents: number;\n  /** Total bytes before compression */\n  totalOriginalBytes: number;\n  /** Total bytes after compression */\n  totalCompressedBytes: number;\n  /** Total bytes saved */\n  totalBytesSaved: number;\n  /** Average compression ratio (0-1) */\n  averageRatio: number;\n  /** Total objects processed */\n  totalObjects: number;\n  /** Session start time */\n  sessionStart: number;\n  /** Last event time */\n  lastEvent: number;\n}\n\n/**\n * Analytics configuration\n */\nexport interface AnalyticsConfig {\n  /**\n   * Enable analytics collection\n   * @default false\n   */\n  enabled: boolean;\n\n  /**\n   * Send anonymous stats to tersejson.com\n   * Helps improve the library\n   * @default false\n   */\n  reportToCloud: boolean;\n\n  /**\n   * API key for tersejson.com (optional)\n   * Get one at tersejson.com/dashboard\n   */\n  apiKey?: string;\n\n  /**\n   * Project/site identifier (optional)\n   */\n  projectId?: string;\n\n  /**\n   * Callback for each compression event\n   * Use for custom logging/monitoring\n   */\n  onEvent?: (event: CompressionEvent) => void;\n\n  /**\n   * Callback for periodic stats summary\n   */\n  onStats?: (stats: AnalyticsStats) => void;\n\n  /**\n   * How often to report stats (ms)\n   * @default 60000 (1 minute)\n   */\n  reportInterval?: number;\n\n  /**\n   * Include endpoint paths in analytics\n   * Paths are hashed for privacy\n   * @default false\n   */\n  trackEndpoints?: boolean;\n\n  /**\n   * Cloud reporting endpoint\n   * @default 'https://api.tersejson.com/v1/analytics'\n   */\n  endpoint?: string;\n\n  /**\n   * Enable debug logging\n   * @default false\n   */\n  debug?: boolean;\n}\n\n/**\n * Default configuration\n */\nconst DEFAULT_CONFIG: Required<Omit<AnalyticsConfig, 'apiKey' | 'projectId' | 'onEvent' | 'onStats'>> = {\n  enabled: false,\n  reportToCloud: false,\n  reportInterval: 60000,\n  trackEndpoints: false,\n  endpoint: 'https://api.tersejson.com/v1/analytics',\n  debug: false,\n};\n\n/**\n * Analytics collector class\n */\nexport class TerseAnalytics {\n  private config: Required<Omit<AnalyticsConfig, 'apiKey' | 'projectId' | 'onEvent' | 'onStats'>> &\n    Pick<AnalyticsConfig, 'apiKey' | 'projectId' | 'onEvent' | 'onStats'>;\n  private events: CompressionEvent[] = [];\n  private stats: AnalyticsStats;\n  private reportTimer?: ReturnType<typeof setInterval>;\n  private isNode: boolean;\n\n  constructor(config: Partial<AnalyticsConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this.isNode = typeof window === 'undefined';\n    this.stats = this.createEmptyStats();\n\n    if (this.config.enabled && this.config.reportToCloud) {\n      this.startReporting();\n    }\n  }\n\n  /**\n   * Create empty stats object\n   */\n  private createEmptyStats(): AnalyticsStats {\n    return {\n      totalEvents: 0,\n      totalOriginalBytes: 0,\n      totalCompressedBytes: 0,\n      totalBytesSaved: 0,\n      averageRatio: 0,\n      totalObjects: 0,\n      sessionStart: Date.now(),\n      lastEvent: Date.now(),\n    };\n  }\n\n  /**\n   * Record a compression event\n   */\n  record(event: Omit<CompressionEvent, 'timestamp'>): void {\n    if (!this.config.enabled) return;\n\n    const fullEvent: CompressionEvent = {\n      ...event,\n      timestamp: Date.now(),\n      // Hash endpoint for privacy if tracking is enabled\n      endpoint: this.config.trackEndpoints && event.endpoint\n        ? this.hashEndpoint(event.endpoint)\n        : undefined,\n    };\n\n    // Update stats\n    this.stats.totalEvents++;\n    this.stats.totalOriginalBytes += event.originalSize;\n    this.stats.totalCompressedBytes += event.compressedSize;\n    this.stats.totalBytesSaved += (event.originalSize - event.compressedSize);\n    this.stats.totalObjects += event.objectCount;\n    this.stats.lastEvent = fullEvent.timestamp;\n    this.stats.averageRatio = this.stats.totalCompressedBytes / this.stats.totalOriginalBytes;\n\n    // Store event for batch reporting\n    this.events.push(fullEvent);\n\n    // Call event callback\n    if (this.config.onEvent) {\n      this.config.onEvent(fullEvent);\n    }\n\n    // Debug logging\n    if (this.config.debug) {\n      const savings = ((1 - event.compressedSize / event.originalSize) * 100).toFixed(1);\n      console.log(`[tersejson:analytics] ${event.originalSize} → ${event.compressedSize} bytes (${savings}% saved)`);\n    }\n  }\n\n  /**\n   * Get current stats\n   */\n  getStats(): AnalyticsStats {\n    return { ...this.stats };\n  }\n\n  /**\n   * Get formatted stats summary\n   */\n  getSummary(): string {\n    const stats = this.stats;\n    const savedKB = (stats.totalBytesSaved / 1024).toFixed(2);\n    const savedPercent = stats.totalOriginalBytes > 0\n      ? ((1 - stats.averageRatio) * 100).toFixed(1)\n      : '0';\n\n    return `TerseJSON Stats: ${stats.totalEvents} compressions, ${savedKB}KB saved (${savedPercent}% avg)`;\n  }\n\n  /**\n   * Reset stats\n   */\n  reset(): void {\n    this.events = [];\n    this.stats = this.createEmptyStats();\n  }\n\n  /**\n   * Start periodic reporting to cloud\n   */\n  private startReporting(): void {\n    if (this.reportTimer) return;\n\n    this.reportTimer = setInterval(() => {\n      this.reportToCloud();\n    }, this.config.reportInterval);\n\n    // Report on exit (Node.js only)\n    if (this.isNode && typeof process !== 'undefined') {\n      process.on('beforeExit', () => this.reportToCloud());\n    }\n  }\n\n  /**\n   * Stop reporting\n   */\n  stop(): void {\n    if (this.reportTimer) {\n      clearInterval(this.reportTimer);\n      this.reportTimer = undefined;\n    }\n  }\n\n  /**\n   * Report stats to tersejson.com\n   */\n  private async reportToCloud(): Promise<void> {\n    if (!this.config.reportToCloud || this.events.length === 0) return;\n\n    const payload = {\n      apiKey: this.config.apiKey,\n      projectId: this.config.projectId,\n      stats: this.stats,\n      events: this.events.slice(-100), // Last 100 events only\n      meta: {\n        version: '0.1.0',\n        runtime: this.isNode ? 'node' : 'browser',\n      },\n    };\n\n    try {\n      // Use appropriate fetch based on environment\n      const fetchFn = this.isNode\n        ? (await import('node:https')).request\n        : globalThis.fetch;\n\n      if (this.isNode) {\n        // Node.js - fire and forget\n        const url = new URL(this.config.endpoint);\n        const req = (fetchFn as typeof import('node:https').request)({\n          hostname: url.hostname,\n          port: url.port || 443,\n          path: url.pathname,\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n          },\n        });\n        req.write(JSON.stringify(payload));\n        req.end();\n      } else {\n        // Browser\n        (fetchFn as typeof fetch)(this.config.endpoint, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify(payload),\n          keepalive: true, // Allow sending on page unload\n        }).catch(() => {}); // Ignore errors\n      }\n\n      // Clear reported events\n      this.events = [];\n\n      // Call stats callback\n      if (this.config.onStats) {\n        this.config.onStats(this.stats);\n      }\n\n      if (this.config.debug) {\n        console.log('[tersejson:analytics] Reported stats to cloud');\n      }\n    } catch {\n      // Silently fail - analytics should never break the app\n      if (this.config.debug) {\n        console.log('[tersejson:analytics] Failed to report stats');\n      }\n    }\n  }\n\n  /**\n   * Hash endpoint for privacy\n   */\n  private hashEndpoint(endpoint: string): string {\n    // Simple hash - just keeps route structure without specifics\n    return endpoint\n      .replace(/\\/\\d+/g, '/:id')\n      .replace(/\\/[a-f0-9-]{36}/gi, '/:uuid')\n      .replace(/\\?.*$/, '');\n  }\n}\n\n/**\n * Global analytics instance (singleton)\n */\nlet globalAnalytics: TerseAnalytics | null = null;\n\n/**\n * Initialize global analytics\n */\nexport function initAnalytics(config: Partial<AnalyticsConfig>): TerseAnalytics {\n  globalAnalytics = new TerseAnalytics(config);\n  return globalAnalytics;\n}\n\n/**\n * Get global analytics instance\n */\nexport function getAnalytics(): TerseAnalytics | null {\n  return globalAnalytics;\n}\n\n/**\n * Record an event to global analytics (if initialized)\n */\nexport function recordEvent(event: Omit<CompressionEvent, 'timestamp'>): void {\n  globalAnalytics?.record(event);\n}\n\n/**\n * Quick setup for common use cases\n */\nexport const analytics = {\n  /**\n   * Enable local-only analytics (no cloud reporting)\n   */\n  local(options: { debug?: boolean; onEvent?: AnalyticsConfig['onEvent'] } = {}) {\n    return initAnalytics({\n      enabled: true,\n      reportToCloud: false,\n      debug: options.debug,\n      onEvent: options.onEvent,\n    });\n  },\n\n  /**\n   * Enable cloud analytics with API key\n   */\n  cloud(apiKey: string, options: Partial<AnalyticsConfig> = {}) {\n    return initAnalytics({\n      ...options,\n      enabled: true,\n      reportToCloud: true,\n      apiKey,\n    });\n  },\n\n  /**\n   * Get current stats\n   */\n  getStats() {\n    return globalAnalytics?.getStats() ?? null;\n  },\n\n  /**\n   * Get formatted summary\n   */\n  getSummary() {\n    return globalAnalytics?.getSummary() ?? 'Analytics not initialized';\n  },\n};\n\nexport default analytics;\n"]}

package/dist/client-BQAZg7I8.d.mts

@@ -0,0 +1,138 @@
+import { C as CompressOptions, T as TersePayload, K as KeyPattern, d as KeyGenerator, b as TerseClientOptions, i as isTersePayload } from './types-CzaGQaV7.mjs';
+
+/**
+ * TerseJSON Core
+ *
+ * The core compression and expansion algorithms.
+ */
+
+/**
+ * Creates a key generator from a pattern configuration
+ */
+declare function createKeyGenerator(pattern: KeyPattern): {
+    generator: KeyGenerator;
+    name: string;
+};
+/**
+ * Checks if an array is compressible (array of objects with consistent structure)
+ */
+declare function isCompressibleArray(data: unknown): data is Record<string, unknown>[];
+
+/**
+ * Compresses an array of objects by replacing keys with short aliases
+ */
+declare function compress<T extends Record<string, unknown>[]>(data: T, options?: CompressOptions): TersePayload<unknown[]>;
+/**
+ * Expands a TersePayload back to its original form
+ */
+declare function expand<T = unknown>(payload: TersePayload): T;
+/**
+ * Creates a Proxy that transparently maps original keys to short keys
+ * This is the magic that makes client-side access seamless
+ */
+declare function createTerseProxy<T extends Record<string, unknown>>(compressed: Record<string, unknown>, keyMap: Record<string, string>): T;
+/**
+ * Wraps TersePayload data with Proxies for transparent access
+ */
+declare function wrapWithProxy<T>(payload: TersePayload): T;
+
+/**
+ * TerseJSON Client
+ *
+ * Transparent client-side handling of TerseJSON responses.
+ * Use the fetch wrapper or manually expand responses.
+ */
+
+/**
+ * Process a potential TerseJSON response
+ * Automatically detects and expands/proxies terse payloads
+ */
+declare function process<T = unknown>(data: unknown, options?: {
+    useProxy?: boolean;
+}): T;
+/**
+ * Creates a fetch wrapper that automatically handles TerseJSON responses
+ *
+ * @example
+ * ```typescript
+ * import { createFetch } from 'tersejson/client';
+ *
+ * const fetch = createFetch();
+ *
+ * // Use exactly like regular fetch
+ * const users = await fetch('/api/users').then(r => r.json());
+ * console.log(users[0].firstName); // Works transparently!
+ * ```
+ */
+declare function createFetch(options?: TerseClientOptions): typeof globalThis.fetch;
+/**
+ * Drop-in fetch replacement with TerseJSON support
+ *
+ * @example
+ * ```typescript
+ * import { fetch } from 'tersejson/client';
+ *
+ * const users = await fetch('/api/users').then(r => r.json());
+ * console.log(users[0].firstName); // Transparent!
+ * ```
+ */
+declare const fetch: typeof globalThis.fetch;
+/**
+ * React hook for fetching with TerseJSON support (if using React)
+ * Returns a configured fetch function
+ *
+ * @example
+ * ```typescript
+ * function MyComponent() {
+ *   const terseFetch = useTerseFetch();
+ *   // Use in useEffect, etc.
+ * }
+ * ```
+ */
+declare function useTerseFetch(options?: TerseClientOptions): typeof globalThis.fetch;
+/**
+ * Axios interceptor for TerseJSON support
+ *
+ * @example
+ * ```typescript
+ * import axios from 'axios';
+ * import { axiosInterceptor } from 'tersejson/client';
+ *
+ * axios.interceptors.request.use(axiosInterceptor.request);
+ * axios.interceptors.response.use(axiosInterceptor.response);
+ * ```
+ */
+declare const axiosInterceptor: {
+    request: (config: {
+        headers?: Record<string, string>;
+    }) => {
+        headers?: Record<string, string>;
+    };
+    response: (response: {
+        headers?: Record<string, string>;
+        data?: unknown;
+    }) => {
+        headers?: Record<string, string>;
+        data?: unknown;
+    };
+};
+declare const _default: {
+    fetch: typeof globalThis.fetch;
+    createFetch: typeof createFetch;
+    expand: typeof expand;
+    proxy: typeof wrapWithProxy;
+    process: typeof process;
+};
+
+declare const client_axiosInterceptor: typeof axiosInterceptor;
+declare const client_createFetch: typeof createFetch;
+declare const client_expand: typeof expand;
+declare const client_fetch: typeof fetch;
+declare const client_isTersePayload: typeof isTersePayload;
+declare const client_process: typeof process;
+declare const client_useTerseFetch: typeof useTerseFetch;
+declare namespace client {
+  export { client_axiosInterceptor as axiosInterceptor, client_createFetch as createFetch, _default as default, client_expand as expand, client_fetch as fetch, client_isTersePayload as isTersePayload, client_process as process, wrapWithProxy as proxy, client_useTerseFetch as useTerseFetch };
+}
+
+export { _default as _, createTerseProxy as a, createKeyGenerator as b, compress as c, client as d, expand as e, createFetch as f, fetch as g, axiosInterceptor as h, isCompressibleArray as i, process as p, useTerseFetch as u, wrapWithProxy as w };

package/dist/client-DOOGwp_p.d.ts

@@ -0,0 +1,138 @@
+import { C as CompressOptions, T as TersePayload, K as KeyPattern, d as KeyGenerator, b as TerseClientOptions, i as isTersePayload } from './types-CzaGQaV7.js';
+
+/**
+ * TerseJSON Core
+ *
+ * The core compression and expansion algorithms.
+ */
+
+/**
+ * Creates a key generator from a pattern configuration
+ */
+declare function createKeyGenerator(pattern: KeyPattern): {
+    generator: KeyGenerator;
+    name: string;
+};
+/**
+ * Checks if an array is compressible (array of objects with consistent structure)
+ */
+declare function isCompressibleArray(data: unknown): data is Record<string, unknown>[];
+
+/**
+ * Compresses an array of objects by replacing keys with short aliases
+ */
+declare function compress<T extends Record<string, unknown>[]>(data: T, options?: CompressOptions): TersePayload<unknown[]>;
+/**
+ * Expands a TersePayload back to its original form
+ */
+declare function expand<T = unknown>(payload: TersePayload): T;
+/**
+ * Creates a Proxy that transparently maps original keys to short keys
+ * This is the magic that makes client-side access seamless
+ */
+declare function createTerseProxy<T extends Record<string, unknown>>(compressed: Record<string, unknown>, keyMap: Record<string, string>): T;
+/**
+ * Wraps TersePayload data with Proxies for transparent access
+ */
+declare function wrapWithProxy<T>(payload: TersePayload): T;
+
+/**
+ * TerseJSON Client
+ *
+ * Transparent client-side handling of TerseJSON responses.
+ * Use the fetch wrapper or manually expand responses.
+ */
+
+/**
+ * Process a potential TerseJSON response
+ * Automatically detects and expands/proxies terse payloads
+ */
+declare function process<T = unknown>(data: unknown, options?: {
+    useProxy?: boolean;
+}): T;
+/**
+ * Creates a fetch wrapper that automatically handles TerseJSON responses
+ *
+ * @example
+ * ```typescript
+ * import { createFetch } from 'tersejson/client';
+ *
+ * const fetch = createFetch();
+ *
+ * // Use exactly like regular fetch
+ * const users = await fetch('/api/users').then(r => r.json());
+ * console.log(users[0].firstName); // Works transparently!
+ * ```
+ */
+declare function createFetch(options?: TerseClientOptions): typeof globalThis.fetch;
+/**
+ * Drop-in fetch replacement with TerseJSON support
+ *
+ * @example
+ * ```typescript
+ * import { fetch } from 'tersejson/client';
+ *
+ * const users = await fetch('/api/users').then(r => r.json());
+ * console.log(users[0].firstName); // Transparent!
+ * ```
+ */
+declare const fetch: typeof globalThis.fetch;
+/**
+ * React hook for fetching with TerseJSON support (if using React)
+ * Returns a configured fetch function
+ *
+ * @example
+ * ```typescript
+ * function MyComponent() {
+ *   const terseFetch = useTerseFetch();
+ *   // Use in useEffect, etc.
+ * }
+ * ```
+ */
+declare function useTerseFetch(options?: TerseClientOptions): typeof globalThis.fetch;
+/**
+ * Axios interceptor for TerseJSON support
+ *
+ * @example
+ * ```typescript
+ * import axios from 'axios';
+ * import { axiosInterceptor } from 'tersejson/client';
+ *
+ * axios.interceptors.request.use(axiosInterceptor.request);
+ * axios.interceptors.response.use(axiosInterceptor.response);
+ * ```
+ */
+declare const axiosInterceptor: {
+    request: (config: {
+        headers?: Record<string, string>;
+    }) => {
+        headers?: Record<string, string>;
+    };
+    response: (response: {
+        headers?: Record<string, string>;
+        data?: unknown;
+    }) => {
+        headers?: Record<string, string>;
+        data?: unknown;
+    };
+};
+declare const _default: {
+    fetch: typeof globalThis.fetch;
+    createFetch: typeof createFetch;
+    expand: typeof expand;
+    proxy: typeof wrapWithProxy;
+    process: typeof process;
+};
+
+declare const client_axiosInterceptor: typeof axiosInterceptor;
+declare const client_createFetch: typeof createFetch;
+declare const client_expand: typeof expand;
+declare const client_fetch: typeof fetch;
+declare const client_isTersePayload: typeof isTersePayload;
+declare const client_process: typeof process;
+declare const client_useTerseFetch: typeof useTerseFetch;
+declare namespace client {
+  export { client_axiosInterceptor as axiosInterceptor, client_createFetch as createFetch, _default as default, client_expand as expand, client_fetch as fetch, client_isTersePayload as isTersePayload, client_process as process, wrapWithProxy as proxy, client_useTerseFetch as useTerseFetch };
+}
+
+export { _default as _, createTerseProxy as a, createKeyGenerator as b, compress as c, client as d, expand as e, createFetch as f, fetch as g, axiosInterceptor as h, isCompressibleArray as i, process as p, useTerseFetch as u, wrapWithProxy as w };

package/dist/client.d.mts

@@ -0,0 +1,2 @@
+export { i as isTersePayload } from './types-CzaGQaV7.mjs';
+export { h as axiosInterceptor, f as createFetch, _ as default, e as expand, g as fetch, p as process, w as proxy, u as useTerseFetch } from './client-BQAZg7I8.mjs';

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+export { i as isTersePayload } from './types-CzaGQaV7.js';
+export { h as axiosInterceptor, f as createFetch, _ as default, e as expand, g as fetch, p as process, w as proxy, u as useTerseFetch } from './client-DOOGwp_p.js';

package/dist/client.js

@@ -0,0 +1,200 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// 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 };
+
+exports.axiosInterceptor = axiosInterceptor;
+exports.createFetch = createFetch;
+exports.default = client_default;
+exports.expand = expand;
+exports.fetch = fetch;
+exports.isTersePayload = isTersePayload;
+exports.process = process;
+exports.proxy = wrapWithProxy;
+exports.useTerseFetch = useTerseFetch;
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/core.ts","../src/client.ts"],"names":[],"mappings":"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","file":"client.js","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"]}