better-supabase 0.8.0 → 0.9.0

package/dist/cli/config-MuKY9kUj.js

@@ -0,0 +1,39 @@
+import { p as commandMeta, r as defineCliCommand } from "./command-CK9Cn8HV.js";
+import { n as redact, r as redactUrl } from "./redact-PjNswZOs.js";
+import { t as display } from "./io-BiPX-_J1.js";
+//#region src/cli/commands/config.ts
+/** The resolved config as JSON: generators by name and version, every credential redacted. */
+function printableConfig(config) {
+	return redact({
+		...config,
+		source: {
+			...config.source,
+			...config.source.dbUrl ? { dbUrl: redactUrl(config.source.dbUrl) } : {}
+		},
+		generators: config.generators.map((generator) => ({
+			name: generator.name,
+			apiVersion: generator.apiVersion ?? null
+		}))
+	});
+}
+const configCommand = defineCliCommand({
+	meta: commandMeta("config"),
+	args: {},
+	run: (_args, context) => {
+		const config = printableConfig(context.config);
+		const file = context.configFile ? display(context.cwd, context.configFile) : null;
+		const environment = context.config.environment ?? null;
+		const header = file ? `# ${file}` : "# no config file, defaults only";
+		return Promise.resolve({
+			code: 0,
+			output: `${header}${environment ? ` (environment: ${environment})` : ""}\n${JSON.stringify(config, null, 2)}`,
+			data: {
+				file,
+				environment,
+				config
+			}
+		});
+	}
+});
+//#endregion
+export { configCommand };

package/dist/cli/config-edit-Ct1lXe8a.js

@@ -0,0 +1,603 @@
+import { t as isRecord } from "./guards-CUlDNYZs.js";
+//#region src/cli/code-ranges.ts
+/**
+* The scanner behind the codemods and the config edits: it finds the code
+* between strings, template literals and comments.
+*/
+/** `[start, end)` ranges of code, outside strings, template literals and comments. */
+function codeRanges(text) {
+	const ranges = [];
+	let start = 0;
+	let index = 0;
+	const skip = (end) => {
+		if (index > start) ranges.push([start, index]);
+		index = end;
+		start = end;
+	};
+	while (index < text.length) {
+		const char = text[index];
+		const next = text[index + 1];
+		if (char === "/" && next === "/") {
+			const end = text.indexOf("\n", index);
+			skip(end === -1 ? text.length : end);
+		} else if (char === "/" && next === "*") {
+			const end = text.indexOf("*/", index + 2);
+			skip(end === -1 ? text.length : end + 2);
+		} else if (char === "\"" || char === "'" || char === "`") {
+			let end = index + 1;
+			while (end < text.length && text[end] !== char) {
+				if (text[end] === "\\") end += 1;
+				if (char !== "`" && text[end] === "\n") break;
+				end += 1;
+			}
+			skip(text[end] === char ? end + 1 : Math.min(end, text.length));
+		} else index += 1;
+	}
+	if (index > start) ranges.push([start, index]);
+	return ranges;
+}
+//#endregion
+//#region src/cli/sql/config-edit.ts
+/**
+* Adds block names to `blocks` in `better-supabase.config.ts`. The
+* edit reads the object literal passed to `defineConfig(...)` (or the
+* default export) with the codemod scanner, so strings and comments never
+* count as code, and inserts the names in the form the config already uses:
+* `name: {}` in an object, `"name"` in a list. Anything that isn't a literal
+* object it can follow is refused with a reason, and `sql add` prints the
+* snippet instead.
+*/
+const OPENING = "({[";
+const CLOSING = ")}]";
+const IDENT = /^[A-Za-z_$][\w$]*$/;
+/**
+* `source` with every character outside code replaced: string and template
+* contents become `x` between their quotes, comments become spaces. Indexes
+* stay the same, so a match in the mask is a position in `source`.
+*/
+function mask(source) {
+	const ranges = codeRanges(source);
+	let out = "";
+	let cursor = 0;
+	const hide = (end) => {
+		const gap = source.slice(cursor, end);
+		const quote = gap[0];
+		if (quote === "\"" || quote === "'" || quote === "`") {
+			const closed = gap.length > 1 && gap.endsWith(quote);
+			const inner = gap.slice(1, closed ? -1 : void 0);
+			out += quote + inner.replaceAll(/[^\n]/g, "x") + (closed ? quote : "");
+		} else out += gap.replaceAll(/[^\n]/g, " ");
+	};
+	for (const [start, end] of ranges) {
+		if (start > cursor) hide(start);
+		out += source.slice(start, end);
+		cursor = end;
+	}
+	if (cursor < source.length) hide(source.length);
+	return out;
+}
+/** The index of the bracket that closes the one at `open`. */
+function closingIndex(code, open) {
+	let depth = 0;
+	for (let index = open; index < code.length; index += 1) {
+		const char = code[index];
+		if (char === "\"" || char === "'" || char === "`") {
+			index = code.indexOf(char, index + 1);
+			if (index === -1) return -1;
+		} else if (OPENING.includes(char)) depth += 1;
+		else if (CLOSING.includes(char)) {
+			depth -= 1;
+			if (depth === 0) return index;
+		}
+	}
+	return -1;
+}
+const skipSpace = (code, from) => {
+	let index = from;
+	while (index < code.length && /\s/.test(code[index])) index += 1;
+	return index;
+};
+/** The end of the expression starting at `index`: the next `,` or closer at depth 0. */
+function valueEnd(code, index) {
+	let depth = 0;
+	let end = index;
+	for (; end < code.length; end += 1) {
+		const char = code[end];
+		if (char === "\"" || char === "'" || char === "`") {
+			end = code.indexOf(char, end + 1);
+			if (end === -1) return code.length;
+		} else if (OPENING.includes(char)) depth += 1;
+		else if (CLOSING.includes(char)) {
+			if (depth === 0) break;
+			depth -= 1;
+		} else if (char === "," && depth === 0) break;
+	}
+	while (end > index && /\s/.test(code[end - 1])) end -= 1;
+	return end;
+}
+/** The properties of the object literal whose `{` is at `open`. */
+function properties(source, code, open) {
+	const close = closingIndex(code, open);
+	if (close === -1) return;
+	const found = [];
+	let index = skipSpace(code, open + 1);
+	while (index < close) {
+		const start = index;
+		let key;
+		if (code.startsWith("...", index)) index += 3;
+		else if (code[index] === "\"" || code[index] === "'") {
+			const end = code.indexOf(code[index], index + 1);
+			key = source.slice(index + 1, end);
+			index = end + 1;
+		} else if (code[index] === "[") index = closingIndex(code, index) + 1;
+		else {
+			const name = /^[A-Za-z_$][\w$]*/.exec(code.slice(index))?.[0];
+			if (!name) return;
+			key = name;
+			index += name.length;
+		}
+		index = skipSpace(code, index);
+		let valueStart = index;
+		if (key !== void 0 && code[index] === ":") valueStart = skipSpace(code, index + 1);
+		else if (code[index] === "(") valueStart = start;
+		else if (key !== void 0 && (code[index] === "," || index === close)) valueStart = start;
+		const end = valueEnd(code, valueStart);
+		found.push({
+			key,
+			start,
+			valueStart,
+			valueEnd: end
+		});
+		index = skipSpace(code, end);
+		if (code[index] === ",") index = skipSpace(code, index + 1);
+		else if (index !== close) return;
+	}
+	return found;
+}
+/** The `{` of the config object: `defineConfig({...})` or `export default {...}`. */
+function configObject(code) {
+	const call = /\bdefineConfig\s*(?:<[^>]*>)?\s*\(\s*\{/.exec(code);
+	if (call) return call.index + call[0].length - 1;
+	const literal = /\bexport\s+default\s*\{/.exec(code) ?? /\bmodule\.exports\s*=\s*\{/.exec(code);
+	return literal ? literal.index + literal[0].length - 1 : void 0;
+}
+const indentAt = (source, index) => /^[ \t]*/.exec(source.slice(source.lastIndexOf("\n", index - 1) + 1))?.[0] ?? "";
+/** A module name as an object key, quoted when it isn't an identifier. */
+const keyText = (name) => IDENT.test(name) ? name : `"${name}"`;
+/** The elements of the array literal whose `[` is at `open`. */
+function elements(code, open) {
+	const close = closingIndex(code, open);
+	const found = [];
+	let index = skipSpace(code, open + 1);
+	while (index < close) {
+		const end = valueEnd(code, index);
+		found.push({
+			start: index,
+			end
+		});
+		index = skipSpace(code, end);
+		if (code[index] !== ",") break;
+		index = skipSpace(code, index + 1);
+	}
+	return found;
+}
+/**
+* The edit that appends `entries` to the object or array whose opener is at
+* `open`, after `last`, its last entry. It follows the literal's layout: one
+* entry per line when it spans lines, inline otherwise, and a trailing comma
+* when the last entry has one.
+*/
+function append(source, code, open, last, entries) {
+	const close = closingIndex(code, open);
+	const multiline = code.slice(open, close).includes("\n");
+	if (last === void 0) {
+		if (!multiline) {
+			const inner = entries.join(", ");
+			return {
+				start: open + 1,
+				end: close,
+				text: code[open] === "{" ? ` ${inner} ` : inner
+			};
+		}
+		const indent = `${indentAt(source, open)}  `;
+		return {
+			start: open + 1,
+			end: close,
+			text: `\n${entries.map((entry) => `${indent}${entry},`).join("\n")}\n${indentAt(source, close)}`
+		};
+	}
+	if (!multiline) return {
+		start: last.end,
+		end: last.end,
+		text: entries.map((entry) => `, ${entry}`).join("")
+	};
+	const indent = indentAt(source, last.start);
+	const after = skipSpace(code, last.end);
+	if (code[after] === ",") return {
+		start: after + 1,
+		end: after + 1,
+		text: entries.map((entry) => `\n${indent}${entry},`).join("")
+	};
+	return {
+		start: last.end,
+		end: last.end,
+		text: entries.map((entry) => `,\n${indent}${entry}`).join("")
+	};
+}
+const lastOf = (props) => {
+	const last = props.at(-1);
+	return last ? {
+		start: last.start,
+		end: last.valueEnd
+	} : void 0;
+};
+/** `source` with `names` added to `blocks`, keeping the form it has. */
+function addBlocksToConfig(source, names) {
+	const code = mask(source);
+	const root = configObject(code);
+	if (root === void 0) return {
+		ok: false,
+		reason: "it doesn't pass an object literal to defineConfig()"
+	};
+	const rootProps = properties(source, code, root);
+	if (!rootProps) return {
+		ok: false,
+		reason: "its config object can't be read"
+	};
+	const blocks = rootProps.find((prop) => prop.key === "blocks");
+	const edit = (start, end, text) => ({
+		ok: true,
+		text: source.slice(0, start) + text + source.slice(end)
+	});
+	if (!blocks) {
+		const entries = names.map((name) => `${keyText(name)}: {}`).join(", ");
+		const change = append(source, code, root, lastOf(rootProps), [`blocks: { ${entries} }`]);
+		return edit(change.start, change.end, change.text);
+	}
+	const open = blocks.valueStart;
+	if (code[open] === "{") {
+		const listed = properties(source, code, open);
+		if (!listed) return {
+			ok: false,
+			reason: "its blocks object can't be read"
+		};
+		const keys = new Set(listed.map((prop) => prop.key));
+		const missing = names.filter((name) => !keys.has(name));
+		if (missing.length === 0) return {
+			ok: true,
+			text: source
+		};
+		const change = append(source, code, open, lastOf(listed), missing.map((name) => `${keyText(name)}: {}`));
+		return edit(change.start, change.end, change.text);
+	}
+	if (code[open] === "[") {
+		const items = [...source.slice(open + 1, closingIndex(code, open)).matchAll(/(["'])([^"']*)\1/g)];
+		const quote = items[0]?.[1] ?? "\"";
+		const present = new Set(items.map((item) => item[2]));
+		const missing = names.filter((name) => !present.has(name));
+		if (missing.length === 0) return {
+			ok: true,
+			text: source
+		};
+		const change = append(source, code, open, elements(code, open).at(-1), missing.map((name) => `${quote}${name}${quote}`));
+		return edit(change.start, change.end, change.text);
+	}
+	return {
+		ok: false,
+		reason: "its blocks key isn't a literal object or list"
+	};
+}
+/** `addBlocksToConfig` for `better-supabase.config.json`. */
+function addBlocksToJson(source, names) {
+	let config;
+	try {
+		config = JSON.parse(source);
+	} catch {
+		return {
+			ok: false,
+			reason: "it isn't valid JSON"
+		};
+	}
+	if (!isRecord(config)) return {
+		ok: false,
+		reason: "it isn't a JSON object"
+	};
+	const blocks = config["blocks"] ?? {};
+	let next;
+	if (Array.isArray(blocks)) {
+		const listed = blocks;
+		next = [...listed, ...names.filter((name) => !listed.includes(name))];
+	} else if (isRecord(blocks)) next = {
+		...blocks,
+		...Object.fromEntries(names.filter((name) => !(name in blocks)).map((name) => [name, {}]))
+	};
+	else return {
+		ok: false,
+		reason: "its blocks key isn't an object or a list"
+	};
+	const indent = /^[ \t]+/m.exec(source)?.[0] ?? "  ";
+	return jsonEdit(source, config, {
+		...config,
+		blocks: next
+	}, indent);
+}
+/**
+* The JSON config with `next` written, or `source` as it is when `next`
+* holds the same values, so a formatted file isn't rewritten for nothing.
+*/
+const jsonEdit = (source, config, next, indent) => ({
+	ok: true,
+	text: JSON.stringify(next) === JSON.stringify(config) ? source : `${JSON.stringify(next, null, indent)}\n`
+});
+/** `source` with `preset` set to `value`, replacing the one it has. */
+function setPresetInConfig(source, value) {
+	const code = mask(source);
+	const root = configObject(code);
+	if (root === void 0) return {
+		ok: false,
+		reason: "it doesn't pass an object literal to defineConfig()"
+	};
+	const rootProps = properties(source, code, root);
+	if (!rootProps) return {
+		ok: false,
+		reason: "its config object can't be read"
+	};
+	const current = rootProps.find((prop) => prop.key === "preset");
+	const quote = source[current?.valueStart ?? -1] === "'" || current === void 0 && source.includes("'better-supabase/config'") ? "'" : "\"";
+	const literal = `${quote}${value}${quote}`;
+	if (current) return {
+		ok: true,
+		text: source.slice(0, current.valueStart) + literal + source.slice(current.valueEnd)
+	};
+	const change = append(source, code, root, lastOf(rootProps), [`preset: ${literal}`]);
+	return {
+		ok: true,
+		text: source.slice(0, change.start) + change.text + source.slice(change.end)
+	};
+}
+/** `setPresetInConfig` for `better-supabase.config.json`. */
+function setPresetInJson(source, value) {
+	let config;
+	try {
+		config = JSON.parse(source);
+	} catch {
+		return {
+			ok: false,
+			reason: "it isn't valid JSON"
+		};
+	}
+	if (!isRecord(config)) return {
+		ok: false,
+		reason: "it isn't a JSON object"
+	};
+	const indent = /^[ \t]+/m.exec(source)?.[0] ?? "  ";
+	return jsonEdit(source, config, {
+		...config,
+		preset: value
+	}, indent);
+}
+/**
+* `lib/blocks.ts` with `blocks` imported and added to the blocks object
+* passed to `defineBlocks(blockConfig, { ... })` or `createBlocks(options,
+* { ... })`. A block whose export the file
+* already names is left out.
+*/
+function addBlocksToWiring(source, blocks) {
+	const code = mask(source);
+	const missing = blocks.filter((block) => !new RegExp(`\\b${block.export}\\b`).test(code));
+	if (missing.length === 0) return {
+		ok: true,
+		text: source
+	};
+	const call = /\b(createBlocks|defineBlocks)\s*(?:<[^>]*>)?\s*\(/.exec(code);
+	if (!call) return {
+		ok: false,
+		reason: "it doesn't call defineBlocks() or createBlocks()"
+	};
+	const callee = call[1] ?? "defineBlocks";
+	const firstEnd = valueEnd(code, skipSpace(code, call.index + call[0].length));
+	const comma = skipSpace(code, firstEnd);
+	const second = code[comma] === "," ? skipSpace(code, comma + 1) : -1;
+	if (second === -1 || code[second] !== "{") return {
+		ok: false,
+		reason: `${callee}() isn't passed an object literal of blocks`
+	};
+	const listed = properties(source, code, second);
+	if (!listed) return {
+		ok: false,
+		reason: "its blocks object can't be read"
+	};
+	const change = append(source, code, second, lastOf(listed), missing.map((block) => `${keyText(block.key)}: ${block.export}`));
+	let text = source.slice(0, change.start) + change.text + source.slice(change.end);
+	const imports = [...mask(text).matchAll(/^import\b[^;]*;/gm)].at(-1);
+	const at = imports === void 0 ? 0 : imports.index + imports[0].length;
+	const lines = missing.map((block) => `import { ${block.export} } from "${block.subpath}";`).join("\n");
+	text = imports === void 0 ? `${lines}\n\n${text}` : `${text.slice(0, at)}\n${lines}${text.slice(at)}`;
+	return {
+		ok: true,
+		text
+	};
+}
+/** `value` as a TypeScript literal, one key per line, indented from `indent`. */
+function literal(value, indent, quote) {
+	if (value === null) return "null";
+	if (typeof value === "string") return value.includes(quote) || value.includes("\\") ? JSON.stringify(value) : `${quote}${value}${quote}`;
+	if (typeof value !== "object") return String(value);
+	if (Array.isArray(value)) return `[${value.map((item) => literal(item, indent, quote)).join(", ")}]`;
+	const entries = Object.entries(value);
+	if (entries.length === 0) return "{}";
+	const inner = `${indent}  `;
+	return `{\n${entries.map(([key, entry]) => `${inner}${keyText(key)}: ${literal(entry, inner, quote)},`).join("\n")}\n${indent}}`;
+}
+/**
+* `source` with `blocks.<name>` set to `value`, replacing the entry it has.
+* A `blocks` list becomes an object, each listed block mapped to `{}`.
+*/
+function setBlockInConfig(source, name, value) {
+	const code = mask(source);
+	const root = configObject(code);
+	if (root === void 0) return {
+		ok: false,
+		reason: "it doesn't pass an object literal to defineConfig()"
+	};
+	const rootProps = properties(source, code, root);
+	if (!rootProps) return {
+		ok: false,
+		reason: "its config object can't be read"
+	};
+	const quote = source.includes("'better-supabase/config'") ? "'" : "\"";
+	const edit = (start, end, text) => ({
+		ok: true,
+		text: source.slice(0, start) + text + source.slice(end)
+	});
+	const blocks = rootProps.find((prop) => prop.key === "blocks");
+	if (!blocks) {
+		const indent = rootProps[0] ? indentAt(source, rootProps[0].start) : `${indentAt(source, root)}  `;
+		const change = append(source, code, root, lastOf(rootProps), [`blocks: ${literal({ [name]: value }, indent, quote)}`]);
+		return edit(change.start, change.end, change.text);
+	}
+	const open = blocks.valueStart;
+	const indent = indentAt(source, blocks.start);
+	if (code[open] === "{") {
+		const listed = properties(source, code, open);
+		if (!listed) return {
+			ok: false,
+			reason: "its blocks object can't be read"
+		};
+		const current = listed.find((prop) => prop.key === name);
+		if (current) return edit(current.valueStart, current.valueEnd, literal(value, indentAt(source, current.start), quote));
+		const inner = listed[0] ? indentAt(source, listed[0].start) : `${indent}  `;
+		const change = append(source, code, open, lastOf(listed), [`${keyText(name)}: ${literal(value, inner, quote)}`]);
+		return edit(change.start, change.end, change.text);
+	}
+	if (code[open] === "[") {
+		const close = closingIndex(code, open);
+		const listed = [...source.slice(open + 1, close).matchAll(/(["'])([^"']*)\1/g)].map((item) => item[2]);
+		const object = Object.fromEntries([...listed.map((block) => [block, {}]), [name, value]]);
+		return edit(open, close + 1, literal(object, indent, quote));
+	}
+	return {
+		ok: false,
+		reason: "its blocks key isn't a literal object or list"
+	};
+}
+/** `setBlockInConfig` for `better-supabase.config.json`. */
+function setBlockInJson(source, name, value) {
+	let config;
+	try {
+		config = JSON.parse(source);
+	} catch {
+		return {
+			ok: false,
+			reason: "it isn't valid JSON"
+		};
+	}
+	if (!isRecord(config)) return {
+		ok: false,
+		reason: "it isn't a JSON object"
+	};
+	const blocks = config["blocks"] ?? {};
+	let current;
+	if (Array.isArray(blocks)) current = Object.fromEntries(blocks.map((block) => [String(block), {}]));
+	else if (isRecord(blocks)) current = blocks;
+	else return {
+		ok: false,
+		reason: "its blocks key isn't an object or a list"
+	};
+	const indent = /^[ \t]+/m.exec(source)?.[0] ?? "  ";
+	return jsonEdit(source, config, {
+		...config,
+		blocks: {
+			...current,
+			[name]: value
+		}
+	}, indent);
+}
+/** `value` under `path`, as nested objects: `["a", "b"]` and 1 give `{ a: { b: 1 } }`. */
+const nested = (path, value) => path.reduceRight((inner, key) => ({ [key]: inner }), value);
+/**
+* `source` with the key at `path` set to `value`, replacing what it has and
+* creating the objects on the way: `["appTables", "projects"]` sets one app
+* table and keeps the others. A `blocks` list becomes an object.
+*/
+function setPathInConfig(source, path, value) {
+	const code = mask(source);
+	const root = configObject(code);
+	if (root === void 0) return {
+		ok: false,
+		reason: "it doesn't pass an object literal to defineConfig()"
+	};
+	const quote = source.includes("'better-supabase/config'") ? "'" : "\"";
+	const edit = (start, end, text) => ({
+		ok: true,
+		text: source.slice(0, start) + text + source.slice(end)
+	});
+	let open = root;
+	for (const [index, key] of path.entries()) {
+		const at = path.slice(0, index + 1).join(".");
+		const props = properties(source, code, open);
+		if (!props) return {
+			ok: false,
+			reason: `its ${at} object can't be read`
+		};
+		const current = props.find((prop) => prop.key === key);
+		const rest = path.slice(index + 1);
+		if (!current) {
+			const indent = props[0] ? indentAt(source, props[0].start) : `${indentAt(source, open)}  `;
+			const change = append(source, code, open, lastOf(props), [`${keyText(key)}: ${literal(nested(rest, value), indent, quote)}`]);
+			return edit(change.start, change.end, change.text);
+		}
+		if (rest.length === 0) return edit(current.valueStart, current.valueEnd, literal(value, indentAt(source, current.start), quote));
+		if (index === 0 && key === "blocks" && code[current.valueStart] === "[") {
+			const [block, ...inside] = rest;
+			return block === void 0 ? {
+				ok: false,
+				reason: "its blocks key is a list"
+			} : setBlockInConfig(source, block, nested(inside, value) ?? {});
+		}
+		if (code[current.valueStart] !== "{") return {
+			ok: false,
+			reason: `its ${at} key isn't a literal object`
+		};
+		open = current.valueStart;
+	}
+	return {
+		ok: false,
+		reason: "the path is empty"
+	};
+}
+/** `value` in `object` at `path`, with the objects on the way copied. */
+function withPath(object, path, value) {
+	const [key, ...rest] = path;
+	if (key === void 0) return object;
+	if (rest.length === 0) return {
+		...object,
+		[key]: value
+	};
+	const inner = object[key];
+	const next = Array.isArray(inner) ? Object.fromEntries(inner.map((item) => [String(item), {}])) : isRecord(inner) ? inner : {};
+	return {
+		...object,
+		[key]: withPath(next, rest, value)
+	};
+}
+/** `setPathInConfig` for `better-supabase.config.json`. */
+function setPathInJson(source, path, value) {
+	let config;
+	try {
+		config = JSON.parse(source);
+	} catch {
+		return {
+			ok: false,
+			reason: "it isn't valid JSON"
+		};
+	}
+	if (!isRecord(config)) return {
+		ok: false,
+		reason: "it isn't a JSON object"
+	};
+	const indent = /^[ \t]+/m.exec(source)?.[0] ?? "  ";
+	return jsonEdit(source, config, withPath(config, path, value), indent);
+}
+//#endregion
+export { codeRanges as _, configObject as a, mask as c, setBlockInJson as d, setPathInConfig as f, skipSpace as g, setPresetInJson as h, closingIndex as i, properties as l, setPresetInConfig as m, addBlocksToJson as n, indentAt as o, setPathInJson as p, addBlocksToWiring as r, keyText as s, addBlocksToConfig as t, setBlockInConfig as u };