adnbn 0.6.0 → 0.7.0

package/dist/types/manifest.d.ts

@@ -3,6 +3,8 @@ import { BackgroundConfig } from "./background.js";
 import { CommandConfig } from "./command.js";
 import { Language } from "./locale.js";
 import { BrowserSpecific, DataCollectionPermission } from "./browser.js";
+import { CspConfig } from "./csp.js";
+import { SandboxCspConfig } from "./sandbox.js";
 type ManifestCommon = chrome.runtime.Manifest;
 type ManifestBase = chrome.runtime.ManifestBase;
 type ManifestPermission = chrome.runtime.ManifestPermission;
@@ -81,6 +83,12 @@ export interface ManifestBuilder<T extends CoreManifest = Manifest> {
     setContentScripts(contentScripts?: ManifestContentScripts): this;
     setPopup(popup?: ManifestPopup): this;
     setSidebar(sidebar?: ManifestSidebar): this;
+    addSandbox(sandbox: ManifestSandbox): this;
+    appendSandboxes(sandboxes: Iterable<ManifestSandbox>): this;
+    addSandboxCsp(csp: SandboxCspConfig): this;
+    appendSandboxCsp(csps: Iterable<SandboxCspConfig>): this;
+    addCsp(csp: CspConfig): this;
+    appendCsp(csps: Iterable<CspConfig>): this;
     setDependencies(dependencies: ManifestDependencies): this;
     addPermission(permission: ManifestPermission): this;
     setPermissions(permissions: ManifestPermissions): this;
@@ -149,6 +157,8 @@ export interface ManifestAccessibleResource {
     useDynamicUrl?: boolean;
 }
 export type ManifestAccessibleResources = Set<ManifestAccessibleResource>;
+export type ManifestSandbox = string;
+export type ManifestSandboxes = Set<ManifestSandbox>;
 export interface ManifestDependency {
     js: Set<string>;
     css: Set<string>;

package/dist/types/manifest.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/manifest.ts"],"sourcesContent":["import {ContentScriptConfig} from \"@typing/content\";\nimport {BackgroundConfig} from \"@typing/background\";\nimport {CommandConfig} from \"@typing/command\";\nimport {Language} from \"@typing/locale\";\nimport {BrowserSpecific, DataCollectionPermission} from \"@typing/browser\";\n\ntype ManifestCommon = chrome.runtime.Manifest;\ntype ManifestBase = chrome.runtime.ManifestBase;\ntype ManifestPermission = chrome.runtime.ManifestPermission;\ntype ManifestOptionalPermission = chrome.runtime.ManifestOptionalPermission;\n\nexport const ManifestMatchSchemes: ReadonlySet<string> = new Set<string>([\"http\", \"https\", \"file\", \"ftp\", \"ws\", \"wss\"]);\n\nexport const ManifestSpecialSchemes: ReadonlySet<string> = new Set<string>([\n    \"chrome-extension\",\n    \"moz-extension\",\n    \"data\",\n    \"blob\",\n    \"filesystem\",\n    \"about\",\n    \"chrome\",\n    \"resource\",\n]);\n\ntype ManifestFixed<T extends ManifestBase> = Omit<T, \"manifest_version\"> & {\n    manifest_version: ManifestVersion;\n};\n\ninterface ManifestUnstable {\n    permissions?: (ManifestPermission | (string & Record<never, never>))[];\n    web_accessible_resources?: string[] | chrome.runtime.ManifestV3[\"web_accessible_resources\"];\n}\n\nexport type ManifestVersion = 2 | 3;\n\nexport enum ManifestIncognito {\n    Spanning = \"spanning\",\n    Split = \"split\",\n    NotAllowed = \"not_allowed\",\n}\n\nexport type ManifestIncognitoValue = ManifestIncognito | `${ManifestIncognito}`;\n\nexport type CoreManifest = ManifestFixed<ManifestBase>;\n\nexport type ChromeManifest = ManifestFixed<ManifestCommon>;\n\nexport type FirefoxManifest = ChromeManifest & {\n    action?: chrome.runtime.ManifestV3[\"action\"] & {\n        browser_style?: boolean;\n    };\n    browser_action?: chrome.runtime.ManifestV2[\"browser_action\"] & {\n        browser_style?: boolean;\n    };\n    page_action?: chrome.runtime.ManifestV2[\"page_action\"] & {\n        browser_style?: boolean;\n    };\n    browser_specific_settings?: {\n        gecko?: {\n            id?: string;\n            strict_min_version?: string;\n            strict_max_version?: string;\n            update_url?: string;\n            data_collection_permissions?: {\n                required?: [\"none\"] | `${DataCollectionPermission}`[];\n                optional?: `${DataCollectionPermission}`[];\n            };\n        };\n        gecko_android?: {\n            strict_min_version?: string;\n            strict_max_version?: string;\n        };\n    };\n} & ManifestUnstable;\n\nexport type SafariManifest = ChromeManifest & {\n    browser_specific_settings?: {\n        safari?: {\n            strict_min_version?: string;\n            strict_max_version?: string;\n        };\n    };\n} & ManifestUnstable;\n\nexport type Manifest = ChromeManifest | FirefoxManifest | SafariManifest;\n\nexport type OptionalManifest = Partial<Omit<Manifest, \"manifest_version\">>;\n\nexport interface ManifestBuilder<T extends CoreManifest = Manifest> {\n    setName(name: string): this;\n\n    setShortName(shortName?: string): this;\n\n    setDescription(description?: string): this;\n\n    setAuthor(author?: string): this;\n\n    setHomepage(homepage?: string): this;\n\n    setVersion(version?: string): this;\n\n    setIncognito(incognito?: ManifestIncognitoValue): this;\n\n    setMinimumVersion(minimumVersion?: string): this;\n\n    setLocale(lang?: Language): this;\n\n    // Specific settings\n    setSpecific(settings?: BrowserSpecific): this;\n\n    mergeSpecific(settings: BrowserSpecific): this;\n\n    // Icons\n    setIcons(icons?: ManifestIcons): this;\n\n    setIcon(icon?: string): this; // name of an icon set for manifest.icons\n\n    // Entry\n    setBackground(background?: ManifestBackground): this;\n\n    setCommands(commands?: ManifestCommands): this;\n\n    setContentScripts(contentScripts?: ManifestContentScripts): this;\n\n    setPopup(popup?: ManifestPopup): this;\n\n    setSidebar(sidebar?: ManifestSidebar): this;\n\n    // System\n    setDependencies(dependencies: ManifestDependencies): this;\n\n    // Permissions\n    addPermission(permission: ManifestPermission): this;\n\n    setPermissions(permissions: ManifestPermissions): this;\n\n    appendPermissions(permissions: ManifestPermissions): this;\n\n    // Optional Permissions\n    addOptionalPermission(permission: ManifestOptionalPermission): this;\n\n    setOptionalPermissions(permissions: ManifestOptionalPermissions): this;\n\n    appendOptionalPermissions(permissions: ManifestOptionalPermissions): this;\n\n    // Host Permissions\n    addHostPermission(permission: string): this;\n\n    setHostPermissions(permissions: ManifestHostPermissions): this;\n\n    appendHostPermissions(permissions: ManifestHostPermissions): this;\n\n    // Optional Host Permissions\n    addOptionalHostPermission(permission: string): this;\n\n    setOptionalHostPermissions(permissions: ManifestHostPermissions): this;\n\n    appendOptionalHostPermissions(permissions: ManifestHostPermissions): this;\n\n    // Web Accessible Resource\n    setAccessibleResource(accessibleResources: ManifestAccessibleResources): this;\n\n    appendAccessibleResources(accessibleResources: ManifestAccessibleResources): this;\n\n    addAccessibleResource(accessibleResource: ManifestAccessibleResource): this;\n\n    getWebAccessibleResources(): ManifestAccessibleResource[];\n\n    // Getter\n    get(): T;\n\n    raw(manifest: OptionalManifest): this;\n}\n\ntype Entry = string;\n\nexport interface ManifestEntry {\n    entry: Entry;\n}\n\nexport type ManifestBackground = ManifestEntry & BackgroundConfig;\n\nexport type ManifestContentScript = ManifestEntry & ContentScriptConfig;\nexport type ManifestContentScripts = Set<ManifestContentScript>;\n\nexport type ManifestCommand = CommandConfig;\nexport type ManifestCommands = Set<ManifestCommand>;\n\nexport interface ManifestPopup {\n    /**\n     * Represents the group name of an icon that can be used in UI elements.\n     * This property is optional and, if defined, should typically refer to a string\n     * that matches the name of an icon resource available in the application or icon library.\n     */\n    icon?: string;\n    /**\n     * Represents an optional title or name or locale key that can be assigned to an entity.\n     */\n    title?: string;\n    /**\n     * Represents an optional HTML path.\n     */\n    path?: string;\n}\n\nexport interface ManifestSidebar {\n    /**\n     * Represents the group name of an icon that can be used in UI elements.\n     * This property is optional and, if defined, should typically refer to a string\n     * that matches the name of an icon resource available in the application or icon library.\n     */\n    icon?: string;\n    /**\n     * Represents an optional title or name or locale key that can be assigned to an entity.\n     */\n    title?: string;\n    /**\n     * Represents an optional HTML path.\n     */\n    path?: string;\n}\n\nexport interface ManifestAccessibleResource {\n    resources: string[];\n    matches?: string[];\n    extensionIds?: string[];\n    useDynamicUrl?: boolean;\n}\n\nexport type ManifestAccessibleResources = Set<ManifestAccessibleResource>;\n\nexport interface ManifestDependency {\n    js: Set<string>;\n    css: Set<string>;\n    assets: Set<string>;\n}\n\nexport type ManifestIcon = Map<number, string>;\n\nexport type ManifestIcons = Map<string, ManifestIcon>;\n\nexport type ManifestDependencies = Map<Entry, ManifestDependency>;\n\nexport type ManifestPermissions = Set<ManifestPermission>;\n\nexport type ManifestOptionalPermissions = Set<ManifestOptionalPermission>;\n\nexport type ManifestHostPermissions = Set<string>;\n"],"mappings":"AAWO,MAAM,uBAA4C,oBAAI,IAAY,CAAC,QAAQ,SAAS,QAAQ,OAAO,MAAM,KAAK,CAAC;AAE/G,MAAM,yBAA8C,oBAAI,IAAY;AAAA,EACvE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAaM,IAAK,oBAAL,kBAAKA,uBAAL;AACH,EAAAA,mBAAA,cAAW;AACX,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,gBAAa;AAHL,SAAAA;AAAA,GAAA;","names":["ManifestIncognito"]}
+{"version":3,"sources":["../../src/types/manifest.ts"],"sourcesContent":["import {ContentScriptConfig} from \"@typing/content\";\nimport {BackgroundConfig} from \"@typing/background\";\nimport {CommandConfig} from \"@typing/command\";\nimport {Language} from \"@typing/locale\";\nimport {BrowserSpecific, DataCollectionPermission} from \"@typing/browser\";\nimport {CspConfig} from \"@typing/csp\";\nimport {SandboxCspConfig} from \"@typing/sandbox\";\n\ntype ManifestCommon = chrome.runtime.Manifest;\ntype ManifestBase = chrome.runtime.ManifestBase;\ntype ManifestPermission = chrome.runtime.ManifestPermission;\ntype ManifestOptionalPermission = chrome.runtime.ManifestOptionalPermission;\n\nexport const ManifestMatchSchemes: ReadonlySet<string> = new Set<string>([\"http\", \"https\", \"file\", \"ftp\", \"ws\", \"wss\"]);\n\nexport const ManifestSpecialSchemes: ReadonlySet<string> = new Set<string>([\n    \"chrome-extension\",\n    \"moz-extension\",\n    \"data\",\n    \"blob\",\n    \"filesystem\",\n    \"about\",\n    \"chrome\",\n    \"resource\",\n]);\n\ntype ManifestFixed<T extends ManifestBase> = Omit<T, \"manifest_version\"> & {\n    manifest_version: ManifestVersion;\n};\n\ninterface ManifestUnstable {\n    permissions?: (ManifestPermission | (string & Record<never, never>))[];\n    web_accessible_resources?: string[] | chrome.runtime.ManifestV3[\"web_accessible_resources\"];\n}\n\nexport type ManifestVersion = 2 | 3;\n\nexport enum ManifestIncognito {\n    Spanning = \"spanning\",\n    Split = \"split\",\n    NotAllowed = \"not_allowed\",\n}\n\nexport type ManifestIncognitoValue = ManifestIncognito | `${ManifestIncognito}`;\n\nexport type CoreManifest = ManifestFixed<ManifestBase>;\n\nexport type ChromeManifest = ManifestFixed<ManifestCommon>;\n\nexport type FirefoxManifest = ChromeManifest & {\n    action?: chrome.runtime.ManifestV3[\"action\"] & {\n        browser_style?: boolean;\n    };\n    browser_action?: chrome.runtime.ManifestV2[\"browser_action\"] & {\n        browser_style?: boolean;\n    };\n    page_action?: chrome.runtime.ManifestV2[\"page_action\"] & {\n        browser_style?: boolean;\n    };\n    browser_specific_settings?: {\n        gecko?: {\n            id?: string;\n            strict_min_version?: string;\n            strict_max_version?: string;\n            update_url?: string;\n            data_collection_permissions?: {\n                required?: [\"none\"] | `${DataCollectionPermission}`[];\n                optional?: `${DataCollectionPermission}`[];\n            };\n        };\n        gecko_android?: {\n            strict_min_version?: string;\n            strict_max_version?: string;\n        };\n    };\n} & ManifestUnstable;\n\nexport type SafariManifest = ChromeManifest & {\n    browser_specific_settings?: {\n        safari?: {\n            strict_min_version?: string;\n            strict_max_version?: string;\n        };\n    };\n} & ManifestUnstable;\n\nexport type Manifest = ChromeManifest | FirefoxManifest | SafariManifest;\n\nexport type OptionalManifest = Partial<Omit<Manifest, \"manifest_version\">>;\n\nexport interface ManifestBuilder<T extends CoreManifest = Manifest> {\n    setName(name: string): this;\n\n    setShortName(shortName?: string): this;\n\n    setDescription(description?: string): this;\n\n    setAuthor(author?: string): this;\n\n    setHomepage(homepage?: string): this;\n\n    setVersion(version?: string): this;\n\n    setIncognito(incognito?: ManifestIncognitoValue): this;\n\n    setMinimumVersion(minimumVersion?: string): this;\n\n    setLocale(lang?: Language): this;\n\n    // Specific settings\n    setSpecific(settings?: BrowserSpecific): this;\n\n    mergeSpecific(settings: BrowserSpecific): this;\n\n    // Icons\n    setIcons(icons?: ManifestIcons): this;\n\n    setIcon(icon?: string): this; // name of an icon set for manifest.icons\n\n    // Entry\n    setBackground(background?: ManifestBackground): this;\n\n    setCommands(commands?: ManifestCommands): this;\n\n    setContentScripts(contentScripts?: ManifestContentScripts): this;\n\n    setPopup(popup?: ManifestPopup): this;\n\n    setSidebar(sidebar?: ManifestSidebar): this;\n\n    // Sandbox\n    addSandbox(sandbox: ManifestSandbox): this;\n\n    appendSandboxes(sandboxes: Iterable<ManifestSandbox>): this;\n\n    addSandboxCsp(csp: SandboxCspConfig): this;\n\n    appendSandboxCsp(csps: Iterable<SandboxCspConfig>): this;\n\n    // Content Security Policy\n    addCsp(csp: CspConfig): this;\n\n    appendCsp(csps: Iterable<CspConfig>): this;\n\n    // System\n    setDependencies(dependencies: ManifestDependencies): this;\n\n    // Permissions\n    addPermission(permission: ManifestPermission): this;\n\n    setPermissions(permissions: ManifestPermissions): this;\n\n    appendPermissions(permissions: ManifestPermissions): this;\n\n    // Optional Permissions\n    addOptionalPermission(permission: ManifestOptionalPermission): this;\n\n    setOptionalPermissions(permissions: ManifestOptionalPermissions): this;\n\n    appendOptionalPermissions(permissions: ManifestOptionalPermissions): this;\n\n    // Host Permissions\n    addHostPermission(permission: string): this;\n\n    setHostPermissions(permissions: ManifestHostPermissions): this;\n\n    appendHostPermissions(permissions: ManifestHostPermissions): this;\n\n    // Optional Host Permissions\n    addOptionalHostPermission(permission: string): this;\n\n    setOptionalHostPermissions(permissions: ManifestHostPermissions): this;\n\n    appendOptionalHostPermissions(permissions: ManifestHostPermissions): this;\n\n    // Web Accessible Resource\n    setAccessibleResource(accessibleResources: ManifestAccessibleResources): this;\n\n    appendAccessibleResources(accessibleResources: ManifestAccessibleResources): this;\n\n    addAccessibleResource(accessibleResource: ManifestAccessibleResource): this;\n\n    getWebAccessibleResources(): ManifestAccessibleResource[];\n\n    // Getter\n    get(): T;\n\n    raw(manifest: OptionalManifest): this;\n}\n\ntype Entry = string;\n\nexport interface ManifestEntry {\n    entry: Entry;\n}\n\nexport type ManifestBackground = ManifestEntry & BackgroundConfig;\n\nexport type ManifestContentScript = ManifestEntry & ContentScriptConfig;\nexport type ManifestContentScripts = Set<ManifestContentScript>;\n\nexport type ManifestCommand = CommandConfig;\nexport type ManifestCommands = Set<ManifestCommand>;\n\nexport interface ManifestPopup {\n    /**\n     * Represents the group name of an icon that can be used in UI elements.\n     * This property is optional and, if defined, should typically refer to a string\n     * that matches the name of an icon resource available in the application or icon library.\n     */\n    icon?: string;\n    /**\n     * Represents an optional title or name or locale key that can be assigned to an entity.\n     */\n    title?: string;\n    /**\n     * Represents an optional HTML path.\n     */\n    path?: string;\n}\n\nexport interface ManifestSidebar {\n    /**\n     * Represents the group name of an icon that can be used in UI elements.\n     * This property is optional and, if defined, should typically refer to a string\n     * that matches the name of an icon resource available in the application or icon library.\n     */\n    icon?: string;\n    /**\n     * Represents an optional title or name or locale key that can be assigned to an entity.\n     */\n    title?: string;\n    /**\n     * Represents an optional HTML path.\n     */\n    path?: string;\n}\n\nexport interface ManifestAccessibleResource {\n    resources: string[];\n    matches?: string[];\n    extensionIds?: string[];\n    useDynamicUrl?: boolean;\n}\n\nexport type ManifestAccessibleResources = Set<ManifestAccessibleResource>;\n\nexport type ManifestSandbox = string;\n\nexport type ManifestSandboxes = Set<ManifestSandbox>;\n\nexport interface ManifestDependency {\n    js: Set<string>;\n    css: Set<string>;\n    assets: Set<string>;\n}\n\nexport type ManifestIcon = Map<number, string>;\n\nexport type ManifestIcons = Map<string, ManifestIcon>;\n\nexport type ManifestDependencies = Map<Entry, ManifestDependency>;\n\nexport type ManifestPermissions = Set<ManifestPermission>;\n\nexport type ManifestOptionalPermissions = Set<ManifestOptionalPermission>;\n\nexport type ManifestHostPermissions = Set<string>;\n"],"mappings":"AAaO,MAAM,uBAA4C,oBAAI,IAAY,CAAC,QAAQ,SAAS,QAAQ,OAAO,MAAM,KAAK,CAAC;AAE/G,MAAM,yBAA8C,oBAAI,IAAY;AAAA,EACvE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAaM,IAAK,oBAAL,kBAAKA,uBAAL;AACH,EAAAA,mBAAA,cAAW;AACX,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,gBAAa;AAHL,SAAAA;AAAA,GAAA;","names":["ManifestIncognito"]}

package/dist/types/message.d.ts

@@ -1,6 +1,7 @@
 export declare const MessageGlobalKey = "adnbnMessage";
 export declare const MessageTypeSeparator = ":";
 export declare const MessageSenderProperty = "$sender";
+export declare const MessageResultEnvelopeProperty = "__adnbnEnvelope";
 export type MessageSender = chrome.runtime.MessageSender;
 export type MessageSendOptions = number | {
     tabId: number;
@@ -13,6 +14,20 @@ export interface MessageDictionary {
 export interface MessageSenderAware {
     readonly [MessageSenderProperty]?: MessageSender;
 }
+export interface MessageError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+export type MessageResult<T = any> = {
+    readonly [MessageResultEnvelopeProperty]: true;
+    ok: true;
+    payload: T;
+} | {
+    readonly [MessageResultEnvelopeProperty]: true;
+    ok: false;
+    error: MessageError;
+};
 export type MessageType<T extends MessageDictionary> = Extract<keyof T, string>;
 export type MessageData<T extends MessageDictionary, K extends MessageType<T>> = Parameters<T[K]>[0];
 export type MessageResponse<T extends MessageDictionary, K extends MessageType<T>> = ReturnType<T[K]>;

package/dist/types/message.js

@@ -1,8 +1,10 @@
 const MessageGlobalKey = "adnbnMessage";
 const MessageTypeSeparator = ":";
 const MessageSenderProperty = "$sender";
+const MessageResultEnvelopeProperty = "__adnbnEnvelope";
 export {
   MessageGlobalKey,
+  MessageResultEnvelopeProperty,
   MessageSenderProperty,
   MessageTypeSeparator
 };

package/dist/types/message.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/message.ts"],"sourcesContent":["export const MessageGlobalKey = \"adnbnMessage\";\n\nexport const MessageTypeSeparator = \":\";\n\nexport const MessageSenderProperty = \"$sender\";\n\nexport type MessageSender = chrome.runtime.MessageSender;\n\nexport type MessageSendOptions = number | {tabId: number; frameId?: number; documentId?: string};\n\nexport interface MessageDictionary {\n    [key: string]: (data: any) => any;\n}\n\nexport interface MessageSenderAware {\n    readonly [MessageSenderProperty]?: MessageSender;\n}\n\nexport type MessageType<T extends MessageDictionary> = Extract<keyof T, string>;\nexport type MessageData<T extends MessageDictionary, K extends MessageType<T>> = Parameters<T[K]>[0];\nexport type MessageResponse<T extends MessageDictionary, K extends MessageType<T>> = ReturnType<T[K]>;\n\nexport type MessageTargetHandler<T extends MessageDictionary, K extends MessageType<T>> = (\n    data: MessageData<T, K>,\n    sender: MessageSender\n) => MessageResponse<T, K>;\nexport type MessageMapHandler<T extends MessageDictionary> = {[K in MessageType<T>]?: MessageTargetHandler<T, K>};\nexport type MessageGeneralHandler<T extends MessageDictionary, K extends MessageType<T>> = (\n    type: K,\n    data: MessageData<T, K>,\n    sender: MessageSender\n) => any;\n\nexport interface MessageBody<T extends MessageDictionary, K extends MessageType<T>> {\n    id: string;\n    type: K;\n    data: MessageData<T, K>;\n    timestamp: number;\n}\n\nexport interface MessageProvider<T extends MessageDictionary, TOptions = void> {\n    send<K extends MessageType<T>>(\n        type: K,\n        data: MessageData<T, K>,\n        options?: TOptions\n    ): Promise<MessageResponse<T, K>>;\n\n    watch<K extends MessageType<T>>(type: K, handler: MessageTargetHandler<T, K>): () => void;\n\n    watch(map: MessageMapHandler<T>): () => void;\n\n    watch<K extends MessageType<T>>(general: MessageGeneralHandler<T, K>): () => void;\n}\n\nexport interface MessageHandler<T extends MessageDictionary> {\n    run(\n        type: MessageType<T>,\n        data: MessageData<T, MessageType<T>>,\n        sender: MessageSender\n    ): MessageResponse<T, MessageType<T>> | undefined | null;\n}\n"],"mappings":"AAAO,MAAM,mBAAmB;AAEzB,MAAM,uBAAuB;AAE7B,MAAM,wBAAwB;","names":[]}
+{"version":3,"sources":["../../src/types/message.ts"],"sourcesContent":["export const MessageGlobalKey = \"adnbnMessage\";\n\nexport const MessageTypeSeparator = \":\";\n\nexport const MessageSenderProperty = \"$sender\";\n\nexport const MessageResultEnvelopeProperty = \"__adnbnEnvelope\";\n\nexport type MessageSender = chrome.runtime.MessageSender;\n\nexport type MessageSendOptions = number | {tabId: number; frameId?: number; documentId?: string};\n\nexport interface MessageDictionary {\n    [key: string]: (data: any) => any;\n}\n\nexport interface MessageSenderAware {\n    readonly [MessageSenderProperty]?: MessageSender;\n}\n\nexport interface MessageError {\n    name: string;\n    message: string;\n    stack?: string;\n}\n\nexport type MessageResult<T = any> =\n    | {readonly [MessageResultEnvelopeProperty]: true; ok: true; payload: T}\n    | {readonly [MessageResultEnvelopeProperty]: true; ok: false; error: MessageError};\n\nexport type MessageType<T extends MessageDictionary> = Extract<keyof T, string>;\nexport type MessageData<T extends MessageDictionary, K extends MessageType<T>> = Parameters<T[K]>[0];\nexport type MessageResponse<T extends MessageDictionary, K extends MessageType<T>> = ReturnType<T[K]>;\n\nexport type MessageTargetHandler<T extends MessageDictionary, K extends MessageType<T>> = (\n    data: MessageData<T, K>,\n    sender: MessageSender\n) => MessageResponse<T, K>;\nexport type MessageMapHandler<T extends MessageDictionary> = {[K in MessageType<T>]?: MessageTargetHandler<T, K>};\nexport type MessageGeneralHandler<T extends MessageDictionary, K extends MessageType<T>> = (\n    type: K,\n    data: MessageData<T, K>,\n    sender: MessageSender\n) => any;\n\nexport interface MessageBody<T extends MessageDictionary, K extends MessageType<T>> {\n    id: string;\n    type: K;\n    data: MessageData<T, K>;\n    timestamp: number;\n}\n\nexport interface MessageProvider<T extends MessageDictionary, TOptions = void> {\n    send<K extends MessageType<T>>(\n        type: K,\n        data: MessageData<T, K>,\n        options?: TOptions\n    ): Promise<MessageResponse<T, K>>;\n\n    watch<K extends MessageType<T>>(type: K, handler: MessageTargetHandler<T, K>): () => void;\n\n    watch(map: MessageMapHandler<T>): () => void;\n\n    watch<K extends MessageType<T>>(general: MessageGeneralHandler<T, K>): () => void;\n}\n\nexport interface MessageHandler<T extends MessageDictionary> {\n    run(\n        type: MessageType<T>,\n        data: MessageData<T, MessageType<T>>,\n        sender: MessageSender\n    ): MessageResponse<T, MessageType<T>> | undefined | null;\n}\n"],"mappings":"AAAO,MAAM,mBAAmB;AAEzB,MAAM,uBAAuB;AAE7B,MAAM,wBAAwB;AAE9B,MAAM,gCAAgC;","names":[]}

package/dist/types/offscreen.d.ts

@@ -1,6 +1,7 @@
 import { TransportConfig, TransportDefinition, TransportType } from "./transport.js";
 import { ViewOptions } from "./view.js";
 import { Awaiter } from "./helpers.js";
+import { CspOptions } from "./csp.js";
 export declare const OffscreenGlobalKey = "adnbnOffscreen";
 export declare const OffscreenGlobalAccess = "adnbnOffscreenAccess";
 export declare const OffscreenBridgeReadyMessageType = "adnbn:offscreen:ready";
@@ -40,7 +41,7 @@ export interface OffscreenConfig extends TransportConfig {
     reasons?: `${OffscreenReason}` | `${OffscreenReason}`[] | OffscreenReason | OffscreenReason[];
     justification?: string;
 }
-export type OffscreenOptions = OffscreenConfig & ViewOptions;
+export type OffscreenOptions = OffscreenConfig & CspOptions & ViewOptions;
 export type OffscreenEntrypointOptions = Partial<OffscreenOptions>;
 export type OffscreenMainHandler<T extends TransportType> = (offscreen: T, options: OffscreenEntrypointOptions) => Awaiter<void>;
 export interface OffscreenDefinition<T extends TransportType> extends TransportDefinition<OffscreenOptions, T>, OffscreenEntrypointOptions {

package/dist/types/offscreen.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/offscreen.ts"],"sourcesContent":["import {TransportConfig, TransportDefinition, TransportType} from \"@typing/transport\";\nimport {ViewOptions} from \"@typing/view\";\nimport {Awaiter} from \"@typing/helpers\";\n\nexport const OffscreenGlobalKey = \"adnbnOffscreen\";\nexport const OffscreenGlobalAccess = \"adnbnOffscreenAccess\";\nexport const OffscreenBridgeReadyMessageType = \"adnbn:offscreen:ready\";\n\nexport enum OffscreenReason {\n    /** A reason used for testing purposes only. */\n    Testing = \"TESTING\",\n    /** The offscreen document is responsible for playing audio. */\n    AudioPlayback = \"AUDIO_PLAYBACK\",\n    /** The offscreen document needs to embed and script an iframe in order to modify the iframe's content. */\n    IframeScripting = \"IFRAME_SCRIPTING\",\n    /** The offscreen document needs to embed an iframe and scrape its DOM to extract information. */\n    DOMScraping = \"DOM_SCRAPING\",\n    /** The offscreen document needs to interact with Blob objects (including URL.createObjectURL()). */\n    Blobs = \"BLOBS\",\n    /** The offscreen document needs to use the DOMParser API. */\n    DOMParser = \"DOM_PARSER\",\n    /** The offscreen document needs to interact with media streams from user media (e.g. getUserMedia()). */\n    UserMedia = \"USER_MEDIA\",\n    /** The offscreen document needs to interact with media streams from display media (e.g. getDisplayMedia()). */\n    DisplayMedia = \"DISPLAY_MEDIA\",\n    /** The offscreen document needs to use WebRTC APIs. */\n    WebRTC = \"WEB_RTC\",\n    /** The offscreen document needs to interact with the clipboard APIs(e.g. Navigator.clipboard). */\n    Clipboard = \"CLIPBOARD\",\n    /** Specifies that the offscreen document needs access to localStorage. */\n    LocalStorage = \"LOCAL_STORAGE\",\n    /** Specifies that the offscreen document needs to spawn workers. */\n    Workers = \"WORKERS\",\n    /** Specifies that the offscreen document needs to use navigator.getBattery. */\n    BatteryStatus = \"BATTERY_STATUS\",\n    /** Specifies that the offscreen document needs to use window.matchMedia. */\n    MatchMedia = \"MATCH_MEDIA\",\n    /** Specifies that the offscreen document needs to use navigator.geolocation. */\n    Geolocation = \"GEOLOCATION\",\n}\n\nexport interface OffscreenConfig extends TransportConfig {\n    reasons?: `${OffscreenReason}` | `${OffscreenReason}`[] | OffscreenReason | OffscreenReason[];\n    justification?: string;\n}\n\nexport type OffscreenOptions = OffscreenConfig & ViewOptions;\n\nexport type OffscreenEntrypointOptions = Partial<OffscreenOptions>;\n\nexport type OffscreenMainHandler<T extends TransportType> = (\n    offscreen: T,\n    options: OffscreenEntrypointOptions\n) => Awaiter<void>;\n\nexport interface OffscreenDefinition<T extends TransportType>\n    extends TransportDefinition<OffscreenOptions, T>, OffscreenEntrypointOptions {\n    main?: OffscreenMainHandler<T>;\n}\n\nexport type OffscreenUnresolvedDefinition<T extends TransportType> = Partial<OffscreenDefinition<T>>;\n"],"mappings":"AAIO,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB;AAC9B,MAAM,kCAAkC;AAExC,IAAK,kBAAL,kBAAKA,qBAAL;AAEH,EAAAA,iBAAA,aAAU;AAEV,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,qBAAkB;AAElB,EAAAA,iBAAA,iBAAc;AAEd,EAAAA,iBAAA,WAAQ;AAER,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,kBAAe;AAEf,EAAAA,iBAAA,YAAS;AAET,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,kBAAe;AAEf,EAAAA,iBAAA,aAAU;AAEV,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,gBAAa;AAEb,EAAAA,iBAAA,iBAAc;AA9BN,SAAAA;AAAA,GAAA;","names":["OffscreenReason"]}
+{"version":3,"sources":["../../src/types/offscreen.ts"],"sourcesContent":["import {TransportConfig, TransportDefinition, TransportType} from \"@typing/transport\";\nimport {ViewOptions} from \"@typing/view\";\nimport {Awaiter} from \"@typing/helpers\";\nimport {CspOptions} from \"@typing/csp\";\n\nexport const OffscreenGlobalKey = \"adnbnOffscreen\";\nexport const OffscreenGlobalAccess = \"adnbnOffscreenAccess\";\nexport const OffscreenBridgeReadyMessageType = \"adnbn:offscreen:ready\";\n\nexport enum OffscreenReason {\n    /** A reason used for testing purposes only. */\n    Testing = \"TESTING\",\n    /** The offscreen document is responsible for playing audio. */\n    AudioPlayback = \"AUDIO_PLAYBACK\",\n    /** The offscreen document needs to embed and script an iframe in order to modify the iframe's content. */\n    IframeScripting = \"IFRAME_SCRIPTING\",\n    /** The offscreen document needs to embed an iframe and scrape its DOM to extract information. */\n    DOMScraping = \"DOM_SCRAPING\",\n    /** The offscreen document needs to interact with Blob objects (including URL.createObjectURL()). */\n    Blobs = \"BLOBS\",\n    /** The offscreen document needs to use the DOMParser API. */\n    DOMParser = \"DOM_PARSER\",\n    /** The offscreen document needs to interact with media streams from user media (e.g. getUserMedia()). */\n    UserMedia = \"USER_MEDIA\",\n    /** The offscreen document needs to interact with media streams from display media (e.g. getDisplayMedia()). */\n    DisplayMedia = \"DISPLAY_MEDIA\",\n    /** The offscreen document needs to use WebRTC APIs. */\n    WebRTC = \"WEB_RTC\",\n    /** The offscreen document needs to interact with the clipboard APIs(e.g. Navigator.clipboard). */\n    Clipboard = \"CLIPBOARD\",\n    /** Specifies that the offscreen document needs access to localStorage. */\n    LocalStorage = \"LOCAL_STORAGE\",\n    /** Specifies that the offscreen document needs to spawn workers. */\n    Workers = \"WORKERS\",\n    /** Specifies that the offscreen document needs to use navigator.getBattery. */\n    BatteryStatus = \"BATTERY_STATUS\",\n    /** Specifies that the offscreen document needs to use window.matchMedia. */\n    MatchMedia = \"MATCH_MEDIA\",\n    /** Specifies that the offscreen document needs to use navigator.geolocation. */\n    Geolocation = \"GEOLOCATION\",\n}\n\nexport interface OffscreenConfig extends TransportConfig {\n    reasons?: `${OffscreenReason}` | `${OffscreenReason}`[] | OffscreenReason | OffscreenReason[];\n    justification?: string;\n}\n\nexport type OffscreenOptions = OffscreenConfig & CspOptions & ViewOptions;\n\nexport type OffscreenEntrypointOptions = Partial<OffscreenOptions>;\n\nexport type OffscreenMainHandler<T extends TransportType> = (\n    offscreen: T,\n    options: OffscreenEntrypointOptions\n) => Awaiter<void>;\n\nexport interface OffscreenDefinition<T extends TransportType>\n    extends TransportDefinition<OffscreenOptions, T>, OffscreenEntrypointOptions {\n    main?: OffscreenMainHandler<T>;\n}\n\nexport type OffscreenUnresolvedDefinition<T extends TransportType> = Partial<OffscreenDefinition<T>>;\n"],"mappings":"AAKO,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB;AAC9B,MAAM,kCAAkC;AAExC,IAAK,kBAAL,kBAAKA,qBAAL;AAEH,EAAAA,iBAAA,aAAU;AAEV,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,qBAAkB;AAElB,EAAAA,iBAAA,iBAAc;AAEd,EAAAA,iBAAA,WAAQ;AAER,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,kBAAe;AAEf,EAAAA,iBAAA,YAAS;AAET,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,kBAAe;AAEf,EAAAA,iBAAA,aAAU;AAEV,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,gBAAa;AAEb,EAAAA,iBAAA,iBAAc;AA9BN,SAAAA;AAAA,GAAA;","names":["OffscreenReason"]}

package/dist/types/page.d.ts

@@ -1,8 +1,9 @@
 import { ViewDefinition, ViewOptions } from "./view.js";
+import { CspOptions } from "./csp.js";
 export interface PageConfig {
     name?: string;
     matches?: string[];
 }
-export type PageEntrypointOptions = PageConfig & ViewOptions;
+export type PageEntrypointOptions = PageConfig & CspOptions & ViewOptions;
 export type PageProps = PageEntrypointOptions;
 export type PageDefinition = PageEntrypointOptions & ViewDefinition<PageProps>;

package/dist/types/plugin.d.ts

@@ -73,6 +73,7 @@ export interface Plugin extends PluginName {
     page?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     popup?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     relay?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
+    sandbox?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     service?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     sidebar?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     offscreen?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
@@ -86,7 +87,7 @@ export type PluginHandlerCallback<O, T = void> = {
     (options: O): Awaiter<T>;
 };
 export type PluginHandlerKeys = keyof Omit<Plugin, "name">;
-export type PluginEntrypointKeys = keyof Pick<Plugin, "background" | "command" | "content" | "page" | "popup" | "relay" | "service" | "sidebar" | "offscreen">;
+export type PluginEntrypointKeys = keyof Pick<Plugin, "background" | "command" | "content" | "page" | "popup" | "relay" | "sandbox" | "service" | "sidebar" | "offscreen">;
 export type PluginAssetKeys = keyof Pick<Plugin, "icon" | "locale">;
 export type PluginHandlerType<T extends Plugin[PluginHandlerKeys]> = T extends PluginHandlerCallback<infer O, infer R> ? {
     options: O;

package/dist/types/popup.d.ts

@@ -1,8 +1,9 @@
 import { ViewDefinition, ViewOptions } from "./view.js";
+import { CspOptions } from "./csp.js";
 export interface PopupConfig {
     icon?: string;
     apply?: boolean;
 }
-export type PopupEntrypointOptions = PopupConfig & ViewOptions;
+export type PopupEntrypointOptions = PopupConfig & CspOptions & ViewOptions;
 export type PopupProps = PopupEntrypointOptions;
 export type PopupDefinition = PopupEntrypointOptions & ViewDefinition<PopupProps>;

package/dist/types/sandbox.d.ts

@@ -0,0 +1,97 @@
+import { TransportConfig, TransportDefinition, TransportType } from "./transport.js";
+import { ViewOptions } from "./view.js";
+import { Awaiter } from "./helpers.js";
+import { MessageError, MessageSender } from "./message.js";
+export declare const SandboxGlobalKey = "adnbnSandbox";
+export declare const SandboxGlobalAccess = "adnbnSandboxAccess";
+export declare const SandboxNamespace = "adnbn:sandbox";
+export declare const SandboxReadyMessageType = "adnbn:sandbox:ready";
+export declare const SandboxRequestMessageType = "adnbn:sandbox:request";
+export declare const SandboxResponseMessageType = "adnbn:sandbox:response";
+export declare enum SandboxAllow {
+    Forms = "forms",
+    Popups = "popups",
+    Modals = "modals",
+    Downloads = "downloads",
+    PointerLock = "pointer-lock",
+    TopNavigationByUserActivation = "top-navigation-by-user-activation"
+}
+export declare enum SandboxSource {
+    Self = "'self'",
+    None = "'none'",
+    Data = "data:",
+    Blob = "blob:",
+    UnsafeInline = "'unsafe-inline'"
+}
+export interface SandboxCspSources {
+    connect?: Array<SandboxSource | `${SandboxSource}`>;
+    image?: Array<SandboxSource | `${SandboxSource}`>;
+    style?: Array<SandboxSource | `${SandboxSource}`>;
+    font?: Array<SandboxSource | `${SandboxSource}`>;
+    media?: Array<SandboxSource | `${SandboxSource}`>;
+    worker?: Array<SandboxSource | `${SandboxSource}`>;
+    child?: Array<SandboxSource | `${SandboxSource}`>;
+}
+export interface SandboxCspConfig {
+    eval?: boolean;
+    inline?: boolean;
+    allow?: Array<SandboxAllow | `${SandboxAllow}`>;
+    sources?: SandboxCspSources;
+}
+export interface SandboxCspOptions {
+    csp?: SandboxCspConfig;
+}
+export interface SandboxConfig extends TransportConfig {
+    readyTimeout?: number;
+    requestTimeout?: number;
+    removeOnRequestTimeout?: boolean;
+}
+export type SandboxOptions = SandboxConfig & SandboxCspOptions & ViewOptions;
+export type SandboxEntrypointOptions = Partial<SandboxOptions>;
+export type SandboxMainHandler<T extends TransportType> = (sandbox: T, options: SandboxEntrypointOptions) => Awaiter<void>;
+export interface SandboxDefinition<T extends TransportType> extends TransportDefinition<SandboxOptions, T>, SandboxEntrypointOptions {
+    main?: SandboxMainHandler<T>;
+}
+export type SandboxUnresolvedDefinition<T extends TransportType> = Partial<SandboxDefinition<T>>;
+export type SandboxParameters = {
+    url: string;
+} & Pick<SandboxConfig, "readyTimeout" | "requestTimeout" | "removeOnRequestTimeout">;
+export interface SandboxReadyMessage {
+    type: typeof SandboxReadyMessageType;
+    channel: string;
+    name: string;
+}
+export interface SandboxRequestMessage {
+    type: typeof SandboxRequestMessageType;
+    channel: string;
+    name: string;
+    requestId: string;
+    path?: string;
+    args: any[];
+}
+export interface SandboxResponseMessage {
+    type: typeof SandboxResponseMessageType;
+    channel: string;
+    name: string;
+    requestId: string;
+    ok: boolean;
+    payload?: any;
+    error?: MessageError;
+}
+export type SandboxEnvelope = SandboxRequestMessage | SandboxResponseMessage;
+/**
+ * Internal seam for the sandbox wire. Lives below `SandboxMessage`, invisible to callers.
+ *
+ * - `connect` establishes the channel (host: create the iframe and await the ready
+ *   handshake; sandbox/in-memory: resolves immediately). Must be idempotent — concurrent
+ *   callers share one connection.
+ * - `post` sends one already-built envelope to the peer.
+ * - `subscribe` attaches exactly one underlying listener and returns its remover.
+ * - `dispose` tears the channel down (remove listener, drop the iframe).
+ */
+export interface SandboxPort {
+    connect(): Promise<void>;
+    post(message: SandboxEnvelope): void;
+    subscribe(onMessage: (message: SandboxEnvelope, sender: MessageSender) => void): () => void;
+    dispose(): void;
+}

package/dist/types/sandbox.js

@@ -0,0 +1,34 @@
+const SandboxGlobalKey = "adnbnSandbox";
+const SandboxGlobalAccess = "adnbnSandboxAccess";
+const SandboxNamespace = "adnbn:sandbox";
+const SandboxReadyMessageType = `${SandboxNamespace}:ready`;
+const SandboxRequestMessageType = `${SandboxNamespace}:request`;
+const SandboxResponseMessageType = `${SandboxNamespace}:response`;
+var SandboxAllow = /* @__PURE__ */ ((SandboxAllow2) => {
+  SandboxAllow2["Forms"] = "forms";
+  SandboxAllow2["Popups"] = "popups";
+  SandboxAllow2["Modals"] = "modals";
+  SandboxAllow2["Downloads"] = "downloads";
+  SandboxAllow2["PointerLock"] = "pointer-lock";
+  SandboxAllow2["TopNavigationByUserActivation"] = "top-navigation-by-user-activation";
+  return SandboxAllow2;
+})(SandboxAllow || {});
+var SandboxSource = /* @__PURE__ */ ((SandboxSource2) => {
+  SandboxSource2["Self"] = "'self'";
+  SandboxSource2["None"] = "'none'";
+  SandboxSource2["Data"] = "data:";
+  SandboxSource2["Blob"] = "blob:";
+  SandboxSource2["UnsafeInline"] = "'unsafe-inline'";
+  return SandboxSource2;
+})(SandboxSource || {});
+export {
+  SandboxAllow,
+  SandboxGlobalAccess,
+  SandboxGlobalKey,
+  SandboxNamespace,
+  SandboxReadyMessageType,
+  SandboxRequestMessageType,
+  SandboxResponseMessageType,
+  SandboxSource
+};
+//# sourceMappingURL=sandbox.js.map

package/dist/types/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/sandbox.ts"],"sourcesContent":["import {TransportConfig, TransportDefinition, TransportType} from \"@typing/transport\";\nimport {ViewOptions} from \"@typing/view\";\nimport {Awaiter} from \"@typing/helpers\";\nimport {MessageError, MessageSender} from \"@typing/message\";\n\nexport const SandboxGlobalKey = \"adnbnSandbox\";\nexport const SandboxGlobalAccess = \"adnbnSandboxAccess\";\nexport const SandboxNamespace = \"adnbn:sandbox\";\nexport const SandboxReadyMessageType = `${SandboxNamespace}:ready`;\nexport const SandboxRequestMessageType = `${SandboxNamespace}:request`;\nexport const SandboxResponseMessageType = `${SandboxNamespace}:response`;\n\nexport enum SandboxAllow {\n    Forms = \"forms\",\n    Popups = \"popups\",\n    Modals = \"modals\",\n    Downloads = \"downloads\",\n    PointerLock = \"pointer-lock\",\n    TopNavigationByUserActivation = \"top-navigation-by-user-activation\",\n}\n\nexport enum SandboxSource {\n    Self = \"'self'\",\n    None = \"'none'\",\n    Data = \"data:\",\n    Blob = \"blob:\",\n    UnsafeInline = \"'unsafe-inline'\",\n}\n\nexport interface SandboxCspSources {\n    connect?: Array<SandboxSource | `${SandboxSource}`>;\n    image?: Array<SandboxSource | `${SandboxSource}`>;\n    style?: Array<SandboxSource | `${SandboxSource}`>;\n    font?: Array<SandboxSource | `${SandboxSource}`>;\n    media?: Array<SandboxSource | `${SandboxSource}`>;\n    worker?: Array<SandboxSource | `${SandboxSource}`>;\n    child?: Array<SandboxSource | `${SandboxSource}`>;\n}\n\nexport interface SandboxCspConfig {\n    eval?: boolean;\n    inline?: boolean;\n    allow?: Array<SandboxAllow | `${SandboxAllow}`>;\n    sources?: SandboxCspSources;\n}\n\nexport interface SandboxCspOptions {\n    csp?: SandboxCspConfig;\n}\n\nexport interface SandboxConfig extends TransportConfig {\n    readyTimeout?: number;\n    requestTimeout?: number;\n    removeOnRequestTimeout?: boolean;\n}\n\nexport type SandboxOptions = SandboxConfig & SandboxCspOptions & ViewOptions;\n\nexport type SandboxEntrypointOptions = Partial<SandboxOptions>;\n\nexport type SandboxMainHandler<T extends TransportType> = (\n    sandbox: T,\n    options: SandboxEntrypointOptions\n) => Awaiter<void>;\n\nexport interface SandboxDefinition<T extends TransportType>\n    extends TransportDefinition<SandboxOptions, T>, SandboxEntrypointOptions {\n    main?: SandboxMainHandler<T>;\n}\n\nexport type SandboxUnresolvedDefinition<T extends TransportType> = Partial<SandboxDefinition<T>>;\n\nexport type SandboxParameters = {url: string} & Pick<\n    SandboxConfig,\n    \"readyTimeout\" | \"requestTimeout\" | \"removeOnRequestTimeout\"\n>;\n\nexport interface SandboxReadyMessage {\n    type: typeof SandboxReadyMessageType;\n    channel: string;\n    name: string;\n}\n\nexport interface SandboxRequestMessage {\n    type: typeof SandboxRequestMessageType;\n    channel: string;\n    name: string;\n    requestId: string;\n    path?: string;\n    args: any[];\n}\n\nexport interface SandboxResponseMessage {\n    type: typeof SandboxResponseMessageType;\n    channel: string;\n    name: string;\n    requestId: string;\n    ok: boolean;\n    payload?: any;\n    error?: MessageError;\n}\n\nexport type SandboxEnvelope = SandboxRequestMessage | SandboxResponseMessage;\n\n/**\n * Internal seam for the sandbox wire. Lives below `SandboxMessage`, invisible to callers.\n *\n * - `connect` establishes the channel (host: create the iframe and await the ready\n *   handshake; sandbox/in-memory: resolves immediately). Must be idempotent — concurrent\n *   callers share one connection.\n * - `post` sends one already-built envelope to the peer.\n * - `subscribe` attaches exactly one underlying listener and returns its remover.\n * - `dispose` tears the channel down (remove listener, drop the iframe).\n */\nexport interface SandboxPort {\n    connect(): Promise<void>;\n\n    post(message: SandboxEnvelope): void;\n\n    subscribe(onMessage: (message: SandboxEnvelope, sender: MessageSender) => void): () => void;\n\n    dispose(): void;\n}\n"],"mappings":"AAKO,MAAM,mBAAmB;AACzB,MAAM,sBAAsB;AAC5B,MAAM,mBAAmB;AACzB,MAAM,0BAA0B,GAAG,gBAAgB;AACnD,MAAM,4BAA4B,GAAG,gBAAgB;AACrD,MAAM,6BAA6B,GAAG,gBAAgB;AAEtD,IAAK,eAAL,kBAAKA,kBAAL;AACH,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,eAAY;AACZ,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,mCAAgC;AANxB,SAAAA;AAAA,GAAA;AASL,IAAK,gBAAL,kBAAKC,mBAAL;AACH,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,kBAAe;AALP,SAAAA;AAAA,GAAA;","names":["SandboxAllow","SandboxSource"]}

package/dist/types/sidebar.d.ts

@@ -1,10 +1,11 @@
 import { ViewDefinition, ViewOptions } from "./view.js";
 import { Browser } from "./browser.js";
+import { CspOptions } from "./csp.js";
 export declare const SidebarAlternativeBrowsers: ReadonlySet<Browser>;
 export interface SidebarConfig {
     icon?: string;
     apply?: boolean;
 }
-export type SidebarEntrypointOptions = SidebarConfig & ViewOptions;
+export type SidebarEntrypointOptions = SidebarConfig & CspOptions & ViewOptions;
 export type SidebarProps = SidebarEntrypointOptions;
 export type SidebarDefinition = SidebarEntrypointOptions & ViewDefinition<SidebarProps>;

package/dist/types/sidebar.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/sidebar.ts"],"sourcesContent":["import {ViewDefinition, ViewOptions} from \"@typing/view\";\nimport {Browser} from \"@typing/browser\";\n\nexport const SidebarAlternativeBrowsers: ReadonlySet<Browser> = new Set([Browser.Opera, Browser.Firefox]);\n\nexport interface SidebarConfig {\n    icon?: string;\n    apply?: boolean;\n}\n\nexport type SidebarEntrypointOptions = SidebarConfig & ViewOptions;\n\nexport type SidebarProps = SidebarEntrypointOptions;\n\nexport type SidebarDefinition = SidebarEntrypointOptions & ViewDefinition<SidebarProps>;\n"],"mappings":"AACA,SAAQ,eAAc;AAEf,MAAM,6BAAmD,oBAAI,IAAI,CAAC,QAAQ,OAAO,QAAQ,OAAO,CAAC;","names":[]}
+{"version":3,"sources":["../../src/types/sidebar.ts"],"sourcesContent":["import {ViewDefinition, ViewOptions} from \"@typing/view\";\nimport {Browser} from \"@typing/browser\";\nimport {CspOptions} from \"@typing/csp\";\n\nexport const SidebarAlternativeBrowsers: ReadonlySet<Browser> = new Set([Browser.Opera, Browser.Firefox]);\n\nexport interface SidebarConfig {\n    icon?: string;\n    apply?: boolean;\n}\n\nexport type SidebarEntrypointOptions = SidebarConfig & CspOptions & ViewOptions;\n\nexport type SidebarProps = SidebarEntrypointOptions;\n\nexport type SidebarDefinition = SidebarEntrypointOptions & ViewDefinition<SidebarProps>;\n"],"mappings":"AACA,SAAQ,eAAc;AAGf,MAAM,6BAAmD,oBAAI,IAAI,CAAC,QAAQ,OAAO,QAAQ,OAAO,CAAC;","names":[]}

package/dist/types/transport.d.ts

@@ -22,9 +22,13 @@ export interface TransportMessageData {
     path?: string;
     args: any[];
 }
-export interface TransportMessage {
+export interface TransportReceiver {
+    watch(handler: (data: TransportMessageData, sender: MessageSender) => any): () => void;
+}
+export interface TransportSender {
     send(data: TransportMessageData, options?: MessageSendOptions): any;
-    watch(handler: (data: TransportMessageData, sender: MessageSender) => any): void;
+}
+export interface TransportMessage extends TransportSender, TransportReceiver {
 }
 export interface TransportProvider<T extends TransportType> {
     get(): T;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adnbn",
   "type": "module",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Addon Bone - Cross-browser web extension framework with shared code base",
   "homepage": "https://addonbone.com",
   "author": "Anjey Tsibylskij (https://github.com/atldays)",
@@ -84,6 +84,10 @@
       "types": "./dist/relay/index.d.ts",
       "default": "./dist/relay/index.js"
     },
+    "./sandbox": {
+      "types": "./dist/sandbox/index.d.ts",
+      "default": "./dist/sandbox/index.js"
+    },
     "./service": {
       "types": "./dist/service/index.d.ts",
       "default": "./dist/service/index.js"
@@ -142,6 +146,8 @@
     "mini-css-extract-plugin": "^2.9.2",
     "nanoid": "^5.1.4",
     "pluralize": "^8.0.0",
+    "postcss": "^8.5.15",
+    "postcss-scss": "^4.0.9",
     "rspack-plugin-virtual-module": "^1.0.1",
     "sass": "^1.83.4",
     "sass-loader": "^16.0.4",

package/dist/cli/plugins/style.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("../../main/plugin.js").PluginDefinition<[]>;
-export default _default;

package/dist/cli/plugins/style.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/cli/plugins/style.ts"],"sourcesContent":["import _ from \"lodash\";\nimport path from \"path\";\nimport fs from \"fs\";\nimport {Configuration as RspackConfig, CssExtractRspackPlugin, RuleSetUse, RuleSetUseItem} from \"@rspack/core\";\n\nimport {definePlugin} from \"@main/plugin\";\n\nimport {appFilenameResolver} from \"@cli/bundler\";\n\nimport {getAppSourcePath, getResolvePath, getSharedPath} from \"@cli/resolvers/path\";\n\nimport {ReadonlyConfig} from \"@typing/config\";\nimport {toPosix} from \"@cli/utils/path\";\n\n// prettier-ignore\nconst styleMergerLoader =\n    (config: ReadonlyConfig) =>\n        (sharedStyle: string, sharedPath: string): string | void => {\n            const sharedDir = getResolvePath(getSharedPath(config));\n\n            if (sharedPath.startsWith(sharedDir)) {\n                const relativePath = path.relative(sharedDir, sharedPath);\n\n                const appDir = getResolvePath(getAppSourcePath(config));\n                const appPath = getResolvePath(path.join(appDir, relativePath));\n\n                if (fs.existsSync(appPath)) {\n                    try {\n                        let appStyle = fs.readFileSync(appPath, \"utf8\");\n\n                        appStyle = appStyle.replace(/url\\((['\"]?)(.*?)\\1\\)/g, (match, quote, filePath) => {\n                            if (\n                                filePath.startsWith(\"/\") ||\n                                filePath.startsWith(\"http\") ||\n                                filePath.startsWith(\"data:\")\n                            ) {\n                                return match;\n                            }\n\n                            const cssDir = path.dirname(appPath);\n                            const assetAbs = path.resolve(cssDir, filePath);\n\n                            const sharedFileDir = path.dirname(sharedPath);\n\n                            const relativeToSharedFile = path.relative(sharedFileDir, assetAbs);\n\n                            return `url(\"${toPosix(relativeToSharedFile)}\")`;\n                        });\n\n                        return sharedStyle + \"\\n\" + appStyle;\n                    } catch (error) {\n                        console.error(error);\n                    }\n                }\n            }\n        };\n\nexport default definePlugin(() => {\n    return {\n        name: \"adnbn:styles\",\n        bundler: ({config}) => {\n            const {app, cssDir, cssFilename, cssIdentName, mergeStyles} = config;\n\n            const filename = appFilenameResolver(app, cssFilename, cssDir);\n            const kebabApp = _.kebabCase(app);\n\n            const createSassRuleSet = (rule: RuleSetUseItem): RuleSetUse => {\n                const rules: RuleSetUse = [CssExtractRspackPlugin.loader, rule, \"sass-loader\"];\n\n                if (mergeStyles) {\n                    rules.push({\n                        loader: \"source-modifier-loader\",\n                        options: {\n                            modify: styleMergerLoader(config),\n                        },\n                    });\n                }\n\n                return rules;\n            };\n\n            return {\n                resolve: {\n                    extensions: [\".css\", \".scss\"],\n                },\n                plugins: [\n                    new CssExtractRspackPlugin({\n                        filename,\n                        chunkFilename: filename,\n                    }),\n                ],\n                module: {\n                    rules: [\n                        {\n                            test: /\\.(scss|css)$/,\n                            type: \"javascript/auto\",\n                            oneOf: [\n                                {\n                                    resourceQuery: /asis/,\n                                    use: createSassRuleSet({\n                                        loader: \"css-loader\",\n                                        options: {\n                                            esModule: true,\n                                            modules: false,\n                                        },\n                                    }),\n                                },\n                                {\n                                    use: createSassRuleSet({\n                                        loader: \"css-loader\",\n                                        options: {\n                                            esModule: true,\n                                            modules: {\n                                                exportLocalsConvention: \"as-is\",\n                                                namedExport: false,\n                                                localIdentName: cssIdentName.replaceAll(\"[app]\", kebabApp),\n                                                localIdentHashSalt: kebabApp,\n                                            },\n                                        },\n                                    }),\n                                },\n                            ],\n                        },\n                    ],\n                },\n            } satisfies RspackConfig;\n        },\n    };\n});\n"],"mappings":"AAAA,OAAO,OAAO;AACd,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,SAAuC,8BAAyD;AAEhG,SAAQ,oBAAmB;AAE3B,SAAQ,2BAA0B;AAElC,SAAQ,kBAAkB,gBAAgB,qBAAoB;AAG9D,SAAQ,eAAc;AAGtB,MAAM,oBACF,CAAC,WACG,CAAC,aAAqB,eAAsC;AACxD,QAAM,YAAY,eAAe,cAAc,MAAM,CAAC;AAEtD,MAAI,WAAW,WAAW,SAAS,GAAG;AAClC,UAAM,eAAe,KAAK,SAAS,WAAW,UAAU;AAExD,UAAM,SAAS,eAAe,iBAAiB,MAAM,CAAC;AACtD,UAAM,UAAU,eAAe,KAAK,KAAK,QAAQ,YAAY,CAAC;AAE9D,QAAI,GAAG,WAAW,OAAO,GAAG;AACxB,UAAI;AACA,YAAI,WAAW,GAAG,aAAa,SAAS,MAAM;AAE9C,mBAAW,SAAS,QAAQ,0BAA0B,CAAC,OAAO,OAAO,aAAa;AAC9E,cACI,SAAS,WAAW,GAAG,KACvB,SAAS,WAAW,MAAM,KAC1B,SAAS,WAAW,OAAO,GAC7B;AACE,mBAAO;AAAA,UACX;AAEA,gBAAM,SAAS,KAAK,QAAQ,OAAO;AACnC,gBAAM,WAAW,KAAK,QAAQ,QAAQ,QAAQ;AAE9C,gBAAM,gBAAgB,KAAK,QAAQ,UAAU;AAE7C,gBAAM,uBAAuB,KAAK,SAAS,eAAe,QAAQ;AAElE,iBAAO,QAAQ,QAAQ,oBAAoB,CAAC;AAAA,QAChD,CAAC;AAED,eAAO,cAAc,OAAO;AAAA,MAChC,SAAS,OAAO;AACZ,gBAAQ,MAAM,KAAK;AAAA,MACvB;AAAA,IACJ;AAAA,EACJ;AACJ;AAER,IAAO,gBAAQ,aAAa,MAAM;AAC9B,SAAO;AAAA,IACH,MAAM;AAAA,IACN,SAAS,CAAC,EAAC,OAAM,MAAM;AACnB,YAAM,EAAC,KAAK,QAAQ,aAAa,cAAc,YAAW,IAAI;AAE9D,YAAM,WAAW,oBAAoB,KAAK,aAAa,MAAM;AAC7D,YAAM,WAAW,EAAE,UAAU,GAAG;AAEhC,YAAM,oBAAoB,CAAC,SAAqC;AAC5D,cAAM,QAAoB,CAAC,uBAAuB,QAAQ,MAAM,aAAa;AAE7E,YAAI,aAAa;AACb,gBAAM,KAAK;AAAA,YACP,QAAQ;AAAA,YACR,SAAS;AAAA,cACL,QAAQ,kBAAkB,MAAM;AAAA,YACpC;AAAA,UACJ,CAAC;AAAA,QACL;AAEA,eAAO;AAAA,MACX;AAEA,aAAO;AAAA,QACH,SAAS;AAAA,UACL,YAAY,CAAC,QAAQ,OAAO;AAAA,QAChC;AAAA,QACA,SAAS;AAAA,UACL,IAAI,uBAAuB;AAAA,YACvB;AAAA,YACA,eAAe;AAAA,UACnB,CAAC;AAAA,QACL;AAAA,QACA,QAAQ;AAAA,UACJ,OAAO;AAAA,YACH;AAAA,cACI,MAAM;AAAA,cACN,MAAM;AAAA,cACN,OAAO;AAAA,gBACH;AAAA,kBACI,eAAe;AAAA,kBACf,KAAK,kBAAkB;AAAA,oBACnB,QAAQ;AAAA,oBACR,SAAS;AAAA,sBACL,UAAU;AAAA,sBACV,SAAS;AAAA,oBACb;AAAA,kBACJ,CAAC;AAAA,gBACL;AAAA,gBACA;AAAA,kBACI,KAAK,kBAAkB;AAAA,oBACnB,QAAQ;AAAA,oBACR,SAAS;AAAA,sBACL,UAAU;AAAA,sBACV,SAAS;AAAA,wBACL,wBAAwB;AAAA,wBACxB,aAAa;AAAA,wBACb,gBAAgB,aAAa,WAAW,SAAS,QAAQ;AAAA,wBACzD,oBAAoB;AAAA,sBACxB;AAAA,oBACJ;AAAA,kBACJ,CAAC;AAAA,gBACL;AAAA,cACJ;AAAA,YACJ;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACJ,CAAC;","names":[]}