tersejson 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +47 -4
- package/dist/{client-BQAZg7I8.d.mts → client-CFGvusCj.d.mts} +1 -1
- package/dist/{client-DOOGwp_p.d.ts → client-hUXNNGcN.d.ts} +1 -1
- package/dist/client.d.mts +2 -2
- package/dist/client.d.ts +2 -2
- package/dist/client.js.map +1 -1
- package/dist/client.mjs.map +1 -1
- package/dist/{express-LSVylWpN.d.ts → express-Da7WcJtt.d.ts} +1 -1
- package/dist/{express-BoL__Ao6.d.mts → express-O5w2NBTf.d.mts} +1 -1
- package/dist/express.d.mts +2 -2
- package/dist/express.d.ts +2 -2
- package/dist/graphql-C3PTnqnZ.d.mts +81 -0
- package/dist/graphql-DmtweJgh.d.ts +81 -0
- package/dist/graphql-client-2H4FjmRc.d.mts +123 -0
- package/dist/graphql-client-BXGtWqe9.d.ts +123 -0
- package/dist/graphql-client.d.mts +2 -0
- package/dist/graphql-client.d.ts +2 -0
- package/dist/graphql-client.js +215 -0
- package/dist/graphql-client.js.map +1 -0
- package/dist/graphql-client.mjs +207 -0
- package/dist/graphql-client.mjs.map +1 -0
- package/dist/graphql.d.mts +3 -0
- package/dist/graphql.d.ts +3 -0
- package/dist/graphql.js +304 -0
- package/dist/graphql.js.map +1 -0
- package/dist/graphql.mjs +296 -0
- package/dist/graphql.mjs.map +1 -0
- package/dist/index.d.mts +5 -3
- package/dist/index.d.ts +5 -3
- package/dist/index.js +400 -3
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +398 -4
- package/dist/index.mjs.map +1 -1
- package/dist/integrations.js.map +1 -1
- package/dist/integrations.mjs.map +1 -1
- package/dist/{types-CzaGQaV7.d.mts → types-BTonKlz8.d.mts} +56 -1
- package/dist/{types-CzaGQaV7.d.ts → types-BTonKlz8.d.ts} +56 -1
- package/package.json +44 -3
package/dist/integrations.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/types.ts","../src/core.ts","../src/integrations.ts"],"names":[],"mappings":"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","file":"integrations.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 Framework Integrations\n *\n * Ready-to-use integrations for popular HTTP clients and frameworks.\n */\n\nimport { isTersePayload } from './types';\nimport { wrapWithProxy, expand } from './core';\n\n// ============================================================================\n// AXIOS\n// ============================================================================\n\n/**\n * Axios request interceptor type\n */\ninterface AxiosRequestConfig {\n headers?: Record<string, string> | { set?: (key: string, value: string) => void };\n [key: string]: unknown;\n}\n\n/**\n * Axios response type\n */\ninterface AxiosResponse<T = unknown> {\n data: T;\n headers: Record<string, string> | { get?: (key: string) => string | null };\n status: number;\n statusText: string;\n config: AxiosRequestConfig;\n [key: string]: unknown;\n}\n\n/**\n * Create Axios interceptors for TerseJSON support\n *\n * @example\n * ```typescript\n * import axios from 'axios';\n * import { createAxiosInterceptors } from 'tersejson/integrations';\n *\n * const { request, response } = createAxiosInterceptors();\n * axios.interceptors.request.use(request);\n * axios.interceptors.response.use(response);\n *\n * // Now all axios requests automatically handle TerseJSON\n * const { data } = await axios.get('/api/users');\n * console.log(data[0].firstName); // Works transparently!\n * ```\n */\nexport function createAxiosInterceptors(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return {\n request: <T extends AxiosRequestConfig>(config: T): T => {\n // Handle both old-style object headers and new AxiosHeaders class\n if (config.headers) {\n if (typeof config.headers.set === 'function') {\n config.headers.set('accept-terse', 'true');\n } else {\n (config.headers as Record<string, string>)['accept-terse'] = 'true';\n }\n } else {\n config.headers = { 'accept-terse': 'true' };\n }\n return config;\n },\n\n response: <T>(response: AxiosResponse<T>): AxiosResponse<T> => {\n // Handle both old-style object headers and new AxiosHeaders class\n let isTerse = false;\n if (response.headers) {\n if (typeof response.headers.get === 'function') {\n isTerse = response.headers.get('x-terse-json') === 'true';\n } else {\n isTerse = (response.headers as Record<string, string>)['x-terse-json'] === 'true';\n }\n }\n\n if (isTerse && isTersePayload(response.data)) {\n if (debug) {\n console.log('[tersejson] Expanding Axios response');\n }\n response.data = (useProxy ? wrapWithProxy(response.data) : expand(response.data)) as T;\n }\n\n return response;\n },\n };\n}\n\n/**\n * Pre-configured Axios interceptors (convenience export)\n */\nexport const axiosInterceptors = createAxiosInterceptors();\n\n// ============================================================================\n// ANGULAR (Modern - HttpClient)\n// ============================================================================\n\n/**\n * Angular HttpInterceptor interface (simplified)\n */\ninterface HttpRequest<T = unknown> {\n clone: (options: { setHeaders?: Record<string, string> }) => HttpRequest<T>;\n [key: string]: unknown;\n}\n\ninterface HttpEvent<T = unknown> {\n type?: number;\n body?: T;\n headers?: { get: (name: string) => string | null };\n [key: string]: unknown;\n}\n\n// HttpHandler not needed - Angular uses its own\n\n/**\n * Creates an Angular HTTP interceptor for TerseJSON support\n *\n * @example\n * ```typescript\n * // terse.interceptor.ts\n * import { Injectable } from '@angular/core';\n * import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpResponse } from '@angular/common/http';\n * import { Observable } from 'rxjs';\n * import { map } from 'rxjs/operators';\n * import { createAngularInterceptor } from 'tersejson/integrations';\n *\n * @Injectable()\n * export class TerseInterceptor implements HttpInterceptor {\n * private handler = createAngularInterceptor();\n *\n * intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {\n * return this.handler(req, next);\n * }\n * }\n *\n * // app.module.ts\n * providers: [\n * { provide: HTTP_INTERCEPTORS, useClass: TerseInterceptor, multi: true }\n * ]\n * ```\n */\nexport function createAngularInterceptor(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n /**\n * Returns a function that can be used as the intercept method\n * Note: This returns the logic - you need to wrap it in an @Injectable class\n */\n return {\n /**\n * Modifies the request to include the accept-terse header\n */\n modifyRequest: <T>(req: HttpRequest<T>): HttpRequest<T> => {\n return req.clone({\n setHeaders: {\n 'accept-terse': 'true',\n },\n });\n },\n\n /**\n * Processes the response to expand TerseJSON payloads\n */\n processResponse: <T>(event: HttpEvent<T>): HttpEvent<T> => {\n // HttpResponse has type === 4\n if (event.type === 4 && event.body !== undefined) {\n const isTerse = event.headers?.get('x-terse-json') === 'true';\n\n if (isTerse && isTersePayload(event.body)) {\n if (debug) {\n console.log('[tersejson] Expanding Angular response');\n }\n // Create new response with expanded body\n return {\n ...event,\n body: (useProxy ? wrapWithProxy(event.body) : expand(event.body)) as T,\n };\n }\n }\n return event;\n },\n };\n}\n\n/**\n * Angular interceptor code snippet for copy-paste\n * Since Angular interceptors require decorators, we provide the implementation\n */\nexport const angularInterceptorSnippet = `\n// terse.interceptor.ts\nimport { Injectable } from '@angular/core';\nimport {\n HttpInterceptor,\n HttpRequest,\n HttpHandler,\n HttpEvent,\n HttpResponse\n} from '@angular/common/http';\nimport { Observable } from 'rxjs';\nimport { map } from 'rxjs/operators';\nimport { isTersePayload, wrapWithProxy } from 'tersejson';\n\n@Injectable()\nexport class TerseInterceptor implements HttpInterceptor {\n intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {\n // Add accept-terse header\n const terseReq = req.clone({\n setHeaders: { 'accept-terse': 'true' }\n });\n\n return next.handle(terseReq).pipe(\n map(event => {\n if (event instanceof HttpResponse && event.body) {\n const isTerse = event.headers.get('x-terse-json') === 'true';\n if (isTerse && isTersePayload(event.body)) {\n return event.clone({ body: wrapWithProxy(event.body) });\n }\n }\n return event;\n })\n );\n }\n}\n\n// app.module.ts - Add to providers:\n// { provide: HTTP_INTERCEPTORS, useClass: TerseInterceptor, multi: true }\n`;\n\n// ============================================================================\n// ANGULARJS (1.x - $http)\n// ============================================================================\n\n/**\n * AngularJS $http config type\n */\ninterface AngularJSHttpConfig {\n headers?: Record<string, string>;\n [key: string]: unknown;\n}\n\n/**\n * AngularJS $http response type\n */\ninterface AngularJSHttpResponse<T = unknown> {\n data: T;\n headers: (name: string) => string | null;\n status: number;\n statusText: string;\n config: AngularJSHttpConfig;\n}\n\n/**\n * Creates AngularJS $http interceptor for TerseJSON support\n *\n * @example\n * ```javascript\n * // In your AngularJS app config\n * angular.module('myApp', [])\n * .config(['$httpProvider', function($httpProvider) {\n * $httpProvider.interceptors.push(['$q', function($q) {\n * return createAngularJSInterceptor();\n * }]);\n * }]);\n * ```\n */\nexport function createAngularJSInterceptor(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return {\n /**\n * Request interceptor - adds accept-terse header\n */\n request: <T extends AngularJSHttpConfig>(config: T): T => {\n config.headers = config.headers || {};\n config.headers['accept-terse'] = 'true';\n return config;\n },\n\n /**\n * Response interceptor - expands TerseJSON payloads\n */\n response: <T>(response: AngularJSHttpResponse<T>): AngularJSHttpResponse<T> => {\n const isTerse = response.headers('x-terse-json') === 'true';\n\n if (isTerse && isTersePayload(response.data)) {\n if (debug) {\n console.log('[tersejson] Expanding AngularJS response');\n }\n response.data = (useProxy ? wrapWithProxy(response.data) : expand(response.data)) as T;\n }\n\n return response;\n },\n };\n}\n\n/**\n * AngularJS setup code snippet\n */\nexport const angularJSInterceptorSnippet = `\n// Setup TerseJSON with AngularJS\nangular.module('myApp', [])\n .factory('terseInterceptor', ['$q', function($q) {\n return {\n request: function(config) {\n config.headers = config.headers || {};\n config.headers['accept-terse'] = 'true';\n return config;\n },\n response: function(response) {\n var isTerse = response.headers('x-terse-json') === 'true';\n if (isTerse && response.data && response.data.__terse__) {\n // Use tersejson.process() or tersejson.wrapWithProxy()\n response.data = tersejson.process(response.data);\n }\n return response;\n }\n };\n }])\n .config(['$httpProvider', function($httpProvider) {\n $httpProvider.interceptors.push('terseInterceptor');\n }]);\n`;\n\n// ============================================================================\n// JQUERY AJAX\n// ============================================================================\n\n/**\n * jQuery AJAX setup for TerseJSON\n *\n * @example\n * ```javascript\n * import { setupJQueryAjax } from 'tersejson/integrations';\n * setupJQueryAjax($);\n *\n * // Now $.ajax, $.get, $.post all support TerseJSON\n * $.get('/api/users', function(data) {\n * console.log(data[0].firstName); // Works!\n * });\n * ```\n */\nexport function setupJQueryAjax(\n $: { ajaxSetup: (options: unknown) => void; ajaxPrefilter: (callback: unknown) => void },\n options: { useProxy?: boolean; debug?: boolean } = {}\n) {\n const { useProxy = true, debug = false } = options;\n\n // Add header to all requests\n $.ajaxSetup({\n headers: {\n 'accept-terse': 'true',\n },\n });\n\n // Process responses\n $.ajaxPrefilter((ajaxOptions: { dataFilter?: (data: string, type: string) => unknown }) => {\n const originalDataFilter = ajaxOptions.dataFilter;\n\n ajaxOptions.dataFilter = function (data: string, type: string) {\n let processed = data;\n\n if (originalDataFilter) {\n processed = originalDataFilter(data, type) as string;\n }\n\n if (type === 'json' || type === undefined) {\n try {\n const parsed = typeof processed === 'string' ? JSON.parse(processed) : processed;\n if (isTersePayload(parsed)) {\n if (debug) {\n console.log('[tersejson] Expanding jQuery response');\n }\n return useProxy ? wrapWithProxy(parsed) : expand(parsed);\n }\n return parsed;\n } catch {\n return processed;\n }\n }\n\n return processed;\n };\n });\n}\n\n/**\n * jQuery setup code snippet\n */\nexport const jQuerySetupSnippet = `\n// Setup TerseJSON with jQuery\n$.ajaxSetup({\n headers: { 'accept-terse': 'true' },\n dataFilter: function(data, type) {\n if (type === 'json') {\n var parsed = JSON.parse(data);\n if (parsed && parsed.__terse__) {\n return tersejson.process(parsed);\n }\n return parsed;\n }\n return data;\n }\n});\n`;\n\n// ============================================================================\n// SWR / React Query\n// ============================================================================\n\n/**\n * Creates a fetcher for SWR with TerseJSON support\n *\n * @example\n * ```typescript\n * import useSWR from 'swr';\n * import { createSWRFetcher } from 'tersejson/integrations';\n *\n * const fetcher = createSWRFetcher();\n *\n * function UserList() {\n * const { data, error } = useSWR('/api/users', fetcher);\n * return <div>{data?.[0].firstName}</div>;\n * }\n * ```\n */\nexport function createSWRFetcher(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return async <T>(url: string): Promise<T> => {\n const response = await globalThis.fetch(url, {\n headers: {\n 'accept-terse': 'true',\n },\n });\n\n if (!response.ok) {\n throw new Error(`HTTP error! status: ${response.status}`);\n }\n\n const data = await response.json();\n\n if (isTersePayload(data)) {\n if (debug) {\n console.log('[tersejson] Expanding SWR response');\n }\n return (useProxy ? wrapWithProxy(data) : expand(data)) as T;\n }\n\n return data as T;\n };\n}\n\n/**\n * Creates a query function for React Query / TanStack Query\n *\n * @example\n * ```typescript\n * import { useQuery } from '@tanstack/react-query';\n * import { createQueryFn } from 'tersejson/integrations';\n *\n * const queryFn = createQueryFn();\n *\n * function UserList() {\n * const { data } = useQuery({\n * queryKey: ['users'],\n * queryFn: () => queryFn('/api/users')\n * });\n * return <div>{data?.[0].firstName}</div>;\n * }\n * ```\n */\nexport const createQueryFn = createSWRFetcher; // Same implementation\n\n// ============================================================================\n// EXPORTS\n// ============================================================================\n\nexport default {\n // Axios\n createAxiosInterceptors,\n axiosInterceptors,\n\n // Angular\n createAngularInterceptor,\n angularInterceptorSnippet,\n\n // AngularJS\n createAngularJSInterceptor,\n angularJSInterceptorSnippet,\n\n // jQuery\n setupJQueryAjax,\n jQuerySetupSnippet,\n\n // SWR / React Query\n createSWRFetcher,\n createQueryFn,\n};\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/types.ts","../src/core.ts","../src/integrations.ts"],"names":[],"mappings":"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","file":"integrations.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/**\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 Framework Integrations\n *\n * Ready-to-use integrations for popular HTTP clients and frameworks.\n */\n\nimport { isTersePayload } from './types';\nimport { wrapWithProxy, expand } from './core';\n\n// ============================================================================\n// AXIOS\n// ============================================================================\n\n/**\n * Axios request interceptor type\n */\ninterface AxiosRequestConfig {\n headers?: Record<string, string> | { set?: (key: string, value: string) => void };\n [key: string]: unknown;\n}\n\n/**\n * Axios response type\n */\ninterface AxiosResponse<T = unknown> {\n data: T;\n headers: Record<string, string> | { get?: (key: string) => string | null };\n status: number;\n statusText: string;\n config: AxiosRequestConfig;\n [key: string]: unknown;\n}\n\n/**\n * Create Axios interceptors for TerseJSON support\n *\n * @example\n * ```typescript\n * import axios from 'axios';\n * import { createAxiosInterceptors } from 'tersejson/integrations';\n *\n * const { request, response } = createAxiosInterceptors();\n * axios.interceptors.request.use(request);\n * axios.interceptors.response.use(response);\n *\n * // Now all axios requests automatically handle TerseJSON\n * const { data } = await axios.get('/api/users');\n * console.log(data[0].firstName); // Works transparently!\n * ```\n */\nexport function createAxiosInterceptors(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return {\n request: <T extends AxiosRequestConfig>(config: T): T => {\n // Handle both old-style object headers and new AxiosHeaders class\n if (config.headers) {\n if (typeof config.headers.set === 'function') {\n config.headers.set('accept-terse', 'true');\n } else {\n (config.headers as Record<string, string>)['accept-terse'] = 'true';\n }\n } else {\n config.headers = { 'accept-terse': 'true' };\n }\n return config;\n },\n\n response: <T>(response: AxiosResponse<T>): AxiosResponse<T> => {\n // Handle both old-style object headers and new AxiosHeaders class\n let isTerse = false;\n if (response.headers) {\n if (typeof response.headers.get === 'function') {\n isTerse = response.headers.get('x-terse-json') === 'true';\n } else {\n isTerse = (response.headers as Record<string, string>)['x-terse-json'] === 'true';\n }\n }\n\n if (isTerse && isTersePayload(response.data)) {\n if (debug) {\n console.log('[tersejson] Expanding Axios response');\n }\n response.data = (useProxy ? wrapWithProxy(response.data) : expand(response.data)) as T;\n }\n\n return response;\n },\n };\n}\n\n/**\n * Pre-configured Axios interceptors (convenience export)\n */\nexport const axiosInterceptors = createAxiosInterceptors();\n\n// ============================================================================\n// ANGULAR (Modern - HttpClient)\n// ============================================================================\n\n/**\n * Angular HttpInterceptor interface (simplified)\n */\ninterface HttpRequest<T = unknown> {\n clone: (options: { setHeaders?: Record<string, string> }) => HttpRequest<T>;\n [key: string]: unknown;\n}\n\ninterface HttpEvent<T = unknown> {\n type?: number;\n body?: T;\n headers?: { get: (name: string) => string | null };\n [key: string]: unknown;\n}\n\n// HttpHandler not needed - Angular uses its own\n\n/**\n * Creates an Angular HTTP interceptor for TerseJSON support\n *\n * @example\n * ```typescript\n * // terse.interceptor.ts\n * import { Injectable } from '@angular/core';\n * import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpResponse } from '@angular/common/http';\n * import { Observable } from 'rxjs';\n * import { map } from 'rxjs/operators';\n * import { createAngularInterceptor } from 'tersejson/integrations';\n *\n * @Injectable()\n * export class TerseInterceptor implements HttpInterceptor {\n * private handler = createAngularInterceptor();\n *\n * intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {\n * return this.handler(req, next);\n * }\n * }\n *\n * // app.module.ts\n * providers: [\n * { provide: HTTP_INTERCEPTORS, useClass: TerseInterceptor, multi: true }\n * ]\n * ```\n */\nexport function createAngularInterceptor(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n /**\n * Returns a function that can be used as the intercept method\n * Note: This returns the logic - you need to wrap it in an @Injectable class\n */\n return {\n /**\n * Modifies the request to include the accept-terse header\n */\n modifyRequest: <T>(req: HttpRequest<T>): HttpRequest<T> => {\n return req.clone({\n setHeaders: {\n 'accept-terse': 'true',\n },\n });\n },\n\n /**\n * Processes the response to expand TerseJSON payloads\n */\n processResponse: <T>(event: HttpEvent<T>): HttpEvent<T> => {\n // HttpResponse has type === 4\n if (event.type === 4 && event.body !== undefined) {\n const isTerse = event.headers?.get('x-terse-json') === 'true';\n\n if (isTerse && isTersePayload(event.body)) {\n if (debug) {\n console.log('[tersejson] Expanding Angular response');\n }\n // Create new response with expanded body\n return {\n ...event,\n body: (useProxy ? wrapWithProxy(event.body) : expand(event.body)) as T,\n };\n }\n }\n return event;\n },\n };\n}\n\n/**\n * Angular interceptor code snippet for copy-paste\n * Since Angular interceptors require decorators, we provide the implementation\n */\nexport const angularInterceptorSnippet = `\n// terse.interceptor.ts\nimport { Injectable } from '@angular/core';\nimport {\n HttpInterceptor,\n HttpRequest,\n HttpHandler,\n HttpEvent,\n HttpResponse\n} from '@angular/common/http';\nimport { Observable } from 'rxjs';\nimport { map } from 'rxjs/operators';\nimport { isTersePayload, wrapWithProxy } from 'tersejson';\n\n@Injectable()\nexport class TerseInterceptor implements HttpInterceptor {\n intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {\n // Add accept-terse header\n const terseReq = req.clone({\n setHeaders: { 'accept-terse': 'true' }\n });\n\n return next.handle(terseReq).pipe(\n map(event => {\n if (event instanceof HttpResponse && event.body) {\n const isTerse = event.headers.get('x-terse-json') === 'true';\n if (isTerse && isTersePayload(event.body)) {\n return event.clone({ body: wrapWithProxy(event.body) });\n }\n }\n return event;\n })\n );\n }\n}\n\n// app.module.ts - Add to providers:\n// { provide: HTTP_INTERCEPTORS, useClass: TerseInterceptor, multi: true }\n`;\n\n// ============================================================================\n// ANGULARJS (1.x - $http)\n// ============================================================================\n\n/**\n * AngularJS $http config type\n */\ninterface AngularJSHttpConfig {\n headers?: Record<string, string>;\n [key: string]: unknown;\n}\n\n/**\n * AngularJS $http response type\n */\ninterface AngularJSHttpResponse<T = unknown> {\n data: T;\n headers: (name: string) => string | null;\n status: number;\n statusText: string;\n config: AngularJSHttpConfig;\n}\n\n/**\n * Creates AngularJS $http interceptor for TerseJSON support\n *\n * @example\n * ```javascript\n * // In your AngularJS app config\n * angular.module('myApp', [])\n * .config(['$httpProvider', function($httpProvider) {\n * $httpProvider.interceptors.push(['$q', function($q) {\n * return createAngularJSInterceptor();\n * }]);\n * }]);\n * ```\n */\nexport function createAngularJSInterceptor(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return {\n /**\n * Request interceptor - adds accept-terse header\n */\n request: <T extends AngularJSHttpConfig>(config: T): T => {\n config.headers = config.headers || {};\n config.headers['accept-terse'] = 'true';\n return config;\n },\n\n /**\n * Response interceptor - expands TerseJSON payloads\n */\n response: <T>(response: AngularJSHttpResponse<T>): AngularJSHttpResponse<T> => {\n const isTerse = response.headers('x-terse-json') === 'true';\n\n if (isTerse && isTersePayload(response.data)) {\n if (debug) {\n console.log('[tersejson] Expanding AngularJS response');\n }\n response.data = (useProxy ? wrapWithProxy(response.data) : expand(response.data)) as T;\n }\n\n return response;\n },\n };\n}\n\n/**\n * AngularJS setup code snippet\n */\nexport const angularJSInterceptorSnippet = `\n// Setup TerseJSON with AngularJS\nangular.module('myApp', [])\n .factory('terseInterceptor', ['$q', function($q) {\n return {\n request: function(config) {\n config.headers = config.headers || {};\n config.headers['accept-terse'] = 'true';\n return config;\n },\n response: function(response) {\n var isTerse = response.headers('x-terse-json') === 'true';\n if (isTerse && response.data && response.data.__terse__) {\n // Use tersejson.process() or tersejson.wrapWithProxy()\n response.data = tersejson.process(response.data);\n }\n return response;\n }\n };\n }])\n .config(['$httpProvider', function($httpProvider) {\n $httpProvider.interceptors.push('terseInterceptor');\n }]);\n`;\n\n// ============================================================================\n// JQUERY AJAX\n// ============================================================================\n\n/**\n * jQuery AJAX setup for TerseJSON\n *\n * @example\n * ```javascript\n * import { setupJQueryAjax } from 'tersejson/integrations';\n * setupJQueryAjax($);\n *\n * // Now $.ajax, $.get, $.post all support TerseJSON\n * $.get('/api/users', function(data) {\n * console.log(data[0].firstName); // Works!\n * });\n * ```\n */\nexport function setupJQueryAjax(\n $: { ajaxSetup: (options: unknown) => void; ajaxPrefilter: (callback: unknown) => void },\n options: { useProxy?: boolean; debug?: boolean } = {}\n) {\n const { useProxy = true, debug = false } = options;\n\n // Add header to all requests\n $.ajaxSetup({\n headers: {\n 'accept-terse': 'true',\n },\n });\n\n // Process responses\n $.ajaxPrefilter((ajaxOptions: { dataFilter?: (data: string, type: string) => unknown }) => {\n const originalDataFilter = ajaxOptions.dataFilter;\n\n ajaxOptions.dataFilter = function (data: string, type: string) {\n let processed = data;\n\n if (originalDataFilter) {\n processed = originalDataFilter(data, type) as string;\n }\n\n if (type === 'json' || type === undefined) {\n try {\n const parsed = typeof processed === 'string' ? JSON.parse(processed) : processed;\n if (isTersePayload(parsed)) {\n if (debug) {\n console.log('[tersejson] Expanding jQuery response');\n }\n return useProxy ? wrapWithProxy(parsed) : expand(parsed);\n }\n return parsed;\n } catch {\n return processed;\n }\n }\n\n return processed;\n };\n });\n}\n\n/**\n * jQuery setup code snippet\n */\nexport const jQuerySetupSnippet = `\n// Setup TerseJSON with jQuery\n$.ajaxSetup({\n headers: { 'accept-terse': 'true' },\n dataFilter: function(data, type) {\n if (type === 'json') {\n var parsed = JSON.parse(data);\n if (parsed && parsed.__terse__) {\n return tersejson.process(parsed);\n }\n return parsed;\n }\n return data;\n }\n});\n`;\n\n// ============================================================================\n// SWR / React Query\n// ============================================================================\n\n/**\n * Creates a fetcher for SWR with TerseJSON support\n *\n * @example\n * ```typescript\n * import useSWR from 'swr';\n * import { createSWRFetcher } from 'tersejson/integrations';\n *\n * const fetcher = createSWRFetcher();\n *\n * function UserList() {\n * const { data, error } = useSWR('/api/users', fetcher);\n * return <div>{data?.[0].firstName}</div>;\n * }\n * ```\n */\nexport function createSWRFetcher(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return async <T>(url: string): Promise<T> => {\n const response = await globalThis.fetch(url, {\n headers: {\n 'accept-terse': 'true',\n },\n });\n\n if (!response.ok) {\n throw new Error(`HTTP error! status: ${response.status}`);\n }\n\n const data = await response.json();\n\n if (isTersePayload(data)) {\n if (debug) {\n console.log('[tersejson] Expanding SWR response');\n }\n return (useProxy ? wrapWithProxy(data) : expand(data)) as T;\n }\n\n return data as T;\n };\n}\n\n/**\n * Creates a query function for React Query / TanStack Query\n *\n * @example\n * ```typescript\n * import { useQuery } from '@tanstack/react-query';\n * import { createQueryFn } from 'tersejson/integrations';\n *\n * const queryFn = createQueryFn();\n *\n * function UserList() {\n * const { data } = useQuery({\n * queryKey: ['users'],\n * queryFn: () => queryFn('/api/users')\n * });\n * return <div>{data?.[0].firstName}</div>;\n * }\n * ```\n */\nexport const createQueryFn = createSWRFetcher; // Same implementation\n\n// ============================================================================\n// EXPORTS\n// ============================================================================\n\nexport default {\n // Axios\n createAxiosInterceptors,\n axiosInterceptors,\n\n // Angular\n createAngularInterceptor,\n angularInterceptorSnippet,\n\n // AngularJS\n createAngularJSInterceptor,\n angularJSInterceptorSnippet,\n\n // jQuery\n setupJQueryAjax,\n jQuerySetupSnippet,\n\n // SWR / React Query\n createSWRFetcher,\n createQueryFn,\n};\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/types.ts","../src/core.ts","../src/integrations.ts"],"names":[],"mappings":"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","file":"integrations.mjs","sourcesContent":["/**\n * TerseJSON Types\n *\n * Defines the wire format and configuration options for transparent\n * JSON key compression.\n */\n\n/**\n * The compressed format sent over the wire\n */\nexport interface TersePayload<T = unknown> {\n /** Marker to identify this as a TerseJSON payload */\n __terse__: true;\n /** Version for future compatibility */\n v: 1;\n /** Key mapping: short key -> original key */\n k: Record<string, string>;\n /** The compressed data with short keys */\n d: T;\n /** Pattern used for key generation (for debugging/info) */\n p?: string;\n}\n\n/**\n * Built-in key pattern presets\n */\nexport type KeyPatternPreset =\n | 'alpha' // a, b, c, ... z, aa, ab (default)\n | 'numeric' // 0, 1, 2, ... 9, 10, 11\n | 'alphanumeric' // a1, a2, ... a9, b1, b2\n | 'short' // _, __, ___, a, b (shortest possible)\n | 'prefixed'; // k0, k1, k2 (with 'k' prefix)\n\n/**\n * Custom key generator function\n */\nexport type KeyGenerator = (index: number) => string;\n\n/**\n * Key pattern configuration\n */\nexport type KeyPattern =\n | KeyPatternPreset\n | { prefix: string; style?: 'numeric' | 'alpha' }\n | KeyGenerator;\n\n/**\n * How to handle nested structures\n */\nexport type NestedHandling =\n | 'deep' // Compress all nested objects/arrays (default)\n | 'shallow' // Only compress top-level array\n | 'arrays' // Only compress nested arrays, not single objects\n | number; // Specific depth limit (1 = shallow, Infinity = deep)\n\n/**\n * Compression options\n */\nexport interface CompressOptions {\n /**\n * Minimum key length to consider for compression\n * Keys shorter than this won't be shortened\n * @default 3\n */\n minKeyLength?: number;\n\n /**\n * Maximum depth to traverse for nested objects\n * @default 10\n */\n maxDepth?: number;\n\n /**\n * Key pattern to use for generating short keys\n * @default 'alpha'\n */\n keyPattern?: KeyPattern;\n\n /**\n * How to handle nested objects and arrays\n * @default 'deep'\n */\n nestedHandling?: NestedHandling;\n\n /**\n * Only compress keys that appear in all objects (homogeneous)\n * @default false\n */\n homogeneousOnly?: boolean;\n\n /**\n * Keys to always exclude from compression\n */\n excludeKeys?: string[];\n\n /**\n * Keys to always include in compression (even if short)\n */\n includeKeys?: string[];\n}\n\n/**\n * Configuration options for the Express middleware\n */\nexport interface TerseMiddlewareOptions extends CompressOptions {\n /**\n * Minimum array length to trigger compression\n * @default 2\n */\n minArrayLength?: number;\n\n /**\n * Custom function to determine if a response should be compressed\n * Return false to skip compression for specific responses\n */\n shouldCompress?: (data: unknown, req: unknown) => boolean;\n\n /**\n * Custom header name for signaling terse responses\n * @default 'x-terse-json'\n */\n headerName?: string;\n\n /**\n * Enable debug logging\n * @default false\n */\n debug?: boolean;\n}\n\n/**\n * Configuration options for the client\n */\nexport interface TerseClientOptions {\n /**\n * Custom header name to check for terse responses\n * @default 'x-terse-json'\n */\n headerName?: string;\n\n /**\n * Enable debug logging\n * @default false\n */\n debug?: boolean;\n\n /**\n * Automatically expand terse responses\n * @default true\n */\n autoExpand?: boolean;\n}\n\n/**\n * Type helper to preserve original types through compression\n */\nexport type Tersed<T> = T;\n\n/**\n * Check if a value is a TersePayload\n */\nexport function isTersePayload(value: unknown): value is TersePayload {\n return (\n typeof value === 'object' &&\n value !== null &&\n '__terse__' in value &&\n (value as TersePayload).__terse__ === true &&\n 'v' in value &&\n 'k' in value &&\n 'd' in value\n );\n}\n","/**\n * TerseJSON Core\n *\n * The core compression and expansion algorithms.\n */\n\nimport {\n TersePayload,\n isTersePayload,\n KeyPattern,\n KeyGenerator,\n NestedHandling,\n CompressOptions,\n} from './types';\n\n// ============================================================================\n// KEY PATTERN GENERATORS\n// ============================================================================\n\n/**\n * Alpha pattern: a, b, c, ... z, aa, ab, ...\n */\nfunction alphaGenerator(index: number): string {\n let key = '';\n let remaining = index;\n\n do {\n key = String.fromCharCode(97 + (remaining % 26)) + key;\n remaining = Math.floor(remaining / 26) - 1;\n } while (remaining >= 0);\n\n return key;\n}\n\n/**\n * Numeric pattern: 0, 1, 2, ... 9, 10, 11, ...\n */\nfunction numericGenerator(index: number): string {\n return String(index);\n}\n\n/**\n * Alphanumeric pattern: a1, a2, ... a9, b1, b2, ...\n */\nfunction alphanumericGenerator(index: number): string {\n const letterIndex = Math.floor(index / 9);\n const numIndex = (index % 9) + 1;\n return alphaGenerator(letterIndex) + numIndex;\n}\n\n/**\n * Short pattern: uses shortest possible keys\n * _, a, b, ..., z, aa, ab, ...\n */\nfunction shortGenerator(index: number): string {\n if (index === 0) return '_';\n return alphaGenerator(index - 1);\n}\n\n/**\n * Prefixed pattern: k0, k1, k2, ...\n */\nfunction prefixedGenerator(prefix: string, style: 'numeric' | 'alpha' = 'numeric'): KeyGenerator {\n return (index: number) => {\n if (style === 'alpha') {\n return prefix + alphaGenerator(index);\n }\n return prefix + index;\n };\n}\n\n/**\n * Creates a key generator from a pattern configuration\n */\nexport function createKeyGenerator(pattern: KeyPattern): { generator: KeyGenerator; name: string } {\n // If it's already a function, use it directly\n if (typeof pattern === 'function') {\n return { generator: pattern, name: 'custom' };\n }\n\n // If it's a preset string\n if (typeof pattern === 'string') {\n switch (pattern) {\n case 'alpha':\n return { generator: alphaGenerator, name: 'alpha' };\n case 'numeric':\n return { generator: numericGenerator, name: 'numeric' };\n case 'alphanumeric':\n return { generator: alphanumericGenerator, name: 'alphanumeric' };\n case 'short':\n return { generator: shortGenerator, name: 'short' };\n case 'prefixed':\n return { generator: prefixedGenerator('k'), name: 'prefixed:k' };\n default:\n return { generator: alphaGenerator, name: 'alpha' };\n }\n }\n\n // If it's a prefix config object\n if (typeof pattern === 'object' && 'prefix' in pattern) {\n return {\n generator: prefixedGenerator(pattern.prefix, pattern.style || 'numeric'),\n name: `prefixed:${pattern.prefix}`,\n };\n }\n\n return { generator: alphaGenerator, name: 'alpha' };\n}\n\n/**\n * Resolves nested handling to a numeric depth\n */\nfunction resolveNestedDepth(handling: NestedHandling | undefined, maxDepth: number): number {\n if (handling === undefined || handling === 'deep') {\n return maxDepth;\n }\n if (handling === 'shallow') {\n return 1;\n }\n if (handling === 'arrays') {\n return maxDepth; // Special handling in collect/compress functions\n }\n if (typeof handling === 'number') {\n return handling;\n }\n return maxDepth;\n}\n\n// Legacy generateShortKey removed - use createKeyGenerator instead\n\ninterface CollectKeysOptions {\n minKeyLength: number;\n maxDepth: number;\n nestedHandling: NestedHandling;\n excludeKeys?: string[];\n includeKeys?: string[];\n homogeneousOnly?: boolean;\n}\n\n/**\n * Collects all unique keys from an array of objects\n */\nfunction collectKeys(\n data: Record<string, unknown>[],\n options: CollectKeysOptions,\n currentDepth: number = 0\n): Set<string> {\n const keys = new Set<string>();\n const { minKeyLength, maxDepth, nestedHandling, excludeKeys, includeKeys } = options;\n\n if (currentDepth >= maxDepth) return keys;\n\n // For homogeneous mode, track key counts\n const keyCounts = new Map<string, number>();\n\n for (const item of data) {\n if (typeof item !== 'object' || item === null) continue;\n\n for (const key of Object.keys(item)) {\n // Skip excluded keys\n if (excludeKeys?.includes(key)) continue;\n\n // Include if in includeKeys, or if meets minKeyLength\n const shouldInclude = includeKeys?.includes(key) || key.length >= minKeyLength;\n\n if (shouldInclude) {\n keys.add(key);\n keyCounts.set(key, (keyCounts.get(key) || 0) + 1);\n }\n\n // Handle nested structures based on nestedHandling option\n const value = item[key];\n\n if (nestedHandling === 'shallow') {\n // Don't process nested structures\n continue;\n }\n\n if (Array.isArray(value) && value.length > 0 && isCompressibleArray(value)) {\n // Nested array of objects - always process\n const nestedKeys = collectKeys(\n value as Record<string, unknown>[],\n options,\n currentDepth + 1\n );\n nestedKeys.forEach(k => keys.add(k));\n } else if (\n nestedHandling !== 'arrays' &&\n typeof value === 'object' &&\n value !== null &&\n !Array.isArray(value)\n ) {\n // Single nested object - skip if nestedHandling is 'arrays'\n const nestedKeys = collectKeys(\n [value as Record<string, unknown>],\n options,\n currentDepth + 1\n );\n nestedKeys.forEach(k => keys.add(k));\n }\n }\n }\n\n // If homogeneous mode, only keep keys that appear in ALL objects\n if (options.homogeneousOnly && data.length > 0) {\n for (const [key, count] of keyCounts) {\n if (count < data.length) {\n keys.delete(key);\n }\n }\n }\n\n return keys;\n}\n\n/**\n * Checks if an array is compressible (array of objects with consistent structure)\n */\nexport function isCompressibleArray(data: unknown): data is Record<string, unknown>[] {\n if (!Array.isArray(data) || data.length === 0) return false;\n\n // Check if all items are objects\n return data.every(\n item => typeof item === 'object' && item !== null && !Array.isArray(item)\n );\n}\n\n/**\n * Compresses an object using the key mapping\n */\nfunction compressObject(\n obj: Record<string, unknown>,\n keyToShort: Map<string, string>,\n maxDepth: number,\n currentDepth: number = 0\n): Record<string, unknown> {\n if (currentDepth >= maxDepth) return obj;\n\n const compressed: Record<string, unknown> = {};\n\n for (const [key, value] of Object.entries(obj)) {\n const shortKey = keyToShort.get(key) ?? key;\n\n if (Array.isArray(value) && isCompressibleArray(value)) {\n // Recursively compress nested arrays\n compressed[shortKey] = value.map(item =>\n compressObject(\n item as Record<string, unknown>,\n keyToShort,\n maxDepth,\n currentDepth + 1\n )\n );\n } else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n // Compress single nested objects too\n compressed[shortKey] = compressObject(\n value as Record<string, unknown>,\n keyToShort,\n maxDepth,\n currentDepth + 1\n );\n } else {\n compressed[shortKey] = value;\n }\n }\n\n return compressed;\n}\n\n/**\n * Expands an object using the key mapping\n */\nfunction expandObject(\n obj: Record<string, unknown>,\n shortToKey: Map<string, string>,\n maxDepth: number,\n currentDepth: number = 0\n): Record<string, unknown> {\n if (currentDepth >= maxDepth) return obj;\n\n const expanded: Record<string, unknown> = {};\n\n for (const [shortKey, value] of Object.entries(obj)) {\n const originalKey = shortToKey.get(shortKey) ?? shortKey;\n\n if (Array.isArray(value)) {\n expanded[originalKey] = value.map(item => {\n if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n return expandObject(\n item as Record<string, unknown>,\n shortToKey,\n maxDepth,\n currentDepth + 1\n );\n }\n return item;\n });\n } else if (typeof value === 'object' && value !== null) {\n expanded[originalKey] = expandObject(\n value as Record<string, unknown>,\n shortToKey,\n maxDepth,\n currentDepth + 1\n );\n } else {\n expanded[originalKey] = value;\n }\n }\n\n return expanded;\n}\n\n// Re-export CompressOptions from types for backwards compatibility\nexport type { CompressOptions } from './types';\n\n/**\n * Compresses an array of objects by replacing keys with short aliases\n */\nexport function compress<T extends Record<string, unknown>[]>(\n data: T,\n options: CompressOptions = {}\n): TersePayload<unknown[]> {\n const {\n minKeyLength = 3,\n maxDepth = 10,\n keyPattern = 'alpha',\n nestedHandling = 'deep',\n homogeneousOnly = false,\n excludeKeys,\n includeKeys,\n } = options;\n\n // Create key generator\n const { generator, name: patternName } = createKeyGenerator(keyPattern);\n\n // Resolve nested depth\n const effectiveDepth = resolveNestedDepth(nestedHandling, maxDepth);\n\n // Collect all unique keys\n const allKeys = collectKeys(data, {\n minKeyLength,\n maxDepth: effectiveDepth,\n nestedHandling,\n excludeKeys,\n includeKeys,\n homogeneousOnly,\n });\n\n // Sort keys by frequency of use (most used first) for optimal compression\n // For now, just sort alphabetically for deterministic output\n const sortedKeys = Array.from(allKeys).sort();\n\n // Create bidirectional mapping\n const keyToShort = new Map<string, string>();\n const keyMap: Record<string, string> = {};\n\n sortedKeys.forEach((key, index) => {\n const shortKey = generator(index);\n // Only use short key if it's actually shorter\n if (shortKey.length < key.length) {\n keyToShort.set(key, shortKey);\n keyMap[shortKey] = key;\n }\n });\n\n // Compress the data\n const compressed = data.map(item =>\n compressObject(item, keyToShort, effectiveDepth)\n );\n\n return {\n __terse__: true,\n v: 1,\n k: keyMap,\n d: compressed,\n p: patternName,\n };\n}\n\n/**\n * Expands a TersePayload back to its original form\n */\nexport function expand<T = unknown>(payload: TersePayload): T {\n const shortToKey = new Map(\n Object.entries(payload.k).map(([short, original]) => [short, original])\n );\n\n if (Array.isArray(payload.d)) {\n return payload.d.map(item => {\n if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n return expandObject(item as Record<string, unknown>, shortToKey, 10);\n }\n return item;\n }) as T;\n }\n\n if (typeof payload.d === 'object' && payload.d !== null) {\n return expandObject(payload.d as Record<string, unknown>, shortToKey, 10) as T;\n }\n\n return payload.d as T;\n}\n\n/**\n * Creates a Proxy that transparently maps original keys to short keys\n * This is the magic that makes client-side access seamless\n */\nexport function createTerseProxy<T extends Record<string, unknown>>(\n compressed: Record<string, unknown>,\n keyMap: Record<string, string> // short -> original\n): T {\n // Create reverse map: original -> short\n const originalToShort = new Map(\n Object.entries(keyMap).map(([short, original]) => [original, short])\n );\n\n const handler: ProxyHandler<Record<string, unknown>> = {\n get(target, prop: string | symbol) {\n if (typeof prop === 'symbol') {\n return Reflect.get(target, prop);\n }\n\n // Check if accessing by original key name\n const shortKey = originalToShort.get(prop);\n const actualKey = shortKey ?? prop;\n const value = target[actualKey];\n\n // Recursively proxy nested objects/arrays\n if (Array.isArray(value)) {\n return value.map(item => {\n if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n return createTerseProxy(item as Record<string, unknown>, keyMap);\n }\n return item;\n });\n }\n\n if (typeof value === 'object' && value !== null) {\n return createTerseProxy(value as Record<string, unknown>, keyMap);\n }\n\n return value;\n },\n\n has(target, prop: string | symbol) {\n if (typeof prop === 'symbol') {\n return Reflect.has(target, prop);\n }\n const shortKey = originalToShort.get(prop);\n return (shortKey ?? prop) in target;\n },\n\n ownKeys(target) {\n // Return original key names\n return Object.keys(target).map(shortKey => keyMap[shortKey] ?? shortKey);\n },\n\n getOwnPropertyDescriptor(target, prop: string | symbol) {\n if (typeof prop === 'symbol') {\n return Reflect.getOwnPropertyDescriptor(target, prop);\n }\n const shortKey = originalToShort.get(prop);\n const actualKey = shortKey ?? prop;\n const descriptor = Object.getOwnPropertyDescriptor(target, actualKey);\n if (descriptor) {\n return { ...descriptor, enumerable: true, configurable: true };\n }\n return undefined;\n },\n };\n\n return new Proxy(compressed, handler) as T;\n}\n\n/**\n * Wraps TersePayload data with Proxies for transparent access\n */\nexport function wrapWithProxy<T>(payload: TersePayload): T {\n if (Array.isArray(payload.d)) {\n return payload.d.map(item => {\n if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n return createTerseProxy(item as Record<string, unknown>, payload.k);\n }\n return item;\n }) as T;\n }\n\n if (typeof payload.d === 'object' && payload.d !== null) {\n return createTerseProxy(payload.d as Record<string, unknown>, payload.k) as T;\n }\n\n return payload.d as T;\n}\n\n// Re-export for convenience\nexport { isTersePayload };\n","/**\n * TerseJSON Framework Integrations\n *\n * Ready-to-use integrations for popular HTTP clients and frameworks.\n */\n\nimport { isTersePayload } from './types';\nimport { wrapWithProxy, expand } from './core';\n\n// ============================================================================\n// AXIOS\n// ============================================================================\n\n/**\n * Axios request interceptor type\n */\ninterface AxiosRequestConfig {\n headers?: Record<string, string> | { set?: (key: string, value: string) => void };\n [key: string]: unknown;\n}\n\n/**\n * Axios response type\n */\ninterface AxiosResponse<T = unknown> {\n data: T;\n headers: Record<string, string> | { get?: (key: string) => string | null };\n status: number;\n statusText: string;\n config: AxiosRequestConfig;\n [key: string]: unknown;\n}\n\n/**\n * Create Axios interceptors for TerseJSON support\n *\n * @example\n * ```typescript\n * import axios from 'axios';\n * import { createAxiosInterceptors } from 'tersejson/integrations';\n *\n * const { request, response } = createAxiosInterceptors();\n * axios.interceptors.request.use(request);\n * axios.interceptors.response.use(response);\n *\n * // Now all axios requests automatically handle TerseJSON\n * const { data } = await axios.get('/api/users');\n * console.log(data[0].firstName); // Works transparently!\n * ```\n */\nexport function createAxiosInterceptors(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return {\n request: <T extends AxiosRequestConfig>(config: T): T => {\n // Handle both old-style object headers and new AxiosHeaders class\n if (config.headers) {\n if (typeof config.headers.set === 'function') {\n config.headers.set('accept-terse', 'true');\n } else {\n (config.headers as Record<string, string>)['accept-terse'] = 'true';\n }\n } else {\n config.headers = { 'accept-terse': 'true' };\n }\n return config;\n },\n\n response: <T>(response: AxiosResponse<T>): AxiosResponse<T> => {\n // Handle both old-style object headers and new AxiosHeaders class\n let isTerse = false;\n if (response.headers) {\n if (typeof response.headers.get === 'function') {\n isTerse = response.headers.get('x-terse-json') === 'true';\n } else {\n isTerse = (response.headers as Record<string, string>)['x-terse-json'] === 'true';\n }\n }\n\n if (isTerse && isTersePayload(response.data)) {\n if (debug) {\n console.log('[tersejson] Expanding Axios response');\n }\n response.data = (useProxy ? wrapWithProxy(response.data) : expand(response.data)) as T;\n }\n\n return response;\n },\n };\n}\n\n/**\n * Pre-configured Axios interceptors (convenience export)\n */\nexport const axiosInterceptors = createAxiosInterceptors();\n\n// ============================================================================\n// ANGULAR (Modern - HttpClient)\n// ============================================================================\n\n/**\n * Angular HttpInterceptor interface (simplified)\n */\ninterface HttpRequest<T = unknown> {\n clone: (options: { setHeaders?: Record<string, string> }) => HttpRequest<T>;\n [key: string]: unknown;\n}\n\ninterface HttpEvent<T = unknown> {\n type?: number;\n body?: T;\n headers?: { get: (name: string) => string | null };\n [key: string]: unknown;\n}\n\n// HttpHandler not needed - Angular uses its own\n\n/**\n * Creates an Angular HTTP interceptor for TerseJSON support\n *\n * @example\n * ```typescript\n * // terse.interceptor.ts\n * import { Injectable } from '@angular/core';\n * import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpResponse } from '@angular/common/http';\n * import { Observable } from 'rxjs';\n * import { map } from 'rxjs/operators';\n * import { createAngularInterceptor } from 'tersejson/integrations';\n *\n * @Injectable()\n * export class TerseInterceptor implements HttpInterceptor {\n * private handler = createAngularInterceptor();\n *\n * intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {\n * return this.handler(req, next);\n * }\n * }\n *\n * // app.module.ts\n * providers: [\n * { provide: HTTP_INTERCEPTORS, useClass: TerseInterceptor, multi: true }\n * ]\n * ```\n */\nexport function createAngularInterceptor(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n /**\n * Returns a function that can be used as the intercept method\n * Note: This returns the logic - you need to wrap it in an @Injectable class\n */\n return {\n /**\n * Modifies the request to include the accept-terse header\n */\n modifyRequest: <T>(req: HttpRequest<T>): HttpRequest<T> => {\n return req.clone({\n setHeaders: {\n 'accept-terse': 'true',\n },\n });\n },\n\n /**\n * Processes the response to expand TerseJSON payloads\n */\n processResponse: <T>(event: HttpEvent<T>): HttpEvent<T> => {\n // HttpResponse has type === 4\n if (event.type === 4 && event.body !== undefined) {\n const isTerse = event.headers?.get('x-terse-json') === 'true';\n\n if (isTerse && isTersePayload(event.body)) {\n if (debug) {\n console.log('[tersejson] Expanding Angular response');\n }\n // Create new response with expanded body\n return {\n ...event,\n body: (useProxy ? wrapWithProxy(event.body) : expand(event.body)) as T,\n };\n }\n }\n return event;\n },\n };\n}\n\n/**\n * Angular interceptor code snippet for copy-paste\n * Since Angular interceptors require decorators, we provide the implementation\n */\nexport const angularInterceptorSnippet = `\n// terse.interceptor.ts\nimport { Injectable } from '@angular/core';\nimport {\n HttpInterceptor,\n HttpRequest,\n HttpHandler,\n HttpEvent,\n HttpResponse\n} from '@angular/common/http';\nimport { Observable } from 'rxjs';\nimport { map } from 'rxjs/operators';\nimport { isTersePayload, wrapWithProxy } from 'tersejson';\n\n@Injectable()\nexport class TerseInterceptor implements HttpInterceptor {\n intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {\n // Add accept-terse header\n const terseReq = req.clone({\n setHeaders: { 'accept-terse': 'true' }\n });\n\n return next.handle(terseReq).pipe(\n map(event => {\n if (event instanceof HttpResponse && event.body) {\n const isTerse = event.headers.get('x-terse-json') === 'true';\n if (isTerse && isTersePayload(event.body)) {\n return event.clone({ body: wrapWithProxy(event.body) });\n }\n }\n return event;\n })\n );\n }\n}\n\n// app.module.ts - Add to providers:\n// { provide: HTTP_INTERCEPTORS, useClass: TerseInterceptor, multi: true }\n`;\n\n// ============================================================================\n// ANGULARJS (1.x - $http)\n// ============================================================================\n\n/**\n * AngularJS $http config type\n */\ninterface AngularJSHttpConfig {\n headers?: Record<string, string>;\n [key: string]: unknown;\n}\n\n/**\n * AngularJS $http response type\n */\ninterface AngularJSHttpResponse<T = unknown> {\n data: T;\n headers: (name: string) => string | null;\n status: number;\n statusText: string;\n config: AngularJSHttpConfig;\n}\n\n/**\n * Creates AngularJS $http interceptor for TerseJSON support\n *\n * @example\n * ```javascript\n * // In your AngularJS app config\n * angular.module('myApp', [])\n * .config(['$httpProvider', function($httpProvider) {\n * $httpProvider.interceptors.push(['$q', function($q) {\n * return createAngularJSInterceptor();\n * }]);\n * }]);\n * ```\n */\nexport function createAngularJSInterceptor(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return {\n /**\n * Request interceptor - adds accept-terse header\n */\n request: <T extends AngularJSHttpConfig>(config: T): T => {\n config.headers = config.headers || {};\n config.headers['accept-terse'] = 'true';\n return config;\n },\n\n /**\n * Response interceptor - expands TerseJSON payloads\n */\n response: <T>(response: AngularJSHttpResponse<T>): AngularJSHttpResponse<T> => {\n const isTerse = response.headers('x-terse-json') === 'true';\n\n if (isTerse && isTersePayload(response.data)) {\n if (debug) {\n console.log('[tersejson] Expanding AngularJS response');\n }\n response.data = (useProxy ? wrapWithProxy(response.data) : expand(response.data)) as T;\n }\n\n return response;\n },\n };\n}\n\n/**\n * AngularJS setup code snippet\n */\nexport const angularJSInterceptorSnippet = `\n// Setup TerseJSON with AngularJS\nangular.module('myApp', [])\n .factory('terseInterceptor', ['$q', function($q) {\n return {\n request: function(config) {\n config.headers = config.headers || {};\n config.headers['accept-terse'] = 'true';\n return config;\n },\n response: function(response) {\n var isTerse = response.headers('x-terse-json') === 'true';\n if (isTerse && response.data && response.data.__terse__) {\n // Use tersejson.process() or tersejson.wrapWithProxy()\n response.data = tersejson.process(response.data);\n }\n return response;\n }\n };\n }])\n .config(['$httpProvider', function($httpProvider) {\n $httpProvider.interceptors.push('terseInterceptor');\n }]);\n`;\n\n// ============================================================================\n// JQUERY AJAX\n// ============================================================================\n\n/**\n * jQuery AJAX setup for TerseJSON\n *\n * @example\n * ```javascript\n * import { setupJQueryAjax } from 'tersejson/integrations';\n * setupJQueryAjax($);\n *\n * // Now $.ajax, $.get, $.post all support TerseJSON\n * $.get('/api/users', function(data) {\n * console.log(data[0].firstName); // Works!\n * });\n * ```\n */\nexport function setupJQueryAjax(\n $: { ajaxSetup: (options: unknown) => void; ajaxPrefilter: (callback: unknown) => void },\n options: { useProxy?: boolean; debug?: boolean } = {}\n) {\n const { useProxy = true, debug = false } = options;\n\n // Add header to all requests\n $.ajaxSetup({\n headers: {\n 'accept-terse': 'true',\n },\n });\n\n // Process responses\n $.ajaxPrefilter((ajaxOptions: { dataFilter?: (data: string, type: string) => unknown }) => {\n const originalDataFilter = ajaxOptions.dataFilter;\n\n ajaxOptions.dataFilter = function (data: string, type: string) {\n let processed = data;\n\n if (originalDataFilter) {\n processed = originalDataFilter(data, type) as string;\n }\n\n if (type === 'json' || type === undefined) {\n try {\n const parsed = typeof processed === 'string' ? JSON.parse(processed) : processed;\n if (isTersePayload(parsed)) {\n if (debug) {\n console.log('[tersejson] Expanding jQuery response');\n }\n return useProxy ? wrapWithProxy(parsed) : expand(parsed);\n }\n return parsed;\n } catch {\n return processed;\n }\n }\n\n return processed;\n };\n });\n}\n\n/**\n * jQuery setup code snippet\n */\nexport const jQuerySetupSnippet = `\n// Setup TerseJSON with jQuery\n$.ajaxSetup({\n headers: { 'accept-terse': 'true' },\n dataFilter: function(data, type) {\n if (type === 'json') {\n var parsed = JSON.parse(data);\n if (parsed && parsed.__terse__) {\n return tersejson.process(parsed);\n }\n return parsed;\n }\n return data;\n }\n});\n`;\n\n// ============================================================================\n// SWR / React Query\n// ============================================================================\n\n/**\n * Creates a fetcher for SWR with TerseJSON support\n *\n * @example\n * ```typescript\n * import useSWR from 'swr';\n * import { createSWRFetcher } from 'tersejson/integrations';\n *\n * const fetcher = createSWRFetcher();\n *\n * function UserList() {\n * const { data, error } = useSWR('/api/users', fetcher);\n * return <div>{data?.[0].firstName}</div>;\n * }\n * ```\n */\nexport function createSWRFetcher(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return async <T>(url: string): Promise<T> => {\n const response = await globalThis.fetch(url, {\n headers: {\n 'accept-terse': 'true',\n },\n });\n\n if (!response.ok) {\n throw new Error(`HTTP error! status: ${response.status}`);\n }\n\n const data = await response.json();\n\n if (isTersePayload(data)) {\n if (debug) {\n console.log('[tersejson] Expanding SWR response');\n }\n return (useProxy ? wrapWithProxy(data) : expand(data)) as T;\n }\n\n return data as T;\n };\n}\n\n/**\n * Creates a query function for React Query / TanStack Query\n *\n * @example\n * ```typescript\n * import { useQuery } from '@tanstack/react-query';\n * import { createQueryFn } from 'tersejson/integrations';\n *\n * const queryFn = createQueryFn();\n *\n * function UserList() {\n * const { data } = useQuery({\n * queryKey: ['users'],\n * queryFn: () => queryFn('/api/users')\n * });\n * return <div>{data?.[0].firstName}</div>;\n * }\n * ```\n */\nexport const createQueryFn = createSWRFetcher; // Same implementation\n\n// ============================================================================\n// EXPORTS\n// ============================================================================\n\nexport default {\n // Axios\n createAxiosInterceptors,\n axiosInterceptors,\n\n // Angular\n createAngularInterceptor,\n angularInterceptorSnippet,\n\n // AngularJS\n createAngularJSInterceptor,\n angularJSInterceptorSnippet,\n\n // jQuery\n setupJQueryAjax,\n jQuerySetupSnippet,\n\n // SWR / React Query\n createSWRFetcher,\n createQueryFn,\n};\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/types.ts","../src/core.ts","../src/integrations.ts"],"names":[],"mappings":"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","file":"integrations.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 Framework Integrations\n *\n * Ready-to-use integrations for popular HTTP clients and frameworks.\n */\n\nimport { isTersePayload } from './types';\nimport { wrapWithProxy, expand } from './core';\n\n// ============================================================================\n// AXIOS\n// ============================================================================\n\n/**\n * Axios request interceptor type\n */\ninterface AxiosRequestConfig {\n headers?: Record<string, string> | { set?: (key: string, value: string) => void };\n [key: string]: unknown;\n}\n\n/**\n * Axios response type\n */\ninterface AxiosResponse<T = unknown> {\n data: T;\n headers: Record<string, string> | { get?: (key: string) => string | null };\n status: number;\n statusText: string;\n config: AxiosRequestConfig;\n [key: string]: unknown;\n}\n\n/**\n * Create Axios interceptors for TerseJSON support\n *\n * @example\n * ```typescript\n * import axios from 'axios';\n * import { createAxiosInterceptors } from 'tersejson/integrations';\n *\n * const { request, response } = createAxiosInterceptors();\n * axios.interceptors.request.use(request);\n * axios.interceptors.response.use(response);\n *\n * // Now all axios requests automatically handle TerseJSON\n * const { data } = await axios.get('/api/users');\n * console.log(data[0].firstName); // Works transparently!\n * ```\n */\nexport function createAxiosInterceptors(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return {\n request: <T extends AxiosRequestConfig>(config: T): T => {\n // Handle both old-style object headers and new AxiosHeaders class\n if (config.headers) {\n if (typeof config.headers.set === 'function') {\n config.headers.set('accept-terse', 'true');\n } else {\n (config.headers as Record<string, string>)['accept-terse'] = 'true';\n }\n } else {\n config.headers = { 'accept-terse': 'true' };\n }\n return config;\n },\n\n response: <T>(response: AxiosResponse<T>): AxiosResponse<T> => {\n // Handle both old-style object headers and new AxiosHeaders class\n let isTerse = false;\n if (response.headers) {\n if (typeof response.headers.get === 'function') {\n isTerse = response.headers.get('x-terse-json') === 'true';\n } else {\n isTerse = (response.headers as Record<string, string>)['x-terse-json'] === 'true';\n }\n }\n\n if (isTerse && isTersePayload(response.data)) {\n if (debug) {\n console.log('[tersejson] Expanding Axios response');\n }\n response.data = (useProxy ? wrapWithProxy(response.data) : expand(response.data)) as T;\n }\n\n return response;\n },\n };\n}\n\n/**\n * Pre-configured Axios interceptors (convenience export)\n */\nexport const axiosInterceptors = createAxiosInterceptors();\n\n// ============================================================================\n// ANGULAR (Modern - HttpClient)\n// ============================================================================\n\n/**\n * Angular HttpInterceptor interface (simplified)\n */\ninterface HttpRequest<T = unknown> {\n clone: (options: { setHeaders?: Record<string, string> }) => HttpRequest<T>;\n [key: string]: unknown;\n}\n\ninterface HttpEvent<T = unknown> {\n type?: number;\n body?: T;\n headers?: { get: (name: string) => string | null };\n [key: string]: unknown;\n}\n\n// HttpHandler not needed - Angular uses its own\n\n/**\n * Creates an Angular HTTP interceptor for TerseJSON support\n *\n * @example\n * ```typescript\n * // terse.interceptor.ts\n * import { Injectable } from '@angular/core';\n * import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpResponse } from '@angular/common/http';\n * import { Observable } from 'rxjs';\n * import { map } from 'rxjs/operators';\n * import { createAngularInterceptor } from 'tersejson/integrations';\n *\n * @Injectable()\n * export class TerseInterceptor implements HttpInterceptor {\n * private handler = createAngularInterceptor();\n *\n * intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {\n * return this.handler(req, next);\n * }\n * }\n *\n * // app.module.ts\n * providers: [\n * { provide: HTTP_INTERCEPTORS, useClass: TerseInterceptor, multi: true }\n * ]\n * ```\n */\nexport function createAngularInterceptor(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n /**\n * Returns a function that can be used as the intercept method\n * Note: This returns the logic - you need to wrap it in an @Injectable class\n */\n return {\n /**\n * Modifies the request to include the accept-terse header\n */\n modifyRequest: <T>(req: HttpRequest<T>): HttpRequest<T> => {\n return req.clone({\n setHeaders: {\n 'accept-terse': 'true',\n },\n });\n },\n\n /**\n * Processes the response to expand TerseJSON payloads\n */\n processResponse: <T>(event: HttpEvent<T>): HttpEvent<T> => {\n // HttpResponse has type === 4\n if (event.type === 4 && event.body !== undefined) {\n const isTerse = event.headers?.get('x-terse-json') === 'true';\n\n if (isTerse && isTersePayload(event.body)) {\n if (debug) {\n console.log('[tersejson] Expanding Angular response');\n }\n // Create new response with expanded body\n return {\n ...event,\n body: (useProxy ? wrapWithProxy(event.body) : expand(event.body)) as T,\n };\n }\n }\n return event;\n },\n };\n}\n\n/**\n * Angular interceptor code snippet for copy-paste\n * Since Angular interceptors require decorators, we provide the implementation\n */\nexport const angularInterceptorSnippet = `\n// terse.interceptor.ts\nimport { Injectable } from '@angular/core';\nimport {\n HttpInterceptor,\n HttpRequest,\n HttpHandler,\n HttpEvent,\n HttpResponse\n} from '@angular/common/http';\nimport { Observable } from 'rxjs';\nimport { map } from 'rxjs/operators';\nimport { isTersePayload, wrapWithProxy } from 'tersejson';\n\n@Injectable()\nexport class TerseInterceptor implements HttpInterceptor {\n intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {\n // Add accept-terse header\n const terseReq = req.clone({\n setHeaders: { 'accept-terse': 'true' }\n });\n\n return next.handle(terseReq).pipe(\n map(event => {\n if (event instanceof HttpResponse && event.body) {\n const isTerse = event.headers.get('x-terse-json') === 'true';\n if (isTerse && isTersePayload(event.body)) {\n return event.clone({ body: wrapWithProxy(event.body) });\n }\n }\n return event;\n })\n );\n }\n}\n\n// app.module.ts - Add to providers:\n// { provide: HTTP_INTERCEPTORS, useClass: TerseInterceptor, multi: true }\n`;\n\n// ============================================================================\n// ANGULARJS (1.x - $http)\n// ============================================================================\n\n/**\n * AngularJS $http config type\n */\ninterface AngularJSHttpConfig {\n headers?: Record<string, string>;\n [key: string]: unknown;\n}\n\n/**\n * AngularJS $http response type\n */\ninterface AngularJSHttpResponse<T = unknown> {\n data: T;\n headers: (name: string) => string | null;\n status: number;\n statusText: string;\n config: AngularJSHttpConfig;\n}\n\n/**\n * Creates AngularJS $http interceptor for TerseJSON support\n *\n * @example\n * ```javascript\n * // In your AngularJS app config\n * angular.module('myApp', [])\n * .config(['$httpProvider', function($httpProvider) {\n * $httpProvider.interceptors.push(['$q', function($q) {\n * return createAngularJSInterceptor();\n * }]);\n * }]);\n * ```\n */\nexport function createAngularJSInterceptor(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return {\n /**\n * Request interceptor - adds accept-terse header\n */\n request: <T extends AngularJSHttpConfig>(config: T): T => {\n config.headers = config.headers || {};\n config.headers['accept-terse'] = 'true';\n return config;\n },\n\n /**\n * Response interceptor - expands TerseJSON payloads\n */\n response: <T>(response: AngularJSHttpResponse<T>): AngularJSHttpResponse<T> => {\n const isTerse = response.headers('x-terse-json') === 'true';\n\n if (isTerse && isTersePayload(response.data)) {\n if (debug) {\n console.log('[tersejson] Expanding AngularJS response');\n }\n response.data = (useProxy ? wrapWithProxy(response.data) : expand(response.data)) as T;\n }\n\n return response;\n },\n };\n}\n\n/**\n * AngularJS setup code snippet\n */\nexport const angularJSInterceptorSnippet = `\n// Setup TerseJSON with AngularJS\nangular.module('myApp', [])\n .factory('terseInterceptor', ['$q', function($q) {\n return {\n request: function(config) {\n config.headers = config.headers || {};\n config.headers['accept-terse'] = 'true';\n return config;\n },\n response: function(response) {\n var isTerse = response.headers('x-terse-json') === 'true';\n if (isTerse && response.data && response.data.__terse__) {\n // Use tersejson.process() or tersejson.wrapWithProxy()\n response.data = tersejson.process(response.data);\n }\n return response;\n }\n };\n }])\n .config(['$httpProvider', function($httpProvider) {\n $httpProvider.interceptors.push('terseInterceptor');\n }]);\n`;\n\n// ============================================================================\n// JQUERY AJAX\n// ============================================================================\n\n/**\n * jQuery AJAX setup for TerseJSON\n *\n * @example\n * ```javascript\n * import { setupJQueryAjax } from 'tersejson/integrations';\n * setupJQueryAjax($);\n *\n * // Now $.ajax, $.get, $.post all support TerseJSON\n * $.get('/api/users', function(data) {\n * console.log(data[0].firstName); // Works!\n * });\n * ```\n */\nexport function setupJQueryAjax(\n $: { ajaxSetup: (options: unknown) => void; ajaxPrefilter: (callback: unknown) => void },\n options: { useProxy?: boolean; debug?: boolean } = {}\n) {\n const { useProxy = true, debug = false } = options;\n\n // Add header to all requests\n $.ajaxSetup({\n headers: {\n 'accept-terse': 'true',\n },\n });\n\n // Process responses\n $.ajaxPrefilter((ajaxOptions: { dataFilter?: (data: string, type: string) => unknown }) => {\n const originalDataFilter = ajaxOptions.dataFilter;\n\n ajaxOptions.dataFilter = function (data: string, type: string) {\n let processed = data;\n\n if (originalDataFilter) {\n processed = originalDataFilter(data, type) as string;\n }\n\n if (type === 'json' || type === undefined) {\n try {\n const parsed = typeof processed === 'string' ? JSON.parse(processed) : processed;\n if (isTersePayload(parsed)) {\n if (debug) {\n console.log('[tersejson] Expanding jQuery response');\n }\n return useProxy ? wrapWithProxy(parsed) : expand(parsed);\n }\n return parsed;\n } catch {\n return processed;\n }\n }\n\n return processed;\n };\n });\n}\n\n/**\n * jQuery setup code snippet\n */\nexport const jQuerySetupSnippet = `\n// Setup TerseJSON with jQuery\n$.ajaxSetup({\n headers: { 'accept-terse': 'true' },\n dataFilter: function(data, type) {\n if (type === 'json') {\n var parsed = JSON.parse(data);\n if (parsed && parsed.__terse__) {\n return tersejson.process(parsed);\n }\n return parsed;\n }\n return data;\n }\n});\n`;\n\n// ============================================================================\n// SWR / React Query\n// ============================================================================\n\n/**\n * Creates a fetcher for SWR with TerseJSON support\n *\n * @example\n * ```typescript\n * import useSWR from 'swr';\n * import { createSWRFetcher } from 'tersejson/integrations';\n *\n * const fetcher = createSWRFetcher();\n *\n * function UserList() {\n * const { data, error } = useSWR('/api/users', fetcher);\n * return <div>{data?.[0].firstName}</div>;\n * }\n * ```\n */\nexport function createSWRFetcher(options: { useProxy?: boolean; debug?: boolean } = {}) {\n const { useProxy = true, debug = false } = options;\n\n return async <T>(url: string): Promise<T> => {\n const response = await globalThis.fetch(url, {\n headers: {\n 'accept-terse': 'true',\n },\n });\n\n if (!response.ok) {\n throw new Error(`HTTP error! status: ${response.status}`);\n }\n\n const data = await response.json();\n\n if (isTersePayload(data)) {\n if (debug) {\n console.log('[tersejson] Expanding SWR response');\n }\n return (useProxy ? wrapWithProxy(data) : expand(data)) as T;\n }\n\n return data as T;\n };\n}\n\n/**\n * Creates a query function for React Query / TanStack Query\n *\n * @example\n * ```typescript\n * import { useQuery } from '@tanstack/react-query';\n * import { createQueryFn } from 'tersejson/integrations';\n *\n * const queryFn = createQueryFn();\n *\n * function UserList() {\n * const { data } = useQuery({\n * queryKey: ['users'],\n * queryFn: () => queryFn('/api/users')\n * });\n * return <div>{data?.[0].firstName}</div>;\n * }\n * ```\n */\nexport const createQueryFn = createSWRFetcher; // Same implementation\n\n// ============================================================================\n// EXPORTS\n// ============================================================================\n\nexport default {\n // Axios\n createAxiosInterceptors,\n axiosInterceptors,\n\n // Angular\n createAngularInterceptor,\n angularInterceptorSnippet,\n\n // AngularJS\n createAngularJSInterceptor,\n angularJSInterceptorSnippet,\n\n // jQuery\n setupJQueryAjax,\n jQuerySetupSnippet,\n\n // SWR / React Query\n createSWRFetcher,\n createQueryFn,\n};\n"]}
|
|
@@ -130,5 +130,60 @@ type Tersed<T> = T;
|
|
|
130
130
|
* Check if a value is a TersePayload
|
|
131
131
|
*/
|
|
132
132
|
declare function isTersePayload(value: unknown): value is TersePayload;
|
|
133
|
+
/**
|
|
134
|
+
* GraphQL terse metadata (attached to response)
|
|
135
|
+
*/
|
|
136
|
+
interface GraphQLTerseMetadata {
|
|
137
|
+
/** Version for compatibility */
|
|
138
|
+
v: 1;
|
|
139
|
+
/** Key mapping: short key -> original key */
|
|
140
|
+
k: Record<string, string>;
|
|
141
|
+
/** JSON paths to compressed arrays (e.g., ["data.users", "data.products"]) */
|
|
142
|
+
paths: string[];
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* GraphQL response with terse compression
|
|
146
|
+
*/
|
|
147
|
+
interface GraphQLTerseResponse<T = unknown> {
|
|
148
|
+
/** The compressed data with short keys in arrays */
|
|
149
|
+
data: T;
|
|
150
|
+
/** GraphQL errors (untouched) */
|
|
151
|
+
errors?: Array<{
|
|
152
|
+
message: string;
|
|
153
|
+
[key: string]: unknown;
|
|
154
|
+
}>;
|
|
155
|
+
/** GraphQL extensions (untouched) */
|
|
156
|
+
extensions?: Record<string, unknown>;
|
|
157
|
+
/** Terse metadata */
|
|
158
|
+
__terse__: GraphQLTerseMetadata;
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* GraphQL middleware options
|
|
162
|
+
*/
|
|
163
|
+
interface GraphQLTerseOptions extends CompressOptions {
|
|
164
|
+
/**
|
|
165
|
+
* Minimum array length to trigger compression
|
|
166
|
+
* @default 2
|
|
167
|
+
*/
|
|
168
|
+
minArrayLength?: number;
|
|
169
|
+
/**
|
|
170
|
+
* Custom function to determine if a path should be compressed
|
|
171
|
+
* Return false to skip compression for specific paths
|
|
172
|
+
*/
|
|
173
|
+
shouldCompress?: (data: unknown, path: string) => boolean;
|
|
174
|
+
/**
|
|
175
|
+
* Paths to exclude from compression (e.g., ["data.config"])
|
|
176
|
+
*/
|
|
177
|
+
excludePaths?: string[];
|
|
178
|
+
/**
|
|
179
|
+
* Enable debug logging
|
|
180
|
+
* @default false
|
|
181
|
+
*/
|
|
182
|
+
debug?: boolean;
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* Check if a value is a GraphQL terse response
|
|
186
|
+
*/
|
|
187
|
+
declare function isGraphQLTersePayload(value: unknown): value is GraphQLTerseResponse;
|
|
133
188
|
|
|
134
|
-
export { type CompressOptions as C, type KeyPattern as K, type NestedHandling as N, type TersePayload as T, type TerseMiddlewareOptions as a, type TerseClientOptions as b, type KeyPatternPreset as c, type KeyGenerator as d, type Tersed as e, isTersePayload as i };
|
|
189
|
+
export { type CompressOptions as C, type GraphQLTerseMetadata as G, type KeyPattern as K, type NestedHandling as N, type TersePayload as T, type TerseMiddlewareOptions as a, type TerseClientOptions as b, type KeyPatternPreset as c, type KeyGenerator as d, type Tersed as e, type GraphQLTerseResponse as f, type GraphQLTerseOptions as g, isGraphQLTersePayload as h, isTersePayload as i };
|
|
@@ -130,5 +130,60 @@ type Tersed<T> = T;
|
|
|
130
130
|
* Check if a value is a TersePayload
|
|
131
131
|
*/
|
|
132
132
|
declare function isTersePayload(value: unknown): value is TersePayload;
|
|
133
|
+
/**
|
|
134
|
+
* GraphQL terse metadata (attached to response)
|
|
135
|
+
*/
|
|
136
|
+
interface GraphQLTerseMetadata {
|
|
137
|
+
/** Version for compatibility */
|
|
138
|
+
v: 1;
|
|
139
|
+
/** Key mapping: short key -> original key */
|
|
140
|
+
k: Record<string, string>;
|
|
141
|
+
/** JSON paths to compressed arrays (e.g., ["data.users", "data.products"]) */
|
|
142
|
+
paths: string[];
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* GraphQL response with terse compression
|
|
146
|
+
*/
|
|
147
|
+
interface GraphQLTerseResponse<T = unknown> {
|
|
148
|
+
/** The compressed data with short keys in arrays */
|
|
149
|
+
data: T;
|
|
150
|
+
/** GraphQL errors (untouched) */
|
|
151
|
+
errors?: Array<{
|
|
152
|
+
message: string;
|
|
153
|
+
[key: string]: unknown;
|
|
154
|
+
}>;
|
|
155
|
+
/** GraphQL extensions (untouched) */
|
|
156
|
+
extensions?: Record<string, unknown>;
|
|
157
|
+
/** Terse metadata */
|
|
158
|
+
__terse__: GraphQLTerseMetadata;
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* GraphQL middleware options
|
|
162
|
+
*/
|
|
163
|
+
interface GraphQLTerseOptions extends CompressOptions {
|
|
164
|
+
/**
|
|
165
|
+
* Minimum array length to trigger compression
|
|
166
|
+
* @default 2
|
|
167
|
+
*/
|
|
168
|
+
minArrayLength?: number;
|
|
169
|
+
/**
|
|
170
|
+
* Custom function to determine if a path should be compressed
|
|
171
|
+
* Return false to skip compression for specific paths
|
|
172
|
+
*/
|
|
173
|
+
shouldCompress?: (data: unknown, path: string) => boolean;
|
|
174
|
+
/**
|
|
175
|
+
* Paths to exclude from compression (e.g., ["data.config"])
|
|
176
|
+
*/
|
|
177
|
+
excludePaths?: string[];
|
|
178
|
+
/**
|
|
179
|
+
* Enable debug logging
|
|
180
|
+
* @default false
|
|
181
|
+
*/
|
|
182
|
+
debug?: boolean;
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* Check if a value is a GraphQL terse response
|
|
186
|
+
*/
|
|
187
|
+
declare function isGraphQLTersePayload(value: unknown): value is GraphQLTerseResponse;
|
|
133
188
|
|
|
134
|
-
export { type CompressOptions as C, type KeyPattern as K, type NestedHandling as N, type TersePayload as T, type TerseMiddlewareOptions as a, type TerseClientOptions as b, type KeyPatternPreset as c, type KeyGenerator as d, type Tersed as e, isTersePayload as i };
|
|
189
|
+
export { type CompressOptions as C, type GraphQLTerseMetadata as G, type KeyPattern as K, type NestedHandling as N, type TersePayload as T, type TerseMiddlewareOptions as a, type TerseClientOptions as b, type KeyPatternPreset as c, type KeyGenerator as d, type Tersed as e, type GraphQLTerseResponse as f, type GraphQLTerseOptions as g, isGraphQLTersePayload as h, isTersePayload as i };
|