epos-spec 1.4.0 → 1.6.0

package/dist/epos-spec.d.ts

@@ -1,13 +1,12 @@
-import { Obj } from 'dropcap/types';
-
-type Action = true | string;
-type Path = string;
-type Match = LocusMatch | TopMatch | FrameMatch;
-type MatchPattern = UrlMatchPattern | '<all_urls>';
-type UrlMatchPattern = string;
-type Access = 'installer' | 'engine';
-type Manifest = Obj;
-type Spec = {
+import type { Obj } from 'dropcap/types';
+export type Action = true | string;
+export type Path = string;
+export type Match = LocusMatch | TopMatch | FrameMatch;
+export type MatchPattern = UrlMatchPattern | '<all_urls>';
+export type UrlMatchPattern = string;
+export type Access = 'projects' | 'engine';
+export type Manifest = Obj;
+export type Spec = {
     name: string;
     icon: string | null;
     title: string | null;
@@ -21,40 +20,39 @@ type Spec = {
     permissions: Permissions;
     manifest: Manifest | null;
 };
-type Popup = {
+export type Popup = {
     width: number;
     height: number;
 };
-type Config = {
+export type Config = {
     access: Access[];
     preloadAssets: boolean;
     allowMissingModels: boolean;
 };
-type Target = {
+export type Target = {
     matches: Match[];
     resources: Resource[];
 };
-type LocusMatch = {
+export type LocusMatch = {
     context: 'locus';
     value: 'popup' | 'sidePanel' | 'background';
 };
-type TopMatch = {
+export type TopMatch = {
     context: 'top';
     value: MatchPattern;
 };
-type FrameMatch = {
+export type FrameMatch = {
     context: 'frame';
     value: MatchPattern;
 };
-type Resource = {
+export type Resource = {
     type: 'js' | 'css' | 'lite-js' | 'shadow-css';
     path: Path;
 };
-type Permissions = {
+export type Permissions = {
     mandatory: Permission[];
     optional: Permission[];
 };
-type Permission = 'background' | 'browsingData' | 'contextMenus' | 'cookies' | 'downloads' | 'notifications' | 'storage';
-declare function parseSpec(json: string): Spec;
-
-export { type Access, type Action, type Config, type FrameMatch, type LocusMatch, type Manifest, type Match, type MatchPattern, type Path, type Permission, type Permissions, type Popup, type Resource, type Spec, type Target, type TopMatch, type UrlMatchPattern, parseSpec as default, parseSpec };
+export type Permission = 'background' | 'browsingData' | 'contextMenus' | 'cookies' | 'downloads' | 'notifications' | 'storage';
+export declare function parseSpecJson(json: string): Spec;
+export declare function parseSpecObject(spec: Obj): Spec;

package/dist/epos-spec.js

@@ -1,285 +1,373 @@
-// src/epos-spec.ts
-import { matchPattern } from "browser-extension-url-match";
-import { ensureArray, is, safeSync, unique } from "dropcap/utils";
-import stripJsonComments from "strip-json-comments";
-var schema = {
-  keys: [
-    "$schema",
-    "name",
-    "version",
-    "icon",
-    "title",
-    "description",
-    "action",
-    "popup",
-    "config",
-    "assets",
-    "targets",
-    "permissions",
-    "manifest"
-  ],
-  name: { min: 2, max: 50, regex: /^[a-z0-9][a-z0-9-]*[a-z0-9]$/ },
-  title: { min: 2, max: 45 },
-  description: { max: 132 },
-  version: { regex: /^(?:\d{1,5}\.){0,3}\d{1,5}$/ },
-  popup: {
-    keys: ["width", "height"],
-    width: { min: 150, max: 800, default: 380 },
-    height: { min: 150, max: 600 - 8 * 4, default: 600 - 8 * 4 }
-  },
-  config: {
-    keys: ["access", "preloadAssets", "allowMissingModels"],
-    access: { default: [], variants: ["installer", "engine"] },
-    preloadAssets: { default: true },
-    allowMissingModels: { default: false }
-  },
-  target: {
-    keys: ["matches", "load"]
-  },
-  permissions: [
-    "background",
-    "browsingData",
-    "contextMenus",
-    "cookies",
-    "downloads",
-    "notifications",
-    "storage",
-    "optional:background",
-    "optional:browsingData",
-    "optional:contextMenus",
-    "optional:cookies",
-    "optional:downloads",
-    "optional:notifications",
-    "optional:storage"
-  ]
+import { matchPattern } from 'browser-extension-url-match';
+import { ensureArray, is, safeSync, unique } from 'dropcap/utils';
+import stripJsonComments from 'strip-json-comments';
+const schema = {
+    keys: [
+        '$schema',
+        'name',
+        'version',
+        'icon',
+        'title',
+        'description',
+        'action',
+        'popup',
+        'config',
+        'assets',
+        'targets',
+        'permissions',
+        'manifest',
+    ],
+    name: { min: 2, max: 20, regex: /^[a-z][a-z0-9-]*[a-z0-9]$/ },
+    title: { min: 2, max: 45 },
+    description: { max: 132 },
+    version: { regex: /^(?:\d{1,5}\.){0,3}\d{1,5}$/ },
+    popup: {
+        keys: ['width', 'height'],
+        width: { min: 150, max: 800, default: 380 },
+        height: { min: 150, max: 600 - 8 * 4, default: 600 - 8 * 4 },
+    },
+    config: {
+        keys: ['access', 'preloadAssets', 'allowMissingModels'],
+        access: { default: [], variants: ['projects', 'engine'] },
+        preloadAssets: { default: true },
+        allowMissingModels: { default: false },
+    },
+    target: {
+        keys: ['matches', 'load'],
+    },
+    permissions: [
+        'background',
+        'browsingData',
+        'contextMenus',
+        'cookies',
+        'downloads',
+        'notifications',
+        'storage',
+        'optional:background',
+        'optional:browsingData',
+        'optional:contextMenus',
+        'optional:cookies',
+        'optional:downloads',
+        'optional:notifications',
+        'optional:storage',
+    ],
 };
-function parseSpec(json) {
-  json = stripJsonComments(json);
-  const [spec, error] = safeSync(() => JSON.parse(json));
-  if (error) throw new Error(`Failed to parse JSON: ${error.message}`);
-  if (!is.object(spec)) throw new Error(`Epos spec must be an object`);
-  const keys = [...schema.keys, ...schema.target.keys];
-  const badKey = Object.keys(spec).find((key) => !keys.includes(key));
-  if (badKey) throw new Error(`Unknown spec key: '${badKey}'`);
-  return {
-    name: parseName(spec),
-    icon: parseIcon(spec),
-    title: parseTitle(spec),
-    version: parseVersion(spec),
-    description: parseDescription(spec),
-    popup: parsePopup(spec),
-    action: parseAction(spec),
-    config: parseConfig(spec),
-    assets: parseAssets(spec),
-    targets: parseTargets(spec),
-    permissions: parsePermissions(spec),
-    manifest: parseManifest(spec)
-  };
+export function parseSpecJson(json) {
+    if (!is.string(json))
+        throw new Error(`Failed to parse JSON: input is not a string`);
+    json = stripJsonComments(json);
+    const [spec, error] = safeSync(() => JSON.parse(json));
+    if (error)
+        throw new Error(`Failed to parse JSON: ${error.message}`);
+    return parseSpecObject(spec);
+}
+export function parseSpecObject(spec) {
+    if (!is.object(spec))
+        throw new Error(`Epos spec must be an object`);
+    const keys = [...schema.keys, ...schema.target.keys];
+    const badKey = Object.keys(spec).find(key => !keys.includes(key));
+    if (badKey)
+        throw new Error(`Unknown spec key: "${badKey}"`);
+    return {
+        name: parseName(spec),
+        icon: parseIcon(spec),
+        title: parseTitle(spec),
+        version: parseVersion(spec),
+        description: parseDescription(spec),
+        popup: parsePopup(spec),
+        action: parseAction(spec),
+        config: parseConfig(spec),
+        assets: parseAssets(spec),
+        targets: parseTargets(spec),
+        permissions: parsePermissions(spec),
+        manifest: parseManifest(spec),
+    };
 }
 function parseName(spec) {
-  if (!("name" in spec)) throw new Error(`'name' field is required`);
-  const name = spec.name;
-  const { min, max, regex } = schema.name;
-  if (!is.string(name)) throw new Error(`'name' must be a string`);
-  if (name.length < min) throw new Error(`'name' must be at least ${min} characters`);
-  if (name.length > max) throw new Error(`'name' must be at most ${max} characters`);
-  if (!regex.test(name)) throw new Error(`'name' must match ${regex}`);
-  return name;
+    if (!('name' in spec))
+        throw new Error(`'name' field is required`);
+    const name = spec.name;
+    if (!is.string(name))
+        throw new Error(`'name' must be a string`);
+    const { min, max, regex } = schema.name;
+    if (name.length < min)
+        throw new Error(`'name' must be at least ${min} characters`);
+    if (name.length > max)
+        throw new Error(`'name' must be at most ${max} characters`);
+    if (name.toLowerCase() !== name)
+        throw new Error(`'name' must be lowercase`);
+    if (!/[a-z]/.test(name[0]))
+        throw new Error(`'name' must start with a letter`);
+    if (!regex.test(name))
+        throw new Error(`'name' must match regex: ${regex}`);
+    return name;
 }
 function parseIcon(spec) {
-  if (!("icon" in spec)) return null;
-  const icon = spec.icon;
-  if (!is.string(icon)) throw new Error(`'icon' must be a string`);
-  return parsePath(icon);
+    if (!('icon' in spec))
+        return null;
+    const icon = spec.icon;
+    if (!is.string(icon))
+        throw new Error(`'icon' must be a string`);
+    return parsePath(icon);
 }
 function parseTitle(spec) {
-  if (!("title" in spec)) return null;
-  const title = spec.title;
-  if (!is.string(title)) throw new Error(`'title' must be a string`);
-  const { min, max } = schema.title;
-  if (title.length < min) throw new Error(`'title' must be at least ${min} characters`);
-  if (title.length > max) throw new Error(`'title' must be at most ${max} characters`);
-  return title;
+    if (!('title' in spec))
+        return null;
+    const title = spec.title;
+    if (!is.string(title))
+        throw new Error(`'title' must be a string`);
+    const { min, max } = schema.title;
+    if (title.length < min)
+        throw new Error(`'title' must be at least ${min} characters`);
+    if (title.length > max)
+        throw new Error(`'title' must be at most ${max} characters`);
+    return title;
 }
 function parseVersion(spec) {
-  if (!("version" in spec)) return "0.0.0";
-  const version = spec.version;
-  if (!is.string(version)) throw new Error(`'version' must be a string`);
-  if (!schema.version.regex.test(version)) throw new Error(`'version' must be in format X.Y.Z or X.Y or X`);
-  return version;
+    if (!('version' in spec))
+        return '0.0.0';
+    const version = spec.version;
+    if (!is.string(version))
+        throw new Error(`'version' must be a string`);
+    if (!schema.version.regex.test(version))
+        throw new Error(`'version' must be in format V.V.V, or V.V, or V`);
+    return version;
 }
 function parseDescription(spec) {
-  if (!("description" in spec)) return null;
-  const description = spec.description;
-  if (!is.string(description)) throw new Error(`'description' must be a string`);
-  const { max } = schema.description;
-  if (description.length > max) throw new Error(`'description' must be at most ${max} characters`);
-  return description;
+    if (!('description' in spec))
+        return null;
+    const description = spec.description;
+    if (!is.string(description))
+        throw new Error(`'description' must be a string`);
+    const { max } = schema.description;
+    if (description.length > max)
+        throw new Error(`'description' must be at most ${max} characters`);
+    return description;
 }
 function parsePopup(spec) {
-  const popup = structuredClone(spec.popup ?? {});
-  if (!is.object(popup)) throw new Error(`'popup' must be an object`);
-  const { keys, width, height } = schema.popup;
-  const badKey = Object.keys(popup).find((key) => !keys.includes(key));
-  if (badKey) throw new Error(`Unknown 'popup' key: '${badKey}'`);
-  popup.width ??= width.default;
-  if (!is.integer(popup.width)) throw new Error(`'popup.width' must be an integer`);
-  if (popup.width < width.min) throw new Error(`'popup.width' must be \u2265 ${width.min}`);
-  if (popup.width > width.max) throw new Error(`'popup.width' must be \u2264 ${width.max}`);
-  popup.height ??= height.default;
-  if (!is.integer(popup.height)) throw new Error(`'popup.height' must be an integer`);
-  if (popup.height < height.min) throw new Error(`'popup.height' must be \u2265 ${height.min}`);
-  if (popup.height > height.max) throw new Error(`'popup.height' must be \u2264 ${height.max}`);
-  return popup;
+    const popup = structuredClone(spec.popup ?? {});
+    if (!is.object(popup))
+        throw new Error(`'popup' must be an object`);
+    const { keys, width, height } = schema.popup;
+    const badKey = Object.keys(popup).find(key => !keys.includes(key));
+    if (badKey)
+        throw new Error(`Unknown 'popup' key: "${badKey}"`);
+    popup.width ??= width.default;
+    if (!is.integer(popup.width))
+        throw new Error(`'popup.width' must be an integer`);
+    if (popup.width < width.min)
+        throw new Error(`'popup.width' must be ≥ ${width.min}`);
+    if (popup.width > width.max)
+        throw new Error(`'popup.width' must be ≤ ${width.max}`);
+    popup.height ??= height.default;
+    if (!is.integer(popup.height))
+        throw new Error(`'popup.height' must be an integer`);
+    if (popup.height < height.min)
+        throw new Error(`'popup.height' must be ≥ ${height.min}`);
+    if (popup.height > height.max)
+        throw new Error(`'popup.height' must be ≤ ${height.max}`);
+    return popup;
 }
 function parseAction(spec) {
-  const action = spec.action ?? null;
-  if (action === null) return null;
-  if (action === true) return true;
-  if (!is.string(action)) throw new Error(`'action' must be a URL or true`);
-  if (!isValidUrl(action)) throw new Error(`Invalid 'action' URL: '${JSON.stringify(action)}'`);
-  return action;
+    const action = spec.action ?? null;
+    if (action === null)
+        return null;
+    if (action === true)
+        return true;
+    if (!is.string(action))
+        throw new Error(`'action' must be a URL or true`);
+    if (!isValidUrl(action))
+        throw new Error(`Invalid 'action' URL: "${JSON.stringify(action)}"`);
+    return action;
 }
 function parseConfig(spec) {
-  const config = spec.config ?? {};
-  if (!is.object(config)) throw new Error(`'config' must be an object`);
-  const badKey = Object.keys(config).find((key) => !schema.config.keys.includes(key));
-  if (badKey) throw new Error(`Unknown 'config' key: '${badKey}'`);
-  const access = config.access ?? schema.config.access.default;
-  if (!isArrayOfStrings(access)) throw new Error(`'config.access' must be an array of strings`);
-  const badAccess = access.find((value) => !schema.config.access.variants.includes(value));
-  if (badAccess) throw new Error(`Unknown 'config.access' value: '${badAccess}'`);
-  const preloadAssets = config.preloadAssets ?? schema.config.preloadAssets.default;
-  if (!is.boolean(preloadAssets)) throw new Error(`'config.preloadAssets' must be a boolean`);
-  const allowMissingModels = config.allowMissingModels ?? schema.config.allowMissingModels.default;
-  if (!is.boolean(allowMissingModels)) throw new Error(`'config.allowMissingModels' must be a boolean`);
-  return {
-    access,
-    preloadAssets,
-    allowMissingModels
-  };
+    const config = spec.config ?? {};
+    if (!is.object(config))
+        throw new Error(`'config' must be an object`);
+    const badKey = Object.keys(config).find(key => !schema.config.keys.includes(key));
+    if (badKey)
+        throw new Error(`Unknown 'config' key: "${badKey}"`);
+    const access = config.access ?? schema.config.access.default;
+    if (!isArrayOfStrings(access))
+        throw new Error(`'config.access' must be an array of strings`);
+    const badAccess = access.find(value => !schema.config.access.variants.includes(value));
+    if (badAccess)
+        throw new Error(`Unknown 'config.access' value: "${badAccess}"`);
+    const preloadAssets = config.preloadAssets ?? schema.config.preloadAssets.default;
+    if (!is.boolean(preloadAssets))
+        throw new Error(`'config.preloadAssets' must be a boolean`);
+    const allowMissingModels = config.allowMissingModels ?? schema.config.allowMissingModels.default;
+    if (!is.boolean(allowMissingModels))
+        throw new Error(`'config.allowMissingModels' must be a boolean`);
+    return {
+        access: access,
+        preloadAssets,
+        allowMissingModels,
+    };
 }
 function parseAssets(spec) {
-  const assets = structuredClone(spec.assets ?? []);
-  if (!isArrayOfStrings(assets)) throw new Error(`'assets' must be an array of strings`);
-  const icon = parseIcon(spec);
-  if (icon) assets.push(icon);
-  return unique(assets.map((path) => parsePath(path)));
+    const assets = structuredClone(spec.assets ?? []);
+    if (!isArrayOfStrings(assets))
+        throw new Error(`'assets' must be an array of strings`);
+    // Add icon to assets
+    const icon = parseIcon(spec);
+    if (icon)
+        assets.push(icon);
+    return unique(assets.map(path => parsePath(path)));
 }
 function parseTargets(spec) {
-  const targets = structuredClone(spec.targets ?? []);
-  if (!is.array(targets)) throw new Error(`'targets' must be an array`);
-  if ("matches" in spec || "load" in spec || "mode" in spec) {
-    targets.unshift({
-      matches: structuredClone(spec.matches ?? []),
-      load: structuredClone(spec.load ?? [])
-    });
-  }
-  return targets.map((target) => parseTarget(target));
+    const targets = structuredClone(spec.targets ?? []);
+    if (!is.array(targets))
+        throw new Error(`'targets' must be an array`);
+    // Move top-level target to 'targets'
+    if ('matches' in spec || 'load' in spec || 'mode' in spec) {
+        targets.unshift({
+            matches: structuredClone(spec.matches ?? []),
+            load: structuredClone(spec.load ?? []),
+        });
+    }
+    return targets.map(target => parseTarget(target));
 }
 function parseTarget(target) {
-  if (!is.object(target)) throw new Error(`Each target must be an object`);
-  const { keys } = schema.target;
-  const badKey = Object.keys(target).find((key) => !keys.includes(key));
-  if (badKey) throw new Error(`Unknown target key: '${badKey}'`);
-  return {
-    matches: parseMatches(target),
-    resources: parseResources(target)
-  };
+    if (!is.object(target))
+        throw new Error(`Each target must be an object`);
+    const { keys } = schema.target;
+    const badKey = Object.keys(target).find(key => !keys.includes(key));
+    if (badKey)
+        throw new Error(`Unknown target key: "${badKey}"`);
+    return {
+        matches: parseMatches(target),
+        resources: parseResources(target),
+    };
 }
 function parseMatches(target) {
-  const matches = ensureArray(target.matches ?? []);
-  return matches.map((match) => parseMatch(match)).flat();
+    const matches = ensureArray(target.matches ?? []);
+    return matches.map(match => parseMatch(match)).flat();
 }
 function parseMatch(match) {
-  if (!is.string(match)) throw new Error(`Invalid match pattern: '${JSON.stringify(match)}'`);
-  if (match === "<popup>") return { context: "locus", value: "popup" };
-  if (match === "<sidePanel>") return { context: "locus", value: "sidePanel" };
-  if (match === "<background>") return { context: "locus", value: "background" };
-  const context = match.startsWith("frame:") ? "frame" : "top";
-  let pattern = context === "frame" ? match.replace("frame:", "") : match;
-  if (pattern === "<allUrls>") return { context, value: "<all_urls>" };
-  if (pattern === "<all_urls>") throw new Error(`Use '<allUrls>' instead of '<all_urls>'`);
-  if (pattern.startsWith("exact:")) {
-    return { context, value: parseMatchPattern(pattern.replace("exact:", "")) };
-  }
-  const href = pattern.replaceAll("*", "wildcard--");
-  if (!URL.canParse(href)) throw new Error(`Invalid match pattern: '${match}'`);
-  const url = new URL(href);
-  if (url.pathname === "") url.pathname = "/";
-  pattern = url.href.replaceAll("wildcard--", "*");
-  return [
-    { context, value: parseMatchPattern(pattern) },
-    { context, value: parseMatchPattern(`${pattern}?*`) }
-  ];
+    if (!is.string(match))
+        throw new Error(`Invalid match pattern: "${JSON.stringify(match)}"`);
+    if (match === '<popup>')
+        return { context: 'locus', value: 'popup' };
+    if (match === '<sidePanel>')
+        return { context: 'locus', value: 'sidePanel' };
+    if (match === '<background>')
+        return { context: 'locus', value: 'background' };
+    const context = match.startsWith('frame:') ? 'frame' : 'top';
+    let pattern = context === 'frame' ? match.replace('frame:', '') : match;
+    if (pattern === '<allUrls>')
+        return { context, value: '<all_urls>' };
+    if (pattern === '<all_urls>')
+        throw new Error(`Use '<allUrls>' instead of '<all_urls>'`);
+    if (pattern.startsWith('exact:')) {
+        return { context, value: parseMatchPattern(pattern.replace('exact:', '')) };
+    }
+    // Ensure pattern url has a path: `*://example.com` -> `*://example.com/`
+    const href = pattern.replaceAll('*', 'wildcard--');
+    if (!URL.canParse(href))
+        throw new Error(`Invalid match pattern: "${match}"`);
+    const url = new URL(href);
+    if (url.pathname === '')
+        url.pathname = '/';
+    pattern = url.href.replaceAll('wildcard--', '*');
+    return [
+        { context, value: parseMatchPattern(pattern) },
+        { context, value: parseMatchPattern(`${pattern}?*`) },
+    ];
 }
 function parseMatchPattern(pattern) {
-  const matcher = matchPattern(pattern);
-  if (!matcher.valid) throw new Error(`Invalid match pattern: '${pattern}'`);
-  return pattern;
+    const matcher = matchPattern(pattern);
+    if (!matcher.valid)
+        throw new Error(`Invalid match pattern: "${pattern}"`);
+    return pattern;
 }
 function parseResources(target) {
-  const load = ensureArray(target.load ?? []);
-  if (!isArrayOfStrings(load)) throw new Error(`'load' must be an array of strings`);
-  return load.map((loadEntry) => parseResource(loadEntry));
+    const load = ensureArray(target.load ?? []);
+    if (!isArrayOfStrings(load))
+        throw new Error(`'load' must be an array of strings`);
+    return load.map(loadEntry => parseResource(loadEntry));
 }
 function parseResource(loadEntry) {
-  const isJs = loadEntry.toLowerCase().endsWith(".js");
-  const isCss = loadEntry.toLowerCase().endsWith(".css");
-  if (!isJs && !isCss) throw new Error(`Invalid 'load' file, must be JS or CSS: '${loadEntry}'`);
-  if (loadEntry.startsWith("lite:")) {
-    if (!isJs) throw new Error(`'lite:' resources must be JS files: '${loadEntry}'`);
-    return { path: loadEntry.replace("lite:", ""), type: "lite-js" };
-  } else if (loadEntry.startsWith("shadow:")) {
-    if (!isCss) throw new Error(`'shadow:' resources must be CSS files: '${loadEntry}'`);
-    return { path: loadEntry.replace("shadow:", ""), type: "shadow-css" };
-  } else {
-    return { path: loadEntry, type: isJs ? "js" : "css" };
-  }
+    const isJs = loadEntry.toLowerCase().endsWith('.js');
+    const isCss = loadEntry.toLowerCase().endsWith('.css');
+    if (!isJs && !isCss)
+        throw new Error(`Invalid 'load' file, must be JS or CSS: "${loadEntry}"`);
+    if (loadEntry.startsWith('lite:')) {
+        if (!isJs)
+            throw new Error(`'lite:' resources must be JS files: "${loadEntry}"`);
+        return { path: parsePath(loadEntry.replace('lite:', '')), type: 'lite-js' };
+    }
+    else if (loadEntry.startsWith('shadow:')) {
+        if (!isCss)
+            throw new Error(`'shadow:' resources must be CSS files: "${loadEntry}"`);
+        return { path: parsePath(loadEntry.replace('shadow:', '')), type: 'shadow-css' };
+    }
+    else {
+        return { path: parsePath(loadEntry), type: isJs ? 'js' : 'css' };
+    }
 }
 function parsePermissions(spec) {
-  const permissions = spec.permissions ?? [];
-  if (!isArrayOfStrings(permissions)) throw new Error(`'permissions' must be an array of strings`);
-  const badPermission = permissions.find((value) => !schema.permissions.includes(value));
-  if (badPermission) throw new Error(`Unknown permission: '${badPermission}'`);
-  const mandatoryPermissions = /* @__PURE__ */ new Set();
-  const optionalPermissions = /* @__PURE__ */ new Set();
-  for (const permission of permissions) {
-    if (permission.startsWith("optional:")) {
-      optionalPermissions.add(permission.replace("optional:", ""));
-    } else {
-      mandatoryPermissions.add(permission);
+    const permissions = spec.permissions ?? [];
+    if (!isArrayOfStrings(permissions))
+        throw new Error(`'permissions' must be an array of strings`);
+    const badPermission = permissions.find(value => !schema.permissions.includes(value));
+    if (badPermission)
+        throw new Error(`Unknown permission: "${badPermission}"`);
+    const mandatoryPermissions = new Set();
+    const optionalPermissions = new Set();
+    for (const permission of permissions) {
+        if (permission.startsWith('optional:')) {
+            optionalPermissions.add(permission.replace('optional:', ''));
+        }
+        else {
+            mandatoryPermissions.add(permission);
+        }
     }
-  }
-  for (const permission of mandatoryPermissions) {
-    if (optionalPermissions.has(permission)) {
-      throw new Error(`Permission cannot be both mandatory and optional: '${permission}'`);
+    for (const permission of mandatoryPermissions) {
+        if (optionalPermissions.has(permission)) {
+            throw new Error(`Permission cannot be both mandatory and optional: "${permission}"`);
+        }
     }
-  }
-  return {
-    mandatory: [...mandatoryPermissions],
-    optional: [...optionalPermissions]
-  };
+    return {
+        mandatory: [...mandatoryPermissions],
+        optional: [...optionalPermissions],
+    };
 }
 function parseManifest(spec) {
-  if (!("manifest" in spec)) return null;
-  if (!is.object(spec.manifest)) throw new Error(`'manifest' must be an object`);
-  return spec.manifest;
+    if (!('manifest' in spec))
+        return null;
+    if (!is.object(spec.manifest))
+        throw new Error(`'manifest' must be an object`);
+    return spec.manifest;
 }
+// ---------------------------------------------------------------------------
+// HELPERS
+// ---------------------------------------------------------------------------
 function isArrayOfStrings(value) {
-  return is.array(value) && value.every(is.string);
+    return is.array(value) && value.every(is.string);
 }
 function isValidUrl(value) {
-  if (!is.string(value)) return false;
-  return URL.canParse(value);
+    if (!is.string(value))
+        return false;
+    return URL.canParse(value);
 }
+/**
+ * - 'path/to' -> 'path/to'
+ * - 'path/to/' -> 'path/to'
+ * - '/path/to' -> 'path/to'
+ * - 'path//to' -> 'path/to'
+ * - 'path/./to' -> 'path/to'
+ * - './path/to' -> 'path/to'
+ * - 'path/../to' -> 'path/../to'
+ * - '../path/to' -> throw
+ */
 function parsePath(path) {
-  const normalizedPath = path.split("/").filter((path2) => path2 && path2 !== ".").join("/");
-  if (normalizedPath.startsWith("..")) throw new Error(`External paths are not allowed: '${path}'`);
-  return normalizedPath;
+    const normalizedPath = path
+        .split('/')
+        .filter(path => path && path !== '.')
+        .join('/');
+    if (normalizedPath.startsWith('..'))
+        throw new Error(`External paths are not allowed: "${path}"`);
+    return normalizedPath;
 }
-var epos_spec_default = parseSpec;
-export {
-  epos_spec_default as default,
-  parseSpec
-};
+//# sourceMappingURL=epos-spec.js.map

package/dist/epos-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epos-spec.js","sourceRoot":"","sources":["../src/epos-spec.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,28 +1,26 @@
 {
   "name": "epos-spec",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "type": "module",
   "license": "MIT",
   "author": "imkost",
   "description": "",
   "keywords": [],
   "scripts": {
-    "dev": "tsup --config ../../tsup.config.ts --watch",
-    "build": "tsup --config ../../tsup.config.ts",
-    "lint": "tsc --noEmit",
+    "dev": "rimraf dist && tsgo --watch",
+    "build": "rimraf dist && tsgo",
+    "lint": "tsgo --noEmit",
     "release": "sh -c 'npm version ${1:-minor} && npm run build && npm publish' --"
   },
   "exports": {
-    ".": "./dist/epos-spec.js",
-    "./ts": "./src/epos-spec.ts"
+    ".": "./dist/epos-spec.js"
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "dependencies": {
     "browser-extension-url-match": "^1.2.0",
-    "dropcap": "^1.0.0",
+    "dropcap": "^1.5.0",
     "strip-json-comments": "^5.0.3"
   }
 }

package/src/epos-spec.ts

@@ -1,442 +0,0 @@
-import { matchPattern } from 'browser-extension-url-match'
-import type { Obj } from 'dropcap/types'
-import { ensureArray, is, safeSync, unique } from 'dropcap/utils'
-import stripJsonComments from 'strip-json-comments'
-
-export type Action = true | string
-export type Path = string
-export type Match = LocusMatch | TopMatch | FrameMatch
-export type MatchPattern = UrlMatchPattern | '<all_urls>'
-export type UrlMatchPattern = string // '*://*.example.com/*'
-export type Access = 'installer' | 'engine'
-export type Manifest = Obj
-
-export type Spec = {
-  name: string
-  icon: string | null
-  title: string | null
-  version: string
-  description: string | null
-  popup: Popup
-  action: Action | null
-  config: Config
-  assets: Path[]
-  targets: Target[]
-  permissions: Permissions
-  manifest: Manifest | null
-}
-
-export type Popup = {
-  width: number
-  height: number
-}
-
-export type Config = {
-  access: Access[]
-  preloadAssets: boolean
-  allowMissingModels: boolean
-}
-
-export type Target = {
-  matches: Match[]
-  resources: Resource[]
-}
-
-export type LocusMatch = {
-  context: 'locus'
-  value: 'popup' | 'sidePanel' | 'background'
-}
-
-export type TopMatch = {
-  context: 'top'
-  value: MatchPattern
-}
-
-export type FrameMatch = {
-  context: 'frame'
-  value: MatchPattern
-}
-
-export type Resource = {
-  type: 'js' | 'css' | 'lite-js' | 'shadow-css'
-  path: Path
-}
-
-export type Permissions = {
-  mandatory: Permission[]
-  optional: Permission[]
-}
-
-export type Permission =
-  | 'background'
-  | 'browsingData'
-  | 'contextMenus'
-  | 'cookies'
-  | 'downloads'
-  | 'notifications'
-  | 'storage'
-
-const schema = {
-  keys: [
-    '$schema',
-    'name',
-    'version',
-    'icon',
-    'title',
-    'description',
-    'action',
-    'popup',
-    'config',
-    'assets',
-    'targets',
-    'permissions',
-    'manifest',
-  ],
-  name: { min: 2, max: 50, regex: /^[a-z0-9][a-z0-9-]*[a-z0-9]$/ },
-  title: { min: 2, max: 45 },
-  description: { max: 132 },
-  version: { regex: /^(?:\d{1,5}\.){0,3}\d{1,5}$/ },
-  popup: {
-    keys: ['width', 'height'],
-    width: { min: 150, max: 800, default: 380 },
-    height: { min: 150, max: 600 - 8 * 4, default: 600 - 8 * 4 },
-  },
-  config: {
-    keys: ['access', 'preloadAssets', 'allowMissingModels'],
-    access: { default: [], variants: ['installer', 'engine'] },
-    preloadAssets: { default: true },
-    allowMissingModels: { default: false },
-  },
-  target: {
-    keys: ['matches', 'load'],
-  },
-  permissions: [
-    'background',
-    'browsingData',
-    'contextMenus',
-    'cookies',
-    'downloads',
-    'notifications',
-    'storage',
-    'optional:background',
-    'optional:browsingData',
-    'optional:contextMenus',
-    'optional:cookies',
-    'optional:downloads',
-    'optional:notifications',
-    'optional:storage',
-  ],
-}
-
-export function parseSpec(json: string): Spec {
-  json = stripJsonComments(json)
-  const [spec, error] = safeSync(() => JSON.parse(json))
-  if (error) throw new Error(`Failed to parse JSON: ${error.message}`)
-  if (!is.object(spec)) throw new Error(`Epos spec must be an object`)
-
-  const keys = [...schema.keys, ...schema.target.keys]
-  const badKey = Object.keys(spec).find(key => !keys.includes(key))
-  if (badKey) throw new Error(`Unknown spec key: '${badKey}'`)
-
-  return {
-    name: parseName(spec),
-    icon: parseIcon(spec),
-    title: parseTitle(spec),
-    version: parseVersion(spec),
-    description: parseDescription(spec),
-    popup: parsePopup(spec),
-    action: parseAction(spec),
-    config: parseConfig(spec),
-    assets: parseAssets(spec),
-    targets: parseTargets(spec),
-    permissions: parsePermissions(spec),
-    manifest: parseManifest(spec),
-  }
-}
-
-function parseName(spec: Obj) {
-  if (!('name' in spec)) throw new Error(`'name' field is required`)
-
-  const name = spec.name
-  const { min, max, regex } = schema.name
-  if (!is.string(name)) throw new Error(`'name' must be a string`)
-  if (name.length < min) throw new Error(`'name' must be at least ${min} characters`)
-  if (name.length > max) throw new Error(`'name' must be at most ${max} characters`)
-  if (!regex.test(name)) throw new Error(`'name' must match ${regex}`)
-
-  return name
-}
-
-function parseIcon(spec: Obj) {
-  if (!('icon' in spec)) return null
-
-  const icon = spec.icon
-  if (!is.string(icon)) throw new Error(`'icon' must be a string`)
-
-  return parsePath(icon)
-}
-
-function parseTitle(spec: Obj): string | null {
-  if (!('title' in spec)) return null
-
-  const title = spec.title
-  if (!is.string(title)) throw new Error(`'title' must be a string`)
-
-  const { min, max } = schema.title
-  if (title.length < min) throw new Error(`'title' must be at least ${min} characters`)
-  if (title.length > max) throw new Error(`'title' must be at most ${max} characters`)
-
-  return title
-}
-
-function parseVersion(spec: Obj): string {
-  if (!('version' in spec)) return '0.0.0'
-
-  const version = spec.version
-  if (!is.string(version)) throw new Error(`'version' must be a string`)
-  if (!schema.version.regex.test(version)) throw new Error(`'version' must be in format X.Y.Z or X.Y or X`)
-
-  return version
-}
-
-function parseDescription(spec: Obj): string | null {
-  if (!('description' in spec)) return null
-
-  const description = spec.description
-  if (!is.string(description)) throw new Error(`'description' must be a string`)
-
-  const { max } = schema.description
-  if (description.length > max) throw new Error(`'description' must be at most ${max} characters`)
-
-  return description
-}
-
-function parsePopup(spec: Obj) {
-  const popup = structuredClone(spec.popup ?? {})
-  if (!is.object(popup)) throw new Error(`'popup' must be an object`)
-
-  const { keys, width, height } = schema.popup
-  const badKey = Object.keys(popup).find(key => !keys.includes(key))
-  if (badKey) throw new Error(`Unknown 'popup' key: '${badKey}'`)
-
-  popup.width ??= width.default
-  if (!is.integer(popup.width)) throw new Error(`'popup.width' must be an integer`)
-  if (popup.width < width.min) throw new Error(`'popup.width' must be ≥ ${width.min}`)
-  if (popup.width > width.max) throw new Error(`'popup.width' must be ≤ ${width.max}`)
-
-  popup.height ??= height.default
-  if (!is.integer(popup.height)) throw new Error(`'popup.height' must be an integer`)
-  if (popup.height < height.min) throw new Error(`'popup.height' must be ≥ ${height.min}`)
-  if (popup.height > height.max) throw new Error(`'popup.height' must be ≤ ${height.max}`)
-
-  return popup as Popup
-}
-
-function parseAction(spec: Obj): Action | null {
-  const action = spec.action ?? null
-  if (action === null) return null
-  if (action === true) return true
-
-  if (!is.string(action)) throw new Error(`'action' must be a URL or true`)
-  if (!isValidUrl(action)) throw new Error(`Invalid 'action' URL: '${JSON.stringify(action)}'`)
-
-  return action
-}
-
-function parseConfig(spec: Obj): Config {
-  const config = spec.config ?? {}
-  if (!is.object(config)) throw new Error(`'config' must be an object`)
-
-  const badKey = Object.keys(config).find(key => !schema.config.keys.includes(key))
-  if (badKey) throw new Error(`Unknown 'config' key: '${badKey}'`)
-
-  const access = config.access ?? schema.config.access.default
-  if (!isArrayOfStrings(access)) throw new Error(`'config.access' must be an array of strings`)
-  const badAccess = access.find(value => !schema.config.access.variants.includes(value))
-  if (badAccess) throw new Error(`Unknown 'config.access' value: '${badAccess}'`)
-
-  const preloadAssets = config.preloadAssets ?? schema.config.preloadAssets.default
-  if (!is.boolean(preloadAssets)) throw new Error(`'config.preloadAssets' must be a boolean`)
-
-  const allowMissingModels = config.allowMissingModels ?? schema.config.allowMissingModels.default
-  if (!is.boolean(allowMissingModels)) throw new Error(`'config.allowMissingModels' must be a boolean`)
-
-  return {
-    access: access as Access[],
-    preloadAssets,
-    allowMissingModels,
-  }
-}
-
-function parseAssets(spec: Obj) {
-  const assets = structuredClone(spec.assets ?? [])
-  if (!isArrayOfStrings(assets)) throw new Error(`'assets' must be an array of strings`)
-
-  // Add icon to assets
-  const icon = parseIcon(spec)
-  if (icon) assets.push(icon)
-
-  return unique(assets.map(path => parsePath(path)))
-}
-
-function parseTargets(spec: Obj) {
-  const targets = structuredClone(spec.targets ?? [])
-  if (!is.array(targets)) throw new Error(`'targets' must be an array`)
-
-  // Move top-level target to 'targets'
-  if ('matches' in spec || 'load' in spec || 'mode' in spec) {
-    targets.unshift({
-      matches: structuredClone(spec.matches ?? []),
-      load: structuredClone(spec.load ?? []),
-    })
-  }
-
-  return targets.map(target => parseTarget(target))
-}
-
-function parseTarget(target: unknown): Target {
-  if (!is.object(target)) throw new Error(`Each target must be an object`)
-
-  const { keys } = schema.target
-  const badKey = Object.keys(target).find(key => !keys.includes(key))
-  if (badKey) throw new Error(`Unknown target key: '${badKey}'`)
-
-  return {
-    matches: parseMatches(target),
-    resources: parseResources(target),
-  }
-}
-
-function parseMatches(target: Obj): Match[] {
-  const matches = ensureArray(target.matches ?? [])
-  return matches.map(match => parseMatch(match)).flat()
-}
-
-function parseMatch(match: unknown): Match | Match[] {
-  if (!is.string(match)) throw new Error(`Invalid match pattern: '${JSON.stringify(match)}'`)
-
-  if (match === '<popup>') return { context: 'locus', value: 'popup' }
-  if (match === '<sidePanel>') return { context: 'locus', value: 'sidePanel' }
-  if (match === '<background>') return { context: 'locus', value: 'background' }
-
-  const context = match.startsWith('frame:') ? 'frame' : 'top'
-  let pattern = context === 'frame' ? match.replace('frame:', '') : match
-
-  if (pattern === '<allUrls>') return { context, value: '<all_urls>' }
-  if (pattern === '<all_urls>') throw new Error(`Use '<allUrls>' instead of '<all_urls>'`)
-
-  if (pattern.startsWith('exact:')) {
-    return { context, value: parseMatchPattern(pattern.replace('exact:', '')) }
-  }
-
-  // Ensure pattern url has a path: `*://example.com` -> `*://example.com/`
-  const href = pattern.replaceAll('*', 'wildcard--')
-  if (!URL.canParse(href)) throw new Error(`Invalid match pattern: '${match}'`)
-  const url = new URL(href)
-  if (url.pathname === '') url.pathname = '/'
-  pattern = url.href.replaceAll('wildcard--', '*')
-
-  return [
-    { context, value: parseMatchPattern(pattern) },
-    { context, value: parseMatchPattern(`${pattern}?*`) },
-  ]
-}
-
-function parseMatchPattern(pattern: string): MatchPattern {
-  const matcher = matchPattern(pattern)
-  if (!matcher.valid) throw new Error(`Invalid match pattern: '${pattern}'`)
-  return pattern
-}
-
-function parseResources(target: Obj) {
-  const load = ensureArray(target.load ?? [])
-  if (!isArrayOfStrings(load)) throw new Error(`'load' must be an array of strings`)
-  return load.map(loadEntry => parseResource(loadEntry))
-}
-
-function parseResource(loadEntry: string): Resource {
-  const isJs = loadEntry.toLowerCase().endsWith('.js')
-  const isCss = loadEntry.toLowerCase().endsWith('.css')
-  if (!isJs && !isCss) throw new Error(`Invalid 'load' file, must be JS or CSS: '${loadEntry}'`)
-
-  if (loadEntry.startsWith('lite:')) {
-    if (!isJs) throw new Error(`'lite:' resources must be JS files: '${loadEntry}'`)
-    return { path: loadEntry.replace('lite:', ''), type: 'lite-js' }
-  } else if (loadEntry.startsWith('shadow:')) {
-    if (!isCss) throw new Error(`'shadow:' resources must be CSS files: '${loadEntry}'`)
-    return { path: loadEntry.replace('shadow:', ''), type: 'shadow-css' }
-  } else {
-    return { path: loadEntry, type: isJs ? 'js' : 'css' }
-  }
-}
-
-function parsePermissions(spec: Obj): Permissions {
-  const permissions = spec.permissions ?? []
-  if (!isArrayOfStrings(permissions)) throw new Error(`'permissions' must be an array of strings`)
-
-  const badPermission = permissions.find(value => !schema.permissions.includes(value))
-  if (badPermission) throw new Error(`Unknown permission: '${badPermission}'`)
-
-  const mandatoryPermissions = new Set<string>()
-  const optionalPermissions = new Set<string>()
-  for (const permission of permissions) {
-    if (permission.startsWith('optional:')) {
-      optionalPermissions.add(permission.replace('optional:', ''))
-    } else {
-      mandatoryPermissions.add(permission)
-    }
-  }
-
-  for (const permission of mandatoryPermissions) {
-    if (optionalPermissions.has(permission)) {
-      throw new Error(`Permission cannot be both mandatory and optional: '${permission}'`)
-    }
-  }
-
-  return {
-    mandatory: [...mandatoryPermissions] as Permission[],
-    optional: [...optionalPermissions] as Permission[],
-  }
-}
-
-function parseManifest(spec: Obj): Manifest | null {
-  if (!('manifest' in spec)) return null
-  if (!is.object(spec.manifest)) throw new Error(`'manifest' must be an object`)
-  return spec.manifest
-}
-
-// ---------------------------------------------------------------------------
-// HELPERS
-// ---------------------------------------------------------------------------
-
-function isArrayOfStrings(value: unknown) {
-  return is.array(value) && value.every(is.string)
-}
-
-function isValidUrl(value: unknown) {
-  if (!is.string(value)) return false
-  return URL.canParse(value)
-}
-
-/**
- * - 'path/to' -> 'path/to'
- * - 'path/to/' -> 'path/to'
- * - '/path/to' -> 'path/to'
- * - 'path//to' -> 'path/to'
- * - 'path/./to' -> 'path/to'
- * - './path/to' -> 'path/to'
- * - 'path/../to' -> 'path/../to'
- * - '../path/to' -> throw
- */
-function parsePath(path: string) {
-  const normalizedPath = path
-    .split('/')
-    .filter(path => path && path !== '.')
-    .join('/')
-
-  if (normalizedPath.startsWith('..')) throw new Error(`External paths are not allowed: '${path}'`)
-
-  return normalizedPath
-}
-
-export default parseSpec