@tablecraft-app/plugin-api 1.1.0 → 1.3.0

package/dist/url.d.ts

@@ -24,6 +24,7 @@ export interface ConnectionUrlSpec {
         readonly key: string;
         readonly values?: Readonly<Record<string, string>> | undefined;
     }[] | undefined;
+    readonly sets?: Readonly<Record<string, Readonly<Record<string, ConnectionValue>>>> | undefined;
 }
 interface UrlField {
     readonly key: string;
@@ -45,7 +46,8 @@ export interface ConnectionForm {
  */
 export declare function parseConnectionUrl(form: ConnectionForm, text: string): ParsedConnectionUrl;
 /**
- * The connection URL of `config`, in the plugin's first scheme. Never carries a secret field, so
+ * The connection URL of `config`, in the first scheme whose `sets` the config holds, else the first
+ * that sets nothing. Never carries a secret field, so
  * the result is safe to copy, show and log; params equal to their field's default are left out.
  */
 export declare function formatConnectionUrl(form: ConnectionForm, config: Readonly<Record<string, unknown>>): string;

package/dist/url.js

@@ -112,6 +112,7 @@ function parseServer(form, url, text) {
         throw new ConnectionUrlError(`That is not a valid ${scheme}:// URL; check the port is a number and special characters are percent-encoded.`);
     }
     const collected = new Collected(form, url);
+    Object.assign(collected.values, url.sets?.[scheme]);
     collected.part("host", decoded(parsed.hostname.replace(/^\[(.*)\]$/, "$1")));
     collected.part("port", parsed.port);
     collected.part("database", decoded(parsed.pathname.replace(LEADING_SLASHES, "")));
@@ -178,12 +179,20 @@ function encodedPath(path) {
     return encodeURI(path).replaceAll("?", "%3F").replaceAll("#", "%23");
 }
 /**
- * The connection URL of `config`, in the plugin's first scheme. Never carries a secret field, so
+ * The connection URL of `config`, in the first scheme whose `sets` the config holds, else the first
+ * that sets nothing. Never carries a secret field, so
  * the result is safe to copy, show and log; params equal to their field's default are left out.
  */
 export function formatConnectionUrl(form, config) {
     const url = urlOf(form);
-    const scheme = url.schemes[0] ?? "";
+    const implied = (candidate) => {
+        const sets = url.sets?.[candidate];
+        return sets !== undefined && Object.entries(sets).every(([key, value]) => config[key] === value);
+    };
+    const scheme = url.schemes.find(implied) ??
+        url.schemes.find((candidate) => url.sets?.[candidate] === undefined) ??
+        url.schemes[0] ??
+        "";
     const valueOf = (part) => {
         const key = url.parts[part];
         if (key === undefined || fieldOf(form, key)?.secret === true)

package/dist/version.js

@@ -2,7 +2,7 @@
  * The plugin contract's version, by semver (decision 106): a host loads a plugin built for the same
  * major and an older or equal minor. Typed `string` so a bump does not change the API report.
  */
-export const API_VERSION = "1.1.0";
+export const API_VERSION = "1.3.0";
 const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
 /** `major.minor.patch` and nothing else; pre-release and build tags are not accepted. */
 export function parseVersion(text) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tablecraft-app/plugin-api",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "The datasource plugin contract for TableCraft",
   "license": "MIT",
   "type": "module",