@floegence/redevplugin-ui 0.1.6 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Floegence
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/contracts.gen.d.ts

@@ -0,0 +1,130 @@
+export declare const pluginUIProtocolVersion: "plugin-ui-v2";
+export declare const pluginHostProtocolVersion: "plugin-host-v2";
+export declare const bridgeSchemaVersion: "bridge-v2";
+export declare const tokenTicketSchemaVersion: "token-ticket-v2";
+export declare const redevPluginContractVersions: {
+    readonly plugin_ui_protocol_version: "plugin-ui-v2";
+    readonly plugin_host_protocol_version: "plugin-host-v2";
+    readonly rust_ipc_version: "rust-ipc-v1";
+    readonly wasm_abi_version: "redevplugin-wasm-worker-v1";
+    readonly manifest_schema_version: "manifest-v2";
+    readonly package_signature_schema_version: "package-signature-v1";
+    readonly release_metadata_schema_version: "release-metadata-v2";
+    readonly source_policy_schema_version: "source-policy-v1";
+    readonly source_revocations_schema_version: "source-revocations-v1";
+    readonly token_ticket_schema_version: "token-ticket-v2";
+    readonly bridge_schema_version: "bridge-v2";
+    readonly opaque_surface_document_schema_version: "opaque-surface-document-v1";
+    readonly opaque_surface_transport_schema_version: "opaque-surface-transport-v1";
+    readonly target_classifier_version: "target-classifier-v1";
+    readonly network_grant_schema_version: "network-grant-v1";
+    readonly plugin_platform_openapi_version: "plugin-platform-v2";
+    readonly compatibility_manifest_version: "redevplugin.compatibility.v2";
+    readonly compatibility_schema_version: "compatibility-manifest-v2";
+    readonly release_manifest_schema_version: "release-manifest-v2";
+    readonly worker_invocation_schema_version: "worker-invocation-v1";
+    readonly error_codes_schema_version: "error-codes-v1";
+    readonly contract_registry_version: "contract-registry-v1";
+};
+export type ReDevPluginContractArtifact = {
+    readonly id: string;
+    readonly path: string;
+    readonly version: string;
+    readonly sha256: string;
+};
+export declare const redevPluginContractArtifacts: readonly [{
+    readonly id: "plugin-platform-openapi";
+    readonly path: "spec/openapi/plugin-platform-v2.yaml";
+    readonly version: "plugin-platform-v2";
+    readonly sha256: "5d6006831c3e55cd9232ad8f9decdc932059193538f9f0ff2b3934d81a6b9aaa";
+}, {
+    readonly id: "manifest-schema";
+    readonly path: "spec/plugin/manifest-v2.schema.json";
+    readonly version: "manifest-v2";
+    readonly sha256: "ba2f782e0e47694484d4112da00d92689187e3bbd1e2f08aca2d9d680e554d51";
+}, {
+    readonly id: "package-signature-schema";
+    readonly path: "spec/plugin/package-signature-v1.schema.json";
+    readonly version: "package-signature-v1";
+    readonly sha256: "13951c0f6831ba28647774368c76a817868aeb7984628e2cf3dc4ad1b54f8284";
+}, {
+    readonly id: "release-metadata-schema";
+    readonly path: "spec/plugin/release-metadata-v2.schema.json";
+    readonly version: "release-metadata-v2";
+    readonly sha256: "6f985f9b0f009151b41e878c68f217058f7dd892f7f6471b2e5d24f54d858567";
+}, {
+    readonly id: "source-policy-schema";
+    readonly path: "spec/plugin/source-policy-v1.schema.json";
+    readonly version: "source-policy-v1";
+    readonly sha256: "b5f3094402bdbfdda1671b46e5f64a69ad7dc2ba9501030439fafa87acd2923e";
+}, {
+    readonly id: "source-revocations-schema";
+    readonly path: "spec/plugin/source-revocations-v1.schema.json";
+    readonly version: "source-revocations-v1";
+    readonly sha256: "4c4132879a51b31e99775c979ca3ab43c2ee4c5c885f3ff1e7b43cd5ce8bc83d";
+}, {
+    readonly id: "token-ticket-schema";
+    readonly path: "spec/plugin/token-ticket-v2.schema.json";
+    readonly version: "token-ticket-v2";
+    readonly sha256: "f2fa0d5948318a7a61a3e52d1487b308891d65578259d5958b26c59adef0f351";
+}, {
+    readonly id: "iframe-bridge-schema";
+    readonly path: "spec/plugin/bridge-v2.schema.json";
+    readonly version: "bridge-v2";
+    readonly sha256: "6a6f33381503d67fd7c3098e5e73b8d01ba80b0145190bdd034f85fd43528f23";
+}, {
+    readonly id: "opaque-surface-document-schema";
+    readonly path: "spec/plugin/opaque-surface-document-v1.schema.json";
+    readonly version: "opaque-surface-document-v1";
+    readonly sha256: "78ca8f1fb161dd5cdd54d192eb3e147d6f0e6a8b9de01652ecd4b255600ea9b7";
+}, {
+    readonly id: "opaque-surface-transport-schema";
+    readonly path: "spec/plugin/opaque-surface-transport-v1.schema.json";
+    readonly version: "opaque-surface-transport-v1";
+    readonly sha256: "36cd3378393fc8b59da0e3beb345d56db9a52548604177f0adc36e40d4d2b29b";
+}, {
+    readonly id: "compatibility-manifest-schema";
+    readonly path: "spec/plugin/compatibility-manifest-v2.schema.json";
+    readonly version: "compatibility-manifest-v2";
+    readonly sha256: "924c117966bfc322b643e2987d1387f15ebd5222f328171c66eb56d24d281e21";
+}, {
+    readonly id: "release-manifest-schema";
+    readonly path: "spec/plugin/release-manifest-v2.schema.json";
+    readonly version: "release-manifest-v2";
+    readonly sha256: "4406be65353d6d6e059cc0bd279c6ffc53c4250dd5407e7435b30b2fd6a0f582";
+}, {
+    readonly id: "worker-invocation-schema";
+    readonly path: "spec/plugin/worker-invocation-v1.schema.json";
+    readonly version: "worker-invocation-v1";
+    readonly sha256: "cbbef78febae6d13d914bf382d22f2d9785d0bac158eb92d18a2815d5c70dbe6";
+}, {
+    readonly id: "error-codes-schema";
+    readonly path: "spec/plugin/error-codes-v1.schema.json";
+    readonly version: "error-codes-v1";
+    readonly sha256: "89c95342f689b0ad486631f85ce73d4ffc86babe4e827ac6c2337e50bddc536e";
+}, {
+    readonly id: "rust-ipc-schema";
+    readonly path: "spec/plugin/ipc-v1.schema.json";
+    readonly version: "rust-ipc-v1";
+    readonly sha256: "4e3a9556392b06b805f36fe80c5690408d702a72d71ac6f6e3edcb31f2fd0e91";
+}, {
+    readonly id: "wasm-worker-schema";
+    readonly path: "spec/plugin/wasm-worker-v1.schema.json";
+    readonly version: "redevplugin-wasm-worker-v1";
+    readonly sha256: "ff0a37ea972db7d8be89b529e03d890af00aab3f2d9461c2db3a3d58c664b775";
+}, {
+    readonly id: "network-grant-schema";
+    readonly path: "spec/plugin/network-grant-v1.schema.json";
+    readonly version: "network-grant-v1";
+    readonly sha256: "e3ba8e7aa42267596b5570c1de60994a0912b125ea78427776db8092c2b3ea7b";
+}, {
+    readonly id: "target-classifier-fixture";
+    readonly path: "spec/plugin/target-classifier-v1.json";
+    readonly version: "target-classifier-v1";
+    readonly sha256: "7e9367d624c22d575ae5c118063c1cb0f0de6b5b0081eabcfc51c0357e4d14d7";
+}, {
+    readonly id: "contract-registry";
+    readonly path: "spec/plugin/contract-registry-v1.json";
+    readonly version: "contract-registry-v1";
+    readonly sha256: "753d9e86abc10957ee2a80ae87b5ebf1b83af70370afc1c4e838efa6854eb8f9";
+}];

package/dist/contracts.gen.js

@@ -0,0 +1,145 @@
+// Code generated by scripts/generate_contract_registry.mjs; DO NOT EDIT.
+export const pluginUIProtocolVersion = "plugin-ui-v2";
+export const pluginHostProtocolVersion = "plugin-host-v2";
+export const bridgeSchemaVersion = "bridge-v2";
+export const tokenTicketSchemaVersion = "token-ticket-v2";
+export const redevPluginContractVersions = {
+    "plugin_ui_protocol_version": "plugin-ui-v2",
+    "plugin_host_protocol_version": "plugin-host-v2",
+    "rust_ipc_version": "rust-ipc-v1",
+    "wasm_abi_version": "redevplugin-wasm-worker-v1",
+    "manifest_schema_version": "manifest-v2",
+    "package_signature_schema_version": "package-signature-v1",
+    "release_metadata_schema_version": "release-metadata-v2",
+    "source_policy_schema_version": "source-policy-v1",
+    "source_revocations_schema_version": "source-revocations-v1",
+    "token_ticket_schema_version": "token-ticket-v2",
+    "bridge_schema_version": "bridge-v2",
+    "opaque_surface_document_schema_version": "opaque-surface-document-v1",
+    "opaque_surface_transport_schema_version": "opaque-surface-transport-v1",
+    "target_classifier_version": "target-classifier-v1",
+    "network_grant_schema_version": "network-grant-v1",
+    "plugin_platform_openapi_version": "plugin-platform-v2",
+    "compatibility_manifest_version": "redevplugin.compatibility.v2",
+    "compatibility_schema_version": "compatibility-manifest-v2",
+    "release_manifest_schema_version": "release-manifest-v2",
+    "worker_invocation_schema_version": "worker-invocation-v1",
+    "error_codes_schema_version": "error-codes-v1",
+    "contract_registry_version": "contract-registry-v1",
+};
+export const redevPluginContractArtifacts = [
+    {
+        id: "plugin-platform-openapi",
+        path: "spec/openapi/plugin-platform-v2.yaml",
+        version: "plugin-platform-v2",
+        sha256: "5d6006831c3e55cd9232ad8f9decdc932059193538f9f0ff2b3934d81a6b9aaa",
+    },
+    {
+        id: "manifest-schema",
+        path: "spec/plugin/manifest-v2.schema.json",
+        version: "manifest-v2",
+        sha256: "ba2f782e0e47694484d4112da00d92689187e3bbd1e2f08aca2d9d680e554d51",
+    },
+    {
+        id: "package-signature-schema",
+        path: "spec/plugin/package-signature-v1.schema.json",
+        version: "package-signature-v1",
+        sha256: "13951c0f6831ba28647774368c76a817868aeb7984628e2cf3dc4ad1b54f8284",
+    },
+    {
+        id: "release-metadata-schema",
+        path: "spec/plugin/release-metadata-v2.schema.json",
+        version: "release-metadata-v2",
+        sha256: "6f985f9b0f009151b41e878c68f217058f7dd892f7f6471b2e5d24f54d858567",
+    },
+    {
+        id: "source-policy-schema",
+        path: "spec/plugin/source-policy-v1.schema.json",
+        version: "source-policy-v1",
+        sha256: "b5f3094402bdbfdda1671b46e5f64a69ad7dc2ba9501030439fafa87acd2923e",
+    },
+    {
+        id: "source-revocations-schema",
+        path: "spec/plugin/source-revocations-v1.schema.json",
+        version: "source-revocations-v1",
+        sha256: "4c4132879a51b31e99775c979ca3ab43c2ee4c5c885f3ff1e7b43cd5ce8bc83d",
+    },
+    {
+        id: "token-ticket-schema",
+        path: "spec/plugin/token-ticket-v2.schema.json",
+        version: "token-ticket-v2",
+        sha256: "f2fa0d5948318a7a61a3e52d1487b308891d65578259d5958b26c59adef0f351",
+    },
+    {
+        id: "iframe-bridge-schema",
+        path: "spec/plugin/bridge-v2.schema.json",
+        version: "bridge-v2",
+        sha256: "6a6f33381503d67fd7c3098e5e73b8d01ba80b0145190bdd034f85fd43528f23",
+    },
+    {
+        id: "opaque-surface-document-schema",
+        path: "spec/plugin/opaque-surface-document-v1.schema.json",
+        version: "opaque-surface-document-v1",
+        sha256: "78ca8f1fb161dd5cdd54d192eb3e147d6f0e6a8b9de01652ecd4b255600ea9b7",
+    },
+    {
+        id: "opaque-surface-transport-schema",
+        path: "spec/plugin/opaque-surface-transport-v1.schema.json",
+        version: "opaque-surface-transport-v1",
+        sha256: "36cd3378393fc8b59da0e3beb345d56db9a52548604177f0adc36e40d4d2b29b",
+    },
+    {
+        id: "compatibility-manifest-schema",
+        path: "spec/plugin/compatibility-manifest-v2.schema.json",
+        version: "compatibility-manifest-v2",
+        sha256: "924c117966bfc322b643e2987d1387f15ebd5222f328171c66eb56d24d281e21",
+    },
+    {
+        id: "release-manifest-schema",
+        path: "spec/plugin/release-manifest-v2.schema.json",
+        version: "release-manifest-v2",
+        sha256: "4406be65353d6d6e059cc0bd279c6ffc53c4250dd5407e7435b30b2fd6a0f582",
+    },
+    {
+        id: "worker-invocation-schema",
+        path: "spec/plugin/worker-invocation-v1.schema.json",
+        version: "worker-invocation-v1",
+        sha256: "cbbef78febae6d13d914bf382d22f2d9785d0bac158eb92d18a2815d5c70dbe6",
+    },
+    {
+        id: "error-codes-schema",
+        path: "spec/plugin/error-codes-v1.schema.json",
+        version: "error-codes-v1",
+        sha256: "89c95342f689b0ad486631f85ce73d4ffc86babe4e827ac6c2337e50bddc536e",
+    },
+    {
+        id: "rust-ipc-schema",
+        path: "spec/plugin/ipc-v1.schema.json",
+        version: "rust-ipc-v1",
+        sha256: "4e3a9556392b06b805f36fe80c5690408d702a72d71ac6f6e3edcb31f2fd0e91",
+    },
+    {
+        id: "wasm-worker-schema",
+        path: "spec/plugin/wasm-worker-v1.schema.json",
+        version: "redevplugin-wasm-worker-v1",
+        sha256: "ff0a37ea972db7d8be89b529e03d890af00aab3f2d9461c2db3a3d58c664b775",
+    },
+    {
+        id: "network-grant-schema",
+        path: "spec/plugin/network-grant-v1.schema.json",
+        version: "network-grant-v1",
+        sha256: "e3ba8e7aa42267596b5570c1de60994a0912b125ea78427776db8092c2b3ea7b",
+    },
+    {
+        id: "target-classifier-fixture",
+        path: "spec/plugin/target-classifier-v1.json",
+        version: "target-classifier-v1",
+        sha256: "7e9367d624c22d575ae5c118063c1cb0f0de6b5b0081eabcfc51c0357e4d14d7",
+    },
+    {
+        id: "contract-registry",
+        path: "spec/plugin/contract-registry-v1.json",
+        version: "contract-registry-v1",
+        sha256: "753d9e86abc10957ee2a80ae87b5ebf1b83af70370afc1c4e838efa6854eb8f9",
+    },
+];

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+export declare const pluginPlatformErrorCodes: readonly ["PLUGIN_INVALID_REQUEST", "PLUGIN_MANIFEST_INVALID", "PLUGIN_PACKAGE_INVALID", "PLUGIN_PACKAGE_TOO_LARGE", "PLUGIN_PACKAGE_PATH_FORBIDDEN", "PLUGIN_SIGNATURE_INVALID", "PLUGIN_TRUST_STATE_DENIED", "PLUGIN_TRUST_VERIFICATION_REQUIRED", "PLUGIN_TRUST_VERIFICATION_INVALID", "PLUGIN_RELEASE_REF_VERIFICATION_FAILED", "PLUGIN_RELEASE_REF_POLICY_DENIED", "PLUGIN_DISABLED", "PLUGIN_DISABLED_BY_POLICY", "PLUGIN_PERMISSION_DENIED", "PLUGIN_CONFIRMATION_REQUIRED", "PLUGIN_CONFIRMATION_INVALID", "PLUGIN_TOKEN_EXPIRED", "PLUGIN_TOKEN_REPLAY", "PLUGIN_GATEWAY_TOKEN_INVALID", "PLUGIN_GATEWAY_TOKEN_REPLAYED", "PLUGIN_GATEWAY_TOKEN_CHANNEL_MISMATCH", "PLUGIN_ASSET_TICKET_INVALID", "PLUGIN_ASSET_SESSION_INVALID", "PLUGIN_STREAM_TICKET_INVALID", "PLUGIN_STREAM_CANCELLED", "PLUGIN_LEASE_INVALID", "PLUGIN_LEASE_REPLAYED", "PLUGIN_GRANT_INVALID", "PLUGIN_STORAGE_QUOTA_EXCEEDED", "PLUGIN_OPERATION_BLOCKED", "PLUGIN_OPERATION_NOT_FOUND", "PLUGIN_OPERATION_NOT_CANCELABLE", "PLUGIN_NETWORK_TARGET_DENIED", "PLUGIN_NETWORK_RATE_LIMITED", "PLUGIN_RUNTIME_UNAVAILABLE", "PLUGIN_RUNTIME_VERSION_MISMATCH", "PLUGIN_JSON_LIMIT_EXCEEDED", "PLUGIN_CONTRACT_MISMATCH", "PLUGIN_STATE_VERSION_MISMATCH", "PLUGIN_CSRF_REQUIRED", "PLUGIN_RETAINED_DATA_CLEANUP_FAILED", "PLUGIN_RETAINED_DATA_BIND_FAILED"];
+export declare const pluginBridgeErrorCodes: readonly ["PLUGIN_INVALID_REQUEST", "PLUGIN_MANIFEST_INVALID", "PLUGIN_PACKAGE_INVALID", "PLUGIN_PACKAGE_TOO_LARGE", "PLUGIN_PACKAGE_PATH_FORBIDDEN", "PLUGIN_SIGNATURE_INVALID", "PLUGIN_TRUST_STATE_DENIED", "PLUGIN_TRUST_VERIFICATION_REQUIRED", "PLUGIN_TRUST_VERIFICATION_INVALID", "PLUGIN_RELEASE_REF_VERIFICATION_FAILED", "PLUGIN_RELEASE_REF_POLICY_DENIED", "PLUGIN_DISABLED", "PLUGIN_DISABLED_BY_POLICY", "PLUGIN_PERMISSION_DENIED", "PLUGIN_CONFIRMATION_REQUIRED", "PLUGIN_CONFIRMATION_INVALID", "PLUGIN_TOKEN_EXPIRED", "PLUGIN_TOKEN_REPLAY", "PLUGIN_GATEWAY_TOKEN_INVALID", "PLUGIN_GATEWAY_TOKEN_REPLAYED", "PLUGIN_GATEWAY_TOKEN_CHANNEL_MISMATCH", "PLUGIN_ASSET_TICKET_INVALID", "PLUGIN_ASSET_SESSION_INVALID", "PLUGIN_STREAM_TICKET_INVALID", "PLUGIN_STREAM_CANCELLED", "PLUGIN_LEASE_INVALID", "PLUGIN_LEASE_REPLAYED", "PLUGIN_GRANT_INVALID", "PLUGIN_STORAGE_QUOTA_EXCEEDED", "PLUGIN_OPERATION_BLOCKED", "PLUGIN_OPERATION_NOT_FOUND", "PLUGIN_OPERATION_NOT_CANCELABLE", "PLUGIN_NETWORK_TARGET_DENIED", "PLUGIN_NETWORK_RATE_LIMITED", "PLUGIN_RUNTIME_UNAVAILABLE", "PLUGIN_RUNTIME_VERSION_MISMATCH", "PLUGIN_JSON_LIMIT_EXCEEDED", "PLUGIN_CONTRACT_MISMATCH", "PLUGIN_STATE_VERSION_MISMATCH", "PLUGIN_CSRF_REQUIRED", "PLUGIN_RETAINED_DATA_CLEANUP_FAILED", "PLUGIN_RETAINED_DATA_BIND_FAILED", "PLUGIN_CONFIRMATION_REJECTED", "PLUGIN_BRIDGE_TIMEOUT", "PLUGIN_BRIDGE_DISPOSED", "PLUGIN_BRIDGE_HANDSHAKE_FAILED", "PLUGIN_BRIDGE_HANDSHAKE_REQUIRED"];
+export declare const pluginClientErrorCodes: readonly ["PLUGIN_INVALID_REQUEST", "PLUGIN_MANIFEST_INVALID", "PLUGIN_PACKAGE_INVALID", "PLUGIN_PACKAGE_TOO_LARGE", "PLUGIN_PACKAGE_PATH_FORBIDDEN", "PLUGIN_SIGNATURE_INVALID", "PLUGIN_TRUST_STATE_DENIED", "PLUGIN_TRUST_VERIFICATION_REQUIRED", "PLUGIN_TRUST_VERIFICATION_INVALID", "PLUGIN_RELEASE_REF_VERIFICATION_FAILED", "PLUGIN_RELEASE_REF_POLICY_DENIED", "PLUGIN_DISABLED", "PLUGIN_DISABLED_BY_POLICY", "PLUGIN_PERMISSION_DENIED", "PLUGIN_CONFIRMATION_REQUIRED", "PLUGIN_CONFIRMATION_INVALID", "PLUGIN_TOKEN_EXPIRED", "PLUGIN_TOKEN_REPLAY", "PLUGIN_GATEWAY_TOKEN_INVALID", "PLUGIN_GATEWAY_TOKEN_REPLAYED", "PLUGIN_GATEWAY_TOKEN_CHANNEL_MISMATCH", "PLUGIN_ASSET_TICKET_INVALID", "PLUGIN_ASSET_SESSION_INVALID", "PLUGIN_STREAM_TICKET_INVALID", "PLUGIN_STREAM_CANCELLED", "PLUGIN_LEASE_INVALID", "PLUGIN_LEASE_REPLAYED", "PLUGIN_GRANT_INVALID", "PLUGIN_STORAGE_QUOTA_EXCEEDED", "PLUGIN_OPERATION_BLOCKED", "PLUGIN_OPERATION_NOT_FOUND", "PLUGIN_OPERATION_NOT_CANCELABLE", "PLUGIN_NETWORK_TARGET_DENIED", "PLUGIN_NETWORK_RATE_LIMITED", "PLUGIN_RUNTIME_UNAVAILABLE", "PLUGIN_RUNTIME_VERSION_MISMATCH", "PLUGIN_JSON_LIMIT_EXCEEDED", "PLUGIN_CONTRACT_MISMATCH", "PLUGIN_STATE_VERSION_MISMATCH", "PLUGIN_CSRF_REQUIRED", "PLUGIN_RETAINED_DATA_CLEANUP_FAILED", "PLUGIN_RETAINED_DATA_BIND_FAILED", "PLUGIN_CONFIRMATION_REJECTED", "PLUGIN_BRIDGE_TIMEOUT", "PLUGIN_BRIDGE_DISPOSED", "PLUGIN_BRIDGE_HANDSHAKE_FAILED", "PLUGIN_BRIDGE_HANDSHAKE_REQUIRED", "PLUGIN_PLATFORM_REQUEST_FAILED", "PLUGIN_STREAM_FAILED"];
+export type PluginPlatformErrorCode = typeof pluginPlatformErrorCodes[number];
+export type PluginBridgeErrorCode = typeof pluginBridgeErrorCodes[number];
+export type PluginClientErrorCode = typeof pluginClientErrorCodes[number];
+export declare class PluginBridgeError extends Error {
+    readonly errorCode: string;
+    readonly data?: unknown;
+    readonly details?: unknown;
+    constructor(errorCode: string, message: string, data?: unknown, details?: unknown);
+}

package/dist/errors.js

@@ -0,0 +1,69 @@
+export const pluginPlatformErrorCodes = [
+    "PLUGIN_INVALID_REQUEST",
+    "PLUGIN_MANIFEST_INVALID",
+    "PLUGIN_PACKAGE_INVALID",
+    "PLUGIN_PACKAGE_TOO_LARGE",
+    "PLUGIN_PACKAGE_PATH_FORBIDDEN",
+    "PLUGIN_SIGNATURE_INVALID",
+    "PLUGIN_TRUST_STATE_DENIED",
+    "PLUGIN_TRUST_VERIFICATION_REQUIRED",
+    "PLUGIN_TRUST_VERIFICATION_INVALID",
+    "PLUGIN_RELEASE_REF_VERIFICATION_FAILED",
+    "PLUGIN_RELEASE_REF_POLICY_DENIED",
+    "PLUGIN_DISABLED",
+    "PLUGIN_DISABLED_BY_POLICY",
+    "PLUGIN_PERMISSION_DENIED",
+    "PLUGIN_CONFIRMATION_REQUIRED",
+    "PLUGIN_CONFIRMATION_INVALID",
+    "PLUGIN_TOKEN_EXPIRED",
+    "PLUGIN_TOKEN_REPLAY",
+    "PLUGIN_GATEWAY_TOKEN_INVALID",
+    "PLUGIN_GATEWAY_TOKEN_REPLAYED",
+    "PLUGIN_GATEWAY_TOKEN_CHANNEL_MISMATCH",
+    "PLUGIN_ASSET_TICKET_INVALID",
+    "PLUGIN_ASSET_SESSION_INVALID",
+    "PLUGIN_STREAM_TICKET_INVALID",
+    "PLUGIN_STREAM_CANCELLED",
+    "PLUGIN_LEASE_INVALID",
+    "PLUGIN_LEASE_REPLAYED",
+    "PLUGIN_GRANT_INVALID",
+    "PLUGIN_STORAGE_QUOTA_EXCEEDED",
+    "PLUGIN_OPERATION_BLOCKED",
+    "PLUGIN_OPERATION_NOT_FOUND",
+    "PLUGIN_OPERATION_NOT_CANCELABLE",
+    "PLUGIN_NETWORK_TARGET_DENIED",
+    "PLUGIN_NETWORK_RATE_LIMITED",
+    "PLUGIN_RUNTIME_UNAVAILABLE",
+    "PLUGIN_RUNTIME_VERSION_MISMATCH",
+    "PLUGIN_JSON_LIMIT_EXCEEDED",
+    "PLUGIN_CONTRACT_MISMATCH",
+    "PLUGIN_STATE_VERSION_MISMATCH",
+    "PLUGIN_CSRF_REQUIRED",
+    "PLUGIN_RETAINED_DATA_CLEANUP_FAILED",
+    "PLUGIN_RETAINED_DATA_BIND_FAILED",
+];
+export const pluginBridgeErrorCodes = [
+    ...pluginPlatformErrorCodes,
+    "PLUGIN_CONFIRMATION_REJECTED",
+    "PLUGIN_BRIDGE_TIMEOUT",
+    "PLUGIN_BRIDGE_DISPOSED",
+    "PLUGIN_BRIDGE_HANDSHAKE_FAILED",
+    "PLUGIN_BRIDGE_HANDSHAKE_REQUIRED",
+];
+export const pluginClientErrorCodes = [
+    ...pluginBridgeErrorCodes,
+    "PLUGIN_PLATFORM_REQUEST_FAILED",
+    "PLUGIN_STREAM_FAILED",
+];
+export class PluginBridgeError extends Error {
+    errorCode;
+    data;
+    details;
+    constructor(errorCode, message, data, details) {
+        super(message);
+        this.name = "PluginBridgeError";
+        this.errorCode = errorCode;
+        this.data = data;
+        this.details = details ?? data;
+    }
+}

package/dist/http.d.ts

@@ -0,0 +1,30 @@
+export type FetchLike = (input: string, init: FetchInitLike) => Promise<FetchResponseLike>;
+export type FetchInitLike = {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    credentials?: "same-origin" | "include" | "omit";
+    signal?: AbortSignal;
+    keepalive?: boolean;
+};
+export type FetchResponseLike = {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+};
+export type HostEnvelope<T> = {
+    ok: true;
+    data?: T;
+} | {
+    ok: false;
+    data?: unknown;
+    error?: string;
+    error_code?: string;
+    error_details?: Record<string, unknown>;
+};
+export declare function defaultFetch(): FetchLike;
+export declare function trimTrailingSlash(value: string): string;
+export declare function readHostEnvelope<T>(response: FetchResponseLike, fallbackCode: string): Promise<T>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function hasExactKeys(value: unknown, keys: readonly string[]): value is Record<string, unknown>;
+export declare function hasAllowedKeys(value: unknown, keys: readonly string[]): value is Record<string, unknown>;

package/dist/http.js

@@ -0,0 +1,45 @@
+import { PluginBridgeError } from "./errors.js";
+export function defaultFetch() {
+    const fetchLike = globalThis.fetch;
+    if (!fetchLike) {
+        throw new Error("fetch is required when globalThis.fetch is unavailable");
+    }
+    return fetchLike.bind(globalThis);
+}
+export function trimTrailingSlash(value) {
+    return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+export async function readHostEnvelope(response, fallbackCode) {
+    const raw = await response.json();
+    if (!isHostEnvelope(raw)) {
+        throw new PluginBridgeError("PLUGIN_CONTRACT_MISMATCH", `Plugin platform endpoint returned an invalid envelope with HTTP ${response.status}`);
+    }
+    if (!raw.ok) {
+        throw new PluginBridgeError(raw.error_code ?? fallbackCode, raw.error ?? `Plugin platform endpoint failed with HTTP ${response.status}`, raw.data, raw.error_details ?? raw.data);
+    }
+    return raw.data;
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function hasExactKeys(value, keys) {
+    if (!isRecord(value))
+        return false;
+    const actual = Object.keys(value).sort();
+    const expected = [...keys].sort();
+    return actual.length === expected.length && actual.every((key, index) => key === expected[index]);
+}
+export function hasAllowedKeys(value, keys) {
+    return isRecord(value) && Object.keys(value).every((key) => keys.includes(key));
+}
+function isHostEnvelope(value) {
+    if (!isRecord(value) || typeof value.ok !== "boolean") {
+        return false;
+    }
+    if (value.ok) {
+        return true;
+    }
+    return (value.error == null || typeof value.error === "string") &&
+        (value.error_code == null || typeof value.error_code === "string") &&
+        (value.error_details == null || isRecord(value.error_details));
+}