URIHandler.ts

interface LibURIHandler {
	tag: "lib";
	pkg: string;
	version?: string;
	import: string;
}

type SplitArgMethod = {
	tag: "split";
	separator: RegExp | string;
};

type SingleArgMethod = {
	tag: "single";
};

interface AppURIHandler {
	tag: "app";
	pkg: string;
	method: SplitArgMethod | SingleArgMethod;
}

interface URIHandlerOptions {
	handler: LibURIHandler | AppURIHandler;
	prefix?: string;
}

class URIHandlerAPI {
	// Handles a URI like "protocol:something/etc" by opening the appropriate app or library.
	async handle(uri: string): Promise<void> {
		// const url = new URL(uri);
		// const protocol = url.protocol.slice(0, -1);
		const [protocol, ...path] = uri.split(":");
		const pathname = path.join(":");
		const handlers = anura.settings.get("URIHandlers") || {};
		const handler = handlers[protocol as string];
		if (!handler) {
			throw new Error(`No handler for URI protocol ${protocol}`);
		}
		if (handler.handler.tag === "lib") {
			let lib;
			if (handler.handler.version) {
				lib = await anura.import(
					handler.handler.pkg + "@" + handler.handler.version,
				);
			} else {
				lib = await anura.import(handler.handler.pkg);
			}
			await lib[handler.handler.import]((handler.prefix || "") + pathname);
		} else if (handler.handler.tag === "app") {
			const app = handler.handler;
			if (app.method.tag === "split") {
				const args = pathname.split(app.method.separator);
				await anura.apps[app.pkg].open(
					handler.prefix ? [handler.prefix, ...args] : args,
				);
			} else {
				await anura.apps[app.pkg].open((handler.prefix || "") + pathname);
			}
		}
	}

	// Sets a handler for a URI protocol.
	set(protocol: string, options: URIHandlerOptions): void {
		const handlers = anura.settings.get("URIHandlers") || {};
		handlers[protocol] = options;
		anura.settings.set("URIHandlers", handlers);
	}

	// Removes a handler for a URI protocol.
	remove(protocol: string): void {
		const handlers = anura.settings.get("URIHandlers") || {};
		delete handlers[protocol];
		anura.settings.set("URIHandlers", handlers);
	}

	// Determines if a handler is set for a URI protocol.
	has(protocol: string): boolean {
		const handlers = anura.settings.get("URIHandlers") || {};
		return !!handlers[protocol];
	}
}