Spaces:
Running
Running
Download js/ext2/protocol.js from UtopiaIA/elffuss-code: direct link, hf CLI and curl.
- Browser
- Download file 8.24 kB
-
https://huggingface.co/spaces/UtopiaIA/elffuss-code/resolve/main/js/ext2/protocol.js
- Command line
-
hf download hf://spaces/UtopiaIA/elffuss-code/js/ext2/protocol.js
-
curl -L -o protocol.js https://huggingface.co/spaces/UtopiaIA/elffuss-code/resolve/main/js/ext2/protocol.js
8.24 kB
| // Protocolo entre la página de Code y el recinto de extensiones (PROTOCOL = 1). | |
| // | |
| // Todo lo que llega del recinto se valida aquí ANTES de tocar nada: tipo | |
| // conocido, campos con su forma y tamaños con tope. Lo desconocido o mal | |
| // formado se descarta y se cuenta; demasiadas faltas desmontan el recinto. | |
| // Lo que la página manda al recinto tiene que ser «datos planos» (isPlainData): | |
| // nunca un FileSystemHandle ni ningún otro objeto del navegador. | |
| export const PROTOCOL = 1; | |
| export const LIMITS = { | |
| message: 1 << 20, // 1 MB por mensaje (los documentos, aparte) | |
| large: 16 << 20, // resultados y ediciones: pueden traer un documento entero (≤ 5 MB, ×2 al contar) | |
| document: 64 << 20, | |
| label: 4096, | |
| markdown: 65536, | |
| url: 8192, | |
| completions: 5000, | |
| symbols: 10000, | |
| markers: 5000, | |
| violations: 20, | |
| }; | |
| export const KINDS = new Set(['format', 'formatRange', 'formatOnType', 'completion', 'hover', 'signature', 'codeAction', 'symbols', | |
| 'definition', 'declaration', 'typeDefinition', 'implementation', 'references', 'rename', 'highlights']); | |
| const STATES = new Set(['installed', 'activating', 'active', 'error', 'stopped', 'unsupported']); | |
| const LEVELS = new Set(['info', 'warn', 'error']); | |
| const isStr = (v, max) => typeof v === 'string' && v.length <= max; | |
| const optStr = (v, max) => v === undefined || v === null || isStr(v, max); | |
| const isInt = v => Number.isSafeInteger(v); | |
| const isPos = v => Number.isSafeInteger(v) && v >= 0; | |
| export const isRange = r => Array.isArray(r) && r.length === 4 && r.every(n => Number.isSafeInteger(n) && n >= 1 && n <= 1e8); | |
| export const isUri = u => isStr(u, LIMITS.url) && u.startsWith('file:///'); | |
| const isExtId = v => isStr(v, 300) && /^[a-z0-9][a-z0-9-]*\.[a-z0-9][a-z0-9._-]*$/i.test(v); | |
| export const isPlainObject = v => v !== null && typeof v === 'object' && Object.getPrototypeOf(v) === Object.prototype; | |
| const isFilter = f => isPlainObject(f) && optStr(f.language, 100) && optStr(f.scheme, 50) && optStr(f.pattern, 500); | |
| const SEVS = new Set(['info', 'warning', 'error']); | |
| const isDecoKey = k => isStr(k, 100) && /^[\w.-]{1,100}$/.test(k); | |
| const isHover = h => isPlainObject(h) && (h.md !== undefined ? isStr(h.md, 4096) && h.text === undefined : isStr(h.text, 4096)); | |
| const isDecoRange = r => isPlainObject(r) && isRange(r.range) && (r.hover === undefined || (Array.isArray(r.hover) && r.hover.length <= 10 && r.hover.every(isHover))) | |
| && (r.ro === undefined || isPlainObject(r.ro)); | |
| const isPickItem = it => isPlainObject(it) && (it.sep !== undefined | |
| ? isStr(it.sep, 200) && Object.keys(it).length === 1 | |
| : isStr(it.label, 500) && optStr(it.description, 500) && optStr(it.detail, 1000) && (it.picked === undefined || typeof it.picked === 'boolean')); | |
| const isEditStep = s => Array.isArray(s) && s.length <= 100000 && s.every(c => isPlainObject(c) && isRange(c.range) && typeof c.text === 'string'); | |
| // tamaño aproximado (para no aceptar mensajes enormes); corta al pasarse | |
| export function approxSize(v, limit = Infinity) { | |
| let n = 0; | |
| const stack = [v]; | |
| while (stack.length) { | |
| const x = stack.pop(); | |
| if (typeof x === 'string') n += x.length * 2; | |
| else if (typeof x === 'number' || typeof x === 'boolean' || x == null) n += 8; | |
| else if (x instanceof ArrayBuffer) n += x.byteLength; | |
| else if (ArrayBuffer.isView(x)) n += x.byteLength; | |
| else if (Array.isArray(x)) { n += 8; for (const y of x) stack.push(y); } | |
| else if (typeof x === 'object') { for (const [k, y] of Object.entries(x)) { n += k.length * 2; stack.push(y); } } | |
| if (n > limit) return n; | |
| } | |
| return n; | |
| } | |
| // Mensajes del recinto → la página: cada tipo con su forma exacta. | |
| const FROM_SANDBOX = { | |
| ready: m => m.protocol === PROTOCOL && isStr(m.vscode, 32), | |
| fatal: m => isStr(m.reason, 50) && optStr(m.text, 1000), | |
| 'ext.status': m => isExtId(m.id) && STATES.has(m.state) && optStr(m.text, 4096), | |
| log: m => LEVELS.has(m.level) && isStr(m.text, LIMITS.label) && (m.id === undefined || isExtId(m.id)), | |
| 'providers.add': m => isInt(m.handle) && KINDS.has(m.kind) && Array.isArray(m.selector) && m.selector.length <= 50 && m.selector.every(isFilter) && isPlainObject(m.meta), | |
| 'providers.remove': m => isInt(m.handle), | |
| result: m => isInt(m.req) && typeof m.ok === 'boolean' && (m.ok || isStr(m.error, 1000)), | |
| 'doc.edit': m => isUri(m.uri) && isInt(m.base) && Array.isArray(m.steps) && m.steps.length <= 1000 && m.steps.every(isEditStep), | |
| 'doc.need': m => isUri(m.uri), | |
| markers: m => isUri(m.uri) && isStr(m.owner, 200) && Array.isArray(m.markers) && m.markers.length <= LIMITS.markers, | |
| 'ctx.set': m => isStr(m.key, 100) && /^[\w.:-]{1,100}$/.test(m.key) && (m.value === null || ['string', 'number', 'boolean'].includes(typeof m.value)) && (typeof m.value !== 'string' || m.value.length <= 1000), | |
| pong: m => isInt(m.n), | |
| 'rpc.denied': m => isPos(m.n) && Array.isArray(m.top) && m.top.length <= 10 | |
| && m.top.every(x => Array.isArray(x) && x.length === 2 && isStr(x[0], 200) && isPos(x[1])), | |
| // lo que la extensión le pide al usuario (la página contesta con ui.result) | |
| 'ui.notify': m => isInt(m.req) && SEVS.has(m.sev) && isStr(m.text, 4096) && Array.isArray(m.actions) && m.actions.length <= 5 | |
| && m.actions.every(a => isStr(a, 200)) && (m.source === undefined || isExtId(m.source)), | |
| 'ui.dialog': m => isInt(m.req) && SEVS.has(m.sev) && isStr(m.text, 4096) && optStr(m.detail, 4096) && Array.isArray(m.buttons) | |
| && m.buttons.length <= 10 && m.buttons.every(b => isStr(b, 200)) && optStr(m.cancel, 200), | |
| 'ui.pick': m => isInt(m.req) && Array.isArray(m.items) && m.items.length <= 1000 && m.items.every(isPickItem) && isPlainObject(m.options) | |
| && optStr(m.options.title, 200) && optStr(m.options.placeHolder, 200) && typeof m.options.canPickMany === 'boolean', | |
| 'ui.input': m => isInt(m.req) && isPlainObject(m.options) && optStr(m.options.title, 200) && optStr(m.options.prompt, 1000) | |
| && optStr(m.options.placeHolder, 200) && optStr(m.options.value, 10000) && optStr(m.options.validation, 500), | |
| 'ui.cancel': m => isInt(m.req), | |
| 'ui.progress': m => isInt(m.id) && isStr(m.text, 500) && typeof m.done === 'boolean', | |
| 'clipboard.write': m => isStr(m.text, 500000), | |
| 'open.request': m => isInt(m.req) && isStr(m.url, LIMITS.url) && m.url.length > 0, | |
| 'editor.show': m => isUri(m.uri), | |
| 'editor.reveal': m => isUri(m.uri) && isRange(m.range), | |
| 'editor.selection': m => isUri(m.uri) && Array.isArray(m.selections) && m.selections.length >= 1 && m.selections.length <= 100 && m.selections.every(isRange), | |
| // decoraciones: la página reconstruye el CSS con su lista blanca (decorations.js) | |
| 'deco.type': m => isDecoKey(m.key) && isPlainObject(m.options) && approxSize(m.options, 40000) < 40000, | |
| 'deco.set': m => isDecoKey(m.key) && isUri(m.uri) && Array.isArray(m.ranges) && m.ranges.length <= 10000 && m.ranges.every(isDecoRange), | |
| 'deco.remove': m => isDecoKey(m.key), | |
| }; | |
| // Tope por tipo: los resultados (p. ej. las ediciones de un formateador) y | |
| // las ediciones de una extensión pueden traer un documento entero; el resto, 1 MB. | |
| export const maxSize = t => (t === 'result' || t === 'doc.edit' ? LIMITS.large : LIMITS.message); | |
| export function validate(msg) { | |
| if (!isPlainObject(msg) || typeof msg.t !== 'string') return { ok: false, why: 'shape' }; | |
| const check = Object.hasOwn(FROM_SANDBOX, msg.t) ? FROM_SANDBOX[msg.t] : null; | |
| if (!check) return { ok: false, why: 'unknown type' }; | |
| const cap = maxSize(msg.t); | |
| if (approxSize(msg, cap) > cap) return { ok: false, why: 'too large' }; | |
| try { return check(msg) ? { ok: true } : { ok: false, why: 'fields' }; } | |
| catch { return { ok: false, why: 'fields' }; } | |
| } | |
| // Página → recinto: solo datos planos (y ArrayBuffer para los ficheros). | |
| export function isPlainData(v, depth = 0) { | |
| if (depth > 64) return false; | |
| if (v === null || v === undefined || typeof v === 'boolean' || typeof v === 'string') return true; | |
| if (typeof v === 'number') return Number.isFinite(v); | |
| if (v instanceof ArrayBuffer) return true; | |
| if (Array.isArray(v)) return v.every(x => isPlainData(x, depth + 1)); | |
| if (isPlainObject(v)) return Object.values(v).every(x => isPlainData(x, depth + 1)); | |
| return false; | |
| } | |
| export { isStr, isInt, isPos }; | |