@floegence/redevplugin-contracts 0.6.24 → 0.7.1

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { generatedContractArtifacts, generatedRegistryContract } from "./contracts.gen.js";
 export * from "./release-signing.js";
+export * from "./presentation.js";
 export type ContractID = (typeof generatedContractArtifacts)[number]["id"] | typeof generatedRegistryContract.id;
 export type Contract = Readonly<{
     id: ContractID;
@@ -19,9 +20,9 @@ export declare const contractRegistry: {
     readonly registry_version: "contract-registry-v2";
     readonly artifacts: readonly [{
         readonly id: "compatibility-manifest-schema";
-        readonly path: "spec/plugin/compatibility-manifest-v13.schema.json";
-        readonly version: "compatibility-manifest-v13";
-        readonly sha256: "c95fdfe0c5818ba57e664c534c3d10d073545e5a31bccd7c1ee5d39d391d13b2";
+        readonly path: "spec/plugin/compatibility-manifest-v14.schema.json";
+        readonly version: "compatibility-manifest-v14";
+        readonly sha256: "67016ead2ed8b86410aafe3771d750ea2ab088479047475542ac65caa1691a7c";
     }, {
         readonly id: "contract-registry-schema";
         readonly path: "spec/plugin/contract-registry-v2.schema.json";
@@ -94,9 +95,9 @@ export declare const contractRegistry: {
         readonly sha256: "f4b5f04870b58e8e2363aaba98b273adccef3a3e9ac1eb1a2dbbc3fb4c71b300";
     }, {
         readonly id: "manifest-schema";
-        readonly path: "spec/plugin/manifest-v7.schema.json";
-        readonly version: "manifest-v7";
-        readonly sha256: "af73ffd8ccedcb149198f847b68ed6fc23e51366122915c7129473f9fde68e35";
+        readonly path: "spec/plugin/manifest-v8.schema.json";
+        readonly version: "manifest-v8";
+        readonly sha256: "f4f6ec875936b19ae3371459804b5ad2c36a4bd0739a83976037efffe51ada48";
     }, {
         readonly id: "network-grant-schema";
         readonly path: "spec/plugin/network-grant-v2.schema.json";
@@ -159,9 +160,14 @@ export declare const contractRegistry: {
         readonly sha256: "4d9979f5205ec047895b64c995312c588d998bb1c1448f6c9c559f1b7ab0d796";
     }, {
         readonly id: "plugin-platform-openapi";
-        readonly path: "spec/openapi/plugin-platform-v11.yaml";
-        readonly version: "plugin-platform-v11";
-        readonly sha256: "41c84c939ca9471baafdb16a1fe7d62a232a58df91e579514351dd6046e529e7";
+        readonly path: "spec/openapi/plugin-platform-v12.yaml";
+        readonly version: "plugin-platform-v12";
+        readonly sha256: "715698e9e1e357e243ee21b3157cc044befac83979107f54d024b5e9e48f7050";
+    }, {
+        readonly id: "presentation-locale-fixture";
+        readonly path: "spec/plugin/presentation-locale-fixtures-v1.json";
+        readonly version: "presentation-locale-fixtures-v1";
+        readonly sha256: "cbb4c0188d020b5fbde9a0c2c33b3677d21cc64c0f0297b7f6f3f6c0efabc40e";
     }, {
         readonly id: "process-containment-schema";
         readonly path: "spec/plugin/process-containment-v1.schema.json";
@@ -179,9 +185,9 @@ export declare const contractRegistry: {
         readonly sha256: "0aced01a8d409953d5075a799ac273cae79e285ac82debe93ac4d8b706571ad1";
     }, {
         readonly id: "release-metadata-schema";
-        readonly path: "spec/plugin/release-metadata-v7.schema.json";
-        readonly version: "release-metadata-v7";
-        readonly sha256: "d9ceac9b8dd52288172bbe5d4dc2f158e2354ad4fe1f071617f6ba9309e21ebf";
+        readonly path: "spec/plugin/release-metadata-v8.schema.json";
+        readonly version: "release-metadata-v8";
+        readonly sha256: "f454fc1923be10fd5a4b46df4a6e376f7e9fe1d462f3da57977b92ad7c7496b0";
     }, {
         readonly id: "release-publisher-config-schema";
         readonly path: "spec/plugin/release-publisher-config-v1.schema.json";
@@ -311,45 +317,45 @@ export declare const contractRegistry: {
 };
 export declare const packageSet: {
     readonly schema_version: "redevplugin.platform_package_set.v1";
-    readonly platform_version: "0.6.24";
+    readonly platform_version: "0.7.1";
     readonly go_module: {
         readonly module: "github.com/floegence/redevplugin";
-        readonly version: "v0.6.24";
+        readonly version: "v0.7.1";
     };
     readonly npm_packages: readonly [{
         readonly name: "@floegence/redevplugin-contracts";
-        readonly version: "0.6.24";
+        readonly version: "0.7.1";
     }, {
         readonly name: "@floegence/redevplugin-ui";
-        readonly version: "0.6.24";
+        readonly version: "0.7.1";
     }];
     readonly rust_crates: readonly [{
         readonly name: "redevplugin-contracts";
-        readonly version: "0.6.24";
+        readonly version: "0.7.1";
         readonly role: "contracts";
     }, {
         readonly name: "redevplugin-ipc";
-        readonly version: "0.6.24";
+        readonly version: "0.7.1";
         readonly role: "ipc";
     }, {
         readonly name: "redevplugin-wasm-abi";
-        readonly version: "0.6.24";
+        readonly version: "0.7.1";
         readonly role: "wasm_abi";
     }, {
         readonly name: "redevplugin-target-classifier";
-        readonly version: "0.6.24";
+        readonly version: "0.7.1";
         readonly role: "target_classifier";
     }, {
         readonly name: "redevplugin-worker-sdk";
-        readonly version: "0.6.24";
+        readonly version: "0.7.1";
         readonly role: "worker_sdk";
     }, {
         readonly name: "redevplugin-runtime";
-        readonly version: "0.6.24";
+        readonly version: "0.7.1";
         readonly role: "runtime";
     }];
     readonly contract_registry_version: "contract-registry-v2";
-    readonly contract_set_sha256: "22ff9be972e19ddbfb7b2e9bbb69861e6f5cc44ac02b490899f2d27cdf4f033f";
+    readonly contract_set_sha256: "ce37ac605cb6c618d8fb26f5e72a7c1346d0315d351f8700aadf6f7ae1708545";
 };
-export declare const contractSetSHA256: "22ff9be972e19ddbfb7b2e9bbb69861e6f5cc44ac02b490899f2d27cdf4f033f";
+export declare const contractSetSHA256: "ce37ac605cb6c618d8fb26f5e72a7c1346d0315d351f8700aadf6f7ae1708545";
 export declare function getContract(id: ContractID): Contract;

package/dist/index.js

@@ -1,5 +1,6 @@
 import { generatedContractArtifacts, generatedContractRegistry, generatedContractSetSHA256, generatedPackageSet, generatedRegistryContract, } from "./contracts.gen.js";
 export * from "./release-signing.js";
+export * from "./presentation.js";
 export class UnknownContractError extends RangeError {
     id;
     constructor(id) {

package/dist/presentation.d.ts

@@ -0,0 +1,42 @@
+export type SettingOptionPresentation = Readonly<{
+    value: string;
+    label: string;
+}>;
+export type ResolvedSurfacePresentation = Readonly<{
+    surface_id: string;
+    label: string;
+}>;
+export type ResolvedSettingPresentation = Readonly<{
+    key: string;
+    label: string;
+    options: readonly SettingOptionPresentation[];
+}>;
+export type PresentationLocale = Readonly<{
+    locale: string;
+    plugin_name: string;
+    publisher_name?: string;
+    summary: string;
+    description: readonly string[];
+    highlights: readonly string[];
+    keywords: readonly string[];
+    surfaces: readonly ResolvedSurfacePresentation[];
+    settings: readonly ResolvedSettingPresentation[];
+}>;
+export type PresentationCatalog = Readonly<{
+    default_locale: string;
+    locales: readonly PresentationLocale[];
+}>;
+export type ResolvedPresentation = Readonly<{
+    requested_locale?: string;
+    resolved_locale: string;
+    default_locale: string;
+    plugin_name: string;
+    publisher_name?: string;
+    summary: string;
+    description: readonly string[];
+    highlights: readonly string[];
+    keywords: readonly string[];
+    surfaces: readonly ResolvedSurfacePresentation[];
+    settings: readonly ResolvedSettingPresentation[];
+}>;
+export declare function resolvePresentation(catalog: PresentationCatalog, requestedLocale: string): ResolvedPresentation;

package/dist/presentation.js

@@ -0,0 +1,57 @@
+export function resolvePresentation(catalog, requestedLocale) {
+    const byLocale = new Map(catalog.locales.map((locale) => [locale.locale, locale]));
+    const requested = canonicalLocale(requestedLocale);
+    let resolved = byLocale.get(catalog.default_locale);
+    if (resolved === undefined)
+        throw new TypeError("presentation default locale is missing");
+    if (requested !== undefined) {
+        for (const candidate of localeLookupCandidates(requested)) {
+            const match = byLocale.get(candidate);
+            if (match !== undefined) {
+                resolved = match;
+                break;
+            }
+        }
+    }
+    return deepClonePresentation(resolved, catalog.default_locale, requested);
+}
+function canonicalLocale(value) {
+    if (value === "" || value.trim() !== value || value.includes("_"))
+        return undefined;
+    try {
+        const canonical = Intl.getCanonicalLocales(value)[0];
+        return canonical === "und" ? undefined : canonical;
+    }
+    catch {
+        return undefined;
+    }
+}
+function localeLookupCandidates(locale) {
+    const parts = locale.split("-");
+    const result = [];
+    while (parts.length > 0) {
+        result.push(parts.join("-"));
+        parts.pop();
+        if (parts.at(-1)?.length === 1)
+            parts.pop();
+    }
+    return result;
+}
+function deepClonePresentation(locale, defaultLocale, requestedLocale) {
+    return {
+        ...(requestedLocale === undefined ? {} : { requested_locale: requestedLocale }),
+        resolved_locale: locale.locale,
+        default_locale: defaultLocale,
+        plugin_name: locale.plugin_name,
+        ...(locale.publisher_name === undefined ? {} : { publisher_name: locale.publisher_name }),
+        summary: locale.summary,
+        description: [...locale.description],
+        highlights: [...locale.highlights],
+        keywords: [...locale.keywords],
+        surfaces: locale.surfaces.map((surface) => ({ ...surface })),
+        settings: locale.settings.map((setting) => ({
+            ...setting,
+            options: setting.options.map((option) => ({ ...option })),
+        })),
+    };
+}

package/dist/release-signing.d.ts

@@ -1,9 +1,7 @@
 export declare const rootDelegationSchemaVersion: "redevplugin.release_root_delegation.v1";
 export declare const packageSignatureSchemaVersion: "redevplugin.package_signature.v1";
-export declare const releaseMetadataSchemaVersionV5: "redevplugin.release_metadata.v5";
-export declare const releaseMetadataSchemaVersionV6: "redevplugin.release_metadata.v6";
-export declare const releaseMetadataSchemaVersionV7: "redevplugin.release_metadata.v7";
-export declare const releaseMetadataSchemaVersion: "redevplugin.release_metadata.v7";
+export declare const releaseMetadataSchemaVersionV8: "redevplugin.release_metadata.v8";
+export declare const releaseMetadataSchemaVersion: "redevplugin.release_metadata.v8";
 export declare const sourcePolicySchemaVersion: "redevplugin.release_source_policy.v2";
 export declare const sourcePolicyPointerSchemaVersion: "redevplugin.release_source_policy_pointer.v1";
 export declare const revocationSchemaVersion: "redevplugin.release_revocation.v2";
@@ -145,8 +143,8 @@ export type ReleaseEvidence = Readonly<{
     provenance_sha256?: string;
     generated_at?: string;
 }>;
-export type ReleaseMetadataV5 = Readonly<{
-    schema_version: typeof releaseMetadataSchemaVersionV5 | typeof releaseMetadataSchemaVersionV6 | typeof releaseMetadataSchemaVersionV7;
+export type ReleaseMetadataV8 = Readonly<{
+    schema_version: typeof releaseMetadataSchemaVersionV8;
     source_id: string;
     release_metadata_ref: string;
     publisher_id: string;
@@ -393,10 +391,10 @@ export declare function buildPackageSignature(input: PackageSigningInput, signat
 export declare function packageSigningPreimage(input: PackageSigningInput): Uint8Array;
 export declare function canonicalPackageSignature(context: PackageVerificationContext, document: PackageSignatureV1): Uint8Array;
 export declare function verifyPackageSignature(context: PackageVerificationContext, document: PackageSignatureV1, verifier: SignatureVerifier): Promise<void>;
-export declare function buildReleaseMetadata(document: ReleaseMetadataV5): ReleaseMetadataV5;
-export declare function releaseMetadataSigningPreimage(channel: string, document: ReleaseMetadataV5): Uint8Array;
-export declare function canonicalReleaseMetadata(document: ReleaseMetadataV5): Uint8Array;
-export declare function verifyReleaseMetadata(channel: string, document: ReleaseMetadataV5, signature: Uint8Array, verifier: SignatureVerifier): Promise<void>;
+export declare function buildReleaseMetadata(document: ReleaseMetadataV8): ReleaseMetadataV8;
+export declare function releaseMetadataSigningPreimage(channel: string, document: ReleaseMetadataV8): Uint8Array;
+export declare function canonicalReleaseMetadata(document: ReleaseMetadataV8): Uint8Array;
+export declare function verifyReleaseMetadata(channel: string, document: ReleaseMetadataV8, signature: Uint8Array, verifier: SignatureVerifier): Promise<void>;
 export declare function buildSourcePolicy(input: SourcePolicyInput, signature: Uint8Array): SourcePolicyV2;
 export declare function sourcePolicySigningPreimage(input: SourcePolicyInput): Uint8Array;
 export declare function canonicalSourcePolicy(document: SourcePolicyV2): Uint8Array;
@@ -415,7 +413,7 @@ export declare function canonicalRevocationPointer(document: RevocationPointerV1
 export declare function verifyRevocationPointer(document: RevocationPointerV1, verifier: SignatureVerifier): Promise<void>;
 export declare function decodeRootDelegation(raw: Uint8Array | string): RootDelegationV1;
 export declare function decodePackageSignature(raw: Uint8Array | string, context: PackageVerificationContext): PackageSignatureV1;
-export declare function decodeReleaseMetadata(raw: Uint8Array | string): ReleaseMetadataV5;
+export declare function decodeReleaseMetadata(raw: Uint8Array | string): ReleaseMetadataV8;
 export declare function decodeSourcePolicy(raw: Uint8Array | string): SourcePolicyV2;
 export declare function decodeSourcePolicyPointer(raw: Uint8Array | string): SourcePolicyPointerV1;
 export declare function decodeRevocation(raw: Uint8Array | string): RevocationV2;

package/dist/release-signing.js

@@ -1,9 +1,7 @@
 export const rootDelegationSchemaVersion = "redevplugin.release_root_delegation.v1";
 export const packageSignatureSchemaVersion = "redevplugin.package_signature.v1";
-export const releaseMetadataSchemaVersionV5 = "redevplugin.release_metadata.v5";
-export const releaseMetadataSchemaVersionV6 = "redevplugin.release_metadata.v6";
-export const releaseMetadataSchemaVersionV7 = "redevplugin.release_metadata.v7";
-export const releaseMetadataSchemaVersion = releaseMetadataSchemaVersionV7;
+export const releaseMetadataSchemaVersionV8 = "redevplugin.release_metadata.v8";
+export const releaseMetadataSchemaVersion = releaseMetadataSchemaVersionV8;
 export const sourcePolicySchemaVersion = "redevplugin.release_source_policy.v2";
 export const sourcePolicyPointerSchemaVersion = "redevplugin.release_source_policy_pointer.v1";
 export const revocationSchemaVersion = "redevplugin.release_revocation.v2";
@@ -49,6 +47,7 @@ export class InvalidReleaseSignatureError extends Error {
 const textEncoder = new TextEncoder();
 const textDecoder = new TextDecoder("utf-8", { fatal: true });
 const maximumDocumentBytes = 1024 * 1024;
+const maximumPatternValueCodeUnits = 4096;
 const signingPrefix = textEncoder.encode("REDEVPLUGIN-SIGNING-V1\0");
 const newIDPattern = /^[a-z][a-z0-9._-]{0,127}$/;
 const legacyIDPattern = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
@@ -59,7 +58,7 @@ const prefixedSHA256Pattern = /^sha256:[0-9a-f]{64}$/;
 const legacySHA256Pattern = /^(?:sha256:)?[0-9a-f]{64}$/;
 const artifactRefPattern = /^[A-Za-z0-9._/@+-]+$/;
 const hostnamePattern = /^[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?$/;
-const semverPattern = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-(?:(?:0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+const semverPattern = { test: isCanonicalSemver };
 const canonicalTimePattern = /^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$/;
 const publicKeyPattern = /^[A-Za-z0-9+/]{43}=$/;
 const signaturePattern = /^[A-Za-z0-9+/]{86}==$/;
@@ -85,7 +84,55 @@ function assertRecord(value) {
         invalidDocument();
 }
 function matchesPattern(pattern, value) {
-    return typeof value === "string" && pattern.test(value);
+    if (typeof value !== "string" || value.length > maximumPatternValueCodeUnits)
+        return false;
+    return pattern.test(value);
+}
+function isCanonicalSemver(value) {
+    if (value.length < 5 || value.length > 255)
+        return false;
+    const plus = value.indexOf("+");
+    if (plus !== value.lastIndexOf("+") || plus === value.length - 1)
+        return false;
+    const withoutBuild = plus < 0 ? value : value.slice(0, plus);
+    if (plus >= 0 && !validSemverIdentifiers(value.slice(plus + 1), false))
+        return false;
+    const dash = withoutBuild.indexOf("-");
+    if (dash === withoutBuild.length - 1)
+        return false;
+    const core = dash < 0 ? withoutBuild : withoutBuild.slice(0, dash);
+    if (dash >= 0 && !validSemverIdentifiers(withoutBuild.slice(dash + 1), true))
+        return false;
+    const coreIdentifiers = core.split(".");
+    return coreIdentifiers.length === 3 && coreIdentifiers.every(validSemverNumericIdentifier);
+}
+function validSemverIdentifiers(value, rejectNumericLeadingZero) {
+    const identifiers = value.split(".");
+    return identifiers.every((identifier) => {
+        if (identifier.length === 0)
+            return false;
+        let numeric = true;
+        for (let index = 0; index < identifier.length; index += 1) {
+            const code = identifier.charCodeAt(index);
+            const digit = code >= 48 && code <= 57;
+            const upper = code >= 65 && code <= 90;
+            const lower = code >= 97 && code <= 122;
+            if (!digit && !upper && !lower && code !== 45)
+                return false;
+            numeric = numeric && digit;
+        }
+        return !rejectNumericLeadingZero || !numeric || identifier.length === 1 || identifier[0] !== "0";
+    });
+}
+function validSemverNumericIdentifier(value) {
+    if (value.length === 0 || (value.length > 1 && value[0] === "0"))
+        return false;
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code < 48 || code > 57)
+            return false;
+    }
+    return true;
 }
 function exactKeys(value, keys) {
     const actual = Object.keys(value).sort(compareUTF8);
@@ -395,9 +442,7 @@ function validateReleaseMetadata(value) {
     }
 }
 function validReleaseMetadataUIProtocolPair(schemaVersion, uiProtocolVersion) {
-    return (schemaVersion === releaseMetadataSchemaVersionV5 && uiProtocolVersion === "plugin-ui-v5") ||
-        (schemaVersion === releaseMetadataSchemaVersionV6 && uiProtocolVersion === "plugin-ui-v6") ||
-        (schemaVersion === releaseMetadataSchemaVersionV7 && uiProtocolVersion === "plugin-ui-v7");
+    return schemaVersion === releaseMetadataSchemaVersionV8 && uiProtocolVersion === "plugin-ui-v7";
 }
 function validateCapabilityContractRef(value) {
     if (![value.publisher_id, value.contract_id, value.signature_key_id].every((item) => matchesPattern(legacyIDPattern, item)) || !matchesPattern(semverPattern, value.contract_version))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floegence/redevplugin-contracts",
-  "version": "0.6.24",
+  "version": "0.7.1",
   "description": "Embedded ReDevPlugin machine contracts and canonical release-signing APIs",
   "license": "MIT",
   "type": "module",