papi-dts
    Preparing search index...

    Interface IThemeServiceInternalExperimental

    Theme operations that exist for the platform's own state-keeping rather than for consumers. They are deliberately kept off IThemeService, so papi.themes does not offer them.

    That is the whole guarantee, and it is a discoverability one rather than a privacy one: these ride on the same data provider as IThemeService under the same name, so any process that resolves the provider itself can call them. That reachability is why they are @experimental on both surfaces (TSDoc here, x-experimental in the registration's OpenRPC document) rather than pretending to be private.

    interface IThemeServiceInternal {
        migrateStoredThemeState(state: PersistedThemeState): Promise<boolean>;
    }
    Index

    Methods

    • Experimental

      Hand over theme state persisted somewhere the host cannot read, so the host can adopt it into its own store. Idempotent: the first offer to be adopted wins and every later one is refused, so several callers offering their own copies cannot interleave into a mixture of them.

      Resolving is terminal for the caller either way: true means the state now lives in the host's store, false means the host already has state that beats the offer (or the offer carried nothing usable). In both cases the caller's copy is dead and should be discarded. A rejection means neither — the offer can be made again.

      Parameters

      Returns Promise<boolean>

      true if the offer was adopted, false if it was refused